写下想法，看见脉络。
Vex 是基于 .NET 与 Avalonia 的桌面 Markdown 编辑器，支持 Windows、Linux、macOS，围绕本地文件提供即时编辑、源码、阅读、章节导图、导出与本机 MCP 协作。
官网：vex.codewf.com · 出品：码坊 CodeWF · 当前版本：1.20.2.0
从 GitHub Releases 下载安装包及对应 SHA256：Windows x64 EXE、Linux x64/arm64 DEB、macOS x64/arm64 DMG。
- 即时编辑、源码、阅读与章节导图，八种固定布局及独立视图窗口，共享当前文档。
- 本地文件与文件夹、最近记录、大纲、查找替换、自动保存和异常退出草稿恢复。
- Markdown、HTML、PDF、PNG、Word 导出，微信公众号、知乎、稀土掘金复制。
- 九套界面配色、十三套正文排版，支持浅色、深色、跟随系统及四种界面语言。
- 文件夹与大纲折叠、布局、导航和编辑偏好持久化；保存失败、外部变更与恢复草稿有独立保护流程。
- 本机 MCP 服务提供 29 个工具，支持访问范围、修改确认、审计和 stdio 桥接。
源码与即时编辑提供选区字号、前景色和背景色，样式以 Markdown 中的行内标记保存。Mermaid 支持 24 类图表，单击即可在图表上方编辑源码，点击正文后提交并收起。单阅读正文会随窗口扩展，最大可达当前显示器宽度的一半。
以下界面由 Vex 1.20.0.0 与正式自研库 12.2.48 的真实 Avalonia 控件渲染生成。更多操作见快速开始，采集方式见截图说明。
| 源码与阅读对照 | 文档导图 |
|---|---|
 |
 |
| 配色与外观 | 正文排版 |
|---|---|
 |
 |
桌面及三平台安装原型在 design，应用已接入 9 套配色、13 套正文排版及对应工作区交互。运行 node design/scripts/preview.cjs 后打开 http://127.0.0.1:4317/design/ 。视觉对照和跨平台验证范围见验收文档。
# 重产物默认落在仓库内 artifacts/；想放仓库外时用相对或任意路径即可（正斜杠跨平台）。
$vexWorkRoot = [IO.Path]::GetFullPath('../vex-temp')
pwsh scripts/restore_library_candidate.ps1 -OutputRoot "$vexWorkRoot/library-candidate"
dotnet restore Vex.slnx "-p:ArtifactsPath=$vexWorkRoot/artifacts"
dotnet build Vex.slnx --no-restore -v:minimal "-p:ArtifactsPath=$vexWorkRoot/artifacts"
dotnet run --project src/Vex/Vex.csproj -f net11.0 --no-restore "-p:ArtifactsPath=$vexWorkRoot/artifacts"应用版本在 Directory.Build.props，框架默认值在 build/ProjectDefaults.props，依赖版本变量在 build/Versions.props，Directory.Packages.props 维护中央包声明，SDK 由 global.json 选择。主分支使用 .NET 11 RC；Win7 历史兼容基线冻结在 win7-archive，不再维护。应用图标以根目录 logo.svg、logo.png、logo.ico 为源；共享库经 NuGet 消费，本地联调和五 RID NativeAOT 发布见开发文档。