开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 16 条记录。
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-17
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,线上已部署并冒烟验证(天气 / 多件下单 / 记地址电话 / 挂单出卡)。