dsh-pomodoro 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-pomodoro 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-pomodoro 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-pomodoro 还在维护吗？

GitHub 5 星。最近一次上游提交在 2026/10/18。

番茄钟 causebefore/dsh-pomodoro

DeepSeek Harnessv0.5.5

causebefore17 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

DeepSeek Harness Web 番茄钟插件：可配置专注与休息时长，提供侧栏入口和可拖动浮动面板

36.5/100

综合分

GitHub 星标

481

npm 周下载

—/5

用户评分

数据截至 2026/10/18 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add dsh-pomodoro

npm 源 · dsh-pomodoro 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · ui

装得上吗

本站已在 dsh 0.2.1-rc.5 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 17 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-pomodoro @ 0.5.5

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/31 07:32:19

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 3 处，展示前 3 条）

发起网络请求
lib/client.js:721
return await lockManager.request(RUNTIME_LOCK_NAME, { mode: "exclusive" }, () => {
发起网络请求
lib/client.js:1068
const response = await fetch("/api/pomodoro/config");
读取本地文件
lib/migrate-settings.js:19
text = await readFile(join(home, filename), "utf8");

扫描于 2026/11/3（1 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-settings

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

6 张 · 点击查看大图

功能亮点

配置专注与休息时长
侧栏入口
可拖动浮动面板

最近更新

在 GitHub 查看全部 →

v0.5.52026-10-18

适配 DSH：0.1.0-rc.7、0.2.0-rc.2、0.2.1-rc.2（本轮实测，仅 rc 基线）

中文 | English

· DSH 0.2.1 rc 远程设置兼容修复

· 适配新版远程持久化设置：首次配置返回前等待开始与离线到期结算，避免误用默认时长或自动开始选项；保留旧宿主的默认配置降级
· 更新新版设置不可用提示，补充 engines.dsh 与 settings peer 声明，未收窄原有支持范围
· 70 项自动化测试通过，安全扫描无 FAIL/WARN；新 rc 完成真实宿主验证，上一 rc 和最低支持 rc 冒烟通过，中英文说明与明暗截图同步更新
· 本轮实测版本列于顶部；其他历史验证范围见验证记录。系统通知授权/送达、提示音实际可听性和跨机器网络/TLS 未验证

· DSH 0.2.1 RC Remote Settings Compatibility Fix

· Wait for initial host settings before starting timers or settling expired phases on remote clients, avoiding default durations or automatic-start options; preserve fallback behavior on older hosts
· Update the unavailable-settings message and declare engines.dsh plus the new settings peer range without narrowing existing support
· All 70 automated tests pass with no security-scan FAIL/WARN findings; real-host checks pass on the new rc, with smoke tests on the previous and minimum supported rc, plus updated bilingual documentation and light/dark screenshots
· Versions tested in this run are listed above; see the validation record for historical coverage. OS notification authorization/delivery, audible sound and cross-machine networking/TLS remain unverified

· 更新 | Update

dsh plugin --profile web update dsh-pomodoro

更新后请重启 DSH Web 宿主 / Restart the DSH web host after updating.

Full Changelog:

v0.5.42026-10-01

适配 DSH：0.1.0-rc.7、0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.2、0.2.0-rc.2（仅 rc 基线）

中文 | English

· DSH 新版设置适配与旧配置迁移

· 适配 DSH 新版配置表单，在“插件 → dsh-pomodoro”中管理六项设置；保留旧版设置入口与计时行为
· 保存和清除改为带 revision 的原子批量操作，遇到冲突或写入失败时保留草稿并显示错误
· 自动迁移旧 settings 文件中的六项有效设置，只补充新版缺失字段，保留原文件；清除后不会在重启时恢复旧值
· 更新中英文说明与明暗主题设置截图；66 项自动化测试通过，新版完成真实宿主验证，四个旧 rc 基线回归通过（0.1.0-rc.7 为加载冒烟，其余包含设置保存与基本计时）

· New DSH Settings Support and Legacy Configuration Migration

· Support the new DSH configuration forms under Plugins → dsh-pomodoro, while preserving the older settings entry and timer behavior
· Save and clear settings in atomic batches with revision checks; preserve drafts and show errors on conflicts or failed writes
· Import the six valid legacy settings only where the new configuration has no explicit value, preserving the original file; cleared settings stay cleared after restarts
· Update bilingual documentation and light/dark settings screenshots; all 66 automated tests pass, with real-host verification on the new baseline and regression checks on four older rc baselines (load smoke test on 0.1.0-rc.7; settings save and basic timing on the others)

· 更新 | Update

dsh plugin --profile web update dsh-pomodoro

更新后请重启 DSH Web 宿主 / Restart the DSH web host after updating.

Full Changelog:

v0.5.32026-09-18

适配 DSH：0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.2（仅 rc 基线）

中文 | English

· DSH 0.1.5 兼容与配置通道迁移

· 修复 DSH 0.1.5 中旧配置 RPC 注册失败导致插件无法加载的问题；当前宿主改走受认证的只读配置 GET 通道，老 rc 宿主自动回退既有 RPC
· 保持 dsh-pomodoro settings namespace 与既有用户设置不变，专注时长、休息时长及四项开关继续正常同步
· 配置响应明确禁止缓存，并补齐 GET 成功、404 回退、认证失败等兼容性测试与发布面安全审查

· DSH 0.1.5 Compatibility and Config Channel Migration

· Fix plugin startup failures caused by the legacy config RPC registration on DSH 0.1.5; current hosts now use an authenticated read-only config GET route, while older verified rc hosts automatically fall back to the existing RPC
· Preserve the dsh-pomodoro settings namespace and existing user settings, with focus duration, break duration, and all four switches continuing to synchronize normally
· Explicitly prevent config-response caching and add compatibility coverage for successful GET requests, 404 fallback, authentication failures, and the published security surface

· 更新 | Update

dsh plugin --profile web update dsh-pomodoro

更新后请重启 DSH Web 宿主 / Restart the DSH web host after updating.

Full Changelog:

数据来自仓库的 GitHub Release，可能与插件实际版本不一致。

README

由 DeepSeek 最新模型翻译生成

🍅 dsh-pomodoro 为 DeepSeek Harness Web UI 提供专注与休息循环的番茄钟插件。 English · 界面预览 ·功能亮点 ·快速安装 ·基本使用 ·设置与提醒 ·故障排查兼容性提示： DeepSeek Harness 目前迭代迅速，本插件仅跟进 rc 版本：开发与验证均以 rc 基线为准，不承诺支持 alpha 等中间预发布。每个发布版本适配的 DSH 版本都在 Releases 说明中注明；升级 DSH 后，请先对照 Release 说明确认插件兼容性。界面预览支持明暗主题、迷你模式和 DSH 插件配置。浅色主题深色主题迷你模式设置页面深色主题设置页面功能亮点 - 融入 DSH：从侧栏打开番茄钟，在插件配置页面统一管理设置。 - 完整计时控制：支持开始、暂停、重置、跳过、环形进度、阶段提示和已完成专注计数。 - 跨会话恢复：刷新页面，或关闭标签页、重启浏览器后重新打开 DSH，都会按原截止时间恢复；离开期间已到期时只结算当前阶段一次。 - 低干扰迷你模式：收起后只保留阶段、倒计时和开始/暂停，仍可拖动、展开或关闭。 - 可配置循环：专注与休息时长可调，并可分别控制是否自动开始休息或下一轮专注。 - 阶段结束提醒：无论面板是否打开都会显示 DSH 内提醒，还可选择提示音和后台系统通知。

展开完整文档（README 剩余 1 节）

🍅 dsh-pomodoro

为 DeepSeek Harness Web UI 提供专注与休息循环的番茄钟插件。

English ·

界面预览 ·功能亮点 ·快速安装 ·基本使用 ·设置与提醒 ·故障排查

兼容性提示： DeepSeek Harness 目前迭代迅速，本插件仅跟进 rc 版本：开发与验证均以 rc 基线为准，不承诺支持 alpha 等中间预发布。每个发布版本适配的 DSH 版本都在 Releases 说明中注明；升级 DSH 后，请先对照 Release 说明确认插件兼容性。

界面预览

支持明暗主题、迷你模式和 DSH 插件配置。

浅色主题深色主题

迷你模式

设置页面

深色主题设置页面

功能亮点

- 融入 DSH： 从侧栏打开番茄钟，在插件配置页面统一管理设置。
- 完整计时控制： 支持开始、暂停、重置、跳过、环形进度、阶段提示和已完成专注计数。
- 跨会话恢复： 刷新页面，或关闭标签页、重启浏览器后重新打开 DSH，都会按原截止时间恢复；离开期间已到期时只结算当前阶段一次。
- 低干扰迷你模式： 收起后只保留阶段、倒计时和开始/暂停，仍可拖动、展开或关闭。
- 可配置循环： 专注与休息时长可调，并可分别控制是否自动开始休息或下一轮专注。
- 阶段结束提醒： 无论面板是否打开都会显示 DSH 内提醒，还可选择提示音和后台系统通知。
- DSH 语言支持： 跟随 DSH 全局语言提供中文和英文；切换语言会立即更新已打开的插件界面，不会重置计时或未保存的设置草稿。
- 界面适配： 自动适配 DSH 明暗主题、键盘操作和“减少动态效果”偏好。

环境要求

| 组件 | 要求 |
| DeepSeek Harness | 已验证版本见各插件 Release 说明 |
| Node.js | ^22.19.0 或 >=24.0.0 |
| DSH profile | web；headless profile 不提供界面 |
| pnpm | 可从命令行使用 |

快速安装

将插件安装到 web profile：

dsh plugin --profile web add dsh-pomodoro

安装后启动或重启 DSH Web：

dsh web

侧栏底部出现 🍅 按钮即表示插件已加载。

在 DSH 界面内安装

不想离开 Web 界面？两个社区伴侣插件都可以代劳：

- dsh-market：先执行 dsh plugin --profile web add dshmarket 并重启 dsh web，然后打开“设置 → 插件市场”，搜索 dsh-pomodoro 一键安装，刷新页面即可使用。
- dsh-find-plugin：先执行 dsh plugin --profile web add dsh-find-plugin 并重启 dsh web，然后直接对话“帮我安装 dsh-pomodoro 插件到 dsh”，agent 会搜索并完成安装，结束后刷新浏览器即可。

基本使用

点击侧栏 🍅 按钮打开或关闭面板，拖动标题栏可以调整面板位置。标题栏中的“迷你”会收起次要信息，“展开”可恢复完整面板。

| 控件 | 行为 |
| 开始 / 暂停 | 启动或暂停当前阶段 |
| 重置 | 将当前阶段恢复到完整时长并暂停 |
| 跳过 | 切换到下一阶段并保持暂停 |
| 迷你 / 展开 | 在低遮挡布局与完整控制之间切换 |

设置与提醒

新版 DSH：从侧栏进入“插件 → dsh-pomodoro”，展开“番茄钟”卡片。旧版 DSH：进入“设置 → 插件 → 插件配置 → 番茄钟”。可修改以下六项设置：

| 设置 | 默认值 | 作用 |
| 专注时长 | 25 分钟 | 每轮专注阶段的完整时长，可设置为 1–240 分钟的整数 |
| 休息时长 | 5 分钟 | 每轮休息阶段的完整时长，可设置为 1–240 分钟的整数 |
| 自动开始休息 | 开启 | 专注自然结束后自动启动休息 |
| 自动开始下一轮专注 | 关闭 | 休息自然结束后自动启动下一轮 |
| 阶段结束时播放提示音 | 关闭 | 阶段自然结束时播放三次提示音，可直接试听 |
| 后台时发送系统通知 | 关闭 | DSH 页面位于后台时发送浏览器通知 |

当前阶段尚未开始时，新时长会立即生效；计时已经开始后，从下一阶段生效。

支持远程设置持久化的新版 DSH 中，已认证的远程浏览器也可保存和清除设置。首次打开页面时，番茄钟会等待宿主设置返回，再执行开始操作或结算离线期间已到期的阶段，避免误用默认时长与自动开始选项。旧宿主不提供远程设置时仍按默认配置运行。

旧设置迁移

升级到新版设置宿主后，插件会自动读取 $DSH_HOME/settings.yaml（不存在时读取 settings.yaml.imported）中的 dsh-pomodoro 分节。只迁移上表六个有效字段，并且只补充新版配置中尚未明确设置的字段；原文件保持不变，无效字段会跳过并在宿主日志中提示。

迁移结果和内部完成标记由宿主一次写入。点击“清除自定义设置”会恢复继承的配置，不会在重启后再次导入旧值。迁移读取或写入失败时，现有配置保持不变；修复旧文件的格式或权限后重启重试，也可以在插件详情页重新设置。

新版保存与清除均一次提交六项变更。若发生并发修改或写入失败，界面会显示错误并保留草稿，请核对最新设置后重试。

完成提醒

- DSH 内提醒： 始终开启。专注或休息自然结束时会显示，即使番茄钟面板已经关闭也能看到；若下一阶段自动开始，提醒中会一并说明。
- 提示音： 默认关闭。开启并保存后，每次阶段自然结束会播放三次提示音；“试听”无需先保存。
- 系统通知： 默认关闭。首次开启时请按浏览器提示允许通知，然后点击“保存”。通知只在 DSH 页面位于后台或失去焦点时发送。

所有 DSH 页面都关闭时，浏览器不会在截止时刻播放提示音或发送通知；下次打开 DSH 时会恢复状态，并对已到期的当前阶段结算和提醒一次。

系统通知需要通过 localhost、127.0.0.1 或 HTTPS 访问，并保持 DSH 页面打开。提示音或系统通知不可用时，DSH 内提醒仍然有效。

更新与移除

更新插件
dsh plugin --profile web update dsh-pomodoro

移除插件
dsh plugin --profile web remove dsh-pomodoro

执行后重启 dsh web。

插件通过 engines.dsh 向新版宿主声明兼容范围，并保留旧宿主使用的 peer 依赖声明。实际完成验证的 rc 版本及验证范围以每次 Release 说明为准。

故障排查

| 症状 | 处理 |
| 安装或更新时报 'pnpm' 不是内部或外部命令 | dsh plugin 依赖 PATH 上的 pnpm：执行 npm install -g pnpm 后重试 |
| dsh web 启动失败，提示端口 3080 被占用 | 上一个实例仍在运行或已残留：用 netstat -ano \| findstr :3080 找到 PID，taskkill /PID <pid> /F 结束后重启 |
| 侧栏没有 🍅 按钮 | 确认使用 web profile 且已执行 dsh plugin --profile web add dsh-pomodoro，然后重启 dsh web |
| 找不到旧设置入口 | 新版入口为侧栏“插件 → dsh-pomodoro”；旧版仍在“设置 → 插件 → 插件配置” |
| 升级后旧设置未导入 | 检查宿主日志中的 dsh-pomodoro 迁移诊断；修复旧文件格式或权限后重启，或在插件页重新设置 |
| 系统通知不出现 | 检查浏览器站点通知权限并保持 DSH 页面打开，详见完成提醒 |

相关链接

- npm 包
- 版本发布
- 问题反馈
- DeepSeek Harness

License

MIT。React/ReactDOM 与 CC0 完成提示音等第三方素材的许可信息见 THIRD_PARTY_NOTICES.md。

开发与维护

展开本地开发、项目结构与发布流程

本地开发

git clone https://github.com/causebefore/dsh-pomodoro.git
Set-Location dsh-pomodoro
dsh plugin --profile web add .
npm run check
npm pack --dry-run

项目没有生成步骤，lib/client.js 就是直接发布的浏览器 bundle。日常开发在 dev 分支进行，main 只接收已经完成发布检查的版本。

项目结构

| 路径 | 职责 |
| lib/index.js | Node/Cordis 入口、官方设置分节与只读配置降级通道（新宿主 GET 路由 / 老宿主 loopback RPC） |
| lib/migrate-settings.js | 旧设置的受限读取、字段校验及一次性迁移 |
| lib/client.js | 浏览器计时引擎、React UI、slot 注册、locale 文案和设置同步 |
| assets/sounds/deep-ding.mp3 | CC0 低沉提示音源文件；运行时字节嵌入客户端 bundle |
| docs/images/ | 中英文 README 截图与 GitHub Social Preview 图片 |
| cordis.patch.yml | 向 DSH Web 组合插入插件服务 |
| package.json | exports、peer 范围、bundle 声明和 npm 发布清单 |
| .github/workflows/publish.yml | GitHub Release 到 npm 的可信发布流程 |

发布流程

1. 在 dev 完成开发和验证，并更新 package.json 版本。
2. 通过发布 PR 将 dev 合入 main。
3. 从对应的 main 提交创建名称匹配 vX.Y.Z 的稳定 GitHub Release。
4. 发布工作流会验证版本、tag 和 main 归属，运行语法与打包检查，再通过 npm Trusted Publishing 发布。