dsh-plugins
存放 DeepSeek Harness（DSH）会话中由 AI 助手创建的动态插件（Dynamic Cordis Plugin）源码的仓库。
仓库用途
DSH 的动态插件是临时运行在 DSH 进程中的 Cordis 插件，由会话中的助手通过 cordis_define 定义。插件定义不随进程重启保留，因此本仓库用于：
- 持久化保存每个插件的 Host / Client 源码
- 记录插件的用途、运行状态与修复记录
- 需要时可通过源码在任何会话中重新创建（
cordis_define + cordis_run）
目录结构（顶层分类）
dsh-plugins/
├── README.md # 本文件
├── README.en.md # 英文版说明
├── scripts/ # 仓库工具：密钥审查扫描、一键安装、任务花费预估
├── hooks/ # pre-commit 钩子
├── patches/ # 分发用补丁（ui-conversation.patch，配合 scripts/install.sh）
├── docs/ # 设计/依赖关系/迁移计划文档
├── 插件类/ # 动态插件：本助手创建的插件，每插件一个目录（按 pluginId）
│ └── dsh-mods-enhanced/ # 静态化常驻包：5 个动态插件的合并版（profile 静态插件）
├── 增强主页类/ # 界面/主页增强：自写界面改造
│ └── dsh-mods/ # 现有补丁集，按功能组织（余额查询/完成提醒/费用账单/图片转文字…）
└── 其他/ # 杂项：不属于以上两类的归档
归档规则：动态插件 → 插件类/；界面/主页增强 → 增强主页类/；其余 → 其他/。
新插件结构（插件类/<pluginId>/）：
插件类/<pluginId>/
├── README.md # 插件用途、版本历史、运行说明
├── host.js # Host 端源码（如有）
└── client.js # Client 端源码（如有）
插件两种形态：
| 形态 | 说明 | 例子 |
|---|
| 动态插件 | 会话内 cordis_define 定义、cordis_run 运行，进程重启即失 | 插件类/baln-4/ 等 |
| 静态化常驻包 | profile 静态插件，随 dsh web 启动自动加载，免手动运行 | 插件类/dsh-mods-enhanced/（合并 baln-4/sntf-5/tokm-1/imgr-3/cost-6） |
提交审查（防密钥泄露）
本仓库是公开仓库：任何密钥一旦提交即视为泄露，必须立即吊销。提交前强制遵守：
- 每次提交前运行扫描：
scripts/check-secrets.sh --all
- 退出码
1（CRITICAL：私钥、sk- 开头的 DeepSeek/OpenAI 等平台 key、智谱 GLM 的 <32位hex>.<密钥段> 格式、JWT、百度 bce-v3/ALTAK、腾讯 AKID、GitHub/GitLab/Slack/AWS/Google token、硬编码的 Authorization、URL 内嵌账号密码）→ 禁止提交，将密钥替换为 <YOUR_XXX> 占位符；
- 退出码
2（WARNING：32/40 位十六进制串、password/api_key/secret 等敏感字段的赋值、Bearer xxx 等）→ 逐条人工审查；
- 确认为误报的，将
相对路径:整行内容 追加到 scripts/secret-allowlist.txt，并写一行 # 理由；
- 插件源码规则：不得硬编码任何密钥/token，一律使用
<YOUR_XXX_TOKEN> 占位符，运行时从环境变量或独立配置文件读取；
- 本地自动拦截：已启用 pre-commit 钩子（
git config core.hooksPath hooks），每次 git commit 自动扫描暂存区，命中即中止提交；
- 若怀疑密钥已泄露：立即到 https://github.com/settings/tokens 吊销对应令牌，再处理仓库历史。
一键安装
本仓库根目录声明了 dsh.bundle(见 package.json + cordis.patch.yml),可作为 DSH profile bundle 标准安装:
dsh plugin --profile web add github:koji-xiaoer/dsh-plugins
该命令会通过 pnpm 安装本仓库(包名 dsh-mods-enhanced,即 插件类/dsh-mods-enhanced 的合并增强插件:余额查询 / 会话完成提醒 / 费用预估与账单明细 / 粘贴图片转文字 / Token 用量统计),自动将其插入 web profile,重启 dsh web 后生效(插件声明了 dsh.client,前端模块随之注入)。
注意:需要 PATH 上有 pnpm(Node.js >= 20 自带 corepack,corepack enable 即可)。
若需要同时应用 ui-conversation 客户端增强补丁(费用预估 / 账单 / 货币 / 通知 / 余额界面增强,属于对 dsh 安装文件的文本补丁,bundle 机制无法覆盖),再执行传统脚本:
git clone git@github.com:koji-xiaoer/dsh-plugins.git
cd dsh-plugins
bash scripts/install.sh
脚本会自动完成:
- 安装
@deepseek-ai/dsh@0.1.0-rc.6
- 把
patches/ui-conversation.patch 应用到 ui-conversation（费用预估 / 账单 / 货币 / 通知 / 余额）
- 把
dsh-mods-enhanced 插件装进 web profile（图片转文字 / 完成提醒 / token 投影）
- 配置
package.json + cordis.patch.yml
装完重启 dsh web --port 3080 即可。图片转文字需配置 ZHIPU_API_KEY，余额查询需 DEEPSEEK_API_KEY。
注意:ui-conversation 补丁锁定 dsh 0.1.0-rc.6。dsh 升级后 client.js 会变,补丁可能失效,需重新生成。
效果预览
截图取自本机实际运行画面,金额/会话标题等均已替换为演示数据或打码,不包含真实敏感信息。
| 功能 | 截图 | 说明 |
|---|
| 会话统计栏 | 费用行 | 轮次/时长/Token 用量/预估费用(对应 cost-6 费用行 + tokm-1 用量行) |
| 总账单 | 总账单 | 全会话费用表(费用预估与账单明细,cost-6) |
| 费用预估设置卡 | 费用预估卡 | 自定义每模型价格 + 峰谷价说明(cost-6) |
| 账单货币卡 | 货币卡 | 15 币种切换/汇率(cost-6) |
| 会话完成提醒 | 提醒设置卡 | 音色/音量/增益/试听/自定义音频(sntf-5) |
| 粘贴图片转文字 | 图片转文字 | 图片经 GLM 识别替换为文字描述(imgr-3) |
| 账户余额 | 余额 | 总账单页顶部余额徽标(金额打码,baln-4) |
如何使用
- 在 DSH 会话中通过
cordis_define 创建或更新插件
- 用
cordis_inspect_self(pluginId, packageId) 取出最新 Package 源码
- 按上述结构保存到本仓库并提交
维护
- 使用 SSH 推送：
git@github.com:koji-xiaoer/dsh-plugins.git
- 每次提交说明对应哪个插件、哪个 Package 版本
许可证
MIT © 2026 koji-xiaoer (CGWP)
