A local plugin for image-heavy chats in Codex, Claude Code and other agents: earlier images stop going out with every message, and the model fetches the one it needs by its ID, also after compaction.
TypeScript ai-agentsclaude-codeclaude-code-plugincodexcodex-plugincontext-managementdeveloper-toolsimage-generationmcpmultimodal
docs(platform): 任务清单和 README 写明 macOS、Linux 的验证范围
chipfighter40b72ec3864e
diff --git a/README.md b/README.mdindex 3355113..cbc9b43 100644--- a/README.md+++ b/README.md@@ -22,8 +22,9 @@## 环境要求-- Windows,Codex 桌面版(在 26.917 上验证过)。-- 不需要另外安装 Node:插件使用 Codex 自带的 Node 24;找不到时,才用系统里的 `node`。+- Windows:Codex 桌面版,在 26.917 上实测过。+- macOS、Linux:CI 上验证过 Codex 能装上插件、启动插件服务和引擎,但还没有人在这两个平台的桌面版上实测过。遇到问题请在 GitHub 上提 issue。+- 不需要另外安装 Node:插件使用 Codex 自带的 Node 24;找不到时,才用系统里 24 以上的 `node`。## 安装diff --git a/docs/tasks.md b/docs/tasks.mdindex 4d2695c..8ba6043 100644--- a/docs/tasks.md+++ b/docs/tasks.md@@ -15,9 +15,12 @@- 问之前没描述过的细节时,回复“需要 IMG-001”,没有编造。- [ ] **v0.1-2 用户做多种情况的测试**【需用户】,同时完成 P5-5:确认插件从 Codex 的缓存启动。- [ ] **v0.1-3 升级时替换旧引擎**:装了新版本插件后,新的插件服务要能替换还在运行的旧引擎。现在要等旧引擎在 Codex 退出后自己退出。-- [ ] **v0.1-4 macOS、Linux 适配**:- - 先查清各平台上 Codex 的形态:有没有桌面版,Codex 命令行和 Node 在哪里;- - 再改启动脚本、进程检测、数据目录和代理检测。+- [x] **v0.1-4 macOS、Linux 适配**(用户 2026-09-25 定:这两个平台没法手测,先发布,由用户在 GitHub 上反馈;证据:CI 的冒烟测试在三个平台上通过)+ - 查证:三个平台都有桌面版(Linux 版 2026-08 起预览,包名 `chatgpt`);macOS 桌面版的命令行在 `<app>/Contents/Resources/codex`;Codex 自己的安装脚本放在 `~/.local/bin/codex`。Codex 启动插件服务时,Windows 上按 PATHEXT 解析命令,macOS、Linux 上直接运行,并在新进程组里启动。+ - 一份 `.mcp.json` 通用:命令写 `./scripts/launch`,Windows 上找到 `launch.cmd`,macOS、Linux 上运行 POSIX 脚本 `scripts/launch`(和 OpenAI 自带插件的做法一致)。+ - 引擎用 `ps` 检测 Codex 进程;macOS 读系统代理(`scutil --proxy`);数据目录按平台惯例;找 Codex 命令行的位置按平台区分;根目录加 POSIX 版 `cam`。+ - `spike/src/plugin-smoke.ts`:用 Codex 自己的命令行把插件装进临时目录,再由 app-server 开任务,确认插件服务起来、工具和面板都在、引擎启动;不用登录。本机桌面版的命令行(0.155.0-alpha)和 CI 上 npm 的命令行(0.157.0,三个平台)都通过,macOS、Linux 上装进缓存后启动脚本仍可执行。+ - 没验证到的:macOS、Linux 桌面版里的面板显示,以及系统代理下 Codex 能否连到本机引擎,要等用户反馈。- [ ] **v0.1-5 更方便的安装**:用户不用打开 GitHub,就能把插件装进 Codex,并完成代理设置。- [ ] **v0.1-6 在 GitHub 上发布 v0.1**。- [x] **v0.1-7 许可证和 CI**(用户 2026-09-25 定:MIT,并加上 CI):`LICENSE`(插件目录里也放一份);`.github/workflows/ci.yml` 在 Windows、macOS、Linux 上跑单元测试;问题反馈模板,方便 macOS、Linux 用户在 GitHub 上报问题。