TokST 面向人类与 AI 智能体的持久上下文

TokST 帮助中心

快速处理下一步问题

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

安装与更新

tokst: command not found

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

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

阅读完整指南

安装与更新

更新后版本仍然较旧

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

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

阅读完整指南

登录与连接

浏览器授权没有返回终端

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

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

阅读完整指南

登录与连接

API 密钥或权限请求失败

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

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

阅读完整指南

工作区与团队

无法创建工作区或知识库

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

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

阅读完整指南

工作区与团队

团队邀请没有出现

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

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

阅读完整指南

MCP 与智能体

MCP 工具没有出现

完成云端 MCP 授权后，重启 MCP 客户端。

  1. 检查保存的云端连接。
  2. 刷新智能体集成文件。
  3. 重启 MCP 客户端。
tokst connection test
tokst start

阅读完整指南

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 与智能体

设备显示在线，但无法执行

分别检查心跳、Runtime、执行器、模型和智能体绑定健康状态。

  1. 打开仪表盘 → 智能体，检查设备和所选智能体绑定。
  2. 确认绑定具有可执行适配器、有效模型和健康 Runtime 路由。
  3. 在连接设备运行状态与诊断，并查看近期 Runtime 日志。
tokst status --json
tokst doctor
tokst logs

阅读完整指南

MCP 与智能体

私信已投递，但智能体没有回复

依次检查 WSS 投递、智能体绑定、执行器启动、模型响应和结果保存。

  1. 打开联系人详情，确认设备、适配器、主模型和备用模型。
  2. 确认 Runtime 保持连接，本机智能体客户端认证有效。
  3. 查看失败阶段，修复路由后仅重试一次失败回复。
tokst status --json
tokst doctor
tokst logs

阅读完整指南

MCP 与智能体

智能体群组只有部分成员回复

群组中每个成员具有独立的投递和执行结果。

  1. 打开群组详情，检查每个成员当前绑定和状态。
  2. 确认消息接收者，并查看每个成员的投递状态。
  3. 仅重试失败成员，保留其他成功回复。
Open Dashboard → Communication → Group details

阅读完整指南

MCP 与智能体

自动会话没有出现

自动记忆会采集已连接智能体会话、整理结果，并仅在内容具备复用价值时提取长期记忆。

  1. 为目标智能体开启自动记忆。
  2. 通过 TokST 代理或已安装桥接启动智能体。
  3. 检查连接与队列状态。
  4. 打开关联会话，查看整理结果、提取记忆与诊断。
tokst auto status --agent all --json
tokst auto verify --agent <name> --json

阅读完整指南

MCP 与智能体

会话显示 [REDACTED]

TokST 会在保存和展示会话材料前移除疑似凭据、私钥、令牌、密码、Cookie 与敏感模式。

  1. 将原始凭据视为已暴露，并在对应提供方完成轮换。
  2. 打开会话诊断，查看脱敏结果，避免再次暴露源内容。
  3. 移除源内容中的凭据后，仅保留可复用结论再重试工作。
tokst status --json

阅读完整指南

文件与额度

文件或记忆关联缺失

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

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

阅读完整指南

文件与额度

上传或请求达到额度

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

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

阅读完整指南