展开本页目录
开始前准备什么
- Jupyter AI v3.2.0、JupyterLab4和另装的Agent/ACP适配器；不会自带免费Agent。参考读取用openpyxl，XLSX创建/渲染用artifact-tool。BSD-3-Clause；Agent模型费用另计。
- 原生三工作簿已由artifact-tool生成；Python只读真实XLSX后合并，保留file/sheet/row并隔离3条异常，结果已输出。未运行Jupyter AI Agent。
- 使用原创或获授权资料；实际目标工具运行记录与本包参考分别保存。
- 查看三份输入和不一致表头
- 准备Jupyter AI和实际Agent
- 把列名映射与拒绝规则交给Agent
- 审查代码后运行合并Notebook
- 分开处理正常和拒绝行
- 逐来源核对行数守恒
- 重启内核从头复跑
- 导出可打开的表和代码
原生输入、提示词、8步说明、独立参考和材料检查；运行范围见README。
区分目标工具操作、人工参考和本地实际执行。
本题独立原生输入或参考文件；身份和使用方法见README。
本题独立原生输入或参考文件；身份和使用方法见README。
本题独立原生输入或参考文件；身份和使用方法见README。
1. 查看三份输入和不一致表头
打开north.xlsx的AM/PM、south.xlsx的Registrations及broken-schema.xlsx。表头分别用编号/报名号、姓名/联系人、人数/名额；south含空编号与0人，broken-schema缺人数列。本题一共7条数据，不能静默跳过坏Sheet。
2. 准备Jupyter AI和实际Agent
在JupyterLab创建新Notebook和Chat，确认v3.2.0及至少一个可用Agent。部分Agent需ACP适配器，模型授权由其自身决定；不用旧版/generate按钮当本题步骤，也不向模型发送真实报名信息。
3. 把列名映射与拒绝规则交给Agent
上传三份文件，使用prompt.md要求先检查schema再生成处理代码。id只作字符串保留，count必须正整数，来源字段必须来自真实文件/Sheet/行号，不让模型事后编一列来源名。
4. 审查代码后运行合并Notebook
确认代码只读取指定文件，输出到新文件，禁止覆盖输入。先运行读取/表头预览单元格，再运行规范化与校验。不要把本包merge_reference.py的结果说成Jupyter AI已经完成合并。
5. 分开处理正常和拒绝行
参考结果为4条正常、3条拒绝：空ID、0人数、缺列各1条。拒绝行应保留原值、原因及来源，不能靠填1人使总表看起来完整。核对合法的N01/N02/N03/S01均保留。
6. 逐来源核对行数守恒
按north AM 2、PM 1、south 3、broken 1对账，合入+拒绝必须仍为7。检查source_row为原Sheet的实际一基Excel行号（数据从第2行开始），而不是合并后的新序号。
7. 重启内核从头复跑
保存Notebook后重新启动内核，Run All，使用同一原始文件确认仍为4/3且输出一致。全新环境运行不能依赖聊天中曾定义但未写入Notebook的变量；具体隐藏依赖排查见相邻Jupyter题。
8. 导出可打开的表和代码
实际输出可交merged/rejected CSV或XLSX，但文件格式要写准确。本包提供真实merged-reference.xlsx与rejected-reference.xlsx及JSON；保留模型原代码、人工修正和版本记录，对外共享前去掉账号密钥。
怎样确认已经完成
- 参考结果为4条正常、3条拒绝：空ID、0人数、缺列各1条。拒绝行应保留原值、原因及来源，不能靠填1人使总表看起来完整。核对合法的N01/N02/N03/S01均保留。
- 保存Notebook后重新启动内核，Run All，使用同一原始文件确认仍为4/3且输出一致。全新环境运行不能依赖聊天中曾定义但未写入Notebook的变量；具体隐藏依赖排查见相邻Jupyter题。
- 原生三工作簿已由artifact-tool生成；Python只读真实XLSX后合并，保留file/sheet/row并隔离3条异常，结果已输出。未运行Jupyter AI Agent。
常见问题
AI 合并多个 Excel 工作表需要什么版本和条件？
Jupyter AI v3.2.0、JupyterLab4和另装的Agent/ACP适配器；不会自带免费Agent。参考读取用openpyxl，XLSX创建/渲染用artifact-tool。BSD-3-Clause；Agent模型费用另计。
几十张格式不一样的Excel怎么合并，这份练习能证明哪些部分？
原生三工作簿已由artifact-tool生成；Python只读真实XLSX后合并，保留file/sheet/row并隔离3条异常，结果已输出。未运行Jupyter AI Agent。
合表还要知道每一行来自哪张表？
保存Notebook后重新启动内核，Run All，使用同一原始文件确认仍为4/3且输出一致。全新环境运行不能依赖聊天中曾定义但未写入Notebook的变量；具体隐藏依赖排查见相邻Jupyter题。
Jupyter AI merge Excel sheets normalize headers source sheet provenance 对应哪份可下载材料？
从本题独立练习包开始，先看north.xlsx；按正文目标工具步骤生成自己的结果，不能把人工或参考算法文件改名当成模型输出。