dsh-plugin-control-your-schedule · 纸屿

把便签、纸页笔记、日历待办和画纸，装进 DeepSeek Harness 的左侧栏。 纸面风格的个人工作台：数据保存在本机，不联网。

当前版本 0.2.3 · 开发依据 DSH 0.2.1-rc.2 · Windows 实测，macOS / Linux 由 CI 构建与静态门禁覆盖

功能

• 便签：短句速记，自动保存；整张纸都能拖着走（正文、滚动条、色块、删除键除外），最后碰过的那张永远在最上面。正文默认使用内置霞鹜文楷手写体，可在设置里换成系统行楷或纸张宋体。

  

• 废纸篓：删掉的便签不弹「撤销」提示，而是进便签窗口顶部的废纸篓，留 7 天，随时放回去；空便签直接丢弃。

• 纸页笔记：长文写作，左侧列表搜索/切换，自动保存。新纸页的标题像正文一样是 placeholder，不写字不会留下一行「未命名纸页」。

  

• 日历与待办：每件事有四档紧急程度（重要且紧急 / 重要但不紧急 / 紧急但不重要 / 不紧急也不重要），在待办行右侧就地切换：点色点弹出四档选择（选中即生效），点旁边的胶囊在「仅今日 / 每天」之间切换，都不用进详情。

• 日历圆点：未完成的点在上、按档位着色；完成的点沉到格子底部并变灰，位置固定不换位。

• 持久待办：选「每天」后，从锚定日起每天出现一条当前实例，今天打卡后第二天自动长出一条未完成的新实例；日历上只留真正打过卡的日子（灰点），未来不铺。勾完当天会出现「这件事算结束了」，收起后不再长新实例、随时可恢复，并显示「打卡 N 天」。

  

• 安静的界面：不弹浮层提示；没有信息的状态行不占位。

• 画纸：手写/绘画，支持撤销、橡皮、导出 PNG；画纸簿可左右翻页，也能整张删掉。

  

• 固定右侧栏：今日纸签始终在右侧，窗口只在左侧工作区活动，不会被遮住。

• 底部应用坞：所有应用的唯一入口；点图标打开/收起窗口；最右边的房子按钮一键收好全部窗口，再点一次恢复。

• 点桌面收好：点击窗口外的空白桌面，也会把全部窗口收进应用坞（不销毁窗口，点图标可恢复）。

• 纯净窗口：没有最小化/最大化/关闭三件套；拖标题栏移动，拖右下角缩放。关闭当前窗口用 Esc、Ctrl/Cmd + Alt + W 或命令面板的「关闭当前窗口」。

• 新手导览：首次打开自动播放 6 步导览；可在「设置 → 快捷键 → 新手导览」重播。

• 数据备份：设置 → 数据与备份，导出/导入完整工作区 JSON。

• 三档配色：跟随 DSH（默认，随宿主的浅色/深色一起变）/ 浅色 / 深色。插件只读宿主的主题信号，不写宿主 DOM，和别的皮肤插件不冲突。

  

• 升级不丢数据：工作区带版本号与迁移阶梯，v1 → v2 自动升级；Host 在写盘前会把旧版本另存为 workspace.v1.backup.json，并在每次写入前留一份 workspace.prev.json。存储里的工作区若过不了校验，会只读打开并另存原稿，绝不拿示例桌面覆盖。

• 切换不丢状态：切到 DSH 其它界面再回来，窗口、以及每个应用正在看的东西（选中的纸页、日历停在哪天、便签滚到哪、画纸开哪张、设置哪个分区）都会复原。

安装

npm（推荐，一行包名）

DSH → Plugins → Add plugin，填：

dsh-plugin-control-your-schedule

也可以带版本：dsh-plugin-control-your-schedule@0.2.3。

GitHub（备选，不需要 npm 时）

https://github.com/HaoyanZhang123/dsh-plugin-control-your-schedule

本地开发

DSH → Plugins → Add plugin，填本目录的绝对路径：

<仓库路径>/dsh-plugin-control-your-schedule

Add plugin 对本地路径只接受绝对路径；相对路径会被拒绝。 已安装的插件不支持自动更新：升级 = 卸载后重装新版。

