D友の酒 · Dyou Wine

面板保持 320 px 的简洁布局，只提供两个效果开关、三个档位、原梗 BGM，以及开喝／暂停／醒酒。不提供本地音频上传或高级参数编辑入口。

启动控制器时保留预设和三个开关，并将高级参数恢复默认：BPM 120、相位 0、强度 65、玩偶 180 px 与 180 px/s、所有区域开启、后台不播放、Escape 停止、循环 true。旧的范围关闭或强度为零设置不会让效果继续消失；底层设置校验和音频资源路径保留，供兼容 API 与测试使用。

设置保存在 localStorage 的 dsh-dyou-wine.settings.v1，同一浏览器源下的 profile 共用设置。清除这一条即可恢复默认参数。pageEnabled／petEnabled 独立，musicEnabled 默认 false；旧 mode: 'pet' 迁移为界面关／玩偶开，旧 mode: 'page' 迁移为界面开／玩偶关，明确布尔值优先。

玩偶沿用 Alpha.6 的蓝白鲸鱼娘毛绒形象：深蓝长卷发、浅蓝发梢、鲸鳍耳、蓝色大眼与白围裙鲸纹，通过 imagegen 生成，不宣称官方角色素材。外层匀速推进位置，左右碰撞反转水平速度，上下碰撞反转垂直速度；内层按固定周期反向缩放 X／Y。界面每拍平滑压矮、拉高并复位，底部固定，不逐帧随机变速、错相或改幅度。

文字按块参与，不拆字、不重建宿主 React DOM。父级参与时带动子区域，避免叠加形变；被父级带动不等于每个子节点都有独立动画。Alpha.8 扩充了普通 div／span、页头与侧栏文字、行内图片和 SVG 等候选，仍只对可见且能安全处理的目标生效。交互保护解除后按统一相位重新加入，未知宿主版本或缺少必要标记会提示兼容问题，无法保证所有第三方插件都被覆盖。120 个目标是工程预算，不能替代真实物理性能、Windows IME、模型流式、审批交互与 Desktop 壳的分别验收。

暂停与后台暂停保留音乐进度，醒酒／Escape 回到开头，卸载释放媒体资源。Alpha.9 移除了左下角视频；Alpha.13 将媒体拆为包内独立文件，音乐支持字节 Range 请求，不占据客户端 JavaScript 入口。

演示 GIF 为 800 × 500、15 fps、12 秒原速无声循环，源码路径 docs/assets/demo.gif。npm README 使用同一 GitHub 图片地址；GIF 和赞助 Logo 仅在 GitHub 源码中，npm 安装包不携带这两张展示图片。

从 Alpha.14 Release 下载 dsh-dyou-wine-0.1.0-alpha.14.tgz：

dsh plugin --profile web add ./dsh-dyou-wine-0.1.0-alpha.14.tgz --ignore-scripts

安装后重启 Host 并刷新页面。已有 Web profile 可用 dsh plugin --profile 你的profile add 安装包绝对路径 更新，这会影响该 profile 的全部会话。

从源码构建：

npm ci
npx playwright install chromium
npm run check
npm pack --ignore-scripts

生成 dsh-dyou-wine-0.1.0-alpha.14.tgz。推荐在独立 DSH home 和 Web profile 先试用；下面是 PowerShell 示例：

$env:DSH_HOME = Join-Path $PWD '.qa/dsh-home'
dsh --version
dsh --profile dyou-wine-test --from-default-profile web --dump-config
$wineTarball = Join-Path $PWD 'dsh-dyou-wine-0.1.0-alpha.14.tgz'
dsh plugin --profile dyou-wine-test add $wineTarball --ignore-scripts
dsh --profile dyou-wine-test --dump-config
dsh --profile dyou-wine-test --no-open --host 127.0.0.1 --port 0

按 Host 日志打开 Web 地址，依该 profile 的认证提示登录。DSH_HOME 只影响当前终端及其子进程。CLI 安装依赖并注册 bundle；修改后没有宿主 HMR 时，重启 DSH 并刷新浏览器。

