TokST Persistent memory for people and AI agents

TokST 帮助中心

快速处理下一步问题

搜索错误文本、命令或使用场景。每份指南都包含检查项、处理路径和成功验证。

安装与更新

tokst: command not found

安装独立 CLI 并刷新终端 PATH。

  1. 运行对应系统的安装器。
  2. 打开新的终端。
  3. 确认终端选中的二进制文件。
curl -fsSL https://tokst.com/install.sh | bash

阅读完整指南

安装与更新

更新后版本仍然较旧

刷新独立二进制，并确认终端实际使用的命令位置。

  1. 运行内置更新器。
  2. 打开新的终端。
  3. 检查当前二进制路径。
tokst update

阅读完整指南

登录与连接

浏览器授权没有返回终端

保持终端流程运行并重新发起浏览器授权。

  1. 保持终端授权流程运行。
  2. 重新执行设置流程。
  3. 授权后检查云端连接。
tokst setup

阅读完整指南

登录与连接

API 密钥或权限请求失败

检查已保存身份、目标工作区与密钥所有者权限。

  1. 检查当前云端连接。
  2. 查看可访问的工作区。
  3. 在控制台创建或轮换可信 API 密钥。
tokst connection test

阅读完整指南

本地模式

本地写入返回 SQLite 错误

保留本地数据库，更新 CLI 后收集配置状态。

  1. 更新独立 CLI。
  2. 修复前创建命名备份。
  3. 收集本地配置状态。
tokst update
tokst local backup create --name before-repair

阅读完整指南

本地模式

本地记忆没有出现在云端

本地同步需要先显式绑定本地知识库与云端知识库。

  1. 检查本地配置。
  2. 连接目标云端知识库。
  3. 执行手动同步。
tokst local status
tokst local connect --cloud-atlas-id <atlas-id>

阅读完整指南

工作区与团队

无法创建工作区或知识库

创建能力遵循个人或 Team 套餐的当前额度。

  1. 检查当前套餐与用量。
  2. 切换到目标工作区。
  3. 在可用额度内创建空间。
tokst status

阅读完整指南

工作区与团队

团队邀请没有出现

受邀用户需要在自己的账户中查看并接受邀请。

  1. 确认受邀邮箱地址。
  2. 查看受邀用户收件箱。
  3. 接受有效邀请后获得团队访问权限。
tokst workspace inbox

阅读完整指南

MCP 与智能体

MCP 工具没有出现

在运行本地 MCP 的机器授权，然后重启 MCP 客户端。

  1. 检查保存的云端连接。
  2. 刷新智能体集成文件。
  3. 重启 MCP 客户端。
tokst connection test
tokst init --agents codex,claude,cursor,opencode,pi --force

阅读完整指南

MCP 与智能体

WorkBuddy、ZCode、Qoder 或 Kimi 无法打开浏览器授权

在 Streamable HTTP MCP 的 Authorization 请求头中使用专用 API 密钥。

  1. 创建一把以客户端命名的专用 API 密钥。
  2. 将客户端传输方式设为 Streamable HTTP。
  3. 将完整密钥填入 Bearer 后并重启客户端。
{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": { "Authorization": "Bearer tk_live_your_api_key" }
    }
  }
}

阅读完整指南

MCP 与智能体

智能体消息缺失

重启后通过持久收件箱同步，长期运行智能体使用监听器。

  1. 确认可信智能体身份。
  2. 同步持久收件箱。
  3. 启动监听器获得即时投递。
TOKST_AGENT=1 tokst message inbox --json

阅读完整指南

MCP 与智能体

自动记忆没有出现

ACP 自动记忆会在已连接智能体会话结束时生成一条可撤销的 Markdown 记忆。显式 Session capture 继续用于确认后的结论。

  1. 为默认路由开启自动记忆。
  2. 通过 TokST 代理启动支持 ACP 的智能体。
  3. 检查连接与队列状态。
  4. 按需查看关联会话或归档自动记忆。
tokst auto on
tokst acp proxy -- <acp-agent-command> [args]
tokst auto status

阅读完整指南

文件与额度

文件或记忆关联缺失

检查文件回收站以及目标工作区中的记忆生命周期。

  1. 打开选定工作区的文件页面。
  2. 查看回收站和孤立文件修复结果。
  3. 恢复可用的记忆或文件关联。
tokst status

阅读完整指南

文件与额度

上传或请求达到额度

用量归属当前选定的个人或团队工作区。

  1. 检查套餐和可用用量。
  2. 确认选定的工作区。
  3. 需要时由团队 Owner 调整团队容量。
tokst status --json

阅读完整指南