lewes2/archpresent

ArchPresent

English · 简体中文

专业交互式架构图

ArchPresent 能做什么？
ArchPresent 是一个 agent 技能，可以从实际代码库生成图表。我们运行 /ArchPresent，得到一个交互式架构图（.html），双击即可打开。无需服务器，无需构建步骤，无需 MCP 调用，无依赖。不是一次性的。你可以在变更后重新生成，并看到带有高亮标记的新组件。

Video

示例页面 ↗

Video

示例页面 ↗

Video

示例页面 ↗

Video

示例页面 ↗

快速开始

1. open your claude skills folder (eg：C:/Users/[your rname]/.claude/skills)
git clone https://github.com/lewes2/archpresent.git

深入四个层级

L1 系统上下文 → L2 容器 → L3 组件 → L4 代码。点击一个矩形向下深入，右键或按 Esc 返回。L4 有两种形式：关键路径状态机，逐步追踪一条真实的端到端路径；以及文件级模块图，其中一个矩形就是一个文件，自动展开。

示例：一个包含 159 个文件 / 54,359 行的 monorepo 映射为 16 张图和 193 个矩形。

不会漂移的清单

每个矩形都带有两个抽屉：其文件清单（真实路径、真实行数）和其类 / 对象 / 函数（按文件分组，带有种类和行号）。将鼠标悬停在一个符号上，即可看到其真实源代码片段，直接从磁盘新鲜截取。
这些内容没有一处是手工输入的。它们是从六大语言家族——TS/JS、Vue/Svelte 单文件组件、Python、Go、Rust、JVM——的源码中提取出来的，然后由一个独立的检查器从头重新读取仓库，并逐条核对每一项声明：8 类断言，全部必须为零。文件缺失、行号漂移、符号不存在、类型错误、片段过时、分组不匹配、文件未覆盖、引用悬空。标题中的汇总数字是从实际归属关系填充的占位符，因此当你重新划分时它们不会过时。

观看系统运行

代表性场景以动画圆点的形式沿真实路径回放——每个流程都会投射到你当前查看的层级上。在 L1 层，你看到几个大块相互传递工作；深入到 L4 层，同一个场景会分解为一行行代码。

能力索引按用户思考的方式对用户可见功能进行分组；点击某一项即可直接跳转到实现它的模块。

暴露风险，而不是隐藏它们

一个因主题原因而无法拆分的大文件会获得自己的矩形，被标记为风险，并附有关于它为何会膨胀到这种程度的说明。全局可变状态、并发陷阱、仅内存中的防护、平台特定的弱化——这些都会获得自己的颜色，而不是被平滑地融入图中。

事后编辑

按 ✎ 编辑（右上角）即可在不重新生成的情况下修正地图：点击任意标签即可重写它，按住 Ctrl 拖动任意矩形即可重新定位——链接会自动重新布线。更改会持久保存在你的浏览器中。

它刻意不做的事

它不会自动生成语义。模块边界、每个描述中的推理，以及每个端口的五列内容，都是由实际读过代码的人（或模型）编写的。ArchPresent 的职责是让这种判断变得可呈现、可导航，并且不可能与源码相矛盾。