Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 6.99 KB

File metadata and controls

53 lines (42 loc) · 6.99 KB

用户教程功能覆盖矩阵

用途:把用户实际看得到的能力、代码所有者、教程入口和发布前检查放在同一处。更新时间:2026-08-09。

状态说明:已复核表示教程步骤和当前实现边界已核对;待发布截图表示正文可用,但下次正式发布需用新安装包确认并重拍受影响界面;待专项复核表示已有教程,尚未按本轮变更逐项对照。

维护规则

  • 教程站的公开版本和截图基线由 guide/package.jsonguide/public/images/vX.Y.Z/ 管理;本地测试包升级不能直接冒充正式发布。
  • 新功能或行为变化先更新对应教程正文、FAQ 和必要的边界说明,再登记本表。
  • 准备发布时,按“待发布截图”和“待专项复核”逐项验收,更新页面版本徽标、截图、网站下载信息和 CHANGELOG.md
  • 代码实现说明留在 docs/;用户教程只保留操作路径、结果、限制与安全提醒。

基础与编辑

功能 主要代码所有者 用户教程 状态 / 下次动作
新建、打开、保存、外部拖入、外部修改提醒 useFileOps.jsuseDropOpen.jsuseAppLifecycle.js guide/basics/create-open-save.md 已复核桌面文件拖入和编辑器图片边界;下次发布检查外部保存冲突提示截图与文案。
多根工作区、文件树、文件操作 useWorkspace.jsuseDropOpen.jsuseSidebarTree.jsSidebar.jsx guide/basics/workspace.md 已复核:文件夹可选择或拖入,工作区只管理本地文件并与同步区分。
富文本 / 源码切换、源码 + 预览、原文保真、源码查找 useSourceModeSwitch.jsuseSplitSourceRichSync.jsuseSplitScrollSync.jsscrollAnchor.jsmarkdown-source-preservation.js guide/basics/rich-and-source.mdguide/troubleshooting/files-and-save.md 已复核:双栏入口与桌面边界、只读预览、滚动联动、保存安全提示,以及段落/列表/引用/反引号/空块/400KB+ 长文档的完整家族矩阵均已对齐。
斜杠命令 editor-slash-menu.js guide/editing/slash-command.md 待专项复核:确认所有可见别名与命令清单一致。
格式、图片、链接、附件 Editor.jsxeditor-dom-content.jsuseAttachments.js guide/editing/formatting.mdimages.mdlinks-and-attachments.md 待专项复核:链接协议与附件路径应在发布前用真实文件再验。
表格、HTML 表格、单元格换行、列宽 editor-tablebreak.jseditor-table-click.jseditor-dom-layout.jseditor-html.js guide/editing/tables.md 已复核:单击单元格编辑、自然宽度、内部横向滚动、HTML 表格窄布局、自适应列宽、长按实时调宽、不回跳,以及 PDF 保留列比例和紧凑行距均已写入。
代码块、Mermaid、LaTeX editor-codeblock-eager.jseditor-dom-content.jseditor-pdf-content.jseditor-mermaid.jseditor-math.js guide/editing/code-blocks.mdmath-and-mermaid.md 已复核编辑器/PDF 代码行号及 122 行虚拟化代码全文复制;下次发布仍需确认公式预览、灯箱和 PDF 长公式截图。

导航、效率与外观

功能 主要代码所有者 用户教程 状态 / 下次动作
查找替换 useFindReplace.js guide/productivity/find-and-replace.md 待专项复核:覆盖富文本、源码与模式切换后继续查找。
大纲、折叠、重排、悬浮章节导航 useOutline.jsOutline.jsxFloatingOutline.jsx guide/productivity/outline.md 待发布截图:正文已覆盖桌面悬浮导航及移动端差异。
命令面板、Review CommandPalette.jsxeditor-review*.js guide/productivity/command-palette.mdreview.md 待专项复核。
自定义快捷键 components/commands/useKeybindings.js guide/productivity/shortcuts.md 待发布截图:保持“编辑器原生命令暂不开放”的范围说明。
主题、字体、排版、自定义 CSS settings.jssettings/customThemes.js guide/customization/themes.mdfonts.mdsettings.md 已复核:CSS 片段、真实选择器预览与返回设置时的片段停留已写入。

输出、同步与移动端

功能 主要代码所有者 用户教程 状态 / 下次动作
PDF 导出中心 hooks/usePdfExport.jscomponents/pdf-export/main/pdf-export.js guide/output/export-pdf.md 教程已对齐真实 Buffer、8–24pt 正文字号、整体缩放、表格列宽/行距、尺寸、目录页、书签、页码范围、图片、Mermaid 和长公式;下次正式发布仍需用最新安装包复核截图。
HTML 导出中心 hooks/useHtmlExport.jshooks/useHtmlPreview.jscomponents/html-export/main/html-export.js guide/output/export-html.md 已用 0.12.48 新安装包和隔离测试文档复核正文、第一版边界及 1440×900 Studio 截图。
Pandoc 文档转换 hooks/usePandocExport.jsmain/pandoc-export.jsmain/subprocess.js guide/output/export-pandoc.mdguide/customization/settings.md 自动检测、手动选择、格式与安全边界已复核;Pandoc 3.10.1 已实际生成并检查 docx、tex、epub,教程说明了 SVG 等资源可能需要额外转换工具。
富文本复制、移动分享 editor-copy.jseditor-dom-content.jscapacitor-api.js guide/output/rich-copy.mdmobile-share.md 桌面三通道复制与长代码块系统剪贴板已专项复核;移动分享仍待真机复核。
桌面 WebDAV / S3 云同步 useSyncWorkspaces.jsSyncSettings.jsxmain/sync/ guide/basics/cloud-sync.mdguide/troubleshooting/faq.md 已复核:明确工作区不会自动同步、根目录唯一 .horsemd/workspace.json、WebDAV/S3、可选 User-Agent、上传/下载/双向同步、远端清空保护、冲突回收和仅桌面端。
iOS / Android 只读与平台边界 capacitor-api.jsmobileReadOnly、移动壳 guide/mobile/ios.mdandroid.md 已复核:只读模式和“移动端不提供云同步”已写明;真机发布前仍需手测。

不进入用户教程的项目

项目 原因 文档位置
AI 文档助手、Provider、Agent、插件生态 Phase 0 只有请求契约、上下文快照和变更提案纯函数,尚无用户入口、密钥或网络请求。 docs/ai-product-architecture.mddocs/ai-vmark-phase-plan.mddocs/ai-readiness-audit.mdROADMAP.md
云同步 v2 决策与实现细节 用户教程只说明安全行为;manifest、策略和恢复状态机属于开发实现。 docs/cloud-sync-v2-prd.mddocs/cloud-sync-v2-architecture.md
编辑器保真、模式切换和表格根因报告 用户需要知道结果与限制,不需要内部算法和故障历史。 docs/markdown-source-preservation.mddocs/issue-86-table-save-report.md