📘 LRDT 使用指南 — V0.2.0

LRDT（Liquid Rocket Data Transfer）是一套面向液体火箭发动机研发团队的工程数据管理平台，提供从模块到图纸的全层级管理、AI 助手驱动的数据库操作、智能标准件联想及多用户协同功能。

1. 数据层级

系统采用四层树形数据模型：

层级	说明	示例
项目	最顶层隔离单元，不同项目数据完全隔离	AE1411A 参宿五
模块	逻辑分组，按子系统划分	推力室总成 / 涡轮泵系统
部件	物理制造单元，有编号、材料、状态、版本	喷注器 TC-001
图纸 / 标准件	挂载于部件之下的文件和配件	.sldprt, .dwg, M8×30 螺栓

2. 界面导航

入口	功能
📊 仪表板	统计概览（模块/部件/图纸/冻结/完工率/标准件）、部件↔图纸互查、团队概况、最近活动
📐 部件与图纸	模块/部件/图纸的全部操作：新建、编辑、上传、下载、打包、标准件管理
🔄 版本历史	查看所有版本变更记录
📈 生产进度	追踪部件生产状态、装配进度
🔩 标准件	全局标准件视图
📤 数据传递	跨项目数据传递记录
🚚 物流追踪	快递/物流状态追踪
📝 反馈看板	用户反馈、评论、点赞、管理员导出
💾 软件平台	内部软件分发与自动更新（PumpHMI 等），严格权限控制 + 下载审计
⚙️ 管理面板	用户审批、角色管理、权限管理、项目管理、公告管理（管理员专属）
🤖 AI 助手	右侧浮动面板，自然语言操作数据库

3. 部件状态标签

状态	含义
designing	设计中，数据可能不完整
reviewing	评审中，等待确认
frozen	已冻结，设计确定

4. 公告系统

每天首次打开页面自动弹出版本公告（当天关闭后不再自动弹）
顶栏 📢 按钮可随时手动打开
公告支持翻页：管理员自定义公告在前，版本更新日志在最后
管理员可在 ⚙️ 管理面板 → 📢 公告管理中发布/编辑/删除公告

5. 反馈看板

角色	权限
所有用户	✍️ 提交反馈 · ❤️ 点赞 · 💬 评论
反馈作者	✏️ 编辑自己的反馈
管理员	✏️ 编辑任意 · 🗑️ 删除（二次确认+不可恢复声明）· 删除评论 · 📥 导出 TXT

6. 操作记录

每个部件行的 📜 按钮查看历史变动日志，记录操作人（AI 操作标注 (+AI)），时间戳不可伪造。

撤销功能：AI 操作完成后，右侧撤销栈保存所有已执行步骤，可逐步撤销。

📤 图纸上传、文档绑定与打包下载

1. 上传入口对照

入口位置	类型	说明
顶部工具栏「📤 上传图纸」	全局	需手动选择归属部件
部件行「📤 上传图纸」	部件级	部件自动锁定，推荐使用
模块行「📤 上传装配体」	模块级	仅限该模块内部件，适合模块 .sldasm
顶部「📤 上传项目装配体」	项目级	可选项目内任意部件，适合顶层装配体
图纸行「📎」	文档绑定	为已上传图纸附加说明文档

2. 支持的文件格式与自动分类

分类码	分类名	格式
`ASM`	📦 装配体总图	.sldasm
`AM3D`	🧊 增材 3D 模型	.sldprt (AM), .stl, .step (AM)
`MC3D`	⚙️ 机加 3D 模型	.sldprt, .step, .stp, .iges
`AM2D`	📐 增材工程图	.slddrw (AM), .dwg (AM)
`MC2D`	📐 机加工程图	.dwg, .dxf, .slddrw
`DOC`	📝 描述文档	.doc, .docx, .txt, .md, .xlsx, .pptx, .csv
`STD`	📋 标准参考	.pdf, .png, .jpg, .jpeg
`MDL`	🔷 仿真模型	.mdl, .slx, .sim

3. 装配体上传注意事项

⚠️ 上传 .sldasm 时，若未同时选择配套 .sldprt 文件，系统会弹出提醒：
「他人打开装配体时需要所有引用的 .sldprt 文件，建议同时上传。」
点击「仍然继续」可忽略提醒单独上传装配体。

💡 下载装配体打包时会自动包含同模块所有 .sldprt，ZIP 内保留原始文件名，SolidWorks 可直接打开。

4. 附加说明文档 📎

