
Cordonix 是 IoTSharp 旗下的本地执行与工作区契约项目,简称 cdx。它把程序、参数、工作目录、文件路径、文本编码和预期哈希拆成明确字段,让 AI 智能体可以直接调用本地程序、读取和编辑文件,同时保留可验证的结果边界。
2026 年 11 月 10 日,Cordonix 发布 v0.5.0。这一版的重点不是增加一个孤立命令,而是把“多个本地调用同时到达时如何处理”“如何观察远程桌面”“如何把发布包和安装过程验清楚”这些实际工作流补齐。
一、MCP 请求排队:并发到达,按顺序执行
AI 智能体经常会在很短时间内发出多个工具调用。例如,一边查询目录,一边读取配置,再请求一次构建或测试。如果服务端把这些请求直接交给同一个活动执行器,就容易出现操作占用、结果交叉或调用方需要自行重试的问题。
v0.5.0 增加了单活动请求队列。新的调用会进入 FIFO 队列,当前请求结束后再开始下一个;每项请求仍然有自己的超时、取消、输出上限和子进程清理边界。队列解决的是调度顺序,不改变工具本身的权限,也不把一次未知结果自动变成可重试操作。
这项变化让 MCP 客户端可以继续使用原来的工具契约,而无需在每个调用方重复实现互斥锁。对于超时、取消和外部副作用,Cordonix 仍保留 unknown、timed_out 等状态,不把“没有收到完整响应”误判成“没有发生写入”。
二、VNC 远程截图:把现场状态带回工具结果
本版加入了 Windows 原生 VNC 能力和 screenshot 工具。经过授权后,工具可以连接目标桌面,捕获远程屏幕并返回 PNG,同时支持凭据存储和有界的连接、读取、输出和清理流程。
截图能力的定位是观察现场状态:它可以帮助排查远端 GUI、核对设备画面、记录操作前后的视觉证据。截图成功只证明 PNG 已生成,不自动证明画面内容完整,也不把远程桌面控制扩展成无限制的交互。Windows 端使用原生图像捕获路径,Linux 端保留明确的能力边界。
三、工具说明和发布包:让“能安装”变成“能核验”
Cordonix 的 MCP 工具描述在这一轮继续补齐输入字段和使用边界,覆盖程序参数、文件编码、哈希检查、网络发送、截图目标、VNC 连接等关键输入。工具说明不是装饰,它决定了 AI 调用方能否在第一次请求时传出正确的结构化参数。
发布流程也同步加强:Windows x64 ZIP 与 Linux x64 tar.gz 继续通过 SHA-256、版本和包内容检查;GitHub 与 Gitee 的发布资产保持镜像核对。0.5.0 的源码、标签、发布包和本机升级验证分别记录,不能用其中一层证据替代另外一层。
四、如何开始
项目仓库:
- GitHub:https://github.com/IoTSharp/Cordonix
- Gitee:https://gitee.com/IoTSharp/Cordonix
正式版本:
- GitHub Releases:https://github.com/IoTSharp/Cordonix/releases/tag/v0.5.0
- Gitee Releases:https://gitee.com/IoTSharp/Cordonix/releases/tag/v0.5.0
安装时建议使用仓库中的安装指南和对应平台发布包,并核对 SHA-256。Windows 用户可以使用 install\install.ps1,Linux 用户可以使用 install/install.sh。安装完成后,再用 cdx --version 和项目提供的测试入口确认实际运行的二进制版本。
五、已发布能力与下一步计划分开看
当前已发布的 v0.5.0 包含 MCP 请求排队、VNC 远程截图、工具输入说明和跨平台发布包验证。工作区中另有一批正在开发的上下文效率计划,包括显式工具配置、摘要结果与原始输出回读、可复现测量,以及后续的模型无关项目事实和失败指纹。这些计划已经记录在路线图中,但不属于 v0.5.0 的运行时能力。
这种区分很重要:源码改动、构建通过、发布包、已安装客户端和真实现场运行,分别回答不同问题。Cordonix 继续把这些证据拆开记录,让本地 AI 工具链在效率提升的同时保留可追溯性。
项目欢迎围绕 Windows 原生执行、MCP 工具契约、文件编码和远程现场证据提出 issue 或 PR。