在 DeepSeek Harness（DSH）的開發流程中，代碼倉庫裏的 TODO、FIXME 等標記往往散落在不同文件中，難以統一追蹤和梳理。本插件通過遞歸掃描本地代碼，將標記轉化爲結構化清單，並提供狀態管理與導出能力，輔助 Agent 與開發者管理技術債。
這是一個 DeepSeek Harness 客戶端插件，由 zhaoxuejie 維護。它遞歸掃描本地項目目錄中的標記（如 TODO、FIXME 等），生成結構化清單與統計，支持狀態管理、Markdown 導出，並在側邊欄展示「TODO 雷達」面板。
核心功能¶
- 遞歸掃描本地代碼標記。
- 生成結構化清單與統計。
- 支持狀態管理（pending / in_progress / done / ignored）。
- Markdown 導出。
- 側邊「TODO 雷達」面板。
- Host 側註冊 8 個工具。
安裝與啓用¶
使用官方 profile bundle 形式安裝：
dsh plugin --profile <name> add dsh-plugin-todo-scanner
Host 側工具¶
插件在 Host 側註冊了 8 個工具，供大模型調用：
todo_scan: 掃描目錄中的代碼標記。todo_list: 獲取當前會話清單，支持篩選與排序。todo_get: 獲取單條條目詳情（含代碼上下文）。todo_update_status: 更新單條狀態。todo_batch_update: 批量更新狀態。todo_export: 導出 Markdown 任務清單。todo_stats: 查看會話掃描統計。todo_clear: 清空當前會話的掃描結果與狀態。
典型用法¶
在 Agent 交互中，可以通過以下指令操作：
- 掃描：調用
todo_scan掃描當前目錄代碼標記。 - 查看：調用
todo_list獲取清單並按狀態篩選。 - 更新：調用
todo_update_status將某條 TODO 標記爲done。 - 導出：調用
todo_export生成 Markdown 文件。
配置與注意¶
- 安全與隔離：插件採用只讀掃描，結合白名單與系統目錄黑名單進行防護。狀態僅存內存，按會話隔離，卸載插件即清空。
- 環境要求：要求 Node.js >= 20，且僅支持 npm。
- 網絡限制：面板數據通過本地 HTTP 輪詢獲取（端口見配置
server.port），默認僅監聽127.0.0.1，要求 Client 與 Host 同機。
結語¶
該插件通過結構化手段解決了代碼標記分散的問題，適合需要在開發過程中集中追蹤技術債的 DSH 用戶。安裝前請檢查源碼與許可證。
