Skip to content

Releases

v0.5.1

Choose a tag to compare

@loofare loofare released this 18 Nov 03:35

ArchRay v0.5.1

日期:2026-11-18。v0.5.1 修复默认楼层视图缩放标签、二次切层构建、自更新与引导脚本安全校验、卸载清理与跨平台兼容问题,并补齐 CLI 类型检查与三平台 CI。

安装

tmp=$(mktemp)
if curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh -o "$tmp"; then
  sh "$tmp" . claude
  archray_install_status=$?
else
  archray_install_status=$?
fi
rm -f "$tmp"
test "$archray_install_status" -eq 0

把 claude 换成 cursor、antigravity、pi、codex、claude,pi 或 all。Node 20+。

升级

从 v0.5.0 升级:

./.archray/archray update --check
./.archray/archray update

从 v0.4.0 或更早一次性升级:

tmp=$(mktemp)
if curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh -o "$tmp"; then
  sh "$tmp" . auto --force
  archray_install_status=$?
else
  archray_install_status=$?
fi
rm -f "$tmp"
test "$archray_install_status" -eq 0

本版本变更

  • 楼层/等轴视图与导航:通过 ResizeObserver 按实际视口缩放与 zoom 计算标签尺寸,大图缩放后标题与摘要保持清晰;autoZoom 改用当前投影包围盒;缩略图视口框与点击定位同步支持相机旋转;详情面板多协议重复边去重、importView 缺省动效重置。
  • 二次视图重建与模板对齐:主命令与六个分层预设重建派生 .archray/index.html 时显式携带 --force(保留 .archray/graph.json 与 view.json);统一 SKILL.md 的全局唯一节点 ID 与 19 种已知组件 kind;参数占位从代码块移出避免误插。
  • 自更新与引导安装加固:更新源拒绝非本地 http:// 与重定向降级(逐跳校验)、增加 30s 超时与体积上限;解压前预检 tar 条目(拦截绝对路径、..、反斜杠、软硬链接与设备节点);修复引导脚本在严格 POSIX sh/dash 下少参 shift 退出问题与正则转义,修复 Windows 下解压校验路径分隔符问题;保守识别无清单的旧 Pi+Codex 共享 .agents/skills 布局。
  • 卸载与安装回滚:install 失败回滚恢复文件权限并清理新建空目录;uninstall 仅清理所选宿主空目录(含 skills/archray)并对未安装宿主明确提示;init 统一接入越界与符号链接保护;doctor 检查系统 tar 可用性。
  • 详情链接安全与工程质量:Inspector 参考链接仅渲染 http:/https: 并附带 noopener noreferrer;npm run typecheck 覆盖 cli/src 与 scripts/*.ts;新增 Ubuntu / macOS / Windows GitHub Actions CI 工作流。

已知边界

  • 更新仍依赖 HTTPS 与 Release manifest 的 SHA-256,不包含独立签名认证。
  • 未覆盖所有 AI 宿主的真实模型回合实测与全量 Windows 实机矩阵(见 宿主验证清单)。

ArchRay v0.5.0

Choose a tag to compare

@loofare loofare released this 17 Nov 20:31

ArchRay v0.5.0

日期:2026-11-18。v0.5.0 加入项目内自更新、一次性引导升级、完整卸载和新的楼层/等轴交互。

安装

tmp=$(mktemp)
if curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh -o "$tmp"; then
  sh "$tmp" . claude
  archray_install_status=$?
else
  archray_install_status=$?
fi
rm -f "$tmp"
test "$archray_install_status" -eq 0

把 claude 换成 cursor、antigravity、pi、codex、claude,pi 或 all。Node 20+。

安装后新开 AI 会话:Claude/Cursor/Antigravity/Pi 输入 /archray;Codex 输入 $archray 或 /skills。

更新

.archray/archray update --check
.archray/archray update

或对 AI 说:/archray update。

更新只刷新工具、Skill、命令和模板,保留 .archray/graph.json、view.json 和 index.html;不重新分析源码。下载使用 Release latest.json 和 SHA-256 校验,失败保留旧工具。

从 v0.4.0 或更早升级

旧版没有 update 命令,需要做一次引导升级:

tmp=$(mktemp)
if curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh -o "$tmp"; then
  sh "$tmp" . auto --force
  archray_install_status=$?
else
  archray_install_status=$?
fi
rm -f "$tmp"
test "$archray_install_status" -eq 0

如果自动探测不确定,显式写宿主,例如 claude,pi 或 pi,codex。升级后才有 .archray/archray update。

卸载

.archray/archray uninstall --dry-run
.archray/archray uninstall

默认保留 graph/view/index;--purge 删除整个 .archray。卸载最后一个宿主后包装器也会消失。

视觉与导航

  • 默认楼层视图;等轴/平面可切换。
  • 指针中心缩放、拖拽平移、右键或 Alt+拖拽旋转、全屏和缩略图。
  • 健康度总览:评分、热点、分层健康。
  • 可替代性总览:高/中/低/未分析、锁定点、已保存方案。

验证

29 项核心测试、typecheck、build、CLI 回归、包级安装/回滚、更新/卸载回归、浏览器矩阵和脱敏扫描通过。

已知边界

  • 更新需要网络;--check 也会读取 Release manifest。
  • 系统需要 tar;Windows 使用自带 tar 或 Git Bash/WSL 的 tar。
  • 下载校验依赖 HTTPS 与 Release manifest 的 SHA-256;不是独立签名认证。
  • 未覆盖所有 AI 宿主的真实加载、所有平台和真实公开 Release 下载。

ArchRay v0.4.0

Choose a tag to compare

@loofare loofare released this 17 Nov 14:28

ArchRay v0.4.0

日期:2026-11-17。v0.4.0 是 M5「真实使用与规模化」的收口版本。

亮点

  • AI 宿主矩阵:Claude Code、Cursor、Antigravity、Pi、Codex;Pi 使用 /archray、/archray-frontend 与 /skill:archray,Codex 使用 $archray 或 /skills。install --agent all 一次安装。
  • 真实仓库验证:前端 nextjs/saas-starter、后端 Express + Prisma、大型 Cal.com 包级架构;覆盖安装、生成、分层、离线浏览、导出与 320px。
  • 大图可读缩放:25+ 模块在宽屏按布局边界打开到可读字号(最高 4×);Fit 回全图;显式 camera/layers/focus 不覆盖。
  • 知识库与图标:212 条技术/品牌提示、167 个品牌图标;kind、重复 ID、跨条目别名冲突在生成期拒绝;Drizzle ORM 使用专用标记。
  • 质量门禁:29 项核心测试、CLI 回归、宿主发现、包级安装/回滚、原版浏览器矩阵、脱敏扫描。

安装

tar -xzf archray-0.4.0.tgz
./archray-0.4.0/install.sh /path/to/your-repo claude   # cursor | antigravity | pi | codex | all

安装后新开会话:Claude/Cursor/Antigravity/Pi 输入 /archray;Codex 输入 $archray 或 /skills。Node 20+。

安装器把 CLI、viewer、Skill、命令和知识库自带为 .archray/tool,命令使用相对路径,下载包可删除。

已知限制

  • 前端 13 节点样例低于 25 节点阈值,仍以 fit 打开;F1 是观察项。
  • 大图可读缩放最高 4×,极端大图仍可能需要手动放大;首屏居中可能裁掉顶部入口,Fit 可恢复。
  • 密集边未做聚合/标签;320px 层名依赖横向滚动。
  • Express 官方宽字标在 fit 下偏小;已记录,缩放后可读。
  • 分析由 AI 依据真实源码或用户描述生成;sourcePaths 是待复核声明,不是运行时监控或自动扫描。
  • 未包含 npm 发布之外的 scan/SaaS/自动重构/时间线;未做全平台、全设备性能或商标法律审查。

证据

本版本为 ArchRay 公开仓库的首个公开发行版。