Kilo Code VS Code 扩展完全指南从安装、快照构建到 Agent 架构解析【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeKilo 是一个开源的 all-in-one agentic engineering 平台其 VS Code 扩展kilo-code位于本仓库packages/kilo-vscode/是使用最广泛的入口之一它把完整的 AI 编码 Agent 运行时以侧边栏、编辑器标签页和 Agent Manager 多会话面板三种形态嵌入 VS Code并内置行内自动补全、浏览器自动化、MCP 服务器市场与自定义 Agent 模式。本文将带你从零安装扩展理解其扩展进程 → CLI 后端的双进程架构掌握本地快照构建与多平台发布流程并深入关键源码确认每个能力背后的实现机制。Kilo Code 是什么一扩展接入 500 模型packages/kilo-vscode/package.json中对该扩展的定位是开源 AI 编码 Agent可用自然语言生成代码、自动化任务并执行终端命令同时提供行内自动补全、浏览器自动化、自动化重构以及用于规划、编码、调试的自定义模式支持 500 AI 模型Claude、Gemini、Grok、GPT、Codex、GLM 等。扩展在 VS Code 侧边栏、编辑器标签页、JetBrains、CLI、Slack 与 Cloud 等多端共享同一套后端能力。从仓库结构看本扩展遵循瘦客户端架构它并不内置 Agent 运行时而是打包并拉起 CLI 二进制bin/kilo通过 HTTP REST SSE 与后端通信详见 AGENTS.md 的架构说明。因此无论你用的是哪个 IDE 客户端会话、工具、Provider 与配置都沉淀在同一套后端中。关键特性与源码印证原 README 归纳了六大核心特性本节逐一展开并结合源码确认其实现路径。1. 代码生成Code Generation用自然语言描述需求Kilo 即可生成代码。这一能力由 CLI 后端的 AI Agent 运行时packages/opencode/提供扩展侧通过KiloProvider侧边栏与kilo-code.new.TabPanel编辑器标签页两种 webview 承载会话交互入口见 src/extension.ts。激活时扩展注册了kilo-code.SidebarProviderwebview view并设置retainContextWhenHidden: true以保证切换到其他面板时 webview 不会销毁。2. 行内自动补全Inline Autocomplete输入时获得智能补全核心实现在 src/services/autocomplete/classic-auto-complete/AutocompleteInlineCompletionProvider.ts它实现了 VS Code 的InlineCompletionItemProvider。值得注意的实现细节自适应防抖初始防抖 300ms采集 10 个延迟样本后动态调整为最近请求延迟的平均值且始终钳制在 150ms1000ms 之间结果缓存与去重最近 20 条建议按scope/prefix/suffix判重缓存命中缓存时无需重新请求 LLM熔断与退避当 API 返回 401/403/402/429/5xx 时进入ErrorBackoff退避避免在额度耗尽或鉴权失效时向 API 洪泛失败请求对 402额度耗尽还会周期性探测账户余额以自动恢复忽略规则通过FileIgnoreController尊重.gitignore等忽略配置被忽略文件不触发补全FIM 提示构建基于 Fill-In-The-Middle 方式组织前缀/后缀上下文FillInTheMiddle.ts并利用最近访问/最近编辑范围作为额外上下文。扩展还提供 Next EditNextEditInlineCompletionProviderTab 接受、Esc 取消与 Suggested Edits 等联动能力相关命令见 package.json 中的kilo-code.new.autocomplete.*系列。3. 任务自动化与自动化重构Kilo 可自动执行重复编码任务并重构既有代码。侧边栏提供kilo-code.new.cycleAgentMode等命令切换不同 Agent 模式编辑器右键菜单集成了 Explain Code / Fix Code / Improve Code / Add to Context 四个入口终端右键菜单集成了 Add Terminal Content to Context / Fix This Command / Explain This Command注册逻辑见 src/extension.ts 与 src/services/code-actions/。4. MCP Server 市场MCP Server Marketplace扩展内置市场面板MarketplacePanelProvider用于发现与安装 MCP 服务器以扩展 Agent 能力。服务层实现位于 src/services/marketplace/MarketplaceService负责拉取市场数据、检测已安装项、评估条目与当前工作区的相关性并提供安装/移除能力src/services/marketplace/index.ts。此外MarketplaceNotifier会在市场条目与工作区匹配时给出可关闭的通知。5. 多模式Multi Mode用 Architect 规划、用 Coder 编码、用 Debugger 调试并支持自定义模式。命令面板提供kilo-code.new.cycleAgentMode默认Ctrl./Cmd.与kilo-code.new.cyclePreviousAgentMode在模式间切换模式本身由后端配置驱动kilo-code.new.reload命令可重载配置与技能。快速上手三步完成安装原 README 的启动流程如下这里补充各步骤的可验证细节安装扩展在 VS Code 扩展市场搜索kilocode.Kilo-Code发布者为kilocode扩展 ID 为kilocode.kilo-code对应仓库目录packages/kilo-vscode。扩展要求 VS Code^1.105.1见 package.json 的engines字段并声明onStartupFinished与onUri两个激活事件——这意味着启动完成后命令、代码操作、快捷键、自动补全与 URI 深链即可用无需先打开侧边栏。创建账户登录后即可访问平台聚合的 500 模型。扩展通过 CLI 后端的网关/账户体系完成鉴权详见packages/kilo-gateway/的 auth 实现并支持KILO_SERVER_PASSWORD环境变量为扩展与本地kilo serve子进程之间的 HTTP 通信提供基础认证见 AGENTS.md。开始编码扩展激活时注册了 URI 深链处理器vscode://kilocode.kilo-code/kilocode/...可打开云会话或切换模型/Agent见 src/extension.ts同时自动注册提交信息生成、代码操作、快捷键与自动补全服务输入即用。常用快捷键定义于 package.json 的keybindings操作Windows/LinuxmacOS聚焦聊天输入框CtrlShiftACmdShiftA切换自动批准Auto-ApproveCtrlAltACmdAltA生成终端命令CtrlShiftGCmdShiftG打开 Agent ManagerCtrlShiftMCmdShiftM切换 Agent 模式Ctrl.Cmd.生成建议编辑CtrlLCmdL接受/跳转下一条建议编辑TabTab取消建议编辑 / 补全EscEsc选中内容加入上下文CtrlK CtrlACmdK CmdA架构深度扩展进程与 CLI 后端的协作理解 Kilo Code 的运行方式关键在扩展只是后端的一个客户端。根据 AGENTS.md 与 src/extension.ts激活时创建唯一共享的KiloConnectionService侧边栏、所有 Open in Tab 面板与 Agent Manager 复用同一个连接SSE 事件按各 webview 的trackedSessionIds过滤分发ServerManager懒启动打包的bin/kilo serve --port 0子进程从 stdout 捕获动态端口后经 HTTP SSE 通信进程退出后可自动拉起替代进程扩展Node/CJS与 webview浏览器/IIFE之间没有共享状态完全通过vscode.Webview.postMessage()通信webview 使用 Solid.js 构建esbuild.js中为扩展与 webview 维护两套独立构建Keep AwakeCaffeinationService可防止系统在 Agent 工作时休眠仅在本地 VS Code 窗口可用并需用户显式确认自动补全预暖ensureBackendForAutocomplete会在各全局事件消费者就绪后提前拉起后端缩短首次输入补全的等待。开发者构建与快照发布Snapshot Builds如果你想在本地构建、调试或分享开发版本原 README 提供了两个命令需在packages/kilo-vscode/目录下执行# 仅构建VSIX 输出到系统临时目录 bun run snapshot:build # 构建并直接安装进 VS Code bun run snapshot:install其实现位于 script/dev-snapshot.ts细节如下快照版本号由三部分组成${pkg.version}-snapshot${commitSha}.${gitUser}。其中commitSha取自git rev-parse --short HEADgitUser取自git config --get --default local user.name并转为小写、非字母数字替换为-为空则回退为local。例如文档示例7.0.47-snapshot8ff7f2d02.kirillk构建前会清理dist/依次执行prepare:sdk、local-bin.ts --compiled准备 CLI 二进制与生产构建校验VSIX 输出到系统临时目录kilo-vscode-snapshots/snapshot:install模式为了本地安装更快会以不压缩方式打包压缩版 VSIX 更小但本地安装更慢并通过--force --install-extension安装若设置了VSCODE_EXEC_PATH指向 Insiders 版脚本会自动改用code-insiders安装。另外普通开发模式可通过bun run extension构建并启动 VS Code 开发实例、bun run extension:isolated持久化隔离状态与bun run extension:isolated:clean清空隔离状态后启动运行详见 AGENTS.md 的命令表。发布流水线VS Code Marketplace 与 Open VSX仓库的发布脚本 script/publish.ts 展示了正式发布的完整流程为8 个平台目标分别打包并发布linux-x64、linux-arm64、alpine-x64、alpine-arm64、darwin-x64、darwin-arm64、win32-x64、win32-arm64每个目标依次发布到VS Code Marketplacevsce publish与Open VSXovsx publish失败时以指数退避重试最多 3 次设置KILO_PRE_RELEASEtrue时以--pre-release发布预发布通道正式发布还会把 VSIX 上传到 GitHub Release仓库根目录github/下的 action 与script/中的publish.ts、version.ts等共同构成版本管理与发布体系。贡献与许可Kilo Code 欢迎开发者、写作者与爱好者参与。贡献前请阅读 CONTRIBUTING.md环境搭建、编码规范、贡献类型与 PR 提交流程并遵守 CODE_OF_CONDUCT.md。社区期望建立在尊重、包容与协作之上。本扩展以Apache License 2.0授权见 LICENSE允许自由使用、修改与分发含商业用途前提是保留适当的署名与许可声明。仓库根目录另有 AGENTS.md、CONTRIBUTING.md、TESTING.md 等文档可供继续深入。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Kilo Code VS Code 扩展完全指南从安装、快照构建到 Agent 架构解析【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeKilo 是一个开源的 all-in-one agentic engineering 平台其 VS Code 扩展kilo-code位于本仓库packages/kilo-vscode/是使用最广泛的入口之一它把完整的 AI 编码 Agent 运行时以侧边栏、编辑器标签页和 Agent Manager 多会话面板三种形态嵌入 VS Code并内置行内自动补全、浏览器自动化、MCP 服务器市场与自定义 Agent 模式。本文将带你从零安装扩展理解其扩展进程 → CLI 后端的双进程架构掌握本地快照构建与多平台发布流程并深入关键源码确认每个能力背后的实现机制。Kilo Code 是什么一扩展接入 500 模型packages/kilo-vscode/package.json中对该扩展的定位是开源 AI 编码 Agent可用自然语言生成代码、自动化任务并执行终端命令同时提供行内自动补全、浏览器自动化、自动化重构以及用于规划、编码、调试的自定义模式支持 500 AI 模型Claude、Gemini、Grok、GPT、Codex、GLM 等。扩展在 VS Code 侧边栏、编辑器标签页、JetBrains、CLI、Slack 与 Cloud 等多端共享同一套后端能力。从仓库结构看本扩展遵循瘦客户端架构它并不内置 Agent 运行时而是打包并拉起 CLI 二进制bin/kilo通过 HTTP REST SSE 与后端通信详见 AGENTS.md 的架构说明。因此无论你用的是哪个 IDE 客户端会话、工具、Provider 与配置都沉淀在同一套后端中。关键特性与源码印证原 README 归纳了六大核心特性本节逐一展开并结合源码确认其实现路径。1. 代码生成Code Generation用自然语言描述需求Kilo 即可生成代码。这一能力由 CLI 后端的 AI Agent 运行时packages/opencode/提供扩展侧通过KiloProvider侧边栏与kilo-code.new.TabPanel编辑器标签页两种 webview 承载会话交互入口见 src/extension.ts。激活时扩展注册了kilo-code.SidebarProviderwebview view并设置retainContextWhenHidden: true以保证切换到其他面板时 webview 不会销毁。2. 行内自动补全Inline Autocomplete输入时获得智能补全核心实现在 src/services/autocomplete/classic-auto-complete/AutocompleteInlineCompletionProvider.ts它实现了 VS Code 的InlineCompletionItemProvider。值得注意的实现细节自适应防抖初始防抖 300ms采集 10 个延迟样本后动态调整为最近请求延迟的平均值且始终钳制在 150ms1000ms 之间结果缓存与去重最近 20 条建议按scope/prefix/suffix判重缓存命中缓存时无需重新请求 LLM熔断与退避当 API 返回 401/403/402/429/5xx 时进入ErrorBackoff退避避免在额度耗尽或鉴权失效时向 API 洪泛失败请求对 402额度耗尽还会周期性探测账户余额以自动恢复忽略规则通过FileIgnoreController尊重.gitignore等忽略配置被忽略文件不触发补全FIM 提示构建基于 Fill-In-The-Middle 方式组织前缀/后缀上下文FillInTheMiddle.ts并利用最近访问/最近编辑范围作为额外上下文。扩展还提供 Next EditNextEditInlineCompletionProviderTab 接受、Esc 取消与 Suggested Edits 等联动能力相关命令见 package.json 中的kilo-code.new.autocomplete.*系列。3. 任务自动化与自动化重构Kilo 可自动执行重复编码任务并重构既有代码。侧边栏提供kilo-code.new.cycleAgentMode等命令切换不同 Agent 模式编辑器右键菜单集成了 Explain Code / Fix Code / Improve Code / Add to Context 四个入口终端右键菜单集成了 Add Terminal Content to Context / Fix This Command / Explain This Command注册逻辑见 src/extension.ts 与 src/services/code-actions/。4. MCP Server 市场MCP Server Marketplace扩展内置市场面板MarketplacePanelProvider用于发现与安装 MCP 服务器以扩展 Agent 能力。服务层实现位于 src/services/marketplace/MarketplaceService负责拉取市场数据、检测已安装项、评估条目与当前工作区的相关性并提供安装/移除能力src/services/marketplace/index.ts。此外MarketplaceNotifier会在市场条目与工作区匹配时给出可关闭的通知。5. 多模式Multi Mode用 Architect 规划、用 Coder 编码、用 Debugger 调试并支持自定义模式。命令面板提供kilo-code.new.cycleAgentMode默认Ctrl./Cmd.与kilo-code.new.cyclePreviousAgentMode在模式间切换模式本身由后端配置驱动kilo-code.new.reload命令可重载配置与技能。快速上手三步完成安装原 README 的启动流程如下这里补充各步骤的可验证细节安装扩展在 VS Code 扩展市场搜索kilocode.Kilo-Code发布者为kilocode扩展 ID 为kilocode.kilo-code对应仓库目录packages/kilo-vscode。扩展要求 VS Code^1.105.1见 package.json 的engines字段并声明onStartupFinished与onUri两个激活事件——这意味着启动完成后命令、代码操作、快捷键、自动补全与 URI 深链即可用无需先打开侧边栏。创建账户登录后即可访问平台聚合的 500 模型。扩展通过 CLI 后端的网关/账户体系完成鉴权详见packages/kilo-gateway/的 auth 实现并支持KILO_SERVER_PASSWORD环境变量为扩展与本地kilo serve子进程之间的 HTTP 通信提供基础认证见 AGENTS.md。开始编码扩展激活时注册了 URI 深链处理器vscode://kilocode.kilo-code/kilocode/...可打开云会话或切换模型/Agent见 src/extension.ts同时自动注册提交信息生成、代码操作、快捷键与自动补全服务输入即用。常用快捷键定义于 package.json 的keybindings操作Windows/LinuxmacOS聚焦聊天输入框CtrlShiftACmdShiftA切换自动批准Auto-ApproveCtrlAltACmdAltA生成终端命令CtrlShiftGCmdShiftG打开 Agent ManagerCtrlShiftMCmdShiftM切换 Agent 模式Ctrl.Cmd.生成建议编辑CtrlLCmdL接受/跳转下一条建议编辑TabTab取消建议编辑 / 补全EscEsc选中内容加入上下文CtrlK CtrlACmdK CmdA架构深度扩展进程与 CLI 后端的协作理解 Kilo Code 的运行方式关键在扩展只是后端的一个客户端。根据 AGENTS.md 与 src/extension.ts激活时创建唯一共享的KiloConnectionService侧边栏、所有 Open in Tab 面板与 Agent Manager 复用同一个连接SSE 事件按各 webview 的trackedSessionIds过滤分发ServerManager懒启动打包的bin/kilo serve --port 0子进程从 stdout 捕获动态端口后经 HTTP SSE 通信进程退出后可自动拉起替代进程扩展Node/CJS与 webview浏览器/IIFE之间没有共享状态完全通过vscode.Webview.postMessage()通信webview 使用 Solid.js 构建esbuild.js中为扩展与 webview 维护两套独立构建Keep AwakeCaffeinationService可防止系统在 Agent 工作时休眠仅在本地 VS Code 窗口可用并需用户显式确认自动补全预暖ensureBackendForAutocomplete会在各全局事件消费者就绪后提前拉起后端缩短首次输入补全的等待。开发者构建与快照发布Snapshot Builds如果你想在本地构建、调试或分享开发版本原 README 提供了两个命令需在packages/kilo-vscode/目录下执行# 仅构建VSIX 输出到系统临时目录 bun run snapshot:build # 构建并直接安装进 VS Code bun run snapshot:install其实现位于 script/dev-snapshot.ts细节如下快照版本号由三部分组成${pkg.version}-snapshot${commitSha}.${gitUser}。其中commitSha取自git rev-parse --short HEADgitUser取自git config --get --default local user.name并转为小写、非字母数字替换为-为空则回退为local。例如文档示例7.0.47-snapshot8ff7f2d02.kirillk构建前会清理dist/依次执行prepare:sdk、local-bin.ts --compiled准备 CLI 二进制与生产构建校验VSIX 输出到系统临时目录kilo-vscode-snapshots/snapshot:install模式为了本地安装更快会以不压缩方式打包压缩版 VSIX 更小但本地安装更慢并通过--force --install-extension安装若设置了VSCODE_EXEC_PATH指向 Insiders 版脚本会自动改用code-insiders安装。另外普通开发模式可通过bun run extension构建并启动 VS Code 开发实例、bun run extension:isolated持久化隔离状态与bun run extension:isolated:clean清空隔离状态后启动运行详见 AGENTS.md 的命令表。发布流水线VS Code Marketplace 与 Open VSX仓库的发布脚本 script/publish.ts 展示了正式发布的完整流程为8 个平台目标分别打包并发布linux-x64、linux-arm64、alpine-x64、alpine-arm64、darwin-x64、darwin-arm64、win32-x64、win32-arm64每个目标依次发布到VS Code Marketplacevsce publish与Open VSXovsx publish失败时以指数退避重试最多 3 次设置KILO_PRE_RELEASEtrue时以--pre-release发布预发布通道正式发布还会把 VSIX 上传到 GitHub Release仓库根目录github/下的 action 与script/中的publish.ts、version.ts等共同构成版本管理与发布体系。贡献与许可Kilo Code 欢迎开发者、写作者与爱好者参与。贡献前请阅读 CONTRIBUTING.md环境搭建、编码规范、贡献类型与 PR 提交流程并遵守 CODE_OF_CONDUCT.md。社区期望建立在尊重、包容与协作之上。本扩展以Apache License 2.0授权见 LICENSE允许自由使用、修改与分发含商业用途前提是保留适当的署名与许可声明。仓库根目录另有 AGENTS.md、CONTRIBUTING.md、TESTING.md 等文档可供继续深入。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