卸载前点击「醒酒」，然后执行，并在需要时重启 Host、刷新页面：

dsh plugin --profile dyou-wine-test remove dsh-dyou-wine

直接安装 GitHub spec 时应固定审查过的 tag／提交。DSH 使用 pnpm，源码包的 prepare 需要开发依赖和构建脚本；pnpm 10/11 可能拦截构建。仅在审核来源后，在目标 profile 的 pnpm-workspace.yaml 中保留原设置并允许确切包：

allowBuilds:
  dsh-dyou-wine: true

DSH 官方发布流程 · 本项目发布指南

Alpha.14 已公开，是 README 同步版；编译入口、玩偶图片和音频与 Alpha.13 逐字节一致。公开 alpha／latest 均指向 Alpha.14；版本仍是 Alpha，请按上方确切版本安装。Alpha.13 首次公开时删除 latest 返回 HTTP 400 的记录保留为历史。

npm 的 README 随版本保存，GitHub main 的文案更新不会改写旧包。这次通过新的 Alpha.14 包同步说明，原 Alpha.13 版本、tag 和发行附件保留。最新发布记录见 更新公告。

市场发现保留 dsh-plugin npm 关键词、dsh.bundle、已验证的 engines.dsh、中英文名称说明和图标；根 screenshots.json 指向真实画面。远程已设置 dsh-plugin Topic 与另外 8 个相关主题。

累计八项正式投稿（三个 PR、三个 Issue、两个网页表单）。dsh.pub、w211 与 dshplugin.online 已可查到 Alpha.13 快照，dsh-find-plugin 的实时 Community 搜索也能找到本插件；最新 Alpha.14 尚未同步到这些静态目录。本轮更新原三个 Issue 和 ydhrdh PR #17 的版本资料，另补投 Britneycode PR #1。其余审核、表单队列、Hub 预检故障与 Awesome 准入限制见 市场状态；社区来源和自动契约检查不等于人工审核。

开发命令：

npm ci
npm run dev
npm run typecheck
npm test
npm run build
npx playwright install chromium
npm run test:browser
npm run pack:check

npm run check 依次运行类型检查、单元测试、构建、浏览器测试、市场资料与包白名单检查。修改运行时代码后先构建，将 lib/host.js、lib/client.js 与两份 lib/assets 资源加入同一待提交变更；市场自检比较 Git 暂存区与构建内容，CI 验证已提交产物。Linux 首次可运行 npx playwright install --with-deps chromium。

模拟页：http://127.0.0.1:4179/tests/fixture/，并非实际 DSH。真实隔离宿主检查：node scripts/dsh-smoke.mjs --tarball ./dsh-dyou-wine-0.1.0-alpha.14.tgz，CLI 自动发现本地或全局安装，特殊布局可加 --dsh-bin /absolute/path/to/dsh/lib/bin.js；60 秒对照单独运行 npm run benchmark。测试记录 分别记载模拟页、真实宿主及其他验收边界。

复现演示需要 DSH、Playwright Chromium 和 PATH 中的 FFmpeg：构建、打包后运行 npm run demo:record -- ./dsh-dyou-wine-0.1.0-alpha.14.tgz。脚本创建新的隔离 DSH home 和测试会话，录制原速双效果及两个方向的反弹，导出 docs/assets/demo.gif；原录屏和采样报告留在忽略提交的 .qa/demo/。

客户端由宿主 ModuleLoader 加载，使用宿主 React，以独立 id 注册 shell.overlay。DOM 版本适配不依赖构建后 CSS 哈希。GitHub Actions 在 Ubuntu／Windows Node 24 运行检查；npm 工作流仅手动触发，上传代码或 tag 不会自动发布 npm。

需求和设计：PRODUCT.md · DESIGN.md。完整原策划案保存在源码仓库，不进入 npm 安装包。