如何给DSH小鲸鱼挂件贡献代码分支策略、Issue与PR规则的完整指南【免费下载链接】DeepSeek-Balance-Whale-WidgetDeepSeek HarnessDSH一只住在 DSH 界面右下角的小鲸鱼娘帮你盯着DeepSeek账户余额。QQ弹弹支持拖拽吸附、左吸附翻转、数字滚动动画随界面自动启用建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-WidgetDeepSeek-Balance-Whale-Widget 是 DSH 小鲸鱼余额挂件DSH Whale Widget一只住在 DeepSeek HarnessDSHWeb 界面右下角的小鲸鱼娘帮你盯着 DeepSeek 账户余额、今日已用和每轮对话消耗。本文是一份面向新手的贡献代码完整指南讲清楚三条分支怎么选、Issue 怎么提才不被白做、PR 必须满足哪些规则让你第一次提 PR 也能顺利合入。动代码前先认识仓库结构贡献前先花一分钟熟悉几个关键文件完整说明见 CONTRIBUTING.md文件作用package.json插件元数据npm 包名dsh-whale-widget发布版本号就写在version字段里cordis.patch.yml插件挂载声明DSH 启动时按它把挂件插进 Web profilelib/index.js宿主侧本体23 条路由 记账接线 音效/图片/角色服务约 3,953 行lib/accounting.mjs记账内核定点金额运算 余额观测/校正账本assets/whale-widget.js前端挂件本体约 16,853 行宿主按 mtime 热读这个单文件whale-widget-prompt.md完整规格、视觉参数、路由清单二次开发的入口文档tools/z-layer-audit.mjs浮层 z 层级自检脚本CI 与发布流程都会跑 如果你的 PR 更新了仓库结构请顺手更新 CONTRIBUTING.md 里的「仓库结构」一节保持最新。分支策略三条分支怎么选本仓库有三条互不兼容的产品线选错分支的 PR 会被直接关闭你要改的东西用哪条分支说明DSH Web 界面里的挂件主产品mainnpm 包dsh-whale-widgetCodex 桌面伴随挂件For-Codexnpm 包api-balance-whale独立维护Windows 桌面版TauriFor-WinDesktop—三条要点记牢平台移植类改动必须提到对应分支提到main会被关闭三条分支未来会整合成同一个 —— 除非你的多平台重构方案 issue 通过了维护者批准main和For-Codex各自独立维护无共享代码、无跨分支依赖。Issue 规则怎么提才不白做Issue 是贡献的起点项目对 Issue 的态度写得很直白bug 一定会修✨功能建议不一定会采纳—— 目的是避免代码无限变臃肿 提 issue 时请明说是你自己想实现这个 issue还是希望维护者或别人帮你实现未来的 feat新功能/ refactoring重构PR必须关联到已被维护者批准的 issue否则会被关闭。所以流程建议是先提 issue 说明想法 → 等维护者认可 → 再动手写 PR。PR 规则三条红线必须守住必须关联 issue 并写close #编号这是硬性要求没有关联的 PR 无从审查区分 bug 与 feat自由发起任何关联 bug-issue 的 PR但 feat / refactoring 的 PR 必须关联已批准的 issue否则关闭PR 正文要自己写可以完全用 AI 发起 PR项目对 AI 很友好但正文描述必须由你自己写清楚做了什么完全由 AI 生成的 PR 可能被关闭。代码风格要求简洁、解耦仓库里 assets/whale-widget.js 和 lib/index.js 已经很大维护者计划在慢慢拆分。在拆分落地之前请按拆分友好的方式写代码新逻辑尽量自成一块、少依赖全局状态不要加深既有耦合别增加后续拆解难度。本地开发两条命令跑起来克隆仓库后用link:.把当前目录以插件方式挂进 DSH即可边改边看效果git clone https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-Widget cd DeepSeek-Balance-Whale-Widget dsh plugin --profile web add link:.两种改动的生效方式不同改了什么生效方式前端assets/whale-widget.js硬刷新页面CtrlF5即可宿主lib/index.js/ lib/accounting.mjs必须重启dsh web提交前建议自查一下 CI 会跑的内容详见 CONTRIBUTING.md图层审计对应 tools/z-layer-audit.mjs前端 / 宿主文件的语法检查「发布副本不得含开发机绝对路径」扫描 —— 你的新代码里不要写死本机路径。发布流程速览改版本号前必读如果你是维护者或想理解发版逻辑记住这几点完整说明见 CONTRIBUTING.md发布是手动触发的push 不会发版publish.yml只在 GitHub Actions 页面手动运行支持dry_run演练跑完全部门禁但不真发版本号不自动递增发出去的版本号就是 package.json 里的version字段需要人手动改发布副本必须先 strip发布前要跑一次_strip-dev-paths.mjs --apply删掉开发机候选路径否则老用户会读到不存在的本机路径只允许在main上触发发布选错分支 workflow 会硬失败。动 assets/ 素材前先看许可边界PROVENANCE.md 明确了代码是 MIT但assets/下的图片 / 动图 / 音效不在 MIT 覆盖范围内仅供运行本插件使用、不授予再许可。所以贡献素材时要格外谨慎收到权利主张时项目会立即替换或移除。总结贡献四步走 读 CONTRIBUTING.md 与 whale-widget-prompt.md选对分支 先提 issuebug 放心提feat 等批准 写 PR 时关联 issue、写close #编号正文自己写代码保持简洁解耦 前端改动硬刷新验证、宿主改动重启dsh web提交前自查 CI 三项检查。祝你的 PR 顺利合入小鲸鱼娘会记得你 【免费下载链接】DeepSeek-Balance-Whale-WidgetDeepSeek HarnessDSH一只住在 DSH 界面右下角的小鲸鱼娘帮你盯着DeepSeek账户余额。QQ弹弹支持拖拽吸附、左吸附翻转、数字滚动动画随界面自动启用建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-Widget创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考