Skip to content

Stop paying the multimodal tax. Your AI agent keeps every image it has seen but only sends the ones it needs: lighter chats, no endless reconnecting, no starting over. Works with Codex, Claude Code, Cline, Gemini CLI, OpenCode, WorkBuddy and more. Install once, forget it.

chore: MIT 许可证、三平台 CI 和问题反馈模板

chipfighter23d27fe83c9f
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..2ba9a7e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,53 @@
+name: 问题反馈 / Bug report
+description: 插件装不上、面板打不开、Codex 连不上,或者结果不对 / Something does not work
+labels: [bug]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ 谢谢反馈。macOS 和 Linux 还没有人实测过,这两个平台上的任何问题都很有用。
+ Thanks! macOS and Linux have not been tested by hand yet, so reports from them help a lot.
+
+ **Codex 连不上时 / If Codex cannot connect:** 先运行卸载命令恢复直连(见 README 的“卸载”),再来提问题。
+ Run the uninstall command from the README first to restore the direct connection.
+ - type: dropdown
+ id: platform
+ attributes:
+ label: 平台 / Platform
+ options: [Windows, macOS, Linux]
+ validations:
+ required: true
+ - type: input
+ id: codex
+ attributes:
+ label: Codex 版本 / Codex version
+ description: 桌面版的版本号,或者 `codex --version` 的输出 / Desktop app version, or the output of `codex --version`
+ validations:
+ required: true
+ - type: input
+ id: plugin
+ attributes:
+ label: 插件版本 / Plugin version
+ placeholder: "0.1.0"
+ - type: textarea
+ id: what
+ attributes:
+ label: 发生了什么 / What happened
+ description: 做了什么,期望什么,实际看到什么 / What you did, what you expected, what you saw
+ validations:
+ required: true
+ - type: textarea
+ id: status
+ attributes:
+ label: 安装状态 / Install status
+ description: |
+ `cam status` 的输出(不含凭据)/ Output of `cam status` (it contains no credentials).
+ render: json
+ - type: textarea
+ id: logs
+ attributes:
+ label: 日志 / Logs
+ description: |
+ 数据目录里 `plugin-server.jsonl` 和 `proxy/<日期>.jsonl` 的最后几十行。日志只记元数据,不含对话内容;贴之前请再看一眼。
+ The last lines of `plugin-server.jsonl` and `proxy/<date>.jsonl` in the data folder. They hold metadata only; please check before pasting.
+ render: text
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..2a3004e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,21 @@
+name: 需求建议 / Feature request
+description: 想要的功能,或者现在不好用的地方 / Something you would like it to do
+labels: [enhancement]
+body:
+ - type: textarea
+ id: problem
+ attributes:
+ label: 遇到的问题 / The problem
+ description: 在什么场景下,现在哪里不方便 / When does it get in your way
+ validations:
+ required: true
+ - type: textarea
+ id: idea
+ attributes:
+ label: 希望怎么解决 / What you would like
+ - type: dropdown
+ id: platform
+ attributes:
+ label: 平台 / Platform
+ multiple: true
+ options: [Windows, macOS, Linux]
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..7cea914
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,35 @@
+# Unit tests on the three platforms Codex runs on. Only Windows is tested by hand, so these runs are the first check
+# that the plugin still starts on macOS and Linux.
+name: CI
+
+on:
+ push:
+ pull_request:
+ workflow_dispatch:
+ workflow_call:
+
+permissions:
+ contents: read
+
+concurrency:
+ group: ci-${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ test:
+ name: test (${{ matrix.os }})
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [windows-latest, macos-latest, ubuntu-latest]
+ runs-on: ${{ matrix.os }}
+ timeout-minutes: 15
+ steps:
+ - uses: actions/checkout@v7
+ - uses: actions/setup-node@v7
+ with:
+ # The version Codex ships; the plugin runs TypeScript directly (type stripping).
+ node-version: 24
+ - name: Unit tests
+ working-directory: spike
+ run: node --test
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..d2572c2
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chipfighter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 5f064f3..3355113 100644
--- a/README.md
+++ b/README.md
@@ -98,4 +98,4 @@ cam uninstall
## 许可证
-尚未确定。
+[MIT](LICENSE)
diff --git a/docs/spec.md b/docs/spec.md
index aad9f22..d0d9a88 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -127,5 +127,5 @@
## 5. 待定问题
- 路线:路线 A(用 `thread/inject_items` 在新任务里重建)技术上可行,但用户不接受“重建后在界面上看不到原对话”。代理路线(任务不换,每次请求发出前由本地代理按勾选改写)已在桌面版验证通过:P1 只转发、P2 按勾选改写,生图和改图也包括在内,见 plan.md 第 9、10 节和 p2-report.md。面板已在 P4 做完,见 p4-report.md。
-- 许可证:尚未确定,开源之前由用户决定。
+- 许可证:MIT(用户 2026-09-25 确定)。
- 只在 Codex 的插件页面里关掉或移除插件、没有运行 `cam uninstall` 时,代理设置还在,却没有东西启动引擎,Codex 会连不上。现在的做法是在 README 里写明,并让 `cam uninstall` 随时能恢复。要不要让引擎不依赖插件启动(例如用 Windows 计划任务),需要用户同意在系统里注册任务,之后再定。
diff --git a/docs/tasks.md b/docs/tasks.md
index 3b63978..4d2695c 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -20,7 +20,8 @@
- 再改启动脚本、进程检测、数据目录和代理检测。
- [ ] **v0.1-5 更方便的安装**:用户不用打开 GitHub,就能把插件装进 Codex,并完成代理设置。
- [ ] **v0.1-6 在 GitHub 上发布 v0.1**。
-- 待定:许可证;只关插件、不卸载时 Codex 会断连(见 spec.md 第 5 节)。
+- [x] **v0.1-7 许可证和 CI**(用户 2026-09-25 定:MIT,并加上 CI):`LICENSE`(插件目录里也放一份);`.github/workflows/ci.yml` 在 Windows、macOS、Linux 上跑单元测试;问题反馈模板,方便 macOS、Linux 用户在 GitHub 上报问题。
+- 待定:只关插件、不卸载时 Codex 会断连(见 spec.md 第 5 节)。
---
diff --git a/plugin/.codex-plugin/plugin.json b/plugin/.codex-plugin/plugin.json
index 370213a..7a8ea4f 100644
--- a/plugin/.codex-plugin/plugin.json
+++ b/plugin/.codex-plugin/plugin.json
@@ -7,6 +7,7 @@
},
"homepage": "https://github.com/chipfighter/codex-attachment-manager",
"repository": "https://github.com/chipfighter/codex-attachment-manager",
+ "license": "MIT",
"keywords": ["codex", "images", "context", "attachments", "mcp-app", "proxy"],
"mcpServers": "./.mcp.json",
"interface": {
diff --git a/plugin/LICENSE b/plugin/LICENSE
new file mode 100644
index 0000000..d2572c2
--- /dev/null
+++ b/plugin/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chipfighter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/plugin/package.json b/plugin/package.json
index e77e45b..a3c84be 100644
--- a/plugin/package.json
+++ b/plugin/package.json
@@ -1,6 +1,7 @@
{
"name": "codex-attachment-manager-plugin",
"private": true,
+ "license": "MIT",
"type": "module",
"description": "The Codex plugin itself: the MCP server, the local proxy engine, the panel and the install command. No dependencies; runs on Node 24 with type stripping (Codex ships one).",
"engines": {