前言¶

DeepSeek Harness（DSH）里的 agent 可以开浏览器、执行命令、改文件，但没法替你接短信验证码、扫二维码、刷脸签字或点授权同意。缺少明确边界时，常见坏行为是假装已登录继续跑、把「请用户输入验证码」写进计划后直接跳过，或让用户对着一长串步骤不知道现在该干什么。dsh-human-step 是社区工作流类插件：开工前标出必须由人完成的步骤，跑到那一步时弹出 DSH 原生问题卡片，等你点「已完成 / 跳过 / 取消」才继续。仓库由 Yyhy110421 维护，许可证 MIT，当前版本 0.1.0。

这是什么¶

一句话：给 DSH 加一道「该你动手了」的暂停键。

宿主工具为 plan_human_steps 与 human_step；设置入口为 设置 → 人工步骤。插件不自动输入验证码、密码或支付信息，也不替用户点授权或支付按钮。

它解决什么问题¶

没有这个插件时，agent 遇到验证码等人机交界步骤容易跳过或虚构完成。装上以后流程是：

1. 先调用 plan_human_steps，把任务拆成步骤并标出哪些必须由人完成（只读，不弹窗）。
2. 执行到人工步骤时调用 human_step，DSH 弹出原生卡片。
3. 用户点「已完成，继续」才继续；点「跳过这一步」会明确标记未完成；点「取消当前任务」时 agent 应停止并汇报。

安装与启用¶

在 DSH 中打开 设置 → 插件管理器，安装下列任一来源（装完重启 DSH）：

github:Yyhy110421/dsh-human-step

本地目录安装示例（实体拷贝，改源码后需卸载再装；插件管理器「更新」仅适用于 npm 注册表插件）：

file:E:\DSH\projects\dsh-human-step

安装前应自行查看 GitHub 仓库 源码与 MIT 许可证。插件在当前 DSH 进程权限下运行，与社区目录 SkillHub 插件页 所列信息一致；该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。DSH 生态理念是「一切皆插件」，本介绍不暗示官方应用商店分发。

典型用法¶

1. 提前标出人工步骤¶

工具：plan_human_steps。

{
  "task": "把演示站部署到线上",
  "steps": [
    { "title": "运行 npm test 并修复失败" },
    { "title": "打开手机接收短信验证码并输入" },
    { "title": "在域名控制台点确认解析" },
    { "title": "部署完成后打开首页检查" }
  ]
}

返回包含 total、humanCount、带 requiresHuman / category / reason 的 steps、humanSteps / agentSteps 拆分，以及可读中文计划 text。这一步不会暂停或弹窗。

2. 到点暂停等用户¶

工具：human_step。

{
  "title": "输入短信验证码",
  "instructions": "打开手机短信，把 6 位验证码填进登录页，然后回来点「已完成」。",
  "category": "verification_code"
}

卡片选项：已完成，继续；跳过这一步（后续可继续，但不得声称该步已完成）；取消当前任务（agent 应停止后续步骤并汇报）。

返回 status 为 done、skipped、cancelled，或 unavailable（当前 DSH 无可用 userQuestions 服务或弹卡失败时，agent 应在对话里请用户完成，不能假装完成）。

3. 步骤类别¶

分类按关键词与少量上下文规则判断，宁可漏判也不把普通步骤硬标为人工。调用方可显式传 requiresHuman: true / false，或传 category 强制指定。

设置与安全边界¶

设置 → 人工步骤 可勾选自动识别类别、追加自定义关键词（如「指纹」「门禁」）、配置是否记录历史及保留条数、清空历史。历史仅存标题、类别、状态和时间，不存验证码、密码或用户填写正文。配置文件位于 DSH_HOME/data/human-step.json，历史在 DSH_HOME/data/human-step-history.json（纯文本，未加密；勿在标题或说明里写敏感信息）。

用户取消任务时 agent 必须停止并汇报。插件不监听用户是否在网页上真实完成操作，只认卡片上的按钮。无 UI 的运行方式可能使 human_step 返回 unavailable；关键词分类可能漏判或误判，显式 requiresHuman / category 优先。

适用谁¶

适合在 DSH 里编排长任务、且流程中穿插登录、2FA、支付、物理操作等必须由人完成的开发者。若你只希望 agent 在对话里口头提醒用户，而不需要原生卡片与计划拆分，可以不装；需要可审计的「停在这里」边界时，这套两个工具的组合更贴切。

结尾¶

dsh-human-step 用规划工具标出人工步骤、用 human_step 在关键点挂起执行，把「等人动手」从计划里的空话变成可确认的交互。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。