minecodex 2.0.8 → 2.0.10

package/README.md

@@ -4,7 +4,7 @@
 
 # MineCodex
 
-MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。所有数据均保存在本地，不经过任何第三方服务器，也不会改变 Codex 的原有使用习惯。
+MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。配置、提示词和图片索引保存在本机。Images 的本地浏览不上传图片；使用云端收藏、加入文件夹或部分生成编辑操作时，所选图片会通过 Codex 原生能力上传至 OpenAI。
 
 ## 插件列表
 
@@ -16,6 +16,8 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **Images** | 在原生 Images 中浏览本地 Image Gen 图片，查看并复制提示词 |
 | **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
 | **Session Status** | 在输入框下方查看当前任务的步骤、观测速度、Token 用量与上下文明细 |
+| **Sidebar Focus** | 展开侧栏时聚焦当前任务路径，再次点击恢复布局 |
+| **Sites** | 在原生 Sites 中收录项目网页与自定义网址，按需打开或启动 |
 
 ## 安装
 
@@ -53,6 +55,18 @@ mcx open
 
 运行 `mcx uninstall` 会移除名为 MineCodex 的后台项目，并默认保留配置设置、Notes 笔记和 Images 图片索引；只有显式加上 `--purge` 参数，才会清理 MineCodex 产生的本地配置。MineCodex 绝不会删除 `~/.codex/generated_images` 中的原始图片或 Notes 引用的本地文件。
 
+## 数据与图片操作
+
+本地 Image Gen 浏览、搜索、提示词查看和下载不会创建云端图片。首次收藏或加入文件夹时，会将所选图片上传到 OpenAI 的 Library；收藏和文件夹关系由云端保存。首次上传后取消文件夹选择，已产生的云端副本仍会保留，界面会提示“图片已保存到 Library，但未加入文件夹”。
+
+图片生成编辑可能通过原生能力准备临时上传附件；查看图片不会触发这类操作。从 Image Gen 删除仅隐藏本地索引条目，保留原始图片和云端副本。卸载或 `--purge` 不会删除云端图片，也不会删除 Codex 的原始生成图片。
+
+## 更新后的自检
+
+MineCodex 在每个 Codex 窗口启动并完成注入后，后台检查一次功能安装、原生锚点与实际使用的设计变量。新窗口、页面重载或重新接入时重新检查；结果代表检查时的页面，不持续监测后续页面切换。控制台区分“正在自检”“部分窗口可用”“外观适配需要更新”“暂不可用”和“当前页面不适用”。没有输入框或未打开 Sites / Images 时，相关功能可能不适用，并不直接表示版本不兼容。
+
+可使用控制台的“复制诊断信息”提供自检结果。诊断包含功能、窗口、锚点与设计变量证据，不包含提示词、聊天内容、账号资料或安装路径。自检可用表示当前检查项通过，实际保存、上传、模型切换等操作仍以各自的结果为准。
+
 ## 工作原理
 
 MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。Model Slider、Prompts 各自管理操作界面，Images 在原生 Images 中接入本地生成图片和提示词查看；Session Status 只读汇总本机 Codex 会话事件，Hide Upsell Banner 优化界面展示。所有功能按需开启，关闭后即停止运行。
@@ -67,16 +81,16 @@ npm run pack:check
 npm run pack:audit
 ```
 
-维护者发布流程见 [GitHub Actions 发布说明](docs/npm-publishing.md)。发布工作流仅允许维护者本人触发，使用 npm 可信发布，无需长期访问令牌。
+维护者发布流程见 [GitHub Actions 发布说明](https://github.com/Vontean/MineCodex/blob/main/docs/npm-publishing.md)。发布工作流仅允许维护者本人触发，使用 npm 可信发布，无需长期访问令牌。
 
 ## 许可
 
 MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；第三方图标、品牌和兼容资产遵循各自的权利说明，见 [`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md) 与 [`features/session-status/vendor/lucide-LICENSE`](features/session-status/vendor/lucide-LICENSE)。
 
-### Sidebar Focus / 侧栏聚焦
+## 侧栏聚焦
 
 展开侧栏时，点击铃铛与搜索之间的聚焦按钮，保留当前任务路径并收起其他分支。再次点击恢复原先布局；切换任务时跟随路径，手动调整分支时退出聚焦。
 
-### 从账号菜单打开控制台
+## 从账号菜单打开控制台
 
 在 Codex Navbar 底部打开账号菜单，点击 Settings 下方的 **MineCodex ↗**，即可在外部默认浏览器打开本地控制台，等同于 `mcx gui`。macOS 默认 Safari、Chrome/Chromium、Edge、Brave 和 Vivaldi 会定位已有控制台标签页，没有时才新建；首次定位可能需要系统自动化权限。其他浏览器与 Windows 仍由系统打开 URL。

