Skip to content

feat: 添加 MCP 本地 AI 协作能力 #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sunyonghuan wants to merge 4 commits into
base: main
Choose a base branch
from
Open

feat: 添加 MCP 本地 AI 协作能力 #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
308fb8f
feat: 添加 MCP 功能
sunyonghuan Jun 6, 2026
6422865
docs: 补充 MCP 功能说明
sunyonghuan Jun 6, 2026
076cac2
fix: 刷新文件夹视图并补齐 MCP 国际化
sunyonghuan Jun 15, 2026
0ea3097
feat: 调整源码和预览面板切换
sunyonghuan Jun 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Directory.Build.props
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project>
<PropertyGroup>
<Version>1.1.2.1</Version>
<Version>1.1.2.2</Version>
<Authors>沙漠尽头的狼</Authors>
<Company>CodeWF</Company>
<Title>Vex - 维刻</Title>
Expand Down
15 changes: 15 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Vex 希望提供一个轻量、清爽、可离线使用的 Markdown 写作环境
- 整理文档时可以打开单个文件或整个文件夹，快速在同目录文档之间切换。
- 发布时可以导出 HTML、PDF、PNG、Word，也可以复制为微信公众号、知乎、稀土掘金可直接粘贴的富 HTML。
- 分享时会尽量嵌入图片资源，让 PDF 和 Word 文件离线发送后仍能正常查看。
- 需要 AI 协作时，可以通过本机 MCP 接口让支持 MCP 的 AI 客户端读取、编辑、预览和保存当前文档。

当前版本：`1.1.0`

Expand Down Expand Up @@ -60,6 +61,19 @@ Vex 希望提供一个轻量、清爽、可离线使用的 Markdown 写作环境
- 内置简体中文、繁体中文、英文、日文界面资源。
- 帮助文档、快速开始、更新日志和鸣谢文档会随发布产物一起输出。

### MCP 与 AI 协作

- 内置本机 MCP Server，入口位于“帮助 -> MCP 设置”，可设置启用状态、监听地址、端口、授权 Token 和访问范围。
- 默认使用本机 loopback 地址，例如 `http://127.0.0.1:17891/mcp/`，并通过 Bearer Token 鉴权。
- 暴露当前文档读取、选区读取、大纲读取、渲染 HTML 读取、应用状态读取和操作审计读取等只读工具。
- 暴露整体替换文档、按 offset 应用文本编辑、插入文本、替换选区、打开授权范围内文档、保存当前文档等文档工具。
- 暴露基础界面操作工具，包括读取界面状态、切换主题、切换排版、切换语言、切换侧边栏/预览/源码模式、打开基础面板、执行常用编辑命令、触发现有导出和复制富 HTML 流程。
- AI 编辑会更新 Vex 当前文档状态，并实时刷新编辑器、预览、大纲和状态栏。
- 保存当前文档不弹出确认；文档编辑、打开文档、复制富 HTML 默认需要用户确认。
- 不向 AI 暴露删除、打印、新窗口、全屏、置顶、打开外部网站、反馈、新手引导、清空最近文档、打开文件所在位置、剪切、粘贴等高意图或系统级操作。
- MCP 工具名对外使用 OpenAI function calling 兼容的下划线格式，例如 `vex_get_current_document`；旧的 `vex.get_current_document` 调用会由服务端兼容归一化。
- MCP 协议和工具分发采用手写 JSON-RPC、静态工具 schema 和 `System.Text.Json` source generation，避免反射扫描工具方法，保持 Native AOT 兼容。

### 发布产物

- 支持 `win-x64`、`linux-x64`、`linux-arm64`、`osx-x64`、`osx-arm64` 多 RID 发布。
Expand Down Expand Up @@ -113,6 +127,7 @@ Release 压缩包会排除 `*.pdb` 调试符号文件。已有产物默认不会

- [快速开始](docs/QuickStart.md)
- [更新日志](docs/CHANGELOG.md)
- [MCP 功能实现方案](docs/MCP功能实现方案.md)
- [鸣谢](docs/ACKNOWLEDGEMENTS.md)
- [GitHub Release 文案](RELEASES.md)

Expand Down
8 changes: 8 additions & 0 deletions Vex-main.code-workspace
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"folders": [
{
"path": "."
}
],
"settings": {}
}
12 changes: 12 additions & 0 deletions docs/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# 更新日志

## 1.1.2.2 - 2026-06-15

### 修复

- 🐞[修复]-左侧文件视图会监听已打开文件夹内 Markdown/txt 文件的新增、删除、重命名和修改，并自动刷新文件列表。
- 🐞[修复]-帮助菜单 MCP 设置入口、MCP 设置窗口端点标签和 MCP Server 状态文本补齐国际化资源，切换语言后显示对应语言文案。

### 测试

- 🧪[测试]-构建 `Vex.slnx`，确认 `net10.0` 与 `net10.0-windows` 均可生成。
- 🧪[测试]-人工验证打开文件夹后新增、删除文件时左侧文件视图会同步更新，MCP 设置窗口语言切换正常。

## 1.1.2.1 - 2026-06-02

### 新增
Expand Down
Loading