前端、网关、后台线程与数据库堆叠在无序矩形里,节点超过 15 个即彻底失去可读性。
让 AI 读懂仓库源码,画出真实的空间架构。
装进你的 AI 编程助手,让它直接通读项目源码,几秒生成可交互的 3D 与 2D 空间架构图。
- Claude Code
- Cursor
- Antigravity
- Codex
- Pi
实机在线沙盒:真单文件 HTML 即刻把玩。
上方还原 AI 编程会话指令,下方直接内嵌由 FreshMart 示例构建的真实离线 HTML 产物。
从你想审视的架构层开始,支持全部查看与跨端自由组合。
一条命令看全部 10 层,也可以只看前端、后端或数据,或用逗号自由组合;未选中的上下游会保留为半透明上下文。
> /archray all
或对 AI 说“用 archray 画全部 10 层全景” · 构建参数 --layers all
全栈十层全景视角
分析一次仓库源码即可任意切片:同时查看前端、网关、后端服务、异步队列、AI、外部 SaaS 与数据库,也支持 --lang、doctor 与 update。
在实机沙盒中查看该层 →10 层与自由组合 展开后可单层选择或拼接
精准消除传统架构图的五大乱象。
一次切换,五格同时从通用 AI 草图缺陷变为 ArchRay 的确定性解法。
缺少 schema 校验与源码引用约束,架构图看似完整却与真实代码脱节。
无法一眼分辨存储基座、异步任务流与三方外部依赖的技术角色。
画完即止,无法辅助技术债治理、框架升级或云服务平替决策。
浏览器手动截图只剩局部残片,依赖在线制图服务又无法通过安全合规审查。
围绕你的真实工程构建,而非演示玩具。
页面所见均由真实仓库源码提取:玩具画法只有 4 个手绘方块、没有行号引用;ArchRay 直接读取真实代码,经数千文件 Monorepo 验证并区分实测与估算(≈)。
高密子包默认 +N 折叠,196ms 完成 ELK 确定性布局,60fps 流畅缩放。
apps/web · packages/features · 196ms
定位订单服务 6,200 行同步锁热点,给出 Passport → Clerk 平替方案与迁移 Prompt。
apps/api/src/order/order.service.ts
精准映射 App Router、Prisma 与 Stripe 轨道,并捕获 JWT_SECRET 回退高危项。
middleware.ts · prisma/schema.prisma
AI 负责语义阅读,引擎负责确定性几何。
大模型从不直接手写 SVG 坐标,只提取经源码验证的模块与证据;布局与三维投影全由确定性引擎完成,零全局污染(.archray/ 可随时卸载)。
每一处结论都留在仓库可审计的 JSON 里。
图谱保存为 .archray/graph.json 与 view.json 随 Git 演进,实测值与静态估算(≈)诚实分标,支持无裁切整图与离线扫码海报导出。
安装 ArchRay
30 秒装入目标项目根目录,开启新会话输入 /archray,第一张空间架构图即刻生成。
- 01不修改业务源码
- 02CLI、viewer、Skill 自包含在 .archray/tool
- 03保留 graph/view/index,可随时更新或卸载
第一步:复制安装命令,在项目根目录运行
$ curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh | sh -s -- . claude
第二步:安装好后,复制这句话对你的 AI 说
用 archray 画一下这个项目的架构(或直接输入 /archray)
日常自检、升级与干净卸载
$ ./.archray/archray doctor && ./.archray/archray update --check
常见问题
关于 ArchRay 的能力、数据边界、宿主和更新方式,先看这几条。
ArchRay 是什么?
ArchRay 是 AI 优先的架构可视化工具。安装到仓库后,在 AI 助手里输入 /archray,它会读取真实源码并生成可分层、可交互、可离线分享的 3D/2D 单文件 HTML。
会上传我的源码吗?
不会。分析发生在你授权使用的 AI 编程助手会话里,产物保存在本地 .archray 目录;HTML 是自包含离线文件。只有主动执行 update 时才会访问 GitHub Releases 读取版本和校验文件。
支持哪些 AI 宿主?
支持 Claude Code、Cursor、Antigravity、Pi 和 Codex。Claude/Cursor/Pi 使用 /archray,Codex 使用 $archray 或 /skills。安装时可用 --agent all 或逗号列表。
如何安装和更新?
从 GitHub Releases 下载安装包或运行 bootstrap install.sh,安装到目标仓库根目录。安装后使用 ./.archray/archray update --check 检查,再用 update 应用更新;旧版 v0.4 需要一次 bootstrap 升级。
它和普通 AI 架构图有什么区别?
ArchRay 把语义事实和确定性布局分开:AI 记录源码证据与依赖,布局引擎计算坐标和 3D/2D 投影。它强调可追溯路径、离线交付、分层查看、健康度和可替代性,而不是让模型直接画一张不可复现的图。
它适合哪些仓库?
适合需要理解真实分层、跨层依赖、技术债或迁移评估的仓库,尤其是希望把架构图离线分享给团队的项目。它不是运行时监控或自动扫描器;没有源码证据、只靠描述的图需要额外复核。
隐私协议与合作联系
代码资产永远留在你的本地仓库;开源共建、企业定制或技术交流欢迎直接联系。
ArchRay 隐私与数据安全声明
- 1. 业务源码与图谱 100% 本地零上传 ArchRay CLI 与构建生成的单文件 HTML 完全在本地离线运行,绝不向 archray.dev 或任何远端服务器上传源码、目录名、环境变量或架构数据。
- 2. 宿主 AI 会话隔离与透明边界 代码审查与架构提取仅发生在你自行授权的 AI 编程助手(Claude Code / Cursor / Antigravity / Pi / Codex)会话内,受你所选模型服务商自身的隐私条款约束。
- 3. 零埋点、零追踪、全量 MIT 开源可审计 工具链与导出视图不含任何遥测探针或第三方追踪 Cookie;仅在主动执行 update 时只读查询 GitHub Releases 校验 SHA-256。