前言¶

在使用 DeepSeek Harness (DSH) 进行开发时，频繁切换窗口查看余额、管理项目文件或执行 Git 操作会打断工作流。dsh-workspace 插件旨在解决这些问题，它直接集成在 DSH 的侧边栏中，提供轻量级的 IDE 和 Git 工作区功能。

简介¶

这是一个为 DeepSeek Harness 设计的轻量级插件，由 AstralFoundry 维护，采用 MIT 许可证。

核心功能¶

• 余额与费用监控：在侧边栏底部显示余额和今日费用。余额低于 10 CNY 时会变红提示。
• 一键更新 Harness：检测到新版本时，点击 Update 按钮即可自动重启 Harness。
• 项目工作区面板：提供文件树、Git 工作区变更、差异对比和提交历史。
• Git 源控制：支持暂存、提交、分支切换、拉取和推送操作。
• 内置终端：直接在插件中打开终端执行命令。
• 隐私保护：默认仅限回环访问，API 密钥通过 Harness 的 ctx.credentials 解析，不暴露给浏览器。

安装与启用¶

使用官方命令安装插件：

dsh plugin --profile web add "github:AstralFoundry/dsh-workspace#v0.2.0"

安装完成后需要重启 dsh web。

配置¶

插件默认无需配置。如需调整，可在配置文件中设置：
* allowRemote：设为 true 以允许远程访问。
* baseUrl：API 基础地址。
* apiKeyEnv：API 密钥的环境变量名。
* projectRoot：项目根目录。
* peakWindows：计费高峰窗口（分钟）。

注意事项¶

• 权限限制：Git 操作严格限制在当前会话的 projectRoot 目录内，不支持路径遍历或外部符号链接。
• 依赖项：依赖 node-pty 原生模块。
• 费用显示：优先显示官方账单，API 不可用时回退到本地估算。
• 非官方项目：这是一个社区项目，未获得 DeepSeek 授权。

结尾¶

该插件将 DeepSeek Harness 变身为具备基础 IDE 功能的轻量级工作台。更多细节请参考插件目录或源码：GitHub。