TokST Persistent memory for people and AI agents

技能指南

TokST 技能文件（skill.md）是一个自包含文档，AI 智能体读取后即可安装并使用 TokST 记忆。本页说明如何使用。

什么是 skill.md？

skill.md 是一个托管在 https://tokst.com/skill.md 的 Markdown 文件。它包含 AI 智能体所需的操作规则：

  1. 安装 TokST CLI
  2. 完成浏览器授权，或为自动化使用 API 密钥
  3. 在支持 Skills 的客户端中放入对应目录
  4. 读取、检索、写入和治理长期记忆
  5. 使用云端或本地会话，并完成工作区内的智能体交接

智能体可以通过 URL fetch 读取，用户也可以直接将其内容粘贴到对话框中。

一键设置

将这个链接分享给任何 AI 智能体，它可读取当前的安装与使用规则：

https://tokst.com/skill.md

如何使用

复制以下消息，粘贴到智能体的对话框中：

Read https://tokst.com/skill.md. Install TokST, configure the matching MCP mode, and follow the Session memory workflow.

安装器会打开浏览器授权，并在升级时保留本地连接。WorkBuddy、ZCode、Qoder、Kimi 及其他支持 Skills 或 MCP 的客户端可使用同一份 skill.md。

版本检查

技能文件包含版本标记（<!-- skill-version: 0.8.3 -->）。智能体可以对比本地安装版本和远程版本以检测更新：

# 已安装版本
grep "^version:" ~/.claude/skills/tokst-memory/SKILL.md

# 最新版本
curl -fsSL https://tokst.com/skill.md | grep "skill-version:"

支持的智能体

将 skill.md 以 SKILL.md 的名称放入目标客户端使用的目录：

智能体技能目录
Claude Code~/.claude/skills/tokst-memory/
ZCode~/.zcode/skills/tokst-memory/
Cursor / Windsurf~/.cursor/skills/tokst-memory/
Codex CLI~/.codex/skills/tokst-memory/
Pi~/.pi/skills/tokst-memory/
WorkBuddy~/.workbuddy/skills/tokst-memory/
Qoder~/.qoder/skills/tokst-memory/
Kimi Code~/.kimi-code/skills/tokst-memory/
通用 MCP~/.agents/skills/tokst-memory/

连接方式

支持浏览器 OAuth 的 MCP 客户端可连接 https://api.tokst.com/mcp 并在 TokST 中批准授权。静态 MCP 客户端使用 Authorization 请求头中的专用 API 密钥。本地 MCP 在 tokst setup --local 后通过 tokst local mcp 运行，数据保存在设备 SQLite 配置中。

TokST 云端 MCP 提供 51 个工具，覆盖记忆、工作区、文件、会话、自动记忆、可信 Agent 身份和消息。公开 Skill 包含 PATH 冲突、浏览器授权、静态 MCP 鉴权、额度、Local SQLite 修复、自动记忆诊断和 Agent 监听重连的简洁恢复路径。

仪表盘集成

在仪表盘创建自动化 API 密钥时，创建弹窗会提供：

  • 可直接复制的 SKILL.md（内嵌你的密钥）
  • 快速安装脚本（终端粘贴）
  • MCP 配置 JSON
  • 每个密钥旁的 Copy for Agent 按钮

浏览器登录和远端 MCP 授权不会创建 API 密钥。通过智能体页面查看可信 agt_... 身份与工作区交接消息。

WorkBuddy、ZCode、Qoder、Kimi Code 也可在各自的 Skills 或 Agent Skills 设置中导入 https://tokst.com/skill.md。

相关