前言¶
在 DSH(DeepSeek Harness)里和 agent 长对话时,灵感、待跟进事项、临时结论往往散落在聊天记录里,事后很难按主题或时间找回。单独开笔记应用可以记,但和当前会话、模型上下文是割裂的;让模型「记住」又多半只活在当轮上下文里。便签墙类插件的思路,是在宿主界面里常驻一面轻量便签墙,数据落本机,同时暴露工具让 agent 在对话里增删查。下面介绍社区插件 dsh-sticky-wall(维护者 bingomu,分类:记忆),它在 DSH 左侧边栏提供便签入口,支持九色便签、分类筛选、时间分区、归档与待办,并通过 sticky_wall_* 工具供 agent 读写。
这是什么¶
dsh-sticky-wall 是 DSH 的 Web 客户端插件:左侧边栏图标栏中有便签图标,点开后在主面板展示整面便签墙。便签可分类、筛选、置顶、归档,也可转为待办清单;对话里可以用自然语言让 agent 读写这面墙。数据保存在本机单个 JSON 文件中,插件不发起网络请求、不需要账号。许可证为 MIT,当前发布版本 v1.0.0(见 GitHub release 与 package.json)。
核心功能¶
以下能力均来自项目 README,安装成功后可逐项对照界面验证。
入口与输入
- 左侧边栏便签图标打开便签墙。
- 顶部暖黄色输入区写内容,
⌘/Ctrl + Enter或「贴上墙」提交;九种纸色、可选分类。
待办
- 输入卡底部「待办」开关可将新便签设为待办;正文一行一条,可勾选并显示进度。
- 编辑态可在「便签 ⇄ 待办」之间切换;勾选状态用稳定条目 id 保存,插入、重排、改写时尽量保留。
浏览与整理
- 分类 chips:全部、各分类、未分类,并显示数量。
- 时间分区:今天 / 本周 / 更早(更早默认收起);搜索或筛选时结果平铺。
- 手动归档暂时不看的便签,可随时取出或删除。
- 删除后有约 6 秒撤销,恢复时保留 id、勾选与归档状态。
agent 工具
| 工具 | 作用 |
|---|---|
sticky_wall_add |
贴一张便签(text,可选 color、category、kind: 'todo') |
sticky_wall_list |
读墙,可按 query / category 过滤、includeArchived 含归档、limit 限制 |
sticky_wall_remove |
按 id 撕掉一张便签 |
在对话中说「记到便签墙」「便签墙上有什么」等,模型可通过上述工具操作。
本地与界面
- 数据路径:
~/.dsh/sticky-wall/notes.json(若设置了DSH_HOME则以其为准)。 - 旧目录
~/.dsh/notes在首次启动时会自动复制到新目录一次,旧文件保留作备份。 - JSON 损坏时会备份为
notes.json.corrupt-<时间戳>后从空墙重新开始。 - 界面语言与亮暗主题跟随 DSH 宿主(中文 / English)。
安装与启用¶
需要 DSH 0.2.1-rc.2 及以上;README 注明已在 0.2.1-rc.5 测试。插件通过 GitHub 发布的 tarball 安装,命令须使用资料中的 URL,不要自行拼接 github:owner/repo 形式。
dsh plugin --profile <你的 profile> add https://github.com/bingomu/dsh-sticky-wall/archive/refs/tags/v1.0.0.tar.gz
也可在 DSH 设置 → 插件 →「安装」中填入同一 tarball URL。安装后重启 DSH 并刷新页面;左侧边栏出现便签图标即表示启用成功。
升级:将 URL 中的 tag 换成新版本 release 的 tarball 地址后重新安装。卸载:
dsh plugin --profile <你的 profile> remove dsh-sticky-wall
卸载不会删除 ~/.dsh/sticky-wall/notes.json;若要彻底清空便签数据,需手动删除该文件。
典型用法¶
- 点左侧便签图标打开便签墙。
- 在顶部便签纸输入内容,选纸色与分类,
⌘/Ctrl + Enter或点「贴上墙」。 - 点击便签正文就地编辑;底部操作可置顶、换色、归档、删除。
- 需要待办时:进入编辑态,在分类右侧打开「待办」;每行一条,勾选框记录完成状态。
- 用搜索框过滤正文与分类;用分类 chips 限定某一类;点「归档 N」查看已归档便签。
- 在对话中让 agent 写入或列出便签,例如说明「把刚才的接口约定记到便签墙,分类写 API」,由模型调用
sticky_wall_add/sticky_wall_list。
备份或迁移:复制 notes.json 即可。
适用场景与注意¶
适合谁
- 希望在 DSH 同屏记录会话旁的想法、链接式备忘、轻量待办,且不想依赖云端笔记账号的开发者。
- 希望 agent 在任务执行过程中把结论写入持久化便签、或先查墙上已有条目再回答的用户。
使用前请知悉
- DSH 生态采用「一切皆插件」思路;社区目录站点(如 SkillHub 上的插件页)与 DeepSeek / 幻方无官方从属关系,安装来源以 GitHub 与目录页说明为准。
- 插件以当前 DSH 进程的权限读写本机 JSON;安装前建议浏览仓库源码与 MIT 许可证,确认符合你的环境策略。
package.json要求 Node >=22,DSH 版本 >=0.2.1-rc.2 <0.3.0-0;与宿主 major 不匹配时需等作者更新兼容声明后再升级。
结尾¶
dsh-sticky-wall 把「随手贴、分类、归档、待办」和「agent 工具读写」收进 DSH 侧边栏一面墙,数据只在本机 notes.json,适合作为会话旁的轻量记忆层。更多说明与截图见仓库 README。