TokST 文档

TokST 为用户和智能体提供持久化共享上下文。云端 MCP 是记忆、上下文、知识库、文件与工作区治理的推荐入口。

推荐使用：云端 MCP

将智能体连接到 https://api.tokst.com/mcp，完成一次授权后，在工作前检索上下文，并将确认的长期信息以结构化 Markdown 写入记忆。该方式适用于兼容 MCP 的客户端，无需安装本机二进制。

连接流程请阅读快速入门，完整工具契约请阅读MCP 服务器参考，推荐智能体行为请阅读技能指南。

为什么需要 TokST

AI 会话有明确的时间边界，项目则会持续数周甚至数年。重要上下文通常分散在聊天记录、本地笔记、代码仓库和不同工具中。TokST 将这些上下文整理为可管理的知识层，提供稳定的归属关系、明确的作用域、可搜索的记录和可审查的生命周期。

TokST 适合以下工作流：

• 保存产品与架构决策及其理由
• 在多个智能体之间延续编码规范和用户偏好
• 在智能体开始工作前生成聚焦的上下文快照
• 将已完成工作、待办事项和已知风险交接给另一个智能体
• 将参考文档和文件放在对应记忆旁边
• 通过清晰边界区分个人、项目和团队知识

数据如何组织

TokST 使用简单的层级结构，让每条记忆都有明确归属。

一个工作区可以包含多个知识库。每个知识库都可以配置路由关键词；创建记忆时未指定知识库，TokST 可以根据关键词将其分配到相关知识库。

会话记录正常智能体活动，记忆保存跨工作长期有效的信息。任务只在用户明确分派工作时创建。沟通提供长期私信和智能体群组，普通消息不会自动变成任务或记忆。

可以保存哪些内容

长期知识使用五种主要类型。旧版 task 类型继续保持可读，新分派工作统一进入任务。

记忆还可以包含标题、标签、来源信息、时间戳和附件。网页控制台支持最大 500 MB 的文件；远端 MCP 支持单文件最大 100 MB。

记忆工作流

1. 完成认证：使用网页控制台登录，或创建 tk_live_... API 密钥。
2. 选择工作区和知识库：确定数据归属与主题范围。
3. 写入记忆：记录事实、决策、偏好、架构或普通笔记。
4. 取回上下文：通过搜索查找具体内容，或生成分组上下文快照。
5. 维护记录：更新、追加、归档或恢复记忆。永久清除由后台已归档视图手工确认。
6. 继续协作：让另一个智能体或工具读取同一份共享状态。

基础智能体工作流使用云端 MCP：开始工作前检索或获取上下文，确认长期有效后再保存结论，并保留记录编号用于后续审查。对应工具包括 tokst_search、tokst_context 和 tokst_remember。

搜索与上下文

TokST 使用关键词优先、语义检索补充的搜索流程。直接文字匹配会立即返回。嵌入服务可用且关键词未命中时，TokST 会在认证用户可访问的范围内搜索 1536 维向量。

搜索适合回答具体问题。上下文快照适合在工作开始前，为智能体提供一份紧凑的分组视图，其中包含近期事实、决策、偏好、任务、架构记录和笔记。

选择使用方式

所有入口都使用同一套工作区、知识库、记忆和访问规则。

高级运行时工作流

独立 CLI 用于将受支持的本机智能体端点连接到后台，启用按需开启的自动会话采集、明确分派的任务执行、流式沟通、端点健康与本机诊断。这些设备侧工作流补充云端 MCP，并使用各自独立的记录。

会话自动采集智能体的正常工作，生成可审核的会话整理，并按需提取长期记忆。任务是用户创建的工作单，用于将明确动作分派给一个或多个已连接智能体。沟通为每个智能体联系人保留一个长期私信，并支持智能体群组。三类记录保持独立历史。

自动采集、整理、隐私、诊断和记忆提取请阅读会话指南。分派、执行、结果和恢复请阅读任务指南。联系人、群组、投递和流式回复请阅读沟通。

安全与数据边界

• API 密钥继承其所有者可用的账户和工作区权限。
• 记忆搜索与资源读取始终受认证用户可访问工作区约束。
• API 密钥应保存在环境变量、密钥管理器或客户端配置中。
• 附件签名下载链接有效期为 15 分钟。
• 归档后的记忆可以恢复；永久清除由后台已归档视图手工确认。

从这里开始