← 返回列表
⚠ 装前注意
把 /.dsh/agents/.md 定义的自定义 agentfrontmatter 元数据 + markdown
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/24 · 已提供中文文档
dsh 插件：将 ~/.dsh/agents/*.md 注册为 dsh 可调用的子代理
综合分
38
GitHub 分
38
用户评分
—
★ Stars
4
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add fan56/dsh-subagent-registry未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 2 天前真实安装成功（L4 · 真实安装）
- 是什么
- dsh 原生插件 · market
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 1 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/24（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@aiwayds/dsh-subagent-registry（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=22.19.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 18:45:23
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-subagent@deepseek-ai/dsh-tools@deepseek-ai/dsh-skill@deepseek-ai/dsh-util-values@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-subagent-registry
English
把 ~/.dsh/agents/*.md 定义的自定义 agent（frontmatter 元数据 + markdown
正文作为 persona/system prompt）注册成 dsh
可按名调用的 subagent：主对话通过 use_agent 点名调用，ask_agent 对后台
代理追问并等回复。跑在 dsh 自带的 spawn provider 上，纯插件、不改 dsh 本体。
特点
- 一个 markdown 文件就是一个 agent — frontmatter 写模型/思考强度，正文就是
system prompt，改完即生效。
- 断点续跑 — 长任务中断（报错/取消/限额/崩溃）后再次调用，自动从已保存的
中间进度继续，不从头重来。
- 后台派发 + 双向追问 — background: true 把代理放到后台跑，主对话继续干活；
ask_agent 发追问并等它的回复。
- 开箱即用三个人物 — 装好即自动植入 workhorse / oldfox / rubber-duck
三个预置 agent（见下）。
- 站在官方 subagent 机制之上 — 不自建执行器：每个自定义 agent 都通过 dsh
官方的 spawn provider 启动，子代理就是货真价实的 dsh subagent（完整会话、
持久化、continuable）。官方 subagent 栈的新能力（如双向通信）本插件自动
继承；官方原生 subagent 工具继续可用，两者并存、互不干扰。
- 纯插件 — 只依赖 dsh ≥ 0.1.7-rc.1 的公开 subagent 机制，可随时干净卸载。
三个预置 agent
首次启动时植入 ~/.dsh/agents/（仅当目录里还没有可解析的 agent 时；你的修改
永远不会被覆盖）。它们就是普通的 markdown 文件，随便改。
| Agent | 一句话 | 典型用法 |
| ----- | ------ | -------- |
| workhorse（牛马狗） | 干活的主力：写代码、调查、测试、部署，脏活累活全包；默认 deepseek-flash，受保护禁止危险操作 | 「用 workhorse 把发布清单整理成表格」 |
| oldfox（老法师） | 顾问不干活：分析、trouble shooting、review 挑刺，只把关不动手；glm-5.3 | 「让 oldfox 审一下这个方案」 |
| rubber-duck（小黄鸭） | 多模态视觉 agent：看截图/图表/手写字，画 plotext/mermaid/matplotlib 图；跑在支持图像的模型上 | 「用 rubber-duck 看这个截图，提取页面文字」 |
用法
装好、重启 dsh，然后在对话里直接说——主模型会按名字挑 agent：
用 workhorse 把今天的发布清单整理成表格
底层就是 use_agent(agent: "workhorse", prompt: "…")。后台代理用
ask_agent(agent: "worker", message: "…") 追问，会等它的回复。
定义自己的 agent
往 ~/.dsh/agents/ 丢一个文件：
name: my-agent
description: "一行简介，显示在 use_agent 名册里"
model: opencode-go/deepseek-flash
thinking: high
You are my-agent. 这段 markdown 正文会原样作为 system prompt。
Frontmatter 字段：name（必填）、description、display_name、model
（provider/model，缺省继承）、thinking（off/low/medium/high/max，缺省继承）、
deep（0 = 叶子不许再开子代理，缺省 1）、background（true = 默认后台跑）、maxRounds（正整数，per-agent 轮数上限，覆盖 dsh-tui.maxRounds 全局值；宿主 TUI 的硬停梯消费）。
未知字段静默忽略。
并发与轮数上限（0.1.7 起）
并发数与嵌套深度由官方 dsh-subagent 托管，本插件不自管并发计数与排队
（官方 ActivationManager 统一调度）：maxActiveSubagents（同时活跃子代理上限，
默认 8）与 maxDepth（委托嵌套深度上限，默认 1）。两者都是 volatile 字段，
免重启热调——在 profile patch 里写 subagent: { maxActiveSubagents: N, maxDepth: M }，
或运行时 settings.update('subagent', …)。use_agent 的 deep frontmatter
只是在这条官方深度预算内再收紧（deep: 0 叶子直接拔掉所有开代理的工具）。
maxRounds（per-agent 轮数上限）本插件继续保留：官方 subagent seam 没有轮数
预算能力，该键仍由宿主 TUI 的硬停梯消费。
→ 完整参考：docs/AGENT-FORMAT.md（英文）——每个字段
的校验与失败行为、deep/thinking 语义、续跑机制、后台派发、配置项、已知边界。
内置技能
插件随包注册一个名为 dsh-subagent-registry-config 的技能（bundled skill）。对话涉及自定义
子代理、agent .md 编写、子代理续跑或本插件配置时，dsh 会自动加载这份使用与配置指南，
主模型可以据此用 ask_user_question 代写 agent 文件、调整插件配置，无需翻 README。
技能与插件同版本发布，随 npm 包携带（skills/dsh-subagent-registry-config/SKILL.md）。
安装
要求 dsh >= 0.1.7-rc.1（RC/稳定线；alpha 线不再支持）。
方式 A — 把本地 checkout 挂进 dsh profile：
sh
dsh plugin --profile tui add ~/github/dsh-subagent-registry
方式 B — npm 依赖：npm i @aiwayds/dsh-subagent-registry，然后在 profile
配置里以稳定 id dsh-subagent-registry 加载，或通过 bundle patch 挂载
（挂法见本仓 cordis.patch.yml）。
卸载
sh
dsh plugin --profile remove @aiwayds/dsh-subagent-registry
宿主会把插件从 profile 里摘除；重启 dsh 后 use_agent / ask_agent 工具
消失。~/.dsh/agents/ 里的 agent 文件会保留——它们归你所有，不会被
重新植入或覆盖。没有本插件时 dsh-tui-pi 会优雅降级（只是失去自定义 agent
派发能力）。
开发
sh
npm run check # tsc --noEmit
npm run build # tsc -> lib/
npm test # 全部单元测试（无 LLM、无网络）
License
MIT