Workgroup

A project group chat for you, Codex and Claude inside Visual Studio Code.

Workgroup 把你、Codex 和 Claude 放进同一个 VS Code 项目聊天，支持共享讨论、上传文件、读取公开网页，以及审阅后应用代码建议。当前版本为 0.2.2 预览版，扩展 ID：GwenZhang.workgroup。

上传文件与图片

输入框左下角的「＋ 上传附件」直接打开文件选择器，支持多选，无需先打开编辑器。可上传 PNG/JPEG/WebP 图片、UTF-8 文本（TXT/Markdown/CSV/JSON 等）、DOCX 和文本型 PDF。图片会作为真正的视觉输入发送给所选 AI；文件提取的文字加入共享讨论。PDF/DOCX 只提取正文文字，不提取版式或内嵌图片；扫描 PDF 请改为上传页面截图。

每条消息最多 5 个附件，单文件最多 5 MB，总计不超过 20 MB。文档单份最多 48000 字符、PDF 最多 100 页；超过限制会明确报错，不会悄悄截断。图片显示缩略图，附件可逐个移除，也可以只发附件不输入文字。最近会话最多带 10 张图片、20 MB 图片上下文；达到上限时请新建会话。已发送图片的本地副本保存在扩展存储中，原文件不会被修改。

读取网页

发送包含公开 HTTP(S) 链接的消息时，插件会先直接读取最多 3 个链接，并在消息下显示「已读取网页」或具体失败原因。取到的正文作为引用资料共享给两位 AI，因此不依赖托管网页工具是否能打开该地址。每个链接限时 15 秒、下载最多 2 MB，单页正文最多 60000 字符、每条消息合计最多 90000 字符，超出时标记为部分正文。网页需执行 JavaScript 或登录时仍可能读不到。关闭 webAccess 会同时关闭此直接读取。

默认允许根据你的要求搜索和读取公开网页，包括你发到群里的作业说明或文档链接。Codex 使用实时网页工具；Claude 使用官方 web search / web fetch 工具，可能产生额外服务商费用。需要登录或被网站阻止的内容仍可能无法读取，插件不使用浏览器 Cookie。可在设置关闭 workgroup.webAccess，该选择从下一条发送的消息生效。文件修改仍通过 diff 审阅，不需要开启完整文件系统权限。

选择模型

输入框下方分别显示 Codex 和 Claude 的模型；点击模型按钮打开可搜索的选择菜单。也可通过「连接 AI」或命令面板中的「Workgroup: 选择 Codex 模型 / 选择 Claude 模型」切换。Codex 读取 CLI 的模型目录，Claude 使用你的 API Key 读取官方 Models API；目录请求失败时仍可手动填写模型 ID。目录不是权限或余额保证，真实请求结果决定可用性。

Codex 可选择「使用 CLI 默认模型」。选择保存在当前项目的 VS Code 工作区设置中，无项目时使用用户设置；已有设置中的模型 ID 也会显示。每条消息在发送时固定所选模型，之后切换不影响正在工作或排队的消息；AI 回复旁标注该轮选择。模型目录查询不发送聊天内容。

Codex connection discovery checks PATH, standalone installation locations, and optionally the CLI bundled with the installed official OpenAI extension (openai.chatgpt). The bundled layout is a compatibility fallback and can change; an explicitly configured absolute CLI path takes precedence. Use 连接 AI → 检测 Codex 连接 to check availability and login status.

一起工作

• 一个侧边栏群聊：你、Codex、Claude 共用讨论记录。
• @Codex、@Claude，或选择「一起回答」。一起回答时 Codex 先工作，Claude 接着读取其实际回复。
• 消息排队、停止当前任务、选中代码附件、多个本地聊天、可搜索历史会话和 JSON 导出。
• 两位 AI 提交文件修改建议；点击文件查看原文与建议的 diff，再选择应用。
• 应用前核对原文和编辑器版本；冲突时拒绝整组建议，要求重新生成。群内 AI 依次工作，避免同时写文件。

