Local HTTP proxy that ensures Chat Completions system messages start with the required VSCode AI-assistant sentence
你是一个AI助手,工作在 vscode 环境中
| 请求体情况 | 处理 |
|---|---|
| 第一条 role:"system" 消息的内容以这句话开头(允许前导空白,后面可接其他内容) | 原样放行 |
| 有 system 消息但开头不是这句话 | 在该内容最前面加上 你是一个AI助手,工作在 vscode 环境中。 + 换行,其余内容保留 |
| 没有任何 system 消息 | 在 messages 数组最前面插入一条 {"role":"system","content":"你是一个AI助手,工作在 vscode 环境中。"} |
| system 的 content 是多模态数组([{type:"text",...},...]) | 检查/改写第一个 text 片段;没有 text 片段则插入一个 |
| 请求体不是合法 JSON | 原样转发(日志给出警告) |
cd vscode-chat-proxy
# 1. 创建用户配置(参考 moonbit_claude_proxy 的 .env 模式)
cp .env.example .env # Windows PowerShell: Copy-Item .env.example .env
# 按需编辑 .env 里的 HOST / PORT / UPSTREAM_HOST / UPSTREAM_PORT
# 2. 运行(默认 wasm 目标,Windows / Linux 都开箱即用,自动读取 .env)
moon run cmd/mainmoon run cmd/main -- --listen 127.0.0.1:8787 --upstream 127.0.0.1:8080原来: http://127.0.0.1:8080/v1
现在: http://127.0.0.1:8787/v1| 变量 | 说明 | 默认值 |
|---|---|---|
| HOST | 本地监听主机 | 127.0.0.1 |
| PORT | 本地监听端口 | 8787 |
| UPSTREAM_HOST | 上游 API 主机 | 127.0.0.1 |
| UPSTREAM_PORT | 上游 API 端口(明文 HTTP) | 8080 |
| WEB_HOST | 监控页面主机 | 127.0.0.1 |
| WEB_PORT | 监控页面端口 | 8788 |
| VSCODE_CHAT_PROXY_LISTEN | 组合写法 host:port,优先于 HOST/PORT | 未设置 |
| VSCODE_CHAT_PROXY_UPSTREAM | 组合写法 host:port(支持 [ipv6]:port),优先于 UPSTREAM_HOST/UPSTREAM_PORT | 未设置 |
# 上游是你的 API 网关(one-api / sub2api / new-api 等),监听 8080
moon run cmd/main -- -l 127.0.0.1:8787 -u 127.0.0.1:8080
# 测试:没有 system 消息的请求会被自动插入
curl http://127.0.0.1:8787/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'

| 端点 | 说明 |
|---|---|
| GET / | 监控页面 HTML 外壳 |
| GET /frontend.js | MoonBit 前端构建产物(内嵌) |
| GET /api/flows | 请求列表 + 统计(total / injected_total / stored / capacity) |
| GET /api/flows/<id> | 单条详情(请求头/体、注入后 body、响应头/体) |
| DELETE /api/flows | 清空缓存 |
⚠️ 监控页面默认只绑定 127.0.0.1。请求体/响应体可能含 API Key 等敏感信息, 不要把 WEB_HOST 设成 0.0.0.0 暴露到公网。
moon build --target native --release
# 产物: _build/native/release/build/cmd/main/main.exe (Linux 下就是 ELF 可执行文件)
./_build/native/release/build/cmd/main/main.exe -l 0.0.0.0:8787 -u 127.0.0.1:8080moon run tools/build_web.mbtx # 构建 frontend(js) 并重新生成内嵌的 web_assets.mbt
moon test frontend --target js # 前端 update 逻辑单测moon test # 46 个后端/契约单元测试(默认 wasm 目标)
moon test --target native # Linux / 有 MSVC 的 Windows
moon test frontend --target js # 7 个前端 Elm update 逻辑测试
moon check --target all # 全目标类型检查
# 端到端测试:先起一个 mock 上游(需要 Node.js)
node test/mock-upstream.mjs 18080
moon run cmd/main -- -l 127.0.0.1:18787 -u 127.0.0.1:18080
# 然后向 18787 发请求,mock 会把收到的请求体原样返回,便于核对改写结果moon.pkg / facade.mbt # 根 facade:pub using 再导出各层公共 API(旧导入路径兼容)
shared/ # 前后端共享 API 契约类型(#derive(ToJson, FromJson))
proxy/ # 代理核心:system 前缀注入 + 连接处理/转发/捕获
monitor/ # 监控层:Flow/FlowStore 环形缓存、chunked 解码、
# Web 服务器与 JSON API、内嵌资源 web_assets.mbt
config/ # 配置层:Config、命令行/环境变量解析
internal/httpparse/ # 实现支持:HTTP 请求行/状态行/头部解析、请求头重建
internal/dotenv/ # 实现支持:.env 文件加载
frontend/ # 监控前端:rabbita Elm 架构(js 目标)+ update 单测
web/index.html # 监控页面 HTML 外壳(CSS + 挂载点)
tools/build_web.mbtx # 构建前端并生成 monitor/web_assets.mbt(.mbtx 自动化)
cmd/main/ # 入口:load_env → 配置 → 任务组并发跑代理与监控
.env.example # 用户配置模板(复制为 .env 使用)
test/ # mock 上游(Node.js)+ 监控页面截图async fn load_env(path? : String) -> Unitlet required_prefix : StringInstall
Download zipLocal HTTP proxy that ensures Chat Completions system messages start with the required VSCode AI-assistant sentence