前言¶
在 DSH 裏用一句「幫我做個插件」或「修一下報錯」發出去，模型往往會再追問目標、範圍、驗收方式；每一輪澄清都佔對話 token，答偏了還要返工。常見做法是自己在腦子裏補全再寫長 prompt，或直接在對話裏多輪來回——兩種都費事，前者還依賴經驗。
任務澄清器（dsh-task-clarifier）把澄清挪到發送任務之前：在客戶端用短問答補齊關鍵維度，右側實時拼出結構化任務書，再複製或填入新對話執行。澄清過程不調用 Host、不請求模型，頁面指標會標明「本頁澄清 0 token」。它不負責讓模型更聰明，而是儘量讓第一次發出的指令就夠完整。
這是什麼¶
- 名稱：dsh-task-clarifier（任務澄清器）
- 維護者：Sun-0306
- 分類：客戶端（DSH 本地 bundle，純 JavaScript，無構建、無第三方依賴）
- 版本 / 許可：0.1.0 · MIT
- 包名 / patch 行 id：
dsh-task-clarifier/task-clarifier - 目錄頁：skillhub 插件頁
- 源碼：GitHub · Sun-0306/dsh-task-clarifier
一句話描述需求 → 回答若干自適應問題 → 得到可直接使用的 Markdown 任務書。數據只寫入本機瀏覽器 localStorage，不上傳。
核心功能¶
澄清全程在瀏覽器本地¶
意圖分類、事實抽取、選題、任務書組裝、token 估算均爲確定性規則（正則、權重、固定問題庫），無 Host 請求、無模型調用。Host 側 index.js 的 apply() 爲空，不註冊路由、不調用模型。
少問：自動識別句中已有信息¶
從原句識別 URL、路徑、技術棧、篇幅、讀者、風格、禁止項、「當前目錄」等；命中的維度寫入任務書並跳過對應問題，以 chip 展示在問答頁。否定子句不會誤當正事實（例如「不要用 Python，改用 Node」只把 Node 記爲技術棧，並把「不要用 Python」寫入 avoid）。
三種澄清深度¶
| 模式 | 實質問題總上限（含已答） | 說明 |
|---|---|---|
| 快速 | 3 | 目標較清楚、想盡快出發 |
| 標準（默認） | 5 | 多數任務 |
| 深度 | 8 | 一次做對、返工成本高 |
每個意圖另有 4–7 道專屬問題 + 共享題「最看重哪一點」；問題庫共 55 道實質題 + 1 張確認卡。意圖分 10 類（如 build、fix、analyze 等），領域用於追加執行約定（如代碼類「只改相關文件，不做無關重構」）。
標準版與極簡版任務書¶
右側預覽可切換渲染長度，內容同源。標準版按「任務 / 交付物 / 驗收標準 / 執行約定」等章節輸出，空章節省略；極簡版壓成「任務：/ 交付：/ …」一行式文本。「信息不足時」可選：按默認做（默認）、先列假設、或停下來問我——會改寫任務書裏的執行約定文案。
入口與交付對話¶
左側欄與「插件」「定時任務」同列，標籤任務澄清（order: 40）。工作臺爲左問答、右預覽；窄屏上下堆疊。「複製任務書」得 Markdown；「開始執行」把任務書填入新對話 composer 草稿並切到對話頁，不會自動發送。缺少工作區 / 佈局服務時，「開始執行」退化爲複製。
歷史與設置¶
進度、最近 24 條任務、澄清深度 / 風格 / 假設策略等存於 localStorage（鍵名如 dsh-task-clarifier.session.v1、history.v1、settings.v1）。卸載插件不刪瀏覽器站點數據。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議自行查看源碼與 MIT 許可證。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
本機 bundle 安裝示例（路徑需換成你機器上的絕對路徑）：
plugin_manager action=install_bundle target=/Users/sunchujun/Desktop/deepseek/dsh-task-clarifier
也可在 Web GUI「插件 → 添加插件」選擇本地目錄。安裝後重啓 DSH 並刷新頁面，左側出現「任務澄清」。依賴 DSH Web 客戶端的插槽、佈局、工作區、側欄與語言服務（package.json 中 dsh.client.inject 已聲明）。
升級：改源碼或 package.json、cordis.patch.yml、locale 後需重啓 DSH 應用（僅刷新頁面不夠）。卸載：
plugin_manager action=remove_bundle target=dsh-task-clarifier
然後重啓 DSH。
典型用法¶
下面按 README 中的流程操作即可復現。
- 在起始頁用一句話描述任務。
Enter開始澄清，Shift+Enter換行；可點示例填入，或「跳過提問，直接整理」只生成任務書。 - 查看頂部「已自動識別」chip，逐題回答；選項可用
1–9或點擊，文本題用⌘/Ctrl+Enter提交；不確定可「跳過，你決定」。 - 確認卡「確認一下，我理解得對嗎？」覈對理解，點「對，生成任務書」；右側隨答實時更新預覽，可隨時切標準 / 極簡。
- 「複製任務書」或「開始執行」；發送仍由你在對話裏按 Enter 確認。
問答頁可隨時「直接生成任務書」（至少答過一題）；完成卡可「繼續回答」或「繼續補充」備註。
適用場景與注意¶
適合：習慣先寫一句模糊需求、希望在進對話前把交付物、範圍、驗收和執行約定寫清楚的人；希望減少「澄清輪次」token、又願意花幾分鐘點選問答的人。
注意：
- 澄清只做結構化整理，不做語義理解（見項目 README「已知限制」）；省的是澄清這一段的 token，執行任務的那次對話仍正常消耗 token。
- 指標行的 token、完整度、「預計少問輪數」爲啓發式估算，不是計費數據。
localStorage禁用或寫滿時寫入可能靜默失敗；換瀏覽器或清站點數據後歷史不跟隨。
開發自測（在插件目錄下，路徑按本機調整）：
cd /Users/sunchujun/Desktop/deepseek/dsh-task-clarifier
node --test tests/engine.test.mjs tests/review.test.mjs
預期：tests 66 / pass 66 / fail 0。
結尾¶
dsh-task-clarifier 在客戶端用固定問題庫和規則，把一句話收成可執行的 Markdown 任務書，澄清階段 0 次模型調用；與 DSH「一切皆插件」的做法一致，作爲側欄工作臺接入，不替代對話本身。
- 目錄頁：https://www.skillhub.cn/plugins/Sun-0306/dsh-task-clarifier
- GitHub：https://github.com/Sun-0306/dsh-task-clarifier
