在 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 用户。安装前请检查源码与许可证。
