minecodex 2.0.8 → 2.0.9

package/packages/cli/src/runtime-manager.mjs

@@ -8,6 +8,11 @@ export const RUNTIME_PLUGIN_STATES = Object.freeze([
   "launching",
   "ready",
   "injected",
+  "checking",
+  "partial",
+  "degraded",
+  "unavailable",
+  "not-applicable",
   "failed",
   "stopped",
 ]);
@@ -48,7 +53,7 @@ export function normalizeRuntimeReady(ready = {}) {
     : [];
   const features = [...new Set([
     ...legacyFeatures,
-    ...plugins.filter(({ state }) => ["configured", "launching", "ready", "injected"].includes(state)).map(({ featureId }) => featureId),
+    ...plugins.filter(({ state }) => ["configured", "launching", "ready", "injected", "checking", "partial", "degraded", "unavailable", "not-applicable"].includes(state)).map(({ featureId }) => featureId),
   ])];
   const renderer = ready.renderer && typeof ready.renderer === "object"
     ? {
@@ -78,12 +83,13 @@ function rendererUnavailableReady(ready) {
   const normalized = normalizeRuntimeReady(ready);
   return normalizeRuntimeReady({
     ...normalized,
-    plugins: normalized.plugins.map((plugin) => plugin.state === "injected"
-      ? { ...plugin, state: "ready", health: null }
+    plugins: normalized.plugins.map((plugin) => ["injected","partial","degraded","not-applicable","unavailable","checking"].includes(plugin.state)
+      ? { ...plugin, state: "checking", health: null, targets:[] }
       : plugin),
     renderer: {
       ...(normalized.renderer ?? {}),
       discovered: false,
+      targets:[],
       injectedTargets: 0,
       active: false,
       runtimeSessionId: normalized.runtimeSessionId,
@@ -170,6 +176,7 @@ export class RuntimeManager {
     const config = await readConfig(this.paths.configPath);
     const features = enabledFeatureIds(config);
     if (typeof this.platform?.codex === "function") await this.platform.codex();
+    const codexBuild=await this.platform?.codexBuild?.();
     await mkdir(this.paths.supportDir, { recursive: true, mode: 0o700 });
     await unlink(this.paths.runtimeReadyPath).catch((error) => {
       if (error.code !== "ENOENT") throw error;
@@ -179,6 +186,7 @@ export class RuntimeManager {
       CODEX_FEATURES_ROOT: this.paths.featuresRoot,
       CODEX_RUNTIME_PROFILE_DIR: this.paths.profileDir,
       CODEX_RUNTIME_CDP_PORT: String(this.cdpPort),
+      MINECODEX_CODEX_BUILD: codexBuild ?? "",
       CODEX_IMAGE_HOST_DATA_DIR: this.paths.imagesDataDir,
       CODEX_NOTES_DATA_DIR: this.paths.notesDataDir,
       MINECODEX_ENABLED_FEATURES: features.join(","),

package/packages/codex-adapter/src/renderer/environment.mjs

@@ -65,7 +65,12 @@ export function createCodexEnvironment() {
     const group = [...(scroll?.children ?? [])].find(child => child !== ownGroup && child.classList.contains('flex-col') && child.classList.contains('shrink-0'));
     return node && template && scroll ? { rail:node, template, scroll, group } : null;
   }
-  return { composer, composerSurface, rail, railSlot, currentThreadId:element => composer(element)?.threadId ?? null,
+  function route() {
+    const node = rail();
+    const scope = node && props(node, value => Boolean((value.router ?? value.value?.router)?.state?.location));
+    return (scope?.router ?? scope?.value?.router)?.state?.location?.pathname ?? null;
+  }
+  return { composer, composerSurface, rail, railSlot, route, currentThreadId:element => composer(element)?.threadId ?? null,
     // 仅供 UI／插件 native Adapter 使用，交互层不读取 React props。
     currentFiber, props, report, diagnostics:() => [...capabilities.values()].map(item => ({...item})) };
 }

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

@@ -1,3 +1,4 @@
+import { createRendererSelfCheck, tokenRequirements } from "./renderer-self-check.mjs";
 import { readFileSync } from "node:fs";
 import { createCodexEnvironment } from "../../codex-adapter/src/renderer/environment.mjs";
 // 注入源生成：createInjectionSource 产出注入到 Codex Renderer 的自包含脚本字符串。
@@ -9,7 +10,7 @@ import { createUIInstallerSource } from "../../ui/src/install.mjs";
 import { randomBytes } from "node:crypto";
 import { CODEX_THEME_TOKENS, CODEX_THEME_TOKEN_ALIASES, MINECODEX_THEME_BINDINGS } from "../../ui/src/native/tokens.mjs";
 
-export const RUNTIME_VERSION = 108;
+export const RUNTIME_VERSION = 109;
 const PROJECT_ICON = Object.fromEntries([16, 20].map(size => [size,
   readFileSync(new URL(`../../ui/assets/minecodex-menu-${size}.svg`, import.meta.url), "utf8"),
 ]));
@@ -127,14 +128,14 @@ export function createInjectionSource(features, {
   bindingToken = "test-binding-token",
   runtimeSessionId = randomBytes(16).toString("hex"),
 } = {}) {
-  function install(config, installUI, installModelSliderFeature, createCodexEnvironment) {
+  function install(config, installUI, installModelSliderFeature, createCodexEnvironment, createRendererSelfCheck) {
     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, installUI, installModelSliderFeature, createCodexEnvironment), { once: true });
+      document.addEventListener("DOMContentLoaded", () => install(config, installUI, installModelSliderFeature, createCodexEnvironment, createRendererSelfCheck), { once: true });
       return;
     }
     const currentRuntime = window.__codexPersonalRuntime;
@@ -211,6 +212,7 @@ export function createInjectionSource(features, {
     }));
     featureUI.accountMenuEntry?.({ label:"MineCodex", icon:config.projectIcon, externalIcon:config.externalIcon,
       onOpen:() => requestPageHostAction("minecodex", "open-control-panel", {}) });
+    const selfCheck = createRendererSelfCheck(features, config.sessionId, featureUI.theme);
     const featureById = new Map(features.map((feature) => [feature.id, feature]));
     const sidebarFeatures = features.filter((feature) => feature.entry?.kind === "sidebar");
     const toolbarFeatures = features.filter((feature) => feature.entry?.kind === "conversation-toolbar");
@@ -248,9 +250,19 @@ export function createInjectionSource(features, {
     let nativeTabCapabilityPromise = null;
     let nativeTabCapability = null;
     let nativeTabCapabilityError = null;
-    const modelSlider = installModelSliderFeature(lifetime.signal, {
-      feature: modelSelectorFeature, codex, ui: featureUI, createIcon: createMarkupIcon, requestRefresh: queueEnsure, locale,
-    });
+    let modelSlider = {ensure() {}, dispose() {}};
+    try {
+      modelSlider = installModelSliderFeature(lifetime.signal, {
+        feature: modelSelectorFeature, codex, ui: featureUI, createIcon: createMarkupIcon, requestRefresh: queueEnsure, locale,
+      });
+      if (modelSelectorFeature) {
+        selfCheck.register(modelSelectorFeature.id, () => modelSlider.selfCheck());
+        selfCheck.installed(modelSelectorFeature.id);
+      }
+    } catch (error) {
+      if (modelSelectorFeature) selfCheck.failed(modelSelectorFeature.id);
+      console.warn("[codex-personal] model selector installation failed", error);
+    }
 
     // ========================================================================
     // page-script 特征安装 — 执行各 feature 声明的页面脚本并登记清理
@@ -271,6 +283,7 @@ export function createInjectionSource(features, {
         const pageConfig = feature.pageScript.config ??= {};
         pageConfig.ui = featureUI;
         pageConfig.codex = codex;
+        pageConfig.registerSelfCheck = probe => selfCheck.register(feature.id, probe);
         pageConfig.requestHostAction = (action, payload) => requestPageHostAction(feature.id, action, payload);
         const cleanup = installer(
           lifetime.signal,
@@ -280,7 +293,9 @@ export function createInjectionSource(features, {
           pageConfig,
         );
         if (typeof cleanup === "function") pageScriptCleanups.push(cleanup);
+        selfCheck.installed(feature.id);
       } catch (error) {
+        selfCheck.failed(feature.id);
         console.warn(`[codex-personal] page-script feature failed: ${feature.id}`, error);
       }
     }
@@ -2369,6 +2384,7 @@ export function createInjectionSource(features, {
       sessionId: config.sessionId,
       updateHostBinding,
       nativeCapabilities: () => codex.diagnostics(),
+      selfCheck: () => ({...selfCheck.snapshot(),capabilities:codex.diagnostics()}),
       ensure: queueEnsure,
       show: showPageSurface,
       hide: () => {
@@ -2422,6 +2438,7 @@ export function createInjectionSource(features, {
   }
 
   const runtimeFeatures = features.map((feature) => ({
+    requiredTokens:tokenRequirements(`${feature.pageScript?.source ?? ""} ${Object.values(feature.pageScript?.resources ?? {}).filter(value => typeof value === "string").join(" ")} ${feature.modelSelector ? createModelSliderInstallerSource() : ""}`,MINECODEX_THEME_BINDINGS),
     id: feature.id,
     label: feature.label,
     labels: feature.labels ?? null,
@@ -2457,7 +2474,7 @@ export function createInjectionSource(features, {
     themeTokenAliases: CODEX_THEME_TOKEN_ALIASES,
     themeBindings: MINECODEX_THEME_BINDINGS,
     features: runtimeFeatures,
-  })}, ${createUIInstallerSource()}, ${createModelSliderInstallerSource()}, ${createCodexEnvironment.toString()})`;
+  })}, ${createUIInstallerSource()}, ${createModelSliderInstallerSource()}, ${createCodexEnvironment.toString()}, ${createRendererSelfCheck.toString()})`;
 }
 
 export function createRuntimeReadyContract({
@@ -2478,15 +2495,28 @@ export function createRuntimeReadyContract({
     features: features.map((feature) => typeof feature === "string" ? feature : feature.id),
     failures,
     runtimeSessionId,
-    plugins: plugins.map((plugin) => ({
-      featureId: plugin.featureId,
-      state: active && (plugin.state === "configured" || plugin.state === "ready")
-        ? "injected"
-        : plugin.state,
-      owned: Boolean(plugin.owned),
-      health: plugin.health ?? null,
-      failure: plugin.failure ?? null,
-    })),
+    plugins: plugins.map(plugin => {
+      const targets=(renderer.targets ?? []).map(target => {
+        const result=target.sessionId === runtimeSessionId && active
+          ? target.plugins?.find(result => result.featureId === plugin.featureId) : null;
+        return {targetId:target.targetId,checkedAt:target.checkedAt ?? null,
+          ...(result ?? {state:"unknown",reason:target.reason ?? "self-check-pending",installation:"pending",checks:[],tokens:[]})};
+      });
+      const states=targets.map(target=>target.state);
+      // 未观测的窗口也参与汇总，不能凭一项成功宣称全部窗口可用。
+      const missing=Math.max(0,discoveredTargets-targets.length);
+      let state=plugin.state;
+      const definition=features.find(feature=>typeof feature === "object" && feature.id === plugin.featureId);
+      if (definition?.healthUrl && state === "configured") state="launching";
+      else if (active && ["configured","ready","injected"].includes(state)) {
+        if (states.includes("available")) state=missing || states.some(value=>!["available","not-applicable"].includes(value)) ? "partial" : "injected";
+        else if (states.includes("degraded")) state="degraded";
+        else if (states.some(value=>["failed","unavailable"].includes(value))) state="unavailable";
+        else if (!missing && states.length && states.every(value=>value === "not-applicable")) state="not-applicable";
+        else state="checking";
+      } else if (state === "injected") state="checking";
+      return {featureId:plugin.featureId,state,serviceState:plugin.state,owned:Boolean(plugin.owned),health:plugin.health ?? null,failure:plugin.failure ?? null,targets};
+    }),
     renderer: {
       discovered,
       discoveredTargets,
@@ -2495,6 +2525,9 @@ export function createRuntimeReadyContract({
       healthy: active && targetFailures.length === 0 && injectedTargets === discoveredTargets,
       targetFailures,
       runtimeSessionId: renderer.runtimeSessionId ?? runtimeSessionId,
+      targets:renderer.targets ?? [],
+      codexBuild:renderer.codexBuild ?? null,
+      buildSource:renderer.buildSource ?? null,
     },
   };
 }

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

@@ -75,6 +75,7 @@ export class CodexRuntime {
     surfaceLoadTimeoutMs = 5_000,
     surfaceFramePollMs = 25,
     featureInstanceId = null,
+    codexBuild = null,
     runtimeSessionId = randomBytes(16).toString("hex"),
     onStatusChange = null,
     sitesService = null,
@@ -99,12 +100,14 @@ export class CodexRuntime {
     this.surfaceLoadTimeoutMs = surfaceLoadTimeoutMs;
     this.surfaceFramePollMs = surfaceFramePollMs;
     this.featureInstanceId = featureInstanceId;
+    this.codexBuild = codexBuild;
     this.runtimeSessionId = runtimeSessionId;
     this.onStatusChange = onStatusChange;
     this.onManagedCodexPidChange = onManagedCodexPidChange;
     this.injectedTargets = new Set();
     this.rendererTargetIds = new Set();
     this.targetFailures = new Map();
+    this.targetChecks = new Map();
     this.clients = new Map();
     this.scriptIds = new Map();
     this.bindingTokens = new Map();
@@ -171,6 +174,7 @@ export class CodexRuntime {
     })).sort((left, right) => left.targetId.localeCompare(right.targetId));
     const active = !this.stopping && this.rendererDiscovered && injectedTargets > 0;
     return {
+      ...(this.codexBuild ? {codexBuild:this.codexBuild,buildSource:"installation-at-start"} : {}),
       discovered: this.rendererDiscovered,
       discoveredTargets,
       injectedTargets,
@@ -178,6 +182,7 @@ export class CodexRuntime {
       healthy: active && targetFailures.length === 0 && injectedTargets === discoveredTargets,
       targetFailures,
       runtimeSessionId: this.runtimeSessionId,
+      targets:[...this.rendererTargetIds].map(targetId => ({targetId,...(this.targetChecks.get(targetId) ?? {sessionId:this.runtimeSessionId,checkedAt:null,plugins:[],tokens:[],reason:"self-check-pending"})})),
     };
   }
 
@@ -192,6 +197,7 @@ export class CodexRuntime {
       && previous.active === status.active
       && previous.healthy === status.healthy
       && JSON.stringify(previous.targetFailures) === JSON.stringify(status.targetFailures)
+      && JSON.stringify(previous.targets) === JSON.stringify(status.targets)
       && previous.runtimeSessionId === status.runtimeSessionId
     ) return;
     this.lastRendererStatus = status;
@@ -237,6 +243,7 @@ export class CodexRuntime {
     this.injectedTargets.clear();
     this.rendererTargetIds.clear();
     this.targetFailures.clear();
+    this.targetChecks.clear();
     this.rendererDiscovered = false;
     this.browserClient?.socket.close();
     this.browserClient = null;
@@ -695,6 +702,7 @@ export class CodexRuntime {
       this.clients.delete(id);
       this.scriptIds.delete(id);
       this.bindingTokens.delete(id);
+      this.targetChecks.delete(id);
       this.hostActionChains.delete(id);
       this.injectedTargets.delete(id);
       this.targetFailures.delete(id);
@@ -705,6 +713,18 @@ export class CodexRuntime {
     if (removedTarget || rendererChanged) this.notifyStatusChange();
 
     for (const target of targets) {
+      if (this.injectedTargets.has(target.id)) {
+        const present=await this.checkTarget(target.id);
+        if (present) continue;
+        const previousClient=this.clients.get(target.id),identifier=this.scriptIds.get(target.id);
+        if (identifier) await previousClient?.send("Page.removeScriptToEvaluateOnNewDocument",{identifier}).catch(()=>{});
+        previousClient?.socket.close();
+        this.clients.delete(target.id);
+        this.scriptIds.delete(target.id);
+        this.bindingTokens.delete(target.id);
+        this.injectedTargets.delete(target.id);
+        this.targetChecks.delete(target.id);
+      }
       if (target.type !== "page" || target.url !== "app://-/index.html" || this.injectedTargets.has(target.id)) {
         continue;
       }
@@ -724,6 +744,12 @@ export class CodexRuntime {
         await client.send("Runtime.addBinding", { name: HOST_BINDING_NAME });
         const bindingToken = randomBytes(24).toString("hex");
         this.bindingTokens.set(target.id, bindingToken);
+        client.on?.("Runtime.executionContextsCleared", () => {
+          if (this.clients.get(target.id) !== client) return;
+          // 新文档撤销启动检查，下一次接入周期重新检查一次。
+          this.targetChecks.delete(target.id);
+          this.notifyStatusChange();
+        });
         client.on?.("Runtime.bindingCalled", (params) => {
           let action;
           try { action = JSON.parse(params.payload)?.action; } catch { return; }
@@ -756,6 +782,7 @@ export class CodexRuntime {
         this.clients.set(target.id, client);
         this.scriptIds.set(target.id, scriptIdentifier);
         this.injectedTargets.add(target.id);
+        await this.checkTarget(target.id);
         this.targetFailures.delete(target.id);
         this.notifyStatusChange();
       } catch (error) {
@@ -784,6 +811,28 @@ export class CodexRuntime {
     this.notifyStatusChange();
   }
 
+  async checkTarget(targetId) {
+    const client=this.clients.get(targetId);
+    if (!client || this.stopping) return false;
+    if (this.targetChecks.has(targetId)) return true;
+    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; })()`,
+        returnByValue:true,
+      }, {timeoutMs:3_000});
+      if (this.clients.get(targetId) !== client || this.stopping) return false;
+      const snapshot=response.result?.value;
+      if (!snapshot) return false;
+      if (snapshot.sessionId !== this.runtimeSessionId || !Array.isArray(snapshot.plugins)) throw new Error("Invalid self-check snapshot");
+      this.targetChecks.set(targetId,snapshot);
+      return true;
+    } catch {
+      // 无法读到当前证据时立即撤销旧成功，不把临时 CDP 故障解释为插件不兼容。
+      this.targetChecks.set(targetId,{sessionId:this.runtimeSessionId,checkedAt:null,plugins:[],tokens:[],reason:"self-check-unavailable"});
+      return true;
+    }
+  }
+
   async publishSessionStatus(onlyTargetId = null) {
     for (const [targetId, client] of this.clients) {
       if (onlyTargetId && targetId !== onlyTargetId) continue;
@@ -815,6 +864,7 @@ export class CodexRuntime {
           if (this.clients.get(targetId) === client) {
             client.socket.close();
             this.injectedTargets.delete(targetId);
+            this.targetChecks.delete(targetId);
             this.notifyStatusChange();
           }
         }
@@ -858,6 +908,7 @@ export class CodexRuntime {
       this.injectedTargets.clear();
       this.rendererTargetIds.clear();
       this.targetFailures.clear();
+    this.targetChecks.clear();
       this.rendererDiscovered = false;
       this.notifyStatusChange();
       this.monitorPromise = null;

package/packages/runtime-host/src/feature-registry.mjs

@@ -834,10 +834,9 @@ export async function startFeatureProcesses(features, loggerOrOptions = console,
     getFailures() {
       return records.map(featureFailure).filter(Boolean);
     },
-    getStatuses({ rendererActive = false } = {}) {
+    getStatuses() {
       return records.map((record) => {
-        let state = record.state;
-        if (rendererActive && (state === "configured" || state === "ready")) state = "injected";
+        const state = record.state;
         return {
           featureId: record.featureId,
           state,

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

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import os from "node:os";
-import { writeFile } from "node:fs/promises";
+import { writeFile, rename } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { CodexRuntime, createRuntimeReadyContract } from "./codex-runtime.mjs";
@@ -43,16 +43,19 @@ const updateCodexPidFile = createManagedPidFileWriter(process.env.MINECODEX_CODE
 function writeReadyFile() {
   if (!process.env.MINECODEX_RUNTIME_READY_FILE) return Promise.resolve();
   const filePath = process.env.MINECODEX_RUNTIME_READY_FILE;
-  readyWritePromise = readyWritePromise.catch(() => {}).then(() => writeFile(filePath, `${JSON.stringify(
+  readyWritePromise = readyWritePromise.catch(() => {}).then(async () => {
+    await writeFile(`${filePath}.pending`, `${JSON.stringify(
     createRuntimeReadyContract({
       pid: process.pid,
       features,
-      plugins: featureProcesses.getStatuses({ rendererActive: runtime?.getRendererStatus().active }),
+      plugins: featureProcesses.getStatuses(),
       failures: featureProcesses.getFailures(),
       renderer: runtime?.getRendererStatus(),
       runtimeSessionId: runtime?.runtimeSessionId,
     }),
-  )}\n`, { mode: 0o600 }));
+    )}\n`, { mode: 0o600 });
+    await rename(`${filePath}.pending`,filePath);
+  });
   return readyWritePromise;
 }
 
@@ -71,6 +74,7 @@ featureProcesses = await startFeatureProcesses(features, {
 runtime = new CodexRuntime({
   features,
   featureInstanceId,
+  codexBuild:process.env.MINECODEX_CODEX_BUILD || null,
   profileDir,
   cdpPort,
   onManagedCodexPidChange: updateCodexPidFile,

package/packages/runtime-host/src/renderer-self-check.mjs

@@ -0,0 +1,56 @@
+// 只管理安装证据；必要原生能力与适用场景由功能所属 Adapter 判定。
+export function tokenRequirements(source, bindings) {
+  const nativeNames=new Map(Object.entries(bindings).map(([native,project])=>[project,native]));
+  const requirements=new Map();
+  for (const match of source.matchAll(/var\((--mcx-[a-z0-9-]+)\s*([,)])/g)) {
+    const name=nativeNames.get(match[1]) ?? match[1];
+    requirements.set(name,{name,required:match[2] === ")" || requirements.get(name)?.required === true,
+      ...(nativeNames.has(match[1]) ? {} : {unmapped:true})});
+  }
+  return [...requirements.values()];
+}
+
+export function createRendererSelfCheck(features, sessionId, theme) {
+  const records = new Map(features.map(feature => [feature.id, { featureId:feature.id, tokens:feature.requiredTokens ?? [], installation:"pending", probe:null }]));
+  function register(featureId, probe) {
+    if (typeof probe !== "function") throw new TypeError("Self-check must be a function");
+    records.get(featureId).probe = probe;
+  }
+  function installed(featureId) { records.get(featureId).installation = "installed"; }
+  function failed(featureId) { records.get(featureId).installation = "failed"; }
+  function snapshot() {
+    return {
+      sessionId,
+      checkedAt:Date.now(),
+      tokens:theme.diagnostics(),
+      plugins:[...records.values()].map(record => {
+        const base = { featureId:record.featureId, installation:record.installation };
+        if (record.installation === "failed") return {...base,state:"failed",reason:"installation-failed",checks:[]};
+        if (record.installation !== "installed" || !record.probe) return {...base,state:"unknown",reason:"self-check-pending",checks:[]};
+        try {
+          const result = record.probe();
+          const states = ["available","not-applicable","unavailable","unknown"];
+          if (!states.includes(result?.state)) throw new TypeError("Invalid self-check result");
+          const scopes = result.scopes ?? [];
+          const requirements=record.tokens.map(token=>typeof token === "string" ? {name:token,required:true} : token);
+          const tokens = scopes.filter(scope => scope.element?.isConnected).flatMap(scope =>
+            theme.checkTokens(scope.element,requirements.map(token=>token.name)).map(token => {
+              const requirement=requirements.find(item=>item.name === token.name);
+              return {...token,scope:scope.name,required:requirement.required,
+                ...(requirement.unmapped ? {available:false,reason:"token-mapping-unavailable"} : {})};
+            }));
+          const missingTokens = tokens.some(token => token.required && (!token.available || (token.projectName && (!token.projectValue || token.scopeMatches === false))));
+          // 不导出异常文本、原生对象、凭据或用户内容。
+          return {...base,state:result.state === "available" && missingTokens ? "degraded" : result.state,
+            reason:result.state === "available" && missingTokens ? "design-token-unavailable" : result.reason ?? null,tokens,
+            checks:(result.checks ?? []).map(check => ({
+            name:check.name,available:check.available === true,reason:check.reason ?? null,
+          }))};
+        } catch {
+          return {...base,state:"unavailable",reason:"self-check-failed",checks:[]};
+        }
+      }),
+    };
+  }
+  return {register,installed,failed,snapshot};
+}

package/packages/ui/src/components/composer-menu.mjs

@@ -7,11 +7,16 @@ export function installComposerMenu(signal, ui) {
       ui.surface(node, "composer-menu");
       ui.layer(node, "floating");
       const rect = body.getBoundingClientRect();
+      const root = anchor.closest("[data-codex-composer-root], [data-chatgpt-composer]");
+      // 首页 Add 向下展开；已有会话保留向上的输入框菜单。
+      const below = root?.getAttribute("data-composer-placement") === "home";
       const zoom = Number.parseFloat(getComputedStyle(node).zoom) || 1;
       node.style.left = `${rect.left / zoom}px`;
-      node.style.top = `${(rect.top - gap) / zoom}px`;
+      node.style.top = `${(below ? rect.bottom + gap : rect.top - gap) / zoom}px`;
+      node.style.transform = below ? "translateY(0)" : "translateY(-100%)";
       node.style.width = `${rect.width / zoom}px`;
-      node.style.maxHeight = `${Math.max(0, Math.min(maxHeight, (rect.top - 16) / zoom))}px`;
+      const availableHeight = below ? innerHeight - rect.bottom - gap - 16 : rect.top - 16;
+      node.style.maxHeight = `${Math.max(0, Math.min(maxHeight, availableHeight / zoom))}px`;
       return node;
     },
   };

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

@@ -31,5 +31,20 @@ export function createNativeThemeAdapter(themeTokenNames,themeTokenAliases,theme
     }
 
   function dispose() {for (const [name,value] of previousThemeBindings) { if(value) document.documentElement.style.setProperty(name,value); else document.documentElement.style.removeProperty(name); } }
-  return {read,dispose};
+  function checkTokens(element, names) {
+    const style = getComputedStyle(element);
+    return names.map(name => {
+      const candidates = [name,...(themeTokenAliases[name] ?? [])].flatMap(candidate => candidate.startsWith("--color-")
+        ? [candidate,candidate.replace("--color-","--app-color-")] : [candidate]);
+      const source = candidates.find(candidate => style.getPropertyValue(candidate).trim());
+      const value = source ? style.getPropertyValue(source).trim() : null;
+      const projectName = themeBindings[name];
+      const projectValue = projectName ? style.getPropertyValue(projectName).trim() || null : null;
+      return {name,source:source ?? null,value,available:Boolean(value),
+        projectName:projectName ?? null,projectValue,scopeMatches:!projectName || projectValue === value,
+        reason:!value ? "native-token-unavailable" : projectName && !projectValue ? "project-token-unavailable"
+          : projectName && projectValue !== value ? "scope-mapping-mismatch" : null};
+    });
+  }
+  return {read,dispose,checkTokens,diagnostics:() => checkTokens(document.documentElement,themeTokenNames)};
 }