文档导航

本目录保存 Markdown Editor 的架构、阶段设计、验证基线和托管同步专题文档。
根目录 README 提供项目概览、关键行为与常用命令，功能说明记录当前用户可见能力。

文档职责

文档	主要内容	适用场景
技术架构与实施计划	当前架构、关键决策、演进边界、阶段状态和路线图	理解全局设计或评估后续方案
模块边界与文件长度维护	集中模块提取、加载顺序和回归入口	定位拆分后的代码或维护文件长度
文件树模块职责与依赖	文件树视图、控件、差异表单、打包的职责、依赖图和初始化顺序	定位文件树实现或评估模块耦合
CodeMirror 6 编辑器迁移规划	迁移范围、适配接口、阶段任务、性能与回归门槛	评估或实施正文编辑器迁移
阶段 0 工程基线	自动化验证、性能基准和人工回归清单	发布验证或检查工程基线
阶段 1 可靠性设计与验证	保存、编码、恢复、外部修改和交互可靠性	修改编辑、保存或恢复流程
笔记库与文件管理	笔记库、目录树、文件操作、搜索和设置	修改工作区或文件管理能力
文件树操作测试用例	选择、复制粘贴、拖放、删除、撤销重做和外部回收站操作	执行文件树手工回归
片段管理器	当前片段集合、搜索、操作和限制	使用或修改片段管理器
工作区性能与验证	1000 文件基准、自动化覆盖和人工平台验证	评估工作区性能或发布验证
预览编辑器产品设计	Preview、Normal、Pinned 与 Dirty 状态及交互规则	修改标签打开、保留、固定或批量关闭行为
文档视图模式	编辑、并排与预览三种互斥视图及恢复规则	修改编辑区和预览区的显示、命令或持久化行为
编辑器导航历史	Go Back / Go Forward、预览恢复、视图状态与验证	修改编辑器位置导航或历史快捷键
引用与反向查找实现	引用生成、扫描匹配、报告生命周期和验证入口	修改引用复制、插入或反向查找
HTML 粘贴与图片本地化实现	粘贴优先级、HTML 转换、图片导入、失败回退与验证	修改富文本粘贴或附件下载
阶段 5 账号与托管同步 Beta	服务运行、数据模型、协议、安全、备份、容量和灰度	部署、运维或修改托管同步
同步流程与代码位置	同步调用链、源码映射、持久化边界和排障指南	定位同步实现或分析故障

阶段 3、4、6 和 7 的范围与状态目前统一记录在技术架构与实施计划中。
阶段 4 已完成的协议契约由阶段 5 文档维护，避免重复定义同一套字段和恢复规则。
SnippetForm 迁移说明保留原 WinForms 设计与迁移背景；当前已交付行为以片段管理器为准。

维护约定

README 保留项目入口、关键行为摘要、常用命令和文档索引，不承载完整协议或实现细节。
FEATURES 只描述当前已交付且用户可观察的行为，不记录规划中的能力。
phase-* 文档记录对应阶段的设计、限制、验证和运维要求。
sync-flow.md 维护实现调用链、源码位置和排障入口；协议字段以阶段 5 文档为准。
同一主题只指定一个主要维护位置，其他文档使用链接引用，避免复制后产生差异。
功能、命令、配置、协议或架构发生变化时，同一提交内更新相关文档。
代码位置引用维护中的 .ts / .mts 源码，Markdown 链接使用相对路径，不携带开发者机器的绝对路径或易失效的行号。
运行命令中的 .js / .mjs 指向编译产物，不应机械改为源码扩展名；从仓库根目录执行应用或测试时使用 npm 入口或 node scripts/run.mts。
带日期的测试结果、性能数据及迁移原规划保留当时的事实和命令，并明确其历史性质；当前操作以 README、功能说明和相关开发文档为准。
多个独立事实分行书写；复杂内容使用小节、列表或表格表达。
所有文档使用 UTF-8 编码和 LF 换行。

README

文档导航

文档职责

推荐阅读路径

使用与功能确认

架构与开发

发布与运维

维护约定

用户目录