Codex Workspace Enhancer

一个原生的、无需端口的 OpenAI Codex 可视化工作区。 无需修补 Codex 应用或暴露 localhost 服务，即可在无限画布上整理项目图片、参考资料和创意笔记。

简体中文 · 架构 · 安全 · AI 可读摘要

它解决了什么问题

在 Codex 中的创意工作往往涉及参考图片、生成帧、笔记和反复对比。Codex Workspace Enhancer 将这种视觉上下文保留在当前对话中：

• 从 Codex 编辑器中原生打开，作为一个 MCP 应用。

• 浏览已批准的项目图片，无需将其复制到云服务中。

• 在无限画布上平移、缩放、调整大小、多选并整理图片。

• 添加创意笔记，并在会话之间保留带版本管理的画布状态。

• 将选中的本地图片路径附加到对话上下文中，而不会自动发送消息。

• 请求全屏显示，同时当宿主拒绝或不支持时仍可内嵌使用。

首选的原生插件使用 stdio、ui:// 资源和捆绑的独立 MCP 服务器。它不会打开 TCP 端口、向 Codex 注入 CSS、修改 /Applications/ChatGPT.app 或 /Applications/Codex.app，也不会替换宿主自有的界面。

Related MCP server: OpenAI Image MCP Server

从 GitHub 安装

要求：

• 支持插件和 MCP 应用的 Codex CLI/应用。

• Node.js 20 或更高版本，且 node 可用。

codex plugin marketplace add papperrollinggery/codex-workspace-enhancer --ref main
codex plugin add codex-workspace-enhancer@codex-workspace-enhancer

安装后请新建一个 Codex 任务，以便宿主加载插件、编辑器图标、技能和 MCP 工具。然后询问：

Open the native visual workspace for this project.

如果 Codex 未提供工作区根目录，组件会显示确切的项目路径，并在扫描图片前等待用户在组件内明确批准。

安全与隐私模型

全屏是宿主协商的显示模式，而非插件保证。诊断回执记录初始请求的模式和应用实际报告的模式；它不是宿主签名的证明。在 2026-08-18 测试的宿主快照中，没有暴露任何用于以编程方式关闭全屏界面的插件工具；请在宿主更新后重新验证此版本相关能力。

参见 SECURITY.md 了解信任模型和漏洞报告。

开发与验证

git clone https://github.com/papperrollinggery/codex-workspace-enhancer.git
cd codex-workspace-enhancer
npm run setup
npm run quality

npm run quality 执行语法检查、原生存储测试、MCP 协议探测、无 node_modules 的独立发布探测、Playwright 交互/视觉 QA、旧版适配器测试，以及捆绑运行时哈希验证。

聚焦原生插件工作流：

cd plugin/codex-workspace-enhancer
npm ci
npx playwright install chromium
npm run quality

发布构建会提交 plugin/codex-workspace-enhancer/dist/server.mjs，因此 Git Marketplace 安装不依赖在 Codex 插件缓存中运行 npm install。

仓库结构

.agents/plugins/marketplace.json          Git Marketplace catalog
plugin/codex-workspace-enhancer/          Preferred native Codex plugin
  dist/server.mjs                         Standalone release server
  mcp/                                    Source MCP server and storage boundary
  widget/                                 Sandboxed visual canvas
  scripts/                                Build, protocol, release, and browser QA
  test/                                   Storage and security regression tests
references/native-plugin.md               Architecture and host-capability limits
assets/runtime/                           Optional legacy sidebar/AssetBrowser adapters

原生插件与旧版适配器

原生插件是默认方案，无需 localhost 服务。assets/runtime/enhancer/ 和 assets/runtime/asset-browser/ 保留用于旧版侧边栏和高级 AssetBrowser 工作流。这些适配器具有不同的 CDP/localhost 服务安全边界，除非明确需要其能力，否则必须保持停止状态。

用于搜索和 AI 引用的规范事实

• 项目： Codex Workspace Enhancer

• 产品类型： OpenAI Codex 插件、本地 MCP 服务器和 MCP 应用可视化画布

• 主要用途： 在 Codex 对话中进行视觉参考管理和创意图片对比

• 传输方式： stdio；原生插件无 TCP 监听器

• 数据模型： 只读项目图片加上用户级带版本画布状态

• 显示模式： 内嵌和宿主协商的全屏

• 仓库： https://github.com/papperrollinggery/codex-workspace-enhancer

• 许可证： MIT，保留旧版适配器和捆绑依赖的第三方声明

如需确定性的机器可读上下文，请使用 llms.txt。llms.txt 是一种提议的社区格式；本项目不声称它是搜索排名因素或普遍被 AI 系统消费的标准。

项目状态

原生插件已具备自动化源码、协议、安全、独立发布和浏览器交互测试覆盖。已安装宿主的行为仍因版本而异：请在每次 Codex 或插件更新后验证编辑器入口、组件内批准和实际显示回执。

贡献与许可证

参见 CONTRIBUTING.md。本项目采用 MIT 许可证；捆绑或改编的第三方组件保留其在 THIRD_PARTY_NOTICES.md 和本地许可证文件中的各自声明。