文件接入与第二十九至三十四章

第 30—34 章现已整批完成，详见系列实操与复跑。当前仍使用独立18368；文件清洗、月度合并、旧库、目标对齐分别有独立 Namespace，自动化入口为 file-regression-current，不覆盖第33章v1示例。以下保留第二十九章最小实验的原数据、计数及能力范围；后续完整结果与失败检查不混入原13项计数。

2026-10-25。Launcher 0.1.42、CLI 0.1.25、Java 17.0.12、Python 3.11.5，openpyxl 3.1.5。独立 Runtime http://127.0.0.1:18368、Namespace file-invoices，数据源 files-sqlite；CSV 副本使用 file-csv / files-csv-sqlite。本次重启后 PID 117468，实际状态以 launcher-start.json 为准。匿名开发测试，Console/FAP 关闭，18067 不动。

方案与文件

文件解析属于外部准备层，Foggy 负责普通 TM/QM 与语义查询。本轮没有使用原生文件上传、会话临时 QM 或自动 TTL。

Excel 样例与CSV 同批样例：来自 Chinook 2012 年 Invoice，83 张、47 位客户、20 个账单国家、477.53。客户编码补足五位，其他事实不改；来源记录保留原始映射及摘要。
文件适配器：固定“账单”工作表、五列与固定值合同，加载到 data/files.sqlite 或 CSV 独立副本，保留源文件摘要及原行号。它不是通用脏 Excel 清洗器；公式、类型不符、缺值或重复编号明确拒绝。
账单 TM / QM：本章只用这两个文件。另两对目标模型仅服务跨源能力实验。
教学目标：四条人为设定记录，保存在 targets.sqlite 的 external_targets，另复制到 files.sqlite 的 teaching_targets 作为同库对照，不是原始事实。
实时 Markdown为引擎从已加载代码生成的本次快照，无须提前维护。

原文件保持不变。适配器完整替换自己管理的 file_invoices 表，重复加载不会增加记录；不是多文件增量规则。金额按样例两位小数，原始记录的 Decimal 对账与数据库浮点容差分开处理，不以显示两位小数宣称任意精度计算。仅刷新 QM 不会重读 Excel。

已执行与验收

规范文件、CSV、两侧单独查询与同库对齐共 13 项正常执行通过，见验收；每个语义请求先 validate，再 execute，Compose 同库对照另经过 preview。结果按原始只读账单、Decimal 和教学目标 JSON 独立核对，数据、排序及空值逐字段比较。

范围	实际结果
总量与日期	83 张 / 477.53；一月范围与原始行一致，2013 年为空
分组与明细	国家 20 组、客户 47 位、全部 83 行一致；`00026` 正确筛选出 25.84
重复加载	同一文件重载后仍 83 张 / 477.53
CSV	独立副本的总额和客户汇总与 Excel 一致
目标对齐	两侧单独查各 4 行，同库 JOIN 3 位匹配、00999 未匹配；不补零

重启后注册表内容不变，模型仍可发现与查询；额外执行总额及前三客户两题通过，见生命周期与补验。前三为 00026 / 25.84、00034 / 24.77、00013 / 24.75。

直接跨源 JOIN 不是通过项目：validate / preview 虽通过，execute 报缺表。实际请求 13-cross-source、错误响应与问题记录分开保存；同库对照 14-prepared-same-source正常。尚未提交 GitHub issue。

完整能力边界见0.1.42 核对。未验证任意跨源执行、Memory Grid 生产接入、公式计算、旧 xls、多文件增量、生产身份或性能；未另开干净 AI 会话仅凭正文提示词验收。

复跑

已有本目录文件时，在资料项目根目录执行，文件依赖可用 python -m pip install -r lab/files/requirements.txt 准备。本机实测使用已提供 openpyxl 的工作区 Python，没有覆盖全局 Skill 或 CLI。

./lab/files/start-runtime.ps1
# 已运行时不要重复启动；先核对 launcher-start.json 和监听进程。
python -X utf8 lab/checks/discover-file-surface-0.1.42.py
python -X utf8 lab/checks/prepare-files-runtime.py
python -X utf8 lab/checks/verify-file-onboarding-0.1.42.py

准备脚本采用当前主机的 bundled Python 路径，仅作为本次环境复现记录；适配器本身接受普通 Python，读取代码与依赖后可按读者环境运行。查询验证脚本遇到跨源校验通过会在隔离库执行一次以记录失败，不能用作生产任务。

重建输入时，生成来源读取公开 Chinook 副本，工作簿构建器用 Artifact Tool 输出并另存到 inputs；这属于制作教学样例，不是读者文件接入的运行依赖。正式查询只读取现有文件。

本次环境保留用于第二十九章审阅。普通数据库、模型和注册信息不会自动过期；关闭服务后仍保留目录。清理时只处理本隔离实例的注册和文件，保留输入与验收记录；不要清理前面章节的 18067 工作目录。