dsh-sticky-notes

亮点

📝 打字记录

每张便签就是一个待办列表,回车或点「添加」即可记下一条。

🤖 AI 协同

DeepSeek 模型可以直接读你的便签、帮你写便签(见 第 3 节)。

☑️ 勾选完成

点复选框,文字出现删除线并变淡;再点一下取消。

📌 多张便签

右上角「＋ 新建便签」随意添加,每张完全独立。

🖐 随意拖动

便签、收起的小标签、「新建便签」按钮都能拖到任意位置并记住。

🎨 9 套皮肤

经典黄、薄荷绿、樱花粉、天空蓝、暮光紫、暖橙日落、石墨暗夜、霓虹荧光、极简白纸,每张便签独立设置。

🖼 图片便签

上传或拖入图片,便签纸里直接展示,点击可更换。

✏️ 自定义标题

铅笔图标重命名,清空后标题可留白。

🛡 数据可靠

每次改动即时保存,刷新、重开页面都不丢。

皮肤一览

---

1. 安装

前提:本机可执行 dsh(DeepSeek Harness CLI)。若 pnpm 不在 PATH,先执行 npm i -g pnpm(或 corepack enable pnpm)。

方式 A:一行命令安装(推荐)

# 从 GitHub 仓库安装
dsh plugin --profile web add github:charrywhite/dsh-sticky-notes

# 或本地目录开发安装(link 指向插件目录,自动解析)
dsh plugin --profile web add link:C:/path/to/dsh-plugin-sticky-notes

安装完成后:

1. 重启 dsh web(在启动它的终端 Ctrl+C,重新运行 dsh web)
2. 硬刷新浏览器页面(Ctrl+F5),右侧就会出现便签

卸载:dsh plugin --profile web remove dsh-sticky-notes

方式 B:手动安装(备选)

把插件目录放到任意位置(下文以 C:\path\to\dsh-plugin-sticky-notes 为例),修改 web profile 配置:

① 注册依赖与 bundle

编辑 %USERPROFILE%\.dsh\profiles\web\package.json:

{
  "dependencies": {
    "dsh-sticky-notes": "link:C:/path/to/dsh-plugin-sticky-notes"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-sticky-notes"
      ]
    }
  }
}

link: 指向插件目录的绝对路径,斜杠 / 或反斜杠 \ 均可(JSON 里建议用 /)。

② 在 profile 目录执行 pnpm install

cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm install

③ 重启 dsh web + 硬刷新浏览器页面(Ctrl+F5)。

方式 C:GitHub 依赖手动方式

在 package.json 里把依赖写成 GitHub 引用,然后同样执行 pnpm install + 重启 + 刷新:

{
  "dependencies": {
    "dsh-sticky-notes": "github:charrywhite/dsh-sticky-notes#commit哈希或分支"
  },
  "dsh": {
    "profile": {
      "bundles": ["dsh-sticky-notes"]
    }
  }
}

---

2. 使用指南

两个功能键

• 📝 便签键:点一下弹出菜单,选择「文字便签」或「图片便签」新建;按住它拖动可以换位置
• 👀 眼睛键:点一下隐藏全部便签(图标变成 🙈),再点一下全部恢复

创建便签

点击右上角的 📝 便签按钮,弹出菜单选择:

选项	说明
📝 文字便签	输入框打字,回车或点「添加」变成一条待办
🖼 图片便签	点击上传区选择图片,或直接把图片拖进便签

新便签默认从右上角层叠排开,每张都有标题栏、计数徽章和操作按钮。

便签操作

操作	方式
拖动	按住标题栏(或收起后的小标签、📝 按钮)拖动,位置自动记住
隐藏/显示全部	单击 📝 按钮下方的 👀 按钮:所有便签整体隐藏(图标变 🙈);再单击全部恢复(状态会记住)
勾选完成	点条目左侧复选框 → 删除线 + 变淡;再点取消
删除单条	鼠标悬停条目,点右侧 ×
清除已完成	便签底部「清除已完成」一键清理勾选项
换皮肤	点标题栏 🎨,弹出 9 色色块,点选即换(每张便签独立)
重命名	点标题栏 ✏️,输入新名字,回车/失焦保存;清空可留白
收起/展开	点标题栏 — 或直接单击标题收起为小圆标;单击小圆标展开
删除整张	点标题栏 🗑(有确认弹窗)

图片便签

• 上传后图片显示在便签纸内,点击图片可更换
• 图片便签同样支持拖动、换皮肤、重命名、收起、删除

---

3. AI 模型读写便签

插件注册了两个模型工具,DeepSeek 模型在对话中可以直接调用:

读取:sticky_notes_read

列出所有便签:标题、每条文字、完成状态(☐/☑)、皮肤、是否收起。图片便签只显示元数据(标题/是否有图)。

用法:对模型说「看一下我的便签」「帮我整理便签」「按便签干活」。

写入:sticky_notes_add

• 新建便签:不传 noteId,传 text(必填)+ 可选 title
• 追加条目:传 noteId(先用 sticky_notes_read 拿到)+ text

设计约束:只允许追加/新建,不能修改或删除已有内容,不会覆盖你手动编辑的东西;图片便签拒绝追加文字条目。

用法:对模型说「帮我在便签上记一条:明天下午三点开会」「把这个需求加到工作便签里」。

---

4. 卸载

1. 方式 A 安装的:dsh plugin --profile web remove dsh-sticky-notes
2. 方式 B/C 安装的:从 package.json 移除依赖项和 bundles 条目,再执行 pnpm install
3. (可选)删除数据文件:Remove-Item "$env:USERPROFILE\.dsh\sticky-notes.json"
4. 重启 dsh web

---

环境要求

• DeepSeek Harness web 模式(dsh web)
• 浏览器:现代 Chromium/Firefox/Safari
• 无第三方运行时依赖

鸣谢

感谢 @scraed 在 PR #1 中提出的交互设计:home 键(单击隐藏/显示全部便签、长按新建)与「点击标题栏收起便签」。

License

MIT