云效 Agent — VSCode 插件

本地驱动的 AI 编程助手：直连 OpenAI 兼容的大模型服务，在 VSCode 内直接执行文件读写、代码智能、Git、终端等本地工具，内置审批网关保障操作安全。无需部署云端 Agent 服务。

功能特性

本地驱动 — 插件直连任意 OpenAI 兼容端点（OpenAI / DeepSeek / 通义千问 / vLLM / Ollama 等），本地完成工具执行，代码与文件不出工作区
本地工具执行 — 21 个内置本地工具，覆盖文件系统、代码智能、Git、终端、Diff、任务进度、网络检索
审批网关 — 写 / 执行 / 删除类操作弹审批卡片（允许 / 始终允许 / 拒绝），只读操作自动放行；支持全访问模式自动批准非删除操作
流式对话 — SSE 流式回复、打字机效果，工具调用过程实时可视化，含每步与会话级 token 用量统计
多会话管理 — 新建、历史切换、重命名、删除；会话按工作区隔离本地持久化
上下文自动压缩 — 对话接近模型上下文窗口时自动生成摘要压缩，保留近期关键信息
模型切换 — 输入框下方快速切换模型，或使用 /model 斜杠命令
外部网络检索 — 可选启用 web_search 工具，通过 Tavily 检索最新网络信息并注入对话
Skill 系统 — 从 .vscode/skills 或 Claude / Trae 的 SKILL 目录加载技能，支持 /skill-name 斜杠命令；同时加载全局 ~/.agents/skills 与工作区 AGENTS.md 规则
MCP 工具 — 在设置页配置本地 STDIO 或远程 Streamable HTTP 的 MCP Server，动态发现的工具自动桥接为 Function Calling，经同一审批与结果治理链执行
斜杠命令 — /new 新会话、/stop 停止生成、/help 帮助、/model 切换模型；输入框 @ 引用文件自动注入上下文
Markdown 渲染 — 代码块、列表、链接、表格等完整渲染

快速开始

打开 VSCode 设置，搜索「云效」，配置模型连接（见下方示例）
命令面板 Ctrl+Shift+P → 输入「云效 Agent: 打开对话面板」（或点击活动栏「云效 Agent」图标、编辑器右上角的对话图标），对话面板将在编辑器区域打开
在输入框输入消息，Enter 发送，Shift+Enter 换行

模型配置示例

在 VSCode 设置（settings.json）中配置：

{
  "yunxiaoAgent.model.baseURL": "https://api.deepseek.com/v1",
  "yunxiaoAgent.model.model": "deepseek-chat",
  "yunxiaoAgent.model.apiKey": "sk-xxxxxxxx"
}

不支持的 Provider 或缺失的 API Key 会在启动对话时给出明确错误提示。

前置条件

VSCode ^1.99.0 及以上
一个 OpenAI 兼容的 LLM 服务（/v1/chat/completions 端点），如 OpenAI、DeepSeek、通义千问，或本地部署的 vLLM / Ollama

本地工具一览

类别	工具	说明	权限
文件	`fs_read_file`	分页读取文件内容	只读
文件	`fs_write_file`	原子写入 UTF-8 文本文件	需审批
文件	`fs_list_dir`	列出目录内容	只读
文件	`fs_search_files`	按内容搜索文件（ripgrep / glob）	只读
文件	`fs_delete_file`	删除文件（移入回收站）	需审批
文件	`fs_move_file`	移动 / 重命名文件	需审批
代码	`code_edit`	字符串替换或 unified diff 精准编辑，带 diff 预览与冲突检测	需审批
代码	`code_find_references`	查找符号引用	只读
代码	`code_get_diagnostics`	获取文件诊断信息	只读
代码	`code_go_to_definition`	跳转到符号定义	只读
代码	`code_workspace_symbols`	搜索工作区符号	只读
Git	`git_status` / `git_log` / `git_diff`	仓库状态、提交历史、差异查看	只读
Git	`git_commit` / `git_branch` / `git_stash`	提交、分支管理、stash 操作	需审批
终端	`terminal_exec`	执行 shell 命令并捕获输出；白名单命令自动放行，危险命令需审批	需审批
Skill	`skill`	按名称加载 Skill，返回 Markdown 指令	只读
网络	`web_search`	通过 Tavily 检索网络信息（需在设置中启用并配置 API Key）	只读
任务	`todo_write`	创建 / 更新会话内的任务进度列表，供面板展示	需审批

MCP 工具配置

MCP（Model Context Protocol）Server 在插件设置页的「MCP」分类中管理，配置由插件私有保存，不读取项目 .mcp.json。支持两类 Transport：

