Zum Hauptinhalt springen
Y

dsh-time-desk

yubudong/dsh-time-desk

A local-first DSH time desk for tasks, rest-aware habits, courses and credit ledgers, with focus timers and a general personal assistant.

Installation

dsh plugin --profile web add github:yubudong/dsh-time-desk

README

时间工作台 · Time Desk

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

包名:dsh-time-desk · 版本:0.13.0 · MIT

时间精灵

功能

  • 快速收集与整理:统一使用左侧「快速记录」,折叠侧栏/窄屏显示加号;工作台内 ⌘/Ctrl+Shift+K 打开同一面板。全局记录默认进入收件箱,不自动继承当前项目;可展开补项目、领域、安排日、截止日和估时,或携带草稿进入「详细编辑」设置重复、提醒和子步骤。保存后可继续记录;Esc 收起保留本次页面草稿。项目和日历局部新增保留所在上下文。收件箱支持轻量归类;已归类但没有日期的事项仍保留入口。
  • 今日事项:重点、定时安排、计划待办、延续待选和已完成分别展示。原安排在当天的事项直接进入当日列表;过去未完成任务留在延续待选,主动加入所选日期后才出现在该日待办中,不改原安排日或截止日。首页不再展示时间预算统计卡,也无需填写每日可用分钟。
  • 项目与任务:项目进度、子步骤、预计番茄数、当天重点、截止提醒。过往定时任务作为续办显示,不伪造成当天的新预约;明确改期到未来的任务尊重改期。取消重点仅清除重点标记。
  • 课程与课时:按上课人管理固定周课和单次课,支持只调这一节、恢复原安排、请假和临时加课;调课会同步首页、周课表和日历,并跟随新时间提醒。课时包按充值、赠送、首次余额和上课流水计算余额,确认上课后才扣课时,撤销会返还;包年课程以有效期控制排课,到期停止新增但保留本期实际上课次数和课时统计,续期新增周期而不覆盖旧账。首页显示今日课程、剩余课时或年卡剩余天数;低余额与到期提醒可关闭。
  • 课程可靠性与草稿:修改已有排期需选择今天或以后的生效日并确认,过去规则与已有单次记录保留;课程详情可按日期、状态或年卡周期查阅和补记,未来日期不能提前确认上课。系统扣减与返还对应到同一笔流水,不能直接删除;请假默认免费,机构收费时可明确记录。课程表单草稿保存在本机浏览器,正式保存才写入账目;草稿不在工作台 JSON 备份中。旧版已经写错的历史流水不会被擅自重算,应核对后用带原因的调整记录更正。
  • 首页自定义:今日课程、重点、定时安排、计划待办、延续待办、待办截止、已完成、收集箱、专注、习惯、本周习惯目标、未来7天安排都可在「自定义首页」里隐藏、排序、折叠,偏好随数据保存。隐藏只影响首页展示,不删除记录,也不改变日期或完成状态。
  • 习惯:不按时间分组,列表平铺便于连续打卡;支持打卡、数量累加、时间目标(如阅读 30 分钟,可分多次累加分钟)和每周次数目标,另有安排今天、跳过剩余和记录未达成。时间目标需要手动记录分钟,不会自动从专注计时累加,也不能靠日复盘自动完成。添加时可选阅读、运动、早睡、每日复盘、每周复盘模板,也可自定义;模板只预填表单,确认保存后才创建,不自动设置提醒。
  • 周目标与休息间隔:每周次数按不同日期计算,周一至周日为一周;可设完成后休息0–6个自然日,跨周延续。模块根据实际打卡、有效规则、跳过日期和已有计划计算最多可安排次数与建议日期,余量刚好或不足时显示温和提示;可关闭建议,不自动发送通知。安排不计为完成,不自动降低目标或顺延欠次数;休息日不自动标记未达成。实际连续完成或补记与间隔冲突时,明确确认后仍可如实记录。新规则从所选生效日起使用,不重写旧规则。
  • 日历与重复:每日、每周、每月、每年、自定义间隔、完成后间隔;支持农历年度事件、闰月策略和月份缺日处理。单次改期与整组规则分开。
  • 专注计时:关联任务或自由专注;单次/默认时长独立;暂停不累计有效专注。完整保存后计一个番茄,提前结束只记录时间,不自动完成任务。
  • 顶部番茄钟与主题:与时间精灵同风格的静态小番茄、等宽数字时间与操作横向排列;点番茄看状态、任务与所选表盘详情,更多菜单保留完整控制。窄栏整组移到工具栏第二行,结束/休息等次要操作仍可在更多菜单找到。「主题」标签说明当前配色,悬停提示切换不影响任务和计时。
  • 四种表盘:极简数字、经典圆盘、翻页时钟、沙漏;黑色全屏可切换普通时钟。退出全屏不改变计时,屏幕唤醒和系统全屏取决于客户端支持。
  • 复盘与个人模板:关联日复盘的习惯进入内容编辑器,与「回顾」页面共用笔记;自己建立一份默认日复盘问题,尚未建立时用内置三个问题,也可自由书写。模板与当天回答分别保存,空白或只有模板问题不能完成复盘。切换日期保留本次页面草稿;刷新前需保存。可以主动请时间精灵根据所选日期和个人模板逐个提问、整理候选草稿,确认保存后才落库和完成习惯。
  • 次日完成窗口:规则可选「允许次日完成」,按工作台时区到次日全天结束仍算按时;超过后完成记为补做,没有记录不自动判未达成。今天只额外带出昨天待完成,不无限累积;首次完成时间与最后编辑时间分开,修改规则从生效日开始、不改旧规则。
  • 回顾与备份:每日/每周笔记、专注记录、JSON 导出恢复、回收站;恢复前保存副本。个人默认复盘模板随主数据备份,助手对话与助手候选草稿不在工作台备份中。
  • 时间精灵:独立 DSH Agent 对话、模型选择和操作回执;可讨论一般知识、分析方案及提供建议,普通对话不额外限制为仅工作台工具,实际工具与权限由 DSH 当前环境决定。专用辅助复盘仍只提交候选草稿,保存由用户确认。图标为薄荷绿精灵轻动画,支持减少动态效果时显示静态图。
  • 可调面板宽度:拖动副工作台或时间精灵左侧分界线调整宽度,支持方向键微调、双击或回车恢复默认;宽度保存在当前浏览器。窗口变窄时自动限制宽度,副工作台按可用正文空间移到下方,精灵使用可调宽的浮动侧栏。

