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） |
提交审查（防密钥泄露）
本仓库是公开仓库：任何密钥一旦提交即视为泄露，必须立即吊销。提交前强制遵守：
1. 每次提交前运行扫描：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，并写一行 # 理由； 2. 插件源码规则：不得硬编码任何密钥/token，一律使用 <YOUR_XXX_TOKEN> 占位符，运行时从环境变量或独立配置文件读取； 3. 本地自动拦截：已启用 pre-commit 钩子（git config core.hooksPath hooks），每次 git commit 自动扫描暂存区，命中即中止提交； 4. 若怀疑密钥已泄露：立即到 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脚本会自动完成:
1. 安装 @deepseek-ai/dsh@0.1.1-rc.1 2. 应用 patches/ui-conversation.patch + patches/dsh-host-apiproxy-0.1.1.patch（费用预估 / 账单 / 货币 / 通知 / 余额；见 scripts/reapply-dsh-mods.sh） 3. 把 dsh-mods-enhanced 插件装进 web profile（完成提醒 / token 投影） 4. 配置 package.json + cordis.patch.yml
装完重启 dsh web --port 3080 即可。余额查询需 DEEPSEEK_API_KEY。
> 注意:补丁锁定 dsh 0.1.1-rc.1。0.1.1-rc.1 起原生支持多模态（deepseek-v4-flash-vision-exp）， > 粘贴图片可走原生视觉；本套补丁已移除图片转文字中继与对话折叠功能（不再维护）。
2026-08-21 修复（费用实时刷新）：账单/会话统计栏的费用此前在单个回合内不刷新——折叠缓存失效键用 updatedAt（仅用户发消息才推进），回合内 agent 连续产生的 LLM 调用费用会冻结在"最后一条用户消息"时刻（表现为"本次对话没有价格"）。已改为投影 asOfSeq（每条已提交事件推进）作为失效键（session.cost / session.costDetail 共 5 处），费用随 5 秒轮询实时更新；并修正 scripts/reapply-dsh-mods.sh 中 apiproxy 补丁原始备份文件名笔误（index.orig.js → index.js.orig）。
效果预览
> 截图取自本机实际运行画面,金额/会话标题等均已替换为演示数据或打码,不包含真实敏感信息。
| 功能 | 截图 | 说明 |
|---|---|---|
| 会话统计栏 |  | 轮次/时长/Token 用量/预估费用(对应 cost-6 费用行 + tokm-1 用量行) |
| 总账单 |  | 全会话费用表(费用预估与账单明细,cost-6) |
| 费用预估设置卡 |  | 自定义每模型价格 + 峰谷价说明(cost-6) |
| 账单货币卡 |  | 15 币种切换/汇率(cost-6) |
| 会话完成提醒 |  | 音色/音量/增益/试听/自定义音频(sntf-5) |
| 粘贴图片转文字 |  | 图片经 GLM 识别替换为文字描述(imgr-3) |
| 账户余额 |  | 总账单页顶部余额徽标(金额打码,baln-4) |
如何使用
1. 在 DSH 会话中通过 cordis_define 创建或更新插件 2. 用 cordis_inspect_self(pluginId, packageId) 取出最新 Package 源码 3. 按上述结构保存到本仓库并提交
维护
- 使用 SSH 推送：
git@github.com:koji-xiaoer/dsh-plugins.git - 每次提交说明对应哪个插件、哪个 Package 版本
许可证
[MIT](LICENSE) © 2026 koji-xiaoer (CGWP)