离线帮助与常见问题

隐私与安全

• 本地优先（Local-first）：所有 CSV / Excel 解析、字段映射、规则校验、修复与报告生成都在你的浏览器内完成， 不会上传到任何业务后端或第三方服务。
• 无 AI 依赖：核心功能为确定性纯函数，无需配置任何 API Key 即可完整使用；本产品不内置会外发数据的 AI 调用。
• 本地存储：当前项目自动保存在浏览器本地存储（localStorage，键名 twinflow-project-v1）， 刷新或重开页面后自动恢复。数据仅存于本机浏览器，不会离开设备。
• 清空数据：进入「关系图」页点击「清空项目」，或在浏览器设置中清除本站数据即可移除全部本地内容。
• 输入安全：校验与修复不修改你的原始源文件；导入为覆盖式写入本地项目，建议在导入前保留源文件副本。

四表数据模型

• Space（空间）：区域 / 楼层 / 厂区等层级对象，可含父级引用形成树。
• Asset（资产）：设备 / 装置等，挂载到某个 Space。
• Sensor（测点）：资产上的量测点，含量纲 / 单位。
• Observation（观测）：测点的时序量测值，含时间戳 / 数值 / 质量标记。

规则引擎在四表之间检查引用完整性、唯一性、量纲单位、时间戳合理性与覆盖度等， 问题可溯源到具体的表 / 行号 / 记录 ID / 字段。

常见问题

支持哪些文件格式？

CSV 与 Excel（.xlsx / .xls）。每个工作表单独映射到一个目标表。

数据会被上传吗？

不会。所有处理在浏览器本地完成，没有业务后端或网络上传。

校验规则会修改我的数据吗？

「校验」只读取并报告问题；「应用修复」在本地项目副本上做不可变更新并即时复检， 不会触碰你的原始源文件。

如何迁移旧版本项目？

v1 旧项目在导入时自动迁移为四表模型（v1→v2）。迁移仅补充缺失字段，不破坏既有数据。

大表卡顿怎么办？

v1.0.0 起数据预览默认对超过 100 行的表启用虚拟滚动，仅渲染可视区间行； 校验改为分块执行，结果与逐条执行完全等价。