English · 繁體中文
# Card Table - Dated Tasks 卡片看板 - 任務分類日誌
**以任務為核心、帶日期的卡片表格。** 靈感來自 Kanban 的表格工作方式,但日期、指派人、置頂、留言、循環全都是筆記裡的純文字。卡片可以放上 **Canvas**、跟你的其他筆記連線;做完的分類可以搬到連結的 **Archive 筆記**,用它自己的 Archive 模式開啟。
> [!IMPORTANT]
> **提醒:** 這個外掛仍在積極開發中,接下來幾個月會經常變動。使用前請先備份你的資料與環境。非常歡迎回報問題和提供回饋!
>
> **聲明:** 這個專案完全由使用 Claude 的 AI agent 打造。專案開發者的程式語言經驗有限。
卡片用 [Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks) 和 [Dataview](https://github.com/blacksmithgu/obsidian-dataview) 外掛同一種 `[欄位:: 值]` 寫法,它們的查詢也看得到卡片的日期和循環。
- **時間篩選。** 年、月、週、日、已逾期、週期永遠在畫面上,四格跟著同一個日期連動。不用挑日期、不跳對話框,◀ ▶ 按幾下就到任何一天。
- **快速搜查。** 在新增卡片打主題或內容,表格就跟著篩選。
- **任務分類。** 分類就是顏色,也是狀態 —— 紅色那一區叫「等回復」,裡面的卡片就都在等回復。
- **多人協作。** 每張卡片都能留下有署名、有時間的留言;每一次寫入都是原子的,兩台裝置同步也不會互相蓋掉。
- **它還是純文字。** 日期、指派人、置頂、留言、循環全寫在筆記裡。外掛關掉之後,仍然是一份誰都看得懂的待辦清單。
覺得好用的話,可以 [在 Ko-fi 請作者喝杯咖啡](https://ko-fi.com/jiajiunwu)。
> [!WARNING]
> **舊筆記不用動。** 以前的寫法全部照讀;哪張卡片被改到,那張才換成現在的寫法(想一次換完:設定 → 筆記格式 → 全部轉換,會先備份)。
> **每台裝置都更新到同一版** —— 1.6.0 以前的卡片看板讀不懂現在的寫法。對照表在 [文字格式](#文字格式)。
> 有問題請開 [GitHub issue](https://github.com/WUYEAHS/obsidian-card-table/issues)。
## 安裝
1. 設定 → 社群外掛 → 開啟社群外掛。
2. 瀏覽 → 搜尋 **Card Table - Dated Tasks**(卡片看板 - 任務分類日誌)→ 安裝並啟用。
還沒上架的話:從 [最新版本](https://github.com/WUYEAHS/obsidian-card-table/releases/latest) 下載 `main.js`、`manifest.json`、`styles.css`,
放進 `<你的 vault>/.obsidian/plugins/card-table/`,重新載入 Obsidian 再啟用 **卡片看板 - 任務分類日誌**。
## 開始使用
1. 打開一篇筆記,從指令面板、左側欄的圖示或分頁的 `⋯` 選 **用卡片看板開啟**。
每篇筆記會記住你上次用哪一種模式,下次照舊開。
還沒用看板開過的筆記,按左側欄的圖示會先問你:把這份筆記開成卡片看板,或開一份新檔案。
2. 全新的筆記會自動建好五個分類(`## 1` … `## 5`),分類在看板上用顏色表示。
3. 在 **新增卡片** 打主題和內容,按 `Shift + Enter` 送出。
卡片會放在上方篩選列目前顯示的那一天、那一週或那個月。
4. 點圓圈標成完成、點日期改日期、✎ 編輯、💬 留言。
## 目錄
- [功能](#功能)
- [鍵盤](#鍵盤)
- [設定](#設定)
- [文字格式](#文字格式)
- [卡片看板、Tasks 和 Kanban](#卡片看板tasks-和-kanban)
- [設計原則](#設計原則)
- [支援](#支援)
## 功能
### 時間篩選
- **四格連動** —— 年、月、週、日跟著同一個日期走,動其中一格,其他格一起跟上。
- **一直知道在看哪裡** —— 今日日期自己一列放在最上面(點了回到今日),篩選那一列寫的是正在看的那一段,右邊是張數。
- **已逾期與週期** —— 就在日期格旁邊,一點就到。
- **行事曆** —— 格子不夠用時挑一天或一段;一週可以從週一、週日、今天或每月 1 號起算。
### 搜尋
- **打字就篩選** —— 新增卡片的主題和內容框,就是表格的篩選。
- **一次只看一區** —— 分類選單每一列都可以「只看這一區」,置頂也一起篩;標題列上一顆膠囊寫現在篩的是哪一區,按 × 取消。
- **常用主題** —— 一點就帶入;用過的主題會帶回它上一次的分類。
### 卡片
- **就地編輯** —— 卡片裡就是 Obsidian 的即時預覽編輯器,邊打邊存;內容裡的待辦可以直接勾。
- **置頂、循環** —— 置頂表在最上面,`[repeat:: every 2 weeks]` 循環。
- **照片和影片** —— 卡片 ⋯ → 加照片(手機直接跳相機或相簿),新增卡片時送出鈕左邊的 📎 也可以夾帶;主題下面一條像 IG 那樣左右滑的照片列,點了放大;一張卡片最多 10 個。
- **融合與輸出** —— 好幾張合成一張,或把目前的篩選輸出成 PNG、PDF。
### 封存
- **封存區** —— 在新增卡片的「⋯」把整區封存:它離開清單,但還在筆記裡(`## Archive/名字`)。封存和還原都會先預覽,按儲存才生效。
- **Archive 筆記** —— 封存區可以移出到連在一起的〈看板名 Archive〉,看板保持精簡;隨時搬回來,回到看板的封存區。
- **在 Archive 筆記裡**可以搜尋、篩區、打勾、留言、整區送到 Canvas;不能新增卡片、不能改內容。
- **連結跟著走** —— 別的筆記和 Canvas 裡指到這些卡片或這一區的連結,搬的時候一起更新。
### Canvas 和卡片連結
- **送到 Canvas** —— 一張、整份清單或一個封存區。一張卡片一個框,每排 4 張;封存區整區送出去會包成一個群組,標題是區名。已經在 Canvas 上的卡片會跳過。
- **複製卡片 ID** —— 貼到 Canvas 或別的筆記,那裡就顯示整張卡片,點了回看板。貼進另一張卡片會變成一般連結(不預覽),卡片可以互相連,不會一層一層嵌。
- **卡片 ID** —— `^ct-abc123` 只有在複製卡片 ID 或送到 Canvas 時才會加在卡片最後,讓連結找得到它。沒有 ID 的卡片用起來完全一樣。
### 分類
- **顏色就是狀態** —— 紅色那一區叫「等回復」,裡面的卡片就都在等回復。
- **就地管理** —— 在新增卡片的「⋯」裡改名、換色、新增、刪除分類。
### 多人協作
- **留言** —— 有署名、有時間,跟著它說的那張卡片。
- **指派人或個人使用** —— 把卡片指派給人,或整個關掉指派人。
- **同步也安全** —— 每一次寫入都是原子的,兩台裝置不會互相蓋掉。
### 手機與版面
- **桌機和手機同一種版面** —— 一樣的卡片,桌機只是比較寬。
- **窄版或寬版**(桌機);深色、淺色跟著 Obsidian 的佈景主題。
### 純文字
- **Tasks、Dataview 讀得懂的欄位** —— `[due:: …]`、`[start:: …]`、`[repeat:: …]`;舊筆記照樣讀得懂。
- **繁體中文與英文介面。**
## 鍵盤
格式快捷鍵**用你自己的設定**:編輯卡片時用的就是 設定 → 快捷鍵 裡綁的那些,跟在一般筆記裡打字一模一樣 —— 卡片的編輯框就是 Obsidian 的編輯器,有即時預覽、復原和 `[[` 建議。
| Obsidian 指令 | 插入 |
| --- | --- |
| Toggle bold | `**文字**` |
| Toggle italic | `*文字*` |
| Toggle highlight | `==文字==` |
| Toggle code | `` `文字` `` |
| Toggle strikethrough | `~~文字~~` |
| Add internal link | `[[文字]]` |
| Insert Markdown link | `[文字]()` |
送出鍵在新增卡片、編輯內容、留言都是同一套:
| 按鍵 | 預設 | 設定成「Enter 送出」 |
| --- | --- | --- |
| `Enter` | 換行 | 送出 |
| `Shift + Enter` | 送出 | 換行 |
| `Ctrl + Enter` / `⌘ + Enter` | 送出 | 送出 |
| `Esc` | 結束編輯 | 結束編輯 |
## 設定
分類跟外掛裡的設定頁一樣;最上面的 **更新內容** 可以看每一版加了什麼。
| 分類 | 可以設定 |
| --- | --- |
| 一般 | 語言、這台電腦是誰在用、個人使用 |
| 輔助使用 | 看板大小(80–120%;80% 是 1.7.6 以前的大小,預設 100%;表格寬度不變;桌機、手機各一個) |
| 時間篩選 | 打開時先看哪一段、一週怎麼算 |
| 卡片外觀 | 已完成的長相、最後編輯時間、留言與留言位置 |
| 新增與編輯 | 送出鍵(見 [鍵盤](#鍵盤))、編輯時游標和卡片的位置、完成時取消置頂 |
| 動作完成後要不要跳轉 | 每一種動作要不要捲到那張卡片 |
| 筆記格式 | 外掛產生的檔案放哪裡(照片、Archive 筆記、新的 Canvas、備份、匯出的長圖;每份看板一個 `<看板名> attachments`,預設在看板旁邊,改名跟著走) |
| 實驗 | 把舊卡片全部轉成現在的格式(會先列出要改幾張、先備份)、壓縮照片(不壓縮 / 高畫質 / 中畫質,只壓太大的)、封存舊照片(選一天,把那天以前的照片搬到 `photo-archive/`;要省 Sync 空間請自己在 Sync 設定排除它)、清掉沒放在卡片上的照片(先列出來才丟) |
## 文字格式
這就是全部的儲存格式 —— 看板上看到的東西,全都來自像這樣的幾行字:
```markdown
## 1
- [ ] [pin:: on] #訂貨 [start:: 2026-09-11] [due:: 2026-09-14] @小明
每樣兩箱,週五前要到
- [ ] 打給廠商
[cm:: 2026-09-11 14:20|小明] 報價回來了,比上次漲 8%
[ed:: 2026-09-11 14:20]
- [x] #巡田 [due:: 2026-09-08] [repeat:: every 2 weeks]
再看一次疑似黃龍病那棵
[done:: 2026-08-25]
[ed:: 2026-09-08 08:30]
```
第一行是卡片本身:置頂、主題、日期、循環、指派人。有照片的話,照片那一行緊接在第一行下面。底下依序是內容(照你打的寫,不會自動加項目符號)、循環的完成記錄、留言,最後一行是編輯時間。外掛自己寫的這幾行也沒有符號。
### 所有寫法
| 意思 | 寫法 | 以前的寫法(照讀) | 放在哪裡 |
| --- | --- | --- | --- |
| 一張卡片,未完成 / 已完成 | `- [ ]` / `- [x]` | — | 第一行開頭 |
| 置頂 | `[pin:: on]` | `📌` | 第一行,主題前面 |
| 主題 | `#主題` —— 最多 3 個;空格會換成 `-`(`#UX-review`)。主題是標籤,所以 Obsidian 的標籤搜尋、Tasks、Dataview 也找得到 | `[主題]` | 第一行 |
| 單日 | `[due:: 2026-09-11]` | `＠{2026-09-11}` | 第一行 |
| 一段區間 | `[start:: 2026-09-11] [due:: 2026-09-14]` | `＠{2026-09-11 ~ 2026-09-14}` | 第一行 |
| 循環 | `[repeat:: every 2 weeks]`(`every 3 days`、`every month`…) | `🔁 every 2 weeks`、`🔁 每2週` | 第一行,日期後面 |
| 指派人 | `@名字` —— 任何 `@名字` 都算,新名字會自動加進指派人名單 | `#小明`(在指派人名單裡的名字) | 第一行 |
| 照片 / 影片 | `![[ct-20260926-2010-1.jpg]] ![[ct-20260926-2011-1.mov]]` —— 一整行只有 `![[圖或影片]]`、只寫檔名;檔案在外掛資料夾的 `photo/年-月/`。不算卡片的身分,加刪照片不會認錯卡 | 自己貼在同一個位置的 `![[圖]]` 也算 | 第一行正下方 |
| 內容 | 照你打的寫;項目符號自己打才有(`- `、`* `、`1. `) | 第一行主題後面的內容;`．` 符號 | 第二行起 |
| 內容裡的待辦 | `- [ ] 事情`(`-[ ]`、`[]` 也會整理成這樣) | — | 內容行 |
| 循環的「本次完成」 | `[done:: 2026-08-25]`(只有循環卡片) | — | 內容之後 |
| 留言 | `[cm:: 2026-09-11 14:20\|小明] 內容` | `．💬{2026-09-11 14:20\|小明} 內容` | 內容之後 |
| 最後編輯時間(外掛自動寫) | `[ed:: 2026-09-11 14:20]` | `✎{2026-09-11 14:20}`(在第一行) | 永遠是卡片的最後一行 |
| 卡片 ID(複製卡片 ID 或送到 Canvas 才會寫) | `^ct-abc123` | — | 接在 `[ed:: …]` 後面,或有子項目時自己一行、放在第一個子項目前面 |
| 封存區 | `## Archive/名字` | `## Archive`(以前一張一張封存的卡片) | 看板裡的分類標題 |
| Archive 筆記裡的一區 | `## 名字`,下一行 `[archived:: 2026-09-23]` | — | 〈看板名 Archive〉裡的標題 |
| 看板 ↔ Archive 筆記 | 看板:`card-table-archive: "[[看板 Archive]]"`。Archive:`card-table: archive`、`card-table-source: "[[看板]]"`、`card-table-archived` | — | 屬性(YAML) |
| 長期 | — | `#long-term`(一般標籤,沒有特別意思) | — |
- 外掛自己寫的行(`[done::]`、`[cm::]`、`[ed::]`)不帶 `- `;時間一律四碼年份到分鐘。
- 第一行上的其他欄位(例如 Tasks 寫的 `[completion:: …]`、`[priority:: …]`)會原樣留著。
- 沒有主題的卡片,第一行內容留在第一行(Kanban 那邊才看得懂)。
### 舊筆記怎麼辦
**舊寫法照讀,改到才換。** 哪張卡片被編輯、打勾或改日期,那張才換成新寫法,其他卡片一個字都不動。
**一鍵轉換。** 設定 → 筆記格式 → **把舊寫法全部轉成新格式**:把所有用卡片看板開過的筆記一次轉完。
轉換前,每份筆記的原文會備份在外掛的資料夾(預設是看板旁邊的 `<看板名> attachments/<名字> backup-20260916-1420.md`);編輯時間沿用原本的,卡片以外的行不動,跑第二次不會再改任何東西。
1.6.0 以前的卡片看板讀不懂新寫法,開這些筆記的每台裝置都要更新。
轉換後內容不對,或有任何疑問,請開 [GitHub issue](https://github.com/WUYEAHS/obsidian-card-table/issues)。
## 卡片看板、Tasks 和 Kanban
**Tasks 和 Dataview。** 卡片看板寫的 `due`、`start`、`repeat`,就是 [Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks) 外掛在 Dataview 格式裡讀的欄位;所有 `[欄位:: 值]` 也都查得到([Dataview](https://github.com/blacksmithgu/obsidian-dataview))。循環由卡片看板自己處理(本次完成),循環卡片請在卡片看板裡打勾。
**Kanban。** 卡片看板的靈感來自 **[Kanban](https://github.com/mgmeyers/obsidian-kanban) 外掛的表格模式(table view)** —— 同樣的 Markdown 清單,不排成一欄一欄,而是一列一列讀。從那裡出發,再長成一個以日期和留言為主軸的看板。
| | Kanban | 卡片看板 |
| --- | --- | --- |
| 以什麼為主軸 | 階段 —— 這張卡片在哪一欄? | 時間 —— 今天、本週、本月要做什麼? |
| 日期 | `@{日期}` | `[due:: …]` / `[start:: …]`(Tasks、Dataview 讀得懂)—— 兩個外掛互相讀不到對方的日期 |
| 主畫面 | 整個看板,一欄一欄並排 | 一份清單,篩到某一天、一週或一個月 |
| 留言 | — | 每張卡片有署名、有時間的留言 |
| 封存 | 同一份筆記裡的封存清單 | 封存區可以移到連在一起的〈… Archive〉筆記、再搬回來;連結跟著走 |
**可以兩個一起裝嗎?** 可以。卡片看板只接管你用它開過的筆記(每篇筆記各自記住),不會自己把 Kanban 看板換成卡片看板,停用或重新載入時也不會拆掉 Kanban 的攔截。
兩個外掛讀的都是 `## 標題` 和 `- [ ]` 卡片,所以卡片看板的筆記也能用 Kanban 開;不過 Kanban 只認得它自己的 `@{日期}`,卡片看板的 `[due:: …]` 在 Kanban 裡會顯示成一般文字。
## 設計原則
1. **每一次寫入都是一次原子的讀改寫**(`Vault.process`),同步、別的分頁、上一個動作同時寫入時,不會被舊內容蓋掉。
2. **看板從不把自己那份寫回檔案。** 所有改動都經過同一個寫入者。
3. **卡片的身分是它的主題加第一行內容。** 兩張一樣的時候,先看它在分類裡是第幾張(再用整行和內容確認),接著才比內容、整行原文和編輯時戳;都分不出來就寧可不寫,不用猜的。
4. **一次只動最少的行。** 打勾只改那一行和編輯時間,不會整份重寫。
## 支援
- 問題回報與建議:[GitHub issues](https://github.com/WUYEAHS/obsidian-card-table/issues)
- 支持開發:[Ko-fi](https://ko-fi.com/jiajiunwu)
## 授權
MIT