daoqi/youle_cocos
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
86 Commits 1 Branch 0 Tags
570892671106ee68ea72da15ba88ef774ac6feb3
Commit Graph
42 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 5708926711 fix(skin): 修复最终评审发现的 6 处缺陷（junction 排除失效/meta 静默丢失等） 
跨任务视角发现的问题：Critical1 materialize.mjs 的 junction 排除比较在
Windows 上因长路径前缀恒假、从未生效，且测试夹具的 junction 指向真源自身，
掩盖了此问题；Critical2 composeSkin 例外通道在 uuid 缺失/框架侧无 meta 时
静默失败，违反第二准则；Important3 可覆盖范围误把 theme/ 下的框架 TS 代码
也纳入；Important5 cli-entry 测试漏注册 check-skin/build-game；Important6
composeSkin 与 check-skin 各自拼路径，未共用 paths.mjs 权威推导；Important7
--platform 缺值时静默落到默认平台。逐条修复并补测试，Critical1 用诱饵框架
目录验证过能真正杀掉该 bug（变异推演见 fix report）。

spec §5 step5 的 dist/<name>/ 拷贝按要求标注为本期未实现，不实现。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 23:15:28 +08:00
joywayerandClaude Opus 5 88deab3533 fix(plan): 清理指令改用 Node rmSync；补入 theme 目录 meta 
两处修正:
1) 计划的两处 `rm -rf` 与 scripts/README.md:28 的安全规程直接冲突 ——
   git-bash 的 rm -rf 可能穿透 junction 误删框架真源, 正是本方案要守护的红线。
   改用 node rmSync(对 junction 不穿透)。Task 8 已按旧指令执行过一次,
   事后核查真源完好(git status 无 D 记录), 属侥幸未出事。
2) Task 7 提交了 theme/ 下四个 .ts 及其 .meta, 但漏了 theme/ 目录自身的 .meta。
   目录 meta 同样承载 UUID, 缺失会在跨工程 junction 共享时打断引用。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 22:50:13 +08:00
joywayerandClaude Opus 5 5a1afedfd3 feat(ui): theme 契约(类型+默认值+合并+Provider) 
子游戏只写要改的字段, 缺省集中在 DEFAULT_THEME 一处(spec §4.3,
第二准则的唯一例外)。ThemeProvider 未 init 即读抛错, 不兜底。
皮肤构建期定死, 故静态读取不做响应式。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 22:38:26 +08:00
joywayerandClaude Opus 5 669a2a5e14 test(ui): 实测构建期合成的三条承重假设并回填 spec 
Auto Atlas 构建期打包 / meta 保留 uuid 后尺寸变化的表现 / Spine 整套替换。
结论写入 spec §6, 未验证项如实标注阻塞, 不假定可行。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 22:30:46 +08:00
joywayerandClaude Opus 5 967641a7c7 chore(ui): 添加框架 ui 资源目录的自动生成元数据 
Cocos Creator 为新创建的目录自动生成 .meta 文件，
确保资源 UUID 在团队协作中保持一致。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 21:16:32 +08:00
joywayerandClaude Opus 5 8a40e682ab feat(ui): 资源归属骨架 + 修复 .gitignore 无锚点模式吞业务目录 
framework/ui 建八个资源目录(按加载时机=图集划分)并落地归属规则文档。
根 .gitignore 的 **/native/ 与 YouleNexus 的裸 native 会静默吞掉
assets/framework/**/native/ 等业务目录; 改为各工程 .gitignore 用锚定
路径负责生成物, 根只管仓库级条目。种子补 .gitignore 使新子游戏继承。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 21:15:26 +08:00
joywayerandClaude Opus 5 37421819ee chore(nexus): 补入 assets/framework 的 .meta 文件 
framework 下的 .ts 已入库但对应 .meta 一直未提交。Cocos 的 .meta 承载资源 UUID,
缺失会导致其它机器导入时重新生成 UUID, 进而打断引用关系, 必须入库。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-19 08:01:29 +08:00
joywayerandClaude Opus 5 42bc0722b8 chore(mcp): 换用 cocos-mcp-server 扩展, .mcp.json 改 HTTP 直连 
旧扩展 @iflow-mcp/harady-cocos-creator-mcp(164 个细粒度工具 + stdio-bridge
转发)整个删除, 换成 cocos-mcp-server v1.7.9(16 个聚合工具, 靠 action 分派)。

新扩展自身起 streamable-http 服务, 不再需要 stdio 桥, 故 .mcp.json 从
node + stdio-bridge.js 改为 { type: "http", url: "http://127.0.0.1:3000/mcp" }。
原配置指向的 client/stdio-bridge.js 已随旧扩展删除, MCP 因此加载失败。

