dsh-task-assist
DSH 任务辅助启动器：在对话框发送键旁放置一个常驻按钮，点击后自动扫描本会话已安装的、对当前任务有帮助的技能与 MCP 工具，弹候选清单（默认勾选匹配项），一键确认后把选中技能注入当前对话交给 Agent 自动执行。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:TheFold060629/dsh-task-assist#44a66394e437c879c47feddb06d8e537218407bbTask Assist 以 dsh-task-assist 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH（DeepSeek Harness）任务辅助启动器插件。在对话框输入卡 发送键左侧 放一个常驻「辅助」按钮：点击后自动扫描本会话已安装的、对当前任务有帮助的 技能（skills） 与 MCP 工具，弹出候选清单（命中关键词的技能默认勾选），确认后把选中技能作为指令注入当前对话，由正在运行的 Agent 自动加载并按其方法论执行。
conversation.input.right 槽位（发送/停止键左侧的输入卡工具栏右侧）。api/task-assist/scan 发起扫描，对已装技能做关键词打分排序。POST 到 api/task-assist/inject，作为 steering 输入进入当前会话，Agent 下一步自动接手执行。把它加进目标 profile 的 dsh.profile.bundles，然后重启桌面端：
dsh plugin --profile <profile-name> add dsh-task-assist
仓库源码安装（
link:）：dsh plugin --profile <name> add link:<本目录>。 注意link:在本机 profile 里会留成软链，适合开发；正式安装请用包名。
⚠️ 不要另外在 profile 的
cordis.patch.yml里手写- insert: [dsh-task-assist]。 本插件自带的dsh.bundle.patch（即包内的cordis.patch.yml）已经会 insert 这一行； 再写一次会让同一个 entry id 在补丁栈里出现两次，触发duplicate entry id … (loader-level boot failure)，桌面端直接起不来。
改完 host 端一定要完全退出再重启（托盘 → 退出，或任务管理器结束所有
DeepSeek Harness.exe）。只刷新页面不够，原因见下方「开发须知」第 4 条。
dsh >= 0.2.0-rc.2（见 package.json 的 dsh.engines.dsh）conversation.input.right，该槽由 @deepseek-ai/dsh-client-ui-conversation 声明pnpm install # 安装构建依赖
pnpm build # tsc 类型检查 + tsdown 产出 lib/index.js 与 lib/client.js
产物：
lib/index.js — host 端：路由 api/task-assist/scan、api/task-assist/inject、技能/MCP 枚举与打分。lib/client.js — 浏览器端：conversation.input.right 槽位组件 + 候选面板。写 DSH 插件有几条不吃亏的硬约束，本插件每一条都真栽过，记在这里省得再试：
绝不写 export default apply。
插件半体按 mod.default ?? mod 解析。一旦有 default 导出，拿到的就是那个裸 apply 函数，
它没有声明点，inject 声明读不到 → 客户端 runner 会拒绝直接访问服务
（ctx.slots 直接抛异常而不是返回 undefined）。
官方插件（dsh-client-ui-model-selection、dsh-host-open-in-app 等）export default 数量实测为 0。
本项目 host 端结尾是 export { Config, apply, inject, name }，client 端同理。
函数式插件可再补一句 (apply as any).inject = inject 兜底。
slots.inject 注「槽自身」，不注父槽。
认领 conversation.input.right 要写 slots.inject('conversation.input.right', …)，
而不是 slots.inject('conversation.composer.bar', …)。理由见下方「说明」中的同名条目。
注错槽会让桌面端整体起不来。
标准 hook 是 SnapshotSelectorHook，选择器必填。
useInput / useSession 内部走
useSyncExternalStoreWithSelector(w.subscribe, w.getSnapshot, void 0, sel, eq)，
而 store 会调用 sel(snapshot)。所以 useInput() 不带参数会抛 TypeError: l is not a function（压缩后变量名）。
内核自己也一律用恒等选择器：useInput((s) => s)、useSession((s) => s)、useStore((s) => s.draft)。
真 InputState 形状（内核 compose() 产出）：
{ draft, attachmentIds, draftRev, phase, claim?, occurrences, queue }。
改完 host 端必须重启整个进程，HMR 不够。
dsh-client-hmr 只热换客户端半体；Node 侧 host 半体只在进程启动时读一次产物。
这会造出「新客户端 + 旧 host」的混合版本态，看起来完全像插件 bug（症状：按钮出现但接口 404）。
核对方法：比对 ~/.dsh/dsh-boot-state.json 里的 bootedAt 与 lib/ 产物的 mtime。
apply() 全身套 try/catch。
客户端 fiber 一旦 FAILED，前端 boot 会整体 throw（web boot: 1 entry did not activate），
整个桌面端卡在 "Failed to load plugins"。失败只 console.error 并降级成「按钮不出现」。
宿主侧同理（startup failed: N required plugins did not activate）。
排障通道：客户端 diag(stage, detail) → POST api/task-assist/diag → 宿主追加写
~/.dsh/rescue/task-assist-client.log（用 diagOnce() 去重，避免刷屏）。
用户输入任务 → 点【辅助】→ client 读 useInput().draft
→ GET api/task-assist/scan?task=..&session=..
→ host 扫描技能根目录(~/.agents/skills、~/.dsh/skills、项目 .dsh/.agents/skills)
+ 枚举已连 MCP server 工具，对 task 关键词打分排序
→ 面板展示候选（命中默认勾选）
→ 用户点【启动辅助】→ POST api/task-assist/inject {selected, session}
→ host 组装注入指令 → ctx.agents.get(sessionId).steer(message) 提交 steering 输入
→ 运行中的 Agent 在下一步拾取并按所选技能执行
ctx.agents 的 steer() 提交，消息 source 固定为 plugin:dsh-task-assist。
V4 会话格式要求 producer-owned source kind —— 写成旧的 { kind: 'plugin', plugin: … }
会让整轮对话被拒，而不是只让注入失败。slots.inject('conversation.input.right', …) —— 注「槽自身」，
不要注父槽 conversation.composer.bar。
slots.inject(key, cb) 订阅的是 key 自己的声明 epoch，那才是它变得可注册的时刻；
而 conversation.input.right 与父槽 conversation.composer.bar 在注册序列里差了 4 步，
注父槽会在子槽尚未声明时触发回调，抛
slot "conversation.input.right" is not declared (a parent entry's children table must declare it)，
并使客户端 fiber FAILED → 整个 web boot 抛 1 entry did not activate，桌面端起不来。apply() 全身套 try/catch：客户端 fiber 一旦 FAILED，前端 boot 会整体 throw，
失败只 console.error 并降级成「按钮不出现」，绝不拖死宿主。user-agents / user-dsh / project-dsh / project-agents / bundled / other，同分时按此优先级展示。dsh-app://app，
与 Host（127.0.0.1:<port>）永不相等，严格 origin === host 会把桌面端请求全部 403。MIT