Skip to main content
Glama
papperrollinggery

Codex Workspace Enhancer

Codex Workspace Enhancer

Нативное визуальное рабочее пространство для OpenAI Codex, не требующее портов. Размещайте изображения проекта, референсы и творческие заметки на бесконечном холсте, не модифицируя приложение Codex и не запуская локальный сервис.

简体中文 · Архитектура · Безопасность · Сводка для ИИ

CI License: MIT MCP Apps

Нативный визуальный холст Codex Workspace Enhancer

Какую задачу решает

Творческая работа в Codex часто охватывает референсные изображения, сгенерированные кадры, заметки и многократные сравнения. Codex Workspace Enhancer сохраняет этот визуальный контекст в рамках текущего разговора:

  • Открывается из композера Codex как нативное MCP-приложение.

  • Просматривайте одобренные изображения проекта, не копируя их в облачный сервис.

  • Перемещайте, масштабируйте, изменяйте размер, выделяйте несколько изображений и упорядочивайте их на бесконечном холсте.

  • Добавляйте творческие заметки и сохраняйте доску с историей версий между сеансами.

  • Прикрепляйте выбранные локальные пути к изображениям к контексту разговора без автоматической отправки сообщения.

  • Запрашивайте полноэкранный режим, оставаясь при этом работоспособным во встроенном виде, если хост отклоняет запрос или не поддерживает его.

Предпочтительный нативный плагин использует stdio, ресурсы ui:// и встроенный автономный MCP-сервер. Он не открывает TCP-порт, не внедряет CSS в Codex, не изменяет /Applications/ChatGPT.app или /Applications/Codex.app и не заменяет элементы интерфейса, принадлежащие хосту.

Related MCP server: gpt-image-2-combined

Установка из GitHub

Требования:

  • Codex CLI/приложение с поддержкой плагинов и MCP-приложений.

  • 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 не предоставляет корневые каталоги рабочего пространства, виджет показывает точный путь к проекту и ожидает явного подтверждения внутри виджета перед сканированием изображений.

Модель безопасности и конфиденциальности

Граница

Поведение

Доступ к проекту

Подтверждение точного пути или совпадающий корневой каталог рабочего пространства от хоста

Исходные изображения

Только чтение; удаление с холста никогда не удаляет и не перемещает файл

Пути

Проверки ограничения realpath и отклонение попыток выхода через симлинки

Загрузка предпросмотра

12 МБ на изображение, три одновременных чтения, ограниченный LRU-кэш объектных URL

Сканирование проекта

Пропускает скрытые/сборочные/зависимые папки; не более 600 изображений, 7 уровней, 20 000 записей или 3,5 секунды

Доступ к сеансу

Непрозрачная возможность в памяти; 2-часовой простой и 12-часовой абсолютный срок действия

Состояние холста

Подтверждённый абсолютный корень проекта плюс JSON холста с историей версий в каталоге данных приложения пользователя; без загрузки

Передача разговора

Только структурированный контекст; следующее сообщение по-прежнему отправляет пользователь

Сеть

Нет прослушивающего сокета для функций нативного плагина

Полноэкранный режим — это согласуемый с хостом режим отображения, а не гарантия плагина. Диагностическая квитанция фиксирует изначально запрошенный режим и фактический режим, сообщённый приложением; это не подтверждение, подписанное хостом. В снимке хоста, протестированном 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, тесты устаревших адаптеров и проверку хеша встроенной среды выполнения.

Сфокусированный рабочий процесс нативного плагина:

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

Сборочный релиз фиксирует plugin/codex-workspace-enhancer/dist/server.mjs, поэтому установка из Git Marketplace не зависит от выполнения npm install в кэше плагинов Codex.

Карта репозитория

.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

Нативный плагин против устаревших адаптеров

Нативный плагин используется по умолчанию и не требует локального сервиса. assets/runtime/enhancer/ и assets/runtime/asset-browser/ сохранены для более старых боковых панелей и расширенных рабочих процессов AssetBrowser. Эти адаптеры имеют иные границы безопасности CDP/локального сервиса и должны оставаться остановленными, если их возможности явно не требуются.

Канонические факты для поиска и цитирования ИИ

  • Проект: Codex Workspace Enhancer

  • Тип продукта: плагин OpenAI Codex, локальный MCP-сервер и визуальный холст MCP-приложения

  • Основное назначение: управление визуальными референсами и творческое сравнение изображений в рамках разговора Codex

  • Транспорт: stdio; без TCP-прослушивателя в нативном плагине

  • Модель данных: изображения проекта только для чтения плюс состояние холста с историей версий на уровне пользователя

  • Режимы отображения: встроенный и согласуемый с хостом полноэкранный

  • Репозиторий: https://github.com/papperrollinggery/codex-workspace-enhancer

  • Лицензия: MIT, с сохранёнными уведомлениями о сторонних компонентах для устаревшего адаптера и встроенных зависимостей

Для детерминированного машиночитаемого контекста используйте llms.txt. llms.txt — это предлагаемый сообществом формат; этот проект не утверждает, что он является фактором ранжирования в поиске или универсально потребляется ИИ-системами.

Статус проекта

Нативный плагин покрыт автоматизированными проверками исходного кода, протокола, безопасности, автономного релиза и взаимодействия с браузером. Поведение установленного хоста остаётся зависящим от версии: проверяйте запись в композере, подтверждение внутри виджета и фактическую квитанцию отображения после каждого обновления Codex или плагина.

Вклад и лицензия

См. CONTRIBUTING.md. Проект распространяется под лицензией MIT; встроенные или адаптированные сторонние компоненты сохраняют собственные уведомления в THIRD_PARTY_NOTICES.md и локальных файлах лицензий.

Related MCP Connectors

Related MCP Servers