package/apps/dashboard/app.js

@@ -1,4 +1,8 @@
-const locale = navigator.language.toLowerCase().startsWith("zh") ? "zh-CN" : "en";
+import {diagnosticReport} from "./assets/diagnostics.js";
+let savedLocale;
+try { savedLocale = localStorage.getItem("minecodex-language"); } catch { /* 存储不可用时跟随浏览器语言。 */ }
+const locale = ["en", "zh-CN"].includes(savedLocale) ? savedLocale
+  : navigator.language.toLowerCase().startsWith("zh") ? "zh-CN" : "en";
 document.documentElement.lang = locale;
 
 const copy = {
@@ -19,8 +23,13 @@ const copy = {
       configured: "Configured — starting in Codex…",
       launching: "Launching in Codex…",
       injected: "Active in Codex",
-      healthy: "Healthy in Codex",
-      failed: "Failed — restart Codex",
+      healthy: "Active in Codex",
+      checking: "Checking compatibility…",
+      partial: "Available in some windows",
+      degraded: "Appearance needs an update",
+      unavailable: "Temporarily unavailable — check for updates",
+      "not-applicable": "Not needed on this page",
+      failed: "Couldn’t start — try again",
       stopped: "Stopped",
       "restart-required": "Restart required — restart Codex",
     },
@@ -31,13 +40,16 @@ const copy = {
     darkAppearance: "Dark appearance",
     lightAppearance: "Light appearance",
     updateFailed: "Couldn’t check for updates. Please try again.",
+    copyDiagnostics: "Copy diagnostics",
+    diagnosticsCopied: "Diagnostics copied",
+    diagnosticsFailed: "Couldn’t copy diagnostics. Please try again.",
     checkUpdates: "Check for updates",
     checkingUpdates: "Checking…",
     current: "You’re up to date.",
     updateAvailable: (version) => `MineCodex ${version} is available. Run mcx update in Terminal.`,
     changeFailed: "The plugin setting could not be saved.",
-    restartFailed: "MineCodex could not restart Codex. Check the service log and try again.",
-    failureDetail: "Health or renderer status could not be confirmed.",
+    restartFailed: "MineCodex could not restart Codex. Please try again or copy diagnostics.",
+    failureDetail: "This extension could not be confirmed. Copy diagnostics to help investigate.",
   },
   "zh-CN": {
     connecting: "正在连接…",
@@ -56,8 +68,13 @@ const copy = {
       configured: "已配置——正在 Codex 中启动…",
       launching: "正在 Codex 中启动…",
       injected: "已在 Codex 中生效",
-      healthy: "Codex 中运行正常",
-      failed: "运行失败——请重启 Codex",
+      healthy: "已在 Codex 中生效",
+      checking: "正在自检…",
+      partial: "部分窗口可用",
+      degraded: "外观适配需要更新",
+      unavailable: "暂不可用——请检查更新",
+      "not-applicable": "当前页面不适用",
+      failed: "暂时无法启动——请重试",
       stopped: "已停止",
       "restart-required": "需要重启——请重启 Codex",
     },
@@ -68,13 +85,16 @@ const copy = {
     darkAppearance: "深色外观",
     lightAppearance: "浅色外观",
     updateFailed: "暂时无法检查更新，请稍后重试。",
+    copyDiagnostics: "复制诊断信息",
+    diagnosticsCopied: "诊断信息已复制",
+    diagnosticsFailed: "暂时无法复制诊断信息，请重试。",
     checkUpdates: "检查更新",
     checkingUpdates: "正在检查…",
     current: "当前已是最新版本。",
     updateAvailable: (version) => `发现 MineCodex ${version}，请在终端运行 mcx update。`,
     changeFailed: "插件设置保存失败。",
-    restartFailed: "MineCodex 无法重启 Codex。请检查服务日志后重试。",
-    failureDetail: "无法确认插件健康状态或 Codex 渲染器状态。",
+    restartFailed: "MineCodex 无法重启 Codex。请重试或复制诊断信息协助排查。",
+    failureDetail: "暂时无法确认这项功能的状态，可复制诊断信息协助排查。",
   },
 }[locale];
 
@@ -94,10 +114,13 @@ const elements = {
   retryButton: document.querySelector("#retry-button"),
   versionLabel: document.querySelector("#version-label"),
   versionValue: document.querySelector("#version-value"),
+  languageToggle: document.querySelector(".language-toggle"),
+  languageButtons: [...document.querySelectorAll("[data-language-choice]")],
   themeToggle: document.querySelector(".theme-toggle"),
   themeButtons: [...document.querySelectorAll("[data-theme-choice]")],
   updateResult: document.querySelector("#update-result"),
   updateButton: document.querySelector("#update-button"),
+  diagnosticsButton: document.querySelector("#diagnostics-button"),
   toast: document.querySelector("#toast"),
 };
 
@@ -106,6 +129,8 @@ let toastTimer = null;
 const pendingFeatureIds = new Set();
 
 function applyStaticCopy() {
+  elements.languageToggle.setAttribute("aria-label", locale === "zh-CN" ? "语言" : "Language");
+  for (const button of elements.languageButtons) button.setAttribute("aria-pressed", String(button.dataset.languageChoice === locale));
   elements.runtimeLabel.textContent = copy.connecting;
   elements.restartTitle.textContent = copy.restartTitle;
   elements.restartCopy.textContent = copy.restartCopy;
@@ -115,6 +140,7 @@ function applyStaticCopy() {
   elements.errorCopy.textContent = copy.loadErrorCopy;
   elements.retryButton.textContent = copy.retry;
   elements.versionLabel.textContent = copy.version;
+  elements.diagnosticsButton.textContent = copy.copyDiagnostics;
   elements.updateButton.querySelector(".button-label").textContent = copy.checkUpdates;
 }
 
@@ -186,6 +212,7 @@ function createPluginCard(feature) {
 }
 
 function updatePluginCard(card, feature) {
+  for (const button of elements.languageButtons) button.disabled = pendingFeatureIds.size > 0;
   const status = featureState(feature);
   const input = card.querySelector('input[type="checkbox"]');
   const image = card.querySelector(".plugin-icon img");
@@ -285,7 +312,10 @@ async function load() {
   try {
     const response = await fetch("/api/status", { headers: { "Accept-Language": locale } });
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
-    state = await response.json();
+    const fresh = await response.json();
+    if (pendingFeatureIds.size && state) fresh.features = fresh.features.map(feature =>
+      pendingFeatureIds.has(feature.id) ? state.features.find(previous=>previous.id === feature.id) ?? feature : feature);
+    state = fresh;
     elements.pluginList.hidden = false;
     render();
   } catch {
@@ -359,6 +389,16 @@ elements.retryButton.addEventListener("click", () => {
   void load();
 });
 
+elements.diagnosticsButton.addEventListener("click", async () => {
+  try {
+    await navigator.clipboard.writeText(JSON.stringify(diagnosticReport(state),null,2));
+    showToast(copy.diagnosticsCopied);
+  } catch { showToast(copy.diagnosticsFailed); }
+});
+
+// 页面可见时更新自检结果；保留正在保存的卡片和键盘焦点。
+setInterval(() => { if (!document.hidden && !pendingFeatureIds.size) void load(); }, 5000);
+
 elements.updateButton.addEventListener("click", async () => {
   elements.updateButton.disabled = true;
   elements.updateButton.querySelector(".button-label").textContent = copy.checkingUpdates;
@@ -397,6 +437,15 @@ elements.themeToggle.addEventListener("click", (event) => {
   try { localStorage.setItem("minecodex-appearance", selectedTheme); } catch { /* 保留内存中的选择。 */ }
   applyTheme();
 });
+elements.languageToggle.addEventListener("click", (event) => {
+  const button = event.target.closest("[data-language-choice]");
+  if (!button || pendingFeatureIds.size || elements.restartButton.disabled) return;
+  const choice = button.dataset.languageChoice;
+  if (choice === locale) return;
+  try { localStorage.setItem("minecodex-language", choice); } catch { return; }
+  // 重载后以同一语言请求卡片内容，不影响功能配置与外观选择。
+  location.reload();
+});
 systemTheme.addEventListener("change", applyTheme);
 document.addEventListener("keydown", () => { document.documentElement.dataset.input = "keyboard"; });
 document.addEventListener("pointerdown", () => { document.documentElement.dataset.input = "pointer"; });

package/apps/dashboard/assets/diagnostics.js

@@ -0,0 +1,18 @@
+// 只复制自检证据；不包含账号、路径、会话内容、绑定令牌或原始错误文本。
+export function diagnosticReport(state) {
+  return {
+    minecodexVersion:state?.version ?? null,
+    codexBuild:state?.renderer?.codexBuild ?? state?.runtime?.codex?.version ?? null,
+    buildSource:state?.renderer?.buildSource ?? null,
+    verification:"runtime-observation-only",
+    targets:(state?.renderer?.targets ?? []).map(target => ({
+      targetId:target.targetId,checkedAt:target.checkedAt,reason:target.reason ?? null,
+      tokens:target.tokens,capabilities:target.capabilities,
+      plugins:(target.plugins ?? []).map(plugin => ({
+        featureId:plugin.featureId,installation:plugin.installation,state:plugin.state,reason:plugin.reason,
+        checks:plugin.checks,tokens:plugin.tokens,
+      })),
+    })),
+    services:(state?.features ?? []).map(feature => ({featureId:feature.id,state:feature.state,failureCode:feature.failure?.code ?? null})),
+  };
+}

package/apps/dashboard/index.html

@@ -18,6 +18,10 @@
           <h1><span class="brand-icon" aria-hidden="true"></span><span class="brand-name">MineCodex</span></h1>
         </div>
         <div class="header-actions">
+          <div class="language-toggle" role="group" aria-label="Language">
+            <button data-language-choice="zh-CN" type="button" lang="zh-CN" aria-pressed="false">中文</button>
+            <button data-language-choice="en" type="button" lang="en" aria-pressed="false">EN</button>
+          </div>
           <div class="theme-toggle" role="group" aria-label="Appearance">
             <span class="theme-selection" aria-hidden="true"></span>
             <button data-theme-choice="light" type="button" aria-label="Light appearance" aria-pressed="false"><span class="ui-icon sun-icon" aria-hidden="true"></span></button>
@@ -67,6 +71,7 @@
         <dl>
           <div><dt id="version-label">Version</dt><dd id="version-value">—</dd></div>
         </dl>
+        <button id="diagnostics-button" class="button quiet" type="button">Copy diagnostics</button>
         <button id="update-button" class="button quiet" type="button"><span class="ui-icon refresh-icon" aria-hidden="true"></span><span class="button-label">Check for updates</span></button>
       </footer>
       <p id="update-result" class="update-result" role="status" hidden></p>

package/apps/dashboard/styles.css

@@ -145,7 +145,11 @@ h2 { font-size: 14px; font-weight: 620; }
 }
 
 .overview { margin: 0 0 32px; }
-.header-actions { flex-shrink: 0; }
+.header-actions { display: flex; align-items: center; gap: 12px; flex-shrink: 0; }
+.language-toggle { display: flex; gap: 4px; padding: 4px; border-radius: 999px; background: var(--surface-muted); box-shadow: inset 0 0 0 1px var(--border); }
+.language-toggle button { min-width: 40px; height: 32px; padding: 0 8px; border: 0; border-radius: 999px; background: transparent; color: var(--ink-secondary); font: inherit; font-size: 12px; cursor: pointer; }
+.language-toggle button[aria-pressed="true"] { background: var(--surface); color: var(--ink); box-shadow: 0 1px 3px #0002; }
+.language-toggle button:disabled { cursor: wait; }
 
 .runtime-state, .plugin-state {
   display: inline-flex;

package/assets/brand/README.md

@@ -1,6 +1,6 @@
 # MineCodex 图标
 
-`minecodex-icon.svg` 是透明底、单色的可编辑矢量图标，使用 `viewBox="0 0 24 24"` 和 `currentColor`。外圈与镐子分别位于 `codex-outline`、`pickaxe`，可单独编辑。`minecodex-icon.png` 是 512×512 透明底预览；`minecodex-icon-preview.png` 展示已选实心版的明暗主题及 16/24/32/48px 尺寸。当前主文件为实心版；`minecodex-icon-filled.svg` 是实心版副本，`minecodex-icon-outline.svg` 保留上一版空心设计。
+`minecodex-icon.svg` 是透明底、单色的可编辑矢量图标，使用 `viewBox="0 0 24 24"` 和 `currentColor`。外圈与镐子分别位于 `codex-outline`、`pickaxe`，可单独编辑。本机 PNG 预览用于透明底、明暗主题及 16/24/32/48px 尺寸对比，已加入 Git 忽略规则。当前主文件为实心版；`minecodex-icon-filled.svg` 是实心版副本，`minecodex-icon-outline.svg` 保留上一版空心设计。
 
 ## 设计与来源
 
@@ -16,4 +16,4 @@
 
 `minecodex-icon.svg` 是唯一可编辑的生产源；运行 `npm run build:icons` 生成明暗 SVG、Dashboard favicon 和 README 顶部标识。`minecodex-icon-light.svg` 用于浅色背景，`minecodex-icon-dark.svg` 用于深色背景。Dashboard 标题通过 favicon 的 CSS mask 消费同一几何，颜色继承页面文字色。主题 SVG 与生产源、Lucide 许可、README 展示图均进入 npm 发布名单。
 
-历史空心版和 PNG 对比图仅用于设计参考，不进入 npm 发布包。macOS 后台服务 1.0.1 已接入 ICNS 图标；`minecodex-service-icon.svg` 为同一几何配浅色圆角底板的原生图标源，更新遵循原生服务文档的注销、替换和重新注册流程。
+历史空心版仅用于设计参考，不进入 npm 发布包；PNG 对比图保留本机，不进入 GitHub 或 npm 发布包。macOS 后台服务 1.0.1 已接入 ICNS 图标；`minecodex-service-icon.svg` 为同一几何配浅色圆角底板的原生图标源，更新遵循原生服务文档的注销、替换和重新注册流程。

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

@@ -83,6 +83,8 @@ observer.observe(document.documentElement, {
   characterData: true,
 });
 
+config.registerSelfCheck?.(() => ({state:hiddenBanners.size ? "available" : "not-applicable",reason:hiddenBanners.size ? null : "no-usage-banner",
+  checks:[...hiddenBanners.keys()].filter(node=>node.isConnected).map(()=>({name:"usage-banner-hidden",available:true}))}));
 return () => {
   disposed = true;
   observer.disconnect();

package/features/images/src/adapters/codex/image-sources.mjs

@@ -3,7 +3,14 @@ export function createImageSourcesAdapter(codex) {
     && props.tabs?.some(item => item.key === "generated")
     && props.tabs?.some(item => item.key === "uploaded");
 
-  return {read() {
+  function applicability() {
+    const props=codex.props(codex.rail(),value=>Boolean((value.router ?? value.value?.router)?.state?.location));
+    const location=(props?.router ?? props?.value?.router)?.state?.location;
+    if (!location) return "unknown";
+    return location.pathname === "/space/files" && new URLSearchParams(location.search).get("tab") === "images"
+      ? "applicable" : "not-applicable";
+  }
+  return {applicability,read() {
     const tabs = [...document.querySelectorAll('[role="tablist"]')].find(node =>
       !node.closest("[data-minecodex-image-navigation]")
       && codex.props(node, isImageNavigation));

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

@@ -423,13 +423,13 @@ export function createNativeImageSource(codex, { requestHostAction, libraryApi,
         {id:"view-prompts", icon:promptIcon, text:context.intl.formatMessage({id:"minecodex.images.viewPrompts",defaultMessage:"View prompts"}),onSelect:() => {void open(image).then(opened=>{if(opened&&isCurrent())onPrompt(image);}).catch(operationError);}},
         {id:"favorite",icon:native.favoriteIcon(saved),text:saved
           ? message("library.favorites.remove","Remove from Favorites")
-          : message("library.favorites.add","Add to Favorites"),onSelect:() => {void perform(async () => {
+          : message("minecodex.images.addToCloudFavorites",(context.intl.locale?.startsWith("zh") ? "加入收藏（上传至 Library）" : "Add to Favorites (uploads to Library)")),onSelect:() => {void perform(async () => {
             favoriteRevision.current++;
             const value=await cloud.favorite(image);
             if(active.current&&isCurrent()){favoriteRevision.current++;setSaved(value);}
           });}},
         action("download-a-copy", native.downloadIcon, {id:"libraryNext.actions.download", defaultMessage:"Download"}),
-        {id:"folder",icon:native.folderIcon,text:message("libraryNext.actions.addToFolder","Add to folder"),onSelect:() => {void perform(() => folder(image));}},
+        {id:"folder",icon:native.folderIcon,text:message("minecodex.images.addToCloudFolder",(context.intl.locale?.startsWith("zh") ? "加入文件夹（上传至 Library）" : "Add to folder (uploads to Library)")),onSelect:() => {void perform(() => folder(image));}},
         {id:"delete",icon:native.deleteIcon,tone:"danger",text:message("libraryNext.actions.delete","Delete"),onSelect:()=>confirmRemove([image])},
       ].filter(Boolean);
       const dropdown = h(native.Dropdown, {

package/features/images/src/frontend/local-image-source.mjs

@@ -188,6 +188,13 @@ export function installLocalImageSource(config, signal, sources, native) {
   signal.addEventListener("abort", cleanup, {once:true});
   return {
     cleanup,
+    selfCheck() {
+      const entry=sources.read(),scope=sources.applicability();
+      if (!entry) return {state:scope === "applicable" ? "unavailable" : scope,reason:scope === "not-applicable" ? "outside-image-sources" : "image-sources-anchor-unavailable"};
+      const available=Boolean(mounted?.nav && mounted?.view && mounted.navigation.isConnected);
+      return {state:available ? "available" : mounted ? "unknown" : "unavailable",reason:available ? null : "native-image-mount-unavailable",
+        checks:[{name:"image-sources-anchor",available:true},{name:"native-image-mount",available}],scopes:[{name:"image-sources",element:entry.shell}]};
+    },
     readViewer:header => native.readViewer(header),
     pendingPrompt:() => pendingPrompt,
     consumePrompt:() => {pendingPrompt = null;},

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

@@ -262,6 +262,15 @@ localeObserver.observe(document.documentElement, { attributes:true, attributeFil
 localImageSource = installLocalImageSource(config, signal, createImageSourcesAdapter(config.codex), createNativeImageSource(config.codex, {
   requestHostAction:config.requestHostAction, libraryApi, createCloudImageActions, promptGlyphSource, signal,
 }));
+config.registerSelfCheck?.(() => {
+  const source=localImageSource.selfCheck();
+  if (source.state !== "not-applicable") return source;
+  const header=document.querySelector('[data-testid="viewer-header"]');
+  if (!header || !libraryImage(header)) return source;
+  const available=Boolean(mounted?.button.isConnected);
+  return {state:available ? "available" : "unknown",reason:available ? null : "image-viewer-mount-pending",
+    checks:[{name:"image-viewer-anchor",available:true},{name:"prompt-control",available}],scopes:[{name:"image-viewer",element:header}]};
+});
 const observer = new MutationObserver(() => {
   if (scheduled) return;
   scheduled = true;

package/features/model-slider/src/adapters/codex/controller.mjs

@@ -89,5 +89,18 @@ function invokeNativeMenuItemSelect(item) {
     codex.report("fast-icons",Boolean(active && inactive),active && inactive ? null : "icon-resource-contract-changed");
     return {active:{path:active,viewBox:"0 0 24 24"},inactive:{path:inactive,viewBox:"0 0 20 20"}};
   }
-return {fastIcons,trigger:nativeComposerTrigger,read:nativeComposerModelController,descriptor:nativeModelDescriptorForItem,setOpen:setReactControlledMenuOpen,selectItem:invokeNativeMenuItemSelect};
+function selfCheck() {
+  const trigger=nativeComposerTrigger();
+  if (!trigger) {
+    const path=codex.route();
+    const applicable=Boolean(codex.composer(null,{threadOnly:false})) || path?.startsWith("/local/");
+    return {state:applicable ? "unavailable" : path ? "not-applicable" : "unknown",reason:applicable ? "model-trigger-unavailable" : "no-task-composer",checks:[{name:"model-trigger",available:false}]};
+  }
+  const generic=codex.props(trigger,p=>!!p.selectedModel && typeof p.onModelChange === "function",40);
+  if (generic) return {state:"not-applicable",reason:"chat-model-picker"};
+  const available=Boolean(nativeComposerModelController());
+  return {state:available ? "available" : "unavailable",reason:available ? null : "model-controller-unavailable",
+    scopes:[{name:"model-trigger",element:trigger}],checks:[{name:"model-trigger",available:true},{name:"model-controller",available}]};
+}
+return {selfCheck,fastIcons,trigger:nativeComposerTrigger,read:nativeComposerModelController,descriptor:nativeModelDescriptorForItem,setOpen:setReactControlledMenuOpen,selectItem:invokeNativeMenuItemSelect};
 }

package/features/model-slider/src/frontend/install.mjs

@@ -2173,5 +2173,8 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     void loadNativeFastIconFromBundle();
   }
 
-  return { ensure: ensureModelSelector, dispose: restoreModelSelectorEnhancements };
+  return { selfCheck: () => {
+    const result=nativeModel.selfCheck();
+    return {...result,scopes:[...(result.scopes ?? []),{name:"model-menu",element:modelSelectorControllerMenu?.menu}]};
+  }, ensure: ensureModelSelector, dispose: restoreModelSelectorEnhancements };
 }

package/features/notes/src/frontend/entry.mjs

@@ -1376,6 +1376,16 @@ document.addEventListener(
 window.addEventListener("resize", position, { signal });
 window.addEventListener("scroll", position, { signal, capture: true });
 sync();
+
+config.registerSelfCheck?.(() => {
+  const rail=config.codex.railSlot(ownNavGroup), composer=config.codex.composer(null,{purpose:"insertion"});
+  const checks=[{name:"prompts-navigation-anchor",available:Boolean(rail && navButton?.isConnected)}];
+  if (composer) checks.push({name:"quick-prompts-anchor",available:Boolean(composer.add && button?.isConnected && composerRoot === composer.root)});
+  const available=checks.every(check=>check.available);
+  return {state:available ? "available" : "unavailable",reason:available ? null : "prompts-anchor-unavailable",checks,
+    scopes:[{name:"navigation",element:navButton},{name:"composer",element:composer?.root},{name:"prompts-page",element:page},{name:"prompts-popup",element:pagePopup},{name:"quick-prompts",element:panel}]};
+});
+
 return () => {
   disposed = true;
   observer.disconnect();

package/features/session-status/src/session-status.mjs

@@ -612,6 +612,17 @@ instanceObserver.observe(document.documentElement, {
   attributeFilter:["class", "style", "hidden", "inert", "aria-hidden", "data-composer-placement"],
 });
 syncInstances();
+config.registerSelfCheck?.(() => {
+  const surfaces=[...document.querySelectorAll('[data-codex-composer-root]')].map(root=>config.codex.composerSurface(root)).filter(Boolean);
+  if (!surfaces.length) {
+    const path=config.codex.route();
+    return {state:path?.startsWith("/local/") ? "unavailable" : path ? "not-applicable" : "unknown",reason:"no-thread-surface"};
+  }
+  const identity=surfaces.every(surface=>!!surface.threadId),mounted=surfaces.every(surface=>instances.has(surface.root));
+  const available=identity && mounted;
+  return {state:available ? "available" : "unavailable",reason:available ? null : "thread-identity-or-status-anchor-unavailable",
+    checks:[{name:"thread-identity",available:identity},{name:"session-status-mount",available:mounted}],scopes:surfaces.map((surface,index)=>({name:`composer-${index+1}`,element:surface.root}))};
+});
 return () => {
   instanceObserver.disconnect();
   for (const instance of instances.values()) instance.dispose();

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

@@ -86,4 +86,12 @@ observer.observe(document.documentElement, { subtree:true, childList:true, attri
   "data-app-action-sidebar-section-collapsed", "data-above-composer-conversation-id", "lang"
 ] });
 reconcile();
+config.registerSelfCheck?.(() => {
+  const sidebar=document.querySelector("#app-shell-sidebar");
+  if (!sidebar) return {state:"unknown",reason:"sidebar-anchor-unavailable"};
+  if (!sidebar.checkVisibility({visibilityProperty:true})) return {state:"not-applicable",reason:"sidebar-hidden"};
+  const available=Boolean(button?.isConnected);
+  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(); };

package/features/sites/src/frontend/entry.mjs

@@ -413,6 +413,14 @@ const observer = new MutationObserver(records => { if (records.some(r => !r.targ
 observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["aria-pressed"] });
 document.addEventListener("input", schedule); document.addEventListener("click", onClick, true); document.addEventListener("keydown", onKey, true); document.addEventListener("pointerdown", onPointer, true);
 refresh().catch(e => notice(e.message)); schedule();
+config.registerSelfCheck?.(() => {
+  const path=nativeSites.path();
+  if (!path) return {state:"unknown",reason:"navigation-context-unavailable"};
+  if (path !== "/space/sites") return {state:"not-applicable",reason:"outside-sites-page"};
+  const page=nativeSites.pageInfo(),available=Boolean(page?.create && addButton?.isConnected);
+  return {state:available ? "available" : "unavailable",reason:available ? null : "sites-anchor-unavailable",
+    checks:[{name:"sites-page",available:Boolean(page)},{name:"sites-create-anchor",available}],scopes:[{name:"sites-page",element:page?.page},{name:"sites-dialog",element:dialog},{name:"sites-menu",element:menu}]};
+});
 return () => {
   disposed = true; pendingLayout = null; clearTimeout(timer); observer.disconnect();
   document.removeEventListener("input", schedule); document.removeEventListener("click", onClick, true); document.removeEventListener("keydown", onKey, true); document.removeEventListener("pointerdown", onPointer, true);

package/features/usage-meter/src/adapters/codex/renderer.mjs

@@ -53,7 +53,8 @@ function avatarAnchor(avatar, rail) {
     const windows=currentWindows(context), avatar=findAvatar(rail);
     const available=Boolean(avatar && context.router && windows);
     codex.report("usage-meter",available,available ? null : "account-quota-or-anchor-unavailable");
-    return { rail,avatar,windows,available };
+    return { rail,avatar,windows,available,anchorAvailable:Boolean(avatar && context.router),
+      applicable:context.auth?.isLoading ? null : context.auth ? ["chatgpt","chatgptAuthTokens"].includes(context.auth.authMethod) : null };
   }
   function open(rail) { const {router}=nativeContext(rail); return router?.navigate("/settings/usage?tab=overview",{state:router.state?.location?.state}); }
   signal.addEventListener("abort",()=>unsubscribe?.(),{once:true});

package/features/usage-meter/src/usage-meter.mjs

@@ -158,4 +158,12 @@ const cleanup = () => {
 };
 signal.addEventListener("abort", cleanup, { once: true });
 sync();
+config.registerSelfCheck?.(() => {
+  const snapshot=nativeUsage.read();
+  const available=Boolean(snapshot.available && record?.button.isConnected);
+  return {state:available ? "available" : snapshot.applicable === false ? "not-applicable" : !snapshot.anchorAvailable && snapshot.rail ? "unavailable" : "unknown",reason:available ? null : "quota-data-or-anchor-unavailable",
+    checks:[{name:"account-anchor",available:Boolean(snapshot.avatar)},{name:"account-quota",available:Boolean(snapshot.windows)},{name:"usage-meter-mount",available:Boolean(record?.button.isConnected)}],
+    scopes:[{name:"account",element:snapshot.avatar}]};
+});
+
 return cleanup;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -27,8 +27,6 @@
     "features/notes/assets",
     "features/notes/vendor/phosphor-LICENSE",
     "features/notes/codex-feature.json",
-    "features/notes/DESIGN.md",
-    "features/notes/README.md",
     "features/images/src",
     "features/images/web",
     "features/images/codex-feature.json",
@@ -36,8 +34,6 @@
     "features/hide-upsell-banner/codex-feature.json",
     "features/session-status/src",
     "features/session-status/codex-feature.json",
-    "features/session-status/DESIGN.md",
-    "features/session-status/README.md",
     "features/session-status/vendor/lucide-LICENSE",
     "features/session-status/vendor/phosphor-LICENSE",
     "apps/dashboard/app.js",
@@ -48,25 +44,16 @@
     "README.md",
     "features/usage-meter/src",
     "features/usage-meter/codex-feature.json",
-    "features/usage-meter/DESIGN.md",
-    "features/usage-meter/README.md",
-    "features/unread-inbox/src",
-    "features/unread-inbox/codex-feature.json",
-    "features/unread-inbox/DESIGN.md",
     "features/sidebar-focus/src",
     "features/sidebar-focus/codex-feature.json",
-    "features/sidebar-focus/DESIGN.md",
     "features/sidebar-focus/vendor/lucide-LICENSE",
     "features/sites/src",
     "features/sites/codex-feature.json",
-    "features/sites/DESIGN.md",
-    "features/sites/README.md",
     "features/sites/vendor/lucide-LICENSE",
     "packages/ui/src",
     "packages/codex-adapter/src",
     "packages/codex-adapter/package.json",
     "packages/ui/package.json",
-    "DESIGN.md",
     "assets/brand/minecodex-icon.svg",
     "assets/brand/minecodex-icon-light.svg",
     "assets/brand/minecodex-icon-dark.svg",

package/packages/cli/src/commands.mjs

@@ -202,7 +202,12 @@ function featureStatusText(feature) {
     saved: "saved; restart required",
     configured: "configured; launching",
     launching: "launching",
-    injected: "injected into Codex",
+    injected: "available in Codex",
+    checking: "checking compatibility",
+    partial: "available in some windows",
+    degraded: "appearance needs an update",
+    unavailable: "temporarily unavailable; check for updates",
+    "not-applicable": "not needed on this page",
     healthy: "healthy in Codex",
     failed: "failed; run `mcx restart`",
     stopped: "stopped",

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

@@ -129,7 +129,7 @@ async function featureStatuses(paths, runtimeManager, locale, runtimeState = nul
     const plugin = ready.plugins.find((candidate) => candidate.featureId === feature.id) ?? null;
     const pluginState = plugin?.state ?? null;
     const applied = appliedFeatures.includes(feature.id)
-      || ["configured", "launching", "ready", "injected"].includes(pluginState);
+      || ["configured", "launching", "ready", "injected", "checking", "partial", "degraded", "unavailable", "not-applicable"].includes(pluginState);
     const injected = Boolean(
       pluginState === "injected" && rendererCurrent,
     );
@@ -152,6 +152,8 @@ async function featureStatuses(paths, runtimeManager, locale, runtimeState = nul
       state = "failed";
     } else if (config.features[feature.id] !== applied) {
       state = "restart-required";
+    } else if (["checking","partial","degraded","unavailable","not-applicable"].includes(pluginState)) {
+      state = rendererCurrent ? pluginState : "checking";
     } else if (pluginState === "configured" || pluginState === "launching" || pluginState === "ready") {
       state = "launching";
     } else if (injected && healthy) {
@@ -178,6 +180,7 @@ async function featureStatuses(paths, runtimeManager, locale, runtimeState = nul
       injected,
       healthy,
       state,
+      targets: plugin?.targets ?? [],
       health: plugin?.health ?? null,
       failure,
     };

package/packages/cli/src/platform.mjs

@@ -377,6 +377,14 @@ export class MacPlatformAdapter {
     return this.codexInstallation;
   }
 
+  async codexBuild() {
+    const installation=await this.codex();
+    try {
+      const {stdout}=await this.execFile("/usr/bin/plutil",["-extract","CFBundleShortVersionString","raw","-o","-",path.join(installation.appPath,"Contents","Info.plist")]);
+      return String(stdout).trim() || null;
+    } catch { return null; }
+  }
+
   async readCodexInstallationFingerprint(installation) {
     if (typeof this.fileSystem.stat !== "function") return null;
     const paths = [
@@ -838,6 +846,8 @@ export class WindowsPlatformAdapter {
     return this.codexInstallation;
   }
 
+  async codexBuild() { return (await this.codex()).version ?? null; }
+
   async readCodexInstallationFingerprint(installation) {
     if (typeof this.fileSystem.stat !== "function") return null;
     const paths = [