Enhance reader styles exports and settings
This commit is contained in:
@@ -9,10 +9,10 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- 内置保存和外部编辑器保存都会触发文件监听,需要区分“程序自己保存”和“外部变更”。
|
||||
- 当前多标签页可以打开同一个文件,保存后要明确哪些标签页刷新。
|
||||
- 编辑时关闭窗口或切换文件要防止未保存内容丢失。
|
||||
- 非 UTF-8 编码文件可能读取失败,需要给出友好的错误提示。
|
||||
- [x] 内置保存和外部编辑器保存都会触发文件监听:使用 `internal_save_paths` 区分本软件保存和外部变更。
|
||||
- [x] 当前多标签页可以打开同一个文件:保存和自动刷新会同步刷新已打开的同一文档标签、目录、文档树和搜索索引。
|
||||
- [x] 编辑时关闭窗口或切换文件要防止未保存内容丢失:编辑标签关闭前调用 `confirm_close()`,未保存时要求用户确认。
|
||||
- [x] 非 UTF-8 编码文件可能读取失败:编辑和阅读渲染路径均捕获 `UnicodeDecodeError` 并显示友好提示。
|
||||
|
||||
## 2. 分屏编辑与预览
|
||||
|
||||
@@ -22,9 +22,9 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- WebEngine 渲染较重,实时预览需要节流。
|
||||
- 标题 slug、Mermaid、公式和媒体资源都依赖完整渲染,局部刷新不一定可靠。
|
||||
- 分屏会改变主界面布局,需要和现有多标签、主题、目录栏协同。
|
||||
- [x] WebEngine 渲染较重,实时预览需要节流:预览刷新使用 350ms 单次 `QTimer` 防抖。
|
||||
- [x] 标题 slug、Mermaid、公式和媒体资源依赖完整渲染:预览和阅读页保持完整渲染流程,不做不可靠的局部刷新。
|
||||
- [x] 分屏会改变主界面布局:编辑器已嵌入标签页,并同步主题、目录栏和多标签状态。
|
||||
|
||||
## 3. 编辑体验增强
|
||||
|
||||
@@ -35,9 +35,9 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- 自动保存可能覆盖用户不想保存的临时改动,默认应谨慎。
|
||||
- 查找/替换要区分“源码编辑器内查找”和“阅读页页内查找”。
|
||||
- 行号和大文件语法高亮可能影响性能。
|
||||
- [x] 自动保存可能覆盖用户不想保存的临时改动:自动保存只写入草稿,不直接覆盖正式文件,恢复前需要用户确认。
|
||||
- [x] 查找/替换要区分“源码编辑器内查找”和“阅读页页内查找”:源码编辑器和阅读页使用独立查找控件和状态。
|
||||
- [x] 行号和大文件语法高亮可能影响性能:行号只绘制可见块,超大源码自动关闭 Markdown 语法高亮。
|
||||
|
||||
## 4. 文件打开与链接策略继续完善
|
||||
|
||||
@@ -47,8 +47,8 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- 记住的程序路径可能被移动或卸载,打开前需要校验。
|
||||
- 不应强行在标签页内展示所有媒体,系统默认程序或用户指定程序更稳。
|
||||
- [x] 记住的程序路径可能被移动或卸载:打开前校验路径,缺失或启动失败时自动清除记录并提示。
|
||||
- [x] 不应强行在标签页内展示所有媒体:非预览文件沿用询问/默认程序/用户指定程序策略,视频提供内置播放和外部打开两种入口。
|
||||
|
||||
## 5. GUI 自动化测试
|
||||
|
||||
@@ -60,8 +60,8 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- Qt WebEngine 在无界面环境下偶发不稳定,测试要保留最小烟雾测试和可重复的等待条件。
|
||||
- 涉及系统默认程序的测试应避免真的启动外部播放器。
|
||||
- [x] Qt WebEngine 在无界面环境下偶发不稳定:保留 `tests/gui_smoke.py` 离屏烟雾测试,并使用明确等待条件。
|
||||
- [x] 涉及系统默认程序的测试应避免真的启动外部播放器:GUI smoke 中替换外部启动函数,只验证路由和参数。
|
||||
|
||||
## 6. 发布与打包
|
||||
|
||||
@@ -71,8 +71,8 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- WebEngine 资源和离线 Mermaid/KaTeX/MathJax 文件容易漏打包。
|
||||
- 单文件 exe 首次启动会解压,启动日志路径要能写入。
|
||||
- [x] WebEngine 资源和离线 Mermaid/KaTeX/MathJax 文件容易漏打包:`MDHelper.spec` 明确包含 `mdhelper/resources`、示例文档和媒体资源,并保留 PyInstaller hook 路径。
|
||||
- [x] 单文件 exe 首次启动会解压,启动日志路径要能写入:日志目录优先使用用户可写目录,并提供临时目录兜底。
|
||||
|
||||
## 7. Markdown 编辑器继续完善
|
||||
|
||||
@@ -141,8 +141,23 @@
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- 冲突检测要避免误判,也要避免静默覆盖外部工具已经保存的内容。
|
||||
- “另存为”后要同步文档树、最近文件、搜索索引、当前标签页标题和文件监听。
|
||||
- 草稿不能直接覆盖正式文件,只能在用户确认后恢复。
|
||||
- 分屏同步滚动只能做近似同步,Mermaid、公式和图片会让源码高度与预览高度不一致。
|
||||
- 插入工具栏要操作选区,不能破坏已有文本。
|
||||
- [x] 冲突检测要避免误判,也要避免静默覆盖外部工具已经保存的内容:保存前比较文件签名,检测到外部变更时要求用户确认。
|
||||
- [x] “另存为”后要同步文档树、最近文件、搜索索引、当前标签页标题和文件监听:另存为保存后统一走刷新与标签状态更新流程。
|
||||
- [x] 草稿不能直接覆盖正式文件,只能在用户确认后恢复:草稿恢复通过确认框选择,拒绝后清理草稿。
|
||||
- [x] 分屏同步滚动只能做近似同步,Mermaid、公式和图片会让源码高度与预览高度不一致:按滚动比例同步,并保留标题目录精确跳转。
|
||||
- [x] 插入工具栏要操作选区,不能破坏已有文本:插入模板通过当前选区替换,并保留无选区占位内容。
|
||||
|
||||
## 13. 可选代码文档展示
|
||||
|
||||
- [x] 增加“展示文件类型”设置,支持 Markdown、Python、C/C++ 分组开关。
|
||||
- [x] 将文档发现逻辑改为按用户选择的扩展名过滤,默认只展示 Markdown/网页文档。
|
||||
- [x] Python、C/C++ 文件在阅读页中用 Pygments 高亮展示,不再只作为普通文本预览。
|
||||
- [x] Python 使用 AST 提取类、函数作为右侧目录;C/C++ 先用轻量正则提取函数/类/结构体。
|
||||
- [x] 搜索索引和自动刷新监听跟随当前展示文件类型更新。
|
||||
- [x] 补充单元测试和 GUI smoke,覆盖配置过滤、代码高亮、代码目录。
|
||||
|
||||
风险与注意事项:
|
||||
|
||||
- [x] 大型源码目录容易让文件树和搜索索引变慢:代码文件展示默认关闭,并跳过超大代码文件,搜索索引只读取安全大小内的文本。
|
||||
- [x] 代码文件编码可能不是 UTF-8:统一使用 `utf-8-sig`、`utf-8`、`gbk`、`latin-1` 回退读取。
|
||||
- [x] C/C++ 结构目录用正则只能做基础识别:按“基础结构目录”处理,避开明显声明和控制语句,不承诺完整语法解析。
|
||||
|
||||
Reference in New Issue
Block a user