@ttmg/cli 0.4.5 → 0.4.6-agent-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.5",
+  "version": "0.4.6-agent-beta.2",
   "description": "TikTok Mini Game Command Line Tool",
   "license": "ISC",
   "bin": {
@@ -14,10 +14,41 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "prepack": "npm run build && npm run verify:dist-version",
+    "demo:vibe": "npm run build && node scripts/vibe-upload-demo.js",
+    "test:vibe": "node scripts/run-ts-test.js src/commands/common/vibe/vibe.test.ts",
+    "test:vibe-process": "node scripts/vibe-upload-smoke.js",
+    "prepack": "npm run build && npm run verify:dist-version && npm run verify:agent-contract",
     "build": "node scripts/build.js",
     "verify:dist-version": "node scripts/verify-dist-version.js",
+    "verify:agent-contract": "node scripts/verify-agent-contract.js",
     "test:network": "node -r ts-node/register src/commands/native/dev/utils/getLocalIPs.test.ts",
+    "test:upload-preview": "node scripts/run-ts-test.js src/commands/common/upload.test.ts",
+    "test:preview-page": "node scripts/run-ts-test.js src/commands/common/previewPageServer.test.ts",
+    "test:preview-page-detached": "node scripts/run-ts-test.js src/commands/common/previewPageDetached.test.ts",
+    "test:preview-page-process": "node scripts/preview-page-server-smoke.js",
+    "test:login": "node scripts/run-ts-test.js src/commands/common/login.test.ts",
+    "test:auth": "node scripts/run-ts-test.js src/commands/common/auth.test.ts",
+    "test:capabilities": "node scripts/run-ts-test.js src/commands/common/capabilities.test.ts",
+    "test:test-account": "node scripts/run-ts-test.js src/commands/common/testAccount.test.ts",
+    "test:dev-session": "node scripts/run-ts-test.js src/commands/native/dev/agentSession.test.ts && npm run test:packaging-compatibility",
+    "test:packaging-compatibility": "node scripts/run-ts-test.js src/commands/native/dev/packagingCompatibility.test.ts",
+    "test:dev-session-command": "node scripts/run-ts-test.js src/commands/native/dev/session.test.ts && node scripts/run-ts-test.js src/commands/native/dev/projectSession.test.ts && node scripts/run-ts-test.js src/commands/native/dev/scanPage.test.ts && node scripts/run-ts-test.js src/commands/native/dev/runtime/logArchive.test.ts && node scripts/run-ts-test.js src/commands/native/dev/capture.test.ts",
+    "test:dev-runtime-event": "node scripts/run-ts-test.js src/commands/native/dev/utils/scoket.test.ts",
+    "test:dev-runtime-client": "node scripts/run-ts-test.js src/commands/native/dev/runtime/runtime.test.ts",
+    "test:dev-session-control": "node scripts/run-ts-test.js src/commands/native/dev/runtime/sessionControl.test.ts && node scripts/run-ts-test.js src/commands/native/dev/runtime/previewWorkflow.test.ts",
+    "test:dev-runtime-session-follow": "node scripts/run-ts-test.js src/commands/native/dev/runtime/runtimeSessionFollow.test.ts",
+    "test:dev-client-preview-orchestrator": "node scripts/run-ts-test.js src/commands/native/dev/runtime/clientPreviewOrchestrator.test.ts",
+    "test:dev-watch-change": "node scripts/run-ts-test.js src/commands/native/dev/utils/watchChange.test.ts",
+    "test:dev-game-ready-process": "npm run build && node scripts/dev-game-ready-smoke.js",
+    "test:dev-default-process": "npm run build && node scripts/dev-default-smoke.js",
+    "test:dev-client-preview-control-process": "npm run build && node scripts/dev-client-preview-control-smoke.js",
+    "test:check": "node scripts/run-ts-test.js src/commands/native/check/check.test.ts",
+    "test:check-ai": "node scripts/run-ts-test.js src/commands/native/check/ai.test.ts",
+    "test:build-structured": "node scripts/run-ts-test.js src/commands/native/build/build.test.ts",
+    "test:doctor": "node scripts/run-ts-test.js src/commands/native/doctor/doctor.test.ts",
+    "test:wasm": "node scripts/run-ts-test.js src/commands/native/wasm/wasm.test.ts && node scripts/acceptance-fixture.test.js",
+    "test:agent-contract": "npm run test:login && npm run test:auth && npm run test:capabilities && npm run test:test-account && npm run test:upload-preview && npm run test:preview-page && npm run test:check && npm run test:check-ai && npm run test:build-structured && npm run test:doctor && npm run test:wasm && npm run test:dev-session && npm run test:dev-session-command && npm run test:dev-runtime-event && npm run test:dev-runtime-client && npm run test:dev-session-control && npm run test:dev-runtime-session-follow && npm run test:dev-client-preview-orchestrator && npm run test:dev-watch-change && npm run test:network && npm run test:vibe && npx tsc --noEmit && npm run build && npm run test:vibe-process && npm run test:preview-page-process && npm run test:preview-page-detached && npm run verify:dist-version && npm run verify:agent-contract",
+    "test:agent-contract:full": "npm run test:agent-contract && npm run test:dev-default-process && npm run test:dev-game-ready-process && npm run test:dev-client-preview-control-process && node scripts/dev-workflow-smoke.js",
     "publish:beta": "npm publish --registry=https://registry.npmjs.org/ --access public --tag beta",
     "setup": "node scripts/setup.js",
     "reset:local-state": "node scripts/resetLocalState.js",
@@ -30,7 +61,7 @@
   ],
   "author": "zhanghongyang.mocha",
   "dependencies": {
-    "@anrans001/ttmg-wasmtool": "^0.3.2",
+    "@anrans001/ttmg-wasmtool": "^0.3.3",
     "acorn": "^8.15.0",
     "archiver": "^7.0.1",
     "axios": "^1.11.0",
@@ -59,10 +90,11 @@
     "ora": "^9.0.0",
     "p-limit": "5.0.0",
     "prettier": "^3.6.2",
+    "qrcode": "^1.5.4",
     "qs": "6.12.1",
     "semver": "^7.7.2",
     "socks-proxy-agent": "^9.0.0",
-    "ttmg-pack": "0.4.8",
+    "ttmg-pack": "0.4.13",
     "ws": "^8.18.3"
   },
   "devDependencies": {
@@ -77,6 +109,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.4",
     "@types/node": "^24.2.0",
+    "@types/qrcode": "^1.5.5",
     "compression": "^1.8.1",
     "eslint": "^9.31.0",
     "rollup": "^4.46.4",

package/CHANGELOG.md

@@ -1,277 +0,0 @@
-## 0.1.0
-
-发布正式版本，支持 H5 小游戏和原生小游戏的初始化、开发调试和打包构建。支持 Windows 系统
-
-## 0.1.0-beta.1
-
-移除 Client WS 端口和 Http 端口默认 -1 的配置，变成通过和 Node CLI 通信显示发端口
-
-## 0.1.0-beta.8
-
-支持自动打开浏览器，且聚焦在 devTools 窗口
-
-## 0.1.0-beta.9
-
-1. 支持文件上传进度显示
-2. 支持自动打开浏览器调试模式
-
-## 0.1.0-beta.10
-
-fix: 修复还未完成新编译就直接上传了的问题
-
-## 0.1.0-beta.11
-
-feat: 先关闭自动上传能力
-
-## 0.1.0-beta.12
-
-feat: 支持文件变更监听，告知浏览器文件变更，提醒开发者重新加载游戏
-
-## 0.1.0-beta.13
-
-1. 支持 sourcemap
-2. 优化上传环节产物，过滤 sourcemap 文件，提高上传效率
-
-## 0.1.0-beta.14
-
-1. 修复 client key 未成功写入 mock meta 的问题，导致不一致
-
-## 0.1.0-beta.15
-
-1. 还原 open url 历史方法
-
-## 0.1.1
-
-发布最新版本，提醒开发者升级最新版本
-
-## 0.1.2
-
-发布最新版本，支持 sourcemap
-
-## 0.1.3-beta.1
-
-优化显示二维码问题
-
-## 0.1.3-beta.2
-
-彻底修复二维码兼容问题
-
-## 0.1.3-beta.3
-
-修复 sourcemap 错乱问题
-
-## 0.1.3-beta.4
-
-修复循环依赖问题
-
-## 0.1.3-beta.5
-
-修复监听文件变化报错问题
-
-## 0.1.3
-
-发布优化版本 CLI
-
-## 0.1.4
-
-优化页面交互
-
-## 0.1.5
-
-1.fix: 控制台报错问题 2. feat: 优化
-
-## 0.1.6
-
-1. 优化控制台报错日志
-2. 优化调试启动环节耗时
-
-## 0.1.7
-
-- 修复 Windows 调试资源加载失败问题
-
-## 0.1.8
-
-优化 DevTool 网页端启动时间
-
-## 0.1.9-beta.1
-
-发布测试版本，供客户端调试使用
-
-## 0.1.9-beta.2
-
-发布测试版本，用于 Windows 测试
-
-## 0.1.9
-
-发布正式版本，支持
-
-- login
-- 支持上传游戏包
-- 支持启动模式
-- 支持 Debug Settings
-
-## 0.2.0-beta.1
-
-发布测试版本，用于 Windows 测试 login 登录异常逻辑
-
-## 0.2.0
-
-发布正式版本，支持 Windows 登录加载报错提示
-
-## 0.2.1
-
-1. 移除项目详情部分，比较冗余，不常用，融合到代码预检中
-2. 打开调试页面地址增加 version 参数，来规避新老版本缓存问题和不同网页之间的隔离（未来支持）
-3. 优化登录失败提示，增加网络检查提示，并给出如何修改网络设置的文档链接
-4. 补充发送 meta 至客户端链路，增加调试链路日志信息，便于排查问题
-
-## 0.2.2
-
-1. 修复访问无权限的小游戏，顶部报错问题
-
-## 0.2.3
-
-优化扫码连接不上问题，支持手动绑定电脑本地 IP 地址
-
-## 0.2.4
-
-支持新的 DevTool 平台
-
-## 0.2.5
-
-1. 增加不在游戏根目录启动调试校验
-2. 支持手动绑定客户端 IP 地址和端口
-3. 调整启动模式中的场景列表表达文案
-4. 修复文件上传问题，避免偶现上传失败
-5. 支持展示游戏详情模块，支持开发者查看当前小游戏基本信息
-6. 支持调试环节消费平台配置的域名
-7. 升级 ttmg-pack 0.1.7，修复构建环节对开发者 JS 代码降级的问题
-8. 文档新增常见问题部分，替换原有的开发文档
-
-## 0.2.6
-
-修复启动模式中场景列表展示问题，重复展示默认启动模式
-
-## 0.2.7
-1. 升级 ttmg-pack 0.2.3，调整 esbuild 配置，目标 es2020
-2. 支持校验子包配置文件名是否符合规范，对于非法文件名，提示开发者修改
-3. 调整域名校验默认逻辑，默认开启，校验失败时，提示开发者修改
-
-## 0.2.8
-1. 升级 ttmg-pack 0.2.4，修复 open data context 文件丢失问题
-
-## 0.2.9
-1. 升级 ttmg-pack 0.2.5，修复 open data context 打包问题
-## 0.3.0
-新增/优化功能适用 TikTok 版本 iOS >=43.1 | Android>=43.1
-支持了开发信息蒙层，打开后可以查看游戏 FPS、设备信息、调试开关等信息，便于查看游戏运行状态 了解如何使用
-支持删除历史启动模式，便于管理历史启动模式
-调整调试设置模块名称为开发选项，和客户端内调开发者选项保持一致 了解如何使用
-调试设置新增定义 vConsole 和 开发信息浮层设置
-支持了变更日志，用户可以在调试环境下查看游戏的变更记录，部分新功能可通过更多信息查看使用
-支持了调试设置开关本地缓存，避免每次都需要重新设置
-修复上传名称为中文的游戏时，平台展示乱码的问题
-修复启动模式模块，自定义query 参数无法持久化的问题
-修复扫描二维码模块，内容过多，纵向无法滚动问题
-
-## 0.3.1
-- 支持 unity 小游戏本地一些列调试功能，如 Wasm 分包、包大小校验、一键上传代码包至平台等 了解如何使用
-- 增加用户登录过期的异常提示，提醒开发者重新登录
-- 优化上传代码包至平台功能，开发者只用添加描述后点击上传便可自动压缩当前目录下的代码包上传至开发者平台
-- 优化 ttmg login 终端网络代理异常导致无法登录的报错引导，提示用户检查网络设置
-
-## 0.3.2-beta.1
-支持 cocos 2.0 openDataContext 相关适配
-
-## 0.3.2
-- 小游戏详情查询升级到 TikTok DevPortal v4 `devtool/info` 接口，字段映射更完整
-- 支持一键打包当前目录并上传代码包到开发者平台；上传失败提示更明确，文件名非法字符自动处理
-- Unity Wasm 分包：更新 `game.json` 子包配置写入逻辑（兼容 `subpackages`/`subPackages` 字段），Android/iOS main/sub 配置去重合并
-- 启动校验增强：检查是否在小游戏根目录执行，并提示 `subPackages` 拼写错误
-增加对 unity 是否需要分包的检查，对于需要分包的 unity 项目，给出明确提示
-支持通过 `ttmg setup` 配置 CLI 语言，调试环境会跟随语言设置展示文案，首次调试时会自动同步默认语言，后续 CLI 与 IDE 语言保持一致，减少反复切换
-调试与预检支持多语言展示，关键提示与校验信息更易理解
-支持 Cocos 2.0 openDataContext 配置
-变更记录新增提醒功能，当有新版本发布时，会通过弹窗提醒开发者更新
-ttmg login 支持 ttmg login --verbose 参数，打印更多登录信息
-API 预检建议文案统一收敛，避免重复提示，阅读更清晰
-顶部区域透出项目预检错误与警告信息，便于开发者及时发现问题并修复
-语言选择策略优化：优先使用 CLI 本地设置，未设置时自动回退浏览器语言
-启动校验增强：检查是否在小游戏根目录执行，对于分包配置 subPackages 给出明确报错，引导开发者修改为 subpackages
-修复项目详情中展示的主包大小限制和代码预检不一致的情况
-
-## 0.3.3
-升级 ttmg-pack 到 0.4.5，解决安卓无法调试 unity 项目问题
-
-## 0.3.4
-优化校验逻辑，给出提示
-
-## 0.3.5
-优化连接和代理，帮助开发者自助解决问题
-
-## 0.3.6
-修复分包过程超时问题
-
-## 0.3.7
-新增/优化功能适用 TikTok 版本 iOS >=43.1 | Android >=43.1
-
-1. 新增能力接入助手，帮助开发者基于小游戏变现类型获取关键能力的接入引导。
-2. 优化上传发布环节，将代码预检与代码上传整合为完整的上传发布流程。
-3. 扩充包体大小预检说明，补充整包、主包、独立分包限制规则与详细文档入口，便于开发者理解和处理包体超限问题。
-
-## 0.3.8
-修复 `ttmg login` 后接口鉴权异常的问题：
-
-1. 登录时把 `Set-Cookie` 响应头中的 `Path / Domain / Max-Age / Expires / Secure / HttpOnly / SameSite` 等属性被当成 cookie 拼接到 `Cookie` 字段，导致 CLI 发请求时把属性当成"假 cookie"一并带上。
-2. 同一域名下同名 cookie（例如服务端用 `Max-Age=0` 显式删除的占位 cookie）也会被一起发送，污染掉真正有效的同名 cookie，浏览器会自动过滤这种情况，CLI 不会，造成登录态接口异常。
-3. 修复后与浏览器行为保持一致：剥离 cookie 属性、过滤 `Max-Age<=0` 或 `Expires` 已过期的 cookie，仅保留 `name=value` 用于请求。
-4. 已登录用户无需重新登录，下次发起请求时会自动清洗 rc 中已存的脏数据。
-
-## 0.3.9
-本次主要优化调试 IDE 的视觉、交互与多语言一致性：
-
-1. 调试 IDE 默认使用浅色主题，暗色模式改为开发者手动开启并记忆选择，避免跟随系统强制进入暗色导致不适应。
-2. 优化暗色模式下二维码显示，调整背景避免过亮刺眼，同时保证扫码识别率。
-3. Wasm 分包页面及相关组件补齐多语言，修复此前页面文案中英文混排的问题。
-4. 能力接入助手页面视觉升级：变现模式卡片新增图标与强调色，关键能力标签按「必需 / 可选 / 实验」分级展示，信息层级更清晰。
-5. 完成扫码连接后，首页标题与说明文案会切换为「已连接」状态，状态反馈更明确。
-6. 新版本提示由红点改为「有更新」文字标签，含义更直观。
-7. 上传游戏包按钮配色与产品主题色统一。
-8. 修复多个页面中标题与正文内容未对齐的问题，整体排版更整齐。
-9. 文案细节调整：「身份与授权」更名为「登录与授权」；移除侧边栏冗余的「查看文档」入口。
-
-## 0.3.9-beta.1
-本次测试版本主要补充启动模式场景能力，并优化场景命名可理解性：
-
-1. 启动模式新增 `inbox` 场景，支持在调试链路中模拟消息入口启动小游戏。
-
-## 0.4.0
-
-修复游戏无开发权限时提示信息展示异常的问题，引导更准确。
-
-## 0.4.1
-
-优化上传代码包流程：
-
-1. 上传后的平台处理提示改为更易理解的文案，不再向开发者暴露平台内部状态码及 asset / ready 等技术字段，进度与失败原因表达更清晰。
-2. 重构上传成功卡片布局：二维码与版本信息分区展示并以分隔线区隔，新增成功状态标识，排版更紧凑协调。
-
-## 0.4.4-beta.1
-
-支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
-
-新增子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
-
-使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
-
-## 0.4.4
-
-支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
-
-正式开放子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
-
-子包收集使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
-
-修复部分企业网络使用非标准局域网网段时，可扫码地址被误判为不可用的问题。
-
-提升本地调试连接稳定性：启动阶段短暂断连会自动恢复，刷新调试页面后可继续使用已连接设备。