DSH 原生时间工作台,管理项目、习惯、农历日程与专注计时,内置时间精灵助手。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/yubudong/dsh-time-desk/releases/download/v0.6.0/dsh-time-desk-0.6.0.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:yubudong/dsh-time-desk
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH 原生个人时间工作台:在侧栏管理项目、待办、习惯、公历/农历重复安排、日历、番茄钟和复盘。内置「时间精灵 · Time Spirit」,通过自然语言操作同一份工作台数据。
包名:dsh-time-desk · 版本:0.6.0 · MIT

功能
- 项目与任务:项目进度、子步骤、预计番茄数、当天重点、截止提醒;普通任务到达安排日后,未完成就持续出现在后续日期的当天待办,保留原日期。过往定时任务作为续办显示,不伪造成当天的新预约。没有安排日期的事项留在收集箱,明确改期到未来的任务尊重改期。
- 习惯:打卡、数量累加、每周次数目标;按早晨/不限/晚上分组,支持安排今天、跳过剩余和记录未达成。
- 日历与重复:每日、每周、每月、每年、自定义间隔、完成后间隔;支持农历年度事件、闰月策略和月份缺日处理。单次改期与整组规则分开。
- 专注计时:关联任务或自由专注;单次/默认时长独立;暂停不累计有效专注。完整保存后计一个番茄,提前结束只记录时间,不自动完成任务。
- 四种表盘:极简数字、经典圆盘、翻页时钟、沙漏;黑色全屏可切换普通时钟。退出全屏不改变计时,屏幕唤醒和系统全屏取决于客户端支持。
- 回顾与备份:每日/每周笔记、专注记录、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 的专有素材。
链接
同类插件
loopx-project/loopx#dsh-loopx-plugin★ 6694
LoopX——面向长周期 Agent 的提供商中立、本地优先状态内核与控制平面:在 DeepSeek Harness 执行层之上持久化 Goal、Todo、门禁、证据、配额、恢复与交接状态;插件负责引导安装 CLI 与技能、准入有界的同会话续跑,并为精确绑定的工作循环提供本地 GoalBar。
Q00/ouroboros#integrations/dsh-plugin★ 6373
通过 DSH MCP 客户端挂载 Ouroboros 的纯配置包,在 DSH 中提供 36 个涵盖需求访谈、Seed、执行、评估与演化流程的工具。
chuspeeism/dashi-taskboard#deepseek-harness★ 3495
把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述文件连接,而不是使用固定端口。
NanmiCoder/dsh-agent-teams★ 2978
AgentTeams 多智能体团队。
EthanYoQ/AI-Novel-Writer#dsh-ai-novel-writer★ 2670
安装专用 AI 小说创作预设与工作台:提供带修订号的本地项目资产、紧凑侧边工作台,以及需要原生审批的逐文件变更。
shanliuling/dsh-image-gen★ 1576
为 DeepSeek Harness 提供原生对话生图能力:直接让 Agent 画图,插件自动完成生成并把结果保留在当前会话中。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。