项目

Memory Console 中的项目工作区

项目工作区（Project Workspaces）提供结构化的上下文边界，用于在各个客户端会话之间对记忆进行分组、跟踪操作决策并管理活动任务。在 https://xmemo.dev/me#projects 的 Memory Console 中，工作区导航区域承载着项目面板，用于 "Browse project workspaces, context, and project memories."

• 工作区指标：控制台显示跨工作区的顶层统计数据，包括 Total Projects、Active、Attention Needed 和 Archived。
• 工作区置备：选择 Create New Project 会打开引导式弹窗，要求输入 Project Name（"Required, 1-128 characters."）。界面实时渲染 Project Identifier Preview（"Non-authoritative preview. The backend server assigns the authoritative project key."），并接受最长 2000 字符的可选 Description。
• 个人边界：项目目前仅限个人使用。后端服务会拒绝携带 team_id 的工作区创建请求（HTTP 400）。文档未承诺提供团队项目功能。
• 无配额限制：项目工作区不设数字方案配额或人为创建上限。账户根据工作流程需求而非方案配额来置备工作区。

记忆关联、生命周期状态与非破坏性移除

记忆被分配给项目，以便为连接的 agent 和仪表板审查提供受限上下文。项目详情视图汇总项目健康指标，并提供对已关联记录的细粒度检查：

• 项目关键统计：每个工作区顶部概览栏突出显示 Memories:、Open TODOs: 和 Decisions: 的实时汇总值。
• 记忆生命周期筛选：记忆浏览器按生命周期状态对记录进行分类：Active、Superseded、Expired 和 Archived。
• 非破坏性取消关联：从项目工作区中移除记忆记录只会解除关联，而不会销毁底层记忆。确认对话框明确说明："This memory will be disassociated from this project workspace. The memory content remains in your personal memory archive, but will no longer appear in this project context."
• 诊断隔离：缺少规范引用或存在命名空间冲突的 item 会被隔离在带有 Unindexed - Troubleshooting Only 徽标的 Diagnostic Isolated Items 下，防止损坏的上下文泄漏到 agent 召回中。

Knowledge 与 Working 分区及 Attention Needed 视图

如果您的账户已启用，项目工作区支持上下文记忆分区（收敛评估模式默认为关闭）：

• Knowledge 分区：保存用于持久召回的长期参考事实、长期架构决策和项目规范。
• Working 记忆分区：包含瞬态任务状态、进行中的工作会话和便签上下文，这些内容在里程碑完成后即可注销。
• Attention Needed 视图：在为您的账户激活分区整理时，高亮显示未分配候选记录、疑似重复项或待归属记录。
• 与 Knowledge Base 的区别：项目 Knowledge 分区对项目边界内的情景对话记忆进行分类。相比之下，Knowledge Base 提供通过独立存储管理的整理好的多 revision 参考文档。有关整理好的文档，请参阅 /docs/concepts/knowledge-bases 的 Knowledge Bases 概念指南。

项目是 scope 加 path convention

对于基础记忆范围隔离，XMemo 不需要独立的项目对象：项目由记忆写入的作用域及其内部的逻辑路径命名空间表达，同一账户可承载多个项目而不发生交叉污染。在此记忆边界之上，Project Workspaces 进一步分层构建结构化项目状态（Project API、TODO 跟踪与已记录决策），以实现跨客户端协作。

• 将项目事实写入稳定路径，例如 projects/<name>/decisions。
• 在写入和读取时均传入 project 作用域，确保检索严格受限。
• Project Workspaces 在底层记忆边界之上分层构建结构化项目状态——包括 Project API、持久化 TODO 及已记录决策。
• 项目目前仅限个人使用；API 会拒绝团队作用域的项目工作区。

写入项目决策

写入时将记录连接到 project path 和 scope；不需要预先配置其他内容。

await client.recordDecision(
  "Remote agents should use network MCP, not SSH stdio",
  { source: "codex", scope: "memory-os" },
);

在另一个 client 中继续项目

第二个 client recall 同一个 scope，就能取回项目上下文，无需用户重新解释。

const context = await client.recallContext("recent agent integration progress", {
  scope: "memory-os",
  maxItems: 6,
  maxTokens: 1200,
});

Agent 工具与客户端 Profile 访问

授权的 agent 通过 config/mcp-documentation-contract.json 中针对特定客户端 profile 定义的工具与项目交互：

• chatgpt-public、generic-public 和 public-only：公开 project、get_project_summary 和 open_project_workspace。
• claude-plugin：公开 project 和 get_project_context。
• cursor-plugin 和 ordinary-full：公开 get_project_context、update_project_todo 和 update_project_decision。
• 聊天内小组件区别：通过 open_project_workspace 打开的 ChatGPT Project Workspace 小组件是交互式聊天内卡片界面；它与位于 https://xmemo.dev/me#projects 的完整基于 Web 的 Memory Console 有所不同。