dsh-pomodoro

DSH PLUGIN会话与消息

仓库 atticuswx/dsh-pomodoro · npm dsh-pomodoro

会话与消息 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness Web 界面提供常驻悬浮番茄时钟,无需打开会话即可计时,支持阶段切换、提示音与通知。

一句话选型结论

按资料字段整理

dsh-pomodoro 是会话与消息类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-04 创建于 2026-11-03
README 6.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:atticuswx/dsh-pomodoro#v0.3.1
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-pomodoro可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-pomodoro:DeepSeek Harness 里不依赖会话的番茄计时悬浮窗

  • 常驻悬浮窗,无需会话
  • 专注/休息阶段与轮次圆点
  • 跳过、重置与可调时长
  • 阶段结束提示音与通知
  • 位置与状态本地记忆

适用场景

通知联网搜索

上游标签

deepseek-harnessdshdsh-pluginpomodoroproductivitytimerweb-ui

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-pomodoro当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方atticuswx仓库 dsh-pomodoro · 默认分支 main
分类会话与消息desktop
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-03 · 2026-11-04最后推送 2026-11-04
本站收录2026-11-03首次进入本站目录的时间

README 全文

6.8 KB
作者原文,中文版优先;只做安全转义,不改内容

番茄时钟 · Pomodoro Timer

一个装在 DSH Web 界面里的番茄工作法倒计时。主界面是常驻悬浮窗:不依赖会话,
在设置页、空会话、任何面板上都一直可见。

> English — A Pomodoro timer for the DeepSeek Harness Web GUI. A draggable
> floating window stays visible without an open session, with an optional pill
> under the composer. One shared focus/break countdown with cycle dots, skip and
> reset, a chime plus a notification when a phase ends, and phase lengths you can
> change in the ⚙ panel. Everything is browser-local (localStorage), no server,
> no network calls.
>
> bash > dsh plugin --profile web add github:atticuswx/dsh-pomodoro >
>
> Reload the page and the pill appears in the bottom-right corner. Requires a DSH
> build with the Web client bundle support. MIT licensed.

长什么样

收起时是右下角一颗小胶囊,显示剩余时间:

╭─────────╮
│ ◔ 24:12 │
╰─────────╯

胶囊本身就能:单击展开、双击开始/暂停、直接拖动移动。

点一下展开为可拖动的悬浮卡片(⌄ 收回胶囊):

┌──────────────────────────┐
│ ⠿ 番茄时钟             ⌄ │   ← 按住标题栏拖动,⌄ 收起
│          ◔ 24:12         │   ← 进度环,专注红 / 休息绿;双击这里也可开始/暂停
│        专注  ● ● ○ ○     │
│ [ 开始 ]  ⏭  ↺  ⚙        │
└──────────────────────────┘
  • 进度环 + 时间:环随进度收拢;专注是番茄红,休息是绿色。
  • 阶段:专注 / 短休息 / 长休息;旁边圆点是本轮已完成的专注数(默认 4 轮后长休息)。
  • 开始 / 暂停:主按钮。
  • ⏭ 跳过:立即进入下一阶段(正在跑就继续跑,暂停中就停着)。
  • ↺ 重置:把当前阶段退回起点。
  • ⚙ 设置:展开偏好面板——专注/短休息/长休息分钟数、长休息前轮数、
    「自动开始下一阶段」「阶段结束时提示音」「结束提醒动效」「同时显示文字提示卡」
    「显示悬浮窗」「输入框下方也显示一条」,以及「试播动效」「重置本阶段」「恢复默认」。

位置、展开/收起状态都会记住(localStorage 的 dsh:pomodoro:window:v1),
并且每次尺寸变化都会把窗口夹回视口内,拖出屏幕也不会丢。

贴边吸附:拖着窗口靠近窗口边缘(左右上下 40px 内)松手,会自动吸到边上并留 12px 边距;
放在中间则停在原地。吸附与收起/展开切换都带一点过渡动画(prefers-reduced-motion 下关闭)。

输入框下方那条计时条默认关闭:悬浮窗已经常驻,没必要重复两处。
想要两处都有(或只留计时条),在 ⚙ 里切换;两个开关至少保留一个,不会把计时器藏没。

阶段自然结束时:播放两声轻提示音(升调进入休息、降调回到专注),并在首次点击开始后
申请一次浏览器通知权限,之后每次切换都会发一条通知。

