2 Commits

Include renames

Author	SHA1	Message	Date
tao.chenandClaude	2570713fbf	tools: 为 spark_submit 的未 mint 绝对路径增加可观测警告 ... LLM 有时会把自己本地的绝对路径直接传给 spark_submit；这个路径在 MCP 服务器上不存在，spark-submit 会失败，但当前 translateArgs 是静默透传， 问题难以定位。添加 logger.Warn("spark_submit.unminted_path")，对 服务器未 mint 的绝对路径/路径型参数发出警告，同时保持透传不变。 生产环境中这条警告是诚实的可观测信号，而不是回归指标：集群本地合法路径 （如 /opt/spark/examples/pi.py）也会触发警告，这是设计上的，因为我们 无法区分“合法集群路径”和“LLM 本地路径”。 测试锁定： - minted_path_no_warn：上传文件返回的 path 不触发警告 - cluster_local_path_warns：未 mint 的绝对路径触发一次警告且 path 正确 - non_path_args_never_warn：--class、Main、--master 等普通参数不触发警告 translateArgs 对 logger 做 nil-safe 处理：测试中 deps.Logger 未设置时不 会 panic，也不会产生日志，保持现有测试的简洁。 Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-13 19:18:35 +08:00
tao.chenandClaude	f374ebfdb4	uploads,tools,config,main: 将 upload_file 返回路径改为服务器端绝对路径并透传给 spark_submit ... 之前 upload_file 把文件写到 DataDir/uploads/<filename>，返回相对路径 uploads/hello.txt。MCP 服务器与 agent 不在同一台机器，agent 无法构造服务 器本地路径，因此 spark_submit 无法定位脚本。 改为由新的 internal/uploads 包 mint 一个 32 字符十六进制 file_id，文件落盘为 DataDir/uploads/<file_id>，元数据写入 <file_id>.meta.json（原始文件名只存在 sidecar 里）。upload_file 返回 {file_id, path, name, size, sha256}，其中 path 是绝对路径。spark_submit 的 description 明确要求 LLM 直接把 upload_file 返回 的 path 放进 args，不要自己构造路径。 为什么只在描述里约束而不在代码里拒绝非 mint 的绝对路径：集群本地已有路径 （如 /opt/spark/examples/pi.py）是合法的 spark-submit 参数，代码不能替 LLM 拒绝。 测试锁定： - internal/uploads: Save 往返、AbsPath/Validate 非法路径、Sweep 过期/未过期/ 孤立 sidecar - internal/mcp/tools: upload_file 新响应字段、spark_submit 透传 mint 路径与 集群本地路径 刻意未做：S3/HDFS 上传、给 spark_submit 新增 file_id 参数、在代码层面拒绝 集群本地绝对路径。 破坏性变更：upload_file 响应从相对 path 改为绝对 path，并新增 file_id/name/ sha256 字段。该工具尚无外部调用者。 Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-13 19:13:14 +08:00