[monkey-sking]

背景与痛点 / Background & Motivation

在人机协作和多 Agent 协同任务看板中，存在两个常见的痛点：

1. 难以区分哪些任务正卡在等待人类输入或操作：很多任务需要人类拍板、输入 API Key / 凭据、扫码登录或确认业务方案。此前任务只能标记为通用的红色“阻塞”，或混杂在待办/进行中列，用户无法一眼辨识“哪张卡片在等我处理”。
2. 待验收与已完成任务缺乏直接的交付与验收指引：任务进入 in_review（待验收）或 done（已完成）后，卡片正面没有展示修改了什么文件、自测了什么项。打开详情时，执行报告和验收清单排在描述后面甚至最底部，无法一目了然地看到验收标准和交付成果。

---

核心变更 / Key Changes

1. 待人类操作识别与工具栏过滤（Waiting for Human Action）

• 智能识别机制 (checkNeedsHuman)：支持显式标记（waitingForHuman）、语义关键字启发式识别（如包含“拍板”、“待确认”、“需人工”、“提供 Key”、“扫码登录”等），并能结合评论和执行报错中缺少凭据的特征进行综合判定。
• 卡片正面琥珀橙色醒目徽章：在卡片标题前展示 🙋 需人工: [原因] 徽章，同时卡片带有柔和的警告色边框与渐变底色，扫视看板一眼定位。
• 看板顶部「🙋 待我处理」一键过滤：在工具栏紧急度筛选旁新增过滤按钮，实时统计数量，点击一键过滤全板所有正在等待人类介入的任务。
• 详情页快捷切换：在详情操作栏提供「🙋 标为需人介入」/「✓ 解除需人介入」按钮，支持随时手动切换。

2. 交付审查与验收核对台置顶（Delivery Review & Acceptance Desk）

• 卡片正面展示【交付与验收卡块】：
  • 📄 改动文件：统计改动文件数并展示核心文件名（若无文件记录则显示 未登记改动文件）。
  • ☑ 验收核对依据：展示 Checklist DoD 进度（如 Checklist 3/3 项）或 Agent 自测项数（如 已自验 9 项）；若缺少报告与清单则醒目标记 ⚠ 缺少自验/验收记录。
  • 💡 交付摘要：直观展示 Agent 提交的交付成果总结。
• 详情页【📋 交付审查与验收核对台】置顶：
  • 处于待验收或已完成状态时，将交付报告与验收清单直接置顶在任务描述上方：
    • 🎯 交付成果摘要
    • 📁 修改文件清单：列表清晰展示每个文件路径，提供「复制路径」快捷按钮。
    • 🔬 自验证据（Checks）：展示 Agent 执行的测试与验证结论。
    • ☑ 验收清单（Checklist DoD）：逐项展示验收标准，已勾选条目显示当时留存的 Evidence Note 证据。
    • 📦 产物与风险：展示生成的交付产物与注意事项。
    • ⚠ 未提交预警：若 Agent 未按协议提交报告，置顶黄色警示框，提示核对实际改动。

3. 多语言与样式支持

• 补充完整的 zh.ts 和 en.ts 中英文双语词条。
• 在 styles.ts 中为新增的徽章、卡片高亮、交付卡块和文件复制按钮添加现代协调的样式。

---

验证情况 / Verification

• Node 隔离仿真自测：通过 Node.js 完整模拟 DSH 前端插件沙箱环境加载，验证 apply、inject 及所有组件挂载，无任何未定义变量或运行时异常。
• 真实台账数据回归：对已有真实任务台账中的 16 条任务进行检测：
  • 成功命中“拍板并接入 LifeOS AI 解析后端”、“语音捕获待人工确认”等需要人介入的任务；
  • 正确在待验收和已完成卡片上提取展示改动文件列表、Checklist 勾选证据和交付摘要。

---

[cloader]

感谢你的贡献！卡片上的人工等待提示、「待我处理」筛选，以及交付验收信息前置都很实用。已基于你的版本继续完善，并通过本 PR 合并，保留了你的原始提交和署名。

本次主要补齐了以下内容：

1. 人工等待状态的完整保存与协作支持

   • 补齐后端接口、Agent 工具和台账存储，手动标记刷新后仍然保留，JSON 导入导出也能保留状态。
   • 支持填写、修改等待原因，Agent 也可以主动登记需要用户完成的操作。
   • 人工等待与普通「阻塞」独立保存，解除人工等待不会清除其他阻塞原因。

2. 可明确解除、可恢复自动识别

   • 支持「标为需人介入」「解除需人介入」「恢复自动识别」三种选择。
   • 明确解除后会覆盖关键词推断，避免点击解除后又被自动标回。
   • 自动识别结果标注为「疑似」，收窄识别规则，避免仅因任务提到“登录”“验证码”等业务词就误判；同时排除已完成、已取消、已归档和回收站任务，以及常见的已解决或否定表述。
   • 补齐识别原因的中英文显示。

3. 交付验收信息更加准确

   • 保留卡片交付概览和详情验收信息前置，只将最新一轮执行的报告作为当前交付展示。
   • 旧报告收纳到可折叠的历史记录，并标注执行编号，避免重跑后把旧成果当成新交付。
   • 区分 Agent 自报的改动文件与 Git 统计；未登记文件采用中性提示，兼顾无需修改文件的分析、评审类任务。
   • 验证说明改用中性列表标识，避免把“测试失败”或“尚未验证”等记录统一显示成绿色通过。
   • 补充复制路径失败时的提示，并保留手动选取路径复制的方式。

4. 回归验证与文档

   • 增加状态持久化、人工选择覆盖、列表筛选、历史报告和复制失败等回归测试，更新中英文使用说明。
   • CI 增加独立类型检查；本地全量 534 项测试通过，PR 的远端类型检查、构建和测试均已通过。
   • 使用隔离验证页面在 Edge 中检查了筛选、解除后列表更新和报告展示交互，无脚本错误。

感谢你把这两处协作体验做出来，后续会在这个基础上继续打磨。