Architec完整项目架构分析
对整个代码库做结构化审阅，输出总体分数、热点文件、组件风险与架构摘要。
archi .Archi 功能介绍
Archi 基于规则与语义对代码库进行全面分析，建立结构索引，识别架构热点，并为新需求与未来演化提供可执行的架构建议。
它是什么
Archi 是一个面向复杂工程的架构分析 CLI。它会先结合 Hippo 为项目建立索引结构，再读取规则结果、语义理解、变更上下文与历史热点，把原本分散在代码树里的信息整理成可执行的架构视图。这个视图既能给人看，也能继续交给 Codex / Claude 使用。
它解决什么问题
大型工程最难的不是写代码，而是在改动前真正理解系统。Archi 的意义，是在你动手之前先给出一张结构化地图：哪些模块最脆弱、哪些变更风险最高、哪些边界已经开始漂移、哪些文件只是局部问题而不是系统问题。
核心能力
目标驱动分析
围绕具体目标组织架构判断，例如重构、边界收敛、模块拆分或接入新能力。
archi --goal "优化支付模块边界" .增量变更分析
只看当前变更对系统结构的影响，适合提交前审查或持续集成场景。
archi --diff --base main --head HEAD .环境与配置自检
在真正分析之前先验证 Hippo bundle 与后端 LLM 配置是否可用。
archi --check .为什么值得使用
减少盲改
先看系统边界、组件关系和热点风险，再决定从哪里改，避免一上来就在局部文件里碰运气。
提升 AI 输出质量
Codex / Claude 最怕缺少全局上下文。Archi 通过 skill 把结构视图、热点问题与优化方向交给 AI，帮助后续优化、重构、设计与未来编程。
你会得到什么结果
.hippocampus 目录
这里保存项目结构索引、签名抽取、依赖关系与基础中间结果，是 Archi 继续理解工程的底层输入。
.hippocampus/.architec 目录
这里保存架构分析结果、热点判断、可视化与报告输出，使用者和 AI 助手都可以直接参考。
.architec/怎么使用
1. 安装
根据当前系统选择对应安装命令。安装器会自动拉取 Archi、Hippocampus、LLMGateway，并写入默认配置模板。
macOS / Linux
curl -fsSL https://www.architec.top/downloads/latest/install_prod.sh -o install_prod.sh && bash install_prod.shWindows PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -Command "$i=Join-Path $env:TEMP 'install_prod.ps1'; Invoke-WebRequest 'https://www.architec.top/downloads/latest/install_prod.ps1' -OutFile $i; & $i"2. 授权
执行 archi login。首次可选择浏览器授权或激活码授权，后续按默认方式直接进入。
CLI
archi login3. 建立项目上下文
先用 hippo . 建立项目结构索引，再用 archi . 读取结构、热点、组件与历史信息生成架构视图。
项目根目录
hippo .
archi .4. 交给 AI 助手使用
重启 Codex / Claude，让技能同步完成，再基于 archi 结果做优化、评审、拆分与演化决策。
Skills
/archi-full
/archi-diff
/archi-goal命令参考
查看当前版本与更新状态
archi --version登录授权当前设备
archi login查看完整命令帮助
archi --help更新到最新版本
archi update参数能力总览
path项目根目录。默认传入当前目录，最常见的用法就是 archi .
--goal GOAL按目标组织分析，比如重构、边界收敛、模块拆分、性能治理。
--diff进入增量变更模式，只分析当前 git 变更带来的结构影响。
--base BASE / --head HEAD与 --diff 配合使用，指定比较区间。
--component COMPONENT保留参数，用于后续组件级提示。
--format {json,md,html,all}指定输出格式，适合接入报告归档、自动审阅或网页查看。
--refresh-from-hippo校验并刷新 Hippo bundle 相关输入，适合更新项目结构后重跑。
--open-browser保留参数，当前实现仍以生成 HTML 报告为主。
--check只做环境与后端 LLM 配置校验，不执行正式分析。
--out OUT覆盖默认输出路径，方便接入外部脚本或 CI。
--skip-auth仅用于本地开发绕过授权门禁，不是正式用户路径。
--version查看当前安装版本、线上最新版本，以及是否需要更新。
上面的命令参考直接来自当前 CLI 的真实能力边界：--version、--goal、--diff、--check、--out、--refresh-from-hippo 等都已经在当前版本可用。
想查看更完整的参数说明，请直接运行 archi --help。