DeepSeek Harness (DSH) 插件集合 —— 余额监控、Git/终端、数据库控制台、批量归档等日常能力,
link:本地安装即用。
| 插件 | 状态 | 一句话说明 |
|---|---|---|
ds-balance |
维护中 | 状态栏第二行:余额 + 今日/本月 token,5 分钟自动刷新 |
file-git-explorer |
维护中 | 右栏 Git 页签(分支 / 变更 / 历史)+ 详情悬浮面板 + 终端抽屉 |
db-console |
维护中 | 会话头部「数据库」页签:PG 登录、schema 树、SQL 编辑器、结果网格 |
deepseek-harness |
维护中 | 蓝色粒子鲸鱼背景,跟随官方明/暗/系统主题 |
stylevault-localchrome |
维护中 | 读本机 Chrome 配色 → 生成并应用 StyleVault 预设 |
batch-archive |
维护中 | 侧边栏「批量归档」按钮,一次归档多个会话 |
browser-operator |
维护中 | 常驻可见浏览器 + 9 个 browser_* 工具(纯 host,挂 agent preset) |
tool-vision |
已归档 | 本地视觉模型描述图片(读图 / OCR / 版面) |
paste-image |
已归档 | 粘贴图片落盘成文件,路径写入草稿 |
归档插件源码在
plugins/obsolete/,不再维护、不列入默认安装。 每个插件的配置项与细节见其自身plugins/<plugin-id>/README.md。
前置:Node.js >= 20、已安装 DSH(dsh CLI)及 web profile。
git clone https://github.com/eh-tools/dsh-plugin.git
cd dsh-plugin
# <repo-abs-path> 换成克隆下来的仓库绝对路径(link: 要求绝对路径)
dsh plugin --profile web add link:<repo-abs-path>/plugins/ds-balance
dsh plugin --profile web add link:<repo-abs-path>/plugins/file-git-explorer
dsh plugin --profile web add link:<repo-abs-path>/plugins/deepseek-harness
dsh plugin --profile web add link:<repo-abs-path>/plugins/batch-archive装完重启 DSH 并硬刷新浏览器(Cmd/Ctrl+Shift+R)生效。
- 更新:
git pull后重跑同一条安装命令。 - 卸载:
dsh plugin --profile web remove dsh-ds-balance,然后重启 DSH。 - 可选:
stylevault-localchrome要应用成主题需先装上游主题引擎:dsh plugin --profile web add github:GptsApp/dsh-stylevault dsh plugin --profile web add link:<repo-abs-path>/plugins/stylevault-localchrome
- 例外:
browser-operator不装 profile,挂进 agent preset(见下)。
仓库只保留这一张全局全览图,各插件不再内嵌截图。
-
官方 stats 行下方独立第二行:
DeepSeek ¥68.64 | 今日 34K tok | 本月 1.2M tok;悬停看明细(总余额 / 赠送 / 充值 / 输入输出拆分)。 -
凭证写入
~/.dsh/.credentials.yaml(或环境变量),不进代码:DEEPSEEK_API_KEY: sk-xxxx DEEPSEEK_USER_TOKEN: <平台网页登录态 token>
-
也可点状态栏**「浏览器登录」**,用系统 Chrome 登录后自动写入。
-
常见问题:只有余额没调用量 = 缺
DEEPSEEK_USER_TOKEN;调用量报40002/40003= token 过期,重新登录;「浏览器登录」不可用 = 本机没有 Chrome。 -
非官方 base URL(网关 / 代理 / 中转)下整行隐藏,属设计行为。
- Git 页签(打开右栏默认显示这格):分支按钮 + 分支树浮窗(本地 / 远程,只换查看对象,不动工作区分支)、变更列表、提交历史、聚焦单条提交;上下两栏各自滚动,可拖分栏比例。右栏宽度可拖(200px ~ 15% 视口)。
- 列表:按目录归类 + 层级虚线,hash 胶囊点击复制完整 hash,文件点开进详情浮窗。
- 详情悬浮面板:1/2 视口宽贴右栏左缘,同一时间只有一个;承载官方文档正文与 diff,可一键全屏,Esc / 切会话关闭。
- 终端抽屉:真 PTY(vim / htop / 颜色 / 补全 / Ctrl+C 可用);每工作区一个终端,切换 / 刷新后仍存活;选中即复制,标题条含收起
×与终止进程树按钮。 - worktree 切换器:仓库用了
git worktree时,可切换看主仓或任意工作树的分支 / 变更 / 历史 / diff。 - 快捷键:agent 回合结束自动刷新;
Alt+Ctrl+R手动刷新(含git fetch)、Alt+J/Alt+L切换右栏页签、详情里Alt+滚轮横向滚动。 - 已砍掉自绘文件树 / 搜索 / 编辑保存 / 右栏终端页签。细节与接口见
plugins/file-git-explorer/README.md。
- 会话头部第三个页签「数据库」,粘贴完整 PostgreSQL 链接串登录,按项目保存(切工作区 / 刷新 / 重启都不丢)。
- schema 树:内省 schema → 表 → 列,手动 ⟳ 刷新,点表名插入编辑器。
- SQL 编辑器:语法高亮 + 三级补全(SQL 关键字 / 表名 /
表名.出列),Ctrl/Cmd+Enter执行光标语句或选区。 - 结果网格:多语句分段渲染,行集默认截断 500 行并提示总数,点单元格复制,写语句显示影响行数。
- 依赖
pg,首次安装后在本插件目录执行一次pnpm install。
- 侧边栏底部(设置按钮旁)「批量归档」按钮 → 面板按工作区分组列出未归档会话(标题 / 相对时间 / 运行中状态)。
- 勾选或全选 → 「归档所选 (N)」→ 二次确认后 8 路并发归档,footer 实时显示「已归档 x / N」与失败数;已归档的自动隐藏,会话日志保留。
- 纯客户端实现,不落盘任何状态。
- 读本机 Chrome 用户色,生成可导入上游 StyleVault 的预设 JSON。
- 已装上游且同意后,首次启动弹窗询问,同意即每次启动自动应用当前 Chrome 配色;之后可在 Settings → StyleVault · Local Chrome 卡片改主意。
- 不装上游则只生成预设,不接管主题。
- 不挂载也能用 CLI 生成预设:
node plugins/stylevault-localchrome/scripts/build-preset.js。
-
先装依赖(仅
playwright-core,用系统 Chrome,不下载浏览器):pnpm --dir <repo-abs-path>/plugins/browser-operator install
-
再把
plugins/browser-operator/cordis.yml里那行加进 preset 的agent.cordis.yml(name写绝对路径):- id: browser-operator name: <repo-abs-path>/plugins/browser-operator/lib/index.js config: browser: chrome headless: false
-
常驻有头浏览器,独立 profile,与日常 Chrome 并存,登录态跨轮次、跨 DSH 重启复用(首次在可见窗口人工登录一次)。
-
9 个工具:
browser_navigate、browser_snapshot、browser_click、browser_fill、browser_eval、browser_screenshot、browser_console、browser_network、browser_artifacts。 -
截图等产物落在项目已 ignore 的目录下,不脏仓库。
-
改
lib/index.js需重启 DSH。
| 现象 | 解决 |
|---|---|
| 装了插件没效果 | 重启 DSH + 硬刷新浏览器;确认安装命令用的是仓库绝对路径 |
| 改了代码不生效 | lib/client.js 改动刷新浏览器即可;lib/index.js 改动需重启 DSH |
| 如何更新插件 | git pull 后重跑安装命令 |
| 如何卸载 | dsh plugin --profile web remove <插件id>,然后重启 DSH |
| 凭证放哪 | ~/.dsh/.credentials.yaml(或环境变量),不要写进代码 / 提交到 git |
新增插件 / 提交规范见 CONTRIBUTING.md;仓库结构:plugins/<plugin-id>/ 一个插件一个目录。
漏洞请走私密渠道报告,勿开公开 Issue,详见 SECURITY.md。
- 本仓库由 DeepSeek 模型协助、基于 DeepSeek Harness (DSH) 开发。
- 第三方社区项目,与 DeepSeek / 深度求索官方无隶属关系;
ds-balance的调用量接口为平台私有接口,可能随时变动,仅用于展示你本人账户信息。