macOS
- 确认芯片类型，双击对应的
.dmg。 - 把 VMark 拖入“应用程序”文件夹。
- 从“应用程序”打开 VMark。
- 如果已有旧版本，先退出旧版并确认未保存内容，再决定是否更新，不要在应用运行时直接替换。
QUICK START · VMARK v0.9.72
VMark 中文安装与使用说明
从选择安装包到开始写作、导出文档和连接 AI，一份说明快速上手。
一、先选择正确的安装包
本文件夹提供 VMark v0.9.72 的三个安装程序。只安装与你的电脑匹配的一个，其他文件无需打开。
| 电脑 | 使用文件 | 如何判断 |
|---|---|---|
| Mac：Apple 芯片 | VMark_0.9.72_aarch64.dmg | “关于本机”中的芯片显示 Apple M1、M2、M3、M4、M5 等。 |
| Mac：Intel 芯片 | VMark_0.9.72_x64.dmg | “关于本机”中的处理器显示 Intel。 |
| Windows：64 位 | VMark_0.9.72_x64-setup.exe | 设置 → 系统 → 系统信息，“系统类型”显示 64 位。 |
注意：VMark 当前主要面向 macOS 开发和测试；Windows 版本按现状提供。请先保存正在编辑的重要文件，再安装或更新。
二、安装 VMark
Windows
- 双击
VMark_0.9.72_x64-setup.exe。 - 按安装向导完成安装。
- 首次启动后先新建一份测试文档，确认打开、保存和重新打开均正常。
- 如系统安全软件报警，请核对文件校验值；无法确认时停止安装。
不要为了安装关闭系统安全保护。如果系统提示文件损坏、恶意软件或来源异常，请停止并重新核对安装包，不执行绕过安全检查的终端命令。
三、5 分钟快速上手
- 新建或打开文档：使用 Cmd/Ctrl + N 新建；使用 Cmd/Ctrl + O 打开 Markdown 文件；也可以把文件拖入窗口。
- 打开工作区：使用 Cmd/Ctrl + Shift + O 打开一个文件夹，左侧边栏会显示文件树。对重要文件夹操作前请先做好备份。
- 选择编辑方式：默认是所见即所得；按 F5 临时查看当前区块源码；按 F6 切换完整 Markdown 源码模式。
- 保存：Cmd/Ctrl + S 保存，Cmd/Ctrl + Shift + S 另存为。首次使用自动保存前，先确认保存位置和文件内容符合预期。
- 辅助视图：大纲用于浏览标题结构，侧边栏用于管理文件，状态栏显示字数与保存状态；可在“视图”菜单中开关。
常见 Markdown 写法
| 用途 | 写法 | 示例 |
|---|---|---|
| 标题 | # 到 ###### | ## 工作总结 |
| 加粗 | **文字** | **重点内容** |
| 无序列表 | - 内容 | - 第一项 |
| 任务列表 | - [ ] 内容 | - [ ] 完成校对 |
| 引用 | > 内容 | > 注意事项 |
| 链接 | [文字](地址) | [文策 AI](https://wence-ai.com) |
四、常用快捷键
| 功能 | 快捷键 |
|---|---|
| 新建 / 打开 / 保存 | Cmd/Ctrl + N Cmd/Ctrl + O Cmd/Ctrl + S |
| 撤销 / 重做 | Cmd/Ctrl + Z Cmd/Ctrl + Shift + Z |
| 加粗 / 斜体 | Cmd/Ctrl + B Cmd/Ctrl + I |
| 区块源码 / 完整源码 | F5 F6 |
| 状态栏 / 专注 / 打字机 | F7 F8 F9 |
| 自动换行 | Alt + Z |
| 设置 | Cmd/Ctrl + , |
VMark 支持自定义快捷键。如果系统功能键优先控制音量或亮度，可能需要同时按住 Fn。
五、导出与中文排版
导出 HTML
使用“文件 → 导出 HTML”。导出后先在浏览器检查标题、目录、表格、图片和链接，再对外发送。
导出 PDF
使用 Cmd/Ctrl + P 打开打印窗口，再选择保存为 PDF。正式材料应再次检查分页和字体。
复制为 HTML
使用 Cmd/Ctrl + Shift + C。粘贴到目标编辑器后仍需检查样式兼容性。
中日韩格式化
在“工具”菜单使用中日韩排版功能，可处理中文与英文、数字之间的间距及部分标点格式。执行前建议保存。
六、AI 精灵与 MCP
AI 精灵
选中文字后按 Cmd/Ctrl + Y，可调用已配置的 AI 服务进行润色、扩写或翻译。需要先在“设置 → 集成”中配置服务商。
隐私边界：一旦启用外部 AI 服务，提交的文字可能被发送给相应服务商处理。不要输入涉密材料、身份证号、手机号、账号密码、内部名单或其他不便公开的信息。
连接支持 MCP 的 AI 助手
- 打开 VMark“设置 → 集成”。
- 启用 MCP 服务器。
- 在对应 AI 助手旁点击“安装”；配置变更后完全退出并重新打开 AI 助手。
- 让 VMark 保持运行并打开一份测试文档，再尝试让 AI 读取或建议修改。
- 先保持“自动批准编辑”关闭，逐项检查并接受建议；不要让 AI 直接批量改动重要文件。
默认建议模式下，可按 Enter 接受建议、按 Escape 拒绝。启用自动批准会绕过逐项预览，只应在材料已备份且任务边界清楚时使用。
七、校验、排错与使用边界
核对下载文件
本文件夹的 SHA256SUMS.txt 保存了三个安装包的校验值。macOS 可在“终端”中进入本文件夹后运行：
shasum -a 256 VMark_0.9.72_aarch64.dmg
shasum -a 256 VMark_0.9.72_x64.dmg
Windows 可在 PowerShell 中运行：
Get-FileHash .\VMark_0.9.72_x64-setup.exe -Algorithm SHA256
把结果与 SHA256SUMS.txt 中对应文件核对；不一致时不要安装。
常见问题
| 现象 | 建议处理 |
|---|---|
| 不知道下载哪个 Mac 版本 | 打开“关于本机”：Apple M 系列使用 aarch64；Intel 处理器使用 x64。 |
| 打开文件后排版异常 | 按 F6 查看 Markdown 源码，检查标题、列表、表格和空行；先复制一份再修正。 |
| MCP 显示未连接 | 确认 VMark 正在运行并有活跃文档；在设置中检查 MCP 状态，安装或修复配置后重启 AI 助手。 |
| 移动应用后 MCP 路径不匹配 | 在“设置 → 集成”中使用“修复”，然后重启 AI 助手。 |
| AI 修改范围过大 | 关闭自动批准，撤销修改；恢复备份后把任务拆小，再逐条确认建议。 |
| 系统提示来源或安全风险 | 停止操作并核对安装包及校验值，不关闭系统安全防护，不运行不明命令。 |
重要边界
- VMark 当前为 Beta 版本，界面、功能和快捷键可能随更新变化。
- 本说明对应 v0.9.72；升级后请以应用内界面和官方文档为准。
- 编辑重要材料前先复制备份；确认保存成功后再关闭应用。
- 不要使用未经检查的插件、脚本或 MCP 配置处理重要文件。
LICENSE.txt为随包保留的软件许可文件，请勿移除。
VMark v0.9.72 中文使用说明 · 文策知识馆整理 · 2026-09-12