A local-first DSH time desk for projects, habits, lunar schedules, focus timers and a scoped AI assistant.
Install
# from a prebuilt release tarball
dsh plugin --profile web add "https://github.com/yubudong/dsh-time-desk/releases/download/v0.6.0/dsh-time-desk-0.6.0.tgz"
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:yubudong/dsh-time-desk
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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 的专有素材。
Links
More in this category
loopx-project/loopx#dsh-loopx-plugin★ 6694
LoopX, a provider-neutral, local-first state kernel and control plane for long-horizon agents: keeps Goal, Todo, gate, evidence, quota, recovery, and handoff state above DeepSeek Harness, while the plugin bootstraps the CLI and skills, admits bounded same-session continuation, and adds a loopback GoalBar for the exact bound loop.
Q00/ouroboros#integrations/dsh-plugin★ 6373
Config-only bundle that mounts Ouroboros through the DSH MCP client, exposing 36 interview, Seed, execution, evaluation, and evolution workflow tools in DSH.
chuspeeism/dashi-taskboard#deepseek-harness★ 3495
Embeds the active installed Codex Taskboard runtime in the DeepSeek Harness sidebar, using its launcher runtime descriptor instead of a fixed port.
NanmiCoder/dsh-agent-teams★ 2978
AgentTeams multi-agent teams.
EthanYoQ/AI-Novel-Writer#dsh-ai-novel-writer★ 2670
Installs a dedicated AI novel-writing preset and workbench: revisioned local project assets, a compact side drawer, and native approval-gated single-file changes.
shanliuling/dsh-image-gen★ 1576
Native conversational image generation for DeepSeek Harness: ask the agent to create an image, and it handles generation and keeps the result directly in the conversation.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.