xiyue718/dsh-ui-git-bash

README 摘要

@dsh-external/ui-git-bash 当 AI 需要执行 Pwsh（PowerShell）命令时，自动将其替换为使用 Git Bash 命令执行，并在设置页提供“Git Base”配置，用于自定义 Git Bash 可执行文件路径。 功能 - 注册全新的 git bash 工具结构，与项目中的 pwsh / bash 工具平级。 - 不再拦截或替换 pwsh 工具；当 Git Base 模式启用时，系统提示会引导 AI 直接使用 git bash 工具。 - 调用 git bash 时直接使用 Git Bash 执行，完全不经过 Pwsh。 - 设置页新增“Git Base”： - 可切换执行模式： Pwsh / Git Base ； - 选中 Pwsh 时不替换命令，保持原 PowerShell 执行； - 选中 Git Base 时自动转换为 Git Bash 命令执行； - 可填写 git-bash.exe / bash.exe 的完整路径； - 可一键填入检测到的系统默认路径； - 配置通过项目 storage domain 持久化保存。 - 运行时优先使用用户配置的路径；未配置时自动尝试常见默认路径。 - 若未找到 Git Bash，会向 AI 返回明确提示。 - git bash 注册了专属 tool.call.toolview 工具卡片，在会话中以“Git Bash”作为一级工具卡片展示，不再落入通用的 Tool call 卡片。 - 不修改项目文件，也不做全局文本替换；轨迹/导航中的工具名保留实际工具名 git bash 。 - 兼容 router-standard 的 standard 模式：首个工具调用后注入一次“Git Base 模式已启用”的步骤指引，让模型后续 shell 命令改用 git bash ，避免继续使用 pwsh 。 - 执行日志写入： 命令执行 git bash 工具直接接收 Git Bash 命令并执行，不进行 PowerShell 转换，也不经过 Pwsh。 安装 方式一：超级模组注入器（推荐，不修改项目文件） 方式二：使用 dsh 命令安装（项目官方方式） 如果你已安装 dsh CLI，可以按项目官方教程使用 dsh plugin 命令安装： 安装后启动： 详细命令说明见项目文档： docs/user/develop/basic/publish.md 。 使用 1. 打开 DSH Web。 2. 进入 设置 → Git Base。 3. 填写 Git Bash 路径，或点击“使用检测到的默认路径”。 4. 保存后，AI 后续发出的 pwsh 命令会自动通过 Git Bash 执行。 Host API 构建产物 - host： lib/index.js - client： lib/client.js …

分类