dsh-pomodoro

DSH PLUGIN通知与集成

仓库 yang313760940/dsh-pomodoro

通知与集成 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

DeepSeek Harness 番茄闹钟插件:三阶段番茄计时、结束提醒、统计,落盘持久化

一句话选型结论

按资料字段整理

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

分类通知与集成 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 未标注 · 未关闭 issue 未标注
最近更新 2026-10-20 创建于 未标注
README 7.1 KB 正文体量,越大说明说明书写得越细

安装

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

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

通知与集成
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

通知存储

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-pomodoro当前 L4 · 沙盒安装通过 低风险 0 未标注 有
treg L3 · 安装规范通过 低风险 4,976 未标注 无
dsh-purge 未做沙盒验证 未标注 3,412 未标注 有
dsh-im L5 · 运行验证通过 低风险 1,837 0.1.7-rc.2 等 10 个 有
dsh-aurabot-qq 未做沙盒验证 未标注 633 未标注 有
dsh-dafeiyu L5 · 运行验证通过 低风险 425 0.1.7-rc.2 等 10 个 有

仓库档案

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

README 全文

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

dsh-pomodoro — DeepSeek Harness 番茄闹钟插件

一个 DeepSeek Harness(DSH)Web / 桌面客户端插件:专注 / 短休 / 长休三阶段番茄计时,输入框下方常驻倒计时,阶段结束提醒,今日与近 7 天统计。设置与统计落盘到 $DSH_HOME/pomodoro.json,重启客户端不丢。

  • 目标宿主:DSH Desktop 0.2.1-rc.2(Web 面)
  • 插件形态:window.__ModuleLoader__ 客户端 bundle + Host 半侧(受信任来源栅栏保护的 JSON 路由)
  • 运行环境:Node ≥ 20、浏览器支持 AudioContext / localStorage(IntersectionObserver 非必需)
  • 界面语言:中文(locale/en.json 仅为英文界面的插件管理器提供元数据,运行时文案为中文)

功能一览

计时

  • 三阶段:专注 / 短休 / 长休;开始 / 暂停 / 继续 / 重置 / 跳过
  • 半自动流转:阶段自然结束后自动切到下一阶段并暂停,等用户点开始
  • 长休由「每 N 个已完成番茄」触发(独立计数,非时长推算)
  • 全局单例计时器:所有会话看到同一个番茄钟
  • 刷新/重开页面按 endsAt 恢复剩余时间;离开期间跨过结束时间 → 视为自然完成,停在下一阶段并说明
  • 倒计时不受后台 interval 节流影响(每次心跳按墙钟重算)

时长与周期

  • 专注 5–90 分钟(默认 25)、短休 1–30 分钟(默认 5)、长休 5–60 分钟(默认 15)均可调
  • 长休间隔 2–8 个番茄可调(默认 4)
  • 三个预设一键切换:25/5/15、50/10/20、52/17/20

提醒

  • 提示音:专注结束=上行三音,休息结束=下行两音(Web Audio 现场合成,无音频素材)
  • 音量 0–100% 滑杆(0 即静音)
  • 界面内醒目提醒:dock 行变强调底色 + 标题文案 + 「开始短休 / 知道了」
  • 系统通知开关,默认关闭;首次开启才请求权限
  • 通知不可用/被拒绝 → 自动降级为「提示音 + 界面提醒」,设置页显示原因

状态显示

  • dock 单行:阶段标签 + mm:ss + 细进度条 + 轮次 n/N
  • 单行完整控制:开始/暂停、重置、跳过(配置全在设置页)
  • 当前任务名出现在 hover 提示与结束文案里
  • 全部颜色走 --dsw-alias-* 主题 token,跟随明暗与皮肤

统计

  • 今日番茄数(只计自然完成的专注段)、今日专注分钟数
  • 今日放弃次数(跳过/重置的已开始专注段,单独计数)
  • 连续专注天数 streak(一天 ≥1 个完成即算;今天未完不算断)
  • 近 7 天柱状图(今天高亮);记录保留 90 天滚动,超期自动裁剪
  • 「清除全部统计」带二次确认

设置与持久化

  • 独立设置页「番茄闹钟」,位于设置侧栏
  • 设置与统计落盘到 $DSH_HOME/pomodoro.json(跨重启保留);localStorage 仅作首帧缓存
  • Host 接口不可用时降级为仅浏览器缓存,并在设置页显示降级提示
  • 修订号单调:旧页面无法把落盘数据回滚;损坏的状态文件读作空记录,不崩插件

安装

方式一:DSH 内安装(推荐)

  1. 下载本仓库的 dsh-pomodoro/ 目录到本地任意位置(不要放进 $DSH_HOME):
git clone https://github.com/yang313760940/dsh-pomodoro.git
  1. 在 DSH 里让 Agent 执行 plugin_manager:
    - action: install_bundle
    - target:
    - 返回 application: applied 后,刷新页面即生效。

  2. 或在 设置 → 插件 → 添加 里用本地目录安装(等价路径)。

