@huanlin/dsh-plugin-yet-another-subagent
可配置的子代理配置文件，支持 Web UI 设置、实时工具调用和令牌显示，以及点击导航至子会话。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:HuanLinOTO/dsh-plugin-yet-another-subagent#ce04bbd761b1cd95e9c1a72cd2f7febe2ef629eePlugin Yet Another Subagent 以 @huanlin/dsh-plugin-yet-another-subagent 发布，当前版本为 0.4.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-plugin-yet-another-subagent card
可配置的子代理（subagent）profile 系统，提供单一 subagent 工具 + profile 参数选择，支持 Web UI 设置、实时进度展示（工具调用/token/活动）、子代理树标签页、点击跳转子会话。
单 bundle，双入口（host . + client ./client）。
不发布
./invariant：本插件的工具/RPC/projection 注册均无独立可分歧的运行时观察（HMR 安全性由测试证明），无内容可校验——按 DSH 0.1.2-rc.1 收紧后的 invariant 规则（禁止空 installer）省略该入口及其全部接线。
src/index.ts）：
subagent 工具，通过 profile 枚举参数选择 profile（非每 profile 一个工具）spawn provider，支持前台（foreground）和后台（continuable / one-shot）两种模式$DSH_HOME/settings.yamlya-subagent.profiles.* / .tools.list / .sessions.repair（/api 上的 exact Fetch route，经 connection.fetch.register 注册）subagentProfile（父会话 childId→profileId 映射 + callId→childId）+ yaSubagentProgress（子会话实时 toolcall/token/活动状态）；wire view 已做引用记忆化，适配 dsh 0.1.2-alpha.3 起 change feed 的 Object.is 下发门控（内容不变即静默）src/client/index.ts）：
settings.section — Profile 编辑页tool.call.toolview（key subagent）— SubagentCard 工具调用卡片conversation.view（id subagent-tree）— SubagentTreeView 子代理树标签页cordis.patch.yml 只禁用官方 tool-subagent（spawn 路径），保留 tool-subagent-fork（无名称冲突）。
# cordis.patch.yml
- id: tool-subagent
disabled: true
- insert:
- id: yet-another-subagent
name: '@huanlin/dsh-plugin-yet-another-subagent'
config:
profiles:
- id: general
label: General
model: { kind: 'auto' }
persona: { kind: 'inherit' }
toolFilter: { kind: 'none' }
maxDepth: 3
backgroundMode: continuable
builtin: true
generalFixed: true
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
id | string（小写字母/数字/连字符，1-32 字符） | — | Profile 唯一标识 |
label | string | — | 显示名 |
model.kind | 'auto' | 'manual' | — | auto 继承父代理模型；manual 指定 |
model.provider | string | '' | Provider（仅 manual 时使用） |
model.model | string | '' | 模型 ID（仅 manual 时使用） |
persona.kind | 'inherit' | 'custom' | 'inherit' | inherit 跟随部署人设；custom 自定义 |
persona.text | string | '' | 自定义人设文本（仅 custom 时使用） |
toolFilter.kind | 'none' | 'allow' | 'deny' | 'none' | 工具过滤策略 |
toolFilter.tools | string[] | [] | 过滤工具列表 |
maxDepth | number | 3 | 最大递归深度 |
backgroundMode | 'continuable' | 'one-shot' | 'continuable' | run_in_background: true 时的后台策略 |
builtin | boolean | false | 是否为内置 profile（仅展示用） |
pnpm install # 安装开发依赖 + zod（唯一运行时 npm 依赖）
pnpm run typecheck # tsc --noEmit（通过 ../dsh 解析 DSH 源码）
pnpm test # vitest run
pnpm run build # tsc + tsdown → lib/index.js, lib/client.js
tsconfig.json 继承 ../dsh/tsconfig.base.client.json，通过 pnpm-workspace.yaml 的 packages/*/* glob 解析 DSH checkout 的源码。需在 ../dsh 存在 DSH checkout 的同级目录下运行。
# 从 npm 安装（推荐）：
dsh plugin --profile web add @huanlin/dsh-plugin-yet-another-subagent
# 本地引用（开发热更新）
dsh plugin --profile web add "link:D:/Projects/deepseek-harness/yet-another-subagent"
安装后重启 dsh web 进程，浏览器硬刷新（Ctrl+Shift+R）。
pnpm run typecheck # 0 errors
pnpm test # 55 tests passing
pnpm run build # lib/index.js + lib/client.js
lib/index.js — Host bundlelib/client.js — Client bundle（CSS-modules inline，d 前缀 hash 防 CSS 类名数字开头）cordis.patch.yml — Bundle patch layerProfile 状态通过 DSH settings seam 持久化到 $DSH_HOME/settings.yaml 的 ya-subagent 命名空间。cordis.yml 的 profiles 字段是组合 base（首次启动种子），运行时变更通过 scope.replace() 写入用户层。外部 yaml 编辑通过 scope.watch 热重载。
无 settings provider 的无头组装回退到内存状态（仅 cordis.yml 种子，不持久化）。
Profile CRUD 走 /api 通道上的 exact Fetch route（ctx.connection.fetch.register，与官方
dsh-client-file-upload 同模式）。不占用 /api 的单拦截器槽（该槽归 Typert gateway 所有）；
信任栅栏与浏览器认证由 /api 载体统一执行。
| endpoint（wire method） | payload | result (ok) |
|---|---|---|
ya-subagent.profiles.list | {} | { profiles: SubagentProfile[] } |
ya-subagent.profiles.add | { profile: SubagentProfile } | { profiles: SubagentProfile[] } |
ya-subagent.profiles.update | { profile: SubagentProfile } | { profiles: SubagentProfile[] } |
ya-subagent.profiles.remove | { id: string } | { profiles: SubagentProfile[] } |
ya-subagent.tools.list | {} | { tools: { name, description }[] } |
ya-subagent.sessions.repair | {} | RepairStats |
URL 形如 POST /api/ya-subagent.profiles.list（Connection client-request envelope，响应为
server-response envelope）。业务错误返回 { ok: false, error: { code: 'internal', message } }。
历史注：v0.3.x 走
connection.rpc.handle('/ya-subagent', …)专用通道；dsh 0.1.5 的 专用通道注册在 web profile 拓扑下无法挂载（webserver 服务与 connection 是兄弟 loader 行，rpc.handle内部的owner.webServer解析永远失败），浏览器侧表现为transport failure for /ya-subagent/profiles.list: HTTP 405。v0.4.0 起改用 exact Fetch route。
completed <label> subagent <id> render 格式变更后，旧会话的结果文本无法被 parseResult 匹配，卡片不可点击。仅新会话（host 重启后）正常。yaSubagentProgress stateVersion 2：projection schema 变更（activity 字段 + assistant/chunk fold）需要 host 重启才能生效。.agents/notes/implemented/feature/2026-07-28-continuable-subagent-conversations.mdplugin-development-guide.md