前言¶
在 DSH Web GUI 里做日常事务，常见做法是分散在多个页面或外部工具：待办在一处、文件在网盘、看板又是另一套入口。切换成本高，也缺少「今天做了什么、上周三做了什么」的可回顾明细。
下面介绍社区插件 dsh-life-workbench（仓库 meihaoyidian/life-workbench）。它把总览、看板、资料库和每日事项收进一个玻璃拟态面板，数据由 Host 侧持久化，适合在本地 DSH Web 环境里一页完成日常交互。
这是什么¶
dsh-life-workbench 是 DSH Web GUI 的个人工作台插件，维护者为 meihaoyidian，在 SkillHub 目录中归类为客户端插件。npm 包名为 dsh-life-workbench，当前版本 1.0.0，许可证 MIT。
插件定位：统计 + 执行 + 记录在同一视图完成，不必为「该进哪个入口」多跳页面。运行要求（来自 package.json）：Node >=20，DSH >=0.1.5-rc.1，Web 平台；客户端依赖 React ^18.2.0（peer，可选）。
核心功能¶
总览¶
总览页分几块，操作就地完成：
| 区段 | 内容 |
|---|---|
| 开头 | 问候 + 5 个 KPI（今日完成 / 今日待办 / 累计完成 / 近七天 / 资料） |
| 统计 | 完成趋势（点击任意柱子可回顾当天逐条明细）、看板进度 |
| 今日 | 今日执行、最近完成 |
| 记录 | 随手记、资料缩略图与上传 |
今日执行是统一列表：填写时间则按日程处理，不填则进入所选看板。日程按天归属，跨天后不再出现在「今日」里。
看板¶
- 多列看板，可自定义增删看板与事项。
- 事项：双击改名、勾选完成、删除。
- 附件：点回形针上传，文件归属该事项；删除事项时附件退回总库，不会随事项一起消失。
资料¶
上传文件与图片的总库，可标注归属、预览放大。单次上传上限 8 MB。
每日事项¶
跨天时先把当天逐条明细（标题 + 完成状态）写入 history，再重置勾选；明细保留 90 天。因此可以回顾「上周三做了什么」，而不只是累计计数。
安装与启用¶
官方安装命令如下（须使用 --profile web）：
dsh plugin --profile web add dsh-life-workbench
装完后重启 dsh host 并刷新浏览器，侧边栏会出现「工作台」图标。
从 npm 安装时，bundle patch 会进入 roster，一般无需额外配置。若用 link: 本地开发，包内自带的 bundle patch 可能不会被 dsh 收集，需在 profile 用户层手动插入（详见仓库 README「两个已知的实现约束」）。
典型用法¶
- 打开侧边栏「工作台」，在总览查看 KPI 与今日执行列表。
- 在今日执行里添加事项：需要提醒则填时间（日程）；否则选目标看板，事项直接进入看板列。
- 切换到看板视图，双击改名、勾选完成；需要凭证时点回形针挂附件。
- 在资料区上传文件或图片；在总览「记录」区也可快速上传。
- 在统计区点击趋势图某天的柱子，查看该日完成明细；每日事项跨天归档后，可在 history 范围内回顾历史天。
数据与 Host 通过同源 HTTP 交互，正式插件无动态 host.call，主要端点为：
| 端点 | 作用 |
|---|---|
POST /life-workbench/load |
读取状态（含每日归档与跨天重置） |
POST /life-workbench/save |
写入状态（history 以磁盘为准合并） |
POST /life-workbench/upload |
落盘一个 base64 文件 |
POST /life-workbench/readFile |
读回某个文件的 base64 |
数据存放¶
状态与上传文件位于 $DSH_HOME/life-workbench/（未设置 DSH_HOME 时为 ~/.dsh/life-workbench/）：
state.json 工作台状态（看板 / 事项 / 便签 / 日程 / 归档）
blob-<id>.b64 上传的文件与图片
写入采用「临时文件 + rename」的原子替换。从资料库移除条目不会删除磁盘上的 blob 文件。
适用场景与注意¶
适合谁：已在用 DSH Web GUI、希望把待办、看板、随手记和本地资料收在一个面板里的开发者或个人用户。
生态说明：DSH 主张「一切皆插件」；SkillHub 目录页 是社区站点，与 DeepSeek / 幻方无官方从属关系。
安全与权限：插件在当前 dsh host 进程权限下读写本地目录并提供 HTTP 端点。安装前建议阅读 GitHub 源码 与 MIT 许可证，确认符合你的环境与合规要求。
开发侧：纯 ESM JavaScript，零构建；改 lib/*.js 后重启 dsh host 即可。Client 的 factory 必须 return module.exports，否则浏览器可能报 invalid plugin ... received undefined。
结尾¶
dsh-life-workbench 把总览、看板、资料与带归档的每日事项放在同一 Web 面板，Host 负责持久化与跨天逻辑，适合作为 DSH 下的轻量个人工作台。
