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。

相關