minecodex 2.0.13 → 2.0.14

package/README.md

@@ -10,16 +10,16 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 
 | 插件 | 说明 |
 | --- | --- |
-| **Model Slider** | 更清晰、更顺滑的模型切换面板：具备品牌标识、常用收藏与流畅交互 |
-| **Prompts** | 专页分类管理提示词与调用统计，输入框 Quick Prompts 快速调用 |
-| **Usage Meter** | 在 Help 与 Account 之间显示剩余额度环，悬浮查看周 / 五小时额度，点击进入 Usage 设置 |
-| **Images** | 在原生 Images 中浏览本地 Image Gen 图片，查看并复制提示词 |
-| **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
-| **Session Status** | 在输入框下方查看当前任务的步骤、观测速度、Token 用量与上下文明细 |
-| **Sidebar Focus** | 展开侧栏时聚焦当前任务路径，再次点击恢复布局 |
-| **Sites** | 在原生 Sites 中收录项目网页与自定义网址，按需打开或启动 |
-| **Markdown Reading** | 用 Pages 正文排版、自适应留白与原生目录阅读文件面板的 Markdown Preview，保留原生工具栏与文字选择；默认关闭 |
-| **File Navigation** | 精简路径与分列文件浏览；在 Markdown 阅读卡片内独立勾选，支持单独启用，默认关闭 |
+| **模型窗口** · Model Panel | 快速切换模型和思考强度，收藏常用模型。 |
+| **提示词库** · Prompt Library | 分类保存常用提示词，需要时一键填入输入框。 |
+| **额度环** · Usage Ring | 在侧栏查看五小时和每周剩余额度，点击打开用量详情。 |
+| **会话状态** · Session Status | 查看回复速度、Token 用量和上下文占用，了解对话消耗。 |
+| **Markdown 阅读增强** · Markdown Reader | 让 Markdown 文档更易读，支持章节目录、表格展开和代码复制。 |
+| **文件级联浏览** · Cascading File Browser | 点击文件顶部路径，分列浏览文件夹并快速切换文件。 |
+| **图片集合** · Image Collection | 集中浏览生成的图片，查看提示词并复用创作思路。 |
+| **站点收藏** · Saved Sites | 发现项目正在运行的网页，收藏常用网址，随时打开。 |
+| **侧栏聚焦** · Sidebar Focus | 一键收起侧栏中的其他分组，再次点击恢复原来的展开状态。 |
+| **隐藏额度推广** · Hide Usage Promotions | 隐藏输入框上方的套餐升级推广，让对话更清爽。 |
 
 ## 安装
 

package/apps/dashboard/app.js

@@ -211,35 +211,9 @@ function createPluginCard(feature) {
   return card;
 }
 