在「部件与图纸」页找到目标图纸行
点击行末 📎 按钮，选择文档文件（.pdf/.doc/.docx/.txt/.md 等）
上传完成后，图纸行显示 📝1 徽章，表示已绑定 1 个文档
也可独立为模块/部件上传描述文档（分类选 DOC）

5. 打包下载

按钮	位置	范围
📥 打包下载全部	顶部工具栏	当前项目所有文件
📥 打包下载	模块行	该模块所有文件

下载时弹出选项框，可勾选是否包含说明文档（默认不包含，工程图纸含文件强制勾选）。

ZIP 内文件使用原始文件名（非系统生成的 UUID 命名），保证 SolidWorks 引用关系完整，拷贝到同一目录即可被 SW 找到。

6. 命名规范

系统内部存储路径格式：{项目简称}/{部件编号}/{分类码}/V{版本号}/{原始文件名}

下载时还原为原始文件名，不含系统路径前缀。

7. 版本管理

每次上传同分类文件时，旧版本被标记为历史版本（不删除）
版本号格式：V1.0 → V2.0 自动递增
可在版本历史页查看所有历史版本并下载

🔩 标准件智能联想库

内置 1600+ 条标准件规格，支持分类筛选 + 关键词联想，覆盖航天工程常用紧固件、管路、轴承、密封及仪表。

1. 使用方式

上传图纸第二步，或部件行「🔩 编辑标准件」进入
左侧选择分类，右侧输入关键词（如 M8 / AN6 / NPT）触发联想
从下拉结果中选择，填写数量（默认 1）后点击「添加」

2. 分类体系

分类	标准	规格范围
螺栓	GB/T 5782/5783/70.1/6177/818/819/77/6564, SAE J429 UNC/UNF, AN3~20, MS20004	M3~M24, 1/4"~1"
螺母	GB/T 6170/6172/6178/889, ASME B18.2.2, AN310/315/365	M4~M24
垫片	GB/T 97.1/93/858, AN960	M4~M30
密封件	GB/T 3452.1 O型圈, HG/T 2579 金属缠绕垫, AN6227 ORB O-Ring	Φ6~Φ100
管接头	GB/T 3733/JB/T 6381 卡套, AN816/819/822/833 37°, SAE J1926 ORB	Φ4~Φ38, AN-2~-16
管转接 ★新	跨体系互转：NPT/PT/BSP/AN37°/ORB/公制	1/8"~1", -2~-16, M10~M22
轴承	GB/T 276/292/283/297/301/9163	60xx/62xx/63xx/72xx/NUxxx/3xxxx/51xxx/GE
弹簧	GB/T 1239.2/1239.3/1972	压簧/拉簧/碟簧
紧固件	GB/T 119/117/91/1096/894.1/893.1, DIN 6799	销/键/挡圈
仪器仪表	压力表/变送器/热电偶/PT100/流量计/液位计	0~60 MPa
阀门	球阀/截止/闸/止回/蝶/针/安全/减压/电磁阀	DN6~DN50

3. 管转接详解

「管转接」分类覆盖以下所有互转组合：

异种体系互转（15 种组合）：NPT↔PT, NPT↔BSP, NPT↔AN37°, NPT↔ORB, NPT↔公制, PT↔BSP, PT↔AN37°, PT↔ORB, PT↔公制, BSP↔AN37°, BSP↔ORB, BSP↔公制, AN37°↔ORB, AN37°↔公制, ORB↔公制
同体系变径：NPT/PT/BSP 各 5 条 · ORB 8 条 · AN37° 7 条 · 公制 6 条

💡 搜索「转接」可显示全部转接件；搜索体系名（如「ORB」「NPT」）可过滤相关转接。

🤖 AI 助手

AI 助手由 DeepSeek API 驱动，可通过自然语言直接操作工程数据库，所有写操作均须人工确认。

1. 操作流程

在 AI 对话框输入指令（如「在推力室总成下创建三个部件」）
AI 返回操作预览清单：📋 待确认操作清单（共 N 步）
确认无误后点击「✅ 确认全部执行」，AI 依次执行所有步骤
右侧撤销栈记录所有已执行操作，可逐步撤销

💡 查询类操作（queryProject）会自动执行，无需点击确认；只有创建/编辑/删除才需要确认。

2. 支持的操作指令

指令类型	示例说明
createModule	创建模块，指定名称和描述
editModule	修改模块名称或描述
deleteModule	删除模块（含子部件移至未分类）
createPart	创建部件，指定名称、模块、编号、材料、状态
editPart	修改部件材料、状态、名称等字段
deletePart	删除部件（危险操作，强制警告）
addStandardPart	为部件添加标准件，指定标准、规格、数量
queryProject	查询项目结构（树状），自动执行无需确认

