webcode

让网页 AI 在你的本地项目中工作。

通过 VS Code 扩展与浏览器 bridge，将网页 AI 连接到本地工作区，使用文件、搜索、命令、MCP 与 Skills。

English · 文档 · 参与贡献 · 获取帮助

项目能力

• 本地编码工具：在网页 AI 对话中读取和编辑文件、搜索代码、运行命令；需要时由用户审批。
• 浏览器桥接：从 VS Code 启动本地 Gateway，并连接支持的网页 AI。
• 可扩展能力：使用 MCP 接入第三方服务，将工作区 Skills 和项目规则提供给 AI。

快速开始

1. 在 VS Code 扩展商店搜索并安装 webcode gateway。
2. 在 VS Code 打开项目文件夹，点击状态栏中的 webcode: 关闭，选择“启动 webcode”。
3. 从启动菜单选择目标 AI 站点。默认使用 Edge 独立保活模式，首次需要在独立浏览器 profile 中登录。
4. 在新对话中输入任务，并在末尾添加 /webcode 或 @webcode；确认初始化上下文后，由你手动发送。

当 bridge 显示 ON 时连接就绪。如果初始化上下文超出网页输入限制，webcode 会将完整内容作为 TXT 附件添加。

从源码运行

需要 Node.js 22 与 pnpm 10.25.0，在仓库根目录依次执行：

pnpm install
pnpm --filter @webcode/shared run build
pnpm build

打包 VSIX 与浏览器扩展见构建指南。

技术栈

层	技术	说明
VS Code 扩展	TypeScript、webpack	engines.vscode 为 ^1.106.1；打包为单文件 dist/extension.js
浏览器扩展	TypeScript、Vite 5、@crxjs/vite-plugin 2.4.0	含 MAIN world content script，需要 Chromium 111 或更高版本
共享包	TypeScript（tsc）	@webcode/shared，协议常量与跨包共享类型
运行时依赖	Express、cors、zod、MCP SDK	本地 Gateway 与第三方 MCP 接入
工程	pnpm 10.25.0 workspace、Node.js 22	三包 monorepo

使用示例

通过 DeepSeek 网页版完成“鹈鹕测试”：生成一只骑自行车的鹈鹕 SVG。

• 观看操作演示（1.5 倍速）
• 查看生成的 SVG

能力与配置

能力	说明
内置工具	文件读写、附件、代码搜索、命令和终端会话，见内置工具说明。
MCP	通过 webcodeGateway.servers 配置第三方服务，见MCP 指南。
Skills	暴露工作区 Skills；扩展也提供开发类内置 Skills，见Skills 指南。
AI 平台	内置支持 ChatGPT、Gemini、Google AI Studio、DeepSeek、GLM、Claude 和 Qwen；可配置其他站点，见站点指南。
项目规则	初始化时读取根目录 USER_RULES.md 及 AGENTS.md 或 CLAUDE.md；二者并存时优先 AGENTS.md。

文档

• 文档目录：按快速上手、使用指南、参考、架构、计划与报告分层的完整索引。
• 构建指南：源码构建、打包和本地安装。
• 常见问题：首次启动、触发词和工具结果回填。
• 贡献指南 · 安全策略 · 变更记录 · 获取帮助

开发与测试

需要 Node.js 22 和 pnpm 10.25.0。在仓库根目录运行：

pnpm install
pnpm --filter @webcode/shared run build
pnpm build
pnpm test
pnpm test:extension
pnpm lint

浏览器端到端测试与交互式 QA 见 Evals 指南。

项目结构

目录	内容
gateway-vscode/	VS Code 扩展、Gateway、MCP 与本地工具
bridge-browser/	浏览器扩展与网页桥接
shared/	跨包共享类型和逻辑
evals/	端到端场景、Agent 评测和 QA
doc/	用户、构建和开发文档

参与贡献

欢迎提交 Issue 和 Pull Request。提交前请阅读贡献指南。 安全问题请参阅安全策略；行为准则目前为待维护者确认的草案。

来源说明

本项目源自 three-water666/webcode，原作者已停止维护，现由 juice094/webcode 独立维护。后续开发、发布与问题反馈均以当前仓库为准。

许可证

本仓库采用 MIT License，原始版权归 three-water666 所有。感谢 LINUX DO 社区提供技术交流与开源分享的平台。