开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 5 条记录。
项目全部项目智慧乐活圈 lehuoquan乐活圈 OA 考勤 lehuoquan-oaMagicEngine 悦居魔法引擎如影随形 TraceMate悦居集团数字化 · 统一后台悦居智能 CRM悦居可视通话 yueju-call悦居存储管家 StorageMate悦居反诈专家 AntiFraud悦居智能NVR小红花 LittleBlossom悦居统计后台 DashboardFileBreeze悦居护眼卫士 EyeGuard宠物小程序贝芽妈(lovely-child)悦居智能官网悦居存储管家 AndroidSmartHome 安卓控制端适老智家 AgeHome悦居 AI 日历轻风快传官网 FileBreeze中航天业竞价小程序绿荫网球中心官网绿荫网球小程序青年公社小程序青年公社官网中羊坊村官网 Zhongyangfang自动化脚本集 automation我的减肥日记 WeightLoss画山别墅的旅行家 Travel画山别墅里的国学世界 GuoXue冰雪冬奥张山营延庆骑行网 YanqingBike延庆徒步网 GoHike智能门锁 SmartLock排队仿真 QueueSimulation悦居智能小程序 yueju-miniprogram智能会议室预约 meeting乡村文旅 VillageHub减肥日记小程序日常运维国学小程序 guoxue3D智慧城市 SmartCityLiveRobot 数字人应梦寺爬山smart_home_chat花间向导 SmartGuideWorkBuddy 指标看板T5AI 聊天机器人悦居AI相册(相册管家)
2026-10-24
scissor 接进渲染层:旋转的精灵终于能被容器裁了(N-201 关闭)
做了什么:v6 的
me_rhi_set_scissor只到「后端能收」——胶水有 thunk、契约写着每 pass 归零,而me-render里没有任何一处发出这条指令。本批补调用侧:clip.rs浮点→整数(min 向下 max 向上)、batch.rs批次键加一维clip、submit每批声明并收尾归 None、rhi_sink.rs缓存 +MeRect。- 数字:P7
apps/coin-run/clip.html57600 像素逐字节相等(A 场景伸出容器的 96 个像素灰→洋红);10 个既有判据页全绿;me-render353 测试;全量 CI 191s 通过(0 红,2 项已知降级);提交9514f1b/ 24 文件。 - 契约错了两处,都是真机抓的:①
clip_approx不会降到 0,正确形状是「只在后端真的没 scissor 时才非零」⇒ 改名clip_gpu(有它正常,零才可疑)②submit收尾必须关 scissor:第一版没关,同 pass 紧随的全屏 blit 被上一个容器切掉⇒ 整帧黑、57600 条判据红 56639。§2.5 的每 pass 归零只保证跨 pass,blit 与精灵提交共享同一个 pass。 - 坑:判据素材必须 24×8——正方形转 90° 是它自己,拿它验裁剪等于没验。九宫格页「同贴图 1 批」变 4 不是性能回归,是批次键多一维。
- 证据:
crates/me-render/src/wasm_clip.rs、run-clip.sh、evidence/p7-scissor-clip.png、契约 v14 第 4 条、Team/closed/2026-10-24-scissor-in-rhi.md。
- 数字:P7
引擎官网上线「Demo 体验」页:列表 + 实机录像 + 可试玩的 COIN RUN
- 线上:https://magic-engine.filebreeze.cn/demos.html ;可玩页
/play/coin-run/(部署版本7a3ac8d,18 个文件逐个哈希一致,14 条路径冒烟全 200) - 做了什么:列表页(实机录像 1920×1080/60fps/10.0s + 「立即试玩」)+ 真可玩页(浏览器里跑同一份引擎编的 wasm);首页顶栏与 hero 各加一个入口;第二条「MIR 可玩切片」标规划中、故意不给按钮(死链比没按钮更糟)
- 判据:不是「页面打开了」,是引擎自报数在涨 —— 线上实测帧号 0→41、批次 2、精灵 7、按住右键后生命 3→2(输入真进了 wasm);390×844 手机视口溢出量 0
- 抓到的坑:站点改动从引擎分支摘到 main 后,胶水按 main 版取(无
me_gl_set_scissor)、wasm 却是分支编的(带这条导入)⇒ LinkError 白屏。标题对、按钮能点、只是永远停在第一帧,截图看不出来。结论:产物必须由所在分支的源构建,判据是核对 wasm 导入表 ⊆ 胶水导出 - 取舍:js 不存副本(构建时从 apps/ 现取),wasm 只能存快照 +
check_play_sync硬门。能靠「只有一个副本」消除的故障不该用守卫管 - 证据:
apps/macos-demo/evidence/coin-run-promo.mp4;提交7a3ac8d(站点)、8562699(出片管线)
- 线上:https://magic-engine.filebreeze.cn/demos.html ;可玩页
P13b 真机验收通过:macOS 窗口能玩了,关卡一次跑通
- 真机结论:COIN RUN 在 macOS 宿主窗口里可操作、可通关,关卡布局被认可。
- 窗口标题实测
80 顶点 · 2 批 · dt 16.82ms,证据apps/macos-demo/evidence/p13b-window.png。 - 上一轮修的三个宿主缺陷至此闭环:上屏路径漏
advance(全黑) /AVAudioEngine抛NSException闪退 /NSPersistentUIRestorer弹恢复框卡死回调。三个都是判据看不见的类型——前两个在 CI 全绿的情况下依然让窗口不可用。 - 判据 D(
ME_DEMO_LIVE_FRAMES)现在是真机可用的守门员:推进只留正式路径一处,删掉它就会红,不再自证。 - 关卡参数(可复用的手感基线):
VIEW 320×240/LEVEL_W 640/MOVE 120/JUMP 440/ 坑300–340/ 平台高度156/ 6 金币 / 终点600。 - 分支
agent/A2ca812a1,CI 62s · 1286 测试全绿。
合并 A2+A3 并重新发版:D0 收口 6/6、M0.2 收口 4/4、发布权收归 main
- 为什么合:发版前核对
/deploy.txt发现线上跑的是1b18bbe / agent/A3,而那个提交不在 main 的历史里。从 main 直接发版会把 S8-5 与 S0-10 从线上抹掉(35 退回 34 条任务),而页面看起来「更新了」。 - 两个合并:A3(24 提交,
me size包体归因 + AI 署名闸门)、A2(5 提交,FFI 开销实测 + 图集装箱 + 矩形帧表)。A3 合并两次——第一次合完他又推了 2 个提交(/team/协商板上站)并又发了一版,正是 N-022 描述的事在那条答复之后又发生一次。 - D0 收口 6/6:A2 测得
set_uniform_vec48.4 ns /set_texture9.5 ns /draw_bound11.4 ns,最贵只占 2μs 的 0.57%。更有用的两点:draw_bound多出来的是require_frame+ 两次查表(大头在我们自己代码里);错误路径比成功路径更快,所以「在什么都没画的调用上量出漂亮数字」真会发生。 - M0.2 收口 4/4:着色器生成器(
src/里除shader/外零手写 GLSL,判据可执行)+ 1000 节点mir→mirb→mir字节等义(160,928 字节)。 - 发布权收归 main:
tools/deploy/site.sh现在要求HEAD == origin/main,否则 exit 3,且卡在构建之前。不再只是 N-022 那条约定。 - 修好两处「闸门没通电」:
commit-msg钩子在版本库里是 100644(本地一次没关过);CI 署名步骤的 BRE 中文交替在本机 grep 上恒不命中,加上兜底写成ok,于是「一条没查」被画成 ✓。 - 契约:
cli.spec.md改了内容没 bump,绿勾底下挂了一条 STALE;补成 v3 + 新哈希。diag.codes.md抬头补「边界」一段(只覆盖 me-rhi 侧)。 - 发版:8 个文件逐哈希相等,
/deploy.txt→341e5d8 / main。 - 踩坑:
pre-push跑 CI 2–8 分钟而 SSH 连接空闲,Gitee 直接断连,git push以 141 退出且 CI 是绿的——白跑两轮。已设core.sshCommand带 ServerAliveInterval。
- 为什么合:发版前核对
2026-10-22
官网上线:magic-engine.filebreeze.cn(架构文档同日可读)
- 站点结构重组:
site/成为唯一部署根(index.html+assets/+docs/),由build_site.py从手写的web/与docs/*.md组装,生成物不入库 - 官网内容全部来自 docs,未实现能力统一标注「设计示例 · 引擎尚未实现」;P0 排期数字直接取自
plan/p0-plan.json - 部署链路:
tools/deploy/site.sh(构建 → rsync → nginx vhost → certbot → 五路径冒烟),vhost 模板入库tools/deploy/nginx-magic-engine.conf - 线上实测:https 200、http 301 跳转、HTML no-cache、assets 7d、gzip 后首页 7.7KB、文档站 110KB
- 前端体检(1440/1280/1024/820/390 五档,Playwright):0 横向溢出、0 小于 11px 的字、时间轴 0 重叠、0 JS 报错,正文对比度最低 5.0:1
- 代码已推 Gitee 私有仓库 main(5a4b1a5)
- 站点结构重组: