feat(action): integrate upload_pipeline into upload-model-file action - zip -> tripo convert -> mixamo fbx (webpack alias + processTripoZip in Main.ts)

Author: yyc-git

contributes/meta3d-action-mod-unit-upload-model-file/src/Main.ts

@@ -8,12 +8,13 @@ import { importFile } from "meta3d-file-ts-utils/src/ImportFileUtils"
 import { getLanguageTextData, getLanguageTextVariableData } from "meta3d-language-utils/src/Main"
 import { languageKey, languageVariableKey } from "meta3d-language-utils/src/Type"
 import { model } from "meta3d-action-mod-unit-publish-to-game-protocol/src/UnitType"
+import { processTripoZip } from "bone_converter/src/tool/upload_pipeline"
 
 let _loadFBX = (api: api): Promise<[boolean, nullable<fbxName>, nullable<fbxData>]> => {
     return new Promise((resolve, reject) => {
         importFile((file: any, result: any) => {
-            if (!file.name.includes(".fbx")) {
-                reject(new Error("文件后缀名应该是.fbx"))
+            if (!/\.(fbx|zip)$/i.test(file.name)) {
+                reject(new Error("文件后缀名应该是.fbx或.zip"))
             }
 
             // resolve([true, api.nullable.return(file.name.slice(0, -3)), api.nullable.return(result as ArrayBuffer)])
@@ -84,6 +85,51 @@ export let getContribute: getContributeMeta3D<actionContribute<uiData, state>> =
                     return meta3dState
                 }
 
+                if (fbxName && fbxData && /\.zip$/i.test(fbxName)) {
+                    return processTripoZip(fbxData).then(({ fbxName: tripoFbxName, fbxData: tripoFbxData, report, warnings }) => {
+                        console.log("processTripoZip", tripoFbxName, report, warnings)
+
+                        let key = actionParams && actionParams.length > 0 ? actionParams[0] : null
+                        let initState = api.action.getActionState<initState>(meta3dState, initActionName)
+
+                        switch (key) {
+                            case "lod1":
+                                if (tripoFbxData.byteLength > 3 * 1024 * 1024) {
+                                    api.message.warn(getLanguageTextVariableData(api, meta3dState, initState.languageTextDataByVariable, languageVariableKey.LimitFileSize)(3))
+                                    return meta3dState
+                                }
+                                break
+                            case "lod2":
+                                if (tripoFbxData.byteLength > 1.5 * 1024 * 1024) {
+                                    api.message.warn(getLanguageTextVariableData(api, meta3dState, initState.languageTextDataByVariable, languageVariableKey.LimitFileSize)(1.5))
+                                    return meta3dState
+                                }
+                                break
+                            default:
+                                throw new Error("error")
+                        }
+
+                        return new Promise<meta3dState>((resolve, reject) => {
+                            let eventSourcingService = api.nullable.getExn(api.getPackageService<editorWholeService>(meta3dState, "meta3d-editor-whole-protocol")).event(meta3dState).eventSourcing(meta3dState)
+
+
+                            resolve(eventSourcingService.addEvent<inputData>(meta3dState, {
+                                name: eventName,
+                                isOnlyRead: true,
+                                inputData: [
+                                    uiData,
+                                    tripoFbxName,
+                                    tripoFbxData,
+                                    actionParams
+                                ]
+                            }))
+                        })
+                    }).catch((error) => {
+                        api.message.error(error)
+                        return meta3dState
+                    })
+                }
+
                 return new Promise<meta3dState>((resolve, reject) => {
                     let eventSourcingService = api.nullable.getExn(api.getPackageService<editorWholeService>(meta3dState, "meta3d-editor-whole-protocol")).event(meta3dState).eventSourcing(meta3dState)
 

contributes/meta3d-action-mod-unit-upload-model-file/webpack.config.js

@@ -18,7 +18,10 @@ module.exports = {
 
 	resolve: {
 		extensions: ['.ts', '.tsx', '.js', '.jsx', '.scss'],
-		modules: ['node_modules']
+		modules: ['node_modules'],
+		alias: {
+			'bone_converter': path.resolve(__dirname, '../../services/bone_converter'),
+		}
 	},
 
 	module: {

笔记/项目文档/issue/2026-08-07-dev-feat-upload-pipeline.md

@@ -7,10 +7,10 @@ workflowId: "wf-meta3d-upload-pipeline-001"
 stateFile: ""
 lastSyncedStateVersion: 1
 createdAt: "2026-08-07T07:35:00.000Z"
-updatedAt: "2026-08-08T01:10:00.000Z"
-status: "in_progress"
+updatedAt: "2026-08-08T09:30:00.000Z"
+status: "completed"
 totalSteps: 5
-completedCount: 4
+completedCount: 5
 ---
 
 # bone_converter 上传管线封装
@@ -22,18 +22,18 @@ completedCount: 4
 | 工作流 | gts-dev-feat（gts-auto 全自动模式） |
 | Workflow ID | wf-meta3d-upload-pipeline-001 |
 | 项目 | Meta3D |
-| 状态 | in_progress |
+| 状态 | completed |
 | 创建时间 | 2026-08-07 15:35 (UTC+8) |
 
-## 步骤进度 (4/5)
+## 步骤进度 (5/5)
 
 | 步骤 | 状态 | 完成时间 |
 |------|------|----------|
 | 0. 需求确认 | ✅ completed | 2026-08-07 15:35 |
 | 1. upload_pipeline 模块实现 + BDD | ✅ completed | 2026-08-07 17:11 |
 | 2. 代码审核 + 修复 | ✅ completed | 2026-08-08 09:05 |
 | 3. 全量验证（tsc + BDD 回归） | ✅ completed | 2026-08-07 18:00 |
-| 4. action 集成确认点（需 yarn bootstrap，停问兄弟）| pending | — |
+| 4. action 集成确认点（无需 yarn bootstrap，node_modules Junction 直接 import）| ✅ completed | 2026-08-08 |
 
 ## 关联资料
 
@@ -79,4 +79,18 @@ OpenCode session grand-basil（ses_024dcd128ffem5fcauEGR8mAFB）完成全部实
   - A2 修复含 mesh Lcl Translation = -根骨位置补偿（实测重解析后 mesh parent=mixamorigHips、world=(0,0,0)、顶点差 0）
   - A1 texture→material 保留 "DiffuseColor" 属性（FBXLoader 按第 4 个属性字符串 map，删除会丢 S7 断言）
 - **验证**（bot 独立复验）：`npx jest --config jest.config.js` = 24 suites / 85 tests 全绿；`npx tsc --noEmit` = 0 error；feature/spec 文件零改动
-- 下一步：步骤 4 action 集成确认点（需 yarn bootstrap 装依赖 → 停问兄弟）
+
+### 2026-08-08 09:30 (UTC+8) — 步骤4 action 集成完成
+- 兄弟指令（`.opencode-brief-upload-action.md`）：把 upload_pipeline（processTripoZip）集成进 `contributes/meta3d-action-mod-unit-upload-model-file`。
+- 确认点澄清：**无需 yarn bootstrap** —— 根 `node_modules/bone_converter` 已是 Junction → `services/bone_converter`，`import "bone_converter/src/tool/upload_pipeline"` 直接可解析。
+- 改动（仅 2 个 action 文件，bone_converter src / feature / spec / protocol 零改动）：
+  - `webpack.config.js`：`resolve.alias` 加 `bone_converter → services/bone_converter`（alias 指向 src 上一级，避免 `src/src` 死路径），import 解析到真实路径、脱离 `/node_modules/` 段 → ts-loader 正常编译；不改 exclude、不动其他配置。
+  - `src/Main.ts`：`_loadFBX` 后缀放行 `.fbx|.zip`；handler 内 `.zip` → `processTripoZip(fbxData)` → 按转换后 fbxData 做 lod1≤3MB / lod2≤1.5MB 校验 → 同一 eventSourcing.addEvent 分发；失败 `api.message.error` + return meta3dState 不崩；report/warnings console.log。
+- 验证（全绿）：
+  - `services/bone_converter && npx tsc --noEmit` = 0 error
+  - `services/bone_converter && npx jest --config jest.config.js` = 24 suites / 85 tests 全绿
+  - action `npx tsc --noEmit` = 0 error
+  - `cross-env NODE_ENV=development npx webpack` = 成功，`dist/static/js/main.js`（3.5MB），bundle 含 processTripoZip×6 / unzipTripoZip×16 / convertToMixamo×14 / JSZip / FBXLoader / mixamorig×115
+- 协议无缺口：EventType `fbxData=ArrayBuffer`、`fbxName=string` 与 processTripoZip 返回完全匹配，无需改协议。
+- 真实 zip 端到端复验（临时 jest 用例，跑完即删）：兄弟桌面 `tripo_convert_1efef564-f149-410e-8df7-aff0deb624f6 (1).zip` → processTripoZip 成功，输出 `fbxByteLength=2,615,915`（≈2.5MB，**过 lod1≤3MB、不过 lod2≤1.5MB**），textureCount=1（无"纹理嵌入失败"警告），骨骼 41→22（mixamorig 全名正确）、rename 22、skinIndexFix 59748、rest pose 对齐 22 骨、无 unmatched。
+- 工作流全部 5 步完成，状态置为 completed。