前言¶
在 DeepSeek Harness（DSH）裏做軟件設計時，界面改完是否「真好用」，往往仍靠開發者自己點一遍，或交給自動化腳本。前者難復現、難審計；後者容易繞過真實交互路徑，也談不上「像用戶那樣用」。下面介紹社區插件 software-design-test（維護者 Inceptzws）：它把「模擬真實用戶測試」收成一套可執行流程——人物與場景、可執行任務卡、三級真實輸入模式，以及以錄屏與截屏爲據的判斷方式，且明確不做輸入注入。
這是什麼¶
software-design-test 是一個 DSH bundle 插件，重心是「怎麼模擬真實用戶來測軟件」。裝上後，Agent 會先走權限閘門，再按人物、場景、任務卡與測試內容清單，用真實鼠標鍵盤操作，並用畫面證據給出可復現的缺陷報告。許可證爲 MIT；README 標明其爲社區項目，與 DeepSeek AI 無隸屬關係。npm 包當前版本爲 1.2.1（以 package.json 爲準）。在 DSH Plugin Hub 等目錄中可找到收錄頁；能力分類在 README 中記爲「技能與智能體（Skills & Agents）」。
核心功能¶
插件的設計約束在 README 裏寫得很清楚，可概括爲以下幾點。
- 人是唯一的手：只用真實鼠標與鍵盤，按 L1 僅鼠標 → L2 鼠標+鍵盤禁快捷鍵 → L3 可快捷鍵 三級模式推進，配合出聲思維式執行。
- 屏幕是唯一的證據：從錄屏/截屏觀察元素是否完好、工具是否可用；代碼與日誌僅作線索。
- 零輸入注入：不注入鼠標/觸摸/按鍵事件，不驅動自動化框架，不調用軟件內部句柄；倉庫 CI 含「包內不存在輸入注入 API」類斷言。
- 先問權限再動手：鼠標、鍵盤、錄屏、截屏與系統權限逐項詢問，未答覆不開始；可選只讀守門器觀察是否有注入類工具在跑。
- 可本地審計：證據落在會話目錄；技能內容、問卷、報告模板與文檔爲中英對照。
運行要求方面，README 註明：零依賴、零構建、不聯網；只寫會話目錄；Node ≥ 20.11；capture 腳本覆蓋 macOS、Windows、iOS 模擬器與 Android。兼容 DeepSeek Harness 0.2.0-rc.2（維護者本機實測）。權限側：需要截屏/錄屏相關能力；README 寫明不需要輔助功能、輸入監控、自動化等控制權限。
安裝與啓用¶
安裝命令須與 README 一致，可按渠道擇一使用。
從 npm 安裝（預構建，無需構建授權）：
dsh plugin --profile web add software-design-test
dsh plugin --profile desktop add software-design-test
從 GitHub 安裝（源碼直裝；包爲零依賴零構建）：
dsh plugin --profile web add github:Inceptzws/software-design-test
本地開發或改源碼時，可用 Release 中的 tarball，或 link: 指向本地目錄（詳見倉庫 docs/INSTALL.zh-en.md）。
安裝後重啓 Harness，並用下面命令確認是否掛載成功：
grep -n "software-design-test" ~/.dsh/profiles/desktop/package.json
README 說明：依賴裏出現對應條目、dsh.profile.bundles 中有同名條目即表示掛載；在 / 菜單或 skill 工具裏能看到插件技能是更可靠的確認方式。
典型用法¶
在對話裏觸發¶
- 直接說觸發詞
模擬真實用戶測試（英文：simulate a real user test/run a real-user simulation test）。插件會進入真實模擬測試：確認對象 → 權限問卷 → 建會話開跑。 - 也可以說「用 software-design-test 測一下 \<應用名>」，或從
/菜單選擇software-design-test。 - 回答權限問卷（鼠標、鍵盤級別、錄屏、截屏、麥克風、系統權限、範圍、數據邊界、合規確認）。
- 建會話後，按 L1→L2→L3 執行，逐條落盤，最後生成中英對照報告（含未驗證項、權限缺口、跨模式差異、注入觀察等）。
更完整的對話模板與 FAQ 見倉庫 docs/USAGE.zh-en.md；框架設計見 docs/FRAMEWORK.zh-en.md。
CLI 會話示例¶
在插件目錄下，README 給出一條可復現的腳本鏈路，用於初始化會話、過閘門、採集與出報告：
cd software-design-test
node scripts/session.mjs init ./ui-test-demo-2026-10-04 --platform macos --app "Demo"
node scripts/session.mjs gate ./ui-test-demo-2026-10-04 --mouse yes --keyboard L2 \
--screen-recording yes --screenshot yes --compliance yes
node scripts/capture.mjs check
node scripts/guard.mjs scan ./ui-test-demo-2026-10-04
node scripts/capture.mjs record ./ui-test-demo-2026-10-04 --label L1 --seconds 60
node scripts/report.mjs build ./ui-test-demo-2026-10-04
未通過權限閘門時，測試不會開始；報告構建會彙總測試內容分佈與中英對照結論。
適用場景與注意¶
適合誰： 在 macOS、Windows、iPhone、iPad 等交互環境下做軟件設計或 UI 迭代，需要可審計的「真人路徑」探索測試、任務卡驅動走查，以及基於畫面證據記錄斷頭路、繞路、誤導與狀態問題的團隊。
使用前注意：
- 插件以當前 DSH 進程權限運行；安裝前應自行查看 GitHub 源碼 與 MIT 許可證，確認符合你的合規與數據邊界要求。
- 涉密界面默認不錄等邊界應在權限問卷中明確；證據僅存本地會話目錄。
- DSH 生態理念是「一切皆插件」；dsh-plugin.org 等社區目錄爲獨立收錄站點，並非 DeepSeek 或幻方官方應用商店。
結尾¶
software-design-test 的價值可以概括爲一行：讓 Agent 像真實用戶一樣測軟件——權限閘門 → 人物/場景/任務卡 → 真實操作 → 錄屏截屏證據 → 可復現缺陷報告。若要安裝或查閱維護者文檔，可訪問目錄頁 skillhub.cn/plugins/Inceptzws/software-design-test 與倉庫 github.com/Inceptzws/software-design-test。
