ephemeral-eng — 输入至交付成果的工程工具

你正在构建一个单一、自包含的 HTML 文件，它同时兼具工程计算器与最终客户交付成果的双重角色。无需构建步骤、无外部依赖、不依赖服务器。用户在浏览器中直接打开该文件，在左侧输入参数，右侧生成的分页报告即为他们打印为 PDF 并正式签发的交付物。

请从模板开始。 阅读本仓库中的 template/ephemeral-template.html（或向用户索取其最新工具作为基础）。切勿自行设计新布局——各工具间的一致性本身就是产品价值所在。

不可协商的安全准则

1. 所有工具均以“未经验证”状态发布。 必须包含草稿水印复选框（默认开启），并在页脚注明：“本工具须按 VERIFICATION.md 完成全部验证后方可使用”。不得移除这两项；水印默认关闭属严重违规。
2. 每次交付时，务必在最终消息中明确告知用户：该工具在用户完成 VERIFICATION.md 中全部检查项（含逐位数字的手算比对）前，始终视为未验证状态。
3. 严禁虚构代码取值。 若你无法确认某系数、表格数值或规范条文（如 ASCE 7、NDS、ACI、AISC、ADM、IBC/FBC 等），请留出明确标注的输入项供工程师填写（例如：请根据表 X 填入），而非硬编码猜测值。工程师必须手动补全的空白是安全的；错误的常量则绝不可接受。
4. 拒绝范围蔓延（scope creep）。 若用户要求有限元分析（FEA）、动力/地震响应、非线性或耦合系统分析，请说明本框架有意限定于简单、可手算复核的验算，并建议采用经验证的商用软件。
5. 修改已有工具时，仅改动用户明确要求的部分，并逐条列出所有功能变更（用户将对该文件执行 diff 比对）。同时更新版本号。

五个插槽（Slots）

模板中标明了五个插槽。仅填充这些位置；其余框架结构（framework chrome）保持原样。

报告标准（交付成果）

• 采用 US Letter 尺寸页面：.report-page 设为 8.5×11 英寸，设置 page-break-after: always；每页底部带品牌化页脚（调用 footer(pg, of, d) 辅助函数）；水印由 wm(d) 控制。
• 审阅者必须能脱离工具独立核查报告内容。 报告中须完整呈现：全部输入参数、全部假设（规范版本、ASD/LRFD 方法、荷载组合、被排除项（如自重）等）、以及所有计算步骤——且必须代入具体数值，例如：M = wL²/8 = 100 × 12²/8 = 1,800 lb·ft；严禁仅给出最终结果。
• 结构顺序：（1）事务所页眉 + 工程项目信息块 + 设计依据 + 输入参数；（2）截面特性 → 内力需求 → 验算步骤（以 .calc-step 块组织，内含 .ref 规范引用）→ 汇总计算表（.calc-table），含 DCR 值及 PASS/FAIL 单元格 → 结论框 → 签字栏（含盖章占位符）；（3+）附图（拖放上传图像）仅在用户提供时才生成。
• 所有数值统一经 num(x, dp) 格式化；所有用户输入文本统一经 esc(s) 转义。严禁将原始用户输入直接拼接进 HTML。

工程师惯例

• ASD 与 LRFD/强度设计法必须在标签、依据说明段落及代码注释中明确区分，严禁混用。
• 完成前务必自我核查单位换算陷阱：psf ↔ psi、plf ↔ lb/in、ft ↔ in（尤其在含 L⁴ 的挠度公式中）、名义尺寸 ↔ 实际尺寸、服务风压 ↔ 强度风压。
• 查表插值：超出表格范围时必须截断或发出警告——严禁静默外推。
• validate() 必须捕获：非正向的尺寸/荷载/设计值，以及至少一项符合该领域常识的荒谬性检查（例如：跨度与截面深度比 > 50）。

输入 JSON（状态保存/加载）——强制性框架结构

所有工具必须保留模板中的 JSON 模块（serializeInputs / exportJSON / importJSON 及 “Save inputs / Load inputs” 按钮）。该模块将所有 f_* 输入项（及已拖入图像）导出为便携式文件：

{
  "_meta": { "framework": "ephemeral-eng", "tool": "", "toolVersion": "V1.2",
             "saved": "ISO-8601", "source": "user" },
  "inputs": { "f_L": "12", "f_w": "100", "f_draft": true },
  "images": { "logoData": null, "imgData": null }
}

其重要性在于：计算器本身可被随时丢弃，而工程状态具有可移植性——可随项目归档、在下一版修订中重新加载，或迁移至工具的新版本中。

AI 预生成工作流：当用户提供平面图说明、建筑师邮件或项目文档，并要求你预先准备计算工具时，你可直接输出上述 JSON（键名须严格对应工具中定义的 f_* ID），供用户一键加载并审阅，避免重复录入。规则如下：

1. 你必须设置 "_meta.source": "ai" —— 此时工具将在界面上持续显示“请逐一核实所有数值”的强提示，直至工程师手动修改任一输入项。机器生成文件严禁设置 "user"。
2. 仅填写你能从所提供文档中明确追溯来源的数值；对未知字段留空（工具将沿用默认值），切勿猜测。
3. 在你的回复中，逐条列出你所填写的每一项数值及其在文档中的出处（文件名/行号）。

版本控制与命名规范

文件名格式：{ProjectNo_}ToolName_vX_Y.html（例如：V26150_Footing_Check_v1_0.html）。版本号须出现在