DSH 工作清单

一个本地优先、支持富文本编辑的 DSH Web 侧边栏工作清单插件。

当前版本：0.1.2

🆕 v0.1.2 更新

相比 v0.1.1：

• 去掉新增事项输入框左侧多余的 ＋ 图标，界面更简洁。
• 富文本工具栏改为吸顶显示，长清单向下滚动时仍可直接使用编辑功能。
• 字体、字号增减和字体样式选择并入富文本工具栏，滚动时也始终可用。

完整变更：https://github.com/liweidong1722/dsh-work-list/compare/v0.1.1...v0.1.2

🆕 v0.1.1 更新

相比 v0.1.0：

• 新增事项折叠 / 展开，默认只显示标题，点击正文即可直接编辑。
• 新增同分类拖拽排序，以及支持还原、永久删除和清空的回收站。
• 新增事项搜索、JSON 导入 / 导出，并让新增事项也支持完整富文本编辑。
• 优化全局富文本工具栏、分类新增 / 删除，以及导入导出和保存状态的布局。
• 修复编辑退出、完成事项操作等交互细节，减少误操作和界面干扰。

完整变更：https://github.com/liweidong1722/dsh-work-list/compare/0.1.0...v0.1.1

安装

推荐：通过 DSH 插件通道安装

dsh plugin --profile web add github:liweidong1722/dsh-work-list#v0.1.2

安装完成后重启 dsh web 并刷新页面，左侧会出现 「工作清单」。

安装最新版 main：

dsh plugin --profile web add github:liweidong1722/dsh-work-list#main

卸载：

dsh plugin --profile web remove dsh-work-list

DSH 的 plugin add 会调用 pnpm 完成依赖安装，并根据本包声明的 dsh.bundle.patch 自动把插件加入对应 profile 的 bundle 列表。

直接使用 pnpm 下载

包中已经包含构建好的 lib/，因此无需在安装机上重新编译：

pnpm add github:liweidong1722/dsh-work-list#v0.1.2

这种方式适合验证包内容或在其他工程中作为依赖使用。 如果是安装到 DSH profile，推荐使用上面的 dsh plugin --profile ... add， 因为它还会负责 bundle 的自动激活。

功能

• DSH Web 左侧栏直接提供「工作清单」。
• 内置「日常 / 工作 / 学习 / 生活」分类，也支持自定义分类。
• 支持勾选完成、待完成 / 已完成筛选、回收站还原与永久删除。
• 每条事项都可以继续作为轻量富文本笔记编辑。
• 支持正文、标题 1 / 2 / 3、加粗、斜体、下划线、删除线和文字颜色。
• 支持编号列表、项目符号、多级缩进和虚线分隔。
• 标题使用醒目的黄色，正文跟随 DSH 当前明暗主题。
• 支持多行输入，Ctrl+Enter 保存。
• 支持 Ctrl+Z 撤销，Ctrl+Shift+Z / Ctrl+Y 重做。
• 点击编辑器外部会自动保存并退出编辑。
• 支持字号和字体样式调整。
• 优先使用 DSH 的 --dsw-alias-* 主题变量，并实时跟随明暗主题。

数据存储

数据由 DSH host 保存到：

~/.dsh/work-list.json

文件是普通 JSON，可以直接备份、迁移和恢复。

插件带 revision 冲突保护：如果文件在页面外被重新导入或修改， 旧页面不能再用过期状态把新数据覆盖掉。

旧版浏览器 localStorage 数据会在首次升级时尝试迁移到该文件。

开发

要求：

• Node.js 22.19+ 或 24+
• pnpm

pnpm install
pnpm check

常用命令：

pnpm typecheck
pnpm test
pnpm build

pnpm build 生成：

lib/index.js
lib/client.js

lib/ 会随版本一起提交和发布，使 GitHub/pnpm 安装无需在目标机器上重新构建。

项目结构

src/
├── index.ts                 # DSH host RPC 与文件持久化
└── client/
    ├── index.tsx            # DSH 侧边栏 / 主面板注册
    ├── WorkListPanel.tsx    # 主界面与交互
    ├── model.mjs            # 清单数据模型
    ├── model.d.mts          # 模型类型声明
    ├── rpc.ts               # 浏览器与 host RPC
    ├── richText.ts          # 富文本清洗与转换
    ├── styles.ts            # 页面样式
    └── theme.ts             # DSH 明暗主题检测
test/
└── model.test.mjs
lib/
├── index.js
└── client.js

License

MIT License