前言¶
DSH 的理念是「一切皆插件」，但它的 Web 界面里一直缺一个顺手的落笔记入口：待办往往写在别处，日期靠手工排，换台机器就丢了。这个插件把这个问题收进了一个左侧栏面板，本机浏览器存着。
下面介绍 gewuji/dsh-plugin-work-notes，一个 DSH（DeepSeek Harness）Web 界面插件。它只做一件事：在左侧栏提供一块可自由摆放的工作便签画布，并配上日历与甘特视图做日期管理。
它是什么¶
这是一个 DSH 插件（bundle），不是独立软件，也不能单独运行。装进 DSH 后出现在左侧栏，带一个笔记形状的「工作便签」图标。维护者是 Gewuji，在社区插件目录里归入「记忆」分类。
它是纯前端插件：不注册宿主路由、不执行命令、不发起网络请求。便签数据只保存在你自己浏览器的 localStorage 里。
核心功能¶
便签画布¶
卡片可以自由拖动，右下角拖拽缩放；靠近其它卡片时自动吸附，按住 Alt 临时关闭吸附。提供 4 种配色、置顶、删除二次确认，以及 未完成 / 进行中 / 完成 三种状态。顶部输入框按回车即可新增便签，卡片按编辑顺序层叠。
日历视图¶
周一开头的月历，单元格内带农历与节气/节日注解。可以在某个单元格上直接建便签；点击便签弹出日期弹层，第一次点设置开始日，第二次点设置结束日。起止日期覆盖某天的便签会显示在那一天里，可直接拖动改期。
甘特视图¶
时间轴按天排布（每天 26px），上限 180 天，围绕今天自动留白。拖动整条可以移动，拖两端可以拉伸，步进按整天。新建时能自动识别文字里的日期；未排期的便签可以一键按文字补日期。
其它¶
- 界面跟随 DSH 语言切换中英文
- 面板自带帮助说明
- 便签保存在浏览器 localStorage，卸载插件不会删除数据
安装与启用¶
插件包的根目录就是一个完整的插件包（package.json 里声明了 dsh.bundle），不需要构建步骤。DSH 的插件安装器可以直接从 git 仓库安装。
方式一：桌面端 / Web 界面里装（推荐）¶
打开「设置 → 插件」，在「包名或地址」里粘贴仓库地址，点「安装」。
https://github.com/Gewuji/dsh-plugin-work-notes
完成后重启 DSH（桌面端退出重开；Web 端重启 dsh 服务），再刷新页面。
方式二：命令行装¶
dsh plugin --profile web add https://github.com/Gewuji/dsh-plugin-work-notes
# 等价写法
dsh plugin --profile web add github:Gewuji/dsh-plugin-work-notes
装完重启 dsh 服务（或退出重开桌面客户端），刷新页面。
--profile 跟你要使用的 profile 走：命令行 / npx @deepseek-ai/dsh web 启动的通常是 web。桌面客户端由 Electron 独占管理 desktop profile，命令行不允许改它，所以桌面端请用方式一。
方式三：本地开发（拷贝目录安装）¶
dsh plugin --profile web add D:\path\to\dsh-plugin-work-notes
路径必须是绝对路径。安装成功后，左侧栏出现笔记形状的「工作便签」图标，点开即可使用。
典型用法¶
| 操作 | 效果 |
|---|---|
顶部输入框 + 回车 / Ctrl + Enter |
新增便签 |
| 拖动卡片 / 拖右下角 | 移动 / 缩放 |
按住 Alt 拖动 |
临时关闭自动吸附 |
| 卡片上的颜色点、图钉、状态 | 换色 / 置顶 / 切换状态 |
| 顶部「便签 / 日历 / 甘特」 | 切换视图 |
| 记「周五前整理周会纪要」 | 新建时自动解析出日期 |
| 「持续 3 天」 | 由单个开始日展开成区间 |
数据与隐私¶
存储键是 dsh-work-notes.v1，写在浏览器 localStorage 里。桌面端页面源是 dsh-app://app，Web 端是 http://127.0.0.1:3080（可用 --port 改），因此桌面端与浏览器之间、换端口之后，便签不共享、不迁移；同一端反复启动是本地的，不会丢。数据不上传、不写会话记录，换电脑请自行导出或手工复制。
卸载¶
图形界面：在「设置 → 插件 → 已安装」里找到 dsh-plugin-work-notes 删除。命令行：
dsh plugin --profile web remove dsh-plugin-work-notes
卸载不会删除已有便签，便签仍在浏览器存储里。想彻底清掉，在该站点的 localStorage 中删除 dsh-work-notes.v1。
适用场景与注意¶
适合在 DSH 里长期待着、需要随手记待办和排日期的人：左侧栏常驻，不用切窗口。
需要注意几点：插件以当前 dsh 进程的权限运行，安装前建议先读一遍源码并确认许可证（本项目为 MIT）。它面向 DSH 0.1.x（在 0.1.7-rc.2 上验证），依赖的稳定接口只有 dsh.client bundle 格式、sidebar.panellist / main 两个注册点，以及 dsh-client-ui-layout + dsh-client-ui-sidebar 注入；DSH 升到 0.2 / 1.0 等大版本若改动这些接口，插件需要跟着更新。桌面端和 Web 端通用，但两边各自独立存数据。
项目为单文件前端实现（client.js），没有构建步骤，改完重启服务并刷新页面即可生效，浏览器端改动也可走 DSH 的 HMR。
结尾¶
它的价值在于把便签、日历、甘特收进 DSH 的左侧栏，本地存储、不越界。目录页：https://www.skillhub.cn/plugins/Gewuji/dsh-plugin-work-notes，仓库：https://github.com/Gewuji/dsh-plugin-work-notes。