3. 上下文机制

每次对话，系统自动将当前项目的模块→部件树状结构（含 ID、编号、材料、状态）注入 AI 上下文：

📦 推力室总成(id:abc123)
  - 喷注器[TC-001][CuCrZr][designing](id:xyz456)
  - 燃烧室[TC-002][GH4169][frozen](id:def789)
📦 涡轮泵系统(id:ghi012)
  - 主泵[TP-001][铝合金][reviewing](id:jkl345)

AI 可直接使用这些 ID 进行操作，无需先查询再操作，批量操作一次返回所有 ACTION。

4. 批量 PDF BOM 解析

点击 AI 面板「📄 PDF BOM 解析」
上传 PDF 文件，AI 自动提取 BOM 表格
弹出确认框，可勾选/编辑各行
确认后批量创建部件

5. 每日报告

点击「📊 生成今日报告」，AI 读取当前项目数据，生成进展摘要，可一键复制。

6. 注意事项

⚠️ 删除操作（deletePart/deleteModule）会显示红色 [⚠️危险操作] 警告，且需要二次人工确认，不可轻易执行。

💡 操作记录中，AI 执行的操作会显示「用户名 (+AI)」，便于后期审计。

🏗️ 系统架构

1. 技术栈

层次	技术	说明
前端框架	Vanilla JS (ES6+) + HTML5 + CSS3	零构建工具，模块化 IIFE 组织
云数据库	Firebase Firestore	实时同步，多用户并发安全
文件存储	Firebase Storage / IndexedDB	云端存大文件，本地 IndexedDB 离线回退
认证	Firebase Auth	邮箱密码登录，管理员审批制
部署	Cloudflare Pages	全球 CDN + 自动 HTTPS + 边缘缓存
AI 引擎	DeepSeek API	OpenAI 兼容接口，通过 Cloudflare Worker 代理
ZIP 生成	JSZip v3.10.1 (CDN)	纯前端打包，无需后端
PDF 解析	PDF.js (CDN)	前端 PDF 文本提取，用于 BOM 解析
PWA	Service Worker + manifest.json	可安装，离线部分功能可用

2. 数据模型 (Firestore Collections)

集合	主要字段
`projects`	name, description, createdBy, createdAt
`modules`	projectId, name, description, sortOrder
`parts`	projectId, moduleId, name, partNumber, material, status, version, team
`drawings`	projectId, partId, fileName, originalName, category, fileUrl, notes, createdAt
`standard_parts`	projectId, partId, standard, specification, quantity, category
`op_logs`	projectId, action, target, detail, actor, createdAt
`versions`	projectId, entityType, entityId, versionNumber, changes, snapshot
`announcements`	title, content, author, createdAt, active
`feedback`	userId, userName, content, likes[], comments[], createdAt
`users`	uid, email, displayName, role, team, approved, pushEnabled

3. 前端模块划分

文件	职责
`app.js`	路由、项目选择、模态框、Toast、导航高亮
`auth.js`	Firebase Auth 封装、权限检查、用户信息
`db.js`	Firestore CRUD 统一封装（add/update/delete/getAll/getById）
`storage.js`	Firebase Storage 上传/下载，含进度回调
`drawings.js`	部件与图纸页（最大模块 ~80KB），上传/下载/打包/标准件/文档绑定
`dashboard.js`	仪表板统计、互查搜索、团队概况
`ai-assistant.js`	AI 对话、ACTION 解析、确认流程、撤销栈、PDF BOM
`std-parts-db.js`	1600+ 条标准件内置数据库（纯前端，无需查询云端）
`announcement.js`	公告弹窗、翻页、管理员发布/编辑/删除
`feedback.js`	反馈看板：提交/编辑/删除/点赞/评论/导出
`admin.js`	用户审批、角色管理、权限管理、项目管理、公告管理、推送设置
`software.js`	软件平台：版本检测、分片下载、权限校验、下载审计
`config.js`	全局配置：分类列表、状态映射、API 配置

4. AI 引擎原理

采用二段提交架构：

系统将项目结构树 + 指令格式模板注入 system prompt
DeepSeek 返回自然语言解释 + 内嵌 <ACTION>{JSON}</ACTION> 操作标签
前端正则解析所有 ACTION，分离 queryProject（自动执行）和写操作（待确认）
用户点击确认 → 顺序执行所有写操作 → 结果写入 op_logs → 推送撤销栈

