cot-lint：检测代码仓库中的思维链泄露

智能体在编码时，往往会在代码周围留下“会话记录残留物”。这些痕迹是思维链的泄露，表现为对已关闭会话的引用、版本变更的叙述，或者是在文档中讨论设计决策的片段。只有当时在场的人才能理解这些内容，普通审阅者会感到困惑。cot-lint 专门用于检测并修复这些泄露。

是什么¶

cot-lint 是一个用于检测代码仓库中思维链泄露的 Linter。它针对的是智能助手在文档、注释和 JSDoc 中留下的会话记录残留物。

• 所属类别：admin-security
• 维护者：YuanyuanMa03
• 许可证：MIT
• 定位：零依赖的命令行工具，支持 Node.js 环境。

核心功能¶

1. 检测思维链泄露：识别文档和注释中的思维链残留，这些内容在脱离特定会话上下文后将变得不可理解。
2. 识别过时引用：定位死掉的引用，例如设计会话的引用（如 design §4.7）、栈或 PR 中的特定视角、以及版本标记（如 v1 refactor）。
3. 包含修复技能：插件内置了 cot-trim 修复技能，用于自动清理和修正发现的泄露。
4. 零依赖：无需安装额外依赖，兼容 Node.js >= 20。

安装与启用¶

通过 DeepSeek Harness 的插件系统安装：

dsh plugin add cot-lint

安装后，cot-trim 技能会通过插件的技能提供者加载，可用于自动修复发现的泄露。

典型用法¶

cot-lint 支持多种命令行参数，以适应不同的扫描场景。

基础扫描¶

扫描仓库中的 Markdown 和散文文件：

npx cot-lint

机器可读输出¶

用于 CI 或 Agent 处理，输出 JSON 格式：

npx cot-lint --json

扩展文件扫描¶

指定文件扩展名进行逐行扫描，例如 TypeScript 和 Python：

npx cot-lint --ext ts,py

深度扫描¶

包含隐藏目录（如 .agents/）：

npx cot-lint --hidden

退出码说明¶

• 0：仓库检查通过，无泄露。
• 1：发现泄露或需要修复的问题。
• 2：用法错误或参数错误。

适用场景与注意事项¶

• 适用场景：任何使用智能体辅助编码的团队，需要在代码审查前过滤掉临时的思维痕迹；或者需要保持文档整洁的 CI 流程。
• 注意事项：
  • 插件以当前 dsh 进程的权限运行。
  • 需要确保本地环境 Node.js 版本 >= 20。
  • 插件默认豁免部分内容，不会误报：
    • Issue 引用。
    • 标记为 TODO / FIXME / XXX 的内容。
    • 引用 RFC 等外部标准的 § 引用。
    • 包含 cot-lint-ignore 注释的行。

总结¶

cot-lint 将发现与修复（cot-trim）结合在一起。它通过严格的规则判断哪些内容是必须保留的（如标准的 RFC 引用），哪些是必须删除的思维链残留。这有助于保持代码库的文档整洁，使代码对未来的维护者具有可读性。

• 插件目录页
• GitHub 仓库