前言¶
在 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。
