前言¶
DeepSeek Harness (DSH) 的插件生态正在快速发展。在智能体开发中,一个常见痛点是聊天记录中的信息碎片化,以及缺乏结构化的任务状态管理。与其在聊天中逐条追踪需求,不如将其转化为结构化流水线。这就是“老板任务面板”的切入之处。
插件定位¶
这是一款运行在 DSH 里的任务面板插件,由用户 lihang-lh 维护。它旨在将“聊天气泡”升级为“任务流水线”,让你在 AI 时代只负责发布和验收,具体的规划、澄清、开发、复核全部由插件动态调度子代理完成。
核心功能¶
插件提供了从需求发布到最终验收的全流程管理能力:
任务流水线(七个状态)¶
任务状态机包含七个节点,每个节点对应不同的代理和操作:
1. 待领取 (todo):任务已登记,等待插件领取或排队执行。
2. 待澄清 (clarify):规划代理发现需求不明确,产出问题清单,等待人工回答。
3. 待确认 (confirm):规划代理已产出计划,等待人工确认(仅在关闭“自动确认”时出现)。
4. 开发中 (develop):开发代理正在执行任务。
5. 暂停中 (paused):人工暂停后进入,可恢复或重新编辑。
6. 复核中 (review):自动复核通过(零遗留问题)后进入,等待人工验收。
7. 已完成 (done):人工验收通过。
自动蒸馏历史会话¶
发布任务时,插件会利用 sessionQuery.searchSessions 对全部历史会话进行全文检索。匹配度高的旧会话会被自动挂载到任务上,并在面板中提供勾选功能。开发/规划代理在执行前会读取这些上下文,实现“接着上次的会话继续做”。
阶段化子代理调度¶
插件内部调度四个阶段的子代理:
* 规划代理:读取历史会话,产出实施计划(plan, steps, risks, questions)。
* 澄清代理:在需求不明确时产出问题清单。
* 开发代理:按计划实施,要求给出可验证证据(如勾选 tasks.md 项),并处理截图。
* 复核代理:对照验收标准和任务清单自检,任何遗留问题即视为复核未通过。
自动读取器¶
每个阶段都有对应的“自动读取器”驱动流转:
* 领取读取器:任务进入待领取且有空闲名额时启动规划。
* 开发读取器:规划确认后启动开发。
* 复核读取器:开发完成后启动,零问题则转复核,有问题则打回开发(上限 3 轮)。
* 恢复读取器:每 20 秒巡检,检测到子会话不在线时标记“可重新执行”。
原生 App 截图支持¶
支持 iOS 和 Android 的真机或模拟器截图。开发/复核代理会根据仓库类型自动调用对应工具:
* Android:adb exec-out screencap
* iOS 模拟器:xcrun simctl io
* iOS 真机:idb screenshot / idevicescreenshot
如果设备未连接或工具缺失,代理会如实报告并标记任务为“待接设备”。
OpenSpec 产物生成¶
计划定稿时,插件会在目标仓库的 <repoPath>/specs/proposals/<任务id>/ 目录下生成标准化的 OpenSpec 产物:
* proposal.md:背景、方案、风险、验收方式。
* tasks.md:编号任务清单,开发代理逐项勾选。
面板 UI¶
- 入口:DSH 侧边栏底部新增按钮(设置上方)。
- 交互:右侧浮层面板,支持拖拽宽度(400-1100px)。
- 信息展示:各 Tab 显示计数,卡片展示状态点、结论徽标、进度条、复核报告、截图缩略图。
- 会话管理:点击可跳转到发布会话、规划会话、开发会话或历史关联会话。
典型用法¶
- 发布任务:在面板点击“发布新任务”,填写标题、描述和验收标准。插件会自动扫描关联历史会话,勾选后发布。
- 处理待澄清问题:任务进入“待澄清”状态后,展开卡片查看规划代理提出的问题,逐条回答。回答完成后,规划代理会结合回答重新定稿计划。
- 验收结果:任务进入“复核中”状态时,面板显示“可验收”或“有问题”徽标。展开卡片查看复核报告、遗留问题清单和验收截图。
- 任务管理:在任意非“已完成”阶段,可点击“暂停”进入“暂停中”Tab;也可点击“重新编辑”修改需求,旧计划将被清空。
局限与注意事项¶
- 执行模式:当前开发阶段为串行模式,默认同一时间只跑 1 个开发任务,其余在“待领取”排队。
- 发布方式:暂未接入
task_publish模型工具,目前仅支持通过面板发布任务。 - 通知方式:目前仅靠面板角标与计数显示,暂不支持飞书或邮件推送。
- 历史会话检索:当前蒸馏仅支持关键词/全文检索,后续计划引入 LLM 语义摘要。
- 原生依赖:原生 App 截图功能依赖
adb、xcrun、idb等工具与设备连接。
插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证。