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 Proxy 啟動支援 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

閱讀完整指南