AIBoter Bridge

AIBoter Bridge 是一个 VS Code 侧边栏聊天扩展，用来把多个 Anthropic 兼容或 OpenAI 兼容接口接到统一的聊天与 Agent 工作流中。

项目说明

这个项目的目标是提供一个固定模型配置、固定代理接口、可直接在编辑器里执行项目操作的聊天助手。除了普通聊天模式，它还提供 Agent 模式，可以在工作区里读取文件、修改文件、搜索文本、创建目录、执行命令，并把这些动作以较清晰的方式展示在界面中。

官网：https://guanli.teach-assistant.com/

核心能力

• 提供 VS Code 侧边栏聊天界面，支持 chat 和 agent 两种模式
• 内置固定模型配置，统一接入 Anthropic 兼容和 OpenAI 兼容网关
• 通过 VS Code Secret Storage 保存共享 API Key
• 支持工作区工具能力： list_files read_file write_file append_file replace_in_file make_dir search_text run_command
• 在模型输出不完整或疑似异常断流时自动续写 / 自动恢复
• 将 Agent 的规划、执行、完成步骤持久化到每条助手消息里，任务结束后仍可查看过程
• 在 release/ 目录下保留可安装的 .vsix 包

功能特性

• 在 VS Code Activity Bar 中添加 AIBoter 图标
• 默认在右侧打开聊天面板
• 固定模型端点配置，不允许随意改 Base URL / API Path / Model
• API Key 保存在 VS Code 安全存储中
• Agent 模式下支持工作区读写与命令执行
• 将工作区动作展示为更易读的进度项，而不是直接暴露原始 JSON

默认模型配置

• Opus 4.8
  • Provider: anthropic
  • Base URL: https://guanli.teach-assistant.com/claudeapi
  • API Path: /v1/messages
• Opus 4.7
  • Provider: anthropic
  • Base URL: https://guanli.teach-assistant.com/claudeapi
  • API Path: /v1/messages
• Opus 4.6
  • Provider: anthropic
  • Base URL: https://guanli.teach-assistant.com/claudeapi
  • API Path: /v1/messages
• Sonnet 4.6
  • Provider: anthropic
  • Base URL: https://guanli.teach-assistant.com/claudeapi
  • API Path: /v1/messages
• DeepSeek V4
  • Provider: anthropic
  • Base URL: https://guanli.teach-assistant.com/deepseekapi
  • API Path: /v1/messages
  • Request Model: DeepSeekV4
• GPT 5.6 Sol
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/codeapi
  • API Path: /responses
  • Request Model: gpt-5.6-sol
• GPT 5.6 Terra
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/codeapi
  • API Path: /responses
  • Request Model: gpt-5.6-terra
• GPT 5.6 Luna
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/codeapi
  • API Path: /responses
  • Request Model: gpt-5.6-luna
• GPT 5.5
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/codeapi
  • API Path: /responses
• GPT 5.4
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/codeapi
  • API Path: /responses
• Kimi K3
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/kimiapi
  • API Path: /v1/chat/completions
  • Request Model: kimi-k3
• Gemini 3 Pro High
  • Provider: openai
  • Base URL: https://guanli.teach-assistant.com/geminiapi
  • API Path: /v1/chat/completions
  • Request Model: gemini-3-pro-high

扩展中只有 API Key 可编辑，模型配置本身是固定的。

仓库结构

• aiboter-bridge/extension.js 扩展主逻辑、WebView UI、模型适配层、Agent 循环、工作区工具实现
• aiboter-bridge/package.json VS Code 扩展清单
• aiboter-bridge/extension.vsixmanifest VSIX 打包元数据
• aiboter-bridge/tests/continuation-recovery.test.js 续写恢复与响应解析相关的最小回归测试
• release/ 打包后的 VSIX 安装包

开发与验证

本地验证

node aiboter-bridge/tests/continuation-recovery.test.js
node --check aiboter-bridge/extension.js

打包方式

当前项目通过直接拼装 VSIX 目录结构并压缩的方式输出安装包到 release/。

安装方式

1. 打开 VS Code 扩展视图
2. 点击右上角 ... 菜单
3. 选择 Install from VSIX...
4. 选择打包好的 .vsix 文件

使用方式

1. 点击 Activity Bar 中的 AIBoter 图标
2. 打开 Settings
3. 给当前模型填写 API Key
4. 保存后直接发送消息

Ctrl+Enter 用于发送当前输入内容。

说明

• 这不是官方的 Claude Code 扩展，也不是官方的 Codex 扩展
• 实际兼容性取决于上游代理接口是否满足预期的 API 结构
• 如果上游接口需要额外请求头、不同的流式格式，或不同的响应字段，需要在扩展代码中继续适配

更新日志

0.0.116

• 修复 WebView 内嵌模型下拉列表未同步的问题，确保 Kimi K3 在界面显示
• 清理 WebView 内嵌模型列表中多余的 Gemini 选项，仅保留 Gemini 3 Pro High

0.0.115

• 恢复模型列表中的 Kimi K3 显示项
• Gemini 模型列表收敛为仅保留 Gemini 3 Pro High

0.0.84

• 会话与工作区绑定：会话索引改存到 VS Code 的 workspaceState，由 VS Code 按打开的目录自动隔离与持久化
  • 打开 a 目录只显示 a 工作区创建的会话；打开 b 目录只显示 b 的会话，互不干扰
  • 重新打开同一目录会自动恢复该目录的历史会话；会话消息文件仍按唯一 id 存于全局存储，仅被所属工作区的索引引用
  • 注意：从 0.0.83 升级后，此前存在全局的旧会话不会自动迁移到某个工作区（避免把无关会话塞进当前项目），按工作区重新开始

