前言¶
在 DeepSeek Harness（DSH）裏做智能體開發，筆記、待辦、複習卡片和工作區用量往往散落在對話記錄、外部 App 或自建表格裏。面板和 Agent 各記各的，很難在同一份數據上協作。dsh-quick-note（界面文案爲「管理臺」）把條目管理、健康記錄、用量/價值分析與 Agent 工具接到 DSH Web GUI 左側欄，數據以本機 Host 爲主、瀏覽器鏡像爲輔，同一份 items.json 既能在 GUI 裏編輯，也能被 quick_note_* 工具讀寫。
下面介紹插件定位、核心能力、安裝方式與典型用法。事實以 TomJerryGit/dsh-quick-note README 與 package.json 爲準。
這是什麼¶
dsh-quick-note 是 TomJerryGit 維護的 客戶端類 DSH 插件（npm 包名 @tomjerrygit/dsh-quick-note）。它在 DSH Web GUI 左側欄增加「管理臺」入口，提供 local-first 的通用管理界面：概覽儀表盤、跨模塊表格、筆記/任務/閃卡複習/健康/自定義記錄，以及「分析」下的工作區價值、Token 用量與系統信息只讀頁。
爲保證與既有安裝和數據兼容，插件 id 仍爲 dsh-quick-note，Agent 工具名仍爲 quick_note_*，主數據文件路徑爲 $DSH_HOME/quick-note/items.json。package.json 聲明運行環境爲 dsh >= 0.2.0-rc.2，許可證 MIT。
核心功能（節選）¶
概覽與管理臺表格¶
默認進入「概覽」：KPI 卡片（任務到期/逾期、待複習、近 7 天複習、健康與自定義記錄等）、今日簡報、快捷新建、最近更新。「全部」頁提供跨類型列表，可按筆記/任務/複習/健康/記錄篩選，支持排序、分頁與批量完成、改優先級、刪除。
v1.11.0 起模塊合併爲：概覽、知識（筆記 + 複習）、計劃（列表/看板/日曆）、健康、記錄、分析；可在「設置 → 管理臺設置」中隱藏部分模塊。
知識與計劃¶
- 筆記：統一條目模型（標題、正文、標籤等）。
- 複習：閃卡 SM-2 隊列，「忘記/模糊/記得」評分，複習日誌寫入數據文件
reviews。 - 任務：列表/看板/日曆；支持優先級、截止、檢查清單與重複任務（v1.3.0）；看板支持拖拽改狀態與排序。
- 對話捕獲：助手消息操作行的速記圖標可把回答存爲帶「對話」標籤的筆記（去重）。
健康與自定義記錄¶
健康模塊支持指標趨勢與用藥計劃（到點提醒、今日簡報摘要）。「記錄」頁可自建類型與字段（文本/數字/日期/複選/單選），保存篩選爲類型內視圖（types[].views）。
分析：價值、用量、系統¶
「分析」標籤含價值、用量、系統三個子頁（選擇會持久化）：
- 系統：
GET /api/quick-note/admin，展示 Profile、DSH 主目錄、已裝 Bundles 等（只讀）。 - 用量：按工作區統計 Token 與估算金額，支持近 14 天曲線等；單價可在設置中修改。
- 價值：
GET /api/quick-note/workspace-value給出工作區價值分（A/B/C/D）、階段與未來價值等；支持人工評級、趨勢快照、導出 CSV/Markdown、歸檔爲筆記。
數據同步、備份與 Agent 工具¶
改動先寫瀏覽器鏡像，再同步 Host；不可達時提示「僅保存在本機瀏覽器」。Host 寫入後可滾動備份至 $DSH_HOME/quick-note/backups/（v1.3.0）。支持導出/導入 JSON（含 types、settings、reviews 等）。
Host 半區提供的 Agent 工具包括（名稱前綴均爲 quick_note_）：
| 工具 | 作用概要 |
|---|---|
search |
按 query/kind/priority 等搜索條目 |
create / update / complete |
創建、更新、完成或重開條目 |
type |
管理自定義記錄類型 |
workspace |
工作區價值列表、評級、快照、報告、歸檔 |
batch（v1.3.0） |
批量完成、改優先級、標籤等 |
v1.13.0 起還支持斜槓命令（如 /note、/task、/search、/plan、/review），在對話輸入框直接錄入或查詢。
提醒與對話注入¶
應用內可對今日/逾期任務與用藥到點提醒；可在設置中開啓「每輪對話注入今日待辦簡報」，讓 Agent 每輪收到任務與用藥摘要。
安裝與啓用¶
README 推薦從 npm 安裝。按你使用的 DSH Profile 選擇一條命令：
dsh plugin --profile web add @tomjerrygit/dsh-quick-note
# desktop profile
dsh plugin --profile desktop add @tomjerrygit/dsh-quick-note
若使用插件市場索引，可將下列地址加入 DSH Plugins → Discover：
https://tomjerrygit.github.io/dsh-quick-note/index.json
SkillHub 目錄頁（dsh-quick-note）也提供「請安裝 DSH 插件 TomJerryGit/dsh-quick-note」的指引，由 Harness 讀取安裝計劃後執行，與社區站點同屬第三方索引，並非 DeepSeek 官方應用商店。
本地開發時，可在插件管理頁「安裝第三方插件」填寫目錄路徑，或通過 Agent 的 plugin_manager install_bundle；修改 index.js（Host 半區）後通常需熱重組裝或重啓 DSH。
典型用法¶
1. 在 GUI 中日常使用¶
安裝並打開 DSH Web GUI 後，從左側欄進入「管理臺」。先在概覽查看今日任務與複習，再用「計劃」看板拖拽改狀態，或用 Ctrl/⌘ K 命令面板跳轉與新建（v1.2.0）。
2. 讓 Agent 創建任務¶
在對話中依賴 Host 註冊的 quick_note_create，傳入 kind、title 等字段即可（具體參數以 README「Agent 工具」節爲準）。也可用斜槓命令，例如：
/task 修復迴歸用例 --due 明天 --priority high --tag dsh
3. 查詢與批量處理¶
quick_note_search 支持 tag、overdue、dueWithinDays 等過濾（v1.3.0）。多條目變更可用 quick_note_batch。
4. 工作區價值報告¶
在「分析 → 價值」中查看自動評分與用量；需要沉澱時可用 quick_note_workspace 的 report 或 archive，或面板內「導出 Markdown 報告」「歸檔爲筆記」。
5. 備份與遷移¶
設置頁可「立即備份」或從 $DSH_HOME/quick-note/backups/ 恢復；也可導出完整 JSON 後在另一臺機器導入（樂觀鎖寫入）。
適用場景與注意¶
適合誰：希望在 DSH 內統一管理筆記、任務、複習與健康數據，並讓 Agent 與面板共用同一份本地數據的開發者；需要粗粒度 Token/工作區價值視圖、又不想把數據放到雲端控制台的用戶。
權限與安全：插件以當前 DSH 進程權限運行，會讀寫 $DSH_HOME/quick-note/ 下文件，並對外提供需 token 的 API（如 admin、usage、workspace-value）。安裝前建議閱讀源碼與 MIT 許可證，確認備份與清理策略符合你的環境。
版本認知：npm package.json 中列爲 1.0.0，README 持續記錄 v1.1.x–v1.44.x 等功能迭代；以你實際安裝的包/發佈說明爲準。GitHub 星標數爲 0（截至目錄抓取），不代表功能完整度，可結合 README 中的迴歸測試說明自行評估。
結尾¶
dsh-quick-note 把「側欄管理臺 + Host 數據文件 + Agent 工具」接到一條鏈路上：人在 GUI 裏操作，智能體用同一套 quick_note_* 讀寫條目與分析工作區。需要安裝命令與細節時，以 README「安裝、更新與卸載」爲準。
