时间工作台 · Time Desk
DSH 原生个人时间工作台:在侧栏管理项目、待办、习惯、公历/农历重复安排、日历、番茄钟和复盘。内置「时间精灵 · Time Spirit」,通过自然语言操作同一份工作台数据。
包名:dsh-time-desk · 版本:0.9.5 · MIT

功能
- 快速收集与整理:统一使用左侧「快速记录」,折叠侧栏/窄屏显示加号;工作台内
⌘/Ctrl+Shift+K打开同一面板。全局记录默认进入收件箱,不自动继承当前项目;可展开补项目、领域、安排日、截止日和估时,或携带草稿进入「详细编辑」设置重复、提醒和子步骤。保存后可继续记录;Esc 收起保留本次页面草稿。项目和日历局部新增保留所在上下文。收件箱支持轻量归类;已归类但没有日期的事项仍保留入口。 - 今日计划:重点、定时安排、计划待办、延续待选和已完成分别展示。原安排在当天的事项自动计入计划,过去未完成任务留在延续待选,手动加入当日计划不会改原日期或截止日。可设置这一天的可用分钟,展示已估算负荷、未估时数与已记录专注;预计分钟优先,否则按预计番茄数 × 默认专注时长,未估时不当作零分钟。
- 项目与任务:项目进度、子步骤、预计番茄数、当天重点、截止提醒。过往定时任务作为续办显示,不伪造成当天的新预约;明确改期到未来的任务尊重改期。取消重点仅清除重点标记。
- 课程与课时:按上课人管理固定周课和单次课,支持只调这一节、恢复原安排、请假和临时加课;调课会同步首页、周课表和日历,并跟随新时间提醒。课时包按充值、赠送、首次余额和上课流水计算余额,确认上课后才扣课时,撤销会返还;包年课程以有效期控制排课,到期停止新增但保留本期实际上课次数和课时统计,续期新增周期而不覆盖旧账。首页显示今日课程、剩余课时或年卡剩余天数;低余额与到期提醒可关闭。
- 首页自定义:今日计划、今日课程、重点、定时安排、计划待办、延续待办、待办截止、已完成、收集箱、专注、习惯、本周习惯目标、未来安排都可在「自定义首页」里隐藏、排序、折叠,偏好随数据保存。隐藏只影响首页展示,不删除记录,也不改变负荷计算。
- 习惯:不按时间分组,列表平铺便于连续打卡;支持打卡、数量累加、时间目标(如阅读 30 分钟,可分多次累加分钟)和每周次数目标,另有安排今天、跳过剩余和记录未达成。时间目标需要手动记录分钟,不会自动从专注计时累加,也不能靠日复盘自动完成。添加时可选阅读、运动、早睡、每日复盘、每周复盘模板,也可自定义;模板只预填表单,确认保存后才创建,不自动设置提醒。
- 日历与重复:每日、每周、每月、每年、自定义间隔、完成后间隔;支持农历年度事件、闰月策略和月份缺日处理。单次改期与整组规则分开。
- 专注计时:关联任务或自由专注;单次/默认时长独立;暂停不累计有效专注。完整保存后计一个番茄,提前结束只记录时间,不自动完成任务。
- 四种表盘:极简数字、经典圆盘、翻页时钟、沙漏;黑色全屏可切换普通时钟。退出全屏不改变计时,屏幕唤醒和系统全屏取决于客户端支持。
- 复盘与个人模板:关联日复盘的习惯进入内容编辑器,与「回顾」页面共用笔记;自己建立一份默认日复盘问题,尚未建立时用内置三个问题,也可自由书写。模板与当天回答分别保存,空白或只有模板问题不能完成复盘。切换日期保留本次页面草稿;刷新前需保存。可以主动请时间精灵根据所选日期和个人模板逐个提问、整理候选草稿,确认保存后才落库和完成习惯。
- 次日完成窗口:规则可选「允许次日完成」,按工作台时区到次日全天结束仍算按时;超过后完成记为补做,没有记录不自动判未达成。今天只额外带出昨天待完成,不无限累积;首次完成时间与最后编辑时间分开,修改规则从生效日开始、不改旧规则。
- 回顾与备份:每日/每周笔记、专注记录、JSON 导出恢复、回收站;恢复前保存副本。个人默认复盘模板随主数据备份,助手对话与助手候选草稿不在工作台备份中。
- 时间精灵:独立 DSH Agent 对话、模型选择、操作回执;只开放工作台业务工具。图标为薄荷绿精灵轻动画,支持减少动态效果时显示静态图。
兼容与安装
需要 DeepSeek Harness 0.2.2-rc.2 或更高的 0.2.x 版本。兼容声明为 >=0.2.2-rc.2 <0.3.0;后续 DSH 主版本需重新核对 API。
插件无原生运行时依赖。分发包包含预构建 Host/Client 文件,不要求安装者运行 npm 或编译。
- 下载发行的 source zip 并解压。
- 在 DSH 插件管理器中安装包含本 README 与
package.json的dsh-time-desk目录。 - 按管理器返回的结果操作;如提示重启,请重启。
- 从侧栏打开「时间工作台」。首次安装是空白工作台,自己添加任务和习惯。
仓库发布后也可使用固定 Git Commit 安装。安装地址应指向实际公开的完整 40 位 Commit,不能把尚未发布的版本当成可下载版本。
当前在 macOS DSH Desktop 上开发;Windows 实机、系统通知和不同客户端的原生全屏仍需实际交互验收。CI 定义了 macOS/Windows/Linux 与 Node 22/24 的构建检查,配置存在不代表已在远端运行。
从 dsh-life-desk 升级
0.5.0 将发布包更名为 dsh-time-desk,产品名保持「时间工作台」,AI 助手保持「时间精灵」。
- 在同一个 DSH Profile 中移除旧的
dsh-life-desk包注册,再安装dsh-time-desk。不要同时启用两个包。 - 主存储单元仍为
life_desk_v1,助手指针仍为life_desk_spirit。移除包注册不等于删除独立存储;不要手动清空 Profile 或存储。 - 保留内部
life-desk面板/入口 ID、life_desk工具名与既有路由,保证现有调用和会话衔接。 - 新导出的备份格式名为
dsh-time-desk,仍接受旧dsh-life-desk备份。旧版本不一定能读取新格式,避免降级覆盖数据。
快速使用
- 用快速记录收集待办,日期可以留空;需要安排时再选择日期和时间。
- 新建项目并关联任务;编辑任务可填写预计番茄数,0 表示不估算。
- 数量型习惯允许分次记录;每周次数目标按不同日期计算,只有主动安排后才进入当天执行区。
- 点击任务旁的计时器,或在专注区选择任务;点击「专注时长/下一轮」设置仅本次时长或默认时长。
- 一次性尚未开始的时长选择只存在当前客户端,刷新后恢复默认;开始后该轮时长持久保存。修改默认值不影响当前计时。
- 点击「全屏专注」查看大表盘;普通时钟显示工作台时区当前时间,不产生专注记录。Esc 退出。
- 在「回顾」保存日/周笔记,在「设置与备份」导出自己的 JSON。
计时按持久化时间戳恢复,长时间离开或电脑休眠后应核对有效专注秒数。每轮需主动开始和确认,不会离线自动累计多轮。显示亮度只调整表盘,不改变系统屏幕亮度。
用自然语言管理
可在 DSH 对话中使用 life_desk,或打开右上角「时间精灵」:
- “建一个阅读项目,先列三条不设日期的待办。”
- “设置每周三次的运动习惯,不固定星期。”
- “为这个任务开始一轮 15 分钟专注,只用于本轮。”
- “把表盘改成沙漏,不改变当前计时。”
工具首次调用 help 获取字段说明,修改前 read 获取 revision 与记录 ID。明确的新增或打卡可以直接执行;批量调整、整组重复事项修改和覆盖恢复需要先确认范围。
时间精灵使用你在 DSH 配置的模型和凭据,产生所选模型的正常用量。手动操作不需要模型请求。关闭助手侧栏不会回滚已完成的修改。
隐私与数据
代码仓库和发行包不包含开发者的任务、习惯、账期、打卡、专注记录、备份、对话或模型密钥。
工作台数据通过 DSH 存储后端写入当前 Profile,独立于插件安装目录。时间精灵聊天保存在独立 DSH Session 中;工作台 JSON 备份不包含该聊天历史。
本项目没有独立账号、云同步或遥测服务。调用时间精灵时,用户输入及工具读取的相关内容会进入所选模型的对话上下文;是否发送到远端由 DSH 的模型配置决定。
自己的 JSON 备份和工作台截图可能包含个人信息,不应提交到仓库或 Issue。详见 PRIVACY.md。
开发
npm ci --ignore-scripts --no-audit --no-fund
npm run privacy
npm run check
npm run build
npm test
npm pack
核心源码:src/model.js 为业务和事务,src/schema.js 为验证,src/dates.js 为日期规则,src/host.js 注册服务和工具,src/client.tsx 为界面,src/TimerUI.tsx 为计时与全屏。
构建会把运行依赖与图片打包进 dist,React 使用 DSH 提供的版本。无安装生命周期脚本,不在安装时运行构建。源码提交前运行隐私检查;具体发布与市场投稿步骤见 PUBLISHING.md。
版本与更新
「设置与备份 → 版本与更新」显示当前版本、安装方式与上次检查时间,并可手动检查稳定版更新。自动检查默认关闭;开启后最多每天检查一次,只读取项目 GitHub 上的公开发布信息,不上传任务或聊天内容。
发现新版时可查看更新说明、打开 DSH 插件管理或忽略该版本。「准备升级」会先检查运行中的计时、未保存编辑、助手请求和保存状态;条件满足时保存升级前快照(最多 3 份)再打开插件管理器。安装后可回到工作台核对版本,必要时用快照恢复数据。工作台不下载、不安装、不覆盖插件文件;升级始终由 DSH 插件管理器执行。本地开发目录安装会被明确标出,不会从这里自动更新。无法读取当前 DSH 版本时,界面会说明兼容性无法确认,而不是显示为可安全升级。
自动发版
维护者更新包版本、填写 changes/版本号.md 并提交预构建文件后,推送 v版本号 标签即可触发隐私与跨平台检查、归档校验和草稿到公开 Release 的流程。测试版标为 Pre-release,不替换稳定版;公开版本禁止自动覆盖。
市场同步独立运行:未配置跨仓库授权时生成可下载的投稿材料;配置专用授权后可更新已有目录 PR,DSH STORE 继续使用其扫描与审核流程。此功能不在用户设备上自动安装更新。操作与重试见 PUBLISHING.md。
限制
- 当前没有云同步、手机独立客户端、法定节假日调休或节气日程。
- 通知需要 DSH 运行、客户端连接和系统权限;后台节流、休眠与退出会影响提醒,不保证关闭后的实时通知。
- 农历事件按年重复;复杂规则应先用预览检查日期。
- 实际布局、原生全屏命中、动画小尺寸观感和平台行为,不能仅由源码测试证明。
许可
MIT。第三方依赖许可见 THIRD_PARTY_NOTICES.md。精灵图来自本项目经确认的 AI 辅助生成形象,随包提供透明静态与动画资源;未复制 Bear/Things 的专有素材。
No comments yet. Be the first to write one.