让真实源码直接生长为 空间立体架构图

将 ArchRay 安装到目标仓库,在 AI 编程助手里输入 /archray。它阅读真实代码而非猜测,通过确定性布局导出可分层交互、100% 离线的 3D 空间与 2D 版图单文件 HTML。

curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh | sh -s -- . claude
Before · 传统混乱折线块 Page_A.vue Page_B.vue Page_C.vue Socket.js routes.py db_ops.py worker.py ext_api MySQL Docker
After · ArchRay 3D 空间分层全景 Vue 3 SPA (+7) REST Client Data Access Layer REST Gateway Async Sync Workers External APIs (L4) MySQL Cluster (L3)

真实单文件 HTML 在线沙盒

下方直接嵌入由 FreshMart 示例构建的真实产物,零服务器、零外部依赖即可体验 3D 环绕、2D 版图、健康热点与整图导出。

全屏新窗口打开 ↗

项目内自包含安装

不污染全局环境,按你的 AI 编程宿主选择对应入口即可落地到 .archray/,并支持一键自更新与安全卸载。

1. 在项目根目录安装
2. 日常自检与更新维护
./.archray/archray doctor
./.archray/archray update --check
./.archray/archray update
./.archray/archray uninstall --dry-run
AI 会话入口命令
/archray
分层聚焦预设示例
/archray:frontend
写入宿主位置
.claude/skills/archray/SKILL.md · .claude/commands/archray.md

十大架构规范层与空间映射

支持自定义层同时内置 10 个规范层映射表,点击任一层格即可查看其在 3D 全景中的空间象限、典型技术栈与切片指令。

L0 · 前端 / 客户端 (client)

./.archray/archray build .archray/graph.json --layers frontend --force

三重视角与第一性原理边界

不为炫技而画图:每一条边、风险和替代方案都有清晰的证据与定位边界。

拓扑结构视图

通过 ELK 分层布局与透视 3D 空间坐标系分离核心主干、异步任务翼与外部服务轨道,高密子模块默认智能折叠。

健康度诊断透视

依据图谱静态扫描或评审诊断标红耦合、单点故障与复杂度热点,提供可拖拽总览评分,并标注实测或估算来源。

可替代性演进预览

标明核心锁定点、替代方案(平替 / 托管 / 重构)的工作量与风险,支持原地差异预览并一键复制迁移提示词给 AI。

不是运行时监控

图中的健康评分和指标基于仓库源码分析与显式输入,不伪造线上 QPS 或延迟监控。

确定性布局,拒绝幻觉

AI 只产出语义 JSON 事实;节点坐标、端口扇出、跨层汇总和路径避让全部由确定性引擎计算。

零网络单文件交付

输出单一 HTML 文件内嵌 167 枚品牌矢量徽标、离线二维码与海报导出,不上传任何私密代码到远端。