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.0-rc.6
2. 把 patches/ui-conversation.patch 应用到 ui-conversation（费用预估 / 账单 / 货币 / 通知 / 余额）
3. 把 dsh-mods-enhanced 插件装进 web profile（图片转文字 / 完成提醒 / token 投影）
4. 配置 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)

如何使用

1. 在 DSH 会话中通过 cordis_define 创建或更新插件
2. 用 cordis_inspect_self(pluginId, packageId) 取出最新 Package 源码
3. 按上述结构保存到本仓库并提交

维护

• 使用 SSH 推送：git@github.com:koji-xiaoer/dsh-plugins.git
• 每次提交说明对应哪个插件、哪个 Package 版本

许可证

MIT © 2026 koji-xiaoer (CGWP)