# TokST Local

TokST Local 使用 SQLite 與 FTS5 將私有記憶保存在目前裝置。它在 macOS、Linux 和 Windows 上共用 TokST Cloud 的同一套 CLI、MCP、npm 套件與二進位發布體系。

```sh
tokst setup --local
tokst local remember "只保存在這台 Mac 的內容" --tags private
tokst local search "private"
tokst local context
```

安裝器會自動選擇目前平台的二進位。npm 使用者繼續使用 `@tokst/cli` 與 `@tokst/mcp-server`。資料目錄位於系統應用程式資料目錄，其中包含資料庫、附件、備份與本機設定。

## 檔案、備份與 MCP

```sh
tokst local remember "合約" --file ./contract.pdf
tokst local backup create --name before-upgrade
tokst local mcp
```

本機 stdio MCP 設定：

```json
{
  "mcpServers": {
    "tokst-local": {
      "command": "tokst",
      "args": ["local", "mcp"]
    }
  }
}
```

## 可選雲端同步

同步需要明確綁定一個本機知識庫與一個雲端知識庫：

```sh
tokst login --key tk_live_xxxx
tokst local connect --cloud-atlas-id <cloud-atlas-id>
tokst local sync
```

同步涵蓋記憶正文、中繼資料、狀態與標籤。附件在此版本繼續保留於目前裝置。雲端和本機同時編輯後，TokST 會保留為兩條衝突記憶，讓兩邊的修改都可追溯。