前言¶
在 DeepSeek Harness（DSH）里跑智能体、调插件、看会话时，灵感、待办和临时结论往往散落在对话里，事后很难按「一块块小笔记」找回。系统自带能力侧重编排与工具调用，并不专门提供侧栏里的轻量便签墙。社区插件 dsh-sticky-wall（便签墙）由维护者 zanhoulll 发布，灵感来自 DSH 官方视频中的演示思路；它在 DSH Desktop 启动的 Web GUI 左侧栏增加「便签墙」入口，打开即是一面可搜索、可编辑、自动保存的彩色便签墙，无需单独部署前端或执行构建。
这是什么¶
dsh-sticky-wall 是挂在 DSH Cordis 插件体系上的便签面板：Host 半负责本机 JSON 持久化与 HTTP 读写，浏览器半负责侧栏入口、瀑布流布局与交互。插件运行在 DSH Desktop 客户端 通过 dsh web 提供的 Web GUI 内，依赖左侧栏与主面板插槽，不是可脱离 DSH 单独打开的网页应用。当前版本 1.1.0（MIT 许可证），仓库：https://github.com/zanhoulll/dsh-sticky-wall；社区目录页：https://www.skillhub.cn/plugins/zanhoulll/dsh-sticky-wall（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
下面介绍 README 中已写明、且与实现一致的能力。
侧栏与快速记录¶
- 左侧栏注入便签折角图标，点击打开独立主面板。
- 顶部黄色输入区支持 6 种马卡龙色；
⌘/Ctrl + Enter或「+ 添加到墙上」快捷添加。
便签墙与瀑布流¶
- 卡片轻微错落旋转，悬停扶正并露出比例、编辑、删除控件。
- 瀑布流：每张便签落到当前能放下它的最靠上位置；长文撑高或宽卡挤开邻居后，后续便签顺次补位，宽卡让出的空洞也会被补上。
- 每条便签可独立设置横向占格 1:1 / 2:1 / 3:1 / 4:1（占 1～4 列）；添加时在输入区选「出生」比例，卡片上也可切换，比例按便签持久化。
编辑、搜索与语言¶
- 双击卡片文字就地编辑；
⌘/Ctrl + Enter保存，Esc取消；编辑框高度随正文变化，与展示态一致。 - 顶部搜索框按内容实时过滤；右上角显示便签总数。
- UI 与展示元数据提供 zh / en 双语。
持久化与兜底¶
- 变更即持久化：刷新、换端口、重启不丢；断网时仍有 localStorage 镜像兜底。
- 主存储文件：
~/.dsh/sticky-wall/notes.json（Host 半用 Node 内建fs原子写入：临时文件 +rename）。 - 浏览器半优先读宿主路由，同时在
localStorage保留镜像，保证首屏与宿主不可用时的回显。
Host 暴露的同源 JSON 接口：
| 接口 | 说明 |
|---|---|
GET /sticky-wall/notes |
返回 { notes: StickyNote[] } |
POST /sticky-wall/notes |
请求体 { notes: StickyNote[] }，返回 { ok: true, count } |
单条便签字段：{ id, text, color, ratio, createdAt, updatedAt }；ratio 为横向占列数（1～4，缺省按 1）。宿主侧限制包括：正文 ≤ 20000 字符、便签数 ≤ 2000、请求体 ≤ 2MB 等。
前置要求¶
- DeepSeek Harness Web GUI：须由 DSH Desktop 启动并在
dsh web实例中打开；插件依赖 Cordis 与侧栏 / 主面板插槽。 - web profile：持久化路由需要宿主
webServer；在 headless 等无 Web 的 profile 中插件其余部分仍可加载，但便签不会落盘。 - 安装方式：通过 DSH 内置
plugin_manager以本地目录安装，无需npm install或构建；Host 半仅用到 Node 内建fs。 - 浏览器：任意现代浏览器；数据保存在本机，不依赖外部网络。
安装与启用¶
官方 README 给出的安装方式是一次工具调用，以本插件目录的绝对路径为安装包目标，而不是凭仓库名拼接 CLI 命令。
通过 DSH 插件管理器安装：
- 工具：
plugin_manager action：install_bundletarget：本插件目录绝对路径，例如<本插件目录绝对路径>
说明：install_bundle 是工具动作名，下划线是名称的一部分，不是占位符。
安装后刷新页面，左侧栏出现「便签墙」入口，点击即可打开面板。
典型用法¶
- 打开 DSH Web GUI，从侧栏进入「便签墙」。
- 在顶部输入区写内容，选颜色与占格比例（1:1～4:1），用
⌘/Ctrl + Enter或按钮添加到墙上。 - 在墙上悬停卡片可改比例、编辑或删除；双击文字进入编辑态。
- 用顶部搜索框过滤便签；需要备份或迁移时，拷贝
~/.dsh/sticky-wall/notes.json即可。
开发与改 client.js 后，可在插件目录跑渲染冒烟测试（无需真实浏览器）：
node test/smoke.mjs
或：
npm test
适用场景与注意¶
适合：在 DSH 会话旁长期保留灵感片段、调试备忘、链接与短结论；希望数据留在本机、侧栏一点即达，且不想维护独立笔记服务的使用者。
注意：
- 插件以当前 dsh 进程权限 运行，安装前应阅读源码并确认 MIT 许可证与行为是否符合预期。
- 无 Web 的 profile 下便签不会写入磁盘；需要落盘时请使用带
webServer的 web profile。 - 项目无第三方 npm 依赖、无构建步骤；浏览器半通过
window.__ModuleLoader__懒加载，纯 DOM + 内联样式。
结尾¶
dsh-sticky-wall 把「随手贴灵感」收进 DSH 侧栏：瀑布流、可调占格、搜索编辑与双端持久化（宿主 JSON + 本地镜像）都在 Web GUI 内完成。进一步了解可查看社区目录 https://www.skillhub.cn/plugins/zanhoulll/dsh-sticky-wall 与 GitHub 仓库 https://github.com/zanhoulll/dsh-sticky-wall。