-function createPluginOption(feature) {
-  const option = element("div", "plugin-option");
-  option.dataset.featureId = feature.id;
-  const label = element("label");
-  const input = element("input");
-  input.type = "checkbox";
-  input.name = `feature-${feature.id}`;
-  const name = element("span", "plugin-option-name");
-  const dot = element("span", "status-dot");
-  label.append(input, name, dot);
-  option.append(label);
-  return option;
-}
-
 function updatePluginCard(card, feature) {
   for (const button of elements.languageButtons) button.disabled = pendingFeatureIds.size > 0;
   const status = featureState(feature);
-  if (card.classList.contains("plugin-option")) {
-    const input = card.querySelector("input");
-    input.checked = Boolean(feature.enabled);
-    input.disabled = pendingFeatureIds.has(feature.id);
-    input.setAttribute("aria-label", feature.label);
-    card.querySelector(".plugin-option-name").textContent = feature.label;
-    const dot = card.querySelector(".status-dot");
-    dot.className = `status-dot ${status.className}`;
-    dot.setAttribute("aria-label", status.label);
-    dot.title = status.label;
-    return;
-  }
   const input = card.querySelector('input[type="checkbox"]');
   const image = card.querySelector(".plugin-icon img");
   const name = card.querySelector(".plugin-name");
@@ -247,7 +221,7 @@ function updatePluginCard(card, feature) {
   const dot = card.querySelector(".plugin-state .status-dot");
   const stateLabel = card.querySelector(".plugin-state-label");
   card.dataset.featureId = feature.id;
-  image.src = `${feature.iconUrl}?v=stroke-2.1`;
+  image.src = `${feature.iconUrl}?v=resource-1`;
   name.textContent = feature.label;
   description.textContent = feature.description;
   input.checked = Boolean(feature.enabled);
@@ -271,16 +245,9 @@ function renderPluginCards(features) {
   for (const feature of features) {
     let card = findPluginCard(feature.id);
     if (!card) {
-      if (feature.id === "file-navigation") {
-        const parent = findPluginCard("markdown-reading");
-        if (!parent) continue;
-        card = createPluginOption(feature);
-        parent.append(card);
-      } else {
-        card = createPluginCard(feature);
-        elements.pluginList.append(card);
-      }
+      card = createPluginCard(feature);
     }
+    elements.pluginList.append(card);
     updatePluginCard(card, feature);
   }
   for (const card of [...elements.pluginList.querySelectorAll("[data-feature-id]")]) {

package/apps/dashboard/assets/data-transfer.js

@@ -7,7 +7,7 @@ const t = (cn, en) => zh ? cn : en;
 const dialog = document.querySelector('#data-dialog');
 const entry = document.querySelector('#data-button');
 const list = document.querySelector('#data-list');
-const featureNames = { notes: 'Prompts', sites: 'Sites', 'model-slider': t('模型滑条', 'Model Slider') };
+const featureNames = { notes: t('提示词库', 'Prompt Library'), sites: t('站点收藏', 'Saved Sites'), 'model-slider': t('模型窗口', 'Model Panel') };
 const status = document.querySelector('#data-status');
 const exportButton = document.querySelector('#data-export');
 const importButton = document.querySelector('#data-import');
@@ -69,7 +69,7 @@ function showInventory(data) {
   for (const feature of data.features.filter(item => item.portable)) {
     const detail = feature.id === 'notes' ? t(`${feature.categories} 个分类`, `${feature.categories} categories`) : '';
     const hint = feature.id === 'model-slider' && !feature.initialized
-      ? t('旧收藏在新版模型滑条首次启动后收录。', 'Legacy favorites are collected when the updated slider first starts.') + ' ' + featureHints[feature.id]
+      ? t('旧收藏在新版模型窗口首次启动后收录。', 'Legacy favorites are collected when the updated slider first starts.') + ' ' + featureHints[feature.id]
       : featureHints[feature.id];
     row(featureNames[feature.id] || feature.id, detail, t(`${feature.count} 项`, `${feature.count} items`), hint);
   }

package/apps/dashboard/styles.css

@@ -186,8 +186,8 @@ h2 { font-size: 14px; font-weight: 620; }
 .plugin-list { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--grid-gap); }
 .plugin-card { display: flex; flex-direction: column; align-items: stretch; min-width: 0; min-height: 216px; padding: var(--card-padding); border: 1px solid var(--border); border-radius: var(--card-radius); background: var(--surface); box-shadow: 0 3px 0 var(--block-shadow); }
 .plugin-topline { display: flex; align-items: center; justify-content: space-between; margin-bottom: 18px; }
-.plugin-icon { display: grid; place-items: center; width: 28px; height: 28px; }
-.plugin-icon img { width: 24px; height: 24px; opacity: 0.75; }
+.plugin-icon { display: grid; place-items: center; width: 28px; height: 28px; flex: none; }
+.plugin-icon img { display: block; width: 24px; height: 24px; object-fit: contain; opacity: 0.75; }
 .plugin-copy { flex: 1; }
 .plugin-name { font-size: 16px; font-weight: 600; line-height: 1.5; letter-spacing: -0.01em; }
 .plugin-description { margin-top: 8px; font-size: 14px; line-height: 1.65; }
@@ -266,10 +266,6 @@ h2 { font-size: 14px; font-weight: 620; }
   *, *::before, *::after { scroll-behavior: auto !important; animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; }
 }
 
-.plugin-option { margin-top:12px; padding-top:12px; border-top:1px solid var(--border); }
-.plugin-option label { display:flex; align-items:center; gap:8px; font-size:13px; }
-.plugin-option input { margin:0; accent-color:var(--ink); }
-.plugin-option .status-dot { margin-left:auto; }
 
 /* 数据迁移沿用控制台的不透明表面与卡片尺寸。 */
 .data-dialog { width: min(520px, calc(100vw - 32px)); max-height: calc(100dvh - 48px); padding: 24px; border: 1px solid var(--border); border-bottom: 3px solid var(--block-shadow); border-radius: var(--card-radius); background: var(--surface); color: var(--ink); box-shadow: var(--shadow); overflow-y: auto; }

package/features/file-navigation/assets/folder-tree.svg

@@ -0,0 +1,16 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M20 10a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1h-2.5a1 1 0 0 1-.8-.4l-.9-1.2A1 1 0 0 0 15 3h-2a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1Z" />
+  <path d="M20 21a1 1 0 0 0 1-1v-3a1 1 0 0 0-1-1h-2.9a1 1 0 0 1-.88-.55l-.42-.85a1 1 0 0 0-.92-.6H13a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1Z" />
+  <path d="M3 5a2 2 0 0 0 2 2h3" />
+  <path d="M3 3v13a2 2 0 0 0 2 2h3" />
+</svg>

package/features/file-navigation/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "file-navigation",
   "version": "0.1.0",
   "label": {
-    "en": "Compact file navigation",
-    "zh-CN": "精简文件导航"
+    "en": "Cascading File Browser",
+    "zh-CN": "文件级联浏览"
   },
   "description": {
-    "en": "Browse folders in columns from a compact file path.",
-    "zh-CN": "精简文件路径，使用分列列表浏览文件夹并切换文件。"
+    "en": "Click the path above a file to browse folders in columns and open another file.",
+    "zh-CN": "点击文件顶部路径，分列浏览文件夹并快速切换文件。"
   },
   "entry": {
     "kind": "page-script",
@@ -19,7 +19,7 @@
     }
   },
   "icon": {
-    "resource": "assets/book-open.svg"
+    "resource": "assets/folder-tree.svg"
   },
   "placement": {
     "order": 91

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

@@ -3,12 +3,12 @@
   "id": "hide-upsell-banner",
   "version": "0.1.11",
   "label": {
-    "en": "Hide Upsell Banner",
-    "zh-CN": "隐藏用量横幅"
+    "en": "Hide Usage Promotions",
+    "zh-CN": "隐藏额度推广"
   },
   "description": {
-    "en": "Hide usage upsell banners above the composer.",
-    "zh-CN": "隐藏输入框上方的额度推广横幅。"
+    "en": "Hide plan upgrade banners above the message box for a cleaner chat.",
+    "zh-CN": "隐藏输入框上方的套餐升级推广，让对话更清爽。"
   },
   "entry": {
     "kind": "page-script",

package/features/images/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "images",
   "version": "0.1.12",
   "label": {
-    "en": "Images",
-    "zh-CN": "图片"
+    "en": "Image Collection",
+    "zh-CN": "图片集合"
   },
   "description": {
-    "en": "Browse generated images and copy their prompts.",
-    "zh-CN": "浏览本地生成图片，查看与复制提示词。"
+    "en": "Browse generated images in one place and revisit their prompts.",
+    "zh-CN": "集中浏览生成的图片，查看提示词并复用创作思路。"
   },
   "icon": {
     "viewBox": "0 0 24 24",

package/features/images/src/adapters/codex/native-image-modules.mjs

@@ -1,3 +1,14 @@
+// 以调用位置和参数结构识别角色，不绑定压缩后的局部变量名。
+export function discoverImageActionBinding(source, role) {
+  const patterns = {
+    switchMode: /([\w$]+)\([\w$]+,[\w$]+\);let [\w$]+=[\w$]+\.length===1/,
+    attachChatImages: /await ([\w$]+)\([\w$]+,[\w$]+,\[[\w$]+\],\{isTemporaryChat:/,
+  };
+  const match = source.match(patterns[role]);
+  if (!match) throw new Error(`Native Images action contract changed: ${role}`);
+  return match[1];
+}
+
 // 按文件预览的调用关系读取角色，不依赖构建时分配的短变量名。
 export function discoverFilePreviewComposerBindings(source) {
   const starts = [...source.matchAll(/function [\w$]+\(/g)].map(match => match.index);
@@ -111,7 +122,7 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       const [moveDialog,dialogs]=await Promise.all([module("library-move-dialog",selection.source),module("library-item-dialogs",selection.source)]);
       const routerLocal = selection.source.match(/get\(([\w$]+)\)\.prepareNavigation\(/)?.[1];
       const routerAtom = await binding(selection.source, selection.url, routerLocal);
-      const switchLocal = selection.source.match(/([\w$]+)\(e,i\);let _=t.length===1/)?.[1];
+      const switchLocal = discoverImageActionBinding(selection.source, "switchMode");
       const switchMode = await binding(selection.source, selection.url, switchLocal);
       const draftLocal = selection.source.match(/let u=([\w$]+)\(e,\[\]\);e.set/)?.[1];
       const createChatDraft = await binding(selection.source, selection.url, draftLocal);
@@ -140,7 +151,7 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       const imageActions = component(menu.exports,source=>/onOpenedInNewTab:/.test(source),"image actions");
       const imageActionSource = String(imageActions);
       const imageFileLocal = imageActionSource.match(/let\{file:[\w$]+\}=([\w$]+)\(/)?.[1];
-      const attachLocal = imageActionSource.match(/await ([\w$]+)\(e,i,\[n\],/)?.[1];
+      const attachLocal = discoverImageActionBinding(imageActionSource, "attachChatImages");
       const downloadLocal = imageActionSource.match(/await ([\w$]+)\(\{downloadSrc:/)?.[1];
       const [imageFile,attachChatImages,downloadImage] = await Promise.all([imageFileLocal,attachLocal,downloadLocal].map(local=>binding(menuCoreSource,menuCoreUrl,local)));
       const toolbarClass = selection.source.match(/className:`(pointer-events-auto flex h-toolbar[^`]+)`/)?.[1];

package/features/images/src/library-prompt-source.mjs

@@ -1,7 +1,7 @@
 import { createCloudImageActions } from "./frontend/cloud-image-actions.mjs";
 import { createImageSourcesAdapter } from "./adapters/codex/image-sources.mjs";
 import { createNativeImageSource } from "./adapters/codex/native-image-source.mjs";
-import {createNativeImageModules, discoverFilePreviewComposerBindings} from "./adapters/codex/native-image-modules.mjs";
+import {createNativeImageModules, discoverImageActionBinding, discoverFilePreviewComposerBindings} from "./adapters/codex/native-image-modules.mjs";
 import { installLocalImageSource } from "./frontend/local-image-source.mjs";
 import { createLibraryApi } from "./adapters/codex/library-api.mjs";
 import { createLibraryViewerAdapter } from "./adapters/codex/library-viewer.mjs";
@@ -11,7 +11,7 @@ import { promptResolverSource } from "./adapters/codex/prompt-resolver-source.mj
 export async function createPageScriptSource() {
   const source=await readFile(new URL("./library-prompt-page.mjs",import.meta.url),"utf8");
   const promptGlyphSource=await readFile(new URL("./assets/prompts-menu.svg",import.meta.url),"utf8");
-  const functions={createCloudImageActions,createImageSourcesAdapter,discoverFilePreviewComposerBindings,createNativeImageModules,createNativeImageSource,installLocalImageSource,createLibraryApi,createLibraryViewerAdapter};
+  const functions={createCloudImageActions,createImageSourcesAdapter,discoverImageActionBinding,discoverFilePreviewComposerBindings,createNativeImageModules,createNativeImageSource,installLocalImageSource,createLibraryApi,createLibraryViewerAdapter};
   const declarations=Object.entries(functions).map(([name,fn])=>`const ${name}=${fn.toString()};`).join("\n");
   return `${declarations}\nconst promptGlyphSource=${JSON.stringify(promptGlyphSource)};\nconst promptFromConversation=${promptResolverSource()};\n${source}`;
 }

package/features/markdown-reading/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "markdown-reading",
   "version": "0.1.0",
   "label": {
-    "en": "Markdown Reading",
-    "zh-CN": "Markdown 阅读排版"
+    "en": "Markdown Reader",
+    "zh-CN": "Markdown 阅读增强"
   },
   "description": {
-    "en": "Read Markdown previews with Pages typography, spacing, and native outline.",
-    "zh-CN": "用 Pages 的正文排版、舒适留白与原生目录阅读 Markdown 预览。"
+    "en": "Read Markdown with a chapter outline, expandable tables, and copyable code blocks.",
+    "zh-CN": "让 Markdown 文档更易读，支持章节目录、表格展开和代码复制。"
   },
   "entry": {
     "kind": "page-script",

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

@@ -3,12 +3,12 @@
   "id": "model-slider",
   "version": "0.1.12",
   "label": {
-    "en": "Model Slider",
-    "zh-CN": "模型滑条"
+    "en": "Model Panel",
+    "zh-CN": "模型窗口"
   },
   "description": {
-    "en": "Switch models and thinking levels. Keep favorites within reach.",
-    "zh-CN": "切换模型与思考强度，快速找到常用收藏。"
+    "en": "Switch models and thinking levels, and keep favorites close at hand.",
+    "zh-CN": "快速切换模型和思考强度，收藏常用模型。"
   },
   "entry": {
     "kind": "composer-model-selector"

package/features/notes/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "notes",
   "version": "0.1.11",
   "label": {
-    "en": "Prompts",
-    "zh-CN": "提示词"
+    "en": "Prompt Library",
+    "zh-CN": "提示词库"
   },
   "description": {
-    "en": "Organize reusable prompts and insert them with one click.",
-    "zh-CN": "整理常用提示词，一键填入输入框。"
+    "en": "Save prompts by category and insert them into your message with one click.",
+    "zh-CN": "分类保存常用提示词，需要时一键填入输入框。"
   },
   "surfaceUrl": "http://127.0.0.1:47832/",
   "healthUrl": "http://127.0.0.1:47832/api/health",

package/features/session-status/codex-feature.json

@@ -2,10 +2,13 @@
   "schemaVersion": 1,
   "id": "session-status",
   "version": "0.1.0",
-  "label": { "en": "Session Status", "zh-CN": "会话状态" },
+  "label": {
+    "en": "Session Status",
+    "zh-CN": "会话状态"
+  },
   "description": {
-    "en": "See response speed, token usage and context space.",
-    "zh-CN": "查看输出速度、Token 用量与上下文占用。"
+    "en": "See response speed, token usage, and how much context your chat uses.",
+    "zh-CN": "查看回复速度、Token 用量和上下文占用，了解对话消耗。"
   },
   "entry": { "kind": "page-script", "script": "src/session-status.mjs", "sourceFactory": "src/injection-source.mjs" },
   "icon": {

package/features/sidebar-focus/codex-feature.json

@@ -7,8 +7,8 @@
     "zh-CN": "侧栏聚焦"
   },
   "description": {
-    "en": "Fold unrelated branches to keep the current task in view.",
-    "zh-CN": "收起无关分支，专注当前任务路径。"
+    "en": "Collapse other sidebar groups with one click, then click again to restore them.",
+    "zh-CN": "一键收起侧栏中的其他分组，再次点击恢复原来的展开状态。"
   },
   "entry": {
     "kind": "page-script",

package/features/sidebar-focus/src/sidebar-focus.mjs

@@ -4,7 +4,7 @@ const EXPAND_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/200
 
 
 const states = new Map();
-let active = false, restoring = false, button, timer, disposed = false;
+let active = false, restoring = false, button, timer = null, disposed = false;
 const text = (en, cn) => (document.documentElement.lang || navigator.language).startsWith("zh") ? cn : en;
 
 
@@ -74,8 +74,8 @@ function reconcile() {
   if (change) { change.toggle(); schedule(); }
 }
 function schedule() {
-  clearTimeout(timer);
-  timer = setTimeout(reconcile, 40);
+  if (disposed || timer !== null) return;
+  timer = requestAnimationFrame(() => { timer = null; reconcile(); });
 }
 document.addEventListener("click", event => {
   if (!active || !event.isTrusted) return;
@@ -83,7 +83,15 @@ document.addEventListener("click", event => {
     active = false; states.clear(); schedule();
   }
 }, { capture:true, signal });
-const observer = new MutationObserver(schedule);
+const observer = new MutationObserver(records => {
+  // 流式回复等侧栏外更新不应推迟或重复触发布局整理。
+  if (records.some(record =>
+    record.target.closest?.("#app-shell-sidebar")
+    || record.type === "attributes" && ["data-above-composer-conversation-id", "lang"].includes(record.attributeName)
+    || [...record.addedNodes ?? [], ...record.removedNodes ?? []].some(node =>
+      node.matches?.("#app-shell-sidebar") || node.querySelector?.("#app-shell-sidebar"))
+  )) schedule();
+});
 observer.observe(document.documentElement, { subtree:true, childList:true, attributes:true, attributeFilter:[
   "aria-expanded", "aria-pressed", "data-app-action-sidebar-thread-selected",
   "data-app-action-sidebar-section-collapsed", "data-above-composer-conversation-id", "lang"
@@ -97,4 +105,4 @@ config.registerSelfCheck?.(() => {
   return {state:available ? "available" : "unavailable",reason:available ? null : "sidebar-focus-anchor-unavailable",
     checks:[{name:"sidebar-focus-anchor",available}],scopes:[{name:"sidebar",element:sidebar}]};
 });
-return () => { disposed = true; clearTimeout(timer); observer.disconnect(); button?.remove(); };
+return () => { disposed = true; cancelAnimationFrame(timer); observer.disconnect(); button?.remove(); };

package/features/sites/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "sites",
   "version": "0.1.0",
   "label": {
-    "en": "Local & Self-hosted Sites",
-    "zh-CN": "本地与自托管站点"
+    "en": "Saved Sites",
+    "zh-CN": "站点收藏"
   },
   "description": {
-    "en": "Find project web services and open your saved sites.",
-    "zh-CN": "发现项目网页服务，收藏并打开常用站点。"
+    "en": "Find running project sites and save useful links for quick access.",
+    "zh-CN": "发现项目正在运行的网页，收藏常用网址，随时打开。"
   },
   "entry": {
     "kind": "page-script",

package/features/usage-meter/codex-feature.json

@@ -2,10 +2,13 @@
   "schemaVersion": 1,
   "id": "usage-meter",
   "version": "0.1.0",
-  "label": { "en": "Usage Meter", "zh-CN": "额度环" },
+  "label": {
+    "en": "Usage Ring",
+    "zh-CN": "额度环"
+  },
   "description": {
-    "en": "Check your remaining weekly and five-hour allowance.",
-    "zh-CN": "随时查看每周与五小时剩余额度。"
+    "en": "Check your five-hour and weekly allowance in the sidebar; click for details.",
+    "zh-CN": "在侧栏查看五小时和每周剩余额度，点击打开用量详情。"
   },
   "entry": { "kind": "page-script", "script": "src/usage-meter.mjs", "sourceFactory": "src/injection-source.mjs" },
   "icon": { "viewBox": "0 0 24 24", "markup": "<circle cx=\"12\" cy=\"12\" r=\"9\"></circle><circle cx=\"12\" cy=\"12\" r=\"5\"></circle>" },

package/package.json

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

package/packages/cli/src/config.mjs

@@ -14,8 +14,8 @@ export const DEFAULT_CONFIG = Object.freeze({
     "usage-meter": true,
     "sidebar-focus": true,
     sites: true,
-    "markdown-reading": false,
-    "file-navigation": false,
+    "markdown-reading": true,
+    "file-navigation": true,
   }),
 });
 

package/packages/cli/src/control-server.mjs

@@ -14,6 +14,7 @@ import { createDataTransfer, MAX_TRANSFER_BYTES } from "./data-transfer/service.
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../..");
 const packageMetadata = JSON.parse(await readFile(path.join(packageRoot, "package.json"), "utf8"));
 const MAX_BODY_BYTES = 64 * 1024;
+const DASHBOARD_FEATURE_ORDER = ["model-slider", "notes", "usage-meter", "session-status", "markdown-reading", "file-navigation", "images", "sites", "sidebar-focus", "hide-upsell-banner"];
 const CONTENT_TYPES = new Map([
   [".css", "text/css; charset=utf-8"],
   [".html", "text/html; charset=utf-8"],
@@ -93,7 +94,7 @@ function acceptedHealth(featureId, health) {
 }
 
 async function loadFeatureDefinitions(paths, locale = "en") {
-  return Promise.all(FEATURE_IDS.map(async (id) => {
+  return Promise.all([...FEATURE_IDS].sort((a, b) => DASHBOARD_FEATURE_ORDER.indexOf(a) - DASHBOARD_FEATURE_ORDER.indexOf(b)).map(async (id) => {
     const manifestPath = path.join(paths.featuresRoot, id, "codex-feature.json");
     const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
     return {
@@ -206,11 +207,15 @@ async function iconResponse(id, paths, response) {
     iconPath = path.join(paths.featuresRoot, id, "assets", "icons", "book-open.svg");
   } else if (FEATURE_IDS.includes(id)) {
     const manifest = JSON.parse(await readFile(path.join(paths.featuresRoot, id, "codex-feature.json"), "utf8"));
-    const viewBox = manifest.icon?.viewBox ?? "0 0 24 24";
-    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" fill="none" stroke="currentColor" stroke-width="2.1" stroke-linecap="round" stroke-linejoin="round">${manifest.icon.markup}</svg>`;
-    response.writeHead(200, { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=3600" });
-    response.end(svg);
-    return;
+    if (manifest.icon?.resource) {
+      iconPath = path.resolve(paths.featuresRoot, id, manifest.icon.resource);
+    } else {
+      const viewBox = manifest.icon?.viewBox ?? "0 0 24 24";
+      const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" fill="none" stroke="currentColor" stroke-width="2.1" stroke-linecap="round" stroke-linejoin="round">${manifest.icon.markup}</svg>`;
+      response.writeHead(200, { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=3600" });
+      response.end(svg);
+      return;
+    }
   } else {
     json(response, 404, { error: "NOT_FOUND" });
     return;

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

@@ -737,7 +737,7 @@ export function createInjectionSource(features, {
         "--codex-summary-row-line-height": "24px",
         "--codex-summary-label-font-size": tokens["--text-base"] ?? "14px",
         "--codex-summary-label-line-height": tokens["--text-base--line-height"] ?? "1.5",
-        "--codex-summary-font-weight": tokens["--vscode-font-weight"] ?? (style.fontWeight || "445"),
+        "--codex-summary-font-weight": style.fontWeight || "445",
         "--codex-summary-icon-size": "18px",
         "--codex-summary-icon-stroke-width": "1.5px",
         "--codex-summary-panel-radius": panelRadius,

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

@@ -109,6 +109,7 @@ export class CodexRuntime {
     this.rendererTargetIds = new Set();
     this.targetFailures = new Map();
     this.targetChecks = new Map();
+    this.targetCheckDeadlines = new Map();
     this.clients = new Map();
     this.scriptIds = new Map();
     this.bindingTokens = new Map();
@@ -245,6 +246,7 @@ export class CodexRuntime {
     this.rendererTargetIds.clear();
     this.targetFailures.clear();
     this.targetChecks.clear();
+    this.targetCheckDeadlines.clear();
     this.rendererDiscovered = false;
     this.browserClient?.socket.close();
     this.browserClient = null;
@@ -714,6 +716,7 @@ export class CodexRuntime {
       this.scriptIds.delete(id);
       this.bindingTokens.delete(id);
       this.targetChecks.delete(id);
+      this.targetCheckDeadlines.delete(id);
       this.hostActionChains.delete(id);
       this.injectedTargets.delete(id);
       this.targetFailures.delete(id);
@@ -735,6 +738,7 @@ export class CodexRuntime {
         this.bindingTokens.delete(target.id);
         this.injectedTargets.delete(target.id);
         this.targetChecks.delete(target.id);
+        this.targetCheckDeadlines.delete(target.id);
       }
       if (target.type !== "page" || target.url !== "app://-/index.html" || this.injectedTargets.has(target.id)) {
         continue;
@@ -759,6 +763,7 @@ export class CodexRuntime {
           if (this.clients.get(target.id) !== client) return;
           // 新文档撤销启动检查，下一次接入周期重新检查一次。
           this.targetChecks.delete(target.id);
+          this.targetCheckDeadlines.delete(target.id);
           this.notifyStatusChange();
         });
         client.on?.("Runtime.bindingCalled", (params) => {
@@ -825,7 +830,12 @@ export class CodexRuntime {
   async checkTarget(targetId) {
     const client=this.clients.get(targetId);
     if (!client || this.stopping) return false;
-    if (this.targetChecks.has(targetId)) return true;
+    const previous = this.targetChecks.get(targetId);
+    const needsRetry = !previous?.checkedAt || previous.plugins.some(plugin =>
+      ["unknown", "unavailable", "degraded"].includes(plugin.state));
+    if (previous && (!needsRetry || Date.now() >= this.targetCheckDeadlines.get(targetId))) return true;
+    // 页面启动时锚点尚未就绪：借用发现周期有限重试，稳定后停止检查。
+    if (!this.targetCheckDeadlines.has(targetId)) this.targetCheckDeadlines.set(targetId, Date.now() + 30_000);
     try {
       const response=await client.send("Runtime.evaluate", {
         expression:`(() => { const runtime=window.__codexPersonalRuntime; return runtime?.version === ${RUNTIME_VERSION} && runtime.sessionId === ${JSON.stringify(this.runtimeSessionId)} ? runtime.selfCheck() : null; })()`,
@@ -876,6 +886,7 @@ export class CodexRuntime {
             client.socket.close();
             this.injectedTargets.delete(targetId);
             this.targetChecks.delete(targetId);
+            this.targetCheckDeadlines.delete(targetId);
             this.notifyStatusChange();
           }
         }
@@ -920,6 +931,7 @@ export class CodexRuntime {
       this.rendererTargetIds.clear();
       this.targetFailures.clear();
     this.targetChecks.clear();
+    this.targetCheckDeadlines.clear();
       this.rendererDiscovered = false;
       this.notifyStatusChange();
       this.monitorPromise = null;

package/packages/ui/src/native/theme.mjs

@@ -67,5 +67,6 @@ export function createNativeThemeAdapter(themeTokenNames,themeTokenAliases,theme
       }
     };
   }
-  return {read,dispose,checkTokens,bindScope,diagnostics:() => checkTokens(document.documentElement,themeTokenNames)};
+  // 根清单仅展示已定义变量；必要值缺失仍由控件作用域检查报告。
+  return {read,dispose,checkTokens,bindScope,diagnostics:() => checkTokens(document.documentElement,themeTokenNames).filter(token => token.available)};
 }

package/packages/ui/src/native/tokens.mjs

@@ -30,7 +30,6 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--color-token-text-tertiary",
   "--color-token-border",
   "--color-token-focus-border",
-  "--color-token-conversation-summary-trailing",
   "--color-token-bg-primary",
   "--color-token-bg-secondary",
   "--color-token-bg-tertiary",
@@ -51,8 +50,6 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--color-background-button-secondary-hover",
   "--color-background-button-tertiary-hover",
   "--color-text-button-tertiary",
-  "--color-token-button-background",
-  "--color-token-button-foreground",
   "--color-text-foreground",
   "--color-text-foreground-secondary",
   "--color-text-foreground-tertiary",
@@ -82,7 +79,6 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--leading-relaxed",
   "--font-weight-normal",
   "--font-weight-medium",
-  "--vscode-font-weight",
   "--default-mono-font-family",
   "--text-heading-lg",
   "--text-heading-md",