IDE 工作区面板AstralFoundry/dsh-workspace

dsh-workspace

非官方项目 —— 独立社区项目，与 DeepSeek 无关，亦未获得其认可或支持。

Release
Stars
License

English · 中文

为 DeepSeek Harness (DSH) 开箱即用的 UI 增强插件：侧边栏实时查看余额与今日费用、浏览项目文件与 Git 变更/历史、内置终端，并支持一键更新 Harness——无需任何额外配置。

本项目基于社区项目 deepseek-dsh/dsh-workspace 二次开发，保留 MIT 许可证与原作者署名。

功能 · 项目截图 · 安装 · 配置 · 常见问题 · 已知限制 · 许可证

项目截图

侧边栏状态卡

项目文件树与预览

功能

用量一目了然

- 左下角实时显示余额、今日费用与空闲/高峰状态
- 余额默认绿色，≤ 10 CNY 时变红；空闲绿色、高峰红色
- 每 30 秒自动刷新，切回页面时立即重新拉取
- 今日费用优先取 DeepSeek 官方账单，平台接口不可用时自动回退为本地 Token 估算

Harness 一键更新

- 显示已安装的 Harness 版本；有新版本时变红并醒目提示
- 点击更新即可安装最新版，完成后自动重启，过渡期间显示呼吸 Logo 动画，页面自动恢复——无白屏、无需手动操作

项目工作区面板

- 右侧固定面板预览当前会话的项目：带文件类型图标的文件树、Git 工作区变更、文件 diff 与提交历史
- 源代码管理支持暂存/取消暂存、撤销修改、提交、创建与切换分支，以及拉取和推送
- 提交历史展示彩色分支拓扑、作者、日期、分支与标签；多文件提交可逐文件查看 diff
- 面板宽度与上下区域可自由拖动，关闭后折叠为右侧入口，重新展开时保留当前上下文
- 常见 Git 错误会转换成中文提示，例如分支已被其他 worktree 占用、工作区修改阻止切换等
- 文件读取和 Git 操作严格限制在当前会话的 projectRoot 内，拒绝路径穿越与越界符号链接
- 跳过 .git、node_modules、dist、lib、coverage、.next、.cache
- 内置终端，可在项目中直接执行命令

默认安全

- 所有接口默认仅允许本机访问，如需开放可设 allowRemote: true
- API Key 通过 Harness ctx.credentials 解析，不会暴露给浏览器

安装

系统要求

- 已安装 DeepSeek Harness，dsh web 可正常启动
- 从仓库安装需要 Node.js >= 22

一行安装

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

装完重启 dsh web 生效。

验证与卸载

dsh web --dump-config | grep dsh-workspace   # 确认插件层已挂载
dsh plugin --profile web remove dsh-workspace # 卸载后重启 dsh web

配置

插件零配置即可使用。以下选项可按需在 profile 配置文件中设置：

| 选项 | 默认值 | 说明 |
| --- | --- | --- |
| baseUrl | https://api.deepseek.com | DeepSeek API 地址 |
| apiKeyEnv | DEEPSEEK_API_KEY | 通过 ctx.credentials 解析 Key 的环境变量名 |
| projectRoot | — | 预览的项目根目录，默认取会话工作目录 |
| peakWindows | [[540, 720], [840, 1080]] | 高峰计费时段（分钟，北京时间） |
| allowRemote | false | 是否允许非本机访问插件接口 |

安装排障

| 现象 | 原因 | 解法 |
| --- | --- | --- |
| 装完侧边栏没有入口 | bundle 插件需要重启进程 | 重启 dsh web，再 dsh web --dump-config \| grep dsh-workspace 核对 |
| [WARN] Issues with peer dependencies found | peer 依赖（@deepseek-ai/*、react）由 profile 提供 | 正常警告，忽略即可 |
| ERR_PNPM_IGNORED_BUILDS | pnpm 拒绝 node-pty 原生构建脚本 | 在 profile 的 pnpm-workspace.yaml 把 node-pty 加进 allowBuilds，重新安装 |
| Cannot find package '...' | profile 严格布局下依赖未被提升 | 在 profile 的 pnpm-workspace.yaml 设 nodeLinker: hoisted，重新安装 |
| 今日费用一直显示估算值 | platform.deepseek.com 认证失败 | 确认 apiKeyEnv 指向的 Key 在 platform.deepseek.com 有效；失败时插件自动回退估算 |

常见问题

装完重启了，侧边栏还是没有入口？

A: 确认装进了 web profile（命令带 --profile web），用 dsh web --dump-config | grep dsh-workspace 核对插件层已挂载；页面刷新不够，需要重启 dsh web 进程。

今日费用和官方账单对不上？

A: 费用优先取平台官方账单，显示的是真实消费；若平台接口认证失败会自动回退为本地 Token 估算，估算按公开单价近似、不是账单。摘要下方会标注金额来源。

余额变红了？

A: 余额小于等于 10（CNY）时提示红色，提醒余额不足；只是展示提示，不影响 API 调用。

「更新」真的会升级 Harness 吗？

A: 会。通过 npm 安装最新发布的 Harness 版本后自动重启进程，页面自动恢复，整个过程约一分钟。

能从手机或其他设备访问吗？

A: 默认只允许本机（回环地址）读取项目数据。非本机浏览器访问会返回 403；确有需要可设 allowRemote: true，并自行确保访问安全。

空闲/高峰状态对计费有影响吗？

A: 该显示与 DeepSeek 实际的峰谷计费时段一致（高峰为北京 9:00–12:00、14:00–18:00，其余空闲半价）。本地估算按当前时段计价，因此已计入了高峰/空闲差价；但费用始终以官方账单优先。

已知限制

- 今日费用优先官方账单，取不到时回退本地估算；估算不是账户账单
- 项目与 Git API 默认仅回环地址可访问；Git 写操作必须绑定当前会话目录
- 空闲/高峰标签同 DeepSeek 峰谷计费时段（高峰北京 9:00–12:00、14:00–18:00）；本地估算按当前时段计价
- 依赖 node-pty 原生模块，平台构建失败时需按安装排障处理

许可证

MIT。本项目是 deepseek-dsh/dsh-workspace 的衍生版本，原项目与本项目贡献者的版权声明均予保留。