概览
dsh-whale-tools
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
**已验证** - 抠图流水线在本机跑通（610×610 透明 PNG，结果 md5 与预览一致）； - 设置项、头部按钮、心跳的桩测试通过；`dump-config` 退出码 0； - 2026-09-13 加固后的实测（桩测试，只读）：跨站 `Origin`、隧道 `Origin`、外部 `Referer`、 缺标识头 —— 四种情况全部 403；回环 `Origin` + 标识头放行；非电脑端 `/status` 不再返回 `md5`； 上传非图片被 magic bytes 拒；`apply.sh` 的默认/`--patch`/`--revert`（逐字节还原）/`--check` 四种模式与 `exit 2`/`exit 3` 分支均按预期； - 手机端拖动修复：作者真机确认可用（代码层面无法用合成事件验证）。 **已知限制** - `dsh-whale-widget` 在**模块 import 期**就定死了 `IMAGE_CANDIDATES`，所以「打补丁」这件事 要到**下一次重启**才生效；本插件的浏览器半因此做了主防线（直接改 `img.src`）， 不再依赖补丁才能换图； - pnpm 重链会冲掉对 `node_modules` 里挂件的任何手改，所以**补丁会丢**；但换图本身不依赖补丁 （浏览器半直接改 `img.src`），补丁只是可选的第二道防线，故默认不打、也不再自动重放； - 抠图对「白底、单一主体」的图效果最好；复杂背景可能残留杂边，可调 `tools/dsh-whale-mascot-cutout.cjs` 里的阈值与裁剪比例参数； - 「重启 dsh」按钮依赖 systemd user 服务名 `dsh-web-profiled.service`（写死在 host 半， 要换服务名请自行改 `lib/index.js`）。 ---