语言：简体中文 | English

Esse Community 是 Esse 的开源社区版，由 Agent 指挥的本地图片工作台。界面、安装程序和设置入口使用完整名称“Esse Community”；日常使用时，用户仍只需要说“用 Esse 生成图片”。

Esse Community 在本机保存 Provider 配置、API Key、批次记录和原始图片。只有实际生图或改图请求会把选中的参考图发给用户配置的 Provider 或当前 Agent 的图片能力。仓库和发行包不内置 API Key，也不依赖 Esse 云端后端。

• Codex Plugin：适用于 Codex/ChatGPT 桌面端，支持 Windows x64、macOS arm64 和 macOS x64。
• Agent Sidecar：适用于 WorkBuddy 等支持本地 HTTP MCP 的 Agent；支持 Windows x64、macOS arm64 和 macOS x64，带完整 Esse 工作台和后台任务执行能力。

这是 Esse Community 的两种技术分发方式，不是两个用户品牌。通常只安装适合当前 Agent 的一种。

把下面这句话发给 Codex：

安装这个插件：https://github.com/renoir1220/esse

Codex 应先阅读 INSTALL.md，再识别平台、下载 Release、校验 SHA256、完成用户目录安装和插件注册。重启桌面端并开启新任务后，说“打开 Esse Community 设置”，在 Esse Community 里配置 Provider、API Key 和默认模型。不要把 API Key 发到聊天里。

也可以从 GitHub Releases 下载对应平台的 Plugin ZIP，解压后运行 install.ps1 或 install.sh。

从 GitHub Releases 下载与当前平台匹配的 esse-community-windows-x64-*.exe 或 esse-community-macos-*-*.dmg，核对 sidecar-latest.json 或 checksums.txt 后安装并打开 Esse Community。在设置页：

1. 选择内置的兔子或 Google Gemini 官方 Provider 预设，或添加 OpenAI 兼容 Provider。Google 预设已填写接口与模型，只需在设置中输入自己的 API Key，详见 Google Gemini 配置。
2. 在 Esse Community 内填写 API Key、测试连接并保存默认模型。
3. 复制 MCP 配置并粘贴到 Agent 的用户级 HTTP MCP 配置中。

之后直接对 Agent 说“用 Esse 生成图片”。仅要求提交生成时，Agent 可在 Esse Community 后台受理后结束；如果原任务或有效目标已授权跟踪、验图或限定次数的返工，Agent 应在原范围、预算和次数内继续查询与验收，无需新的用户消息。后台受理不等于图片或任务验收完成。实际客户端的计划模式仍只允许规划和有助于完善计划的只读探索；未知提交或扣费先只读对账，不自动重发。只取回原任务授权的结果。

• Codex Plugin：Windows %LOCALAPPDATA%\esse；macOS ~/Library/Application Support/esse
• Esse Community：Windows %LOCALAPPDATA%\esse-community；macOS ~/Library/Application Support/esse-community

两个目录刻意隔离，Sidecar 安装程序目录也不与任何数据目录重名。迁移仓库不会移动、覆盖或删除旧 esse-desktop 数据。Windows API Key 由当前用户 DPAPI 保护；macOS 使用系统 Keychain。

Agent Sidecar 的签名状态遵循仓库公开的 Code signing policy。当前发布者签名凭据不是发布前置条件；没有凭据时，CI 会明确验证 Windows 产物未签名、macOS 应用具有结构有效的 ad-hoc 签名，并在 Release 说明中披露两者均不代表发布者身份。Windows 可能显示未知发布者或 SmartScreen 提示，macOS Gatekeeper 可能拒绝未做 Developer ID 签名和 Apple 公证的应用。不得把校验哈希或 ad-hoc 签名等同于发布者签名，也不得要求用户关闭系统安全机制。

plugins/codex/       Codex Plugin
sidecars/agent/      面向本地 Agent 的 Sidecar
apps/standalone/     未来独立应用占位
docs/                路线图、协议和开发文档

暂时不抽取共享 Core。两个运行形态必须独立构建，不得相互产生运行时依赖；有意义的行为移植记录在 SYNC.md。

Codex Plugin：

cd plugins/codex
npm install
npm run check

Agent Sidecar（Windows x64、macOS arm64/x64 使用同一份核心代码）：

cd sidecars/agent
npm install
npm run typecheck
npm test
npm run make

MIT License，见 LICENSE。