前言¶

在 DSH 的 Web 会话中，工作区里经常会有临时记录、待办或片段需要快速记下来。dsh-sticky-notes 是一个由 flyhigao 维护的轻量插件，它在当前会话头部右侧提供一个便签入口，用来为所选工作区新建、编辑和删除多张便签。

该插件使用 MIT 许可证，支持 DSH 0.1.0-rc.6、0.1.0-rc.8、0.1.1-rc.2、0.1.2-alpha.2 及更高版本。

核心能力¶

• 当前会话头部快捷入口，不占用侧边栏空间。
• 多便签管理：列表预览、点开编辑、新建、保存、删除。
• 弹窗内提供工作区下拉框，默认当前会话工作区，也可以切换到本机其他已注册工作区。
• 界面语言跟随 DSH 当前语言设置，支持中文和英文。
• 切换便签、切换工作区或关闭窗口前，会自动保存未提交的编辑内容。
• 每个便签保存为一个 Markdown 文件，方便直接用编辑器查看和修改。

安装¶

从 GitHub 安装：

dsh plugin --profile web add github:flyhigao/dsh-sticky-notes

安装后重启 dsh web，进入会话时可在会话头部右侧看到便签图标。

本地开发安装时，克隆仓库后执行：

dsh plugin --profile web add file:/path/to/dsh-sticky-notes

再重启 dsh web。

使用¶

1、打开一个 DSH 会话。

2、点击会话头部右侧的便签图标。

3、在弹窗顶部选择工作区；默认是当前会话工作区，也可以切换到本机其他已注册工作区。

4、在列表中预览便签，或新建、编辑、删除便签。

5、保存后，内容会写入所选工作区的 dsh-notes/ 目录。

保存后的文件路径形式为：

<working-directory>/dsh-notes/<note-id>.md

数据与接口¶

每个便签对应一个 Markdown 文件。删除便签就是删除对应的 .md 文件，没有额外索引。手工修改或新增 .md 文件后，重新打开便签面板即可看到变化。

插件提供如下 HTTP API：

GET /dsh-sticky-notes/list?workspaceId=<id>
POST /dsh-sticky-notes/save
POST /dsh-sticky-notes/delete

这些接口用于列表、保存和删除。写操作仅接受同源 POST，避免跨站请求。服务端通过 workspaceRegistry 解析工作区路径，不信任浏览器传入的任意路径。

适用场景与注意¶

这个插件适合需要在工作区中快速记录零散内容、并且希望以 Markdown 文件形式保留的场景。它使用 DSH 官方加法插槽 conversation.session.header.actions，不替换整个会话头部，也不会独占该位置。

插件使用唯一 ID sticky-notes、order: 30 排序、HTTP API 前缀 /dsh-sticky-notes/* 和弹窗类名 dsh-sticky-notes-modal，以减少与其他插件冲突。

当前版本是手工维护的轻量实现，不需要额外构建步骤，零外部运行时依赖，不依赖已被废弃的 dsh-client-runtime。

由于插件会以当前 dsh 进程权限运行，安装前建议检查源码和 MIT 许可证。

结尾¶

dsh-sticky-notes 的价值在于把“工作区便签”做成一个轻量、透明、可直接用编辑器维护的 Markdown 文件入口。

GitHub 仓库：https://github.com/flyhigao/dsh-sticky-notes

插件线索给出的目录页地址为：https://www.skillhub.cn/plugins/flyhigao/dsh-sticky-notes（该地址未直接在已抓取资料中确认）