前言¶
DeepSeek Harness（DSH）裏的 agent 可以開瀏覽器、執行命令、改文件，但沒法替你接短信驗證碼、掃二維碼、刷臉簽字或點授權同意。缺少明確邊界時，常見壞行爲是假裝已登錄繼續跑、把「請用戶輸入驗證碼」寫進計劃後直接跳過，或讓用戶對着一長串步驟不知道現在該幹什麼。dsh-human-step 是社區工作流類插件：開工前標出必須由人完成的步驟，跑到那一步時彈出 DSH 原生問題卡片，等你點「已完成 / 跳過 / 取消」才繼續。倉庫由 Yyhy110421 維護，許可證 MIT，當前版本 0.1.0。
這是什麼¶
一句話：給 DSH 加一道「該你動手了」的暫停鍵。
宿主工具爲 plan_human_steps 與 human_step；設置入口爲 設置 → 人工步驟。插件不自動輸入驗證碼、密碼或支付信息，也不替用戶點授權或支付按鈕。
它解決什麼問題¶
沒有這個插件時，agent 遇到驗證碼等人機交界步驟容易跳過或虛構完成。裝上以後流程是：
- 先調用
plan_human_steps，把任務拆成步驟並標出哪些必須由人完成（只讀，不彈窗）。 - 執行到人工步驟時調用
human_step，DSH 彈出原生卡片。 - 用戶點「已完成，繼續」才繼續；點「跳過這一步」會明確標記未完成；點「取消當前任務」時 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 強制指定。
| id | 中文 | 典型場景 |
|---|---|---|
| verification_code | 驗證碼 / 二次驗證 | 短信碼、郵箱碼、2FA、OTP、人機驗證 |
| qr | 掃碼 | 微信掃碼、掃碼登錄、掃設備碼 |
| phone | 電話 / 短信 | 打電話、接聽、接收短信、電話確認 |
| 郵箱確認 | 打開郵箱、點郵件裏的鏈接、回覆郵件 | |
| identity | 實名 / 人臉 / 簽字 | 身份證、刷臉、活體、手寫簽名 |
| credential | 密鑰 / 密碼 | API Key、Token、密碼、私鑰 |
| payment | 支付 / 下單 | 付款、轉賬、購買、充值、確認訂單 |
| login | 登錄 / 授權 | 登錄賬號、輸入密碼、同意授權 |
| physical | 物理操作 | 插拔設備、按按鈕、重啓、拍照 |
| approval | 人工確認 / 選擇 | 必須由用戶拍板、選擇或批准 |
設置與安全邊界¶
設置 → 人工步驟 可勾選自動識別類別、追加自定義關鍵詞（如「指紋」「門禁」）、配置是否記錄歷史及保留條數、清空歷史。歷史僅存標題、類別、狀態和時間，不存驗證碼、密碼或用戶填寫正文。配置文件位於 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 倉庫。
