dsh-agent-preset-plugin-dev

August 18, 2026 · View on GitHub

DeepSeek Harness 「插件开发」agent preset：基于官方 cordis（创造模式）复制扩展，把一套实测过的 Harness 插件开发工作流固化进 persona，并随行携带两个开发技能。让任何 DSH 实例上的 Agent 都能按统一流程开发、测试、打包、分发 Harness 插件。

能力

cordis（创造模式）的全部能力：文件/Shell/检索/计划/目标/子代理/工作流、自指 Cordis 工具集（cordis_define/cordis_run/cordis_inspect_* 等）
随行技能（随 preset 目录分发，安装到哪里就在哪里生效）：
- cordis-plugin-development — 动态 Cordis 插件开发规范
- editing-cordis-compositions — 组合/预设创作规范（两平面归属、realm 规则）
persona 固化的插件开发工作流（本仓库已验证跑通）：
1. 标准插件项目骨架（src/index.ts + src/client/index.ts、tsconfig、 cordis.patch.yml、dsh.bundle.patch + dsh.client 元数据、零运行时 import）
2. tsc 编译提交 lib/、scripts/to-client-bundle.mjs 生成调用 __ModuleLoader__.load 自注册的静态 client bundle（lib/client.js，exports["./client"] 指向它）、 scripts/to-dynamic.mjs 生成免重启动态代码体
3. 会话内 cordis_define/cordis_run 动态注册测试 + 槽位/激活校验
4. pnpm pack → dsh plugin --profile web add <spec> 打包安装验证（确认 dsh.profile.bundles 自动追加 + 装下的 client bundle 以 __ModuleLoader__.load 自注册）
5. README 写安装命令、完成后先询问是否提交 git（用 ask_user_question）；提交则按用户提供的远程方式执行（remote URL / gh 建仓推送 / 仅本地 init+commit 兜底并给出推送命令），无凭据绝不自行建仓或推送

安装（给使用者）

一键安装脚本（克隆后一条命令，自动复制到 $DSH_HOME/.agent-presets/plugin-dev/）：

# Windows
git clone https://github.com/<你>/dsh-agent-preset-plugin-dev.git
cd dsh-agent-preset-plugin-dev
powershell -ExecutionPolicy Bypass -File install.ps1

# macOS / Linux
git clone https://github.com/<你>/dsh-agent-preset-plugin-dev.git
cd dsh-agent-preset-plugin-dev
./install.sh

或手动复制：

Copy-Item -Recurse <克隆目录>\* $HOME\.dsh\.agent-presets\plugin-dev\

重启 harness，在会话/预设选择器里选「插件开发」。然后说"开发一个 XX 插件"，Agent 会按固化工作流执行。

目录结构

dsh-agent-preset-plugin-dev/
├── agent.cordis.yml                    # 组合（persona 含插件开发工作流）
├── preset.yml                          # 名称/描述（roster 显示）
├── install.ps1                         # Windows 一键安装
├── install.sh                          # macOS/Linux 一键安装
└── skills/                             # 随行技能（随 preset 分发）
    ├── cordis-plugin-development/
    └── editing-cordis-compositions/

更新与再分发

本机已安装的副本在 $DSH_HOME/.agent-presets/plugin-dev/（以 ctx.agentPresets 为准）。修改后同步回本仓库：

Copy-Item -Recurse $HOME\.dsh\.agent-presets\plugin-dev\* .\   # 覆盖
git add -A && git commit -m "..." && git push

TRUST 说明

本 preset 继承 cordis 的自指能力：cordis_mount 会执行模型写的 JavaScript，该 Agent 写的组合会成为其他会话挂载的预设。把会话交给它等同于授予 Shell 访问权。

License

MIT