在Windows 系统中更好的读写文件或者执行命令

Qoder Windows端AI文件操作工具优化功能需求

Problem

目前Qoder Windows系统版本中,AI大模型执行本地文件读写、编辑、创建、删除等文件操作时,默认依赖PS1、BAT系统脚本完成能力调用。该原生脚本调用方式存在大量稳定性缺陷,是当前文件操作异常的核心痛点:

1. 文件操作成功率低:脚本执行受Windows系统权限、路径编码、文件锁、系统策略限制极大,频繁出现文件读写失败、写入内容不全、文件创建/删除无响应等问题,导致AI任务中断、执行结果出错。

2. 兼容性与容错性差:不同Windows版本、用户自定义权限配置、中文/特殊字符文件路径,都会导致PS1/BAT脚本执行失效,无法适配复杂的本地文件场景。

3. 操作能力单一、规范性不足:原生脚本仅能实现基础文件操作,缺乏标准化的文件管理能力,批量文件处理、精准文件读写、目录遍历等复杂场景极易出错,且无统一的执行校验机制。

4.AI执行逻辑冗余:AI需要自主生成、解析、执行系统脚本,脚本编写存在随机性,容易出现语法错误、指令冲突,大幅增加无效执行成本,降低AI工作效率。

Solution

摒弃Qoder Windows端AI默认的PS1/BAT脚本文件操作模式,内置集成标准化MCP(Model Context Protocol)工具,替代原生脚本完成所有本地文件、桌面资源操作,具体实现方案如下:

1. 集成两款核心MCP服务工具,默认预装、后台常驻启动,无需用户手动配置:

- desktop-commander:基于npx全局调用,采用stdio通信模式,负责桌面级资源操作、系统目录管理、批量文件指令执行,替代原有脚本的系统层级操作能力;

- filesystem:基于官方MCP文件服务,标准化实现文件读写、创建、修改、删除、遍历、权限校验等核心文件操作,统一AI文件调用规范。

工具配置标准参数:

"desktop-commander": {
    "command": "npx",
    "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest"
    ],
    "type": "stdio"
},
"filesystem": {
    "command": "npx",
    "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem"
    ],
    "type": "stdio"
}

2. 重构AI文件操作调用逻辑:让AI大模型优先调用内置MCP工具执行所有文件、目录操作,不再生成和执行PS1/BAT脚本,所有文件交互通过标准化MCP协议完成。

3. 增加执行容错与校验机制:依托MCP工具原生的异常捕获、路径解析、权限适配能力,自动规避Windows系统环境差异问题,操作失败返回标准化报错信息,支持AI重试修复。

4. 保留工具自动更新能力:通过npx拉取最新版本MCP工具,确保文件操作能力持续迭代,兼容新版Windows系统特性。

Use Case

1. 核心场景:Windows系统下,AI自动执行代码文件创建、代码写入、文件修改、日志读写、配置文件更新等开发常用文件操作,解决脚本执行失败导致的任务失效问题。

2. 复杂路径场景:用户本地文件路径包含中文、空格、特殊字符、超长路径时,AI稳定完成文件读写、目录遍历操作,规避脚本编码兼容问题。

3. 批量操作场景:AI批量创建、修改、删除项目多文件、多级目录,替代低效、易报错的批量脚本指令。

4. 权限受限场景:普通用户权限、受限系统策略下,AI正常执行合规文件操作,减少权限导致的读写失败。

5. 日常AI辅助开发场景:AI自动补全代码文件、生成配置文件、整理项目目录、清理冗余文件等高频操作。

Priority

:yellow_circle: Medium - Important improvement

说明:当前脚本文件操作问题未完全阻断核心使用,但高频出现文件读写失败、任务异常,严重影响Windows端用户使用体验与AI工作效率,属于亟需优化的核心体验问题。

Additional Info

1. 工具依赖:Node.js环境(npx原生支持),Qoder端需保证基础运行环境兼容;

2. 工具官方资源:

- desktop-commander:@wonderwhy-er/desktop-commander 最新版

- filesystem MCP服务:@modelcontextprotocol/server-filesystem 官方稳定版

3. 部署方式:内置集成、后台自动启动,用户无感知、无需手动配置;

4. 适配范围:仅针对Windows系统Qoder客户端,替代原有PS1/BAT脚本执行逻辑。