管理上下文
Sources 与采集
Sources 在信息被筛选为知识之前保留证据。Content Source 保存采集的文本,其他 Source 类型可引用 Connector 提供的材料。 Work Contract 和 Task Outcome 也会保留 Source 证据。
采集与检查
- 选择已有 Scope。API Quick Start演示通过
POST /v1/sources/content采集内容, 并保留返回的 Source 引用。 - 使用
GET /v1/scopes/{scope_id}/sources浏览 Source journal,再通过GET /v1/scopes/{scope_id}/sources/{source_type}/{source_id}读取选中的 Source。 - 将符合条件的证据处理为 Memory,需要配置生成模型,并启用定时处理或显式执行 Memory flush。 步骤见启用提取与向量搜索。
采集成功表示证据已保存,不表示提取成功,也不表示内容一定值得长期保留。 通过 Source 引用追溯生成结果的输入。不要在同一身份下修改内容并重试采集,将其当作新的观察。
选择采集入口
- Agent Prompt Hook:在接入指南中选择宿主对应的采集开关。
- 安装前的 Codex Prompt:Server 运行时,使用
powercontext import-sessions --host codex从CODEX_HOME或~/.codex导入 CLI 所在机器上的历史用户 Prompt,也可以写入远程 Server。该命令只写入普通 Content Source,在 Codex home 目录下维护与目标 Server 绑定的持久 checkpoint,并跳过无法解析到 Scope 的 workspace。提取仍是独立操作;已配置的后台处理仍可处理导入的 Source。可先用--dry-run预览扫描结果。 - 文件与对象存储:使用 OpenDAL Connector。
- Scope Profile 的主体证据:按 Scope Profile写入。
- 应用或评测事件:使用应用对应适配器;Bub 采集需要显式启用。
Source 读写受所选 Scope 与访问策略约束。

