英文原文正文为项目原始 README(英文),本站后续会翻译为中文,当前仅剔除图片与无关章节并统一排版。
将你想要理解、计划或分享的任何内容转化为互动可视化。
官方渠道: archify.si · GitHub
Archify 是免费且开源的。第三方在线服务和付费计划由各自的提供商运营,并不代表 Archify。 服务详情 →
从一个想法、一个问题或一个计划开始。将其描述给您的 AI 代理,Archify 会将其转化为可探索、可定制、可分享的互动 HTML。从旅行行程和学习地图到复杂系统——都可以由您来打造。
看看社区正在创造什么——并想象一下您接下来可以创造什么。
Live demos · Get started · Scenario guide · Community · 简体中文 · 日本語
❤️ 合作伙伴与赞助商: Kimi Work · Supercode · OpenLux
观看 Archify 的实际操作
https://github.com/user-attachments/assets/78570807-ba1d-4737-953f-55504a378a87
一句话。你的仓库,映射完成。观看35秒的演示:探索图表,跟随源链接,追踪路径。尝试互动示例 ↗
安装,然后描述你的想法
适用于 Cursor、Claude Code、Codex CLI 和 OpenCode。有关其他集成,请参见下面的安装选项。
npx skills add tt-a1i/archify -g
将此发送给你的代理人:
Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.
然后继续:“添加身份验证”、“突出显示缓存未命中路径”,或“切换到浅色主题”。
不需要仓库: 从描述开始,或让你的代理读取仓库以获取源支持的架构图。
展示重要内容
| 解释代理工作流程 | 跟随缓存未命中 | 探索服务关系 |
|---|---|---|
| 跟踪某一步骤下游的所有内容。 | 高亮从 Web 应用到数据库的路径。 | 专注于已有的后端和数据库连接。 |
Proof Lab 包含了所有 11 个已签入的场景、它们的 JSON 源文件以及验证收据。
了解一个真实的代码仓库
代码 → 图表 · 基于源代码的系统地图
Archify 跟踪了 mco-org/mco 在 9f1a1cf 的状态,并生成了此审核后的地图。打开它 ↗ · 追踪覆盖范围 ↗ · 类型化源文件
易于扩展。更多方式让它属于你。
社区故事 · 用户分享的精选示例
在图表生成后继续构建。 Archify 是开源的,其输出是独立的 HTML 文件。你可以让你的智能助手适配它、连接有用的链接,或为自己的工作流程添加交互。社区创作已经涵盖团队协作、旅行规划、法律引用检查、合同审查和事件回顾。这些只是一些示例。
一位用户从手绘的多代理架构开始,将其转化为交互图表,然后通过对话添加了一个 Kimi 执行池。其他人让他们的智能助手阅读一个项目,并将生成的架构导入到飞书或钉钉进行团队讨论。
另一位用户将上海 CityWalk 导览转化为四天的行程:切换日期、检查某一站点,并跳转到高德、小红书或大众点评。作者还添加了到达签到和站点备注,使行程成为旅行中可用的小工具。这些扩展是社区作者为该特定创作添加的。
▶ 试用互动版本 · 在 D1–D4 之间切换并点击地点进行探索。
社区创作 · 上海 CityWalk · 四天路线及地点链接
下载它。打开它。探索它。
输出是一个自包含的 HTML 文件。下载后在浏览器中打开即可使用该创作中的节点详情和路径探索功能。无需安装 Archify 即可查看。将 HTML 文件发送给他人,交互功能也会随之传递;外部网站和地图链接需要网络连接。
尝试在 D1–D4 之间切换,打开地点卡片,或跟随地图链接。时间和地点信息反映了作者的原始行程。
社区与认可
- 在 GitHub 趋势每周榜单中所有语言仓库中排名第1。 排名截图由创建者于 2026 年 9 月 1 日发布,选择了所有语言和“本周”。
- 由 QbitAI 推荐并采访。 项目介绍 · 开发者故事。
- 与开发者社区分享。 midudev 的文章。
精选公开报道、社区分享及历史里程碑。请访问链接查看日期和来源。
预览
主题、导出和分享卡片
相同的图表,两个主题,一次点击即可切换:
| 暗 | 亮 |
|---|---|
导出菜单将 PNG 复制到剪贴板,并下载静态或动态格式:
在追踪路线之后,导出 → 路线分享卡 将下载该已创建路径为 1200×630 的 PNG,同时保留完整图表以供参考。
在追踪已创建的 上游 或 下游 区段之后,导出 → 区段分享卡 捕捉该精确读数,而不影响运行时。
在本地打开 examples/web-app.html 来体验完整查看器。
快速开始
当前稳定版本: v3.0.1。查看 更新日志。
1. 安装
npx skills add tt-a1i/archify -g
更多安装选项和更新检查详情
进行显式的、非交互式 Cursor 安装:
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
试用而不安装:
npx 技能使用 tt-a1i/archify@archify --agent codex
DSH 社区选择加入:dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0
代理切换器涵盖 cursor、codex、claude-code 和 opencode。
Archify 可能仅 GET 固定的稳定清单以显示可选提醒;它从不下载或安装更新。成功检查大约每 24 小时(±20%)进行一次;活跃使用在失败后会在 6 小时和 24 小时重试。服务器会看到正常的 HTTP 元数据(IP 和时间),但不会接收版本、代理、项目数据、提示、帐户/设备 ID 或 ETag。您可以决定是否以及何时更新。设置 ARCHIFY_UPDATE_CHECK_DISABLED=1 可禁用网络连接和提醒状态写入。
保持更新
带更新检查器的安装在生成图表时也会检查新稳定版本,并可显示提醒。没有检查器的旧安装需要手动更新以获得此功能。您可以选择是否以及何时升级;Archify 从不自动安装更新。
2. 从描述开始 — 不需要仓库
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
要查找来源证据,请打开一个资料库并询问:
Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.
3. 在聊天中优化
继续使用集中请求,例如 add Redis、move auth to the left 或 highlight the rollback path。Archify 保持已输入的源内容可用于有针对性的迭代。
选择合适的图表
五种图表类型、架构比较和示例
| 类型 | 最适合 | 在提示中包括 |
|---|---|---|
| 架构 | 组件、服务、存储、边界 | 范围、核心组件、主要路径 |
| 工作流 | CI/CD,审批,工具调用,运行手册 | 参与者,顺序,分支,例外 |
| 序列 | API 调用,缓存回退,认证,异步追踪 | 调用者,被调用者,返回值,时间 |
| 数据流 | 管道、血缘、个人身份信息、使用者 | 来源、转换、存储、边界 |
| 生命周期 | 状态、重试、等待、最终结果 | 状态、事件、重试和取消路径 |
架构的可选 deployment-ownership 配置在缺少已编写的所有者、区域放置、私有数据库范围或命名交叉时会关闭失败;它从不隐式启用,也不会检查实时基础设施。请参阅 已验证的部署证明。
在设计或 PR 审查中,Architecture Delta 会将经过验证的 Before / Delta / After 快照与机器收据进行比较。选择一个已编写的更改或播放一个有限的、仅查看的审查;它不会推断影响、风险或合并安全性。
节点 archify/bin/archify.mjs 比较架构 base.json head.json architecture-delta.html --json
不确定哪个适合?使用 交互式场景指南,或询问零依赖的 CLI:
node archify/bin/archify.mjs guide "显示带有 Redis 缓存未命中的 API 请求"
node archify/bin/archify.mjs guide "映射 Kafka 主题、消费者组、重放和 DLQ" --json
工作流保持各条路径上的流程畅通:
序列解释了一个随时间发生的交互:
数据流明确展示了移动和敏感性边界:
生命周期将进度、等待、重试和终态分开:
架构示例:web-app · Archify 管道 · 网格放置 · 桌面代理
为什么选择 Archify
| 理解结构 | 讲解故事 |
|---|---|
| 从代码或描述中映射组件、工作流程和关系。 | 浏览节点,跟随路径,并将任何视图作为链接分享。 |
| 以你自己的方式扩展 | 分享结果 |
| 保持可编辑的源代码,并在开源代码或生成的 HTML 上构建你自己的交互和使用场景。 | 分享一个自包含的 HTML 文件或导出图片、视频,并分享卡片。 |
体验背后的工程原理
- 布局判断优于通用自动布局 — 代理选择层次结构、间距、路径和重点;共享的自动端点按确定性方式展开,而不是将箭头堆积在一个中点上。
- 类型化 JSON IR — 每种渲染器支持的模式都有一个模式(schema)和可复现的源。
- 交付前的原子验证 — 模式(schema)、布局、HTML/SVG、路径和标签到路径的清理检查都必须通过,展示工件才能替换最后一次已知的良好输出。
- 失败附带修复凭证 —
validate --json和deliver --json返回稳定的规则代码、确切主体、测量证据,以及仅支持的修复控制,而不是节点堆栈或无结构的重试猜测。 - 最后一次良好状态的实时预览 — 可选桌面循环监视一个 JSON 文件,仅在最新候选通过所有门控后刷新,并在保存不完整或无效时保持之前验证的图表可见。
- 真实交互 — 焦点、上下游范围、精确路径、角色比较和故事重用已创建的节点和关系,而不是发明拓扑或宣称运行时影响。
- 仅在请求时提供来源证据 — 证据支持的架构节点标记自己为
SRC n,并打开固定到一个公共提交的 Git 验证文件和行范围;普通工件保持无源状态。 - 默认可移植 — 输出是一个 HTML 文件;导出保持完整图表状态,并且没有临时查看器状态。
Archify 不是通用的绘图编辑器或 Mermaid 主题。它将技术意图转化为交流产物。
它的工作原理
生成、验证、预览和交付详情
| 步骤 | 发生了什么 |
|---|---|
| 生成 | 该代理根据您的描述创建类型化的 JSON IR。 |
| 验证 | 捆绑的验证器和布局规则检查源代码;失败会以机器可读的 JSON 格式标识确切的本地修复位置。 |
| 预览(可选) | 仅回环的桌面会话监视一个源并只重新加载经过验证的修订;失败时保留最后一个良好工件。 |
| 交付 | 渲染并检查同一目录下的候选者;只有通过的工件会原子性地替换目标,然后可选的 --open 会启动该确切文件。 |
| 迭代 | 代理会更新源,而无关的结构保持稳定。 |
有用的仓库命令:
cd archify
node bin/archify.mjs doctor node bin/archify.mjs demo /tmp/archify-demo node bin/archify.mjs guide "显示 CI/CD 检查、审批、部署和回滚"
node bin/archify.mjs 验证工作流 examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs 预览工作流 examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs 交付工作流 examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json
preview 是一个显式的仅回环桌面模式:它在随机 127.0.0.1 端口上监视一个 JSON 文件,在失败时保留最后验证的输出,通过 Ctrl-C 停止,并且不添加生成的 HTML 运行时。测试或手动打开 URL 时使用 --no-open。
deliver --open 是一次提交后的可选一次性交接。打开失败时仍保留成功;JSON 保留在 stdout,绝对备用路径发送到 stderr。
失败时,validate --json 和 deliver --json 输出一个 JSON 对象。仅对每个 diagnostics[] 对象的 supportedFixes 使用,在 Skill 的两个修正轮次内;视觉检查保持独立。
设置:
{
"meta": {
"locale": "en",
"animation": "trace",
"视觉预设": "信号流"
}
}
meta.locale 本地化页面标题、图例、状态/错误、无障碍 (a11y)、HTML/SVG lang——不包括创作内容。en/zh-CN 已内置;其他语言,包括西班牙语 (es),需要 meta.translations(规范消息键 → 翻译字符串;见 examples/locales/es.json),否则渲染器会回退到英语并提示。静态忽略 animation;classic 使用默认值。
探索并分享输出结果
| 动作 | 控制 |
|---|---|
| 打开事实图指南 | ? |
| 查找并聚焦语义节点 | / |
| 跟踪上游/下游作者的范围 | 聚焦一个节点 → Upstream / Downstream |
| 探查定向路线并检查其路径 | R 或 PATH |
| 比较一个或两个语义角色 | L 或 LENS |
| 打开实时概览雷达 | M 或 MAP |
| 进入演示阶段 | F |
选择视觉风格(S 循环)/ 切换主题 / 打开导出 |
S / T / E |
| 缩放或重置 | / - / 0 |
稳定链接可以恢复 #focus=<id>、#focus=<id>&reach=upstream|downstream、#relation=<id>、#route=<source>~<target> 和 #lens=<kind>~<kind>。读者驱动的动作是有限的,遵循 prefers-reduced-motion,且永不进入规范导出。
完整的生成与查看合同存放在 archify/SKILL.md。
安装选项
| 表面 | 安装位置或方法 | 功能 |
|---|---|---|
| Claude 代码 | ~/.claude/skills/ 或 .claude/skills/ |
完整渲染器验证工作流程 |
| Codex CLI | ~/.agents/skills/ 或 .agents/skills/ |
完整渲染器验证工作流程 |
| opencode | ~/.config/opencode/skills/、.opencode/skills/ 或 .agents/skills/ |
完整渲染器验证工作流程 |
| Claude.ai | 在 设置 → 功能 → 技能 下上传 archify.zip |
取决于沙箱中的 Node.js 访问 |
| 项目知识 | 将 archify.zip 上传到项目中 |
基于提示的架构回退 |
| Hermes Agent | 选择加入:hermes skills install skills-sh/tt-a1i/archify/archify -y |
仅社区技能集成;Node >=18;不是 Nous 官方产品。无遥测。不是切换目标。详情 |
| DeepSeek Harness | 选择加入: dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0。调用: Use the archify skill to map this repository's runtime architecture. 移除: dsh plugin --profile web remove @tt-a1i/archify-dsh。 |
开发者预览的社区集成 @deepseek-ai/dsh@0.1.2-rc.1;节点 ^22.19.0 \|\| >=24.0.0;非官方 DeepSeek 产品。无遥测。Shell 文件需要精确的工作区路径,而不是 Web 生成的文件。详情。 |
参考与范围
自动 Mermaid 解析、通用自动布局、托管分享以及所见即所得编辑有意不在当前范围内。
社区
👋 欢迎加入 Archify 社区!
与其他用户和开发者交流,分享想法,请求功能,报告错误,讨论开发,共同帮助 Archify 变得更好。
- Discord
- 微信:扫描下方二维码。微信群码会定期失效;如果该码已失效,请通过 Discord 或 QQ 询问最新码。
- QQ群:
1121948602
| 微信 |
QQ |
官方渠道与第三方服务
- 开源项目: 在 MIT 许可证 下,源代码和安装包可免费使用。
- 官方网站: archify.si 目前提供项目资讯、示例及安装指南。
- 第三方服务: 定价、数据处理及支持由各自提供商决定。类似的名称或域名并不构成官方关联。
许可证
MIT — 免费使用、修改和分发。
贡献
在 Archify 上构建独立软件包?提交到社区目录;指南中包括可折叠示例和完整的中文步骤。
欢迎提出问题、拉取请求和真实世界的图表。请从贡献指南开始,对于失败请使用可重现的错误表单,或通过社区展示表单提交经过验证的图表。 · LINUX DO
支持 Archify
如果 Archify 对你有帮助,你可以支持它的持续开发。感谢你帮助项目继续运行 ❤️
通过微信支付支持
使用微信扫描下面的二维码,或保存后在微信中打开进行扫描。
通过支付宝支持
使用支付宝扫描下面的二维码,或保存后在支付宝中打开扫描。
使用 Archify、分享它、报告漏洞以及贡献改进也是帮助的方式。
星标历史
- 本文标题:archify - 将任何想法
- 本文链接:https://www.cn121.com/llm/tt-a1i-archify.html
- 原项目:tt-a1i/archify 版权归原作者 tt-a1i 及贡献者所有
- 收录信息:本站于 2026-10-10 收录本项目,本页所列协议与仓库指标均为收录当时的状态;该日期之后原项目的版本更新与协议变更,本页不作同步。
- 开源协议:收录时本项目采用 MIT(查看 LICENSE 原文),本站转载其原始文档(未改动文字,仅剔除图片与无关章节);使用、修改、分发请以该仓库 LICENSE 原文为准。
- 站点出处:本文首发于 OneTwoOne,收录自 GitHub 开源项目 tt-a1i/archify。
- 内容说明:本页正文为原项目 README 原文(英文),本站后续会翻译为中文(当前尚未译出,仅将二级标题译为中文,便于按栏目定位;标题原文可在下方原仓库中查看),仅剔除了图片与赞助等无关章节、并把相对链接改为绝对地址;页首简介为机器翻译自仓库描述。
- 引用声明:商业转载、第三方聚合或 AI 检索训练引用时,请务必保留以上来源出处、本文永久链接,以及原项目的版权声明与许可信息。
- 下架通道:若原项目此后变更或收紧了许可协议、或作者/权利人认为本站的收录方式(译文、排版适配、简介翻译等)超出其授权范围,请通过 xyd3302001@163.com 发送下架通知,并附上项目地址与本页链接。本站核实后将第一时间删除本页内容,或改为不复制原文的目录性收录;署名更正等其他要求可一并提出。