dsh-niuma 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+本文件记录用户可感知的变化。版本号遵循语义化版本。
+
+## 0.1.1 — 2026-10-21
+
+发布链路改为**自动直发**（用户可感知：以后发版不用人工批准）。
+
+- 推 tag `vX.Y.Z` → GitHub Actions 用 npm Trusted Publishing（OIDC）直接 `npm publish --provenance --access public`
+- 发布带 **SLSA provenance**（0.1.0 是本地手动发布，没有 provenance）
+- 保留人工模式：手动 Run workflow 选 `mode=stage`，可走「暂存 + 在 npm 网页批准」
+- 前提：npm 包设置里的 Trusted Publisher 绑定页勾选 “Allow npm publish”
+
+## 0.1.0 — 2026-10-21
+
+首个版本。
+
+- 新增「牛马」侧栏入口与主面板：把**实收月薪**换算成每秒滚动的现金计数器
+- 六档工资换算：秒工资、分工资、时工资、日工资、周工资、月工资
+- 工作日口径：周一至周五上班；法定节假日不算工作日（日工资因此变高）；调休上班日算工作日
+- 内置 2026 年法定节假日与调休上班日（来源：国办发明电〔2025〕7号），面板内可编辑
+- 可设置上下班时间、午休起止，并可勾选「午休是否算工时」；午休不算工时时金额冻结
+- 今日已赚按秒刷新（4 位小数）、今日进度条、距上班/下班倒计时、状态徽标
+- 设置面板内直接保存到 DSH 设置；非法输入就地提示，不白屏
+- 中英双语

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oli20
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,73 @@
+# dsh-niuma · Salary Ticker for DSH
+
+[![npm](https://img.shields.io/npm/v/dsh-niuma.svg)](https://www.npmjs.com/package/dsh-niuma)
+
+> A DSH (DeepSeek Harness) plugin that turns your **monthly take-home pay** into a **live cash counter that ticks every second**.
+> Glance at it during work: your money grows before your eyes. After hours it stops — a tiny daily reality check.
+
+[中文](README.md) | English
+
+---
+
+> **Community plugin, not affiliated with DeepSeek.** All amounts are local estimates from the salary and working
+> hours you enter — not a payslip, not a bill, not labor or financial advice.
+
+---
+
+## What it computes
+
+Set it up once, then the panel refreshes every second:
+
+- **Earned today**: your effective work income accumulated per second, 4 decimals, visibly ticking
+- **Per-second / per-minute / per-hour / per-day / per-week / per-month** wage breakdown
+- **Working-day rules**: Mon–Fri count as working days; **statutory holidays do NOT count** (so the daily wage rises); **make-up workdays DO count**
+- Editable lunch break, with a checkbox for **whether lunch counts as paid work time** (unpaid lunch freezes the counter)
+- Status badge: day off / not started / working / on lunch / off work
+- Progress bar for today, countdown to start / end of shift
+
+### Formulas
+
+| Metric | Formula |
+|---|---|
+| Paid minutes per day | (end − start) − (lunch enabled and unpaid ? lunch length : 0) |
+| Working days this month | Mon–Fri, minus statutory holidays, plus make-up workdays |
+| Daily wage | monthly take-home ÷ working days this month |
+| Hourly wage | daily wage ÷ paid hours |
+| Minute / second wage | hourly ÷ 60 / ÷ 3600 |
+| Weekly wage | daily wage × working days this week (Mon–Sun) |
+| Earned today | paid seconds today × second wage (capped at the daily wage) |
+
+Ships with the **2026** China statutory holiday and make-up workday calendar
+([State Council notice](https://www.gov.cn/zhengce/content/202511/content_7047090.htm)); both lists are editable in the panel.
+
+## Install
+
+```bash
+dsh plugin --profile desktop add dsh-niuma
+```
+
+Or add it to your profile's `package.json` dependencies and `dsh.profile.bundles`, then fully quit and reopen DSH.
+**Plugins load at startup — a restart is required.**
+
+## Privacy
+
+No network calls, no telemetry. Your salary and schedule live in your local DSH settings only.
+
+## Compatibility
+
+- DSH 0.2.x (verified on 0.2.1-rc.2)
+- Node ≥ 22.19.0
+
+## Development
+
+```bash
+npm run setup    # link DSH base modules + esbuild (once)
+npm run build    # build lib/client.js (the built artifact is committed)
+npm test         # 5 checks: core / holidays / host smoke / client smoke / render smoke
+```
+
+See [`SPEC.md`](SPEC.md) for the implementation contract.
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# dsh-niuma · 牛马加速器
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/dsh-niuma.svg)](https://www.npmjs.com/package/dsh-niuma)
+
+> DSH（DeepSeek Harness）插件：把**实收月薪**换算成**每秒跳动的现金计数器**。
+> 上班摸鱼看一眼，今天的钱正在一秒一秒地长大；下班后它停住，提醒你「今天又白干了」还是「今天赚够了」。
+
+[English](README.en.md) | 中文
+
+---
+
+> **社区插件，并非 DeepSeek 官方插件。** 与深度求索（DeepSeek）无隶属、合作或背书关系。
+> 所有金额都是按你填的工资与工时**本地估算**，不是工资条、不是账单，不构成任何劳动/财务建议。
+
+![面板预览（浅色 / 深色）](docs/preview-light-dark.png)
+
+---
+
+## 它算什么
+
+填一次你的情况，面板每秒更新：
+
+- **今日已赚**：按秒累加的有效工作收益，4 位小数，肉眼可见地跳
+- **秒工资 / 分工资 / 时工资 / 日工资 / 周工资 / 月工资** 六档换算
+- **工作日口径**：周一至周五上班；**法定节假日不算工作日**；**调休上班日算工作日**
+- 节假日不算工作日 → 当月工作日变少 → **日工资更高**（这正是「牛马加速器」的核心体感）
+- 午休可设置起止，**可勾选午休是否算工时**；午休不算工时则午休期间金额冻结
+- 状态徽标：休息日 / 未上班 / 搬砖中 / 午休中 / 已下班
+- 今日进度条、距上班/距下班倒计时
+
+### 口径公式
+
+| 指标 | 公式 |
+|---|---|
+| 日有效工时 | （下班 − 上班）−（午休启用且不计薪 ? 午休时长 : 0） |
+| 当月工作日数 | 当月内「周一至周五，扣除法定节假日，加上调休上班日」的天数 |
+| 日工资 | 实收月薪 ÷ 当月工作日数 |
+| 时工资 | 日工资 ÷ 日有效工时 |
+| 分工资 / 秒工资 | 时工资 ÷ 60 / ÷ 3600 |
+| 周工资 | 日工资 × 本周（周一~周日）工作日数 |
+| 今日已赚 | 今日有效工作秒数 × 秒工资（封顶日工资） |
+
+默认内置 **2026 年**法定节假日与调休上班日，来源：
+[国务院办公厅关于2026年部分节假日安排的通知（国办发明电〔2025〕7号）](https://www.gov.cn/zhengce/content/202511/content_7047090.htm)。
+跨年后可在面板里直接编辑「节假日 / 调休上班日」（一行一个 `YYYY-MM-DD`）。
+
+## 安装
+
+```bash
+# 在 DSH profile 里安装（包名：dsh-niuma）
+dsh plugin --profile desktop add dsh-niuma
+```
+
+或写进 profile 的 `package.json` 依赖与 `dsh.profile.bundles` 后重启 DSH。
+**插件是启动时加载的，安装/升级后必须完全退出并重开 DSH。**
+
+## 使用
+
+1. 打开 DSH 侧栏 → 点 **牛马** 图标
+2. 展开「设置」：填实收月薪、上下班时间、午休时间，勾选午休是否算工时
+3. 保存后回到顶部看「今日已赚」按秒滚动
+
+## 隐私
+
+- 不联网、不上传、不统计。工资、作息只存在你本机的 DSH 设置里。
+- 面板所有数字（除了节假日表）都由本机时间实时计算。
+
+## 兼容性
+
+- DSH 0.2.x（开发与验证版本：0.2.1-rc.2）
+- Node ≥ 22.19.0（DSH 自带运行时满足）
+
+## 开发
+
+```bash
+npm run setup    # 链接 DSH 基座模块 + esbuild（只需一次）
+npm run build    # 构建 lib/client.js（构建产物必须入库）
+npm test         # 5 项自检：core / holidays / host 烟测 / client 烟测 / 渲染烟测
+```
+
+`lib/client.js` 是构建产物，源码在 `src/client/index.js`；宿主半侧在 `lib/index.js`，纯逻辑在 `src/core.mjs`。
+实现契约与验收口径见 [`SPEC.md`](SPEC.md)。
+
+## License
+
+MIT

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,20 @@
+# Third-Party Notices
+
+dsh-niuma 本身以 MIT 协议发布（见 `LICENSE`）。
+
+## 运行时依赖
+
+**无。** 插件运行时不带任何第三方 npm 依赖：宿主半侧只 import DSH 本体提供的服务
+（`@deepseek-ai/schemastery` 为可选依赖，动态加载失败即降级），浏览器半侧由 DSH 外壳注入 React。
+
+## 构建期依赖
+
+| 包 | 用途 | 协议 |
+|---|---|---|
+| [esbuild](https://esbuild.github.io/) | 构建 `lib/client.js` | MIT |
+| [@deepseek-ai/schemastery](https://www.npmjs.com/package/@deepseek-ai/schemastery) | 宿主侧设置 schema（来自 DSH 本体） | 见 DSH 许可 |
+
+## 数据来源
+
+- 2026 年法定节假日与调休上班日：国务院办公厅《关于2026年部分节假日安排的通知》（国办发明电〔2025〕7号），
+  <https://www.gov.cn/zhengce/content/202511/content_7047090.htm>（政府公开信息）。

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# dsh-niuma bundle patch：把自己插进 DSH 的 profile 层栈。
+# 宿主半侧（Node）从这里被 Loader 加载；浏览器半侧由 package.json 的 dsh.client 声明。
+#
+# row id 必须唯一：内核 @deepseek-ai/dsh-base 已经占了 `niuma` 之外的常用 id，
+# 这里统一用 `niuma`，与包名去前缀一致。
+- insert:
+    - id: niuma
+      name: 'dsh-niuma'
+      config:
+        # 留空即用默认值（见 tools 里的 schema / README）。
+        # 想改默认值可以在这里写，例如：
+        # monthlySalary: 12000
+        # workStart: '09:30'
+        # lunchPaid: true
+        {}