项目概览
markmap++ 是一个以 Markdown 为唯一内容来源的浏览器知识与思维导图工作台。它基于 Tem-man/markmap-plus 的可编辑导图能力，补充了完整编辑器、文件管理、本地缓存、Agent 知识问答与可审核修改、GitHub 手动同步、社区主题、集中偏好设置和高清导出。
工作方式
text
Markdown 文本
├─ 编辑器：源码 / WYSIWYG 视觉模式、输入、高亮、拼写检查与撤回
├─ Markmap 视图：缩放、折叠、节点增删改
├─ Mermaid 文档：源码编辑、SVG 预览与独立导出
├─ 浏览器缓存：设置、仓库绑定、本地草稿
├─ Agent：笔记检索、通用知识问答、Diff 审核与操作记忆
├─ GitHub 仓库：多端文件同步与提交历史
└─ 导出：MD / Mermaid / SVG / PDF / PNG / JPEG / HTML编辑器中的修改会实时转换为思维导图；在导图中编辑、增加或删除节点时，结构也会回写为 Markdown。这样既保留纯文本的可移植性，也获得可视化操作体验。
外观和编辑体验从“帮助 → 偏好设置”统一管理。主题预设可以同时控制 UI、编辑器和预览；语法高亮与画布背景默认跟随主题，也可以单独打开覆盖开关。画布上的 Markmap 分支线会根据背景改善明度和对比度，但文档元数据中的 options.color 永远优先。
数据保存位置
| 数据 | 保存位置 | 是否随设备同步 |
|---|---|---|
| 欢迎示例 | 应用内置 | 每次打开恢复 |
| 偏好设置、字体与编辑器模式 | localStorage | 否 |
| GitHub 仓库绑定与令牌 | IndexedDB | 否 |
| Agent 服务商配置与 API 密钥 | IndexedDB | 否 |
| Agent 对话历史与审核状态 | IndexedDB | 否 |
| 已拉取文件和草稿 | IndexedDB | 否 |
| 确认同步的 Markdown | GitHub 仓库 | 是 |
| 导出文件 | 设备下载目录 | 由用户管理 |
推荐方式
临时整理可以直接编辑后导出 Markdown；需要长期保存、跨设备继续和查看版本历史时，使用 GitHub 仓库同步。
为什么不是实时自动提交
键入一个字符就创建一次 Git 提交会产生大量无意义历史，也容易在多个设备间制造冲突。markmap++ 采用“本地持续暂存，用户确认后同步”的方式：
- 打开仓库 Markdown 并缓存到当前设备。
- 编辑、重命名、移动、新建或删除文件。
- 文件树显示
A、M、R、D状态。 - 点击“同步”，所有待处理操作合并为一个提交。
项目边界
- 应用是纯前端静态站点，不提供账户系统或服务端数据库。
- GitHub 令牌由用户在浏览器中输入，不会进入部署产物。
- Agent 请求会从浏览器直接发送给用户选择的 AI 服务商；不同服务商的数据策略由对应服务商决定。
- Agent 配置备份包含 API 密钥，只应作为敏感文件用于受信任设备间迁移。
- Git 无法记录真正的空目录；不含文件的本地文件夹不会同步。
- 当前同步后端为 GitHub，WebDAV 等方式不在第一阶段范围内。