ShenpingDD/wooden-fish-dsh

🪵 电子木鱼桌宠 · Wooden Fish Pet（DeepSeek Harness 插件）

为 DeepSeek Harness Web 界面打造的一只可点击的「电子木鱼」。 它不是卡通人物，而是一件案头小木器——随时点一下，系统自动按天记录敲击次数，设置页里可以看到每日趋势。

English

---

✨ 功能

• 悬浮木鱼：页面右下角常驻，可自由拖动，点击敲击
• 敲击反馈：木鱼晃动 + 木槌朝左敲落 + 声波环 + 「+1」飘字
• 悬停木鱼显示「今天已敲 N 次」
• 按天计数（YYYY-MM-DD 分桶），持久化到 $DSH_HOME/wooden-fish-data.json，重启不丢
• 设置 → 电子木鱼：今日 / 累计 / 连续天数卡片 + 日历热力图（近 3 / 6（默认） / 12 个月，5 档木色、月份 + 星期标签、悬停看数值、今日描边、范围摘要行）
• 记住你的设置：木鱼位置与显隐状态刷新后保持
• 跟随主题：外壳使用 harness 主题 token（--dsw-alias-*），自动匹配浅/深色与自定义主题（如 sakura）；木鱼与热力色阶保持木质本色
• 无横向滚动条：热力图等分占满容器宽度（短范围格子更大，一年视图自动压缩）
• 禅意木质风，纯本地零网络

⚠️ 暂无敲击音效，反馈以视觉为主。

📸 界面预览

交互演示：docs/preview-heatmap.html（浏览器打开——可拖动、敲击木鱼、切换热力图范围）

📦 安装

本插件是可直接安装的 web profile bundle 包。在 DeepSeek Harness 检出目录执行：

dsh plugin --profile web add --config.minimumReleaseAge=0 -w <本仓库路径>
# 然后重启 dsh

或直接从 GitHub 安装：

dsh plugin --profile web add --config.minimumReleaseAge=0 -w github:<owner>/wooden-fish-dsh
# 然后重启 dsh

重启后木鱼自动出现在右下角，之后每次启动自动加载，无需重新激活。

🎮 使用

💾 数据

存放于 $DSH_HOME/wooden-fish-data.json：

{ "version": 1, "days": { "2026-08-18": 10, "2026-08-19": 3 } }

• $DSH_HOME 为 Harness 数据主目录（默认 ~/.dsh）
• 纯本地、纯 JSON，方便备份或重置

🧱 工作原理

详见 ARCHITECTURE.md。

📚 文档

• docs/PRD.md — 产品需求文档
• docs/UI-DESIGN.md — 设计规格：令牌、状态、动效参数
• docs/wooden-fish-preview.html — 交互预览页（浏览器打开）
• docs/fish.svg — 木鱼美术稿
• CHANGELOG.md · DEVELOPMENT.md · SECURITY.md · CONTRIBUTING.md

⚖️ License

MIT