基于真实产物的空间渲染
在同一深空 3D 舞台内预览拓扑、健康度与可替代性三种视角

让 AI 读懂仓库源码,画出真实的空间架构。

装进你的 AI 编程助手,让它直接通读项目源码,几秒生成可交互的 3D 与 2D 空间架构图。

FREE · MIT 完全本地化直管 对项目无侵入性 零源码外传
全部支持:
  • Claude Code
  • Cursor
  • Antigravity
  • Codex
  • Pi
file:line真实源码证据链,零臆测 3D + 2D确定性空间布局 167+离线单文件 · 向量徽标 ≈ / ✓健康度与可替代性

实机在线沙盒:真单文件 HTML 即刻把玩。

上方还原 AI 编程会话指令,下方直接内嵌由 FreshMart 示例构建的真实离线 HTML 产物。

.archray/index.html · 100% Offline Single-File
新窗口全屏 ↗
You /archray 3d 审查当前仓库真实源码,输出双语分层 3D/2D 架构视图与热点证据。
✓ 16 modules · 5 layers ✓ 0 locale gaps → .archray/index.html

从你想审视的架构层开始,支持全部查看与跨端自由组合。

一条命令看全部 10 层,也可以只看前端、后端或数据,或用逗号自由组合;未选中的上下游会保留为半透明上下文。

选择视角:
在 AI 会话中输入:
> /archray all

或对 AI 说“用 archray 画全部 10 层全景” · 构建参数 --layers all

3D 空间透视坐标栈
ALL · L0–L9

全栈十层全景视角

3D 全景空间 · 十层映射 默认保留完整上下文

分析一次仓库源码即可任意切片:同时查看前端、网关、后端服务、异步队列、AI、外部 SaaS 与数据库,也支持 --lang、doctor 与 update。

在实机沙盒中查看该层 →
10 层与自由组合 展开后可单层选择或拼接
点击单层或开启“多选自由组合”,任意拼接前端+后端+AI+数据(自动保留一跳上下游)
ENTRY · 接入
CORE · 核心
WINGS · 侧翼
BASE · 基座

精准消除传统架构图的五大乱象。

一次切换,五格同时从通用 AI 草图缺陷变为 ArchRay 的确定性解法。

5 个待解决问题
跨层乱线蜘蛛网
所有连线挤在同一平面互相穿透

前端、网关、后台线程与数据库堆叠在无序矩形里,节点超过 15 个即彻底失去可读性。

crossings: 28 · unreadableL0–L9
AI 臆测黑盒
凭目录名字脑补不存在的调用关系

缺少 schema 校验与源码引用约束,架构图看似完整却与真实代码脱节。

src/orders/order.service.ts:42✓
死板同质白框
网关、数据库与消息队列长相完全一样

无法一眼分辨存储基座、异步任务流与三方外部依赖的技术角色。

167 vector brand icons + 3D shapes3D
静态死图无诊断
看不出哪里存在高耦合或供应商锁定

画完即止,无法辅助技术债治理、框架升级或云服务平替决策。

Health + Replaceability diffAI
截图裁切难分享
大图截不全、外链图床泄露代码隐私

浏览器手动截图只剩局部残片,依赖在线制图服务又无法通过安全合规审查。

Unclipped PNG + Offline QR PosterQR

围绕你的真实工程构建,而非演示玩具。

页面所见均由真实仓库源码提取:玩具画法只有 4 个手绘方块、没有行号引用;ArchRay 直接读取真实代码,经数千文件 Monorepo 验证并区分实测与估算(≈)。

calcom/cal.com 大型 Monorepo
7,712 文件 · 33 模块 · 75 边 · 7 层

高密子包默认 +N 折叠,196ms 完成 ELK 确定性布局,60fps 流畅缩放。

apps/web · packages/features · 196ms
FreshMart Commerce 沙盒同源工程
16 模块 · 21 边 · 5 层 · 3 条链路

定位订单服务 6,200 行同步锁热点,给出 Passport → Clerk 平替方案与迁移 Prompt。

apps/api/src/order/order.service.ts
SaaS Starter & RealWorld 前后端真实样本
43–49 源文件 · 0.03s 出图 · 零虚构指标

精准映射 App Router、Prisma 与 Stripe 轨道,并捕获 JWT_SECRET 回退高危项。

middleware.ts · prisma/schema.prisma

AI 负责语义阅读,引擎负责确定性几何。

大模型从不直接手写 SVG 坐标,只提取经源码验证的模块与证据;布局与三维投影全由确定性引擎完成,零全局污染(.archray/ 可随时卸载)。

● ● ●archray validate & build
> ./.archray/archray validate .archray/graph.json
✓ TypeBox schema valid · 16 nodes · 21 edges
> ./.archray/archray build .archray/graph.json --force
→ .archray/index.html ready (100% offline)

每一处结论都留在仓库可审计的 JSON 里。

图谱保存为 .archray/graph.json 与 view.json 随 Git 演进,实测值与静态估算(≈)诚实分标,支持无裁切整图与离线扫码海报导出。

.archray/graph.jsonEvidence Schema
1  { "id": "order", "layer": "service",
2    "sourcePaths": ["apps/api/src/order/order.service.ts"],
3    "metrics": { "loc": { "value": 6200, "origin": "measured" } }
4  }

安装 ArchRay

30 秒装入目标项目根目录,开启新会话输入 /archray,第一张空间架构图即刻生成。

浏览 GitHub 源码与完整文档 →
  • 01不修改业务源码
  • 02CLI、viewer、Skill 自包含在 .archray/tool
  • 03保留 graph/view/index,可随时更新或卸载
1

第一步:复制安装命令,在项目根目录运行

$ curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh | sh -s -- . claude
SHA-256 校验 · 与 latest.json 同批发布 · 查看 Release
会话触发入口
/archray
写入宿主配置
.claude/skills/archray/ · .claude/commands/
2

第二步:安装好后,复制这句话对你的 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。