Excel 等文件临时建模能力核对

2026-10-21。范围：公开文档、Java 主仓库、CLI 0.1.25，以及下载后独立启动的标准 Launcher 0.1.33。时间分析由用户另一个会话推进，本轮不修改其模型、数据或运行环境。

结论

当前核对到的标准发行包中，没有发现“上传 Excel/CSV → 自动创建临时 QM → 查询”的公开入口。 不能将它写成教程中已经可调用的原生能力；结论不扩展到未检查的宿主自定义模块、历史分支或未来版本。

有三件事需要区分：

能力	核对结果
文件解析、识别工作表/表头/类型	Runtime API、CLI 与 MCP 工具目录未发现现成入口
文件数据加载后建立语义模型	已有 SQLite 数据源、TM/QM 和 Bundle 公开接入路径；文件解析加载由外部程序承担
查询结果进入内存再分析	Memory Grid 有相近能力，输入为受治理的有界结果，不是任意 Excel 路径

白皮书 v1 提到“临时结果表映射为临时 TM/QM”的架构方向，不能据此推断已经发布 Excel 上传接口。当前可选 DuckDB 实现中，临时表从 resolver 提供的 schema/rows 建立；没有因此在公开模型目录注册可发现的文件 QM。

本轮证据

Launcher 0.1.33 发行页，构建提交 0cae461a80d9bc93ecfa41b27278b358f8354e20。下载 JAR、README、PowerShell 启动脚本与 manifest，逐项 SHA256 与发行包校验清单一致。
按发行脚本在 127.0.0.1:18367 独立工作目录启动，PID 81300；未启用 Console/FAP。capabilities 为 Java、Runtime API v1、schemaVersion 2026-06-06、none-dev-test-only。
CLI --help、datasources/models/query 帮助未出现 Excel、CSV、文件上传或临时文件模型命令。
Runtime capabilities 未出现文件导入能力。authoring.releasePackage.import 是语义定义发行包导入，本实例还标为 disabled，不能当作业务数据导入。
公开 MCP 地址为 /mcp/analyst/rpc；完整 tools/list 返回 12 个工具，nextCursor 为空，没有文件导入工具。包含模型发现、元数据、query_model、compose_script、校验、图表与 viewer 等。
标准 JAR 包含 foggy-dataset-memory-grid-bridge，未包含可选 foggy-dataset-memory-grid-duckdb 或 DuckDB JDBC。不能直接把可选源码模块能力当作标准包默认能力。
Java 本地 main 与远端 main 均为 5eb60a863f0cb2e563771b31c790b6ba3c7bd614，工作树未修改。额外核对 RuntimeApiRoutes、Memory Grid 实现及外部资源校验；CLI 源码用于补充命令说明，实际探查调用的是已安装发行版 exe。

实际目录清单与摘要、环境记录、发行包校验。完整 capabilities、工具 Schema、命令帮助、日志和源码快照保留在 lab/nonstandard-discovery/。

首次将 /mcp 当作地址探查返回 404；按公开 runbook 改用 /mcp/analyst/rpc 后成功。这是调用地址修正，不是文件能力或引擎故障。未虚构文件上传 URL 来反复探测。

探查完成后仅停止本轮新建的 PID 81300，18367 端口已释放；原教学 Runtime 18067/PID 18068 仍在运行。没有注册 Bundle、改绑定或导入任何用户数据。

Memory Grid 的实际边界

输入是已经查询到的、带身份和来源约束的有界结果；跨模型对齐还要明确键、粒度和版本等。
临时内存表是执行过程的数据结构，不等于一个已公开的文件 QM，也不代表会自动完成字段含义和指标定义。
可选 DuckDB 模块的预检明确拒绝 read_csv、read_parquet、read_json 等外部表函数，连接也设置 enable_external_access=false。不能借它直接读取磁盘 Excel/CSV。
具体行数、单元格上限、handle 生命周期依部署和合同核对；当前没有可对 Excel 导入承诺的文件大小、工作表或行数限制。
README 中 viewer 预览缓存 60 分钟是展示链接生命周期，不是临时 QM 的过期机制。

来源：Memory Grid 参考、受控 Grid SQL 校验源码、可选 DuckDB 实现。这些源码用于确认边界，本轮未运行可选模块的测试或任意 Grid SQL。

现有公开接口怎样组合

可规划的链路是：AI 配合文件解析工具 → 人确认字段与业务口径 → 独立 SQLite → TM/QM → Foggy CLI 查询。

文件解析不是 Foggy 原生入口。本轮只验证了接口目录与帮助，没有新做 Excel 解析到查询的完整实验；下一步先用一个最小文件验证组合链路，再据此写实战正文。

在已启动的隔离 Runtime 上，解析程序生成 SQLite 与 TM/QM 后，公开 CLI 调用顺序如下。使用者替换 <url>、<sqlite-path>、<models-dir> 等参数；不是可直接粘贴的当前环境命令：

foggy-runtime --base-url <url> --namespace files datasources add --name files-sqlite --type sqlite --jdbc-url jdbc:sqlite:<sqlite-path>
foggy-runtime --base-url <url> --namespace files datasources test files-sqlite
foggy-runtime --base-url <url> --namespace files datasources bind --namespace files --data-source files-sqlite
foggy-runtime --base-url <url> --namespace files tables list --data-source files-sqlite
foggy-runtime --base-url <url> --namespace files tables inspect --data-source files-sqlite --table <table>
foggy-runtime --base-url <url> --namespace files models validate --models-dir <models-dir>
foggy-runtime --base-url <url> --namespace files bundles add --name file-analysis --path <models-dir>
foggy-runtime --base-url <url> --namespace files models refresh --model <QM>
foggy-runtime --base-url <url> --namespace files models describe <QM>
foggy-runtime --base-url <url> --namespace files query validate <QM> --payload <request.json>
foggy-runtime --base-url <url> --namespace files query execute <QM> --payload <request.json>

命令以 CLI 0.1.25 帮助和公开接入 runbook 核对。任何校验失败先修复，不继续发布/执行。JSON 请求只包含 DSL，命名空间与模型由 CLI 参数给出。

这条路线的限制：

SQLite 路径必须是 Runtime 所在机器可访问的文件；客户端路径不是上传。
TM/QM、SQLite 和注册信息按当前配置保留，不会因为叫“临时分析”就自动过期；需要明确保留、重载与清理策略。
类型和字段名可由 AI 辅助整理，单位、日期、粒度、标识符和重复记录处理仍需确认。Excel 公式的缓存值与重算也要单独验证。
数据变更与语义定义变更分开处理；刷新 QM 不会重新读取原 Excel 并自动同步 SQLite。
跨数据源 JOIN、Compose 和 Memory Grid 的组合必须逐项实测；不把“能注册多个数据源”当作“任意多源 JOIN 已支持”。

对系列规划的影响

按非标准数据与多源分析系列草案继续。第一篇先验证文件整理到 SQLite/TM/QM 的最小链路，保留将来替换成原生文件入口的空间。若要求无落盘、上传即问数，当前应列为待补接入能力，不能通过换名称冒充已经支持。