5. Cloudflare Workers

Worker 文件	功能
`cloudflare-worker-deepseek-proxy.js`	DeepSeek API 反代（隐藏 API Key，处理 CORS）
`cloudflare-worker-daily-push.js`	Cron 触发，每日推送项目日报到用户邮件
`cloudflare-worker-kuaidi100.js`	快递 100 API 反代，用于物流查询

6. 权限体系

角色	权限
admin（管理员）	全部权限：用户审批/删除、项目管理、公告发布、软件下载、所有数据读写删
lead（组长）	查看所有数据、上传、编辑、软件/图纸下载（可被限制）
member（成员）	查看所有数据、上传图纸/文档、软件/图纸下载（受细粒度权限控制）
viewer（访客）	只读，无下载权限
pending（待审批）	注册后等待管理员审批，审批前无法使用功能

6.1 细粒度权限预设

预设	说明
全权限	所有功能可用
禁止下载软件	可操作数据和下载图纸，但不可下载软件
禁止下载图纸	可操作数据和下载软件，但不可下载图纸
仅观看	只读浏览，不可下载任何文件

7. 离线与缓存

Service Worker 缓存静态资源（JS/CSS/HTML）
IndexedDB 缓存最近查询的 Firestore 数据，断网时可只读浏览
文件上传需要网络连接，离线时不可上传

📋 更新日志

V0.2.0 [Build 0706a] — 2026-07-06

💾 软件分发平台：新增左侧「软件平台」入口，支持内部软件分发 + 分片下载 + 自动更新
🔒 细粒度权限系统：4 种预设（全权限/禁止下载软件/禁止下载图纸/仅观看），管理面板可配置
🔧 PumpHMI v1.1.0：修复图表吃线/卡顿/对不齐问题，提升界面亮度和曲线可见度
📦 自动化部署流水线：build_release.py 一键完成打包→分片→SHA256→部署同步
🛡️ 安全增强：Cloudflare Function 日志审计、下载频率限制、JWT 身份验证预留
📊 管理面板新增权限列（细粒度权限管理）
🔄 Service Worker 缓存版本升级机制优化

V0.1.5 [Build 0513d] — 2026-05-13

🤖 修复 AI 部件归属理解问题（上下文改为模块→部件树状结构）
🤖 修复多步操作需手动继续（queryProject 自动执行，批量操作一次返回）
📢 公告系统：管理员可发布/编辑/删除；公告弹窗支持翻页；每天自动弹一次
📝 反馈看板：提交/编辑/删除（双重确认）/点赞/评论/管理员导出 TXT
🔩 新增「管转接」分类：NPT/PT/BSP/AN37°/ORB/公制 15 种互转 + 各自变径
📊 仪表板新增模块数统计卡片（现为 6 项）
📢 顶栏新增 📢 公告按钮，随时查看
⚙️ 管理面板新增「📢 公告管理」标签页

V0.1.5 [Build 0513c] — 2026-05-13

📤 部件行新增「📤 上传图纸」按钮，部件自动锁定
📤 模块行新增「📤 上传装配体」；顶部新增「📤 上传项目装配体」
⚠️ 上传 .sldasm 时自动检测 .sldprt 缺失并提醒
📎 图纸行新增「📎 附加说明文档」功能，绑定成功显示 📝 徽章
📥 打包下载弹出选项框，可勾选是否含说明文档
📝 新增「描述文档(DOC)」分类
🔢 标准件关联时支持数量输入
📋 帮助文档全面重写（6个标签页）
🔖 版本号规范化为 V0.1.5

V0.1.4 — 2026-05-12

🔩 标准件数据库抽离为 std-parts-db.js，1554 条覆盖公制/美标/航空/管螺纹/轴承/阀门
🔒 上传过程中禁用关闭按钮，防止误触中断
📊 上传实时进度显示
🐛 修复上传 DOM 销毁后静默失败 bug

V0.1.3 — 2026-05-11

🤖 AI 助手：DeepSeek 集成 + 二段确认机制 + 撤销栈
📜 操作日志：所有 AI/人工操作记录，标注责任人
📐 图纸上传完整流程：分类识别、部件关联、版本追踪
📊 仪表板：部件↔图纸互查

V0.1.0 — 2026-05-11（初版）

Firebase Auth/Firestore/Storage 集成
模块→部件→图纸四层数据结构
Cloudflare Pages 部署，管理员审批制
PWA 支持（可安装，Service Worker 缓存）