update at 2026-02-13 22:26:53

miniapp/README.md

@@ -1,10 +1,21 @@
-# 小程序端骨架
+# 小程序端（当前可用范围）
 
-当前目录提供了与 Figma `node-id=584:64` 对齐的页面骨架：
+当前目录已从骨架升级为可用版，支持以下能力：
 
-- 顶部 Logo/主题/上传/导出区域
-- 效果预览区域
-- 源数据与目标数据列选择区域
-- 主题底部选择器（底部弹层）
+- 顶部 Logo / 主题 / 上传 / 导出区域
+- 文件上传与解析：`csv / xls / xlsx`
+- 默认列映射：
+  - 源数据列优先匹配 `data/value/数据/值`
+  - 源描述列优先匹配 `source/源`
+  - 目标描述列优先匹配 `target/目标`
+  - 若无显式数值表头，则回退到第二行首个数字列
+- 源/目标列选择交互与聚合统计
+- 信息日志（解析信息 / 告警 / 错误）
+- 原生 canvas 桑基图预览
+- 导出能力：
+  - `PNG`：保存到系统相册
+  - `SVG`：生成 `.svg` 文件写入用户目录，优先尝试打开，失败时复制路径
 
-后续接入时建议直接复用 `src/core` 的解析与聚合逻辑，保持 Web 与小程序一致的数据行为。
+注意事项：
+- `xlsx` 解析依赖 npm 包，若在微信开发者工具中提示模块缺失，请先执行“工具 -> 构建 npm”。
+- SVG 文件导出后是否可直接预览，取决于当前系统与微信版本对 SVG 文档的支持。