Archipelago

Archipelago

一张不断更新的工作地图。从聊天到结构化模型，让你、团队和 Agent 保持步调一致。

早期版本：由作者构建并每天使用；可能尚不完善。

AI 正在加速许多任务，但只有方向正确时，更快才有帮助。执行前先绘制地图，有助于发现风险和依赖关系，也能让你轻松跟进人员和 Agent 的工作。

共享同一张地图，任何人都能随时随地接手工作。详细的历史记录让你能够分析项目的实际发展过程、遗漏之处，以及如何改进。

网站地址为 archipelago.tools。

工作原理

Archipelago 的核心小巧而不预设立场，其余部分由你塑造。

由人掌控。 Agent 承担大部分工作，而你决定哪些内容需要经过批准。每项变更都会记录其授权来源，已应用的变更也可以撤销。掌控权在你手中

日志即事实。 每项变更都会添加到同一个日志中，且永不改写。撤销、历史记录、实时更新和备份都读取同一份记录。 docs/log.md

万物皆为条目，每个条目都有类型。 每种类型都扩展自七种基础类型之一。由于 Archipelago 以这些基础类型为核心，适用于我们提供的类型的功能，同样适用于你添加的类型。

插件架构。 Pack 是系统中体现观点的地方。创建一个包含所需条目类型、链接类型、视图样式和功能的 pack。你创建的类型、视图或规则，都能像内置内容一样运作。 编写 pack

为人和 Agent 提供统一界面。 你和 Agent 使用相同的工具操作地图。告知 Agent 的内容会保留在地图上，供你查看和修改。Agent 工具

统一读取方式。 查询由筛选条件、遍历方式和限制组成，视图则是在查询基础上添加布局。你和 Agent 读取的是同一个查询。

自行托管

Archipelago 是一个 Node 24 服务和一块持久化磁盘，采用 MIT 许可，包含所需的一切。数据库为内嵌式；团队使用时，可改为将地图保存在 Postgres 服务上。如果你不想运行服务，快速入门可在大约五分钟内帮你运行起来。

git clone https://github.com/AlexReiner98/archipelago.git
cd archipelago
npm install
npm start

打开 http://127.0.0.1:3100，进入 Workspace，在 Owner 下输入你的名字。若想先看看效果，运行 npm run demo，即可在 3200 端口打开 Archipelago 自身的地图；其数据彼此隔离。

连接 Claude Code

在你正在处理的项目文件夹中，确保服务正在运行，然后执行：

node -e "fetch('http://127.0.0.1:3100/connect/setup.mjs').then(r=>r.text()).then(t=>import('data:text/javascript,'+encodeURIComponent(t)))"

它会列出将要写入的文件（.mcp.json、几个钩子，以及 CLAUDE.md 中的工作规则），并先征求你的同意。添加 -- --dry-run 仅查看列表，或添加 -- --remove 将其移除。然后在该文件夹中重新打开 Claude Code 并输入：

将这个项目放入 Archipelago，把我正在处理的三件事设为任务，并告诉我你会先做什么。

你的任务会立即显示在地图上。要撤销任何内容，请打开 Changes 并选择 Undo。其他任何 MCP 客户端也可以通过 http://127.0.0.1:3100/mcp 操作地图。

延伸阅读

• 自行托管和 托管：所有设置和限制。
• 参考文档：所有界面、工具、视图、设置和限制。
• 让 Agent 遵循地图：如何向 Agent 说明要求、检查并协调。
• 扩展包：逐项介绍清单，以及 docs/layouts.md：布局和沙箱。
• 日志：存储了什么，以及如何从中读取其他所有内容。
• 术语表：每个概念对应的唯一用词。
• 如需参与 Archipelago 本身的开发，请参阅 CONTRIBUTING.md。该文档按原样发布，不保证会回复或修复问题。
• 如需私下报告安全问题，请参阅 SECURITY.md。

版权所有 2026 Aperture Design Tools Inc. MIT 许可证。