SPM - Structured Project Memory

SPM Agent 连接器

SPM（结构化项目记忆）的公共连接器包。

SPM 将项目知识转化为持久、可共享、受治理且具备内部智能的项目记忆，供 AI Agent 使用。本仓库仅包含公共连接器部分：经过身份验证的远程 MCP 配置、可安装的 Codex、Claude Code、Cursor 和 OpenClaw 插件包、浏览器授权辅助工具、生命周期适配器、示例和安全指南。

本仓库不包含 SPM 应用、后端、计费系统、私有控制台、记忆引擎和基础设施。

托管 MCP 端点

人工设置和检查指南：

https://getspm.com/agents

https://getspm.com/v1/mcp

官方 MCP Registry 描述文件：

server.json

Registry 名称：

com.getspm/spm

该端点公开供发现，但使用时需要身份验证。客户端需要：

• 一个 SPM 账户；
• 一个组织和至少一个项目；
• 试用版或付费套餐；
• 一个 SPM 令牌，该令牌需获准访问一个项目、所选项目集，或用户在组织中可访问的项目。

Agent 可以做什么

连接器配置文件向 Agent 提供以下 SPM 功能：

• 在不同聊天、运行和工具之间使用持久项目记忆；
• 确定当前项目，不与其他已获授权的项目混淆；
• 列出已获授权的项目，并仅在用户明确要求时组合跨项目上下文；
• 使用智能记忆包，其中保留了需求、当前决策、已完成的工作、有来源支持的上下文和时间信号；
• 查询时间性项目记忆；
• 请求范围受限的上下文包；
• 验证上下文包的来源和哈希值；
• 查询上下文图谱和边界；
• 执行符合策略的预检；
• 报告已完成的操作、测试、证据和决策；
• 在客户端支持生命周期钩子时，将 Agent 生命周期轮次提交给以 LLM 为先的记忆分流流程，并附带来源溯源信息。
• 独立选择性捕获、完整脱敏捕获、仅摘要捕获或仅元数据捕获源内容，不受分流流程为未来使用而提升的记忆影响；
• 检查并验证按追加顺序排列的捕获日志，同时不向 Agent 工具暴露保留的对话正文。
• 当没有匹配的已授权项目时，提议基于源内容的项目记忆引导；仅请求仍需的特定已授权证据，然后等待用户在 SPM 中创建、关联或跳过该项目；
• 通过短时有效的一次性交接，在另一个 Agent 或设备上继续处理已授权项目；交接仅携带引用，不包含记忆正文或凭据；
• 在交接前比较不含正文的工作区清单：Git 身份、修订版本和本地状态哈希；非 Git 文件或文档快照；远程版本引用；或仅记忆工作；
• 在客户端支持生命周期钩子时，于会话开始、用户轮次开始前以及工作完成后自动刷新工作区清单；无需上传本地文件正文，即可显示过时的观察结果和范围外变更；
• 区分仅含元数据的源观察结果与实质性证据，并在需要当前内容时请求已授权的源交接。

典型用例

• 编码 Agent 在更改代码前获取实际应使用的项目记忆：需求、当前决策、测试、约束和已完成的工作。
• 交付团队将分散的项目知识整理成范围明确的知识包，供工程师、客户、合作伙伴或支持团队使用，同时不暴露整个项目。
• 合作伙伴或外部协作者获得范围受限的记忆，其中包含来源、到期时间、撤销信息、溯源信息和审计证据。
• Agent 工作流在任务完成后保留记忆，将决策、测试和证据报告回 SPM。

Agent 无法执行的操作

托管 MCP 连接器不会提供以下功能：

• 账单或结账；
• 发票付款；
• 创建客户门户；
• 破坏性租户管理；
• 原始密钥；
• 全局操作员工具。

这是有意设置的边界。Agent 可以使用所需的记忆工具，但不会获得商业或破坏性管理权限。

Codex

从此仓库的插件市场安装 Codex 插件：

.agents/plugins/marketplace.json

或手动配置 Codex：

[mcp_servers.spm]
url = "https://getspm.com/v1/mcp"
bearer_token_env_var = "SPM_CODEX_MCP_TOKEN"
startup_timeout_sec = 30
tool_timeout_sec = 120

授权 Codex 访问已登录组织用户可访问的所有项目：

python3 plugins/spm-codex/scripts/auth_spm_codex.py \
  --project-id <authorization-project-id> \
  --access-mode organization \
  --write-env ~/.spm/codex.env
source ~/.spm/codex.env

验证：

python3 plugins/spm-codex/scripts/doctor_spm_codex.py

运行远程 MCP 功能冒烟测试：

python3 plugins/spm-codex/scripts/smoke_spm_remote_mcp.py \
  --project-id <authorized-project-id>

冒烟测试使用与 Codex 相同的 SPM_CODEX_MCP_TOKEN，并要求指定一个已授权的项目 ID（或设置 SPM_SMOKE_PROJECT_ID）。它会初始化托管 MCP 端点，验证项目解析、多项目、Agent 会话和记忆工具功能，创建一个小型项目级冒烟测试记忆事件，读取时间状态，创建并验证上下文包，查询上下文图，运行 Agent 预检，并报告操作后的证据。它绝不会打印令牌，且托管连接器会从返回的上下文中剥离原始事件正文。

如需检查令牌但不执行修改，请使用：

python3 plugins/spm-codex/scripts/smoke_spm_remote_mcp.py \
  --project-id <authorized-project-id> --read-only

Claude Code、Cursor 和 OpenClaw

仓库包含原生客户端套件：

• plugins/spm-claude
• plugins/spm-cursor
• plugins/spm-openclaw

仅支持 MCP 的客户端可以使用同一个远程端点和 bearer 令牌。通用授权助手为 scripts/agent-connectors/authorize_spm_agent.py。另请参阅：

• examples/codex/config.toml
• examples/claude-desktop/claude_desktop_config.json
• examples/cursor/mcp.json
• examples/windsurf/mcp_config.json

安全

不要提交令牌。请优先使用环境变量或各 Agent 客户端的密钥存储。令牌必须明确限定范围，并且可从 SPM 撤销。组织级可见性不允许在项目间静默混用：每项任务只保留一个活动项目，而跨项目包则需要用户明确请求。会话续接不会克隆、拉取、重置或覆盖工作区。接收方 Agent 会检查实际素材状态，将其与 SPM 清单进行比较，并在获取或协调资源前征求许可。

请参阅 SECURITY.md 和 docs/security-boundary.md。

链接

• 网站：https://getspm.com
• Agent 集成指南：https://getspm.com/agents
• MCP 设置：https://getspm.com/mcp
• 文档：https://getspm.com/docs
• 安全：https://getspm.com/security
• 演示：https://getspm.com/sales/spm-current-scoped-trusted-agent-memory.mp4
• 目录列表套件：docs/directory-listing-pack.md