STDIO — 通过 command / args 启动本地子进程（如 codegraph serve --mcp），不经 shell；cwd 缺省按当前主工作区解析，绝对/越界路径拒绝
Streamable HTTP — 连接远程 url，仅允许 HTTPS（loopback 地址允许 HTTP）；静态 headers 绑定配置 URL 的 origin，跨 origin redirect 被拒绝；可勾选「兼容旧版 SSE」作为 legacy HTTP+SSE 回退

配置示例

{
  "mcpServers": {
    "codegraph": {
      "type": "stdio",
      "command": "codegraph",
      "args": ["serve", "--mcp"],
      "env": {},
      "enabled": true
    },
    "remote-docs": {
      "type": "streamable-http",
      "url": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer token"
      },
      "legacySseFallback": true,
      "enabled": true
    }
  }
}

秘密存储与占位语义

非敏感配置保存在用户级 ~/.yunForce/mcp/servers.json；所有 env / headers 的值存入 VS Code SecretStorage，普通文件与设置页永不回显明文
编辑已保存的 Server 时，已有秘密显示为占位值 <已安全保存>：保留占位 = 保留原秘密；输入新值 = 替换；删除 key = 删除对应秘密；新 Server 使用占位或空秘密会被拒绝
模型无法新增、修改或删除 MCP Server，也无法通过工具参数指定 endpoint、URL、command 或 headers——全部由设置页用户操作决定

运行时行为

设置页可查看每个 Server 的配置/实际 Transport、状态（disabled / waiting_workspace_trust / connecting / ready / reconnecting / error / stopping）、工具数与错误摘要，并执行启停、重连、编辑与删除
ready Server 的 MCP 工具以 mcp__<server>__<tool> 命名注册为 Function Calling，工具结果继续经过脱敏与截断治理
工作区不可信时保留配置但停止连接（waiting_workspace_trust）；恢复可信后自动重连
远程 Server 仅当配置 legacySseFallback 且错误被判定为 Transport/协议不匹配（404/405）时回退 legacy SSE；401/403、TLS/DNS、超时与 5xx 不回退

安全模型

路径守卫 — 所有文件操作经 pathGuard 校验，限定在打开的工作区内，越界读写被拒绝
分级审批 — 只读工具自动放行；写 / 执行 / 删除类工具弹审批卡片，提供「允许（本次会话记忆）/ 始终允许（写入配置）/ 拒绝」三选项
终端白名单 — yunxiaoAgent.shellWhitelist 前缀匹配自动放行（如 npm test、git status）；rm -rf、管道、重定向、sudo 等危险命令强制审批
结果治理 — 工具返回结果在发往模型前自动脱敏密钥、截断长度，避免泄露与上下文超限

扩展设置（常用）

配置项	默认值	说明
`yunxiaoAgent.model.baseURL`	`https://api.openai.com/v1`	LLM API 地址（OpenAI 兼容 `/v1/chat/completions`）
`yunxiaoAgent.model.model`	空	模型名称（如 `gpt-4o-mini`、`deepseek-chat`）
`yunxiaoAgent.model.apiKey`	空	LLM API Key（Bearer Token）
`yunxiaoAgent.model.temperature`	`0.7`	生成温度
`yunxiaoAgent.model.maxTokens`	`4096`	单次最大输出 token 数
`yunxiaoAgent.toolTimeoutMs`	`30000`	本地工具执行超时（毫秒）
`yunxiaoAgent.terminalTimeoutMs`	`300000`	终端命令执行超时（毫秒）
`yunxiaoAgent.alwaysAllowTools`	`[]`	无需审批直接放行的工具名列表（如 `fs_write_file`）
`yunxiaoAgent.approvalMode`	`request`	审批模式：`request` 逐次确认 / `full-access` 自动批准非删除操作
`yunxiaoAgent.webSearch.enabled`	`false`	是否启用外部网络检索 `web_search` 工具
`yunxiaoAgent.webSearch.apiKey`	空	Tavily API Key（启用网络检索后必须配置）
`yunxiaoAgent.shellWhitelist`	14 条安全命令前缀	终端自动放行的命令前缀
`yunxiaoAgent.skills.directories`	`[".vscode/skills"]`	Skill 搜索目录（相对工作区根）
`yunxiaoAgent.sync.source`	`none`	生态配置来源：`none` / `claude`（同步 Claude SKILL 与项目规则）/ `trae`
`yunxiaoAgent.agent.maxSteps`	`50`	Agent 循环最大步数
`yunxiaoAgent.compaction.autoEnabled`	`true`	是否启用上下文自动压缩

更多配置项（读文件护栏、结果截断、范围授权等）可在 VSCode 设置中搜索「云效」查看。

安装

从 Open VSX 市场安装

在 VSCode 扩展面板搜索「云效 Agent」直接安装。

安装 .vsix 文件

code --install-extension yunxiao-agent-vscode-0.1.1.vsix

或在 VSCode 内：扩展面板 → 右上角 ··· → 从 VSIX 安装。

许可证

MIT

码力云效 Agent

yunxiao