# 快速入門

在一分鐘內上手 TokST。本指南將引導您完成安裝、驗證、建立第一個知識庫和儲存記憶。

## 智能體一鍵設定（最快方式）

複製以下訊息，貼上到您的 AI 智能體對話框中：

```
請閱讀 https://tokst.com/skill.md 並按步驟安裝 TokST 記憶技能。
先執行：curl -fsSL https://tokst.com/install.sh | bash

升級 CLI 時，安裝程式會保留既有 TokST 連線。瀏覽器確認僅在首次連線或憑證失效時開啟。
```

智能體會自動讀取連結文件並自行安裝獨立 CLI、技能檔案和 MCP 設定，然後完成瀏覽器授權。適用於 Claude Code、Cursor、Codex、ZCode 及任何相容 MCP 的智能體。

完整指南請參閱[智能體設定](/docs/agent-setup)。

## 一鍵安裝

安裝 TokST 及所有相依套件的最快方式：

```bash
curl -fsSL https://tokst.com/install.sh | bash
```

該腳本會下載通過 SHA-256 驗證的 TokST 獨立 CLI，開啟瀏覽器授權，並讓機器可以直接使用 `tokst` 指令。macOS 與 Linux 只需要 Unix 終端和 `curl`，Windows 使用 PowerShell。支援 macOS Apple Silicon、macOS Intel、Linux x64、Linux ARM64、Windows x64 與 Windows ARM64，無需安裝 Bun、Node.js、npm 或套件管理器。

Windows PowerShell：

```powershell
irm https://tokst.com/install.ps1 | iex
```

Windows Git Bash 也支援 `curl -fsSL https://tokst.com/install.sh | bash`；指令碼會識別 Windows 並交給同一套 PowerShell 安裝程式執行。

可隨時依目前安裝渠道升級。獨立版下載驗證後的二進位，npm 與 Bun 版更新各自的全域套件：

```bash
tokst update
tokst version
```

## 瀏覽器授權

安裝腳本會開啟 TokST 瀏覽器頁面並儲存已驗證的本機憑證。可隨時驗證：

```bash
tokst doctor
tokst status
```

API 金鑰用於 CI、伺服器和無人值守自動化，可在[儀表板](https://tokst.com/dashboard/api-keys)建立和管理。

## 連結儲存庫與智能體

在任意目錄執行以下指令。TokST 會為選定的智能體寫入本機指令並保留既有檔案。知識庫建立和目錄綁定使用獨立指令。

```bash
tokst init --agents codex,claude,cursor,opencode,pi
tokst doctor
```

需要主動更新產生的整合檔案時使用 `tokst init --force`。`tokst init` 不依賴 Git 或雲端存取。`tokst doctor` 會檢查驗證、可選的 Git 和知識庫綁定，以及已產生的智能體檔案。

## 建立您的第一個知識庫

**知識庫**是一個命名的知識庫，用於保存相關記憶。建立一個：

```bash
tokst atlas init --name "MyKnowledge"
tokst atlas bind --atlas-id <id>
```

您可以列出知識庫來確認：

```bash
tokst atlas list
```

## 儲存您的第一條記憶

記憶是 TokST 中的核心資訊單元。儲存一條：

```bash
tokst remember "Hello TokST!" --type note
```

您可以透過類型對記憶進行分類：`fact`、`decision`、`preference`、`task`、`architecture` 或 `note`。

附加檔案或圖片來豐富您的記憶：

```bash
tokst remember "Meeting notes with diagram" --file diagram.png
```

### 批量匯入

從資料夾批量匯入檔案為記憶 — 文字檔案自動提取內容：

```bash
tokst import ./my-docs --dry-run               # 先預覽
tokst import ./my-docs --type note --tags imported  # 帶標籤匯入
```

## 搜尋您的記憶

透過關鍵詞或語意搜尋來尋找記憶：

```bash
tokst search "hello"
```

要獲得更豐富的結果，請使用額外篩選條件：

```bash
tokst search "deployment" --type decision --tags production --limit 10
```

## 檢查狀態

隨時查看您的帳戶和使用詳情：

```bash
tokst status
```

要取得機器可讀的輸出（適用於腳本）：

```bash
tokst status --json
```

## MCP 伺服器設定

要將 TokST 連接到支援 Model Context Protocol 的 AI 智能體（Claude Desktop、Cursor、Codex CLI），請將以下內容新增到您的 MCP 設定中：

```json
{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp"
    }
  }
}
```

MCP 用戶端會開啟 TokST 完成 OAuth 授權，無需本機執行環境。請參閱 [MCP 伺服器參考](/docs/mcp)了解針對特定用戶端的設定詳情。

## 下載附件

如果記憶包含檔案附件，可以將它們下載到本機：

```bash
tokst memory download mem_xxxxx                    # 所有附件 → ~/Downloads
tokst memory download mem_xxxxx --out ./files      # 指定輸出目錄
tokst memory download mem_xxxxx --json             # JSON 格式輸出
```

## 下一步

- 瀏覽 [CLI 參考](/docs/cli)了解所有可用指令
- 了解[記憶類型](/docs/memories)以及何時使用每種類型
- 設定[檔案附件](/docs/attachments)以用文件豐富記憶
- 使用[工作區](/docs/workspaces)和[知識庫](/docs/atlases)組織您的知識
- 透過[智能體一鍵設定](#智能體一鍵設定最快方式)為您的 AI 智能體配備持久記憶