arcgram

<p align="center"> <img src="assets/arcgram-logo.svg" alt="Arcgram" width="280"> </p> # Arcgram v2 **Arcgram 是人类与 AI 协作的共享基础。** 您的 AI 以可审计的图表形式呈现其思考过程 —— 节点输入、明确的边、具体的坐标 —— 而不是一大段文字。您可以调整它。双方在多个回合、会话和代理之间趋于一致的事实基础上汇聚。 它 **不是 "Mermaid, prettier."** 任务是协作，而不是美学： - **像素空间外部化** —— 当 AI 提交到 "此节点位于 x=870, y=670" 时，其推理变得可指向。您可以在几秒钟内发现错误或纠正特定节点，而不是重新阅读一段文字并信任它。 - **约定残留** —— 作者技能携带工作流规则，每个规则可以防止已经经历过的特定失败，由下一个读取它的代理自动应用。随着约定的成熟，达到良好输出的时间会减少。 - **跨代理中立性** —— 相同的技能文件适用于 Claude、GPT、Gemini、Cline、Continue.dev、Cursor、Aider 和本地模型。混合代理的团队在一个共享词汇上趋于一致。 **适用于每个读取该技能的代理。** **形式** 是一个单独的独立 HTML 文件：平移 · 缩放 · 悬停提示 · 色码分类 · 正交边缘路由 · 垂直和水平布局 · 思维流决策节点 · 子流程钻取 · 画布过滤器聚光灯 · 主题切换。没有构建步骤，没有 npm，没有 CDN，没有运行时 —— 在任何浏览器中打开它。所有内容都在渲染时从一个小的手动编辑的数据块中计算出来。但这只是交付方式，而不是重点。 ## 在浏览器中查看实时演示 无需安装。引擎在 GitHub Pages 上实时运行 —— 点击一个，然后平移 / 缩放 / 悬停： - [一个小型游戏循环](https://jovesun-lab.github.io/arcgram/examples/example.html) —— 画布过滤器 · 列 · 提示 · 关键路径 - [思维流：战斗中的对话](https://jovesun-lab.github.io/arcgram/examples/example-thinkflow.html) —— 决策菱形 · 赤陶土主题 - [工作流如何工作](https://jovesun-lab.github.io/arcgram/examples/usage-workflow.html) —— 提议 → 绘制 → 自我审计 → 修复循环，人类在循环中 - [审计展示](https://jovesun-lab.github.io/arcgram/examples/example-audit.html) —— 红色大头针标记节点上的发现；悬停大头针或列表以查看其注释 ## 一目了然 **Arcgram 可以做什么** —— 每个功能都作为一个分组树，就像一个视觉功能规格： <p align="center"> <img src="assets/feature-tree.svg" alt="Arcgram 系统功能树 —— 每个功能都按功能分组" width="900"> </p> **您如何使用它** —— AI 和您之间的端到端循环：提议 → 绘制 → 自我审计 → 错误标记 → 修复，人类在循环中： <p align="center"> <img src="assets/usage-workflow.svg" alt="Arcgram 使用工作流 —— 提议、绘制、自我审计、错误标记、修复，人类在循环中" width="900"> </p> ## 快速入门 1. **首先查看实际操作：** 打开 `examples/example.html` —— 一个小型工作图，带有 **左上角过滤器** （点击选项卡以聚焦一个交叉分组）、悬停提示、列和关键路径。 2. 然后打开 `template-v2.html` —— 它作为一个空白填充模板（空 `nodes` 和 `edges`）提供，因此画布一开始是空的。 3. 编辑文件顶部附近的 **数据部分**：添加您的 `nodes`、`edges`，以及可选的 `CANVASES`（左上角过滤器）。模式在那里有文档记录。`数据部分` 之后的所有内容都是引擎 —— 不要动它。 4. 在浏览器中重新打开文件。就是这样。 `nodes`、`edges`、`COLUMNS`、`BANDS`、`CANVASES` 和 `STATUS_LEGEND` 的模式在模板和 `schema.md` 中有详细记录。 ## 此文件夹中有什么 | 文件 | 它是什么 | |---|---| | `template-v2.html` | 引擎 —— 复制它，填写您的数据，发送一个文件。 | | `examples/example.html` | 一个工作示例：一个带有左上角画布过滤器、列、提示和关键路径的小型游戏循环。打开它以查看引擎的功能。 | | `examples/example-thinkflow.html` | 一个思维流示例：一个战斗中的对话 MVP 循环，带有决策菱形、是/否分支、三个反馈循环和赤陶土主题。打开它以查看决策流功能。 | | `examples/example-workflow.html` | 一个生产工作流示例：一个 Arcgram 图表如何成为一个可调、可用的游戏功能 —— 作者 → 编码代理 → 设计师调优 → 渲染 → 迭代 —— 作为一个以列为中心的决策脊柱。悬停是/否徽章以读取分支的数据。 | | `examples/example-workflow-H.html` | 相同的生产工作流作为一个 **水平** 思维流：左→右脊柱，菱形是 = 右 / 否 = 下，无带。 | | `examples/example-bands.html` | **带状（H）布局** 参考：水平带向下级联，带目标线（`t:'BAND_ID'` 落在容器框上），以及引擎实际读取的 **2-字段带色方案** （`fill` + `color`）。在编写任何 `BANDS[]` 之前打开此文件。 | | `examples/example-harness.html` | 一个代理操作/元示例：代理中立的 **harness build-guide** —— 一个验证工具如何连接在一起（验证器 · 工具连接 · 人类门户）作为一个自引用的流，带有决策菱形、虚线回路和画布过滤器聚光灯选项卡。 | | `schema.md` | 完整的模式参考（节点、边、列、带、画布、状态、自动生命周期）。 | | `USAGE.md` | 如何从 AI 代理（Claude、Cowork 等）驱动 Arcgram。 | | `layout-tips.md` | 作者指南，包括无冲突的 H 布局。 | | `themes/` | `base.css` （结构）+ `default.css` （调色板）—— 引擎内联这些，保持在这里参考和分叉。 | | `assets/` | 徽标、标记和 favicon SVGs，以及上面的 `feature-tree.svg` + `usage-workflow.svg`。 | | `LICENSE` | Apache License 2.0。 | | `NOTICE` | 归属 + 版权 + 商标声明（在重新分发时保留，按照 Apache §4(d)）。 | | `WATERMARK-AND-COMMERCIAL-TERMS.md` | 开放核心条款：默认情况下归属；未品牌构建需要商业许可证。 | ## v2 中的新增功能 - **水平（H）布局** 与垂直布局并存 —— 带分组的行向下级联，无冲突。 - **思维流** —— 带有分支/关键路径着色的菱形决策节点。 - **子流程钻取** —— 一个节点可以打开一个嵌套流程叠加层。 - **问题标记** —— 用 `flag: '…'` 标记一个节点，在其右上角添加一个红色错误标记（带有悬停注释），用于未解决的问题/漏洞；仅绘制，从不影响布局。 - **画布过滤器/聚光灯** —— 左上角选项卡，调暗除所选组以外的所有内容。 - **自动生命周期带** —— 顶部带上方松散的锚点。 - **梳状/共享干线路由** 、紧密的药丸解剖结构和主题感知渲染。 ## 许可证和归属 Arcgram 引擎和作者技能在 **Apache License 2.0** 下许可 —— 使用它们、修改它们、在商业产品中嵌入它们并分发它们。请参阅 [`LICENSE`](LICENSE) 和 [`NOTICE`](NOTICE)。 **默认情况下归属是开启的。** 每个图表都带有 "Made with Arcgram" 标记 —— 一个视觉徽章，在缩放控件之后位于顶部栏中，以及代码头和 `window.__arcgramMeta` 中的许可证/出处声明。根据 Apache 2.0 §4(d)，请在重新分发时保留这些标记和 `NOTICE`。保留标记是免费的；**未品牌/无归属构建** 需要单独的商业许可证（引擎公开了一个记录的 `ARCGRAM_ATTRIBUTION` 切换开关，它是 **许可的**，不是免费的）—— 请参阅 [`WATERMARK-AND-COMMERCIAL-TERMS.md`](WATERMARK-AND-COMMERCIAL-TERMS.md)。 **商标。** "Arcgram" 和 Arcgram 徽标是 Rae Sun 的商标。您可以声明您的作品是 "用 Arcgram 制作的"，但请不要使用名称或徽标来为您的产品贴牌或暗示认可。 > _早期版本在 MIT 许可证下分发；该授予仍然适用于已经接收的副本。从此版本开始，Apache 2.0 适用。_ ## 注释 这是公共版本集。引擎是统一的 V·H 构建，验证门户清洁。内部工具 —— 门户套件、设计书籍、备份和开发笔记 —— 生活在该文件夹之外，不会分发。