update at 2026-02-12 17:30:41

README.md

@@ -0,0 +1,42 @@
+# 星程桑基图
+
+基于 `Vue3 + TypeScript + ECharts` 的桑基图制作工具，支持 `CSV / XLS / XLSX` 上传、列映射配置、目标描述列合并语义聚合、实时预览与 `PNG / SVG` 导出。
+
+## 已实现（本轮）
+
+- Web 端（Figma `3044:158`）
+  - 顶部工具条：主题选择、文件上传、导出按钮
+  - 列映射：源数据列单选、源描述列多选、目标描述列多选
+  - 解析规则：支持“目标描述列空值沿用上行非空值”
+  - 图表预览：方向切换、节点间距、预览边距配置
+  - 导出：PNG / SVG
+- 小程序端骨架（Figma `584:64`）
+  - 页面结构、图标布局与主题底部弹层
+
+## 本地运行
+
+```bash
+npm install
+npm run dev
+```
+
+## 质量检查
+
+```bash
+npm run test
+npm run type-check
+npm run lint
+```
+
+## 测试数据
+
+按你的要求，测试 Excel 文件放在 `data/`：
+
+- `data/example.xlsx`
+- `data/example0.xlsx`
+- `data/example00.xlsx`
+- `data/example1.xlsx`
+
+## 图标资源
+
+所有 SVG 图标统一放在 `assets/icons/`，Web 与小程序都直接复用该目录。