记忆管理
记忆保存可跨会话和跨任务复用的已确认知识。通过 TokST 云端 MCP 检索和写入记忆；通过 仪表盘 → 记忆 浏览、编辑、审核、归档和追溯每条记录。
适合保存的内容
| 类型 | 保存内容 |
|---|---|
fact | 已确认的项目、用户、基础设施或运营信息 |
decision | 已批准的选择、理由和约束 |
preference | 长期有效的个人、团队或项目约定 |
architecture | 系统边界、组件、接口和运行设计 |
note | 其他可长期复用的上下文 |
task | 历史兼容记录；已分派工作应进入正式任务 |
执行结果应保留在会话或任务中。只有结果包含可供其他人或智能体复用的知识时，才提取一条或多条记忆。
智能体工作流
- 使用
tokst_context获取紧凑的范围化上下文，或使用tokst_search回答具体问题。 - 在提出变更前，用当前证据核对检索结果。
- 在事实或决策确认后调用
tokst_remember。 - 需要审查时填写标题、合适的类型、聚焦标签和结构化 Markdown。
- 信息变化时更新、归档、恢复或替代现有记录。
MCP 连接会提供已认证用户和可信智能体身份。请使用与当前工作相匹配的最小工作区和知识库范围。
写出高质量记录
简单事实可使用简短文本。需要保留结构时使用 Markdown：
| 类型 | 建议栏目 |
|---|---|
| 事实 | 结论、来源、范围 |
| 决策 | 决策、背景、理由、影响 |
| 偏好 | 偏好、适用范围、例外 |
| 架构 | 目标、组件、数据流、约束 |
| 备注 | 摘要、详情、下一步 |
保留重要数值、表格、配置变更、文件路径、已确认风险和具体下一步。记录保持用户和来源材料使用的工作语言。
云端 MCP 的单条记忆正文最大为 512 KiB UTF-8 Markdown，成功写入会返回实际字节数。来源内容更大时，请附加原始文件，并保存完整、可读的摘要与来源链接。
不进入长期记忆的数据
请勿保存密码、API 密钥、私钥、Cookie、访问令牌和其他凭据。原始推理、终端日志、原始工具 JSON、调试记录、配额错误、网络重试和重复输出应保留在当前工作记录或诊断中。
用户授权保存的业务和个人信息按记录需要完整保留。凭据应存入专用密钥管理器，记忆仅保存长期有效的决策、引用或访问流程。
搜索与上下文
TokST 使用关键词优先、语义补充的检索方式。文字直接匹配会立即返回；配置嵌入服务且关键词结果无法回答请求时，可使用语义检索。
tokst_search 适合具体问题、类型筛选、标签筛选和历史决策。智能体开始工作前需要一份紧凑分组视图时，使用 tokst_context 获取相关事实、决策、偏好、架构和备注。
生命周期与证据
| 状态 | 含义 | 检索 | 恢复 |
|---|---|---|---|
| 活跃 | 当前可用 | 默认包含 | 可操作 |
| 已归档 | 保留但退出正常检索 | 默认排除 | 可以恢复 |
| 已删除 | 永久移除 | 不可用 | 不可用 |
需要清晰可信链路的记录可附加证据、可信度、有效期和审核状态。修订决策时，通过更新或替代关系保留旧记录，让后续智能体理解变化过程。
文件与导入
可通过仪表盘或对应云端 MCP 附件工具上传支持文件。导入适用于已有来源材料；在将导入内容视作长期知识前应完成审核。
Cloud MCP 是当前记忆入口。可选 CLI Runtime 负责设备和智能体 Binding，并提供按需会话、明确任务、沟通与诊断。