兼容与安装

需要 DeepSeek Harness 0.2.2-rc.2 或更高的 0.2.x 版本。兼容声明为 >=0.2.2-rc.2 <0.3.0;后续 DSH 主版本需重新核对 API。

插件无原生运行时依赖。分发包包含预构建 Host/Client 文件,不要求安装者运行 npm 或编译。

  1. 下载发行的 source zip 并解压。
  2. 在 DSH 插件管理器中安装包含本 README 与 package.json 的 dsh-time-desk 目录。
  3. 按管理器返回的结果操作;如提示重启,请重启。
  4. 从侧栏打开「时间工作台」。首次安装是空白工作台,自己添加任务和习惯。

仓库发布后也可使用固定 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 备份。旧版本不一定能读取新格式,避免降级覆盖数据。

快速使用

  1. 用快速记录收集待办,日期可以留空;需要安排时再选择日期和时间。
  2. 新建项目并关联任务;编辑任务可填写预计番茄数,0 表示不估算。
  3. 数量型习惯允许分次记录;每周次数目标按不同日期计算,只有主动安排后才进入当天执行区。
  4. 点击任务旁的计时器,或在专注区选择任务;点击「专注时长/下一轮」设置仅本次时长或默认时长。
  5. 一次性尚未开始的时长选择只存在当前客户端,刷新后恢复默认;开始后该轮时长持久保存。修改默认值不影响当前计时。
  6. 点击「全屏专注」查看大表盘;普通时钟显示工作台时区当前时间,不产生专注记录。Esc 退出。
  7. 在「回顾」保存日/周笔记,在「设置与备份」导出自己的 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/lesson-actions.js 为课程写入与账目校验,src/lessons.js 为排期、余额与提醒,src/schema.js 为数据格式,src/dates.js 为日期规则,src/host.js 注册服务和工具,src/client.tsx 与 src/LessonsUI.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 的专有素材。

Ähnliche Plugins