TheFold060629/dsh-task-assist

dsh-task-assist

DSH（DeepSeek Harness）任务辅助启动器插件。在对话框输入卡 发送键左侧 放一个常驻「辅助」按钮：点击后自动扫描本会话已安装的、对当前任务有帮助的 技能（skills） 与 MCP 工具，弹出候选清单（命中关键词的技能默认勾选），确认后把选中技能作为指令注入当前对话，由正在运行的 Agent 自动加载并按其方法论执行。

功能

• 发送键旁常驻按钮：挂在官方 conversation.input.right 槽位（发送/停止键左侧的输入卡工具栏右侧）。
• 自动扫描匹配：读取输入框当前草稿作为「任务描述」，向后端 api/task-assist/scan 发起扫描，对已装技能做关键词打分排序。
• 候选面板：列出技能（可勾选）与 MCP 工具（陈列），支持取消/确认。
• 搜索栏：面板顶部可按名称或描述实时过滤技能列表，配「全选/全不选」对当前筛选结果批量操作。
• 面板可用性：面板用 position: fixed 脱离 composer 的层叠上下文（见下方说明）， 头部与底部按钮吸附（列表再长也够得着 ✕ 和「启动辅助」）， 点面板外任意处或按 Esc 都能关闭，再点一次「辅助」按钮也可收起。
• 自动分析适配技能：面板内的勾选项。勾选后——
  • 打开面板时默认勾中所有命中项，不用自己一个个挑；
  • 更关键的是，之后每条消息发出时都会自动扫描一次技能库，把命中的技能作为 steering 消息随该条消息注入， 完全不用再手动点「辅助」。开关状态存 localStorage（键 dsh-task-assist:auto-analyze），重启后仍记得； 按钮右上角出现小圆点表示已开启。
• 一键注入执行：确认后把勾选技能 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、api/task-assist/auto、api/task-assist/diag，技能/MCP 枚举与打分。
• lib/client.js — 浏览器端：conversation.input.right 槽位组件 + 候选面板 + 发送后自动分析触发。

开发须知（踩过的坑）

写 DSH 插件有几条不吃亏的硬约束，本插件每一条都真栽过，记在这里省得再试：

1. 绝不写 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 兜底。

2. slots.inject 注「槽自身」，不注父槽。 认领 conversation.input.right 要写 slots.inject('conversation.input.right', …)， 而不是 slots.inject('conversation.composer.bar', …)。理由见下方「说明」中的同名条目。 注错槽会让桌面端整体起不来。

3. 标准 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 }。

4. 改完 host 端必须重启整个进程，HMR 不够。 dsh-client-hmr 只热换客户端半体；Node 侧 host 半体只在进程启动时读一次产物。 这会造出「新客户端 + 旧 host」的混合版本态，看起来完全像插件 bug（症状：按钮出现但接口 404）。 核对方法：比对 ~/.dsh/dsh-boot-state.json 里的 bootedAt 与 lib/ 产物的 mtime。

5. 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 在下一步拾取并按所选技能执行

自动路径（勾选「根据文本内容自动分析适配技能」后）：

用户正常打字 → 按发送
  → client 观察到 InputState 从「有草稿」跳到「草稿清空且 draftRev 前进」
  → POST api/task-assist/auto {task: 刚发出的文本, session}
  → host 自己跑一遍 scan，取 score >= 1 的全部命中项
  → 命中则以同样的 steer(message) 通道注入；未命中则静默结束
  → 整个过程不打断发送，失败也只是「这次没帮上」，不影响消息本身

为什么自动路径不劫持发送键。 插件侧没有「消息已发送」事件，也没有受支持的 办法包住 composer 的提交处理器——发送键属于内核自己的 composer entry， 替换它正是此前把桌面端整个拖死的那类改动（槽/组件契约违规会让 fiber FAILED， 整个客户端 boot 拒绝挂载）。所以这里只观察内核已经发布的状态： InputState 的 draft 被清空、draftRev 前进，就是「刚发出去一条」。 这是观测而非入侵：不可能弄坏发送路径；形状若哪天变了，最坏结果也只是自动分析不再触发。

draftRev 同时用于去重——同一次发送会因各组件重渲染而被观察到多次， 必须保证一次发送只注入一次。

说明

• 扫描是只读的：只枚举技能元信息（name/description）与 MCP 工具名，不执行任何技能、不调用任何业务工具。
• 注入是提示级指令（作为 steering 输入进入会话），不是直接代跑技能；是否真的加载/执行由 Agent 按上下文判断。
• 自动分析的门槛是 score >= 1（至少一个任务关键词出现在技能名或描述里），且只作用于自动路径。 面板里的 scan 结果不做这个过滤——面板必须显示全部技能，否则搜索栏就没东西可搜， 用户也无法捞回打分器漏掉的技能。
• 自动路径的空结果（没命中 / 没会话 / 空任务）都是成功，不是错误： 一个匹配不上任何技能的任务是最常见情况，不该给用户弹错误。
• 面板为什么用 position: fixed：本插件的槽位在 composer 的 trailing 组里 （.RlGAzG_trailing{flex:none;margin-left:auto} ← .RlGAzG_standardControls{display:flex} ← .RlGAzG_card{position:relative;border-radius:…}）。 用 absolute 会被定位到那张 card 里、并被限制在它的层叠上下文内 —— ✕ 所在区域会被后绘制的 composer 元素盖住，点击落到上层元素而不是按钮上。 这种情况加 z-index 是没用的，因为面板一开始就在更低的层叠上下文里。 position: fixed 直接相对视口定位（composer 祖先链上没有 transform/filter， 不会劫持 fixed 的包含块），于是面板画在整个 composer 之上、自己收自己的点击； 坐标由按钮实测矩形算出，并夹进视口。
• 面板尺寸与位置必须分开算（"滚轮下滑时面板会变形"的根因）： 尺寸只由视口决定（computePanelFixes()，打开时算一次，此后仅在 window.resize 时重算）， 位置才由锚点 + 冻结尺寸决定（placePanelAt(anchor, width, height)，滚动时 rAF 节流重算）。 之前把高度写成 min(contentHeight, anchor.top - gap, …) —— 而滚动对话时 composer 按钮 会一路往上走，于是面板高度跟着一路收缩（实测 542 → 502 → 452 → 342 → 282）， 正是用户说的"下滑滚轮的时候页面会变化大小"。 准则：浮层可以跟着自己的触发元素移动，但不可以跟着它改变尺寸。 面板保持视口比例的 maxHeight + overflow:auto，长列表在稳定的框里滚动，而不是把框撑开。
• 关闭方式为什么不做遮罩层：全屏 scrim 会吃掉第一次点击 —— 而用户经常是点回输入框继续打字。用「外部 pointerdown + Escape」能达到同样的脱离效果， 又不抢占点击。
• z-index 取值注意：产物里 2147483000 会被打包器折成指数写法 2147483e3， 写测试断言时按数值解析，别用十进制字符串匹配。
• 注入经 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，同分时按此优先级展示。
• 请求围栏只拒绝明确跨站的请求：桌面端 Electron 渲染层的 Origin 是 dsh-app://app， 与 Host（127.0.0.1:<port>）永不相等，严格 origin === host 会把桌面端请求全部 403。

License

MIT