安装与连接

1. 使用桌面版 VS Code 1.95 或更新版本，打开并信任一个本地项目文件夹。
2. 在 VS Code 扩展商店搜索 GwenZhang.workgroup 并安装，也可以使用 Install from VSIX… 安装本地包。
3. 点击活动栏 Workgroup 图标，选择 连接 AI。
4. Codex：安装官方 Codex CLI，通过「登录 Codex」或终端 codex login 登录 ChatGPT 账号。若 VS Code 找不到命令，在 workgroup.codexPath 设置可执行文件的绝对路径。需要支持 exec --json --ephemeral --output-schema 的官方 CLI。插件复用 CLI 的正常认证方式；若 CLI 原本配置 API 认证，费用也按该方式计算。插件不会读取认证文件。
5. Claude：在「设置 Claude API Key」中输入你自己的 Anthropic API Key。Key 存储于 VS Code SecretStorage；费用计入你的 Anthropic API 账户。可在设置修改 workgroup.claudeModel。插件不提供 Claude 订阅账号登录。
6. 默认「一起回答」需要已配置 Claude Key；只用 Codex 可切换为 Codex。

你：一起查看项目，给一个开发计划。
Codex：我建议先实现……
Claude：我读了 Codex 的计划，补充……
你：@Codex 按刚才的计划修改登录表单。
你：查看 diff → 应用建议 → 保存文件
你：@Claude 审阅刚才已经应用的改动。

修改代码的方式

Codex 以官方 CLI 的只读沙箱运行，返回结构化修改建议；Claude 使用受限的项目文件读取、目录列表和修改建议工具。Claude 不执行终端命令。插件不会自动运行测试、安装依赖、提交 Git 或推送远程；你可以在 VS Code 终端执行测试，再将结果贴回群聊。

第一版支持新增和替换 UTF-8 文件，不支持文件删除、移动、二进制文件或符号链接。每次建议最多 10 个文件，单文件最多 256 KB。已有文件的修改进入编辑器缓冲区，由用户保存；新增文件通过 VS Code WorkspaceEdit 创建。应用与撤销遵循 VS Code 的工作区编辑行为。

多根工作区使用第一个文件夹；请分别打开项目以建立独立群聊。当前版本支持桌面本地项目，不支持浏览器版 VS Code、SSH/容器和虚拟工作区。聊天按工作区保存；「… → 新建会话」会保留原记录，点击「… → 历史对话」可搜索并切回旧聊天，重启后恢复上次打开的会话。每个聊天的消息、名称、附件与修改建议独立保存。最多将最近 60 条消息发给下一位 AI，过长时要求新建会话；不承诺无限记忆。

隐私

聊天、代码附件、AI 读取的源码和修改建议会发给被选中的模型服务商。选择「一起回答」时，两家服务商都可能收到这些内容。插件没有自建中转服务器、遥测或分析服务。记录和附件保存在当前工作区的扩展存储中，Claude Key 使用 VS Code SecretStorage。新建会话保留历史记录；移除尚未发送的图片会删除其缓存副本。公开链接读取会向目标网站发送无登录凭据的请求。服务商的处理、保留和计费政策分别适用。完整隐私说明随插件提供于 PRIVACY.md。

开发与打包

安装 Node.js 20+ 和 npm：

npm install
npm run build
npm test
npm run check
npm run package

在 VS Code 中打开本目录，按 F5 启动 Extension Development Host。

文档解析器在打包时构建到 dist/，安装后的插件不需要额外安装 npm 依赖。自动化测试使用协议、DOM 和 HTTP 模拟，不调用付费模型。已在 macOS 的 VS Code 中安装测试，其他系统尚未进行实机验证。

Workgroup 是独立项目，不是 OpenAI、Anthropic 或 Microsoft 的官方产品。各服务的账号访问、额度和模型可用性由相应服务商决定。

支持与反馈

请通过 Marketplace 的 Q&A 提交问题。请勿在公开反馈中包含 API Key、账号令牌、私人聊天或未公开项目代码。