0.0.83

• 修复对话卡住 / 莫名其妙中断的问题，并让每一次被迫中断都有明确提示：
  • 新增流式响应停滞检测：代理把连接挂住却不返回数据时，不再傻等到 10 分钟硬超时——首字最长等待 3 分钟、字间最长 90 秒，超时即自动中断并按可重试错误重连
  • 停滞/网络类错误纳入自动重连（最多 5 次），重连过程改为中文清晰提示“连接异常（原因），N 秒后自动重连（第 x/5 次）”
  • 统一中断原因提示 describeInterruptionReason：手动中断、请求超时、流式停滞、鉴权失败(401/403)、限流(429)、上游 5xx、网络失败均给出明确中文说明，并在已有部分输出时于结尾追加警告而非静默结束
  • 新增对应单元测试（停滞检测、可重试判定、中断原因文案）

0.0.82

• 修复 Agent 经常“声称已创建/修改文件但实际并未写入”的问题：
  • 修正 forceStopAfterTools 逻辑——当写入工具失败、被判为重复而未执行，或声称完成却没有任何成功写入时，不再直接返回“任务完成”，而是把工具结果回灌让模型真正执行/修复
  • 扩充中文完成语句与写入意图识别（覆盖“已经创建/创建成功/开发完成/修复函数/新建脚本”等更多表达），让强制使用工具的纠偏逻辑可靠触发
  • 新增结构化诚实兜底：当本轮没有任何成功的 write_file/append_file/replace_in_file/make_dir（且未执行命令）却声称改动时，回复末尾追加明确警告，绝不把“未落盘”说成“已完成”
  • 强化 Agent 系统提示：明确“输出文件内容 ≠ 创建文件”，未拿到工具成功结果前不得声称已创建/修改/完成

0.0.81

• 新增多会话能力：顶部会话标签栏逐个展示会话，右侧“新建”快速新建、“管理”下拉管理所有会话（切换、重命名、删除、清空全部历史会话）
• 会话磁盘持久化到扩展的 globalStorage，关闭或重启 VS Code 后历史会话仍然保留，可随时切回
• 切换到历史会话时自动载入完整上下文并提示记忆要点，AI 可直接续上之前的任务，无需重新描述需求
• 会话记忆（自动压缩摘要）改为按会话隔离，避免不同会话之间记忆串扰
• 优化与 AI 对话的输出风格（Cursor 级严谨）：结论先行、简洁可读、严禁臆造文件内容或结果、以 path:line 引用代码、收尾给出改动文件与验证状态，语气更友好专业

0.0.77

• 修复 Agent 模式下工具动作全部被阻止为重复操作时导致死循环的问题
• 新增连续全部阻止轮次计数器，连续 3 轮全部被阻止后强制退出循环并返回结果

0.0.76

• 修复 AI 返回的原始 JSON 工具块（{"actions":[...]}）在文本中间泄露显示的问题
• 新增 removeEmbeddedActionJson 函数，使用平衡括号检测移除嵌入文本中的 JSON 工具块
• 所有类型的工具动作（读取、搜索、列表等）均渲染为工具块，不再仅限写类操作

0.0.75

• 小猴子 GIF 与"正在工作中..."文字合并到同一行
• 状态栏固定在消息区域底部，始终可见不受滚动影响
• 消息区域改为 flex column 布局，加载气泡简化为仅保留 spinner 和工具进度

0.0.74

• 修复进度历史在对话完成后仍固定显示的问题
• 完成的消息不再显示"正在规划 / 正在执行 / 最近完成"等进度块
• 渲染层仅在轮次进行中时展示进度历史

0.0.73

• 已成功完成的读取、搜索、列文件和命令操作在工作区状态未变化时不再重复执行
• 读-only 分析总结会被识别为任务完成，避免 Agent 继续追加相同的检查动作

0.0.72

• 读取文件、搜索文本、列文件、命令执行等 Agent 过程状态仅临时展示，不再固定保留到对话记录
• 固定对话记录中的操作结果只保留写入、追加、替换、创建目录等关键完成项

0.0.71

• Agent 执行中的“正在规划 / 正在执行”中间态不再作为固定对话记录保留
• 任务结束后仍保留已完成的工作区操作结果和助手总结

0.0.70

• 将 Agent 的执行过程持久化到每条助手消息中，不再只显示在临时 loading 区域
• 任务结束后保留规划 / 执行 / 完成等工作步骤
• 不再把“总结 + 文件列表”这类正常收尾回复压缩成通用的 已处理相关文件
• README 补充中文项目说明、仓库结构、开发验证方式和更新日志

0.0.69

• 修复 DeepSeek V4 在 Agent 中遇到“正在检查 / 继续完善”这类占位文案时过早停下的问题
• 为 Anthropic 兼容路径补充 OpenAI 风格文本提取兜底，适配 DeepSeek V4 的兼容响应
• 新增续写恢复和响应解析相关回归测试

0.0.68

• 修复流在第一轮 watchdog 触发前就结束时，明显未完成回复无法自动恢复的问题
• 增加首批续写恢复测试

0.0.67

• 增加基于 stream watchdog 的异常断流自动续写恢复

0.0.66

• 增加 DeepSeek V4 与新的 Gemini 模型配置