服务器名保留 cocos-creator-mcp(而非 INSTALL.md 建议的 cocos-creator), 以免
打断 CLAUDE.md、cocos-mcp 技能与 settings.local.json 里的
mcp__cocos-creator-mcp__* 允许规则。

gitignore: 新扩展是商业付费产品(vberai), 非 npm 可重装, dist/sidecar/static
共约 16M 发行产物+加密载荷+平台二进制不入库; 顺带忽略 Claude Code 个人本地
配置与编辑器运行时端口文件。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-19 08:01:07 +08:00
joywayerandClaude Opus 4.8 4b4e2261b4 feat(framework): platform PlayerStore(=C_Player) applyLogin 
Implement PlayerStore wrapping signal<PlayerState> for player account data.
Adds applyLogin(raw) to fill state from login response A group, with:
- Mandatory fields get default 0/'' if missing (never undefined)
- Optional fields (openid/unionid/province/city) only set if present
- Immutable updates via spread operator
- Notifies subscribers on state change

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 22:06:06 +08:00
joywayerandClaude Opus 4.8 7659e1fac5 feat(framework): platform State 类型(登录驱动子集) + 只读视图接口 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 21:39:39 +08:00
joywayerandClaude Opus 4.8 854d72a420 feat(framework): core 响应式 signal 基元(自研薄封装) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 21:32:03 +08:00
joywayerandClaude Opus 4.8 883335f656 fix(framework): kick_server 终止不重连(对齐真实客户端) 
收到 kick_server 时 emit kicked 并 stop()，不再 onClose→重连→重踢空转。
kick 处理移出登录门控，登录态内外一致。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 20:37:16 +08:00
joywayerandClaude Opus 4.8 ad661707ec fix(framework): player_login.version 改为数字 versionCode(联调登录成功) 
真机联调发现：协议 version 字段=数字 versionCode（源码 8 处 data.version=GameData.versionCode），
框架原发字符串 '1.1' 被服务器版本校验拒绝(kick_server 检查到新版本)。改为数字后登录成功
(state:0 playerid:430511)。
- ChannelIdentity/LoginRequestData.version: string→number，去掉冗余 versionCode 与未发送的 '1.1' 串
- query-string version 解析为数字；测试 fixture 同步

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 20:33:53 +08:00
joywayerandClaude Opus 4.8 96c6c7c914 fix(framework): decodeFrame 改单层(服务器协议非双层) 
真机联调发现：服务器实发单层 {app,route,rpc,data}；旧客户端的'外层 data'是浏览器
MessageEvent(00_minhttp.js:266 ws.onmessage=config.onmessage)，非协议层。框架传输层
已取 ev.data，decodeFrame 不应再剥一层。修正后 kick_server 等业务包能正确解析。
- decodeFrame 单层化 + 测试改单层帧
- 更正 docs/protocol/01 §3.2(双层→单层，附 MessageEvent 依据)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 20:25:36 +08:00
joywayerandClaude Opus 4.8 5132fddc4e feat(framework): config 调试 serverOverride(全链路+游戏服连本地) 
- DebugProfile 加 serverOverride：debug 抓远程配置走全链路后把连接地址覆盖为此
- staging profile 加 serverOverride=ws://127.0.0.1:3088（联调本地测试服）
- release 一律忽略 serverOverride，用远程解析结果
- 同步指南

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 20:08:59 +08:00
joywayerandClaude Opus 4.8 d461578d6e feat(framework): config 调试登录账号进 profile(DebugAccount) 
- DebugProfile 加 account?: DebugAccount（openid 等登录字段，仅 debug 模式生效）
- resolveBootstrap 结果加 account：debug 取 profile.account，release 恒 undefined
- staging profile 留占位 account 待填真值；接入处 setIdentity 合并 identity+account
- 同步指南

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 19:57:41 +08:00
joywayerandClaude Opus 4.8 51a4ee57ac refactor(framework): 移除 resolveBootstrap 下游兜底，立第二准则 
- CLAUDE.md 新增「第二准则：数据源权威、唯一，下游不兜底」
- bootstrap 删除 fallbackServers 选项与 ?? DEFAULT_GAMESERVER 猜默认
- 无 server/gameserver、远程失败、解析不出地址 → 一律抛 ConfigFetchError 显式暴露
- 同步 guide + 两篇 spec（删 fallback/降级措辞）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 18:59:15 +08:00
joywayerandClaude Opus 4.8 39bb964a49 chore(framework): 填入真实渠道身份默认值与测试配置服地址 
- BUILD_IDENTITY 的 agentid/channelid/gameid 改为真实渠道身份
- STAGING_GAMESERVER 改为真实测试配置服地址

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 18:43:50 +08:00
joywayerandClaude Opus 4.8 5ab4a0a4b6 feat(framework): net NetClient 可选 debug 收发包日志 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 18:16:36 +08:00
joywayerandClaude Opus 4.8 2c2e487d8f feat(framework): config resolveBootstrap 接入 mode + release 锁死 URL 覆盖 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 18:13:15 +08:00
joywayerandClaude Opus 4.8 8cbc488e0c feat(framework): config 运行模式解析 resolveRuntimeMode(自动+手动覆盖) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 18:10:42 +08:00
joywayerandClaude Opus 4.8 e4d16bf412 docs(framework): 澄清 SERVER_KEYS 有意只取 *_server_tcp(WebSocket-only) 
最终审查指出 spec 文本列了 *_server_http 而代码注释称逐字一致，易致误解。补注说明本期 WebSocket-only、HTTP 传输模式(netType==1)超范围。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:52:38 +08:00
joywayerandClaude Opus 4.8 632cef35e5 feat(framework): config 生产用 HttpConfigFetcher(全局 fetch) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:47:15 +08:00
joywayerandClaude Opus 4.8 c87d204f28 feat(framework): config 启动编排 resolveBootstrap(身份合并+服务器决策+降级) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:44:43 +08:00
joywayerandClaude Opus 4.8 6333ddc8e4 feat(framework): config 远程配置分层取参 getParam + 服务器解析 resolveServers 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:41:28 +08:00
joywayerandClaude Opus 4.8 231e9ee31c feat(framework): config 调试 profiles + ?profile= 切换 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:38:44 +08:00
joywayerandClaude Opus 4.8 119a457c59 feat(framework): config 原生同步身份来源(window.settings/app_* 逐字对齐) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:36:13 +08:00
joywayerandClaude Opus 4.8 510c074627 feat(framework): config H5 URL query 身份来源 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:33:58 +08:00
joywayerandClaude Opus 4.8 2f97150a6f feat(framework): config 身份类型 + 纯合并 resolveIdentity + 构建期默认 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 16:30:49 +08:00
joywayerandClaude Opus 4.8 9842c065c8 feat(framework): Cocos/浏览器 WebSocket Transport adapter 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:28:13 +08:00
joywayerandClaude Opus 4.8 0ada512464 feat(framework): protocol routes 常量 + login 请求构造/响应解析 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:25:29 +08:00
joywayerandClaude Opus 4.8 540cf286a5 feat(framework): net-client 编排(login流程/门控/TcpID/超时重连/服务器切换/事件) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:24:57 +08:00
joywayerandClaude Opus 4.8 79d0071645 feat(framework): net 候选服务器轮询策略 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:23:41 +08:00
joywayerandClaude Opus 4.8 08d41cdec1 feat(framework): net 收包超时看门狗(注入 Clock 可测) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:23:13 +08:00
joywayerandClaude Opus 4.8 90843374f9 feat(framework): net Transport 接口 + 测试用 FakeTransport 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:22:47 +08:00
joywayerandClaude Opus 4.8 7dcdeb6615 feat(framework): net 信封编解码 + 握手/心跳/错误包识别 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:22:18 +08:00
joywayerandClaude Opus 4.8 c1be4dcb1e feat(framework): core 座位↔视图转换 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:21:46 +08:00
joywayerandClaude Opus 4.8 bfd9339f64 feat(framework): core EventBus(类型化+故障隔离) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:21:26 +08:00
joywayerandClaude Opus 4.8 56dbfeb5e2 feat(framework): core 最小集协议类型(envelope/login) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:20:54 +08:00
joywayerandClaude Opus 4.8 f693f45895 chore(framework): TS 测试基建(tsx+node:test) + core 常量 
- 补 @types/node（tsconfig types:[node] 所需，原计划遗漏）
- tsconfig 加 allowImportingTsExtensions（import 带 .ts 后缀所需）
- test:framework 改用 run-framework-tests.mjs 递归枚举（node 20.13 <20.14 不支持 --test glob）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 14:20:25 +08:00
joywayerandClaude Opus 4.8 5bba8676ea chore(monorepo): 工具层脚手架 + 框架真源占位结构 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 11:58:20 +08:00
joywayerandClaude Opus 4.8 7ab748919a chore: 纳入项目全部源码进根仓库统一管理 
删除 YouleNexus 内嵌 .git，统一由根仓库唯一管理。提交：
- projects/ 旧 H5 模板 Game_Surface_3 与各子游戏源码
- cocoscreator_projects/YouleNexus 工程 + cocos-creator-mcp 扩展源码
- CLAUDE.md、.mcp.json 等配置
library/temp/node_modules/dist 等缓存由 .gitignore 排除。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 11:55:13 +08:00