autocode

读代码、写业务文档的 agent。它不写代码,只回答「这段代码在业务上是什么、为什么这么做」, 并把答案维护成一套随代码演进的知识库。

运行要求

• Node.js ≥ 22.5(用到内置 node:sqlite)
• 本机已安装并登录 Claude Code 或 Codex CLI —— autocode 借用它们完成分析, 不需要你另外配置 API Key,代码也不出本机。

安装

npm install -g @ethan.carter/autocode
autocode --help

升级:npm install -g @ethan.carter/autocode@latest。

上手

cd <你的项目>
autocode init          # 建图 + 生成骨架,全程零 AI 调用
autocode wiki          # 生成/更新知识库
autocode check         # 体检:锚点失效、文档孤儿、结论矛盾

wiki 接受自然语言,例如:

autocode wiki "只重写工单创建这条能力"
autocode wiki "先别改文件,告诉我这次会动哪些"

产物落在项目的 .autocode/ 下,代码图落在 .autocode-graph/(建议 git 忽略)。

费用提示

init 与 check 不花钱。wiki 会调用本机 AI CLI,按你自己的订阅计费; 执行前会回显「预计影响多少篇、预计调用多少次」,加上「先别改文件」即可只看计划不落盘。

已知边界

• 入口自动识别覆盖 Go(gin)、TS/JS(Express 系与前端路由)、Python(Django / Flask / FastAPI)、 Java(Spring)。其它框架可在 .autocode/config.yaml 的 entries.manual 里手工声明入口。
• 知识库是 AI 产出:结论都挂了代码锚点便于核对,拿不准的地方它会提问而不是编造, 但重要结论仍建议回代码确认一次。
• 运行时会打印一行 node:sqlite 的 ExperimentalWarning,不影响使用。