setuplisted

# setup — config 精靈 把 `config.example.json` 的行內文件（`$comment` 們）變成一場**短訪談**： 建立、體檢、或調整 `~/.config/research-cards/config.json`。原則： - **最小 config 優先**——純 .md 資料夾模式只需要 `obsidian.vault` 一個 必填（`backends` 缺省即 `["local"]`）。不要把 example 整份抄給使用者。 - **絕不臆造 id**——heptabase 模式的 workspace_id／tag_id／property UUID 一律由指令查出或使用者提供（`heptabase tag list`／`tag properties`）。 - **改前先讀**——調整模式永遠先讀現有 config，只動使用者要動的鍵； 寫回後跑驗證器。 ## Step 0 — 體檢（每次都先跑） ```bash python3 <此 skill 目錄>/check_config.py # 人讀報告 python3 <此 skill 目錄>/check_config.py --json # 給 agent 解析 # heptabase 模式想順便測 app 連線：加 --probe ``` 輸出告訴你：config 在哪（含 `RESEARCH_CARDS_CONFIG` env 覆蓋與 legacy `heptabase-cards` 路徑）、載不載得起來（載入失敗會指名缺哪個 key）、 backend 的可及性（vault 目錄／heptabase CLI）、以及 **upgrade_hints**—— example 有記載、此 config 尚未設定的鍵（新功能的加購清單，如 `profile.language`、`obsidian.journal`）。 ## 模式 A — 建立（config 不存在） 訪談順序（一次問一組，別轟炸）： 1. **用途**：讀論文管線（study）？研究專案卡（project）？都要？ → `features.{study, project}`（預設皆開，都要就不用寫）。 2. **backends**：預設推薦**純 .md 資料夾**（不需要任何筆記 app；就是 `backends: ["local"]`，可省略不寫；list 首位＝正本，舊單值 `backend` 鍵仍相容）。使用者有 Heptabase 才問 `heptabase`／`both`——並提醒 macOS＋desktop app＋CLI ≥ 0.4.0 的需求。 3. **資料夾**：`obsidian.vault` 路徑（iCloud 要提醒 Full Disk Access）＋ `folders`（預設 `{"papers": "Papers", "overviews": "Overviews"}`）。 4. **profile**：`reader`（讀者身分，流進每張卡的「為什麼該讀」）、 `field`（主領域）、`language`（產出語言；不設＝跟 Claude Code 的 language 設定，再預設繁體中文）。 5. **agent**：跑無人值守腳本的 CLI（`claude`｜`codex`）；互動用途照預設。 6. 只寫使用者實際回答的鍵——寫入前把 draft 亮給使用