结束提醒:动效

工作环境静音时声音用不上,所以阶段结束默认还会播放一套画面动效。可在 ⚙ 里选「关 / 涟漪 / 边缘光 / 组合」,
默认组合,并可叠加文字提示卡:

  • 边缘光:整个界面四周泛起两层很淡的同色光(专注红 #f25a5a / 休息绿 #22c55e),顶部有一条细线扫过;
  • 涟漪:胶囊(或展开的卡片)里荡开三圈同色波纹,时间翻到下一阶段;
  • 提示卡:胶囊上方浮出一条「专注结束 / 短休息 5:00」,4 秒后淡出。

动效只在阶段自然结束时播放(跳过、重置不播),约 1.6–2.2 秒,不抢焦点、不改变窗口位置;
系统开启「减少动态效果」时退化为静态提示卡;标签页在后台时,动效会等你切回前台再补播一次;
设置面板里的「试播动效」可以立刻看一遍,不用等计时结束。

设计预览:preview/phase-end-effects.html(四个方案可逐个重播)。

状态放在哪

倒计时只依赖一个 endsAt 时间戳,所以:

  • 刷新页面、关掉标签页再回来,都会接着同一阶段继续;
  • 后台标签页被节流也不会算错时间,回到前台立刻校准;
  • 如果离开期间刚好有一阶段结束,回来时只结算这一阶段,停在新阶段的起点,不会连环跳。

设置与计时状态存在 localStorage 的 dsh:pomodoro:v1 键里,不同标签页各自独立计时。

安装

从 GitHub 安装(推荐):

dsh plugin --profile web add github:atticuswx/dsh-pomodoro

装完刷新页面,右下角就会出现那颗胶囊。想锁定版本,可以在地址后面加 tag:

dsh plugin --profile web add github:atticuswx/dsh-pomodoro#v0.3.1

也可以从本地目录安装(改代码即时生效,适合自己改着玩):

git clone https://github.com/atticuswx/dsh-pomodoro.git ~/dsh-plugins/dsh-pomodoro
dsh plugin --profile web add ~/dsh-plugins/dsh-pomodoro

或者在 DSH 里用 Plugin Manager 指向目录的绝对路径:

plugin_manager { action: "install_bundle", target: "/Users/<你>/dsh-plugins/dsh-pomodoro" }

包内没有构建步骤:client.js 就是浏览器直接加载的模块。安装后 bundle 会写进 profile 的
package.json 与 cordis.patch.yml,重启后仍在;Client 半立刻注册到 shell.overlay
(常驻悬浮窗)和 conversation.composer.dock(可选计时条)。改动 client.js 后若界面
没更新,刷新一次页面即可。

> 包名 dsh-pomodoro,与仓库同名。插件在 profile 里显示为 pomodoro 这一行。

实现要点

文件 作用
package.json bundle 清单:dsh.bundle.patch + dsh.client(web,immediately)
cordis.patch.yml 插入 pomodoro 行;Host 半为空
index.js Host 半:apply() {},计时全在浏览器
client.js 计时引擎 + 悬浮窗 + 计时条 + 设置面板 + 通知/提示音 + 结束动效
locale/*.json 插件清单里的标题/描述(中英)
icon.svg 番茄 + 时钟指针,原创图形
  • 只从 loader 的模块表取 react,不引用任何 Harness Client 包;
  • 颜色全部走 --dsw-alias-* 主题令牌,浅色/深色主题自动跟随;
  • 悬浮层本身是 click-through 的,只有窗口自己的盒子接收指针事件;
  • 文案走 Client locale 服务的 pomodoro 命名空间(en/zh),切换语言时插槽会自动重渲染;
  • 样式以组件内 ` 渲染,卸载即移除;区间、监听、音频上下文都在ctx.effect` 里释放。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-pomodoro 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:atticuswx/dsh-pomodoro#v0.3.1` 即可。对应的 npm 包名是 `dsh-pomodoro`。

dsh-pomodoro 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-pomodoro 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-pomodoro 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-pomodoro 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-pomodoro 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-pomodoro 有哪些功能?

常驻悬浮窗,无需会话、专注/休息阶段与轮次圆点、跳过、重置与可调时长、阶段结束提示音与通知、位置与状态本地记忆。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

7 条
不同作者的仓库分开列,请确认你要装的是哪一个
会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

atticuswx 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。