# 1. 装 Python 包
pip install feishu-memory-mcp

# 2. 装系统依赖（自动检测 Node.js / npm 然后 npm install -g @larksuite/cli）
feishu-memory install-deps

# 3. lark-cli OAuth 授权（会打开浏览器）
lark-cli config init

# 4. 在飞书 UI 创建 2 个**空的**多维表格（memory / knowledge 各一个）
#    这一步必须手动：飞书不开放「创建空 Bitable」的 API，需要人去
#    https://open.feishu.cn/base 点几下创建。记下每个表的 app_token
#    和 table_id。

# 5. 配环境变量
export FEISHU_APP_ID=cli_xxxxxxxxxxxx
export FEISHU_APP_SECRET=...
export MEMORY_BITABLE_APP_TOKEN=bascnxxxxxxxxxxxx
export MEMORY_BITABLE_TABLE_ID=tblxxxxxxxxxxxxxxxx
export KNOWLEDGE_BITABLE_APP_TOKEN=bascnyyyyyyyyyyyy
export KNOWLEDGE_BITABLE_TABLE_ID=tblyyyyyyyyyyyyy

# 6. 自动建表（16 个字段一次性创建）+ 验证
feishu-memory init      # 自动建表（不需要手动加字段）
feishu-memory doctor    # 6/6 检查过
feishu-memory sync      # 第一次拉飞书 Bitable 数据
feishu-memory serve     # 启动 MCP server（agent 客户端连）

{
  "mcpServers": {
    "feishu-memory": {
      "command": "feishu-memory",
      "args": ["serve"],
      "env": { "FEISHU_APP_ID": "...", "...": "..." }
    }
  }
}

[agent client]  ←stdio/MCP→  [feishu-memory-mcp]  ←subprocess→  [lark-cli]  ←HTTPS→  [飞书]
    • 9 tools      │              │ Service Layer         │              │       • Bitable
    • stdin/stdout│              │ • MemoryService       │              │       • Docx
                  │              │ • SearchService       │              │       • Drive
                  │              │ • SyncService         │              │
                  │              │ • BootstrapService    │              │
                  │              │   (冷启动初始化)        │              │
                  │              │                       │              │
                  │              ├─ Index Engine         │              │
                  │              │ • EmbeddingEngine     │              │
                  │              │   (bge-m3 / MiniLM)   │              │
                  │              │ • TextChunker         │              │
                  │              │ • Reranker            │              │
                  │              │ • RRFMerger           │              │
                  │              │                       │              │
                  │              └─ Local Storage        │              │
                  │                 • SQLite (FTS5)       │              │
                  │                 • LanceDB (vectors)   │              │
                  │                                                  │
                  └─ Skill file: skill/feishu-memory/SKILL.md

git clone https://github.com/junqiu520/feishu-memory-mcp
cd feishu-memory-mcp
pip install -e ".[dev]"
pytest                 # 跑全部 unit tests
ruff check src tests