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 Proxy 或已安裝橋接啟動智慧體。
  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

閱讀完整指南