开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 725 条记录。
2026-11-22
核价:两家住宿没弄反,朗丽兹起价偏低已改;连带修了玉渡山过期营业时间
飞哥问:朗丽兹和民宿的价格是不是弄反了?民宿 680 比酒店 200 贵,确实反直觉。
核实:没弄反。同程今日朗丽兹 314 起、携程/Agoda 常规 300 出头;民宿主楼 680–1580/间、院落 2880–7380/院,多来源一致(含民宿自己的官方遨游报价)。同村普通农家院才 203 起。
改了:① 朗丽兹 200→300(200 是「特价无窗双床房」最低价,能订到但报给老人就是骗) ② 民宿备注加「带餐厅的度假民宿,不是农家院」,院落起价 3880→2880 ③ 核景区时撞出玉渡山时间过期:官方 2026-10-12 改冬季 9:00–15:00(周末 15:30),库里还是夏季 8:30;另补「车要开上山」—— 9.5 公里盘山路,步行骑行禁行、公交也进不去。
顺手:自测两条断言写死了 200 元,改成从报价取数;以后改价不会再红。44 项全过。
教训:报价不能拿特价房最低价当「起」;营业时间有季节性,换季得重核;四处修正都用旧值做条件 UPDATE,重跑幂等。代码
f945883已推 master。文旅倒流 1.2.2 提交并上线:两仓提交、两处部署、线上六家数据复核
提交:小程序
0f1db35(文旅全链 + 三张配图);主站bb8280c(后台加「文旅预订」类型)。均显式路径 add,未跟踪的 build/、video/、汇报 HTML 一律未入;主站远端一笔报价表提交已 fast-forward 合入。部署:小程序
deploy.sh→ healthz 三项全绿(llm/voice/wxLogin),orders=0;后台--platform-only→ 32 文件哈希全一致,//m//api/dashboard全 200。复核(另签令牌实测,不看部署脚本自回查):
/api/travel六家齐——世园 0 元freeAll=true、古崖居 0 元oldFree=true、龙庆峡open=false(闭园)、玉渡山 30、朗丽兹 200、自游自在 680;两种免费确实分得开。管家:问「世园门票多少钱」→「门票也免」,卡片 0 元、
costTxt「公交免费,门票淡季也免」;回复已提及景区名,提示条正确地未再贴。线上REMOTE_TYPE = { travel: 'order' }已就位。待办:① 玉渡山/朗丽兹/自游自在三张图等对方给 ② 世园恢复收费时把
UPDATE的 0 改回 2000 重发版 ③ 六家电话与老人票价跟对方核一遍
2026-11-18
首次提交 b54a221 + 部署 1.61.13:OA 独立成项目
- 首次提交:
b54a221(分支lehuoquan-oa),86 个文件 / +10901 行。提交前逐个文件看过,全是 OA 这条线(含品牌从「如影随形」改「乐活圈OA」、把keystore.properties加进.gitignore);只写显式路径,没用-A。 - 部署:
bash scripts/deploy-oa.sh→ 线上1.61.13;oa.js/oaRoutes.js/oa.html三份文件本地↔线上 md5 逐字一致。 - 当前线上:App
1.61.7(versionCode 147);服务端1.61.13;下载页https://oa.filebreeze.cn/dl/。 - 分发两条路各自到位:已装的人走 App 内更新(
/api/app/version鉴权),没装的人走/dl/静态落地页;先传包后传清单,避开「清单说有、包没到」的 404 窗口。 - 回归:
test-oa131 /test-workplaces57 /test-exempt31 /test-oa-roles23 /test-change-password25 /test-web-password29,全过。 - 口头待定:
/dl/下 145/146/147 三个包(约 140MB)只留最新?App「我的」页按 OA 精简要不要做(要重新出包)?
- 首次提交:
2026-11-17
几个不报错的坑:坐标差 538 米、华为装包四步、种子账号「女儿」
- 高德给的是 GCJ-02、库里存的是 WGS-84,延庆实测差 538 米 —— 而围栏半径只有 100 米。后果:人站在门口也被判外勤,而且任何地方不报错,只能看报表时才发现全员外勤。
- 修法:入库前一律
gcj2wgs(),转换算法只在server/src/gcj.js一份;后台另给一个「高德坐标转 WGS」按钮(拿高德抄回来的坐标先转再存)。 - 华为 HBN-AL00 装包四步(微信发 apk 装不上的真因):① 提示「应用备案状态未知」;② 底部「已了解此应用未经检测」不勾,「继续安装」是灰的、点不动;③ 勾完才能继续;④ 还要输手机锁屏密码。原来文案只写「点安装 → 允许」,而那台机上根本没有「允许」这个按钮 ⇒ 同事找不到就以为包坏了。已把这四步写进更新弹窗与
/dl/落地页。 - 会话与密码两个坑:登录查
SELECT *而会话查指定列 ⇒pw_must_change读不到,刷新一下就绕过了强制改密(两处必须同源);/api/auth/me会话失效返回 200 + user:null(不是 401),拿状态码当判据会漏。 - 伴迹种子账号「女儿」删不掉:
db.js每次启动INSERT OR IGNORE ... VALUES (2,'女儿','child')。之前靠「已标离职」这个巧合挡住,谁点一下恢复她就进考勤表、变成天天缺勤的员工。改成按角色白名单(只认employee/self),花名册 / 员工表 / 看板共用一份。
考勤从 0 到 1:不打卡靠轨迹,服务端算,网页上看
- 判据在
server/src/oa.js文件头写死:窗口[上班, 下班),上班打卡 = 窗内第一个点、下班 = 最后一个点;迟到/早退的量已扣宽限;早退只在当天走完之后才判(否则上午 10 点全员早退)。 - 外勤 ≠ 缺勤:围栏没命中但窗内有轨迹 ⇒ 外勤单列;无点分三档(未上报 / 当天未完 / 缺勤),三种都不是同一件事,不能合成一个红字。
- 重算时机:轨迹同步进来就在
/api/trace/sync里顺手重算今天(minAgeMs60 秒节流)。打卡时刻取自轨迹点时间,不是重算时刻 ⇒ 节流不会把 8:31 变成 8:32;算失败只记日志,绝不让轨迹同步失败。 - 多工作地点:
workplaces+user_workplaces,点落在任一所分配围栏算在岗;没分配回落旧单围栏。改地点或分配立刻重算近 45 天,否则历史那几十天挂着旧结论,管理员以为开关没生效。 - 班次 8:30–17:30 周一至周五;端侧采集时段 = 班次 −25 / +2 分钟(
ShiftGate),网页后台只是复述同一份规则、改一处必同步。 - 免考勤不是不建号:没设备令牌就传不上点、连轨迹都没了,正好把客户要的「也要记录轨迹」做没。改成打标记:只记轨迹、不判迟到缺勤、不进「应到」分母。
- 验证:
test-oa131 /test-workplaces57 /test-exempt31 全过。
- 判据在
v1.1.5 上线合规补齐:注销 / 隐私同意节点 / 在线留言 / 运维确认到账
- 提交
26a6f91已推 master;服务端已部署,/api/story未登录 200;体验版 1.1.5(773.6 KB,Using AppID: wx979f...已核) - 注销账号:
DELETE /api/account,余额不为 0 或物业费未结清先 400 拦,过了删干净并留脱敏审计。假账号自测:users/wallet/messages 均归 0 - 踩坑:
users主键叫id不叫user_id,写进通用删除循环会静默失败,表现是「注销成功但账号还在」——靠查库才发现 - 隐私:首次进小程序主动调
wx.requirePrivacyAuthorize;app.json 补scope.record用途;不再等到按说话才弹 - 「我的」加在线留言(
open-type=contact,透明按钮覆盖);注销入口移到卡片外居中灰字;button 当整行容器会被微信默认样式打乱(图标错位、文字挤三行) - 品牌故事:「资质与备案」不再写「已备案」(还在办),无资料条目整行不渲染;备案号下来填
honor_license自动出现 - 新增
server/tools/ops.mjs:pending / ok / no / users / wallet / bill / points,堆着不确认的充值终于有出口 - 线上
DEMO_SEED改 0(备份env.bak-20261117);微信认证已提交申请,钥密钥已核(40029 说明 appid+secret 有效)
- 提交
v1.1.3 上线:会员积分体系 + 语音提速 6 倍 + 品牌故事与协议页
提交
2893979(43 文件 +2847 行)已推 Gitee;bash server/deploy/deploy.sh部署完成,/api/healthzok(voice=xfyun)、日志无报错,线上新表 members 1 / wallet 2 / points 9 / property_bills 4 / achievements 10 已就位。- 语音:送帧间隔可调(
XFYUN_IAT_GAP),8 秒长句 4.3s → 0.88s;ASR 改二进制直传省 33% 体积;TTS 修分片 base64 截断(只念前两个字),端上改wx.request落本地再播绕开 downloadFile 白名单 - 会员:199 元/年(余额扣或线下登记)、充值带政府监管提示、1 元 1 分且会员双倍、100 分抵 1 元物业费(封顶欠费、不退现金)
- 成就:13 枚勋章分「发生 / 成长 / 生活」三组,只认真实动作表,
check()幂等并由动作接口回带 - 内容与合规:品牌故事页、服务协议 10 章 + 隐私声明 8 章(本地存储断网可读);主体统一乐活圈(北京)信息科技有限公司,技术支持署北京悦居智能;管家页去「我的订单」,我的页加协议入口
- 体验版 1.1.3(771.0 KB)已上传,等真机验收;线上
DEMO_SEED=1正式上线前必修 0
- 语音:送帧间隔可调(
1.1.3 管家页去订单按钮 + 服务协议/隐私声明 + 正式上线审核清单
- 管家页去掉右上角「我的订单」按钮,顶栏只留「管家 · 有事直接说」。顺带把只为按钮存在的
capInset一起删了(cnav-in的 padding-right 不再需要,胶囊按钮在右侧但标题靠左不受影响)。订单入口统一走「我的 → 我的订单」。 - 新增
pages/terms/terms:一个页面两份文书,顶上胶囊切换,?t=service/?t=privacy直接进。文本放miniprogram/utils/terms.js(不放服务端)——断网也得能看、审核员点进来必须立刻有内容。 - 服务协议 10 章,重点写了「哪些事我们管不了」:紧急呼叫不替代 120/110/119、用药提醒不是医嘱、代买商品质量归商家、叫车安全归承运方、不可抗力免责。隐私声明 8 章:收集清单(9 项,逐条说为什么收)、给谁看(师傅/家人/讯飞/高德/物业/微信支付/司法)、存多久(订单 3 年、录音转完即弃、聊天文字 1 年)、六项权利、泄露 24 小时内告知。
- 「我的 → 关于乐活圈」插入服务协议、隐私声明两行(品牌故事之后)。
- 排版细节:
ps渲染在li前面,第 2 条「某项服务能不能做…」必须排在条目之后,加了tail字段单独渲染,别用ps。 - 正式上线审核(未改代码,只出清单):阻断 6 项——微信认证+备案、后台必须配隐私保护指引声明麦克风(不配则真机按住说话直接失败)、服务类目不能选医疗、线上 DEMO_SEED=1 必须改 0(否则真人拿到「王秀兰」的假家属和药)、支付未接、营业执照经营范围。合规 7 项——缺注销入口/首次同意节点/在线客服。运营空白——整个项目没有后台,派单退款账单录入全靠手工 SQL,且订阅消息 0 条。
- 体验版 1.1.3(771.0 KB)已上传,预览码
lq113.png在手机相册。
- 管家页去掉右上角「我的订单」按钮,顶栏只留「管家 · 有事直接说」。顺带把只为按钮存在的
1.1.2 页脚口径:北京悦居智能提供技术支持,不写「合作伙伴」
- 按飞哥要求去掉「合作伙伴」这类分工说法:页脚只写真主体 + 「北京悦居智能提供技术支持」。
- 首页页脚:
乐活圈(北京)信息科技有限公司 · v1.1.2/ 下一行北京悦居智能提供技术支持。 - 我的页页脚:智慧乐活圈 · 延庆居家养老服务 / 乐活圈(北京)信息科技有限公司 / 北京悦居智能提供技术支持 · 8:00–20:00。
- 品牌故事:「找我们」卡去掉「上门服务由合作伙伴…」一行,只留公司全称与延庆本地服务时间;页脚只留「北京悦居智能提供技术支持」;删掉第 04 章「两家,一件事」(那章全在讲两家分工);「资质与背书」里「合作单位 / 悦居智能·本地上门服务」改成「技术支持 / 北京悦居智能」。
- 排障:改完 WXML 后 devtools 模拟器仍渲染旧文案(
.ft-sub读到旧字符串),文件几经确认已是新的、项目无第二份。cli cache --clean compile无效,旧的cli auto实例还活着、渲染停在旧编译产物。pkill -f "cli auto"+ 换端口重开 auto 后立刻读到新文案。以后改完看 devtools 不生效,先怀疑 auto 会话僵了。 - 验证:三个页脚 + 品牌故事页逐页截图;线上
/api/story返回 3 章、honors第三条为技术支持。体验版 1.1.2(758.2 KB)已上传,预览码lq112.png在手机相册。
1.1.1 更正主体:乐活圈(北京)信息科技有限公司,悦居智能是合作方
- 口径纠正:小程序主体=乐活圈(北京)信息科技有限公司;悦居智能=合作伙伴,负责上门服务。此前首页/我的/品牌故事把服务方写成了主体。
- 改到的地方:首页页脚(主体全称 + 版本号,下面一行「服务由合作伙伴 悦居智能 提供」)、我的页页脚三行、品牌故事页「找我们」卡(公司全称 + 延庆本地服务时间 + 上门服务由悦居智能提供)、故事新增第 04 章「两家,一件事」,讲清平台管规则账务售后、师傅上门干活、打电话找的是同一家。
- 「资质与背书」里「合作单位」从「正在补充」改为「悦居智能 · 本地上门服务」,另两项继续等资料。
- 新踩的坑:品牌故事页滚到底页脚被切半行。
pageScrollTo(99999)后scrollTop停在 493,.foot.bottom804 而视口 762,差 42px 正好等于padding-bottom+.safe-b—— 最后那段留白没算进可滚动高度。把.safe-b40rpx 提到 140rpx 后bottom752,完整露出。已写进 README 第 13 条。 - 验证:devtools 逐页截图(首页页脚、我的页脚三行、故事页 04 章与联系卡、页脚);线上
/api/story返回的contact.name已为新主体与partner字段。体验版 1.1.1(758.4 KB)已上传,预览码lq111.png推到手机相册。
1.1.0 会员/余额/积分抵物业费/成就/品牌故事
- 会员:年会员 199 元/年(
settings.member_price可改),可余额扣或线下交;会员页有会员卡、4 条权益、会员账单(wallet里 kind=member 那几笔)与消费记录(订单表)。“我的”页顶部加会员横条,开通后转深绿。 - 余额:充值页含预付卡监管提示(《北京市单用途预付卡管理条例》、可退、不可提现、单笔上限 5000);
pay_mode=demo直接到账(DEMO_SEED=1 时默认),live只登记待客服确认。余额流水单独一本账,balance存变动后快照。 - 积分:消费 1 元 1 分、会员双倍(
points_per_yuan),只能抵物业费:100 分 = 1 元(points_per_redeem),抵扣封顶欠费、不退现金。物业费账单由客服录入(一期不接物业系统),页面上可“全抵”或“自己填”。 - 勋章 13 枚:第一次说话/用语音/下单/入会/充值/抵扣、5 单、聊满 10 次、100/500 分、结清账单、叫车、报活动。判定
check()幂等,动作接口里顺手带newBadges,客户端弹一句“得了枚勋章”。 - 品牌故事页:三段来历 + 资质背书(占位“正在补充”,等飞哥给政府奖励/背书资料)+ 联系卡。
- 踩坑:第一版拿“有没有地址/家人/用药”当成就条件,但 DEMO_SEED 会给新用户预置,一进页面三枚一起到手;改成数真实动作,且
first_voice必须在/api/voice/asr直接发(那条路径不发消息,客户端随后调 /chat 存的是文字)。 - 验证:本地全接口跑通(充值 300 → 开会员扣 199 → 会员下单双倍 64 分 → 抵 0.64 元 → 账单 left 119.36),devtools 逐页截图核对;线上已部署,韩先生账号补了 11 月账单与历史积分 50 分。
- 会员:年会员 199 元/年(
1.0.11 语音提速 + 语音气泡换声波图标 + 播报只念头两个字修好了
- 识别提速:
/api/voice/asr从 base64 JSON 改成直接发 PCM 二进制(省 33% 体积);讯飞送帧间隔 8ms → 6ms。8 秒长句 1.13s → 0.88s,3 秒常用句约 0.3s(余下都是讯飞解码,本机转发只几十毫秒)。 - 送帧有硬坎:8 秒真人语音各跑 60 次实测——40ms(实时)4.3s;7ms 0.93s;6ms 0.88s;5ms 及以下变 0.8s / 2.3s 两极跳,约 13 倍实时是讯飞引擎的坎。
- 语音标记:气泡里「话音」两个字换成白色声波图标(
svg烘base64),跟正文同一行vertical-align: -3rpx对齐。 - 播报只念头两个字:讯飞 TTS 分片返回,每片单独
base64;拼成长串再解码时 Node 碰到中间片的=填充就停,只解出第一片(13 个字只出 0.86 秒)。改逐片Buffer.from再Buffer.concat,识别反查确认整句都在。 - 真机没声的另一半原因:
wx.downloadFile的域名白名单和request是分开两份,只在 request 里加过 ⇒ 真机静默 fail(原来 fail 回调是空的)。改wx.request取arraybuffer落USER_DATA_PATH/ttsN.mp3再播;obeyMuteSwitch = false;打开播报先念一句;失败给一次提示。 - 验证:devtools 里
onCanplay读到dur=2.844(整句);二进制上传走完整链路(上传 → 识别 → 对话)拿到正确回复与卡片。
- 识别提速:
管家中控全图标化:说话/打字放最左,播报放最右
原来两侧是四个字:「打字」「播报关」,字号 26rpx,老人得凑近看。现在全换图标,一眼认形状。
布局:最左说话/打字互换(语音模式显示键盘、打字模式显示话筒,跟微信那套一致);最右播报开关(开着墨绿实心喇叭+声波,关着灰色喇叭打叉);发送换成 96rpx 纸飞机;主按钮里「话」字圈也换成白色话筒。
技术选型:24×24 svg 烘 base64 进
background-image,不用-webkit-mask换色——mask 在少数低版本 WebView 上不生效,而失败方式是静默渲染成空方块,老人看到四个没图标的按钮还以为手机坏了。放大截图才看出的问题:键盘图标描边初版 1.9,旁边是实心喇叭和粗话筒,视觉重量明显偏轻,统一到 2.1~2.2 才对。
实测(390×762):语音模式键盘 12–61 / 主按钮 67–323 / 喇叭 329–378;打字模式话筒 12–61 / 输入框 67–266 / 纸飞机 274–323 / 喇叭 329–378,高 49px 对齐,无挤压无换行。
体验版 1.0.10,已推送
b1a1792。首页底部补版本号与「北京悦居智能提供技术支持」
页面最底下补一行:
北京悦居智能提供技术支持 · v1.0.9。版本号从
config.js的VERSION读,模板里不写死。发版只改一处,不会出现「配置里 1.0.9、页面上还是 1.0.8」这种对不上的情况。字号 22rpx,颜色用
--muted,比上面那行免责声明(20rpx、--muted2)略大略深。免责声明是淡化处理,署名是要让人看见的,层次不能反。间距用 margin 不用 flex gap:小程序在旧一点的 iOS 上
gap不生效,用了两边会直接挤在一起。分隔点踩了个小坑:一开始用
--line2(#e5e0d6),在米色底(#f5f3ee)上几乎完全糊掉,放大截图才看出来只有一个模糊的点。改成--muted2才立得住。这是配色上的通病——同一个色阶里的两个近色相邻时,浅的那个会消失。模拟器实测(390×762):整行宽 358px、高 16.5px,单行不换行、居中;与免责声明间距 14px;没被底部 tabBar 遮住。
体验版 1.0.9,已推送
9f45923。管家中控并成一行,去掉底部缝隙,修滚动到底:scrollHeight 少算 87px
一、底部并成一行:「说话 / 打字 / 播报」原来独占输入区上方一行,底部凭空高出 66rpx(少显示两行消息)。并进「按住 说话」同一行:主按钮
flex:1,右侧两个 96rpx 小方块(flex:none防被压),align-items:center不用 stretch。打字模式下输入框只剩 338rpx,占位提示改短成「有事您说」(原文「说一句,比如:买袋米」被切成「买袋才」)。二、去掉那 10px 的缝:上一版
measureFeed()里+10留了个「呼吸位」,列表是米色、输入区是白色,中间横一条 10px 底色,像页面少了一截。现在直接对齐.composer实测高度;末尾 120rpx 占位也删了(.msg自带 28rpxmargin-bottom)。三、滚动到底的根因:
scrollHeight少算 87px。实测scrollHeight报 6849,而最后一条消息底边实际在 6936。之前一直以为是采样时机,其实是量的对象错了。改成拿最后一条元素自己的位置换算:last.bottom + off.scrollTop + 8 - feed.height。为了让last一定选得中,给列表最后一个元素挂条件 id(不发消息时是最后一条.msg,sending时是三点.typing),q.select('#mlast')永远拿到最底下那个。改成 80/260/620ms 三次采样(卡片图片晚一拍撑高)。小坑:
scroll-top是「值变了才动」,设之前比一下,差 2px 内当作到底;首次进页面先关动画,900ms 后再开,否则是「刷」一下飞到底。真机实测(华为 4DV0225619008235):进页面超出 0px;上翻后发消息自动跟回底部;键盘弹起时列表跟着让位;切说话/打字两边缝隙都是 0px。体验版 1.0.8,已推送
09b7285。修语音看不到识别结果与「网络不通」:讯飞末帧漏发 status 2
现象:按住说话说完,界面既看不到自己说了什么,管家只回一句「网络不通」。
日志证据:nginx 里每条
/api/chat都是20002ms+499(客户端主动断开),20 秒整,正好是前端timeout: 20000。根因:讯飞 IAT 的
status只发了首帧 0 和中间 1,从来没发过末帧 2。协议规定末帧必须是 2,讯飞不知道音频到头了,于是一直挂到超时——连 2.6 秒的短音频也要等 20 秒。这不是送得快慢的问题。修法一(服务端):补末帧
status: 2,同时把送帧节奏从实时提速(原来录 15 秒就要送 15 秒,光传输就吃掉半个超时)。实测 2.6 秒音频20.08s → 0.85s,16 秒长句→ 1.8s。修法二(客户端拆两段):原来整段录音发给
/api/chat,识别和对话在服务端串着跑,识别文字得等管家想完才一起回来。改成先调/api/voice/asr拿到文字立刻回填气泡(灰色斜体「正在听写…」→ 正常显示),再拿这段文字调/api/chat。老人当场能看到自己说了什么,就算后面超时也知道话没白说。api.js超时从写死 20 秒改成可传:识别 30s、对话 60s- nginx
proxy_read_timeout60s → 90s,让客户端先超时——客户端报错是中文可读的,nginx 504 只有一句话 - 回填用
patchMsg原位替换,不重建整个列表(否则滚动位置会跳)
这个项目踩过的坑:天气源、讯飞签名与帧长、服务器不是自己的那台
天气源别随手选:
open-meteo在本机和服务器都是 TLS 握手 12 秒超时(不是 DNS,是握手就挂住),两台机器表现一致。换http://t.weather.itboy.net/api/weather/city/<编码>(延庆 101010800)后服务器 Node fetch 65ms / 200。区县级,跟老人手机上天气 App 口径一致。讯飞三个坑:签名
origin = host + date + request-line,date必须同一次请求里取,取两次就10105;IAT 送音频必须 40ms 一帧(1280 样本×2 字节),帧长直接断流;开了dwa:'wpgs'就必须处理pgs==='rpl'——那段是替换上一段不是追加,不处理同一句会被念两遍。Node 22 自带全局WebSocket,连讯飞零依赖。线上服务器是 154.8.211.18,不是自己的 (服务器IP)(
*.filebreeze.cn都指 176,但 lehuoquan.filebreeze.cn 在 154)。deploy.sh 里HOST默认值写死的就是 154,用错键找不到路径。同一个实例连跑两遍接口测试必大面积失败:不是代码问题。「进行中订单」互相挡、幂等键复用返回
replayed而非 201。要测就换端口 + 空数据目录。清测试数据前先打备份:数据库 WAL 模式,
lehuoquan.db主文件才 4KB、WAL 已 2.4MB,直接拷主文件会拷到空库。先用PRAGMA wal_checkpoint(TRUNCATE)归并。修首次按住说话卡在「正在听您说」:麦克风权限要提前要
现象:第一次点按住说话,弹麦克风授权框,之后界面死在「正在听您说」出不来。第二次就好用。
原因两个叠在一起:① 代码顺序反了——先
setData({recording:true})弹浮层,再由recorder.start()去触发授权框;第一次scope.record是undefined,所以必中。② 原生授权弹窗会吞掉touchend,onVoiceEnd收不到,recording永远停在true。改法:立一条规矩「权限没确定之前,一步都不碰
recorder.start()」。切到「说话」页签或从首页语音入口进来时warmMic()先把权限问掉(此刻没有手势在进行);按下时_recordOk为真就直接录,中间不插任何异步。头一回按下只用来申请权限,拿到手 toast 请用户再按一次。不在同一次按压里接着起录——授权框关掉那一下
touchend已经丢了,硬起录就变成没人叫停的录音。两道兜底:
.rec浮层加pointer-events: none(不接手指,touchend必须落回话筒);beginRecord()挂 65 秒看门狗,任何路径出岔子都不会留一个点不掉的界面。模拟器用手动打桩测了两条分支(手指先抬 vs 一直按着),体验版 1.0.6。
管家接 DeepSeek 工具调用:天气、超市下单、缺信息追问、主动关怀
管家从「只会跑规则」改成三层:规则层 → 天气快路径 → agent 层。
新增 5 个文件:
agent.mjs(9 个工具:天气/搜商品服务/挂单/记地址电话/查单查药/记事/找人工,4 轮循环)、weather.mjs(中国天气网 101010800,今天+明天,20 分钟缓存)、xfyun.mjs(WebSocket 签名 + IAT 听写 + TTS)、care.mjs(主动关怀扫描)、time.mjs。规则层会主动让路:一句话点两样以上、或没留过电话时
return null交给 agent。否则「两袋大米和一盘鸡蛋」会被截成一样,还不问电话就挂单。价格只准从工具返回里抄:
draft_order只产待确认单,用户说「行」才由规则层execute()落库;模型说「已经下好了」会被FAKE_DONE正则改成「这样办行吗」。连带修复:超市 40 样默认全选(一进页面 842 元)改成 ≤8 样才全选;聊天页滚不到底改成
createSelectorQuery量scrollHeight - rect.height,前五种写法都不灵。体验版 1.0.5,线上已部署并冒烟验证(天气 / 多件下单 / 记地址电话 / 挂单出卡)。
2026-11-15
me-record 补到 20 条判据:PNG 用两套独立实现从外部解;提案 apps 契约守卫
- PNG 写入器的 7 条判据:手写 110 行,此前判据只看签名与 IHDR 宽高。里面最容易错的都是常数(crc32 多项式/初值、adler32、65535 分块边界、每行前置的 0、IEND 那 12 个字节),错了的症状完全一样:文件在那里、看图软件打不开或下半截是黑,而判据全绿。
- 做法:从外部解一遍。用两套独立实现(查表法 CRC32 + 只解 stored 块的最小 inflate)把产物从头解到尾,再与源像素逐字节比。测试侧先对规范标准向量,否则「两个实现互验」可能只是同一个错误写了两种排版。
- 三轮反向实验互不重叠:去掉 65535 分块 ⇒ 只红跨块那条;去掉 write_rgba 空检查 + Report::bytes 累加 ⇒ 正好两条;把多项式写成正向版 0x04C11DB7 ⇒ 4 条红而测试侧校验和仍绿 —— 这就是「独立」的证据。
- ⚠️ 还原要靠 git diff 不靠绿:反向实验后把
self.bytes += …还原到std::fs::write前面,20 条判据全绿,语义却变成「写盘失败也记账」。没判据抓得到的错。 - 顺带补了跨块用例:128×128 的原始行数据是 65,664 字节,正好跨两块 —— 此前所有判据都用小图,分块那段代码从来没被执行过。
- 提案 N-250:13 个带 Cargo.toml 的 app 里 8 个 CI 真编译,5 个从不编(city-twin / anim-metal / studio-native / ui-gallery / ui-lab),而 me-record 的唯一调用方就在 city-twin。提案给三个选项,建议加一条 cargo check;共享 target 的冷编/增量秒数还没实测。
- ⚠️ 两次假空:grep 被 OOM 杀(137、stdout 空)被读成「0 调用方」;用名字表当 CI 覆盖证据(gpu-metal 只在注释出现,实际第 4000 行就 cargo build)。改法不是更小心,是换一条能复现结论的命令。
- 入主:参数表那批 → main 8a94c8f2(CI 1181s / 10 项降级);提案 + PNG 两条一起推(CI 跑着,第二、三轮)。
me-record 参数表补 8 条判据;顺带挖出「apps 从没在 CI 里编过」
- 第二层重复:ffmpeg 参数表曾在本 crate 与 apps/city-twin 各一份(两份不报错、只让片子体积差 40%),那次已合并。本批补的是合并之后没人看的那层:那一处拼出来的东西,是不是文档承诺的那些。threads/bit_exact/crf/preset 四个开关删掉会怎样 —— 编译过、原有四条判据全绿(mp4_twice 反而更容易绿)、产出物完全正常,只是换机器就不是同一个文件。
- 做法:参数拼装抽成纯函数
me_record::encoder_args(mp4 里只剩一行 cmd.args),新文件tests/encoder_args.rs8 条判据。不需要 ffmpeg —— 验的是我们递出去的那串参数,不是编码器怎么理解它,所以不会在缺工具的机器上降级成 SKIP。 - 位置即语义:
-i -之前是输入选项、之后是输出选项。-pix_fmt rgba放到后面就变成「输出用 rgba」,原始字节被当成 yuv420p 解释 —— 颜色整体错、尺寸看着对、照常退出 0。判据不只数有没有,还数在哪一侧、-pix_fmt是否正好两次、-s与 frame_bytes() 是否同源。 - 反向实验:一次改三处(删 -threads、去掉输入侧 -pix_fmt rgba、把 -s 挪到 -i 后面)⇒ 正好那三条红,另五条仍绿,定位互不重叠。
- 一处自我纠正:我早先说 me-record 全仓 0 调用方,其实是那次 grep 被 OOM 杀掉(退出码 137、stdout 空),我把空输出读成了「没有」。apps/city-twin 在用两处。
- 挖出的真问题:apps/** 各自独立 workspace(自带 Cargo.lock,不在根 members),根 cargo test --all 覆盖不到。CI 真编译的 app 只有 coin-run / minigame-smoke / arcade / math-lab / studio;city-twin / anim-metal / studio-native / ui-gallery / ecs-swarm / arcade-replica 一次都没编过。也就是说我改 me-record 的契约,CI 不会告诉我 A1 那个 app 有没有破。
- 台账缺口:plan/board.json 里一次都没出现的 crate 有 3 个(me-arcade 5332 行、me-compare 5740 行、me-record)。看板只有 sprint 任务号这一种粒度,而「一个 crate 存在」不是 sprint 任务。
- 结果:13 条判据全绿(8 新 + 5 旧),clippy / doc 干净,生成物与归属守卫通过(CHANGELOG 走已登记代修)。不进 wasm,包体不动。
S15-8 收口:撤掉重复的 UI 过渡实现,转成一条实测;S16 两件补进看板
- 撞车了,我那份撤了:S15-8 的 UI 过渡,A1 的
me-ui/src/transition.rs(02:49)先落,我 12:08 又在me-anim侧写了ui_transition.rs(455 行 + 10 条判据)。同一件事两份,删后写的那份。DoD「没有第二份插值代码」两边都没破 —— 撞的是记账那一层,而 DoD 一个字没写到它。 - 从那边带回一条实测:被中断的过渡仍按整段时长走完剩余行程 ⇒ 从 50% 处打断「退干净」用 10 帧而不是 5 帧。画面上不是「被打断」是「变慢」,肉眼看不出、像素判据也抓不到。已开 N-247 给 A1。
- S16 缺的是台账不是功能:S16-1(
scope.rs938 行 + 23 条判据)与 S16-2(ledger.rs+ 13 条判据)都写完了,板上一条都没有。前者进 tasks 并勾 DoD;后者记 3/4 ——disk层 0 调用方(push_disk没喂),docs/10那条 DoD 不勾,开 N-248 给 A3。 - 一处我的错:
disk层「可选不急」以前只写在 notes 里,而协同唯一来源是协商表 —— 写在 notes 里等于没说。 - 补了一条判据:
me-rhi转发层原有判据比的是方法名集合,抓不到「转发到别的方法」。新判据要求正文调同名方法。反向实验:begin_frame改成调end_frame(能编过)⇒ 红在["begin_frame"],原有两条仍绿。 - 入主:两批都过了全量 CI(第一批 3056s / 10 项降级),main
0dece559;第二批 CI 跑着。 - 协商板 171 条 / 23 条在等,全绿;A2 名下剩 N-231 / N-150 / N-237 / N-239,四条都要对方扇区先动。
- 撞车了,我那份撤了:S15-8 的 UI 过渡,A1 的
统计页翻页时总结报告不跟着变:两条路同时断,还都不报错
- 病根两个,各自都能单独让报告一动不动,且两头都不报错:① 端侧
LaunchedEffect(reportKind, reload)没有anchor—— 翻页只重发了统计那一个请求;② 服务端/api/reports不接锚点 ——status()永按「现在」算、latest永是「最近一份」,所以端侧就算重发,回来的还是同一份。 - 服务端:新增
reportPeriodAt()把语义分开 —— 带date就按该期period_key取,该期没有就是 null,绝不回退到别的期(回退会出现「日期写 10月5日、正文讲另一周」);不带date则老行为不变。例外:本期没走完时回退到最近一份,与不带锚点一致。 - 端侧:
RemoteApi.reports()加date;LaunchedEffect改成(reportKind, reportAnchor, reload),用归一后的期初(周一/1 号/1 月 1 日)做 key,日视图翻天只要同周就不重复请求。ReportCard补「正在读」与「这一期没有报告」两态。 - 踩到一个坑:
latestOf()回的是原始行(period_key蛇形),brief()读的是驼峰periodKey⇒ 得到undefined,界面变成「有报告、但期别空白」。改用reports.get()。 - 验证:新增
test-report-anchor.js29 条全绿;关联回归 50/81/137/91 全绿。线上 server 1.45.3(md5 逐字相同),逐周真调:11-08→11-02、10-25→10-19、10-11→10-05、09-15→09-14 全对;08-20 那期确实没报告则回(无),没串期。 - 提交
020b486,已推1b421fb..020b486。 - ⚠️ App 侧只过编译:debug 包已出(54MB,仍 134 / 1.60.29),验收时
adb devices为空,真机翻页未验 —— 不装这一版界面不会变(旧包根本不发带锚点的请求)。
- 病根两个,各自都能单独让报告一动不动,且两头都不报错:① 端侧
S15-1 结项:三栏改成内容驱动,web 工作台正文收口 34em;进度重核 76/170 · 284/672
- 三栏从「各算各的 + 减法」改成
layout::distribute一次分完,2026-11-07 造好的Intrinsic第一次被宿主真用上(此前 Studio 写死 262 / 320)。用Item::ranged(Fixed)不是flex_within(Flex):Flex 分的是权重份额,右栏 cap 0.34 > 三栏份额 1/3 ⇒ share 落在夹紧区间中间,拿到份额而不是 cap,差几像素且不报错。 - 实测 1440×900:body 1424 = 左 200 + 视口 984 + 右 240;名字 34 字时 342 / 710 / 372。右栏长值 327(旧版只给 171.6,会截断)。
- 74 项判据改完一个没红(
distribute对 Fixed 做的就是clamp,同一算式),价值是「证明什么都没坏」;靠新加 3 条兜住:总量铺满 / 余量全给视口 / 诉求大于结算值。3 组反向实验真跑过(gap 给 8 ⇒「三栏 1408,那一行 1424」)。 - web 工作台:判据只有 1280 / 1440 两组视口,宽屏从没量过。加 1920 后是 0 违规 —— 布局不坏,只是没人问过「一行多长」。实测正文一行 41.2 / 53.5 / 90.5 个汉字,
.max-width: 34em后三组都是 34。 - 一条被实测纠正的论断:
ch量的是数字 0 的宽(本机字体 0.59em),34ch实测只有 20em —— 「一行 34 字」写成 ch 会变 20 字,而且判据不红(只抓太长)。量中文字数用 em:native 一栏装名字(不可断 ⇒ 像素),web 一栏装段落(可断 ⇒ em)。 - CI 连红三轮,没有一轮是这批代码算错:① ui-lab 控件覆盖表(每加一个
impl Ui的pub fn就红一条,报文不带名字);② 字表SCOPE含apps/ui-lab/src,「增益」不在 495 个码位里(修法是换词不重烘);③run-workbench.sh末句写死「视觉 4 组视口」,加第三组后照旧说 4。 - 落地:main 658d81ac,
S15-1从 wip 挪进 tasks(wip 16→15 / tasks 75→76),docs/10§17 加四小节,Team/notes/A1.md报备三条。 - 进度口径重核(取 main 658d81ac):计划内 76/170 条任务 · 284/672 人日 = 42.3%(在写 15 条 / 61 人日;extras 57 条)。原写的「40% = 255/636 · 67/155 · wip 14 · extras 12」全部过期,分母变了(155→170 任务、636→672 人日);三个数必须一起给,只报百分比会让分母一涨看起来像在退。
- 顺手核出一处账不平:
docs/10§1 抬头写「前 17 个迭代 569 人日 / 全表 636」,逐行合计实际是 630 / 672。差额集中在 S14:一个迭代排了 73 人日 / 23 条(两倍多容量),而文档只承认「S13 排 39」是唯一例外。待 A2 复核 S14。
- 三栏从「各算各的 + 减法」改成
判据的两条几何限制:有些错只有交叉那条测得到;双胞胎抓不住口径错
meet只能验一个轴,这是几何的限制不是偷懒。取min(sx,sy)意味着比值大的那个轴刚好铺满(free = 0),只有另一个轴有空隙。所以九种x??Y??不可能在同一个 setup 里看出差别,最多验三种,要两个 setup:viewBox="0 0 50 100"(free_w=100)验横向、0 0 100 50(free_h=100)验纵向。- 两个 setup 加起来仍然抓不到串轴错。把
match a.align_x写成match a.align_y,横向那三条用的名字是xMinYMin/xMidYMid/xMaxYMax—— x 与 y 的对齐恰好一致,串了以后算出同一个数。抓它的是交叉那条:xMaxYMin必须 x 偏 100、y 不偏。所以「两个单轴判据拼起来」不等于「两轴判据」,必须显式测一次交叉。这一点是变异演练发现的,不是设计时想到的。 - 「期望红而没红」有两种完全相反的真相,只能手算分辨。前者是判据有洞(需要改判据),后者是期望算错(需要改期望)。我这一次遇到的是后者,而且一次就是两处。处置是改期望、并在脚本里写明「为什么这条抓不到」——不是把判据改软去凑它,后者会把「判据有洞」永久掩盖起来。分辨方法只有一个:把 setup 里的
sx/sy/free/tx一个个算出来,看那个数该不该变。 - 一个反例:
if rest.is_empty() { return Ok(ident) }删掉后 0 条红。它看起来在防「空transform属性」,实际上while !rest.is_empty()本来就处理了空串——那是「看起来在防什么」的空代码。同形状的还有Flatten::segments_for里那个n.max(1)。所以演练不只能验判据真假,它也在验代码里哪些分支是真的。 - 下一步(没做):现在 179 条断言里还有几条只证明「自洽」(比如拿 A 跟 A 的双胞胎比)。这类抓得住回归,但拓不住口径错——双胞胎两边一起错仍然绿。值钱的那几条已经把期望值换成独立公式(
πr²/ 交集w·h/ 包围盒整数格子),剩下的还没换完。
素材不够狠,第八次:判据跑绿只说明两个实现碰巧给出同一个数
- 现象:一共十来条判据,写完跑绿,改一行代码去破它(变异演练),结果也绿。判据不红,等于没写。到这一轮已经是第八次。
- 八次的名字:① 漏了闭合标记
Z(纯填充会隐式闭合,必须加stroke才看得见)②stroke-linecap(一条直线看不出圆头与平头的区别)③ 填充规则(一块实心方块上NonZero与EvenOdd同一个数)④ 组不透明度(单块方块上「每个孩子乘 alpha」与「整层打 5 折」同数;必须用两块重叠的)⑤ 自适应离散(tiger.svg的曲线本来就偏小,断成三段与断成三十段看不出差)⑥preserveAspectRatio(圆对sx/sy交换完全无感 —— 交换只是把椭圆转 90°)⑦ 掩码(拿Framebuffer::new当掩码,那张连 RGB 都是 0,两种实现同数)⑧ 裁剪(裁剪框与被裁元素完全重合时,「裁剪形状被当普通图形画出来」这个错画面一模一样)。 - 共同形状一句话:素材必须让那条代码路径有机会把答案改掉。 判据能“通过”是因为两个实现都落在同一个数值上——那不是同意,是没测到。
- 第八次最贵,因为它花了两次才认。第一次是裁剪 ① 用整块 200×200 元素被 100×100 框裁,演练报「期望红但没红」。我第一反应是「判据有洞」,去查判据;真正的真相是素材里那个洞恰好被填住了。改成元素只占上半张(200×100)后,交集 5000 与元素自身 20000 分得开,同一份变异立刻红。
- 可操作的做法:写判据时先问一句「错的那个实现算出来是多少」。答不出来就是不知道自己要区分什么,那就没写完。这一句后来直接进了几份场景文件的注释。
SVG 光栅化层补完十一个缺口:从「只认 path」到能画一份真文件
- 起点是一个静默黑洞:
svgdoc.rs只认<path>与<g>,另外六种基础图形(rect/circle/ellipse/line/polyline/polygon)全落进_ => {}—— 画面上凭空少东西,而 CI 全绿、日志里一行都不留。现在这条缺口关掉了:不认识的标签计入Stats::ignored,tiger.svg上有一条判据要求这个数是 0。 - 十一个功能,每一个修的都是「画得出来但画错了」:虚线(
dasharray/dashoffset)· 端头与拐角(linecap/linejoin/miterlimit)· 填充规则(NonZero/EvenOdd)· 曲线自适应离散(按画布像素卡弦高,Flatten::Sagitta)· 组不透明度(composite_over+ 离屏图层栈)· 六种基础图形 ·viewBox四数 +preserveAspectRatio·apply_mask·<clipPath>+clip-path·transform列表 · 椭圆弧与二次贝塞尔。 - 四处「丢了一半」是可以眼见的骗人:①
viewBox只取后两个数,"50 30 100 100"被当0 0 100 100⇒ 整图偏移 (−50,−30),形状全对、位置整体偏;②viewBox原是在整份文档里find("viewBox=\""),根上没写就读到内层<svg>那个;③ 等比缩放是写死的假设,写none的文件被悄悄压扁;④transform="translate(10,10) scale(2)"被读成一个函数,报「参数读不出来」—— 一句看着像素材坏了的话,而它是导出工具的常见写法。 - 裁剪不能靠截断几何:一条路径被圆裁掉之后边界是圆弧,截断只会得到折线;更要紧的是抗锯齿 —— 圆边界上的像素该是半透明,而截断只能给「在里面/在外面」。所以走「裁剪区域光栅化成掩码 → 内容画到离屏层 →
layer.apply_mask(mask)」,掩码里的变换在光栅化之前进几何(Path::transform),不是事后挪掩码(那会模糊两遍)。 - 账:
apps/clanlib-port断言 179 项全过(15 个场景 / 15 张 BMP);引擎侧me-swrast新增tests/composite.rs9 条 +tests/mask.rs6 条;变异演练脚本从 11 条涨到 13 条(新增 aspect 12 / mask 5 / clip 6 / xform 5,跑起来全部全红)。ci.sh里那七条--check只核演练锚点 —— 全量的那部分要人手动跑,因为一次变异演练要重编十几次。 - 顺带修了一处只会在真文件上炸的 panic:
f32::clamp(0.0, w/2.0)在width="-40"时min > max触发assert!。是变异演练报「0 条红」才发现的 —— 真相是场景 panic 了,一行x都没输出,脚本把「没有输出」读成了「没有红」。现在两处都改:代码用(w/2.0).max(0.0),脚本把panicked at算演练失败。
- 起点是一个静默黑洞:
收付款流水补「三样缺一」与待认领,预算改占用口径
- 收付款流水(24→58 分):新增「三样缺一就说不清」,逐笔核 单据 / 账户 / 回单。回单不是「付了就有」:网银手工付的要自己传,现金的要先缴存才有缴款单,这两笔标红并写清缺什么。
- 新增六步付款状态机(申请→复核→授权→直连→回单→记账),样张停在第四步「钱已出、回单未回」,配一句「没有回单的支出,不算支出」。
- 新增「待认领 · 银行有、系统里没对上」三笔,每笔写清「可能是什么」和「不处理会怎样」—— 对账的第一件事不是做平,是找出说不清的那几笔。
- 预算与超标(17→43 分):占用 = 已用 + 在途,条形图浅色段就是在途;明细表给出可用与占用率,可用为负就是超支。
- 一并修了标题与数据不符:卡片叫「今日流水」却列了 6 条含昨日的,改成「近两日」。
- 厚度汇总:AVG 30.6 → 32.4,THIN(<40) 53 → 49。
决策:同一屏的数字必须同源,负载改成按当天行程算
- 现象:派单页左侧写「张桂芝 余 1 单」(来自
STAFF.orders静态字段),右侧行程板却只画了她两段时间,看上去像「系统自己都数不清」。 - 改法:负载一律用
blocksOf(name).length现算,和行程板、候选排序、可用人力 KPI 四处同源。现在张桂芝 2 单、余 2 单,三处一致。 - 同理处理过的还有:项目页
paid/cost/heads由数据算而不是写死、预算页占用 = 已用 + 在途、流水页流入流出由CASHFLOWS汇总。 - 这条以后当规矩:同一屏上两个数字如果能互相推出来,就不许一处写死一处现算。演示时被问到「为什么这里对不上」,一次就够尴尬了。
- 现象:派单页左侧写「张桂芝 余 1 单」(来自
坑:跨天单的「滞留时长」算出了负数
- 派单页 KPI「最长滞留」第一版算出来是 -1.0 小时:因为待派单池里有隔夜单(SO-20261106-088,昨天 16:10 受理),只比时分就会得负数。
- 正确算法是先把日期差折成分钟:
(new Date(TODAY) - new Date(单日)) / 60000 + NOWM - hm(at),昨天 16:10 到今天 10:00 应该是 17.8 小时。 - 修正后同时加了兜底:
Math.max(0, ...),即使池里只有未来单也不会出负数。 - 教训:任何「距今多久」的计算都不能只看时分,跨天、跨月全靠日期差。而且自检要盯边界值 —— 负数比错数字更容易看出问题,但也更容易被一句
Math.abs()掩盖过去。
派单调度:把「找最近的人」做成约束满足,加了人员×时段行程板
- 页头换成了「派单不是找最近的人」:候选护理员按 冲突 → 证书 → 余量 → 距离 四级排序,距离永远排最后,不然会把单塞给最忙的人。
- 张桂芝 09:10 那单助浴做到 11:10,新单 11:00 起,重叠 10 分钟 → 系统直接把她排到候选末尾并标「时段冲突」。这一步不是写死的文案,是算出来的:
bs.find(b => b.st < en && st < b.en)。 - 新增今日行程板:人员 × 08:00–18:00 时间轴,色块按预约时刻与标准时长画(左定位
(st-480)/600,宽度dur*60/600),红线是现在 10:00。用绝对定位而不是表格,是为了在一行里同时看清「有单的时段」和「空档」。 - 待派单池里两单走真实数据:往
data.js加了 SO-20261107-041(11:00 助浴)和 044(14:30 扶手加装),不再用静态卡片假装有活干。 - 厚度 19 → 54 分,自检
N=1422 ERR=0、DRAWERS=70 ERR=0。
23 步演示导览:老板看前 10 步,业务看后 13 步
23 步,每步
{tag, t, say, act}—— 一个动作 + 一句讲解词。左右键翻页,可左右挪位避开抽屉。路线分两段,对应两类听众:
- 第 1–10 步(给老板/董事长):一个账号进门 → 17 个系统 → 切角色看权限 → 切机构看数据范围 → 金额三档 → 大屏同源。要回答的是“为什么不能直接买现成的”。
- 第 11–23 步(给业务/财务):订单怎么变钱。立项 → BOM 展开 → 净需求 → 比价 → 定标 → 收货 → 领料 → 安装 → 开票 → 收款 → 分录 → 五张表。中间在第 20 步停在预算闸门,给听众选一次。
三个异常放最后:短收 / 退单 / 三单不匹配,改一张单,下游分录与毛利表跟着变。
导览面板初始
display:none,所以在renderApp()末尾幂等调一次tourRoot(),否则入口根本不存在。按钮bottom:64px避开右下角角色浮层。毛利口径改成「估价 − 定标价」:少装的货不能算成省下的钱
两个数字错了,不是算法错,是口径错。已改并加了回归断言。
一、比价省下的钱从 16 跳到 87
saved原来算quote - cost(估价 − 实际成本)。收货短收 4 台后成本变小,账上就显示「省了更多钱」—— 实际上那 71 块是少装的货,钱没进账,欠客户的。改为
saved = quote - po(估价 − 定标价),另单列gap = po - cost并标红:“这不是省下的钱,是少领的料。”二、毛利率 25.76% 虚高 71
同一个根因。短收后收入少了 389,成本少了 460,毛利反而被抬高。真实是净亏 71。修了之后异常票上直接写“毛利虚高 71,实为净亏”。
教训:异常分支不是改个数字就完事,口径不变就会让报表说假话。演示时被人问一句“短收了毛利怎么还高了”就穿了。
iframe.srcdoc 设了却加载空白 —— 包被 body.innerHTML 抹了
现象:
f.srcdoc = html执行成功,但contentDocument.body.innerHTML.length == 0,也不报错。两个真因,分两次才找全:
1. base64 包放在了 body 里。主原型每次
renderApp()都重写document.body.innerHTML,body 里的<script id="chainPkg">第一次渲染就被抹掉,getElementById('chainPkg').textContent读出空串 → 解码得空串 → srcdoc 为空。包必须放<head>。2. iframe 还没 append 就赋 srcdoc。游离节点赋值不触发加载,先
body.appendChild(f)再赋 srcdoc 才行。另两条坑:
blob:URL 在file://下被 CORS 挡死(SecurityError),srcdoc同源可读可调contentWindow,选 srcdoc。- 覆盖层(演示导览、应用框)要挂
document.documentElement,挂 body 同样被重写清掉,而且会让 iframe 重载、推演进度归零。
把 57 页后台、三条链路和五张报表装进一个 520 KB 的 HTML
目标是演示时只需双击一个文件,不用先开一个原型、再切另一个窗口。
做法:
- 把《业务链路推演器》整份 base64 编进演示台
<head>里的window.CHAIN_PKG - 点「业务链路」时 atob + TextDecoder 解码,塞进
iframe.srcdoc - 推演器和主后台的通信走
iframe.contentWindow.YJChain,只暴露goto/chains/state/run四个动作
现在的入口:7 个系统页头 + 订单抽屉 + 两张 L2 抽屉底部,共 5 类跨模块跳转,两边能互跳。
构建脚本
build_all.py:先跑build_chain.py出推演器,再把它打进演示台。改任何一边都跑这一个。- 把《业务链路推演器》整份 base64 编进演示台
2026-11-14
Unity 7 调研:它花十年修的是「并存」,我们别重犯
- 数据源:
UnityCsReference@7000.0.0a16(Unity 7.0 alpha 16,2026-11-05)。树里 9,035 个.cs;blob 只落盘 2,639 个 / 783,136 行(Editor 层近全量:1,544 文件 / 456,886 行)。核心 C++ 一行看不到——那本身是第一条结论。 - 三条硬数据:① 398 个
*.bindings.cs= 12.1% 的行数没有任何实现(全文 6,556 处extern、964 处NativeHeader)② 编辑器 1,544 个.cs里 UI Toolkit 约 18%、IMGUI 约 19%,两套并存五年(OnGUI(已 0,但GUILayout/EditorGUILayout还在 300 个文件里)③ 最大单一模块是GraphToolkitEditor813 文件,第十名才是Entities163。 - 主论点:它十年修的是「并存」不是「功能」。三管线收敛 7 年(2026-06 的 6.5 才正式弃 BiRP),Mono→CoreCLR 9 年(2017 HackWeek 原型 → 2026-10 的 7.0 编辑器才不带 Mono),而且为此暂停了动画与世界构建的新功能。
- 该抄三条,全关于怎么退役:弃用写日期三件套(最后支持版本 + 支持结束 + 迁移文档)/opt-in → 默认 → 留逃生阀/给 agent 一条
me status --json(先做命令,MCP 只是壳)。 - 不该抄三条,全关于怎么并存:五对两个(渲染 3 套 + 物理/UI/输入/运行时各 2 套)/闭源核心/可回溯的商业条款。Unity 自己的判词是「Game Objects won, but Entities will Drive Game Objects」。
- Web 差距:Unity 空项目 7.7 MB(2D BiRP)/ 10.7 MB(3D URP),Godot ~5 MB,我们 795.1 KB 的完整游戏——9.7 倍 / 6.3 倍。Unity 那条「双后端同构建 + 按设备自动回退」值得抄,硬约束是「用户只下一份包」。
- 两篇调研撞出同一个洞:Godot 44% 的编辑器 include 自家控件 vs 我们
me-studio对me-ui是 0%。
- 数据源:
Godot 4.7 调研落地:抄产品化那层,不抄引擎那层
- 拉了 Godot 4.7.2-stable 源码(445 MB,gitee 镜像)+ 官方 demo 目录树,出
docs/20-godot-study.md(591 行、35 个小节、113 行表格,数字都带可重跑脚本或文件行号)。 - 该抄三条:场景是文本 + 两级稳定 id(资源
uid://与节点unique_id,写盘处resource_format_text.cpp:274)、导入旁路文件、编辑器吃自己控件(我们 me-studio 压根不依赖 me-ui)。 - 不该抄三条:309 方法的 Vulkan 式 RD(我们 38 个方法撑三个后端)、双渲染器(它是 renderer_rd 65k + gles3 31k 两套完整渲染器,实测漂移 cluster 1109:0、sdfgi 974:35,不支持的只能写静默 no-op)、运行时反射(1783 个类 / 36 个 Variant 型)。
- 最该抄的是 §5.1:用编译期生成的静态组件表拿属性反射,而不是把 Variant 搬过来。
- demo:139 个里 27 个是 2D,逐条判完 ✅11 / 🟡12 / ❌4(脚本核过 27 对 27)。3D 32 个出局——我们没有 3D 渲染器(Camera3D 全仓 0 处)。
- 中间修了一次自己判错的:
polygons_lines原判能做,理由是「me-math/poly.rs有三角化」,实际那是多项式不是多边形,全仓三角化 0 处。已改判 🟡 并进附录 B。 - 落库 main
0a95a4a7 → 193d738e,两次 CI 699s / 526s 全绿,树断言 e40a8c96。
- 拉了 Godot 4.7.2-stable 源码(445 MB,gitee 镜像)+ 官方 demo 目录树,出
文档里点名的符号现在有判据了(附录 B.8 那条做成)
- 新增
tools/ci/check_doc_symbols.py+ CI 一步(117→118 步):状态文档里反引号点名的me_*必须真的存在;范围是docs/**减 adr/proposals(那两卷在说「打算建什么」)。 - 逃生阀不设白名单:讨论它的那一段得自己承认它不存在。粒度错了两次——按行(正文硬折行,一句话跨行)、按句(词表一下午加三次),最后收到段级。
- 「存在」的定义收紧三次,每次都是踩出来的假绿:注释里提过不算、README 里不算、
interface/MANIFEST.json里记着「v31 已删 me_rhi_draw」也不算(删除记录被当成存在证明)。 - 收紧后真实 5 个符号 / 12 处,全带备案。与手数报的 2 个对不上是因为旧口径——两件事分开记。
- 判据先挑出我自己新写的那段 B.8(列了 5 个不存在符号而整段没说「不存在」)。
- 顺带:S19 两条 DoD 据实测打勾(capi 43=43 双向差集空;IR 两条逐字节测试跑绿);M0.9 第 3 条两条腿今天重跑(跨机 20/1/0、同机 20/1/0)后打勾;S18 那条 draws 判据没勾并写清缺的是哪一段。
- 降级表按「拿真实输出对表」核了一次,补登
SHELL-PROBE-WINDOWS与XSECTOR-EXPIRED;这条方法本身记进了手册。
- 新增
2026-11-10
报表不许手填,但有三样东西自动不出来
- 原则:报表所有数字 = 期初余额 + 分录汇总,分录由单据终态自动生成。人只做两件事:推进单据、看报表
- 但必须承认三个边界,否则就是吹:
- 期初要人工搬:8 月售卡 4,776 不在链路里,没期初的话核销时预收会变成 −398。这就是「上系统先搬期初」的真实原因,省不掉
- 合同额在链路外:毛利表的 524 来自合同系统,链路只管成本那一半。合同额不对,毛利表全废
- 往来单位要靠主数据:分录能自动生,但「这笔应付是欠明觅还是万象汇」靠 party 字段。没维护就全进「未指定往来」,明细表立刻失效
- 否掉的方案:在报表页给人留「手工调平」入口。一旦允许手填,账和业务就脱钩了 —— 下次对不上时没人分得清是业务错了还是手调错了
- 一个实现细节:凭证单(VCH-*)标
post:false,只展示不重复计账,否则一笔业务会记两遍
链路里少一张领料单,毛利表的成本就永远是 0
- 现象:把三条链接到项目毛利表,成本永远是 0、毛利率永远 100%
- 查:手数 p2p 的 9 张单 —— 请购 → 比价 → 采购 → 收货 → 质检 → 发票 → 应付 → 付款 → 凭证。料进了仓库(借 库存商品 460),但没有任何一张单把它从仓库挪到工地
- 根因:收货只让料「从供应商搬到仓库」,资产还是资产。要领到工地才算项目成本。原链路把「入库」当成了终点,漏了「出库」
- 修:补一张领料出库单(借 合同履约成本 460 / 贷 库存商品 460),插在质检之后、收票之前。补完后库存清零、合同履约成本 460、毛利 64
- 教训:「账能不能自动出来」是检验链路完整性的最好尺子。页面画得再全,只要报表某一行永远出不来,就说明链路缺了一张单 —— 这个漏洞看单据流看不出来,一算账就暴露
三条链路接到账簿:7 张凭证、15 行分录、五张报表自己平
- 上一版只做到「单据流转」,57 页全是列表。这次往下接一段:单据到终态 → 分录自动入账 → 报表全是派生的,没有一处手填
- 三条链跑完(服务 6 / 采购 10 / 报销 6 单),产出 7 张凭证 15 行分录,本期借贷各 3,682.60、期末各 4,821.00,差额 0.00
- 三个能对上的验证:预收 4,378 ÷ 398 = 11 次(账上的负债 = 业务欠的活);库存商品与应付暂估双双归零(冲回做对了);项目毛利 64 = 报价口径 48 + 比价省 16
- 五张表:试算平衡 / 资产负债 / 利润 / 往来明细 / 项目毛利;每行可展开看来源凭证,数字能倒查回单据
- 自检:账务逻辑 27 项 + 浏览器 DOM 全矩阵(1460 / 1024 / 742 三宽度)0 错
S17-3 落地:动画系统的 Metal 原生渲染(main 96d7a01d)
- 一条链上两处断裂,两处都不报错:① MSL 出口只有精灵管线,
create_pipeline用Unsupported拒绝非 GLSL 后端;② Metal 后端 3 个 uniform 槽 vs 契约 131 个 ⇒upload_palette写到第 4 个 vec4 就 InvalidArg。 - 补法:msl 四条蒙皮出口(调色板
constant float4* u_bones [[buffer(4)]]);后端骨骼段 128 个紧凑 vec4 合并成一次上传(64 字节存法会 8KB,超 setVertexBytes 4KB);program*按ShaderLang分派。 - demo
apps/anim-metal/:6 节骨骼链,12 帧 PNG + 拼图,bash apps/anim-metal/run.sh。 - 判据:只换调色板(0°/90°)看象限搬移 —— 绑定姿势下任何不生效的调色板都画出同一幅画;131 槽逐个写得进 / 132 必被拒。反向实验四个全红。
- 收尾三件:漏同步两份 wasm 快照(CI 拦下,体积不变 md5 变,368 字节);
emit_msl覆盖面缺蒙皮(8→12 份 + 脚本点名);图集真机探针一次抖动(单跑 18 条全过)。 - 全量 CI 964s 通过,6 条提交合入,main = 96d7a01d,四条 land 判据(树一致 / 每条都是祖先)逐条验过。
- 一条链上两处断裂,两处都不报错:① MSL 出口只有精灵管线,
重跑导入不再把产品详情长图冲成封面(0.12.6)
产品图片分「封面」与「详情长图」两组后,重跑一次导入就会把长图全冲成封面:导入对图片是「整组重建」,而分组标记通常只存在于数据库里(长图是事后手工标的,数据源 JSON 里没有这个字段)。后果是图片文件还在,但对外接口的长图分组空了、官网详情页整宽长图静默消失,而导入日志只显示「图片 N 张」。
修法:重建前先把同名旧记录的分组标记抄下来,优先级 = 数据源明写 > 同名旧记录 > 封面;另写一个校验脚本,在临时库上验证「重跑一次不退化」。
这类 bug 的共同点是:写的时候无感,读到才发现不对。同一批修掉的还有产品规格字段超长——导入时不管、列表接口直接 500。
发版前多了步 md5 对拍,救回 490 条产品规格
发版前把服务器上前后端每个文件的 md5 算成清单,跟本地逐一比对——而不是直接 rsync --delete。对出两个文件只存在于服务器、从未进过 Git:一份供应商价格表数据源(已补全过规格)、一张规格标签对照表(多 11 个键);旁边还躺着两个 .bak 和四个一次性修复脚本。
直接部署会怎样:用本地版覆盖后,490 条产品的结构化规格(显指 / 色温 / 尺寸 / 灯珠)静默退回旧版,官网规格区大面积空掉;65 条产品的「配件」标签全没;11 个标签消失、界面直接显示英文键名。而部署日志、健康检查、首页 200 全都会显示成功。
处置:线上版本取回入库(逐条确认仅线上多 490 条规格、少 9 条表格说明行);四个脚本原样存档并标「路径写死指向线上库,不要跑」,它们恰好解释了那批规格怎么补出来的。
两条教训:① 数据源与标签白名单只能改仓库,直接改线上会在下次部署时静默还原;② rsync --delete 前一步固定是 md5 对拍,不是可选项——健康检查只能告诉你「进程活着」,告诉不了你「数据还在」。
人工改按人天记账,员工薪资分「日薪 / 月薪」两制(0.13.2 上线)
项目费用原来只能记一个金额:「人工 5431」这样一行。能算进利润,但答不了三个每天都会被问的问题——这单用了几个人、干了几天、一天多少钱。
改成一人一条,金额 = 人数 × 天数 × 日单价:
- 金额由服务端算,前端只做预览。手改金额、复制旧条目、浏览器浮点误差,最后账都对不上。
- 缺项不猜:天数或单价只填了一个就拒收,不按 1 倍补齐——那会造出一个看着合理的错数。
- 「按派工带入人工」做成显式且幂等的动作,派工不自动写费用:自动写的话,每改一次派工就多加一条,一单下来人工翻三倍还没人发现。
同时补上月薪制:施工队按天议价,内勤 / 设计 / 项目经理拿月薪,两种人都要能算进项目。月薪不另立一套成本算法,只在出口折成日单价(默认按 21.75 天,界面给 21.75 / 26 / 30 三档)。同一个 8000 元月薪,按 21.75 天是 367.82/天、按 26 天是 307.69/天,差 20% —— 这是公司的会计口径,不该由代码拍定。
两个细节值得记:
1. 折算结果不落库,每次现算。写回日单价字段的话,一调薪就会出现「档案一个数、成本另一个数」,而且没有字段能证明哪个对。
2. 切换计薪方式时不清另一套数字:日薪改月薪、再改回日薪,原来的数值都还在,不用重输。
顺手把设备清单加了供应商 / 品牌 / 类型筛选,筛完直接显示「筛出 N 项 · 报价小计」——筛完最想知道的就是这个数。
包体归因:先把「字节属于谁」这张表修成真的,再接进 CI
- 余量只剩 4.9 KB(795.1 / 800 KB),而
wasm_budget从 10 月写好起从没被跑过 —— CI 里没它的位置。 - 先查工具自己:它把产物报成「中文 11.4 KB / ASCII 0.2 KB」,严格 UTF-8 实测是 6.4 / 12.5 —— 几乎对调。两道判据几乎恒真(
0x80..=0xFF一律算文本;0xE4..=0xE9占 1‰ 算中文)。 - 改成按文本游程切(严格 UTF-8、≥8 字节才算),CJK 按码点比例;
--self-test喂 6 个已知答案样本 + 混合段 + 逐字节守恒。反向实验两轮都红。 - CI 新增一步(只增不改):先自检再出表;归因表凑不齐或段级重复 >1 KB 也红(后者以前只印不判)。
- 结论:文本只有 18.9 KB,不是大头;五张图集全是
zlib(9)且解压逐字节等于.rgba⇒ 没有安全字节可砍。800 KB 是 S0 手写圆整数,真约束是.70冷启动,要真机实测重定。 code522.2 KB(65.7%)还没归因:要留name段重编 + 按函数切。
- 余量只剩 4.9 KB(795.1 / 800 KB),而
分支落后 168 个提交,代价是重做了 A1 三天前的活
- 今天上午从零查「100 个刚体堆 10 秒会倒」,花了 6 个假说。下午合并
origin/main时发现:A1 在 11-06 就提了N-153写了同一个病(“今天掉 22 个”、临界 7 层、与宽度无关),而我的分支落后 168 个提交,板子上没有它。 - 结论对上了,力气白花了。更贵的是:我一直把“板子上没有”当成“没发生”,而那其实是“我没拉到”。
- 可操作的规则:分支落后超过一周就先 merge,再判断“这事没人管”。合并本身有成本(
negotiation.md有冲突、需要脚本解析块来合),但比重复劳动便宜得多。 - 合并的副产品:发现 10 条我自己答复过却没改状态的条目(“谁答复谁改状态”没做到)——
watch.py一直在把 A3 列进「在等」,我的待办虚高 10 条。 - 合并还顺手纠正了 A1 的半个结论:他测的
20/10、40/20是把 velocity 与 position 一起提的,两半效果相反(velocity 提了变好、position 提了会崩)。同事报的“调更多没用”可能只是他的调法里有一项是负作用。 分开扫比信结论便宜。
- 今天上午从零查「100 个刚体堆 10 秒会倒」,花了 6 个假说。下午合并
「看着像就安一个教科书机制」是本项目最贵的错:它给出贵而不起作用的方案
- 背景:一个 10 层堆叠会倒。第一版没查数据,直接根据两个现象(塔倒 + 锁旋转就稳住)安了一个教科书机制(顺序求解净扭矩)。那个结论听起来专业、做起来很贵(3–5 人日)、而且做完不用验证就能交差——没人知道它本来就不该治这个病。
- 真实原因花了六次实验才找到:默认 8 轮迭代传不完 10 层串联接触。而
StepStats一直是pub的,里面有pairs/manifolds/normal_impulse。直接打印它,比猜六个机制的力气小一个量级。 - 具体判别读数:底层
vy在 8 轮下卡在 28px/s 不降、32 轮下三步收敛到 0。这个数比「塔倒了」有用一百倍——后者只能确认现象,前者能定位层。 - 一个现象能同时解释两条通路时,它不能当判据。 「锁旋转就不倒」看着像「所以是转动问题」,其实锁旋转同时把塔变成了只能竖直传力的质点链,同一病因换了表现。排除法要求“若否则大不同”,不是“如果像那就是”。
- 改之前先量。 「接触容差为 0 导致 chatter」听着很对,加上 0.5px 容差后:单列逐位无变化(说明从来不是瓶颈),10×10 直接爆到 41km(让并排箱子互相粘住)。一次都没量过的改动,很容易在不相关的场景里造成爆炸。
- 还得注意写文档的副作用:11-07 我把错结论写进了 CHANGELOG 和判据文件头,A1 会按它排期。错结论进了文档就会自己长腿跑。 定了之后要么第一时间通知,要么改成“待验”状态再写。
S13 止损线的病因更正:不是净扭矩,是 8 轮迭代传不完 10 层
- 11-07 我给 A1 的结论是「2 点流形顺序求解带净扭矩 ⇒ 上块求解(3–5 人日)」。那个结论是猜的,今天推翻。
- 判别读数(同一场景只改
velocity_iterations):8 轮下底层竖直速度第 9→11 步 26→28.5→28.3 卡住不降;32 轮 9.4→7.2→5.6 收敛到 0。600 步后 8 轮下沉 200px 翻倒,32 轮下沉 28.5px 站住。 - 分界严格在层数 6→7,与宽度无关:80px 宽(宽高比 1:2.5,物理上绝不该倒)照样翻。8 轮 ≈ 8 跳传播距离,6 层够 7 层差一点。
- 块求解治不了这个病——它管「同一个流形内部两点冲量不等」,而这个病在「上下相邻两层之间」。两件事不在同一层。那 3–5 人日排期是白花的。
- 上一版错在把「锁住旋转就不倒」当判据:锁旋转同时把塔变成只能竖直传力的质点链,同一病因换了表现(塌不表现为翻倒、表现为下沉 9.4px)。一个现象能同时解释两条通路时,它不能当判据。
- 排除过程(六条,各有实测):地面摩擦(μ=0.6,排除)、恢复系数(e=0 仍翻)、暖启动(关掉仍翻)、分岛(逐位相同)、参考面抖动(真缺陷但只治 289→164)、接触分离容差(单列逐位无变化,10×10 爆到 41km,有反作用)。
- 判据 9→10 条,新增一条同时断言「8 轮塌 / 32 轮稳」,两组变异证过会红(2.13px / 15.27px)。整包 86 条全绿,
N-357已按这版更正。
2026-11-09
源码推入 Gitee 私有仓库 yueju-digital-design
- 5 个提交 / 29 文件 / 16,736 行,按主题拆:仓库骨架 → 设计规范与皮肤 → 交互原型 → 方案稿 → 样板与素材
- 私有仓库:17 个子域规划、组织机构、订单与成本口径都在里面,不能公开
.workbuddy/整体忽略:13M 是本机运行时截图与工作日志,不是交付物- 体检只命中一处:登录页的演示密码
yj@2026,假数据,保留 - 令牌没写进
.git/config,remote 保持干净 URL(用一次性 credential helper 推) - 已知:
assets/有一张重复图(同 md5),白占 1.8MB,未删
2026-11-08
移动端表格把中文压成一字一行,先别急着认定为横向溢出
现象:430px 宽下,订单表的客户名和「上门安装服务」被压成一字一行,右侧内容看着像被裁掉。
根因:
table没设最小宽度,浏览器按容器宽度硬分列;中文没有词边界不能断词,只能一个字一行。修法:760px 以下
table.tb设min-width: 820px、td.k设 132px,走横向滚动而不是压缩。820 不是拍的——先用探针量出max(各列最小可读宽)再加合。真正值得记的是怎么发现的:一开始靠截图目测,以为是横向溢出。用 DOM 探针实测才看清:无头 Chrome 的
--window-size=430实际innerWidth是 526,截图看着像被裁,探针报scrollWidth 485无溢出——问题根本不是溢出,是列宽不够。教训:窄屏判断一律用 DOM 探针(
clientWidth/scrollWidth/getComputedStyle),不要用截图目测。否则会去修一个不存在的 bug。旅行卖位置、保洁卖人时——业态插件的切分线定在「订单行怎么履约」
飞哥问:客户下一个旅行订单涉及几个系统?下单保洁呢?
答案:都是 7 个,但只有 4 个共用(CRM / OMS / CASH / BI),中间履约段完全不同。
- 旅行卖位置:资源位库存(按「资源 × 日期」扣可售量)→ SRM 供应商分账(民宿 / 餐饮 / 讲解各结各的)→ 电子协议 → 到店核销
- 保洁卖人时:HR 排班技能匹配 → 派单(距离 + 单日工时上限)→ PMS 现场签到拍照签字 → WMS 耗材领用
关键判断:资源位库存 ≠ WMS 物料库存,是两张表。前者按「资源 × 日期 × 可售量」扣,后者按 SKU 扣件数。混成一张,月底必然对不上账。
否掉的方案:把旅行和保洁拆成两个独立后台。理由——客户档案、订单主表、收款、报表会立刻分叉,两个后台各记一份客户,同一个客户在两边消费就对不上人了。
结论:业态插件的切分线定在「订单行怎么履约」。前后两端 (下单 → 客户 → 订单主表 / 收款 → 报表) 共用,中间分叉。插件只换中间那一段。
把 ERP 从「财务总账」改回「资源计划」—— BOM 才是内核
现象:上一版把
erp这个 id 给了「财务总账」(凭证 / 科目余额 / 报表)。飞哥直接问:ERP 不是企业资源计划、按产品拆物料型号和数量吗?根因:国内用友 / 金蝶把 ERP 泛化成「财务 + 进销存」,只有制造业客户才开 MRP 模块。我照着这个泛化建模,做出来的是 ERP 的 FI 尾巴,却当成了全身。
正解:MRP(BOM 展开算净需求)→ MRP II(加产能 / 车间 / 成本)→ ERP(1990 年 Gartner 提出,标志是业务单据自动生成凭证)。「资源」= 物料 + 产能 + 资金 + 人,物料是第一个也是最内核的那个。
落地:改名「资源计划 ERP」,3 页扩到 5 页 —— 计划组(方案物料计划 / 净需求与请购)+ 账务组(记账凭证 / 科目余额表)+ 报表组。
为什么悦居需要 BOM:报价单本质就是 BOM。安装费 = 物料 × 15% 就是「人工随物料走」,典型的工程 BOM 逻辑。三居室 A2:8 行物料、需求 12/6/4/22/1/1/1/8,减库存与在途后净需求只剩 12 件,齐套率 75%、物料成本 6,380 元。
口径坑(已写进页面):缺料货值 ¥524 按售价、建议采购 ¥476 按采购价,差的 48 元是毛利不是误差。对账时不能拿这两个数比。
三种业态物料强度不同:智能家居工程有真 BOM;养老服务是服务 BOM(工时 + 耗材);乡村文旅根本不拆物料,卖资源位 + 日期。
17 个系统全部展开为独立工作区,共 57 个功能页
- 上一版只有 8 个系统真展开了,wms / exp / cash / oa / clm / admin 六个挂着「共用骨架」标签 —— 拿共享骨架冒充独立系统,飞哥直接批了「有点偷懒」
- 改成
#/s/<系统>/<页面>路由:进系统后侧栏换成该系统的功能树,顶栏面包屑变「机构 / 系统 / 页面」,正文顶上加一条系统徽标(域名 + 职责 + 权限级) - 规模:17 系统 / 57 个功能页(其中 ERP 5 页、CLM 4 页、OMS 5 页、PMS 4 页)
- 权限两层:系统级不过侧栏只显「未授权」不列功能树;页面级不过才出 403 —— 护理员点 ERP 看到的是前者,不是「功能被藏起来」
- 自检:8 角色 × 5 机构 × 57 页 = 2280 次渲染,0 错(无 undefined / NaN / 抛错)
代码上 Gitee:yueju-call 与 yueju-token-server 两个私有仓库
- 两个私有仓库已建并推送成功(Gitee API 建库 + SSH 推送,均 main 分支):
gitee.com/halley2026/yueju-call→5b1ddf1(10 文件 / 4097 行)gitee.com/halley2026/yueju-token-server→0adebe7(5 文件)- 推送前做了敏感文件体检:远端树里无
tokens//*.keystore/*.apk/.env,gen_token.sh也无硬编码证书,凭据全靠(本机路径)与.env.runtime现场读。 - 本机已有 Gitee 认证:SSH key
(本机路径)已绑 halley2026;另存有 HTTPS 令牌(可用于 API 建库 / 改仓库设置)。 - 约定:新项目默认私有仓库 + main 分支,远程用 SSH。
2026-11-07
容差按「结果的量级」算是错的:f32 相消会把 1e-5 顶到 3.5e-5
- 给
me-math写对 f64 的 10⁵ 组对拍时,第一版容差用1e-5 × |结果|,红了 6 条而没一条是真缺陷。 - 原因:
cross(a,b)在输入 ±1024 时是两个 1e6 量级的数相减得到 185,两个乘积各自的舍入误差就有1e6 × 6e-8 ≈ 0.06,相对 185 是 3.5e-5 —— 比 1e-5 大 3 倍多。那不是实现错,是 f32 的 24 位尾数在 185 这个量级上能给的全部。 - 正确写法:容差按各项绝对值之和算(
1e-5 × max(Σ|各项|, 1.0)),条件数进分母。相消表达式没有「相对结果」这个量级的保证。 - 同类的第二个错:测量穿透时第一版「只量竖直方向」。两个转 45° 的盒子并排,支撑半宽各 14.142、竖直方向相加得 28.28,报出「穿透 28.18px」——真实值是最紧那根轴上的 1.69px。方向对、量级错 17 倍,而它还是全场最大值,判据会踩着一个假数红/绿。得用真 SAT(四根面法线取最小重叠)。
- 教训是同一个:自己的测量代码也要有判据。
pair_penetration哪天悄悄返回 0,上面四条会永远绿。
- 给
S13 的止损线第一次被真的跑起来,它没过
- §15 的 DoD 第一条「100 个刚体堆叠 10 秒:不炸、不穿、不抖」此前没有任何判据,
me-rigid2d76 条里规模最大的是 6 个体。今晚补tests/stack100.rs(9 条),第一次跑就红了。 - 读数:穿透 0.98px、堆顶下沉 200.5px、水平漂移 289.0px。锁住旋转则漂移变成 0.00 ⇒ 塌是转动问题(2 点流形被顺序求解,合起来带净扭矩),不是位置解算发散。
- 把
LINEAR_SLOP降一个量级(0.5→0.05)不解决翻倒(漂移 197px),只把穿透压到 0.72 ⇒ 两个病,一个参数治不了。 - 两处 DoD 与实现打架:① DoD 的 0.5px 与
LINEAR_SLOP = 0.5是同一个数,十层累计必然越线 ⇒ 这条 DoD 在现有参数下不可能成立;② DoD 第二条的「贝塞尔求根」没有实现(poly只有二次求根)。都记在N-357等 A1 拍。 - 没动求解器。判据分两档:默认档只断言今天成立的,
STACK100_STRICT=1才断言 DoD 四条 —— 免得它落地第一天就红然后被#[ignore]掉。 - 顺带:
me-math补了tests/against_f64.rs(12 条、120 万组采样、0.08s),这是 DoD 第二条此前完全没有的一层。
- §15 的 DoD 第一条「100 个刚体堆叠 10 秒:不炸、不穿、不抖」此前没有任何判据,
S16-5 后一半:me watch 落地,§3 表被迫长出一列「输出」
- S16-5 收口:
me watch落地(增量监听 + 变更集),契约 §3.8,事件 schemame.watch.v1 - 本仓唯一不经过
main::emit的命令:其余命令输出「一次结论」,而它输出「一个过程」。三条不变量:一行一个完整 JSON、首start末stop、seq不跳号——第二条最要紧,进程被杀时没有stop,那是编辑侧唯一能区分「跑完了」与「断了」的信号 - §3 表被迫长出第五列「输出」(信封/流):不加的话
--json扫描会跑me watch --json而它永不返回,CI 不红只会挂着。这列是给「判据自己别变成挂起」开的规矩 - 增量是两层指纹(文件字节只决定要不要重解析、节点指纹决定变更集);坏文件不中止也不参与节点差分(中间态必然语法错),保留最后一次好的快照,坏→好抖动不刷屏
- 判据:Rust 157 条;
test_cli.sh176→190(第十一节按列分流 17 条全覆盖 + 新的三步真改文件增量演练);drill-watch.py6 条变异逐条证过会红。演练逼出真问题:scan()那层原本没有判据——单测只覆盖了diff,把scan换掉则毫无反应,而真实后果是编辑侧每存一次盘场景节点全删再全加
- S16-5 收口:
安全修复:归档校验放行会删本地、物理删除、远端命令注入三处 P0
- P0 校验放行(会真丢数据):
(v?.remote ?? 0) >= (v?.local ?? 0) / 100 * 99,verify 返回 nil(ssh 超时/路径不存在/无输出)时是0 >= 0判通过;整数除法又让 <100KB 的项阈值恒为 0。配合「传完删本地」,一次超时就能把没传上去的文件删掉。改为 nil 一律判失败,容差max(1%, 4KB)浮点比。 - P0 物理删除:
removeItem+try?不可恢复且失败无声。改trashItem,失败写日志并保留文件。 - P0 命令注入:
remotePathExpr双引号包路径,双引号内$(...)照样展开,目录名填/tmp/$(rm -rf ~)即远端任意命令执行(实测可复现)。改单引号 +"$HOME"/'剩余'。同类三处一并修:rsync 远端目标未转义(含空格会把文件传到别处且不报错)、tar 管道-C "路径"、Windows 校验的 powershell(PS 与远端 shell 两层)。 - P1 管道阻塞:AI 服务拿到密码就拆了 readabilityHandler,Pipe 没人读,输出满 64KB 阻塞在 write(),「AI 用着用着不回话」——与 0.2.2 归档假卡住同病。改为持续读 + 打码 + 2MB 滚动。
- P1 密码入日志:启动横幅
Password cw_xxx落在 644 文件里。改落盘前打码 + chmod 600,历史日志已抹。 - P1 tar 停止无效:sshErr 无人读会死锁,且整段没 track()。改轮询可中断,两个 stderr 都读走。
- 新增
--security-test:六项断言全绿(注入不执行、字面量落盘、空格与单引号、~ 展开、日志打码、日志 600),退出码可进 CI。 - 提交
c3f78d6已推 Gitee。
- P0 校验放行(会真丢数据):
S16-5 前一半:协议协商 + 冻结面,让「无破坏性变更」变成可判的
- S16-5(6 人日)这轮落版本协商这一半,watch 增量与变更集下一轮
- 要堵的那句话没法判定:DoD「编辑器协议连续两个迭代无破坏性变更(判据:me-studio 调用端不改一行)」——什么算协议、什么算破坏性都没清单,只能靠人回忆,而改的人从不觉得自己改了协议
- 把协议变成可枚举的面,每行取代码真实形状:外壳六键与顺序(从
json::envelope实际输出里读键名)、七档退出码、全部命令名、流式事件。渲染成protocol.v1.txt(27 行)+ FNV 指纹 → 「破坏性变更」有了机械定义:那份文件变了(加命令就重生成,改键序就 bump 版本另存 v2) --protocol <n>是门,在分发之前判、对每条命令生效。放各条命令自己管 = 留一个「忘了协商」的口子,而忘了的症状是安静地放行- 判据:Rust 6 条 + test_cli 第十二节 12 条(含python 现算一遍 FNV 与 me 报的指纹比对,两个语言独立算出同一个值)+ drill-protocol.py 8 条变异逐条证过会红
- 演练逼出一个真问题:第一版用
assert_ne!(newer, older)判「两个方向说的话不一样」,而它恒真——版本号不同就恒不相等,方向写反也照样不相等。第 3 条变异红在下一行才看见。判据自己也要被演练 - 顺带修掉上轮留下的
CONTRACT-STALE:cli.spec.md升 v12、同步 MANIFEST(A1 扇区,已登记代修) - 进度百分比没动:那是 main 的发布基线,A3 这半要等合并后才进分母
- 没做 watch 的理由:它输出是流式的,而 §3 表与
--json扫描都假设「一条命令 = 恰好一份信封」。加一列「输出:信封 / 流」改的是扫描的判据形状,而那个扫描这轮刚建成 S16-4 的证据——同一轮既建又改,两件事都没验干净
S16-4 收口:me --json 第一次真覆盖全部命令(三处「看着对」的坑)
- 飞哥说「S15、S16 可以提前」,先动 S16 里唯一无依赖的一条(S16-4,5 人日)
- 坑①:
me survey --json吐出的是「人读表格 + JSON 外壳」两段拼接,json.loads在第 1 个字节就失败(825 字节全不是 JSON)。全 crate 只有这一处绕过诊断通道的print!。改法不是加if json,而是把数字写进diagnostics(新码 ME-SURVEY-010..040),人读与机器读同一份。代价:那张对齐的表没了 - 坑②:「全部命令」以前没有可枚举的定义——契约表 §3 只有 13 条,代码能解析 15 条(
me sym/me bench一直没登记)。补两行 + 双向判据(name()的穷尽 match ↔ §3 表)。没另抄手写清单:抄的第三份就是会漂的第二真相源,而「两份对得上却同时少一条」正是这次的形态 - 坑③:
new/atlas/survey的外壳cmd是空串(位置参数必填时走的那条路),另 12 条是填对的。拆MissingArg { cmd, usage }修好 - 判据:
test_cli.sh160 → 176 条,按 §3 遍历、在空临时目录里跑(那批命令有会写盘的) - 六组变异逐组单独注入,都红了。最有价值的一条:
survey又自己 print! 这个变异,只有成功路径那条判据抓得到,扫描抓不到——不给参数时走不到report() - 流程教训:还原变异用反向替换,别用
git checkout。这轮它两次把我的改动一起冲掉(main.rs 一处、survey.rs 整块),重做了一遍。拿仓库当前状态当备份不成立 - S15 对 A3 是空转:三条 A3 名下的活全排在 A1 的 S15-4「通用序列化」后面(存档的槽位与迁移链必须建在那个版本头上)。已开 N-356 请 A1 先给最小可用接口
S13 第 8–9 条补齐五件;顺带踩到「变异忘还原会让 git status 撒谎」
- 五件补齐(me-fx2d 判据 39 → 74):序列帧
flipbook.rs(帧号吃 age 不吃 progress,Hold 夹末帧,起始帧默认随机)、屏幕抖动shake.rs(幅度 = trauma²,按绝对时间算,零创伤精确 0)、混合批次blend.rs(给下标数组不重排粒子,稳定排序)、拖尾trail.rs(按 min_dist 过滤不按帧)、后效挂钩点Action::PostFx(只给数据,后处理管线不在 L5) - 演示覆盖 physics-lab 153/153 公开函数,四个 crate 的 FUNCTIONS.html 全部重生成
- 16 组变异逐组跑过,其中两组逼出「恒绿判据」:集成判据里粒子恰好本来就分组(改成交错发才抓得到)、
sort_unstable_by_key对 5 个元素恰好稳定(加到 500 个才打乱) - 最大的坑:这 16 组是手改手还原跑的,漏了两处在
apps/studio-shell/probe/src/(move_to少了self.anchor = None)。而本机.git/config的core.bare = true让需要工作区的命令报错、报错被管道吞掉、输出为空 —— 看起来工作区干净。于是下一轮全量 CI 红在三条「拖动锚没释放」的判据上,查了半轮才发现红是自己留的 - 教训:①
git status空输出不等于干净,先看退出码 ② 变异必须一条一条单独注 —— 两处合起来会互相掩盖(hit()兜底成恒Hit::Input就给「输入框内缩」兜住了,看起来像抓不到)③ 演练脚本化,还原不能靠记性 - 已落地:15 条变异收进
tools/ci/drill-fx.py(7 → 22 条),末尾加git diff --quiet核对(这条核对自己也证过会红) - 收尾:自绘壳八条通道 96 条判据全绿(--edit 31 / --smoke 17 / --hit 9 / --box 11 / --sel 7 / --keys 21)
- 五件补齐(me-fx2d 判据 39 → 74):序列帧
微信式全屏来电:通知层已通,卡在后台通道与 uid 级权限
- 需求:手机锁屏/在桌面时,来电能不能像微信一样整屏弹出来、直接接听?
- 第一层(通知写法)早就有了:
yueju_incoming_call渠道mImportance=4(HIGH),全屏 Intent + 响铃 + 震动 + 接听/拒接两个按钮,写法上和微信没差别。 - 第二层(系统权限)是卡点:Android 14+ 的
USE_FULL_SCREEN_INTENT有 uid 级 / package 级两套,之前只给了 package,uid 级是ignore→ 系统直接把fullScreenIntent摘掉,降级成普通通知。cmd appops set --uid ... allow后变allow。 - 第三层(来电根本到不了)才是真卡点:手机退到桌面后约 12 秒频道断(
信号通道异常 error=117),主叫再呼连INV都收不到。通知写得再对,没有来电事件就不会弹。 - 已验证:通知栏显示「客厅电视 / 邀请你视频通话」+ 两个 action;点「接听」不用先开 App 直接进通话(
通知动作 accept state=2→ 电视signal ACC)。 - 未验证:桌面/锁屏自动全屏弹出(副屏状态下 adb 截图取不到画面)。
- 结论:微信能弹靠的是厂商推送通道 + 悬浮窗白名单 + 通话类应用分类,不是通知 API 写法差异。缺的是 通知到达的通道。
隐私政策写了 5 项没做的功能,属于描述不实
web/privacy.html里写了通知使用权、本地 VPN、悬浮窗、对话记录查看/删除、应用内申诉入口五项。- App 实际一个都没实现(v1 只有应用扫描、链接核验、专家对话、案例库、网页守护)。
- 这是「隐私政策描述不实」,不是文案小毛病——商店审核和备案都可能追问,且用户可据此投诉。
- 处置二选一:①把五项标注为「后续版本提供」(半小时,风险归零)②或真做出来。
- 建议先改文档。隐私政策只能滞后于实现,不能超前。
证照时间表:9 周关键路径,软著反而不占路
- 软著:普通 6-8 周(受理后 30 工作日发证);加急 3-5 天
- ICP 备案:3-4 周(管局 20 工作日)
- App 备案:4-5 周(须先有 ICP 号 + 签名公钥)
- 商店注册:1-3 天/家;上架审核 1-3 天/家
- 关键路径:keystore → 域名+ICP → App 备案 → 上架,合计约 9 周
- 软著不占关键路径,可全程并行,选普通件即可,加急费能省
- 商店注册现在就能办,但注册完上不了架,建议先把 5 家账号认证排上队
- 开头先做:正式 keystore + 域名解析。这两件不定,第 4 周交备案会原地停住
三家主体与证照一致性结论:软著可分散,备案被域名锁死
- 域名注册人 = App 备案主体:强制,无解。ICP 备案要求域名实名信息与主体完全一致,备案主体必须是所用域名的注册人。
- 备案主体 ≠ 商店账号主体:可以。华为勾选「与开发者账号主体不一致」并录入对方名称+证件号;小米需填备案主体名称、统一社会信用代码、营业执照附件及备案说明。
- 软著著作权人 ≠ 商店账号主体:可以。交《应用版权授权书》,需含授权人、被授权人、软著登记号、软件名称、生效日期、双方盖章。
- 软著名称必须 = App 名称:华为明确「不可以」不一致;小米要求应用名与软著全称或简称之一一致。
- 一个软著只能对应一个 App:小米/抖音均明确,一软著多应用会被判马甲包。
结论:软著最灵活,可分散到三家公司;但备案被域名锁死,商店账号也宜与备案主体统一。不一致的每一处都要靠纸质授权书兜底,而授权书会过期、章难盖、人易换——本质是可维护性问题,不是合规问题。
2026-11-03
设计对齐基线 + docs 文档集:tokens.json 数值基准、21 项漂移闸门、五份产品/开发文档
- 背景:mac 与 Windows 版本不一致,先对齐设计再出文档。旧手绘稿(archive/)与实现早已分叉,照它写 Windows 端会错上加错。
- 设计对齐做成可执行的:
design/tokens.jsonv3.0.0 —— 唯一数值基准,从 SwiftUI 源码逐条量出(卡片 18/14、环 172/16、行 7/12、字号 17/13/10、阈值 0.80/0.92),含明暗两套色值与 pt→DIP 换算后的 Windows 建议值(mac 13pt 行标题 ≠ Win 13 DIP,直接抄会小一圈)。tools/design-build/check-tokens.py—— 21 项漂移闸门,令牌 vs 源码字面量逐条比,对不上非零退出。开发中逮到自己 6 处正则锚点写错(lineWidth 抓到卡片描边、胶囊内边距抢了行内边距、阈值抓错分支),说明这闸门有真用。- docs/ 新增五份(531 行):README(阅读顺序 + 与 spec/ 分工)、product.md(四屏规格、判定体系、AI 边界、必须一致/允许不同)、architecture.md(模块接口照源码签名、M0-M6)、design-system.md(Avalonia 明暗主题资源字典可直接粘)、parity-checklist.md(发版前逐条勾)。
- 纠偏一处:mac 实现的 AI 判定是 AIDecision 三值(可以删/可以迁/必须留)+ 待复核徽标(confidence<0.6),规范层六 verdict 是映射关系而非 UI 六标签。
- 提交
8caa272已推 Gitee。Windows 端第一动作仍是StorageMate.Bench复现 PoC 四数字。
设计稿换代:design/index.html 改为 mac 真机稿,手绘旧稿归档
design/index.html换成以真机实拍为准的 mac 稿(原design/mac-v1.html),八张截图暗/亮可切,374 KB 单文件离线可看。- 旧手绘稿移入
design/archive/:v2-handdrawn.html+tokens-v2-handdrawn.json,更早的 v1 备份一并收进去;design 顶层不再有会误导的旧文件。 - 稿内「上一版设计稿」那段原本写着
design/index.html,替换后会指向自己,已改成归档路径。 tools/design-build/build.py输出改为design/index.html;重跑一遍 md5 与替换前一致(365673ef58119a61e232ec7c78a032ee),说明产物可复现,不是手工拼的。- 提交
2709d5c已推 Gitee。
2026-11-02
mac 界面设计稿 v1:以真实实现为准重出,八张真机实拍
- 为什么要重做:
design/index.html+tokens.jsonv2 是按设想手绘的,跟真机已经分叉 —— 颜色写死(纸面 #3B82F6 / #070A0F)而实现全用系统语义色;行高写 48 而实现约 58;窗口写 1216×768 而实现最小 1000×680。而真实版本反而更好用。改为以实现为准重出。 - 怎么做:不给应用截图加任何后门,只加两个自检开关 ——
SnapshotProbe把 windowNumber / 尺寸 / 强制外观写到文件,再用screencapture -l <id>直取窗口图层(比 -R 算坐标稳,窗口被遮挡也截得到)。八张图(4 屏 × 暗/亮)全部无手绘、无补画。 - 踩到的坑:
open -n --args在 macOS 26 只把 argv[0] 传进去,后面全丢(实测 argv 只有一个元素)⇒ 参数改走defaults write;windowResizability默认的 automatic 把窗口上限压到内容理想尺寸(恒 1082×692、拖不动)⇒ 改.contentMinSize;只设window.appearance时标题栏仍是系统色(深色机上截浅色得到一条黑标题栏)⇒NSApp.appearance也得设。 - 产出:
design/mac-v1.html,374 KB 单文件,8 张 webp 内嵌(共 256 KB),离线可看。含四屏实拍(可切暗/亮)、设计令牌(从 SwiftUI 源码量出来的)、六大组件规格、设计→代码对照、Avalonia 移植六处差异、五条已知不足。 - 可复现:
tools/design-build/shot.sh(截图)+build.py(压 webp 内嵌)+mac-v1.template.html(模板)已入库,下一次改稿重跑两条命令就行。 - 顺带两处实现改进:窗口现在可以拉大(原本拖不动);非概览页首次进入会自己扫一次(原本直接进清理页是空列表)。这两条对用户可见,下一个版本(0.2.3)需要带上。
- 为什么要重做:
Windows 端立项依据入库:不用等 MFT,并行 NtQueryDirectoryFile 首扫已达标
- 验证目标:Windows 上能不能不用 MFT,只靠
NtQueryDirectoryFile就把 50 万文件枚举压到 10 秒内。 - 实测
(本机路径)全盘(148~158 万文件,两轮):baseline51.6s(外推 50 万 16.3s,不达标);ntquery单线程 12.1s(4.0s);ntquery-par同层并行 16 线程 5.7s(1.9s);mft顺序扫 2.1s(0.7s)。 - 结论:不用等 MFT。瓶颈是 syscall 数量而非磁盘 I/O ——
FILE_ID_BOTH_DIR_INFORMATION内联 size,省掉 158 万次 per-file stat。首扫走并行NtQueryDirectoryFile,MFT 留给后续增量。 - 踩掉三个坑:① 只有
STATUS_NO_MORE_FILES才算读完,在STATUS_SUCCESS就 break 会让大目录静默漏计数(少 13,624 个文件,零报错);②winioctl.h与 MS-FSCC 对USN_RECORD_V2的定义差 8 字节(少了TimeStamp),照头文件写就整体错位、并报错;③ 三种策略文件数天然不同,junction 重复统计与 WinSxS 硬链接让基线与 MFT 各偏 2~6 万,产品上必须先定义「按目录项还是按 inode」。 - 文档已入库:
spec/windows.md(.NET 8 + Avalonia 11,四层 sln,枚举契约用同步批量回调而非IAsyncEnumerable);spec/decisions/0001-windows-enumerator.md(ADR,含对 PoC 的三处修正 —— 外推偏乐观、增量必须缓存直接子项聚合、USN 不带 size)。ADR 里那句错解释(把TimeStamp说成SecurityId)已在源头改掉,避免后来者照错。 - PoC 代码在
poc/FileScanBench/,后续 Windows 端第一动作是把四个数字在StorageMate.Bench里复现。
- 验证目标:Windows 上能不能不用 MFT,只靠
mac 0.2.2 发版:归档假卡住、清理被拒、聚合项误删整目录三个问题一起修
- 归档假卡住:
Process.standardOutput = Pipe()挂上却没人读,rsync--progress写满 64KB 管道后阻塞在write(),界面永远停在「传输中」。lsof证据:1 PIPE ... 65536。改成统一runRsync,stdout / stderr 两条管道同时读,stderr 只收错误。 - 进度回跳:openrsync 是逐文件报百分比(每传完一个小文件回 100%),改成按
to-chk=剩余/总数与已传字节/总字节算,并强制单调递增;归档中按钮变「停止」,可中途取消。 - 清理失败:
(本机路径)这类目录带 ACLgroup:everyone deny delete,trashItem必报 513 / -5000。改为整体移废纸篓失败就清空内容、保留目录;部分成功不再整体判失败,失败原因逐条写进日志。 - 误删整目录:下载目录的「安装包」聚合项之前拿
(本机路径)本身当路径,trashItem会把整个下载目录送进废纸篓。ScanItem加payload,聚合项只删真实安装包。 - 口径不一致:首屏「可清理」按已勾选统计,跟卡片对不上,改
cleanableSizeText。 - 发版:DMG 1.9 MB,通用二进制(
x86_64 arm64挂载复核过),MD5378603adbb5aa67b613f21463c4ddda1;latest-mac.json与官网下载入口同步 0.2.2,线上回下校验一致。
- 归档假卡住:
2026-11-01
动画系统:路径四格演示落地 + chainScale 补完
path_lab四格演示页落地(等间距 / 链式 / 按骨长 / 位置是状态),自检PATH LAB OK 16/16,两张证据图入库- 页面读 Rust 算的两个误差(间距 px / 朝向 rad)—— 这一页的观察点在顶点数组里看不出来
RotateMode::ChainScale补完:Bone一直有scale_x,当初"骨长刚性"的跳过理由是错的- 判据四条(含一条跨模式比对:位置与朝向与
chain逐位相同) - 全量 CI 绿(271s / 4 项既有降级),两批都已合入 main
2026-10-31
官网 5 处事实错误:全部「看起来正常」,没有一处会报错
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
Last-Modified停在 10-10,下载页 10-13,这 21 天恰好是功能最密集的一段。 - 错处一(硬伤):4 个页面顶栏「Web 版」都链到
(内网地址):3000,而本机已在(内网地址)网段。对外站放局域网 IP 本身就是错的设计 —— 任何公网访客点了必然失败。已直接去掉该入口,下载页留「访问同一网络下的系统地址」说明。 - 错处二(数字):原写「¥0.003/次、日均 50 次、¥4.7/月」。10 月账本实测 3311 次 / ¥17.52,其中低谷 75%、高峰 25%:低谷中位 ¥0.0037、高峰 ¥0.0075、综合 ≈¥0.005;有活动的 10 天日均 326 次 ⇒ 月约 ¥50。把 ¥4.7 改成 ¥50 看起来是「把自己写贵了 10 倍」,但那是真实账单。
- 错处三:「4 品牌 5 设备」→ 实际 6 台(新增地下室 .20,车库换 .76)。错处四:下载页版本号与 SHA。错处五:about.html 正文有 Markdown 星号泄漏(
带价值判据的事件管道),页面会真显示**。 - 为什么这些能活 21 天:它们都是「看起来正常」的东西 —— 链接是蓝色的、数字是像模像样的、版本号也有。没有一处会报错,只会默默指向错的地方。
- 验收:4 页本地与线上字节逐一相等;从线上拉回 dmg 算 SHA-256 与页面标注一致;并给下载页做了强制显示副本截图,实测四张卡片底边与按钮对齐(macOS 描述原来多一行把按钮顶高 5px,已缩到同宽)。
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
macOS 客户端 0.2.0 发版:打包脚本补上 .dmg 产出
- 为什么发:官网下载的 dmg 是 9-27 的 0.1.0,而源码已到 10-16。下载版缺:帧看门狗、AI 事件分析页、事件详情对话框、回放页、语音唤醒。用户下到的是个残缺品,页面却写着「最新版本」。
- 根因不是忘了发版,是打包脚本从来就不产 dmg:9-27 那个是手工
hdiutil做的,于是「源码天天改、下载包一动不动」。 - 修正:
build-app.sh补 release 模式自动hdiutil出 dmg 并打印 SHA-256;版本号从写死的0.1.0改为NVR_VERSION可覆盖(默认 0.2.0)—— 同上一个「部署脚本硬编码 apk 版本号」的坑是同一类。 - 产物:
NVRStation-0.2.0.dmg2.0M,SHAcd937893…c448。挂载校验:CFBundleShortVersionString=0.2.0、CFBundleName=悦居智能NVR、codesign --verifyvalid on disk + satisfies its Designated Requirement。 - 签名不是 ad-hoc:钥匙串里有「NVRStation Local Signing」(
security find-identity -v会过滤掉它,因为不被系统信任;不带-v才能看到)。用固定证书才能让 macOS 记住「本地网络」授权,否则每次重编译都重弹窗。 - 官网同步:v0.2.0 + 新 SHA + 描述补上 AI 事件分析页;并如实写明「本地签名、未走 Apple 公证,首次需右键打开」—— 不写这一句,用户会以为装坏了。
- 上线验收:从线上拉回 dmg 算 SHA-256,与页面标注逐字符一致(不是只看 HTTP 200)。
AI 事件落库断了 5 天:真因是登录 401,却被记成「网关 503」
- 现象:
events最后一条停在 10-30 22:36,spool/dead/积了 542 个事件(书房 227 / 客厅 219 / 玄关 96),而成本账本 10-31 19:55 还在正常扣费 —— 理解在跑、钱在花、结果被丢掉。 - 真因:
ai_understand用默认密码admin123登录,而 10-30 安全加固已把密码改掉 ⇒ 每轮 401。日志里全历史 1635 次「登录网关失败 HTTP 401」,零次 503。 - 为什么排查会被带偏:
_save_to_db只返回 True/False,上层把一切失败写成「落库未确认(网关 503/降级或返回 id=0)」。错误归因比没有归因更贵,它会让人去网关里查一天。 - 三处修正:①凭据改读
(本机路径)(600),改密码不用重装 launchd 服务(改 plist 后bootstrap在受限终端恒 EIO);②新增_LAST_DB_ERROR/last_db_error(),dead 备注写真实原因;③补 flock 单实例锁。 - 为什么必须加锁:launchd 每 120s 起一轮
--once,积压大时一轮跑不完 ⇒ 两个消费者同时读写同一 spool,互相os.remove、同一条事件重复理解重复扣费、run_once抛 FileNotFoundError 整轮中断。重放 500 条时第一次必然撞车,平时事件量小看不出来。 - 重放:新增
scripts/replay_dead_events.py,必须清掉_consume.attempts否则移回 spool 会被立刻再判死。514 条重放,按 ¥0.0043/次约 ¥2.2。 - 验收:小批 3 条全部落库(id 1702~1704)、死信 0、超 300s 的旧事件只落库不播报;并发第二个进程干净退出(退出码 0,不是失败)。
- 现象:
官网重新部署:修掉部署脚本两个失效点
官网 nvr.filebreeze.cn 重新部署(远端停在 9 月 27 日版,落后半个月)。
部署脚本两个真失效点(直接跑会挂或漏更)
- 硬编码
nvr-tv-0.1.0.apk,而磁盘已是 0.2.0 ⇒ scp 阶段失败。改为按后缀取最新(版本升级不用改脚本) - 只上传
index.html⇒ download / product / about 永远停在旧版。改为整站打包上传,解包后 chown 回 ubuntu - 又踩一次「全角括号紧跟变量」:
$REMOTE_NGINX(报 unbound variable,必须${VAR}
验收(不只 curl 200,要比字节数)
- 首页 200 / 12389B,与本地 index.html 字节数完全一致(旧版只有 9.6K)
- 下载页 7271B,引用
NVRStation-0.1.0.dmg与nvr-tv-0.2.0.apk - 两个安装包 Range 请求均 206(支持断点续传)
- product / about 均 200;nginx -t 通过后 reload
- 硬编码
车库子码流 H.265→H.264:406 拒绝才是重启的真凶
背景:6 台主码流全 H.265,子码流里只有车库(id=11,海康白牌 800x448)也是 H.265。flv.js 只认 codecId=7、ExoPlayer FlvExtractor 只认 AVC ⇒ 仅这一路在 Web/TV 黑屏。设备无配置入口,只能转码。
链路:cam_11_sub → h264_videotoolbox → cam_11_sub_h264;网关自动发现
_h264变体,三端零改动。实测 5.5% 单核(libx264 speed 0.855x 跟不上)、拉 10 秒得 151 帧且 time=10.11s。四个坑
- ffmpeg 8.1.1 没有
-rw_timeout(rc=8 秒退)⇒ rtsp demuxer 用-timeout(微秒) - 不加
-fps_mode passthrough⇒ ZLM 声明 fps=22(源 15)快放 1.47× stderr=PIPE只在退出时读 ⇒ 警告写满 64KB 阻塞转码(进程活、画面不动)- ffmpeg 被 kill 后 ZLM 不立刻释放发布者 ⇒ 重推同名流必吃
ANNOUNCE 406(rc=8)。正常退出不触发、像「随机偶发」。推流前close_streams force=1,黑屏 10~20s → 3s
两个假阴性:
launchctl list恒空 ≠ 未注册;grep -E "^\s+(state|pid) ="在 BSD grep 下\s不匹配,会误报「未注册」。自省:曾把 aliveSecond 很大当成僵尸源,踢了一个正出数据的流(speed 34KB/s)。判据应是
bytesSpeed>0。- ffmpeg 8.1.1 没有
暴露面收敛:7 个端口收回本机 + JWT_SECRET 改必填
接上网线后发现局域网内任一设备可直接连数据库与 Redis(实测 Redis 无密码直接回 +PONG),遂做收敛。
做了什么
- 5432 / 6379 / 1883 / 9091 / 8082 / 80 从 0.0.0.0 收窄到 127.0.0.1(网关用容器名访问 redis、mosquitto,本来就不需要宿主端口)
- Redis 加 requirepass;admin 密码重置为 18 位强口令(旧 admin123 实测返 401)
比弱口令严重得多的一条
docker-compose.yml写着JWT_SECRET: change-me-in-production,Go 代码读不到环变量时的默认值也是同一个串。知道这串就能自己签发任意用户令牌,跳过密码调用所有 API,admin 密码多强都没用。已改为
${JWT_SECRET:?...}必填、值放deploy/.env(600);缺变量则网关拒绝启动,宁可不起也不静默回落。代价:三端已登录 token 全部失效,mac / 手机 / TV 需重新登录。
遗留:ZLM secret 仍为可猜字符串且在 git 历史里(与 PG 密码同),真正解药是轮换而非改文本;554 端口因 Lima 残留监听未能关闭(实测不响应 RTSP、拉不到流,重启即消失)。
App 端媒体接口上线 + 对外集成 API 落地
- 新增
/api/client三接口(JWT 保护,DTO 不含任何凭据字段):逐个:清单 / 起流并返回四协议地址 / JPEG 截图 - 失败码语义分开:502 起流失败、504 流建好但 N 秒无数据(仍给地址)、503 截图取不到真实帧
mediaBase由请求 Host 推导 ⇒ 同一份代码在 127.0.0.1 与 (内网地址) 下各自返回可用地址- 对外集成(ADR-013/014):服务令牌 + 中间件、Webhook+HMAC、订阅调度、migration-013
- 双向令牌隔离:用户 JWT 打 /api/v1 返 401、服务令牌打 /api/* 返 401
- 修
zlm.Stream缺Schema字段:同一路流按 rtsp/rtmp/hls/ts/fmp4 各一条,原遍历会算成 5 路 - 实测:清单 6 台全在线、play readyMs=12、FLV 与 HLS 均 200
- 新增
第三条腿飘过一次 —— 抓不到结论就重抓,别指望「预算给足」
git push卡在「WebGL2 对账第三条腿」:```
✗ WebGL2 对账未通过(第三条腿)
✗ 标题里读不出 n/m(实际:GL COMPARE 运行中)
```
同一台机器、同一份代码,紧接着跑的 ANGLE 那一路 21/21 全过 —— 所以那不是判据红,是这一条判据当时飘了。根因在
apps/gpu-gl/run.sh:--dump-dom在页面加载完成时就把 DOM 抓走,而判据是 wasm 里算完才写进<title>的;--virtual-time-budget=120000是预算,不是「等到做完」——页面在 wasm 里做长段同步计算时预算可能已经走完,DOM 里还停在静态 HTML 的初始标题上。改成看着结果决定要不要再抓:标题仍是「运行中」/ 读不到就重抓,上限
GL_WAIT_SECS(默认 180s);热路径上永远第一次就出结论、一次都不多花。超时与判据红的分开写——「抓了 N 次、等了 Ns 仍是运行中 —— 这是没跑完,不是判据红」,退出码 1(跑不完不能算通过)。CI 层另加一个run_page_script兜底:只认日志里「没跑完」这一句才重跑,判据红一律立刻回去报红 —— 「失败就重试」是把红变成「有时红」的另一种写法。演练过(把
caps.html那行document.title用if (0)短路、GL_WAIT_SECS=3):重抓 1 次后打出上面那句、退出码 1;还原后三页全绿,attempt全是 1。一句话:飘的 CI 比红的 CI 贵 —— 红只让你多看一眼,而「有时红」会训练人重跑一次了事,从那一刻起这个门口就没人看结论了。
`same` 那句是假话;深度第三次演练,红在了第 ① 条而不是第 ⑥ 条
- 一句写错的表头能存活很久:
compare.rs的表头原写「same只有几何/光栅规则不同时才会小于总数」。实测反例干净得刺眼——整块 R/B 互换(max_delta140、gross10000)与整块 alpha 差 1(max_delta1、gross0)给出分毫不差的same,覆盖与质心两条都是 0 差。same只说「全等/不全等」,它说不出差在哪。 - 同一张表里还有个不存在的名字:
off_by_more_than_8,真名叫gross。它在反引号里、不是 intra-doc 链接,rustdoc 一声不响——名字错从不报红,只会让读表的人去找一个不存在的字段。 compare一直是「间接使用」:被scenes/rules/mutations隔着「先画再判」用到,所以「这张表里写错一句,没有任何东西会红」。这一轮才给它补上它自己的第一批判据(tests/compare.rs)。- 第三次真机演练,期望与结果错位:把
clear_depth: Some(1.0)改成None(不清深度),指望第 ⑥ 条的四把尺子发声,红的是第 ① 条——预热的z=0.05把后面四遍全拒了,四张对照图「深度开」的两张变整屏清屏色,尺子那四列也一律是清屏色(它们量的是同一个已经被拒的缓冲)。所以写进文档的是分工而不是新判据:尺子管「z 落在哪儿」,清屏本身失效归预热管。「四把尺子全绿」不该被读成「深度这一整套没问题」。 - 另一条演练是对的方向:HLSL 的
z改成0.5*z+0.25→ 前四列一个字节没变、尺子列[清屏色][清屏色][红][红],红在「第 ⑥ 条·尺子 2(清屏深度 0.25):近的独占区 280,300 应当是 [220,40,40,255],实际 [16,18,22,255]」。 - 「抓不到」这句话必须配一个真能跑的反例。模块头从上一轮起就写着「两点之间的曲线形状抓不到」,但没有可执行的映射。这一轮补上
t²幂次重映射(端点不动 ⇒ 四张图与四把尺子逐字节相同 ⇒ 判据全绿)——证明的是信息量不够,不是判据写得不好;同时钉住补法(多一块z=0.5的矩形 + 一把清屏0.5−ε,两支当场分开)。
- 一句写错的表头能存活很久:
30 条变异扫描:6 条改错没人响,全是同一类 —— 判据被调钝或干脆被蕴含
把问法从「判据绿不绿」换成「这一行改错了,有没有东西会响」,对
me-compare做了 30 条手工变异(每条改一处、跑全组测试):深度 16 条、compare8 条、judge6 条。24 条当场被抓住,6 条存活——而存活的 6 条是同一类。- 被完全蕴含的判据是死门。深度第 ⑥ 条原来只有一把清屏 0.5 的尺子,而它被「清屏 0.75−ε」那把完全蕴含(凡过后者必过前者)——它永远不会是红的那一条,却让读报文的人以为「这一档通过了」是额外信息。换成四把(
f(0.25)与f(0.75)的上下界)之后,上一轮写进「抓不到」的窄带重映射f(z)=0.5z+0.25当场被抓出来。ε 是两头夹出来的:1e-4 × 2^24 ≈ 1677档,量化翻不了「低于」。 - 容差本身就是判据。
half.max_cover_dev0.0→0.01、half.max_centroid1.5→15、srgb.max_deltaSome(1)→Some(3)三条全部存活:报文照旧绿、结论照旧「通过」,只是能抓的错少一档。其中 0.0 那条是「整行漂移」的唯一探针(一行几百像素,比例远在 4% 以内、质心只偏 1px,另两条容差都放过它)。 - 只在真机腿被验的那一行,等于没被
cargo test验。GLSL 里a_pos.z * 2.0 - 1.0(窗口深度 ↔ NDC)被删掉,30 条里没人响——因为这一行只在浏览器里跑得到,而真机腿在没装 Chrome 的机器上会降级成「本轮没跑」。补了一条文本代理测试,注释里写清它挡不住什么(写成2.0*(z-0.5)就抓不到)。 - 还有两条更朴素的:
is_bg只比 RGB(alpha 不参与背景判定)、差异图把差异处标成黑而不是纯红——前者让覆盖数与质心的语义悄悄变味,后者让一张全黑的差异图被读成「没有差异」,而报文里明明写着「差 57600 个像素」。
共补 6 条判据,每条都把对应的错真做出来看它红,再还原。工具在
tools/ci/sweep_mutants.py(手动、不进 CI:一轮八到十分钟,push 每次多等八分钟的结果一定是有人开始绕过钩子)。教训一句话:「绿着」只说明当前代码没有这些缺陷,不说明判据挡得住下一版。
- 被完全蕴含的判据是死门。深度第 ⑥ 条原来只有一把清屏 0.5 的尺子,而它被「清屏 0.75−ε」那把完全蕴含(凡过后者必过前者)——它永远不会是红的那一条,却让读报文的人以为「这一档通过了」是额外信息。换成四把(
一句没核实过的理由挡住了正确改动整整五版;一条从 v21 起就走不到的分支没人验过
- v21 拒绝换掉
format里0的含义,理由写得像回事:「RGBA8 layer 不被支持,所以把 0 读成 RGBA8 在 Metal 上就是静默降级」。后半句没人量过。 v26 拿同一个CAMetalLayer、只换pixelFormat跑了三次:80 / 70 / 115 都能拿到 drawable 且texture.pixelFormat回读一致 ⇒ 那个理由不成立,而它挡住了一个正确的改动五版。 - 反向对照(
R8Unorm/B5G6R5/Depth32Float)不是「返回错误」,而是
*** Terminating app due to uncaught exception 'CAMetalLayerInvalid', reason: 'invalid pixel format 40'setPixelFormat:抛 ObjC 异常,跨 FFI 进 Rust 是 UB,表现是进程直接终止(整个测试二进制没了)。所以surface_format()那个穷举白名单不是「顺手校验一下」,它是防止进程被杀的那道墙:加格式值必须有实测记录,不许看文档像支持就加。- 另一条同族的:
acquire_frame里「读到pixelFormat == 70就报TEX_RGBA8且把me_frame.flags位 0 归零」从 v21 到 v25 永远走不到(没有任何输入能把图层设成 80 以外),而同期所有测试都是绿的。v26 换掉0的含义之后它第一次可达,判据当场能分辨真假。 - 读数法:见到
if x == 某个常量的分支,先问「什么路径能把x变成那个值」;答不出来就该怀疑它是装饰,而不是去给它写注释。
- v21 拒绝换掉
改一个字的含义必须 bump ABI,加一个函数不必 —— 判据是「失败响不响亮」
rhi.ffi.h的版本表上这句话现在有了正反两面的例子:- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
INVALID_ARG/ 格式值不存在)。 - 改已有值的含义必须 bump(v26 是 v9 之后第一次):旧宿主传
format = 0想说的是「你挑」,新库读成「要 RGBA8」——两边都不报错,画面还在出,只是换了个通道序。这正是握手该拦的那一类,而拦得住的前提是两个数不相等。
哨兵取
0xFFFF_FFFF的第二个理由:格式值今天最大 22,它离得无限远,而且零初始化的结构体不会撞上它 ⇒ 零初始化 = 要 RGBA8(两条后端都真收),比「零初始化 = 你挑」安全(「你挑」在换后端时换答案)。配套给调用方加了一条义务(规则 30):
formats[]里现在真的有 0,只能按format_count读;按「遇到 0 结束」读的症状是「这台机器一个格式都不支持」而format_count说是 2。- 加格式值 / 加函数不 bump(v14–v25 一路没涨 ABI):旧宿主不碰它,二进制接口一个字节没变,失败是响亮的(
RHI 契约 v24–v26:一位没有宾语的能力、另一半在胶水里、第一次 bump ABI
- v24
RGBA16_FLOAT:FLOAT_RENDER_TARGET这一位从 v1 就在、档位模板里有、satisfies拿它判定,而契约里一个浮点格式值都没有——这是 §D6 规则 1「报了的必须能用」的反面:报了一件没有宾语的事。选 16F 不选 32F(GLES3.0 core-filterable;MetalRGBA16Float=115 从 A11 起可渲染可混合),顺手补上 v21 漏置的CAP_SURFACE_BGRA8(同一次回答里两个答案)。 - v25 上下文丢失那一半:契约说「丢失后
capabilities只清CONTEXT_READY一位、其余原样」,Metal 侧照做了、判据也有,而胶水me_gl.js返回 0(整片清零)——两条实现说同一件事、一条对一条错,而错的那条才是线上的那条(wasm 分支才是宿主跑的),且它在 Rust 测试里跑不到。补webglcontextlost监听 +onContextLost钩子(轮询能回答但不通知,症状是「帧还在跑、画面不动」);胶水刻意不调preventDefault——那是在说「我要恢复」,而恢复要重建整份实例,那是宿主的策略。 - v26 表面格式的哨兵:
surface_desc.format的0从「让后端挑」改成「明确要 RGBA8」,哨兵挪到SURFACE_FORMAT_AUTO = 0xFFFF_FFFF,第一次 bump ABI(7→8)。起因是 v21 记的那笔债:0同时是TEX_RGBA8的编号 ⇒「我要 RGBA8」在表面上无法表达,而 v21 的对策是让surface_caps.formats[]只报一款——那不是后端的事实,是我们自己的编号问题。 - 判据:三条新判据 + 各自反向实验(把 0 读回「你挑」/ caps 少报一款 /
flags位 0 写成常量,三次都红在对的断言上);胶水 52 条 / boot 19 条全绿;全量 CI 278s / 290s / 293s(8 项环境降级,无真红)。
- v24
2026-10-30
「AppID 无效」是假象:109 其实是 token 过期,且有过 24 小时首次使用窗口
- 现象:语音可以跳转,但入会失败,界面上写「AppID 无效」。参数一字未改,两端同时挂。
- 真因:声网返回的是
109,含义是 Token 已过期;我们自己的errHint()把 109 写成了「AppID 无效」,把排查带偏了。官方对照:101 = AppID 无效,109 = Token 过期,110 = Token 无效(与频道 / uid 不匹配)。 - 更关键的冷知识:烤进 APK 的 token 有 24 小时首次使用窗口——生成后 24 小时内没被任何设备用过就作废,与
gen_token.sh里设的 7 天expire是两件事。所以「装完放两天的设备一开就挂」是必然。 - 修:错误文案按官方重写;token 改服务端现签。
- 同时发现
channel字段不复位:传过一次 channel 后不传仍沿用旧频道,INV发出去rc=-2,对端永远收不到 → 改成没带 channel 就回默认频道,实测错频道失败后紧接着调起能 381ms 入会。
语音技能「给飞哥打个电话」接通,token 改为服务端现签
- 语音技能:在
YuejuCallLauncher加aliases(飞哥 / 韩飞 / 老韩 / 飞)+ 倒装 / 「拨个电话」/ 尾部语气词剥离,JVM 跑 14 句回归:11 命中、3 句按预期落空走 TTS 兜底。 - 实测:
dialMs=3000→ 3002ms 接通,2500→ 2511ms;手机标题「客厅电视」;挂断后jumpBack ok回悦居智能首页。 - Deep link:
yuejucall://call?peer=1002&name=韩飞&ms=3000中文与毫秒均正确解码。 - token 服务:
outputs/token-server(Node + agora-token,:8788,POST /rtc/token,X-Api-Key 鉴权)。客户端入会前现取,超时 1800ms 自动回退内置 token,服务挂掉入会仍成功(557ms)。
- 语音技能:在
GPU 对账第十组 alphaacc:清屏 alpha 设成 0,顺手查出「量化规则是路径相关的」
- 为什么动清屏色:前九组期望里 alpha 全是 255,而那是恒等式
出a = a + 255×(1-a/255) = a + (255-a) = 255——背景不透明时 alpha 怎么画都等于 255。所以「两层半透明叠起来 alpha 该多少」九组一次都没验过(blend_ladder与stack_ramp两处注释都写着「这一格我只能承认它测不到东西」)。要让 alpha 离开这个不动点,只能让 dst alpha 从 0 起步。 - 结构改动:
Scene多clear: [u8;4],cpu::render/gpu::draw/compare::compare各多一个清屏参数。九个既有场景全填BG,实测前九组的差异像素数与上一轮逐个相同(这比「我觉得没影响」值钱)。新组用[26,28,32,0]:RGB 与 BG 相同,画面看起来一模一样。 - 数字:源色 (76,53,57)、a=51 → 一层 (36,33,37) a=51;两层 (44,37,41) a=91.8→92。源因子若写成
SRC_ALPHA,两层是 18(51×.2 + 51×.8)——差 74 位。演练(改me-swrast的blend()):alphaacc 差 80000 像素、最大差 74;blend也红(差 64);order差 41;additive/stack一个像素没动(alpha 恒饱和,与 README 早写的一致)。 - 它没红,而这件事本身是最大的产出:91.8 在两边都是 92,一个像素都没差;而第八组
tex同样是.x却全部差 1 位。两件事放一起才说得清:混合之后的量化两边都四舍五入,而「着色器直接把颜色写到渲染目标」那一步(Blend::Off)是截断的。 那条 1 位差不是「这台 GPU 的量化规则不同」,而是「不同路径的量化规则不同」——第八组那个「契约没写」的缺口被缩到了具体一步上。 - 静默的账:动机是「alpha 一次都没被测过」,演练完发现说过头了——
blend组靠「五档期望值全是 255」这条恒等式本来就能分辨源因子(写成SRC_ALPHA时 a=128 那档给 191,差 64)。准确说法是「它只在饱和那个不动点上被测过」;这一组真正多测的是非饱和区间的累积。已写进 README,免得后来人把「alphaacc 也绿」读成「alpha 全都验过了」。 - 还差:三层以上(第三层 RGB 就不再是整数,会把「量化差 1」与「算错了」混在一起,要另挑一组颜色);「混合 + 纹理」(
texture × 顶点色的 alpha 怎么参与混合);mip / sRGB / 各向异性;sort_y/layer/z的排序语义(三字段全填 0,排序没实现)。
- 为什么动清屏色:前九组期望里 alpha 全是 255,而那是恒等式
GPU 对账第九组 order:契约只写了「调用之间」的顺序,没写同一批里图元的先后
- 补的是上一轮列的空白 #2:前八组对「谁先谁后」一个字都没说过——
stack摎内坐标完全相同(正着倒着一样),其余七组连重叠都没有。查契约才发现答案半个在半个不在:rhi.ffi.h那句「后端必须按调用顺序生效」说的是 set → draw_bound 之间;同一批里图元的先后一个字没提。而真实管线会把半透明攒批最后合成(SpriteInstance带layer/z/sort_y,本工程全填 0),一旦攒了中间夹不透明的必须先切断——顺序与「必须切断」是同一件事。 - 道具:两块逐字段相同的几何按相反顺序提交(红 a=51 → 黄 a=255 → 蓝 a=51 得
(206,208,76);倒过来得(251,208,32),差 45)。场景自带差分:顺序被忽略时两簇同色,抽查点必红一个,不必另写自检。 - 能要求逐像素全等,因为中间那层
a=255把 dst 抹成纯色 → 两侧各只剩一次混合、每步都是整数(26×0.2+251×0.8 = 206.000003,浮点噪声在整数上方,round 与硬件截断同答)。代价:中间那层不能改半透明,改了就得放宽到「最大差 ≤ 1 位」。 - 两次演练红的形状不一样:① CPU 那半倒序提交 → 前八组一个像素都没动,order 差 259200、最大差 45,抽查仍 5/5(比的是 GPU)——这是「前八组对顺序无感」的实测证据;② 右簇改成和左簇同序 → 逐像素差 0、覆盖全对,只有两个抽查点红——顺序被无视时,逐像素那条判据是瞎的。
- 抓不到的四条:alpha 累积(
a + 255(1-a/255)恒等 255,九组帧缓冲都从 alpha 255 起步)、每层舍入(全整数)、真正的排序键(三字段全填 0,排序没实现)、「多算一遍但算对了」(a=255 时与直接覆盖同字节)。 - 顺手补的账:上一轮只重生成了
me-soft2d的 FUNCTIONS.html,而「apps/physics-lab 的 N 个场景」印在四份清单页首,场景数一变四份一起过期(CI 只红三份,第四份恰好是我改的那份)。教训:生成物挂在「别的东西的计数」上时,那份计数有几个落点就得重生成几处。 - 操作纪律一笔:
git push的 pre-push 钩子会整跑 ci.sh(7 分钟),我在它跑的同时又起了一份自己的——两份 CI 在同一工作树里并行,都写dist//host-wx//site/,第一次 push 就是这么红的。一个工作树同一时间只跑一份 CI。
- 补的是上一轮列的空白 #2:前八组对「谁先谁后」一个字都没说过——
physics-lab 第 20 格:布落在球上——一次位置推离,逼出两条被实测否掉的判据
- 补的是
push_out_of_circle从没进过演示的空白。做法只有一句:Verlet 里速度是pos − prev的差,所以每帧把跑到球内的点推回球面、不动prev,就等于给点一个朝外的速度突变——布自然滑下来,不需要摩擦、不需要冲量、不需要接触流形。整个实现是一行调用加一个spheres: Vec<Sphere>字段。 - 四条判据,缺一条就只剩一张好看的图,因为假绿各不相同:每帧每点不进球(实测最小距球心 90.00 = 半径,但球不在布的路上时会假绿)· 布真的贴过球面(100 点,门槛 40,但布从旁边滑过时会假绿)· 关掉推离就穿过去(最小距球心 0.32,差分守的正是上一条的假绿)· 末帧落到地面(540)。
- 两次演练分别红了 3 条与 2 条,且第二次演练中判据 1、4 仍然绿——这就是「球不在路上时它们会假绿」的直接证据,不是推理出来的。
- 写的时候两条判据被实测否掉:我原以为末帧布会卡在球内、两侧都有布;实跑是球内 0 点(布已落到球下方)、左 0 右 233(整块滑向一侧)。按实测改写,理由写进
tests/ball.rs文件头。 - 判据的常量不许手抄:演练时手抄了
const C = [480, 380],球被挪走后判据还在找旧球心——「测试常量过期」比没测更坏。改成引用scenes::BALL_CENTER / BALL_RADIUS;「从没发生」用Option<usize>而不是usize::MAX,否则报文印出「第 18446744073709551615 帧」。 - CI:场景数 19→20,加一份独立的
--test ball日志,结论行加「· 落球 N passed」;函数清单补上第 19 格落地时欠的19 + 41 → 20 + 41。 - 还差:布擦着球滑(摩擦/无摩擦两版对比)、布把球压弯(球目前是无限硬),两面都写进 README 的边界表了。
- 补的是
GPU 对账第八组 tex:纹理一上,撞出的不是 bug 而是契约没写清「怎么量化回 8 位」
- 前七组的纹理验算量是零:两边都用 1×1 白纹理,双线性采样只有一个点,mip / wrap / 线性与否一个字节都没碰过。第八组把纹理真的接上:
TexKind::White/Grad4,一块 4×4(R = 16(x+4y)、G = 240−R、B 在 (1,1) 挖一个 0、A=255),三块几何分别是 放大 80×(测插值)、1:1(测索引)、UV 子区域(测 UV 有没有真被用上)。 - 撞出来的不是 bug,是契约缺口:188030 / 204816 像素差 1 位,最大差 1。三个抽查点把数解释干净——
31.7→31、167.75→167、15.95→15,全部向下取整。根因:me-swrast在blend()末尾写out[0].round(),而 D3D12 的R8G8B8A8_UNORM是硬件截断。两边都对,只是契约里没写这一步该怎么量化。 - 判据因此改口:从「逐像素全等」改成「最大差 ≤ 1 位」,另加「
gross(差 > 8)必须为 0」把「量化」与「两个渲染器算出了不同的东西」分开。按像素比例判会红成笑话(91.8% 的像素都差 1 位);按位判一句话说清。跟 d3d12 那个 alpha 通道 bug、Metal 交接里「预乘 vs 非预乘」完全同构:契约里只要有一句话可以有第二种读法,就会有第二个后端读出第二种。 - 找到了「两边一起错」最干净的实例:把两侧同时退回白纹理 → 逐像素差 0、覆盖全对,前六条判据绿得毫无破绽,只有新加的「通道不变式」破 204816 像素。这条不变式好用在不依赖插值权重:四个权重非负且和为 1,所以对任何权重
R+G=240都成立 —— 不经过任何手算,也不依赖-0.5有没有写对。 - UV 盲区的实证:把
push_quad的 UV 改回常量 → 190947 像素差、最大差 96,但六个抽查点只红 1 个(子区域那块)。没做第三块的话整组对「UV 没接上」完全无感,而cpu.rs那一行在加这组之前正是写死的。补第三块是被「with_uvnever used」这条警告推进去的,不是设计时想到的。 - 半像素偏移仍然没被钉住:采样写的是
t = uv*size − 0.5,缺了-0.5整张图平移半个像素;Grad4是双线性可再生的(ramp 在插值下不变),所以这个错法测不出来。要么换一张高对比棋盘,要么承认这块还空着——已写进 README 的未验证清单。 - 两个小设计:① 「不查 max_delta」不能用
255当哨兵(matches!(Some(md) if md > 0)会把spin组吸进量化分支),改用Option<u8>:None/Some(0)/Some(1),「不查」是类型上不同的东西;② 抽查点吃同一容差、逐通道比,不让一个通道的误差抵掉另一个。 - 验收:完整 CI 451s 通过 · 6 项降级,GPU 那步报「八组对账全绿 · axis/half/blend/additive/stack 逐像素全等并抽查 6/6/5/5/5 · tex 最大差 1 位并抽查 6/6 · towers 差 9 个像素(边界)」,结论行加「· tex 最大差 1 位并抽查 6/6」,组数门 7→8。
- 事故一笔(已记在 commit message):python 批量替换
!= "7"→!= "8"误伤了 2721 行那条ARC_N判据(不是我写的),发现后断言 + 还原。批量替换必须带上下文断言,不能只匹配「看起来唯一」的短串。 - 还差:mip / sRGB / 各向异性没验;叠加的顺序语义仍未做(
stack摞内坐标完全相同,正着叠和倒着叠一模一样)。
- 前七组的纹理验算量是零:两边都用 1×1 白纹理,双线性采样只有一个点,mip / wrap / 线性与否一个字节都没碰过。第八组把纹理真的接上:
2026-10-29
来电自动接听三档落地,设置页可关
- 需求:家人内部通话,允许 3 秒无人操作自动接听,设置里可以关。
- 三档:静默接通(INV 第 4 段=1 或调用方
autoAccept)/ 自动接听(默认autoAnswerMs=3000,响铃 + 接听·拒接 + 倒计时)/ 关闭(一直响,45 秒超时)。SharedPreferences("yueju_call")存auto_answer_ms。 - 入口:手机右上角「设置」+ 电视通讯录下方设置卡,自绘 Toggle(不用系统 Switch)。
- 三个坑:①
Toggle.setOn里if (on == v) return导致anim未同步,首次进设置页画成“关”;② 内部类不能声明成员接口(JLS 8.1.3),ToggleChange提到类级;③ 电视设置页按返回误弹“结束通话”确认 →onBackPressed先判page == PAGE_SETTINGS。 - 真机:手机
INV→ACC3010ms;电视来电同样 3 秒;关闭后响 6 秒仍停在来电页,手动接听正常。
电视画面横屏 + 真圆角:SurfaceView 换成 TextureView
- 问题:手机上电视画面加圆角后四个角是黑的,其实是 UI 坑。
- 根因:
SurfaceView的像素在独立 surface 图层,父容器的cornerRadius/clipChildren/setClipToOutline全部无效;之前用CornerMask涂 90% 近黑伪装圆角,一遇亮画面就成四个黑块。实测角落(21,25,33)vs 背景(51,57,64)。 - 修:手机端改
TextureView+setOutlineProvider(RoundRect)+setClipToOutline(true)真镂空,修后(54,60,66)vs(55,61,68)。电视端保持SurfaceView(零拷页、底色纯黑看不出)。 - 附带:电视编码 1280x720 +
RENDER_MODE_HIDDEN,塞进 358x392 卡片会裁掉左右 49%(只剩中间 51%)→ 卡片改 358x202,不裁不留黑边。 - 新坑:
getSurfaceTexture()是异步的,未就绪就setupRemoteVideo,SDK 不报错也不出画(现象等同“远端没推流”)→ 加ready()判断 +pendingRemoteUid记账补绑。
GPU 对账第七组:四摞完全重合的色块,把「不累积」这种错法逼出来
- 前六组一个重叠都没有(
blend那句注释明写「互不重叠」,是为了让几何上没得错)。代价是累积从来没被验过:每块色块只混合一次,于是「每画一个矩形都从干净背景重新开始混」这种错法六组全绿——它只在东西压着东西时才显形。 - 新场景
stack:四摞完全重合的色块,摞深 1/2/4/8(共 15 个 quad),加性混合。演练(CPU 侧改成「每个矩形单独画到干净背景再取并集」=不累积):axis/half/spin/towers/blend/additive 一个像素都没动,stack差 124800 像素、最大差 140。124800 = 166400 − 41600,正好是「除第一层外所有层覆盖的像素」——数对得上,说明红的原因就是缺了累积。 - 为什么能要求逐像素全等:
a = 51(51/255 = 0.2),源色 (100,50,25) → 每层增量 (20,10,5) 全是整数,一次舍入都不发生。四摞期望值 (46,38,37)(66,48,42)(106,68,52)(186,108,72) 是手算的,跑出来逐格相同。代价如实写进注释:测不到每层的舍入规则(两边一个向上一个向下也永远落在整数上),测不到叠放顺序(摞内坐标完全相同)。要测舍入得用增量带小数点的场景,那会引入「不同 GPU 在 .5 上的 tie-breaking 不保证一致」——把一条硬判据换成一条偶发红的,不值。 - 破坏性改动:
geom::spec_of()从(usize, usize)变成Spec { quads, area, cover }。stack是第一个「面积和 ≠ 覆盖像素数」的场景(15 个 160×260 = 624000,画面里只有 166400 个像素被盖到),沿用「覆盖率 == 面积和」会红 457600 个像素而画面完全正确。调用点只有一处。 - 顺手补上第 2 条判据的第一次红:覆盖率那条此前是五条里唯一「没有一条演练证明它会红」的(README 里如实写着「没演练到」)。
stack给了干净坏输入——四摞间距 220→120 互相重叠,并集 166400→135200,而个数与面积和一个没变;第 3、4 条都绿,只有第 2 条说话。 - 这次演练抓出一个报文缺陷:抽查点一红就无条件顶掉
judge()的报文,把「覆盖 135200 ≠ 166400(偏 18.75%)」整句顶掉了,屏幕上只剩「抽查点错 4 个」——去查覆盖率的人会被带到完全无关的方向。改成两句并列:红几条就说几条。 - 前一轮欠的账:第 19 格(浮力)落地时忘了重新生成
crates/me-soft2d/FUNCTIONS.html,页首「18 + 41」不会自己变 19,CI 的清单那步(--check逐字节比)会红。已重生成。 - Metal 收编交接:
Team/notes/metal-handoff.md九节 + 跨扇区登记(复核 A2+A3,11-19 到期)。性质写清:本机没有 Mac,那 2509 行一行都没跑过,是「要人验的清单」而不是结论。核心判断——预乘 alpha 是收编唯一需要改契约或改数据的地方,与 d3d12 那个 alpha 通道 bug 完全同构:契约一句话有歧义,两个后端长出两个答案,而各自的单测都绿。 - 验收:完整 CI 整跑 381s 通过 · 6 项降级(Mac / 微信 / 代修待复核那些环境限制)。GPU 那步报「七组对账全绿 · 逐像素全等并抽查 6/6/5/5/5 · 7 组都在」。上一轮 507s 那次是红的——
tools/ci/ci.sh被批量替换写成了 CRLF(shebang 变bash\r),已转回 LF。 - 还差:混合 + 纹理(1×1 白纹理,采样只有一个点)、叠加的顺序语义(要先确定引擎承诺的是哪一种,当前没有答案)、以及「每步量化回 8 位」本身(整数增量把它绕过去了)。
- 前六组一个重叠都没有(
动画系统 S14-1 / S14-2:骨骼层级 + 关键帧时间轴,确定性变成会红的判据
新建
crates/me-anim(L4/A2),S14-1 与 S14-2 两批,判据 57 条全绿、CI 整跑通过 (270s)。- S14-1:
Affine2/Bone/Skeleton/ 五种 SpineInherit,五种继承各断言世界矩阵六个分量。 - S14-2:
Curve/Interp(线性·阶跃·贝塞尔)/Track+blend/blend_angle。 - 真正的交付是「确定性」:三张 golden 表(16 角度 sin/cos、骨骼世界矩阵 6 分量、贝塞尔反解 12 采样点),host 与 wasm 逐位相同,CI 里一步跑。这是
me-math存在理由的第一个硬证据。 - 贝塞尔反解用固定 20 轮二分而不是牛顿:牛顿的终止判定是浮点比较,可能在不同目标上于最后一次迭代分叉。
- 顺手查清两个别人的文件里的真 bug(已报备不代修):
build_crate_docs.py的 H1 标题死循环、check_commit_msg.py在本地已发散时的假绿窗口。 - 待办:
crates/me-anim还没进plan/agents.json(A1 的活);下一步是 S14-3 GPU 蒙皮 —— 那是「超越 Spine」的主攻方向。
- S14-1:
特效系统 me-fx2d:粒子 + 时间轴 + 真的会弹会溅(两个真 bug 是判据抓的)
- 两块不是一个东西:粒子回答「长什么样」,时间轴回答「什么时候」。只有粒子是一团永远在喷的火,只有时间轴是一串没有内容的时间点。为什么是 L5 不是 L4:刚体守动量、软体守边长、流体守不可压,都有方程;而「这团火星对不对」只有「像不像」。硬塞进 L4,第一个破的就是「物理层只放守守恒律的东西」。也不放进
me-render(渲染不该拥有「什么时候爆炸」这种玩法级时间,且 owner 不是 A3)。 - 弹射两个必须一起做:① 先按穿透深度把粒子推出去再改速度(只反射不改位置 → 粒子留在盒子里 → 下一帧又撞 → 看着像「在里面抖」);② 用相对速度(含
ω × r),否则横扫过来的挡板只是把它自己的速度还给粒子。 - 溅射三条:冷却 0.12s(地砖是拼的,一次撞击被两块体各判一次 → 同一点溅两簇;卡墙角则每帧一簇「持续喷水」)+ 每帧预算 24 个 + 数量
min(2 + ⌊speed/400⌋, 8)(150 像素/秒 → 2 个、900 → 4 个,是取整台阶不是线性,否则读数不可复现)。 - 粒子不推动刚体:反作用力是
World::explode那种一次性的活。每帧几千个粒子各给刚体一个力,会让刚体行为取决于粒子数量,而粒子数量取决于容量与帧率 —— 等于让物理结果依赖性能。 - 两个真 bug,都是判据抓的:①
next_f32只覆盖[0, 0.5)(xorshift64* 取了 31 位再右移 8),而当时那条0 ≤ v < 1的判据全绿;抓住它的是另一条「圆盘取点是否面积均匀」——1000 点里 509 个落在半径一半内(应该 250)。② 曲线在同一时刻取了前一个关键帧(按「哪一段包含 t」搜,落点上前一段先命中),at(0.5)给 2.0 而那个关键帧是 3.0。 - 一条绿着的假话:
a_settled_spark_stops_splashing第一版池子只有 512,溅射粒子填满后splashes因为「发不出来」停止增长,于是「停止溅射」在行为已经坏掉时通过。修法不是改判据,是池子给到 8000 并断言dropped == 0;顺带发现计数器在没设溅射发射器时也会 +1,计数器和现象不一致本身就是谎话。 - 演练:
drill-fx.py7 条全红、还原后全绿。脚本自己踩三个坑:--exact只认完整路径(单元测试名带rng::tests::前缀 → 一条都过滤不到、退出码 0,于是「七条全过」是空转);「一帧只放一个 cue」改内层while→if不红(外层while remain > 0会补上),变异点必须挑到remain -= to_next;「曲线取前一个关键帧」改上界搜索后那段成了死代码,变异它等于变异注释。 - 验收:25 单元 + 12 场景 + 2 doc test 全绿;清单 186 项 / 102 函数 / 102/102(每个公开函数在演示里真调一次,构建时校验);
--api-tour24 → 32 行,读数真跑(掠射 15° 只偏 30°、溅射 150→2 / 900→4)。 - CI 两处范围修正:清单检查从只查
me-rigid2d扩到三个 crate(原来另两个的清单可以一直是旧的、甚至没生成过,而 CI 全绿);新增「me-fx2d依赖面只许me-math+me-rigid2d」—— 随机全来自自己的Rng,哪天拉进rand,「同种子两次一样」照样绿。 - 还差:演示工程没有可视的粒子关(场景数仍是 12;要做得让
Spec带粒子流、viewer.rs与关键帧光栅都会画粒子,同时改 CI 里「场景数 = 12」那条);me-fluid2d仍是骨架;软体那 6 条判据还没演练红。
- 两块不是一个东西:粒子回答「长什么样」,时间轴回答「什么时候」。只有粒子是一团永远在喷的火,只有时间轴是一串没有内容的时间点。为什么是 L5 不是 L4:刚体守动量、软体守边长、流体守不可压,都有方程;而「这团火星对不对」只有「像不像」。硬塞进 L4,第一个破的就是「物理层只放守守恒律的东西」。也不放进
2026-10-28
小游戏资质:微信 IAA 免版号,抖音软著必须且唯一
- 微信小游戏分两条通道(官方文档区分):IAP(要开虚拟支付)必须版号 + 软著;IAA(纯广告、永不开支付)不需要版号,只需代备案授权书 + 著作权自我声明 + 自审报告。仅两种情况 IAA 要软著:游戏名含英文/「软件」字样,或涉品牌/公众人物合作。
- 抖音小游戏:软著创建即必填且一软著只能挂一款;版号是开通内购的凭证;官方明确电子软著可用于资质准入,但不能用于小游戏备案。
- 变现方式决定版号:纯广告 2-3 周可上;带内购要等版号,半年起步。这个要在写第一行代码前定下来。
- 两边都绕不开工信部小程序备案。
- 不采信代办站「2025 新规」那套(注册资本 100 万实缴、2 万保证金等),非官方口径。
物理三件套:刚体补磁铁/射线,新建软体与粒子流体,数学统一到 me-math
- 规划里原本没有物理(P0 砍掉清单原文「物理(2D 用简单 AABB)」),今天作为计划外补齐为三个 crate,按「守什么不变量」分家:刚体守动量、软体守边长与形状、流体守不可压。
me-rigid2d补玩法级五项(层掩码、射线、区域查询、持续力与扭矩、力场/磁铁),36 条场景判据全绿,公开面 193 项 / 109 函数,109/109 都在演示里真调过(构建时校验)。me-soft2d新建:6 条判据全绿。果冻的「软」是量出来的——带对角约束的grid残余偏差 0.0 像素,必须用只有横竖边的block;形状匹配每步只能跑一次,放进迭代里 8 轮×0.1 会让果冻被戳只动 0.0 像素。me-fluid2d新建:双密度松弛 + 计数排序空间哈希(不用HashMap,迭代顺序会漂)。能编过,但参数标定、判据、演示场景都还没做,这条不算完成。- 数学统一:推翻「物理自己写
sqrt/det_sin_cos、两份实现互校」——me-math守得更硬,互校能发现「算错」但发现不了「两边差着用」。math.rs改成门面,cross_math.rs删除。 - 文档同步:
docs/01§6.1 从 20 个 crate 改为 22,新增 §6.3「物理为什么是三个 crate」。改之前build_arch.py --check是红的(两个新 crate 在图上有、表里没有)。 - 站点
/arch//docs//board/三页已重建;/board/extras 追加这一条,--fmt后--check通过(110 任务 / 62 完成 / 22 crate)。 - 还差:流体标定与判据、软体判据演练红、三 crate 的 clippy/fmt、演示工程的磁铁/布料/流体三类场景。
帧率归因:引擎只花 1~5ms;十二个用例全加动画 + 第 13 项「角色与关卡」
先量再答:帧率不是引擎的事 原 HUD 只有一个帧率数,而「引擎慢」和「宿主不给帧」在数值上一模一样、修法却相反。加第三行「引擎 x.x ms · y%」(量一次 frame 调用的墙钟)后
.6实测:平铺 73fps / 引擎 1.5ms、规模 84fps / 4.5ms、角色 73fps / 1.3ms ⇒ 引擎只花 1~5ms,73/84 是抖动不是锁频。顺手拿掉preserveDrawingBuffer(每帧多一次全屏拷贝)与 HUD 每帧写 9 次 textContent。动画:t_ms 一直有,没人读 十二个用例无一读
Params.t_ms⇒「静止」是漏了不是设计。两条硬约束:① t=0 时逐顶点与旧版相同(判据/截图都跑 t_ms=0)⇒ 只用 sin / fract,一个 cos 都不要;② 只改位置/uv/颜色,不改精灵数与贴图交替顺序。翻转块从「1.8s 硬切」改「按 |cos| 压宽、过零换 uv」—— 硬开关时 t=0 与 t=1200 都落在不翻转那半、截图逐字节相同,看着像没生效。新增?t=毫秒,已验 6 项 t=0/t=1200 不同。第 13 项「角色与关卡」 夜空 + 地面带 + 主角(走/转身/跳)+ 两只史莱姆 + 三枚金币,9 批 16 精灵;四张素材走云函数 genImage。三个坑:抠图不能按 RGB 距离(背景 18~25 渐变暗灰,要按亮度分档:背景 18~25 / 描边 0~11 不重叠);
square()补边默认纯黑正落进「描边保留」档;content_box()阈值 26 是给纯黑背景写的,暗灰上判出整张图 ⇒ 只剩右下水印被裁进精灵。水印三分:图标裁、整屏背景镜像补、平铺砖回原坐标补(uv 内缩 5% 躲不开横跨 66%~100% 的它)。平铺重写:原按视口 88% 排,加平移立刻露黑边(深色画布上 = 渲染坏了)⇒ 铺满视口再多一圈作余量,
tile_layout()场景与判据共用。验收:cargo test -p me-render 全绿(lib 268)、clippy 0 warning、CI 全绿(30 项 · 2603 测试)、无头与 .6 真机均 13/13 PASS 且读数逐字一致;wasm 606,464 → 611,090 B,无新 import,三份副本 md5 一致。遗留:「着色」第 7 块挤在最右(六格后只剩 64 px),功能对但构图偏挤。
SPRITE 演示页:清屏修掉 + 四张 AI 素材换掉色块
用户报:「切场景没清屏,越叠越乱」+「只有色块,观赏性太差」。
- 清屏根因:
frame()直接画默认帧缓冲、全程没begin_render_pass;而begin_frame一个字节都不清(清屏挂在 begin pass 的clear_color上)。抄LdrBlit时省掉的是填充 + 它顺带的清屏两件事。 - 12 项判据全绿:它们数的是「这一帧画了什么」,不是「屏上剩什么」。新判据钉
clear_color == Some(BG);?warm=24是唯一能拍下它的开关。 - 四张 AI 素材(genImage/混元):panel 512² · atlas 512×128 · tiles 256² · chest 256²。图标不抠图 —— 清屏色与页面底色统一成纯黑,近黑底直接融进背景。
- 平铺换过一次题:格子图不是周期结构(间距 30~69 浮动)、四重镜像又在中线出双线 ⇒ 改成「一格 = 一块带凹槽边框的板」,不用镜像。
chest的「主体占中间 50%」是case_trim的 uv 契约,不是审美。 - 连带:
TEXTURES与兜底像素尺寸必须同步(不做长度校验 ⇒ 不同步是越界读);T_CHECK采样器Nearest→Linear;修掉自己刚造的「等图再画 ⇒ 截图空画布」。 - 判据:268 测试全绿 · clippy 0 warning · 无头与
.6真机都 12/12、读数逐字未变 · wasm +735 B、无新 import、三份 md5 一致 · 素材脚本已入库可复现。
- 清屏根因:
SPRITE 演示工程 —— 12 项功能巡览(参考 Cocos SpriteTest,图全是算出来的)
产物是画面,不是判据:与上一轮
sprite-lab(回答「特性生效没有」)分工不同,这一页回答「精灵能干什么」。判据只核三件(frame 返 0 / 批次 ≥ 1 / 未贴图批 = 0),故意不核精灵数。只借结构不借资源:Cocos 源码在
tao-lan:(本机路径)(不在本机)。看01.sprite九个场景 +staticScene的 sort/batching/opacity,但cocos-test-projects无 LICENSE ⇒ 7 张贴图全部代码算出。12 项:基础与过滤 / 九宫格 / 图集取帧 / 裁剪与留白 / 平铺 / 填充 / 旋转与缩放 / 翻转 / 着色 / 排序 / 合批 / 规模。
.6真机与无头 SwiftShader 都 12/12,读数逐字相同:1=2/4 2=1/37 3=1/20 4=5/16 5=1/64 6=3/57 | 7=1/24 8=1/8 9=2/13 10=3/24 11=66/129 12=1/1000(批次/精灵)。表比截图信息量大:第 1 项 2 批 =
T_QUAD与T_QUAD_SMOOTH像素相同、只有过滤不同,仍然断批;第 11 项 66 批/129 是故意的反例(交替贴图 + 递增 z)—— 不是合批退化,是合批的定义。三个取舍:
scene()返回多遍(排序是整份列表的属性,一帧里看三种排序只能提交多遍);绕开probe骨架(受控例外,守卫改三分类 + 名单过期断言);例外拿掉的是配平 ⇒ 补「连画两帧都成功」判据。五处观感缺陷全是截图看出来的、判据一个都不报:九宫格切边太细 / 裁剪右侧放大成两倍 / 填充扇形条有缝 / 旋转两件事没拆开 / 排序超出画布。
提交:
22a3a05(源码 2331 行)/78627dd(wasm 575.6→591.5 KB,+11 导出)/d71bc0c(§82)。竖版宣传片:8 屏真机截图 + 中文旁白(生成脚本可重跑)
成片:
dist/xiaohonghua-promo.mp4— 1080×1920 / 30fps / 72.9 秒 / H.264+AAC / 15.5MB,手机上可直投视频号、抖音、小红书。结构(8 屏):欢迎页 → 首页打卡 → 19 个习惯库 → 惩罚与二次确认 → 成长统计 → 攒花换奖励 → 两台手机同步 → 品牌结束卡。
做法:
tools/make_promo.py—— PIL 逐屏排版(渐变底 + 柔光色块 + 圆角截图卡 + 阴影 + 字幕)+say -v Tingting生成中文旁白 + ffmpegzoompan做缓慢推镜,每屏时长跟随旁白自动伸缩,最后 concat 合成。踩过的坑:
1. homebrew 这版 ffmpeg 没编
drawtext(Unknown filter)→ 字幕改由 PIL 画进画面2. PIL 在 RGBA 图上画半透明是替换不是混合 → 标题底衬变成实心蓝方块;必须走独立图层
alpha_composite3. 柔光色块的模糊超出图层边界时露出方形边缘 → 图层要预留 blur×2.2 的内边距
4.
-loop 1 -i img默认输入 25fps,导致成片只有 1821 帧(应为 2184)→ 加-framerate 30后 2185 帧 / 29.99fps5. 应用图标 PNG 四角是白底 → 贴图前必须按圆角裁 mask,否则是个白方块
验收:抽帧出 8 屏联系表逐屏核对(内容与字幕相符、无黑帧/截断);
volumedetect均值 -18.8dB / 峰值 -2.4dB,确认旁白已混入。v1.3.1:回填 deviceId,修掉「分不清本机 / 能把自己踢下线」
现象:设置 → 家庭成员里两台设备都显示「移除」、没有「这台」标记,能把自己踢下线。
根因:
isMyDevice()拿session.deviceId比,但 v1.2 以前存的本地 session 没这个字段;而服务端GET /api/state早已返回me.deviceId,只是ApiClient.fetchState只解析了me.name,把设备身份丢了。修法:RemoteState 增
deviceId/deviceLabel并解析;Session 增copyWith;refresh()里若本地 deviceId 为空则从服务端回填并持久化(老用户升级后自动修好,不用重新登录);身份未知时隐藏「移除」并给出提示,作为最后一道防护。验证:
flutter analyze0 问题;flutter test36 项全过(新增 device_identity_test 4 项)。SPRITE 实验室:8 项功能矩阵 + 36 格阶梯,一次 draw call ≈ 10µs
- 新落点
crates/me-render/src/wasm_lab.rs+crates/me-render/tools/sprite-lab/,一行没进apps/(apps 归 A3)。它不 import 游戏,也不需要游戏存在。 - 功能矩阵 8 项(实心 / 四象限 / 旋转 90° / UV 裁剪 / 翻转 / 半透明 / 合批 / Z 序):
.6真 GPU 8/8,无头 SwiftShader 也 8/8。 - 贴图用 8×8 四象限而不是单色 —— 裁剪/翻转/旋转/图集取帧都只改「哪块纹素落到屏幕」,单色下四种改动一个字节都不变。
- 阶梯 36 格(N=125→10000 × 6 组状态位):一次 draw call ≈ 9.9µs,跨三个数量级稳定;1000 批 ≈ 10.6ms = 16.7ms 预算的 63%。旋转/缩放/裁剪/染色/透明合计 <15%,换贴图 4.4 倍。
- 判据分工:不变量(覆盖率/批次数/顶点数)进
#[cfg(test)]13 条;颜色金标只能真 GPU 给,记在页面。 - 三次判红都红在判据上(染色是否断批 / 旋转方向 / a/b/c 全按颜色印),已写进状态文档 §80.3。
- 另外:产品页
?level=N直进关卡接上了,并撞出并修掉一处归因缺口(trace_start的归因在start重建 Game 时丢失,.6上组 0→9、残差 100%→0%)。
- 新落点
M0.3 ④ 真机 trace 接上(归因 9 组残差 0.0%),并查出 ② 在产品页上未达
- M0.3 ④(真机 trace 回传编辑器)第一次有真机证据:产品页默认就在采 trace(
CoinBoot.traceStart(ex, 600)),缺的是导出口 —— 只有按 T 下载 JSONL 和 console.log,真机上两样都没有。页面加了?trace=<毫秒>:跑满 N 毫秒把统计与归因压成一行回传/verdict。 .6上读数:TRACE-PAGE OK 600帧 归因帧 944 组 9 批 8496 残差+beyond 0.0% dt_p95 36.5ms busy_p95 2.2ms fps 47.4 canvas 1920x1080 css 816x460 dpr 1.5。归因落在 9 个 MIR 节点组上、残差 0.0%,一帧画的东西全部能指名道姓。- 顺带发现 M0.3 ② 在产品页上未达:同一台机器同一关,判据页
m03.html是dt_p95 17.0ms/60fps,产品页index.html是33.3ms/47–53fps。原因量到了 —— 产品页背板 1920×1080,而屏幕上那格是 816×460(dpr 1.5 ⇒ 1224×690),每帧多画 2.45 倍再缩下来,而busy_p95只统引擎侧 GL(2.2ms)。 - 背板 A/B(B→A→B):换成 1224×690 ⇒ fps 47.3 → 52.6、JS 堆 34.3 → 18.8MB,但
dt_p95仍停在 33.3。默认值没动:像素判据都按 1920×1080 建的口径,要 A1 定。 - DoD ② 的措辞有自相矛盾:「稳定 30fps,帧时间 p95 ≤ 33ms」—— 60Hz 上 dt 只有 16.7/33.3/50.0 三档,而 30fps 的帧时间正是 33.3ms,门槛比它小 0.33ms,照字面读任何真正跑 30fps 的机器都不达标。这条实际等价于「丢帧率 <5%」(fps ≥ 57)。
- 新增
apps/coin-run/run-trace-page.sh做驱动;顺带修了自己一处判据错:环缓冲回绕后frames恒等于容量而归因是累计的,accounted === frames会跑得越久越错判,改成>=。
- M0.3 ④(真机 trace 回传编辑器)第一次有真机证据:产品页默认就在采 trace(
M0.3 ②③ 第一次真机测量:`.6` 上 60fps、整进程 RSS 473MB,两条都过
- 判据 ②(中端安卓 30fps,p95 ≤ 33ms):第 1 关 180s
dt_p95 17.0ms(= 58.8fps)、busy_p95 2.6ms;第 12 关 180sdt_p95 17.0ms、busy_p95 2.8ms。余量 2 倍以上。 - 判据 ③(峰值内存 < 600MB):
com.tcl.browser整进程 PSS 峰值 308MB / RSS 峰值 473MB(基线 218MB),都在预算内。扣掉基线的页面自身部分 RSS ≤251MB、PSS ≤87MB。 - 三趟合计 285s 游玩,
wasm 15.1MB 增长 +0KB,与 30 分钟浸泡的 +0KB 一致。 dt_p95顶在上限时它测不出变慢:只要引擎成本在 16.7ms 内dt_p95恒为 17.0ms,要盯趋势得看busy_p95。- 「峰值」对跑之前进程多干净敏感:三连跑基线 157→182→218MB,引用这个数必须带条件。
- 边界:一台机器(
.6)、两关、一轮;.70是飞哥在用的电视盒子,没碰。
- 判据 ②(中端安卓 30fps,p95 ≤ 33ms):第 1 关 180s
M0.6 ③ 收尾 + wasm 降到 MVP(老 WebKit 也能跑)+ M0.3 / M0.6①④ 两台真机数
- wasm 降到 MVP:
build.sh加三个 lowering(sign-ext / trunc_sat / memory.copy-fill),价差 +1478 B / +0.22%。.70(Android 9 · TCL 自带浏览器 · WebKit)从「wasm 编不了、页面全黑无提示」变成能玩:GLLOST-PAGE NEAR 丢前 黑0.0%/步17 恢复 2579ms 黑0.0% 异常 0。加wasm-sec.py --min 0当门。 - D-02 的版本号读错了:之前写「WebView 66」,真正跑页面的是
com.tcl.browser(默认 VIEW 处理者,UA 冒充 iPad)。版本号要从跑页面的那个进程读。 - M0.3 第一次有三个数:
.6dt_p95 16.9ms / PSS 249MB;.70dt_p95 16.7ms / PSS 392MB —— 阈值 33ms、预算 600MB,余量很大,60fps 没掉帧。 - M0.6 ①(限时 1800s):
.61412 轮 / 84720 帧、.701192 轮 / 71520 帧,wasm 线性内存 +0KB,0 崩溃。 - M0.6 ④(100 轮):wasm +0KB;PSS 收尾相对峰值 −11.4% / −0.0%,相对基线 +24.4% / +0.7% —— 两个分母结论相反,采哪个挂 A1。
- 判据工具的三处修补:
soak.html轮数上限 500 原来是静默夹取(cycles=1400跑成500/500轮,看着像跑满了,其实只有 10 分 37 秒),现在会说出来,并新增?seconds=限时模式;dumpsys meminfo在 Android 9 上没有TOTAL PSS:标签,解析器收敛成apps/coin-run/meminfo.sh一份(原来两个脚本各存一份、同时坏);真机脚本加了「收尾」第三个内存读数。 - 六笔已推,CI 每笔全绿(262/249/241/236/238s)。
- wasm 降到 MVP:
2026-10-27
通知权限未声明,告警通道静默失效
- Android 13 起通知默认关闭,不声明 POST_NOTIFICATIONS 就一条也发不出去。
- 真机实测(小米 2509FPN0BC / Android 16):
cmd appops get ... POST_NOTIFICATION返回ignore,而grep -c POST_NOTIFICATIONS AndroidManifest.xml是 0——连权限都没声明。 - 最坑的是界面上完全看不出来「提醒已经断了」,属于静默失效。
- 已修:manifest 声明 + 开屏用
ActivityResultContracts请求 + 拿没拿到都立即上报心跳;加了 debug 探针am broadcast -a cn.yueju.antifraud.PROBE。 - 修后验证:
dumpsys notification --noredact能看到id=1001 importance=4 channel=guard_alert。 - 教训:告警通道必须能被观测到「没发出去」,不能只验证「发得出去」。
v1.3.0:一人多机拆成人/设备两层,修掉取消打卡被撤销
问题:飞哥指出「app 好像没解决一个人有多个手机」。实测比这更宽:手机 1 取消打卡 → 手机 2 推旧快照 → 服务端打卡数 0→1,取消被撤销,两个人两台手机同样中招。
根因:① 「成员」其实就是「设备」,每台手机加入就是新 member;② 整份快照 + 并集合并,删除没墓碑,取消/删除在另一端必然复活;③ 成员重复、无法踢设备下线。
修法:服务端 member 拆出
devices[](token 归设备,老数据启动自动迁移,不用重新登录);新增 6 位数字配对码(10 分钟一次性)把新手机绑到同一成员;CheckIn/Reward加deletedAt改软删除;加入页两种身份,设置页可看设备并踢下线。验证:本地 server 8 项端到端全过(老 token 可用 / 成员不重复 / 码一次性 / 踢设备后 401);
flutter test32 项全过;真机小米装 v1.3.0 截图确认。上线:apiVersion=2,2 个家庭均迁移为 1 人 1 设备,打卡与习惯数据完好,已备份。
铜钱江湖:背景视差上线 + 工笔侠客 + 地面接缝彻底修掉
已发布(线上
92e1841,HEAD2d197d5)。- 背景有视差了:
Backdrop加step,三块[x, x+3w]才恒包含屏幕(两块会漏半屏,1920 宽从 1496 列起全黑);因子 0.22 是按画面调的。证据:X=700与X=1500两帧互相关最佳位移 −704 px,理论值0.22 × 800 × 4 = 704。 - 真分层拆不出来:需要一张无云远山图。横向插值留水平直条、IDW 留矩形块、按山脚行对齐混回云的青绿,三种都试过,放大 4 倍一眼看出「被抹过」。所以这一版是单层 + 视差 + 镜像平铺。
- 接缝根因不是块边界:
dilate写 RGB 却留alpha=0,混色权重 0 等于没外扩,每个精灵右边缘漏一列半透背景((150,76,50)→(175,122,88))。亮线跟着屏幕走(X=700在 435 列、X=750在 235 列)就是凭据。改成border_alpha:世界图集 255、侠客 0。 - 地面:镜像平铺 → 渐变 + 裁头,烘焙期断言首尾列差 < 12(实测 4.9)。坑从深绿方块换成中性压暗 + 6 单位坑口暗影。
- 判据跟着新美术改两处(撞色,不是引擎错):红袍把「主角专属色」堵死了,换石青云一族三色(41 / 上半段 0);地面换
(105,155,117)且模式改lower(19 299 / 335)。 - 验证:294 测试全绿,
ci.shexit 0 零 ✗,wasm 653.2 KB,发布 23 文件哈希一致。顺手把library/art子模块从42e8761快进到ffeb3af,重烘产物逐字节等价。
- 背景有视差了:
S6-7 引擎侧落地:结构热重载按「身份」接力(并撞出 cooked 的 node 是序号)
crates/me-runtime/src/reload.rs新增:SceneReload::reload(world, index, scene, uids) -> ReloadReport。换一份场景、世界不重启、帧号不归零,不在这份场景里的实体(玩家/粒子/UI)一个字节不动。- 落地前撞到的事:
DrawItem::node是lower.rs:409的node_names.len()+1,即条目序号。文档中间插一条绘制,它之后每条node全 +1 ⇒ 按它接力会把旧实体接到别的节点上,pos被覆盖而账上updated==N看起来完全正常。没有任何一层会报错。 - 解法:身份由宿主带外给(
uids与items()逐条对齐,从 MIR 节点 id 算),NodeIndex的键从此是身份 ⇒owner/拾取/框选/拖拽/补丁整条链自动对上。cooked 字节一个都没动。 - 判据 13 条(
tests/reload.rs)。核心那条的身份故意取成 1/2/3(与序号相同),让「按序号接力」找得到实体——找不到是响亮的,改错了人才需要钉住。演练:换成it.node⇒ 红在updated应为 0 实际 3,且三个实体位置被隔壁内容覆盖。 - 判据抓出真 bug:贴图「没变」不能按下标判(旧表 [a,b] 持 0=a、新表 [b] 要 0=b,下标相同图换了)⇒ 必须比名字、写入写新下标。
- 八个数分开报,
reindexed单列(资产表重排、画面不动):并进updated会让「插一张图」= 「改了 998 个节点」。 - 给 A1 提
N-228(契约 §5 补一句「编号只在这份产物内有意义」)、给 A3 提N-229(/api/build顺带吐uids,不许拿node顶替)。 - 判据:
cargo test -p me-runtime --release全绿(lib 294 + 集成,reload 13)、clippy/rustdoc-D warnings干净、本地 CI 206s · 0 ✗ · 5 项已知降级。 - 顺手订正板上账:
N-313标着「球在 A2」而N-223早答了 ⇒ 已关闭 /N-223待落地·球在 A3。
第十二轮:地面按震地什么也没发生,第三处「算出标志又丢掉」上了锁
- 审完
fixed_step与late_update两块:Hero::Brute站在地上按技能那条分支被let _ = shock;吃掉 —— 冷却照扣 150 步、音效照响、屏幕什么也没有。修法照抄同函数的slammed(块内算、出块兑现) - 冲击波那道环每帧写的是屏幕居中的算式(从选关页格子排版抄来的),相机贴世界边界时人在 x=31 震、环出现在 x=240。改成绕自身中心长,并修掉
spawn_effect「按左上角落位却按中心扩散」的半格偏移 - 第三次同款(
flash_due/shock/multi)⇒ 新增守卫tests/source_shape.rs:src/coin_run/*.rs禁止let _ = <裸标识符>;(那句正是让unused_assignments闭嘴的钥匙),守卫自带一条「匹配器不许空转」 Sim.unlocked的注释写着「Game::step每帧同步一次」——是假的,step 里没有这一处;把真实约定(改存档那步后面必须跟restart())写进注释,并把「两份镜像一致」推广成判据:unlocked/last_level/hero/save.hero/touch_ui五对数 × 四条入口- S6-3 第 ③ 段落地:
FrameRenderer::collect_cooked+Viewport::frame_cooked(产物字节 → 绘制列表 → 离屏 → 上屏,四步次序与 ECS 那条逐行相同),判据 4 条、两条变异各红。第 ④ 段(→ canvas)卡在 A3 一句答复:LoadedScene借用字节,wasm 里要自有版本还是Box::leak - 目录清理按档 1 执行:14G → 7.6G(incremental 4.0G / aarch64-apple-darwin 1.3G / macos-demo target 965M / Chrome 配置 350M / examples 226M / doc 90M),删前后
git ls-files都是 960 - 数字:
cargo test -p me-runtime36 target / 738 通过;game_slice117 通过;clippy --workspace --all-targets -D warnings干净;CI 3m01s 0 条 ✗(2 项已知降级);wasm 652.4 KB / 92 导出 - 三笔已推
agent/A2:2315a80震地与环 ·63d1985视口 cooked ·ef1c9c6死局部守卫 ·813511ewasm 快照 + §36
- 审完
压力关五个字一直是豆腐块 —— 守卫链在最后一环短路了
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
力 / 测 / 试 / 机 / 批五个字从来没进点阵表,屏幕上一直是豆腐块。而所有门都是绿的。 - 四层根因,每层单独看都合理:①
requirements.txt里从来没有 pillow,而install_hooks.sh只装它 ⇒ 托管的.venv一定跑不动gen_hanzi.py(SystemExit(2));②cjk.rs::the_generated_table_is_current按「第一个存在的解释器」选,取到.venv就只跑它;③ 退出码 2 走「跳过」分支,报 ok;④ CI 里那条cargo test也绿 —— 「跳过」和「通过」在输出里长得一样。而同一台机器的python3装了 Pillow,--check跑得动,并且会当场红。 - 修法:判据改成按结果退到下一个解释器(每个候选都试,全不行才跳过,并打印试过谁、各自怎么不行)、报错里带「用哪个解释器判的」;
STRESS_SAMPLE从stress.rs挪进copy.rs(上屏中文只有一个烘点阵的入口),stress.rs进NOT_ON_SCREEN并写明理由;重烘点阵。 - 验到底,不只看判据绿:无头 Chrome 跑压力页四档,批次
401 / 2 / 7 / 1全部等于期望、missing=0、白块0;再停到有标签那档截图放大逐字对过。图集占用率 51.6%(606 字),离装不下还很远(BakeError::AtlasFull会直接expect炸,不会静默画白块)。 - 顺手两处 review:①
copy.rs注释说「测试盯着名字分家」,实际只验数量与非空 —— 把两关中文名对调,四条判据全绿。改成LEVELS: [(&str,&str); 12](一行一关的中英名),逐关比.lvl的title;三个变异各自红(整行对调 / 只改英文 / 只改.lvl重打包)。②game.rs的let _ = (title, par, facing)吞掉三个死局部,含每帧一次String克隆与一个全仓没人读的Sim::par;sim.levels.clone()每帧一次 Vec 分配改成栈上定长数组。wasm 668,420 → 668,330 B。 - 两条口径:「跳过」与「通过」在输出里必须长得不一样 —— 判据越重要,越不能有「静默可行」的分支;「路径存在」≠「东西能用」,凡按存在选完就不再换的,都会在「存在但坏掉」的机器上退化成空转。
- 账面:CI 297s 全绿(0 ✗,2 项已知降级);
cargo test --workspace(debug)2275 通过 / 0 失败 / 3 忽略,5 分 33 秒 —— 在这之前-p me-runtime在 debug 下一直是红的。提交db670f9/66aa728/a61e0af/c6d278f/df8bcb0。 - 报给 A3:
requirements.txt缺pillow>=10(他的文件,一行闭合根因)、ci.sh第 742 行的包体余量数字过期(写 57.7 KB,实测 147 KB)。
- 症状与代价:压力关那 40 条中文标签切的样本文案「铜钱江湖压力测试中端机帧时间批次数」里,
第八轮 review:三个真 bug + 一次越界红灯(音频分块 / 音景锚点 / 渲染守卫)
- dsp:
TvBiquad::process的时间用本次调用的下标 ⇒ 分块喂时扫频每次调用从头开始,0.5s 扫频变 2.7ms。修成cursor + i(cursor原来只写不读)。判据三层:症状(尾段保留 84.65% 该砍光)+ 逐样本相等(128/100 两个块长)+ 空折线也算时间;5 个变异全红。 - 音景:首发点缀锚在 0 秒 ⇒ 宿主时钟不从 0 起时全层同时叫。改成锚到第一次
tick,随机流消耗次数不变所以撒点序列不变;3 个变异全红。 - 九宫格:判“最外沿”用列/行序号 ⇒ 没切的那一边永远拿不到内缩,
NineEdges::default()下默认Inset完全不起作用(只在贴一张图时最该起作用)。判据 + 真 GPU 跑 P4 自检 PASS。 - 裁剪:NaN 守卫只查尺寸,位置 NaN 同样能把 uv 算成 NaN(注释描述的灾难没变,只换入口);顺手给“尺寸那一半”补上从来没了的判据。
- 越界:
crates/me-atlas/**属 A3,我连着改了两笔 ⇒ CI 唯一红灯。不回退,按规矩登记cross-sector.txt代修(复核 A3 / 到期 2026-11-10),并把 20 处协商共享路径一次报备完。 - 推翻两条旧信念:①“me-audio 的改动都进 wasm”不成立(只有导出入口可达的才进);②判据绿 ≠ 那条路对(只有一种调用方式时)。
- CI 全绿:第八轮跑了四次 314/176/386/429s,差异全来自机器负载,不是优化。61 笔领先
origin/main。
- dsp:
第四轮收尾:Studio 视口闭环打通(点中 → 拖 → 改)
- 归属表:
DrawList加第二条并行数组owners(UNOWNED = u32::MAX,不进批次键)。不能用push_attributed—— 那个节点号是批次键的一部分,按实体归因会让同贴图的 400 个精灵断成 400 批。 - 撤回一个假缺口:第三轮记的「震屏会连带改剔除」不存在。
Game::step先feel.present(cam)再把同一份交给View,剔除与投影本来就是同一个相机。两种「修法」都不必做,改成一条判据钉住。 - 拖动:新增
me_runtime::gizmo,屏幕位移 → 只改pos的补丁。锚点法(origin + (pointer - pointer0)/zoom),缩放锁定在起手那一刻。 - 闭环判据:点中 → 拿 node → 拖 → 下一帧在新位置点中的还是同一个节点。
- 判据账:三条新模块共 3+3 / 1 / 14+1 条,反向验证 4 + 1 + 5 条全红。
- 教训:判据没红的第四种形态 —— 我把「累加会累积误差」写成了事实,而纯算术的逐步累加是望远镜式抵消的,常规量级下与锚点法逐位相同。判据测不出的性质,不许在文档里说。
- CI 全绿(167~292s,2 项已知降级),
agent/A2领先 main 21 笔。
- 归属表:
压力关第一次上真机:揪出「整页中文变白块」,并拿到真实的 draw call 代价
- 白块的根因在压力关自己:
StressScene::new忘了上传字体图集,而TextStyle的默认纹理号是0(游戏把图集传到 0,压力关的精灵从 100 起)⇒ 800 个字形矩形全部采样到一张不存在的贴图,GPU 给纯白。数字全对(批次 401 / 顶点 4800 / 字形 800),所以 8 条数字判据一条都没红;第一张肉眼截图恰好在「纯静态」档(无文字)。 - 修法与判据:显式
TEX_FONT+ 建场景时上传 + 标签TextStyle写明纹理号;新增 2 条判据(图集尺寸必须落在 sink 里 / 每条标签的纹理必须已登记),反向验证去掉上传即红。 - 真机代价(TCL / MT5879 / 1920×1080):3000 精灵时六纹理档 3001 批 → cpu p50 24ms、帧间隔 33.3ms、36.9fps;同一画面单图集 2 批 → 15.4ms / 52fps,批优先 7 批 → 14.3ms / 53.9fps,纯静态 1 批 → 7.9ms / 61fps。3001 次 draw call 比 7 次多花约 9ms/帧,且是四档里唯一掉出 60fps 的。
- 真机没有 CDP ⇒ 压力页加了
?auto=1自跑自报(逐格 POST 到 serve.py 的/verdict),并写了run-phone.sh一键跑。路上踩到:why字段被截 64 字符(四档拼一行必丢后两档)、am start -d url在浏览器进程活着时会把 URL 丢掉(Status: ok照样返回)、设备护眼卫士连续 20 分钟弹全屏遮罩。 - 未完成:小米那台锁屏,PIN 不在手上,手机侧数据待补;三档精灵数全扫被遮罩打断,数据分两次采集。
- 白块的根因在压力关自己:
补上版本控制:此前两周一直不是 git 仓库
- 项目从 10-15 起就一直不是 git 仓库。能跑、能部署,但没有任何「什么时候改了什么」的证据
- 补上时第一件事不是
git add .,而是先把排除规则写对:运行数据、数据库与 WAL、哈希盐、环境变量、日志全部排除 - 排除规则里最容易被漏的是备份目录:
data.bak-*这种名字不被data/规则覆盖,一不留神就把 7MB 演示数据悄无声息地收进仓库。第一次提交前逐条核对过一遍,确认没有库文件 / 密钥 / 依赖目录 - 因为补得晚,五笔提交全落在同一天,但实际开发跳了 13 天。这种「时间线失真」是无法事后修的 —— 能记录真实日期的地方是开发日记,不是提交时间
- 一个反思:版本控制不该等到「要交付了」才补。在它不是 git 仓库的那两周里,任何一次改坏都没有回退点,只是恰巧没出事
页面停留改用独立细桶:一把尺子量不了两种东西
- 现象:页面停留的 P50 恒等于 P90,每一行都是同一个数
- 根因:页面停留复用了会话时长的分桶。会话时长跨 5 秒到几十分钟,桶在 0~60 秒内只有 3 格;而页面停留集中在 0.3~60 秒,两个分位数直接落进同一格,取到同一个代表值
- 这不是算错,是尺子不对。改成给页面停留单独一套 8 格细桶后,分位数立刻分开
- 同时拆了会话桶的尾部:原来的「10 分钟以上」是个巨桶,会吞掉一切,导致 P75 与 P90 也常常相等
- 一个时机判断:现在是改桶边界的唯一窗口期。桶名是字符串存在表里的,线上还没有新口径数据时改边界零迁移成本;一旦积累几个月真实数据,就得处理新旧两套桶名混在同一张表里
- 演示数据也一并修了:原先所有页面共用一个均匀分布,导致每页停留一模一样。改成每页一个中位数 + 对数正态抽样 —— 真实停留是右偏的,少数长尾拉长平均,中位数才是那个「一般情况」
- 结论:分位数用直方图近似是省存储的正确做法,但「一套桶到处用」是错的。桶边界必须贴着每个指标的真实分布分别设计
多端不做 N 个 SDK,做一个协议 + N 个薄适配层
- 需要覆盖 Web、小程序、App、电视四类端。直觉是各写一个 SDK,但那是四条互相不知道对方存在的时间线
- 四份实现(JavaScript / Kotlin / Swift / Dart)迟早会在派生字段上漂移。最先出事的会是「会话累计时长」这种要计算的字段:一份从页面进入算、一份从会话开始算,两套口径就永久分叉了,而且没人会发现 —— 看板上只是两个数不一样
- 唯一有效的防线是契约测试:一套共享的 JSON 用例,每个实现都必须逐字节通过。原生实现只要写几十行执行器就能跑同一批
- 基线用「改造前的 Web 行为」生成,改造后逐字节一致 —— 这才证明重构没有改变任何现有行为,而不是「我觉得没改」
- 核心层同时做了能力化:必需接口 13 个,其余能力自动探测,缺能力只少一个字段而不是抛错。否则原生端要写一堆空实现,漏一个就崩
- 另一层设计:平台差异不在「怎么发 HTTP」,而在「什么算一次会话」。电视上一集剧 45 分钟,沿用 30 分钟超时会把一集切成两段,会话数直接翻倍、平均时长对半砍 —— 这种错在报表上看起来完全正常。所以会话超时、最短停留、离线队列都按平台分档,写进协议而不是写死成全局常量
- 电视端目前不做:没有真实项目,做出来就是没验证的代码,等真有项目时需求一定会变。协议里已预留客户端枚举和阈值覆盖,将来只需「写一个适配层」,不必「改协议」
- 服务端同步补了三个接收口径:客户端名归一化(多端一并入必然出现各种写法,不归一按端分组会碎成十几个桶)、设备维度允许自报(原生端没有 UA,否则设备分布图只能看见 Web)、协议版本收下并做版本自检(用来发现「某个端静默跑着半年前的老 SDK」)
生产迁移上线:v0.1 老库升级到 v0.3,历史数据全量重放
- 起点:生产库还是 v0.1 结构,19,878 条事件(10-09 到 10-15),只有页面浏览与离开两种事件,其中 1,771 条明文用户标识、19,878 条明文 UA
- 迁移顺序:备份(含 WAL checkpoint)→ 传代码 → 停服 → 按新口径从原始事件全量重放聚合 → 清明文字段 → 隐私门禁复验 → 启动
- 重建正确性不能靠感觉:先在本地用同一份数据重建一次,比对前后页面浏览数 / 会话数 / 访客数 / 停留桶计数完全一致,才敲在生产上跑
- 重放后「时长」有 3,938 个会话样本,页面停留 P50 45 秒、P90 120 秒 —— 两个分位数分开,说明细粒度桶在真实历史数据上真的生效了
- 上线后用真实浏览器逐页人眼复核,四个新模块的历史数据表现符合预期,无报错、无 NaN
- 一条提醒:迁移后看默认 7 天区间是空的,属正常 —— 真实数据在 10-09 到 10-15,要看就得手动改区间
- 根本判断:预聚合的真身是原始事件,所以可以「清空重算」而不是「增量兼容」—— 这比写两套兼容代码便宜得多
老库升级时 DDL 顺序错了,会让整批事件静默丢失(P0)
- 现象:生产启动日志里只有一行「存储域预热失败(将退回懒加载)」,很容易当成噪音跳过
- 实际后果:建表和建索引写在同一段 DDL 里,而「表已存在就跳过」这句话不会给已存在的表补列。老库的事件表没有新加的列,于是执行到建索引那行报「列不存在」,整段中断 —— 后面的补列一次都没跑,写入语句也建不出来,该月所有事件静默丢失
- 之所以一直没暴露,是因为站点还没真正嵌入 SDK,没触发过写入。一旦接入第一个站,第一颗真实埋点就会撞上
- 修法:DDL 拆两段,顺序固定为 建表 → 补列 → 建索引。索引创建是幂等的,每次启动重建代价可忽略
- 验证走生产库冷拷贝:修前预热报错,修后预热 24.4ms 通过,事件表自动补出 7 个列、索引建成、写入与聚合都正确
- 教训:这类错误不报错、不崩溃、不留痕,只在日志里留一行可以被忽略的失败。凡是「静默降级」的日志都该被当成 P0 排查,而不是优雅的兜底
- 同一类问题的另一面:懒加载看着更稳(启动不报错),实际只是把错误推到了第一个真实请求上,而那时候已经有人在线上了
一次页面离开产生 3 条 page_leave,停留时长虚高 3 倍
- 用真实浏览器实测:1 个 page_view 对应 3 个 page_leave,时长分别 2466 / 2482 / 2482ms
- 原因:Web 端同时监听了 pagehide、beforeunload、visibilitychange 三个事件,关页面时三个连续触发同一个回调,而结算函数没有幂等保护
- 后果比数字难看:页面停留样本量、会话时长、停留直方图的计数全部虚高 3 倍。这种错不报错、不崩溃,报表看起来完全正常,只是每个数都错了
- 修法:幂等锁加在核心层而不是适配层 —— 因为原生端有一模一样的问题(Android 的 onPause + onStop、iOS 的 viewWillDisappear + didEnterBackground 都是连续两个回调),一处修全部端
- 一个细节:短停留(低于最短停留阈值)既不结算也不上锁,留给下一次离开机会 —— 用户可能只是短暂切到后台又回来
- 修完复验:1 个 page_view → 1 个 page_leave
- 这类 bug 的特点:不会有人报障,因为界面全部正常,只是分母比分子胖了三倍
沉默页面必须双层数据源 —— 无人问津的页面在埋点里根本不存在
- 直觉做法是「查一下哪些页面很久没有访问记录」。这只覆盖了一半
- 它能找到的是「曾经活过、现在死了」的页面:这些页面留下过数据,所以能上榜单
- 但「上线之后一次都没人访问」的页面在埋点里连一条记录都没有 —— 它不会出现在任何榜单上,也就永远不会被发现该下线。这恰恰是最该下线的那些
- 解法:除被动埋点外,再开一条主动通道,由站点上报自己有哪些页面。两路交叉比对:清单里有、埋点里没有 = 上线即无人问津
- 附带一条必须显性化的结论:如果站点根本没上报清单,覆盖度就是 0,此时「沉默为零」不是好消息,是「还看不见」。界面上专门留了一块警告说明这件事,而不是让一个漂亮的 0 蒙混过去
- 现状:22 个站一个都没上报清单,所以那块警告一直在亮 —— 这是真的
- 另一条相关设计:功能名不做预登记。埋点随手命名,事后自动归集 + 一键合并同义名,改名不丢历史
M1b:导航按「要回答什么问题」重新分组,补上四个模块
- 导航从 3 个 tab 扩到 7 个,按「要回答什么问题」分三组:概览(总览 / 实时)、分析(流量 / 时长)、治理(沉默资产 / 崩溃 / 功能)
- 使用分析:会话时长分桶直方图 + P50/P75/P90 + 快速退出率 + 深度使用率 + 页面停留榜
- 沉默资产:阈值可调 30/60/90/180/365 天,双路数据源交叉比对
- 崩溃监控:崩溃率趋势双轴图 + 无崩溃率 + 按指纹分组 + 行内展开堆栈
- 功能归集:跨站排行 + 按站点勾选合并同义名 + 一键撤销
- 每个模块都能直接分享链接(hash 路由),不用教人怎么点进去
- 顺手修了一处显示:相邻分位数落进同一个桶时合并成一行(如 P50–P90)并说明「是分布集中,不是算错」。界面摆三个一模一样的数字,用户第一反应是系统坏了
- 折叠处理:沉默资产的覆盖度表默认铺满 19 行「缺失」会把整页占完,改成一行摘要 + 展开按钮
代码推到 Gitee 私有仓库,本地与远端打通
- 仓库:https://gitee.com/(账户)/little-blossom(私有,halley2026 账号下首个仓库)
- 共 4 个提交,远端 master =
ee120e9,211 个文件(App 124 / 设计稿 40 / 官网 17 / 文档 11 / 素材 9 / 工具 4 / 后端 2 / 校验清单 1) - 入库前已确认排除:
dist/*.apk(60.7MB,只留 SHA-256 清单)、server/data.json(线上真实家庭数据)、build/、.dart_tool/ - 凭据:本仓库级别
credential.helper = store --file=(本机路径)(权限 600),git push免输密码 - 踩坑:
(服务器路径)系统级挂了osxkeychain,git 会先问钥匙串 → 弹出授权窗口 → 无人值守时命令直接卡死被杀(exit 137)。修法:本仓库 config 先用credential.helper=空值清空继承链,再加 store,才能免弹窗 - README 补「源码托管」章节(克隆地址 + 为何不含 APK/数据)
2026-10-26
踩坑合集:Gradle 缺 .ok 标记、代理环境变量、UTF-16-LE 搜中文
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
(本机路径)里只有 zip 和解压目录、缺.ok完成标记,Gradle 每次都重新下载 234MB。touch .../gradle-9.3.1-all.zip.ok解决。千万不要把 distributionUrl 换成镜像 —— 目录名是 URL 的哈希,换了等于重新下载。 flutter test/flutter run报 Invalid WebSocket upgrade:本机HTTP_PROXY=127.0.0.1:51582干扰。必须env -u HTTP_PROXY -u HTTPS_PROXY ... NO_PROXY=127.0.0.1。flutter build apk报 Unable to locate a Java Runtime:要显式JAVA_HOME=(服务器路径)。- 无头 Chrome 一启动就 FATAL(GPU process isn't usable):必须
--no-sandbox --disable-gpu --disable-dev-shm-usage。 - release web 包里的中文搜不到:被编译成
\uXXXX转义,直接 grep 中文字符串一定是 0;APK 里libapp.so则是 UTF-16-LE。两者都要编成对应形式再查。 - 设计稿全局样式会泄漏:
a { border-bottom }把侧边导航也画上了下划线,看起来像分隔线错位。 - 8GB M1 同时跑无头浏览器 + web 编译:load average 能上 30,编译从 70s 拖到 5 分钟以上;先关浏览器再编译。
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
v1.2.0 发布:习惯库 19 个推荐习惯 + 两处关键对比度修复
- 版本:v1.2.0+3(Android APK 约 60MB,含 3 个 ABI)。
- 新增:习惯库 19 个推荐习惯,6 个分组:生活自理 / 吃饭 / 学习专注 / 礼貌社交 / 运动睡眠 / 要扣花的事。点一下就加,不用自己写名字。
- 新图标 6 个:洗手泡沫、绘本、打招呼、皮球草地、书包、水杯 —— 同批生成、同套去白底,和原 8 个黏土图标放在一起没有断层。
- 顺带修的对比度:底部标签栏未选中态
#B4C0D2(1.84:1)→inkMute5.64:1;花数字#E05A76(3.56:1)→ 新增令牌flowerInk #B3244A6.43:1,全站 7 处一起换。 - 顺手发现的 bug:习惯编辑弹层直接改的是列表里同一个对象 —— 改到一半点取消也会生效(实测把「无理取闹」1 朵改成 3 朵后取消,列表真变了)。改成传副本、保存才按 id 回写。
- 验证:
flutter analyze干净;flutter test22 项全过(新增 10 项:重名检测、与默认习惯不撞名、图标非空、分组顺序、扣花分组一致、模板转习惯 id 唯一等);无头浏览器真实点击走完“设置 → 每日习惯 → 习惯库 → 加一个 → 回列表能看到”。
四个产品口径:惩罚不进分母、库而非全开、扣花两步走
1)惩罚项不进分母。 首页大数字是「今天已经收到 4 / 7 朵」。分母只算奖励项,被扣的花不扣减这个数字,而是单独一行「⊖ 今天扣掉 1 朵」。
理由:直接减会让 5 岁孩子看到自己的成果倒退,惩罚从教育变成挫败。
2)贴花一步,扣花两步。 点「记一次」先弹确认,按钮上写死数字「确定扣 1 朵」,并明说可以再点一次撤销。加花误点只是多一朵,扣花误点是拿走孩子已经得到的东西。
3)习惯做成「库」,不是全塞进默认列表。 库里 19 个推荐习惯,默认只开 7 个(6 奖励 + 1 扣花)。用户原始需求就写了「每天四五个好习惯」,一次全开等于没有重点。挑的动作本身就是一次家长决策。
4)扣花按钮不用粉底白字。 粉色实心块上白字只有 2.16:1,儿童端等于看不清。一律「浅底深字」(alertSoft / alert = 4.95:1)。
5)老家庭迁移用固定 id。
h_seed_chores_v2/h_seed_tantrum_v2,两台手机各补一次mergeFrom时按 id 去重不会变成两行;迁移标记只落本机,用户手动删掉后不会被加回来。v1.0 全链路:Flutter 客户端 + 自建 Node 同步后端上线
- 需求:5 岁女儿(幼儿园大班)爱睡懒觉、不爱刷牙。首页建档只要名字/年龄/性别;我和老婆两部手机同步;每天 4–5 个好习惯,贴小红花;月度统计换奖励。
- 技术选型:Flutter 单代码库(iOS/Android/Web),
provider+shared_preferences存 JSON 快照(不用 SQLite,避免平台差异);后端自写 零依赖 Node(一个 server.js + data.json),pm2 + nginx + certbot 部署到 (服务器IP)。 - 为什么不用托管云服务:官方云服务 SDK 只有 JS,Dart 直接请求
/.cloud/**属违规用法 —— 换成自建后端反而更简单可维护。 - 美术:内置生图工具出图(黏土质感、马卡龙色),本地 Pillow 做去白底 + 切图 + 缩放到 256px。去白底的坑:floodfill 后强制 alpha=255 会把吉祥物变成黑方块 —— 必须真算 alpha 通道再从四角验证 alpha==0。
- 验收方式:不用“看起来对”,而是 Flutter Web + 无头 Chromium + CDP 脚本真实点击截图(tools/cdp.js),逐页查溢出、截图、读文案。
电视端落地:LEANBACK 入口 + 遥控器焦点界面 + 收完直接播放
- 背景:国产 Android 电视。现有 APK 能装但等于打不开:只有 LAUNCHER 入口(桌面不显示图标)、0 处 FocusNode / onKeyEvent(遥控器点不动)、0 处响应式断点。
- 方案:不动手机端页面,另建一套电视界面,main.dart 按
TvMode.isTv分流;手机/桌面继续走原来的 _MainNavigation。 - 入口与判定:Manifest 加 LEANBACK_LAUNCHER + 三档 banner + touchscreen/leanback required=false(aapt2 已验两个 launchable 都在);判定读 UiModeManager.currentModeType,不用机型白名单,异常一律当「非电视」——手机被误判就完全不能用。
- 遥控器两个坑:Flutter 默认不认 DPAD_CENTER 且各家 ROM 键值不一(select / enter / gameButtonA)→ 五种键统一映射 ActivateIntent;
onShowFocusHighlight只在键盘高亮模式触发,页面刚开是 touch 模式 → 焦点框不显示,改用onFocusChange。 - 🔴 第三个坑(收到的视频放不了):
_saveMediaToGalleryIfNeeded存相册后删临时副本,而播放页正是读这个路径;且电视没有相册 App。处理:电视跳过入相册 + 不设 mediaStagingDir,媒体直接落 downloadDir。 - 验证与配套:analyze 0 error;flutter test 162 项全过(新增 tv_mode 4 + tv_focusable 6);APK 40.9MB。
--dart-define=FB_FORCE_TV=true桌面预览;tool/preview用 golden 渲图自检(需手动加载中文字体 + MaterialIcons,否则全是方框)。 - 待真机验收:桌面图标可见、遥控器能聚焦能点、收完能播放、手机装 +25 不会误入电视界面。
上线应用内更新 + 40 分钟提醒,三端同时发版(1.9.9 / 1.1.0 / 1.1.1)
- 守护端 1.9.9:新增应用内更新 —— 心跳里已经带着
latestFw/apkUrl/apkSha,点提示条即下载(带百分比进度),校验 SHA256 后通过自写的ApkProvider(content://,不引 androidx)拉起系统安装器;没允许「安装未知应用」时引导到设置页;装完MY_PACKAGE_REPLACED把状态页重新拉到前台。真机验证 1.9.7 → 1.9.8 → 1.9.9 两次升级均成功,且无障碍服务不会掉(以前掉的场景其实是pm uninstall+ 重装换签名)。 - 服务端 1.1.1:新增
notices(家长提醒)数据与/api/v1/notices、/api/v1/notices/read;sync里按当日累计 40 分钟(policy.alert_min)分桶生成「小朋友还在看电视」,40/80/120 分钟各一条,key 带日期自然重置;注销账号时一并清理。syncPayload增补apkSha。 - 家长端网页:顶部铃铛 + 未读红点 + 最新一条黄色横幅 + 提醒弹层(打开即已读);登录/退出时通过
window.GuardNative.onToken把 token 交给原生外壳。 - 家长端 App 1.1.0:
NoticeService前台服务每 60 秒轮询提醒,有新提醒发系统通知(Android 13 通知权限),token 失效自动停服务。 - 电视端观感:标题左侧加图标、左列四张卡用
weight与右列底边像素级对齐、删掉「未连接 · 正在连接…」红字(只看右上角 WiFi 图标)、顶部与底部留白重调。 - 踩坑记录:这台 TCL
wm density是 240(hdpi),1dp = 1.5px,之前按 mdpi 量的尺寸要 ×1.5 才对得上截图。
- 守护端 1.9.9:新增应用内更新 —— 心跳里已经带着
坦克大战的图集与渲染层 —— 现在能把一帧画成 PNG,不需要窗口
- 图集是纯代码画的:8×8 / 16×16 硬边色块,一张外部素材都没有。不是「美术排队先凑合」——这种图用代码画比画笔准,而且可判据(判据能问「炮管在上半部有几个像素」,PNG 不行)。附带好处:不受
library/art队列阻塞。 - 渲染层输出纯数据:
render::scene()把Sim翻成Vec<Cmd>(位置/尺寸/uv/乘色/图层),不依赖 ECS 也不依赖 GPU。于是整套画面能在没有窗口的条件下验证。 - 同一个文件里有个 CPU 软光栅化器(
rasterize),它在产品代码里而非测试里,因为三处都走它:判据、离线截图、以及与真机 GPU 的对照(两条路共用一份Cmd,不一致就说明问题在批渲染)。 - 三处只有看图才发现的错(改到第五版才对):① 老鹰是个蘑菇 —— 翅膀宽度逐行线性张开,画出来是等腰三角形、顶点被头盖住 ⇒ 改成「先张后收」;② 坦克是一根火柴 —— 描边取 42,乘上玩家黄 tint 后变成 15,比战场底色 24 还暗,描边等于不存在 ⇒ 改 86,落在「背景24/描边86/车体172/炮塔255」四层里;③ 水是蓝色砖堆 —— 波纹密度 30% 且每格两道横线、格与格正好对齐 ⇒ 改斜向稀疏(
(x+3y)%16<3,19%),格之间对不齐才像水。 - 15 条判据,6 条反验真红。最有价值的是「树压在坦克上面」那条:把
LAYER_FOREST调到 1,结果是图层判据 + 像素判据同时红 —— 说明像素那条不是靠图层判据吃饭,它自己走完了采样→排序→混合整条链。 - 顺手修的数据问题:三关玩家出生点都在第 0 列(贴左边界,16×16 的车有一半压在画面边缘),挪到第 2 列。
- 一处流程问题:上午请 A1 登记
apps/tank-battle/那次只写进了Team/notes/A2.md(流水),板子上没条目 = 等于没问**。补成 N-216 并--fmt重算汇总表。 - 规模:38 条判据(规则 23 + 渲染 15),workspace 1750 passed;wasm +0 字节(
tank没被 wasm 引用,dead code 全摇掉);CI 224s · 2 降级。提交d38de1a。 - 看画面:
cargo run -p me-runtime --example tank_png -- atlas(图集总览)/-- 1 300(战场)。两个视角都要用 —— 水在图集里看像波纹,铺到 26×26 才看出是砖。 - 仍缺宿主:
apps/tank-battle/未登记(球在 A1);apps/macos-demo/是 A3 共享路径,接窗口要报备。
- 图集是纯代码画的:8×8 / 16×16 硬边色块,一张外部素材都没有。不是「美术排队先凑合」——这种图用代码画比画笔准,而且可判据(判据能问「炮管在上半部有几个像素」,PNG 不行)。附带好处:不受
新游戏:坦克大战的规则层 —— 俯视、无重力、砖两发一块
- 选题:飞哥从 GitHub 候选里挑了坦克大战(Battle City 一类)。参考
feichao93/battle-city(MIT),只借规则与关卡布局思路,美术/数据/代码全自产。 - 为什么是它:coin-run 是横版重力;这一款换掉俯视无重力、地形可破坏、敌人换向打墙、弹道可对撞、字符网格关卡五样,共用 ECS/批渲染/混音器/输入。能跑通横版跳跃,只能说明能跑横版跳跃。
- 落点:
crates/me-runtime/src/tank/{mod,stage,logic}.rs+stages/tank-1..3.stage+ 23 条判据。提交dbc4f62/a2dbcdb。 - 三个设计决定:① 格盘 26×26 个 8 像素格(不是 13×13 个块)⇒ 砖才能两发一块、一发掉半块;② “挡坦克”与“挡炮弹”是两张表,合成一个
solid()水就变砖;③ 全整数,同一段输入跑两遍逐位相同。 - 四处踩到的:炮弹对撞不能用纯 AABB(4px 炮弹每步 4px,一步位移=自身宽度,迎面两发整步互穿);弹头出界撞上
get的越界默认值(钢板)⇒ 没钢板的图报 5 次打钢;关卡只护老鹰头顶、侧面空着 ⇒ 敌人贴侧面打穿,三关全这么输;两条判据是假绿,已改成峰值 + 总开炮数。 - 能看:
cargo run -p me-runtime --example tank_ascii -- 1 120。里面的守卫三关都会输,留着是为了反过来用——它突然赢了就说明敌人 AI 坏了。 - 下一步:渲染层 + 宿主
apps/tank-battle/(需 A1 登记扇区,已发 ask)。workspace 1735 passed,wasm +0 字节。
- 选题:飞哥从 GitHub 候选里挑了坦克大战(Battle City 一类)。参考
定位音效的时长在混音器里被写死成 0 —— 每发都永久占着槽位
- 症状:玩一会儿之后定位音效全没了,日志里一个错都没有。
- 根因:
Mixer::play_spatial的签名里没有时长,函数体填duration_ms: 0;而0在这层的语义是「永不过期」(循环语音的语义)。实测(容量 2)播两发、tick(600_000)之后active()仍是 2,十分钟一条没释放;槽位满后新语音被PoolFull静默拒绝。 - 为什么要记:同一个坑在包装层
AudioSystem::play_at已经踩过并修过,机制层没跟着修 —— 两层各写一遍同样的逻辑,于是可以各错一次。 - 改法:
play_spatial收整条PlayRequest(而不是补第八个参数)。pan被覆盖(方位只有一套)、gain被乘上衰减(「半音量的远处声音」)。play_at退化成装请求 + 转发,spatialize全工程只剩一处调用。 - 判据(都反向验过):容量 2 播两发 100ms →
tick(1000)后active()==0,再播两发仍成功且rejected()==0(后半段抓「标成结束但没把槽位放回空闲链」);贴耳处(left,right)==(500‰,500‰)且请求里的Pan::RIGHT被位置覆盖,左侧 300px 处left>right且left<500‰。改回写死 0 ⇒ 红left: 2;不覆盖 pan ⇒ 红(0,500‰);把 gain 覆盖成衰减 ⇒ 红(1000‰,1000‰)。 - 一处 rustdoc 断链:
mixer.rs引用crate::AudioSystem::play_at,而me-audio里没有AudioSystem(在me-runtime,方向相反不能互依),-D warnings下会把 CI 文档检查打红 ⇒ 改成普通行内代码。 - 验收:wasm 732.2 KB(余量 67.8 KB),三份副本 md5 一致;工作区 1712 passed(+2);CI 通过 208s · 2 项降级。提交
cc0fa05,只在agent/A2。
汉字点阵的「扫哪些文件」自己也会过期 —— 新加模块就静默漏扫
- 症状:在
coin_run/下新加一个模块、里面写一句上屏中文 ⇒ 那几个字不进点阵(屏幕上豆腐块),而--check照样绿:它比的是「生成物 vs 那三次固定扫描的结果」,两边都不知道新文件的存在。 - 改法:扫范围从「三份写死的文件」改成「一个目录」:
SCOPE_GLOB = crates/me-runtime/src/coin_run/*.rs,目录里每个文件必须在SCAN(上屏)或NOT_ON_SCREEN(不上屏,必须写一句理由)之一,否则生成器直接失败。另一条报错管「名单里的文件已不存在」——否则--check会对着一个幽灵文件永久绿着。 - 为什么不全扫:量过,
crates/*/src/里含中文的字符串字面量横跨 100 个**文件(me-cli/me-mir/me-studio/me-rhi的报错与panic!全在里面),四千字上下。全扫会让点阵从 569 字涨到四千多,wasm 多背约 120 KB,而那些字一个都不会上屏。 - 反向验过两条:造一个
hud.rs⇒ 点名它、exit 1;把copy.rs改名 ⇒ 点名「已不存在」。 - 提交
b9ee5c8。
- 症状:在
跨两个命令的验收补上了:me pack 的账 == 运行时解出的条目数
- 背景:
N-210里我说过「跳命令那条验收只做得到一半」,因为dist/里没有.bin(me pack的接线在 A3,N-039)。那个单落地后这条路通了,补上。 - 判据:
me pack打真工程 → 账本content[0].draws→ 同一个dist里的content/scenes/main.bin用LoadedScene::from_cooked解 → 条目数必须相等。两个数字来自两条独立的路(编译链 /me-cooked::decode)。 - 两份内容而不是一个数:
sprite_scene(4 条 / 3 资产)与layer_stack_scene(9 条 / 1 资产),最后用assert_ne!钉住「两份必须不同」——否则哪天失去区分力还会继续绿。 - 反向验过两条:两份都用
sprite_scene⇒ 红在[4, 4];产物削一个字节 ⇒Truncated { at: 249, need: 4, left: 3 }。 - 两个取舍:①
me路径按 cargo 规则从current_exe推(CARGO_BIN_EXE_me只给定义 bin 的包,即 A3 的me-cli);② 测试里不跑cargo build(执行期抢构建锁 = 自己锁自己,表现为卡住而报错为空)。找不到me时跳过并说明,CI 跑--workspace时 bins 一定会被构建。 - 踩到的红:
check_workspace不许测试里出现cfg!(windows)(平台差异只允许在 pal 层)⇒ 去掉。 - 数字:工作区 1710 passed(+1);CI 通过 125s · 2 项降级。提交
56707bc。
- 背景:
金币声整关只有头 600 像素能听见 —— 听者从没被设置过
- 症状:第 1 关宽 7040 像素,金币声只有头六枚有声,其余七十几枚完全静音。玩家不会说「静音」,会说「这游戏声音怪怪的」。
- 根因:定位音效的衰减相对听者算,而
AudioSystem的听者从构造起就钉在世界原点(0,0)—— 全工程没有一处调set_listener。于是「金币在玩家身上」被算成「金币在世界原点上」,spatialize在距离超过max_distance(600) 时返回Gain::ZERO。 - 实测(修前):金币 x=40 → 551‰;x=670 / 1812 / 3992 / 6760 → 全是 0‰。
- 为什么测试一直绿:
every_coin_makes_exactly_one_sound数的是plays_of(SFX_COIN),那是「我们请求了一声」,不是「玩家听见了一声」。中间隔着增益,而增益可以是 0。 - 修法:
dispatch_audio每帧把听者设到玩家中心,金币声源用同一个点(两处各取一次会得到十几像素差,让每枚金币恒定压低几十‰ 并向左偏)。 - 顺手收掉一处分叉:八段音效合成一张表
sfx_for。原来只有金币挂在sfx总线上,另外七段直连MASTER—— 「音乐与音效分开压」的设计只对金币生效。七行照抄的分叉,单看每行都合理。 - 判据两条,都反向验过:①
a_coin_is_heard_all_the_way_to_the_end_of_the_level:去掉set_listener⇒ 四处实测 0‰、红。②every_sfx_goes_through_the_sfx_bus:跑完整关 + 撞障碍 + 按技能,八段都得响且都得等于 sfx 总线链;先校验两条总线增益不相等(否则没区分力)。让非定位音效直连 MASTER ⇒ 七段 1000‰、红。期望值从混音器读、不写死 800。 - 假红一条:把玩家瞬移到尖刺中心不触发受伤(危险判定看接触那一步的相对运动,瞬移没有速度)⇒ 走真路(一路向右不跳)。
- 数字:wasm 732.3 → 732.1 KB(预算 800);工作区 1709 passed(+2);CI 通过 188s · 2 项降级(都不是这一笔引入的);三份副本 md5 一致。
- 提交
49312fd,已 push 到origin/agent/A2。
高刷屏上按一下跳会被丢掉:按下边缘在帧层产生,却在步层消失
手机上一半的跳没反应,而电脑上永远复现不出来。根因两条拼起来:① 144Hz 一帧 6.94ms、固定步 16.67ms ⇒ 三帧才跑一步(time.rs 的 advance 自己写着「返回 0 是正常的」);② PadState::jump_pressed 是单帧边缘,只在「这一帧按着、上一帧没按」那帧为真。于是按键落在没跑固定步的那一帧上就静默消失,而它落在哪种帧上取决于按下的时刻 —— 也就是随机。
判据按帧相位扫三遍(只测一遍会有一半概率绿着放行):改前相位 0、1 都丢,改后三遍全跳。
修法的关键是装填位置:窗口在 Input 阶段(帧层)写进 Sim.jump_buffer,在 fixed_step(步层)兑现与递减。在 fixed_step 里装填等于没修 —— 跑 0 步的那一帧没人看 intent.jump,下一帧它就被新的 PadState 覆盖成假了。
技能同一个病,但只给 2 步(33ms):跳跃那 8 步里有一半是手感,而技能在冷却里按的键刻意不兑现(否则「掐冷却」从玩家的操作变成引擎的承诺)。
顺带加了 6 步土狼时间(100ms)。上限由关卡自己给:从 44 的台阶掉下去要 13 步,宽限必须明显短于它,否则修掉一个不一致又造出「掉到半空还能原地起跳」。起跳时当场清掉计数器 —— 不清就是二段跳,判据实测会升 78.1 像素(单跳 56.7)。
六条判据全部反向验过,窗口长度连同常量一起钉住(只钉「实测 == 常量」的话,把两边同时改成 1 也能绿)。
顺手记两个假红:place_player 不动物理体的 on_ground(先判后走会让「落地前 N 步」变成「站着按跳」,rise 恒为 0);以及 wait=0 时量「落地后升了多少像素」恒为 0 —— 那时人已经站住了,第一次看到 grounded 发生在跳完之后。改成量「曾经站住、后来又离地」两种情况都对得上。
数字:wasm 732.2 → 732.3 KB(+134 字节,余量 67.7 KB);me-runtime 431 passed(+7);workspace 1707 passed;十二关机器人全通且逐关币数与改前逐项相同;离屏判据 72/72、SWITCH 12/12;CI 通过 119s · 2 项降级。
看板重核:10 处失真已修,其中一处是我自己刚犯的 —— 分支的工程量不是发布基线
用户让「更新一下项目看板和项目管理平台」。云端的 49 号项目板是手工同步的(它自己第 ⑩ 条就写着「腐坏时不报错」),所以这次先量后改。
第一版改错了,值得原样记下来:我按工作区(A2 分支)跑 --scale 读出「743 个文件 / 218,103 行 / 47 完成」,就照这个数写进了 description 与 notes。写完之后
git fetch origin main—— main 已经到 53 完成 / 46%,同一句 --scale 在 main 上是 747 / 216,978。差 3.9 万行不是谁算错了,是 A2 握着 39 笔未合并提交。分支的工程量与完成度都不是发布基线,整段重做。用了git worktree add把 origin/main 检出到临时目录里跑 --scale,这样既不碰工作区,也不用手工 checkout。这次修掉的 10 处(每处都有「旧值 → 新值」):工程量 598/178,031 → 747/216,978(差 3.9 万行 / 149 文件)· crate 15 → 14 · 契约 15 → 16 · docs 37 → 35 篇 · 测试 1464 → 1669(main 侧;A2 当轮 1700,两个口径都写进板上)· CI 降级「4 项」→ 当轮实测 2 项(另两项只在非 Mac 宿主上降级,4 项是跨机器并集)· 进度 182/433·51 任务 → 201/433·53 任务 · extras 52 → 48 · wip 名单整份过期(板上写的 5 条只有 S6-8 还在,实际是 S7-4 / S3-9 / S6-8 / S3-8 / S5-6 / S8-4)· 分支口径从没写过。
顺手补的一条结构性事实:A2 分支上根本生成不出一份合法看板 —— main 版 board.json 里 S1-10 的证据路径
tools/doc/gen_mir_manual.py与 S5-6 的crates/me-cli/tests/provenance_ledger.rs在这条分支上都不存在,拷过来跑 --check 直接红两条。所以「看板页在哪条分支上生成」不是风格问题。仓库侧:
plan/board.json只加了两处(S3-7 的 why 从一句扩成五处取舍 —— 中文 1 位点阵 / 单图集槽位 / 度量必须与真正画的字体一致 / 对白字幕条 16.2:1 / 生成物与 rustfmt 打架;extras 48 → 49 记关卡文本压着进包)。没有提交 site/board/index.html:A2 生成出来是 47 完成,合并时要么冲突要么把 53 退回 47,页面留给合并后在 main 上重建(已在协同区 ask A1)。另一个自找的坑:
say.py --body "…\n…"走 bash 双引号时\n是字面两个字符,argparse 收到不是换行,于是整段挤成一行、还带着字面的 \n。已经用 Python 把那两条流水的正文改成真换行,教训写进记忆:多段正文用 heredoc,不用双引号。数字核对过两遍(
get_project读回:wip 六条编号逐个对、46% = 201/433、747/216,978、1669 测试、extras 48)。点阵收字改成走词法:续行不再静默丢字,代价 8 292 字节
上一笔的包体腾挪收尾后接着查了一个更深的坑:点阵收字的扫描器靠正则猜「哪些字在字符串字面量里」,两处近似都在打这个判断的主意 —— ① 正则里「反斜杠 + 任意字符」在非 DOTALL 下不匹配「反斜杠 + 换行」,于是任何一处续行都让它后面的引号配对整体错位一格,哪些字被收进来变成靠运气(我这次写了一句续行断言消息,点阵从 459 字静默掉到 407 字);② 旧版只丢「整行以斜杠斜杠开头」的行,行尾注释里的字被烘进表(实测 14 个:倾双弓抱拳掌推握横步独立膝马,逐条核过,全部只出现在注释里,一个都不在字面量中)。
改成走一遍 Rust 词法:引号起头就找配对的引号(反斜杠连下一个字符一起吃掉,续行就这样被消化),行注释到行尾、块注释整块跳过。注释的判定变成「在不在字面量里」,不再有两种互相矛盾的近似。
成本:+8 292 字节,wasm 724.1 → 732.2 KB,余量 75.9 → 67.8 KB。569 字(原 465):多烘 118 个(几乎全是测试断言的消息,永不上屏)、少收 14 个注释字。不省这 8 KB 是有意的 —— 要省就得让扫描器区分测试模块与生产代码,切错了是静默漏字,等于拿字节换一种新的静默失败。
顺手纠正半个自己的判断:原以为 BakeReport.missing 没人断言是个缺口,查下去发现它是「恒为 0」——建局时把整个 GLYPHS 表喂给烘图集,missing 在数学上永远是 0,加断言只能测出「表为空」,是装饰。真正的残留风险只有一条:上屏中文若写在扫描列表之外的新模块里,字永远进不了表,而生成物自检也不会红(它只比「表与那三份源是否同步」)。修法是让扫描列表变 glob,代价多烘一批错误消息里的字(估 8~16 KB),余量刚花掉 8 KB,先记着不动。
数字:me-render 206 passed · me-runtime 424 passed · 离屏判据全绿(SWITCH 12/12,逐关币数与改前一致)· CI 通过 250s · 2 项降级。
包体腾挪:关卡文本压着进包,wasm 769.9 → 724.1 KB,余量 30.1 → 75.9 KB
接完武侠图集后 wasm 只剩 30.1 KB,而下一批素材(怪/道具/存档点/弹丸)估 46.5 KB —— 一接就撞线。先量了字节花在哪:data 62.1%、code 37.4%;data 里三张 .rgba.z 占 353 394,那三张已经压过了,deflate 在 36 351 种颜色的背景上就是 2~3 倍,到顶了。
试过两条「免费的」路,都是白忙:
- 每行按 PNG 启发式挑过滤器(不再一律 Sub):三张合计只省 1.9 KB,世界图集反而 +1 629 字节 —— 启发式优化熵,deflate 抓重复;
- alpha=0 处藏着的 RGB 抹零:透明像素占 39.7%,但 RGB 非零的只有 1.7%,只省 197 字节。
真正压得动的是文本:十二关 .lvl 原文 56 899 字节,是包里唯一没压过的东西。
levels/pack.py把它们首尾相接 deflate 一袋(MLV1 + 关数 + 每关原始长 + 一个 zlib 流),56 899 → 8 626。一个流而不是十二个:整袋 8 572 vs 逐关 23 907,因为字段名/缩进/注释用词高度重复。保留注释(不剥):删了只多省 3 KB,但那样「包是不是最新」就只能靠两套剥注释逻辑互相对齐来证明。留着原文的收益是判据能写成最硬的那种 ——
the_packed_levels_are_byte_identical_to_the_sources拿包里解出来的字节与include_str!原文逐字节比。反向验过:给第 1 关加一行注释不重打包 ⇒ 当场红(56899 vs 56939),改回复绿。顺手踩到的坑:
gen_hanzi.py收字正则不认反斜杠续行(非 DOTALL 下\\.匹配不了「反斜杠+换行」),任何一处续行字面量都会让后面引号配对错位一格。我在断言里写了句续行消息,点阵从 459 字静默掉到 407 字(金币/存档/尖刺/巡逻那批被当成「文案里没有了」删掉)。改单行后恢复 465 字。正确修法(正则加 re.S)会连带把测试夹具的字收进表,另排一笔做。数字:wasm -46 944 字节(余量 30.1 → 75.9 KB,已用 90.5%);data 489 242 → 441 177;code +632(解包与断言)。CI 通过 265s · 2 项降级;me-runtime 424 passed;十二关机器人全通,逐关 coin 数与改前一致(84/96/101/…/172)⇒ 解析结果没变;build.sh --check --browser 72/72、SWITCH 12/12;三份 wasm 副本 md5 一致。
coin-run 换成武侠皮:改名「铜钱江湖」、界面说中文、跑动中有对白
- 改名:
copy.rs成了文案唯一来源 —— 游戏名「铜钱江湖」、十二个中文关名、角色 疾风/铁山、技能 疾行/撼地。画布、宿主面板、官网可试玩页三处一起改(外壳原来是 SWIFT/DASH,同一屏两个名字)。 - 汉字点阵:
tools/gen_hanzi.py用系统 STHeiti 把文案里出现过的字烘成 16×16 1 位点阵(459 字 / 62.7 KB 源码)。8 位要多 8 倍,这是「放得进 800 KB」与「放不进」的差别。生成器--check进 CI:改了文案忘了重新生成,屏幕上是豆腐块。 - 对白:
.lvl里一行talk x 说话人 台词就是一句剧情,十二关共 24 句,一条线「镖银被劫 → 顺着铜钱走 → 终库对上」。跑动中底部弹出,做成字幕条(深底浅字 16.2:1)—— 原来墨字压深色土带只有 3.4:1,而噪声背景上换颜色没有解。 - 三处「排版还按 5×7 算」的残留:技能条压在铜钱数字上;标题页高亮条只包住字的下半截;
check_dump.py的取样带够不着技能条(拉长带子会把场景里的朱砂红山算成 HUD 墨色,结算帧就永远红)。三处都补了判据并反向验证过。 - 真机两路都验了:Metal 离屏
build.sh --check全绿;无头 Chrome 的 wasm/WebGL2 页截图确认画布与外壳都是中文。me-runtime99 条测试通过,CI 绿。 - ⚠️ 包体只剩 30.1 KB(769.9 / 800 KB)。素材那批(怪/道具/存档点/弹丸,估 46.5 KB)装不下,接素材之前要先谈包体。
- 改名:
巡逻怪锚点判据 + 复核对方的取景纠错 + 两轮假红的真因
- 巡逻怪也有锚点判据(反向:纸白 ≤45%)。实测 0.047,左侧对照 1.000(21.3×);怪消失时 0.993 ⇒ 真红。
- 争议点已复核:另一会话指出我的取景框里 43% 是玩家(相机跟玩家 ⇒ 玩家屏幕位置固定),认。但它说「旧取景该红时不红」我量不出来:旧取景怪消失时 0.793,照样红。结论换取景不变,理由改成「判据有一部分在量玩家」。
- 顺手把四条锚点帧全审了:只有巡逻怪那帧被玩家污染过;门那帧两种 warp 下暗占比都是 0.424(玩家被门遮住),尖刺/平台纵向不重叠。
- 今晚两轮假红是我自己造成的:同一棵树上还有另一会话,抢 target/。症状是「红的步骤每次不一样」,认它要看 git status 里有没有不是自己的文件。
- 另一会话正把 SWITCH-MANUAL 降级换成真跑(headless+swiftshader,72/72,6.4s)—— 我当初那条降级理由(沙箱 GPU SIGTRAP)指的是 GUI Chrome,不适用于 headless。
COIN RUN 夜间:5 条新判据 + 20.9KB 余量 + 十二关判据接进 CI
- 三条锚点像素判据(门/尖刺/平台):相机由引擎导出,屏幕=(世界−相机)×4;实测 0.424/0.421/0.173,左侧对照全 0.000。根因是图集为手绘噪声图,按色数像素不可分。
- S0 的 800KB 包体预算终于有判据(此前只是措辞):现 721.5KB,余量 78.5KB。反向验证:预算改 700KB ⇒ 红。
- 背景改 bpp=3 存(129600 个 alpha 全是 255):省 21618 字节,wasm 760153→738772。无损由逐字节对账测试证明。
- 补判据:踩存档点后 respawn_x 真的变(此前零覆盖);没有拾取物被埋在实心几何里(1695 件,0 处可疑)。
- 十二关全量通关此前带 #[ignore]、CI 从不跑:实测 release 仅 1.4s(标注的「半分钟」是 debug),已接进 CI 并打表。
- 订正:字节变而大小不变的真因不是 DWARF,是 panic 的 file:line 表跟着行号位移(16 字节全 +19,那次正好加 19 行)。
「没命中」被读成「不存在」:D-04 的探针写错,结论反了
- 技术债表里
D-04一直挂「待重测」。原因是我 grep 单行找ops.iter().find没命中,据此判成「代码不存在」,还在表里写「Ctx根本没有ops字段」。 - 真实代码是三行写的,且挂在
LegalizeReport(frame.rs:255)不是Ctx。「没命中」被读成「不存在」:git grep逐行匹配而代码是分行写的;当工具表达不了一种形态,人只能用更弱的探针凑,再用弱探针的结果下强结论。 - 修法不是「下次仔细点」,是给工具加那种形态:
check_debt_baseline.py新增第三种探针text(全文正则 +re.S,能跨行匹配;对排版不敏感、对结构敏感)+label字段(报格里印人话而不是正则)。 - 量到的三个数:0.017(小图)/ 0.455(26.8×)/ 48.006ms(105.5×)。真凶是
op_of在Facts::scan的双重循环里逐节点调用,修法是HashMap查表,已提N-310。 - 体检结论也跟着纠正:11 条里 5 条主干真实(
D-04、D-07~D-10)、4 条分支特有、2 已消、「待重测」那格现在是空的。 - 又踩了另一个坑,同一个晚上第二次:变异测试五个全红,但实际是我改出来的代码有
SyntaxError(global BASELINE的位置非法),一次都没跑起来。变异测试自己也要核验「红的原因」——红得对但红错了原因,比不红更危险,因为它给的是「已验证」的错觉。 - 探针的三种形态现在都验过:分行命中、压成单行仍命中、换
HashMap转 absent。成本最高的一条教训写进了plan/debt-baseline.json头部的$comment。
- 技术债表里
符号表判据换成代码段指纹(旧判据会放行错版本),零手写 GLSL 补上全仓守卫
- 符号表版本判据换了。
me sym --map原来只比函数总数。这个洞很危险,因为它绿得让人放心:module字段是文件名、函数总数改一个函数体一个字节都不变,所以贴错版本的表会被放行,然后给出一串看起来正常的错名字——人拿它去改代码,代价比没有符号表高一个数量级。 - 现在记
code: {bytes, fnv1a64},弱(总数)+ 强(代码段指纹)两道并行。用 FNV-1a 64 而不是 sha256:这里要答的是「两次编译字节一样吗」,不是「是否被刻意构造」。 - 实测这条路多容易踩:
[profile.wasm-symbols]只把strip换个写法重编,code 段 218,913 → 218,907 B(差 6 字节),函数个数一条不差、旧检查照样通过。这顺带推翻了一个我以为对的常识:换 profile 名就会让 codegen 变,所以只能走RUSTFLAGS = "-C strip=none"(实测 code 段与线上 sha256 完全相同)。 tools/gen/sym-map.sh第一次真的产出符号表:build/sym/me_runtime.sym.json,1123 条,指纹0x2785a826397d7af3。第三步用自己的指纹去核线上产物,不核过就 exit 1。落点选build/sym/而不是apps/coin-run/wasm/——后者会被me pack打进主包,而.json在上传白名单里,149KB 的表会直接进小游戏。- 实战验证:拿线上 wasm + 这张表,把
wasm-function[900]还原成NullBackend::draw。 - 判据自身也得上牙齿:
test_sym.sh5 → 9 条。第 6~8 条现场合成两个最小模块(import 数、本地函数数、name 段全同,代码段只差最后一个字节)——这个形状真产物给不出来,而要验的正是它。两个变异各验一次:指纹比较恒假 → 只有第 7 条红;拿到警告不发 → 只有第 8 条红。 - 零手写 GLSL 从口号变成了守卫。 A2 那条测试只扫
crates/me-render/src/**/*.rs,而host-wx/render.js里有 5 段手写 GLSL——只在部分范围成立的守卫,和没有守卫的区别只在心理上。新增tools/ci/check_no_shader.py扫全仓 9 种后缀,三条硬规则:清单外红 / 豁免到期红 / 陈旧豁免(写了但已扫不到)红。最后一条最容易被忽略:豁免表会随代码迁移变成一张假条子,而假条子比没有条子更坏。 - 现状 10 处命中 / 9 条豁免(后端自检 5 / 墓碑 2 / 宿主替身+夹具 2)/ 8 项
--self-test/ 6 个手工变异全被抓,又用三处源码变异证明自检有牙。 - 记一个自己踩的坑:第一轮变异五个全红,实际是
global BASELINE位置非法导致的SyntaxError(退出码也是 1),一次都没跑起来。红得对、但红错了原因,比不红更危险——它给的是「已验证」的错觉。 现在变异输出多一列「崩=False」,重跑后每条红的原因都对。
- 符号表版本判据换了。
Gate 0 第一版报 8.3%,真实 36.7%:写防自欺的那一页时先自欺了一次
- 做 Gate 0 六项仪表盘,M2 包体那一项第一版报 349,848 B(8.3%)。读数很漂亮,问题是它是假的。
- 它读的是
dist/pack.json——一份.gitignore的本地生成物,比源码旧两天。重跑me pack后真实值是 1.47MB(36.7%),差 4 倍。 - 难受的一点在哪儿:
pack.json就在磁盘上、schema 对、字段全、解析不报错。它是一条「看起来完全正常」的陈旧数据。CI 不看它,所以它永远不会红。 - 改法不是「下次记得重跑」,是换掉获取方式:现算
me pack <dir> --check --json(零写盘),只在找不到me时才降级读账本,且必须比对 mtime 并在结论里明说「可能过期」。 - 另一条自己定的规矩:不要用自己写的第二份实现去量体积。第一版想过自己 walk 目录加总和——那就是第二份实现,两边差 1KB 时没人分得出谁对(之前已经栽过一次 190 vs 189KB)。调
me pack是复用唯一实现。 - 六项的实际状态(写这一页的收获):2 项通过(包体 7.7% / 零手写 GLSL)、1 项有数但答不了(本机 Iris Xe 核显 p95 0.41ms,达标但机型不是低端安卓 ⇒ 报 unknown 而不是 pass)、3 项缺证据(尚未上线,所以没有真实数据)。四态是刻意的:pass / fail / unknown / gap,后两态都不算通过。
- 仪表盘 恒 exit 0:还没到 W26 就长期红着的门,等于没有门。它只回答「现在有什么数」,不负责拦人。
- 底层那条教训:「缺证据」不允许被折叠成「待定」——Go/No-Go 里没有第三种答案,把 gap 写成「大概没问题」是这个门最容易的作弊方式。
主包 1.47MB 里 71% 是演示页素材,而演示页根本不在包里
- Gate 0 的包体那项一直报「通过,但 71% 是一个演示素材目录」。查到底,结论有点荒唐:页被剔除了,页的素材留在了包里。
- 上传白名单按后缀拦(
.html进不去),所以me pack每次都把wushu.html剔掉并打一条警告;但它引用的wushu/那 1.06MB 序列帧、nav.js按后缀是白名单内的,于是照旧进包——而包里没有任何代码会去读它(读它的那个页面自己没进包)。 - 改法两行:
apps/coin-run/project.config.json的packOptions.ignore加folder wushu+file nav.js。主包 1,539,020 B(36.7%)→ 426,914 B(10.2%),进包文件 18 → 9;装 binaryen 后wasm-opt -Oz真的跑起来,再降到 321,975 B(7.7%)。 - 根因不是粗心,是判据的形状:按后缀的剔除表天生不知道「谁引用谁」。这类残留不会让任何检查变红——包能上传、游戏能跑,只是白背 1MB。以后新增演示页,要连素材一起登记。
- 对外一个页面都没少:可试玩页
web/play/coin-run/只有index.html+wasm/,演示页从来不在它里面(本地serve.sh直接读源目录,不经dist/)。去掉的是只有上传包才背的那 1MB。 - 顺手改掉一处写死的建议:排除之后大头变成
wasm/(71%),而 Gate 0 页里那句「拆分包第一候选」对 wasm 是做不到的建议(分包只切内容)。现在按归因分支——大头是wasm//js/时说「再降只能靠压缩」(S8-1 纹理 / S8-2 wasm),否则才说「拆分包」。一条写死的建议,会在它描述的事实变化后继续以同样自信的语气出现。 - 另一条顺带确认的假设:
me pack --check不写盘,所以 CI 跑一百遍dist/也不会更新——本地dist/当晚仍是含 wushu 的旧产物,已重建。
dump 能指定关卡了:十二关各拍一帧,顺带发现坑是「空着的」
ME_DEMO_LEVEL=0..11走choose_level(先顶满 unlocked,不绕解锁);ME_DEMO_X走新的warp_to(贴地落位 + 12 帧无敌,否则落点旁的刺同帧弹回复活点)STATUS_U329 → 10,第 9 项是关卡号:12 关共用图集与天空,拍错关卡像素看着完全正常- 真 bug:坑在地形里是「地面段之间的空隙」⇒ 什么都不画 ⇒ 背景纸从坑里透出来(纸是亮的,读起来像地面被裁了一刀)。改成从
ground_segments()反推坑、画soil×0.3竖井压在地面下一层:贴地最暗 8×8 块 68.1 → 23.0 - 新判据 G:十二关各 1 帧,只读 dump 自己的数(STATUS_N 两侧常量 / LEVEL / COINS_LEFT == 该关
.lvl的 coin 行数);金币那条是唯一抓得到「关卡号换了、世界没换」的 - 新判据 H:量贴地最暗 8×8 块 ≤ 40。三条反向验证都做了:漏调 level ⇒ 两条红;伪造 LEVEL ⇒ 只有金币数红;停掉坑绘制 ⇒ 68.3 红
- 踩坑记一笔:
PICTURE是 NDC(-1..1)不是像素,按像素量会得到「画面 2×2,渲染没走完」 - 全套 23 项 ✅ / 0 ❌,CI 通过;wasm 三份副本同哈希
2026-10-25
HUD 换成墨色:那五行字的对比度本来是 1.00:1,而判据一直在数纸
- 放大 in-game 帧发现五行读数几乎看不见。量的结果是没画:关卡行对背景 1.00:1(亮度与纸完全相同),五行 1.00/1.02/1.54/1.13/1.09。
- 判据为什么绿:旧判据数「三通道 ≥150 的亮像素」,而敦煌纸三通道全 ≥150 ⇒ 数到 56 984 个,带子总共才 58 368 个像素。判据数的是纸。
- 改法:五槽位换墨/铜/朱砂/石青/石绿(4.5 到 12.55:1),结算面板那行不动(压在深色板上,方向相反)。不选「加暗影/垫底板」:会切开批次或压住技能条。
- 新判据两条:①数墨色像素 ≥300 ②五色对实测背景众数的 WCAG 对比度 ≥4.5。只判一,颜色淡了过;只判二,字没画也过。
- 顺手修同一类错的第二例:结算分支扫的是窗口顶部(1024×768 里正好是 letterbox)⇒「顶部没字」一直在数黑边。改成按画面矩形扫。
- 反向验证:配色改回旧的重建 ⇒ 红在「0 个墨色像素」;改回来绿在 595,最差对比度 6.01:1。
- 提交
345e611,三份 wasm 逐字节相同,十项判据 + 全套 CI 通过(2 项降级)。
地面换成 A1 的贴图:镜像平铺消掉竖缝,半分辨率把 336KB 压到 94KB
ground帧只有 288 世界单位、一关地面 1760 ⇒ 直接贴横拉 24 倍,而这张图不可无缝平铺(首尾列差 33、内部只 4.5)。- 解法:镜像平铺 —— 偶数块正贴、奇数块 uv 的 u 两端对调。接缝两侧是同一个像素列,不需要图能接。周期变两块 576 单位,而一屏只 480 ⇒ 看不到完整周期。
- 分辨率取 1/2(576×80,tile 仍 288×40,每 texel 铺 2×2 屏幕像素):1:1 是 336 KB,加上 wasm 会到 981 KB 破线;1/2 是 94 KB,wasm 645.3 → 742.4 KB(余量只剩 58 KB)。
- 删掉地面顶边的 3 像素亮线(贴图自带高光):批次 6 → 5(地面从白图那一批进了世界素材,少一次切换),期望值跟着降。
- 判据重立:地面这条换过三次(主体色 → 亮线 → 草绿 96,162,124 + 像素数下限 3000)。新判据
ground_tiles_cover_every_segment_without_gaps判三件事:无缝隙、深度到底、相邻块 uv 方向相反(镜像的机器可读证据)。 OBJECTS从 4 元组扩到 5 元组(末格min_px),把「玩家像素下限」的 name 特判变成数据。- 判据:十项全绿;接缝放大 5× 肉眼看无硬缝。
贴图改压缩态进包:wasm 962.9 → 645.3 KB,自己写 inflate 不引入外部依赖
- 上一批接 A1 素材后 wasm 从 390.5 涨到 962.9 KB,破了 S0 DoD 的 800KB;CI 只卡主包 4MB 所以不会报红。
- 三张图裸 RGBA 合计 769 408 字节 → zlib + PNG Sub 行过滤后 275 557(省 64%)。背景只压到 57%,因为大面积平滑渐变 LZ77 抓不到「几乎一样」。
- 新增
inflate.rs(zlib 解压 + 五种行过滤)+image_blob.rs(.rgba.z容器:13 字节头 + PNG 风格扫描行)。零外部依赖,不引miniz_oxide。 - 判据两条二值:解压结果与仓库里的裸 RGBA 逐字节相等;再用 git stash 拿旧版跑同一帧,两份 PPM md5 相同。
- 顺手修三件旧账:
PANEL_COLORalpha 232→248 时漏改测试字面量(那条测试从上一批起就红);rebase 并集后协商板 §4 汇总表没重生成;library/art/index.json在 A1 的 42e8761 里就是陈旧的。 - 扇区:
library/art子模块指针跟随 3×→4× 被判越界,按正规出口登记cross-sector.txt代修(复核人 A1 / 到期 11-08),并建议把子模块指针进open段。
coin-run 接上武侠图集:18 帧烘成 7 帧 256×64,玩家拆成碰撞框 + 贴图两个实体
- A1 的 18 帧武侠图集 →
make_hero.py离线烘 256×64 的 7 帧(65 536 字节),include_bytes!进 wasm,引擎侧无解码器无异步。wasm 364.0 → 390.5 KB。 - 每帧按高归一到 44 像素:碰撞框 22 世界单位 × 4 屏幕像素 = 88,整数 2 倍最近邻。按宽归一会让出拳帧突然变小。
- 玩家拆两个实体:
player只留碰撞框(不带 Sprite,带了就是蓝方块盖住侠客),skin负责画、尺寸随帧变。合并会让碰撞框语义随帧变。 - 两个角色共用 7 帧,靠
Sprite.color乘白袍分色温:Swift[186,222,255]冷白 / Brute[255,226,210]暖白。用饱和色会变成蓝塑料。 - 坑一:宿主
coin.rs的texture()缺2 =>分支 ⇒ 拿不到第 2 张纹理像素,侠客画不出来,而 BATCHES 4 / 采样 4 全绿。删掉同色系的PlayerAccent才让判据抓住。 - 坑二:天空带 78 高是 320×240 时代定的 ⇒ 视野 270 后地平线之上一条黑带,改铺满
WORLD[1]。 - 坑三:判据色
(214,236,255)离 HUD 关卡行只 22(容差 24)⇒ 改(183,218,250),距离 52。 - 判据:
cargo test194 条、build.sh --checkMAC/COIN×4/LIVE/AUDIO/MENU×2/PAUSE 全绿、ci.shEXIT=0。提交3b1a7ea。
- A1 的 18 帧武侠图集 →
渲染目标提到 1920×1080:VIEW 拆成 WORLD / VIEWPORT
- 渲染面 320×240 → 1920×1080,世界不变,一屏看到 480×270 单位,整数 4 倍缩放。
- 视野为什么不是 320×180:12 关纵向占
y=54..240,要 186 高,320×180 差 6 个单位 ⇒ 第 3~11 关最高平台看不见、关卡打不通且不报错。 - 新增
STAGE_H=240:视野 270 比世界高 30,多出的必须是天空。相机纵向贴底,follow_clamped上沿抬 30。 - 抓到三处「zoom 只对一半生效」(zoom==1 时全都正确):
collect_text只乘scale不乘max_width⇒ 结算屏 4 行变 8 行;Camera2D::new的center=viewport*0.5⇒ 画面偏到世界右下角、第一帧零精灵;DrawList存屏幕像素而判据按世界/窗口量。 - 顺手补
TextStyle::scaled(k):加长度字段必须加进去。 - 判据:
cargo test全过 · boot.test 16/16 · wx.test 18/18 · mac demo MAC/COIN/MENU/AUDIO 全绿 ·ci.shEXIT=0。 - 已提交
c42bf86并推agent/A2。 - 缺口:画面没变清楚(仍全是纯色矩形 + 5×7 位图字);视野横向多 50% 是玩法变化;判据页只改了画布尺寸没重跑。
M0.3 判据②③:量尺架好了,顺带抓出「busy 恒为 0」的老 bug
- 新增
apps/coin-run/m03.html+run-m03.sh:跑真实一局(全程按右、结算自动继续)量dt/busy/ 内存,结论 POST 回serve.py的/verdict。 - 修了一处真 bug:
boot.js的busy原来是performance.now() - now(rAF 的时间戳 = 呈现时刻),Chrome 上常大于performance.now()⇒ 减出负数 ⇒ 夹 0 ⇒ 从上线第一天起busy一直是一片 0。同一台机器两次跑一次 700µs、一次 0µs,才把它抓出来。 - 分位数对「大部分是 0」不敏感:961 帧里 95% 是 0,p95 就落在 0 上。指得分位数替你看「量错了」是不可能的。
- 逐帧
busy就算改对了也分不出来:performance.now()被粗化到 ~100µs,而引擎一帧就是 25µs。于是另加「同步连跑 600 帧取平均」当可用替代。 - 这一页不能用无头:无头里 rAF 一帧都不发(
CVDisplayLinkCreateWithCGDisplay failed);加--virtual-time-budget则虚拟时间在同步代码里不前进 ⇒busy恒 0。所以用真窗口 +/verdict回传。 - 三档结论:
OK(安卓 + ≥180s + 两条线都过)/NEAR(数据有效但机器不对)/FAIL。前六条判据验「这次测量可信吗」,自检不过时后面的数字没意义。 - 实测(Mac · Chrome 156 · 120Hz · 10s):
M03 NEAR 1201帧 10.0s dt_p95 10.0ms busy_p95 0.0ms sync 25µs wasm 11.8MB js 4.6MB rAF 120Hz。两次跑sync都是 25µs。 - 判据③ 的引擎侧数已经能答:wasm 11.8MB + JS 堆 4.6MB ≈ 16.4MB,是 600MB 的 1/36。但判据② 的安卓数还没有 ⇒ M0.3 离达成差一台设备。
- 负向验证 2 条全红在靶上(
syncFrameUs置 0 ⇒ FAIL;无头 ⇒ 一帧不发)。 - ✅ CI 68s 绿 · 提交
dca0ef2
- 新增
S7-4:帧级 trace 打通「引擎 → C ABI → 宿主」,链路判据 12 条全绿
- 新增
crates/me-runtime/src/trace.rs(约 560 行):它不采集、只留存。LoopReport已把一帧算齐,trace 只做「留历史 / 压分位数 / 导出字节」。 FrameSample只收八个整数,push接它而不接LoopReport⇒ 模块不依赖game_loop,方向单向。- p95 用最近秩不插值:20 个样本的 p95 是第 19 个真实样本。「第 3402 帧 41ms」可追,「38.2ms」不可追。
dt_us与busy_us分开算:只报 dt 会把「等 GPU」和「逻辑慢」混成一个数,而两者修法相反。busy不夹到dt。- 宁可少一个字段,也不要一个永远是 0 的字段:原打算记
render_error,但 COIN RUN 路径上Game::step不返回渲染错误,填 0 等于「没测过也说没错」。换成untextured(退白纹理批次数)。 - 导出走「引擎缓冲 + 指针」而不是
out/cap:JS 宿主没能力自己申请 wasm 内存(malloc刻意不导出)。 - 判据:Rust 19 条 + C ABI 3 条 + 链路 12 条(
apps/coin-run/trace.html);负向验证 8 条全红在靶上。 - 实测输出:
M03-TRACE OK 64帧 回绕 120 dt_p95 16.0ms busy_p95 11700µs heap 1120KB - ⚠️ 仍缺:真机采样(数还没有)、MIR 节点归因(属 S7-5)、编辑器端 WS 端点(属 A3)。
- ✅ CI 81s 绿 ·
cargo test -p me-runtime382 测试全过 · wasm 三份哈希唯一fdf0ecf9…· 提交5fd8d60
- 新增
M0.3 核对:看板写「玩法框架未开始」,实际 12 关全通、循环齐全
- 看板 M0.3 = 待开始,why 仍写「S7 玩法框架未开始」——已失真:M0.2 早已 reached,
coin_run有 7203 行 - 实测
all_twelve_levels_are_clearable_by_the_bot(release,1.04s):12 关 × 2 角色全通,131882 帧 - 每关完美目标 par = 175–190s(≈3 分钟,正好对上 S7 DoD),速通 53–127s
- 判据 1「开始→关卡→结算→重开」代码齐全:Screen 4 态 + Outcome 4 态 + 存档解锁 + restart
- 判据 2(中端安卓 p95≤33ms)无真机证据,只有 Mac 上 1000 批 31.7ms / 3 批 0.2ms;实盘 2 批 424 顶点
- 判据 3(峰值内存 <600MB)没有任何测量代码
- 判据 4(trace 回传 + MIR 归因)未开始,S7-4 / S7-5 空
- 未登记但事实完成:S7-1 玩法框架 / S7-2(12 关,超出 1–3)/ S7-3 UI / S7-6 存档
- 看板 M0.3 = 待开始,why 仍写「S7 玩法框架未开始」——已失真:M0.2 早已 reached,
S4-8 场景切换无白屏:冷切换必须超预算,预热后 0 帧
crates/me-runtime/src/scene_switch.rs(约 470 行)+ 10 条判据,提交affc9bf,CI 174s 全绿- 三个时刻三种手段:冷启动画占位 / 切换中 hold 旧场景 / 换前预热
- 冷切换 19 帧 = 316.7ms(必须超),预热到位后 0 帧;预热要提前 20 帧(333ms)开始,预热过半就切仍只 13 帧 = 216.7ms
- 300ms 只测一头没意义:配额从 2 调到 8,冷切换只 166.7ms ⇒ 判据自己红并报「证明不了预热的意义」
- 预热必须 pin:有对照组,不 pin 的 AssetId(0) 当场被 LRU 掉
- ⚠️ 负向验证抓出自己写的死规则:原本「降级等 30 帧」改成 0 后 10 条判据全绿 ⇒ 根本没钉住(drive 每 tick 重发,Failed 一帧内就回 Requested)。真正该兜的是平台什么都不回,改 MAX_SWITCH_FRAMES=90 超时兜底
- 5 条负向验证全红在靶上(删 holding / 删 pin / 删超时 / 删空场景守卫 / 配额 2→8)
- 已知缺口:COIN RUN 关卡是 include_str! 零 IO,走不到这条路径
S4-2 wasm DSP 最小集落地:噪声/包络/滤波/混响能在运行时现算
crates/me-audio/src/dsp.rs(660 行)+tests/dsp.rs(16 条判据),提交3249cbc,CI 77s 全绿- 与 Python 烘焙版三处不得不分岔:时变滤波 STFT→biquad 按块更新系数;粉噪频域塑形→Kellet 七极点;混响 FFT 卷积→Schroeder 4 梳状+2 全通
- 炸相位的真因不是 IIR,是逐样本重算系数;块边界更新+块内 LTI 递推即连续
- 确定性口径:同目标同构建两次逐字节一致;不承诺与 Python 版逐字节一致(numpy 随机流/FFT 实现不同)
- 6 条负向验证全红在靶上(反馈符号反 → 通带 0.0043;粉噪退白 → 0.09689486 vs 0.096895166;混响反馈归零 → RT60 红)
- 三个我自己的错假设写进注释:perc attack 末尾不是 1(指数已掉 8%)、布朗去趋势≠零均值、扫频折线太缓后段还剩 30%
S4-9:16 通道混音每帧 118ns,只占 1.5ms 预算的 0.01%
- 实测(release / 600 帧 / 取 4 轮最小值):tick 18ns、commands 101ns、合计 118ns、16 个位置音源 417ns。
- 结论比数字重要:这个混音器不混 PCM(只算增益/声像,采样叠加在平台侧)⇒ 「混音会不会爆预算」的风险不在我们能改的那部分。
- ⇒ 1.5ms 那道门永远抓不到回归(涨 80 倍照样绿)。另设 2μs 回归门;分配那一类靠指针判据(
commands()逐帧指针不变),不靠阈值。 - ⚠️ 负向验证当场抓出一条假判据:第一版只设
looping(),删掉它判据照样绿 —— 因为tick的过期条件是!looping && duration_ms > 0,默认 0 本来就不止期。改成with_duration(3_000)+looping()才真(删 looping ⇒ 第 188 帧剩 0 个)。控制实验证明推理不假。 - 5 条判据;照
ffi_cost.rs模板(release 才断言 + 分项报 + 单独前提判据);CI 加--nocapture让数字进日志。 - ⚠️
me-audio::Mixer至今没有宿主在用(coin_run 走另一条 AudioEvent 流水)——这批量的是「将来要接」的路径。已向 A1 提 1.5ms 口径问题。CI 170s 绿。
S3-2:父子层级与变换传播(回到引擎主线)
- 前十三批全在
coin_run(验收载体),且task:trailer 借了S0-5(那是me-rhi/ffi.h的号)——署名守卫只验格式不验占号。这批回到 10 号排班表,task: S3-2。 - 父子不是组件:archetype 按组件集合分桶,加
Parent会把「精灵+变换」劈成两桶,而绝大多数实体没父。改成World里的左孩子/右兄弟(24B/实体、零分配、懒扩容)。 - 环在
attach时拒,不靠深度上限兜底——差别是发现问题的时刻(拖拽当场弹回 vs 某帧开始每帧多转一点)。 - 不动
Transform2D的世界坐标语义(SpriteInstance/DrawItem都按世界坐标消费它),另开LocalTransform+ 每帧propagate;没LocalTransform的实体一个字节不碰。 - 语义:局部原点 = 父左上角;旋转绕父中心;角度累加;尺寸不继承(缩放要加
scale列 = 契约级)。 - ⚠️ 删父必须
despawn_keeping_children_in_place烘焙,裸despawn会让挂件瞬移(ECS 不认识 Transform,封装只能在 render2d)。 - 22 条判据(11 单元 + 11 端到端);负向验证 5 条全红在靶上,报错带具体数字(「子该在 (132,200),实际 [100,200]」)。
- 顺手补账:
mem.rs887 行 / 28 判据早就是 S3-4,板上一直空着,已登记(38/110)。CI 70s 绿。
- 前十三批全在
触屏三页从「截图给人看」升级成「量像素」(第十四批)
- 上一批的截图判据只验「图落盘了」,排版对不对还是只有人眼 ⇒ 补像素读数。
- ⚠️ 关键:
readPixels必须在自己的requestAnimationFrame里读。从 eval 任务里读拿到的是已清掉的缓冲(整屏[0,0,0]),而恒 0 会让「这一带没有墨」全部假绿、让「有墨」永远红。所以先读一个已知一定亮的像素当控制组:选关页第一格青色光标(实测[86,210,200]),它不亮就整组作废。 - 基线:页脚带 88/808、格子与页脚间空带 0/808、说明页正文 920/5499、正文与手柄之间 0/1269。
- 负向验证:旧排版(8 行头 + 行距 1)放回去重编 ⇒ 那条空带变 345,红在「正文长到手柄底下了」;还原回 0。
- 顺手复跑九个老判据页(atlas/text/scale/mip/rotate/nine/demo/mir/buttons)全绿;12 关全通 131882 帧全绿。CI 131s。
触屏那三页终于能看了:加开关 + 截图判据(第十三批)
- 桌面报
pointer: fine⇒ 触屏独有的排版在桌面上永远看不到(页脚位置、说明页行数行距),而这几处正是唯一会错的地方。 index.html认?touch=1;新增shot-touchui.js+run-touchui.sh,手机视口拍三页落evidence/p-touchui-*.png(标题/选关/说明)。- 三张图已人眼验过:两列对齐在 9/32 列、页脚与手柄不重叠、说明页最后一行在 159。
- 顺手:发布页说明从「四个虚拟键」改成五个(加了顶部
||)。 - ⚠️ 顺手抓到一处漂移:
web/与site/的 wasm 还是上一批之前的字节,而上一批 CI 的check_play_sync是绿的 —— 提交前要核三份哈希。 - ⚠️
task:trailer 必须是S<n>-<n>;前四批写了自由文本没红,因为那道门只查未推送的提交。CI 68s。
- 桌面报
手机上的说明页,最后三行压在手柄底下(第十二批)
- 说明页在触屏上从
24排到211,而手柄从193.7起 ⇒ 最后三行被<>盖住(含12 LEVELS ABOUT 3 MINUTES EACH)。 - 它什么都不报:正文确实画了,
menu_line(Body)读出来也完整。只有把「画在哪」和「手柄在哪」一起量才红。 - 触屏头部改两列两行、行距收到 0 ⇒ 17 行排到 159(页脚 172、手柄 193.7)。
- 新增
help_line_rects(touch)逐行给矩形(行高/前进量从BuiltinFont取);不能给整页包围盒 —— 那是满宽的,而HOW TO PLAY靠左、顶部||居中,会红在假的地方。 - 判据 x1(84),负向验证:旧排版放回去就红。CI 135s。
- 说明页在触屏上从
Mac 桌面版放不出技能:宿主只认了三个键(第十一批)
coin::button_of只写了0/1/2,漏了Skill = 3—— 而 Swift 侧一直在发(J/K/Shift)。- 后果:
me_md_key返回 -3,宿主_ =丢掉 ⇒ 桌面版放不出技能;而窗口底部那行说明写着「J / K / Shift 技能」。不报错、不黑屏,DASH OK一直亮着。 - 改成「列出接受的四个动作键、编号问
raw()」;Pause=4仍拒(桌面有自己的菜单键,两条路做一件事)。 - 判据
every_action_button_the_keyboard_can_produce_is_accepted:逐个问raw(),外加 Pause 必须被拒。负向验证红在「按钮 3(Skill)被拒」。 - Mac 23 条判据全绿,clippy 干净。
手机上的菜单页脚:不删了,抬到虚拟手柄上面(第十批)
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
TOUCH_FOOT_TOP=172就行。 - 最贵的是选关页:页脚是那一页唯一说「哪个键开这一关、怎么退回去」的地方。
foot_text(touch, 键名版, &[(PadButton, 词语)])用pad_glyph拼字形;键盘版一个字没动。- 判据 ×2(83→84):逐页查非空+无键盘键名+逐键问字形;页脚与手柄每个键的矩形相交测试(不能比「最上面那个键」——暂停键在 y≈6)。
- 负向验证 ×3 全红在靶上。CI 99s。
- 触屏页脚一直整行删掉,理由「底部 34 像素是手柄地盘」对、结论错:抬到
说明页补上 `||`,并把「提到屏幕上的每个键」做成自维护判据
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
KEYS ARE THE FOUR BUTTONS BELOW(屏幕上是五个,且一个在顶部)。刚修过「说明教玩家按不存在的键」,不补就变成它的镜像:屏幕上有键,说明不提它。 - 顺手把判据改成逐个问
pad_glyph(不再写死字形清单)——写死的话加第六个键时这页会静默漏掉,而它是玩家唯一会读的地方。pad_glyph因此升成pub。 - 负向:删掉那一行 ⇒ 红在「触屏宿主的说明页该画出屏幕上的
||(Pause)」。 - 另一条硬朾教训:改完引擎必须
build.sh → cp 两份 → build_site.py,否则 CI 红在「生成物陈旧」(这一批被拦了两次)。 - 提交
a8937d9(agent/A2 已 push),全量 CI 73s 通过。
- 上一批加了触屏暂停键,而说明页对触屏宿主还写着
触屏暂停键:手机玩着也能回菜单(选关/换角色终于够得着)
- 洞:手机玩家玩着时没有办法回菜单(没 M 键、没 Esc,屏幕只有四个动作键)⇒ 上一批的选关/换角色只在开局看得到,唯一退路是切后台再回来。
- 做法:
PadButton::Pause(raw=4追加在最后)+PadState.pause_held/pause_pressed+platformer()顶部正中一个 0.75 键宽、字形||;输入系统把它换成回标题页(menu_item=0),不给玩法意图。 - 为什么由引擎消费:宿主要做这事得先知道「这一帧刚按了暂停」,而
state里没这列——加列就是又一处两个宿主都要改。为什么不另开一张键表:多指记账/命中/绘制三条路都只认PadKey。 - 位置是三个候选逐一排除的:右上角是 HUD
LIFE;底部中间压地面(再压一块玩家看不出哪里能落脚);右手键群旁会误触(后果是「玩着玩着回菜单」)。 - 顺带:字形居中开始乘字符数(
||是唯一双字符);暂停在说明/选关页是「返回」,在标题页什么都不做(否则光标每次被打回第一项)。 - 验收:102 lib + 81 game_slice(+3)、node 53 项(+1)、clippy/CI 全绿(148s);负向两条(去处理→红在「该把画面换到标题页」;矩形压到跳键→红「键 Jump 与 Pause 重叠了」)。
- 提必
496a0df(agent/A2 已 push)。
手机结算页:文案按宿主说话,且点一下真的能继续
- 小游戏开局现在停在标题页,于是它第一次有了玩家能看到的第一屏文字。顺着这条线补了两处「默认玩家有键盘」的地方。
- ① 说明页只有一版
JUMP SPACE UP W / MOVE A D,手机上这三个键一个都没有(只有底部四个字形<>^*)。拆成HELP_HEAD_KEYS/HELP_HEAD_TOUCH+ 共用HELP_TAIL,判据用已有的touch_ui(它已经在决定画不画手柄)。 - ② 三个终局面板硬写
PRESS SPACE,手机上通关/掉坑后就停在一个「让他按空格」的画面上,而那个画面上没别的东西可点。触屏版改TAP TO CONTINUE。 - ③ TAP 得真的有用:
me_coin_run_continue只有网页接过,game.js从来没调 ⇒ 手机玩家只能杀微信重进。bindTouch加onPress:DOWN 之前问一遍,返回 true 就整下吃掉(不 poke,否则手柄认领一个键而restart不重建手柄 ⇒ 进关先蹦一下);UP/MOVE 照样转发(否则按着右键掉坑的那根手指永远不抬起)。 - ⚠️
me_coin_run_continue错误约定与me_coin_run_audio相反:失败返回正数 4。写if (o < 0)永远进不去。 - 验收:Rust 101 lib + 79 game_slice(+2)、node 52 项(+1)、clippy/CI 全绿(148s);负向三条各自精确红(不吞 → py 170.97→152.86 起跳 18px)。
- 提交
b3f4782(agent/A2 已 push)。
全端发布 1.5.0+24:三端安装包上官网,文件名带 build 号避免缓存
- 发版 1.5.0+24,四端安装包全部上传
(服务器路径),文件名带 build 号(-24)避开浏览器缓存:APK 40.7MB / DMG 41.3MB / Windows zip 14.0MB,上传后 md5 与本地逐个一致。 versions.jsonlatest 三平台 build=24,history 顶部新增1.5.0+24;DownloadSection.vueverTag →v1.5.0+24,feature 换成“通讯录多选一键发送”“传输中可中途停止”。官网构建部署后验证:线上引用index-CfCcDH-C.js,JS 内 grep 到 3 处v1.5.0+24与三个-24文件名。- Windows 构建踩了 SSH 坑:直接
ssh ... flutter.bat build windows会把进程连同会话一起挂死(19 分钟无产物、tasklist 里无 dart/msbuild)。改用Invoke-CimMethod Win32_Process Create脱离会话 + 日志重定向,再轮询日志才跑通,实际 166.5s。另有首行Nuget.exe not found(走 storage.googleapis.com)干等 2~3 分钟,不是死机。 - 提交:App
a6abcfd(+24)、官网cdce6cb(发版清单与下载区)。华为 P70 18→24、小米 17 21→24 均已覆盖安装、数据保留。
- 发版 1.5.0+24,四端安装包全部上传
小游戏开局进标题页:玩家终于看得到选关/换角色/操作说明
game.js加CoinBoot.openMenu(ex):三个宿主里只有它开局什么都看不到(*技能键没有任何文字解释)。网页能写 DOM hint,小游戏只能靠Screen::Help,而那一屏只能从菜单进。- 先探过前提:手柄在菜单页也画得出来(
batches玩着 4 / 菜单页 4 / 关掉 2),所以那一屏既看得见也按得动。 - 顺带修好一条假绿的判据:「dt 单位」一直恒真。两个原因叠加:① 不喂输入 ⇒ 角色不横向移动,两条时间线都是出生点;② 直接读
fresh.state + 16,而stepFrame只填step块 ⇒ 读到上一帧循环的旧字节,等于byLoop === byLoop。把DT_MS_X100_PER_MS改成 12(差 8 倍)它照样过,相邻三条触控判据全红。 - 改后同一负向验证给出「循环 39.40 vs 手喂 156.03」。
- 五条既有判据因「开局不再在玩」要改:加公共
enterPlay(rt, game)替玩家按一下^。 - 验收:node 51 项 全绿;负向两条(注释
openMenu/ dt 改错)各自精确红在靶上;全量 CI 77s 通过。 - 提交
a2e90c4(agent/A2 已 push)。
小游戏补上存档、切后台暂停、四个虚拟键(S0-5 · 第九批)
game.js是三个宿主里唯一还缺这几样的,而它恰好是真正发给玩家那一个(网页与 Mac 是验收入口)。- ① 四个虚拟键从来没画出来过:命中区域一直在(所以能玩),但
game.js没调CoinBoot.touchUi—— 网页按pointer: coarse开了,小游戏百分之百是触屏反而漏了。 - ② 存档整条是断的:通到第 5 关、关掉微信、再进来又从第 1 关开始,最高金币永远 0。接上
wx.getStorageSync/setStorageSync,与网页localStorage/ MacUserDefaults走同一份四整数契约。writeSave只在内容变了才写 ——setStorageSync是同步的,每帧写会抖磁盘,而症状是「玩久了偶尔卡一下」。 - ③ 切后台不暂停 = 回来人就没了:rAF 停摆而
loop用真实时间算dt⇒ 回来第一帧dt是几秒,掉帧补步一次补很多步,角色已掉坑。onHide调openMenu+ 落一次存档,onShow什么都不做。 - ⚠️ 手柄那条判据写错了两版:第一版「开/关
sprites差 8」实测差 0 —— 零面积精灵照样计入sprites,只在图元装配阶段被丢,真正分界是batches(关 2 批 / 开 4 批);第二版测试自己先关再开,验的是「API 有效」而不是「game.js默认开了」,把game.js那行注释掉照样全绿。第三版从默认状态出发才真的红。 - 存档判据钉的是两边一致(存档里的值 == 引擎里的值),不是「大于 0」:
bestCoins只在通关后涨,拿「大于 0」当判据实际在验「机器人能不能在 4 秒内通关」。 - 验收:node 50 项(+5)/ 负向验过四条 / 全量 CI 73s。提交
5d8bbf5。
小游戏也有声音了:一份音色配方,两种落地(S0-5 · 第八批)
- 病灶:微信小游戏没有
AudioContext,只能wx.createInnerAudioContext()播文件 —— 网页那套「现场合成」在小游戏里根本不存在。所以game.js一局到底一声没有,而所有测试全绿。 - 根因在
game.js:CoinBoot.loop(ex, mem, onFrame)只传了三个参数,第四个onAudio一直是undefined⇒ 音频流水一条都没被取走。 - 一份配方两种落地:新增
js/sfx-recipes.js(波形/起止频率/时刻/时长/峰值/包络常数),sfx.js读它建振荡器,make-sfx.js读它算 PCM。数字埋在 switch 里就是两份真相互相漂移,而症状是「手机上的金币声和电脑上不是同一个调」。 - ⚠️ 噪声必须固定种子 LCG:
Math.random()每次烤出来字节不同 ⇒ 入库那份永远「和刚烤的不一致」⇒ 门要么永远红、要么被迫去掉。 - ⚠️ 扫频要积分相位,不能算
f(t)·t:后者在f0≠f1时相位跳,0.22s 的下坠音听起来像「断了一下」。 - BGM 取 1 秒:55/110/165 在 1 秒里都是整数周期。实测循环点首尾差 159 = 相邻样本差 159 —— 接上就是正常步进。非整数周期会每秒「咔哒」一声,听起来像心跳。
- 两个能力边界(写进注释,否则会有人去错的地方查):
InnerAudioContext没有 pan,两路增益只能取平均;烤出的波形与 WebAudio 的 band-limited 振荡器不逐样本一致(音高/节奏/包络/响度一致),所以判据验参数不验逐样本。 sfx-wx.js四个静默失效全用假InnerAudioContext验掉了:src 拼错 / 忘设 loop / 静音恢复成 1(BGM 一下响十倍)/ 每次 Play 新建实例(微信有实例数限制,超了不出声且不报错)。- 顺带:
check_play_sync从「只盯 wasm」扩到「PLAY_ASSETS 也逐字节比」—— 原注释那句「js 由 sync 现取、没有副本就没漂移」只对构建时成立,site/是入库的。 - 验收:node 45 项(+13)/ 负向验过四条 / 真机两页
AUDIO OK/ 全量 CI 72s。提交e1776c1。
- 病灶:微信小游戏没有
音频流水加上限 —— 把「宿主忘了取」从「会不会崩」降级成「丢了几条」(S0-5 · 第七批)
- 病灶:
AudioLog.events完全无界,而小游戏入口game.js从来没调过audioFrame⇒ 一局里每条增益淡变都留在Vec里单调增长,几万条。症状「玩久了变卡、偶尔闪退」会被算到内存、GPU、机型头上,唯独不会让人怀疑音频。 - 上限 96 条(约两秒的量),满了丢最老的(玩家在意刚发生的那一声);
VecDeque而不是Vec::remove(0)(每次溢出都要 memmove)。三条AudioSink方法走同一个push:写成三处各判一次,漏一处那个事件类型就成了无界口子,而「只有 Stop 会漏」的表现是「跑久了才卡」。 - 新状态列
STATE_AUDIO_DROPPED(第 27 列)。它的价值全在「宿主可以自己说清楚我没在取」—— 没有它,这件事在真机上没有任何可读证据。 - ⚠️
audio_events的差值会归零:原来算events.len()差值,队列满之后「弹一条、压一条」长度原地不动 ⇒ 报告说「本帧 0 条」。改用新的total(累计入队数,跨取走跨溢出单调增)。 - ⚠️
plays_of不能从流水里数:一有上限就只在「全程没溢出」时对,实测every_coin_makes_exactly_one_sound红成「81 枚金币 = 2 声」。改成按编号分桶的计数器。sounds()改名pending_sounds()(它只覆盖尾段,叫原名会让人以为拿到完整账)。 - 暂存区的账:
state多占一格 ⇒ 音频块起点 34→35 ⇒AUDIO_MAX5→4。每帧少取一条无影响,但它是提醒:加字段要从别处挪。 - 验收:
game_slice77(+3,每条先断言「这个场景必须真的溢出过」)/ lib 101 / node 32 / 真机AUDIO OK/ 全量 CI 143s 八条 Mac 判据全绿。提交8c4e056。
- 病灶:
把「最高金币」显示出来 —— 存着不给人看等于没有(S0-5 · 第六批)
- 引擎从 12 关那一批起就在算
bestCoins、也一直通过STATE_BEST_COINS导出,但界面从来没有那一格。存着不给人看 = 没有重打目标。HUD 补上「最高」并每帧对齐。 - 判据验的不是这个格子,是「引擎导出的字段 → 宿主显示」这条路:
touchbar-probe.js里先往 localStorage 写bestCoins:77再重载,读 HUD 得到 77;同一次重载顺带验了存档里的角色(hero:1→ 界面 BRUTE)。这类漏接不报错、不崩,只会一直空着。 - 结论行
✅ HOSTUI OK … 最高分 77;全量 CI 通过(workspace 1509 / node 32 项)。 - 提交
a27a6a2(push agent/A2)。
- 引擎从 12 关那一批起就在算
手机上补两个宿主键:暂停与静音(S0-5 · 第五批)
- 引擎只画四个动作键(←→ 跳 技能)⇒ 手机玩家想停一局只能按 R,而 R 是重开(等于放弃);想安静得先静音整台手机。补上页面里的「暂停 / 静音」两键(
.touchbar+@media (pointer: coarse))。 - 放在页面而不是引擎:
openMenu/setMuted是宿主能力;画进引擎桌面也会多出两个没人按的键,而四个虚拟键已经把地面盖掉一半。 - ⚠️ 顺手修了一个会被它踩到的隐患:
setMuted可能在AudioContext建起来之前调(那时还没用户手势),而_ensure建 master 时写死gain = 1⇒ 「按钮显示静音,一进游戏又响了」。补测试并负向验过(把1放回去立刻红)。 - ⚠️ 桌面那一半判据必须先跑:CDP 的
setTouchEmulationEnabled(false)撤不干净(撤完再导航pointer: coarse仍是 true)⇒ 第一版判据是假红的,测的是浏览器残留状态。 - 三个跑法脚本收成一套:
run-buttons.sh/run-shot.sh只设PROBE然后exec run-audio.sh(服务+Chrome 生命周期只能有一份)。 - 真机:
✅ TOUCHBAR OK 手机可见/桌面隐藏 · 无溢出 · 按钮 92×40 · 暂停把固定步冻在 24 · 静音可逆且落盘;证据evidence/p14-touchbar-phone.png。全量 CI 通过(70s,workspace 1509 / node 32 项)。 - 提交
0c0d6ac(push agent/A2)。
- 引擎只画四个动作键(←→ 跳 技能)⇒ 手机玩家想停一局只能按 R,而 R 是重开(等于放弃);想安静得先静音整台手机。补上页面里的「暂停 / 静音」两键(
网页版终于有声音了:引擎发货、宿主现场合成(S0-5 · 第四批)
- 症状:网页版一局打到底一声没有,而所有测试全绿。两头都断:引擎把每句该响的话都算对、记在
AudioLog里,但 wasm 只导出audio_events计数("本帧响了几声")—— "响的是哪一声"到不了宿主。 - 取走式不是游标式:
me_coin_run_audio(out, cap)取走即消费。游标的失效点只有restart清空日志那一处,而它零症状:之后每帧读到空 ⇒ "重开一局就哑了",账目全对。 - ⚠️ 错误码必须负数:这一层别的函数返回
ErrCode正数,但这里返回值首先是计数 ——InvalidArg是 4,而"恰好 4 条"也是 4。混在一个数里宿主只能照播四条没被写过的内存(上一帧残留,听起来像随机音效)。 - 合成而不加载 ogg:
library/sfx/没有 jump/hurt/win 那几段,另存一份就是又一处"发版忘了拷就没声音"。9 个音色现场合成:零资产、不会 404。 - 两路增益:
源 → Gain(L) → ChannelMerger[0]+源 → Gain(R) → merger[1]。引擎给的是定点增益(1.0 = 1000000),压成一个pan就把声像白算了。 - 判据:
game_slice+3(74 通过)/wasm.rs+3 /test/sfx.test.js7 条(假 AudioContext 记账 ——sfx.js在 CI 里唯一的覆盖)/ 真机run-audio.sh:AUDIO OK ctx=1 BGM 3 层 跳 +1 源 merger=2、固定步 0→63→91。全量 CI 通过(68s,workspace 1509)。 - 提交
bd7e0fd(push agent/A2)。
- 症状:网页版一局打到底一声没有,而所有测试全绿。两头都断:引擎把每句该响的话都算对、记在
手机竖屏能玩了 + 官网试玩页不再落后好几个批次(S0-5 · 第三批)
- 手机上那 1 像素:
width:100%+ 1px 边框在 content-box 下算出100%+2px⇒scrollW 391 / clientW 390整页能左右晃。改box-sizing:border-box;顺手补viewport width=device-width、aspect-ratio:4/3、justify-content:safe center(safe是关键,否则内容比视口窄时左边被裁)。 - 官网那份是手工维护的第二份:
site/play/coin-run/落后好几个批次(没有选角条、没有选关与存档、金币写 6 枚、触屏说明还让人「点一下画面」)。改由build_site.py的PLAY_ASSETS从web/复制,web/再从apps/取胶水。 PLAY_SYNC少一行,门等于没装:它只盯web/,而sync_web()只在构建跑过之后才铺site/⇒ 实测site/的 wasm 停在 248508 字节、web/已是 361990,差 113 KB,十二关之前那版引擎,线上照常能玩、零症状。补第二行;负向验过(追加 1 字节立刻中止并指名)。- 判
pointer: coarse不判ontouchstart:触屏 Windows 笔记本后者也 true,而那类机器有键盘、块会压住地面(玩家靠地面判断落脚)。matchMedia只在加载时求值 ⇒ CDP 里必须重载。 - 实测:390×844 无横向溢出、画布占 93.8%、四个键各 39.3 CSS 像素;
build.sh --check八条全绿;全量 CI 69s;cargo fmt无 .rs 变更(wasm 不陈旧)。 - 提交
98bc703(push agent/A2)。
- 手机上那 1 像素:
COIN RUN 触屏手柄:画的和点的必须是同一个数
- 四个虚拟键的命中区域一直在
VirtualPad::platformer,所以手机一直“能玩” —— 但那四个按钮从来没被画出来过。玩家面对一片“按哪里都有反应、看不出该按哪里”的画面,而桌面永远暴露不出来。 - 画的和点的必须是同一个数:
build_world里再建一个VirtualPad::platformer(VIEW)把keys()带命中区域一起抄进Sim::pad_ui。手写第二份矩形算式 = “看着在按钮上、点下去没反应”,不报错、不崩、数字全对。 touch_ui放Game上而非只放Sim:Sim每关重建,只写Sim的话“过了第 1 关手机上手柄就没了”。- 判
pointer: coarse不判ontouchstart:带触屏的 Windows 笔记本后者也 true,而那类机器有键盘、块会压住地面。 - 三处只有渲染出来才发现:① 底块
[8,14,22,120]在深色地面上等于隐形(只剩四个漂着的符号)⇒ 改[26,40,56,170];② 字形用Align::Center+max_width偏半格,无max_width还偏 ⇒ 自己算内边距 + 左对齐;③ 触屏时菜单页脚键位提示要藏掉(手柄压在那一带)。 - 判据:
game_slice新增 4 条(零面积默认 /pos == hit.min逐值 / 按住变青 / 重开还在)。mac 八条判据全部不受影响,顶点 408→424 正是 4 个底块 × 4 顶点。 - 真机:CDP
Emulation.setTouchEmulationEnabled后重载页面(matchMedia只在加载时求值),pointer: coarse为 true,按住左边那块变青且角色往左走。 - 全量 CI 123s 全绿,
9d8c22e在agent/A2。
- 四个虚拟键的命中区域一直在
COIN RUN 存档与选关:关掉游戏再回来接着打
- 引擎侧:Screen 第 4 档 Levels、标题页第三项「LEVELS n/12」、新 Save(unlocked/last_level/hero/coins)。通关当帧解锁,不等玩家按「继续」——在结算画面直接关游戏是正常动作。
- 选关页 6×2 格:
6*40+5*6=270,320 宽左右各留 25;锁定格画--不隐藏(否则玩家以为只有三格);技能键 = 返回(左右是环,否则死胡同)。 - 越界值一律
clamped():浏览器里 F12 就能改存档,unlocked=200会让格子画到屏幕外。 - 三处持久化:网页
localStorage(coin-run.save.v1)、macOSUserDefaults(coinRun.*)、小游戏预留。引擎只收发四个整数,格式由宿主定。 - 两处只有渲染出来才发现:① 选中格数字被同色高亮条吃掉(第 1 格成空青块)⇒ 选中一律反色;② 菜单里世界还在动(暗色只盖 93.3%,6.7% 透出金币悬浮)⇒
animate也看screen。 - 判据 F(标题页/选关页两屏,方向与前几批相反:判「该没有的确实没有」)+ PAUSE(
cmp比菜单里 90 帧与第 1 帧逐字节相同)。实测光标 538×45 与 128×96,正好是 168×14 / 40×30 的 3.2 倍。 - 踩坑:判据进程会读本机
UserDefaults⇒ 跑过标题页之后判据 E 报「61 条 ≠ 60 帧」,换干净机器又绿。结论取决于「以前有没有人玩过」。现在探针一律从新玩家起步、也不写回。 - 全量 CI 140s 全绿,
36aaea0在agent/A2;共享路径 9 处已用say.py报备 A3。
COIN RUN 启动先给标题页与操作说明(三平台)
- 新增
Screen {Playing, Title, Help},与Outcome分开;引擎建局照旧在玩,标题页由宿主open_menu()显式打开(判据/机器人/离屏 dump 不用先按键) - 菜单=暂停不是重开:
fixed_step非 Playing 直接 return;首项文案按has_run切 START GAME / RESUME - 不新增按键:左右翻项(环)+ 跳/技能都是确认;左右补了按下边沿(持续态会一口气翻三项)
- 说明页:按键表 / 道具 / 两种怪 / 两个角色技能 / 12 关约 3 分钟;位图字体等宽 ⇒ 左对齐手排空格
- 顺手修旧 bug:
Sim.hero搬进build_world,原来换角色后「身体是岩、技能是风」 - 证据:
game_slice+7 条全绿,12 关×2 角色 131882 帧仍全通;boot.test.js10/10;CDP 真按键在无头 Chrome 走通 →→空格进说明页 - macOS
build.sh --check七项全绿(ME_DEMO_MENU=1才拍菜单);标题栏菜单里改「标题页(已暂停)」 - 全量 CI 通过 76s;提交
dddc11b已 pushagent/A2 - 坑:
cargo fmt --all会让 wasm 产物变陈旧 ⇒check_generated报「生成器失败」;顺序必须是 fmt → build.sh → cp → check → ci
- 新增
结算画面两处残留 UI:描边停在 (0,0)、技能条没让位
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
let _edge = …),位置永远停在 (0,0) —— 屏幕最上沿多出一条 6px 青线,看起来像装饰;② 技能条是另外两个色块实体,结局后文字让位了它俩没让,结算画面左上角飘着一条青色进度条。 - 修法:
Sim.panel_edge与panel走同一段定位算式;结局后技能条尺寸缩到零(零面积不落像素,比加可见性开关少一个会忘同步的状态)。 - 新判据
the_result_panel_is_the_only_thing_left_on_screen:过关帧描边的位置与宽度必须等于面板、技能条两个色块面积必须为 0。两条在修之前都会红。 - 实测:结算帧描边矩形 (83,218)-(940,223)(面板左上角 80,215),技能条填充 0 像素;全量 CI 166s · 1485 测试 全绿。
- 提交
35fea9b,已 push agent/A2。
- 截图验收「通关表现」时发现两处残留,都是「只搬了该搬的一个实体」:① 面板描边 spawn 后被丢掉(
COIN RUN 十二关 · 双角色 · 技能 / 道具 / 四种怪 · 结算与继续
- 玩法:12 关 7040…14080 宽(
levels/coin-run-1..12.lvl,include_str!进二进制,parse(&str)一行未改);每关设计目标 175~190s(完美通关 ≈3 分钟)。 - 双角色:Swift(132px/s、跳 56.7、DASH)/ Brute(112px/s、跳 49、SLAM);技能是
Intent.skill意图不是状态机,PadButton::Skill=3排最后。 - 道具:宝石 / 红心 / 护盾 / 星(无敌);怪:巡逻 / 飘浮 / 炮台 / 弹丸(都无物理体,轨迹与帧率无关)。
- 判据:
all_twelve_levels_are_clearable_by_the_bot实测 131882 帧 / 17.9s,12 关 × 2 角色全通,每关受伤 ≤2;内容层三条间距判据(怪不压坑 / 离坑 ≥一跳 / 怪间 ≥88)。 - 三个血坑:踩怪不能比「脚底 vs 头顶」(落地帧速度被清零 ⇒ 踩死变撞死);
fall_vy必须在物理步之前采样;出生点on_ground第一帧就得 true(否则开局按跳被静默吃掉)。 - 宿主:
me_coin_run_start/continue,state追加STATE_LEVEL_COUNT(21→22)让「关卡 1/12」的分母来自引擎;页面加选角条 + 空格继续。 - 顺带重标
apps/macos-demo四条像素判据(配色改由关卡数据决定);两条是改判据本身:顶点「都在框内」→「与画面相交」、实心度允许一组颜色(玩家 = 身体 + 高光)。 - 全量 CI 128s · 1484 测试 · 42 ✓(2 项降级:微信真运行时未登录 / 1 个 ogg 未入索引);wasm 344.7 KB。
- 玩法:12 关 7040…14080 宽(
三个内存池(S3-4):按「谁能决定它的死期」分,不按「数据多大」分
为什么:
lib.rs从 9 月就承诺了三个池,代码里一个没有。承诺了却不存在的接口比没有承诺更糟——下一个人按文档去用,或在第一帧发现它不在,或按文档自己实现一份。它也是S4-5资源系统的直接前置。分界线是「谁能决定它的死期」:
FrameArena(帧末 reset,只归零游标)/AssetHeap(按分包整体还)/Persistent(进程结束)。分不清的后果不是崩溃,而是每一处都退化成「看着差不多就 Vec::clear 一下」。三条判断:① 超预算返回
None,不 panic 也不扩容(wasm 里 panic 就是整局闪退);② 失败不改状态(手写 bump 很容易先推游标再判越界,一次失败毁掉后面全部);③reset不还内存(帧内数据生命周期全不一致,但一定死在同一时刻)。零 unsafe:
Vec<u8>当底座、把分配表示成区间。底座自己修一次对齐:Vec<u8>只保证 1 字节对齐,建池时多要 15 字节跳过开头几个字节使绝对地址 16 对齐;非 2 的幂的对齐值一律按 1 处理(位运算写法在 align=3 时给出假的对齐,调用方 cast 成[f32]会 fault)。接进 GameLoop:
tick末尾先取账再归零。两件错事的症状会撞在一起——先归零再取账 ⇒frame_used是 0(而「没人用过」也是 0);不归零 ⇒ 第二帧叠成 2048。所以判据写成「同一帧报 1024、帧末归 0」这一对。诚实一句:帧池暂时没有真实消费方(渲染用跨帧复用的 DrawList),
frame_used恒 0 是正常的。要盯的是frame_refusals——非零就是有人降级了,而画面不会报错。判据 28 条(
--lib mem22 +--test memory6):10000 帧后 capacity 与 peak 都不涨(S10「30 分钟不掉内存」的单测形状)· 拒绝后还能装下剩余的量 · 分包卸 9/10 占用落到 1/10 · 压缩后内容不串也不被清成零。坑:
compact先搬后清原位会毁数据(空洞在前 ⇒ 源在目标之后,重叠,清原位把刚搬的抹掉大半,症状是某些包变全零,看起来像「还没加载完」)。//!里连本模块自己的 item 都不在链接作用域,引用式定义也不行,必须写全crate::mem::FrameArena。顺带算清「我还能自己走多远」:A2 未完成 20 条 = 11 条能动/44 人日 + 9 条被卡/35 人日;被卡的 9 条里 4 条是我自己的前置(S6-3→S6-6→S6-7、S7-4→S7-5、S10-3→S10-7),都在能动清单里。真正卡在外面只有 5 条,已开
N-211要排期。结果:
49fce4c· CI 149s / 1451 测试 / 2 项降级运行时读 cooked 场景(N-040):那句「只读 mirb」终于指着一个存在的东西
为什么先做:
N-040是板上唯一一条 A1 在等我、且卡着「可玩切片」的条目(到期 11-07)。做了:
me-runtime加me-cooked(path,L5→L0 审计通过)· 新模块cooked.rs(LoadedScene::load)·lib.rs那句「只读mirb」改成指向具体入口。8 条判据全是真字节往返。我加的一条:只留
DrawList、不留Scene。两者是同一条记录的两种形态,都留就是每条 52 字节的双份常驻。判据里最值钱的两条:名字用指针落在
bytes区间里验「借的」而不是「拷的」(字符串相等对拷贝同样成立);真实示例那 4 条按me build --verbose报出的字段拄成常量——手工构造的都是整数位置全白着色,而真实内容里有layer=1000的 UI 条、rot≠0的旋转条。跨命令那半我只做得到一半:
me pack的draws: N↔items.len() == N要等dist/里有.bin(N-039在 A3)。我做的是「编出 4 条 →encode/decode→ 读回 4 条」——证明格式对真实内容保真,不证明 pack 写出的字节一致。两个坑:
//!模块文档里use引入的名字不进链接作用域([DrawList]照样报找不到);CI 跑的时候手动跑build.sh会抢同一份target/,第二次 CI 红在 site 报 markdown 缺失,第三次复跑EXIT=0而代码一个字未改。顺带:补登
S3-9——性能基准那批做完后看板一直空着,五条 DoD 落四条,差的只有微信 ≥30fps。结果:
aecda70+6b78a0c· 全量 CI 71s / 1423 测试 / 2 项降级项目板全量重核:8 处陈述已和仓库不符,而它腐坏时不报错
做了什么:把项目板(id=49)的 description 与 notes 逐项对了一遍仓库,不是只改个百分比。目的是找出「哪几句已经不真了」。
查出 8 处过时,每一处都是静默的:工程量 383 文件/96,136 行 → 591/169,253(标签写「10-24 快照」却贴着 10-22 的数,一天之内看上去完全正常);crate 13→14(me-cooked);契约 13→14 份(rhi.ffi.h 已 v6,板上还写 v4);测试 790→1331;CI 17 步→33 步 144s;ADR-001/008 已 Accepted 3-4 天而板上仍写 Proposed/待裁决;D0 6/6、M0.2 4/4 已收口而板上还写 4/6、2/4;me pack 早已实装(dist/ + pack.json + 四档预算 + exit 70 自校验)而板上写「仍是占位」。
同步结果:进度 32%→33%(141/433 人日、37/110 任务),与 /arch/ 与 /board/ 同值;wip 3 条→4 条并逐条重写「还差什么」(S2-4 差图集分配等 S3-6、S2-9 基准 0/3、S3-8 只差真机手指、S6-8 已拆掉包体分析)。
为什么能腐到这程度:本板是手工同步的——CI 跑 33 步没有一步看它,它不会变红也不会变旧,只会静静地看上去「正常」。
改法(不是「下次注意」):notes 加前置纪律「快照日期必须与数字同时取,更新前先跑
--scale,不许贴上次的值」;已知缺口新增第 ⑩ 条,把「手工同步、腐坏不报错」写成显式缺口;D0 标题里的 FFI 数字换成当轮 CI 实测 12.34/10.34/11.23 ns(旧值 8.4/9.5/11.4 不写日期就会被当成当前值,相差 47%)。顺带修正我自己写错的两处:ADR 段初稿写「002-0006 一系列已接受」,而 ADR-002(wasm-first)恰好是仍悬着的两份之一;另,
ADR-001…008与ADR-0002…0012是两套并存编号,光看号分不出哪套。证据:
build_board.py --scale·/tmp/ci-1025.log(33 步/144s/1331 测试)·interface/MANIFEST.json(14 份)·crates/me-cli/src/pack.rs(83KB)· commit65ffbe4NEON BREAK:一个能玩的打砖块,热闹时一帧也只有 2 个 draw call(P9)
这一批问的是「合起来能不能玩」:320×180、一个 wasm 模块、一个 canvas、固定步长循环,200+ 四边形、碎片带旋转飞出容器 —— draw call 正好 2。真机
b=2 q=152 brk=30 lv=1 clip=1 ev=57 f=3000(24 秒游戏时间)。2 是下界不是目标:批次键
(texture, clip),两条裁剪上下文 × 两张贴图 ⇒ 下界 2,判据写「任何一帧不超 2」。这条判据被自己的装饰毁过一次——命原本画成三个场景图集小方块,同一张贴图在「裁」与「不裁」各出现一次 ⇒ 必然断两次 ⇒ 批次 3。改成"I".repeat(lives)走字体那批后回到 2。判据:
--test breakout22 条(玩法内核零 GL)+--test breakout_render14 条(NullBackend);600 帧max_batches == 2、max_quads > 140;900 帧里至少一帧真的走了 GPU scissor。ev=57验的是跨 C ABI 的第 17 个字,单测证明不了它落在页面S.events = 16上。真 bug:打掉最后一块后球还在飞(
Phase::Cleared飞 0.7 秒),半秒后从底部出去 ⇒ 扣命 ⇒ 状态拨回Ready,关卡停在 1。庆祝阶段必须停掉失败判定,而这条只有「打完整一屏」的测试碰得到。坑:① 位图字体
0>7补零 +scale 2.0⇒ 七个「口」;② 碎片横向初速 ±60 飞不出容器,判据红得莫名其妙,给 ±130;③ 无头自检要取整段最大值不是最后一帧(clip=0假红)。音效:引擎不发声(wasm 无输出设备)。内核报
EV_*事件位(第 17 个字)读完清零,页面用 WebAudio 发声;微信侧要用InnerAudioContext。证据:
apps/coin-run/breakout.html(serve.sh --open breakout)·crates/me-render/src/breakout/{mod,render,wasm}.rs·evidence/p9-neon-break{,-play}.png·run-breakout.sh· 全量 CI 170s/876 测试 · commit93c146c
2026-10-24
批处理吞吐实测:1000 批 p95 31.7ms vs 3 批 0.2ms(P8)
做了什么:S3 的 DoD 有两条关于性能:「1000 sprite 批次数 ≤8」(可数)与「性能基准进 CI,超阈值报警」(要量)。把两件性质不同的事塞进同一个门里,两件都会不可信(一条「必须 <16ms」会 flaky → 被 ignore → 没人再跑)⇒ 拆开:计数进 CI 判红,墙钟只打印。新探针
wasm_perf(1000 个 8×8 铺满 320×200,三贴图轮转)+ 判据页perf.html+run-perf.sh+ CI 一步(11 项)。- 反直觉结论:批处理不省 CPU。主机侧 1000 精灵提交 9.6 µs(画家顺序)对 17.9 µs(批优先,含排序)——批优先更慢。省下的开销在驱动里,而主机侧 NullBackend 没有驱动,所以 bench_2d 永远看不见它。
- 真机数字(Chrome + SwiftShader,同一份精灵集合、光栅化工作量相同):提交 p95 21.9ms 对 0.3ms;帧 p95(每帧 gl.finish)31.7ms 对 0.2ms —— 前者吃掉 30fps 的整个帧预算。
- 踩的坑:画布高必须取 200(8 除不尽 180,半行会污染 A/B);标题里不能有
</>(--dump-dom转义后case匹配不上);--dump-dom连<script>源码一起 dump,正则会把字符串模板当数据行。 - 证据:
crates/me-render/src/wasm_perf.rs、tests/perf_js_table.rs、apps/coin-run/{perf.html,run-perf.sh,evidence/p8-perf-batches.png};提交7cbf638;全量 CI 208s 通过(0 红)。协商板N-209通报 A1:docs/10 那句 DoD 要不要改口径。
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 ;可玩页
COIN RUN 通关宣传片:离线逐帧录制 + 自动通关脚本(10s / 1080p60 / 带音频)
- 成片
apps/macos-demo/evidence/coin-run-promo.mp4:10.03s / 1920×1080 / 60fps / 432KB。不录屏,走离线逐帧 —— 帧率不受负载影响,音频指令按同一帧号从引擎取走(同步是构造的,不是对的),可复现,不碰屏幕录制权限。 - 宿主新增
ME_DEMO_RECORD(每帧写 PPM)/ME_DEMO_TRACE(帧级轨迹)/ME_DEMO_SIZE。⚠️ 录制分支不调me_md_tick:renderOffscreen内部就带advance,两个都调会录成两倍速,而两倍速在任何静帧判据里都看不出来。 - ⚠️ TRACE 是必需品:只给
OUTCOME的话「撞刺」与「掉坑」都是 Lost,修法正好相反。靠它调了 5 轮,拿到通关脚本:280 帧 / 6-6 金币 / 零失误 / 4.7 秒。帧号与MOVE/JUMP/重力绑定,改了要重调。 - ⚠️ 这台机器的 ffmpeg 没编译 freetype/libass(
drawtext、subtitles都不存在)⇒ 文字改用 Pillow 渲 PNG 再 overlay。PingFang.ttcPIL 打不开,改用 Hiragino Sans GB W6 + SFNSMono;等宽空格是一个字宽,COIN RUN得拆两词画。 - 编排
make-promo.sh(一条命令 46s 重出)+promo_cards.py;判据 A-E 复跑全绿。关卡内容只占下半屏,4:3 摆进 16:9 时两侧放「本片成绩」栏而非黑边。
- 成片
RHI v6 scissor 后端落地:三态各有名字 + 义务 21 每次 begin 归零(N-201 后端侧)
- 前置:A1 的
ff018a8把me_rhi_set_scissor+ ADR-0011 放进 main,N-201那句「等 v6 契约窗口」失效。这一批补 A2 那半:后端 thunk + 胶水 + 判据。 - 驳掉一个顺手就会写出来的错:把
None(关裁剪)与0×0(裁到空)合并。它们在多数驱动上结果相同,于是「关裁剪」很自然被写成scissor(0,0,0,0)。但那是恰好对:某个后端优化掉空 scissor 并顺手关掉SCISSOR_TEST,整块就会被画出来,不报错。 - 所以胶水新导出是
me_gl_set_scissor(enabled, x, y, w, h):enabled独占一个判别位。关 =disable;裁到空 =enable+ 0×0;按矩形 =enable+ 矩形。判据是调用序列,不是「调过就算」(enabled恒为 1 的实现能通过「调过」那条断言,而那意味着裁剪永远关不掉)。 - 义务 21 是状态不是命令:空后端加
scissor()访问器回答它(日志里「没调用」与「上个 pass 设过」长得一样);webgl2 必须真的发一条disable——SCISSOR_TEST不会因为换了 pass 自己复位,残留不报错、只让画面少一块。 - y 要翻:契约原点在目标左上角,GL 在左下角,中间夹着「当前目标多高」。胶水在 begin 记
passTargetSize(RT 高 ≠ 画布高)、end 清回画布。拿画布高去翻的后果是离屏那遍裁剪框整体错位,错位量 = RT 高 − 画布高,画面只表现为「少画了一块」。三条测试分别钉默认帧缓冲 / 绑 RT / end 之后。 - 校验只有一处(
backends::validate_rect):只判负尺寸,越界不判。cap 层与两个后端都不重复判,否则会出现「记录器接受、真机拒绝」这种只在换后端那天才发现的差异。 - 胶水缺这条导出时返回
Unsupported,不假装成功:假装成功的症状是「裁剪不生效」,与「裁剪算乱了」长得一模一样。 - 这一批不做:
me-render的消费端(旋转精灵走 GPU 裁剪、clip_approx降到 0)。它要动批次键(切 scissor 必然断批),8 个真机判据页都得复跑 —— 记下一批。N-201因此仍是待落地。 - CI 248s 全绿;me-rhi lib 测试 67 → 70 + 3 条新集成(
tests/scissor.rs),胶水测试 30 → 33。分支agent/A2c650524。
- 前置:A1 的
关卡外置:`const` → `.lvl` 数据,改一行就改世界(已附端到端验收)
- 关卡从
const变成数据:新增crates/me-runtime/levels/coin-run-1.lvl(行式文本,#注释),src/coin_run/level.rs负责解析(带行号的错误)。 - 用
include_str!嵌进二进制:.app双击时工作目录是/,wasm/微信小游戏根本没有文件概念 —— 三个目标行为一致。改关卡仍需重编译,但改const本来也要。 - 解析器两条不静默的规矩:未知字段报错(
platfrom静默跳过 = “那层平台不见了”)、参数多了报错(“我改了宽度怎么没生效”);nan/inf也拒(所有比较恒为假)。 build_world改成接受&Level注入,并新增 4 条测试:世界跟随数据 / 出生点同时移动精灵与碰撞盒 / HUD 金币总数跟随 / 两段地面都铺到视口底。- HUD 里写死的
0/6改成coins.len()(3 处),LIVES常量取代两处各写一个3。 - 端到端验收:临时注释掉最后一枚金币 →
COINS_LEFT 6→5,且两帧像素差异只在x 320..351 / y 13..47(正是 HUD 最后一个字符6→5的位置),其余零像素变化。 - 新增 12 条关卡测试(含“常量与文件一致”的镜像检查)。`
- 关卡从
没声音的真因:空图 prepare() 抛 NSException —— 一行修复,附判据 E
- 真机反馈「从 Finder 启动也没音效」⇒ 根因不是会话类型、不是音量、不是波形。
- 根因:
AVAudioEngine是惰性建图的,而prepare()假设图已建好。 建出来直接prepare()时 graph 里连outputNode都没实例化,AVAudioEngineGraph::Initialize断言inputNode != nullptr || outputNode != nullptr失败,抛NSException绕过do/catch。栈顶就在-[AVAudioEngine prepare]。 - 修复是一行:
prepare()之前先_ = e.mainMixerNode(getter 才会实例化 outputNode 并连上)。最小复现 20 行验证:不碰 → NSException;碰一次 →running = true。 - 上一版归因是错的,已在代码注释里订正:写成「非 GUI 会话(终端/沙箱/ssh)拿不到音频硬件」,并用「
system_profiler明明列着默认输出设备」当反证。错在证据只有「终端里跑没声音」——而双击启动根本没有终端可看。用open -n(LaunchServices,与控制台双击同会话)复现,一样失败。 - 判据 D(上屏)之外新增判据 E:
ME_AUDIO_PROBE=60报引擎在跑 / 节点已挂 / 淡入到满音量。实测AUDIO_TAKEN 60 CMDS FRAMES 60+节点 1 · 运行中 · mixer 1.00 · 当前语音音量 1.00。 - 探针自己踩了一个坑:
audioProbe分支没走固定步长,连跑 N 帧的dt差分为 0 ⇒ 30 帧只取到 3 条指令(全在第 0 帧),而同一份代码走 dump 是 30 条。判据红的与被测行为无关。 - 另加落盘诊断
(本机路径):双击启动没有终端,log show又要非沙箱权限 —— 起不来的结论必须落在磁盘上。
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 测试全绿。
P13b:Mac 窗口全黑 + 闪退 —— 三个判据照不到的宿主缺陷
- 起因:只说「启动一下 mac 测试」,结果窗口开了两次都没画面,第二次弹了系统崩溃框。查出来是三条独立原因。
- ① 上屏路径从来不推进逻辑(P12 的回归):
SpriteRenderer.draw(in:)只encode,没有advance—— 那是 P12 抽出来时只给renderOffscreen加了调用。症状:窗口开着、标题里的分/命/剩都在动、画面全黑、标题写0 顶点 · 0 批,而 A/B/C 三组判据全绿(都走离屏)。活了两个批次、一次「能玩」验收。 - ②
AVAudioEngine抛 NSException,do/catch抓不住:从非 GUI 会话启动时拿不到音频硬件(system_profiler明明列着扬声器是默认输出)。试过三条都不够 ——do/catch(只抓Error)、查 HAL 默认输出设备(查得到照样崩)、AudioUnitInitialize探一遍(返回 noErr 成功照样崩),根因是outputNode的 getter 本身就会抛。最终新增 20 行 ObjC 桥Sources/ExcBridge.{h,m}用@try兜住,降级成「本次运行静音」。 - ③ 真正让人以为「一直在崩溃」的是启动时的恢复提示框:崩溃过几次后
NSPersistentUIRestorer会在applicationDidFinishLaunching之前弹模态的「要恢复窗口吗」,NSAlert.runModal把回调整个挂住 —— 进程活着、窗口不出现、脚本一行输出都没有。sample的栈里才看得见。修:UserDefaults.register(["ApplePersistenceIgnoreState": true])+window.isRestorable = false。 - 新增判据 D(上屏路径自报数):
ME_DEMO_LIVE_FRAMES=30→LIVE VERTICES 80 FRAMES 30 FRAME 30。不碰 drawable(currentDrawable在没有显示链路时会阻塞等 vsync,第一次接进 CI 挂了 5 分钟)。 - 判据自证的教训:第一版把
advance写在 live 分支里,删掉正式路径那一行仍然是绿的 —— 判据验的是它自己。改成推进只留一处(DemoController.draw开头),SpriteRenderer.draw改名render(in:)只管编码。现在删那一行 ⇒VERTICES 0 FRAMES 30 FRAME 0。 - 顺带:
codesign … 2>/dev/null的静默失败(.o误进Contents/MacOS)改成显式报错。 - 数字:CI 62s 全绿;1286 个测试;
--check摘要从 5 个 OK 变 6 个(MAC DUMP OK + 4×COIN DUMP OK + LIVE OK);真机窗口标题80 顶点 · 2 批 · dt 16.71ms。 - 提交:
fc1d7ae(主体)+21f63e0(文档数字)+ca812a1(真机窗口截图证据)。
N-207 + N-202:守卫认不出第二张表(main 本身就坏着);dump() 补上 uv/color
- main 的板子本身就是坏的:
Team/negotiation.md的 §4 汇总表一直是两块(98~141 行有表头、143~169 行无表头且逐行相同,rebase 的「两边都留」)。旧守卫只比对第一块 ⇒ 全绿,A1 和 A3 都在这个坏板子上改状态。 - 修法:
table_blocks()扫所有块,len(blocks) > 1直接红并给出行号范围;识别不靠表头(复制出来那半张没有表头,只按表头找等于漏掉它,判据是「连续|行里出现过表头或编号行」且只认围栏外);--fmt删多余块,判据是修复后与真板子逐字节相同。修完当场的下一次 rebase 又复制了一份,守卫红了、--fmt收敛、cmp相同 —— 同一个现场旧守卫是绿的。 - 守卫自己也有了测试(
Team/test_check_negotiation.py,8 条):它是唯一会发现板子坏掉的东西,于是它坏掉时没有任何东西会红(CI 跑的正是它)。自测用真板子的表体造副本(去掉表头),CI 里先跑自测再判板子。两处破坏演练都红:拿掉块数判据 ⇒ 端到端那条红;退回只按表头找块 ⇒ 3 条红。 - N-202 落地(A1 在 N-035 批准):
dump()补上uv与color,规则沿用rot那条(只在非默认时打);missing_fields从["uv","color"]变成空数组。 - 「漏字段」变编译错用穷尽解构,不用反射:
let DrawItem { texture, layer, z, pos, size, uv, color, sort_y, rotation } = *it;,加一个字段就E0027。演练:给结构体加pub drill: u8⇒ 构造点先E0063,补上后解构点E0027,两处都红。但穷尽解构只保证「测试提到了所有字段」,不保证「dump 打了所有字段」 —— 所以另加两条内容判据(HUD 那条 color 恰好出现一次;uv 默认时不许出现)。 - 末端判据:
mir-demo.html的hudTint()—— HUD 乘(255,128,128)后画面里 19.5% 的像素红分量高于绿分量(4096 个像素);改回共用sc.defaults.color⇒MIR DEMO FAIL/0.0%。旁边那条旋转判据在同样故障下全绿 —— 这个 bug 活了那么久,正是因为没有任何一条判据看得见它。 - 最大的教训:分支上的板子会落后 main 一个世界。
watch.py在我分支上说「没有一条是等 A2 的」,而 main 上有 42 条、其中 5 条是 A1 答复我的(N-032 cooked 场景名、N-033 D0 6/6、N-034 scissor 进 v6、N-035 uv/color 都加、N-029 看板选 A)。我提的 N-206/N-207 从来没上过 main,A1/A3 一次都没看见。以后动板子前先git fetch && git log origin/main -- Team/negotiation.md,rebase 时板子一律--ours,自己的条目在 rebase 之后重加。 - 数字:workspace 1286(分支)/ 1271(main);
me-compilerlower 25 → 29 条;MIR 判据 2644 点全过;CI 138s。 - 提交:
48b2d1d+f5b2970(agent/A2,rebase 后--force-with-lease);main 上a483dec+86e07b7(守卫与它抓到的第一份体检报告,纯共享基础设施按例外单独上 main)。
- main 的板子本身就是坏的:
P13:Mac COIN RUN 补音频 + 结算面板 + 按 R 重开(逐像素验过)
- 结算:结局那一帧一次性 spawn 260×76 面板(
Sim.panel记),HUD 搬进面板变三行居中 +max_width。实测面板 173899 px / 实心度 0.857,顶部白像素 0、全图白像素 8467。 - 重开:
restart清四样东西 —— 语音stop_all()、调度表clear()、定步长余量reset()、ctx.frame归零(新增GameLoop::ctx_mut())。最后一个洞是 Mac 离屏判据抓的:重开后第 1 帧与全新一局第 1 帧差 75 个像素(金币悬浮相位接着上一局,ctx.frame % 120)。补完逐字节相同。 - 音频:
AudioEvent::Play补voice(audio-ffi.md的me_au_play(voice, …)一直是带 voice 的,代码与自己的提案不一致而无人报错)。FFI 布局改成[kind, voice, sound, looping, left, right]。 - Mac 侧:
Sources/CoinAudio.swift一个算式合成器(正弦/方波 + 包络,无随机数,判据可复算)喂两个消费者:实时AVAudioEngine+ 离线OfflineMixer→ WAV。 - 判据:
build.sh --check三组 —— C 打到输(240 帧一直按右键)验面板 + 音频流水 + WAV(2ch/44100/16bit/4.000s,有声 0.945),D 第 240 帧按 R 验「与开局首帧逐像素相同」。 - 坑:离线混音第一版在
Stop时直接删语音 ⇒ 已响过的那段也消失,LOUD从 0.94 掉到 0.008。改成记end时刻。 - 数字:game_slice 31 条 + demo 22 条 + workspace 1282 条;CI 103s 全绿;提交
49a7cda。
- 结算:结局那一帧一次性 spawn 260×76 面板(
合并 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。
- 为什么合:发版前核对
第十八批 P12:COIN RUN 在 Mac 上能玩(同一份 Game,两个宿主)
- 演示不抄玩法:
apps/macos-demo直接依赖me-runtime,键按下翻译成PointerEvent,与 wasm 宿主走同一个Game::press。Mac 侧另写一遍「右键=向右加速」的话,今天一样、三个月后必不一样,而没有任何判据会红。 Game不是Send(系统是Box<dyn FnMut>)⇒OnceLock<Mutex>编译不过,换thread_local!{RefCell};顺带删掉上批的static SERIAL: Mutex——串行化是把并发问题按下去,不是解决它。- 保比不铺满:逻辑画布 320×240 进任意窗口,
s = min(vw/320, vh/240),余量居中。判据期望值是320·vh/(240·vw);1024×768 上「铺满」也是 1.0000,这个尺寸抽不到它。 - 实测:判据 A(武术)覆盖率差 −0.000 / 重心 +0.001;判据 B 宽高比 1.0000 / 2 批 / HUD 白像素 3704 / 五种物件实心度 1.000;对照不按键
x=24.00→ 按右键 30 帧x=84.01。单测 24+17 条,workspace 1275 条,CI 57s 全绿。 - 证据:
apps/macos-demo/evidence/p12-coin-first.png与p12-coin-moved.png、check_dump.py --coin、提交dfb6512。 - 最值钱的坑:图集是白色+alpha,颜色判据对纹理完全不敏感。「所有批次都用第 0 张贴图」的破坏演练第一版全绿,因为乘上顶点色后颜色逐值不变,变的只有形状。换成数包围盒里非底色像素的实心度才红(1.000 → 0.133/0.185/0.203/0.238)。判据要抓的是「哪条路错了会给错答案」,不是「改动之后哪里变了」。
- 另一条:
rebase把协商板 §4 汇总表复制成两块而守卫只认第一块 ⇒ 全绿。已手删,缺口转成 N-207 给 A1(check_negotiation.py归 A1)。
- 演示不抄玩法:
紧排图集接进 Mac demo:anim.rs 支持矩形表,Metal 那一侧也画对了
- 图集紧排落地:18 帧武术图集 1024×1280(内容 49.9%)→ 1024×699(内容 93.3%,面积 −45%)。做法:裁到外接框 → 高度降序 → shelf 装箱(照抄
Atlas::insert)→ 贴图时四周外扩一像素。相邻帧最小差异仍是 79.3,与改造前逐值相同 ⇒ 画面内容没变,只是排布变了。 SpriteSheet从「cols × rows」扩成Layout::{Grid, Rects},新增from_rects(rects, atlas_w, atlas_h, frame_ms)。契约零改动(SpriteInstance.uv从 S3 起就是四元组)。cols()/rows()删掉(全仓无调用方),换grid() -> Option<(u32,u32)>。- 一个必须一起记住的副作用:紧裁把「头在哪一列」这个对齐信息裁没了。所以每帧随矩形存一个锚点
ax(头部中心到矩形左边的距离),消费方按它摆位 —— 只按矩形中心摆,踢腿帧会左右跳。 - Mac demo 改法:先按
ax把矩形放进虚拟的BOX=256格子(底边贴格底、头心对格子竖中线),再整格缩放到屏幕目标框。舞台与 18 格缩略图走同一份place(),两边各写一遍必然出现「舞台对、缩略图歪」。 - 真机判据:
build.sh --check离屏渲染 → PPM → 比基线,MAC DUMP OK:舞台覆盖率差 0.000、重心差 +0.001 / +0.002(阈值 0.03 / 0.02)。基线gen_expect.py是按同一套摆位算式独立写的第二份实现,不是拿实现验实现。 - 踩到的坑(值得记):①
SpriteSheet的文档链到私有Layout⇒ rustdoc-D warnings拦下,CI 红在这一步。②apps/macos-demo是独立 workspace,根cargo test/clippy --workspace永远看不到它 —— 补 CI 之前它带着 12 条-D warnings级错(11 条unsafe extern "C"缺# Safety)没人知道。③ 这个 crate 用static Mutex存全局状态,并行测试里frame()写、frame_no()读互相踩 ⇒ 加了static SERIAL: Mutex<()>串起来;重跑就绿的红最容易被当噪声放过。 - CI:新增一步「Mac 原生(Rust 侧)」跑该 crate 的
cargo test+clippy -D warnings(不需要 GPU/swiftc,任何机器都能跑);全量 CI 由 1233 个测试通过。 - 报备:改了两个
open路径(apps/macos-demo/**、tools/ci/ci.sh),已Team/say.py --kind fyi。
- 图集紧排落地:18 帧武术图集 1024×1280(内容 49.9%)→ 1024×699(内容 93.3%,面积 −45%)。做法:裁到外接框 → 高度降序 → shelf 装箱(照抄
Mac 原生 demo 跑通:Rust 出顶点,Swift+Metal 上屏(第一批 · 武术 18 帧)
- 新增
apps/macos-demo/:能双击的 .app。Rust 编 cdylib,只出顶点(20B,已转 NDC)/ 索引 / 批次表;Swift 写窗口 + Metal 管线。零 Cargo 依赖(swiftc 不进 Cargo,也不动根 Cargo.toml)。 - 切分的理由:
me-rhi在非 wasm 宿主只接NullBackend(native 发不出 draw call),但me-render::batch的产出本来就后端无关。这一批兑现了那句话——同一份批次表,WebGL2 和 Metal 各画了一遍。 - NDC 换算复用了
RhiSink::upload_geometry的算式(在 Rust 侧做,不在着色器里),所以两边顶点逐字节相同,画面才可比对。 - 真机判据:
build.sh --check→ 离屏渲染 → 读回 PPM → 和expect.json逐项比。实测舞台覆盖率 0.249/0.251、重心差 +0.001、18 格缩略图全在 ±0.04、高亮 1.69×。 - ⚠️ 踩到一个只有数值判据能抓的坑:纹理上下颠倒了。窗口截图里看着完全正常——武术素材本来就有一堆倒立/翻滚帧,全局颠倒被当成“这一招就这样”。只有重心项(0.464 vs 基线 0.535)红了才暴露。
- 破坏演练三处全红:缩略图 uv 错一帧 / 高亮失效 / NDC 的 y 不翻转。
apps/macos-demo/已登记到 A3 owns + 第 10 条 open;CI 加一步(无 swiftc 明确跳过)。全量 CI 52s exit 0**。- 第二批待做:COIN RUN 可玩版(键盘 + me_runtime::coin_run)。
- 新增
演示页加统一导航条与总览页 menu.html(13 页)
- 新增
apps/coin-run/nav.js:一行<script src>注入顶部导航,按「玩 / 看 / 判据」分三组,当前页高亮。用position: sticky而不是fixed—— fixed 会盖住 wushu 舞台顶部,判据读的是 canvas 像素,遮住就看不清在验什么。 - 新增
apps/coin-run/menu.html总览页:12 个页面分三组列卡片,每张一句说明 + 一行提示。打开演示.command与serve.sh --open menu默认进这一页。 - 13 个
*.html各加一行 script(12 个原有 + menu 自己)。 - CI 加两条清单检查(
tools/ci/ci.sh):① 每个 html 都引nav.js;②nav.js提到的.html必须真实存在(死链在浏览器里看起来就像页面坏了)。都做了破坏演练:改错一个文件名能判红。 - 判据页结论行一个都没变(这是验收条件):wushu 18/18、anim 12/12,其余 8 页 atlas/text/scale/mip/rotate/nine/mir/demo 全部 SELFCHECK PASS,mir 2644 像素 0 对不上,demo 八面板正常(合批 4096 精灵 1 批、99 µs/帧)。
- 全量 CI:exit 0,50s,新检查显示「13 页都有导航且无死链」。
check_bash.py21 个脚本通过,归属自检 6 处协商共享已向 A3 报备。
- 新增
P9 用生图素材跑 P8:18 帧武术动作,三个反直觉的坑
- 素材:CloudBase 云函数
genImage(混元HY-Image-3.0-Plus,走成长计划赠送额度,不额外扣费)生成 3 张图、每张 6 个人物 = 18 帧。三张原图与提示词都入库(apps/coin-run/wushu/gen/*.jpg、prompts-sheet*.json),可复现。 - 为什么一次生成六个动作:逐帧分别生成时人会长得一帧一个样 —— 而肉眼看单帧全都对,只有连起来播才发现是六个人。同一次生成的一致性由模型自己保证。
- ⚠️ 坑① 白衣服会被当成背景抠掉。背景近纯白 + 白练功服时,衣服与背景色差只有 10、描边是 135。按「与背景色差得远 = 前景」判,整件衣服落进背景只剩一圈描边;反混合 α 趋 0 除出来是黑的 —— 第一版十六帧里一半人穿黑衣服。正解是从画面边界漫水填充:与边界连通的那片才算背景,衣服被描边围住就自动算人物,什么颜色都无所谓。
- ⚠️ 坑② 「AI生成」水印不是淡的:实测 alpha 峰值 1.00,和人物一样实心,按「淡」筛一条也滤不掉。能分开的只有面积(人物 3~4 万像素,字块 200~1000)。更早一版按外接框面积筛还会长出一帧只画了一个「A」的假帧(框 40×50 过门槛,前景像素只几百)⇒ 筛前景像素数,不筛外接框面积。但真正解法是改构图:提示词要求画面底部留 12% 空白,水印落进空白带 —— 把噪声从数据里赶出去,比事后挑出来便宜。
- ⚠️ 坑③ 逐帧缩放让踢腿像呼吸:踢腿帧外接框突然变高,按框高逐帧归一会让整个人缩一下。改为按源图分组、组内统一缩放,基准取身高中位数;水平锚用头部中心而非框中心(腿横伸会把框中心拉偏,人突然向左跳)。
- 判据三条(全是「错了照样能播」):18 格非空 / 相邻帧必须不同(两个顺序都查)/ 脚底都在 249±3。门槛
MIN_DIFF取 20 而不是「不为 0 就算不同」—— 实测最小 79.3,设 0.5 只抓得住「两帧一模一样」。 - 破坏演练三轮:插重复帧 ⇒
生成顺序里重复帧 0→0;Loop 取余改四舍五入 ⇒loop@89 得到 1,应为 0;把once@1620期望 17 改 0 ⇒ 两条同时红,其中「同 elapsed 异 mode 必须不同帧」那条也红了(改完两者都返 0,对照没了)—— 这条红得最有价值:把对照改成一致会被抓住。 - 实测:真机
WUSHU OK 18/18(最低内容占比 13.9%、相邻最小差异 77.0、帧号表 11/11),CI 53s 全绿(新增一步 5 项,REPORT_PAGES 10→11)。截图evidence/p9-wushu.png。提交acd1d84已推agent/A2。
- 素材:CloudBase 云函数
P8 帧动画:整数毫秒 → 帧号 → uv,契约零改动(真机 12/12、19200 判据)
- 契约零改动:
SpriteInstance.uv从 S3 起就是[u0,v0,u1,v1],一帧动画要的东西它已经全有 ⇒DrawItem/render.pass.md/MANIFEST.json一行没改。缺的从来不是「能画出某一帧」,而是「哪个时刻该是哪一帧」。 - 三条判据都是「错了也能跑」:帧与帧之间没有几何变化,帧号错、uv 偏一格,画面上都还是一张会动的图。① 整数毫秒且只除一次(
f32逐帧累加一小时漂几十毫秒 = 正好吃掉一整帧);②Loop用(elapsed/frame_ms) % n,不先乘回毫秒(n*frame_ms在overflow-checks下当场 panic);③Once播完夹住不回绕。 - ⚠️ 除零
overflow-checks管不了 —— 它在 Rust 里无条件 panic。frame_ms == 0必须显式返回第 0 帧,而它来自策划配置。 - 素材三通道分工:
R= 每帧左上角一个像素写帧号色(64/128/192/255)⇒ 偏整帧;G= 1 纹素棋盘格,亮格CHECKER[帧](255/192/128/64)⇒ 偏一纹素;B恒 0 ⇒B == 255只可能是洋红清屏色。共用通道等于给错误留后门(「这个 255 是帧号还是棋盘格」)。 - 2×2 是刻意的:
1/3在f32里是0.33333334,边界落在纹素外侧 ⇒ 判据只能写「约等于」,而那种判据没人能复核。 - 12 个副本同一帧,只有
elapsed不同(分十二帧画会毁掉判据:任何一份错了都能被解释成「帧不同」)。第 2 行整行是第 1 行的对照:elapsed=120在Loop下第 0 帧、在Once下第 3 帧 —— 同一时刻必须给不同答案,否则「mode 没被用」会安静通过。 - 测试抓到一次真问题:
Once行四格全在最后一帧,「相邻必不同」不可能满足。那是数学事实,所以改测试不改数据(Once播完全同是正确行为,不是被稀释的判据)。 - 第一版十二格几乎一模一样(只有 1 个纹素不同),放大到屏幕是 2×2 像素 ⇒ 亮格绿随帧变暗。一个看不出在演示什么的演示等于没演示。
- 破坏演练两轮:
uv故意+1帧 ⇒ANIM FAIL tint=12(原因准确);Once改成回绕 ⇒ 三条单测同时红(语义 / 单调性 / 表一致性)。 - 实测:单测 26 条 + 表对照 6 条;真机
ANIM OK 12/12、19200 条判据、批次 1、退白 0;截图evidence/p8-animation.png;CI 140s 全绿(新增一步 32 项)。提交0e7da45已推agent/A2。
- 契约零改动:
演示打不开的两个真原因:端口通 ≠ 是我们的服务;nohup 服务随父进程被回收
- 现象:Safari 打开演示页是一页 404 / 连不上,而服务看起来在跑。两个原因症状完全一样,白查两轮。
- 原因一:上一轮为跑
run-*.sh手工起过服务,--root是仓库根(页面在/apps/coin-run/demo.html)。serve.sh --open看到端口通就跳过启动,转头打印/demo.html⇒ 404。复用没错,错在没问一句「你是谁」。现在复用前先要一个 200,拿不到就在开浏览器之前 exit 1 —— 宁可什么都不弹,也不要弹一页 404。 - 原因二:从 CI / agent 工具调用上下文
nohup起的服务,父进程一退就被回收。地址打印完、浏览器打开时端口已经没了。现在起完立刻探活,探不到直说并指向双击入口。 - 新增:
apps/coin-run/打开演示.command(Finder 双击,父进程是登录会话 ⇒ 服务不被回收);apps/coin-run/test_serve_open.py9 项;serve.sh --no-open。 - 判据支点:把
open换成记账的假货放进 PATH 最前面 ⇒「弹窗了没有」成了可断言的事实,测试本身也不弹浏览器。只有证明「该弹的时候会弹」,「不弹」才是判据 —— 否则把 open 那行删掉,前三条照样全绿。 - 实测:Safari 回传
DEMO READY 8/8,why=title-change,UASafari/605.1.15;全屏截图确认八个面板全渲染。headless 截图evidence/demo-gallery.png。 - 顺带:
check_bash.py的discover()扩到.command(双击入口必须是这个后缀,天然逃过 CRLF / 缺 shebang /$VAR(中文)三类检查)—— 这一批正好写了/$FILE,,是它先红了我才发现的。A3 的 owns 路径,已代修登记cross-sector.txt(复核 A2+A3,到期 2026-11-07)并 fyi 报备。 - CI:42s 全绿,新增一步「演示可达」9 项;workspace 1186 测试。提交
add36b8已推agent/A2。
判据从「某个人看见过」变成「有记录」——Safari 在屏幕休眠中也能验收了
起因:上一批做完「Safari 一条命令打开」后我想自己验收 ——
osascript读title被 TCC 拦(-10004),截图时屏幕睡着截到壁纸。页面很可能已通过,而我无法知道。做法:判据多了一个读者。页面
verdict-report.js盯<title>变了就POST /verdict,新增的serve.py(http.server超集)落到/tmp/coin-run-verdicts.jsonl,serve.sh --verdicts直接 cat。绑 127.0.0.1、4 KiB 上限、no-store(顺手治 Chrome 磁盘缓存老坑)。八个run-*.sh与九个自校验页跟着换,CI 加一步静态检查。实测:headless Chrome 两次各回传
DEMO READY 8/8;Safari 26.4、屏幕休眠中也回传DEMO READY 8/8。证据evidence/p7-safari-verdict.jsonl。坑:①
send_error(code, "中文")把 message 放状态行,而状态行只能 latin-1 ⇒ 客户端看到RemoteDisconnected而不是 400;②why=load不代表 observer 坏了(同步渲染十几秒,1.5 s 兜底定时器栈一空就先跑);③ 兜底通路会把静态标题当结论 ⇒ 加initialTitle守卫。CI 全绿 44s(新步骤 17 项,降级仍 2 项);25 处改动全在协商共享路径,已
say.py报备。演示在 Safari 里一条命令打开 + 第 8 个性能面板(顺手修掉 516 倍浪费)
1.
serve.sh --open:一条命令起服务并用 Safari 打开(--open mir/game/selfcheck,--stop收,BROWSER可换)。用 nohup 摘出去,等端口真通了再 open —— 抢在前面就是 ERR_CONNECTION_REFUSED,而「再刷一次就好」最容易被当成页面 bug。2. 结论横幅:
<title>与页面上那行由setVerdict()同一次赋值写。以前只在 title 里,无头 Chrome 抓到、人在 Safari 里看不到。两处各写一套就会出现「CI 判过了而人看到的是旧版」——两边都「有结果」,最难查。3. 第 8 个面板「合批吞吐」(4096 精灵 = 1 批)。第一次跑出 50150 µs/帧,根因是
draw_external每帧OffscreenTarget::new+dispose(尺寸根本没变)⇒ 改成按尺寸复用,97 µs/帧(516 倍),千精灵 12243 → 23.6 µs。⚠️ 七个探针页只画一帧,这个白花开销在它们身上永远看不见。4. 判据落在批次数不是耗时:耗时跨机器差两个量级(Apple GPU 0.07ms vs SwiftShader 50ms),红了的人没法复核。乘色另用两个角的像素判(乘色没生效时前三条全对,逐字节比对也抓不到)。
5. 号段化:一天撞了两遍号(N-008/9 撞 A3,改 N-015/16 又撞 A1 的 15/16/17)。根因不是忘查号,是分支上的条目在合进 main 前别人看不见 ⇒ 改成 A1=1xx / A2=2xx / A3=3xx,守卫加
segment_problems(≥ 10-25 的条目必须落在自己号段),演练过会红。render.pass.md因此一天内第二次升版本,只为一行引用。6. 数字:DEMO READY 8/8 · 69s→18.7s→15.1s · mir-demo 仍 4/4(像素数字一字未变)· CI 全绿 197s · 提交
50a046874982866184b44,已推 agent/A2。7. ⚠️
say.py正文用双引号传时,里面的反引号会被 shell 当命令替换吃掉,内容静默消失而返回 0。⚠️$VAR紧跟全角括号会被 bash 3.2 当成变量名的一部分 ——check_bash.py本来就抓这个,我在「改了还没跑 CI」的窗口里踩的。协商板撞号修复 + 守卫第 5 条 + poke 相位编号收敛成一个
两条跨扇区尾巴,各自堵掉一个「不会红」的失效。
1. 协商板撞号(错在我):提 N-008/N-009 时手上是
92ab276,A3 的同号两条随c26dccf才进 main ⇒ 四行里两行的编号指向的不是自己。它自己不会红(表由正文生成、reply_state_problems用 dict 按编号索引、watch.py照常报「在等」)。已改名为 N-015/N-016,并给守卫加第 5 条(同一编号出现两次即红 + 给出能直接抄的号max+1)。演练过:真板红两条,改完绿。2. N-013:poke 相位编号对齐契约(选 B)。A3 倾向两入口并存,理由是「poke 刻意没有 Move」——这句在代码里不成立:
VirtualPad::update有Move => {},移动不掉键(有测试);且touch_codec线上码也是 0/1/2/3,选 A 会留三套编号。3. 顺带:
render.pass.md升 v11(只为一条交叉链接改指向,sha 变了就升版本);pointercancel从 UP 改发 CANCEL;宿主加pointermove/onTouchMove;新增以前写不出来的测试「按住右滑到左键区域不掉键」。4. 证据:
me-runtime5 条单测 · 宿主 17 项 ·run-demo.sh七面板 7/7 · CI 全绿(契约 50 / workspace 1181 / 协商板 ✓)。提交a043c9a+0916547,已推agent/A2。5. 坑:换编号必须重编
apps/coin-run/wasm/me_runtime.wasm(gitignore)——产物没跟着改时,红的是产物不是代码;这台机器的 bashgrep是 BSD 版,\|不是「或」⇒ 静默返回空,用它找引用会漏,改-E或 ripgrep。P5 · 内容驱动:引擎能画别人给的东西 + 两个演示页
做了什么
me_render_external_frame:按外部给的精灵表(56B/条)+ 纹理表(16B/条)渲染一帧,走与七批探针同一条路径。于是me build的绘制列表第一次有了消费者:.mir的rot=0.5236一路走到屏幕上一颗转了 30° 的金币。- 两个能直接看的页面:
demo.html(七个面板各自一个 wasm 实例 + 一个 WebGL2 上下文同时活着)、mir-demo.html(一份内容变成画面)。 - 新提协商 N-009(A2→A1):
DrawItem::dump()少打uv与color。
实测:mir-demo 判据 2644 像素、精确 99.7%、对不上 0;demo
DEMO READY 7/7且重画逐字节相同;CI 20 步全绿,测试 931 → 944。坑:⚠️ Chrome 复用
--user-data-dir磁盘缓存 ⇒ 改了 html 跑的还是旧页面(DOM 里是旧结论,会让你以为跑过了),八个run-*.sh全中已修;⚠️ 判据漏半像素的症状看起来像旋转方向反了;⚠️ Rust “自己写自己读”的布局测试是盲区,必须有 JS 侧独立对照。P4 · UI 从「能画」到「能编排」:九宫格 + 矩形裁剪
做了什么
me-render::nine:九宫格展开成最多 9 个精灵,不加图元;九块同贴图同图层 ⇒ 合批后仍是一次 draw call。rotation != 0返回错误而不是画歪。me-render::clip+DrawList裁剪栈:未旋转精灵精确重映射 pos/size/uv;旋转的只判整块内外并计入clip_approx。相机剔除与容器裁剪分两个计数。render.pass.mdv8→v9(ui:能画→能编排);协商板 N-008 提给 A1(me_rhi_set_scissor进不进 v6)。
实测与代价
- 真机
apps/coin-run/nine.html(P4):12096 条判据零容差全过,截图evidence/p4-nine-clip.png。零容差靠参数整数化:切边 4、目标 64 ⇒56/8 = 7,每源像素正好 7 屏幕像素。 - workspace 测试 931 个(本批 +56),CI 全绿 110s / 17 步。
坑:三段分割返回值顺序要见名知意(
(a,b,rest)被当(l,c,r)⇒ 三块全错);源图无中间段时目标不能还按三段分(会留洞);「空裁剪矩形」≠「没有裁剪」。扇区边界改三档(新增「协商共享」9 条)+ 协同区搬上 main
- 起因不是纪律,是划分错了。 查 168 条代修登记,前几名全是「同一条路径因同一个机制被跨扇区重复改」:
cross-sector.txt自己 38 次、ci.sh12、minigame-smoke~18、coin-run6+、MANIFEST.json5、me-cli/src6、compiler/passes4。第一条是自指的荒谬——登记越界这个动作本身要改那张表,于是每登记一次就制造一次新越界。 - 三档:① 排他(owns,跨扇区走复核人+到期日的代修);② 协商共享(open,新):责任在 owner 但谁都能改,不要复核人、不要到期日、改完 fyi 报备一句;③ 代修只在①上偶发用。进②的判据可查:同路径被跨扇区重复改 ≥3 次且理由同构。
- 不是全放开:②放的是「谁都要动的实现细节」,①守的是「一方动、全体受影响的面」——契约内容 / ABI / Cargo 骨架 /
agents.json。 - 守卫改动关键一处:
open必须在shared/owns之前短路。apps/coin-run/**在 owns 与 open 里字面相同、specificity 相等,谁赢会取决于max()对相等键的取舍——那是实现细节,不该决定「能不能跨扇区改」。 - 验证:24 条路径逐条断言档位 0 条不符;
--as A2改 open ⇒ EXIT=0,改me-compiler/src/lib.rs/Cargo.toml⇒ EXIT=1(放宽没把排他档一起放掉)。 - 三份 agent-briefs 同步(不然规则等于没发布)。A3 那份多写一段:它 7 条路径被放开最多,要说明「别人改你的目录是预期行为,判断改坏没改坏靠跑 CI,不靠读 diff」。
- 协同区上 main(
32dd1c1):只在 agent 分支上的话,A1/A3 拉 main 看到的是搬迁前的旧世界(plan/negotiation.md还在、Team/不存在)⇒ 「通过 Team 协商」物理上不成立。只摘共享基础设施,不带 16 个引擎提交;ci.sh不能整取(会带上未验收的探针步骤),只手改一行路径。 - 预演了 A3 的 rebase(worktree,不改他的分支):会撞 3 个文件 ——
cli.rs2 块(双方各加一个子命令:main 有Build、A3 有Pack⇒ 两个都留)、ci.sh2 块(同一段代码两代写法,得他自己判断)、cross-sector.txt1 块(两边都留)。这比事后让他自己发现省一轮。 - 顺手补
.gitignore漏的apps/coin-run/wasm/(181 KB 产物;至今没入库纯靠每次写显式路径,等于没防)。 - CI:876 测试 / 16 步 / EXIT=0(main 与 agent/A2 各跑一遍)。
origin/main=32dd1c1,origin/agent/A2=b67b254。
- 起因不是纪律,是划分错了。 查 168 条代修登记,前几名全是「同一条路径因同一个机制被跨扇区重复改」:
网站进 git:线上从此能反查是哪一版
- 起因:「网站可以在git仓库里,发布到线上」。这不是删一行 ignore。
- 事实:
plan/agents.json的generated一直登记着 site/(“由脚本产出但会提交”),而.gitignore里躺着site/—— 矛盾了近两个月没人发现。gantt.html 当年同款矛盾,那次也是改忽略规则。顺带补登记了 site/board/index.html。 - 先定语义,再写判据:site/ = 最近一次发布的快照,不是源码镜像。若按镜像判(逐字节等于构建结果),每次改代码都红——因为页面上有工程量。第一版函数就是那么写的,立刻因为「脚本 15,247→15,356 行」而红,差异全来自刚改的两个 .py 本身。所以 CI 只验「能构建 + 产物完整」。
- 基线改成仓库里那份页面:
git show HEAD:site/board/index.html里的指纹表。旧方案读旁路文件,发版后再构建一次就与线上分叉。HEAD 那份不会被本地预览动到。 - 线上可反查:
/deploy.txt写 commit,写完必须 curl 读回来比对——它存在的唯一目的就是“能查”。踩了两次 403(隐藏路径规则 +.json deny)才找到位置;根因是一条真教训:“写在磁盘上”和“能从 HTTP 读到”是两件事。 - 闭环实测三条:两次构建逐字节相同 / 线上页面==本地 site/ /
git show "${C}:site/board/index.html"逐字节等于线上。第三条让“网站进了 git”从声明变成可验证。 - 顺手修真 bug:
fmt_week_note用 date.today() 写「还有 N 天」→ 页面永远停在构建那天,且 site/ 入库后每天第一次 CI 必红。改为浏览器算。 - 新成本:改任何代码 → 重建站点 → 提交(工程量会变)。不做也不红,只让 deploy.txt 指纹与仓库对不上;发版必然重建,发布态下两者一致。
协同区建成 Team/:协商板与守卫搬入,状态只有一处
- 建之前先看了已有什么:发现
plan/negotiation.md+check_negotiation.py已经存在,而且比我准备建的成熟(四态机 / 到期日 / 已关闭必须有落点 / 正文≤24行 / 汇总表由正文推导)。⇒ 不重复造,只补它做不到的三个槽位,并把它搬进Team/。 - 三个槽位都不持状态:
notes/<AGENT>.md(各家流水,一人一个文件 ⇒ 文件级零冲突,正对cross-sector.txt的病)、open/<id>.md(议题正文,板子限 24 行放不下)、beat/<AGENT>(心跳,板子只记「谁欠着」不记「谁活着」)。 - 最重要的设计:状态只有一处。
Team/open/*.md不写 status/due,只写negotiation: N-xxx;watch.pyimport 守卫的parse(),格式只有一处实现 ⇒ 它报的「谁在等我」永远等于ci.sh那步报的东西。代价是开议题要动两处(故意的摩擦),而--open会把孤儿与悬空议题报出来。 - 搬家断了四条链:守卫
BOARD、ci.sh调用、agents.jsonshared、board.jsonev +p0-plan.json+ 三个 prompts。gantt.html 已重生成。 - CI 抓到 1 处 + 自查抓到 3 处:红在「看板证据路径不存在
plan/negotiation.md」——那条是 rebase 从 main 带进来的(板子搬迁前写的)⇒ 搬迁后任何从 main 进来的旧引用都不在你的 diff 里。另三处是「路标」(写给读者的指引,编译测试都不报):板子 §2 指着旧守卫、watch.py的 docstring 与提示文案。 shared的 owner 在check_ownership里也是排他的 ⇒ 光靠 git 零冲突不够,agents.json必须逐文件登记(新增 13 条),否则 A1 写自己的notes/A1.md会被判越界。顺带发现既有设计矛盾:docs/**的 policy 写「各 Agent 只追加自己的章节」但 owner 是 A1。- N-007 已提:MIR 怎么表达旋转角(度 vs 弧度 / 要不要 pivot / 归一化),正文在
Team/open/2026-10-24-mir-rotation-syntax.md。板子现状:7 条,在等:A1 ← N-007 / A3 ← N-001, N-006。 - CI:876 测试 / 16 步 / EXIT=0,「协商板」那步已用新路径跑通。提交
73b677d(搬迁) +4bae1c8(补漏),已推agent/A2。
- 建之前先看了已有什么:发现
2026-10-23
P3 收尾:接缝测试 + 四张老判据页复跑全绿(874 测试)
- 改了
push_quad(所有精灵都走它)⇒ 把机器上四张老判据页全部复跑:atlas 12 / text 9 / scale 24 / mip 192,一条没红。新判据证明"旋转能画",复跑证明"没把别的弄坏"——后者 CI 查不出来(主机侧只验算式不验像素)。 - 补三条接缝测试:①两条收集路径(带相机/不带相机)都要原样传角度;②剔除用旋转后的包围盒(同一精灵不转时被剔、转 45° 后必须画);③不转时包围盒与
pos/size逐字节相同(防那个0.0短路被当冗余优化掉)。 - 第②条错起来的样子是精灵转到某些帧消失、其余帧正常——很容易被归因成相机或批次,所以它必须有自己的断言。
- CI:874 测试 / 16 步 / EXIT=0。已 rebase 到最新 main 并推
agent/A2(f139254)。
- 改了
P3 旋转:五份同帧 2880 条判据,第一批「一个约等于都没有」的像素判据
- 五个副本同一帧(同贴图 / 同尺寸 / 同 uv,只换旋转角),2880 条判据(5 × 24×24 格)真机全过,五份两两不同 10/10 对,
glError = 0,一次过没调参。 - 第一次做到像素判据不需要任何容差:90/180/270 把整数坐标映到整数坐标 ⇒ 读回值必须逐字节等于源位图的一次转置/翻转。
- 非直角用 3-4-5(≈36.87°)而不是 45°:
sin/cos= 0.6/0.8 ⇒ 逆旋转后的源坐标恒为奇数/10,离最近纹素边界 ≥ 0.1;45° 的0.7071…可以任意接近整数。这就是"不要容差"的根据,而且有单测把它钉住。跟上一批把缩小倍数从 8 改成 7 同一个道理。 - 素材
v(x,y) = 16y + x:每个像素的值唯一(字形/图标有大量重复值,会把判据稀释成"看起来差不多")。副作用是灰阶铺满 0..255 ⇒ 清屏色必须跳出灰阶,用洋红(255,0,255);顺带白拿一条判据:像素要么灰阶、要么逐通道等于洋红,没有第三种。 - 功能:
SpriteInstance.rotation/Transform2D.rotation(弧度,正值 = 屏幕上顺时针,绕中心)。旋转几何只此一份(corners_of/aabb_of),顶点展开与剔除共用 —— 各算一份 ⇒ "画出来了但被剔掉了",只在转到某几帧出现。 - 契约检查把这一批拦下来过一次,拦得对:ADR-0006 §2.2 要求
DrawItem与SpriteInstance字段集一致;已给me-compiler的DrawItem加同名字段(恒 0.0,MIR 无旋转语法),登记cross-sector.txt(复核 A1+A2)。⇒ 渲染侧通了,内容(.mir)里的精灵还转不了,要 A1 定 MIR 属性形状(§1.9)。 - 顺手改正状态文档 §7 那句"旋转要换算法层":渲染侧只要加字段,物理侧才要换算法层。
- CI:867 测试 / 15 步 / EXIT=0。提交
b975241(代码+证据) +b9983f3(文档),已 rebase 到 main 并强推agent/A2。
- 五个副本同一帧(同贴图 / 同尺寸 / 同 uv,只换旋转角),2880 条判据(5 × 24×24 格)真机全过,五份两两不同 10/10 对,
陷阱:基线不能取「上一次构建的产物」
- 问题:看板要标「哪些变了」,就要知道「上次发布的是哪一版」。第一版设计里我把基线取成「上一次构建的产物」——听起来合理,因为它代表「上次部署到线上的那一页」。
- 它错在哪里:产物会被本地预览反复重写。为了看一眼效果建两次,第二次算出来的变化集就是空的,然后发版把线上的绿点覆盖成一片平静。一次预览就吃掉了真正的更新,而没有任何东西会报这件事——页面里一个字都不会提示「基线丢了」。
- 修正:基线落在仓库文件
plan/board.revs.json(生成物),由 site.sh 在 rsync + 冒烟 + 逐文件哈希全部成功之后调--publish前移。 - 为什么必须在成功之后:失败也写,就会把没发出去的内容记成「已发布」,那批改动从此不再标绿。漏标比重复标危险得多——重复只是烦一下,漏了是永远的沉默。所以这一步自身失败也不阻断发版结果(页面确实发出去了),只打一行警告。
- 没有基线时退到 git:「不 dirty 用 H^、dirty 用 HEAD」。但它只覆盖「最后一次改 board.json 的提交」,不是「上次发布以来的全部变化」——所以它是过渡退路,不是常规路径。
- 一句话结论:「上次构建」和「上次发布」不是一回事,把两者当成一回事的代价,是静默地少报。
看板加了「哪里更新了」:绿→蓝,红点指路
- 起因:「看板已经更新但我没看过」+「每次看都不知道该关注哪里」。这不是排版问题,是缺一层状态——页面只有「现在是什么」,没有「和上次比变了什么」。
- 三层分工:绿(条目)= 变了且没看过;蓝(条目)= 变过、看过了;红点 = 那里面还有绿的但我没滚到(导航角标 / 收起的迭代卡 / 右下浮动「下一处」)。红点只出现在看不见绿的地方,因为它指位置不指状态。
- 变化怎么算:每个条目按内容算 8 位指纹(task 含状态+标题+why+ev,里程碑含状态+why+全部判据),与 plan/board.revs.json 比对。工程量和完成度百分比刻意不进指纹:尺子量出来的数每轮都变,算进去等于天天说「有更新」,这个词随即失去意义。
- 看过 = 50% 可见 + 停留 900ms。滚轮一甩而过也「进入过视口」,那不算——替人决定「他看过了」比不做更糟。
- 首访只标构建期变化集,其余当基线写本地;否则第一次打开满屏绿,那是把「我还没有基线」说成「全都变了」。
- 「全部标为已读」带 8 秒撤销:它一键抹掉的正是这个页面唯一的值。
- 实测 24 项全过:首访只标 1 处 / 停留后转蓝 / 刷新记住 / 指纹对不上重新变绿 / 全部已读+撤销 / 1440 与 390 无横向溢出 / 无 JS 报错。
- 顺手修两个坑:
.sp角标用attr(data-new)但属性在祖先上,attr()只读同一元素 → 命中规则、内容为空,画面上只剩一个空胶囊(看起来像样式问题,不像数据没传过去);.revbar{display:flex}顶掉了[hidden],没更新时露出空壳。 - 颜色都手算过:未读绿白底 5.43:1、已读蓝 3.89:1(3px 竖条,非文本门槛 3:1)、红点白字 4.97:1。色盲兜底是标题后的「新」字,不靠色相单独承载信息。
P2 缩小:mip 链 → 揪出「采样器覆盖纹理参数」,mips 参数从上线起一直空转
- 三个副本同帧(同像素 / 同 uv / 同缩放,只换 mip 链与采样器句柄),192 条判据(3×64 像素)真机全对。
- 读数:只第 0 层+采样器
min=0 max=255 对比度=255别名;mip 全+采样器0/255/255别名(mip 没生效);mip 全+不绑采样器128/128/0正确。 - bug:WebGL2 要求采样器对象覆盖纹理自己的 MIN/MAG_FILTER,而
RhiSink永远带非 0 采样器 ⇒ 胶水照mips生成的LINEAR_MIPMAP_LINEAR从第一天起就没生效过。形状是「参数被接收、被处理、被断言设过了,但被下一条指令覆盖」——编译和单测都拦不住。 - 判据设计:缩小取 7 倍不取 8 倍。
ratio=8⇒s = 8d+3.5,frac恒 0.5,每格 50/50 平均成一片 128,与 mip 链的值分不开;7 时frac恒 0,取到纯纹素,黑白交替,对比度 255 vs 0。 - mip 由引擎自己 2×2 box filter 逐层算(确定性;胶水那次
generateMipmap跑在还没有像素的时候)。 - 新增
wasm_mip.rs(8 单测)、mip.html(192 判据)、run-mip.sh、mip_js_table.rs(5 条表核对)、证据evidence/p2-mip-minification.png。 - 协商板补 §1.8:
me_filter只有 NEAREST/LINEAR,表达不了*_MIPMAP_*,请 A1 裁决;并提醒 A3 别删胶水那次generateMipmap(它的副作用是分配 mip 层,删了只在真机glError != 0)。 - CI:845 测试 / 13 步 / EXIT=0。提交
8948f4e(代码+证据) +83d52e7(文档),已推agent/A2。
A2:放大字形——采样器按素材分,把「糊」变成可算的 85 / 170(P1)
- 起点是上一批自己写下的「真问题」:缩放 ≥2 的像素字体走双线性会糊。写在文档里等于还没解决。
- 症结不在渲染:
SamplerDesc::pixel_art()(两档 NEAREST)早就写好了,但RhiSink只有一个sampler字段、懒建时固定用sprite()(线性)⇒ 这个 API 存在却从未被真机验证过一条指令。修法:samplers: [u64; 2]+TexEntry.filter,upload_font_atlas→ Nearest。 - 为什么 filter 挂图上而不是精灵上:挂精灵上要先让批次键
texture→(texture, filter),而Batch是me-render导出的公开类型 ⇒ 契约级改动 + 波及每一处SpriteInstance构造点。代价如实记下:一张图两种读法仍要上传两次(32KB,可量)。分界不是「灵活 vs 死板」,而是哪种错了会静默。 - 判据(可复用):一帧画两个副本,只换采样器句柄(左 x=16 线性 / 右 x=200 最近邻)。分两帧会被归因成「帧不同」。缩放必须取 3:
1/3×255=85、2/3×255=170都是整数;取 2 得 63.75/191.25 ⇒ 判据里出现「约等于」就没人能复核。 - 两个数字就是「糊」的定义:两笔之间的黑格 线性 85(墨漏出来)vs 最近邻 0;笔画边缘那一列 线性 170(边缘稀释)vs 最近邻 255。
- 真机一次过,没调参(SwiftShader / Chrome 640×360):
SELFCHECK PASS,24 条判据(12 点 × 2 副本),两副本差异 5 条 / 相同 7 条,批次 2 / 退白 0 / 四边形 2,glError = 0。实测与算式逐条相等,连 170、85 都没偏一。 - 比表更严的硬判据:要求「两副本读回值恰好差 5 条」。表只能证明表被写成 5 条;读回值才能证明换采样器在这台机器上真的可见。反过来「另外 7 条必须逐字节相同」同样重要:12 条全不同 ⇒ 两边不止差采样器一件事。
- 顺带修一处文档错误:
SamplerDesc::sprite()注释写「缩小取最近」,代码是min_filter: Linear。注释与代码不符的代价不是文档难看,而是下一个改这块的人会相信注释,于是不去查 mip 的缺口。 - 证据:
apps/coin-run/evidence/p1-sampler-scale.png(一帧两个副本 + 各自放大 8 倍 + 24 条判据)。左「4」笔画四周一圈灰边、中间黑格发白;右「4」是硬的像素边,肉眼可证。 - 主机侧 12 条进 CI(
wasm_scale9 +scale_js_table3)+rhi_sink3 条,整体 830 测试 / 20~40s 全绿。
ADR-007 裁决 + ADR-008「更像人」:对齐玩家,不是变强
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
me-net只装与范式无关的六件事;同步范式项目级二选一、编译期裁剪;确定性是可选能力 + CI 守卫。未决两条(Det数值表示、快照压缩)保留开放——按 §3.1 实测,Det的触发点是“守卫变红”,不是开工前置。 - ADR-008 加 §8「更像人」。需求原话:「通过对弈玩家,假装水平和玩家相当。」
- 它与初版“智力远超常规 AI”不矛盾:前者是能力上限,后者是暴露水平。合起来是“我比你能,但我装成和你差不多”。
- 拆三步,每步归属不同:观测(引擎:SkillModel,规则层算、不调模型)→ 目标(项目:开关 + target_offset)→ 执行(provider:loss_budget / think_ms / style)。任何一步合并掉,就成了“引擎偷偷替人决定难度”。
- 三条先决判断:
① 对齐的是“这个人”不是档位 → 估计只能来自与他的实际对局;
② 局内不修胜率,跨局才更新目标 —— 拟人化的死敌不是失误,是橡皮筋;
③ 能力不足不许装,否则“像人”就成了静默降级的后门。
- 判据只承诺“量得出来”:盲测 AUC / 思考时长 KS / 失误率条件分布 / 重复率,四条都必要不充分;判据数据必须与调参数据不同源。
arena report不判通过失败——“多像才算像”是产品标准。 - 同步改了三处口径防打架:14 号文档 §6 把“自动调难度”拆成禁(隐藏)与行(显式 + 留痕);新增 §7.4 接入形态;05/09 的计划表同步。
- ADR-007 → Accepted(飞哥裁决)。裁决的是分层与六条约束:
陷阱:HTTP 200 不等于「这一次的内容」
- 事实:22:54 那次发版,冒烟 7 条路径全 200,脚本打印「完成」。半小时后核对,线上
/board/是一次更旧的构建:行尾 CRLF、任务清单少了「在写」两条、工程量还是旧数字。 - 写入者没定位到:同一份工作区里有另一个会话在并行提交+发版;SSH 只有一个 key(本机)一个 IP,不是外部入侵。但结论与写入者无关:
HTTP 200只回答“这个路径有东西”。 - 这是同一族的第二次:上一次是
/board/404 而脚本说完成(没有校验对象,因为清单是手写的);这一次是校验对象太弱(只看状态码)。 - 改法:
tools/deploy/site.sh新增「内容校验」——本地 site/ 每个文件的 md5 == 远端同一文件的 md5,不一致就打印 diff 并 exit 1。三条不许退化的判据:本地为空 / md5 缺失 / 远端取不到,各自单独报错(否则“两边都是空”会被当成相等,这是最便宜的假绿灯)。 - 演练:远端注入一行 + 把 rsync 换成空转 shim → 红并点名 index.html;撤销后 7 个文件逐个哈希相等。
- 额外发现:同一个 nginx 根下可能有两份不同的「同一个工程」产物在互相覆盖——两个会话、一份工作区,发版前不必先打协议,但发版后必须验哈希。
- 事实:22:54 那次发版,冒烟 7 条路径全 200,脚本打印「完成」。半小时后核对,线上
看板进了 CI:从「靠记得」变成「忘了会红」
- 起因:要求「每次更新都把文件数和代码量放上去」。在此之前工程量只是「我记得跑一次」——
build_board.py --scale存在,但没人逼你看。 - 改动:
tools/ci/ci.sh新增「看板」一步,跑build_board.py --check(4 条守卫:证据路径不存在 / 任务 id 拼错 / 里程碑与判据不自洽 / 标记完成但无证据),并在同一步打印--scale那一句工程量。 - 定位:工程量只打印、不判定(改一行注释数字就变,CI 验不了“对不对”);但“这次没带”从此变成看得见的事。
- ok 行只写「数据自洽」,不写“已发布”:site/ 是产物不进仓库,CI 绿 ≠ 线上新。把两件事说成一件,是这类检查最常见的谎。
- 演练:把 S0-1 的证据路径改成不存在的 → 立刻红并点名该文件;顺带那条 round-trip 守卫又抓到一次排版漂移。
- 后果:CI 14 步 → 16 步(另一会话同时加了协商板)。
- 起因:要求「每次更新都把文件数和代码量放上去」。在此之前工程量只是「我记得跑一次」——
A2:字上真机——32 条像素判据,并抓回上一批 uv_inset 的回归(S0-10)
- 为什么上一批不够:S0-6 用纯色块验渗色,而纯色块被拉伸、被压缩、被错开一格读出来都是同一个颜色——结构上就验不到「位置」。字形自带内部结构(
4的横笔右侧必须有空),且只有缩放 1 时「屏幕像素 ↔ 图集纹素」一一对应,判据才能是干净的 0/255。 - 抓回一处上一批自己的回归:
uv_inset是缩放不是平移(u 范围w→w-1个纹素,四边形仍占w个 ⇒ 内容压缩w/(w-1))。16 纹素只缩 6.7%,纯色块量不出来;5 像素宽的字缩 20%,笔画变形。上一批把text::bake改成uv_inset正踩这条 ⇒ 改回rect.uv(),并加测试盯「uv 跨度必须正好w个纹素」。字形本就不需要内缩:blit已向四周外扩一像素。 - 对照组设计(可复用):模式 1 把每块 uv 整体右移一个纹素,位置一像素不动 ⇒ 每个探针读到「右邻那颗纹素」。16 点里刻意留 6 条翻面、10 条不翻;全都会翻的话「6 条」可以靠「随便什么都翻」凑出来。而且判据用「读回值真的变了 6 条」而不是「表里写了 6 条」——后者只能证明表被写成了那样。
- 真机(SwiftShader / Chrome 640×360):
SELFCHECK PASS,32 条判据(2 模式 × 16 点),对照组翻面 6 条,glError = 0,两模式都是 批次 1 / 顶点 8 / 退白 0 / 字形 2。一次过,没有调参——因为期望全是手算常量(ORIGIN=16/ADVANCE=6/5×7/gl_y = 359 - top_down),不是从代码反推的。 - 探针坐标必须硬编码:反过来用
GlyphMetrics::pos+ 排版公式推屏幕位置,排版错时探针跟着错,两边一起错 ⇒ 判据永远绿。 - 主机侧 9 条进 CI(
wasm_text6 +text_js_table3),整体 810 测试 / 20~40s 全绿。其中一条拿BuiltinFont::ink反推回字形内(c,r)逐点核对期望 —— 它抓的是「改了字形美术没改探针表」,这种漂移在截图上根本看不出来。 - 证据:
apps/coin-run/evidence/s0-10-text-on-device.png(两帧 + 「4」放大 16 倍 + 32 条判据) - 未覆盖:缩放 ≥2 的像素字体(双线性是加权平均,要清晰得换
NEAREST采样器——那是「采样器选择」问题,不是文本链路问题);中文(内置字体只有 ASCII 32..126,换来源只需换GlyphSource实现);微信真机WXWebAssembly。
- 为什么上一批不够:S0-6 用纯色块验渗色,而纯色块被拉伸、被压缩、被错开一格读出来都是同一个颜色——结构上就验不到「位置」。字形自带内部结构(
A2:图集渗色收口 + 18 条真机判据(S0-6)
- 契约 §5.2 那句「图集要么加 padding、要么内缩」是错的措辞:实测是三件事——留边、留边填边缘色(
Atlas::dilate)、uv 内缩半纹素(AtlasRect::uv_inset)。只做第一件,症状从「渗邻格」变成「边缘发暗」,一样不报错。 - 主机侧 9 条断言(
crates/me-render/tests/atlas_bleed.rs):把 GL 双线性规则抄一遍(s = u*N - 0.5+floor/frac+CLAMP_TO_EDGE),于是「边缘会混」变成可算的事。uv()+ 空留边 ⇒ 蓝色只剩0,0,128(alpha 也减半)。 - 真机侧 18 条(
apps/coin-run/atlas.html):同图集同精灵,只换 uv 取法画三帧。Raw是对照组——没有它,「修复模式读到纯色」可能只是这台机器恰好没出问题。实测Raw红块左边缘74,0,0→Inset/Dilate255,0,0;紫条65,0,65→Dilate255,0,255;外扩像素242 = 68×3+38。 - 一条主机上没预测到的:紫条中心在
Inset下读到252而非255。1 纹素宽的精灵 u 跨度就是 1 个纹素,屏幕像素中心几乎必然落在纹素边缘上,双线性躲不开边界。为此加Expect::Almost档(实测 252 vs 65,与Mixed的分界很清楚,判据没失去分辨力)。 - 两份判据表(JS 读像素 / Rust 出真值)逐行逐字段比对,比「抽数字按位比」严——三种期望形态长度不同,只抽数字会错位。
- 证据:
apps/coin-run/evidence/s0-6-atlas-bleed.png(三帧 + 8 倍放大镜 + 18 条判据)。全量 CI 12 项新增断言,整体 801 测试 / 21~39s 全绿。
- 契约 §5.2 那句「图集要么加 padding、要么内缩」是错的措辞:实测是三件事——留边、留边填边缘色(
四个坑:--done 重排 361 行 / 双开遇 UU 别动 / 渐变背景的对比度假阳性 / 全角括号吃变量
- 工程量(本次):378 个文件 / 92,592 行(源码 54,255 · 文档 13,106 · 脚本与配置 25,231),44 个二进制资产。
- 坑一:
--done把整个 board.json 重排。 它用json.dumps(indent=2)写回,于是「加一条任务」的 diff 是 +361/−90,真正的改动淹在重排里。那种 diff 没有人真的 review,而「没人 review 的 diff」正是这个账本想避免的。修法:按手写排版序列化,只对两类短结构内联(ev 字符串数组、{text,done} 判据),内联与否按显示宽度 ≤130 列判(用 len() 会把一行 90 个汉字当 90 列,实际 180 列)。判据是一条 round-trip 断言:dump(load(文件)) == 文件字节,当前逐字节相同;并且--check也守它,不一致就提示跑--fmt。改完同一个操作的 diff 是 +4 行。 - 坑二:双开时不要抢着解冲突。 我跑 CI 的时候,另一个会话在同一工作区开始了 merge,
git status出现UU tools/ci/cross-sector.txt。我读了那处冲突就退出去了——它不属于我这一笔,动它只会让两边的解决互相覆盖。判据:看到 UU 就别写文件,等对方收口。 - 坑三:对比度脚本在渐变背景上会造假阳性。 实测
.gauge-cap报 1.92:1,实际是深色 hero 渐变上的浅灰字(约 8:1)。因为backgroundColor是透明的,脚本一路走到 body 白底去算。背景是渐变时,computed backgroundColor 不可信。 - 坑四:
$code(…又被自己的 CI 抓了一次。 变量后紧跟全角括号,bash 3.2 会把它当变量名的一部分。七小时前刚在 cross-sector.txt 里记过同一类错误,还是手滑了——这类规则不能靠记性,只能靠检查器。
看板公开上线 + 工程量层:把「做了多少」摆到「做到多少」旁边(378 文件 / 92,592 行)
- 工程量:378 个文件 / 92,592 行:源码 54,255 行 · 文档 13,106 行 · 脚本与配置 25,231 行,另有 44 个二进制资产。口径:
git ls-files实测、不含生成物,每次构建重算。 - 看板上线:https://magic-engine.filebreeze.cn/board/ 之前一直是 404,原因不是忘了部署,而是发版脚本的冒烟清单是手写 5 条路径——新页面不在清单里,就等于没有校验对象。手写清单的失效方式不报错,只沉默:脚本打「完成」,访问者看 404。现已改成从
site/产物推导(*/index.html → 目录 URL,assets/* → 文件 URL),本次上线校验 7 条路径全 200。 - 为什么加工程量层:看板一直只回答「做到多少」,不回答「做了多少」。百分比离开分母就没有意义——25% 可以被读成“刚开头的小项目”,也可以被读成“干了大半的大工程”。现在这一句压在页首:一句话 + 六条横条(源码 / 文档 / 脚本 / 配置 / 前端 / 示例 MIR)。用横条不用饼图:这里要比的是量级差距(5.4 万 vs 452 行),线性宽度才看得出来。
- 只有一处真相源:页面上的 HTML(数字加粗)与
--scale打印的纯文本共用同一份scale_parts(),并且构建时把 HTML 去标签后与纯文本逐字比对,不等就构建失败。两份文案一旦分叉,「看板写 92,592、项目板写 9 万」就会悄悄发生而没人核对。 - 「在写」第一次有数据:
wip以前是死代码(render 去读排班表里不存在的字段),于是那条图例永远空着——有图例没数据,比没有图例更容易让人以为“没人在做”。现在是 board.json 的一等字段:与 tasks 互斥、必须写「还差什么」。当前 S2-4(lower 差图集分配)、S1-9(示例 1/12)。视觉上用半填充方框表达第三档,不引入第三族颜色。 - 补记 S1-7:长期记着“me validate 还是占位”——那条口径过期了,占位的是 me build。fmt/validate 早就实装且各有三态断言。计划内完成度 27 → 28/110 任务,109/433 人日 = 25%。
- 工程量:378 个文件 / 92,592 行:源码 54,255 行 · 文档 13,106 行 · 脚本与配置 25,231 行,另有 44 个二进制资产。口径:
今天踩的五个坑:都是「没东西会因为你做错而变红」的那一类
今天这一轮全部是「工具没报错、但结果不对」的类型,共同特征是没有任何东西会因为你做错了而变红。
- 同一目录开两个会写代码的会话 = 编辑会静默丢失:4 次编辑都报成功,
git diff只剩最后 24 行;另一会话在期间做了 3 次 merge 并git stash了我的改动。对策:不再在同一目录双开写代码;必须改多文件时用 Python 脚本原子写盘,且每个锚点都assert count == 1。 git merge报Already up to date是假成功:本地agent/A3停在一周前的提交,merge 一句话就把人骗了。唯一判据是git log --oneline origin/main..origin/<branch>有东西。同理:本地grep是 toybox shim,grep -o '[0-9]*'多字节下返回空、-Eo '[0-9]+'正常。- 100% 误报的检查会马上被关掉,然后连真问题一起忽略:
check_coverage首版用绝对路径比相对路径,报出「全部文档未登记」;改成relative_to(ROOT).as_posix()才是真值 1 处。 - 误报率 5/6 的检查不能上线:试扫 docs 里 44 个代码路径引用,6 处「不存在」只有 1 处是真问题——那 1 处人工看,不上检查。
- 缺席的契约比写错的更隐蔽:
docs/qa/diagnostics-review.md写着「归 A1:建interface/diag.codes.md」,而这个文件从未存在,me-cli 已经在用它。写错的会红,缺席的不会。 - 一类 bug 只有截图看得见:既不溢出也不重叠、对比度全绿,但文字被 flex 压成竖排;或
[hidden]被display:grid顶掉导致同一栏冒出两倍的卡。能自动量的量一遍,量不到的必须看一眼,两者不是替代关系。
- 同一目录开两个会写代码的会话 = 编辑会静默丢失:4 次编辑都报成功,
编辑器界面设计稿:从「Agent 只产 MIR diff」反推出的三视图,实测 24 次全绿
产出
design/studio/(index.html + studio.css + studio.js + verify.js,约 2400 行),单页三视图 + 深浅双主题 + 可交互。定位是设计稿,零实现。- 结构不是「传统编辑器加个 AI 侧边栏」,是从契约反推的:①
me-agent硬规则「不许直接改文件,只产 MIR diff」⇒ 右侧是 Patch 队列而不是 Inspector,patch 是一等公民;②docs/03 §3.1「Guardian 必须是确定性代码」⇒ 拒绝必须精确到ME-REF-004 · subject= · missing=并能点进视口高亮;③ 预算感知生成 ⇒ 预算条压在视口上方,用 MIR 真实五键tri/tex_kb/draw/ms_x100/mem_kb,不另造人类单位,不藏进面板。 - 三个视图:工作台(意图流 / 视口 / patch 队列 / Guardian 判据栏)· Diff 审查(MIR 文本 diff + 干瓦→湿瓦→参考图三联)· 性能(三层时间轴 + 预算热力图 + 归因链)。
- 三个取舍写在页内说明抽屉:没有传统 Hierarchy 树做主轴;patch 卡片默认信息密度偏高(可审计性的成本);退回是栈语义而不是重新生成(所以「退回」与「让 Builder 修这 3 条」是两个不同措辞的按钮)。
- 实测 24 次(3 视图 × 2 主题 × 4 视口,1280/1440/1920/390):对比度违规 0 · 溢出 0 · 重叠 0 · 最小字号 10px · 交互断言 7/7。脚本
design/studio/verify.js跟着设计稿进仓库——「我测过了」不是证据,跑得起来才是。 - 量出来的真问题都不是「看着不对」,而是量了才知道不对:分隔符用
--line画实测 1.27:1(等于没画);主按钮白字压电光蓝 3.24:1,深浅两端都不达标 → 新增--brand-solid(5.70,色相不变);diff 行号落在增删行浅底上 4.30;时间轴色块#3E86E8上白字 3.63。 - 两个只有截图才能看见的 bug:底部 Guardian 栏同时冒出 8 张卡(
[hidden]的display:none被.gd-body{display:grid}顶掉);1280px 下顶栏被 flex 压到中文逐字竖排(既不溢出也不重叠,三项判据全绿)→ 加nowrap+ 按序让位断点,检测视口从 3 个补到 4 个。 - 浅色主题不能复用深色的场景色阶:深色下建筑要比地面亮才立得住,浅色下必须反过来比地面深,直接复用糊成一片——两套独立值。
- 扇区登记:
design/**与build_board.py原为未注册扇区(warn)。按cross-sector.txt不能用代修表开后门,必须改plan/agents.json(已加到 A1 owns,理由写进notes.design_and_board)。
- 结构不是「传统编辑器加个 AI 侧边栏」,是从契约反推的:①
公开进度看板上线:110 个任务逐条可见,每条完成都带可核验的证据路径
页面
site/board/index.html,入口三处:官网顶栏、首页「逐条看进度 →」、文档站侧栏。六个区块:总进度 / P0–P3 路线图 / 12 个里程碑(逐条摊开判据)/ 13 迭代 × 110 任务(可展开可筛选)/ 12 个 crate 实测行数与测试数 / 12 份契约 / 6 项计划外交付。- 数据分三层,避免看板变成许愿池:任务清单不另存,构建时解析
docs/10-p0-sprint-plan.md(抄一遍就有两份,漂移方向永远是「文档改了、看板没改」);完成状态只存plan/board.json,每条必须有why+ev,构建时逐个 stat,路径写错即构建失败;行数与测试数扫源码实测。 - 五条守卫都演练过会红:证据路径不存在 / id 拼错 / 里程碑状态与判据不自洽 / 完成但无证据 / 文档少一条任务。没红过的守卫等于没有守卫。
- 实测(无头 Chromium 1440 + 390):溢出 0、对比度违规 0、首屏无遮挡;筛选 已完成 27 条 / 未完成 83 条 / 全部 110(27+83=110);
ci.sh12s 全绿;site.sh --dry-run走通。 - 先修了一个假功能:筛选原来作用于「整个迭代卡片」,13 个迭代一个也过滤不掉;改成作用于任务行。
- 顺手修三处「没人会因为这句话不对而报错」:首页「立项第 1 天」已过期;「19 篇文档 + 6 份决策记录」实际 25 份 → 改构建时注入
{{DOC_COUNT}},残留占位符即失败;ADR-0003-rhi-v3.md从未登记进文档清单,新加的check_coverage()真挡住了构建。 - 脱敏(页脚写明):只呈现模块 / 任务 / 判据 / 证据路径;不含姓名联系方式、机器网络信息、成本预算、客户商务条款、未公开决策与风险登记册。泳道 A/B/C/D 是角色代号。
- 待办:
ci.sh里还没有看板校验(tools/**归 A3),目前只靠发布脚本兜底 —— 改了board.json却没部署,看板就是旧的。
- 数据分三层,避免看板变成许愿池:任务清单不另存,构建时解析
2026-10-22
性能门禁 25% 概率假失败,问题不在代码在测量
- 同一份没改过的代码,四次跑出 5.01 / 7.39 / 4.22 / 14.91ms,阈值 10ms —— 有一次直接判红
- 三个原因叠在一起:
① 单轮 500 样本算 P99 只有 5 个数据点,基本被操作系统调度主导
② 测量顶着上一轮自己造的队列积压(落盘上限约 750 行/秒,而压测远高于此)
③ 存储域懒加载,第一次写入把编译开销也算进了延迟
- 修法:三轮取中位、新增「服务端 handler P99 < 5ms」第二阈值、每轮前等队列排空、启动预热。连跑三次 5.51 / 4.31 / 4.09ms 稳定通过
- 教训:一个会随机报错的门禁比没有门禁更糟 —— 它教会所有人忽略红灯
- 同族的另一条:开着一个副本服务和浏览器时测出 9.4ms 贴着阈值,清场后立刻回到 4.5ms。看性能数字之前先看环境干不干净,否则测的是「谁在抢 CPU」
M1a:重构成 ingest / store / query 三分域,打点接口不再阻塞
- 原先是单进程双库,读写混在一起,查询一慢就拖到打点
- 重构成三域:ingest(脱敏后立即返回 204,永不阻塞)→ store(唯一落盘出口)→ query(只读,预聚合 + 30 秒缓存)
- 实测推翻了一个假设:存储不是瓶颈(每个事件约 321 字节),真正的瓶颈是同步 SQLite 接口把事件循环堵住
- 所以光做「内存微批」不够 —— 一批 750 行照样一口气写完,一次堵上百毫秒。改成每片 150 行 + 主动让出事件循环:不切片时 p99 59ms,切片后单片 8ms
- 崩溃明细单独一个库只留 30 天,但崩溃率的趋势聚合仍然留 12 个月 —— 明细是排查用的,趋势是决策用的,保留期不应一样长
- 存储域启动时预热:三库连接与语句预先备好,冷启动开销不摊给第一个访客(实测 14.4ms)
体验版 v1.0.0 已上传:包体 1.6MB,客服拆分 / 商品卡 / 宠物动画上线
- 提交
d75c88b(客服拆分 / 对话商品卡 / 宠物动画)+aebd387(包体精简) - 「我的」:设置与客服拆两行,弹窗统一走
utils/support.js,微信号只从COMPANY取 - 对话:问猫粮不再解释渠道,直接出商品卡;主推/补位分级,猫粮问题不混狗粮
- 宠物动画:
pet-parade三种形态(柯基横穿 / 灰猫爬墙 / 橘猫舔爪),15–32s 随机、聚焦即停、不挡点击 - 包体:首个上传报 80051(2115KB > 2MB),根因是根目录 package.json+lock(650KB)被打包;移到
.workbuddy/tools/后 1.6MB,✔ upload成功 - 工具行为:packOptions 改动要 close/open 项目才生效;重开后首次 upload 常卡 compile_start Timeout,等 20s 重传即可
- 验证:5 个脚本共 107 项全 PASS
- 提交
官网上线: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)
- 站点结构重组:
立项:MagicEngine 正式启动,代码落位 (本机路径)
定位:不做「另一个全能引擎」,做「预算感知 + AI 进编译链」的引擎;护城河在 MIR(带预算注解与溯源的内容图)+ 跨端编译,不在渲染器。
验收口径:P0 不是「做出引擎」是「验证假设」—— Gate 0 六指标 <4 项即止损;降级方案 C(AI 挂到 Cocos,8 周止损)预定触发。
代码落位:
(本机路径)→(本机路径)(240 文件 / 2 提交 / 工作区干净,原目录留备份)。基线已成:19 篇文档 + 6 ADR;
interface/契约冻结(rhi.ffi.h v1);越界守卫脚本;SfxForge 音效已跑通(32 资产 / 7 项硬校验 / 两次构建 MD5 一致)。三个决定:MIR 用块语法不用 S-expr(可 review 优先);FFI 冒烟提前到 W2(改语言成本 2 周 vs 4 个月);并发度按 FTE 表定(四并发窗口仅 8 周)。
现实约束:PS5 devkit 与主机 SDK 受 NDA、周期不可控 ⇒ 架构留口 P2 实现;新引擎本身不是卖点,唯一卖点是效率被实测数据证明。
v3 全量落地:3 位置 / 18 页 / 数据层归一
产品:底部 3 个位置(首页 / 豆豆 / 我的),页面 33 → 18,预设 59/39/138。
数据:MySQL 17 → 8 表(删 9 张商城/积分/排期/POI 表);services 36 条重复去重为 3 条;NoSQL 归一 4 合集。
云函数:25 → 10,废弃 15 个归档至 docs/archive-cloudfunctions(云端需控制台手删)。
踩坑:
call()已解包 data,4 个页面又取res.data→ 永远 null → 静默退回种子数据。只有云端才有的特征值(如新单地址)出现在页面上,才算真通。文档:doc/pet-product-design-v3.html,实测 21 项对比度 ≥4.52、零溢出;体验码 .preview/qr-v3.png。
关于页新增「二十年事业版图」入口,独立长页 /business-map/ 上线
- 入口放在「创始人介绍」之后、「智能体验中心」之前:白→淡蓝渐变卡片 + 发丝边 + 主色实心按钮,右侧「20 年 · 四个五年」阶段列(立身 / 制造 / 出行 / 全球)
- 独立页沿用站内视觉:白底与浅灰交替、白卡细边,深色只保留首屏长图、环形能力图、结尾三处
- 配图 20 张 PNG → WebP:5.3MB → 1.09MB;补 title / description / canonical / og;桌面左上角悬浮「返回官网」,手机端挂到页脚(悬浮键在小屏会压正文)
- 入口区块上下留白对称(80 / 80),右侧分隔线用负 margin 抵掉卡片内边距,正好贴住卡片上下边;首版只写了下边距,卡片顶到上一区块,看着没居中
- sitemap 收录 /business-map/(priority 0.7);全站 38 条路由 1440 / 390 回归零异常
产品库扩到 204 款:详情长图进抽屉,CRM 同步改分批拉取
- 新增 4 款:松联诚 S5 超薄开关(一位 / 二位 / 三位)+ UIOT X04 智能门锁,品牌 15 → 17;X04 带 7 张厂家详情长图
- 详情抽屉新增「产品详情」区:长图整宽铺开,每张包一层链接可点开新窗口看原图(抽屉只有 560px 宽,750 宽电商长图缩到 512 偏小);卡片封面仍只用 images[0],不与详情图混
- 修一处静默失败:CRM
POST /api/public/products/batch的 ids 上限 200,清单涨到 204 后整批 422 → 走降级分支沿用旧快照,页面看着一切正常,但新产品永远不会出现;改为按 200 分批拉取,批内保序、批间按清单顺序拼接 - 验证:本地与线上都打开 X04 查看详情图,11 张图片 content-length 与本地构建产物逐一一致
2026-10-21
老人守护页接入「适老智家」独立站入口
- 官网老人守护页(/elder-care)视频下方新增适老智家广告位,整块可点、新窗口跳转 agehome.filebreeze.cn
- 广告内容:6 项具体改造项(扶手/防滑/起夜亮灯/一键呼救/燃气漏水报警/摔倒识别)+ 少摔跤·不摸黑·喊得应 + 9 大系统 / 980 元起 / 4 步上门到教会
- 底部 CTA 改为双按钮:立即咨询(本站)+ 了解适老智家(外链)
- 站群分工明确:官网讲守护方案,独立站讲「怎么改、改哪些、多少钱」
- llms.txt 增加「关联站点:适老智家」段,便于 AI 检索时指向正确站点
- 1440/1024/768/390 四档无横向溢出,点击跳转实测可达
产品中心新增「按品牌」筛选轴,品牌下可再按类型细分
- 产品中心筛选新增按品牌轴,与产品类型 / 使用空间 / 智能场景并列
- 选中品牌后出现「再按类型」子行,只列该品牌真正覆盖的品类:沃铁 → 照明 38 / 插座 7 / 开关 5 / 遮阳 1 / 中控 1;小米 → 中控 7 / 传感 5 / 安防 3
- 品牌计数按「除品牌外」的其他条件计算,选完一家后其余品牌不归零;顺序固定不跳位
- 移动端子行改为换行平铺,避免横滑时只露出前三个品类
官网产品中心:零售价全面对齐京东页面价,下线单品牌专题
- 官网零售价改为直接等于京东页面价(不含国补),不再叠服务溢价,价格更透明
- 本轮校准 26 款:中控屏Max 2899→2299、云台摄像头 469→179、户外 599→349、锐捷 EG110G-P V2 1135→939、中弘 B19 PRO 1400→979
- 只改能确认为同款同型号的条目,未核到确切同款价的暂不调整;组合销售场景允许多品类平价
- 下线「X7 系列智能开关」单品牌专题(供应商增多不再单设品牌专题),旧链接 /products/smart-switch 重定向回目录
- 同系列多型号卡片增加差异标签;站头导航与品牌名间距收紧 146→30px
2026-10-20
产品中心接入自有 CRM 产品库:199 款、三轴分类、9 个品类页上线
- 产品中心数据源改为自有 CRM 产品库自动同步:拉取 200 条(有价 122 / 询价 78)、下载 219 张 WebP 主图,页面/预渲染/站点地图/大模型知识文件全部读同一份数据,官网不再二次录入
- 三轴分类全部落地,199 条无一漏分类:类型 9 类(照明 51 / 插座 38 / 开关 32 / 网络 31 / 传感 14 / 暖通 13 / 中控 10 / 遮阳 7 / 安防 3)、空间 13 个(全屋通用 139 / 客厅 47 / 主卧 24 / 餐厅 21 / 书房 19 / 厨房 18)、场景 10 个(回家 124 / 离家 90 / 节能 65 / 睡眠 60);同轴内为「或」、跨轴为「与」
- 新增 9 个品类落地页(智能开关、智能照明、插座取电等),带款数/品牌数/起价与全量清单,承接「智能开关价格」类搜索;X7 专题页保留为深度页
- 价格口径:只展示厂商建议零售价,无价显示「询价」,不用成本价或系数反推;成本类字段在同步环节就裁掉
- 类型判定改三级取信号(标题型号 → 供应商子表 → 摘要描述),修掉两起批量误判:暖通文案含「无需网关」致 13 条被判中控;插座标题含「PC 面板奶油白」致 9 个插座被判开关
- 站点地图 73 → 82 条 URL,预渲染产品页 1 → 11 个;同步脚本幂等(二次运行 0.3 秒),CRM 不可达时沿用历史快照,不会把线上产品清空
- 上线后线上复核:桌面/手机两档共 6 次访问 0 报错、0 横向溢出,产品图正常加载,详情抽屉与空间筛选可用
产品中心 + 延庆养老大屏合并发布上线
- 环境:Vue 3 + Vite + CloudBase 静态托管
- 本次发布 442 个文件,含 12 个视频(约 271MB)全部保留,未做远端删除
- 发前跑同步 SEO + 预渲染 + 构建三步,而非只跑构建,避免站点地图与静态页落后于内容
- 线上逐项校验:产品列表 / 产品详情(含刷新)/ 产品图 / 两个视频 / 站点地图 / 大模型知识文件 / 延庆大屏,状态码与格式、体积均正常
- 桌面与移动双端跑通:导航 10 项不挤不换行,控制台零报错
- 合并了另一台机器推上来的延庆智慧养老大屏与案例页,并解决了一处知识文件合并冲突(两边内容都保留)
产品页接入预渲染与结构化数据,资讯页去掉头部宣传片
- 资讯页头部企业宣传片移除,页面顺序改为:深色页头 → 分类筛选 → 文章列表
- 产品页加入预渲染:与文章页同一套路(复用站点外壳 + 挂载容器内放降级内容),直访与刷新都能看到完整页面
- 新增 Product / BreadcrumbList 结构化数据,Offer 中带价格字段,便于搜索引擎展示价格
- 站点地图扩到 73 条 URL;大模型知识文件补上产品型号与零售价
- 旧的产品占位页重定向到新产品中心,避免两个产品页争同一批关键词
- 顺带修了埋点脚本对带引号文章标题的解析报错
产品中心改为明码标价,全站去掉「代理」表述
- 型号参数表新增一列「零售价」,每个型号逐条标价;详情首屏与列表卡显示「起价 + 单位」
- 同一型号按面板材质分档报价,低价档写在表格注释里,避免列数过多撑爆移动端
- 移动端表格需横滑,把价格列钉在右侧固定,滑到哪都能看到金额
- 全站取消「代理」字样,统一为「品牌 / 在售 / 智能家居硬件」
- 报价口径:只展示零售指导价,成本口径不进任何对外页面与文档
新增产品中心:智能开关 X7 系列上架,型号参数全量录入
- 导航在「企业服务」之后新增「产品中心」,页头按 10 项重排:logo 靠左、导航靠右,900px 以下收进抽屉菜单
- 列表页:在售品类大卡 + 全屋品类路线图(智能照明 / 传感 / 门锁 / 窗帘 / 厨电 / 大家电灰显「筹备中」)
- 详情页数据驱动:四个系列(X7 MAX 彩屏按键 / X7 AIR 纤薄 / 智能温控三合一 / X7 AIR 插座)各带型号参数表
- 新增一个品类只需在数据文件加一项 + 放图,列表与详情自动出现,不用改组件
- 产品图从厂商手册 PDF 按区域裁出,转 WebP 后共约 360KB
踩坑:跨库搬产品图不能按 id 搬,要按「供应商+型号+名称」反查
跨库搬产品图时把
product_images.product_id直接搬过去,会把图挂到隔壁产品上。- 本地库与线上库的
products.id并不一一对应:同一批供应商在不同时间导入,id 段整体偏移(这次差 7 条),4283 条里有 3190 条的 id 对不上。 - 正确做法:按「供应商 + 型号 + 名称」的交集反查目标库的行;同名多行按产品 id 顺序一一配对。只按名称会命中重复,只按型号会命中同款四色,交集才唯一。
- 动手前先跑映射预演,并核对一件事:
原有覆盖是否被新覆盖完全包含。这次原有覆盖 369 个产品、新覆盖 668 个、原有而新缺失 0 个,才落库。 - 第二个坑:
product_images.created_at是 NOT NULL 且没有默认值,手写 INSERT 必须显式补时间戳 —— 否则抛 IntegrityError,而delete已经在同一事务里执行过,看着很像「数据已经没了」(实际会回滚)。 - 第三个坑:先传了图片文件、后补数据库记录,中间跑了一次审查脚本,被判成「233 条没有产品图」—— 审查脚本查的是
product_images表,不是文件系统。文件和记录要一起到位再跑审查。
- 本地库与线上库的
0.10.0 上线:售后记录、利润双口径、员工派工、官网产品中心
本版按工作流拆成 6 个提交推送,每块都带一份 ADR / 模块说明:
- 售后记录独立成表(ADR-015):交付之后客户回来的事(报修 / 补装 / 回访)不再塞进「跟进记录」。看板「售后」列改成跨阶段汇总列 —— 阶段在售后 ∪ 有未完成记录,所以同一张卡片可能同时出现在「已交付」和「售后」。这是刻意的:一列回答「走到哪一步」,另一列回答「还有谁在等我们」。
- 交付后不再催跟进(ADR-016):已交付 / 售后 / 已流失不再挂红色「未跟进」;但用户显式约的「待跟进」照旧保留。原则是「派生告警抑制,显式承诺保留」。
- 利润给两个口径:现金利润(银行里真进出的钱)与经济利润(再扣掉自有安装的影子人工,设备款 ×15%)。只报一个,必然有「看着很赚、其实在给自己打工」的单子被当成好生意。
- 员工管理 + 项目派工(ADR-017):员工就是账号(补工种与电话),不另立名册;派工表挂账号真外键。派工是计划、打卡是实际 —— 两本账才看得出「安排三个人只来了两个」。
- 官网产品中心(ADR-018):产品库逐条标记「上官网」(370 条审出 200 条),对外开一组只读白名单接口(列表 / 按 id 批量 / 详情 / 图片)。只出厂商建议零售价,不出进货价、不出供应商、不出规格原文里的内部备注;没有价就显示「询价」,不拿成本乘系数编价。CORS 单独一组,只对公开接口放开。
- 安全:修掉静态回退的路径穿越(P0,实测可读到签名密钥与整个数据库),定价倍率不再随产品接口下发(那是定价策略本身)。
- 线上数据:产品图 703 张 / 8.3MB 同步上线,200 条标记落库。公开接口实测:200 条、分页 100/页、未上架与不存在的 id 一律 404、响应体里扫不到进货价与供应商字段。
多选批量卸载:系统一次只让卸一个,就做成队列
需求:应用不能多选一起删吗?选完从队列里删。
做不了真批量:Android 不准静默卸载,每卸一个必弹一次系统确认框。所以做成队列:勾 N 个 → 依次弹 N 次确认 → 每从系统页回来就接下一个,中途取消的那个直接跳过。
实现上两个细节:
onResumeCheck()里先看队列再看重扫,否则“回来就重扫”会把队列冲掉- 发下一个意图前
delay(700),等系统卸载界面退干净,否则意图会被吞
浮条显示「还剩 N 个」+「停止」。默认仍是单点模式,多选要用户主动打开 —— 卸载不可撤销,不该让一次误触变成全部损失。
高德被当成僵尸应用:三处根因都修了
反馈:应用多久没用判断不准,高德地图我还在打开使用。
先拿证据:
dumpsys usagestats里高德明写着lastTimeUsed=10-08、appLaunchCount=147—— 系统有记录,是我们的查询没取到。三处根因:① 只查
INTERVAL_BEST:华为挑中的那张表里这个包恰好是空的 ⇒ 改成日/周/月/年/BEST 五个区间全查取最大值。② 只看
lastTimeUsed:lastTimeVisible/lastTimeComponentUsed/lastTimeFS更新时机各不相同,有些应用只更新可见性或前台服务 ⇒ 四个字段取 max,用反射取(API 级别不齐,缺方法当 0)。③ 「查不到记录」被当成了「没用过」⇒ 加两道否决:近 30 天 Wi-Fi 流量 > 512 KB 算「还在后台活动」(
android.app.usage.NetworkStatsManager,包名不是android.net);面板里加「我在用,别再推荐它」写进SettingsStore.keepApps。1.4.0:大文件能预览视频,能一键转到电脑
「MP4 · 1.2 GB」这种行没法判断,飞哥原话:得先预览才知道能不能删、还是该转到局域网存储。
先看见:列表直接出缩略图(视频取第 0.1 秒画面,避开纯黑首帧);点行弹面板,三个动作按后悔成本排序 —— 看一遍 → 转到电脑 → 删掉;播放用系统 VideoView 不引 media3(30 MB 依赖还会和 compose 版本打架),控制条自画;删后进回收站,撤销时把文件放回大文件列表。
转走:电脑端
tools/sm-receive.js(零依赖 Node,POST /upload流式落地 →(本机路径));UDP 8788 广播发现,路由器拦广播时能手填 IP;OkHttp 流式写,几 GB 不进内存,请求带size由服务端核字节数,不一致删半截返 400。两个坑:① 本机 launchd 彻底不可用(
bootstrap恒报5: I/O error)⇒ 改 python 双 fork + setsid,验证PPID=1才算脱离,开机自启靠登录项;② 两个 gesture detector 写在同一个pointerInput里第二个永不执行 ⇒ 进度条改 Material3Slider。相似照片只按字节分组会删错照片,改三重校验(1.3.0)
上一版相似照片只按「字节数相同」分组,页面上还写着「字节完全一致,是同一张图的副本」。
真机截图一拍出来就露馅了:第 1 组 6 张里,第一张是横版海报、其余是竖版人物照 —— 它们只是文件大小恰好一样(3.9 MB),内容完全不同。用户照着这个结果删,会删掉完全不同的照片。
改成三级校验,三项全等才归为一组:
1. 字节数
2. 像素宽高(
BitmapFactory.Options.inJustDecodeBounds,不真解码)3. 全文 MD5
性能上只对「尺寸重复的那几十张」算哈希,不是全盘算。代价:扫描 173s → 197s(+14%)。修正后从 179 张降到 176 张,多出的 3 张就是误判。
同时把界面改成逐张摊开:三列网格、格子按图片真实宽高比算(竖图不裁头脚)、点开可双指放大 1~6 倍、逐张改「删除 / 保留」,并去掉了整项勾选框 —— 防止不看照片就整组删。
另一个 bug:撤销后照片回来了、分组数据没恢复。用删除前的分组快照
photoBackup整组还原。华为只保留 184 个应用中 70 个使用记录
真机上「僵尸应用 0 个」,一开始当成是逻辑 bug。查下来是系统在裁剪数据:
dumpsys usagestats里这台华为只保留了 184 个应用中的 70 个的使用记录,其余应用不是「没用过」,而是「系统把记录扔了」。这直接影响措辞和归类。改成:
- 有确切打开记录的才叫「90 天没打开」
- 查不到记录的归「系统没留记录」,副标题写明「不等于没用过」
- 覆盖不足时默认只展开 8 行(
DORMANT_PREVIEW = 8),不让一屏陌生名字堆在面前 - 该分组不算进「建议卸载」的推荐量,只作为参考
教训:“我没查到”不等于“不存在”。在别人的 ROM 上做判断,先弄清楚它愿意给我们看多少。
应用清理 1.1.0 / 1.2.0:僵尸分组 + 缓存 + 卸载
1.1.0 把应用清理做进去,1.2.0 加占用排序 + 「云端可恢复」风险标注。
分组逻辑:
- PROTECTED:系统应用 + 保护名单(输入法 / 通讯录 / 支付类)
- ZOMBIE:
days >= 90且真的有打开记录 - IDLE:30~90 天
- DORMANT:没有任何打开记录 + 装了 3 个月以上 + 占用 ≥ 80 MB
后面改过两次:
① 推断门槛本来用
lastUpdateTime,但应用市场自动更新会把它刷成「刚刚」→ 所有推断全部失效。改用安装天数 + 体积。曾想用getAppStandbyBucket(pkg),但那是非公开 API,撤回。② 「可清缓存」曾经统计不进体积,列表上显示「可清 0 B」—— 修正统计口径。
卸载走
ACTION_DELETE意图,不可静默也不可撤销,所以入口默认是逐个点,不预设全选。token 对照实验:12 项一次提交 vs 分 4 批(+46%)
飞哥问「所有文件一起提交和多次提交,token 额度一样吗?不限制调用次数吧」——做了对照实验。
同一批 12 项,两种提交方式:
- 一次全给:3,082 tokens
- 分 4 批:4,512 tokens(+46%)
原因很直白:每次调用都要重发一遍 system prompt 和字段说明,分批只多花重复开销、不少花任何真正的判断量。
但金额层面这事儿可以忽略:DeepSeek 输出单价是输入的 3 倍,而这组数据的总花费不到半厘钱。结论:批量更省,但省的那点钱不值得为它牺牲稳定性 —— 项数太多时反而要分批,否则输出被截断、JSON 不完整。
另一个已确认的事:DeepSeek 没有「调用次数」限制,只有 token 计费(峰谷价)。所以设计上没有做请求次数限流,只做了服务端 token 计量日志:
[judge] items=.. in=.. out_tok=..。不连 WorkBuddy CLI,AI 走服务器代理
问题:手机版能不能像 Mac 版一样,把 WorkBuddy CLI 当 AI 基座?
实测三条通道:子进程
-p、HTTP--serve、--acp。结论是不该这么做,三个硬理由:① CLI 是 Agent 运行时,不是模型 API。手机要的是「一段 JSON 进、一段 JSON 出」。
② 电脑必须常开。
--serve绑定在电脑上,手机一出门就断了。③ 读不到手机的文件。CLI 跑在电脑上,扫的是电脑磁盘 —— 手机要判断的是
/sdcard。④ 安全隐患最重:
--serve的 Password 等于那台机器的任意命令执行 + 文件读写权,不能当普通令牌发。所以定的是:手机 → 自建服务端 → DeepSeek。服务端只做三件事:白名单过滤字段、拼 prompt、把 key 藏在服务端。
对比直连 LLM:直连省一台服务器,但 key 在 APK 里可反编译扒走,而且换模型、限量、熔断都做不到 —— 目前不需要体量,但需要能改。
服务端落在自有服务器 (服务器IP),nginx 反代 trace.filebreeze.cn/sm/,
/sm/health实现在线体检。手机版 1.0.0:8 屏 UI + 扫描引擎 + 回收站
一天内从设计稿到能装机的 8 屏:概览 / 扫描 / 可清理 / 判断详情 / 大文件 / 应用清理 / 设置 / 授权 / 完成。
技术栈 Kotlin + Compose,不用 XML。45 枚图标没手抄 —— 写了脚本从
design/index.html的 symbol 库直接转成 ImageVector,设计稿一改重跑脚本即可。扫描是双路:MediaStore 拿媒体元数据 + 文件遍历拿其余。真机(华为 HBN-AL00)跑一遍 11 万文件 / 124 GB,183 秒 —— 能用但太慢,已列为下一版首优。
删除一律进回收站:
/sdcard/.storagemate/trash/<batchId>/+ manifest.json,30 天内可整批还原。中转通道被旧连接误删导致 37 帧静默丢包
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
relayChannels在 relayEnd/断连即释放;唯一落盘是取件码 DropStore(TTL 24h、5min 扫),实测目录为空。 - 顺手查出真 bug:
cleanupByDevice不判断设备是否已被新连接接管就删 relay 通道。现场 13:58 tao-mac→华为:通道 04 秒建立、14 秒接收端断开被清、16~20 秒发送方又推 37 帧全部Unknown channel,而代码只console.warn不回帧 → 客户端进度条照走、接收端缺片。 - 修复:服务端改为按
deviceId重绑 from/to + 30s 宽限期(期间重连自动恢复),Unknown channel 回relayError(CHANNEL_LOST)(同 requestId 只报一次),新增relayAlive探活回复relayAccept(recovered);客户端RelayTransfer区分暂时/致命,分片边界awaitChannelReady挂起等恢复,超时 30s 才失败。 - 验证:服务端 jest 52/52(新增 relay-rebind 5 项)、客户端 flutter test 152/152(新增 4 项);生产
tool/relay_rebind_live_check.js实测断开前 3/3、重连后 20/20 帧,日志出现🔁 Rebound channel。 - 坑与部署:服务端 src 长期「线上比仓库新」(bindings 修复只改了服务器),本次先回写仓库再改再部署;
docker compose up -d --build后 health OK / WS 101,顺手把已提交未上线的/api/errors限流+读鉴权一并带上线。提交7b4063f已推 Gitee。
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
语音识别提速 1.1 秒:省下来的是一行发送节奏,不是换架构
- 讯飞 IAT 本来就是 40ms 一帧的流式协议,但调用方是「整段录完才发送」,发送耗时直接叠在端到端上:2.77 秒的话光发出去就要 1.39 秒。
- 发送节奏从 0.02(2 倍速)改到 0.004(10 倍速):0.97 秒短句 0.89→0.46 秒,2.77 秒长句 1.79→0.67 秒。本机 15 轮全通,识别文本逐字一致(含标点)。再压到 0.002 收益趋平且限流风险升高,停在 0.004。
- 没有改成真流式:只再省 0.2~0.3 秒,而握手 + 尾包 + 收尾约 0.24 秒的固定成本躲不掉;更关键的是真流式做不了整段音量归一化,而客厅这台电视麦克风增益极低(说话 rms 200~600、底噪 550),识别率全靠这一步。
- 端到端剩下的大头是判停 1300 毫秒,不是识别本身。再想快应该动判停,但要先统计真实说完后的静音分布,否则短句准确率会掉。
米家 / 涂鸦 / 天猫精灵三朵云接进同一套设备模型
- 米家的房间归属直接取 /v2/homeroom/gethome 的 roomlist[].dids,不自维护映射;动作统一收敛到一个 POST /api/action 接口。
- prop/set 回 code=1 不代表失败(部分属性只可回读),所以写完一律回读核对。蓝牙子设备(blt.3.*)先按 datasource=2 读、缺的点位用 1 补。窗帘的 target-position 是枚举(0 暂停 / 1 开 / 2 关),不是百分比。
- 红外遥控是电视之外的独立设备:电视彻底关机后仍能开机,唤醒词「关闭电视」也走这条红外。
- 米家动作曾经全部失效而接口仍回 200:动作 key 取的是 urn 末尾的版本号,「1」把十几个动作全撞成同一个。
- 涂鸦的签名铁律是 METHOD + sha256(body) + path(query 按字母序),HMAC 的 message 是 client_id + access_token + t + stringToSign。少拼 access_token 会回 1004,但 /v1.0/token 照样成功,很容易误判成参数错。online 只信设备列表、不信 status(离线时会返回缓存)。
- 天猫精灵与 BLE Mesh 各有一个桥。Mesh 的 NetKey / AppKey 等同设备钥匙,单独存放、不入库。
「能打断」不能听 HAL 声明:三层探测才问得出真话
- AcousticEchoCanceler.isAvailable() 只是厂商 HAL 的声明,不等于这条录音真的有回声消除。真判据是 create(sessionId) 成功且 getEnabled() 为真,而且必须在 startRecording 之前 enable——启动后再挂上去,HAL 已经按无 AEC 的路径把管道建好了。
- 最终还要看运行时:播报期间跟踪「自己说话时麦克风里还剩多少」。AEC 有效时残余只有几十,人声 300+ 立刻超线;无效时基线被抬到上千,人声压不过它,于是自动退化成「打不断」(连续 1.6 秒残余超过 1600 直接判定 AEC 是摆设并关麦)。
- 于是按能力分档而不是按机型写死:有 AEC 的电视边说边听,说话即打断;没有的退回半双工,播报时关麦。家里四台电视装同一个包,不用改配置。
- 遥控器语音键(219/231)根本到不了 App:在 framework 层被厂商语音助手吃掉,日志里连 key= 都没有,同一时刻发 OK 键(23)正常记录。所以半双工机器的打断入口是「OK=打断并聆听、BACK=只停播报」,播报时界面上直接写「按 OK 打断」,否则这能力等于不存在。
- 打断不能借用「停播报」那条路:它会把会话状态一起清掉,用户刚开口就被踢出对话。只停播放器、保留会话,也不清预录缓冲——开口那几百毫秒正好补回来。
- 顺带修掉两个「好电视反而变差」:好电视通常带系统识别引擎,原来「有就用」会把自建链路整个让出去,丢掉离线唤醒分流、10 秒连续对话和打断;TTS 也统一走云端同一音色,免得四台电视四种声音。
电视端:从「打开 App 按着说话」变成「喊一声就能聊」
- 8 个离线唤醒词常驻,喊「小悦同学」或「小悦管家」即应答并进入对话窗口,不用再开电视、开 App。
- 唤醒词本身不进识别:命中瞬间连同预录缓冲一起丢弃,否则会被静默判停截成一句「小悦同学」送去识别,屏幕闪一下「在听」就回待机。
- 熄屏待机:3 分钟无交互就把背光调到 0(screenBrightness 必须给 0,给 -1 是不熄屏),应用常驻、麦克风继续工作,唤醒时先恢复亮度再应答。电视从此不用关,应用也不用每次重开。
- 区分「熄屏」与「关闭电视」:前者只是关背光、还在听,后者走米家红外彻底断电;唤醒词「关闭电视」对应后者。
- 连续对话:唤醒后 10 秒内可以连着说,每轮重新计时,10 秒没声音才退回等唤醒。以前是一句落地就把窗口清零,第二句必须重新喊唤醒词。
- 唤醒应答是现生成的 2~6 字寒暄,不是固定的「我来了」;寒暄期间掐麦并压短,避免把用户紧接着说的第一句吞掉。
- 真机验收:第一句没听清(3301)时状态自动回「在听」,第二句不重新唤醒即识别成功;空闲到期距 TTS 播完 10.03 秒。
全屋智能报价表 v3 入库:61 项 33,047.15,脚本一键出 xlsx + pdf(4dfb2fd)
tools/build-quote.py一键生成 xlsx + 同名 pdf,成表与脚本一起入库(commit4dfb2fd,随6d74cb9一并推送fb4b54f..4dfb2fd)。- 61 项设备款 28,736.65,含 15% 服务费 33,047.15;三档:A 15,459.80 / A+B 24,115.65 / 全配 33,047.15。6 张 sheet:报价汇总 / 降本对照 / 设备明细 / 九大系统场景 / 选型依据 / 施工与验收。
- 延庆样板间条件:集中供暖、地暖不可控 ⇒ 不做温控面板,温度只靠空调伴侣;不装新风 ⇒ 用自动开窗器替代;32㎡ 单间不上 AP ⇒ 一台 4 天线路由。
- ⚠️ 开窗器必须按 980/台(后装免布线锂电款)报,不能用 CRM 里 178.2 的「UIOT 窗户电动开关」—— 那是阁楼小扇窗简易款,推不动平开扇。
- ⚠️ 表格想压成一页,光调
row_dimensions.height无效(LibreOffice 会按内容撑高)⇒ 必须page_setup.fitToHeight = 1。生成后必soffice --convert-to pdf→ pymupdf 转 PNG 逐页看。
健康检查直连 /yqm/ 必 404:nginx proxy_pass 尾斜杠把前缀剥了,误触发一次回滚
- 写
--platform-only的健康检查时直接curl 127.0.0.1:8095/yqm/,三项判失败、触发了自动回滚(回滚本身工作正常,线上未受影响)。 - 根因:nginx 是
location ^~ /yqm/ { proxy_pass http://127.0.0.1:8095/; }—— 尾斜杠把/yqm/前缀剥掉了,服务自身只认/。反观/m/那条是proxy_pass .../m/(保留前缀)所以直连 200,两条规则行为不一致,特别容易看错。 - 结论:直连自检一律用
/,/yqm/只用于经 nginx 的对外验证。 - 附带两个坑:① 远端
for f in $FILES前必须把换行清单tr '\n' ' ',否则换行被 bash 当命令分隔,报syntax error near unexpected token 'package.json';② macOS bsdtar 的com.apple.provenance扩展属性在服务器 GNU tar 上刷几十行警告 ⇒tar --no-xattrs。 - 哈希回查仍然必须两边先
tr -d '\r':线上是 CRLF、工作副本是 LF,不剥行尾会整文件全红(假的)。
- 写
后台管理补上专属部署通道:deploy.sh --platform-only + 数据库每日备份
- 起因:后台(
platform/)与主站同一个仓库,但部署通道完全不同 —— 主站走 deploy.sh(rsync 到 (服务器路径)),后台是手敲 scp 到 (服务器路径) + 重启 systemd。最容易出的事是「只跑了整站部署,以为后台也更新了」,而部署前哨只比主站页面、不会报这件事。 deploy.sh新增第三个互斥开关--platform-only(与整站 /--screen-only三者互斥),六步:① 线上代码打 tar + 数据库VACUUM INTO快照 → ② tar 管道上传(排除data/,数据库任何部署都不许碰)→ ③systemctl restart yq-platform→ ④ 健康检查(/+/m/+/api/dashboard/snapshot,还判响应体积,防止「服务活着但库坏了」)→ ⑤ 29 个文件逐个哈希回查 → ⑥ 经 nginx 对外复核。任一步不过自动回滚到第①步的 tar 包并重启,数据库不受影响。- 文件清单用
find而非git ls-files:未 commit 的新文件也必须能上线,否则「改完测不了」。 - 新增
platform/tools/backup-db.mjs:VACUUM INTO一致性快照(WAL 模式下cp会拿到「能打开、但内容停在几步之前」的副本且不报错 —— 最坏的一种备份)+ 三重校验(体积 >1MB / 能独立打开 /elder行数与源库一致 = 12,860)+ 按文件名时间轮转保留 14 份。 - 服务器 cron
10 3 * * *(与 CRM 的 03:30 错开),日志(本机路径);crontab 用grep -qF做幂等追加,不会覆盖已有条目。在env -i最小环境实测(不是只手动跑通):exit 0、12.5MB、elder=12860。 - 实测:29/29 文件哈希全绿,
//yqm//m//screen/全 200,全流程约 20 秒;回滚包约 96K。commit6d74cb9。
- 起因:后台(
2026-10-19
两处体验修复:测试按钮卡死 + 每次编译重弹权限
① 存储目标的「测试」按钮原本同步 SSH 探测,阻塞主线程十几秒看起来像没反应 → 改 Task.detached 异步,行内显示「检测中… → ✓ 连接正常,剩余 206G」。
② 反复弹权限的根因是 ad-hoc 签名的 designated requirement 是 cdhash,每次重编都变,TCC 视为新程序 → build.sh 改为自动匹配 Apple Development 证书,DR 稳定。
结论:本机开发用免费 Apple ID 就够,99 美元账号买的是别人机器上的信任(Developer ID + 公证),分发前再买。
WorkBuddy 基座接入的四个坑(都已定位)
① CLI -p 模式必崩:SetupGalileo → Config.startPull 里 setProxy instanceof 报错,只能走 --serve。
② --version 能跑是假阳性,不代表链路通——曾据此误判「CLI 可用但模型不回应」。
③ 所有请求必须带 x-codebuddy-request: 1,否则 403。
④ ACP 的 initialize SSE 流不能断开,一断就 Server not initialized;session/new 不收 model 字段。
另:⛔ 绝不能设 CODEBUDDY_BASE_URL(三个域名全 405),不设反而成功。
AI 接入收敛为双后端,A+B+C 三种方式全支持
A(主流):用户机器上已装 WorkBuddy → 起 CLI --serve 走 ACP JSON-RPC over SSE,零额外密钥,直接吃用户已有积分。
B(主流):企业网关 → CODEBUDDY_API_KEY=ck_... 走同一套基座,agent 层鉴权免登录。
C(兜底):BYOK 第三方 HTTP(豆包 / DeepSeek / OpenAI / 本地 Ollama)。
代码上把原 .cli 后端整段删掉——它和 acp 功能重复,两套 tab 让用户困惑。
产品核心重申:不做 CleanMyMac 第二,卖的是判断力
传统清理软件把判断写死在代码里(路径白名单 / 大小 / mtime),猜错就误删。
定调:核心是「判断力」,跨机归档只是它执行「迁移」这个决定的方式之一。
因此 AI 不是可选装饰,而是主链路;证据采集必须足够厚,让模型能回答「这个目录是什么、还有没有价值」。
首版跑通:扫描 → 证据 → 判断 → 清理闭环
一天内从零到可运行(4721 行 Swift,Swift Package 直编,不依赖 Xcode 工程)。
链路:ScanEngine 按体积 + mtime 粗筛出真正占地方的几十个目录 → EvidenceCollector 采集目录树、README 摘要、git 最后一次提交、文件类型分布、缓存占比 → AIBridge 交给模型 → 返回 {decision, title, reason, confidence} → 用户拍板。
清理一律走废纸篓,支持「放回原处」还原;AI 只出建议,不执行任何删除动作。
2026-10-17
大屏地图点位「红点跟着动、粉点不动」:progressive 渐进渲染不参与 geo 视图变换,改为分层固定抽样
- 现象:拖拽/缩放地图时红色紧急事件点跟随、粉色重点照护点留在原地。
- 根因:三层老人点位 scatter 开了 progressive/progressiveThreshold,12,860 点超过阈值走渐进渲染分支,该分支不参与 geo 视图变换更新;effectScatter 不受影响,于是「红点动、粉点不动」。
- 改法:新增 POINT_BUDGET + samplePoints() 按照护等级确定性等距抽样(480/400/560),12,860 → 1,440;不用随机是因为随机会让每次刷新点位跳动。去掉三层 scatter 的 progressive,symbolSize 1.3/2.0/3.0 → 1.6/2.4/3.2。
- 图例加「点位抽样 1:N」角标,抽样只作用于打点,统计口径仍全量。
- 验证:convertToPixel 像素判定,对照组漫游后命中 1/4,修复后 4/4;大屏自检 18/18 通过。commit fb4b54f,已上线。
全端版本对齐 1.5.0(build 16)并更新线上清单
- 1.5.0+16(含分片 flush 修复),全端对齐:macOS 40.7MB / Android 40.5MB / Windows 14.0MB 三包上站。
- versions.json、下载卡片、web-send.html 页脚三处同步。
- Mac、tao-mac、win-halle 重装并 9527 监听;华为 USB、小米无线 ADB 用 install -r 保数据。
- 三包 URL 全 200,线上 JS 含 4 处 v1.5.0,Web 接收页逐字节一致,回归 61/61;两端须同版本。
华为→iPhone 传视频失败:分片写盘没关文件句柄
- 华为→iPhone 传视频失败:接收端 pipe 完没 flush/close 就返回 200,缓冲未落盘,合并读到空分片,SHA-256 校验 422。
- 三条写盘路径全包 finally flush + close;中转合并前对账已收分片数 vs 声明数,缺片报缺哪几片,4xx/5xx 响应体 ≤500B 带进异常。
- 新增「2 分片并发上传」单测,不 await close 必坏可稳定复现;客户端测试 88 项全通过。
- 遗留「视频播放失败」是播放器解码该流失败,与传输无关。
2026-10-16
tools/verify-live.sh:把「线上 vs 工作区」逐文件比对固化成一条命令(112 个产物、两份差异清单)
- 把三方比对固化成 tools/verify-live.sh(c2968fd):只比不部署、不一致退出码 1,覆盖主站 100 + 大屏 12 共 112 个产物。
- 补的是「线上↔工作区」逐文件内容哈希那层,配 git status 凑齐三层;deploy.sh 前哨只看上次部署基线,看不到本机工作区。
- 两个坑:文件列表须压成空格分隔,否则远端哈希全空、全报不一致;comm 前须整体排序,否则把已匹配文件报成仓库独有。
- 合并后实跑 112/112 全绿,线上独有与仓库独有两份清单均为空。
并行会话的改动随部署上线后补交入库(685dda8)
- 工作区留了 5 项并行会话的改动没提交:about.html、两个 css、展厅图、自检脚本。
- 这批已随 22:48 整站部署上线,线上有而仓库没有就是纯风险,需回头补交。
- 逐文件核对线上哈希一致(17af676c…、图 56628B),显式 add 提交 685dda8,推送 60b7f17..685dda8,工作区清空。
- 含 about 页技术突破区块与 contrast 页两处静默 bug 修复;BSD grep 的 \| 坑须用 grep -E。
整站部署上线:套餐第四版 + 去角标 + 大屏一起同步(deploy.sh 53 秒,100+ 产物哈希全绿)
- 整站 deploy.sh 53 秒,100+ 产物哈希全绿零差异,manifest 已回写。
- 上线套餐第四版、47 张去角标配图、9 页讲解语音、大屏矢量底图。
- 部署前 diff 39 个文本产物仅 5 个不同,全是「线上旧 → 工作区新」;img 48=48 双向无差异,无删除风险。
- 备份线上 5 文件;复核 plans 页 v4 特征齐、v2/v3 残留 0,playwright 三页 0 溢出 0 报错 0 404。
- 副作用:并行会话未提交的 about 三件随部署上线,仓库里没有。
本轮入库推送:c69373d(去角标)+ dfc82ca(套餐重做),双机 merge 到 60b7f17
- 两个提交:c69373d 是 47 图去「AI 生成」角标 + erase-mark.py(36 文件),dfc82ca 是套餐重做(+815 −413)。
- fetch 见 origin/master 领先 4 个提交(大屏底图、平台后台、--screen-only),只碰 platform/、screen/,与本机零重叠。
- merge 干净合并到 60b7f17 并推送成功(1181d93..60b7f17)。
- 工作区留 5 项并行会话 about 改动未提交;仓库已同步未部署,线上仍第二版。
线上 plans.html 是「中间版」不是「最新版」:「线上 vs 仓库」只比两层,漏了工作区那一层
- 拉线上 plans.html 实测(43017 字节):线上是第二版(九个套餐),仓库 HEAD 更早,工作区才是第四版,昨天「线上比仓库新」只说了一半。
- 教训:只比线上与仓库两层,工作区有未提交改动时必漏判,要三层并列、比归一化内容而非时间戳。
- 已提交推送 c69373d + dfc82ca,双机 merge 到 60b7f17,仓库升级为第四版,与线上差距反而拉大。
- 线上仍是第二版,本轮未跑 deploy.sh;工作区还有 about 那批未提交改动,整站部署会顺带传上去。
套餐体系第四版:砍掉三档递进,改「四个便宜的智能设备小包(¥980–¥3,980)+ 定制改造分流」
- 套餐第四版:砍掉三档递进,改四个互不包含的智能设备小包——起夜防摔 980 / 厨房安全 1580 / 省力舒适 2680 / 呼救看护 3980。
- 扶手、防滑、洗澡椅移出套餐,另立「定制改造」分流;前装后装从第一步降为条件。
- 删原九个套餐整节 271 行与三档覆盖表,清 4 个弃用区块 CSS 6800 字符,套餐文字补 min() 封顶。
- 352 组回归全过,13 宽 × 2 模式横向溢出 0,四卡价签差 1px;四个起步价仍为建议值,未与报价核实。
部署前比对拦下一场事故:线上主站 3 页 + 3 css + 35 张图都比仓库新(未提交未推送)
- 上线前做线上/仓库/工作区三方比对:线上主站 3 页 + 3 css + 35 图都比仓库新且未提交,整站部署会覆盖并删掉展厅图。
- 逐文件比内容哈希(剥 ?v=、去 CR),不比 mtime;35 图差异与日记去角标批次对上(47−12)。
- 先备份线上 42 文件 / 1.6MB,给 deploy.sh 加 --screen-only(1181d93),只同步 screen/。
- 大屏 12 产物哈希全绿,外网底图 498KB、towns.json 8 个服务站;主站三页哈希与备份逐位一致。
取证与磁盘操作的三个教训(陈旧帧 / 抢焦点 / 误动用户会话文件)
- 截图取证踩两坑:screencapture 返回陈旧帧(两图 md5 相同);窗口抢焦点,误截到含真实地址的浏览器页面,已删图不外传。
- 无辅助功能权限,osascript 定位窗口一律 -10004,改整屏截图后按逻辑坐标裁窗口。
- 为截登录页移走 session.json,事后 accounts.json 显示 logins 1→2,移走的正是刚建好的会话,已放回。
- 结论:动用户文件前先看时间戳;get-task-allow 来自 Flutter release 默认 ad-hoc 签名,不是配置错。
登录页精简成一屏 + 登录状态保持 30 天(会话层落地)
- 登录页收成一屏一张卡;新建 session_store.dart,会话与凭据分存,退出只作废会话。
- 四条:滑动续期 30 天、改口令按 credential 哈希失效、令牌用 Random.secure()、坏会话文件只当没会话。
- 令牌明文存盘(600):挡得住旁人,挡不住拿到机器的人;勾选框默认开,到期日挂侧栏。
- 加「保留到 11 月 15 日」把底部说明顶出 1176×676 屏,说明压两句、导航进滚动区。
- 验收:analyze 干净、test 290/290、release 41.5MB。
记忆索引超注入上限:14201 → 3997 字符,老条目骨架下移 topics/14
- MEMORY.md 是项目工作记忆、注入上限 4000 字符,实测 14201,仅前 28% 可见,#206~#216 被截断。
- 骨架 #1~#205 下移 topics/14,#212/#215 补进 topics/13,索引重写为铁律 12 + 活跃 11 + 导航。
- 14201 → 3997(压 72%),SESSION-CONTEXT 补写至 10-16。
- 查出两处假状态:#206 报告已在 origin/main(0a5af02),shortstay.js 早已接线(5690640)。
踩坑:macOS 沙盒让「CLI 产数据包」与「App 读数据包」永远看不见对方 —— 最终关掉沙盒
- 数据包放好 App 仍读范例:开沙盒后 HOME 指向容器,CLI 与 Finder 写真实家目录,互相看不见。
- 第一次修法方向错:沙盒里读不到真实家目录,只靠手工复制进容器才看着好。
- 最终关掉 App Sandbox,统一落点 Application Support/yueju_calendar/,账户文件一并迁走。
- 取证坑:screencapture 返回陈旧帧、旧实例挡住画面(先 pgrep)、kill 的 SIGTRAP 不是崩溃根因。
- 交付前结束旧实例,摘掉 dev-autologin 标记。
真实日历进 App:数据包 + 本机账户登录门(15,444 条 / 3,742 天上屏)
- 真实日历进 App:中间层 app-bundle@1(5.6MB)只装事实,15,444 条 / 3,742 天上屏。
- 新增数据包解析、PBKDF2 口令哈希、账户原子落盘 600、冲突判定与登录页。
- 四条口径入代码:按 localDate 分组、全天显式 allDay 且不上轴、零长度不重叠;真实重叠只出待裁决。
- PBKDF2 10 万次(345ms);未登录不读一个字节,退出清内存,限制范围印在登录页。
- analyze 干净、测试 266/266、release 41.3MB;未 commit。
10-16「在家」拆三张卡:两个根因都改了 + 历史三张卡并成一张
- 「在家」拆三张卡,根因一:上行销号读当前库,1~3 秒内离开即永不重传;改快照判据+迁移重传。
- 根因二:163 米假点踩坏两把尺子,moveLimit 500 判「还在」、isSameVisit 固定 150 判「新趟」。
- 新增 ACC_TRUST_M=100;sameVisit 补「一有一无」第三条路,并为一张。
- 全库对拍卡片 93→90 组、零消失;test-merge 139/0;线上未闭合停留 4→1。
- 三个 commit(App 134/1.60.29)未推送;两台真机已核 134。
三端补「帧看门狗」:修掉画面静默冻结,并纠正一个错误归因
- 画面冻在 12:34,源端 OSD 正常、日志六小时无重连与拉流错误:三端只做首帧超时,没有中途停帧检测。
- 判据改为「最近一次收到新帧的时间」:mac 10 秒无新帧重建并加 120 秒内 3 次的刹车,Web 四路径三档信号,TV 看 currentPosition。
- 纠正错误归因:ZLM 按需拉流 0 路,摄像头只有 mac 的 5 条直连、每台 1 条已是最小,改走 ZLM 不做。
- 三端编译通过,看门狗自测 13/13;提交 f1a98e7 已推。
push 被拒才发现远端领先 10 个 commit:本地 `branch.ab +0 -0` 是旧记忆,不是现状
- Windows 侧 push 被拒,远端已被领先 10 个 commit,本地 branch.ab 却仍 +0 −0。
- 根因:本地 origin/master 引用停在 10-15,未 fetch 的领先/落后只是上次的印象。
- 处置:fetch 后比两向差异,确认只碰 deploy.sh 不同行,pull 干净合并。
- 合并后核对 deploy.sh 含底图且 0 个 CR;merge commit 497d925 推送成功。
- 固化为流程:推送前 fetch → 比差异 → 有领先先合再推。
新增子工程 platform/:养老社区平台数据管理后台(零依赖 Node + 内置 SQLite,24 张表、49 项交付自检全绿)
- 新增 platform/ 子工程:养老社区数据管理后台,commit 1f51774,29 文件 / 8314 行。
- 零依赖(含 node:sqlite)、零构建、单进程同时供后台与大屏接口;24 张表、7 个预置角色。
- selfcheck 49 项全绿;演示快照客户 12860、设备 67284、工单 6056、告警 1260。
- 待处理:默认管理员口令须改,config.mjs 硬编码本机路径需环境变量覆盖。
- 未部署,下一步定服务器、端口、反代与大屏 Token。
大屏不再“空虚”:接入延庆真实路网/水系/铁路底图,并把对外口径从「乡镇街道」改成「服务站」
- 大屏地图补真底图:新增 yanqing-basemap.json(488KB,OSM 转 GCJ-02),道路两级配色、水系与铁路分层。
- 对外口径从 18 个乡镇街道改为 8 个服务站,原乡镇降为内部聚合桶。
- 加右下缩放控件;iframe 嵌入时 postMessage 就绪信号撤加载遮罩。
- 重点照护由红改紫;deploy.sh 的 SCREEN_BIN 必须补底图,否则线上缺底。
- commit aa9ff32,9 文件 +499/−162;12 个产物比对 8 一致、3 处差异已说明。
macOS Release 首次跑通 + 整体入库(181 文件 / 14303 行)
- commit 432a4bd 推送 Gitee(181 文件 / +14303 行),本地与远程同步。
- macOS Release 跑通:40.8MB,六屏渲染正确。
- 沙箱里启动带 app-sandbox 的 App 会 SIGTRAP(栈顶 _libsecinit_appsandbox),不是 App bug。
- 隐私边界逐项 check-ignore:日历导出、留痕、轨迹与 .env 均未入库。
- 测试 186/186、analyze 干净;留痕报告 5 档视口无溢出、目录跳转 10/10。
生活留痕层落地:支付流水与订单 → AI 推理补全日历
- 打通 13 类事实源(支付流水、酒店/火车/机票订单、外卖点评)进生活留痕层。
- 两条口径:occurredAt 才进日历、bookedAt 只做关联;只有住宿/铁路/航班单独造条目,标题须具体。
- 四级去重 L1–L4,合并须留来源链可撤销;补全/填补/纠正三类产物门槛不同。
- 样例实测:读入 20、L2 合去 2 得 18,补全 2、填补 2、纠正 1、行程 1。
- 修 6 个真 bug:弱证据按天聚合、mergedFrom 可审计、同指纹第三条被静默丢弃;46 条单测;真实消费导出未拿到。
一次收口 8 个 commit(#199~#212):海拔 / 总结报告 / 骑行成卡 / 偏移剔除 / 头锚定 / 出门第四条腿
- 8 个 commit 推送 Gitee(28d68b3..6e66f8e),App 出到 132/1.60.27。
- 出门检加第四条腿「精度跃升」(Wi-Fi ±30m→户外 ±4m),比出发腿早 7 分半。
- 海拔死锁:fused 不带 alt,81399 点 0 个有海拔,另开只收海拔的旁路。
- 骑行成卡;总结报告重算新增 revision 行,年报须给 partialFrom(记录率 4.2%)。
- 偏移剔除:假点离路网仅 1 米,错在时间不在空间;10-16 折线 42.29→21.39 km。
2026-10-15
隐私从「配置项」改成「架构约束」
- 常见做法是用一个配置开关控制「要不要记 IP」,但那只是承诺,不是约束 —— 一个手滑的日志、一次临时排查就能绕过去
- 改成结构性约束:IP 只在内存里查一次归属地,查完立刻置空,继续往下传的对象上根本不存在这个字段。存储域在代码结构上就拿不到 IP,不需要靠任何人不犯错
- 访客标识一律做带盐的单向哈希(32 位十六进制),并立为不变量:库里任何匿名标识都必须是哈希,不许直接把会话 id 塞进去当「匿名 id」—— 那只是把明文字段换了个名字
- UA 默认不落原文,只留操作系统 / 浏览器 / 设备类型三个分类值
- 这条不变量写成了自动化自检脚本并进发布门禁:跑不过就发不出去,不靠人看
- 理由:隐私一旦是「配置项」,它就会在某个赶进度的下午被打开,而且再也不会被关闭
v0.1 打通链路:埋点 → 落库 → 看板渲染全通
- 三个模块:总览 / 实时 / 流量。一套脚本嵌进站点就能出数
- 链路:浏览器采集 → 打点接口 → 落库 → 查询接口 → 看板渲染
- 当天定下三条底线:单租户自用(不做 SaaS,无注册 / 无计费 / 无多租户)、隐私优先、打点不能影响业务站
- 打点路径定在
/fbtrack而不是/api/track:各站自己的/api/已被业务后台占用,会抢先匹配。这个坑不看代码看不出来,接第二个站的时候才会炸 - 接入成本压到一行脚本 + 一行初始化,不用改 nginx
- 同时产出产品规划、架构设计与交付说明三份文档
全站 35 张配图去掉「AI 生成」角标:云 erase 排到 4.7 分钟/张 ⇒ 改本地 cv2.inpaint,顺手沉淀 tools/erase-mark.py
- 全站 47 张图里 35 张带「AI 生成」角标;数字阈值与模板匹配都不可靠,最后裁角放大拼联系表目视过完。
- 云 erase 排到 4.7 分钟/张、临时凭据 20 分钟过期,改本地 cv2.inpaint(Telea),35 张几秒跑完。
- 两条规律:角标按尺寸等比锚定右下,只在预期位置 ±16px 内搜;判据取与局部中值差的绝对值,亮底是暗字。
- 处理前匹配分 0.57~0.71 → 0.09~0.21;--scan 复检 47 张全干净;沉淀 tools/erase-mark.py。
讲解模式从 2 页补齐到 9 页:289 段 / 45 分 43 秒;顺手加一道「合成前选择器预检」把发现问题的时间从 8 分钟压到 29 秒
- 讲解模式从 2 页补到 9 页:新增 7 页,九页共 289 段、45 分 43 秒、音频 15.7MB。
- 加合成前选择器预检:读旁白表用无头浏览器比对,把发现问题从 8 分钟压到 29 秒。
- 抓到两处结构陷阱:智能厨房用 .sec-head/.kt-leadline,遮阳开窗节容器是 .sd-split,照抄会整段不亮。
- check-tour.py 改多页,清单从 js/tour-*.js 反查,避免旧页数的假绿。
- 9 页 × 3 视口全过、选择器 289/289 命中;288 是手工汇总错。
智能遮阳从八件扩到十二件 + 新增「窗户也能自己开合」:扩内容先量节底色,标题折行先量字宽
- 智能遮阳 8→12 件,按驱动→帘型→开窗→感知→控制重排,新增布艺双开/单开、香格里拉帘、开窗器。
- 新增「窗户也能自己开合」一节,口令补一组、FAQ 3→5 条。
- 插节后 04/05/06 底色与编号要整体顺延;底色探针要读 backgroundImage。
- 660px 下四卡差 46px 是标题折行(245px 卡宽 vs 247px 文字),改短即齐。
- 与讲解补齐 7 页一起提交 1c870f0、tag tour-9sys-live;12 卡三宽等高,新节暂无配图。
system.html「三个时刻」「三步走」层层嵌套:整卡套链接时全局把 </article> 替成 </a> 打穿了同文件其它区块
- 「三个时刻」「三步走」卡层层嵌套、卡高 2084/1371/687:整卡套链接时全局把 </article> 替成 </a>。
- 修 14 处错标签(8 处 →span、6 处 →article),一条 27 字正文收到 24 字。
- .sy-steps 三列断点 660→900;列表 flex 吃余高,底距 30/63/63→30/30/30。
- 16 页标签配对零错配、352 组全过;批量替换绝不能用全局 </article>→</a>。
首页 hero 换成高端别墅效果图 + 九套系统各配横版封面图,顺带沉淀一键生图工具
- 首页 hero 换第二版:高端独栋别墅起居厅、无人物,去水印后约 43KB。
- 九套系统各出一张横版图(1280×720、32~60KB),system.html 加 .sy-mod-fig,卡片变图+文案+入口。
- 沉淀 tools/gen-image.py:混元调用+429 退避+当场下载+去水印+转 webp,一条命令出图。
- 两坑:响应路径变 data.RetMsg 需双层兜底;erase 缺 token 曾 9 张全失败,补后 9/9 过。
- 47 张图线上哈希全一致;水印只能像素级擦除。
云养宠对战改用云函数轮询方案(免费替代云托管)
- 云养宠对战改云函数轮询:pet-game 新增 syncGame、startGame,房间状态存 game_rooms.game_state,500ms 轮询替代 WebSocket,全程免费。
- 前端移除 WebSocket 与本地模拟降级,改为轮询;拔河累加点击,消消乐/跳跃赛简化为点击得分。
- 胜负统一写回 game_state,保证双方读到一致 winner;数据源归属文档已整理。
- 里程碑 11 项全完成,进度 100%,commit 8d51e28。
夜间守护:过 0 点还在看短剧就拦(新模块 · 遮罩倒计时,待真机验收)
- 夜间守护:00:00–06:00 检测短剧 App,连看 5 分钟进 60 秒倒计时,超时进全屏遮罩。
- 五个文件判据与动手分开,NightPolicy 纯函数;挂 TrackingService 上,零新增常驻通知。
- 真机三坑:MIUI 启动时回收悬浮窗权限须先启动再授权;WRAP_CONTENT 截断正文;epoch 三个入口没自增。
- 单测 391 全绿,commit c4d9728 已推;未出包(仍 1.60.11),真机验收未完成。
以九大系统为主线重排首页与三个说明页;关于我们改成北京全市
- 按九大系统重排首页与三个说明页:首页加 9 张整卡可点目录卡,为什么改/改造前后加系统映射,套餐加 9 格覆盖条。
- system.html 的 title/description/og 从七个模块改九大系统;关于我们改成北京十六区。
- 卡内文案统一 19–20 字:三个断点阈值分别 16/18/17 字,15~16 字会掉成 1 行、卡矮 31px。
- 长辈模式 320px 溢出 14px,单独封字号与既有规则打架,改整宽+允许换行;352 组溢出全 0。
讲解语音换成百度大模型音库「度禧禧」:只换音色不动节奏,并补上一条能真正拦住错的断言
- 讲解语音换百度大模型音库 per=4146 度禧禧,只换音色不动节奏;spd=2 实测 9.77s,接近旧版 say 的 8.60s。
- 成片 32 段、6 分 20 秒、1249 字、2229 KB,逐段偏差在 ±1.8s 内。
- 加段级缓存:改一句只重合成一句,整页重建 1 分钟→3 秒;ENGINE 一行可切回 say 做离线兜底。
- 修掉旁白提到页面上已移走的智能窗帘、下标指错,改为五件并指向 AI 管家中枢。
- 自检加「全段时间轴选择器命中」断言并计入失败数——原来只打 warning,缺陷藏了一轮。
AI 主动开口(nudges)P0/P1/P2 一次上线:九类话题 + 七道闸 + 退路闭环
- AI 主动开口 P0–P2 上线:服务端 nudges.js 预生成话术(9 类检测器),App 决定说不说。
- App 侧 NudgeGate 纯函数 23 条单测、NudgeSync、ChatMessage 加四列、DB 升 v11。
- 修掉真错:候选 expire_at 是当天结束,安静时段 HOLD 会让候选先过期。
- 「全关」用 none 哨兵,「自动关闭」落盘 muted_kinds + 水位线;迁移消息零丢失。
- 47 脚本全过(test-nudges 123/0)、App 单测 368/0。
2026-10-14
「通电」不等于「在工作」—— 待机的烤箱被当成运行中
- 蒸烤箱待机被算成运行中:设备同时返回 power=true 与 status=standby,旧代码只看 power。
- 拆成「通电」与「在工作」两个语义;烤箱用白名单,只有烹饪中/暂停算干活,未知一律按没在工作。
- 选白名单因漏报误报代价不对称,告警一说谎就没人信;「运行中」在六个位置统一走同一字段。
- 真机验证房间页与智能页都变「0 台运行」,设备页如实显示待机。
文案里的病句:「一楼蓝色的一楼蓝色」
- 管家回答出现「一楼蓝色的一楼蓝色」:5 处直接拼「房间+的+设备名」,没走既有称呼函数。
- 该函数也只挡了一半:只处理设备名等于房间名,没处理设备名里已含房间。
- 收口到一个函数两条规则:名字含房间不再拼,名字就是房间名退回类型名;8 个用例含空房间/空名字边界全过。
家庭服务主机上线:局域网设备终于能在 4G 下控
- 家庭服务主机上线,四段体检全绿:本机服务、隧道进程、服务器三端口、公网三路径 200。
- 公网读到烤箱真实状态(待机、腔内 22°C、门关、童锁开),只认同网段协议的设备在 4G 下也能控。
- 探针实测 -60dBm、信噪比 31、5GHz、网关 4.5ms、公网 13ms、零丢包。
- 5 个系统级服务 + 1 个转发容器均开机自启;连不上时文案分层,区分链路问题与设备故障。
实机部署的五个坑,每一个都伪装成别的问题
- 五个坑:变量名后紧跟中文被并入变量名;端口被占,反向隧道只绑 IPv6 仍返成功,请求打到别家返回 200。
- 本机 8000 被另一项目容器占用,烤箱服务改可配端口 8001。
- 本地网络权限:包管理器装的 framework 解释器连不通,借 Docker 网络做 TCP 转发;测连通要用真正跑服务的解释器。
- 依赖漏声明,查清该库本就在公共索引上,改回正常依赖管理。
- 分段体检才能定位断在哪一段。
真机装机成功不能只看退出码:安装命令几乎不打印任何输出
- 真机装包退出码 0 却几乎无输出,容易误判静默失败;该命令成功时本就只打两行,接管道还会被缓冲吞掉。
- 判据落到设备:用构建工具链内置工具查应用标识是否已装,再列设备应用清单确认。
- 系统设备管理命令对这台手机一直报「设备未找到」,只有项目自带工具链认得。
- 装机是先卸载再装,传输历史与设置会被清空,验收前先告知使用者。
传输到一半打开 WiFi 就停了:断网 / 切网现在会自动续传
- 传到一半开 WiFi 就停:重试 1 次+退避 1 秒约 2 秒窗口,远短于换网 5–15 秒;续传数据存了却没有恢复入口。
- 新增「等待网络」状态(占住并发位、最长 3 分钟),恢复后自动续传并重新解析对端地址;分片超时 30→15 秒。
- 网络类异常走等恢复、业务类走退避,两套计数器;顺带修状态文本只转入参小写、并发分片重复上报开始。
- 客户端 86 项全过(新增 8 项覆盖网络恢复);涉及传输层,两端须同版本。
GPS 跳变清洗补速度兜底:早退分支放行的 4 处假位移(10-05 那段 2177 m 假行程没了)
- 早退支补速度兜底:真后邻被精度筛剔走后 span 虚高,坏点被无条件放行。
- 改为 off>600 且速度超上限才 continue,两判据必须同时成立;只动早退支,正常分支不改。
- 30 天 79,760 点试算多剔 4、少剔 0;10-05 的 2177 m 假行程消失,10-07 一趟 158.7 km 接回。
- A/B:10-05 358.7→356.6 km,10-07 960.4 km;test-segment 51→61,服务端 46 套全绿。
新增 08 智能遮阳与 09 智能健康:先做覆盖盘点,再定九个系统
- 补 08 智能遮阳与 09 智能健康两页(各 8 件设备);先做六大方向与七系统对照,发现「管住吃药慢病」整格空白。
- 定 9 个系统的原因:3 列满格要 %3==0、2 列要 %2==0,9 张正好 3×3。
- 智能窗帘从居住舒适移出(7→6 件);wide 卡断点改成 660–999px,只在 2 列生效。
- 合规红线写进正文与 FAQ:只记录提醒、不诊断、数据不共享;352 组溢出 0,按约定未 commit。
新增智慧养老社区大屏子站 /screen/:本地矢量地图,零依赖可内网演示
- 新增独立静态子站 /screen/:原生 HTML/CSS/ES Module + 本地 echarts,零构建零依赖。
- 地图用本地矢量 GeoJSON(延庆真实边界 5937 顶点),不加载在线瓦片、无 key,内网可演示。
- 1920×1080 固定舞台等比缩放;data/ 为固定种子演示快照,接真实数据只改 js/data-source.js。
- 入口只放页脚、14 页各一条;这是产物副本,开发根在另一仓库,复制时别丢返回链接与 .sb-back 样式。
双机同仓的覆盖事故:一台机器的整站上传把另一台的改动静默盖掉
- 事故:另一台 Windows 整站上传覆盖 comfort.html,讲解入口消失,js/css/audio 都还在、只是页面不再引用。
- 处置:合并对方页脚入口后重部;deploy.sh 加部署前哨,比对上次部署的线上指纹,不一致列文件名并停 6 秒。
- 前哨两坑:基准须是上次部署指纹;指纹取归一化内容(剥 ?v=、去 CR)。
- 两条线合并进 Gitee 后以 git 为准,合并后实跑又抓出三处硬伤;哈希只证明两边一样,不证明产物对。
居住舒适页上线「讲解模式」:静态页变成有人讲的动态 PPT
- 居住舒适页上线讲解模式:点「听讲解」进放映态,语音在讲、页面跟着滚、讲到哪亮到哪。
- 旁白逐段合成,时长按 PCM 帧数算后拼接编码,全程零漂移;32 段、6 分 24 秒、1254 字、2.25MB。
- 三种镜头动作 focus/spot/pick;字幕、上下段、可拖进度条、Esc/空格/方向键齐全。
- 语音失败 7 秒降级静音导览;check-tour 与 25 项边界自检线上 25/25;其余 13 页未铺。
云函数 6 把明文凭据下线改环境变量;小程序相册识图确认从未生效,转 App 端
- 6 处明文凭据从 config.json 收进环境变量(DeepSeek、百度、火山 LLM/ASR),去掉代码里的明文兜底。
- 最初只搜 sk- 前缀,漏掉火山 UUID 型 Key;config.json 的 envVariables 是声明式,部署会覆盖云端,先确认控制台已配。
- 小程序相册识图确认从未生效(extend.AI 不支持传图、模型纯文本),已下线改只读+引导下载 App。
- 云端新增 visionScan,直接吃 base64 供 App 一次扫几百张。
免疫程序改用 2026 年版(现行);确立「宁可显示不确定,也不显示错误政策时间」
- 查证现行是 2026 年版免疫程序而非 2021 版:百白破 4→5 剂、首针 2 月龄,白破只做 7–11 岁补种。
- 新增 13 岁女孩双价 HPV,乙脑全国统一免费;按旧版做会让 2 月龄跑空、6 岁打错剂型。
- 未收录省级细则一律按国家程序并标「国家程序」,每条带 confidence;价格只给区间+采集时间+可纠错。
- 北京水痘免费(2022 起)多源一致但无原文,标待确认。
疫苗记录与提醒按三层架构重做,34 个省级行政区闭环验证 217 项全通过
- 疫苗记录按三层重做:L0 标准字典(跨城认编码不认名字)、L1 31 省+港澳台区域包、L2 云函数事件流只追加。
- 每针记该疫苗全局第几针,避免换城市剂次错位;提醒由 L2 事实与 L1 目标的差值在本地算,门诊弱网可用。
- 每针算最早/推荐/最晚三个时间点;34 区域 × 8 生日 = 272 份计划,217 项全通过(按时接种不判超期 248 例)。
决策:暂不购买 Apple 开发者账号,iOS 维持开发期分发
- iOS 用免费个人团队签名,描述文件 7 天到期需重装,无分发证书与 TestFlight 权限。
- 结论:产品暂无收入,不购买 Apple 开发者账号,上架与 TestFlight 整体搁置。
- 出口合规声明、隐私清单、发布导出配置三项准备也先不做,有收入再补。
iOS 相册「既不授权也不弹框」的根因:权限库的编译宏没打开
- iOS 相册既不授权也不弹框:权限库的相册读写编译宏没在工程里打开,请求落到未知权限分支直接拒绝。
- 依赖安装钩子补两个宏并重跑安装;新增统一权限网关:查状态→说用途→弹框→被拒给去设置。
- 有限访问视为通过;接收预检从「全是图片」放宽为「图片+视频」,原来收视频压根不申请权限。
- 修掉保存路径里已删依赖的调用;静态分析 0 错、测试 78 项全过,真机安装成功。
被补全认证过的时段一律出卡 + 凌晨在家→早上出门切成行程(时间线补上两张卡)
- 新增 mergeFilledGaps:补全层 3 分钟口径认证的时段并进 gaps,三条判据须同时成立(crossGap、不与停留窗重叠、不与断口重叠)。
- tripDaySegments 在 carry 后按最终 stays 重跑:凌晨在家 1.62 km/62 点原被 isDrift 整段否决。
- 15 天对拍只 10-14 变:trips 0→1、orphans 230→3;真机时间线 5→7 条、顶栏 19.3 公里。
- v1.43.0 上线,commit 4b4c400 已推。
推进两项待办:冗余清理完成 + WS 服务代码就绪(部署待开通云托管)
- NoSQL/MySQL 冗余清理完成:init 不再播种 banners/categories/products,删三个死函数,加 cleanupNoSQL。
- 清空三个集合(3+8+12 文档),shop 云函数验证 MySQL 单一数据源正常。
- 云养宠 WS 代码就绪:补 verifyToken,房间接口返回 openid+wsUrl,onGameEnd 主动结算。
- 阻塞:云托管未开通,需控制台开通后配 WS_AUTH_SECRET、wss 域名与合法域名。
云环境迁移 lovely-pet 全部完成并提交 git(commit 1e1c154)
- 环境迁移与 MySQL 库归一提交 git,commit 1e1c154,30 文件 +511/−73。
- app.js 与 cloudbaserc.json 切环境 ID,13 个云函数绑 VPC、database 字段改 MySQL host。
- 修 pet-game.wxss 多余 } 引起的全局 WXSS 编译错误,新增迁移文档。
- 看板日记从 1 条补到 12 条,覆盖 5 月立项至今。
断口补全:端点锚回停留中心 + 被停留盖住的断口只切 1 段也补(轨迹接上了)
- 补全起点跑偏:11:18:26 点 77 秒位移 3.85 km,早退支没剔掉。
- 改法:普通断口端点紧邻停留时改用停留中心,四条护栏(跳变点、5 min 邻近、>500 m、物理跑不到)缺一不可。
- 卡片4→5 整条断口消失:被停留盖 68%,只切 1 段就被「≥2 段」判死,改判空后恢复。
- 15 天对拍只动 3 天 4 处;v1.43.0 上线 fills 1→2、inferredM→17655。
- 真机四端点全 0 m 贴合停留中心,顶栏 17.7 公里;test-gapfill 107 项全绿。
案例影片归位:从资讯列表页移到讲大屏的那篇文章详情页
- 资讯列表页一度同时挂企业宣传片与案例影片,列表页是索引,不该承载具体项目影片。
- 修正:列表页只留宣传片,案例影片移到讲大屏的那篇文章详情页,语境才对得上。
- 实现:文章数据新增可复用 video 字段(同案例页结构,多一个说明文字),详情页按视口选源。
- 顺带修观感:封面图与影片封面是同一张截图,有影片的文章不再渲染封面。规则:列表页放拉新内容,详情页放印证内容。
资讯页新增案例影片(与宣传片形成品牌→实证序列)
- 资讯页企业宣传片之后再挂 60 秒案例影片(徐汇托育大屏),带播放控件、按需加载。
- ≤768px 走移动端压缩版(约为桌面三分之一),与案例详情页规则一致。
- 两段同处一条深色带,形成「宣传片(品牌)→ 案例影片(实证)」序列。
修复文章页刷新后站点外壳丢失(预渲染改为复用站点入口)
- 现象:文章页从列表点进正常,直接访问或刷新则无站头导航、无页脚、样式全变。
- 根因:为爬虫生成的静态 HTML 是完全独立的裸页面,不加载站点样式与脚本、也没有挂载容器,刷新时服务器直接把它发给浏览器。
- 修法:静态页复用站点入口,只注入文章 SEO 信息,正文放进挂载容器作首屏内容,前端接管时清空重填。
- 效果:刷新后是完整站点页面,爬虫仍能直读全文与结构化数据。教训:给爬虫的页与给用户的页不能是两份。
七个系统详细页补「这一套具体装什么」设备清单
- 七个系统详细页新增「这一套具体装什么」设备清单,放在能力卡之后成第 02 节。
- 一件设备一张卡:设备名 + 必备/选配胶囊 + 装在哪 + 功能 3~4 条;件数灯 7 / 安防 8 / 厨房 8 / 家电 6 / 清洁 6 / 舒适 7 / 陪伴 7。
- 文案纪律:功能写工程口径不与能力卡重复,每条 ≤22 字、设备名 ≤6 字;报价只给量级,末句师傅上门看完出清单和报价。
- 版式:≥900px 两列,奇数时末张跨满整行且功能分 2 栏;新节插入后白底/浅底需重排避免相邻同色。
智能系统页精简:标题 + 视频 + 七张卡,接入 15 秒实拍介绍片
- 智能系统页精简:删掉卡片上方三段共约 225 字说明,标题直接跟七张卡,详述留详细页。
- 新增 .sy-video 16:9 视频位,成片 system-intro.mp4(1280×720、15.07s、3.2MB),点击才加载。
- 封面取第 8 秒帧:AI 角标会游走,8s 四角干净且画面是门厅非人脸。
- 两坑:HEAD 预检被 abort 留 ERR_ABORTED,改用 video error 事件;第 7 张宽卡被 grid-auto-rows:1fr 拉到 461px,改 auto。
全站换「冷白商务」配色,14 页上线
- 全站配色由暖橙黄换成「冷白商务」:冷灰底 #F4F7FB + 宝蓝 #1D4ED8 + 深墨 #0E1729,14 页上线。
- 283 处色值、116 处描边、约 240 处字重归一;主题色与内联 favicon 同步,次级文字补到 7:1。
- 踩坑:.subnav a 加 2px 描边使长辈模式 660px 顶栏折成 196px,scrollWidth 检测不到,靠 worktree 拉旧分支做全宽度 A/B 才定位。
- 验证:308 组断点矩阵 0 溢出、顶栏全 1 行、控制台零错误。
资讯页新增企业宣传片区块
- 资讯页页头下方、分类筛选之前加企业宣传片,进页即见。
- 区块起始色取页头渐变末端色,两段深色连成一体无接缝。
- 960px 居中 16:9 圆角卡,静音自动播放循环,窄屏自适应。
- 站点三条视频动线成型:首页背景片 / 资讯页宣传片 / 案例页案例影片。
案例影片上移至「项目背景」之后:让访客早一点看到
- 案例影片原在「解决方案」之后,访客滚很久才看到,等于白做。
- 移到「项目背景」之后:讲完客户处境紧接着给答案。影片位置从页面靠下提到约前 20%(全页 8547px,影片在 1706px)。
- 通用规则:面向客户的展示内容往前放,铺垫文字往后收。
徐汇托育大屏上线真实地图底图,并补上 60 秒案例影片
- 徐汇托育大屏底图换成真实地图,支持缩放与定位到机构,叠加行政区划边界。
- 案例页新增 60 秒案例影片,桌面与移动端分别适配(移动端压缩版约为桌面三分之一)。
- 配套发布第 38 篇案例软文,站点地图 70→71 条 URL;演示数据,交互与真实系统一致。
拆提交本轮的 6 个坑:旧 dump 静默退回已提交内容 / `-U0` 歧义匹配 / KSP 增量缓存炸了
- 拆 6 个 commit 踩 6 个坑,共同点是结果「看着对、其实错」。
- 最阴:dump 早于引擎修正,A 线把 D 刚加的 excluded 字段整段删掉;用不变量 grep 抓出,修法是重 dump 未提交线。
- -U0 歧义匹配把改一行吐成 64 行新增,下标 0 必须归给改之前那条线。
- KSP 增量缓存报 already registered,清缓存均无效,最终 -Pksp.incremental=false 绕过,后续 5 条线一次通过。
轨迹页下拉刷新(同步 → 重推 → 照片自愈 → 重读)+ 照片灰格实锤:源手机没传图本体
- 轨迹页加下拉刷新:commit 5d920bb(12 文件 +384/−2),四步同步→重推→照片自愈→重读,顺序不可换。
- 照片灰格实锤:25 张全来自另一台小米机,源机没传图本体,云端 remoteUrl 为空、本机 uri 故意留空。
- 本机已把 46 张旧判据下的照片排队上云;需小米那台也下拉刷新一次才能补齐。
- 链路已验证:上传会刷新 updated_at,另一端增量游标可拉到并补 remoteUrl,灰格转真图。
清洗口径统一:三条「看着像 bug」的建议被线上数据全推翻,真缺口在端上离线切段
- 清洗口径统一:commit ec19b42(16 文件 +1134/−5)。
- 上轮三条建议用线上数据验完全推翻:端上加精度上限会废掉 traceFill,剔 acc≤50 无病可治,12:42 断口指向室内不补。
- 真缺口是端上离线切段缺按精度剔:网络定位点把行程切碎,真机实测行程段 84→46、里程 1521.2→1492.6km。
- 改动:新增 ACC_MAX_M=50 与 dropBadFix,gapfill 复用 dropSpikes,test-gapfill 91 项通过。
回放「第一遍不走虚线、第二遍才走」:不是渲染坏了,是「本地版没补全段」把正在播的那一遍打断了
- 全天回放第一遍不走虚线、第二遍才走:commit 41cec0e(1 文件 +122/−11)。
- 根因:本地版 fills 恒为空,页面先取本地再等云端,两次换 day 触发地图清空重绘,正在播的那遍被打断。
- 真机抓帧三次均复现不出(数据稳定时撞不到窗口),改靠逐行读链路定位。
- 修法:进入页改云端优先、失败回落本地;点播放时等云端数据齐再开播,按钮分播放/重播/等待三态。
- 前提是补全段与实线同一套渲染参数,否则虚线 0 像素渲染。
两条增量游标统一改「服务端写入时刻」:旧口径下轨迹点静默漏 856 行、照片漏 309 张
- 两条增量游标统一改「服务端写入时刻」:commit 51524f2(照片)、656f882(轨迹点)。
- 旧判据拿手机钟比服务端钟,永久漏且不报错;线上实测轨迹点漏 856 行、照片 309 张命中 0 条。
- 改为比对 updated_at 且用 >=(同毫秒用 > 会永久跳过);advanceCursor 从取最大改取最小,并保证每轮前进 1ms。
- 存量 79,321 行需唯一 updated_at 且最大值小于未来 serverTime,否则 16 页分页会静默丢行。
入库 6 个 commit:四轮积压一次清空(照片口径 / 照片删除 / 两条增量游标 / 回放虚线 / 清洗口径 / 下拉刷新)
- 四轮改动按「一个 commit 一条线」拆 6 个 commit,合计 +3068/−171,只提交未推送。
- 六线:照片口径 d11772b、照片删除 51524f2、轨迹点游标 656f882、回放虚线 41cec0e、清洗 ec19b42、下拉刷新 5d920bb。
- 硬依赖 d11772b 最先,51524f2 早于 656f882。
- 逐线闸门全绿,服务端 45 套回归通过,49 个文件与开工前逐字节一致。
- 遗留:未 push;家人守护、shortstay 未接线等历史项未动。
决策:情感陪伴页把「它顶不了儿女」写在明面上
- 情感陪伴页用一整节写明边界:它顶不了儿女、不做心理诊断;老电视需配摄像头盒子,点播要宽带和会员,方言口音可能听不懂。
- 另节写「分寸」:不推销、不问银行卡、不引导转账,能免打扰、说停就停。
- 理由:老人对机器乱动乱说话最敏感,边界说清才敢长期用;写成「能替代儿女」反而卖不出去。
- 同思路用于居住舒适(不治病、不换锅炉)与安防(卧室卫生间只装雷达不装摄像头)。
踩坑:配图容器用了 16:10,把图里的「AI 生成」角标裁掉了一半
- AI 生图右下角「AI 生成」角标是合规标识且烧在图内,配图容器用 16:10 裁切把角标裁掉一半,只剩「AI 生」。
- 改回与源图一致的 16:9 后立即完整。
- 约定:装这类图的容器一律 16:9,不为排版改比例。
- 同页多图需提前分配场景:总览页页头与深夜卡原本都是「居中走廊 + 人」,改成玄关近景与卧室床边才分开。
07 情感陪伴模块上线:聊天 / 节目点播 / 电视一键视频通话
- 新增第 7 个模块「情感陪伴」:聊天、语音点播电视与音频、电视一键与家人视频通话。
- 页面四节:三件事六张卡、它凭什么能陪、管与不管、装前定三件事(常联系人排成大按钮并定顺序)。
- 技术侧:第 7 张卡在 3 列(7=3+3+1)与 2 列(7=2+2+2+1)都靠「最后一张跨 2 列」补满,复用已有规则,零新增样式。
给七个系统页配 16 张实景图,图带总重还不到 0.5MB
- 给智能系统总览页配 4 张、六个模块页各 2 张实景图,统一 1280×720 暖调、不给老人正脸、画面无文字。
- 全部懒加载,16 张共 418KB(平均 26KB),全站图片合计 760KB。
- 踩坑:六个详细页「能力清单」容器类名不统一,脚本只认一种,把图插进网格变成一格(中等屏仅 299px 宽),回头补一轮。
- 另给改造方向清单页表格行挂对应模块页链接。
06 居住舒适模块上线:地暖/空调/新风/加湿器 + 大模型自动判断
- 新增第 6 个模块「居住舒适」:地暖 / 空调 / 新风 / 加湿器自动控制,背后由大模型判断。
- 页面四节:四样东西、判断依据(看清屋里屋外 + 人和时间 + 有边界会解释)、管与不管、装前三件事 + FAQ。
- 明确边界:不治病、不换锅炉、老空调红外只发不收、新风替代不了开窗、加湿器要人加水。
- 核心取舍不是温度多准,而是老人不用再为几度操心;重点写「只在硬边界内动 + 一句大白话讲清为什么」。
2026-10-13
下载区 Windows 卡片的版本号没跟上实际发布版本
- 下载区 Windows 卡片版本号停在很早的版本,实际线上已有更新安装包。
- 原因:卡片版本号与下载链接硬编码,与版本清单无联动,上次发版只改清单没改文案。
- 处理:版本号与链接对齐实际发布版本并核对安装包体积;删掉与实际不符的「原生界面」描述,改为跨平台框架实现。
- 重新构建部署,首页引用产物哈希已刷新。教训:发版清单把「页面卡片」单列一项。
本地版本清单落后于线上:按本地文件部署会把已发布版本整体回退
- 部署前发现本地版本清单比线上旧:线上桌面端版本更高,最近几次直接在服务器改、未回流仓库。
- 危害:按本地文件部署会把已发布版本整体回退,下载页版本号往回跳、安装包与实际不符。
- 处理:先从线上拉回对齐,并核对安装包真实存在(体积);把「部署前先拉线上比对」写进发布前自检。
- 教训:线上可改的配置一定会与仓库分叉,要么即时回流,要么流程强制比对。
开发机自用:启动台里的图标一直指向半年前的旧构建
- 启动台图标指向半年前旧构建(带调试残留),最新构建一直躺在构建目录。
- 原因:同一应用标识在注册表登记多份(调试目录、中间产物、备份副本),互相抢链接归属与图标。
- 处理:旧副本移到项目外备份,用保留扩展属性与签名的拷贝方式覆盖,清理多余登记只留「应用程序」那份,刷新启动台。
- 做成脚本:一键同步最新构建并打印版本号,已实跑可重复执行。
iOS 首次真机构建:依赖索引被墙 + 一个失效的镜像劫持了依赖克隆
- iOS 首次真机构建卡两层,均非代码问题。
- 依赖索引 CDN 被墙:改配置文件地址无效(代码有短路逻辑),必须改代码常量。
- 更隐蔽:一条全局地址改写规则把某依赖劫持到 git 协议握手失败的镜像,首页 HTTP 仍返 200;判断方法是绕开规则直连一次。
- 修好后依赖安装 1 分 18 秒完成,35 个包全部就位。
- 环境结论:只能用项目自带工具链装机;安装会先卸载旧版、清空本地数据。
两条并行的版本线合并为 1.5.0 —— 顺手拦住一次错误码撞号
- 两条并行版本线(微信小程序传输 / 应用内更新与版本详情页)合并为 1.5.0。
- 冲突两处:版本号取远程(远程更高且已发布);错误码撞号——本地号段与远程「页面不存在」同数字,服务端只按数字入库会混统计,整段挪到空闲号段。
- 四处自动合并(本地服务、主入口、传输引擎、传输任务)双方改动均保留。
- 静态分析 0 错误,客户端测试 33 项全通过。教训:加错误码前先查小程序侧已占码表。
卡片照片可删除:端上是「打标记不是删行」、云端是「墓碑 `hidden`」
- 卡片照片可删除,且连云端一起删,否则别的手机与网页仍显示。commit 51524f2(17 文件 +1012/−56)。
- 删=打标记不删行:端 excluded、云 hidden,相册原图不动。
- 端迁移 9→10;显示与上行查询加 excluded=0,去重查询不加,否则删掉的会复活。
- 云端 delete 接口按用户与拍摄时刻定位,删文件、清 image_key、重算 photo_count。
- 判据须 uploaded=1 OR remoteUrl 非空,否则别机拍的照片删了云端仍留。
照片上传范围改「按卡片、每卡 ≤5」:跟「在哪儿拍」无关,只看「挂在哪儿」
- 上传范围改「每卡最多 5 张」,与在哪儿拍无关:commit d11772b(12 文件 +292/−92)。
- 旧判据含「是否 App 内按快门」,系统相机或相册扫入的照片永不上云,换机看网页只剩灰格。
- 判据收拢到 shouldUploadImage:挂了停留就传,无停留只传主动快门那张;配额改 MAX_UPLOADS_PER_CARD=5。
- 两处入库须逐张判逐张插,否则同批 8 张互相看不见、全部放行。
- 单测 23 类 334 例 0 失败,真机 remoteUrl 非空 0→17 条。
产出 15 秒短视频脚本,拆成 3×5 秒交 AI 生成
- 15 秒短视频脚本交即梦生成,主题是老人不是不喜欢智能家居,只是习惯了节俭和将就。
- 因单次只能出 5/10 秒,拆成 3 段 ×5 秒,每段可独立重抽,成本最低。
- 画面只拍「手和光」,不给老人正脸;三镜靠同一盏灯、同一走廊、同一件深色棉布上衣串联。
- 口播按 4.2 字/秒卡字数,50 字留 3 秒呼吸;「窗帘自动打开」挪到清晨。
踩坑:凭肉眼判断了两个不存在的问题,探针一量全是误判
- 改版前用探针实测,推翻两个肉眼结论:图带 6 张卡高与图高一致,只是说明行数不同;入口按钮 1440/1280 落差 0px。
- 真正的问题:18 张同构卡连排 2538px 无分组、色标随机、首屏仅 694px 撑不满、悬浮胶囊压内容。
- 结论:长页面先量后改,肉眼易把「行数不同」看成「高度不同」。
视觉质感精修:三层阴影、遮罩渐隐、首屏独占一屏
- 只做视觉精修、功能不改:阴影从单层大模糊改三层(接触 + 中距 + 远距)。
- 卡片色条渐隐改遮罩渐变(渐变到透明会朝黑走,浅底留脏带);图标改双色渐变底 + 白内圈,悬停位移 3→5px。
- 首屏宽屏独占一屏:最小高度 + 纵向居中须同时上,只给高度内容仍贴顶。
- 顺手修几何:9 卡在 2 列断点空半格;悬浮拨号条只移出 99px,宽屏仍露 15px。
全站配色换成「暖橙黄 · 小清新」,40 多个硬编码色值一并替换
- 全站配色由陶土红换成「暖橙黄·小清新」,40 多个硬编码色值(含半透明)一并替换。
- 各页浏览器主题色与内联站点图标同步换色。
- 实测对比度:正文 14:1、次要文字 6.6:1、链接 4.8:1,按钮白字 3.07:1(大字号达 AA)。
- 经验:颜色全走变量;换主题最易漏「浏览器主题色 + 页头内联图标」两处。
把模块详述从总览页拆出,新建模块页共用样式
- 模块内容从单个长页拆成「总览 + 模块详细页」:灯光 / 安防 / 厨房 / 家电 / 清洁,后加居住舒适、情感陪伴。
- 新建模块页共用样式(页头配图、FAQ 折叠、对照两栏、分步链、口令药丸),后两个模块页零新增样式。
- 页面写明两条硬话:卧室卫生间只用毫米波雷达与门磁不装摄像头;AI 与自动化只当帮手不是保险。
导航增设「智能系统」入口,并把它从聚合页改成总览页
- 导航 5 项加到 6 项(新增「智能系统」)。原 5 项只剩 68px 余量,新项需 118px,硬塞必折行。
- 配平:容器 1140→1200px 且顶栏与正文同宽,导航内边距 15→8px、字号 21→19px,实测余量 110px。
- 长辈模式按钮改为注入导航胶囊最后一格(顶栏右侧只剩 86px,按钮需 135px)。
- 「智能系统」页从聚合页改总览页:页头→说明→模块总览→底座→三个时刻→三步走→FAQ→行动区。
修网关拉流接口的凭据泄露(source 字段带 admin 密码)
- 拉流接口 /cameras/:id/stream/start 的 source 字段原样回传带 admin 密码的 rtsp 地址,任何登录用户可调。
- 网关新增 redactSource():清空 UserInfo,解析失败返回空串;重建容器后两份响应搜密码与 user@host 均 0 命中。
- /api/health 恢复(database.ready=true, degraded=false)。
- 教训:内部字段顺手回给前端不会报错,凡响应出现 rtsp:// 就要问一句「本来有密码吗」。
Android TV v0.2.0:从「装不上」到「能看监控」
- tv-client 重写:API 基址运行时化,地址容错解析 + /24 扫描(并发 64、350ms 超时)。
- 取流不猜编码、失败再降级:主码流 HLS、子码流 FLV,网络类退避重连 1/2/4/8s。
- 实时宫格、单画面、事件列表、设置齐活;语音本地三级匹配,PCM 走 /api/asr。
- 单测 49 条全通过(地址 18 / 播放计划 11 / 语音 16 / 发现 4)。
- v0.2.0:debug 15.4MB 已签名、release 11.5MB 未签名,下载页已同步 SHA-256。
视频异地备份脚本:状态码 200 不代表文件存在
- 视频已移出 git,素材只剩本机与线上托管两处,遂做异地备份 / 灾备恢复脚本。
- 踩坑:托管平台对不存在路径也回 200(回退首页),只看状态码会把丢文件判成下载成功。
- 判据改为同时校验 content-type 与字节数;另带只体检、按关键词单拉两种模式。
修复文章预渲染脚本在 Windows 下构建中断
- 修文章预渲染脚本在 Windows 下构建中断:动态导入路径改为按文件 URL 处理。
- 站点在 Windows 开发机上可完整构建并发布。
- 结果:换机器即可改站上线,不再绑死单一开发机。
重写 README,确立站点规模基线
- 重写工程 README,清掉残留的脚手架模板文字。
- 确立规模基线:38 页 / 12 云函数 / 37 文章 / 13 案例 / 32 组 SEO 配置 / 地图 70 条 URL,改代码需同步维护。
- 写入部署红线(不可加清库参数)、素材策略、内容流水线与常见坑。
新增徐汇托育监管大屏案例(含全屏在线体验页)
- 新增案例「徐汇区托育机构远程监管大屏」:全区机构分布、入托幼儿、教职工、证照到期与整改闭环一屏统览。
- 大屏为独立静态应用(自带图表库),iframe 嵌入案例页,另做全屏在线体验页。
- 案例 12→13 个,站点地图 69→70 条 URL;演示用演示数据。
SSL 证书自动续期上线(云函数每日巡检)
- 云函数每日 09:00 巡检线上真实证书,剩余 30 天内自动申请并原地换绑域名,全程零人工。
- 只读巡检可随时手动跑一次做体检。
- 另配每周巡检兜底,异常才人工介入。
修复图表库因公共 CDN 不可达而加载失败的问题
- 管理后台趋势图不显示、new Chart() 报错:图表库走公共 CDN,该 CDN 国内完全不可达。
- 改为站点内自托管 + 本地路径引用,浏览器验证控件正常绘制、页面无报错。
- 教训:判断页面是否真用到某库不能只看返回 200,要查 window.X 是否存在。
图片全量转 WebP,静态素材体积压降 72.7%
- 仓库体积大头是图片:占 86%,PNG 均值 566KB、17 个超 1MB。
- 250 张图全量转 WebP,静态素材 66.7MB → 18.5MB(-72.7%)。
- 质量分类型定:图形 q88、透明 q90 且 alpha 无损、照片 q85;真实浏览器逐页复核 0 死链,透明通道 100% 一致。
- 分享图与站点图标保留原格式,社交平台与浏览器兼容性不齐。
视频与历史垃圾文件移出版本管理,并重写仓库历史
- 视频素材累积 243MB(10 个 mp4),移出版本管理但文件保留在磁盘,页面与构建仍照常引用。
- 从跟踪移除 + .gitignore 覆盖,再重写历史把 21 个大文件从全部提交抹除。
- 结果 .git 由 430MB → 112MB,78 条提交完整保留,push 不再触发大文件告警。
仓库迁入 Gitee(首个远程备份)
- 站点此前只有本地 git、无任何远程备份,属单点风险。
- 建 Gitee 私有仓库作异地备份,全部提交推送成功。
- 顺带补 .gitignore,构建临时文件、演示稿工具缓存、系统文件不再入库。
录制器静默死 24 小时 + ZLM 代理「补建后不等就绪」读帧死循环
- AI 事件分析零记录:录制器 10-12 21:41 静默死亡、不在 launchd 托管,日志无 traceback。
- 拉起后查出读帧死循环:addStreamProxy 异步,建完不等就绪就 open,读不到就重连、代理被回收,再补建又不等。
- 新增 _wait_zlm_ready(有 tracks 且码率>0)超时 12s,验证通过。
- 消费者无服务脚本,新增 understand-service.sh;匹配只认绝对路径会双份跑。
- 提交 4ecbfdd + c3adab7。
产品化成熟度盘点:技术已完成,产品化后半程空白;建议先 B 后 C
- 盘点 15 个维度:技术护城河已成,装/用/修/卖/合规基本空白,缺口多是差最后一公里。
- 三个空壳:有权限矩阵但全仓无 RequireRole 中间件、前端无成员管理;audit_logs 表完整但零写入;告警引擎完整但出口只有本地 TTS。
- 建议先 B 后 C:先服务已有付费客户,不做通用 App 抢 C 端;交付形态(盒子/自备/云托管)必须先拍板;暂不做人脸、云存储、通用 App 获客。
- 产物:15 维度评分 + 10 组缺口 + 三期路线图的盘点文档。
2026-10-12
电脑端接收小程序文件:落盘位置、临时文件残留与「全程无提示」
- 电脑端接收文件修三处:落盘改到下载文件夹根,不再多套产品子目录;分片暂存移到应用支持目录,合并后连空暂存根一并清理。
- 局域网直传不走信令,原先全程无提示;主界面加接收提示:发送中、已接收 N 个文件并给「打开文件夹」、失败显示原因。
- 顺带修进度估算:分片变小后仍按旧假设反推会提前跑满,改为采纳发送方清单里的分片数。
小程序错误上报链路打通:写接口加配额、读接口加鉴权
- 小程序错误上报链路打通:写接口加专用限流 + 条目级配额,实测 30 次请求 × 100 条即可冲空环形缓冲。
- 读接口此前完全无鉴权,一次请求就能爬走完整调用栈、设备标识与任务号,本轮补上。
- 超配额返回成功但标记已丢弃,避免客户端整批回队重试放大压力;健康检查暴露已丢弃条数。
- 客户端补齐两个错误码,与小程序侧同码同义,两侧文件头互标「必须同步」。
小程序工程纳入主仓库 —— 此前它完全不在任何版本库里
- 小程序源码此前只存在于开发机、不在任何版本库,几轮修复无历史可回溯。
- 整体迁入主仓库,拷贝后逐文件校验与源目录逐字节一致。
- 补忽略清单:开发者工具私有配置、约 5MB 端到端测试产物。
- 迁移后自检 110 项、冒烟 14 项全过,打包不受影响仍约 70KB;用开发者工具打开须选仓库子目录而非根。
踩坑:长辈模式把顶栏挤折行,rem 尺寸必须补 px 封顶
- 长辈模式(根字号 27px)上线后顶栏挤成两行,导航又被后加的固定高度规则撑到 84px。
- 小屏加放大字号下,带不换行属性的按钮顶破容器,320px 宽横向溢出 149px。
- 结论一:rem 尺寸在放大模式里都要补 min(…, Npx) 上限,否则整体按比例缩放先撑不住。
- 结论二:写完新规则要回查有没有旧规则被覆盖,固定高度那条就是后加覆盖了前面的。
新增「智能厨房」专题页:从三件套到 6 步联动链路
- 新增「智能厨房」专题页,拆 8 个模块:三个要命时刻、核心三件套、6 步联动链路、6 张补齐卡、早晚场景、改造前后 5 行对比、6 条折叠疑问与免责。
- 6 步链路:报警器响 → 断燃气阀 → 油烟机开到最大 → 音箱喊话 → 推给子女 → 无人应答再升级。
- 页面写明两句不夸大:断网时屋里照样响但推送要等网络恢复;设备是帮手不是保险,燃气管本体须持证施工。
新增「改造方向清单」页:6 大方向 35 项,标注花钱量级与优先级
- 新增「改造方向清单」页:6 大方向 35 项,每项写清怎么实现、花钱量级(¥/¥¥/¥¥¥)、优先级。
- 桌面为表格,≤719px 摊成卡片,靠单元格 data-l 属性与伪元素打标签,不写两套 DOM。
- 结尾给分三步走(防摔+叫人 → 看得见+认得出 → 省力+不孤单)及价格区间、强电施工免责说明。
首页能力卡补齐到 18 张并分成两组,新增 AI 生活管家
- 首页能力卡 16→18 张,首次分两组:先装的实体设备 9 张、传感器与 AI 守护 9 张。
- 每组以竖色条 + 大序号 + 组标题 + 一句说明开头。
- 新增智能门锁(人脸/语音开锁/指纹/临时密码/子女看进出)、家电语音控制、电动窗帘、可视门铃(针对耳背)。
- 新增「AI 生活管家」板块:左侧今日自动记录时间线,右侧每日起居小结、作息变化提醒、越住越顺手。
长辈模式上线:字号放大到 27px + 读给我听
- 全站加长辈模式:根字号 21→27px,正文与线条加深(去掉阴影改粗边框),卡片一律单列。
- 加「读给我听」:浏览器内置语音合成,按句切约 90 字一段,不支持的浏览器自动隐藏按钮。
- 用 html data-mode 加本地存储记住选择,换页刷新都保持;切换按钮与提示条脚本注入,六页共用一份 DOM。
- 页头内嵌脚本先恢复模式属性,避免刷新时闪一下普通版。
车库纳入录制 + AI 事件分析页自动更新 + 事件详情对话框
- 车库摄像头纳入录制(--cams 补 21,共 5 路);只加参数无效,还要在 devices.json 填 rtsp 地址,空地址会被直接跳过。
- AI 事件分析页自动更新:时间轴 30 秒轮询 /api/events(¥0),先 pageSize=1 探测有新事件再拉全量。
- 简报只由按钮触发,避免每 30 秒重算一次、约 ¥0.02/次且界面无痕迹。
- 新增事件详情对话框:左录像右文字,支持跨设备翻页、0.25~4x 倍速、进度拖动,点事件不再跳回放页。
2026-10-11
服务端镜像构建上下文缺忽略清单,环境变量文件与备份目录被打进镜像
- 服务端镜像构建缺忽略清单(该文件从未入库),环境变量文件(含签名密钥与后台口令)与备份目录被打进镜像层。
- 危害等同凭据泄露,换变量值后旧镜像层仍留旧值。
- 补上忽略清单,环境变量、备份、临时文件一律不进构建上下文。
- 中转接口同期加独立限流与单文件/单会话/文件数/有效期上限,落盘名由服务端生成防路径穿越。
- 此后交付前增加构建上下文内容检查。
发布 1.4.0:微信小程序「轻风快传」上线,微信 ⇄ 电脑双向传文件
- 微信小程序「轻风快传」1.4.0 上线:微信 ⇄ 电脑双向传文件,扫码即用,不用装 App 和数据线。
- 同一 WiFi 走局域网直连、不经服务器;跨网自动回退服务器中转,凭取件码取件。
- 上行分片上传,电脑端同名文件自动加序号不覆盖;下行可选中文件共享给手机,末片附校验值、收完即比对。
- 受小程序平台约束(须备案加密域名、连接创建次数上限、单次写入上限),全程复用一条长连接、分片调小。
⚠️ 途中停顿摘除(transitstop)判据②过摘:线上试算会摘掉「在家」和一处「施工」——部署前必须先收紧
- transitstop 判据②「两头都在跑且地址无目的地词就摘」过摘真实停留,部署前必须收紧。
- 线上 14 条停留试算:会摘掉在家的 122 分(#2173)与施工的 28 分(#2206),另有一条疑似重复可能与对。
- 根因是 DEST_RE 漏词:真实地址常无「小区/别墅」,店名也没写「店」。
- 两方向待拍板:扩 DEST_RE 危险(号/楼几乎人人有),更宜收紧判据②并加时长或减速带证据;判据①本次零误伤可保留。
- 教训:一票否决的规则上线前必须拿线上全量数据逐条试算。
入库 739de38:全天轨迹回放「进入即全显」+ 服务端途中停顿/地点绑定/短停留三模块(App 1.57.0(102) / server 1.39.1)
- 提交 739de38,40 文件 +2923/-220;App 1.57.0(102)、server 1.39.1。
- 回放改进入即全显;修「补全段不渲染」:逐帧生长折线设过透明度会 0 像素渲染(17551 vs 6549px)。
- 服务端新增途中停顿摘除、地点绑定、短停留成卡;短停留模块未接线,幼儿园类拆分未生效。
- 修两处回归:裸「桥」误判街道名;test-stayrename 缺 updated_at 致 48 小时后假失败。
- 单测 266 条 0 失败,39 脚本全绿。
2026-10-10
M6 事件阅读与归纳上线(Web + mac 端),补上 mac 网关鉴权层
- M6 事件阅读与归纳上线 Web:按天按设备出四段简报、时间轴带缩略图,检索三维解析 + IDF 加权。
- 报告按事件 id 集合 SHA1 缓存,命中 0.178s vs 生成 9~17s;mac 端补上缺失的网关鉴权。
- 三个静默失败:摘要须带逐词命中数;思维链与正文共用 max_tokens,2048 致正文恒空需 16384;mac 主线程读 Keychain 冻结 UI。
- 验收 search 23/23、report 12 组、缩略图 51/51、报错 0;六笔提交已推 Gitee。
AI 两级推理 M4:成本看板 + 灵敏度在线可调
- M4 成本看板上线:网关新增 /api/ai/stats 读文件账本、/api/ai/gating 三档(保守/均衡/灵敏),前端新增 AiPage.vue 与顶栏侧栏入口。
- 机器永不回写 gating.yaml,另立覆盖层,避免 YAML 往返丢掉注释与实测依据;切档后原文件 mtime 未变。
- 录制器按 mtime_ns+size 指纹每秒比对,变更后 reload 约 1 秒生效、不重启服务,且不动门禁状态。
- Go 单测 12/12、Python 自检 20/20。
构建排障两例:一行「25.0.2」和它掩盖的错误;以及构建成功≠产物正确
- flutter build apk 1 秒失败只输出「25.0.2」:Flutter 优先用 Studio 自带 JDK 25,Gradle 8.14 不认;改 --jdk-dir 到 17.0.7。
- permission_handler_android 自带 AGP 9.0.1、硬编码 compileSdk 37,与 Gradle 8.14/36 代差;已摘掉。
- 构建成功不等于产物正确:图标脚本按自身目录拼路径,5 张图标写错位置,只有 API 24/25 真机暴露;签名缺配置时静默回退 debug。
移动端 Android 首版落地:现场打卡(签到 / 收工双时点)+ 施工拍照 + 离线优先同步
- Android 首版可装可用:签到 → 施工 → 拍照 → 收工,自动算时长。
- 离线优先:手机时间为权威,服务端另存字段核对;每动作带 client_uuid 只落一条;先落盘再提示成功。
- 队列由本地未同步记录反推,负数 id 区分;开工→收工依赖持久化的 id 映射。
- 失败三分类:5xx/超时停下等、401 不碰队列、其余 4xx 进失败箱不删。
- release apk 54.9MB、签名 CN=Yueju Intelligent 非 debug;队列 14 项、后端 51 项断言全绿。
本批入库:App 1.52.1(96) / server 1.38.0(线上服务端与本地已逐字对齐)
- 入库 10-09 全天到 10-10 凌晨,共 64 个文件(含 8 份报告与截图)。
- App 1.52.1(96):轨迹回放、空白天不编卡、卡头统一、照片方向修复、时长到分、AI 对话落盘。
- server 1.38.0:同一次到访判据补上轨迹点。
- 发布前逐文件比校验值,服务端与网页运行时文件全部与线上一致;单测 246 条 0 失败、36 脚本全绿、两端一致。
- 线上版本 1.38.0,真调当天停留 9 条、目标停留合并为 20:12 → 次日 00:00;5 个落后文件已对齐。
商场卡后面那张「1 张照片」:阈值量的是停车点,不是他逛到哪儿
- 商场卡后夹一张照片:判据按距停留中心 max(半径,150)+50 米,该卡半径 80 米故阈值 200 米,第 6 张在 214.5 米判飞,只差 14.5 米。
- 加第二遍判据:时间仍须在窗内,且与已归入该窗的照片相距不超过 200 米;参照必须是第一遍定稿,否则会连锁串出几公里。
- 第二遍进来的照片按拍摄时间重排;网页端归属只有时间判据,本轮只修 App。
- 验证商场卡照片 1/6 → 6/6 全部挂上,单测 246 条 0 失败(新增 5 条)。
同一趟「在家」被切成两张卡:判据写好了,调用它的那一行没传参数
- 「在家」被切成两张卡:判据只看「30 分钟内回来」,补上「空档里轨迹点全在原位附近即同一次到访」,61 分钟空档 12 颗点都在中心 3 米内。
- 判据早已写好且与线上逐字相同,但调用它的那一行没传轨迹点,线上永远走不到新逻辑;报「已上线」必须逐文件比校验值。
- 全日期开关对比 8 天只 2 天变,其余 6 天逐字未动;线上该停留合并为 20:12 → 次日 00:00,停留 10→9。
- 服务端 36 个脚本全绿(含停留合并断言 113 项)。
2026-10-09
AI 两级推理 M0~M3:从「落库假成功」到「一句话找回录像」
- M0~M3 均在真实摄像头上跑通。
- M0 修静默降级:Ping 失败即置 db=nil,事件接口回 200 但 id=0、events 恒 0,坏了两天;改为后台重连 + health,降级回 503。
- M1 契约走文件 spool,判据用运动帧跨度不用含预录缓冲的总时长,被挡也记 audit。
- M2 走视觉模型,单次 ¥0.003~0.0034,50 事件/天约 ¥4.7/月。
- M3 检索加意图解析:原 ILIKE 整句中文召回恒 0;另修时间戳、clipUrl、中文路径读图。
AI 助手对话落盘:「它记着你几个月去了哪,却记不住你昨天问过它什么」
- AI 助手对话落盘:新增 chat_messages 表(v7→v8 纯新增),界面类型直接用数据库行,写库只留一个入口。
- 拍照消息记按下快门时刻;上行上下文只取最近 20 条并剔除本地提示,避免模型学着道歉语气。
- 新增历史页按天列(今天/昨天/日期 + 时间范围 + 条数),点开看当天只读对话。
- 坑:滚到底不等于最后一条,对齐顶边会截掉长回复尾部,改为给足够大的下移量。
- 验证杀进程重启对话仍在、库里时间正确,单测 241 条 0 失败(新增 11 条)。
卡片持续时间只到分钟(App 1.51.3(94),顺手把两份时长格式化收成一份)
- 卡片时长只到分:删 fmtLiveSpan,进行中与收口同走 fmtSpan;心跳 1s 改 60s,且对齐「本段时长的整分」而非墙上整分。
- 网页删掉 dur() 与 liveDur(),六处调用统一 fmtSpanMs;定时器改自递归 setTimeout,避免定长间隔累积漂移。
- 验证真机无「秒」命中 0,72 秒后 5 小时 55 分 → 57 分;线上 11 张卡只到分;单测 230 条 0 失败、36/36、两端一致。
- App 1.51.3(94) 已装小米,华为未装,未提交。
老照片躺倒修复:错的是 EXIF 标签不是画面 + 顺带查出相机方向换算 90/270 反了(App 1.51.2(93))
- 老照片躺倒:10:02 卡 3 张画面正确,是 EXIF Orientation=6 写错;同批 10-08 两张竖拍标签本就对,须逐张目视。
- 服务器 jpegtran -rotate 270 无损转;手机只改 TIFF 头 0x0112 字节 6→1,长度不变故 _id 不变。
- 顺带查出相机握姿 90/270 写反(横拍倒 180°),改用 snapToSurfaceRotation 并补 7 条边界单测。
- 单测 230 条 0 失败、缩略图正立、36/36;App 1.51.2(93)。
卡片头统一「序号 → 图标 → 时间」+ 序号圆里的数字按「墨迹」居中(App 1.51.1(92))
- 卡片头统一「序号 → 图标 → 时间」:SeqBadge 与 CardHead 各一处、五类卡片共用;序号取当天时间线第几条。
- 网页序号发灰变大是 CSS 优先级(
.tl .t span盖住.no);两端校验抓不到,只有计算样式能发现。 - App 数字偏下是字体度量地板,调行高/padding 无效,改按墨迹居中(getTextBounds)。
- 单测 223 条 0 失败、36/36、5 圆偏移 0.00~0.17dp;App 1.51.1(92) 已装小米。
空白天不再编卡片:「某天没打开 App」就说当天没有记录
- 十二天无轨迹却每天顶一张公园卡:兜底判据只有下界,被一条 318 小时未闭合停留(#228)命中。
- merge.carryOverNight 加「当天无停留且无轨迹点则返回」守卫;App 与网页空态改「当天没有记录」。
- 逐日 diff 只动那 12 天;线上空白天停 1→0,有记录 4 天 Δ=0;09-21 342.9 公里未误伤。
- 单测 223 条 0 失败、36 脚本全绿;上线 App 1.51.0(90) 与 merge.js。
- 线上 5 个文件落后 HEAD,其余 4 个待定。
全天轨迹回放:沿线移动的光标 + 视野框全 + 时间流动气泡 + 严格串行
- App 1.51.0(89) 回放四改:沿线移动光标、视野框全(边距 7/7/9/13%)、气泡加时间流动、气泡与轨迹严格串行(2580ms 同余,总时长 26s→40s)。
- 修三个 bug:未闭合停留 exitAt=0 哨兵渲染成 08:00;未 layout 时 bounds padding 失效;全天被重切成一段致 3.9km/h 误判走路,按停留窗再切后还原 31.8/37.5km/h。
- 单测 223 条 0 失败、两端一致;小米已装,华为 USB 掉线未装;服务端判据未收敛,未提交。
上门施工也算工时:「不在电脑前」不等于没干活
- 工时加第二路来源:标成施工/勘察/上门/售后/维修/安装的停留,读时合成工时(不写库),改活动名即时生效,与键鼠那路取并集。
- 活动名限长 8 字,防 AI 写整句话把停留凭空变成工时;8 字按线上现存最长 7 字定。
- 进行中施工算到此刻,收口定时器每小时兜底,最多差一小时。
- 文案改「日均按有工作的 N 天算」,活动下拉加「施工」「现场勘察」。
- 服务端 88 条断言全过,两台手机确认已装新版本。
两台手机把同一趟各记了一条:靠顺序兜住,不是设计
- 同一天两组停留中心距离 0 米:两台手机同账号各记了一条。
- 未翻倍是因为时间带「先到先占位」把第二条压成 9 分 14 秒,属顺序兜住不是设计。
- 合并脚本里「必须同一台设备」的条件恰好挡住误合并,去掉会毁掉双设备真实记录。
- 同批还有 29/30 小时跳天重叠脏数据,本轮只处理当天两组,历史数据未动。
- 待办:App 关闭停留时只关本地最新一条的逻辑未改,双设备重复还会再长出来。
接送孩子这类事,把「前边那段路」也算进来
- 「送孩子上学」这类要去某处的活动,把前边路上时间并入本条(送/接/上学/放学)。
- 只在前面确实是路上空档或紧邻行程时并,且不超过 2 小时;购物、吃饭不吃前段路。
- 「记下来了」总量口径不变,界面小字注明其中 N 分钟在路上、不计入总量。
- 效果:送孩子上学 5 分钟 → 25 分钟(含路上 20 分钟)。
判「人走了」的证据,得先确认「下一条」是同一地点
- 未闭合停留原按「下一条进入时刻」收口,线上遇到中心距离 0 米的重复开启,真实 3 小时被压成 31 分钟。
- 修法:先比坐标,中心距离小于 200 米视为同一地点,不作「人走了」证据,改由轨迹点判真实离开时刻。
- 坐标缺失或非法时直接报错停下,不静默退化。
统计页「洗车 8.4 小时」:同一条停留,两个页面两套算法
- 修统计页洗车 8.4 小时虚高:同一条停留轨迹页 3.0 小时,统计页按「未闭合就按现在算」滚到 8.92 小时。
- 僵尸时段按「先到先占位」还盖住当天后面三段,造成「半天蒸发」。
- 把收口判据抽成模块,命令行脚本、每小时定时器、统计接口三处共用一份。
- 验证洗车 8.92h → 2.97h,与轨迹页一致,自洽校验通过。
0.7.0 上线:产品图与建议零售价进生产
- 上线 0.7.0:385 张产品图入产品库,建议零售价三层来源覆盖 99%。
- 按工作流拆两笔提交(数据+产品图 / 零售价),以相对基线、同组文件的完整差异逐字节自检两笔合并等于改动前工作区。
- 数据上线独立成步:同步数据源、服务器跑幂等导入、单独同步图片,导入前先拍回滚备份。
- 上线时发现线上库多一个客户一个项目,再次印证生产库只能增量导入。
- 验收 4283 条 / 7 家供应商 / 385 张图 / 孤儿图 0;令牌取图 200 且为 webp、无令牌 401、不存在 404。
阶段变更的操作人:从手打文本框改成名册下拉
- 阶段变更「操作人」由自由文本改为名册下拉,候选从专门接口现取,新入职同事立即可选。
- 接口登录即可、不要求管理员;不复用账号管理接口,也不放进免登录公开元数据(姓名属内部信息)。
- 下拉下注明「留空则自动记为当前登录账号」。
- 用不落库方式验证三种情形:不填署当前、选人署所选、空串回落当前,全部通过。
项目类型可以自己加了:内置项与自定义项拼起来下发
- 项目类型支持自定义增删,其余字典保持只读。
- 下发为内置常量加自定义表拼接:内置恒排最前、顺序稳定,自定义追加在后。
- 接口挂在免登录公开路由(登录页渲染表单用),增删两个接口各自显式声明需管理员,不能靠挂载位置定权限。
- 字典值长度上限与项目表该列同宽,并去首尾空格,避免「智能照明 」另成一条分类。
- 删除时返回「有几个项目还在用」,项目存名字快照,删分类不动已有项目。
行业动向 + 竞品分析:机器批量写入,指纹去重
- 侧栏新增「行业动向」与「竞品分析」,均仅登录可见。
- 幂等键:动向为日期加公司加标题,不含摘要与来源,避免两家媒体同题重复入库;竞品为品牌加品类加产品加型号,不含价格,避免每次调价新增一行。
- 指纹认字面不认意思:改摘要算更新、改标题算新条目,已写进抓取提示词要求标题写死。
- 护栏:价格区间低大于高直接拒收;全屋整包与单品分开统计,某品牌均价从 ¥1,438 修正为 ¥892。
- 交付自包含每日抓取提示词加纯标准库推送脚本,交常开电脑每天跑一次。
派生金额不给编辑入口,但显示它的地方必须自带导航
- 反馈找不到设备清单小计的编辑入口;小计是数量乘报价单价实时算出,库里没有该字段。
- 界面误导:小计卡在首屏最上与只读指标同款,可编辑清单在下一屏且非默认页签,卡上无跳转。
- 定两条:派生金额继续不可直接编辑;显示该数的地方负责导航,整卡可聚焦回车跳页签并滚动到位,右上角常驻低干扰的「维护」。
- 空清单提示不再显示 ¥0,避免误读为已填;概览位(客户详情、看板卡片)不加编辑入口。
项目加施工工期:只存两个数,完工日现算
- 项目补开工日与施工天数,完工日不落库,由开工日加天数减 1 现算,避免存三个数出现两个真相。
- 加列走既有迁移清单,线上重启即生效,不需要单独导数据。
- 阶段流转:拖进施工中时显式给了按给的、已有值保留(误拖回不抹掉)、都没有才取当前时间。
- 看板卡片显示「10-07 · 3 天(10-09 完工)」。
- 16 项断言全过:0 天、1000 天、负数一律拒收;只填天数不给日期时完工日为空。
今日待办:工作台首屏 + 独立页,两个入口同一份计数
- 侧栏新增「今日待办」,可自加紧急事项并可选绑定项目。
- 待办不属于项目:绑定可选,删项目只解绑不删待办。
- 「今日」定义为未完成且期限不晚于今天,含未设期限,避免无限后拖。
- 工作台首屏面板支持回车添加、勾选、推迟到明天;独立页做分组、编辑、清空已完成;两处与侧栏角标取同一接口,计数一致。
- 逾期转红、紧急标橙;工作台为桌面布局,面板设最小宽度,移动端适配列为下一步。
建议零售价:厂商给的、官方的、我们推的,必须一眼分得开
- 需求:产品查询加建议零售价,厂商没提供则由系统推。
- 数据现状:库里约五分之一产品带厂商零售价,其余报价靠手感加价。
- 四层来源带角标区分:厂商零售价「厂」、官方定价「官」、采购价乘品类系数推算「估」、无采购价显示短横线。
- 系数取自库里五百多条采购价与零售价真实配对,按类目取中位数,1.07 至 2.9 倍、兜底 2.4;官方产品线只乘 1.1,展板样品不给建议价。
- 即时算不落库,避免成本改了建议价静默错位;覆盖 99%,三处先行规则挂出待核。
一条超长字段,能把整个页面打挂
- 现象:供应商列表页整页挂,产品库按价格排序也整页挂,看着像前端写坏,实为数据问题。
- 根因:SQLite 文本字段无长度上限,接口出参契约限 64 字,写入无感、查询才炸;一家 21 个品牌拼进「主营品类」达 80 多字。
- 修法三层:导入按上限截断并统计截断条数;上限值直接取自出参契约;冒烟测试加超长值断言,确保列表仍返回 200。
- 教训:数据侧超长会表现成前端崩溃,排查先拿一条真实数据过接口;此后导入前先跑字段长度体检。
解析「跑通了」不等于「解析对了」:三个静默错误
- 脚本一路打印成功、条数也对,但有三处静默错误,结果都看起来合理。
- ① 三张表被判无表头,19 条真产品没进:闸门要求表头含价格类词,默认词表缺「产品价格」,补入后解决。
- ② 插座凭空多出同价「单火」版:合并单元格使零火/单火两列读出同值;加闸「拆出版本与主价相同即不是两件货」,两表从 51+32 收敛到 35+25。
- ③ 分类被关键词抢走:床归成窗帘电机、中控屏归成音箱、音响线当成音箱,重排分类优先级修正。
- 教训:每次解析后必须回原表逐格核对,并看类目分布是否符合常识。
把「产品图」做成通用能力:385 张图随产品一起入库
- 第 7 家米家生态,表 50MB 出头,体积几乎全是内嵌产品图,要求图也一并入库。
- 抽图按锚点定位到行,宽高比 ≥2.5 判为页眉横幅剔除 28 张;透明通道先合成白底,否则压缩后发黑;同格多图只按内容去重。
- 51.6MB 原图压成 385 张 webp、2.9MB;新建图片表启动时自动建,与产品一对一,产品图不进幂等键。
- 取图接口要求登录,前端不能直写图片地址,须取二进制渲染并及时释放,否则翻几千条会攒几百兆内存。
- 该家共 371 条,米家生态与小米官方产品各成一块。
新增门禁安防品类:参数全塞在一个格子里
- 第 6 家做门禁,43 条,是产品库首个门禁安防品类,表头干净,难点在描述格。
- 十来个参数塞一格,键值换行、空格分隔、一半键不带冒号三种写法混用;描述解析器拆成结构化属性加归一化原文,拆不出原样保留不硬猜。
- 新脏数据:表尾页脚费用行(安装费/快递费/设备总计)有名无型号无价,原闸门拦不住;「设备总计」行因合并单元格读到「不含税运」,看着像有型号。改为按名称前缀拦。
- 一款支架三个型号在源表里型号、名称、描述完全相同只有价格不同,挂出等确认,不自己编。
价格表是 PDF 也能读:把矢量表格线还原成网格
- 首个 PDF 报价表:10 页带表格线与产品图,用矢量表格线还原网格,落入与 Excel 侧相同结构,导入代码零改动。
- 补系列前缀必须隔空格,否则「A6」加「16A插座」会拼出 A616A插座。
- 列宽折行只在中文与中文之间掐空格,保留中英文之间空格,以区分「M3 一开」与「M3一开」。
- 一格两价拆两条;两列材质是互补非主备(70 行只填前者、27 行只填后者、50 行都填),也拆两条。
- 147 个数据行拆成 203 条,全部有价。
一家渠道商 = 21 个品牌、11 张子表:第 5 类畸形表也拿下了
- 渠道商汇总表:一家 21 个品牌、11 张子表,列名各表自定,3 张表内分多段,1 张整表无表头。
- 引擎补按子表生效的配置:子表列映射、无表头直取列号、段内重算列号、子表默认品牌、价格词表按表设定。
- 品牌三级兜底(行内品牌列 → 子表默认 → 命令行),含数字或过长的品牌名一律回落默认。
- 结果 370 条全有价、覆盖 21 个品牌,全量回表逐格核对 370/370 一致。
- 抓出两个真问题:千分位价格被读成 1、供应商页因字段超长整页挂;第一家 723 条基线复跑一致。
把「导价格表」沉淀成可复用的流程:引擎通用、配置专用
- 把导价格表沉淀为「引擎通用、配置专用」:每家供应商一份配置(列名别名、子表列映射、分类与品牌规则、计价单位)。
- 脚本只做体检与解析,体检先跑,输出行列数、合并区、表头段数、记录数、有价数并自动告警。
- 留回归基线:第一家表重跑输出必须逐条完全一致,新特性先过基线,防「为 A 家加的功能改坏 B 家」。
- 已验证单一供应商表、渠道商汇总表、PDF 报价表三种形态,每次只加一份配置和一个钩子,前三家结果均可复现。
同一款产品被多家供应:不归并,按「供应商 × 型号」各存一行
- 结论:同一款产品被多家供应时不归并,按「供应商 × 型号」各存一行。
- 实测两家供应商品牌完全不相交,当前跨供应商重复为 0 组。
- 只按品牌 + 型号去重,光一家内部就误并 88 组:型号列笼统,一串名字下塞着 6 个不同功率的价。
- 同一通用件(200W 电源)一家内部 4 个价、差 60%;漏并只是多几行,误并就是报价报错。
- 扩展路径:只读的跨供应商比价视图,查询时聚类不落库,验证后再固化标准品层。
产品查询与供应商两个板块:从供应商价格表到可检索的产品库
- 三段流水线:供应商价格表解析成结构化数据源,幂等导入产品库,再由接口供查询页,换供应商只改第一步。
- 解析处理合并单元格、多段表头、整行标题、一格多配置价等畸形表。
- 导入按「来源表 + 行号」幂等 upsert,重复跑不产生重复行;不带清理参数时人工补录的产品保留。
- 查询一次返回结果、价格统计与筛选项,三者同源,筛完统计跟着收敛。
- 首批入库 723 条、4 个类目;采购底价不进公开展厅,挂在登录路由下;规格结构化存储(搜 24V 能命中)。
定名「悦居智能 CRM」:产品名带上公司名,并与业务描述区分开
- 产品名从「智能家居 CRM」定为「悦居智能 CRM」,加上公司名,一眼看出是谁家的系统。
- 三层命名有意区分:产品名悦居智能 CRM、业务领域智能家居、对外展厅智能家居案例展厅。
- 展厅是否挂公司名不在本次范围,属对外业务品牌承诺,需单独决策。
- 落地 11 个文件 12 处(README、接口文档标题、/health、页面 title、侧栏、登录页大标题),英文标识与前缀不动。
- 重新构建部署后从公网逐页核对,均为新名且控制台无报错。
部署脚本用 rsync --delete,把线上的启动脚本删了
- 现象:一次例行部署后站点直接 502。
- 根因:rsync --delete 全量同步把线上手工放置、未进仓库的启动脚本删掉,进程管理器重启找不到入口。
- 脚本最后一步打印「部署完成」,健康检查拿到 502 仍照常打印成功。
- 修法:启动脚本纳入版本库;健康检查改硬判据,返回内容必须含 ok,否则非零码退出并提示看日志。
- 结论:全量同步与服务器手工文件天生冲突;打印成功不等于真成功。
新增「行业调研」:把行情与价格变成一份能查的底稿
- 新增「行业调研」,首个主题智能灯具市场:17 章节、67 条型号价格记录,覆盖品牌格局、价格分档、成本结构、合规与采购报价建议。
- 数据独立种子文件、幂等写入,已存在主题默认不覆盖,需显式 --reset 才重灌且只清这一个主题。
- 可见性:读对全员开放、写仅管理员,避免同一条价格出现两个版本。
- 价格有出处、有数据日期、有口径说明,「这个价是什么时候的」能直接答。
项目改名:去掉错字,并简化到「智能家居 CRM」
- 原名「智能家具项目与客户管理平台」中「家具」为错字,且名字太长、各处缩写不统一。
- 统一为「智能家居 CRM」。
- 有意不动两处:对外展厅仍叫「智能家居案例展厅」;英文标识与配置项前缀保持原样,避免为改显示名牵出部署改动。
- 外部平台上的项目名一并同步,避免改名漏在客户先看到的地方。
正式上线:内部客户与项目管理平台投入使用(v0.1.0)
- 立项到上线历时 2 天,已按生产标准部署到自有域名并投入使用(v0.1.0)。
- 能力:客户加项目全生命周期九阶段可旁路流失;三级可见性;经营统计 KPI/年度对比/月度趋势/成本构成/CSV 导出;智能灯具价格库。
- 上线前收口:全站 HTTPS 自动续期、关闭 /docs 与 /openapi.json、应用端口只监听本机、未登录业务接口返回 401。
- 前端构建产物由后端一并吐出,线上只有一个进程。
- 真实浏览器从公网走完整流程均正常、控制台无报错;库内为演示数据,正式录入前需重建管理员账号。
2026-10-08
家庭服务主机:让局域网设备也能远程控
- 烤箱只认局域网协议,手机 4G 到不了家,而家里机器无公网 IP、公网服务器也摸不到设备,两端都过不去。
- 解法:家里机器主动连云端,在服务器开只监听回环的端口,反向代理挂到域名子路径,App 只需传云端路径。
- 坑①:服务器默认不探测客户端,死连接永久占端口,重连报端口占用且永不自愈,两头都要设保活。
- 坑②:反向隧道端口被占时会「假装成功」连上不转发,必须显式要求转发失败即退出。
- 交付一键部署包:十步安装脚本、反向隧道与自愈守护、四段式体检、家庭网络探针(实测信号/噪声/延迟丢包/解析耗时)。
v1.3.0:家庭网络检测 —— 把误判做成功能
- v1.3.0 / versionCode 14,把上一轮误判做成家庭网络检测。
- 四档判定:全部设备离线(≥2 台)或 ≥2 台在 180 秒内先后离线为家里断网;有离线但不同时为各自故障;无异常为正常;任意设备 30 分钟内上下线 ≥3 次为网络不稳。
- 同时性判据是本次新增,上次空调全掉而净水器仍在线,只看全离线会漏判成设备故障。
- 认定断网时逐台离线告警全部跳过,铃铛只出 1 条未读而非 5 条。
- 排除电池类设备(门锁长期离线会污染全离线判据);7 个构造场景全部通过。
把「家里网断了」误判成「设备故障」
- 上一轮把离线结论定为设备联网模块故障,实际是家里路由器被关掉,网络恢复后全部自动恢复。
- 证据链本不指向该结论:同账号净水器云端一直在线,不同品类心跳超时不同,「全部设备离线」根本不成立。
- 教训:只看单台设备在线状态,永远分不清设备坏了与家里断网,排除法要用对照物。
- 排查顺序:域名解析 → 外部绕一圈请求 → 服务器本机请求 → 进程与日志 → 最后才怀疑设备侧。
设备掉线,界面却永远显示正常 —— 两层错都在
- 报障:空调离线,但自家界面四台都显示已关机、室温正常。
- bug ① 服务端桥:在线字段只在启动时拉过一次,实时推送里有新状态但解码时从未读取,设备离线桥仍报在线。
- bug ② App:适配器没把离线字段传给界面,界面上连「离线」文案都没有。
- 修法:服务端以实时推送为准并定期重拉列表(拉空保留旧列表);App 侧离线为最高优先级文案,盖过已关机/运行中,开关置灰且点击如实拒绝。
- 已发 v1.2.0;新规矩:接口返回的在线状态必须问清是哪一刻的值。
通知发出去了却不弹横幅:代码里改不动的那一层
- 现象:点通知自检提示已发送,但通知栏找不到,一度误判为假成功。
- 实际通知已发出、有声音和振动,只是被折进「更多通知」区且不弹横幅;系统把排序重要性降级,渠道设高重要性也无效,应用侧改不动。
- 真正开关在系统应用通知管理页,「横幅通知」「置顶通知」默认关闭,打开即正常;已在「我的」页加提示。
- 排查技巧:拉界面层级取精确坐标,目测 y 差 23px 就打空;判断截图是否变化要算哈希,状态栏时钟每分钟在变。
- 结论:第三方 App 无法用代码强制弹横幅。
v1.1.0:设备长转 / 无效运转告警 + 消息中心
- v1.1.0 / versionCode 12。
- 告警引擎:无效制冷、长转、报障三类规则,带严重度排序、去重、6 小时通知节流;待处理列表按严重度倒序(首版写反已修)。
- 消息中心:房间页右上角铃铛带未读红点,设备恢复正常后告警自动退出待处理,不用手动清。
- 系统通知带后台巡检,每 15 分钟一次,进后台启动、回前台停止。
- 长转阈值做成可调项(6/12/24/48 小时),放在「我的」页。
告警判据:不看你花了多少电,看这次运转还有没有意义
- 起因是家人问空调是否一直开着、是否费电;实测家里电耗并不高,按电量或费用告警的方向被推翻。
- 判据改为「这次运转还有没有意义」:无效制冷(制冷中且室温低于设定、已运行 ≥1 小时)、长转(默认 12 小时,可切 6/12/24/48)、报障。
- 严重度 = 类别权重 + 已运转小时数,长转超 24 小时升级;按「规则 + 设备」去重,通知 6 小时内不重复。
- 运行时长必须由服务器侧常驻桥追踪:App 端算的话,装一次新版本所有开着设备都会被算成刚开机 0 分钟。
- 首次看到已在运行的设备,开机时刻留空只记观测起点,宁可说「至少开了 X 小时」。
自动断言也可能是假断言:用 0 验证 0
- 断言「在谈项目金额合计等于 0」恒成立,实为验证 0 == 0,实现写错也会通过。
- 改为比对接口真实返回的「在谈金额」字段才有意义。
- 截图脚本以 URL 是否以 /dashboard 结尾判登录成功,而登录失败跳 /login?redirect=/dashboard 也命中,密码错误被静默当成功。
- 改为严格比对完整地址,并额外等一个仅登录后存在的元素。
- 结论:断言先问「实现写错时它会不会失败」,会失败的才叫断言。
公开页用白名单挑字段,不用黑名单删字段
- 落地三级可见性:公开免登录、成员(客户资料/方案/售价)、管理员(成本/其他费用/利润)。
- 公开页不复用内部对象删字段,单独定义模型逐字段挑选;黑名单的弱点是新增字段会自动上公网,白名单最坏只是忘了显示。
- 对外标题用独立字段不回退项目名;不显示内部阶段名,只给筹备中/施工中/已交付;附件对外重命名。
- 成本字段读写双向拦截,只裁剪输出可被改写后反推原值。
折线图看着挺正常,数据点却全飘在顶部
- 现象:月度趋势折线峰谷正确,但代表各月的圆点全落在图表顶部。
- 根因:折线用 SVG、数据点用 HTML 绝对定位,SVG 的 y 轴向下、CSS 的 bottom 向上,整条曲线被垂直翻转。
- 修法:bottom = 100 − (y / 高度) × 100。
- 另坑:SVG 呈现属性不解析 CSS 变量,stroke 写 var(--brand) 会静默失效,必须用 :style 绑定。
- 结论:跨两套渲染体系拼图形,坐标方向与颜色解析规则都要各验一遍。
还没签约的项目,被算成了「亏损 4.9 万」
- 现象:在谈项目的明细行显示合同额 ¥0、利润 ¥-49,173 且标红,看着像已经亏了。
- 根因:统一公式「合同额 − 总成本」只对已成交项目成立,代码漏了这个前提。
- 修法:仅已成交算利润,未签约的利润与利润率留空显示短横线,成本照常显示,表头注明未签约项目不计利润。
- 补一条断言专守此回归。
- 教训:同一公式在汇总与逐行两种用法下前提可能不同,汇总时全是成交项目所以看不出来。
统计口径先定死,再写代码
- 先写 ADR 钉死口径,再由一个模块统一算钱,详情页与统计页共用同一套算法。
- 业绩按签约时间归属,不按建档时间,避免「去年谈、今年签」的报表慢一拍。
- 利润 = 合同额 −(设备成本 + 其他费用);只减设备成本得到的是毛差,会系统性虚高。
- 成本按项目归集不分摊,历史年份利润随后续售后费用录入而变小,属预期行为且界面已说明。
- 未成交项目不计业绩,按在谈/流失/签约后流失单列;收入为 0 时利润率返回「算不出来」而非 0;口径随接口下发。
新增「统计」:看清自己的时间都去哪儿了
- 新增底部「统计」:日/周/月/年四档,按活动分类统计时长,另列出出行方式与里程。
- 口径三条:按天切分且单条停留封顶 24 小时(库里真有横跨十余天的停留,直加会算出 168 小时)。
- 时间带去重、行程优先于停留,否则停留与行程重叠时一天能算出 26 小时。
- 只算记录到的,导航补全的推断路段一律不计。
- 硬校验:各类时长之和加没记录时间等于区间已过去时长;「没记录」占比显式展示,数据只读不出网。
踩坑:相册列表在新版系统上报错,而权限明明是已授予
- 现象:点扫相册报「打开相册时出错了」,但权限检查是已授予。
- 根因:新版系统不接受排序字符串里带条数限制,直接报非法标记;异常被宽泛兜底吞成统一错误提示。
- 修法:查询去掉条数限制,取回后在应用侧截取;扫相册改成有明确开始与结束的对话框,避免关不掉的加载。
- 结论:权限已授予不等于功能可用;兜底过宽会把参数非法翻译成未知错误,排查先拆兜底。
多设备同步:同一个人两台手机时,以移动轨迹为准
- 场景:一人两台手机,留家那台记出「在家」停留,随身那台记出门行程,合并后变成「人既在家又在外面」。
- 规则:以移动轨迹为准,静止那台的停留裁到人离开时刻,裁完不足 5 分钟整条丢弃。
- 判据须同时满足「在别处」与「在移动」,缺一不可。
- 保守边界:无设备标识、只有一台在报、另一台点少于 3 个,一律不合并。
- 去重键补上设备标识,否则两台同秒各采一点会互相顶掉;老库需重建索引。
通知提醒:早上提醒写目标,记录停了提醒重开
- 两条提醒都落在本机系统定时任务,不需要推送账号,也不依赖第三方通道。
- 早上 7 至 11 点每半小时提醒写今日目标,当天写过就不再打扰。
- 记录停摆提醒以「最近定位时间超 10 分钟未更新」为判据,一个值同时覆盖定位断与服务被杀。
- 提醒须挂独立高优先级通道;前台判断用生命周期计数而非布尔量;不同用途通知用不同请求码,否则后建覆盖先建。
- 顺带修两个存量问题:定位关了再开采集回不来、定位关着重新注册会掉监听器。
停留开不出来:「持续静止 5 分钟」被实现成了瞬时读数
- 现象:一天一万多个轨迹点零条停留,服务区充电 18 分钟也没被记下。
- 根因不在阈值,而是判据取瞬时状态量:连续两次读到「没在动」就成立。
- 改为按相对静止锚点的位移判定,阈值随定位精度放宽,连续两次才算离开,且位移计数为零才允许开启停留。
- 末条约束关键:系统冻结后回调会成片到达,没有它会长出「幽灵停留」。
- 停留体检按设备隔离,否则另一台手机记的点在这台眼里全是「人走了」。
修复记录弹窗被底部 TabBar 遮挡 + 清理 EXIF 探针
- 修记录弹窗被 TabBar 遮挡:TabBar 写死 z-index 100,弹窗层级只有 40、遮罩 30 压不住。
- app.wxss 抬到 overlay 200 / modal 300 / toast 400,仅两个弹窗在用,改一处即可。
- 写 shot-sheet.js 用 automator 开弹窗截图,before/after 对比确认。
- 删 exif-probe 页与 utils/exif.js,相册页下线自动扫描与识别基准卡。
- EXIF 实测:小程序能解析拍摄时间/GPS 机型,但 chooseMedia 临时文件已剥离敏感字段,iOS 更彻底。
记录页建档误报自愈 + 个人中心真实化 + 宝宝头像
- 修「请先创建宝宝档案」误报:本地缓存丢失时调云端 babyList 自动认领并回写缓存,云端确无才提示,弹窗带去创建入口。
- 「我的」页重做:真实宝宝头像、昵称、性别月龄、出生第 N 天,四项真实统计,删掉无后端的 mock 菜单。
- 新增 pages/baby-edit(编辑资料、多宝宝切换、设为当前);建档新增头像上传第 4 步,走云存储 fileID,失败不阻塞,建档统一走 addRecord.babyCreate。
- 云函数 addRecord 增 action=overview 返回记录天数/条数/连续记录,取回后 JS 统计,避开复合索引。
- 新增 validate-static.js 静态体检,几十毫秒出结果;静态全过,preview 推送成功即编译通过。
2026-10-07
一排卡片的按钮要齐平,靠的是把空隙喂给按钮而不是写死高度
- 下载区四张平台卡、会员区三张定价卡改纵向弹性布局,按钮用自动外边距吃掉剩余空隙,同排按钮落到同一水平线。
- 修掉主次按钮 2px 高差:基类统一 1px 透明边框,首页并排按钮同步对齐。
- 定价卡「整体放大」改为等效内边距加外边距,增高效果不变、按钮不再位移。
- 1100/1280/1440/1600/1920 五个宽度实测四按钮纵坐标最大偏差 0px,窄屏单列无横向溢出。
- 量测前须先把入场动画标记为已激活,否则元素初始位移会读出假偏差。
「下载按钮点击没反应」的根因:卡片的装饰描边层吞掉了点击
- 四个下载按钮点击均无反应,链接与下载属性本身正常。
- 真因:平台卡片有一层绝对定位铺满的渐变描边层,透明度 0 仍接收指针事件,按钮点击全落在卡片容器上。
- 取证:取按钮中心做命中测试返回卡片容器;绕过命中测试直接触发点击则下载正常。
- 修法:给装饰层加不接收指针事件。验证四个按钮真实点击成功,全站 40 个可点击元素零遮挡,悬停描边与按钮对齐未受影响。
官网下载区接入真实安装包(macOS DMG / Android APK),发版 1.3.0
- 官网下载区卡片写着版本号、链接也齐,但指向的安装包在服务器上不存在,点下去 404。
- 归档本轮真实产物(macOS DMG + Android APK),清单更新到 1.3.0 并补变更说明,重建部署。
- 核验:首页产物哈希与本地一致,各平台直链可下载且字节数与本地一致,六个独立页面增量部署后完好。
- 固化发版四处同步:版本号 → 构建 → 上传包 → 清单与下载页。另记红线:增量部署要逐页排除,按扩展名排除会挡掉首页,曾卡一个月。
macOS 打包踩坑:签名校验失败的真因是可执行文件名大小写不一致
- 签名校验报「信息清单或签名已被修改」,但应用双击能正常打开,容易误判成打包改坏了文件。
- 真因:包内信息清单声明的可执行文件名与磁盘实际文件名大小写不一致;文件系统不区分大小写所以运行无异常,签名按字节比对即判篡改。
- 修法已固化成打包脚本:对齐文件名、移除旧签名、逐个内部框架重签(不用已废弃的深层签名参数)、整体签名后强制校验,不过就不出包。
发布 1.3.0:macOS 桌面版安装包首发 + Android 应用内更新
- 发 1.3.0,补齐官网此前指向 404 的下载入口。
- macOS 桌面版首个 DMG 安装包,Apple Silicon 与 Intel 通用,拖入应用程序即装。
- Android 应用内更新:应用内下载并拉起系统安装器,含进度、取消与失败原因,区分应用内下载与跳外部下载页两条路径。
- 接收端加总进度与「已完成 M / N 个文件」。两端包归档、清单更新到 1.3.0;核验产物哈希一致、直链字节数与本地一致。
照片进对话:让 AI 真的能看到图
- 链路:拍照 → 本地暂存 → 随消息上传 → 服务端调视觉模型读图 → 结果落回对话。
- 三个要点:采集链路与界面解耦,否则拍完界面空白;同一张照片会多处重复记录,按内容指纹去重(曾一次调试灌进一百多张);系统相机在该机型不可靠,改用应用内相机。
- 隐私:照片只在本人视角可见,不参与家人授权。
- 照片可挂到时间线对应记录,让「今天去了哪」带一张图。
踩坑:报告「已上线」了,但线上跑的还是旧文件
- 某轮改动本地自测通过、也执行了上传,就汇报「已上线」;复查逐字比对线上与本地校验值,发现内容还是旧的。
- 根因:上传命令目标路径写成目录,文件落到上一层,而项目里恰有同名旧文件,于是传输 100%、文件存在、语法检查、版本号全部看起来正常。
- 处置:把「上传后逐字比对校验值」定为硬规矩,是否上线以线上接口真实返回为准,不看传输日志。
页面打开要 19.4 秒:真凶是服务器没压缩 JSON
- 现象:打开网页空白约 19.4 秒,之后显示「这一天还没有行程」,原以为是加载态没做。
- 排查:直连服务端首字节 0.13~0.22 秒,服务端不慢;单日响应体 2.79 MB,轨迹坐标被时间线与行程各存一份。
- 根因:服务器只开了压缩开关,压缩类型仍是注释状态,默认只压 HTML,JSON 一直裸传。
- 修完 2.79 MB → 556 KB,19.4 秒 → 1.7 秒;加载态分加载中 / 无记录 / 失败三种,加载期间数字显示「—」。
直播轨迹 + 断口按导航补全
- 直播轨迹:正在走的行程在地图上实时推进,带方向车头与当前时速;时速只读定位系统自带速度字段,不用两点距离除时间。
- 断口补全:两段记录间有空档时用导航补路,画虚线灰蓝与真实实线区分;加覆盖率与位移速度两道判据,静止空档不补。
- 补出里程单独列账,不并入真实里程。
- 难点:导航路线常把端点吸附到辅路,补出的线贴着高速平行跑;判据只能用绕路比,不能用路名里有没有高速。
全天上下文推理:给每一天写一段「今天的故事」
- 一天一次,把当天停留、活动、行程按时间顺序交给大模型,生成一段当日叙述,并给每条停留一句细节描述。
- 只在还有未推断过的停留下调用,避免反复空跑产生费用;用户手动改过的记录不被覆盖。
- 改名后只把当天总结标记为过期,下次推理重算,不就地重算,避免一次保存触发多轮请求。
- 提示词里不放细节描述项,只用短名加活动名,减少模型被上一轮措辞带偏。
相册识图链路被证伪:端上 AI 根本不支持传图
- 反馈:宝宝照片与合影被识别成风景照、说没有人物。把已入库原图重跑识图,模型答「我无法看到照片」;换明确支持看图的多模态模型,回复一样,说明图在传输途中就丢了。
- 根因两层:一是选了纯文本模型 hy3-preview,传图被忽略;二是小程序原生 wx.cloud.extend.AI 不支持图片上传,content 里的 image_url 被网关直接丢弃。
- 结论:这条链路从上线起就没真正跑通过,此前自动化测试「通过」是拿风景图测的、模型蒙对。
- 修法:控制台开启多模态模型,识图改走服务端 node-sdk(超时调 60s)或 App 端 js-sdk。
2026-10-06
高速长途被切成多段:真凶是网络定位的「瞬移点」,不是服务区
- 现象:一段高速长途被劈成几段,中间冒出短促「停留」,像在服务区停了好几次;段间隔只有几十秒到一两分钟,并非真停车。
- 真凶是网络定位脏点:精度差、位置跳出几百米,采样间隔又短,两点一算就是超物理上限的速度,被当成急停再出发。
- 判据两条同时成立才算脏点:位移除以间隔超物理上限、间隔短到亚秒级(兜底除零)。
- 修完长途恢复一条,服务区边界正常。结论:有信号但错得离谱的定位点比空档更难识别。
底部导航从 5 个精简为 3 个:同一功能不留两个入口
- 底栏由 5 个精简为 3 个:轨迹 / AI 助手 / 我的。
- 「今日」与「轨迹」共用同一条数据管线,只是两个视角,合并后天气、当天概要、今日目标三样搬进轨迹页;「家人」低频,并入「我的」。
- 判断依据:中老年用户对底部按钮数量敏感,少一个入口少一次犹豫;同一功能只留一个入口也避免两处数据不一致。
- 后统计功能加入扩回 5 个,但「不留两个入口」的原则保留。
自动化改造:启动即同步 + AI 自动推理,长辈什么都不用点
- 改造:App 启动即全量同步;服务端把 AI 推理接成定时任务,有新数据自动跑,不再靠打开指定页面触发。
- 只在还有未推断过的停留下调用大模型,空跑不产生费用。
- 同步引擎化:可多处触发,结果以广播发出,界面收到即重读,不再轮询。
- 效果:装好后不用操作,次日打开能看到昨天的行程与活动结论。手动改过的记录不参与自动推理,人工优先。
排查内存吃紧 + 定调:相册扫描挪到 App 端
- 现象:开发机内存常年只剩 85~100MB,swap 顶到 15GB;物理内存仅 8GB。
- 实测:开发者工具 25 个进程 1.8~2.5GB、WorkBuddy 约 1.3GB、wired 约 1.6GB。
- 漂移测试:挂最吃内存的相册页静置 10 分 54 秒、采样 7 轮,三方内存与 swap 均高位震荡无单调上涨,判定容量问题而非泄漏;代码审计也未发现未解绑监听或无限缓存。
- 定调:相册扫描挪到 App 端(可读系统相册、后台批处理、无包体与 3 秒超时限制),小程序只做展示并放引导卡。前置需先解决 openid 身份对齐才能共用 baby_photos。
Windows 1.1.2 上架官网下载(zip 免安装)
- Windows 版首次上架官网(zip 免安装):构建 90.9s,Release 32M,打成 13.2 MiB 的包(顶层目录 + 30 项)。
- 上传下载目录,versions.json 的 latest.windows 指向 1.1.2 / build 9,history 加记录并镜像同步;官网 Windows 按钮原先只有 UI 没有 url,已补进压缩 JS。
- 坑:nginx 给 JS 标了 immutable 30 天,改名才生效——按新 sha256 前 8 位重命名并改 index.html 引用,验证旧名 404。
- 验证:zip 直链 200(application/zip,13.86 MB);沙盒拦 Add-Type,改用 tar 校验包结构。
官网同步 App 1.1.2 下载入口并重新部署
- 官网同步 1.1.2:Android 下载链接指向新包。
- 版本清单更新为 1.1.2 / build 9,补变更说明(多文件只到一个、进度条回落、同名覆盖)。
- 重新构建部署,首页引用产物哈希已刷新。
- 核验:首页 HTTPS 200、证书通过,线上 JS 哈希与本地一致,安装包直链 200,六个独立页面与微信校验文件完好。
发布 Android 1.1.2(build 9)+ macOS 同步重编
- 发 1.1.2(build 9),补丁版本、无协议变更,新旧版可混用。
- 内容:根治共享文件 ID 撞号导致只收到一个、接收端同名追加序号、进度条回落、任务卡显示文件数量。
- Android 包归档,版本清单与下载页同步;桌面端同步重编到同一版本号。
- 两台不同品牌手机覆盖安装成功,确认 1.1.2 / build 9,冷启动后服务端三台设备在线可互见。上架仍缺 release keystore、i18n 迁移、商店物料与隐私声明核对。
修复多文件传输进度条反复回落导致的「单文件闪烁」
- 现象:多文件传输进度条涨一段就归零,看着像在重复传同一个文件。
- 根因:进度 = 已收分片 / 总分片,文件合并后其分片从已收表移除,分子骤降,顺序发送时每个文件都走一遍涨满归零。
- 修复:以已落盘文件累计字节为基座(只增不减),加当前文件已收分片比例,夹在 [0, 总字节];同名文件按出现次序匹配清单尺寸。
- 顺带把任务卡副标题最前面明写「N 个文件」,避免长文件名截断后看成单文件。新增真实分片上传回归,50/50 通过。
根治「选多个文件发送、对方只收到一个」:共享文件 ID 撞号 + 同名覆盖
- 现象:手机选 5 张图发电脑,两端都报成功,磁盘只有 1 个文件。
- 根因:文件 ID 用毫秒时间戳,多选同步连发全落在同一毫秒,映射表后写覆盖前写;传输历史里 5 条的名称、大小、ID 全相同且等于任务号。
- 修复:ID 改微秒时间戳 + 自增序号并循环校验不冲突;接收端同名自动追加序号、绝不覆盖;合并落盘返回实际路径,完成判定改为已合并数达到清单长度。
- 顺带修:原先用待收分片表为空判整批完成,顺序发送时首文件合并完就提前报成。新增 11 例回归,49/49 通过。
发布 Android 1.1.1(build 8):传输可靠性修复 + macOS 版本号对齐
- 发 1.1.1(build 8),补丁版本、无协议变更,新旧版可混用。
- 内容:地址不可用导致整单失败(缺端口自动降级中转)、信令半开 75 秒判死重连 + 无限重连 + 60 秒巡检、错误码、全选与滑动多选、系统程序打开与文件管理器定位。
- Android 包归档,版本清单与下载页同步;服务端同步部署按地址完整性决定直连或中转。
- macOS 同步重编,修掉打包配置写死版本号导致上报恒为初始值,版本号来源统一。验证三台设备在线且端口齐全,手机确认 1.1.1 / build 8。
修复「对端设备地址不可用」:网络变化丢端口 + 自动降级中转 + 错误码体系
- 根因:网络变化回调里用不带端口的构造方式重建设备信息,本地服务端口被清空,上报地址只剩 IP,发送方前置校验直接判死。
- 三层防护:重建时保留端口;服务端发现接收方地址缺端口改走中转;客户端把直接判死改为「直连→中转」降级,并给发送入口补异常兜底,避免任务永久停在传输中占并发位。
- 错误码体系落地:失败提示带编号(如 E1005),14 个失败分支统一带码,补齐 WebRTC / 蓝牙码位,修掉重试时旧错误文案残留。
- 验证:静态分析 0 error,客户端 38/38(新增 5 例)、服务端 32/32(新增 2 例),三台设备上报端口全部非空。
根治长时间挂机后设备失联:信令半开自愈 + 无限重连 + 定时健康巡检
- 现象:桌面端长挂后进程活着、界面显示在线,但各端互相看不到,只能重启恢复。
- 根因:TCP 半开时收不到关闭也收不到错误回调,连接状态仍显示已连接;两处缺陷是重连有次数上限、心跳只发不等回。
- 改法:心跳升级往返探测,3 个周期无服务端消息即判死重建;移除重连上限,退避最长 30 秒永不放弃;局域网发现广播 30 秒未成功即重建;另加每 60 秒健康巡检。
- 用只握手不回数据的假信令服务器验证:第 75 秒准确触发重连;回归 21/21 通过。
媒体选择器支持全选与长按滑动多选
- 媒体选择器补两种批量选择:全选 / 取消全选,选中项带序号角标,底部显示「选好了 (N)」。
- 长按任一缩略图进入批量模式(带触觉反馈),按住滑动可连续选中或取消经过的条目。
- 实现:长按赢得手势竞争后接管拖拽,网格滚动让位;指针旁路层按滚动偏移换算网格下标(内容坐标 = 局部坐标 + 滚动偏移)。
- 选择结果带序号,传输顺序与选择顺序一致;静态分析 0 问题,真机全选与滑动均正常。
2026-10-05
相册自动扫描(大模型识图)+ 单列无限滚动
- 相册新增「自动扫描」,首次选一张宝宝正脸照作识别基准;页面改单列大图 + AI 推断地点时段 + 标签,滚动到底加载。
- 识图放小程序端:云函数默认超时 3 秒,识图要 3~10 秒,CLI 也改不了超时。
- 新云函数 albumScan(9 个 action),集合 baby_photos / album_state,新增 utils/album.js。
- 选型:wx-server-sdk 3.0.4 无 cloud.extend.AI,豆包 Key 失效、百度无图像权限、DeepSeek 无视觉 → 用内置混元,零新增凭据。
- 新增 tools/mp-auto-eval 端到端跑通,提交 63a0330 已推手机。
跨夜轨迹日切:前一天的轨迹收口在凌晨 24:00
- 需求:前一天轨迹若到凌晨未再移动,就收口在 24:00。线上三种坏形态:未结束一直「进行中」、换设备后一条停留横跨 13 天、午夜 GPS 抖动多伸十几分钟。
- 三条同时成立才收口:当天进入 + 结束时间越过零点 + 次日 0–6 点未离开停留位置;例外是真出门、凌晨无任何轨迹点(设备关机)、正在看今天。
- 离开判定用超出停留半径(小区 200 米),不用绝对距离。只在展示层收口,数据库结束时间不动,另打推断标记。
- 客户端补等价实现应对断网,并加 JVM 单测与服务端用例一一对应,防两份实现漂移。
踩坑:Android 11+ 不声明包可见性,语音识别会被误判为「本机不支持」
- 现象:接入系统语音识别后,任何手机都被判成「本机没有识别服务」。
- 根因:Android 11+ 包可见性限制,不声明查询就看不到系统识别服务,接口恒返回不可用。
- 修法:清单里声明要查询的识别服务与合成引擎,不申请查询所有应用这种过宽权限;TTS 引擎同样要声明。
- 结论:接口存在、代码没错却不生效,先查平台级权限与可见性。
修复「家人」页当前状态恒为横线,并把授权改为可自助管理
- 现象:老人端「家人」页当前状态永远是横线。
- 根因:该页调家人视角接口,校验 viewer 是否被授权;机主查自己时 owner 与 viewer 同一人,永远无授权记录,返回 403。
- 新增本人视角接口,不查授权,与家人视角共用同一段实现,避免两套逻辑漂移。
- 家人页改为可操作:位置与轨迹 / 活动 / 照片 三个开关,加收回全部授权与恢复;改后回读服务端为准,已用线上真实数据跑完往返并恢复原状。
AI 助手加语音输入与播报:让长辈不用打字
- 语音输入:AI 助手输入框左侧加「说话」按钮,走系统识别,识别到文字直接发出,省掉二次点发送。
- 语音播报:回复自动用系统 TTS 朗读,右上角可开关,默认开;语速调 0.95×。
- 错误提示不朗读,避免「连不上服务器」加重焦虑。
- 不引第三方语音 SDK,不增网络依赖与费用;识别不可用时隐藏按钮并提示可直接打字。
大字号模式与「导出我的数据」:看得清、带得走
- 大字号模式:三档(标准 / 放大 15% / 放大 30%),切换即时全局生效;只放大文字、不缩放控件,也不动系统字号。
- 上限压在 30%:实测再高会让固定高度按钮与底栏标签换行。
- 导出我的数据:全部轨迹点与停留导为 JSON,走系统分享面板;坐标保持原始 WGS-84 不转,转了就不可逆。
- 文件落在缓存目录,经 FileProvider 只授权该文件,每次导出前先清上一次。
修复云端同步:未结束的停留被提前标记为已同步,导致结束时间永远传不上去
- 现象:服务端有 10 条停留「未结束」,手机端 8 条正常关闭,两边对不上。
- 根因:上报成功即无条件标「已同步」,含未结束、后续还会变的记录;标记后不再补报,结束时间永远传不上去。
- 修法:只有已结束记录才能标同步,并加一次数据库升级回退历史上被误标的记录。
- 验证:服务端未结束从 10 条降到 5 条,与手机一致。结论:凡「标记后不再重试」的机制,必须确认标记时数据已完整。
地点命名改为「大地名优先」:用周边商铺的引用度排序
- 起因:商场被叫成它内部住宅组团的名字,用户要求按大地名(购物中心)。
- 查打分:更近更大的商场输了,因其 POI 分类是住宅+商场综合体,先命中高权重住宅档,又叠加地址末尾点名。
- 新增「地标引用分」:候选名被周边设施写成地址后缀的次数计分、封顶 50;该商场周边 17 家商铺写「(某购物中心店)」,住宅组团为 0。
- 同时剥行政区前缀,两道护栏:剥完只剩通名不剥,业态后缀省掉后仍被引用才省。
地点识别纠错:坐标系混用导致地点名整体偏了 650 米
- 现象:停留点在小区里,却被识别成「森林公园」。
- 根因是坐标系混用:客户端存 WGS-84,服务端直接当 GCJ-02 查,查询点整体平移约 650 米。
- A/B 对照:修正前最近住宅 POI 在 770 米外,修正后 147 米,名字命中真实小区;存量 7 个地点里 5 个名字是错的。
- 新增坐标转换模块,接到全部 3 处地图请求;库内坐标保持原样不转,否则距离归属会错位。已幂等重刷存量,手动改过的名字跳过。
2026-10-04
多用户账号与登录体系(手机号 + 密码,数据按用户隔离)
- 从单机设备令牌升级为多用户体系:手机号 + 密码注册登录,密码加盐哈希存储。
- 登录态用令牌,Web 与 App 共用同一套接口,未登录访问数据接口一律拒绝。
- 设备令牌保留作兼容通道,老版本 App 不受影响。
- 数据按用户隔离,每账号只看自己的轨迹与停留,为家人守护的授权查看铺底。
轨迹页改为「列表 → 详情地图」两级,对齐网页版
- 轨迹页改为「列表 → 详情地图」两级,先看当天滚动列表(行程 / 停留 / 断档三类),点条目再进地图。
- 行程看整段路线自适应缩放;停留自动聚焦该地点,按停留范围选缩放级别。
- 补返回键处理,实体返回回列表而非退出应用。
- 顺带接逆地理接口,列表地点名缺失时实时补上。
同一天同一地点的碎片停留自动合并为一次到访
- 问题:同地点待一下午,时间线被拆成 4、5 条,GPS 抖动让停留反复中断重建。
- 按「同一地点 + 同一自然日」合并为一次到访:已结束间隔 30 分钟内、未结束 3 小时内算同一次。
- 只在输出层合并,原始记录不动;规律统计与纠偏先过一道合并再算,纠偏时可整组改地点与活动。
- 效果:一天 17 条碎片停留收敛为 8 次真实到访。
官网同步 App 1.1.0 下载入口并重新部署
- 官网同步 1.1.0:Android 下载链接指向新包,体积标注 38MB 改为 40MB。
- 版本清单(latest + history)补齐 1.1.0 条目与变更说明,重新构建部署,首页引用的产物哈希已刷新。
- 核验:安装包直链 200 且 Content-Length 与本地字节数一致;六个独立页面与微信校验文件增量部署后完整保留。
- 首页引用的 JS 内已含 filebreeze-1.1.0.apk 链接。
macOS 重编踩坑:依赖锁文件被忽略导致版本漂移 + 国内网络下 66MB 二进制下载
- macOS 重编卡在二进制依赖两处。坑一:报错称最低系统版本不够,实为锁文件锁了旧版二进制;该锁文件被忽略规则排除、从未提交,版本漂移无人察觉。
- 清理锁文件重新解析,最低系统版本抬到 12.0,工程配置与构建脚本两处同步改,只改一处仍在安装阶段报错。
- 坑二:66MB 二进制国内直连不通,镜像单线程衰减到几 KB/s;切 8 段并行续传并加低速超时重连,约 330 KB/s、3 分半完成,缓存按原始校验和补齐。
- 重编后注册正常:服务端 120 秒窗口内仅 1 次注册,此前每 30 秒上万次的重注册风暴确认根治。
发布 1.1.0(build 7):服务端生产部署 + Android 包上线
- 发 1.1.0(build 7),因含传输协议变更(本地接收加一次性配对令牌鉴权)走 minor 号,新旧版混用会单向失败。
- 服务端生产部署:先补环境变量(JWT 密钥、后台口令、跨域白名单),缺变量会拒绝启动;容器编排改读环境文件,原配置改文件不生效。
- 上线探针全绿:健康检查含 Redis、WebSocket 升级 101、错误上报读写、后台登录、服务端单测 30/30。
- Android 包归档,官网下载入口与版本清单(latest + history)同步;待办商店上架仍在推进。
错误上报链路真正打通:固定 API 基地址 + 运行期全局异常兜底
- 错误上报此前从未成功:地址由信令地址派生,信令迁 wss 后拼出的地址带 wss 前缀,HTTP 客户端不支持,异常被吞。
- 改为固定 API 基地址常量,所有 REST 调用只认这一处,不再派生。
- 日志初始化改幂等可更新:启动早期只传上报地址,初始化前记录暂存内存(上限 200 条),完成后统一补写补报。
- 入口包进 runZonedGuarded,加 FlutterError.onError 与 PlatformDispatcher.onError 兜底,统一映射崩溃码 9999。
- 验证:analyze 0 error,test 21/21,服务端 /api/errors 读写正常。
新增消息中心与消息详情页
- 新云函数 messages 已部署:集合 baby_messages / baby_msg_state,action 覆盖 init/list/detail/read/readAll/unread/remove,首个 openid 自动播种 3 条欢迎消息。
- 新增消息中心与消息详情两页:分类筛选、未读圆点、全部已读、长按删除,打开即已读。
- 首页入口角标改真实未读数(0 隐藏、>99 显示 99+),app.json 注册两个新页。
- 坑:CLI 首次 deploy 新函数停在 Creating,等 20s 重试即成功。
首页新增宝宝切换下拉(多孩家庭)
- 首页标题栏加「当前宝宝 + ▾」下拉,列全部宝宝(年龄/性别、当前项 ✓)与「+ 添加宝宝」。
- addRecord v3 新增 babyList / babySetPrimary,list/summary/dots/recent 支持 babyId 过滤,用 _.in([id,'']) 兼容历史数据。
- 记录页标题栏显示当前宝宝 chip,新建记录归属当前宝宝,创建后自动设为当前。
- 已部署 addRecord,提交 5ebb680,autopreview 推手机。
记录页做成真功能 + 建记录数据库(云开发集合)
- 记录库选云开发集合而非 MySQL:高频小数据、按 openid + 日期读写、无 JOIN。
- 新增 baby_records(含软删)与 baby_profiles 两个集合。
- addRecord / manageBaby 从 MySQL 版改写为 wx-server-sdk NoSQL 版并部署。
- 记录页 v3:翻周日历、分类筛选、真实时间轴、今日统计、软删除;首页接真实数据。
- 新增 utils/records.js,提交 02a1867。
P1/P2 全部修复:完整性校验、文件策略、合规页与 i18n、单测补齐
- 修完 8 项 P1 + 7 项 P2(6593827,31 文件)。
- P1:隐私协议内置、中英切换、错误上报落库、SHA-256 校验、10GB 阻断、Redis 降级、单测 21+30。
- P2:删重复 _checkUpdate、并发常量单一来源、relay 改实例字段、CI 与 systemd。
- 坑:flutter test 需 pumpAndSettle;intl 需升 ^0.20.2。
- 验证:analyze 0 error、test 21/21、jest 30/30、构建 29.8s。
v1.9.0:新名全量落地并上线
- v1.9.0 全量落地新名:App 桌面名、应用内 8 处文案、前台通知标题。
- 服务端 AI 提示词同步,助手自称改为「随形」。
- 官网标题、关键词、主标语更新,标语改为「走过的路,如影随形。」
- 共替换 47 处品牌名 + 3 处助手自称,构建产物旧名残留为 0;后端已重新部署重启,线上验证通过。
品牌中文名定为「如影随形」(英文保持 TraceMate)
- 中文名定为「如影随形」,英文保持 TraceMate。
- 原名双去声、声调一路下坠且同音词多,介绍时要额外解释;新名取「你走哪它都在」。
- 主动记代价:四字略长、成语作商标显著性偏弱,记为试用名,后续调整追加决策记录不改历史。
- 包名与域名不动:改包名会被当成新应用,已装用户的本地轨迹与停留数据会全丢。
2026-10-02
上线前安全加固:修复全部 7 项 P0 阻断问题
- 上线就绪审查修完 7 项 P0(819cbdc,25 文件 +1054/-298)。
- 覆盖路径穿越、配对令牌 + CORS、缺 JWT_SECRET 拒启、限流 + WS 校验、强制签名、版本号统一、删死分支。
- 坑:集成测试 open 后才注册监听,connected 握手丢失成静默超时;SessionHandler 未 close 致进程不退,17s→1.8s。
- 验证:analyze 0 error、Windows 构建 56.9s、服务端 25/25。P0-2 涉协议,两端需同步升级。
AI 助手接入百度语音:按住说话 + 回答自动播报
- 百度语音链路移植进小程序:ASR 短语音 REST + TTS 大模型音库(per=4146)流式。
- 新增 baidu.js(token 缓存、wav/pcm 判别、流式 TTS + REST 降级)与密钥文件。
- voiceCommand 加 asr/tts,TTS 按 md5 缓存;助手页按住说话、上滑取消、自动播报。
- 实测 TTS 61.8KB、7.7s、1.7s;ASR 识别长句全对。
- 坑:百度不收 mp3、大模型音库只支持流式、token 30 天须缓存;部署后超时设 20s。
2026-09-29
接入热泵:开关「假成功」—— 布尔值传成了字符串
- 接入第四个品牌:空气能热泵(v0.8.0)。
- 开关「假成功」:接口返回 200、界面也变了,设备根本没动。
- 根因是开关字段该传布尔却传了字符串,服务端不校验直接忽略。
- 结论:协议无类型校验时,验证开关必须回读设备状态,不能只看接口是否成功。
接入美的蒸烤箱:一个没有云 API 的设备
- 美的蒸烤箱是唯一没有可用云 API 的设备,只支持局域网私有协议(TCP 6444)。
- 必须由同网段机器跑中转服务,App 再连那台机器;v0.9.0 先接入。
- 该约束后来成了系统最大架构问题:手机不在家里 WiFi 就够不到烤箱,10-08~10-14 另做反向隧道方案解决。
真机 App 重构为五 Tab(v1.0.0)
- 真机 App 从单页长列表重构为五 Tab,版本 v1.0.0。
- 分批渲染:各品牌桥谁先回谁先显示,首屏从十几秒降到 4 秒。
- 开关乐观更新:本地先翻转并显示「状态同步中」,600ms 后后台校准。
- 修两处显示:中央空调 name 常与房间名相同,标题改用类型名;无读数显示 -- 而非 --°C。
- 踩坑:无头浏览器 --window-size 最小 500px,380 宽截图按 500 布局再裁切,第 5 个 Tab 看似被挤出屏幕,靠 DOM 实测宽度才排除假 bug。
信息架构定稿:按房间组织,不按品牌
- 信息架构定稿五个一级 Tab:房间 / 设备 / 管家 / 智能 / 我的。
- 关键决策是按房间组织而非按品牌:用户关心客厅里有什么,不关心牌子。
- 列表页只放灯光、窗帘两项高频控制,全量设备与联动收进房间详情,避免两级重复。
- 底部五钮同水平线不做凸起主按钮(会遮挡内容区,聊天页实测被挡);管家负责说、智能负责看。
交付物说明:方案书四版本 + 可运行的服务端原型
- 方案书四版内容一致:Markdown 源稿 / HTML / PDF / DOCX,按场景取用。
- 同时交付可运行服务端原型:四级权限(地域→部门→角色)、本地与云端可切换的存储抽象层、文件管理与回收站、全链路审计、动态水印、WebSocket 三地同步、Docker Compose 一键部署。
- 可复用:多地域多部门分级权限模型与存储抽象层可直接沿用,方案文本改参数即可重出稿。
运维收尾:系统稳定运行,迭代至 v2.1.4
- 系统 2026-07-07 上线后稳定运行,Web 端迭代至 v2.1.4,此后均属运维。
- 环境:华为云 ECS + Docker Compose + Nginx + Let's Encrypt,已配 systemd 自动续期。
- 运维期:时间改北京时间、四态流转与投标去重(18 份→3 家)、截止后封锁上传删除、竞价按联系人隔离修泄露。
- 09-18 证书到期全线不可用后补自动续期。尾巴:小程序 footer 硬编码 v2.0.2、end_time 未过 fmtDate、certbot 待升级。
2026-09-28
立项:把五六个厂商 App 收进一个
- 起点是家里每买一个品牌就多一个 App,查一次客厅温度要先想清是哪个牌子。
- 首日打通洗碗机、中央空调、净水器三个品牌协议,迭代到 v0.7.0;两个纯出站连厂商云,一个走局域网。
- 难点在协议各异(WebSocket 长连、加密私有 TCP、局域网广播发现),定为每品牌一个独立桥,App 只读统一格式状态。
定死全站文案口径:不喊口号、不承诺疗效、主动写「不管什么」
- 定三条口径:不用 emoji 不喊口号;不承诺疗效;每页主动写「不管什么」。
- 边界写进页面而非手册:AI 与自动化是帮手不是保险;卧室、卫生间只用雷达和门磁不装摄像头;旧设备能留就留,燃气管道须持证施工不在服务范围。
- 判断:写得越诚实越好卖,客户怕的是花钱后发现「当时没说清楚」。
立项:适老化智能改造落地页首版上线
- 适老化改造落地页首版上线,定位面向有老人的家庭(多由子女代购),北京延庆本地团队上门看房、免费出方案。
- 首版 5 页:首页 / 为什么改 / 改造前后 / 方案套餐 / 关于我们。
- 部署在自有服务器 Nginx 静态站,发布脚本 rsync 上传 + 逐文件哈希比对,线上不一致立刻能发现。
- 上线前后围绕防摔、陪聊、电视做了多轮版本迭代,每轮留截图存档可回溯。
发布「大模型 Agent 智能家居」文章(含 AI 生成配图)
- 发布「我们开始给家装一个『大脑』:悦居智能正式启动大模型 Agent 智能家居系统研发」。
- 文章归入 AI 应用分类。
- 配图由云函数调大模型生成 6 张,不再依赖图库,内容生产链路拉通。
华为真机适配:新机权限一键配齐
- 新装后运行时权限全为空,逐项自动授予定位、后台定位、通知、活动识别、存储。
- 机器是 Android 12,存储需用 READ_EXTERNAL_STORAGE;READ_MEDIA_IMAGES 报 Unknown permission。
- 已加电池优化白名单,后台相关 AppOps 兜底放行。
- 华为「应用启动管理」受私有权限保护,非 root 写不进去,只能引导用户手动开自启动 / 关联启动 / 后台活动,否则夜里静默断采且无报错。
文案改为数字分身版:全程不让分身开口,用面部小动作+画外音规避口型崩坏
- 改为数字分身版文案:主角贯穿全片,三镜头为中景偏侧 → 过肩 → 中近景反打。
- 全程不让分身开口,表情改用弯眉、挑眉、靠椅背、松肩微笑,台词走字幕 + 画外音(旁白 27 字)。
- 人物锚定写在提示词第一句,前 20~30 字权重最高;三段保持同款家居服、短发、光线方向。
- 新增分镜表、分身风险提示与 9:16 竖版改法;15 秒内只做 3~4 个动作,不拿真人清晰照做首帧。
把这次风扇优化做成即梦 15 秒短视频素材(对外展示 WorkBuddy 的运维能力)
- 把风扇排障过程做成即梦 15 秒短视频素材,对外展示运维能力。
- 三段各 5 秒:出风口特写 + 风扇声渐强 → 扫过散热口、闪白后声降一半 → 合盖静音、屏幕浮字定格。
- 按规范写清 16:9 / 24fps / 15 秒与三个时间段,指定精确末帧,旁白压到 38 字内;字幕三句共 43 字。
- 交付 workbuddy-风扇优化-即梦15秒文案.md,含提示词、字幕、旁白、音效、竖版适配与替代方案。
风扇嗡嗡响的根因不是占用率:上下文切换 11273/秒,外加一次差点搞坏网银的误判
- 只有这台一开机风扇狂转。XTXCoreSvr_BOB 一度被误判成 ToDesk,查 PathName 才知是北京数字认证的网银证书环境。
- CPU 8.3%、空闲 93.9%,但上下文切换 11273/秒、系统调用 34831/秒;DPC 0.19%、缺页 1,排除驱动与内存。
- 结论:大量极短线程反复抢核,核心进不了深 C-State;风扇看瞬时功耗。
- 已改电源计划(5%/99%)、关 Copilot 延迟 12s 自启、清三项自启,注册表已备份;风扇已不响,待重启复测。
2026-09-27
v1.8.0:接入高德地图、后台保活加固、后端迁入自有服务器
- 轨迹可视化改用高德地图,定位与地图同源,偏移更小。
- 针对国产 ROM 省电策略做保活加固,降低熄屏后被静默断采的概率。
- 后端迁到自有轻量服务器(PM2 + Nginx),接口域名启用。
- 同步产出产品官网与数据看板。
Web 端打通真实监控画面 + 主界面重构 + 智能助手真实化
- Web 端入口定为内网 3000:云端域名无 API 反代,HTTPS 调 http 被混合内容拦截。
- VideoPlayer.vue 重写:NETWORK_ERROR 静默重连、首帧 18s 超时、generation 作废旧回调;5 路真机出画面。
- 主界面改左设备列表 + 右画面区替换 mock;助手修 5 处,含 randomUUID 崩溃与 stream 幂等。
- H.265 播不了真凶是 flv.js 只认 H.264,ZLM 输出 Enhanced FLV;浏览器链路须有 H.264。
手机端助手页语音输入 + 监控页及整体 UI 改版
- 助手页加微信式按住说话:16k 单声道 PCM → 网关 /asr → Python → 百度短语音,端到端识别正确。
- 监控页 LazyColumn 改 Column + verticalScroll,滚动不再释放 ExoPlayer。
- Theme.kt 补全 Typography/Shapes/色彩 token;VideoPlayer 重写直播重试 + 1/2/4/8s 退避。
- 注意:手机端默认子码流,cam_11_sub 是 H.265,解不了。
录制门禁误判根因:把 motion 当价值 → 改为「只有检出人才录」
- 玄关每 15 秒封一个 15s 片段,存量 1298 个 / 1.06GB;根因是 valuable 判据把 motion 也算价值。
- 12 个片段 person 检出全为 0;帧差挡不住夜视切换,静态片段帧差最高 71%~88%。
- 配额统计只扫顶层,子目录录像恒为 0,64GB 循环覆盖失效。
- 改为只认 person、min_value_frames=3、尾巴 15s→5s、配额递归统计,加 L0 亮度护栏。
- 实测 9 个静态片段全拒、有人片段仍录;待办:录制服务需真实终端 restart。
手机端「登录已过期」根因:token 30 分钟 + 无续期,两端修复
- 「登录已过期」与 mac 版无关,真因是网关 access token 仅 30 分钟,手机端无续期,401 直接登出。
- 排除网关重启致密钥漂移:JWT_SECRET 写死在 docker-compose.yml。
- 手机端加 refreshToken 持久化与 tryRefresh(),401 静默续期后重试原请求;executeAndUse 改接受 suspend 闭包。
- 网关改为 access 7 天 / refresh 30 天。待办:重建容器 + 重装 APK 后生效。
车库(.21) 根因纠正:不是萤石,此前密码/取流路径全错
- 推翻早前结论:车库 .21 不是萤石,家里也没有萤石设备,是另一品牌。
- 错在沿用品牌假设用错账号,误判「设备不推流 / 需 App 唤醒」;mac 端一直能出画面本是强信号却被忽略。
- 实测:admin/admin + Digest、ONVIF 8888、RTSP 标识 happytime,主 ch0_0.264(H.265 2304×1296)、子 ch0_1.264(800×448)。
- 已修正 DB id=11 的 stream_url,重启 media 容器清掉 PlayerProxy 缓存。
mac 客户端新增「录像回放」页 + 清理 1292 个无效录像片段
- 清理无效录像:1298 个片段里仅 5 个真检出人(+1 疑似),1292 个静态误录共 1.0GB,体积 1.06GB→13.8MB。
- 新增 scripts/prune_recordings.py 按 L0~L4 同款判据复核,清理走废纸篓可恢复,报告存档。
- mac 新增录像回放页:直扫本地目录 + AVPlayer,左侧片段列表、右侧 24 小时时间轴可拖动定位并自动续播。
- build-app.sh release 编译通过、实机快照验证;待办录制服务需在真实终端 restart。
手机端 Android 完成开发并真机联调 + 二楼阳台补录
- 手机端 Android APK 完成并真机联调:Compose + ExoPlayer,功能对齐四端,竖屏单列、多路画面常驻不销毁。
- 修 5 项:播放地址补 MEDIA_BASE 前缀、网络请求切 Dispatchers.IO、401 自动登出、HLS 断流自动重试、登录页密码可见按钮。
- 二楼阳台(.48)补录网关 id=12,5 台摄像头全在线。
- 早前把车库(.21)记成萤石有误,当日 17:10 纠正为另一品牌,相关结论全部作废。
官方下载站 nvr.filebreeze.cn 上线,盘点各端进度与备案状态
- 官方下载站 nvr.filebreeze.cn 上线,HTTPS 证书已签发,只放最新版。
- 已完成:Web(Vue3,7 页 + 暗色系统)、macOS 原生(RTSP + 硬解 + 语音唤醒)、Android TV(Compose + ExoPlayer)。
- 可下载:NVRStation-0.1.0.dmg(1.37MB,已签名)、nvr-tv-0.1.0.apk(15.2MB,debug 签名)。
- 待办:手机与 Windows 未开发;TV 换正式签名;域名未做 ICP 备案,有被拦截风险。
道路渲染第二轮:从「能看见」到「改对了」——假配对 / 一张贴图服务整条 way / 路口前灰楔子
- 修三处:假配对把剖面压扁 27.5%;一张贴图服务整条 way 使延康路压缩 41.6%,改逐段取带宽;灰楔子把 14.3m 测成 3.2m。
- measureSpan 先求纵向重叠窗口,最近点只认对向平行段,加 maxOverlap ≤1m、maxFarFrac ≤50% 守卫。
- probe_top.cjs 查像素图层;11 个 audit、13 个 probe 全 exit 0,裸露格 3.9%→3.2%。
- 代价:未配对里程 30.4→37.4km;残留逐 way 配对上限,路缘石仍只是一道颜色。
同源判据抓不到同类 bug:走廊幅两个真 bug 的根因
- 探针抓出两个真 bug:走廊幅 u 分母误用普通样式(innerMedian 为 0),#947 人行道中心 3.386m 落进 3.40m 车道。
- 行道树 off0 符号假设错,127 段里 9 段偏移出渲染跨度(最大 2.74m),改按 sign(off1-off0) 现算。
- 教训:判据与实现同源会一起错,须从几何定义推导;探针 4a 漏除 miter 系数,急弯假偏差 2.6m。
- 抽出公共 edgePoints() 共用,4a/4b 各 5236 次比对全绿,绿化带审计 127 段全绿。
慢行者层落地:路上不只有车了
- 探针量出非机动车网络 703 段 / 37.1km,但连通分量 197 个、最大仅占 4.8%,放弃单独建图,改沿用机动车路网 + 横向分带。
- 参数收进 AgentProfile.ts 一张表;桶键改为 边|通行面,road/bike/walk 互不为前车,配时只取 road 面。
- 通行资格:lanes===0 一律可进,lanes>0 需有对应分带,自动排除高速与匝道。
- 验收新增 7 条判据、15 条全绿;实测自行车 45 体(4.04 m/s)、行人 70 体(1.30 m/s)。
“自适应优于固定配时”测不出来:效应量小于种子噪声,验收拒绝盖章
- 自适应 vs 固定配时 A/B:跨种子均值 97.8%,单组种子噪声就有 6.9 个点,效应量小于噪声,验收拒绝盖章。
- 证据:相位需求占比 0.885,需求确实不对称;现有规则只延长不缩短,46.8% 绿灯贴底 baseGreen,仅 4.0% 触顶。
- 定下两条写进脚本头部:判据只判「无系统性劣化」(≥95%),必须多种子并同时报噪声。
- 跑全同步与错开两种相位初值排除绿波巧合(影响 0.05 m/s)。未做:独立 minGreen、按饱和度选周期、真实 OD。
判据写太弱会给你假绿:最小车距从 25.65% 打到 0.021%
- 判据从「中心距为负」改为「中心距 < 车长」,才测出 25.65% 车体重叠。
- 六个缺陷:idm 把 s0 当车长(7.0→5.0m)、v0≤0 进不了紧急制动、桶按帧初建致跨边车不跟车、投车不查重叠、往短段塞车(8.15m 段 13 辆)、重投兜底硬塞。
- 分桶定位:<15m 段重叠 95.3%、≥15m 仅 4.09%,再用 hasRoomFor 判否与事件日志锁定 setRoute。
- 加 EntryClearance=7.0m 与投车不越停止线,重叠率降到 0.021%,最小中心距 6.08m。
交通层路网化:车第一次真的穿过路口
- 新增 RoadEdge(seg, forward),把段 + 方向打包成有向边;distAlong 统一从当前边入口算,反向要同时翻切向,否则车位置对、朝向反。
- 路由改为沿路口 outgoing / incoming 做带等级权重与转角惩罚的随机游走,不做最短路。
- 跨段前车沿本车 route 向下游累计 60m,只比同段同向桶;对向车不是前车。
- 信号相位按行进轴向配对(角差 ≤30°),四臂 4 相位降为 2;521 个灯里 481 个是 2 来车 / 2 相位。
2026-09-26
项目定名「悦居智能NVR」
- 中文名定为「悦居智能NVR」,英文保持 NVRStation。
- 落地 8 处显示名:构建脚本两个 CFBundle 键、README、前端 title、TopBar、MainPage、LoginPage、TV strings.xml 与 LoginScreen。
- 不改包名、bundle id、数据目录与 UserDefaults 域,旧配置与自测开关继续有效。
- 验证:lsappinfo 返回 LSDisplayName=悦居智能NVR,重启后 5 路设备 0~6s 出画面;看板同步改名。
git 首次入库:5 个逻辑提交 + 补齐 .gitignore
- 建仓后首次入库,按逻辑拆 5 个 commit:2c05c55 mac 客户端、e79c97a 探测脚本、017be55 节流文档、1be89dc 网关流媒体 + ZLMediaKit、24d87db Vue 前端 + TV 端。
- 提交前补 .gitignore,挡住 mac-client/.build(245MB)与 nohup.out。
- 安全检查:third_party 已由 vendor/ 规则忽略,db.go 无明文密码。
- 提交后工作区干净,后续开发有了可用基线。
Tab 改版:商城/社区降级,AI助手+相册上线
- 底部 Tab 由(首页/记录/商城/社区/我的)改为(首页/记录/AI助手/相册/我的)。
- 新增 pages/ai(走 voiceCommand 的 chat 分支,带宝宝月龄上下文)与 pages/album 两个 Tab 页,云函数新增 aiChat。
- 商城、社区降级为次入口,对应「砍掉大而全、聚焦语音记录 + AI 助手」的定位。
- 待办:打通语音记录 → 首页/记录实时刷新,记录页仍是 mock 数据。
第 6 台摄像头跨网段暂缓接入
- 光猫 + 3 台下级路由全开 NAT 的多层网络,Mac 在 3.x,第 6 台摄像头在另一路由的 10.x。
- 实测 3 个别名 IP(10.238 / 1.238 / 0.238)ping 全丢包,多层 NAT 下别名方案必然失败。
- 留三条路:下级路由改 AP 模式 / 光猫加静态路由 / 摄像头重新配网。
- 摄像头装得太高不便重置,本轮暂缓;客户端扫描范围与失败提示符合预期,不为跨网段改客户端。
两个隐蔽判据坑:bash 3.2 中文变量边界 / RTSP 连接数漏 -i
- macOS 自带 bash 3.2 会把紧跟 $VAR 的中文字节吞进变量名(zsh 不会),set -u 下报 unbound variable 并中断。
- build-app.sh 因此长期在签名后中断,codesign -dvv 校验步骤从未执行;全仓库改 ${VAR},按正则扫出 4 处修复。
- 查 RTSP 连接数用 grep -c estab 漏了 -i,输出是大写 ESTABLISHED 恒定返回 0,把 5 条活连接误读成一条都没有。
.48 切回主码流 + 修复 ONVIF 设备改不了取流地址
- .48 从子码流 /stream2 切到主码流 /stream1,解码由 H.264 640×480 变 H.265 2560×1440,首帧 9s。
- 切前链路已自行改善:ping 从 733~1136ms 降到 avg 53.8ms。
- 根因:ONVIF 模式下编辑表单把取流地址与路径预设整块隐藏,逻辑层其实一直支持覆盖。
- 修复:ONVIF 也显示「取流地址(可选)」,预设拆成主码流/子码流两个一键按钮。
四端通路打通,5 台真实设备稳定出画面
- 启动后 5 路全部 0~1s 出画面(4 台 TP-Link + 萤石),自动探测 8.9s 完成。
- 5 条 RTSP 连接每台正好 1 条,无会话堆积。
- 车库(.21 萤石)首次稳定出画面,解码 2304×1296,走 ONVIF 动态取流,推翻此前「设备侧不推流」的判断。
证实朗读不烧 TTS 额度,并把切段逻辑收敛为单一来源
- 结论:朗读不烧 TTS 额度。三级链路只有第 3 级花钱,本地缓存 0 请求、服务器预置只下载自家域名,57 段覆盖 18 部书,正常停在第二级。
- 新建 tools/tts-verify-page.js 复刻页面侧组装逻辑,与 tts-check.js 交叉验证,实测请求 59 段、去重 57、服务器缺 0。
- parseContent 曾在两个详情页 + 构建脚本各存一份共 4 处,漂移会让 hash 对不上、静默走在线合成,已收敛到 utils/tts-common.js。
- 进度文案改为「已缓存 / 加载音频 / 在线合成」,只有最后一种消耗额度;另清理《论语》20 个孤儿音频,用 mv 备份可回退。
踩坑:报错代码把「域名未配」伪装成了「网络不好」
- 现象:开发者工具朗读正常,真机一律弹「合成失败,请检查网络」,但网络与域名都没问题。
- 根因在报错代码:wx.request/downloadFile 的 fail 传的是普通对象 {errMsg} 不是 Error,String(err) 得到 [object Object],匹配不上 not in domain list 便掉进兜底分支。
- 修法:所有 wx 出错路径统一过 errText() 归一化,fail 补主机名,域名类错误直接抛出不再降级重试。
- 经验:错误提示必须能反推根因,catch 不该产出「请检查网络」这类无信息量文案。
「每日提醒」后端从 0 到 1 打通
- 打通两条反向通道:消息推送(微信→服务器,配 URL/Token/AESKey)与订阅消息(服务器→用户,需 access_token + 模板 ID)。
- 后端 server/ 零依赖纯 Node,监听 8790,nginx 反代 /api/wx/,密钥只存服务器环境文件(600)不入库。
- systemd:guoxue-api 常驻 + guoxue-push.timer 每天 07:00(错峰、错过补跑)。
- 选 JSON 免 CDATA 转义;实测合法签名回 echostr、错误签名 403,access_token 换取成功。
- 离线自检 31 条全过(15 加解密 + 16 端到端),只差订阅消息模板 ID。
去掉高速硬路肩,补上道路贴图的像素级验收
- 删掉高速最外侧 2.5m 硬路肩(RoadTexture 的 SPECS.motorway 与单向幅两处),连带清理 CrossBand 的 shoulder 类型、深色常量与图例。
- 高速渲染全宽 22.8m→17.8m,断面变为中央绿化带 + 双向各 2 车道 + 路缘石;margin 2.65→0.15,退距与补楼避让同步收窄 2.5m。
- 补像素级验收:贴图渲成 PNG,取中间一行做横向游程,按最近调色板色名合成长度,与断面规格对账。
- 判据:不得出现连续 ≥0.3m 的硬路肩段——肩色与沥青色只差 (7,7,8),按像素判会误检出 0.1m 假路肩。
坑:楼一旦允许旋转,所有拿包围盒当「重叠」的判定都失效了
- 改完朝向补楼从 656 掉到 582 栋,掉的一成在碰撞判定而不在朝向。
- 根因:AABB 会把旋转楼撑大,50×12 板楼转 30° 后包围盒变 49×35,相邻排净距 28m 直接咬住。
- 改 AABB 粗筛 + SAT 细判:凸四边形做精确 SAT,凹多边形退回 AABB,外扩 4m 用候选矩形沿自身两轴放大,只多否不漏放。
- 结果 582→673 栋,与旧行为只差 3 栋(-0.4%)。
- 回归脚本同步换严格多边形重叠,并报「盒子相交但实体分离」对数与最近距离;阈值先量真实 OSM 再定。
补楼朝向改成「跟着道路走」,平均平行度 20.3° → 9.5°
- 旧实现给每小区固定正南北 ±8° 偏角,而延庆路网主轴实测有 0.8°、11°、20.6°、50.9°、61.1°、98.9°、117~120° 多个方向。
- 新做法 voteRoadAxis:取外扩 180m 路段按等级权重 ÷(40+距离) 加权,在轴向角上 2° 分档投票定主轴,±10° 内圆均值精修,正交轴权重更高则翻 90°,末加 ±4° 抖动。
- 必须投票而非直接圆均值:网格城市双向路权重接近,角度翻倍后合矢量趋零,均值会退化成 45°。
- 实测平行度均值 20.28°→9.51°,中位 2.06°,≤5° 占比 19.4%→78.8%;300m 口径均值 1.33°、≤5° 占 96.0%。
立面复盘:技术上全对但不美 —— 三层诊断后收窄到纯色
- 第一版贴图进引擎是「整齐但缺美感」,HSL 量化后归因:贴图 60%、光照 25%、几何 15%。
- 贴图层:6 套住宅墙色全挤在暖米色(H20~45°、L59~85),1188 栋里 1182 栋住宅糊成一片米黄。
- 光照层:代码创建的 MeshRenderer 默认不投也不接阴影;几何层:全是方盒,无女儿墙与屋顶设备。
- 三处都改后按反馈再收窄:贴图默认关闭、屋顶设备去掉、只留女儿墙;纯色仍按小区 id 取色,保持同小区同色。
- 贴图管线完整保留,配置一个开关可切回。
建筑外立面:程序化贴图 + 小区归组
- 目标:同小区共用一套立面,不同小区各自随机,不引入任何图片资源。
- 6 类建筑语言(住宅/公寓/办公/商业/公共/工业),每类 3~6 套,共 21 张 256px POT 方图(mipmap + REPEAT)。
- 尺度对齐:开间 = 层高 = 3.2m,一张贴图覆盖 6.4m;UV 取 u=开间数×0.5、v=层数×0.5 并取整,否则楼顶切半截窗。
- 小区归组三级兜底:高德 AOI 圆 → OSM landuse=residential → 200m 网格,方案号由 (小区ID, 样式) 哈希决定。
- 渲染按 (样式, 方案) 分桶合并,1188 栋楼 DrawCall 从 1188 降到 19。
道路宽度审计脚本修正 + 建筑补齐
- 部分道路宽度与真实值偏差明显。
- 写审计脚本逐条比对并修正。
- 同时补齐缺失的建筑体块。
2026-09-25
AI 分析链路定稿
- 链路定稿:App → photo.filebreeze.cn/api/v1 → DeepSeek,App 不直连大模型。
- 真实 Key 只留服务端,App 侧只持令牌。
- 服务端加每日额度硬上限与单 IP 限流。
- 返回分类、价值评分与删除理由,供用户决定删不删。
五端构建全部通过
- macOS / Windows / Android / iOS / Web 五端构建验证通过。
- 相册权限封装完成。
- 文件选择器封装完成。
涂鸦授权完成,固件可正常烧录
- 完成涂鸦授权配置。
- COM4 烧录链路稳定。
- DuckyClaw v1.1.0 固件写入正常。
2026-09-24
口型与 TTS 联动修复
- 停顿时口型仍在动,视觉上很假。
- 改为按 TTS 音频包驱动口型。
- 结合静音段判定,停顿即闭嘴。
Windows 端唤醒与识别串联
- Windows 端用 sherpa-onnx 做 KWS,唤醒词「花间向导」。
- 接豆包 ASR,静音窗口 800ms。
- 再接火山 TTS 与 LLM。
运行时串口无输出
- 烧录成功但串口一片安静。
- 按先排除再怀疑的顺序查。
- 波特率、时钟配置、日志级别逐项收敛。
2026-09-23
朗读音频托管落地:自定义域名实测与微信的配置约束
- 音频改静态托管:站点落 (服务器路径),音频目录 /tts/audio/{hash}.mp3。
- 实测 HTTPS 200、Content-Type: audio/mpeg、支持 Range(206),Let's Encrypt 由 certbot.timer 自动续期,TLS 1.2/1.3 正常。
- 服务器是腾讯云轻量北京地域,域名必须 ICP 备案。
- 微信约束:必须 HTTPS + 已备案,不能用 IP 与非默认端口,每类上限 20 个、每月只能改 5 次;本项目占两类共 3 个域名。
- 风险:轻量套餐有月流量包上限,超额断网时回退在线合成兜底。
修复「朗读全文失败」:两个根因叠加,都不是网络问题
- 真机点朗读一律弹「合成失败,请检查网络」,但网络与域名都正常,提示本身在误导排查。
- 根因一:《论语》补全 20 篇后段落 hash 全变,未重跑预合成,25 段一个都不在服务器。
- 根因二:百度长文本合成音频落在 aipe-speech.bj.bcebos.com,tsn.baidu.com 是短文本接口地址,填错被 wx.downloadFile 拦截。
- 修复:按 hash 判存只补 25 段,耗时 1 分 43 秒,覆盖率回到 100%(需 57 段、缺 0)。
- 新增 hostOf/reportError,域名类错误直接提示「音频域名未配置」并附主机名。
踩坑:icon 裁剪为什么「按卡片裁」是错的
- 坑 1:不能按卡片裁,要按内圆圆心 ± 半径裁,否则微信圆形裁切后露出米白纸底与云纹残线。
- 坑 2:粗检圆心偏 14px(被云纹细线打断),改两遍裁切:180 条射线测边界 + 最小二乘拟合圆,四边留白 7/7/8/6。
- 坑 3:微信圆角矩形展示会露四角纸底,按径向取半径 −14px 处颜色补角,最外 5 圈 20480 像素里米白 0 个。
- 验证手法:取橙色朝日质心相对圆心的归一化坐标,两版 dx=−0.194 完全一致。
icon 三轮迭代,最后定稿的是用户自己画的那一版
- icon 三轮迭代,最终定稿的是用户自己用豆包 AI 画的那一版。
- 第一轮图形 + 四字被否,小尺寸必糊;第二轮改日月符号 4 套,推荐日月合璧;第三轮按幼学启蒙重做 5 套,128/96/64/48px 实测,竹叶在 64px 以下糊成一团判不合格。
- 定稿为深青圆 + 金边,内含竹简卷轴、书卷、朝日、白月、云纹与朱砂篆印;5 套全部归档 design/icon/archive_yixiang/。
- 写了可复现裁剪脚本 design/crop_icon.py,输出符合规范的 1024×1024 成品。
定位澄清与命名定稿:从「画山别墅里的国学世界」到「朝夕国学」
- 核对注册状态发现小程序一直没在公众平台注册,本地 AppID 是早期占位值,且被 git skip-worktree 保护,状态看起来一直干净。
- 微信命名硬规则:4-30 字符(汉字算 2)、全平台唯一、不能单一通用词、禁用保留字,个人主体每年只能改 2 次。
- 定位从「国学书房」纠正为幼学启蒙,面向童蒙,名字、文案、视觉全跟着改。
- 定名「朝夕国学」,微信名称校验已通过。
项目交付使用
- 竞标接单、支付订阅完成。
- 扫码签到、私教预约完成。
- 已交付上线。
2026-09-22
架构取舍:朗读音频走静态托管,不走后端转发
- 定架构:朗读音频走静态托管,不走后端转发,产物 {hash}.mp3 按段名直取,无需接口与鉴权。
- 用自有的 guoxue.filebreeze.cn,nginx 直接发文件,用户听音频链路上没有应用进程。
- 代价是要在微信后台配 downloadFile 白名单,换来后端挂了音频照常能听。
- 命名用内容 hash 而非序号,缓存可跨书复用、改正文不错位,代价是旧音频变孤儿。
Android ASR 改为双向流式
- 原非流式识别要等整句说完才出字,改为双向流式:裸 PCM 边录边发,静音自动判停。
- 语音链路:百度唤醒 → 豆包 ASR 双向流式 → LLM → 火山 TTS 双向流式。
- TTS 与 ASR 均换成 WebSocket 长连接,首字延迟明显下降。
users 表补 uk_phone 唯一索引
- 同一手机号被重复建档,导致会员课时对不上。
- users 表补 uk_phone 唯一索引。
- 重复注册被拦在写入前。
2026-09-21
添加流程端口知识硬编码 6 处 → 收敛为一表
- 内网萤石设备添加失败:端口知识硬编码只认 2020(散落 6 处),该设备 ONVIF 在 8888。
- 设备侧另有一问题:RTSP 逐步全 200 但 8 秒收 0 个 RTP 包,同时刻三台 TP-Link 正常送流(1501/719/171 包)。
- 新增 PortScanner.portHints 表统一端口→ONVIF 路径→厂商→RTSP 默认路径,扫端口、拼地址、给默认路径三处共用。
- 修两处假成功:test() 握手后等首个 RTP 包 6 秒,超时如实报「设备接受了会话但没送流」。
- 固化 scripts/rtsp_diagnose.py 与自测钩子;权威判据只有数 RTP 包,且须同时测一台正常设备对照。
左侧列表布局改造:自绘分栏 + 像素级快照验证
- 左侧列表突兀:NavigationSplitView 侧栏在 macOS 上会向上与标题栏融合,是系统行为不是 bug。
- 改自绘 HStack:sidebar | 6px 拖拽手柄 | detailContent,内容自然落在标题栏之下。
- 补回侧栏开关按钮与 200–320 宽度拖拽;全屏收起用 sidebarVisible = showSidebar && !isFullScreen,不写回原状态。
- 新增 UI 快照自测 NVR_UI_SHOT=1,无录屏权限时用 CALayer.render 在进程内绘制,须渲染 contentView.superview 且不翻转 y 轴。
- 像素扫描断言:侧栏 0–246、内容区 246→1148、标题栏高 52px 横跨全宽。
项目交付使用
- 场地预约、精品套餐、接单台全部就绪。
- TT Lock 门禁对接完成。
- 已正式交付给客户使用。
2026-09-20
AI 画面筛选与大模型节流方案:月成本从 ¥2100 压到 ¥7
- 方案:本地离线筛图,只把有价值画面送 DeepSeek,目标是省积分。
- 选型(M1/8GB):macOS Vision 9 项能力全可用(指纹 7.1ms、美学 7.3ms、光流 14.5ms),OpenCV 帧差 0.24ms;不引入 PyTorch/YOLO。
- 手写逐像素帧差 320×180 要 8.55ms,换 vDSP 后 0.264ms。
- 关键:省积分靠少发请求,DeepSeek 固定 384 tokens/张,每次请求都重复付 prompt 开销;事件驱动 ≈¥7/月,每 10 秒一帧 ≈¥2100/月。
- 坑:美学分不能做门禁(监控画面天然不美,最低 −0.38),基准须预热(光流冷启 16.6s → 稳态 14.5ms)。
事件为 0 是设备侧配置问题(三重验证),客户端无解
- 四台 TP-Link TL-IPC44K-4 能力一致:PTZ 可用、Events 声明 6 类主题(CellMotion/Motion、Tamper、Intrusion、LineCross、People、TPSmartEvent)。
- 但零事件,三重验证指向设备侧配置:150s 长监听 0 条;转云台造画面位移仍 0 条;GetRules 返回空规则表、GetVideoAnalyticsConfigurations 返回 HTTP 500。
- 结论:移动侦测/智能事件须在 TP-Link 客户端或 Web 手动开启,客户端侧已做对。
- 「声明支持」≠「真能用」,云台必须用位移差判定,不能只看请求被接受。
- 变焦无法用位置复核(Zoom.x 恒为 0),只能写「请求被接受」,不可写已验证通过。
云台控制 + 事件订阅落地(6 个坑逐一攻克)
- 交付:能力探测落盘、云台 8 方向按住即动/松开即停 + 变焦 + 复位 + 预置位、事件 PullPoint 订阅 + 去重 + 未读徽标。
- 坑:WSSecurity 注入命中 XML 声明结尾生成双根元素(设备回 200 但没带凭据);XMLParser 不处理命名空间导致元素名静默失配;PTZ 请求返回空响应体。
- 坑:订阅 8s 超时(设备 PT10S,改 20s);松开云台报 cancelled(改 detached 调 Stop);预置位 300 条空槽过滤后剩 3 条。
- 安全:设备侧 PT3S 保护窗 + 客户端 2.5s 续期 + 看门狗 25s 上限。
- 验证:订阅中断 115 次降至 150s 内 0 次,云台 Δpan=0.1914、复位 0.0000。
全屏「只剩画面」:SwiftUI 重排覆盖 + 延迟重压三次
- 全屏能进但顶部仍见工具栏。两层根因:.toolbar 只清空按钮、NSToolbar 仍挂窗口;didEnterFullScreen 里设 isVisible=false 被 SwiftUI 重排覆盖。
- 日志实测:进入时仍显示、1s 后已隐藏 —— 是滞后不是无效。
- 修复:.toolbar(isFullScreen ? .hidden : .visible) + 同步 toolbar/titlebar + 0.1/0.4/1.0 秒延迟重压三次(幂等)。
- 新增 windowDiagnostics,一行输出工具栏/标题栏/菜单栏/Dock 状态。
- 残留:鼠标移到屏幕顶部菜单栏仍会滑出,系统会重置 presentationOptions,确认不影响。
全屏闪退根因:presentationOptions 互斥约束违反即 abort
- 现象:一全屏就退出,4 份 .ips 崩溃日志全落在 FullScreenController.applyImmersive,SIGABRT。
- 根因:NSApp.presentationOptions 有硬性互斥约束,违反即抛 NSInvalidArgumentException,Swift 无法 catch 直接 abort。
- 逐 mask 验证:唯一合法组合是 [.hideDock, .hideMenuBar];新增赋值前逐条校验,非法则记日志降级。
- captureAppearance 统一快照,自建按钮与系统绿钮两条路径都能还原。
- 验证:app 内自测钩子直接调崩溃函数体触发。
最大教训:客户端多实例堆积把自己的摄像头打满
- osascript quit 静默失败,open -n 每轮开新实例,4 轮后 4 个实例并行,每台摄像头挂 2~4 条 RTSP 会话,打满 TP-Link 并发上限。
- 假象连串:首帧等 42 秒、对端关闭连接、退避重试 4 次全失败、ffprobe/ffmpeg 也拉不到流。
- 正确流程:killall → 确认实例数 0、554 连接归零 → 等 15~25s 让设备回收会话 → 只启一个实例,已固化为 scripts/run-app.sh。
- 诊断命令 pgrep -x NVRStation | wc -l,必须为 1。
- 教训:调试客户端前先确认实例数,多实例会自己打爆自己并制造假故障。
凭据泄漏修复:明文密码进了 devices.json 与 nvr.log
- 取证:nvr.log 出现 rtsp://admin:<明文>@IP 的 SETUP 记录,devices.json 中三台 rtspURL 仍内嵌明文凭据。
- 上轮凭据剥离只对新保存设备生效,存量未清洗,等于没修。
- 新增 Log/Redaction.swift 覆盖全部日志点;DeviceStore.load() 加 migrateEmbeddedCredentials() 存量迁移,改写前自动备份。
- 验证:地址字段 0 个 @,日志明文密码出现 0 次,脱敏单测 5/5 通过,4 台设备认证正常。
- 教训:安全修复必须覆盖存量数据,「只对新增生效」是假修复。
添加摄像头三个叠加缺陷:无编辑入口 / 黑屏无提示 / 列表静默截断
- 从扫描结果添加设备后找不到输账号密码的地方,画面不出,devices.json 里凭据全空。
- 三缺陷叠加:无编辑入口;ONVIF 取流失败纯黑无提示,状态停在 .idle;画面 prefix 截断,新设备排末尾看不到。
- 修复:AddDeviceView 编辑模式 + 独立「认证」Section;右键、状态栏、失败浮层三处加入口;新增 reportFailure 推进 .failed。
- 监控改按页切片 + 翻页,新设备自动跳末页;指纹变更自动重连,RTSP 401/403/404 文案语义化。
- 验证:4 台设备全部出画面。
P1 互动学习:《论语》20 篇补全 + 国学小测 + 成就徽章
- 《论语》20 篇原文补全,新增 data/lunyu.js 共 20364 字,由 merge-lunyu.js 内联进 classics.js。
- 国学小测 3 套各 8 题,记录最高分;成就徽章 8 枚,书架页展示解锁状态。
- 每日推送跳过,依赖后端模板与定时任务。
- 坑:WXML 不支持字符串索引,改显式 icon 字段;数据文件带 function 会让预览脚本 json.loads 失败。
- 遗留:正文改动使段落 hash 变化,论语音频须重跑预合成脚本重传。
P0 留存与传播闭环:打卡 / 书架 / 金句海报 / 跟读
- 落地 5 个纯前端功能:阅读进度 + 收藏、我的书架、每日打卡 streak、金句海报、跟读练习,均不依赖后端。
- 书架因 tabBar 已满 5 个,做成非 tab 页 + 首页入口卡片;跟读只做本地回听,打分刻意不做。
- 新增 utils/store.js 统一封装存储,key 加 guoxue_ 前缀,书目用 type:id 复合键,避免经典与蒙学 id 重复串数据。
- 坑:海报 Canvas 2D 必须在 onReady 绘制,onLoad 时节点未渲染拿不到实例,画出来是空白。
P2P Socket 协议栈打通
- 自研 P2P 协议栈完成握手。
- 数据帧收发打通。
- 同类设备可不经中转直接传文件。
navigation-bar 返回逻辑 + Skyline 兼容
- 现象:部分机型返回后页面状态错乱。
- 返回逻辑改为按层级判断目标页。
- 同时处理 Skyline 渲染器下的样式差异。
2026-09-19
今日卡片左滑即可编辑 / 删除,错字当场改
- 今日卡片左滑露出「编辑」「删除」两个操作。
- 编辑可改时间、事件、地点三项。
- 删除带二次确认,避免误触。
- 手动记录走云端接口,自动记录改本地库,两条链路分别落地。
轨迹采集加入重力 + 陀螺仪静止判定,抑制 GPS 漂移
- 起因:手机放桌上不动,定位仍每分钟漂移,轨迹被拉成一小团。
- 用加速度计与陀螺仪判定动/静,静止时锁当前位置为锚点,漂移点不落库,心跳点落在锚点。
- 漂移阈值随定位精度浮动,精度差时自动放宽,避免误判。
- 加速度基线缓慢自适应,兼容机型传感器标定与摆放姿态差异。
- 效果:静止时段轨迹钉在一点,起身走动几秒内切回正常记录。
个人中心页按设计稿还原
- 头部改渐变头像 + 「已连续记录 N 天」,天数按最早一条轨迹真实计算,无数据时显示「开始记录你的每一天」。
- 三组功能卡片:数据同步/本地备份/识别灵敏度;数据与隐私/导出我的数据/大字号模式;关于与版本。
- 设置入口并入卡片,不再单列按钮。
- 版本号动态读构建号,避免界面写死。
首版提交:自动记录与时间线主干跑通
- 从零打通主干:后台定位服务持续采集轨迹点,记录存手机本地。
- 时间线按天聚合展示,自动区分「停留」与「移动」。
- 产品方向:面向中老年用户,无感记录、不用手动打卡。
- 版本 v1.5.0。
macOS 本地网络权限反复弹窗根治(稳定自签名证书)
- 每次启动弹「是否允许查找附近的设备」,签名 adhoc、Info.plist 未绑定。
- 根因:无稳定签名身份,重建后 cdhash 变,被当新应用;macOS 14+ 按签名标识记授权。
- 解法:openssl 自签名证书(codeSigning)+ codesign 固定 identifier。
- 坑:系统 security 不认 OpenSSL 3.x 默认 PKCS#12,须用 openssl -legacy 导出。
- 固化:幂等 setup-signing.sh,打包后自动签名。
自动探测三通道实测:组播与单播 0 台,只有端口扫描有效
- 5 台设备实测三通道:WS-Discovery 组播 0 台、单播 0 台、端口扫描 5/5 为唯一有效通道。
- 附测 mDNS _rtsp._tcp / _onvif._tcp 无结果;组播通道保留,备将来换到支持 ONVIF 组播的网络。
- 坑:重写组播漏设 SO_RCVTIMEO,recv 全阻塞、超时判断失效,该通道卡 13.9s 而非 3s;修复后总耗时 22.5s → 11.8s。
- 启动自动探测默认 skipExisting: true,避免与已接入设备抢 RTSP 会话导致画面中断。
拉流失败自动重试:2/4/8/8 退避 + generation 代次号
- 问题:pkill 后 2 秒内重启,上一 RTSP 会话未释放,三台摄像头首连 socket 全失败并永久黑屏。
- 实现失败重试最多 4 次,退避 2/4/8/8 秒;generation 代次号让旧回调与待执行重试失效,pendingRetry 防双重调度。
- 连接成功(.playing)重置 retryCount,后续断线重新获得完整重试机会。
- 验证:故意 pkill 后等 2 秒重启,socket 失败 3 次 → 2 秒后第 1/4 次重试 → 三路播放就绪,黑屏自愈。
可观测性建设:实时日志面板 + 落盘 + 沉浸式全屏
- 需求:排查画面不能靠 print,界面要有实时日志面板。
- LogCenter 单例,NSLock + 串行队列,带级别/时间戳/category,缓存 2000 条。
- LogView 支持级别与关键词过滤 + 自动滚动,sheet 弹出不占画面。
- 每条日志同步写 app 数据目录 nvr.log,可直接 cat,成了排障入口。
- 全屏:隐藏标题 + fullSizeContentView,ESC 退出,侧栏切 detailOnly,控制条 3 秒淡出。
扫描能力修复:poll 循环 + SO_ERROR 判据 + 并发度硬约束 → 5/5
- 5 台只扫出 3 台、耗时 20.4 秒,写了 5 个版本逐一验证。
- poll 必须循环到超时,单次 poll 会漏掉握手中的连接(v3/v4 命中 0)。
- 判定要 revents != 0 且 SO_ERROR == 0,未完成握手时 SO_ERROR 同为 0。
- 并发是硬约束:30 台并发只命中 2/5,批次降到 10 才 5/5。
- 终态:ARP 预筛 254→约 28 台 + 探 554/批次 10/超时 2.5s + 补 2020、8000、8888,两轮 5/5,8~9 秒。
黑屏真正原因:渲染层 frame 零尺寸(拉流解码全通)
- 日志证据:首帧已送入显示层(bounds=0×0),拉流解码全通,问题在渲染层尺寸为零。
- 旧 View 两 bug:makeNSView 用空 CALayer 覆盖原 layer;layer.frame 未随 bounds 更新。
- 修法:新建 SampleBufferContainerView 重写 layout(),布局时同步 frame。
- 修复后 bounds=326×300,画面出来。
- 降噪:status=1 正常,isReadyForMoreMediaData 短暂 false 是背压。
黑屏三大叠加 Bug:sin_len / control 路径 / PLAY Range 头
- Bug 1:sockaddr_in 未设 sin_len,macOS 下 connect 直接失败。
- Bug 2:SETUP 的 control 路径丢前缀,track1 应为 /stream1/track1。
- Bug 3:PLAY 缺 Range 头且 Session 带 ;timeout=15,报 400。
- 修完 OPTIONS→DESCRIBE 401→200→SETUP→PLAY 全 200,RTP 帧持续流入。
- 经验:TP-Link 的 RTSP 交互与 ffmpeg 一致。
RTSP 客户端从未实现认证:补 Basic/Digest 自动识别
- 缺陷:connect() 的 OPTIONS→DESCRIBE→SETUP→PLAY 全程不发 Authorization,TP-Link 要密码,DESCRIBE 直接 401。
- 认证方式也误判:实测是 Basic,不是 Digest。
- 补 AuthScheme + buildAuthorization(Basic=base64 / Digest=MD5)+ 401 重试。
- 验证:无密码/错密码 401,正确密码 200;SDP 为 H265,2560×1440@15fps。
设备厂商判定修正:74:39:89 是 TP-Link 而非海康
- 74:39:89 曾按 OUI 判为海康(ONVIF 响应带 hikwsd 命名空间),实测推翻。
- GetDeviceInformation 显示 TP-Link TL-IPC44K-4,固件 1.0.13,74:39:89 是 TP-Link 的 OUI。
- hikwsd 只是兼容海康扩展协议的痕迹,不能当厂商判据。
- .21 的 9c:a3:a9 才是真海康 OUI(萤石为其消费品牌)。
- 结论:厂商以 GetDeviceInformation 为准。
ZLMediaKit 两个阻断性 Bug:MediaServer 未编入 all + enable_rtmp=0
- Bug 1:镜像缺 MediaServer,make 只构建 all 而它带 EXCLUDE_FROM_ALL;改 make MediaServer 并校验产物。
- Bug 2:AddStreamProxy 传 enable_rtmp=0,.live.flv 依赖 rtmp,播放 000;改 1 后 200。
- 附带:gateway 容器是 8/21 旧镜像,不含新拉流路由,需重建。
- 端到端:ffmpeg 推流→注册五协议→stream/start 拉流,FLV/HLS/fmp4 全可播。
云函数 initCheckIn / fixSchema 配置完成
- 部署扫码签到依赖的云函数 initCheckIn / fixSchema。
- 同时修正表结构。
- 目的:避免首次签到写库失败。
2026-09-18
踩坑:SSL 证书到期导致全线不可用(未配置自动续期)
- 09-18 早小程序接口全报错,HTTPS 握手失败,证书 09-17 08:34 GMT 已到期。
- 根因:部署时手动签发,服务器从未配自动续期,无 certbot.timer 也无 crontab。
- certbot renew --nginx 手动续期,新证书至 2026-12-17。
- 新建 certbot-renew.service + .timer,每天 00:00 与 12:00 跑,Persistent=true。
- 遗留:certbot 1.23 基于 Python 3.6,待升级。
云环境迁移 lovely-pet + MySQL 库归一
- 原云环境到期,切新环境,24 个云函数全量部署 0 失败。
- 13 个 MySQL 函数绑 VPC/子网,超时 3s 提到 20/30/60s;坑:IDE CLI 部署不带 VPC,须走 tcb fn deploy --force。
- MySQL 归一:17 张表迁入默认库,13 个函数 database 字段同步改指。
- 种子数据 6 张表入库,端到端验证全 code:0。
- 遗留:game-ws-server 未部署,pet-game.js 写死 wss://localhost。
Android TV 客户端构建成功(APK 15MB)
- app-debug.apk 15MB,包名 com.yueju.nvrtv。
- 栈:Kotlin 2.0 + Compose for TV + Media3 ExoPlayer 1.4.1。
- AGP 8.6.0 + Gradle 8.7 + Kotlin 2.0.20(compileSdk 35)。
- 排坑:gradle 8.9 下载 15 分钟仅 23MB;代理干扰 maven;无输入框改 BasicTextField。
- 播放走 HLS,导航 D-pad + LEANBACK_LAUNCHER。
原生 macOS 客户端首版:ONVIF + RTSP + VideoToolbox 硬解
- ONVIF 栈:WSSecurity + SOAPClient + WSDiscovery(UDP 3702)。
- RTSP 栈:SDP/RTP 解析 + NAL 拆包(H264 FU-A、H265 FU)+ BSD socket。
- 端到端:握手→解包→重建→H.264 硬解,123~124 帧成功。
- 坑:CFStream runloop 调度失效卡死,改 BSD socket 同步 recv。
- 教训:-12909 非代码 bug,是 profile 66 不被 VideoToolbox 兼容。
客户端形态选型:放弃 Electron/Tauri,改原生 SwiftUI
- 本机无 Rust(rustc/cargo 均无),Xcode 完整版已装,Swift 6.3,target arm64-apple-macosx26。
- 三条路径:Electron 与原生 SwiftUI 可立即做,Tauri 需先装工具链。
- 定调原生 SwiftUI + SPM,首期支持 ONVIF + RTSP 两种协议。
- 战略价值:可直连 RTSP + VideoToolbox 硬解,绕开媒体服务转协议那一跳,单路延迟与服务器 CPU 成本更优。
Web 端打通真实拉流:前端从未调用 startStream
- 根因:网关早有 stream/start,前端从未调用,播放器直接拼 /live/cam_{id}.flv 播不存在的流。
- 修:camera.ts 加 startStream/stopStream,play() 先 await 成功再启 flv/hls/webrtc,失败报错。
- 硬约束:flv.js 不支持 H.265,种子数据 3 路就是 H.265。
- 判断:浏览器不能直连 RTSP,须媒体服务转协议,多一跳延迟与 CPU 成本。
盘点发现「UI 层高于数据层」:4 个页面仍是硬编码 mock
- 当时只有登录页接通后端(JWT),MainPage / FourGridPage / PlaybackPage / EventsPage 仍硬编码设备数组。
- groupId 直接序列化成 {Int64:0, Valid:false},泄漏 Go 内部结构。
- 截图用 playwright-core 复用 Chromium,访问 localhost 须加 --noproxy '*',否则代理 502。
- 归档 docs/ui-preview/ 九页截图作改造前基线。
cameras 表为空:init-db.sql 的种子数据从未执行
- 现象:/api/cameras 返回空数组、stats 全 0,前端列表却显示 5/6 在线(那是硬编码 mock)。
- 根因:官方 PG 镜像的 initdb.d 只在数据目录为空时执行,种子 INSERT 是后期追加的,pg_data 早已初始化。
- 手动 psql 导入 6 路,验证 stats = total 6 / online 5 / recording 4 / offline 1。
- 教训:改 init-db.sql 不会自动生效,需 down -v 重建数据卷或手工补齐。
从 Unity 迁移到 Cocos Creator
- Unity Editor 在本机装不上(拿不到管理员权限),整体迁到 Cocos Creator 3.8.8 + TypeScript。
- 资产不受影响:路网仍由 OSM 数据生成,地面仍走瓦片。
- 构建更轻,命令行出包顺畅。
修复精品套餐支付调起失败
- 用户反馈点套餐下单没反应,定位到详情页缺购买按钮,补上后微信支付正常调起。
- 顺带复验支付回调与订单状态回写。
- 已发版。
2026-09-16
7 个页面设计定稿
- 7 个页面设计定稿:登录 / 设置 / 单摄像头 / 四宫格 / 回放 / 事件页 / 主面板。
- 统一暗色优先。
- 下一阶段进入代码落地。
2026-09-13
项目建仓:把国学做成「可读可听」的内容型小程序
- 一天完成建仓,定架构:零后端、零云开发、零数据库,数据层为静态 JS 模块,首屏零网络请求。
- 内容资产:12 部经典 + 6 部蒙学 + 名人故事 + 读书方法 + 每日一言,全文可读。
- 朗读 TTS 三级降级:本地缓存→服务器预置音频→在线合成,预合成产物不入库,托管自有域名。
- 写 README 固化目录结构与域名清单,本地工具目录加忽略。
- 不做后端的理由:无用户体系与 UGC,进度/收藏/打卡走本地存储;后端只留给每日提醒,等真要做再开。
2026-09-04
批量新增 13 篇文章(→37 篇)并修复 SEO 同步脚本
- 批量新增 12 篇公众号文章到官网:会议/养老/灯光/宠物/采暖/导购/门锁/民宿/离家/避坑/儿童房/排队。
- 另新增「AI 智慧红绿灯」行业洞察文,文章总数达 37 篇。
- 修 sync-seo 脚本漏同步 sitemap / llms.txt 的问题,站点地图扩到 68 条 URL。
资讯分类体系重构:从发布者视角改为读者视角
- 资讯分类从公司动态/技术分享/行业洞察重写为五大主题:全屋智能/智慧商业/客户案例/适老关怀/AI应用,36 篇全量重分类。
- 改因:旧三档按发布者视角分,读者不关心;新五档按客户关注点分,筛选才有意义。
- 补上 NewsDetail 的分类映射,原先列表改了详情页会显示空标签。
2026-08-21
Phase 3 LLM 集成:混元 API + Function Calling
- llm_client.py:OpenAI 兼容客户端,默认混元 v1,Bearer 鉴权 + 429 重试。
- search 用 LLM 解析意图为 JSON,无 Key 降级关键词(昨天下午红色车辆→time/object/attr)。
- chat 四个工具:switch_camera / playback / export_clip / query_events。
- 配置走 LLM_ENDPOINT 等环境变量,密钥不入库。
Docker 环境落地(colima)+ C++ ZLMediaKit 编译通过
- 无 Docker Desktop,改用 colima 0.10.3 + lima 2.2.0。
- 镜像加速配 DaoCloud;坑:colima 键名须复数 registry-mirrors。
- 代理失效:宿主 HTTP_PROXY 被映射成无效端口,env -u 后重启解决。
- C++ 关掉 x264/x265/faac/mp4v2,构建到 100%,五种编解码器加载成功。
- compose 全 healthy,真实 PG 登录端到端打通。
后端从 Mock 演进为可运行实现
- 新增 store/ 数据层:db.go(PG 连接+内存降级)、model.go、camera/event/recording 三 repository。
- 库不可用自动回退内存 mock,前端始终可跑。
- handler 层三模块改真实查库。
- WebSocket 用 Hub 广播+订阅 channel 过滤,复用 event/metric/detection/chat/recording。
- 选 database/sql + lib/pq,不引 ORM。
2026-08-20
踩坑:竞价可见性必须按联系人隔离,不能只按公司
- 山东中航联系人李晓(487)能看到同事王(385)受邀的 4 个竞价,邀请查询只按 supplier_id 过滤、没按 contact_id。
- 4 处 SQL 补上 (contact_id IS NULL OR contact_id = ?),覆盖 portal 与 bidding 的列表/详情/出价。
- placeBid 原本没做邀请校验,顺手补上,避免知道竞价 ID 就能出价。
- 兼容早期邀请:contact_id 为 NULL 的记录仍可见。
2026-08-19
新增「夏季空调节能」文章(→23 篇)
- 新增官网文章「夏天电费两千多,可能一半都花在了空房间的空调上」(summer-energy-saving)。
- 文章总数达 23 篇。
- 选题从「我是做什么的」转向「客户关心什么」,更贴搜索意图。
2026-08-18
批量同步 5 篇公众号文章到官网(→22 篇)
- 批量同步 5 篇公众号文章到官网:智能家居刚需 / 你几点回家 / 适老化改造 / 智慧讲解员 / 暴雨防汛。
- 文章总数达 22 篇。
- 内容策略定为公众号负责触达、官网负责沉淀与搜索收录,同一篇两处分发。
2026-08-07
社交裂变部署:CLI 凭证过期 + 命令格式变更踩坑
- tcb CLI 临时凭证约 26 天前过期,login 报密钥校验失败,需重新 device flow 授权。
- 部署后 NoSQL 短暂隔离报 env status is isolated,约 10 分钟自恢复。
- nosql execute 命令格式变更,旧 Values 格式报错,改用 Command 字段包 mongo 语法。
- 冒烟 6 项全通过;fn invoke 无真实 OPENID,依赖 openid 的 action 留待真机验证。
2026-08-05
状态机收尾:定时任务覆盖四态 + 拆开「存储状态」与「计算状态」的职责
- 状态归属改三轮定稿:定时任务三条顺序执行,覆盖待开标(4)/已结束(2)/开标中(3)。
- 去掉 STATUS_SQL 里的 AND status != 2,计算状态只认时间,人工干预交给 status 字段。
- 补上 cron 自动切换时的操作日志;架构文档写明 status 为对外真实状态、computed_status 为纯时间推导值。
- 顺带修状态切换弹窗每秒重复弹(timer 缺 fired 标志),toast 从 alert 换成 3 秒自动消失。
2026-07-29
管理端文件下载改用 openDocument(showMenu) + 区分预览与下载
- 小程序「下载招标文件」只能预览存不下来,根因是 wx.openDocument 不带菜单入口。
- 改 showMenu:true,右上角「…」可转发、可保存到本地。
- 按客户要求拆成两个按钮:预览=纯查看,下载=打开+弹保存菜单。
- 版本号只在左下角显示,footer 技术支持处去掉版本号。
2026-07-26
云养宠 P0/P1/P2 社交裂变玩法
- 出社交裂变策略报告,K 因子目标 1.05,设计 6 大玩法。
- P0:对战邀请卡(分享挑战 + 应战)+ 出生报喜卡(分享喜讯 + 见面礼)。
- P1:3 人拼团领 30 金币、名片互换、排行榜宣战;P2:邀新双奖励各 50 金币 + 里程碑弹窗。
- commit be725f5:28 文件,+2956 行。
2026-07-18
列表状态实时计算 + 新增「待开标」状态 + 保存即发布
- 列表状态改用 getEffectiveStatus 按当前时间实时算,不再只信数据库 status 字段。
- 新增 status=4「待开标」,覆盖 end_time 到 opening_time 之间的窗口。
- 新建招标改保存即发布(create 默认 status 0→1),列表去掉发布按钮。
- 创建成功改 wx.redirectTo 回列表,避免停在表单重复提交。
2026-07-14
投标截止后封锁上传/删除:服务端 403 + 前端条件渲染双保险
- 截止后仍能上传甚至删标书,服务端 uploadDocument/deleteDocument 查 end_time 后直接返 403。
- 两接口小程序与 Web Portal 共用,改一处两边都盖住。
- 前端只做体验:详情算 isEnded,上传区与删除按钮条件渲染,截止后显示「投标已截止」。
- 坑:isEnded 用格式化字符串比大小导致按钮没隐藏,改用原始 UTC 时间戳。
招标四态流转 + 修复投标数量统计算重
- 招标状态从三态补到四态:0 草稿 / 1 已发布 / 2 已结束 / 3 开标中,到开标时间由 detail() 自动转开标中,另加「开标结束」按钮。
- 修统计 bug:后台显示 18 份标书实际 3 家投标,根因 tender_documents 缺 (tender_id, supplier_id) 唯一约束,重复上传堆记录。
- 三处修:上传前先删旧记录、统计改 COUNT(DISTINCT supplier_id)、补唯一索引并迁移清存量。
- 教训:计数 bug 先想清一个供应商应算几次。
2026-07-07
正式上线:客户投入生产使用(v2.1.1)
- 07-07 正式交付客户投产,从 06-19 立项算 18 天,小程序与 Web 后台均为 v2.1.1。
- 供应商端:邀请链接→验证→实时出价→投标;管理端小程序 + Web 双入口 8 模块。
- 上线前两天收口:开标时间不下发 file_url、文件选择坑链、中文文件名乱码、隐私合规只留 chooseMessageFile。
- 此后进运维阶段,不再算开发。
列表页时间从 UTC 原始串改为北京时间(新增字段漏格式化的坑)
- 首页与「我的」把开标时间显示成 UTC 原始串,因为只对 start_time/end_time 做了 fmtDate,后加的 opening_time 漏了。
- 两页补 fmtDate,wxml 增开标时间并用绿色区分,WXSS 加 .opening-text。
- 统一口径:所有时间按 YYYY-MM-DD HH:mm:ss 北京时间展示。
- 同类遗留:管理端统计页 end_time 至今没格式化,加时间字段应全局 grep 一遍 _time。
2026-07-06
踩坑:Web 端「上传按钮没反应」——Vue 静默吞掉 ReferenceError
- 招标详情弹窗点上传完全无反应,控制台也没报错,先怀疑文件选择和权限都排掉了。
- 根因:uploadFile()/save() 调的 token() 只在根 app setup 里定义,组件作用域没有,ReferenceError 被 Vue 3 静默吞掉。
- 修复:组件自己加 token() 读 localStorage 的 admin_token。
- 教训:Vue 里「点了没反应、无报错」先查模板/方法作用域。
开标时间到达自动刷新:15 秒轮询解锁投标文件
- 开标时间到页面不自动变,小程序与 Web 都加 15 秒轮询:canViewDocs 为 false 且有待开标时间才启,到点清定时器、刷新详情。
- 关键点:存原始 opening_time,fmtDate 转过的字符串不能比大小;onShow 补检、onUnload/onUnmounted 清定时器。
- 不改推送的理由:开标没有外部事件可挂,轮询只在未开标时启,开销一个详情接口。
- 遗留坑:定时器重复触发每秒弹 toast,07-18 补 fired 标志位才干净。
隐私合规改造:仅保留 chooseMessageFile(v2.1.1)
- 移除 chooseMedia/chooseImage/chooseVideo 全部调用,只保留 chooseMessageFile(从聊天记录选文件)。
- 新增隐私协议页,验证页 UI 压缩、竞价详情底部留白,版本升到 v2.1.1。
- 权衡:投标文件本来就走微信聊天记录传输,收窄权限换审核确定性。
踩坑:Web 端上传中文文件名乱码(Latin-1 误解码)
- Web 后台传文件后中文名变乱码,根因是 Content-Disposition 的 filename 按 Latin-1 解码 UTF-8 字节。
- 修复:服务端 Buffer.from(displayName,'latin1').toString('utf8') 重新解码。
- 供应商端早修过、管理端漏了,同一问题两个入口只补了一个,这次一并补齐。
踩坑:小程序文件选择与上传的一条完整坑链
- 选文件无反应,先疑隐私授权,加 requirePrivacyAuthorize 仍无效。
- 模拟器报栈溢出:chooseMessageFile 带 type 参数在基础库 3.16.1 触发微信 bug,去掉参数与授权壳仍无效。
- 正解改用 onNeedPrivacyAuthorization:未授权时弹自定义隐私弹窗,agree 按钮 resolve 放行原调用。
- 上传后文件名变 tmp_数字,改由客户端从 tempFilePath 拼 file_name,服务端多级探测扩展名;长名中间截断。
精品套餐统一改名「口碑好品」(含一次 revert 的教训)
- 6-29 的精品套餐页重构 + packageOrder 支持 RDB 当日 revert,改动面太大。
- 7-06 只做一件事:页面、列表、详情、云函数文案统一从「精品套餐」改为「口碑好品」。
- 改名理由:套餐本质是入驻企业互相带货,「口碑」比「精品」贴场景也不撞电商话术。
- 这是小程序最后一个开发提交,之后进交付验收。
2026-07-05
全站埋点系统 + 管理后台上线
- 上线全站埋点:页面级、区域级、滚动深度三档采集,写 trackAnalytics 云函数。
- 同期上管理后台:预约线索、用户管理、访问趋势看板(带 IP 归属地)。
- 接入百度统计,站点从只能看升级为能看到谁来过、留没留线索。
招标开标时间机制:未开标不下发文件地址
- tenders 表加 opening_time 字段并写迁移脚本,新建招标支持上传招标文件供供应商下载。
- detail() 按开标时间判 can_view_docs,未到点把 file_url 置 null,数据不下发而非前端隐藏。
- 管理端与小程序同步:未开标只显示文件名,下载按钮不出现。
- 结论:可见性靠后端控制,前端 v-if 能被直接看接口绕过。
2026-07-03
服务端原型 Day1:四级权限模型 + Storage Adapter 抽象层
- 抽 Storage Adapter:上层只调接口,底层可切本地或云端存储,三套硬件方案共用一套代码。
- 四级权限 用户→地域→部门→角色,一人可持多个地域-部门组合,权限独立可收回。
- Day1 建 8 张 SQLite 表,JWT 登录 + 权限中间件 + bcrypt,用户 CRUD、权限分配、审计日志可用。
- 前端 React 18 + Ant Design 5 + Vite 五页骨架,compose 一键部署;健康检测、登录、日志、地域列表联调通过。
2026-07-02
语音指令功能上线 + FAB 重构
- 70bedea 首页上线语音指令,FAB 重构为「铅笔 + 麦克风」双入口。
- 语音记录打通豆包 ASR + LLM 语义解析,一句话记喂养/睡眠/尿布。
- 7435d0e 修昵称输入框文字被裁(固定 height + line-height)。
- 产品定位由此转向「语音优先」。
2026-07-01
方案书交付:三套软硬件方案对比(本地 / 云端 / 混合)
- 按三地办公室 / 8 部门 / 6TB 存量 / 50-100 并发出软硬件方案书,一次给三套供选型。
- A 首选本地 NAS:群晖 4 盘位 + 4 块企业盘 RAID5,Docker 跑在 NAS 上,三地走 HTTPS + Tailscale。
- B 云端:10TB 对象存储 + 轻量服务器,零机房运维;C 混合:本地 RAID1 热数据 + 云端归档冷数据。
- 交付源码、部署文档、运维手册、API 文档与首年维保,输出 MD/HTML/PDF/DOCX 四版。
2026-06-30
新增高考志愿填报分析服务文章
- 新增公司动态文章:面向周边考生提供志愿填报分析报告服务。
- 发布后不久去掉「免费」表述,未再提价格。
- 结论:定价口径先定清楚再对外写,否则每改一次都是对外承诺变更。
2026-06-29
云养宠模块 5 Phase 全部完成
- 5 个 Phase 全部完成:新增 48 文件、7 云函数、8 前端页面、4 次提交。
- 领养互动 + AI 对话(人格引擎/打字机/TTS)+ 语音 ASR/TTS + 每日定时。
- 拔河大赛接 CloudRun WebSocket(房间管理、游戏循环、断线判负、心跳),另有社交拜访、消消乐、障碍跳跃赛。
- 进化系统 + 三榜排行 + 12 件装扮商店;Jest 29 六个 suite、61 个测试全通过。
CloudBase 环境打通 + 启动页
- a86fd2e 更新 CloudBase 环境 ID,37f46a8 修 @cloudbase/manager-node 需显式传 envId。
- 788e4de 去掉冗余 SCF_NAMESPACE 兜底,45aad0e 新增启动页 splash。
- 云函数调用环境指向问题解决。
Phase 1 MVP:从纯前端原型重构为全栈 Monorepo
- 前端迁入 frontend/,新建 backend 与 deploy。
- 前端 TS 化(TS 5.4 + vue-tsc):7 个 Pinia store、Axios/WS 层、6 个 API 模块。
- 新增 VideoPlayer、CameraGrid、PTZControl、DetectionOverlay 与自然语言搜索页。
- 后端 Go Gateway(Gin+JWT)/ C++ Media(ZLMediaKit)/ Python AI;init-db.sql 建 9 表,compose 六服务。
2026-06-28
内容模块:育儿贴士 + 知识文章 + 宝宝创建
- c192c53 育儿贴士与知识文章模块上线。
- 51ab922 完成 P0 的 Quick Actions 与宝宝创建。
- 首页信息流成型,每日贴士 + 育儿知识两个内容模块落地。
2026-06-27
安全区域与状态栏适配
- 31e4968 页面下移至安全区域,底部工具栏固定不滚动。
- 1f619b3 工具网格加 box-sizing,全站用 min-height 替代 100vh。
- e1de5d8 整体下移 44px 避开状态栏与退出按钮,解决刘海屏遮挡。
2026-06-26
全站 SEO/GEO 优化:history 路由 + 结构化数据 + sitemap + llms.txt
- 路由由 hash 改 history,URL 去掉 /#。
- 新增 useStructuredData,全站注入 Organization/BreadcrumbList 等结构化数据,sitemap 9 条 + robots.txt 补齐。
- Services/Policies 加 FAQPage(4+3 问答),9 处 img 补 lazy 与 alt。
- 新增 llms.txt;页脚补京公网安备 11022902000522 号。
- 遗留:sitemap 待提交百度站长,百度统计/GA4 未接。
首页工具网格多轮打磨
- d3ba7cc 工具页补返回键与首页导航栏,7f71ba1 统一全站标题栏样式。
- 2fecf07 修标题栏 safe-area 被 padding 覆盖不显示,栏高 88rpx 降为 80rpx。
- 92b7ffb 新增食物查询工具(NoSQL + AI 大模型回退)。
- 工具网格多轮调整:两排三列居中、压缩按钮、去掉弧形背景框。
2026-06-25
项目初始化:贝芽妈 v1.0 骨架搭建
- 3d47cab 初始化贝芽妈小程序 v1.0,定微信原生 + CloudBase 底座。
- 搭首页、记录、商城、社区、我的五个 Tab 骨架与自定义 TabBar。
- 产品定位未定型,先跑通页面框架。
2026-06-24
踩坑:Failed to fetch 全面修复(网络 / CORS / 500 / 轮询泄漏四层)
- 一天内收掉 Failed to fetch 四层成因:请求层、服务端、CORS、前端定时器泄漏。
- 小程序 request() 加 try/catch,statusCode 补认 201,不再把创建成功当失败。
- Express 加全局错误中间件统一返 JSON 500;CORS 白名单补 http 生产域名;JWT_SECRET 后备值统一。
- 所有轮询定时器补 onUnmounted 清理,四处 footer 版本统一到 v2.0.2。
2026-06-23
产品化收尾:操作说明、仪表盘小程序码、供应商搜索筛选 + 架构文档
- 供应商管理加搜索与企业分类筛选,仪表盘加小程序码,管理员扫码即进后台。
- 出价排名补显示竞价标题,新增管理员图文操作说明;供应商「竞价中/我的」按状态分流。
- 补三份文档:功能对比表、服务端架构、小程序架构,README 加技术栈/目录/错误码速查。
- 定规矩:版本更新说明不用 emoji。
2026-06-22
企业资讯栏目重构:分类筛选 + 文章详情页 + 结构化数据
- 企业资讯从堆列表改为五类主题筛选 + 独立详情页 /news/:slug。
- 详情页嵌 Article JSON-LD 与公众号二维码,兼顾收录与涨粉。
- 文章统一由 articles.js 单一数据源驱动,列表与详情不再各维护一份。
出价规则定型:降幅整数倍 + 固定 5 分钟延时 + 弹窗交互
- 出价降幅限定为最小降幅的整数倍,服务端 bid() 做整除校验,不合法直接拒。
- 延时写死 5 分钟:结束前 5 分钟内有人出价即顺延 5 分钟,delay_minutes 字段保留但不再读取。
- 出价弹窗修四处:默认值自动填充、取消不关弹窗、字符串转 number、结束时间补 fmtDate。
- 已结束竞价的邀请链接改为返回 bidding_ended: true 跳只读详情,不再弹「请求异常」。
v2.0.0 发布 + 官网入口页与 SEO/AI 元数据
- 发布首个正式版 v2.0.0:隐私协议页、价格取整、WebSocket 实时同步、订阅消息、自动过期与重启。
- 官网入口页单页上线,补齐 OG/Twitter Card/canonical、Organization JSON-LD、robots.txt、sitemap.xml。
- 加 llms.txt 与 ai-summary 元数据供 AI 检索引用,首页标注备案号。
- 后续发 v2.1.0(开标时间)与 v2.1.2~v2.1.4,线上为 v2.1.4。
日期输入改年月日独立文本框(绕开浏览器 locale)
- 竞价表单日期输入在英文浏览器显示 mm/dd/yyyy,根因是原生 date 控件跟随 locale。
- 改为年/月/日三个独立文本框,同步改重置、回填解析、保存拼串,招标表单的 datetime-local 一并换掉。
- 改完白屏:save() 被多复制一行 async function 造成语法错误,用 new Function() 先验语法再部署。
- 部署前做本地→宿主机→容器三层 md5 比对。
WebSocket 实时价格同步 + 微信订阅消息推送
- WebSocket 实时同步价格,任一方出价所有在线端立即收到,不再等轮询。
- 订阅消息三类:开标提醒、被反超提醒、出价后引导重新订阅(微信订阅是一次性)。
- 价格统一取整去小数,出价加跳动动画;时区统一为存储北京时间、API 输出 UTC、客户端 +8h。
- 坑:订阅模板字段不匹配导致推送失败,逐字段对齐模板 ID 与 data 结构。
竞价状态双轨维护 + 自动过期 + 一键重启
- 竞价状态双轨:biddings.status 由后端 30 秒定时任务更新,API 返回时用 SQL 实时算 computed_status。
- 招标补自动过期:list() 开头把 status=1 且已过 end_time 的置为 2。
- 已结束的竞价/招标可一键重启并重设起止时间,其他状态按钮置灰防误操作。
2026-06-21
SEO/GEO 基础体系与 404 兜底页面
- 补齐 SEO 基础工程:Twitter Card、Person 结构化数据,修正 sitemap 逻辑。
- 新增 404 页面,死链不再暴露浏览器默认报错。
- 「关于我们」加创始人介绍与创业初衷,同步更新青年公社案例数据。
竞价招标完整流程走通 + UI 全面优化(单日 9 次提交)
- 单日 9 次提交,竞价(邀请→验证→看价→出价→排名→结果)与招标(建档→传文件→邀请→投标→下载)全流程走通。
- 半数提交是视觉:竞价卡片重排、状态标签配色、圆角间距统一、管理端按钮归位。
- 出价按钮从固定悬浮改为跟随内容滚动,滑到底才出现,避免误触。
- 新增出价排名自动刷新与首页按状态分流。
错误提示体系:从 toast 到带 errCode 的 Modal
- 报错从一句「请求失败」改成带 errCode + HTTP 状态码的 showModal 弹窗,弹窗限频 3 秒。
- 建统一错误码表,管理端加 /error-codes 接口可查全表。
- 坑:容器缺文件报 404 找不到错因,顺手把接口路径打进弹窗。
- 教训:源码必须 bind mount 进容器,否则 compose 重建后改动全丢。
附近热门门店:三层免费数据架构
- 搭三层免费数据:nearby_stores 缓存 + 入驻商家 + 腾讯地图 API 种子。
- 新建 nearby-store 云函数与 nearby_stores 表(lat/lng 索引),搜索半径 5→15km。
- 种子数据:手动 14 家 + API 采集 30 家,深圳共 44 家门店。
- 验证南山 10km 返回 16 家,0 次用户 API 调用。
2026-06-20
首版骨架跑通:招标管理 + 分享转发 + 日期统一格式化
- 两天内跑通招标链路:列表、详情、邀请供应商、分享转发全部可用。
- 抽 fmtDate() 统一所有时间字段,补齐竞价/招标前后端状态口径。
- 坑:管理后台 Web 跳小程序用 wx.navigateTo 失败,改 navigator 组件。
- 登录来源打 miniapp 标识,服务端据此区分 Web 与小程序。
重写决策:放弃旧版 uni-app 竞拍源码,改原生小程序 + 自建后端
- 接手外包竞拍小程序后先出逐项功能对比表,判定重写而非改造。
- 三条理由:旧后端 PHP 撑不了 WebSocket 推价、uni-app 对 chooseMessageFile 等原生 API 隔阂、数据模型要加邀请/日志/开标时间。
- 旧版缺的供应商邀请验证、管理员控制台、错误日志、手机号绑定列为新增项,对比表当需求清单用。
- 保留 RESTful 接口风格、原生小程序与 WXSS。
投资项目详情 / 套餐下单 / 附近工作 / 服务器迁移
- 投资项目详情改 HTML 渲染,排版自由度高于纯文本;精品套餐下单打通,附近工作接真实数据。
- API 模块上线,对应官网 API 文档页;后端迁到新机器,server.js 与部署脚本同步改地址。
- 至此小程序达 102 个页面、30+ 云函数。
2026-06-19
项目立项:华为云 + Docker 容器化部署方案
- 中航天业竞价平台立项:固定降幅阶梯出价、结束前出价延时、同公司联系人隔离,SaaS 改不动,自研。
- 华为云 ECS(CentOS 8 / 40G / 7.6G),Docker Compose 两容器:Node 22 Alpine + Express、MySQL 8.0。
- Nginx 反代 443→3000,Let's Encrypt 证书;代码 bind mount,改代码不重建镜像。
- 选小程序:供应商不装 App,管理员转发卡片即可邀请。
操作日志系统:全链路留痕到 IP
- 新建 operation_logs 表:admin_id/admin_name/action/target_type/target_id/detail/ip/created_at。
- 新增 logger.js 统一写入,接入登录成功与失败、竞价/供应商/分类/用户 CRUD、配置修改、邀请发送。
- 新增 GET /api/admin/logs,支持分页与按 action、关键词筛选。
- 系统设置页加操作记录板块:时间/操作人/类型/详情/IP;登录失败也记,用于排查异常登录。
供应商邀请制:32 位 token + 身份验证 + 鉴权中间件
- 小程序导航标题由「竞价系统」改为「中航天业」,验证页显示 Logo 与系统名。
- 邀请制:每次生成 32 位随机 token,链接 pages/verify/verify?token=xxx,供应商填公司/姓名/手机验证后才能看竞价与价格。
- 服务端 supplierAuth 中间件拦截,未验证 token 访问详情接口直接 401。
- 后台竞价列表加邀请按钮:查看已邀供应商、复制链接、发送新邀请。
扫码签到考勤系统 + 修复新用户登录失败
- 首页加扫码签到,直接 wx.scanCode,支持带参二维码与小程序码 scene,结果弹窗反馈。
- 教练排课页加签到,按日期切换已签到/迟到/缺勤,只写变化记录。
- 新增 check_in_records 表,含 user_date、coach_date、course 三个索引。
- 独立签到页多一步跳转,删掉改首页直调。
- 上线遇登录 1062:uk_phone 空串冲突,删索引改业务层保证唯一。
2026-06-18
两个 Tab 换位:精准政策→本地招聘,文创商城→精品套餐
- Tab 4 精准政策换本地招聘,新增 8 个文件,参照「附近的工作」做 Logo + 薪资 + 区域筛选。
- 详情页橙渐变头部、职位描述、任职要求、福利、底部收藏/电话/申请,先上模拟数据。
- 文创商城换精品套餐,8 个文件 4 个套餐:智能锁 700、民宿 999、注册 0 起、咖啡月卡 199。
- 坑:Skyline 高度塌缩,去冗余 padding-top,底栏改 flex-shrink:0,scroll-view 补 height:0。
2026-06-17
新增 API 文档页面与页脚入口
- 新增 API 文档页面,集中说明园区/企业/场地/政策等数据接口,供对接方自助查阅。
- 页脚同步加 API 文档入口。
- 官网展示、内容、数据接口三条线至此全部对外。
P0/P1/P2 全面代码审查与修复(59 文件)
- 3 个 Agent 并行审查 22 页面 + 16 云函数 + WXML,产出 50+ 项清单。
- P0:删 _testOpenid 后门,init/migrate 加管理员鉴权,6 个云函数密码改环境变量。
- P1:shop/order N+1 批量化,community delete 分页 + create 身份验证,补价格校验。
- P2:品牌色统一、px/rpx 清理、死页面删除;commit 7c57264 共 59 files +469/-843。
2026-06-16
apiGateway 上线:把党建活动开放成 HTTP 接口
- apiGateway 上 HTTP 触发器 /api,请求头 X-API-Key 做 SHA256 鉴权。
- 党建活动 6 个接口:health、list、detail、create、update、delete。
- 图片接口下载外部 URL 转存 COS 返 cloud://,魔数校验 jpg/png/gif/webp,限 10MB。
- 全链路验证:上传图片 → 创建活动 id=7 → 查询确认。
- docs/api-guide.md 同步到官网 API 文档页。
品牌色统一 + px→rpx + 骨架屏 + 瀑布流 + 话题系统
- 品牌色统一:16 个 WXSS 文件,主色改 #5BA3C9 / #E87B35,深色改 #2C2C2A,背景改 #FAF8F5。
- px→rpx:Python 脚本批量转 19 文件 1095 处,保留 0.5px/1px 发丝线。
- 首页/商城/宠物圈加骨架屏,157 个元素补 hover-class;商城瀑布流改 CSS columns。
- community 支持 topic 字段,新增 5 个话题筛选栏。
- commit d3748e5:48 files, +1358/-1181。
2026-06-11
学员风采页 + 每周固定排课 + 自定义扣课
- 课程购买页下线,换成「学员风采」朋友圈式 feed:管理员传图/写备注/删除,点图全屏预览,新建 student_showcase 表。
- 教练排课支持每周固定:自动生成 8 周日期,进页自动补齐快过期排课;排课时间延到 22:00,补上 18:00-19:00。
- 低课时预警:≤4 课时的学员顶部黄条 + 名字红标。
- 一键扣课支持自定义课时与金额,默认沿用上次金额。
- 用户管理新增备注字段,学员名统一显示为「备注 原名」。
2026-06-09
全站品牌更名为「青年公社」,新增浮动电话按钮
- 全站品牌名统一改为「青年公社」,Logo 与文案同步更新。
- 官网与小程序品牌口径拉齐,此前对外识别度打折。
- 新增右下角浮动电话按钮,点击直拨 400-600-2417,移动端咨询少一步。
2026-06-03
官网完工:品牌视觉与内容文案定稿,可对外发布
- 品牌视觉与全站文案定稿:子页 Hero 红色统一、四大服务板块、园区与入驻企业数据对齐小程序。
- 官网功能与视觉双完工,具备对外发布条件,静态产物部署到 CloudBase 静态托管。
- 对外信息定稿:400-600-2417、延庆区东顺城街 14 号、京ICP备2025149772号-3。
2026-06-02
地图方案换血:腾讯地图额度耗尽 → Leaflet + OpenStreetMap
- 腾讯地图 JS API 报 Error 121 无权限,免费额度耗尽,改用 Leaflet + OpenStreetMap 瓦片,不再依赖 Key。
- News.vue 重写:L.map + L.tileLayer + SVG divIcon 标记 + popup,改在 onMounted 初始化,去掉 window.initTMap 全局回调。
- 代价 dist 增大 150KB,换掉额度风险。
- 遗留:OSM 境外瓦片国内加载一般,提速需换国内源并处理 GCJ-02 纠偏。
四个子页按小程序真实数据重构,底部加小程序二维码
- 按小程序真实数据重做四个子页。
- 园区地图拆掉写死的 12 家企业与筛选,改地图打点展示 6 个园区,初始中心延庆 zoom=7。
- 空间租赁上 5 类场地 8 张卡片 + 分类筛选;创业导师 10 位 + 7 分类,补录李丹丹(id 12,财务)。
- 入驻企业由 2 列改 4 列卡片网格,1024→3 列、768→2 列、480→1 列,数据仍走 getCompanies。
- 网页底部品牌区加小程序二维码。
踩坑:精准政策报 EXCEED_AUTHORITY —— CloudBase RDB 对匿名用户不开门
- 精准政策报 EXCEED_AUTHORITY,日志为 app.rdb is not a function。
- 两层根因:匿名身份无 RDB 读权限;本地改 mysql2 但云端仍跑旧版。
- 改 mysql2/promise 直连,连接信息走 process.env,依赖换 mysql2@^3.11.0,部署加 --force 并看日志。
- 验证 invoke 返回 code=200,16 条政策正常。
- 结论:tcb 显示 deployed 不等于真更新,公开接口直连更稳。
2026-06-01
品牌升级:换上珊瑚红视觉体系,精准政策改走云端数据源
- 按 35 页品牌手册换视觉:主色 #BA0C2F、品牌黑 #101820、背景 #F1F0EC,新增草绿与活力橙。
- Home/About/Services/Contact 四页重做,服务收敛四大板块;电话统一 400-600-2417。
- Hero 改珊瑚红渐变,子页 Hero、底部 CTA、页脚全部红色化。
- 新增 getPolicies 云函数读 MySQL policies 表,四个 action,Vue 页去掉硬编码并补三态。
2026-05-31
shop 回滚纯 MySQL + UI 全面审查
- shop 回 MySQL,回滚全部 NoSQL 降级代码,对齐「shop 走 RDB、社交走 NoSQL」。
- 恢复纯 MySQL 并加 snake_case→camelCase 映射;initMySQL 写 3 banners + 8 categories + 12 products + 16 images。
- tags 解析兼容 Buffer/String/Array,mysql2 把 JSON 字符串返成 Buffer。
- 逐行审查 18 页 wxml+wxss,输出 UI 改善建议报告。
2026-05-29
园区坐标逐个精确化 + 快速金融扩到 6 家银行
- 6 个园区坐标用腾讯地图拾取器逐个手查并写回 parks 集合,同步 _fallbackParks 兜底;青年公社修正为 40.459715/115.974769。
- Geocoding API 的 Key 一直报 121 调用量超限,控制台显示用量 0,未查出头绪,先走人工。
- 快速金融扩到 6 家银行:中行加到 4 个产品(随心智贷 50 万、3.0%),新增东亚银行经营性物业贷,顺序中行→东亚→工行→建行→农行→招行。
- 银行 logo 换真实图,新增金融申请页与后台管理页(含一键拨打)。
2026-05-28
Banner 改 5 固定卡槽 + 可转让营业执照资源页
- Banner 改 5 个固定卡槽:原用时间戳当 sort_order,增删即乱序,改 slot 1~5 独立上传/更换/删除,空槽不显示。
- 迁移 3 条旧 banner 的 sort_order 为槽位号,配图改 aspectFit,槽高扩到 320rpx。
- 新增可转让营业执照资源页(#A81829 商务风,6 家企业),挂 banner 4;关于我们页补备案号。
2026-05-27
踩坑:数据分析营收统计口径错误 + 缓存损坏
- 数据分析营收/消课/购课大量为 0,四个根因。
- 统计只查 orders,收入在 expense_records、coach_bookings、venue_bookings。
- 缓存 stats_json 写入 [object Object],解析必失败;existing 把 {data,error} 当数组。
- 修复:口径汇总四个收入源,缓存先删同日同类再插,动画值与 target 拆开。
- expense_records.amount 语义混乱(课时数 vs 金额)的历史数据一并修正。
精准政策爬虫上线:每天 6:00 自动拓延庆政策
- 政策爬虫 policyCrawler 每天 6:00 定时拓取延庆政策兑现数据,直接打官方 JSON API,不用浏览器。
- 按 themeTypeId 去重、排除已截止,首次入库 16 条,source_id 唯一索引做 upsert 幂等。
- 页面改造:列表改显扶持金额,分类从 DB DISTINCT 动态加载,详情加实施主体/服务对象/金额与申请表单。
- 后台新增申请管理页(状态筛选 + 一键拨打)。
- 坑:AI 提取服务对象撞配额上限,加 2s 间隔 + 正则兜底。
2026-05-26
踩坑:场地价格管理页与预约页不一致(三个独立根因)
- 管理页与预约页价格不一致,挖出三个独立根因。
- UTC 日期:toISOString 取 UTC,东八区凌晨差一天,查不到当日价回退模板价。
- 时段名 23:00-00:00 对 23:00-24:00 匹配失败,DB 21 条统一 UPDATE。
- 会员 8 折双重误差:预约页 price*0.8、管理页原价;日期改本地格式化,onLoad 先定价再算会员价。
- 价格定稿:高级场工作日 100/150/100、周末 150/100;普通场 80/100/80、周末 120/80。
余额与课时数据源统一到 members 表
- 余额与课时口径分散在 users 与 members 两张表,同一会员在不同页面数字不一致。
- 统一改用 members 表读写 balance + remaining_hours,users 不再承载这两个字段。
- 连带修复:新增/编辑会员与学员打通,教练扣课时同步扣余额并写消费流水。
- 价格模板表与每日实例表必须同步改;教练-学员关联改 members.coach_id;价格统一会员 400/时、非会员 440/时。
2026-05-25
管理员兼教练双角色与视角切换
- users 新增 is_coach 列并在 coaches 表插入对应记录,支持管理员兼教练。
- 用户管理新增 admin_coach 复合角色,标签用紫色区分;「我的」页加管理员 ↔ 教练视角切换。
- 修 setRole:不再把已有 admin/coach 降级为 member。
云函数瘦身 + 沉浸式启动页与首页过渡
- dbOperation 云函数从 695 行瘦身到 241 行,只留通用 CRUD 与 SQL;错误日志拆到 errorLogs,价格初始化并入 adminVenuePricing。
- 新增全屏启动页 pages/launch/launch:绿渐变 + Logo 呼吸 + 进度条,最少 3 秒最多 5 秒。
- 修启动页到首页闪白:首页改 custom 导航并内置绿色遮罩,200ms 淡出。
- 图片从 Unsplash 外链迁云存储,教练头像回退改本地图;首页 onShow 先渲染缓存再静默刷新。
踩坑:rdb 不匹配下划线字段,管理员被当成普通会员
- 现象:管理员账号登录后显示普通会员,管理功能全部不可见。
- 根因:rdb SDK 不返回下划线字段,_openid 查询静默为空,账号被当新用户重建为 role='user'。
- 修复:users 加 openid 列并双写,查询统一走 openid,覆盖 profile、db-service、payment 与三个 admin 鉴权。
- uk_openid / uk_phone 唯一索引因空串冲突删除,改由业务层保证唯一。
Windows 环境搭建与 navigation-bar 返回逻辑修正
- Windows 环境搭建:node_modules 未入 git,npm install 补 380 个包并手动构建 miniprogram_npm。
- 修 navigation-bar 返回:接单台详情、服务点单返回直接 reLaunch 回首页。
- 根因是 isShareEntry 判断过宽(群聊/公众号/发现/搜索全命中),改为按当前路径反推所属 TabBar 页用 switchTab。
- 之后「分享进入 → 浏览 → 返回」路径恢复正常。
wxLogin 云函数 3 次重构:NoSQL 优先 + RDB 同步定稿
- wxLogin 三次重构:mysql2 直连 → RDB 数据模型 → NoSQL 优先 + RDB 同步(定稿)。
- 坑:tcb db model push 只能更新已有模型,新模型只能在控制台手动建。
- 登录报 Table 'chongaitok.users' doesn't exist,建表解决。
- tcb 部署 wxLogin 需 --dir 加 echo y 管道确认。
2026-05-21
上线前安全审查:关 DEBUG、清硬编码密码、下调试页
- 上线前安全审查:DEBUG_MODE 置 false,调试面板仅管理员可见,移除角色切换、清空预约等危险按钮。
- app.json 删除 debug/test 页面;6 个云函数去掉 password 硬编码回退。
- 教练详情页去掉硬编码电话改读数据,管理员添加教练不再预填测试数据。
社员权益体系落地:54 项次数型权益 + 15 个 action 的旗舰模块
- 权益体系:次数型 54 项建库核销,折扣型 64 项仅展示;非社员看广告,社员看真实次数。
- MySQL 4 张表,memberService 15 个 action 覆盖企业、员工、社员与核销。
- 新增 my-company、service-order、member-manage 三页;转社员自动初始化 54 条权益。
- 企业信息降级:数脉工商 API → 启信宝 → 百度 + AI → 模型兜底。
- user_companies 与 companies 双写,按信用代码去重合并。
Skyline 深坑复盘:从 flex 高度塌缩到弹窗四改
- 服务点单页一天五轮,Skyline 多层 flex 高度塌缩为 0,改导航栏与内容平级。
- 默认 content-box,带 padding 容器须 border-box;横向筛选改 overflow-x 避开嵌套滚动。
- 弹窗四改:transition 对 transform 无效改 wx:if,双 fixed 改单容器 + absolute,body 固定 55vh。
- navigation-bar 硬编码 #333,title 红底无白字须改 slot;导航栏不显示是 .json 没注册组件。
2026-05-20
头像路径治理与用户数据回填:24 条脏数据 + 43 个补录用户
- 清掉 users.avatar_url 里 wxfile:// 与 http://tmp/ 临时路径 24 条,只存 cloud:// fileID。
- 漏洞:mine.js 漏判 wxfile://;lock-scan.js 未上传云存储就写库。
- syncUnlockLogUsers:183 条日志去重 71 人,补录 43 人,users 55→98。
- bidding 里 nickName/avatarUrl 与表字段 nickname/avatar_url 不一致,全员显示匿名。
2026-05-19
园区地图重构 + 头像缓存 2 小时过期修复
- 园区数据从硬编码迁到云库 parks 集合,loadParks 动态加载 + _fallbackParks 兜底,权限 adminwrite。
- 6 个园区覆盖延庆/上海/海口,默认延庆 scale=12,可切全国 scale=4;园区红标常显,企业白标点击显示。
- 修头像缓存 2 小时过期:改存原始 avatarFileID,每次启动重新换链,加载失败切默认头像。
- 内部预约静默失败:MySQL 缺 is_internal 字段,SDK 不报错但写入失败,补字段并写入后回查。
电子名片小程序码:从 -501001 与 32 字符静默失败里绕出来
- 名片小程序码云调用报 -501001,改双策略,失败走 HTTP API 换 access_token。
- 坑:scene 用 card=openid 33 字符,超微信 32 上限且静默失败,改放纯 openid 28 字符。
- page 传名片页报 invalid page,改首页中转再重定向。
- 保存失败先查 business_cards 集合;更新不写 openid,避开 _openid 冲突。
- 画布用页面 Canvas + arcTo 圆角,主题色改 #D4272D。
2026-05-18
接单台上线:Tab 改版 + bidding 云函数 10 个 action
- 接单台做成 Tab 第 3 位,bidding 云函数 10 个 action 覆盖发布、竞标、留言、选标。
- projects/bids 进 MySQL,messages 进文档库;新增 5 个页面。
- 防自竞标与重复竞标,非发布者看不到预算;选标后项目转 in_progress,其余 lost。
- 坑:云函数无 wx 全局对象,AI 调用报 ReferenceError,改用 app.ai().createModel('cloudbase')。
- 同日上线电子名片与企业注册申请。
2026-05-17
场地预约后台改造 + adminVenue 云函数拆分 + OPC 专属服务页
- 场地预约后台支持清空测试数据与内部预约(免支付,is_internal=1 直接 pending_use)。
- 场地 action 从 adminUsers 拆出独立 adminVenue 云函数,自带管理员鉴权。
- 新增 OPC 专属服务页:红色渐变头部 + 5 类服务 + 价格表 + 申请弹窗;启动页进度条改为加载即可见。
- 坑:WXML 不支持箭头函数与 findIndex,picker 返回索引不是 id,需在 JS 里先算好。
产品战略审查:三位一体定位 + 商业模式
- 产出战略审查报告,定位定稿为本地宠物社交 + 上门服务 + 轻量电商三位一体。
- 商业模型:服务抽佣 15-25% + 商城佣金 + 会员订阅,明确 6 项不做。
- 5 大差异化:LBS 附近宠友、到家服务、宠物朋友圈、暖萌品牌、微信原生。
- 附竞品分析、用户研究、市场数据三份子报告与 7 页品牌色 PDF。
全面功能真实化:9 云函数 + 7 页面 + 15 集合
- 新增 7 个云函数(order/user/friend/shop/nearby/pet/message)+ init。
- 新增商品详情、购物车、我的订单、我的宠物、消息 5 页;初始化 15 集合 + MySQL 3 表。
- 支付先走模拟下单即 paid;登录同步 user_profiles。
- placekitten 宕机,52 处图片换 picsum;腾讯 POI 接入,附近 5km。
- 坑:tcb 部署报 entryFile not found,需 --dir 与 --force。
2026-05-16
项目立项:5-Tab 架构 + UI 草图 + 登录重构
- 产出 5-Tab UI 草图(首页/服务/商城/宠物圈/我的)+ 5 个弹窗,7-Tab 精简为 5-Tab,附近与消息降为子页。
- 设计规范定稿:奶橘 #E87B35、浅蓝 #5BA3C9、米白 #FAF8F5,暖萌圆角。
- 首页改为 Banner 轮播 + 8 宫格 + 附近门店横滑,新增服务页与商城瀑布流页。
- 登录去掉独立页,改个人中心弹窗微信一键登录。
- 修掉 enhance 增强编译 tree-shaking 误删依赖导致的页面空白。
2026-05-09
公众号文章服务迁到固定 IP 服务器:IP 白名单绕不过去
- 首页最新资讯拉不到公众号文章,云函数报 errcode=40164:微信 API 要求调用方 IP 在白名单,而云函数出口 IP 不固定。
- 决策加一台固定 IP 服务器做中继:云函数 getArticles → server.js → 公众号 API;server.js 用 Node HTTP + PM2 纳管,白名单加服务器与本地 IP。
- 云函数改 HTTP 调用,多图文的 news_item 拆开展平(原来只取第一篇),缓存 12h → 2h。
- 坑:3000 端口被 Docker 容器 iptables DNAT 占用,内部通外部不通,换 3002 解决。
2026-05-07
门禁真机问题攻坚:手机号与头像的「三修」
- 手机号授权修三轮:phone 写进 userInfo 被按 openid 判未登录覆盖 → 换独立 key lock_phone → 根因是云函数查到 phone 却不返回,_checkLogin 改三重读取。
- 头像压扁修三轮:加圆角、加 flex 均无效,最终视觉层与交互层分离,view 做圆形裁切、button 设 opacity:0 只接 open-type;根因是微信 button 内置 UA 样式。
- errcode -3 与 0 拆成两态:确认开门 vs 指令已发送;开锁成功页改 3 秒倒计时回首页。
- 设备名支持自定义,lock_devices 优先于默认 alias。
2026-05-01
扫码门禁上线:TT Lock 对接 + 设备小程序码
- 小程序首次接硬件,用 TT Lock 开放平台 API 做扫码开门。
- 新增 lock-scan / lock-result / admin/lock-manage 三页;云函数 ttlock_unlock 提供 unlock / getLocks / unlockByQrCode,内置 token 缓存、错误码映射、订阅消息。
- 建 lock_devices 与 unlock_logs,录两把锁(觉觉书店 20315795、正门 20292199),生成两张带 Logo 小程序码。
- 认知:errcode=-3 只表示指令已发送,不等于确认开门。
2026-04-30
部署上线腾讯云 CloudBase 静态托管
- npm run build → deploy.js → cloudbase hosting deploy dist,站点上线 CloudBase 静态托管。
- vite.config.js 配 base: './' 适配静态托管子路径。
- 收尾给关键文件补中文注释,注明组件功能、数据结构与设计决策。
- 已知:默认测试域名首次访问有提示页需点确定;子路径无 SPA fallback,直接访问会 404。
修复 i18n 取数组返回 key 路径:t() 改 tm()
- 现象:切语言后标签、设施清单等列表被 v-for 拆成 key 路径字符串。
- 根因:vue-i18n v9 的 t() 只返回字符串,数组/对象值会回退成 key 路径。
- 修复:取数组或对象统一改 tm() 并加 || [] 兜底,涉及 6 个文件;约定 t() 管字符串、tm() 管数组对象。
- 附带修复:联系我们锚点被 70px 固定导航遮挡,加 scroll-margin-top: 80px。
中英文双语完整的国际化(vue-i18n@9)实施
- 引入 vue-i18n@9,建 src/i18n/,zh-CN 与 en 两包约 200+ key。
- key 按页面/组件分命名空间,导航、首页、教练、课程、场地预约等各一组。
- 自动检测浏览器语言 + localStorage 持久化,Navbar 加中/EN 切换;硬编码中文改 $t(),ref 数据用 computed + t()。
- 管理调试页不做国际化;修切换按钮白字看不见,改深色字 + 绿色 active。
SEO 优化:结构化数据 + 懒加载路由 + 404 兜底
- index.html 补 description / keywords / theme-color、Open Graph、Twitter Cards、JSON-LD(LocalBusiness)、preconnect。
- 新增 robots.txt 与 sitemap.xml。
- 路由全量懒加载,每路由带 meta,beforeEach 同步 title 与 OG 标签。
- 新增 NotFound 页与 :pathMatch(.*)* 兜底,删除脚手架残留 style.css。
踩坑:scroll-reveal 双层嵌套导致内容 opacity:0 不显示
- 现象:加滚动动画后首页课程体系整块 opacity:0 不显示。
- 根因:About/Coaches/Courses/Moments/Contact 五个组件模板自带 .scroll-reveal,Home.vue 又包一层,内层永远不被 IntersectionObserver 观察到。
- 修复:移除组件内 class、动画统一由 Home 控制;CSS 动画挂 html.sr-ready 前缀做渐进增强,useScrollReveal 加 nextTick。
- 同类坑:子页面根元素也不能加 .scroll-reveal,否则整页不显示。
滚动揭示动画 + 移动端响应式适配
- 新建 useScrollReveal.js,基于 IntersectionObserver 做滚动触发。
- style.css 加方向变体、data-reveal-delay 1~6 交错延迟、prefers-reduced-motion 降级。
- 子页面卡片改为每张独立滚动显示,避免整块空白等待;断点 768px 与 480px 适配,按钮 min-height 44px。
- 教练竖图高度 240→360px,配 object-fit: cover 与 center top,修掉只露下半张脸。
首页 Hero 可读性优化:黑色半透明毛玻璃文字框
- Hero 大图上白字与背景重叠,部分文字几乎看不清。
- 方案一改绿字对比度不够,已弃用。
- 最终给 .hero-content 加 rgba(0,0,0,0.35) 半透明底、圆角 20px、blur(4px) 毛玻璃,内边距 40/50px。
- 结论:大字压图加半透明底比改字色靠谱。
新增场地预定页,全站购买入口统一为「立刻咨询」
- 新建 VenueBooking.vue:3 片场地卡片 + 设施标签 + 日夜场价格 + 营业时间 06:00-00:00 + 预定须知。
- 价格:1/2 号场日场 100、夜场 150,3 号场日场 80、夜场 120。
- 3 号场类型由红土场修正为户外硬地场。
- 购买入口全改「立刻咨询」,新增 useContactAction:PC 跳联系我们锚点,手机直接拨号。
图片资源全面本地化:中文文件名转英文、去掉 Unsplash 外链
- coaches/ 下中文文件名改为 assen.jpg / he-coach.jpg / lu-coach.jpg,避开 URL 中文编码;venus/ 下网球场图改为 court-1/2/3.jpg。
- 教练照片、活动图片从 Unsplash 外链全部换本地路径,fallback 同步改。
- 客服二维码从占位接口换成真实图 /ScanMe.png。
- 原因:外链不稳、内容不可控、国内加载慢。
2026-04-29
引入飞书 Bug 台账,43 条问题一次性清账
- Bug 流程搬到飞书表格,配 lark-cli 自动读写,汇总文档成唯一台账。
- 一轮清 43 条:新增 5 条,当晚修完 7 条,全量同步状态为已修复 14 / 待测 27 / 部分修复 1。
- 坑:飞书多列写入 range 必须覆盖全部目标列,否则状态错位一列;Skyline 对 inline-block 点击支持差,筛选标签改 inline-flex;MySQL 数值字段需 Number() 后再运算。
2026-04-21
新增课程体系与课程购买页,接入部署配置
- 新增 CourseSystem.vue(五阶段成长路线)与 CoursePurchase.vue(套餐卡片)。
- 路由全量懒加载,每个路由带 meta。
- 新增 deploy.js:构建后 cloudbase hosting deploy dist 发布静态托管。
- 补 README,含结构说明、Vite 操作与部署说明。
2026-04-20
项目立项:Vue 3 + Vite 骨架搭起,首版官网跑通
- 初始化 Vue 3 + Vite 工程,确立单页官网 + 多路由结构。
- 首版路由规划 9 页:首页、关于我们、孵化服务、创业导师、入驻企业、空间租赁、精准政策、园区地图、联系我们。
- 新增入驻企业页,接 CloudBase 云开发 JS SDK 作数据源;路由先取 hash 模式,设计 token 抽成变量便于换肤。
- 04-21 追加一轮 UI 打磨,重排首页视觉层级与卡片样式。
2026-04-19
云函数直连 MySQL:用架构选择绕开 RDB 字符集乱码
- 云开发 RDB 写入中文取出全是乱码,改为云函数直连 MySQL(mysql2),从根上绕开字符集问题。
- 连接信息走 process.env,依赖由 @cloudbase/node-sdk 换成 mysql2;同日把公众号文章链路也改成直连,并引入页面分享、封面图走云存储。
- 副作用:MySQL 数值字段可能返回字符串,加减前必须 Number(),当天场地预约总价 1100 算成 800300。
2026-04-14
视频播放能力与二维码弹窗,并下线早期 HTML 版官网
- 多个方案页加响应式视频播放,自动播放 + 容器相对定位,避免视频撑破布局,并新增智慧酒店视频。
- 新增二维码放大弹窗 QrModal,用于公众号引流。
- 同日删除早期 HTML 版官网、backup 移出版本库,Vue 版成为唯一实现,不再双套并行。
2026-04-13
数据分析提速:统计缓存 + 夜间定时任务
- 看板统计原来每次实时算,页面打开慢。
- 新增 daily_stats 统计缓存表,夜间定时任务计算并跨日自动刷新。
- 定时任务顺带归档过期活动。
- 过滤非学员及无课时记录用户,避免统计虚高。
2026-04-12
瘦身与加固:移除商城模块、支付安全、优惠券赠送
- 移除商城相关代码,客户不做实物商品。
- 支付安全加固,修复 analyticsData。
- 新增优惠券赠送,统一错误处理走 dbService.reportError。
- 活动场地支持动态配置,修复预约流程与身份校验,删除旧登录页。
2026-04-09
集成微信支付,课程套餐与登录跳转联调
- 支付链路跑通:下单 → 支付 → 余额/课时入账。
- 集成微信支付云函数 payment;未登录自动跳登录,登录后可返回原界面。
- 课程套餐按客户确认口径重调。
- 新增消息日志功能,修复球场类型字段。
基于小程序内容重组官网信息架构
- 小程序先于官网成型,官网沿用小程序已谈定的内容口径,避免两端不一致。
- 课程体系、教练团队、场地信息以小程序为准同步。
- 官网定位展示 + 咨询引流,不做交易闭环,购买入口全部改成「立刻咨询」。
2026-04-08
新增智慧酒店方案详细页
- 智慧酒店 / 民宿方案详情页上线。
- 内容含房态与场景联动、无人入住流程、客房智能控制。
- 企业服务线从概念介绍进到有可展示的落地场景。
2026-04-01
包体积治理:7.3MB → 2.2MB,把 2MB 上传上限这道墙撞开
- 主包上限 2MB,工程膨胀到 7.3MB 上传被拒:npm 依赖全量打包、node_modules/cloudfunctions/map 全被算进包体、miniprogram_npm 嵌套路径配置错。
- 移除未使用的 @cloudbase/js-sdk 改手动 npm 打包,用 packOptions.ignore 排除无关目录,修正构建路径。
- 结果 7.3MB → 2.2MB,上传通过。
- 顺带恢复 Skyline、版本号第三位自动自增、关于页补备案号 京ICP备2025149772号-2X。
2026-03-30
购物车与订单管理成型,管理员云函数上线
- 新增购物车与订单管理功能。
- 实现活动报名并重构相关页面。
- 新增管理员云函数 adminUsers,用户管理与多业务表操作打通。
- 至此小程序具备「看内容 → 下单 → 后台管理」完整闭环。
2026-03-29
微信支付打通 + 手机号绑定 + 轮播图后台
- 接入微信支付与手机号绑定,成为后续门禁、社区、会员功能的前提。
- 新增地址管理页,优化收藏页交互。
- 新增图片上传组件与轮播图管理。
- 后台管理入口进小程序,管理员与普通用户开始分权。
2026-03-25
场地预约改按天计费,活动租赁与商城订单三线并进
- 场地预约从按次改为按天计费,价格模型与订单字段同步调整。
- 新增活动预约与场地租赁两个入口。
- 补网络状态检测与商城订单功能,顺带处理断网态。
- 首页导航栏加 Logo,替换订单页的网络图片资源。
2026-03-23
三大业务线页面成型(单日 11 次提交)
- 单日 11 次提交,按家庭服务、企业服务、技术开发三条线铺业务页。
- 家庭线:全屋智能、老人守护、儿童成长、高端别墅、智能产品;企业线:智慧酒店、智慧办公、智慧园区、智慧农业。
- 每个方案页统一为能力介绍 + 应用场景 + 预约入口,方便直接留资。
2026-03-22
主站页面集中开发(单日 17 次提交)
- 单日 17 次提交,首页、关于我们、服务体系等主站页面集中成型。
- 确立视觉基调:首页 Hero 视频、核心优势六宫格、三大生态兼容展示。
- 公共组件落地:SiteHeader(吸顶导航 + 移动端抽屉)、SiteFooter。
2026-03-19
数据库从云开发 NoSQL 迁移到 CloudBase MySQL
- 会员-教练-场地-课时-消费流水关系变复杂,NoSQL 查询别扭,数据库迁到 CloudBase MySQL。
- 前端统一走 dbOperation 云函数做 CRUD。
- 同时补上小程序自动化测试脚本。
2026-03-18
微信登录与云函数集成
- 打通小程序与云端的认证链路,接入微信登录。
- 云函数调用统一封装为 callCloudFunction。
- 后续补 -404006 冷启动超时自动重试。
2026-03-16
重构为「数据中心」模式 + 场地预约体验优化
- 原先各页面各查各的数据,重复请求多、状态不同步。
- 新增 utils/data-center.js 统一缓存层,带默认数据回退,场地数据改数据中心模式。
- 场地预约新增时间段与场地选择,预约限制在一周内。
- 教练数据与头像样式重构,补场地图片;此后所有页面都基于这套结构。
2026-03-15
教练端排课日历与管理后台成体系
- 教练端:排课日历、请假、新增/编辑教练、学员查看、数据统计。
- 管理端:场地管理(时间表视图)、球场设置、自定义价格、活动管理、优惠券管理、学员管理。
- 数据分析页加图表入场动画,后续因动画抢跑又调一轮。
- 场地管理页加自定义导航栏,教练卡片样式尺寸统一。
2026-03-13
项目立项:会员端功能与整体架构搭建
- 从零搭小程序骨架,先做会员端。
- 主题色定绿色系,全套 icon 重做。
- 自定义 TabBar,避开原生 tabBar 的样式限制。
- 首批页面:我的课程、课程体系、私教预约 + 教练详情、会员中心,配入场与卡片降落动画、滚动触发。
项目立项:从原生 HTML 改为 Vue 3 + Vite
- 原先是单文件原生 HTML,内容一多难维护,整体重构为 Vue 3 + Vue Router 4 + Vite。
- 组件拆为 Home / StarCoaches / Activities / CourseSystem / CoursePurchase。
- 公共组件单独抽出 Navbar / Hero / About / Stats / Coaches / Courses / Moments / Contact / Footer。
- 静态资源按 public/images/ 分类(coaches、venus、home.jpg)。
2026-03-10
企业查询上线:企查查风格的企业详情页
- 新增企业查询功能,详情页按企查查的信息层级重做。
- 新增风险信息、知识产权两个标签页。
- 完成优惠券领取功能。
- 统一状态类名、用类型断言收敛一轮重构,固定可复用样式模式。
2026-03-07
搜索页 + 个人中心重构 + 全站换自绘导航栏
- 新增搜索功能页与交互逻辑。
- 重构个人中心,拆出收藏、历史、订单等新功能页。
- 自定义导航栏落地:原生导航栏满足不了品牌视觉,改为自绘,首次撞上状态栏高度适配。
- 投资者详情页同步补自定义导航栏样式与布局调整。
2026-03-06
官网首次上线
- 官网正式对外发布,域名 + HTTPS + CloudBase 静态托管链路全通。
- 首批开放首页与公司介绍,此后持续迭代。
- 从立项到上线历时 3 天。
2026-03-05
内容骨架落地:党建活动 / 创业导师 / 精准政策 / 企业成长
- 新增党建活动页与导师详情页,园区内容四条主线成形。
- 精准政策、企业成长两页的显示问题集中修了一轮。
- 新增停车服务页。
- 此时仍是照设计稿一页页搭,数据大多写死在页面里,尚未云化。
2026-03-04
项目立项:搭起 Vue 3 + Vite 的站点骨架
- 从零搭站点骨架:Vue 3(Composition API + script setup)+ Vue Router 4(history 模式,带 SEO meta 守卫)+ Vite 5。
- 样式全部手写,不引 UI 组件库,视觉自主、包体轻量。
- 静态托管选腾讯云 CloudBase,构建与部署链路当天打通。
2026-03-02
项目从零起步:first init,第一版页面在开发者工具里跑起来
- 从开发者工具建工程,渲染引擎选 Skyline,3-02 首次提交 first init。
- 3-03 首页改为青年公社设计语言,文章详情、企业列表、企业详情三屏同时出。
- 同日补企业地图与位置权限,重构导航栏、精简首页入口图标。
- 坑:小程序无 DOM,rpx 与 px 混用、导航栏要自绘,Web 那套经验基本作废。