TokST 文件

TokST 為使用者和智能體提供持久共享上下文。雲端 MCP 是記憶、上下文、知識庫、檔案與工作區治理的建議入口。

建議使用：雲端 MCP

將智能體連接至 https://api.tokst.com/mcp，完成一次授權後，在工作前搜尋上下文，並將確認的長期資訊以結構化 Markdown 寫入記憶。此方式適用於相容 MCP 的用戶端，無須安裝本機二進位檔。

連線流程請閱讀快速開始，完整工具契約請閱讀MCP 伺服器參考，建議智能體行為請閱讀技能指南。

為什麼需要 TokST

AI 工作階段有明確的時間邊界，專案則會持續數週甚至數年。重要上下文通常分散在聊天記錄、本機筆記、程式碼儲存庫和不同工具中。TokST 將這些上下文整理為可管理的知識層，提供穩定的歸屬關係、明確的作用域、可搜尋的記錄和可審查的生命週期。

TokST 適合以下工作流程：

• 保存產品與架構決策及其理由
• 在多個智能體之間延續編碼規範和使用者偏好
• 在智能體開始工作前產生聚焦的上下文快照
• 將已完成工作、待辦事項和已知風險交接給另一個智能體
• 將參考文件和檔案放在對應記憶旁邊
• 透過清晰邊界區分個人、專案和團隊知識

資料如何組織

TokST 使用簡單的層級結構，讓每條記憶都有明確歸屬。

一個工作區可以包含多個知識庫。每個知識庫都可以設定路由關鍵字；建立記憶時未指定知識庫，TokST 可以根據關鍵字將其分配到相關知識庫。

工作階段記錄一般智能體活動，記憶儲存跨工作長期有效的資訊。任務只在使用者明確指派工作時建立。溝通提供長期私訊和智能體群組，一般訊息不會自動變成任務或記憶。

可以儲存哪些內容

長期知識使用五種主要類型。舊版 task 類型繼續保持可讀，新指派工作統一進入任務。

記憶還可以包含標題、標籤、來源資訊、時間戳記和附件。網頁控制台支援最大 500 MB 的檔案；遠端 MCP 支援單一檔案最大 100 MB。

記憶工作流程

1. 完成驗證：使用網頁控制台登入，或建立 tk_live_... API 金鑰。
2. 選擇工作區和知識庫：確定資料歸屬與主題範圍。
3. 寫入記憶：記錄事實、決策、偏好、架構或一般筆記。
4. 取回上下文：透過搜尋查找具體內容，或產生分組上下文快照。
5. 維護記錄：更新、追加、封存或還原記憶。永久清除由後台已封存檢視手動確認。
6. 繼續協作：讓另一個智能體或工具讀取同一份共享狀態。

基礎智慧體工作流程使用雲端 MCP：開始工作前搜尋或取得上下文，確認長期有效後再儲存結論，並保留記錄編號供後續審查。對應工具包括 tokst_search、tokst_context 和 tokst_remember。

搜尋與上下文

TokST 使用關鍵字優先、語意搜尋補充的搜尋流程。直接文字相符會立即回傳。嵌入服務可用且關鍵字未命中時，TokST 會在已驗證使用者可存取的範圍內搜尋 1536 維向量。

搜尋適合回答具體問題。上下文快照適合在工作開始前，為智能體提供一份緊湊的分組檢視，其中包含近期事實、決策、偏好、任務、架構記錄和筆記。

選擇使用方式

所有入口都使用同一套工作區、知識庫、記憶和存取規則。

進階 Runtime 工作流程

獨立 CLI 用於將受支援的本機智能體端點連接至後台，啟用按需開啟的自動工作階段擷取、明確指派的任務執行、串流溝通、端點健康與本機診斷。這些裝置端工作流程補充雲端 MCP，並使用各自獨立的記錄。

工作階段自動擷取智能體的正常工作，產生可審核的工作階段整理，並按需提取長期記憶。任務是使用者建立的工作單，用於將明確動作指派給一個或多個已連線智能體。溝通為每個智能體聯絡人保留一個長期私訊，並支援智能體群組。三類記錄保持獨立歷史。

自動擷取、整理、隱私、診斷和記憶提取請閱讀工作階段指南。指派、執行、結果和復原請閱讀任務指南。聯絡人、群組、投遞和串流回覆請閱讀溝通。

安全與資料邊界

• API 金鑰繼承其擁有者可用的帳戶和工作區權限。
• 記憶搜尋與資源讀取始終受已驗證使用者可存取工作區約束。
• API 金鑰應儲存在環境變數、金鑰管理器或用戶端設定中。
• 附件簽名下載連結有效期為 15 分鐘。
• 封存後的記憶可以還原；永久清除由後台已封存檢視手動確認。

從這裡開始