Archprint 是一个从 TypeScript 仓库真实 import 图推断架构规则，并将有证据支持的规则自动写入现有工具链的工具。它的核心目标不是给项目套用一套外部规则手册，而是先勘查代码实际如何构建，再把已经遵守的边界变成自动检查，让架构漂移在编辑器和 CI 中被发现，而不是数周后才在评审中暴露。
用途 它面向开发者、技术负责人、代码评审者，以及使用 AI 编码代理的团队。对前者，它生成带证据的 ESLint 和 dependency-cruiser 规则；对评审者，archprint check 只标记一次变更新引入的规则破坏，不翻旧账；对 AI 代理，它通过 MCP 提供项目规则及证据；对任何评估代码库的人，它给出项目实际结构的诚实画像。
主要能力 Archprint 会扫描 TypeScript 项目，识别代码已经遵循的规则，并展示每条规则的证据：遵守文件数量、破坏文件、置信度。它使用 Wilson 分数下界进行统计置信判断，将每条规则分为 AUTO（可强制）、SUGGEST（暂定，供审查）或 REJECT（信号不足）。只有机械信号明确的规则族会被默认信任并自动生成，包括禁止导入（AP-001、AP-002）、循环依赖、测试隔离、导入风格、console 隔离和公共 API barrel；结构类规则族（如层级、角色边界、UI/数据分离、入口纯净性、服务端/客户端、功能切片隔离、环境变量访问、工作区包 API、stories 隔离、依赖卫生与依赖声明）默认保留待审查，只有加上 --include-structural 才写入强制配置。它还能识别 Next.js、Nest、SvelteKit、Nuxt、Remix 等技术栈，并对 React、Angular、Vue、Svelte 组件进行分类，使组件相关规则跨框架适用。
使用方式 要求 Node 20 或更新版本，在含有 tsconfig.json 的目录中运行。常用命令包括 init、wire、generate、generate --check、eject、migrate、check、allow 等。init 生成配置并连接，wire 将托管引用插入现有强制执行工具，eject 可移除 Archprint 的文件及所有 wired 引用并恢复配置原状。archprint generate --check 可在连接前先跑生成的 ESLint 规则验证是否通过。规则会写入 .archprint/config.json，以及在检测到 ESLint 或 dependency-cruiser 时生成对应的 .archprint/eslint.mjs 或 .archprint/dependency-cruiser.json。--expand 还会额外写入按规则卡片、fixtures、ts-arch 测试以及 Mermaid 和 Graphviz DOT 层级图。monorepo 中 scan 和 recommend 可接受根目录并覆盖所有应用，而 init 和 generate 一次只针对一个应用。也可通过 npm install --save-dev archprint 安装到项目中。
适用场景 适用于希望把代码库中隐性架构边界变成可执行检查的 TypeScript 团队；希望审查只关注新增破坏而不被历史 backlog 淹没的代码评审流程；希望通过 MCP 让 AI 编码代理在写代码前了解项目规则并自行检查变更的团队；以及需要快速了解一个项目实际结构的评估者。在 CI 中，archprint check 可比较基线分支并只报告本次变更引入的违规，在 GitHub 上以内联方式显示在拉取请求中，默认仅警告，可用 --fail-on new 改为失败。
限制 Archprint 只报告，强制仍由项目的 linter 执行。循环依赖目前只报告结果而不写入规则。涉及结构推断的规则可能因路径推断错误而不可靠，因此默认不强制。统计置信度基于文件数量与遵守比例，小型仓库证据可能不足。目前未提供具体收费、价格或平台限制信息。
