flyhigao/dsh-sticky-notes

dsh-sticky-notes

English

DSH（DeepSeek Harness）工作区便签插件。在当前会话头部提供一个紧凑的便签入口，点击后可以为当前工作区创建、编辑和删除多张便签。

便签以 Markdown 文件形式保存在当前工作区的 dsh-notes/ 目录中，简单、透明、可直接用 Git 管理。

功能

- 当前会话头部快捷入口，不占用侧边栏空间。
- 多便签管理：列表预览、点开编辑、新建、保存、删除。
- 弹窗内提供工作区下拉框，默认当前会话工作区，也可以切换到本机其他已注册工作区。
- 界面语言跟随 DSH 当前语言设置，支持中文和英文。
- 切换便签、切换工作区或关闭窗口前，会自动保存未提交的编辑内容。
- 数据落在当前工作区：/dsh-notes/.md。
- 每个便签一个 Markdown 文件，方便直接用编辑器查看和修改。
- 服务端通过 workspaceRegistry 解析工作区路径，不信任浏览器传入的任意路径。
- 写操作仅接受同源 POST，避免跨站请求。

兼容性

- 支持 DSH 0.1.0-rc.6、0.1.0-rc.8、0.1.1-rc.2、0.1.2-alpha.2 及更高版本。
- 零外部运行时依赖，不依赖已被废弃的 dsh-client-runtime。
- 本插件使用 DSH 官方的加法插槽 conversation.session.header.actions，不会替换整个会话头部，也不会独占该位置。
- 使用唯一 ID sticky-notes，避免与其他插件冲突。
- 使用 order: 30 排序，和其他插件按顺序共存。
- HTTP API 统一使用 /dsh-sticky-notes/ 前缀，避免接口冲突。
- 弹窗样式通过独立的 dsh-sticky-notes-modal 类名控制，不污染全局样式。
- 通过 ctx.slots.inject(...) 注册，不依赖插件加载顺序。

为什么是多张便签

一个工作区会积累很多零散想法：待办、灵感、会议记录、临时代码片段。如果只有一张便签，所有内容会堆在一起，越来越难找。

多张便签更符合「便签」的直觉：

- 每张便签一个主题。
- 列表里可以直接看到标题、预览和更新时间。
- 每个文件独立，方便用 Git 追踪和协作。

安装

从 GitHub 安装

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

重启 dsh web 后，进入任意会话，在会话头部右侧可以看到便签图标。

本地开发安装

如果你正在本地开发：

1. 克隆仓库：

git clone git@github.com:flyhigao/dsh-sticky-notes.git

2. 安装到 Web profile 并重启：

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

使用

1. 打开一个会话。
2. 点击会话头部右侧的便签图标。
3. 在弹窗顶部选择工作区：默认选中当前会话工作区，也可以切换到本机其他工作区。
4. 在弹窗中：
- 左侧：所选工作区的便签列表。
- 右侧：标题输入框 + 正文编辑区。
- 底部：新建、删除、保存。
5. 切换便签、切换工作区或关闭窗口时，未点击保存的内容也会先自动保存。
6. 保存后，便签会立即写入所选工作区的 dsh-notes/ 目录。

数据格式

每个便签是一个 Markdown 文件：

/dsh-notes/.md

文件内容：

便签标题

便签正文…

- note-id 由插件生成，例如 note-msw19zz2-7gbiyg。
- 删除便签即删除对应的 .md 文件，没有额外索引。
- 手工修改或新增 .md 文件后，重新打开便签面板即可看到。

HTTP API

插件自带一组简单的 HTTP 接口，供浏览器端调用：

| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /dsh-sticky-notes/list?workspaceId= | 列出当前工作区所有便签 |
| POST | /dsh-sticky-notes/save | 新建或保存便签 |
| POST | /dsh-sticky-notes/delete | 删除便签 |

保存请求体

{
"workspaceId": "workspace-id",
"note": {
"id": "可选，编辑已有便签时传入",
"title": "便签标题",
"content": "便签正文"
}
}

删除请求体

{
"workspaceId": "workspace-id",
"id": "note-id"
}

开发

- 服务端入口：lib/index.js
- 浏览器端入口：client/client.js
- 插件 manifest：cordis.patch.yml

当前版本为手工维护的轻量实现，不需要额外构建步骤。client/client.js 是 DSH 客户端模块加载器可直接加载的 CJS bundle。

许可证

MIT