前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。DSH 中的动态插件通常在会话中通过 cordis_define 定义，并在 cordis_run 时运行。这类插件的生命周期仅限于当前进程，一旦进程重启，插件定义即失效。因此，需要一个外部仓库来持久化保存这些插件的源码，以便在需要时重新加载。
koji-xiaoer/dsh-plugins 仓库正是为此设计。它作为 DSH 插件集合，不仅用于存储动态插件源码，还提供了一系列增强功能，并通过一键安装脚本简化了部署流程。
定位¶
本仓库是 koji-xiaoer 维护的 DSH 插件仓库。它主要解决以下问题：
* 持久化存储：存放 DSH 会话中由 AI 助手创建的动态 Cordis 插件源码。
* 功能增强：提供费用预估、账单明细、Token 统计、余额查询、图片转文字等实用功能。
* 快速部署：提供一键安装脚本，支持静态化常驻包的自动加载。
核心功能¶
仓库包含以下已核实功能：
* 费用与账单：费用预估与账单明细 (cost-6)，支持自定义模型价格与多币种切换。
* 会话管理：会话完成提醒 (sntf-5)，支持音色、音量与自定义音频。
* 数据统计：Token 用量统计 (tokm-1)，显示轮次、时长与消耗。
* 账户查询：账户余额查询 (baln-4)。
* 多模态支持：粘贴图片转文字 (imgr-3)。
* 界面增强：增强主页/界面，包含静态化常驻包 (dsh-mods-enhanced)，随 dsh web 启动自动加载。
安装与启用¶
仓库支持通过 DSH Profile Bundle 机制一键安装。安装前请确保环境已安装 pnpm (Node.js >= 20)。
- 执行以下命令添加插件：
dsh plugin --profile web add github:koji-xiaoer/dsh-plugins
该命令会将 `dsh-mods-enhanced` 插件插入 web profile，重启 `dsh web` 后生效。
- 若需同时应用对安装文件的文本补丁（如 UI 界面增强），需使用传统脚本：
git clone git@github.com:koji-xiaoer/dsh-plugins.git
cd dsh-plugins
bash scripts/install.sh
该脚本会自动完成依赖安装、补丁应用（锁定 DSH 版本至 0.1.1-rc.1）及配置工作。
典型用法¶
仓库支持两种插件形态的使用方式：
- 动态插件：在 DSH 会话中，通过
cordis_define创建或更新插件。使用cordis_inspect_self(pluginId, packageId)取出最新 Package 源码，保存到本仓库对应目录结构中，以便后续复用。 - 静态化常驻包：通过上述一键安装命令，
dsh-mods-enhanced静态包会随dsh web启动自动加载，无需手动运行。
适用场景与注意¶
- 密钥安全：仓库是公开仓库。任何密钥一旦提交即视为泄露，必须立即到 GitHub 设置页面吊销对应令牌。插件源码不得硬编码任何密钥/token，一律使用占位符。
- 版本锁定：使用补丁机制时，会将 DSH 版本锁定至
0.1.1-rc.1。 - 运行机制：动态插件不随进程重启保留，需通过
cordis_run重新创建；静态化常驻包则随dsh web启动自动加载。 - 适用对象：适合需要持久化管理 DSH 会话中生成的插件代码，并希望快速接入费用监控、多模态识别等增强功能的 DSH 用户。
短结尾¶
koji-xiaoer/dsh-plugins 为 DSH 用户提供了一个标准化的插件存储与分发方案。通过将动态插件源码集中管理，并利用静态化常驻包实现功能增强，它降低了 DSH 插件的维护成本，提高了会话管理的效率。
