前言¶
用 DeepSeek Harness（dsh）写代码、改方案时，对话窗口里经常会冒出不该立刻发给模型的东西：一个还没想清楚的点子、一句对刚才回答的感想、一条稍后要做的 TODO。这些内容如果塞进当前输入框，容易被下一次发送带走；如果切到外部笔记软件，又要离开正在进行的会话。
官方仓库 deepseek-ai/deepseek-harness 把 Harness 概括成 Everything is a plugin（一切皆插件）：界面插槽也可以被第三方包接管。社区目录 DeepSeek Harness 插件库 收录了一批这类插件，它是独立站点，与 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。
dsh-sticky-note 补的就是输入栏这一侧。它在编辑框工具栏放一枚便签按钮，点开后可以按「点子 / 感想 / TODO」分类随手记，内容以 Markdown 文件落盘，历史清单和归档都在同一块面板里。本文按目录详情页、GitHub 仓库 README / package.json / lib/index.js / lib/client.js，以及上游官方仓库交叉核对后整理。
这是什么¶
dsh-sticky-note 是一款面向 DeepSeek Harness Web 客户端的工具与能力插件，由 Meredith2328 维护。仓库 Meredith2328/dsh-sticky-note 采用 MIT 许可证，主要语言是 JavaScript。package.json 中的版本号是 0.2.1。GitHub 仓库当前星标为 9（目录页仍显示 6，以仓库页面为准）。GitHub topic 标了 dsh-plugin 和 dsh-external。
它解决的问题很具体：把临时笔记留在 DSH 界面里，而不是混进对话，也不必另开一套笔记应用。目录页和仓库简介都把它写成「左下角便签」；客户端实际把按钮注入到输入栏左侧插槽 conversation.input.left，点击后弹出便签面板。
插件分成两半：Host 端负责读写磁盘、定时清理；Web 端负责面板、快捷键和设置页。cordis.patch.yml 会把同名包的 Host 与 Web 两半一起装进当前 profile。
核心功能¶
下面这些能力来自仓库 README，并与 Host / 客户端源码交叉核对过。
随手记与自动保存¶
编辑框工具栏上有一枚便签按钮（aria-label 为「打开便签」）。点开后面板可直接写 Markdown。自动保存间隔可选 10 秒 / 1 分钟 / 5 分钟，也可以关掉（间隔为 0）。Ctrl+S 会立即落盘。空内容不会写成文件。
默认根目录是 $DSH_HOME/sticky-notes（未设置 DSH_HOME 时即 ~/.dsh/sticky-notes）。文件按时间戳命名，例如 20260818-153045.md；类别为 TODO 时会多一个 -todo 后缀。同一条草稿在类别不变时会覆盖同一文件，切类别或点「新建」才会开新文件。
三分类、发送与历史清单¶
便签分成三类：点子 / 感想 / TODO，快捷键 Ctrl+Shift+1/2/3 切换。默认类别是「点子」。
写好之后可以把内容交给当前对话，发送方式有两种：
send：直接发出（默认）append：追加到输入框末尾
历史侧是分组清单，可展开收起。客户端帮助文案写明：单击条目会露出发送按钮，双击查看内容。归档分组可以把条目移回原类别目录。历史便签支持二次编辑保存；用外部编辑器改过对应 .md 后，查看视图会刷新。
保留、自动清除与回收站¶
每条便签可以打「保留」标记（针形图标）。自动清除按文件最后修改时间计龄，未保留且超期的条目会先被移入「已清除」目录，而不是立刻删掉。清除周期可选 1 / 3 / 7 天，设为 0 则不自动清除；默认是 7 天。回收站再保留 30 天 后才真正删除。
Host 在启动时跑一次清理，之后每小时再跑一次，不依赖用户是否打开历史列表。2026-08-16 的提交还修了一处回归：保留标记按「类别 + 原始文件名」识别身份，归档再恢复后仍然豁免清理。
Markdown、主题与设置¶
编辑和预览用 Ctrl+Shift+V 切换。README 写明支持表格、任务列表、删除线和图片。配色跟随 DSW 主题变量，深浅色会一起切。
设置入口在 设置 → 插件 → 便签。可改的项包括：存储路径、保存间隔、清除周期、默认类别、发送方式，以及查看模式（inline 在面板内看全文，file 用系统默认程序打开文件）。配置写在 $DSH_HOME/sticky-note-config.json，保留名单写在 $DSH_HOME/sticky-note-retained.json。
磁盘目录结构如下：
<root>/
├── 点子/ ← 以时间戳命名的 .md 文件
├── 感想/
├── TODO/
├── 归档/ ← 归档条目，文件名前缀带原类别名，可一键恢复
└── 已清除/ ← 自动清除的回收站（再留 30 天）
安装与启用¶
社区目录页给出的安装命令是：
dsh plugin add github:Meredith2328/dsh-sticky-note
package.json 把客户端平台声明为 web，README 也要求装到 web profile。更稳妥的写法是显式指定 profile：
dsh plugin --profile web add github:Meredith2328/dsh-sticky-note
如需可复现安装，按目录页提示固定 commit 哈希。本文核对时，仓库 main 最新提交是 ebabb6c746b1495c5f077e440d98b6665d7a61b9（2026-08-16）：
dsh plugin --profile web add github:Meredith2328/dsh-sticky-note#ebabb6c746b1495c5f077e440d98b6665d7a61b9
本地开发可以用 README 中的目录安装：
dsh plugin --profile web add file:/path/to/dsh-sticky-note
README 还写了 dsh plugin --profile web add dsh-sticky-note（不带 github: 前缀）。当前在 npm registry 查不到同名包，这条命令不能当成已发布的 npm 安装方式；从 GitHub 安装请用上面的 github:Meredith2328/dsh-sticky-note。
安装完成后，按 README 重启 DSH（Web 或 Desktop）。上游 CLI 文档说明：从 Git 拉源码时，pnpm ≥10 可能拦截 prepare 一类构建脚本，第一次 add 失败后要把提示里的包键写进该 profile 的 pnpm-workspace.yaml 再重试。本仓库发布的是已构建的 lib/，是否弹出该提示以本机 pnpm 行为为准。
目录页的安全提示同样适用：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。
典型用法¶
- 启动
dsh web（或 Desktop），确认输入栏左侧出现便签按钮。 - 点击按钮打开面板，按
Ctrl+Shift+1/2/3选「点子 / 感想 / TODO」，写下内容。默认约 10 秒自动保存；着急落盘就按Ctrl+S。 - 需要把这段话交给模型时，用面板上的发送：直接发出，或先追加到输入框再自己改一版。
- 打开「历史便签」查看分组清单。双击查看并继续改；要长期留着的条目打上保留标记；告一段落的条目可以归档，之后再一键恢复。
- 到 设置 → 插件 → 便签 改存储路径、保存间隔和清除周期。如果希望用 VS Code / 记事本打开文件，把查看模式改成
file。面板上也有「打开便签文件夹」，Host 会调用系统默认文件管理器（Windows 用explorer，macOS 用open，Linux 用xdg-open）。
常用快捷键（README 列出，客户端源码中有对应处理）：
Esc：层层退出Tab/Shift+Tab：缩进Ctrl+S：立即保存Ctrl+Shift+V：编辑 / 预览Ctrl+Shift+X：删除线Ctrl+Shift+T：任务列表项Ctrl+T：插入表格骨架
适用场景与注意事项¶
适合已经在用 DSH Web 界面、需要把「还不想发给模型的话」就近记下的人。三类目录把点子、感想和待办分开，历史清单加归档，适合同一台机器上连续多天的会话。它不是知识库，也没有全文检索或跨设备同步；笔记就是本地 Markdown 文件。
使用前需要看清这几条边界：
- 只声明了 Web 客户端。
package.json的dsh.client.platform是web，并注入@deepseek-ai/dsh-client-ui-slots。Headless / TUI profile 装上也不会出现这块面板。 - 以当前 dsh 进程权限运行。 Host 会在配置的根目录读写文件，也能拉起系统默认程序打开文件或文件夹。安装前应阅读
lib/index.js、lib/client.js和 MIT 许可证；不信任的来源不要装。 - 自动清除会搬文件。 默认 7 天未改且未保留的便签会进「已清除」，30 天后删除。重要条目要打保留，或把
clearAfter设为 0。 - 社区目录不是官方商店。 deepseek-harness-plugin.com 与 DeepSeek / 幻方无官方从属关系。Harness 仍是开发者预览，插件可能随核心升级出现不兼容变更。需要可复现环境时，固定上面的 commit 哈希。
小结¶
dsh-sticky-note 把一块本地 Markdown 便签嵌进 DSH 的输入栏：分类记录、定时落盘、一键送进对话，历史和归档都在面板里完成。它不替代专业笔记软件，只补「人还在会话里、话还不能发给模型」这一段。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-sticky-note/
GitHub：https://github.com/Meredith2328/dsh-sticky-note
