概览
dsh-workspace
README / ZH
插件文档
dsh-workspace
非官方项目 —— 独立社区项目，与 DeepSeek 无关，亦未获得其认可或支持。
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 的衍生版本，原项目与本项目贡献者的版权声明均予保留。
LIMITATIONS
已知限制
- 今日费用优先官方账单，取不到时回退本地估算；估算不是账户账单 - 项目与 Git API 默认仅回环地址可访问；Git 写操作必须绑定当前会话目录 - 空闲/高峰标签同 DeepSeek 峰谷计费时段（高峰北京 9:00–12:00、14:00–18:00）；本地估算按当前时段计价 - 依赖 `node-pty` 原生模块，平台构建失败时需按安装排障处理