AI Disk Doctor 集成

面向 AI Disk Doctor Core 的通用本地 Agent 技能和只读 MCP 服务器。

此仓库是集成与分发层。它不实现第二个扫描器、清理器、风险引擎、恢复模型或策略系统。本地 Core 仍然是执行和策略的事实来源。

Alpha 范围

MCP 服务器暴露四个工具：

I0 不暴露 clean、restore、quarantine、delete、任意 shell 或任意文件系统变更工具。在公共 Core 提供合并后的 M1C 可解释性契约之前，explain_storage 有意不包含在内。

安装

先决条件

• Node.js 18 或更高版本。

• AI Disk Doctor Core v1.7.0 或兼容的更高版本 Core，位于 PATH 中，命令名为 aidisk/aidisk.exe。

• 当 Core 二进制文件安装在其他位置时，设置 AIDISK_EXE。

从检出安装：

git clone https://github.com/quzhiii/ai-disk-doctor-integrations.git
cd ai-disk-doctor-integrations
npm install
npm start

对于确定性的本地安装，请固定仓库检出版本或使用带标签的发布版本。npm 依赖在 package-lock.json 中固定为 @modelcontextprotocol/sdk 1.30.0。

该进程使用 MCP stdio 传输，应由 MCP 客户端启动，而不是作为独立的交互式程序打开。

OpenCode

OpenCode 支持在 opencode.json 或 opencode.jsonc 中声明项目级 MCP：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-disk-doctor": {
      "type": "local",
      "command": ["node", "C:/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "C:/absolute/path/to/your-workspace",
      "enabled": true
    }
  }
}

对于全局安装，请为 command 参数使用绝对路径，并在需要时在 environment 中设置 AIDISK_EXE。将 cwd 设置为应存储 Core 快照的用户工作区，而不是集成检出目录。然后使用 opencode mcp list 或让代理检查 core_status。已检入的示例位于 adapters/opencode/opencode.jsonc。

OpenCode Agent 技能从 .opencode/skills、.claude/skills 或 .agents/skills 中发现。对于项目或用户安装，将 skills/ai-disk-doctor 复制或符号链接到其中一个位置。

Qwen Code

Qwen Code 通过 qwen mcp 或 settings.json 支持本地 stdio MCP 服务器：

qwen mcp add --scope user --transport stdio ai-disk-doctor node ./src/server.js

等效的 .qwen/settings.json 条目：

{
  "mcpServers": {
    "ai-disk-doctor": {
      "command": "node",
      "args": ["/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "/absolute/path/to/your-workspace",
      "env": { "AIDISK_EXE": "aidisk" },
      "trust": false
    }
  }
}

仓库根目录通过其 qwen-extension.json 成为 Qwen 扩展包。在 npm install 之后，将仓库作为本地扩展安装；参见 adapters/qwen/README.md。规范技能仍然是同一个技能，而不是 Qwen 特定的治理实现。

CodeBuddy / WorkBuddy

使用已安装产品支持的本地 MCP 配置界面，并将其指向相同的 node ./src/server.js stdio 进程。将其工作目录设置为 Core 快照历史应存放的工作区。不包含任何 Expert 角色或供应商特定的风险逻辑。在官方、可本地测试的 CodeBuddy / WorkBuddy 客户端契约可用之前，暂缓确定具体打包方式；参见 adapters/codebuddy/README.md。

TRAE

使用 TRAE 文档中记载的项目 MCP 配置，并添加相同的本地 stdio 进程。将其工作目录设置为 Core 快照历史应存放的工作区。在本地有 TRAE 客户端可供验证之前，暂缓确定具体项目打包方式；参见 adapters/trae/README.md。

Core 诊断

# Verify the Core directly
aidisk --help

# Verify the integration server syntax
npm run check

# Override the Core executable
# Windows PowerShell:
$env:AIDISK_EXE = 'C:\\Tools\\aidisk.exe'
# POSIX shells:
export AIDISK_EXE=/opt/aidisk

如果 Core 缺失或返回格式错误/不兼容的输出，core_status 会报告结构化失败。MCP 进程不会下载 Core、克隆仓库、联系云服务，或静默替换为其他扫描器。

安全边界

• MCP 传输仅限本地 stdio。

• 服务器仅启动配置的 aidisk 可执行文件，并使用固定的只读子命令。

• 不存在任意 shell 或任意命令工具。

• 不存在清理、隔离执行、恢复、删除或变更工具。

• scan_summary 标记为 readOnlyHint: false，因为当前 Core 扫描持久化可能会写入 AI Disk Doctor 拥有的快照。它仍然是 destructiveHint: false，不会修改用户/工作区文件。

• 根据 Core 契约，模型清单仅包含元数据；此集成不会读取提示词、转录、源代码、文档、令牌、cookie 或凭据内容。

• 提供给工具的路径仅传递给相应的 Core 命令或历史元数据读取器。此集成不会递归读取这些路径。

代理绝不能通过 shell 命令删除路径来绕过这些规则。如果未来的变更流程获得批准，它必须使用单独的授权界面。

开发

npm install
npm run check
npm test

要进行真实的 Core 冒烟测试，请安装/构建固定的 Core 修订版，将 aidisk 放入 PATH 或设置 AIDISK_EXE，然后运行 npm test。当未设置 AIDISK_EXE 时，跳过真实 Core 测试。其余协议测试使用临时目录和 Core 缺失场景；它们不会假装已安装供应商客户端。

许可证

集成源代码采用 MIT 或 Apache-2.0 双重许可。参见 LICENSE-MIT 和 LICENSE-APACHE。Core 的许可仍由公共 Core 仓库管辖。

状态

I0 Alpha。此仓库不是商业版 Desktop，不包含账户、计费、授权、遥测、云同步或专有 Desktop 代码。