# 分片4 交付报告：记忆闪卡 + 思维导图 + 可编辑导出

- session：全量历史债治理20260930_s4
- 隔离实测端口：http://127.0.0.1:8014（独立后端，未碰用户 8000/8011/8012）
- DB：backend\data\shuili_exam.db（改库前已备份 .bak_s4；本分片未改库结构，仅闪卡复习评分写过可逆 SRS 记录）

## 一、改动文件（仅本分片所有权内）
- frontend/modules/flashcard/flashcard.js
- frontend/modules/mindmap/mindmap.ct2.js（唯一生效；mindmap.js、mindmap.ct.js 未加载未改）
- backend/api/v1/flashcard.py、mindmap.py：**未改**（只读 textbook/tree，未改 textbook.py / main.py 注册 / index.html / settings / 共享 css）
- read-practice.js：未改。

## 二、逐项实测表

| # | 需求 | 结果 | 关键证据 |
|---|---|---|---|
| 1 | 外部设置每次30张=内部实际取出 | ✅ | 8014 选30开始复习→进度1/30；数量选择器加显式 value(10/20/30 默认30)，按 n 切片 |
| 2 | 卡面横向长方形 | ✅ | 前卡实测 760×336px，唯一 id `<style>` 注入 |
| 3 | 初始只显问题，互动后显答案 | ✅ | 背面容器初始 display:none，翻转/点击后才显 |
| 4 | 答案区答案与口诀各占一半 | ✅ | 有口诀卡绿答案框≈61px / 蓝口诀框≈59px，flex 1 1 50% |
| 5 | 上一张/下一张全局修复 | ✅ | 下一张×2 到 3/30，再上一张回 2/30 |
| 6 | 语音输入自动判对错 | ✅ | onresult 终值→VoiceTextParser.cleanRaw→doJudge()，实测翻显“判定：没记住（要点命中25%）” |
| 7 | 磨耳朵=知识点+答案+口诀 | ✅ | flashcard.js:834-841 三段以“。”拼接，统一 TtsService.speak；移除只含口诀的本人配音片段分支 |
| 8 | 正面/背面/全部/随机/磨耳朵/口音保留 | ✅ | 按钮均在；**口音属系统全局=分片5跨片依赖，未私改 settings** |
| 9 | 新建导图自动加载模板 | ✅ | _startCreate 直接 _defaultTemplate()，无“加载模板”按钮 |
| 10 | 移除拆分/合成/PDF按钮 | ✅ | ct2 已无此三按钮；后端 split_from_pdf/merge/upload_pdf 端点保留（智能拆分归分片3） |
| 11 | 节点编辑三栏可用 | ✅ | 通用 _openElixirEditor；实测 MindElixir 打开根节点“第1章·答案版”（仅取消未存库） |
| 12 | 节/章/科目导图落地 | ✅ | 章导图下拉5章、科目导图全科渲染、编辑按钮齐全；教材树由损坏的 material/tree 切到只读 textbook/tree（node_code 1.1 对齐） |
| 13 | 教材目录树以下拉显示 | ✅ | 节导图 章→节级联下拉，只读 GET /api/v1/textbook/tree，未改 textbook.py |
| 14a | 闪卡可再导入导出 | ✅ | CSV 9列表头与 backend flashcard.py:557 template_excel 及 :513-521 别名逐字对齐，带 BOM，文件名含“可再导入” |
| 14b | 导图可编辑导出 | ✅ | _mdToOpml 输出合法嵌套 OPML2.0 + Markdown；node 单测通过 |

## 三、OPML 导出证据（_mdToOpml 单测，样例见下）
修复了两缺陷：①初版所有节点自闭合 `<outline/>`、无父子嵌套，XMind/幕布导入即丢层级；②同级连续 bullet 被误判为父子。修正后输出：

```xml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
<head><title>第1章</title></head>
<body>
<outline text="第1章">
  <outline text="第1章 水利工程造价构成">
    <outline text="1.1 投资构成">
      <outline text="建筑安装工程费"/>
      <outline text="设备购置费"/>
    </outline>
    <outline text="1.2 其他费用">
      <outline text="建设用地费"/>
    </outline>
  </outline>
</outline>
</body>
</opml>
```
要点：建安费与设备购置费为兄弟节点，1.2 为 1.1 的兄弟——层级完整，可被 XMind/Freeplane/幕布 导入再编辑。

## 四、跨片依赖
- 口音全局设置：属系统设置（分片5）。本分片在闪卡页保留 #fcAccentSelect，但未读写 settings 文件；待分片5接全局口音后自动生效。
- 智能导图拆分：后端能力保留，挂接学习资料库（分片3），本分片未改资料库文件。

## 五、需用户确认项
无阻塞项。仅提示：闪卡复习评分会写 SRS review（可逆，实测已产生少量记录，属正常）。

## 六、遗留
1. OPML “点击按钮真下载”未在浏览器复点（浏览器沙箱中途不可用）；函数体与线上逐字一致且单测通过，按钮 onclick 已 grep 接线（mindmap.ct2.js:1112 等）。
2. 8014 后端运行期间曾因 RAG 常驻内存不足(OOM)退出一次，已重启恢复；RAG 内存为系统全局问题，不在本分片范围。

## 七、交付物
- artifacts/ledger_seed_s4.json（2 条：闪卡 flashcard.js、导图 mindmap.ct2.js）
- artifacts/report_s4.md（本文件）
- 未自跑 record_change.py，待总控串行导入。
