维刻 Vex 桌面体验与安装设计复核
本轮依据安装后反馈重新修订原型；未完成下列验证前不升级版本、不发布 tag。Vex 仅作只读参考。
| 问题 | 已定位的原因 | 设计与验收要求 |
|---|---|---|
| 初次启动已有五篇文章 | WorkspaceViewModel 构造函数主动装载 sampleDocuments | 文件列表为空；空白写作区不生成文件，首次输入或主动新建才创建文档。历史文件通过文件菜单打开。 |
| 菜单小、文字不齐 | 通用按钮包裹 Flexible 文本；菜单沿用 10–12px 文本和紧凑密度 | 顶级菜单同基线，14px；弹出菜单至少 260px 宽、36px 行高，名称与快捷键分列，分组与子菜单对应原型。 |
| 字形虚、小 | 中西文混用字体回退，界面大量 9–12px 字号 | Windows 中文优先微软雅黑 UI，界面正文 14px、辅助文字至少 12px；按最新要求统一 36px 弹窗标题栏与 14px 标题，真实原生截图核对，不能靠整体缩放改善。 |
| 引导不指向目标 | 原生实现为底部说明条，未连接真实控件 | 六步引导锚定真实区域；高亮、箭头、说明卡片随布局及窗口大小更新，目标可交互；退出恢复文档与撤销记录。 |
| 快速上手入口 | design/Vex.html 的 guide-launch 已存在 | 不新增入口；与原型一致，只在未完成引导时展示，帮助菜单始终可重新进入。 |
| 即时编辑不能拖选 | 展示块 selectable=false，鼠标抬起才切换输入框 | 从第一下鼠标按下即可拖选；格式工具操作保留选区；源码、预览、撤销历史同步。 |
| 表格变成源码 | 普通块点击逻辑统一将整块交给 TextField | 表格始终保留行列结构；单元格内输入，Tab/Shift+Tab 移动；转义管道符、CRLF、撤销、格式操作不损坏其他单元格。 |
| 导图不能原位改名 | onActivate 只打开 ChapterInspector | 双击或 F2/Enter 原位编辑标题；Enter 提交、Esc 取消、失焦提交；正文及后代章节不变。 |
| MCP 缺失 | 原型有配置页，应用没有服务及入口 | 必须提供真实本机服务、Token 验证、范围控制、修改确认与错误状态；禁止展示虚假的“运行中”。 |
| Windows 安装器 | 原生界面与原型未一起验收 | 去掉顶部标题栏，关闭操作放到底部；品牌、正文、操作区统一；安装/维护/失败/取消/许可/卸载均覆盖。 |
| 各平台安装 | 系统管理与应用可控区域边界不同 | Windows 自定义安装窗口；macOS DMG 背景品牌化；Linux 原生软件包元数据与图标；Android/iOS/鸿蒙保留系统安装权限页面，品牌视觉用于应用自己的首次打开页面。 |
视觉验收使用完整原型截图与真实窗口截图，逐状态、明暗主题与 DPI 检查；平均颜色接近不等于 98% 视觉一致，更不代表交互通过。不能为提高分数而隐藏差异或把实现截图替换为参考图。
Windows 安装器精简稿与关闭修复
根据最新反馈，窗口收敛为 800 × 480，左侧只保留一枚图标和一行「维刻 Vex」。移除重复品牌、口号、作者、网站和页脚；平台、架构、版本合为一行。路径与选项默认折叠，底部保留一个关闭入口与安装主操作，确认对话框不再重复显示图标。原型与原生安装器共用渲染资源和控件几何数据。
卸载完成后，原生向导的 CurPageID 仍是欢迎页；此前代码根据自定义完成状态隐藏了 Inno 的内部取消按钮，导致引擎拒绝关闭。现在保留引擎所需按钮并将其移至窗口外，底部关闭通过引擎的取消流程退出，完成安装则通过完成流程退出。Alt+F4 同样转交给关闭处理，关闭完成页不启动应用。
本机独立 AppId 的原生交互验证已通过：
- 折叠/展开路径选项、真实复选框、许可说明、退出确认与返回。
- 简中明暗主题及英日文原生回退布局；品牌与关闭操作不重复。
- 实际安装暂停确认、继续安装、完成关闭、修复及真实卸载。
- 卸载完成页关闭按钮的点击区域、鼠标按下/抬起事件、进程退出；另一次完整安装与卸载验证 Alt+F4 退出。
- 测试结束没有残留测试安装器进程或测试安装注册；未操作用户正式安装目录。
资源已完整生成简中明暗主题的 100%、125%、150%、200% 矩阵，编码前检查矩阵完整性和图片尺寸，防止混用旧稿资产。本机原生交互截图仅验证当前 100% 缩放，其他 DPI 仍需真实窗口验收，尚不宣布达到 98%。应用侧 48 项测试通过，仓库静态分析无问题。
其余验收仍待完成
即时编辑跨段落拖选、表格失焦后的行内 Markdown 显示、完整菜单与快捷键对照仍需复核。MCP 已实现本机鉴权、范围、确认和 20 个工具，但不等于覆盖 Vex 的全部能力。应用最新原生截图、安装器其他 DPI、macOS DMG 品牌布局及各平台可控界面仍需验收；这些完成前不升级版本或发布 tag。
桌面原型导航与标题栏修订（2026-10-17）
原型与发布应用的启动内容分开处理。design/Vex.html 默认保留五篇可编辑演示文档，覆盖文字格式、图片、链接、代码、表格、数学方程、化学表达式、Mermaid 流程图与时序图。插图、KaTeX/mhchem、Mermaid 及字体保存在本地；Flutter 工作区的首次空列表行为未改动。
文件／大纲改为等宽居中的纯文字标签；文件页仅保留搜索与可折叠目录树，打开目录时保留子目录结构。移除大纲“文档结构”栏和源码按钮右侧的说明文字。主标题栏从 44px 减至 33px；九类遮罩弹窗统一采用更新日志的 36px 标题栏，关闭操作使用真正的按钮，统一 46×32px 点击区域和 14px 图标。
标题栏按钮挪位的原因是引导将常驻主题控件当成弹出面板隐藏，且未恢复；同时右侧按钮依赖主题控件的自动边距。现在引导只关闭语言下拉，标题栏按钮拥有独立靠右布局。未保存确认框新增的标题栏关闭按钮按“取消”处理，避免意外放弃草稿。
本机 Edge 离线验证覆盖 800、1024、1440px 三种宽度与明暗主题，检查目录搜索／折叠、大纲、九类弹窗的高度及按钮位置、真实菜单打开弹窗、Esc 关闭，以及六步引导后布局恢复。公式与图表源码修改、即时渲染、撤销及阅读视图同步通过，未发现脚本或资源加载错误。本节仅记录原型检查，不代表 Flutter 最新布局或整体视觉一致性已经验收；尚未升级版本或发布 tag。
Flutter 导航与标题栏同步（2026-10-17）
实际应用已同步等宽居中的纯文字“文件／大纲”标签，移除固定的文件夹工具行与大纲结构统计。文件页保留搜索框和目录树；独立打开的文件与未保存文档仍可访问。目录选择服务现在保留真实根路径，递归读取 Markdown／文本文件与空目录；符号链接不跟随。树支持折叠，搜索展开匹配文件的父目录，清空搜索恢复此前折叠状态；打开文件后不会在树外重复列出。MCP 工作区范围也使用实际选择的根路径，避免根据首篇文件推断为子目录。
主标题栏为 33px，共用弹窗标题栏为 36px；主窗体、弹窗、浮层与检查面板的关闭按钮共用 46×32px 点击区域及 14px 图标。菜单、弹窗开关和六步引导之后，主窗口控制按钮的位置独立保持靠右。发布应用的首次空列表逻辑保持，演示文档仍只属于设计原型。
本机 Windows 原生集成检查通过，覆盖 900、1024、1440px 窗口宽度与明暗主题、关于弹窗的关闭与 Esc、菜单 Esc、引导恢复、目录搜索／折叠／打开、大纲、表格单元格输入、导图原位改名、MCP 设置和未保存关闭确认。验收对 33／36px 高度、按钮尺寸及靠右位置作了实际布局断言，并保存完整截图。应用 50 项测试、仓库静态分析和 Windows Release 构建通过。
截图与本机日志位于 D:/github/temp_files/vex-experience-review/native-sidebar-chrome 及其同级日志文件。该原生验证使用内存文档和设置，未操作正式安装或个人文件。此处通过的是上述导航及窗口布局检查；前文列出的跨段落选择、表格富显示、其他安装 DPI 与 macOS 等整体验收仍未完成，尚未升级、提交、推送或打 tag。
有疑问或建议，欢迎到 GitHub 提交 Issue 参与讨论。