<div align="center">
🐂🐴 牛马修仙看板
DeepSeek Harness 工时统计 × 修仙养成 —— 把每一分钟劳动，都修成境界
<img src="https://img.shields.io/github/license/spacexun2/dsh-worktime-board?style=flat&label=License" alt="license"/> <img src="https://img.shields.io/badge/DSH-bundle-8257D0?style=flat" alt="dsh bundle"/>
</div>
牛马修仙看板是一个 DeepSeek Harness 工时统计插件，用于记录 agent 在各线程中的活跃时长、模型 token、用户输入和工具调用，并按日、周、月和学年汇总展示。插件通过修仙值和十二重境界呈现累计工作量，所有数据均保存在本地。
✨ 功能
🧘 工时统计与修仙进度
看板将活跃时长、模型 token、用户输入和工具调用汇总为修仙值，并通过十二重境界显示累计进度。夜间工作、连续活跃和突破奖励会计入进度。
> token 口径（v0.1.3）：「输入」= 计费输入（未命中缓存的 inputTokens + cacheRead + cacheWrite，与官方用量口径一致，含历史缓存命中）；token 计分统一按 1 万 token = 1 分换算（修仙值最终整体 ×15 展示尺度，阈值同步 ×15，境界节奏不变）。数据来自会话日志每条回复结算的 usage 字段，纯本地，无第三方统计。
<p align="center"> <img src="assets/day.png" alt="今日修仙值、境界与工时总览" width="402" /> </p>
境界十二重：炼气 → 筑基 → 金丹 → 元婴 → 化神 → 炼虚 → 合体 → 大乘 → 渡劫 → 真仙 → 金仙 → 宇宙洪荒
看板以右下角悬浮角标进入，支持时长 / 修仙值切换、忙碌呼吸灯、拖动位置、调整高度和一键收起。
「输入次数」卡片点击可在两种口径间切换：输入次数（含子 Agent 委托与注入消息）或人输入（仅真人发送的 prompt），切换只影响显示，不影响修仙值计分。
📊 日 / 周 / 月 / 学年统计
看板提供日、周、月和学年四种统计范围。日视图展示 24 小时分布；周视图汇总总修行、活跃天数、日均修行、token 和时间构成。
<p align="center"> <img src="assets/week-summary.png" alt="本周修行、活跃天数、日均修行与时间构成" width="369" /> </p>
月视图按自然周聚合，并支持查看时长、token 和修仙值。下图分别展示时长与 token：
<table> <tr> <th>时长</th> <th>token</th> </tr> <tr> <td><img src="assets/month-duration.png" alt="本月时长热力图" width="392" /></td> <td><img src="assets/month-token.png" alt="本月 token 热力图" width="392" /></td> </tr> </table>
学年年历覆盖每年 8 月 1 日至次年 7 月 31 日。点击任意日期，可以查看当天的境界、修仙值、时长、调用和 token。
<p align="center"> <img src="assets/school-year.png" alt="学年年历与单日详情" width="392" /> </p>
🔗 线程出勤与排行
线程出勤按会话展示活跃时段，并支持跳转到对应线程。卷王榜列出所选周期内活跃贡献最高的前三名。
<p align="center"> <img src="assets/threads-ranking.png" alt="线程出勤与本月卷王榜" width="392" /> </p>
🤖 Agent 查询工具
插件注册了 worktime_summary(range?, ranch?) 工具，线程和子 Agent 可以用它查询日、周、月摘要：
汇总本月工时，并告诉我最活跃的线程。📦 安装
本插件是标准 dsh bundle（声明了 dsh.bundle.patch + dsh.client），通过 profile 插件机制安装：
# 方式一（推荐）：npm 包（正式发布后）
dsh plugin --profile web add dsh-worktime-board
# 方式二：GitHub 源直接安装（构建产物 lib/ 已入库，无需本地构建）
dsh plugin --profile web add github:spacexun2/dsh-worktime-board
# 方式三：本地目录（有源码时，从插件目录的上一级执行）
dsh plugin --profile web add ./dsh-worktime-board安装后重启 DSH（dsh web），右下角出现 🐂🐴 角标即成功。
> 也支持 dsh-super-injector（超级模组）运行时注入：dev_inject_plugin <插件目录>，免重启。
🗂️ 数据
- 存储：
$DSH_HOME/worktime-board/data.json（5 分钟槽活动位图 + 调用/token 计数，60s 批量落盘） - 接口：
GET /plugins/dsh-worktime/state?range=day|week|month（client 轮询） - 隐私：全本地、零外发、不注入消息打扰
<details> <summary><strong>⚙️ 配置</strong></summary>
计分系数、数据保留天数等配置位于 $DSH_HOME/worktime-board/config.json，保存后热重载生效。
</details>
<details> <summary><strong>🛠️ 开发</strong></summary>
# 构建（无 DSH_CHECKOUT 环境；pnpm exec 会被 verify-deps 拦截，直接调二进制）
node node_modules/typescript/bin/tsc -p tsconfig.json # host → lib/
node node_modules/tsdown/dist/run.mjs # client → lib/client.js
node --test test/core.test.mjs # 单测（node 24 原生 TS，零依赖）- 依赖 junction：
node_modules/@deepseek-ai/{cordis,schemastery}→ 全局 dsh 内部 node_modules（必须用@deepseek-ai/*scope）。 - 注入调试：
dev_inject_plugin→ 刷新浏览器；dev_reload_package dsh-worktime-board热重载。
</details>
📄 License
MIT