[更新时间] 2026-02-13（第二次更新）
[项目] 星程桑基图

一、已完成（Done）
1. Web 单页主流程已打通：上传 -> 列映射 -> 预览 -> 导出。
2. 已支持文件格式：csv / xls / xlsx。
3. 已实现核心聚合规则：
   - source 数值列解析（含千分位）
   - source 描述列拼接（可为空）
   - target 描述列向下补全（合并单元格语义）
   - source-target 键值聚合
4. 已实现预览配置：方向切换、gap、padding、主题切换。
5. 已实现导出：PNG/SVG（带时间戳命名）。
6. 已实现默认样例加载：页面首次进入自动读取 `data/example0.xlsx`。
7. 已有核心单测（parser + sankey 聚合 + xlsx 读取）。
8. 小程序端已完成视觉骨架（非完整业务）。
9. 已实现本地持久化：用户上传文件、映射配置与预览选项会写入 localStorage，刷新后自动恢复。
10. 已新增“汇聚对齐”配置（Between/Middle/Top/Bottom），可控制 target 侧对齐，且 gap 作为源侧基准。
11. 已优化“无配置初始化映射”：优先按表头别名自动匹配，缺失时按第二行首个数字列兜底。

二、当前状态（In Progress）
1. 无进行中的代码重构任务。
2. 文档体系已补齐为知识库结构：
   - PRD.md
   - APP_FLOW.md
   - TECH_STACK.md
   - FRONTEND_GUIDELINES.md
   - BACKEND_STRUCTURE.md
   - IMPLEMENTATION_PLAN.md

三、已知问题 / 风险（Known Issues）
1. 本地持久化基于 localStorage，受浏览器容量限制；超大文件可能无法完整保存。
2. Vite 开发配置依赖本机 HTTPS 证书路径，换机器可能无法直接启动。
3. 当前“目标数据”无独立数值列，数值始终来自 source data 列；若未来业务需要需先改 PRD。
4. 小程序仅骨架，尚未接入真实解析、渲染与导出。

四、下一步建议（Next）
1. 决策是否引入“目标数值列”能力（先更新 PRD 后实现）。
2. 将小程序由骨架升级为可用版本（优先复用 `src/core`）。
3. 补充更多异常用例测试（空文件、超大文件、乱码表头、极端数值）。
4. 评估并处理 dev HTTPS 证书本地耦合问题，降低新环境接入成本。

五、执行约定（Session Memory Rules）
1. 新会话开始先读取本文件，再读取 6 份规范文档。
2. 每次功能完成后，必须更新：Done / Known Issues / Next。
3. 任何范围变化先改 PRD，再改实现与计划。