arch-doc

接手一个陌生仓库通常是一场猜谜游戏：哪个目录是核心模块、谁依赖谁、入口点在哪里、到底怎么跑起来——答案往往藏在过时的 README 里，或者只在同事的脑子里。arch-doc 把这件事变成一句话的事：给它一个仓库路径，它自动识别项目类型、语言和构建系统，然后生成一份结构化的架构文档，涵盖模块职责、内外部依赖（附 Mermaid 依赖图）、入口点识别（覆盖 CLI、Web、Worker、Scheduler、Library 五种形态）以及从安装、开发到构建、测试、部署的完整运行链路。

输出刻意追求实用：一份按统一模板生成、结构清晰的 ARCHITECTURE.md，一份可直接喂给下游工具的 architecture.json，以及一棵独立的 module-dependencies.mmd 依赖图文件，可以原样丢进文档或 PR 描述里。即使没有 Node 运行时，插件也会自动降级为基于 shell 的探测流程，保证链路不断。

它适合正在上手新代码库的开发者、需要补全架构说明的技术负责人，以及任何希望在 Agent 工作流中加入一步可靠自动架构分析的 DSH 用户。