daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
34 Commits 1 Branch 0 Tags
a20498f898eab08d49469f53f28a95140bd1ccca
Commit Graph
7 Commits
Author SHA1 Message Date
joywayerandClaude Opus 4.7 a20498f898 CLAUDE.md：新增「参考原项目 daoqi」规则 + LaunchScreen 典型案例 
新增「原项目 daoqi：遇到问题时的参考来源」段：
- 明确原 daoqi 项目路径 ../daoqi/（与 ylgamehall 同级目录）
- 列出何时主动去读原项目（iOS 行为不符预期 / Info.plist 不确定 / 桥接
  字段 / SDK 时序 / 渠道注入 / 老 hack 等）
- 怎么用原项目（先查关键文件 → grep 同名 key → 看 git log → 对照差异）
- 与「原则 B：内部自由重构」不冲突：参考是"必须做的清单"和"已踩过的坑"
  备忘，不是"实现细节照抄"

新增 LaunchScreen orientation 典型案例：
- 症状：启动图横躺被旋转 90°
- 错误做法：凭文档推测、纯调 storyboard / contentMode / 反复换素材
- 去原项目找到 msext 用 LaunchImage Asset Catalog（iOS 8 时代）的"按
  orientation 自动旋转 portrait 资源"魔法 — 这套机制 iOS 14+ 已 deprecated
- 新项目用 LaunchScreen.storyboard 没有自动旋转，必须三步组合：
  1. 素材物理像素就是横屏（sips -r -90 一次性旋转 msext 残留 portrait 素材）
  2. Info.plist 显式补无后缀 UISupportedInterfaceOrientations
  3. UIImageView scaleAspectFit + 黑底
- iOS launch snapshot 缓存粘滞：开发期改启动相关任意一项后必须卸载重装
  才能看到新效果；终端用户不受影响

文档索引表加入 ../daoqi/ 一行，加突出可见性。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 03:59:29 +08:00
joywayer 87304552c3 docs：勾选 Plan §5 / §8 Phase 1.10-1.13 进度 + CLAUDE.md 新增「进度同步规范」 
把 Plan 任务清单和进度追踪 checklist 同步到当前实际进度（1.10-1.13
均已完成 + 实测验证），并在 CLAUDE.md 写入"每完成 Phase 子项必须立即
更新 Plan 进度"的硬约束。

- Plan §5 Phase 1.10-1.13 任务清单 [ ] → [x]
- Plan §8 进度追踪同步：标注算法名 / 端到端实测结果（260→261 验证）
- CLAUDE.md 新增「进度同步规范」节，规定：
  - Plan §5 + §8 每完成子项立即勾选，与 commit 同 commit 内完成
  - 任务描述与实现有差异时同步修订（不允许 Plan 与代码长期不一致）
  - commit message 末尾备注"Plan 进度已勾选"
  - 理由：Plan 是项目记忆的唯一权威进度视图，新人 clone 后看 Plan
    §8 即可知整体进度；与 commit log 双写互为校验

Plan 进度已勾选
 2026-06-22 02:30:31 +08:00
joywayer cabdc1ed42 docs：剥离 docs/res/ 为私人素材池，废止仓库根 Resources/ 假设 
明确 docs/res/ 是项目维护者的私人原始素材池，与项目架构无关；项目
代码 / 构建脚本 / Xcode 工程都不感知它的存在，需要时从中拷一份到
项目按现代实践规划的位置。原 ADR-004「Resources/ 在仓库根 +
Build Phase 引入」语义已崩塌（gamehall.zip / Images.xcassets / Res/
均被挪入 docs/res/），修订为「项目内资源目录由各 Phase 按需落地」：
静态 Bundle 资源走 ylgamehall/Resources/、原生 Asset Catalog 走
ylgamehall/Assets.xcassets/、渠道注入产物走 ylgamehall/ChannelInjection/
（.gitignore + Scripts/inject_channel.sh 生成）、闭源 SDK 走 Vendor/。

- CLAUDE.md 原「Resources/ 目录约定」节改写为「docs/res/ 与项目
  资源的关系」，禁止把 docs/res 当项目资源目录使用
- Design §7.0 整节重写为「项目资源目录约定」三小节（docs/res
  与项目无关 / 项目内资源目录在 Phase 实施时按需落地 / 渠道注入
  运行时路径）
- Plan ADR-004 修订为「项目资源目录由各 Phase 按需落地」；ADR-002
  / §2.2 / Phase 1.1.a-d / 1.5 同步调整为 docs/res → ylgamehall/Resources
  的拷贝模型；Phase 1 任务清单细化渠道注入由 Scripts/inject_channel.sh
  生成
- 物理迁移：仓库根 Resources/gamehall.zip / Images.xcassets / Res/
  全部 rename 到 docs/res/（git rename detection 自动识别）
 2026-06-21 22:32:38 +08:00
joywayer 17a8b96cf8 docs：依赖管理改为纯 SPM + Vendor，移除 CocoaPods（ADR-006） 
调研发现 Qiniu SDK 已官方支持 SPM（https://github.com/qiniu/objc-sdk
v8.9.x），AMap 仍仅支持 CocoaPods 或手动 XCFramework；CocoaPods 1.15.2
不兼容 Xcode 26 的 PBXFileSystemSynchronizedRootGroup，需绕道 Bundler
才能升到 1.16+。综合性价比决定不引入 CocoaPods 工具链，所有闭源 SDK
（含 AMap）统一走 Vendor .xcframework 手动接入。

- Design §14.1 三层策略改写为两层（SPM + Vendor），新增 Vendor 接入
  标准流程 6 步法
- Design §14.2 AMap 接入方式从 CocoaPods 改为 Vendor，Qiniu 标注 SPM
  URL 与版本
- Plan §2.3 / §5 Phase 5.1 / §6.1 / §8 同步 AMap Vendor 化
- Plan 新增 ADR-006 完整决策记录
- CLAUDE.md 新增「依赖管理约定」节，禁止引入 CocoaPods
 2026-06-21 21:46:19 +08:00
joywayer d18ea4f1c5 新增所需资源，修改优化文档 2026-06-21 20:40:46 +08:00
joywayer 1da2884358 CLAUDE.md：新增「及时提交」规则到提交规范 
每完成一个可独立验证的工作单元（bug 修复 / 配置变更 /
文档更新 / 依赖升级 / M 里程碑子项）就主动提议提交，
BuildProject 通过 / 关键路径手测通过即立即提议。

理由：项目处于 greenfield 重写阶段，commit 颗粒越小
回滚成本越低；CLAUDE.md / docs 与 git log 一起构成
项目记忆，commit message 是"为什么"的第一现场。
 2026-06-21 20:03:14 +08:00
joywayer beb05ab451 添加文档和CLAUDE.md 2026-06-21 19:39:22 +08:00