节后aionclaw更新导致用户自定义口径失效，需手动迁移输入映射、数据过滤器和派生字段公式三类配置；通过导出对比json结构变更，再用手动重建或json注入方式复现，并用测试数据逐行验证一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
节后开工第一天，你刚把三张销售表合并完，AionClaw提示有新版本可更新；更新后一跑分析脚本，发现“月度完成率”字段计算结果全变了——不是模型换了，是底层数据清洗逻辑被重置了，原来自定义的“剔除试用订单”“按签约日归期”等口径全部失效。
确认哪些口径属于“用户定义型”而非“系统默认型”
打开 AionClaw 设置页 → 进入【技能管理】→ 查看「销售分析」技能详情页。重点检查三项：① 输入字段映射表（是否手动将“合同签订时间”映射为“归档周期”）；② 数据过滤器（是否添加过 WHERE status NOT IN ('trial', 'cancelled')）；③ 派生字段公式（如完成率 = 实际回款 / 合同金额 * 100，且分母加了 IFNULL 处理）。【只有这三类配置才需人工迁移，系统内置的“销售额求和”“去重客户数”等基础聚合不在此列】
若该技能由社区导入，点击右上角「查看源码」，搜索关键词 filter、CASE WHEN、COALESCE——这些就是你必须手动复现的口径锚点。
导出旧版口径配置并定位变更点
在旧版本 AionClaw 中执行命令：/export-skill-config sales_analysis --format json。
生成的 JSON 文件里，重点关注 preprocess_rules 和 field_calculations 两个键。用 VS Code 打开，对比 v2026.8.1 与 v2026.9.5 的 release notes，发现 preprocess_rules 已从数组结构改为对象嵌套结构，旧版中第 3 条规则的 condition 字段名在新版里已更名为 filter_expr。
这一步不做对比直接覆盖，会导致所有过滤条件被忽略。
在新版本中重建分析口径
方法一：手动重建（推荐用于关键口径）
① 新建空白技能，命名为「销售分析_v2」；
② 在「字段映射」面板中，将原始表的「contract_signed_at」拖入「归档周期」输入框，点击右侧齿轮图标，选择「按年月截断」；
③ 切换到「数据过滤」标签页，点击「+ 添加规则」，在表达式框中输入：status != 'trial' AND status != 'cancelled'；
④ 进入「派生字段」，新增字段「月度完成率」，公式栏粘贴：IFNULL(actual_payment, 0) / NULLIF(contract_amount, 0) * 100。
方法二：JSON 注入（仅限熟悉结构的用户）
将上一步导出的 JSON 中 preprocess_rules 内容复制，替换新版本对应字段名（condition → filter_expr），保存为 sales_v2.json，执行：/import-skill-config sales_v2.json。
【注入前必须删掉旧 JSON 中的 _id、created_at 等运行时字段，否则导入失败】
验证口径一致性
用同一份测试数据（例如 2026年9月销售明细表）分别跑旧版技能和新版技能，导出两份结果 Excel。
在 Excel 中对「月度完成率」列使用公式 =EXACT(A2,B2) 校验逐行是否一致；若出现 FALSE，定位到对应行，检查该订单的 status 值是否为 'trial' 或 'cancelled'——若是，说明新版本过滤规则未生效，返回上一步检查 filter_expr 语法是否漏写括号。
这一步验证通过后，即可停用旧技能，将新技能设为默认。
