minecodex 0.1.10 → 0.1.12

package/README.md

@@ -1,31 +1,32 @@
+<p align="center">
+  <img src="./assets/readme/hero.svg" width="100%" alt="MineCodex：给 Codex Desktop 增加轻量、本地优先的插件，包含模型滑条、笔记与图片库">
+</p>
+
 # MineCodex
 
-MineCodex 给 Codex Desktop 增加三个轻量、本地优先的插件：
+MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。所有数据均保存在本地，不经过任何第三方服务器，也不会改变 Codex 的原有使用习惯。
+
+## 插件列表
 
-- **Model Slider**：更清楚、更顺滑的模型选择窗口。
-- **Notes**：跨会话管理 Todo、Prompts 和 Files。
-- **Images**：集中浏览生成图片、Prompt 和来源任务。
+| 插件 | 说明 |
+| --- | --- |
+| **Model Slider** | 更清晰、更顺滑的模型切换面板：具备品牌标识、常用收藏与流畅交互 |
+| **Notes** | 跨会话管理待办事项、常用提示词与文件，可随时从 Codex 工具栏快速复用 |
+| **Images** | 集中浏览生成的图片、Prompt 和来源任务，轻松保存原图或快速返回原会话 |
+| **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
 
 ## 安装
 
-MineCodex v1 仅支持 macOS，需要 Node.js 22.5 或更高版本。安装时会从
-`/Applications/ChatGPT.app` 或 `~/Applications/ChatGPT.app` 查找 Codex Desktop；
-如果两处都找不到，安装会停止并给出提示。
+MineCodex 目前仅支持 macOS 系统，需要 Node.js 22.5 或更高版本。安装程序会自动扫描 `/Applications/ChatGPT.app` 或 `~/Applications/ChatGPT.app` 寻找 Codex Desktop；如果两处均未找到，安装将暂停并给出说明。
 
 ```bash
 npm install -g minecodex
 mcx install
 ```
 
-`mcx install` 不会关闭或启动 Codex，也不会改变当前窗口。安装完成后，终端会提示
-MineCodex 将在下次重启 Codex 时启用，并询问是否现在重启；默认答案是 **No**。
-安装过程只有在用户明确确认，或之后主动运行 `mcx restart` 时，才会关闭并重新打开
-Codex。安装后，macOS 的“登录项与扩展”中会显示名为 **MineCodex** 的后台项目。
-这个后台项目负责插件与本地控制台：用户退出 Codex 后，它会保持停止；用户后来从
-Dock 主动打开 Codex 时，这次新启动会被视为明确的启动意图，并切换为可注入的托管
-实例。由于普通 Dock 启动本身没有 CDP，首次切换时 Codex 可能会短暂重开一次。
+运行 `mcx install` 不会强制关闭或启动 Codex，也不会影响当前打开的窗口。安装完成后，终端会说明更改将在下一次重启 Codex 时生效，并询问是否立即重启；默认选项为 **No**。只有在您明确确认，或后续手动运行 `mcx restart` 时，才会重新打开 Codex。安装完成后，macOS 的“登录项与扩展”中会添加名为 **MineCodex** 的后台项目。
 
-安装后三个插件默认开启。打开本地控制台：
+打开本地控制台：
 
 ```bash
 mcx open
@@ -33,19 +34,22 @@ mcx open
 
 常用命令：
 
-```text
-mcx install
-mcx uninstall [--purge]
-mcx update
-mcx open
-mcx status [--json]
-mcx restart
-```
+| 命令 | 作用 |
+| --- | --- |
+| `mcx install` | 安装或修复 MineCodex |
+| `mcx uninstall [--purge]` | 移除扩展；默认保留个人数据，带 `--purge` 参数才会清理 |
+| `mcx update` | 更新到最新的稳定版本 |
+| `mcx open` | 打开 MineCodex 控制台 |
+| `mcx status [--json]` | 查看安装与插件运行状态 |
+| `mcx restart` | 重启 Codex 并应用插件开启/关闭状态 |
+
+关闭某项功能仅停用对应的扩展服务，不会删除任何个人数据；修改设置后运行 `mcx restart` 即可应用更改。
+
+运行 `mcx uninstall` 会移除名为 MineCodex 的后台项目，并默认保留配置设置、Notes 笔记和 Images 图片索引；只有显式加上 `--purge` 参数，才会清理 MineCodex 产生的本地配置。MineCodex 绝不会删除 `~/.codex/generated_images` 中的原始图片或 Notes 引用的本地文件。
+
+## 工作原理
 
-关闭插件只会停用对应功能，不会删除数据；保存开关后运行 `mcx restart` 应用变更。
-`mcx uninstall` 会移除名为 MineCodex 的后台项目，并默认保留 MineCodex 设置、
-Notes 数据和 Images 索引；只有显式传入 `--purge` 才会删除 MineCodex 自有数据。
-MineCodex 永远不会删除 `~/.codex/generated_images` 中的原图或 Notes 引用的源文件。
+MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。每个插件（Model Slider、Notes、Images）独立管理各自的数据与操作页面；Hide Upsell Banner 专注于界面展示的优化，不影响实际的用量计算。所有功能按需开启，关闭后即停止运行。
 
 ## 开发
 
@@ -57,9 +61,6 @@ npm run pack:check
 npm run pack:audit
 ```
 
