TokST 面向人類與 AI 智能體的持久上下文

幫助中心

本頁協助處理 TokST 安裝、連線和日常使用的常見問題。每個項目提供最快處理方式和驗證指令。

安裝與更新

tokst: command not found

安裝獨立 CLI 後，開啟新的終端機讓 PATH 生效。

curl -fsSLo tokst-install.sh https://tokst.com/install.sh
sh tokst-install.sh
tokst version

Windows PowerShell：

Invoke-WebRequest https://tokst.com/install.ps1 -OutFile "$env:TEMP\\tokst-install.ps1"
& "$env:TEMP\\tokst-install.ps1"
tokst version

Windows Git Bash 支援 Unix 指令，安裝腳本會自動啟動 PowerShell 安裝器。

更新後版本仍然較舊

tokst update 會下載並驗證最新的獨立 CLI 二進位。終端機仍解析到舊路徑時，請透過版本詳情檢查目前二進位。

tokst update
tokst version --verbose
tokst doctor
tokst doctor --fix-path

獨立安裝或 PATH 修復後請開啟新的終端。安裝器會記錄獨立二進位位置，同時保留雲端授權。

登入與雲端連線

瀏覽器授權沒有返回終端機

瀏覽器確認期間保持終端機程序執行。瀏覽器顯示連線請求失效時，重新開始授權流程。

tokst login
tokst connection test

CI、伺服器和無人值守環境使用 API 金鑰：

tokst login --key tk_live_xxxx
tokst connection test

為智能體工作流程選擇知識庫

雲端 MCP 提供工作區和知識庫工具。寫入共享記憶前，請在後台或已驗證智能體中選擇正確的受治理範圍。

已退役的本機模式

TokST 本機模式已退役。既有裝置檔案繼續保留；CLI 不再開啟、匯出、復原、同步或提供 Local SQLite 設定。已連線 Runtime 裝置保留內部加密佇列，用於去識別投遞復原。請查看 TokST 本機模式已退役。

工作區與知識庫

無法建立工作區或知識庫

工作區和知識庫建立遵循目前方案額度。檢查控制台帳戶用量，切換到目標工作區後重試。

tokst status

Cloud Free 包含一個個人工作區和一個知識庫。團隊工作區使用獨立 Team 訂閱和共享額度。詳情參考 版本與額度。

看不到團隊邀請

受邀使用者可以在控制台查看、接受或拒絕所有待處理邀請。已驗證智能體使用對應的雲端 MCP 工作區工具。

團隊 Owner 與 Admin 可在團隊協作中管理邀請。

MCP 與智能體設定

WorkBuddy、ZCode、Qoder 或 Kimi 無法開啟瀏覽器授權

在「後台 → API 金鑰」建立專用金鑰。將用戶端傳輸方式設為 Streamable HTTP，並透過 Authorization 請求標頭在每個請求中傳遞該金鑰。停止使用用戶端後請撤銷該金鑰。

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_api_key"
      }
    }
  }
}

MCP 工具沒有出現

重新連線 MCP 用戶端至 https://api.tokst.com/mcp，並完成瀏覽器授權。 授權後重新啟動 MCP 用戶端，並讓它列出可存取的 TokST 工作區。OAuth 與 API 金鑰設定請查看 MCP 概述。

裝置顯示上線，但無法執行

儀表板狀態同時參考心跳與執行健康。開啟「智能體」，選擇裝置和智能體綁定，檢查生效適配器、主要模型、備用模型、WSS 路由和最近診斷。

tokst status --json
tokst doctor
tokst logs

健康狀態應為「可執行」。近期心跳只表示 Runtime 回報了上線狀態。

私訊已投遞，但智能體沒有回覆

開啟聯絡人詳情並查看投遞階段。確認綁定裝置保持連線、本機智能體用戶端驗證有效、所選模型可用。修復頁面顯示的路由或執行器錯誤後，只重試失敗回覆。

訊息狀態、WSS 投遞、串流回覆、群組與復原流程請查看溝通。

智能體群組只有部分成員回覆

群組中每個成員都有獨立投遞和執行記錄。開啟群組詳情，逐一檢查成員，並只重試失敗成員。成功回覆繼續保留在共享對話中，並成為後續群聊上下文。

自動工作階段沒有出現

自動記憶預設關閉。為目標支援用戶端啟用後，重新啟動該用戶端一次，並完成一條包含最終回覆的請求。

tokst auto status --agent all --json
tokst auto verify --agent <name> --json

開啟「儀表板 -> 工作階段」查看整理或診斷狀態。詳情請查看工作階段。

檔案、用量與安全

檔案仍在，關聯記憶已消失

開啟控制台的「檔案」頁面並檢查回收站。還原記憶後會恢復一般關聯；修復工具會識別待處理的孤立附件。

上傳、用量或權限請求失敗

確認目標工作區、個人或團隊剩餘額度以及工作區角色。Owner 管理訂閱和稽核權限，Admin 管理團隊內容，Member 管理自己的記憶。

tokst status

API 金鑰繼承其所有者權限。請在控制台撤銷閒置金鑰，並只向可信自動化提供金鑰。詳情參考 API 金鑰。

仍需協助

請準備指令、完整錯誤訊息、已安裝版本、作業系統，以及本機端點、CLI、雲端 MCP、控制台或 REST 相容介面的使用方式。完整資訊可讓支援和問題排查快速重現。

tokst version
tokst doctor
tokst connection test
tokst status --json