前言¶

開發智能體時經常需要順手記幾條東西：待辦、調試結論、留給下一次會話的線索。手邊開着很多窗口，專門爲一條筆記切到編輯器不划算；寫到對話裏又容易被刷走。yanghx-dsh-quick-notes（npm 包名 @yanghx/dsh-quick-notes，GitHub 倉庫 YangYhx/yanghx-dsh-quick-notes，維護者 YangYhx）解決的是這一件事：在 DeepSeek Harness（DSH）桌面端按一個快捷鍵，隨手記一筆，內容按天落到本地 Markdown 文件裏。

插件屬於 DSH 生態裏的社區作品，分類標籤是「記憶」。目錄頁收錄於獨立站點 SkillHub（社區目錄，與 DeepSeek 無官方從屬關係）。

這是什麼¶

一句話定位：DSH 的筆記插件，提供速記浮層、側欄面板，把筆記按天歸檔到本地 Markdown 文件。

解決的問題：

1. 速記入口要夠快，正在輸入其他內容時也能觸發
2. 筆記要落在普通文本文件裏，不鎖在插件私有格式
3. 能按目錄（筆記本）分開放，切換方便

設計取向：所有內容都是本地 .md 文件，插件不做雲同步，也不引入額外依賴。宿主半部純 Node 內置模塊，瀏覽器半部樣式只用主題 token。

核心功能¶

三個入口：

• 速記浮層：⌘⇧N（Windows / Linux 用 Ctrl+Shift+N），任意頁面可用，包括正在輸入時
• 側欄面板：左側欄「隨手記」圖標，可以看時間線、搜索、編輯、刪除、切換筆記本、管理筆記本
• 文件本身：筆記就是磁盤上的 Markdown，可以直接用 Finder 或編輯器打開當天文件

寫入規則：

1. 一天一個文件，文件名 YYYY-MM-DD.md
2. 每條筆記帶時間，新條目用 - HH:MM 內容 的形式追加
3. 多行內容用兩個空格縮進續行，不會被拆成兩條

筆記本（保存目錄）：

• 每個筆記本 = 一個名字 + 一個目錄，面板頂部下拉切換，一次只看一個筆記本
• 速記浮層和麪板速記框永遠寫入當前選中的筆記本
• 默認筆記本是 ~/Documents/隨手記
• 設置抽屜裏可以添加筆記本（起名字 + 選文件夾）、設爲當前、重命名、移除
• 移除只解除關聯，不刪除文件；至少要保留一個筆記本
• 換筆記本不會搬文件，舊目錄內容原地不動

安裝與啓用¶

插件市場收錄後，在桌面端插件市場搜索 quick-notes 或 隨手記，一鍵安裝。

也可以直接裝包。走包安裝需要在 profile 裏手動接線：

npm i @yanghx/dsh-quick-notes

接線步驟與卸載相反：

1. 在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 里加入 @yanghx/dsh-quick-notes
2. 裝好後重啓 DeepSeek Harness

安裝前先看這兩點：

{
  "engines": { "node": ">=20" },
  "license": "MIT",
  "version": "0.1.0"
}

這是資料裏的原文字段：要求 Node 20 及以上，許可證 MIT，當前版本 0.1.0。插件以當前 DSH 進程的權限運行，裝包方式會改動 profile 配置，建議先看一遍源碼再裝。

典型用法¶

速記一條：

1. 任意頁面按 ⌘⇧N，浮層彈出
2. 輸入內容，⏎ 保存，⇧⏎ 換行，esc 關閉
3. 保存後側欄面板列表立即多一條

浮層彈出時正在輸入其他內容也不衝突，這是它相對「切到編輯器寫文件」的主要優勢。

編輯已有筆記：

1. 側欄面板裏 hover 一條筆記，出現複製、編輯、刪除操作
2. 編輯是行內改：⌘⏎ 保存，esc 取消
3. 行內編輯只改正文，原有時間戳保持不變

列表默認每條預覽 3 行，超出部分點「展開全文」。

打開底層文件查看當天的完整內容：

# 2026-11-05 星期三

- 10:25 先把方案定下來
- 11:02 多行的一條
  第二行

配置與落盤位置：

• 配置文件：~/.dsh/quick-notes/config.json，格式 {"vaults": {"名字": "/絕對路徑"}, "active": "名字"}
• 舊的單數形式 {"vault": "/路徑"} 會自動遷移成 {"vaults": {"默認": "/路徑"}, "active": "默認"}
• 任一目錄不可寫時，保存被整體拒絕，配置保持不變

適用場景與注意¶

適合：

1. 在 DSH 桌面端高頻記短內容的開發、調試場景
2. 希望筆記直接是本地 Markdown、能被編輯器或 git 管理的用途
3. 需要按項目或主題分目錄存放筆記的人

不適合：

1. 需要雲同步或跨設備一致性的場景，插件不做同步
2. 需要系統級全局熱鍵的場景。Electron 主進程的 globalShortcut 插件碰不到，本插件的快捷鍵是應用內快捷鍵

性能與一致性邊界：

• 默認只加載最近 60 天、最多 400 個文件，更早的點「加載更早」按需翻
• 寫入只在單個進程內保證按日期串行，不做跨進程文件鎖。多開進程同時寫同一目錄，仍可能互相影響

卸載（筆記文件不會被刪）：

1. 從 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 裏刪掉 @yanghx/dsh-quick-notes
2. 刪掉 ~/.dsh/profiles/desktop/node_modules/@yanghx/dsh-quick-notes
3. 重啓 DeepSeek Harness

開發與驗證：源碼結構是 index.js（宿主半部，/api/quick-notes 前綴路由 + 文件讀寫 + 配置，純 Node 內置模塊零依賴）、client.js（瀏覽器半部，側欄面板、速記浮層、設置抽屜）、cordis.patch.yml（把宿主半部插進插件樹，id quick-notes）。跑宿主端全鏈路測試：

node dev/smoke.mjs   # 臨時目錄，不碰真實數據

結尾¶

這個插件的價值在於把「隨手記」和「按天歸檔到 Markdown」這兩件事一貫到底：入口快，落盤是普通文本，目錄可換。適合作爲 DSH 桌面端的本地記憶層使用。

插件目錄頁：https://www.skillhub.cn/plugins/YangYhx/yanghx-dsh-quick-notes
GitHub：https://github.com/YangYhx/yanghx-dsh-quick-notes
npm：https://www.npmjs.com/package/@yanghx/dsh-quick-notes