-MineCodex 是唯一发布仓库。三个插件继续拥有各自的数据和页面；RuntimeHost 只负责
-Codex 中的入口、主题与交互适配。
+## 许可
 
-MineCodex 是非官方独立项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；
-第三方图标、品牌和兼容资产遵循各自的权利说明，见
-[`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md)。
+MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；第三方图标、品牌和兼容资产遵循各自的权利说明，见 [`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md)。

package/features/hide-upsell-banner/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "hide-upsell-banner",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "label": {
     "en": "Hide Upsell Banner",
     "zh-CN": "隐藏用量横幅"

package/features/hide-upsell-banner/src/hide-upsell-banner.mjs

@@ -37,18 +37,30 @@ function hideVisibleBanners(root = document) {
   }
 }
 
+let rescanQueued = false;
+function rescanBanners() {
+  // React can render the banner in stages: an empty <aside> shell first, then
+  // text and style updates on the same element. A childList-only observer
+  // misses those later mutations, so every mutation triggers a full rescan
+  // instead of only inspecting freshly added nodes.
+  if (rescanQueued) return;
+  rescanQueued = true;
+  queueMicrotask(() => {
+    rescanQueued = false;
+    hideVisibleBanners(document);
+  });
+}
+
 hideVisibleBanners();
-const observer = new MutationObserver((records) => {
-  for (const record of records) {
-    for (const node of record.addedNodes) {
-      if (node.nodeType !== Node.ELEMENT_NODE) continue;
-      hideVisibleBanners(node);
-    }
-  }
+const observer = new MutationObserver(() => {
+  rescanBanners();
 });
 observer.observe(document.documentElement, {
   childList: true,
   subtree: true,
+  attributes: true,
+  attributeFilter: ["style", "class", "hidden"],
+  characterData: true,
 });
 
 return () => {

package/features/images/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "images",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "label": {
     "en": "Images",
     "zh-CN": "图片"

package/features/model-slider/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "model-slider",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "label": {
     "en": "Model Slider",
     "zh-CN": "模型滑条"

package/features/notes/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "notes",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "label": {
     "en": "Notes",
     "zh-CN": "笔记"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

package/packages/runtime-host/src/codex-runtime.mjs

@@ -105,6 +105,14 @@ export function createInjectionSource(features, {
 } = {}) {
   function install(config) {
     if (window.top !== window) return;
+    if (!document.documentElement) {
+      // The document bootstrap runs before the root element exists. Defer the
+      // whole install until the DOM is ready instead of crashing on a null
+      // documentElement (which previously left the runtime permanently absent
+      // after a renderer reload).
+      document.addEventListener("DOMContentLoaded", () => install(config), { once: true });
+      return;
+    }
     const currentRuntime = window.__codexPersonalRuntime;
     if (currentRuntime?.version === config.version && currentRuntime?.sessionId === config.sessionId) {
       currentRuntime.ensure();
@@ -605,10 +613,42 @@ export function createInjectionSource(features, {
       }
     }
 
+    function nativeCssModuleClass(tokenName, root = document) {
+      const pattern = new RegExp(`^_${tokenName}_[A-Za-z0-9_-]+$`);
+      const live = Array.from(root.querySelectorAll(`[class*="_${tokenName}_"]`))
+        .flatMap((element) => Array.from(element.classList))
+        .find((name) => pattern.test(name));
+      if (live) return live;
+      const selectorPattern = new RegExp(`\\.(_${tokenName}_[A-Za-z0-9_-]+)`);
+      const find = (rules) => {
+        for (const rule of rules ?? []) {
+          const match = String(rule.selectorText ?? "").match(selectorPattern);
+          if (match?.[1]) return match[1];
+          try {
+            const nested = find(rule.cssRules);
+            if (nested) return nested;
+          } catch {
+            // Ignore inaccessible nested rules and continue with Codex's readable sheets.
+          }
+        }
+        return null;
+      };
+      for (const sheet of document.styleSheets) {
+        try {
+          const match = find(sheet.cssRules);
+          if (match) return match;
+        } catch {
+          // Ignore cross-origin stylesheets.
+        }
+      }
+      return null;
+    }
+
     function createNativeFastIcon(active) {
       const definition = modelSelectorNativeFastIcons?.[active ? "active" : "inactive"];
       const icon = createModelSelectorIcon(definition, { brand: true });
-      if (icon) icon.classList.add("_FastModeIcon_1ryrb_423");
+      const iconClass = nativeCssModuleClass("FastModeIcon");
+      if (icon && iconClass) icon.classList.add(iconClass);
       return icon;
     }
 
@@ -1389,12 +1429,17 @@ export function createInjectionSource(features, {
       if (!track) return;
       track.querySelectorAll('[class*="_FastParticleClip_"]').forEach((element) => element.remove());
       if (!enabled || matchMedia("(prefers-reduced-motion: reduce)").matches) return;
+      const clipClass = nativeCssModuleClass("FastParticleClip");
+      const particlesClass = nativeCssModuleClass("FastTrackParticles");
+      const pathClass = nativeCssModuleClass("FastTrackParticlePath");
+      const particleClass = nativeCssModuleClass("TrackParticle");
+      if (!clipClass || !particlesClass || !pathClass || !particleClass) return;
       const clip = document.createElement("span");
-      clip.className = "_FastParticleClip_3jngk_242";
+      clip.className = clipClass;
       clip.setAttribute("aria-hidden", "true");
       clip.style.opacity = "1";
       const particles = document.createElement("span");
-      particles.className = "_FastTrackParticles_1pz9e_1";
+      particles.className = particlesClass;
       particles.setAttribute("aria-hidden", "true");
       particles.setAttribute("data-animation-active", "true");
       const travelDuration = 1.9;
@@ -1407,12 +1452,12 @@ export function createInjectionSource(features, {
         const speed = 1 + (nativeParticleSeed(index, 21) - 0.5) * 0.4;
         const duration = travelDuration / speed;
         const path = document.createElement("span");
-        path.className = "_FastTrackParticlePath_1pz9e_7";
+        path.className = pathClass;
         path.style.animationDelay = `${index * stagger - duration * remainingTravel}s`;
         path.style.animationDuration = `${duration}s`;
         path.style.top = `${12 + nativeParticleSeed(index, 23) * 76}%`;
         const particle = document.createElement("span");
-        particle.className = "_TrackParticle_1pz9e_22";
+        particle.className = particleClass;
         particle.style.opacity = String(0.4 + nativeParticleSeed(index, 11) * 0.6);
         particle.style.transform = `translate(-50%, -50%) scale(${0.5 + nativeParticleSeed(index, 12) * 0.45})`;
         path.append(particle);
@@ -1501,26 +1546,37 @@ export function createInjectionSource(features, {
     function createGenericModelSlider(parentMenu, selector, identity, model, selectedEffort) {
       const efforts = model.supportedReasoningLevels.map((level) => level.effort);
       const selectedIndex = Math.max(0, efforts.indexOf(selectedEffort));
+      const classes = Object.fromEntries([
+        "Menu",
+        "ViewToggle",
+        "ViewToggleContent",
+        "ViewToggleIcon",
+        "ViewControls",
+        "FastModeToggle",
+        "FastModeToggleContent",
+        "SimpleView",
+      ].map((tokenName) => [tokenName, nativeCssModuleClass(tokenName, parentMenu)]));
+      if (Object.values(classes).some((name) => !name)) return null;
       const shell = document.createElement("div");
       shell.setAttribute("data-codex-model-slider-generic", `${identity.raw}:${selectedEffort}`);
-      shell.className = "_Menu_1ryrb_2";
+      shell.className = classes.Menu;
       shell.setAttribute("data-view", "simple");
       shell.setAttribute("data-reduced-motion", String(matchMedia("(prefers-reduced-motion: reduce)").matches));
       shell.setAttribute("data-transitions-ready", "false");
       const nativeRow = nativeModelPickerRow(parentMenu);
       const modelButton = document.createElement("div");
-      modelButton.className = "_ViewToggle_1ryrb_13";
+      modelButton.className = classes.ViewToggle;
       modelButton.setAttribute("role", "button");
       modelButton.setAttribute("tabindex", "0");
       modelButton.setAttribute("data-codex-model-slider-model-button", "");
       modelButton.setAttribute("aria-label", `Model ${modelDisplayLabel(identity, selector)}`);
       const buttonContent = document.createElement("span");
-      buttonContent.className = "_ViewToggleContent_1ryrb_334";
+      buttonContent.className = classes.ViewToggleContent;
       const buttonLabel = document.createElement("span");
       buttonLabel.textContent = modelDisplayLabel(identity, selector);
       const nativeChevron = nativeRow?.querySelector("svg")?.cloneNode(true);
       if (nativeChevron) {
-        nativeChevron.className.baseVal = "_ViewToggleIcon_1ryrb_85";
+        nativeChevron.className.baseVal = classes.ViewToggleIcon;
         nativeChevron.setAttribute("aria-hidden", "true");
         buttonContent.append(buttonLabel, nativeChevron);
       } else {
@@ -1536,7 +1592,7 @@ export function createInjectionSource(features, {
       });
 
       const viewControls = document.createElement("div");
-      viewControls.className = "_ViewControls_1ryrb_12";
+      viewControls.className = classes.ViewControls;
       viewControls.setAttribute("data-expanded", "false");
       viewControls.setAttribute("data-ultra-warning-visible", "false");
       const controller = nativeComposerModelController();
@@ -1552,7 +1608,7 @@ export function createInjectionSource(features, {
       if (supportsFast) {
         const fastButton = document.createElement("button");
         fastButton.type = "button";
-        fastButton.className = "_FastModeToggle_1ryrb_14";
+        fastButton.className = classes.FastModeToggle;
         fastButton.setAttribute("data-codex-model-slider-fast", "");
         fastButton.setAttribute("aria-pressed", String(fastEnabled));
         fastButton.setAttribute("data-fast-mode-enabled", String(fastEnabled));
@@ -1563,7 +1619,7 @@ export function createInjectionSource(features, {
           : (locale === "zh-CN" ? "开启 Fast 模式" : "Enable Fast mode"));
         const fastIcon = createNativeFastIcon(fastEnabled);
         const fastContent = document.createElement("span");
-        fastContent.className = "_FastModeToggleContent_1ryrb_399";
+        fastContent.className = classes.FastModeToggleContent;
         fastContent.setAttribute("data-codex-model-slider-fast-content", "");
         if (fastIcon) fastContent.append(fastIcon);
         fastButton.append(fastContent);
@@ -1669,7 +1725,7 @@ export function createInjectionSource(features, {
         selectNativeEffort(parentMenu, efforts[pendingIndex]);
       });
       const simpleView = document.createElement("div");
-      simpleView.className = "_SimpleView_1ryrb_50";
+      simpleView.className = classes.SimpleView;
       simpleView.append(nativeSlider ?? rail);
       shell.append(viewControls, simpleView);
       return shell;
@@ -1707,12 +1763,13 @@ export function createInjectionSource(features, {
       existing?.remove();
       const nativeContainer = parentMenu.firstElementChild;
       if (!nativeContainer) return false;
+      const shell = createGenericModelSlider(parentMenu, selector, identity, model, selectedEffort);
+      if (!shell) return false;
       if (!modelSelectorGenericContainers.has(nativeContainer)) {
         modelSelectorGenericContainers.set(nativeContainer, nativeContainer.style.display);
       }
       parentMenu.setAttribute("data-codex-model-slider-generic-menu", "");
       nativeContainer.style.display = "none";
-      const shell = createGenericModelSlider(parentMenu, selector, identity, model, selectedEffort);
       shell.setAttribute("data-codex-model-slider-generic", key);
       parentMenu.append(shell);
       return true;