Seam——人工智能代理的共享上下文
AI代理的共享上下文。就这样
你的代理人在两次会议之间忘记了一切。当两个人的代理人在同一个项目上工作时，他们每次都是陌生人——重读文件，重新发现惯例，不知道有人已经做出了他们即将再次做出的决定。
Seam是一个小型MCP服务器，它为代理提供了一个共享的地方来读写项目级理解。设计哲学、架构决策、谁在做什么、什么被尝试和拒绝了——那些重要但永远不会出现在代码中的东西。将其视为一个远程协作的CLAUDE.md。
代理连接，读取索引，知道发生了什么，然后开始工作。当它做出决定时，它会将其写回。下一个特工继续他的工作。没有冷启动，没有重新解释，没有“等等，我们不是已经决定了吗？”
它是一个Express服务器、一个SQLite数据库和11个MCP工具。简单到一次就能理解，有用到足以改变你的代理如何协同工作。
快速开始
路径A：连接到现有服务器
一位队友已经部署了Seam。它们为您提供服务器URL和引导令牌。
1.注册：
curl -X POST https://your-server.example.com/register \
-H "Content-Type: application/json" \
-d '{"bootstrap_token": "boot_...", "display_name": "your-name"}'您将收到一个API密钥： sk_your-name_...
2.连接到克劳德代码：
claude mcp add --transport http \
-H "Authorization: Bearer sk_your-name_..." \
-s user seam https://your-server.example.com/mcp3.安装插件（可选，推荐）：
# Add the Seam marketplace (one time)
claude plugin marketplace add https://github.com/Aedrand/seam.git
# Install the plugin
claude plugin install seam
# Or project-scoped instead of global
claude plugin install seam -s project该插件在启动时自动加载共享上下文，并引导代理在整个会话中提出回写决策。如果全局安装，它只会在连接了Seam MCP服务器的项目中激活。如果没有插件，这些工具仍然可用——你只需手动使用它们。
4.开始会话。 代理会自动发现Seam的工具。没有CLAUDE.md更改，没有设置仪式。开始工作吧。
路径B：部署自己的服务器
Seam是一个由SQLite支持的Node.js服务器。在任何可以运行Node的地方运行它——VPS、容器平台、网络上的备用机器。它只需要一个持久的数据库文件系统。
在本地运行：
git clone https://github.com/Aedrand/seam.git
cd seam
npm install
npm run dev首次启动时，服务器会打印一个引导令牌：
====================================
Bootstrap token: boot_a7f3...
Share this with your team to register.
====================================与您的团队共享此信息，就像Wi-Fi密码一样。按照与路径A相同的方式注册并添加到Claude Code中，使用 http://localhost:3000 作为服务器URL。
Example: Deploy to Railway
让Seam在生产中运行的一种方法。任何支持Docker和持久卷的平台都可以工作。
railway login
railway init
railway link
railway service
railway volume add --mount-path /data
railway up
railway domain如果需要，将数据库路径设置为持久卷和端口：
railway variables set SEAM_DB_PATH=/data/seam.db
railway variables set PORT=3000从部署日志中获取引导令牌：
railway logs使用分配的域Railway注册并添加到Claude Code。
How It Works
Seam将共享上下文存储为 索引 加 章节.
这 索引 它很小——总是可以安全加载，永远不会破坏上下文。它列出了每个部分的描述、作者、时间戳和版本号。这些描述告诉特工里面有什么以及何时阅读。
## Shared Context — dashboard-redesign
### design-philosophy (v2)
Dense, scan-optimized dashboard for financial analysts. Covers
the overall aesthetic direction, target users, design principles,
and tradeoffs we've explicitly chosen (density over whitespace,
speed over beauty). Read this before making any visual or layout
decisions.
*andrew, 2026-03-18*
### component-conventions (v1)
Vue 3 component patterns and naming. Covers composable structure,
prop naming, event patterns, Tailwind usage conventions, and file
organization. Read this before creating new components or
refactoring existing ones.
*sarah, 2026-03-19*
### current-status (v5)
Who's working on what, what's done, what's in progress, what's
blocked. Read this on startup to understand where things stand
and avoid duplicating work.
*sarah, 2026-03-20*章节 是自由形式的散文，不是键值对，也不是结构化数据。由代理人为代理人编写，关于代码中没有的理解。代理只阅读与其当前任务相关的部分。在前端工作？抓住设计理念和组件惯例。跳过api架构。
索引会自动刷新——每 read_section 调用将返回当前索引以及部分内容。代理人保持最新状态是做正常工作的副作用。
版本检查 防止特工们互相攻击。每个部分都有一个版本号。当你更新一个部分时，你会包含你上次阅读的版本。如果此后其他人更改了它，则写入失败——重新读取，合并他们的更改，再试一次。简单乐观并发，无锁定，无协调服务器。
MCP Tools
连接MCP服务器可以让您的代理访问这些工具。工具描述教代理如何使用它们。对于自动启动行为（加载上下文、建议回写），请安装可选插件。
上下文
| 工具 | 它做什么 |
|---|---|
get_index() | 查看存在哪些共享上下文。在启动时调用此功能。 |
read_section(name) | 阅读一个部分的内容+获取一个新的索引。 |
write_section(name, content, description, expected_version?) | 创建或更新节。版本检查可防止无声覆盖。 |
delete_section(name, expected_version) | 删除一个部分。版本检查可防止删除已更改的内容。 |
工作区
| 工具 | 它做什么 |
|---|---|
create_workspace(name) | 创建一个工作区并加入它 |
join_workspace(name) | 加入现有工作区。 |
list_workspaces() | 查看服务器上的所有工作区以及您已加入的工作区。 |
set_workspace(name) | 切换活动工作区。 |
项目链接
| 工具 | 它做什么 |
|---|---|
link_project(project_path, workspace) | 将目录链接到工作区以进行自动激活。 |
unlink_project(project_path) | 删除项目到工作区的链接。 |
resolve_project(project_path) | 查找并激活链接到目录的工作区。 |
Workspaces
所有上下文都限定在一个工作区内。不同的项目，不同的工作空间，没有交叉污染。
- 任何注册用户都可以创建和加入工作区。无管理员，无所有权，无需邀请。
- 一个身份适用于所有工作区。注册一次，加入任何你需要的。
- 在MCP URL中设置默认工作区，以便您的代理登录到正确的位置：
https://your-server.example.com/mcp?workspace=dashboard-redesignAPI
POST /register
唯一的REST端点。其他一切都通过MCP。
// Request
{ "bootstrap_token": "boot_...", "display_name": "andrew" }
// Response
{ "api_key": "sk_andrew_..." }显示名称是唯一且不可变的。API密钥是您的永久凭证。
Configuration
| 变量 | 默认值 | 描述 |
|---|---|---|
SEAM_PORT | 3000 | 服务器端口（也 PORT 为了平台兼容性） |
SEAM_DB_PATH | ./seam.db | SQLite数据库路径 |
如果引导令牌泄漏，则重新生成引导令牌（现有用户和API密钥保持有效）：
npm run cli -- regenerate-tokenDevelopment
npm run dev # Start dev server
npm test # Run tests
npm run build # Build for production范围
Seam专注于一件事：代理之间共享项目理解。这是一个具有MCP接口的SQLite数据库——没有嵌入，没有知识图，服务器上没有LLM。情报在于特工，而不是基础设施。
它并不试图成为代理内存系统、协调平台或消息总线。这些都是有趣的问题，但它们是不同的问题。Seam只是确保你的代理人知道你的团队已经弄清楚了什么。
来自人类的笔记
提醒一下：Seam是一个有趣的副项目，主要在人工智能的帮助下构建，用于探索代理如何共享上下文。事实上，这里的这一部分是整个事情的唯一一部分，你会发现我手动写的任何东西。
它没有生产硬化，没有公司的支持，也没有任何保证。确实有许多领域需要改进。如果你觉得它对你有用，太棒了。如果您发现问题，欢迎PR。如果它坏了，现在你知道为什么了。如果你玩它，一定要记住这一切。
许可证
麻省理工学院——随心所欲。