前言¶
在 DSH 里跑长任务时，想法和中间结论经常散落在对话里：开头记的一条需求，跑到一半忘了放在哪儿；想让 AI 处理某条便签，又要手工复制正文、指定目录、再盯着结果。dsh-notes-qiange（签格 · 智能便签）就是为了把这些事情收拢到一处：便签板开在中间列或右侧栏，便签按项目文件夹分区，需要时拖进任务泳道交给 AI，也可以按日程定时跑。
下面介绍这个插件。它由 jxhsjxhs 维护，是 @zzerx/dsh-plugin-notes（MIT，作者 0x7A7A）的 Fork，基础上增补了项目文件夹分区管理；社区目录里归在工作流分类，当前 0 星标。安装方式只有源码构建一种，因为还没发布到 npm。
这是什么¶
一句话定位：DSH 的便签插件，纸卡墙便签板 + 项目文件夹 + Markdown 编辑器 + 任务泳道。与普通便签工具的差别在于后半段——便签可以变成任务，交给 AI 在指定工作区里跑，也可以按日程定时触发。
来源归属要说清楚：基础版本是 @zzerx/dsh-plugin-notes 0.6.0（MIT），本分支新增了项目（文件夹）数据模型、文件夹条筛选、新建时区分便签/项目、编辑器归属下拉、agent 项目工具，以及带 projects 的 WebDAV v2 快照。原项目的 MIT 许可证与版权声明保留在仓库 LICENSE 中。
安装与启用¶
尚未发布到 npm，因此先用源码构建。下面的命令按 README 原文，--profile 后面替换成你自己的 profile 名：
git clone https://github.com/jxhsjxhs/dsh-notes-qiange.git
cd dsh-notes-qiange
npm install
npm run build
dsh plugin --profile <你的 profile 名> add "$(pwd)"
这一步是在本地编译出插件产物并装进指定 profile。装好后侧栏出现便签字形（侧栏折叠时只留图标），点它打开便签板；板内右上角 ✕ 或 Esc 回到会话。
发布到 npm 之后可以直接装，命令也来自 README：
dsh plugin --profile <你的 profile 名> add dsh-notes-qiange
启用后有四个入口，都可以在 dsh 设置 → 便签 → 入口 里单独开关，默认全开：侧栏顶部入口（点行开板，点 (＋) 只开快捷新建）、输入框左下角的字形（三行菜单：新增便签 / 便签板 / 任务泳道）、每条助手回复下方的「存成便签」按钮（把该条回答连同图片带进快捷新建浮层，预填标题与正文）、右侧栏导引页的便签卡片。四者至少会留一个，全关掉时设置页会锁住最后一个开着的入口，因此不会出现没有入口开不了板的死局。宿主没装右侧栏时，「打开方式」选右侧栏会自动回退中间列。
核心功能¶
一、项目文件夹分区。新建时可选「便签」或「项目」，项目就是文件夹，便签按项目归堆。顶部文件夹条筛「全部 / 未分类 / 某个项目」，支持重命名、改色标、删除；删项目不会删便签，只把它们挪回「未分类」。停在某个项目里新建便签会自动落进该项目，编辑器里随时可以改归属。快捷新建浮层顶部同样有「便签 / 项目」两个页签。
二、三种显示模式。纸卡墙 / 看板 / 日历随时切换，选择会被记住，项目筛选对三种视图都生效。六色纸卡配色与 Win11 便签一致，置顶优先，颜色可多选筛选；标题加正文实时搜索，归档便签收进纸卡墙底部折叠区，可恢复 / 编辑 / 删除。
三、到期与日历。看板卡片上点「截止」即选日期，逾期标红。日历按月排格，截止（蓝点）、定时触发（绿点，含未来重复）与执行历史（橙点，成功/失败）分色，点事项进编辑器。
四、Markdown 正文。工具栏覆盖加粗 / 标题 / 列表 / 任务清单 / 引用 / 代码 / 链接 / 表格 / 撤销重做；任务清单 - [ ] 在纸卡上显示完成度徽标（如 2/5，全勾变 ✓）。在编辑器里 Ctrl+V 粘贴剪贴板图片或普通文件，会存到本地 $DSH_HOME/notes-assets/，正文只留引用，不把 base64 塞进便签 JSON；文件以「📎 文件名」chip 出现，右侧常驻 👁（用本机系统默认应用打开）与 ⬇（下载回来）两个按钮。
五、便签变任务。写入泳道状态即成为任务，五列看板（待规划 → 待办 → 进行中 → 已完成 → 已失败）拖拽换状态，普通便签不进看板。编辑器底部只留一行任务摘要（状态 · 工作区 · 模型 · 预设），点「设置」会从纸条右侧抽出一张附表，点「收起」塞回纸后。
六、交给 AI 执行。任务卡 hover「执行」，插件按该任务的工作区新开一个会话跑，便签板所在会话不被占用；完成后摘要回到卡片首行，全文进编辑器的「任务与结果」区。跑太久可以「重置为待办」。附表里能选模型与 Agent 预设（留空即宿主默认），只影响该任务派发出来的新会话。
七、定时执行。支持一次性 / 间隔 N 分钟 / 每天 / 每周（可多选星期）/ 每月；卡片显示「周期 · 下次时刻」，编辑器显示「下次 / 上次」。宿主停机期间错过的时点超 2 小时不补跑（循环型顺延到下一周期，一次性停用并写明原因），2 小时以内的补跑一次；上一轮未结束则本轮跳过。
八、编辑安全。编辑既有便签时停顿约 1 秒自动落盘，页脚有保存指示灯；X /「取消」/ Esc / 点弹窗外，只要还有未保存的改动就弹「便签有改动」，保存并关闭、放弃改动、继续编辑三选一。Ctrl+S 立即保存但不关弹窗，Ctrl+Enter 或「保存」按钮等于保存并关闭。
典型用法¶
卡下流程是 README 里「常用操作」一节直接给的，按顺序走：
1、输入框左下角那个字形 → 菜单「新增项目」，先建一个放代码的目录项目；或在便签板文件夹条点「新建项目」。
2、同一菜单点「新增便签」，或点侧栏便签字形里的 (＋)，记一条「给定时任务把 README 里的示例跑一遍」。写的过程中可以用工具栏「任务清单」（或 Ctrl+Shift+9）插几条 - [ ]，回车续行、Tab 缩进成子项。
3、把这条便签变成任务：打开编辑器，在右侧任务附表里选工作区（绝对路径，从下拉框选，候选是最近会话用过的目录，只选不手填），写入泳道状态即成为任务。文档明确：没有默认值也没有兜底，没选工作区就存不成任务，摘要行变红、保存被挡下；泳道里没设工作区的任务卡显红字「未设工作区」，「执行」按钮也是禁用的。
4、把卡片拖到「进行中」，hover 点「执行」，插件会按这个工作区新开一个会话跑；跑完回来看卡片首行的摘要与编辑器里的「任务与结果」区。
5、想做周期检查就再设一条定时任务：bijvoorbeeld 每天一次，它会在卡片上显示「周期 · 下次时刻」，并在日历视图里以绿点标出。
备份走 WebDAV：在 dsh 设置 → 便签 → 备份 里填服务器地址、远端目录、账号与应用密码，按检查间隔定时比对，只在便签有变更时上传快照，远端只留最近保留份数份。要立刻验证连通可以点「保存并立即备份」。注意图片与附件不随备份上传，快照里只有正文和 notes-asset: / notes-file: 引用，换机恢复只恢复文字与引用，本机没有对应文件时便签里显示「图片已丢失」，附件链接点了会提示下载失败。恢复前插件会先自动备份当前状态，选中的那份整体覆盖现有便签。
适用场景与注意¶
适合在 DSH 里维护长项目的人：需要把临时想法、需求条目、AI 执行结果都挂在一个固定位置，并且希望「记下来 -> 变任务 -> AI 跑 -> 定时再跑」这条链路不靠手工复制粘贴。依赖少、几乎不用改宿主配置，装好开关即可；纯 UI 宿主也能照常使用便签板。
三点要注意。其一，插件以当前 dsh 进程的权限运行，能读写该进程能访问的文件与目录，安装前应先通读源码与 LICENSE（MIT）再决定；它从源码构建，npm install 会执行仓库里的脚本，核对上游 Fork 来源（@zzerx/dsh-plugin-notes，0.6.0，作者 0x7A7A）是必要步骤。其二，任务执行要求显式指定工作区，没有默认值，顺着下拉框选而不是手填路径。其三，宿主装配了 tools 服务时插件注册 8 个 agent 工具（notes_list、notes_get、notes_list_projects、notes_create_project、notes_create、notes_update、notes_set_pinned、notes_delete、notes_task_set_status、notes_task_report 中的核心一套）；工具改或删你手写的便签时会发起一次「同意 / 拒绝」，宿主没有审批通道时 agent 只能删它自己创建的便签，任务工具只在「执行」授权的那次会话内可用。
同仓库里的开发命令：npm run typecheck（tsc –noEmit）、npm run build（产出 lib/index.js + lib/client.js + lib/types）、npm run watch（改 src 自动重建，host 侧改动仍需重启 dsh）。
结尾¶
dsh-notes-qiange 把「记一笔」到「让 AI 去做」之间的距离缩短了：便签按项目分区，任务和 AI 执行结果落回同一块板子，备份也能走 WebDAV。想先看界面，目录页是 https://www.skillhub.cn/plugins/jxhsjxhs/dsh-notes-qiange，源码与 README 在 https://github.com/jxhsjxhs/dsh-notes-qiange。
