From a666f6bd12cd437629cd52debadbd9da79b67f57 Mon Sep 17 00:00:00 2001 From: leefer Date: Thu, 22 Oct 2026 02:39:47 +0800 Subject: [PATCH] docs: record HEL-753 joint type validation Co-authored-by: multica-agent --- .../2026-10-22-hel753-joint-types.md | 35 +++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/changelogs/2026-10-22-hel753-joint-types.md diff --git a/docs/changelogs/2026-10-22-hel753-joint-types.md b/docs/changelogs/2026-10-22-hel753-joint-types.md new file mode 100644 index 00000000..df7613a9 --- /dev/null +++ b/docs/changelogs/2026-10-22-hel753-joint-types.md @@ -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或强推。