安装后左侧栏「插件 / 自动化任务」下面会出现「便签」。如果没有出现，刷新页面；替换已安装的包需要重启 DSH。

npm：https://www.npmjs.com/package/dsh-plugin-control-your-schedule

使用

想做什么	怎么做
打开应用	点底部应用坞的图标
收起 / 恢复窗口	再点一次应用坞图标
一次收好全部窗口	点房子按钮，或点窗口外的空白桌面
关闭当前窗口	Esc / Ctrl/Cmd + Alt + W / 命令面板「关闭当前窗口」
重看新手导览	设置 → 快捷键 → 新手导览 →「重新播放」
备份数据	设置 → 数据与备份 →「导出工作区」

数据存在哪里

• DSH 数据目录（主存储）：$DSH_HOME/control-your-schedule/workspace.json
  • Windows 默认：C:\Users\<你>\.dsh\control-your-schedule\workspace.json
  • 如果设置了 DSH_HOME，以该目录为准。
• 浏览器缓存（备用）：IndexedDB / localStorage，用于页面快速启动。
• 换设备时在设置里导出 JSON，再导入即可。

兼容性

• 开发依据：DSH 0.2.1-rc.2。
• 已在 Windows 11 + DSH 0.2.1-rc.2 实测：安装、侧栏、面板、刷新/切换后数据保持、宿主落盘、导出/导入路径。
• CI 在 Windows / macOS / Ubuntu 三个 runner 上执行构建、页面契约、DOM 嵌套、宿主路由与客户端语法检查。
• 未在 macOS / Linux 真机 DSH 上实测：快捷键标签会自动使用 ⌘/⌥；数据路径使用 DSH_HOME 或 ~/.dsh；没有平台专属二进制。发现问题请提 issue。
• 页面为中文界面；插件列表中的英文名称为 “Sticky”。

开发

# 构建 client.js（把 assets/paper-os.html 内嵌进客户端包）
python tools/build_page.py

# 校验产物是否与源码一致（CI 用）
python tools/build_page.py --check

# 项目门禁（页面契约 + DOM 嵌套 + 构建 + 迁移 + 宿主路由持久化）
python smoke/run_all_checks.py

# 连真机浏览器一起跑（需要本机有 Edge/Chrome；不加 --cdp 时该套件只算 SKIP，不算通过）
python smoke/run_all_checks.py --cdp

# 单独跑迁移与真机页面检查
node smoke/migrate_test.mjs
node smoke/page_e2e.mjs

路径	作用
index.js	Host 半边：/api/control-your-schedule/workspace 读写 DSH 数据目录
src/client.src.js	Client 半边：侧栏入口、主面板、iframe 桥接
assets/paper-os.html	纸屿页面（唯一 UI 源）
client.js	构建产物，禁止手改
tools/build_page.py	构建脚本
smoke/run_all_checks.py	项目门禁
smoke/host_route_test.mjs	Host 持久化路由 + 升级备份 + 字体路由测试
smoke/migrate_test.mjs	迁移门禁：v1 快照升 v2 后逐字段比对，含反向用例
smoke/page_e2e.mjs	真机页面检查（无头浏览器，25 项断言）
assets/fonts/	内置手写体子集（霞鹜文楷，OFL）与来源/许可

设计取舍

• UI 不重写成 React：原页面用同源 iframe 隔离挂载，窗口拖拽、自动保存与键盘交互保持原样。
• 数据双写：页面先写浏览器存储保证即时可用，再通过 postMessage → Host 路由落盘到 DSH 数据目录；重开时选择较新的快照。
• 单一加载闸门：Host 快照 / IndexedDB / localStorage / 恢复日志 / 导入文件全部先过 ingestWorkspace（迁移阶梯 + 当前版本严格校验），不存在第二条版本比较。
• 持久待办用「模板 + 读时投影」，不物化每日实例：跨天只重绘、零写盘，计数天然「只算一个」。
• 主题只读不写：读宿主 body[data-ds-dark-theme]，读不到再退回 prefers-color-scheme。
• 无第三方运行时依赖；Host 只用 Node 内置模块，构建只用 Python 标准库。字体子集化脚本额外需要 fonttools（仅开发期，产物已入库）。

更新日志与许可

• CHANGELOG.md
• Releases
• MIT