> 不要在 profile 目录里手写 package.json / cordis.patch.yml,也不要跑 pnpm——install_bundle 负责这些步骤。

启用 / 禁用 / 卸载

操作 做法 效果
禁用 plugin_manager set_bundle,target: dsh-pomodoro,enabled: false dock 行与设置页消失;已落盘数据保留
启用 同上,enabled: true 重新挂载
卸载 plugin_manager remove_bundle,target: dsh-pomodoro 移除依赖;$DSH_HOME/pomodoro.json 不会被自动删除,需要清干净请手动删该文件

> 替换已安装包的代码需要重启客户端(新装可能靠 HMR 直接生效,替换已装包需要重启以加载新的 JS 代码)。

使用

  1. 安装后刷新页面,打开任一会话:输入框下方出现番茄倒计时行。
  2. 点击「开始」进入专注计时;阶段自然结束会自动切到下一阶段并暂停,同时播放提示音(首次点击后才有声,浏览器要求一次用户手势才能创建 AudioContext)。
  3. 设置 → 侧栏「番茄闹钟」:调整三段时长、长休间隔、预设、音量、系统通知、当前任务名。
  4. dock 行的进度条与轮次计数实时反映当前轮次;统计在设置页查看。

仓库结构

dsh-pomodoro/                 ← 插件包本体(安装这个目录)
├── package.json              包清单:dsh.bundle / dsh.client / exports / files / icon
├── cordis.patch.yml          向 Loader 树插入一行 dsh-pomodoro(同时激活 Host 半与 Client 半)
├── index.js                  Host 半:注册 /pomodoro/api,原子读写 $DSH_HOME/pomodoro.json
├── client.js                 浏览器半:计时状态机 + 两个槽位组件 + 提示音 + 统计
├── locale/zh.json            插件管理器里显示的标题与描述(中文)
├── locale/en.json            同上(英文)
└── icon.svg                  插件图标
tests/                        离线测试(纯 Node、无外网、无浏览器)
GLOSSARY.md                   领域词汇表(番茄 / 放弃 / 自然完成 / streak …)
docs/adr/                     架构决策记录

开发与测试

node --check dsh-pomodoro/client.js
node --check dsh-pomodoro/index.js
node tests/copy.cjs
node tests/smoke.cjs
node tests/reload.cjs
node tests/host-api.cjs
  • tests/smoke.cjs:浏览器半冒烟测试(17 组断言)
  • tests/reload.cjs:刷新/跨阶段结束场景(5 组场景)
  • tests/host-api.cjs:Host 路由测试(来源栅栏、修订号、原子写,11 组断言)
  • tests/copy.cjs:静态一致性(t() 键有译文、无死文案、清单导出展示资源)

已知边界

  1. UI 文案仅中文。运行时字典对 en 也返回中文,避免英文界面出现裸 key。
  2. 系统通知在桌面壳里可能被平台层拦截,代码按「不可用即降级并显示原因」处理。
  3. 提示音需要一次用户手势才能创建 AudioContext,首次点击「开始」后才有声。
  4. 统计按浏览器时区的本地自然日划分,跨时区旅行时历史记录的归属日不会重算。
  5. endsAt 依赖本机时钟,系统时间被手动大幅调整时倒计时按新墙钟重算。
  6. 未做(不在当前范围):独立侧边栏面板/全局浮窗、任务列表与预估番茄、白噪音、网站屏蔽、跨设备同步、数据导出、30 天趋势。

许可证

MIT © 2026 yang313760940

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:yang313760940/dsh-pomodoro#v1.0.0` 即可。

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

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-pomodoro 安全吗?

低风险。

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

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

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

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

同名或近似条目

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

treg

treg

Treg 是面向 Agent 工具的 OpenRouter,聚合 60 个提供商的 2896 个端点,按调用计费,统一令牌访问,无需注册各供

L3 · 安装规范通过 4,976 星

dsh-purge

dsh-purge

dsh-purge Community · DeepSeek Harness 社区维护版:宿主兼容、状态诊断、提示词管理、更新与本机备份回滚

未标注验证等级 3,412 星

dsh-im

dsh-im

将IM机器人接入DeepSeek Harness,支持飞书、微信、钉钉等九种渠道,通过扫码或凭据配置,统一管理多机器人连接。

L5 · 运行验证通过 1,837 星

dsh-aurabot-qq

dsh-aurabot-qq

让 DeepSeek Harness 里的 AI 以「大肥鱼」人格住进 QQ,通过 OneBot v11 网关聊天、发表情语音、写空间日记并

未标注验证等级 633 星

dsh-dafeiyu

dsh-dafeiyu

DSH 大肥鱼是一款由 DeepSeek Harness 真实工作状态驱动的桌面伴侣插件,以始终置顶的透明窗口实时展示 Agent 的思考、

L5 · 运行验证通过 425 星

dsh-trading

dsh-trading

L3 · 安装规范通过 235 星

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