Skip to content
dsh marketplace

dsh-plugin-control-your-schedule

Verified

dsh-plugin-control-your-schedule · v0.3.0 · MIT · Web UI

Paper-style sticky notes, paper notes, calendar, drawing and a reusable prompt library inside DSH

Install

dsh plugin add dsh-plugin-control-your-schedule

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

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

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

ci release

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

功能

  • 便签：短句速记，自动保存；整张纸都能拖着走（正文、滚动条、色块、删除键除外），最后碰过的那张永远在最上面。正文默认使用内置霞鹜文楷手写体，可在设置里换成系统行楷或纸张宋体。
便签
  • 废纸篓：删掉的便签不弹「撤销」提示，而是进便签窗口顶部的废纸篓，留 7 天，随时放回去；空便签直接丢弃。
  • 纸页笔记：长文写作，左侧列表搜索/切换，自动保存。新纸页的标题像正文一样是 placeholder，不写字不会留下一行「未命名纸页」。
纸页笔记
  • 日历与待办：每件事有四档紧急程度（重要且紧急 / 重要但不紧急 / 紧急但不重要 / 不紧急也不重要），在待办行右侧就地切换：点色点弹出四档选择（选中即生效），点旁边的胶囊在「仅今日 / 每天」之间切换，都不用进详情。
  • 日历圆点：未完成的点在上、按档位着色；完成的点沉到格子底部并变灰，位置固定不换位。
  • 持久待办：选「每天」后，从锚定日起每天出现一条当前实例，今天打卡后第二天自动长出一条未完成的新实例；日历上只留真正打过卡的日子（灰点），未来不铺。勾完当天会出现「这件事算结束了」，收起后不再长新实例、随时可恢复，并显示「打卡 N 天」。
日历与待办
  • 提示词库：应用坞第 5 个应用。左列表搜索、置顶优先；右编辑器写标题与多行正文，自动保存。正文上限 20000 字，最多 300 条。新建/复制一条/置顶/删除，删除有确认。
  • 对话里随取随用：每个对话输入框工具行左侧有一个「提示词」小按钮，点开上方弹出列表，↑↓ 选择、Enter 填入、Esc 关闭。只填进草稿：草稿为空时整段填入，非空时插到光标处（单步可撤销），输入框正在发送会提示稍后再试。不写系统提示词、不自动发送。点「在便签里管理 ↗」会切到纸屿并打开提示词窗口。
提示词 - **安静的界面**：不弹浮层提示；没有信息的状态行不占位。 - **画纸**：手写/绘画，支持撤销、橡皮、导出 PNG；画纸簿可左右翻页，也能整张删掉。 画纸 - **固定右侧栏**：今日纸签始终在右侧，窗口只在左侧工作区活动，不会被遮住。 - **底部应用坞**：所有应用的唯一入口；点图标打开/收起窗口；最右边的房子按钮一键收好全部窗口，再点一次恢复。 - **点桌面收好**：点击窗口外的空白桌面，也会把全部窗口收进应用坞（不销毁窗口，点图标可恢复）。 - **纯净窗口**：没有最小化/最大化/关闭三件套；拖标题栏移动，拖右下角缩放。关闭当前窗口用 `Esc`、`Ctrl/Cmd + Alt + W` 或命令面板的「关闭当前窗口」。 - **新手导览**：首次打开自动播放 6 步导览；可在「设置 → 快捷键 → 新手导览」重播。 - **数据备份**：设置 → 数据与备份，导出/导入完整工作区 JSON。 - **三档配色**：跟随 DSH（默认，随宿主的浅色/深色一起变）/ 浅色 / 深色。插件只读宿主的主题信号，不写宿主 DOM，和别的皮肤插件不冲突。 深色档 - **升级不丢数据**：工作区带版本号与迁移阶梯，v1 → v2 → v3 自动升级（v3 新增提示词库，只做加法）；Host 在写盘前会把旧版本另存为 `workspace.v<旧版本>.backup.json`，并在每次写入前留一份 `workspace.prev.json`。存储里的工作区若过不了校验，会**只读打开**并另存原稿，绝不拿示例桌面覆盖。 - **切换不丢状态**：切到 DSH 其它界面再回来，窗口、以及每个应用正在看的东西（选中的纸页、日历停在哪天、便签滚到哪、画纸开哪张、设置哪个分区）都会复原。

安装

npm（推荐，一行包名）

DSH → Plugins → Add plugin，填：

dsh-plugin-control-your-schedule

也可以带版本：[email protected]。

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（仅开发期，产物已入库）。

更新日志与许可