# half-half **Repository Path**: sublimator/half-half ## Basic Information - **Project Name**: half-half - **Description**: 一半一半,两个人一起控制,每人控制一半的小游戏 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 一半一半 · Half & Half 一具布娃娃,两条腿。左半边归你,右半边归我 —— 谁也没法一个人把它走成路。 这是《一半一半》的可玩原型,用纯 HTML + Canvas 实现,双击 `index.html` 就能玩,不需要构建、不需要装东西。 线上地址:**** 当前版本 **v0.4.2**。**页面最上方**有一条版本标签,显示版本号 + 这一版的构建时间;鼠标悬停能看到完整 build id。底部保留 `Powered by Linzhennan · © 2026`。 --- ## 怎么玩 ### 一起玩(各用一台手机) 1. 一台手机打开 ,点 **「📱 联机」** 2. 另一台手机用**相机扫屏幕上的二维码**,直接进同一个房间 3. 两台手机各控制一半,开始 扫码那台是右腿(B),开房那台是左腿(A)。连上后两台手机看到的是同一具身体, 状态由开房的那台计算并广播,所以永远同步。 ### 同一块屏幕 两个人挤在一台设备前(手机、平板、笔记本都行),每人对着一半屏幕。 | | 左腿 / 左臂 | 右腿 / 右臂 | |---|---|---| | **键盘** | `A` `D` | `←` `→` | | **端蛋糕关的手臂** | `W` `S` | `↑` `↓` | | **触屏** | 按住屏幕左半边上下拖 | 按住右半边上下拖 | **核心节奏**:你的输入直接决定「这条腿指向哪里」。往前推 = 脚往前抬,往回拉 = 蹬地。 一条腿抬起来的同时另一条必须落地 —— 两条腿差半步(反相)才走得动,两个人一起抬就会劈叉摔倒。 **手机上**:按住屏幕上下拖,拖 105 像素到满幅;**轻点一下 = 迈一小步**(不用非得拖)。 按下之后会跟着手指画一个圈、拉一条轨道、旁边实时显示「腿 · 抬起 62%」, 底部面板两端也标着「‹ 蹬地 / 抬腿 ›」,不用猜。 端蛋糕关屏幕最下面那条带子是「手」,会单独高亮,上面写着「按住这条带子上下拖」。 联机时你的 HUD 那一格里显示的是**你自己的输入**,手指一按就有反馈,不用等对面的包回来。 **换关**:游戏里左下角「关卡」按钮,或者直接按数字键 `1`–`6`。联机时两个人谁点都行, 客机选的关会发给主机,由主机统一切,两边不会各跑各的。 盯着右上角的**同步盘**:两个点转到面对面(差 180°)就是稳的;贴在一起就是乱的。 --- ## 六个关卡 | 关 | 名字 | 目标 | 这一关在教什么 | |---|---|---|---| | 1 | 学走路 | 平地走 3.2 m | 建立相位差:你必须等对方 | | 2 | 端蛋糕 | 走 5.2 m 不碎 | 两只手高度差超过 15° 蛋糕就裂 | | 3 | 独眼 | A 的屏幕黑 5 秒 | 逼出语言:看得见的人得开口 | | 4 | 钢丝 | 走 3.2 m | 抬腿超过 26° 就翻下去,小步慢走 | | 5 | 交换 | 中途交换控制权 | 把一半身体交给别人 | | 6 | 两人三足 | 60 秒走 26 m | 腿被绑着,只能快不能大 | --- ## 实现说明 ### 自适应难度(摔多了会变简单) 文档 9 节提到的"三级辅助"实现成了**自动升降**,不用手动开: | 等级 | 什么时候开 | 效果 | |---|---|---| | 辅助 1/3 | 本局摔了一次,或这一关失败过一次 | 判定放宽容(髋高 0.42→0.30、双脚离地 0.42→0.75s)、两张卡都放宽、摔倒概率 ×0.5、身体会被自动扶正 | | 辅助 2/3 | 失败两次 | 摔倒概率再降到 ×0.28 | | 辅助 3/3 | 失败三次 | 再加**慢动作**(物理按 0.55 倍速跑),摔倒概率 ×0.15 | 等级 = 这一关历史失败次数 + 本局摔倒数,封顶 3。HUD 上会显示「辅助 2/3」的徽标, 开局引导里也会说明当前开了什么。辅助只放宽判定,不改核心规则 —— 同相抬腿照样会劈叉。 ### 开局引导 每关第一次进、以及**同一关失败两次之后**,会先弹一张引导卡: - 三到四步的具体操作(怎么拖、什么时候抬腿、这一关的坑在哪) - 当前辅助等级说明 - 按钮会变成「再来一次」 游戏里还有一条随堂提示(底部深色胶囊),按状态给话:开局教手势、站着不动提醒"一次只抬一条腿"、 两个人同步率太低提醒"错开半拍"、走起来就夸一句。 ### 文件 - `sim.js` —— 物理与规则内核。**纯函数、无 DOM、60Hz 定步长、不读时间也不读随机数**,所以同样的输入序列一定得到同样的结果(文档第 10 节要的确定性 / 帧同步前提)。 - `net.js` —— 联机:房间码 + 二维码 + WebRTC。 - `game.js` —— 渲染、输入、关卡流程。 - `tools/worker.js` —— Cloudflare Worker:静态资源 + 信令中转(Durable Object)。 - `test-sim.js` / `test-levels.js` —— 无头回归测试,`node test-sim.js` 跑。 ### 联机是怎么做的 **信令只用来配对,不碰游戏数据。** 1. 主机要一个 5 位房间码(去掉 I/O/0/1),把房间码拼成 `/?r=CODE` 生成二维码 —— 因为二维码里只有一条几十个字符的链接,模块能画得很大,一扫就开。 2. 主机把 WebRTC offer 存进 Durable Object(一个房间一个实例),客机扫到链接后轮询取走 offer,回一个 answer,配对结束。 3. 通道打通后: - **主机**跑物理,每帧把状态(髋、两只脚、身体倾角、同步率、进度、蛋糕…)广播出去; - **客机**只把输入(一个数字)发过去,渲染收到的状态。 这种"主机权威"的做法不用处理浮点漂移 —— 两台设备显示的一定是同一个结果。代价是客机的操作会多一个单程延迟,局域网里感觉不到。 信令用的是非 trickle(等 ICE 收齐再一次性发),所以没有逐条 candidates 的管道,代码短、失败点少。STUN 用 Google 公共节点;**没有 TURN**,所以极少数对称 NAT 网络下会连不上。 ### 手机上的处理 - 一台手机一个人:整块屏幕都是自己的控制区,不再左右分屏(`localSlot()`)。 - 切后台时立刻发一次归零输入,免得对方看到一条卡住的腿。 - 竖屏单独算镜头缩放,控件避开刘海和 Home 条(`env(safe-area-inset-*)`)。 - 二维码按设备像素比绘制,保证每一格都是整数像素、边缘锐利。 ### 物理是怎么做的 不是给每条腿一个动画,而是真的把身体当成一具骨架子: - 髋是一个质点,受重力和两条腿的**长度约束**(PBD,位置求解)。 - 每条腿是一条刚性连杆:脚落地就被钉住(x 锁死、只允许被抬起来),于是**髋只能绕着那只脚转** —— 这就是"抬一条腿会拖动整个身体"的来源。 - 玩家推的是「腿的角度」,脚和髋之间按力矩分配受力:脚被钉住时,反作用力全部变成对身体的推进力。 - 屈髋时膝盖会弯,脚离地 → 进入摆动;落地瞬间重新钉住。摔倒 = 髋掉到 0.42 m 以下、两脚同时离地超过 0.42 秒、或同步率过低在移动中绊倒。 ### 规则是怎么对上文档的 - 同步率 `S = -cos(Δφ)`(文档里写的是 `cos(Δφ)`,此处把相位差取成"与 180° 的偏差",语义一致):`S ≥ 0.7` 满速,`0.3 ≤ S < 0.7` 摇晃并降速,`S < 0.3` 按文档的 `P = clamp((0.3−S)×2.4, 0, 0.72)` 折算成每帧绊倒概率。 - 同步差的时候腿的驱动力也会变弱 —— 两个人打架,谁也迈不动。 - 一条腿完全不动而身体在前进 = "拖行",会被额外阻尼,逼两个人一起动。 - 摔倒 1.5 秒爬起动画期间输入无效(文档 5.3),三次摔倒判负。 ### 和文档不一样的地方 - **两台手机:已支持,但不是"帧同步"。** 原案要求 lockstep + 输入帧广播。原型用更省心的主机权威模型:只有主机算物理,客机发输入、收状态。输入延迟多了一个单程,但完全不担心两端算出不同结果。另外两台手机看到的都是完整身体(不是原案里"只渲染自己那半边"),因为不看全身根本没法配合。 - **陀螺仪 → 触屏拖动 / 键盘。** 倾斜在网页里拿不到稳定的双人输入,就换成了直接的位置映射(拖多远 = 腿抬多高),手感更接近 QWOP 那种"关节直接听你的"。 - **第 3 关的"黑屏"** 变成遮住屏幕左半边 —— 同一块屏上,这是"让 A 看不见"最接近的做法。 - **第 6 关** 用"步幅过大互相拽"代替真正的绑腿约束。 ### 可以继续做的 - 交换关卡里加入"只能靠对方描述"的语音提示层 - 双人分屏联网(`sim.js` 已经是确定性定步长的,接一个 lockstep 传输层就能联机) - 手感参数(`DRIVE_K`、`THETA_RATE`、抬脚速率 2.6 等)都集中在 `sim.js` 顶部,真人试玩后直接调那几个数。 --- ## 部署 线上:(Cloudflare Worker + Static Assets,自定义域名) ```bash npm install && npm run deploy ``` `npm run deploy` = 构建 `dist/` → 注入版本标记 → `wrangler deploy` → 线上 HTTP 校验(200 且 HTML 含本次 build-id,否则失败退出)。 部署配置(`wrangler.worker.jsonc`、`tools/worker.js`、`tools/deploy.mjs`)与凭据只留本机,已 gitignore;账户与排错记录见 `docs/Cloudflare部署与配置.local.md`。 ## 版本 版本号在 `package.json` 的 `version`,`npm run build` 会把它连同构建时间注入页面: ```html ``` 首页底部读这几个 meta 显示成 `v0.3.0 · 2026-11-13 10:19`;本地直接打开源码(没跑 build)时用 `index.html` 里的默认文字。`npm run deploy` 的线上校验也会核对这个版本号。 | 版本 | 时间 | 内容 | |---|---|---| | v0.1.0 | 2026-11-12 | 六关 + 物理内核 + 同屏双人 | | v0.2.0 | 2026-11-13 | WebRTC 联机 + 二维码配对 | | v0.3.0 | 2026-11-13 | 首页版本号 / 构建时间 / 版权信息 | | v0.3.1 | 2026-11-13 | 键盘输入加爬坡(短按=小步),钢丝关从此键盘也能过 | | v0.4.0 | 2026-11-13 | 任意选关 + 通关提示;触屏加固(canvas 上补 touch-action)、轻点迈小步、联机本地输入回显 | | v0.4.1 | 2026-11-13 | 结算页也加「选关」,关卡按钮显示当前进度(之前结算卡片挡住屏幕,手机上换不了关) | | v0.4.2 | 2026-11-13 | 版本号移到页面最上方做成显眼标签(版本 + 构建时间) | | v0.5.0 | 2026-11-13 | 自适应难度(摔多了自动开三级辅助,含慢动作)+ 开局引导卡 + 随堂提示 | | v0.5.1 | 2026-11-14 | 操作反馈:按住时手指圈 + 轨道 + 实时数值,面板标「蹬地 ‹ › 抬腿」,手部带子单独高亮,开局手势动画 | ## 开发 ```bash npm test # 无头物理回归:反相能走、同相必摔、站着不倒、各关可通关 ```