Devmark 0.2.0 · 給開發者的本機工作筆記

把進展留下，
把思緒接回來。

記住值得留下的進展，也收好暫時岔開的念頭。
用 CLI 記錄，在原生 App 裡找回脈絡，
需要交代成果時，再整理成一份日報。

取得 macOS 版看看 CLI 怎麼用

Devmark Journal：左側為依使用次數排序的標籤，中間為里程碑卡片，右側顯示選取紀錄的 Markdown 內容。 — 原生 App 畫面 · 示範資料

工作繼續，脈絡留下。

從完成一個里程碑，到發現一件稍後再做的事，各有合適的位置。

Journal

留下重要的進展

記下里程碑、決策、發布與部署。回頭看時，知道做了什麼，也知道為什麼。

Todos

先收好，下次接著做

臨時想到的分支工作，先記一筆。完成待辦就勾掉，不會自動產生日誌。

Tags & search

不必記得放在哪裡

用標籤串起不同專案的工作，再透過關鍵字搜尋找回內容。專案路徑是選填資訊。

Devmark Todos：未完成、已完成與全部的分段篩選及數量，搭配待辦卡片、標籤與 Markdown 詳情。 — Todos 原生 App 畫面 · 示範資料

靈感岔路，
不用現在走完。

任務做到一半，總會發現其他值得處理的事。從 menu bar 快速新增 Todo，用一句話加上 #標籤，收好想法，再回到手上的工作。

用既有標籤快速分類，也能新增標籤
直接在 App 內編輯，多行標題與 Markdown 保留脈絡
未完成／已完成／全部，一鍵切換並顯示符合條件的數量

Devmark menu bar 快速輸入：補上搜尋空狀態 #ux #follow-up。 — 一句話記下，#標籤自動整理

Recaps · 需要時，再整理成日報

一天的進展，
整理成一份交代。

選好日期、時區與標籤，勾選要納入的日誌和當日完成的待辦。用 ChatGPT 方案產生草稿，檢查、編輯，再複製或匯出 Markdown。

由你按下產生，不會在背景自動執行
可選擇加入未完成待辦，整理成後續事項
保存日報及來源快照，隨時從歷史重新開啟

透過 Continue with ChatGPT 連接符合資格的帳戶，無須提供 API key。生成會使用你的 ChatGPT 方案用量或可用點數；只傳送勾選內容，不讀取 ChatGPT 或 Codex 對話紀錄。查看官方適用說明 ↗

Devmark 日報：左側歷史紀錄，右側預覽今日完成、重要決策與後續事項，可編輯、複製或匯出 Markdown。 — Recaps 原生 App 畫面 · 示範日報，非即時 AI 生成

Language

用熟悉的語言工作

支援 English、简体中文與繁體中文。啟動時跟隨系統語言，未支援的語言預設使用 English，也能在設定中切換。

Backup & export

紀錄與日報，一起帶走

在設定備份完整資料庫，或匯出 Journal、Todos 與 Recaps 的 JSON。日報也能個別匯出 Markdown。

Your connection

授權與資料分開保管

ChatGPT 憑證保存在 macOS Keychain，不包含在資料庫備份中。只有主動產生日報時才檢查並更新 token。

在你工作的地方記錄

終端機裡一筆，
App 裡就找得到。

給自己用，也給 coding agent 用。傳入一個 JSON，CLI 與 App 就能讀到同一份本機資料。

在專案目錄執行時，自動辨識專案路徑。Journal 重試時沿用同一個 event_key ，避免重複寫入。

devmark list --tag ux依標籤查詢

devmark todo list --status open找回待辦

devmark add --json - <<'JSON'
{
  "kind": "milestone",
  "summary": "完成搜尋與標籤篩選",
  "details": "支援中文關鍵字與標籤篩選。",
  "tags": ["devmark", "ux"],
  "event_key": "search-and-tags-v1"
}
JSON

devmark todo add --json - <<'JSON'
{
  "title": "補上搜尋空狀態的提示",
  "details": "保留篩選條件，提供清除入口。",
  "tags": ["ux", "follow-up"]
}
JSON

Devmark × coding agents

Connect your coding agent

讓 agent 常駐讀取一小段規則，需要 Devmark 命令時再載入 skill。

加入 AGENTS.md 或 CLAUDE.md，告訴 agent 何時記錄進展、何時留下待辦。

## Devmark

Use Devmark to remember meaningful development progress and deliberately deferred work.

- Record completed implementation phases, releases, deployments, migrations, and accepted decisions that materially change scope, architecture, or operations. Record blocker changes only when they materially affect milestone progress.
- Skip routine turns, checks, reviews, commits, and discussions. If an event does not clearly qualify, skip it.
- Create a Todo only when the user asks for a reminder or has explicitly chosen to defer that work. Recording a Todo does not authorize executing it. Completing or reopening a Todo must not create a Journal entry.
- Run from the relevant project directory so Devmark can infer its path. Use the user's preferred language for records and the user's active timezone.
- Confirm each write succeeds. Reuse the same `event_key` and unchanged payload when retrying a Journal event; never silently replace a conflicting event.
- Consult the Devmark skill for commands and JSON examples. If it is unavailable, use `devmark --help` or `devmark todo --help`. If the CLI is missing or a write fails, report it without claiming success and continue unrelated work.

下載 prompt ↓

SKILL.md

需要時再讀取的命令細節

一份可獨立使用的 Markdown skill，包含記錄規則、完整 JSON 範例，以及 Journal 和 Todo 的操作命令。

記錄重要里程碑，不記流水帳
專案路徑、標籤、搜尋與完成 Todo
確認寫入結果，明確處理重試

下載 skill（.md） ↓

將檔案存成 agent 的 skills 目錄下的 devmark/SKILL.md；實際目錄位置依使用的 agent 而定。

請先安裝 Devmark CLI 並加入 PATH。兩個網站語言版本的 prompt 和 skill 都使用英文，日誌則可使用你偏好的語言。

你的紀錄，留在你的電腦。

一份本機 SQLite 資料庫，CLI 與 App 共用。
日常記錄不需要帳號或伺服器；需要帶走時，可以匯出或備份。
只有使用可選的 ChatGPT 日報功能時，才會將選取內容傳送至 OpenAI。

為下一次接續，留個記號。

先從 macOS 開始，把 Devmark 放進你的工作流程。

原生桌面 App

Devmark 0.2.0 for macOS

Apple Silicon · 三語原生介面 · 快速待辦與日報

下載 App ZIP

已完成 Apple 公證。解壓後，將 Devmark.app 移到 Applications。
目前僅驗證 macOS Apple Silicon。

給終端機與 Agent

搭配 Devmark CLI

下載 CLI，安裝到自己的指令目錄。

下載 macOS Apple Silicon CLI

mkdir -p "$HOME/.local/bin"
unzip -q ~/Downloads/devmark-cli-0.2.0-macos-arm64.zip -d ~/Downloads
install -m 755 ~/Downloads/devmark-cli-0.2.0-macos-arm64/devmark "$HOME/.local/bin/devmark"
export PATH="$HOME/.local/bin:$PATH"
devmark --help

CLI 已使用 Developer ID 簽署並通過 Apple 公證，獨立執行檔的公證憑證需連線查驗。App 與 CLI 預設共用資料庫。

SHA-256 校驗檔 ↓

把進展留下，把思緒接回來。