前言¶
在 DeepSeek Harness（DSH）或 ACRYL 裏做對話和插件開發時，常會需要隨手記下接口名、路徑或待辦，又不想切到外部編輯器。瀏覽器標籤、系統便箋和對話上下文各管一塊，Web 與 Desktop 之間也不容易對齊同一份內容。下面介紹社區 Cordis 插件 acryl-quick-notes（維護者 inboxxobni，SkillHub 分類爲「記憶」）：在頂欄提供筆記本入口，筆記以主機插件數據目錄下的獨立 .txt 文件保存，Web 與 Desktop 共用同一套數據。
這是什麼¶
acryl-quick-notes 是面向 ACRYL 與 stock DeepSeek Harness 的 Cordis 插件。簡介爲：Quick Notes — a Cordis plugin for ACRYL and DeepSeek Harness。當前 package 版本爲 0.3.0，許可證 MIT。
插件拆成兩半：index.js 在主機側通過已認證的 RPC 路由（位於 /api）讀寫筆記；client.js 負責頂欄按鈕與筆記列表 UI。聲明權限爲 fs.write（僅限本插件數據目錄）與 ui。它不向外提供額外 Cordis 服務，僅在客戶端填充插槽 conversation.session.header.actions。
核心功能¶
- 頂欄入口：會話頂欄出現小筆記本圖標，點擊打開 Quick Notes 列表。
- 按文件持久化：每條筆記對應主機上插件數據文件夾內的一個
.txt文件，便於與 DSH 其它本地數據一起備份。 - Web / Desktop 共享：讀寫都走主機 RPC，同一 DSH 實例下 Web 與 Desktop 客戶端看到同一份筆記。
- 依賴明確：缺少所需 Cordis 服務時插件會等待並保持 inactive，不會自行猜測存儲路徑。
運行環境與依賴¶
宿主應用需提供 package.json 中 acryl.requires 所列服務（由其它插件提供）：
| 側 | 所需服務 |
|---|---|
| Host | connection、dshHomePath |
| Client | connection、slots |
ACRYL 與 stock DSH（Web、Desktop）均提供上述服務。0.3.0 起可在 stock DSH 中運行；0.2.x 的 RPC 通道依賴 stock DSH 未聲明的 webServer，因此主要面向 ACRYL。若環境中缺少任一服務，插件保持 inactive。
安裝與啓用¶
安裝方式以倉庫 README 爲準，不要用 github:owner/repo 自行拼接 stock DSH 的 dsh plugin add。
ACRYL 任選其一：
/plugin pull github:inboxxobni/acryl-quick-notes
acryl plugin pull github:inboxxobni/acryl-quick-notes
或在 Plugins 頁的 “Add plugin” 框粘貼 github:inboxxobni/acryl-quick-notes（按 release 的 sha512 校驗安裝最新版）。
stock DeepSeek Harness：在 GitHub Releases 取最新 release 的 .tgz URL，然後：
- 將該 URL 粘貼到 Plugins 頁 “Add plugin”，或
- 執行（將
<that URL>換爲實際地址）：
dsh plugin --profile web add <that URL>
倉庫帶有 GitHub topics acryl-package、cordis-plugin、dsh-plugin，並寫在 package.json 的 keywords 中；索引這些 topic 的目錄可發現該插件，無需單獨提交。社區目錄頁：https://www.skillhub.cn/plugins/inboxxobni/acryl-quick-notes。
典型用法¶
- 按上一節在 ACRYL 或 stock DSH 中安裝並啓用插件（DSH 需 0.3.0 對應 release）。
- 打開 Web 或 Desktop 客戶端，進入帶會話頂欄的對話界面。
- 點擊頂欄筆記本圖標，在 Quick Notes 列表中新建或編輯筆記；保存後內容由主機寫入插件數據目錄下的
.txt文件。 - 換用同一 DSH 實例的另一種客戶端時，再次打開列表即可看到相同筆記。
README 未給出額外配置項；行爲由 Cordis 補丁與上述 RPC/API 約定實現。
適用場景與注意¶
適合：需要在 Harness 會話界面內快速記要點、且希望筆記落在主機文件、並在 Web/Desktop 間一致的用戶。
注意：
- 插件以當前 dsh 進程權限運行；安裝前請閱讀 GitHub 源碼 與 MIT 許可證，確認
fs.write僅作用於插件自有數據目錄是否符合你的安全策略。 - SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
- 星標與 release 以 GitHub 頁面爲準；本文版本號來自已抓取
package.json的 0.3.0。
結尾¶
acryl-quick-notes 用頂欄 UI 和主機側 txt 文件，把「會話裏隨手記」和「多客戶端同一份數據」合在一起，體量小、依賴聲明清楚。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/inboxxobni/acryl-quick-notes 與倉庫 https://github.com/inboxxobni/acryl-quick-notes。
