前言¶
在 DeepSeek Harness(DSH)里长时间写代码、跑智能体或盯会话时,「今天过了多久、按工资算已经值多少钱」往往只有模糊感觉。常见做法是另开计算器或表格,和 IDE 界面割裂,也不会按你的班次实时刷新。下面介绍社区插件 dsh-salary-flap(维护者 hulibuld):它以 client 插件形式挂在 DSH Web UI 上,用老式机场翻牌动画展示「今天已经赚了多少钱」,每 2 秒结算一次,纯前端、不联网,配置与进度都落在本机浏览器。
这是什么¶
工资跳板(Salary Flap) 是一块浮在 DSH 界面上的翻牌工资看板。填好月薪、每日工时、每月工作天数和上班时间后,它只统计当天收入:上班前为 0,上班中按秒递增,下班后封顶为日薪不动。分类上在 SkillHub 目录 归入「趣味换装」——重点在翻牌动效与多套配色,而不是后端服务或数据同步。
核心功能¶
看板与交互¶
装好后刷新页面,看板默认在窗口右下角(Client Slot shell.overlay,条目 id salary-flap)。浮层整帧不接鼠标,只有板子区域可点,避免挡住下方界面。
第一次出现即为设置态:填写月薪、每天工作几小时、每月工作几天、上班时间(默认 09:00),点「开始跳」即可运行。运行后包括:
- 大号翻牌金额;下方小字显示时薪、今日进度和状态(还没上班 / 上班中 / 今天收工了)。
- 拖动:按住顶部把手移动,位置写入本机,下次仍在该处。
- 换配色:标题旁六个圆点对应 mono、green、wood、sky、night、sakura 六套主题,含牌面与凹陷窗。
- 收进顶栏:点右上角
×缩成会话顶栏上的金额胶囊,再点展开。界面默认中文,⚙ 可切 English。
翻牌动效¶
单格数字变化时,上半页绕铰链翻至 90°,下半页再落定;两段各 210ms,共 420ms,落定带 6° 过冲。仅变化的格子会翻,进位从右向左错开 30ms。系统开启「减少动态效果」时关闭翻页,数字直接替换。
计算口径¶
日薪、时薪与每 2 秒增量关系如下(与 README 一致):
日薪 = 月薪 / 每月工作天数
时薪 = 日薪 / 每日工作小时数
每 2 秒结算一次 = 时薪 / 1800
| 现在的位置 | 显示 |
|---|---|
| 早于上班时间 | 0.00,状态「还没上班」,并显示倒计时 |
| 上班时间内 | 日薪 × 已过去的计薪秒数 / 当日总计薪秒数 |
| 晚于下班时间 | 日薪(封顶),状态「今天收工了」 |
下班时间 = 上班时间 + 每日工作小时数。若结束时刻 ≤ 开始时刻,按跨午夜班次处理(例如 22:00 至 06:00),收工后当日金额保持日薪,不会回到 0。金额截断到两位小数(不四舍五入);牌面固定 8 格:¥ + 4 位整数 + 小数点 + 2 位小数。时间按本机本地时区,不对时联网。
本地存储¶
数据在浏览器 localStorage,键前缀 dsh.salary-flap.v1.:settings(月薪与班次)、pos(位置)、view(展开或顶栏)、theme、lang。换浏览器、清缓存或换设备不会同步——插件本身不打算联网。
安装与启用¶
它是 DSH 的 client 插件(bundle 形态),装在 desktop profile。任选一种方式:
从 npm 安装(包名 dsh-salary-flap,当前版本 1.0.0):
plugin_manager → action: install_bundle → target: dsh-salary-flap
从本地目录安装:
plugin_manager → action: install_bundle → target: <你 clone 下来的目录>
装完刷新 DSH 页面即可看到看板。package.json 中声明的 DSH 引擎范围为 >=0.2.0-rc.1 <0.3.0-0。
典型用法¶
- 在 DSH 中按上文命令安装 bundle 并刷新。
- 首次在设置态填写月薪、每日小时数、每月天数、上班时间,点「开始跳」。
- 需要时拖动把手、切换六色主题,或通过
×收到顶栏胶囊以减少遮挡。 - 开发或维护插件时,可在插件目录执行自检(README 说明断言来自源码,共 97 项):
node tools/selfcheck.mjs
适用场景与注意¶
适合:希望在 DSH 同一窗口里直观感受「今日计薪进度」、且接受纯本地、无历史图表的开发者;喜欢 split-flap 翻牌视觉的用户。
注意:
- 插件以当前 DSH 进程及浏览器上下文运行;安装前建议阅读 源码 与 MIT 许可证,确认符合你的环境策略。
- 不剔除午休:工作时长为连续一段,中午也在计薪范围内。
- 仅一份班次,无排班表;无历史、图表、导出、声音、托盘或开机自启。
- 同一浏览器多标签各算各的,不同步。
- 宿主当前禁止
window.open,独立桌面弹窗能力尚未可用;仓库保留window.html与路由,待宿主放开后可再接。 - SkillHub 等为社区目录,与 DeepSeek / 幻方无官方从属关系;星标与版本以仓库与 npm 页面为准。
结尾¶
dsh-salary-flap 把「今天赚了多少」做成 DSH 界面里一块可拖、可换肤的翻牌看板,计算与存储都在本机完成。目录页:https://www.skillhub.cn/plugins/hulibuld/dsh-salary-flap;源码与说明:https://github.com/hulibuld/dsh-salary-flap。问题可通过 GitHub Issues 反馈。