实战笔记
上线以后才冒出来的毛病，
一篇只讲一个。
导入 120 行只进了 117 行，界面上一句提醒都没有；脚本报「操作成功」，后台那一单还是待发货；输了完整车架号，系统却认成了尾号相同的另一辆车。这些事都出在交付过的项目里。
每篇讲清楚事情是怎么出的、后来定了什么规矩，写给要上系统的老板和负责人看，不讲代码。客户名只写到行业；每篇旁边标了对应的交付档案，有演示的也标了图号，可以对照着点开看。
共 20 篇最近一篇 2026-09-10按主题可筛
服装厂计件工资系统01 全部笔记
20 篇，新的在前
篇号越大越新。点主题只看那一类；右边一栏是这篇说的那个项目的档案号，有同类演示的，写了图号。
- 第 20 篇
AI 客服和自动上架：先查平台开没开这扇门
一家卖家在四个平台开了九家店，想把选品到利润整条链打通。逐个查下来，客服和淘宝集市店上架恰恰是官方接口最难拿到的两样，得在报价前查清。
对应档案通用做法，不对应单个项目 - 第 19 篇
毛利率不写成算式，AI 和报表各给各的答案
毛利率、回款率、账龄、「本月」都不止一种算法。不把算式写下来，模型的习惯和报表的默认值就会替你定，输出上还一个字都看不出来。
对应档案通用做法，不对应单个项目 - 第 18 篇
验证改动：客户的账号不是测试环境
为了验证一处采集改动，我们一晚上在客户账号上把全量跑了 4 遍、打了八千多次请求，第二天账号掉线、巡检停摆一天。验证要按代价从低到高排，全量只在最后跑一次。
- 第 17 篇
读拦了、写没拦：界面上藏掉的单子照样能改
工人一刷新就看不到已结账的工单，没刷新的页面却照样能改数量；老板要是照着屏幕转账，钱就会对不上，好在洞堵上时这家厂一笔工资都还没发。权限只有拦在服务器上才算数。
- 第 16 篇
给了完整编号，就不该退回尾号匹配
车架号、订单号、合同号这类编号，日常口头只报后几位。系统可以按后几位找，但用户给了完整编号却对不上时，绝不能自动退回模糊匹配。
- 第 15 篇
多买 Key、加内存、加核：先找到请求在哪排队
客户问多买 Key、加内存、加核能不能撑三十人。实测下来 Key 和内存加了没用，核只到 8 个有用，请求全堵在给资料打分排序那一步。扩容前先找到排队的地方。
- 第 14 篇
静默过滤：交付系统最大的病根
系统悄悄少给你几条数据还不说，比直接报错可怕得多。我们在三个项目里都栽过，后来定成铁律：凡是被过滤掉的记录，必须当面告警。
- 第 13 篇
台账算不清：同一个数有两处能填
流水类型选了支出，分类却是收款；余额靠手工往下滚，插一行后面全错。台账算不清，多半是同一个数有两处能填。我们的办法是每个数只留一个源头。
对应档案通用做法，不对应单个项目 - 第 12 篇
挂在一个人身上的系统：人走之后悄悄失效
自动化的执行身份、消息接收人、第三方 Key、知识库和唯一的管理员，常常都挂在某一个人身上。人一离职或调岗，它们悄悄失效，看上去却和一切正常没有两样。
对应档案通用做法，不对应单个项目 - 第 11 篇
同行素材：智能体把外人认成了创始人
拿同行爆款当素材喂给 AI 是常规做法。可没告诉它这些人是外人，它就把同行的名字说成了客户公司的创始人。防编造规则漏了客户公司自己。
- 第 10 篇
照着客户的 Excel 建表，交出去的是更难用的 Excel
接台账类项目最容易犯的错，是照着客户的表建字段。表里沉淀的是结果，真正缺的是过程；客户反复说「每次都要重新筛一遍」的那个东西，才是系统该有的一等公民。
- 第 9 篇
数字全由代码算，大模型只出配方
「每次生成的结果都不一样」是 AI 看板最常见的投诉。根治办法只有一个：金额和统计一律由程序算，模型只负责判断意图和决定怎么呈现。
- 第 8 篇
「毛重皮重反了」：机器没写错，错在列的顺序
客户报障说毛重皮重反了。我们先拿台账、计量系统和纸质票三方对账：数全对，错在列的顺序。三方一致时去改代码，才会真把数据改错。
- 第 7 篇
「没报错」不等于成功：自动化的判据要落在最终态
做网站自动化最容易被骗的地方，是脚本跑完没报错，可后台里那条记录根本没变。判据必须落在最终结果的列表页上。
- 第 6 篇
上线第一天就该有的三样东西：备份、哨兵、异地
一个知识库客户丢过四十多条用户提问，且不可恢复。从那以后，我们交付的每个系统上线当天就配齐每日备份、行数哨兵和异地副本。
- 第 5 篇
隐藏了成本价不等于挡住：五条出口一条都没关
隐藏成本价、锁视图、只给「可阅读」，数据照样能从切视图、详情页、导出、群推送、图表图例五条路出去。挡列要靠字段级权限，建库第一天就得问清套餐。
对应档案通用做法，不对应单个项目 - 第 4 篇
花钱担责的事，AI 只能出建议
一个看似省事的「自动修正」，会把约一成的收入金额改记成支出，而且不会报错。所以凡是花钱、担责、要专业判断的动作，我们只让 AI 出建议，人确认后再交给程序执行。
对应档案通用做法，不对应单个项目 - 第 3 篇
删数据的脚本，交付之后就是上了膛的枪
系统刚上线，我们顺手跑了一次演示数据脚本，清掉了客户当天亲手录的真实项目，备份里也没有。交付之后删任何数据，只认当场记下的确切编号。
- 第 2 篇
需求书里的「AI」：报价前先拆开归类
需求书里的「AI」底下压着算法、大模型、系统集成、视觉等不同的活。报价前不先分清是哪一种，档位能差十倍，交付的也会和客户想的对不上。
对应档案通用做法，不对应单个项目 - 第 1 篇
多维表格的报表是活的：没有「当时是多少」
改一个单价，去年的订单金额全跟着重算；改一个选项名，三年的分类被追溯改写，变更历史里却查不到。多维表格没有「关账」，该固化的值要自己存下来。
对应档案通用做法，不对应单个项目
这个主题下暂时没有笔记，点「全部」看其余几篇。
赶时间，只看这 20 条也行
- 第 20 篇
报价前逐平台、逐环节查开放能力，写死「官方接口、ERP 接口、模拟人工」三级路线和甲方要备的条件。
AI 客服和自动上架：先查平台开没开这扇门 → - 第 19 篇
口径词一律写成算式：分子分母取哪几项、含不含税、按哪个日期归期；表里存原始列，比率现算。
毛利率不写成算式，AI 和报表各给各的答案 → - 第 18 篇
验证按代价从低到高排：先模拟数据、再单件、再列表，全量只在最后跑一次；批量任务设每日上限。
验证改动：客户的账号不是测试环境 → - 第 17 篇
看和改用同一条权限规矩，写在服务器上、每个接口自己查；动钱那一下按此刻数据重算，对不上就不让发。
读拦了、写没拦：界面上藏掉的单子照样能改 → - 第 16 篇
给了完整编号只做精确匹配，对不上就报「未找到」；只给尾号又撞号时，列出全部候选让人选。
给了完整编号，就不该退回尾号匹配 → - 第 15 篇
客户问容量只拿实测回答：先找到请求真正排队的环节，再决定加 Key、加内存、加核还是加机器。
多买 Key、加内存、加核：先找到请求在哪排队 → - 第 14 篇
凡是被过滤、被跳过的记录都要当面说出来：导入、生成账单、批量操作，结果里必须有失败清单。
静默过滤：交付系统最大的病根 → - 第 13 篇
每个数只准一个源头：库存由出入库算，余额由流水算，收支方向由分类带出，能算出来的就不许填。
台账算不清：同一个数有两处能填 → - 第 12 篇
通知接收人走「岗位—当前负责人」小表，共用 Key 用公司账号申请，交接清单写清谁配的、谁领的、谁是管理员。
挂在一个人身上的系统：人走之后悄悄失效 → - 第 11 篇
喂同行素材先写明「这些人是外人」，规则里单开一条「关于客户公司自身」，复测必出直球陷阱题。
同行素材：智能体把外人认成了创始人 → - 第 10 篇
顺着客户反复抱怨的那句话找表里缺的东西；状态由过程算出来，不手填，不存当前值。
照着客户的 Excel 建表，交出去的是更难用的 Excel → - 第 9 篇
金额和统计一律由程序按固定口径算，模型只判断意图、决定怎么呈现。
数字全由代码算，大模型只出配方 → - 第 8 篇
客户报障先做台账、源头系统、原始凭证三方比对；三方一致就调表的列序，代码一个字不动。
「毛重皮重反了」：机器没写错，错在列的顺序 → - 第 7 篇
自动化的成功判据落在最终态的列表页；没到目标状态的一律判失败，推到群里 @ 到人。
「没报错」不等于成功：自动化的判据要落在最终态 → - 第 6 篇
上线当天配齐每日备份、行数哨兵和异地副本，一周内真从备份恢复一次。
上线第一天就该有的三样东西：备份、哨兵、异地 → - 第 5 篇
不该外传的列不靠隐藏、锁定和「可阅读」：要么走字段级权限，要么根本不放进对方能打开的文件。
隐藏了成本价不等于挡住：五条出口一条都没关 → - 第 4 篇
花钱、担责、要专业判断的动作，AI 只出建议；人确认过，再由确定性脚本照确认的内容执行。
花钱担责的事，AI 只能出建议 → - 第 3 篇
产生测试数据当场记下确切编号，删除只认这个编号；清库脚本只清自己登记过的记录。
删数据的脚本，交付之后就是上了膛的枪 → - 第 2 篇
需求书里每一处「AI」报价前先归类：算法、大模型、集成还是视觉；集成先要系统清单，视觉单独勘点。
需求书里的「AI」：报价前先拆开归类 → - 第 1 篇
单价、折扣率、汇率、税率、提成比例、成本价在成交那一刻存成死值，历史金额只认存下来的值。
多维表格的报表是活的：没有「当时是多少」 →