記憶管理
記憶保存可跨工作階段和跨任務重用的已確認知識。透過 TokST 雲端 MCP 檢索和寫入記憶；透過 儀表板 → 記憶 瀏覽、編輯、審核、封存和追溯每筆記錄。
適合儲存的內容
| 類型 | 儲存內容 |
|---|---|
fact | 已確認的專案、使用者、基礎設施或營運資訊 |
decision | 已批准的選擇、理由和約束 |
preference | 長期有效的個人、團隊或專案約定 |
architecture | 系統邊界、元件、介面和執行設計 |
note | 其他可長期重用的上下文 |
task | 歷史相容記錄；已分派工作應進入正式任務 |
執行結果應保留在工作階段或任務中。只有結果包含可供其他人或智慧體重用的知識時，才提取一筆或多筆記憶。
智慧體工作流程
- 使用
tokst_context取得緊湊的範圍化上下文，或使用tokst_search回答具體問題。 - 在提出變更前，用目前證據核對檢索結果。
- 在事實或決策確認後呼叫
tokst_remember。 - 需要審查時填寫標題、合適的類型、聚焦標籤和結構化 Markdown。
- 資訊變化時更新、封存、還原或替代既有記錄。
MCP 連線會提供已驗證使用者和可信智慧體身分。請使用與目前工作相符的最小工作區和知識庫範圍。
寫出高品質記錄
簡單事實可使用簡短文字。需要保留結構時使用 Markdown：
| 類型 | 建議欄目 |
|---|---|
| 事實 | 結論、來源、範圍 |
| 決策 | 決策、背景、理由、影響 |
| 偏好 | 偏好、適用範圍、例外 |
| 架構 | 目標、元件、資料流、約束 |
| 備註 | 摘要、詳情、下一步 |
保留重要數值、表格、設定變更、檔案路徑、已確認風險和具體下一步。記錄保持使用者和來源材料使用的工作語言。
雲端 MCP 的單筆記憶正文最大為 512 KiB UTF-8 Markdown，成功寫入會回傳實際位元組數。來源內容更大時，請附加原始檔案，並儲存完整、可讀的摘要與來源連結。
不進入長期記憶的資料
請勿儲存密碼、API 金鑰、私鑰、Cookie、存取權杖和其他憑據。原始推理、終端機日誌、原始工具 JSON、偵錯記錄、配額錯誤、網路重試和重複輸出應保留在目前工作記錄或診斷中。
使用者授權儲存的業務和個人資訊按記錄需要完整保留。憑據應儲存至專用金鑰管理器，記憶只保存長期有效的決策、引用或存取流程。
搜尋與上下文
TokST 使用關鍵字優先、語意補充的檢索方式。文字直接相符會立即回傳；設定嵌入服務且關鍵字結果無法回答請求時，可使用語意檢索。
tokst_search 適合具體問題、類型篩選、標籤篩選和歷史決策。智慧體開始工作前需要一份緊湊分組檢視時，使用 tokst_context 取得相關事實、決策、偏好、架構和備註。
生命週期與證據
| 狀態 | 含義 | 檢索 | 還原 |
|---|---|---|---|
| 活躍 | 目前可用 | 預設包含 | 可操作 |
| 已封存 | 保留但退出正常檢索 | 預設排除 | 可以還原 |
| 已刪除 | 永久移除 | 不可用 | 不可用 |
需要清晰可信鏈路的記錄可附加證據、可信度、有效期和審核狀態。修訂決策時，透過更新或替代關係保留舊記錄，讓後續智慧體理解變化過程。
檔案與匯入
可透過儀表板或對應雲端 MCP 附件工具上傳支援檔案。匯入適用於既有來源材料；在將匯入內容視作長期知識前應完成審核。
Cloud MCP 是目前記憶入口。可選 CLI Runtime 負責裝置和智能體 Binding，並提供按需工作階段、明確任務、溝通與診斷。