docs: record HEL-753 joint type validation

Co-authored-by: multica-agent <github@multica.ai>
This commit is contained in:
leefer
2026-10-22 02:39:47 +08:00
co-authored by multica-agent
parent b02c50fdf7
commit a666f6bd12
@@ -0,0 +1,35 @@
HEL-753 完成指定搭景类型修复,等待审核;整份 PR #5 仍未验收。
## 范围与实现
沿用 `fix/hel-750-code-checks`,起点 `e49b8b0072558fd27359d5d058eed47efa315543`;目标仍是 `feat/hel-730-management@64c1116bca1150e413ab51151bade6844f1ec914`。已读取 HEL-727 架构交接;不修改页面、CSS、接口、依赖或用户配置。
- `mannequin-js.d.ts` 根据实际安装的5.2.3源码补齐 `Mannequin extends THREE.Group`、三种人物的继承与身高构造器、有限具名关节与数值访问器、手指mid/tip、Posture契约。删除四处任意索引签名,以及原声明中不存在于人物本身的select;select属于Joint。
- `jointConfig.ts` 用27个真实关节键、6个数值访问器、mid/tip目标约束访问;Object3D调用边界用in/instanceof/typeof逐项窄化,不用断言。25个编辑区、79个DOF及范围值与旧配置完全一致;pelvis/neck保持可寻址但不进入UI或v7存储。
- `mirror.ts` 复用同一数值读写边界,保留命名角度、左右符号、手指turn与分节、单点/整链顺序;`posture.ts` 明确读写接口,复用既有v7校验器窄化第三方posture返回值,保持四个lossy关节XYZ与角度换算。
缺失关节/分节/数值访问器安全退出,读取仍回退0,写入不创建伪字段;非法第三方姿态现在明确报错,避免强转为合法Posture。合法实例的读写/镜像/姿态往返与旧实现逐项一致。不新增any别名、unknown后断言、双重断言或随意索引签名,不关闭规则。
## 自测
环境 Node24.16.0 / npm11.13.0,Linux;实际包版本与锁文件不变。干净安装后依次运行:
| 命令 | 退出码 | 结果 |
|---|---:|---|
| npm ci | 0 | 干净安装 |
| npm run lint | 1 | Prettier通过;ESLint174 errors / 0 warnings |
| npm run check | 0 | 0 errors / 原有1个字幕warning |
| npm test | 0 | 四组现有检查通过 |
| npm run build | 0 | 构建成功 |
对照HEL-752原始诊断的文件/规则/行列/消息:188→174,仅移除指定14个no-explicit-any,新增0,其余174条逐项完全相同。剩余87导航resolve、48列表key、25响应性类、10命令式DOM、3只读state、1字幕编译诊断;无扩排除、删脚本或规则压制。
独立TypeScript契约检查开启strict并关闭skipLibCheck,正反用例通过:人物继承/构造器/数值/姿态有效;任意字段、错误访问器/分节/手指编号和figure.select被拒绝。
隔离Chromium页面使用真实factory与Male/Female/Child实例:每种25关节、79个DOF各min/mid/max与旧helper对照,比较数值、完整序列化姿态与世界矩阵;逐关节双向单点/整链镜像;含lossy XYZ的JSON往返;缺失/非法边界;真实WebGL选择、编辑、镜像、渲染及PNG导出均通过,无pageerror。169466是递归标量断言数,不作为独立业务用例数。未调用后台生成/收费服务、未修改用户数据;未冒称整站交互或视频导出端到端回归。浏览器及测试服务已关闭。
任务附件提供14处逐项源码依据、原包关键源码与SHA256、完整检查日志、诊断差集/剩余清单、类型契约与浏览器复现脚本、截图/PNG、完整patch和待更新PR正文。只在本卡交接,总管统一维护PR正文。不合并、不部署,不启动其他批次。
## 回滚
本卡代码与记录分提交;按本卡提交逆序git revert可回到e49b8b0,保留既有历史。无数据迁移、无部署,不reset或强推。