插件中心三篇中文文章重写证据报告
日期：2026-08-30
Comet 源码基线：D:\Project\Comet@baef0646。该工作区有与 Native Runtime、CHANGELOG 和 website submodule 相关的未提交改动；本报告引用的插件、Agent Learning、Personal Memory、Project Knowledge 源码不在当前脏改动列表中。
站点基线：D:\Project\comet-website-docs@75201fb。站点没有项目级research/或notes/目录（只有.agents/.claude下的 research Skill），因此按任务要求新建本文件。
证据等级：S = 当前源码事实，D = 当前产品/运行文档合同，H = 历史 research 结论，I = 业界官方事实，P = 本报告据此提出的产品推论。
结论先行
三篇文章应该共同讲清一件事：Comet 插件中心不是一个“多存几段提示词”的设置页，而是让 Agent 把长期协作经验和项目工程知识安全地带到下一次任务的产品层。- **Personal Memory（个人记忆）**回答“这个用户希望怎样协作”。它属于用户，既可全局生效，也可只在一个项目生效；默认不共享给团队，也不会变成项目规则。【S：
domains/comet-memory/plugin.ts:36-53,187-278,279-367；D：docs/operations/PERSONAL-MEMORY-ZH.md:1-30】 - **Project Knowledge（项目知识）**回答“这个项目是什么、为什么这样设计、改动时要核对什么”。一个插件内部包含 Project Model（项目模型）和 Project Policy（项目策略）；旧 Project Rules 插件和命令已经删除。【S：
domains/project-knowledge/plugin.ts:48-69,117-138；test/repository/project-rules-removed.test.ts:1-39】 - Agent Learning Loop回答“经验怎样变成下一次可用的上下文”。它是两个插件共享的运行机制，不是 Dashboard 中第三个独立插件，也不是模型训练。源码中的循环是事件采集、Journal、Reflection、Consolidation、Context 选择、应用结果反馈。【S：
domains/agent-learning/types.ts:1-23,79-95,146-168；domains/agent-learning/coordinator.ts:83-138,180-252；domains/comet-plugin/integration.ts:356-472】 - **Rule / AGENTS.md / CLAUDE.md /
.cursor/rules**是宿主直接加载的行为指令；Hook / linter / test / CI负责执行时观察、拦截或确定性校验；Project Knowledge是可追溯、可检索、按任务激活的工程知识层。三者协作，不应在文案中互称同义词。【D：docs/operations/PROJECT-KNOWLEDGE-ZH.md:1-17；I：Claude、Codex、Cursor 官方资料，见下文】
一、当前 Comet 的真实产品与运行时边界
1. 插件中心的真实对象
当前默认 Plugin Bridge 只注册两个面向用户的第一方插件：comet.personal-memory 和 comet.project-knowledge，随后通过 reconcileFirstParty() 默认启用。Plugin Runtime 支持 enabled / disabled / uninstalled，也支持按项目暂停；停用会卸载活动模块，未见删除插件数据的动作。【S：domains/comet-plugin/integration.ts:356-472；domains/comet-plugin/plugin-runtime.ts:179-205,230-264,472-523】
Runtime 给插件的公开能力包括：订阅 Experience、Reflection/Consolidation、提供/展开 Context、Dashboard 页面和 capability 调用。第一方和第三方走同一接口；第三方安装或更新必须由用户发起。【S：domains/comet-plugin/types.ts:10-13,74-107；domains/comet-plugin/plugin-runtime.ts:638-646】
因此，“Agent Learning Loop”文章应定位为插件中心的工作原理，不要写成第三张插件卡或第三套存储。
2. Personal Memory：用户拥有的协作连续性
当前源码将个人记忆分为：core-profile：语言、角色、稳定偏好；collaboration-policy：按项目、路径、任务、操作、阶段匹配的个人协作方式；personal-episode：一次成功、纠正或失败的紧凑经历。
global/project 作用域和 explicit/inferred 来源。显式长期信号同步处理，显式记录初始即 proven；推断记录初始为 trial，应用成功可转为 proven，纠正或造成失败可转为 superseded。【S：domains/agent-learning/types.ts:18-23,42-50,63-68；domains/agent-learning/coordinator.ts:83-115；domains/comet-memory/personal-memory.ts:1694-1737；domains/comet-memory/plugin.ts:279-335】
它明确过滤 diff、堆栈、stdout/stderr、测试/命令/提交等任务日志式内容；产品文档还排除完整会话、隐藏推理和容易从仓库重建的事实。【S：domains/comet-memory/personal-memory.ts:2680-2716；D：docs/operations/PERSONAL-MEMORY-ZH.md:1-12】
用户核心价值不是“保存聊天记录”，而是：
- 不必跨任务反复说明语言、表达方式、证据习惯和协作节奏；
- 项目内个人习惯仍保持私有，不误写成团队共识；
- 可以查看、纠正、遗忘、回滚，并知道某条记忆为什么被使用；
- 记忆故障不会阻断 Native、Classic、Hotfix 或 Tweak。
3. Project Knowledge：Agent 的项目理解层
当前comet.project-knowledge 是 project-scope 第一方插件。Record 类型分为两组：
- Project Model：
topology / fact / dependency，回答项目是什么； - Project Policy：
decision / pattern / procedure / constraint / failure-resolution，回答以后怎样做。
domains/project-knowledge/plugin.ts:48-69,128-138】
它订阅验证、Review、故障闭环、Change Archive、仓库变化和 Context 结果，形成或更新项目记录。只有 Project Policy 可以达到 enforced，且产品合同把这一状态限定为绑定当前存在、成功执行过的确定性验证命令。【S：domains/project-knowledge/plugin.ts:383-457；D：docs/operations/PROJECT-KNOWLEDGE-ZH.md:8-31】
Local corpus 当前自动发现 Comet 管理的 Native/Classic specs、archives、Superpowers 文档；额外普通 Markdown 必须由 knowledge.local.include glob 配置。不要在文章中承诺 AGENTS.md、CLAUDE.md 或 .cursor/rules 会被默认自动索引；它们只有匹配用户自定义 include 时才进入这个 Markdown corpus。【S：domains/project-knowledge/corpus.ts:330-376】
用户核心价值不是“更快搜文档”，而是让 Agent 第一次进入任务时就获得：模块职责、关键依赖、已接受决策、易漏集成点、验证路径和历史故障解法；同时每条内容保留来源、适用范围、新鲜度和验证方式。当前代码、配置和测试仍需现场核对，Project Knowledge 只提供定向假设与检查清单。【H：docs/research/2026-08-22-agent-project-knowledge-memory-retrieval-architecture.md:59-97,154-179,489-532,1038-1056】
4. Agent Learning Loop：经验治理，不是无边界“自进化”
源码公开comet.agent-experience.v1，事件包括 user.signal、任务完成、验证、Review、故障解决、Archive、仓库变化、Context 应用和结果。Journal 先幂等持久化，再按 episode/evidence 分块 Reflection；显式长期用户信号同步处理，其他内容可后台处理并重放。不同 Learner 独立 Consolidate，失败只记录诊断，不让另一个插件或工作流一起失败。【S：domains/agent-learning/types.ts:1-12,79-95；domains/agent-learning/experience-journal.ts:110-158；domains/agent-learning/coordinator.ts:83-138,180-252,291-343】
Context Director 先按 project/path/operation/phase/task 过滤，排除 superseded，再按权威等级和历史效果排序。Core Profile 与少量 proven/enforced Policy 可完整投递；其他候选进入带 whyApplied 的 Manifest，可按稳定 ID 展开。应用结果会再次写回 Journal。【S：domains/agent-learning/context-director.ts:322-455,533-580,583-714；domains/comet-plugin/integration.ts:111-175,200-233】
这里的“学习”应产品化解释为：从可核对的工作结果中形成可撤销的外部记忆。它不训练模型参数，不保存隐藏推理，不自动改写 AGENTS/Rule/Skill/linter/CI，也不扩大提交、推送、删除或发布权限。【D：docs/comet/specs/personal-memory/spec.md:63-88；docs/comet/specs/project-knowledge/spec.md:68-88】
二、Project Knowledge 与 Rule / 项目指令的关系
最适合中文用户的一句话是：
项目知识让 Agent 先读懂项目；Rule 让 Agent 按团队约定行动；Hook 和检查守住必须执行的边界。“项目规则”改为“项目知识”的根本原因：Rule 天然暗示“必须遵守的一条要求”，但该插件实际还包含拓扑、事实、依赖、决策背景和故障解法。继续叫“项目规则”会把“知道什么”和“必须怎么做”混在一起，也容易让用户误以为 Comet 会创建或覆盖宿主 Rule 文件。当前 Dashboard contribution 已只显示“项目知识”，路由也已是
/plugins/project-knowledge。【S：domains/project-knowledge/plugin.ts:117-125】
三、业界怎么做，为什么
Claude Code
Claude Code 官方明确分开两类跨会话内容：CLAUDE.md 是用户写的持久指令，Auto Memory 是 Claude 根据纠正与偏好自行写的 notes；两者都是 Context，不是硬性配置，必须阻止动作时使用 PreToolUse Hook。.claude/rules/ 支持按 path 加载以减少噪声和上下文占用；Auto Memory 按仓库共享 worktree，且跳过能从代码或 CLAUDE.md 推导的内容。官方：How Claude remembers your project
对 Comet 的意义（P）：个人记忆和项目指令必须分开；自然语言上下文负责引导，确定性阻断交给 Hook/权限/检查。Comet 进一步把项目事实与程序性策略结构化，并记录来源和应用结果。
OpenAI Codex
Codex 从$CODEX_HOME 及项目根到 cwd 聚合 AGENTS.override.md / AGENTS.md，项目文档默认合计上限 32 KiB；Skill 在初始 Context 中先暴露元数据与使用规则。官方：Unrolling the Codex agent loop；官方：AGENTS.md
OpenAI 的 Harness Engineering 实践明确把 repository knowledge 作为 system of record，并让短 AGENTS.md 主要充当通向结构化 docs 的地图；原因是巨型指令文件会挤占上下文、稀释重点、快速腐化且难以验证。官方：Harness engineering
对 Comet 的意义（P）：Project Knowledge 应是可定位、可验证、按任务召回的知识层；AGENTS/Rule 保持短、明确、作用域清晰。当前官方资料未声明 Codex 会自动把每次对话写回项目知识库，文章不要暗示这是行业默认能力。
Cursor
Cursor 把 Rules 定义为 Prompt 层的持久、可复用 Context。Project Rules 位于.cursor/rules，版本化并限定代码库，可 Always、按 glob、按相关性或手工激活；根/子目录 AGENTS.md 会合并且更具体者优先。官方：Cursor Rules
Cursor 历史 Memories 功能把聊天中抽取的内容做成 project-scoped memory，并为后台生成加入用户批准；该页面属于历史路径，当前产品状态应谨慎表述。官方历史页：Memories；官方 Changelog 1.2
Cursor Hooks 可观察、控制和扩展 Agent loop，用于审计、阻断命令和脱敏。官方 Changelog 1.7
对 Comet 的意义（P）：Cursor 证明了“按相关性/路径激活”与“自动记忆需可治理”的产品价值；Comet 不应把聊天抽取结果直接提升成团队项目知识，更不应把 Rule 和 Hook 写成同一种能力。
四、历史 research 中仍有效与已经演进的结论
- 仍有效：普通 Memory 不能直接成为团队强制规范；不能让 Agent 自动覆盖共享 AGENTS/Rule/Hook；个人偏好、项目事实、团队规范和安全策略必须分域。【H：
docs/research/2026-08-07-agent-self-evolution-landscape.md:9-36,82-101,138-150】 - 仍有效：行业已普遍采用路径/相关性激活，Hook 只是宿主投递与执行适配之一；自然语言指令不等同于确定性检查。【H：
docs/research/2026-08-14-contextual-project-standards.md:9-21,23-47】 - 仍有效：项目级个人偏好留在 Personal Memory；可由当前仓库证据验证、可复用的工程事实进入 Project Knowledge；两者都不能授权高风险操作。【H：
docs/research/2026-08-22-agent-project-knowledge-memory-retrieval-architecture.md:59-97】 - 已演进：2026-08-14 research 建议把能力叫 Project Standards，并讨论
.comet/rules/*.md；当前源码已经删除旧 Project Rules 插件，并确定一个“项目知识”入口、内部 Project Model + Project Policy。重写应以当前源码为准，只保留旧研究关于 Rule/Check/Instruction 确定性分层的术语依据。【H：docs/research/2026-08-14-team-rules-terminology.md:9-23,81-140,170-180；S：test/repository/project-rules-removed.test.ts:1-39】
五、三篇文章的推荐产品叙事
《Agent Learning Loop》
开头先回答：为什么 Agent 每次都像第一次合作？ 然后用一个闭环讲清Experience → Reflection → Consolidation → Activation → Outcome。重点是证据、作用域、可撤销和失败隔离，不要从事件 schema、CLI 命令或配置开篇。
核心承诺：用户的纠正能成为下一次协作方式；已闭环的 Review、故障和 Archive 能成为下一次项目上下文；使用结果会继续校准。明确非承诺：不是模型训练，不保存完整轨迹，不自动改写 Rule/Skill/检查。
《个人记忆》
开头先回答：你不再需要在每个任务里重新教 Agent 怎样和你合作。 以“跨项目偏好 / 当前项目个人习惯 / 一次性要求不记住”三个中文场景区分作用域。再解释 Core Profile、Collaboration Policy、Personal Episode 和trial/proven/superseded。
核心承诺：私有、可查看、可纠正、可忘记、按任务相关性使用。不要把价值写成“无限容量”“聊天备份”或“自动生成团队规则”。
《项目知识》
开头先回答：让 Agent 少做一轮盲目探索，更早找对模块、补全影响范围并运行正确验证。 先用 Project Model / Project Policy 解释“项目是什么 / 以后怎样做”，再用一张边界表说明 Knowledge、Rule、Hook/Check。 核心承诺：可追溯、项目隔离、按需激活、来源变化后失效、与个人记忆分离。标题和正文统一使用“项目知识”；“项目规则”只作为旧称或关系解释出现一次。URL slug 是否从project-rules 迁移属于站点兼容决策，不属于本报告范围。
六、写作时必须避免的过度承诺
- 不要把 Agent Learning Loop 写成第三个可安装插件；它是共享运行机制。
- 不要说 Project Knowledge 会默认扫描所有 AGENTS.md / CLAUDE.md / Cursor Rules；当前默认 corpus 没有这个保证。
- 不要说 Project Policy 等于 Rule，或 Comet 会静默修改宿主指令、Skill、linter、测试、构建和 CI。
- 不要说任何自然语言策略都能“强制执行”；
enforced只属于绑定现有确定性验证入口的 Project Policy。 - 不要把 Personal Memory 的 project scope 写成团队共享知识；共享必须显式、脱敏并重新核对来源。
- 不要承诺“所有超出字符预算的已存记录一定出现在当前 Manifest”。源码中 Context Director 确实会把无法完整投递的候选降级为 Manifest，但 Personal Memory Provider 在它之前仍按
profile/task字符限制选择候选。最稳妥的产品说法是：“Comet 优先完整提供关键策略，其余相关候选以摘要按需展开；每次任务只使用有界上下文。”【S：domains/agent-learning/context-director.ts:399-448；domains/comet-memory/personal-memory.ts:2147-2204】
来源索引
当前源码与产品合同
D:\Project\Comet\domains\comet-plugin\types.tsD:\Project\Comet\domains\comet-plugin\plugin-runtime.tsD:\Project\Comet\domains\comet-plugin\integration.tsD:\Project\Comet\domains\agent-learning\types.tsD:\Project\Comet\domains\agent-learning\experience-journal.tsD:\Project\Comet\domains\agent-learning\coordinator.tsD:\Project\Comet\domains\agent-learning\context-director.tsD:\Project\Comet\domains\comet-memory\plugin.tsD:\Project\Comet\domains\comet-memory\personal-memory.tsD:\Project\Comet\domains\project-knowledge\plugin.tsD:\Project\Comet\domains\project-knowledge\corpus.tsD:\Project\Comet\docs\operations\PERSONAL-MEMORY-ZH.mdD:\Project\Comet\docs\operations\PROJECT-KNOWLEDGE-ZH.mdD:\Project\Comet\test\repository\project-rules-removed.test.ts
历史 research
D:\Project\Comet\docs\research\2026-08-07-agent-self-evolution-landscape.mdD:\Project\Comet\docs\research\2026-08-14-team-rules-terminology.mdD:\Project\Comet\docs\research\2026-08-14-contextual-project-standards.mdD:\Project\Comet\docs\research\2026-08-16-hermes-self-improving-memory-comparison.mdD:\Project\Comet\docs\research\2026-08-22-agent-project-knowledge-memory-retrieval-architecture.mdD:\Project\Comet\docs\research\2026-08-22-agent-project-knowledge-engine-technical-design.md