minecodex 2.0.12 → 2.0.14

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

@@ -7,6 +7,7 @@ function addSections(target, sections) {
 export function createSessionState() {
   return {
     turns: new Set(),
+    currentTurnId: null,
     runningTurns: new Set(),
     responses: new Set(),
     hasResponseUsage: false,
@@ -58,13 +59,15 @@ export function applySessionStatusEvent(state, event) {
       state.hasVisibleHistory=event.sections !== null;
       break;
     case "history-added": addSections(state.visibleSections,event.sections); state.hasVisibleHistory=true; break;
-    case "turn-observed": state.turns.add(event.id); break;
+    case "turn-observed":
+      if (state.currentTurnId !== event.id) reset();
+      state.currentTurnId=event.id; state.turns.add(event.id); break;
     case "session-configured":
       if (Number.isFinite(event.contextWindow)) state.contextWindow=event.contextWindow;
       state.baseInstructionTokens=event.instructionTokens; break;
     case "context-reset": state.compactionEvents++; state.last=null; reset(); break;
-    case "turn-started": reset(); state.turns.add(event.id); state.runningTurns.add(event.id); break;
-    case "turn-ended": reset(); if (event.id) state.runningTurns.delete(event.id); else state.runningTurns.clear(); break;
+    case "turn-started": reset(); state.currentTurnId=event.id; state.turns.add(event.id); state.runningTurns.add(event.id); break;
+    case "turn-ended": reset(); state.currentTurnId=null; if (event.id) state.runningTurns.delete(event.id); else state.runningTurns.clear(); break;
     case "first-token-measured": state.ttftTotalMs+=event.elapsed; state.ttftSamples++; break;
     case "compaction-finished": state.compactionCompleted++; break;
     case "output-observed":
@@ -88,7 +91,7 @@ export function applySessionStatusEvent(state, event) {
         state.responses.add(event.id);
         const output=event.last?.output;
         if (Number.isFinite(output) && output > 0 && state.firstOutputAt != null && Number.isFinite(event.end) && event.end > state.firstOutputAt)
-          state.speedMeasurements.push({ start:state.firstOutputAt,end:event.end,output,
+          state.speedMeasurements.push({ turnId:state.currentTurnId,start:state.firstOutputAt,end:event.end,output,
             outputs:state.pendingOutputIntervals.slice(),tools:state.pendingToolIntervals.slice() });
       }
       reset();
@@ -103,12 +106,23 @@ export function sessionStatusSnapshot(state, threadId) {
   let decodeTokens = 0;
   let decodeMs = 0;
   let speedSamples = 0;
+  const turnSpeeds = new Map();
   for (const sample of state.speedMeasurements) {
     const elapsed = sample.end - sample.start - boundedToolWaitMs(sample.tools, sample.start, sample.end, sample.outputs);
-    if (elapsed <= 0 || elapsed >= 600_000) continue;
-    decodeTokens += sample.output;
-    decodeMs += elapsed;
-    speedSamples += 1;
+    if (!sample.turnId || elapsed <= 0 || elapsed >= 600_000) continue;
+    const turn = turnSpeeds.get(sample.turnId) ?? { tokens:0, ms:0, samples:0 };
+    turn.tokens += sample.output;
+    turn.ms += elapsed;
+    turn.samples += 1;
+    turnSpeeds.set(sample.turnId, turn);
+  }
+  // 按回合顺序取最近三个有效回合；同轮多步合并，无数据的回合不占名额。
+  const recentTurns = [...state.turns].filter(id => turnSpeeds.has(id)).slice(-3);
+  for (const id of recentTurns) {
+    const turn = turnSpeeds.get(id);
+    decodeTokens += turn.tokens;
+    decodeMs += turn.ms;
+    speedSamples += turn.samples;
   }
   const total = state.total;
   const input = total?.input ?? 0;

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

@@ -7,14 +7,14 @@ const copyByLocale = { "zh-CN": {
   firstToken: "平均首字延迟", input: "输入", cached: "缓存输入", output: "输出",
   sum: "合计", capacity: "窗口容量", contextShare: "上下文占用", compactions: "压缩次数",
   instructions: "指令", messages: "消息", toolHistory: "工具交互", other: "未分类",
-  speedHelp: "关于 TPS", speedInfo: "GPT 等模型不公开完整思考过程及逐 Token 生成时间。这里的 TPS 是基于可观测事件估算的体感响应速度，仅供参考，不代表模型真实的 Token 生成速度。",
+  speedHelp: "关于 TPS", speedInfo: "GPT 等模型不公开完整思考过程及逐 Token 生成时间。TPS 取最近 3 个有有效数据的回合，不足 3 轮时按已有数据计算。它是基于可观测事件估算的体感响应速度，仅供参考，不代表模型真实的 Token 生成速度。",
 }, en: {
   turns: "turns", steps: "steps", speed: "TPS", cache: "Cache", cacheDetail: "Cache hit",
   statistics: "Session stats", usage: "Token usage", context: "Context", total: "Total",
   firstToken: "Avg first token", input: "Input", cached: "Cached input", output: "Output",
   sum: "Sum", capacity: "Window size", contextShare: "Context used", compactions: "Compactions",
   instructions: "Instructions", messages: "Messages", toolHistory: "Tool activity", other: "Unclassified",
-  speedHelp: "About TPS", speedInfo: "Models such as GPT do not expose their full reasoning process or per-token generation timing. This TPS estimate reflects perceived response speed based on observable events, rather than the model’s actual token generation speed.",
+  speedHelp: "About TPS", speedInfo: "Models such as GPT do not expose their full reasoning process or per-token generation timing. TPS uses the latest 3 turns with valid timing data, or fewer if unavailable. It estimates perceived response speed from observable events, rather than the model’s actual token generation speed.",
 } };
 function selectedCopy() {
   const language = document.documentElement.lang || navigator.languages?.[0] || navigator.language || "en";

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/sites/src/backend/sites-service.mjs

@@ -3,6 +3,8 @@ import { localListeners, probePage } from "./discovery.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readFile, rename, writeFile, realpath } from "node:fs/promises";
 import os from "node:os";
+import { readFileSync, writeFileSync, renameSync, rmSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
 import path from "node:path";
 import { CodexCatalog } from "../adapters/codex/catalog.mjs";
 
@@ -21,17 +23,30 @@ export class SitesService {
     this.catalogReader = catalog; this.listeners = listeners; this.probe = probe; this.queue = Promise.resolve();
   }
   catalog() { return this.catalogReader.snapshot(); }
-  async read() {
-    try { const data = JSON.parse(await readFile(this.file, "utf8")); if (data.schemaVersion !== 1 || !Array.isArray(data.sites)) throw new Error("Unsupported sites data."); return data.sites.map(site => site.url ? { ...site, hosting: isLocalAddress(new URL(site.url).hostname) ? "local" : "self-hosted" } : site); }
+  readStoredSites() {
+    try { const data = JSON.parse(readFileSync(this.file, "utf8")); if (data.schemaVersion !== 1 || !Array.isArray(data.sites)) throw new Error("Unsupported sites data."); return data.sites.map(site => site.url ? { ...site, hosting: isLocalAddress(new URL(site.url).hostname) ? "local" : "self-hosted" } : site); }
     catch (error) { if (error.code === "ENOENT") return []; throw error; }
   }
+  async read() { return this.readStoredSites(); }
   async mutate(operation) {
     const task = this.queue.catch(() => {}).then(async () => {
-      const sites = await this.read(); const result = operation(sites);
       await mkdir(path.dirname(this.file), { recursive: true, mode: 0o700 });
+      // SQLite 仅协调跨进程写锁，进程退出自动释放；业务数据仍在 sites.json。
+      const lock = new DatabaseSync(path.join(path.dirname(this.file), "sites-write-lock.sqlite"));
       const temporary = `${this.file}.${randomUUID()}.tmp`;
-      await writeFile(temporary, JSON.stringify({ schemaVersion: 1, sites }, null, 2) + "\n", { mode: 0o600 });
-      await rename(temporary, this.file); return result;
+      try {
+        lock.exec("PRAGMA busy_timeout=3000; BEGIN IMMEDIATE");
+        // 锁内不让出事件循环，避免同进程另一个写入等待自己。
+        const sites = this.readStoredSites(); const result = operation(sites);
+        writeFileSync(temporary, JSON.stringify({ schemaVersion: 1, sites }, null, 2) + "\n", { mode: 0o600 });
+        renameSync(temporary, this.file);
+        lock.exec("COMMIT");
+        return result;
+      } finally {
+        if (lock.isTransaction) lock.exec("ROLLBACK");
+        lock.close();
+        rmSync(temporary, { force: true });
+      }
     });
     this.queue = task; return task;
   }

package/features/sites/src/backend/transfer.mjs

@@ -0,0 +1,43 @@
+import { SitesService } from './sites-service.mjs';
+import { normalizeSite, isLocalAddress } from '../domain/site.mjs';
+
+function portable(row) {
+  if (!row.url) return null;
+  const site = normalizeSite({ title: row.title, url: row.url, origin: { kind: 'external' } });
+  if (isLocalAddress(new URL(site.url).hostname) || new URL(site.url).hostname === '0.0.0.0' || new URL(site.url).hostname === '[::]') return null;
+  return { id: row.id, title: site.title, url: site.url };
+}
+export function validateSites(data) {
+  if (!data || data.version !== 1 || !Array.isArray(data.sites) || data.sites.length > 50000) throw new Error('Unsupported Sites data');
+  const ids = new Set();
+  return { version: 1, sites: data.sites.map(row => {
+    if (!row || typeof row.id !== 'string' || !row.id || row.id.length > 256 || ids.has(row.id) || typeof row.title !== 'string' || row.title.length > 160 || typeof row.url !== 'string' || row.url.length > 8192) throw new Error('Invalid Site record');
+    const clean = portable(row);
+    if (!clean) throw new Error('Local URLs cannot be transferred');
+    ids.add(row.id); return clean;
+  }) };
+}
+function merge(sites, incoming) {
+  const result = { added: 0, duplicate: 0, conflict: 0 };
+  const ids = new Map(sites.map(row => [row.id,row])), urls = new Set(sites.map(row => row.url));
+  for (const row of incoming.sites) {
+    const match = ids.get(row.id);
+    if (match) result[match.url === row.url && match.title === row.title ? 'duplicate' : 'conflict']++;
+    else if (urls.has(row.url)) result.duplicate++;
+    else {
+      result.added++;
+      ids.set(row.id,row); urls.add(row.url);
+      sites.push({ ...row, origin: { kind: 'external' }, hosting: 'self-hosted', createdAt: Date.now(), updatedAt: Date.now() });
+    }
+  }
+  return result;
+}
+export function sitesTransfer(dataDir) {
+  const service = new SitesService({ dataDir });
+  return {
+    id: 'sites', validate: validateSites,
+    async snapshot() { const all = await service.read(), sites = all.map(portable).filter(Boolean); return { data: { version: 1, sites }, count: sites.length, excluded: all.length - sites.length }; },
+    async preview(data) { return merge(await service.read(), data); },
+    async apply(data) { return service.mutate(sites => merge(sites, data)); },
+  };
+}

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.12",
+  "version": "2.0.14",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -59,14 +59,22 @@
     "assets/brand/minecodex-icon-dark.svg",
     "assets/brand/references/lucide-LICENSE.txt",
     "assets/readme/hero.svg",
-    "packages/ui/assets"
+    "packages/ui/assets",
+    "features/markdown-reading/src",
+    "features/markdown-reading/codex-feature.json",
+    "features/markdown-reading/vendor/lucide-LICENSE",
+    "features/markdown-reading/assets",
+    "features/file-navigation/src",
+    "features/file-navigation/codex-feature.json",
+    "features/file-navigation/assets",
+    "features/file-navigation/vendor/lucide-LICENSE"
   ],
   "engines": {
     "node": ">=22.5.0"
   },
   "scripts": {
     "start": "node packages/cli/bin/mcx.mjs serve",
-    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs",
+    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/test/*.test.mjs",
     "test:cli": "node --test packages/cli/test/*.test.mjs",
     "test:runtime": "node --test packages/runtime-host/test/*.test.mjs",
     "check": "node scripts/check-syntax.mjs",

package/packages/cli/src/config.mjs

@@ -2,7 +2,7 @@ import { randomBytes } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
 
-export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status", "usage-meter", "sidebar-focus", "sites"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status", "usage-meter", "sidebar-focus", "sites", "markdown-reading", "file-navigation"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
@@ -14,6 +14,8 @@ export const DEFAULT_CONFIG = Object.freeze({
     "usage-meter": true,
     "sidebar-focus": true,
     sites: true,
+    "markdown-reading": true,
+    "file-navigation": true,
   }),
 });
 
@@ -22,7 +24,7 @@ const configQueues = new Map();
 function normalizeFeatures(features) {
   return Object.fromEntries(FEATURE_IDS.map((id) => [
     id,
-    typeof features?.[id] === "boolean" ? features[id] : true,
+    typeof features?.[id] === "boolean" ? features[id] : DEFAULT_CONFIG.features[id],
   ]));
 }
 

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

@@ -9,13 +9,17 @@ import { BrowserExchangeStore } from "./browser-exchange.mjs";
 import { FEATURE_IDS, readConfig, updateFeature } from "./config.mjs";
 import { normalizeRuntimeReady } from "./runtime-manager.mjs";
 
+import { createDataTransfer, MAX_TRANSFER_BYTES } from "./data-transfer/service.mjs";
+
 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"],
   [".js", "text/javascript; charset=utf-8"],
+  [".mjs", "text/javascript; charset=utf-8"],
   [".svg", "image/svg+xml"],
   [".ttf", "font/ttf"],
 ]);
@@ -51,12 +55,12 @@ function json(response, statusCode, value) {
   response.end(body);
 }
 
-async function readJson(request) {
+async function readJson(request, maxBytes = MAX_BODY_BYTES) {
   let size = 0;
   const chunks = [];
   for await (const chunk of request) {
     size += chunk.length;
-    if (size > MAX_BODY_BYTES) throw Object.assign(new Error("Request body is too large"), { statusCode: 413 });
+    if (size > maxBytes) throw Object.assign(new Error("Request body is too large"), { statusCode: 413 });
     chunks.push(chunk);
   }
   let value;
@@ -90,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 {
@@ -203,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;
@@ -220,8 +228,9 @@ async function iconResponse(id, paths, response) {
 
 async function staticResponse(url, paths, response) {
   const requested = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-  const absolute = path.resolve(paths.dashboardDir, requested);
-  if (absolute !== paths.dashboardDir && !absolute.startsWith(`${paths.dashboardDir}${path.sep}`)) {
+  const sharedTooltip = requested === "assets/ui-tooltip.js";
+  const absolute = sharedTooltip ? path.join(packageRoot, "packages/ui/src/components/tooltip.mjs") : path.resolve(paths.dashboardDir, requested);
+  if (!sharedTooltip && absolute !== paths.dashboardDir && !absolute.startsWith(`${paths.dashboardDir}${path.sep}`)) {
     json(response, 404, { error: "NOT_FOUND" });
     return;
   }
@@ -251,6 +260,8 @@ export async function createControlServer({
   logger = console,
   exchangeStore = new BrowserExchangeStore(),
 }) {
+  let transfer;
+  const dataTransfer = () => transfer ??= createDataTransfer({ paths, version: packageMetadata.version });
   let boundPort = port;
   const server = createServer(async (request, response) => {
     try {
@@ -328,6 +339,19 @@ export async function createControlServer({
         json(response, 200, { exchange: exchangeStore.issue(token), expiresInMs: exchangeStore.ttlMs });
         return;
       }
+      if (request.method === "GET" && url.pathname === "/api/data") {
+        json(response, 200, await dataTransfer().inventory()); return;
+      }
+      if (request.method === "GET" && url.pathname === "/api/data/export") {
+        const bundle = await dataTransfer().export();
+        response.setHeader("Content-Disposition", 'attachment; filename="minecodex-data.mcx.json"');
+        json(response, 200, bundle); return;
+      }
+      if (request.method === "POST" && ["/api/data/preview", "/api/data/import"].includes(url.pathname)) {
+        requireMutationOrigin(request, host, boundPort);
+        const bundle = await readJson(request, MAX_TRANSFER_BYTES);
+        json(response, 200, await dataTransfer()[url.pathname.endsWith("/import") ? "import" : "preview"](bundle)); return;
+      }
       const featureMatch = url.pathname.match(/^\/api\/features\/([a-z-]+)$/);
       if (request.method === "PATCH" && featureMatch) {
         requireMutationOrigin(request, host, boundPort);

package/packages/cli/src/data-transfer/service.mjs

@@ -0,0 +1,42 @@
+import path from 'node:path';
+import { promptsTransfer } from '../../../../features/notes/src/backend/transfer.mjs';
+import { sitesTransfer } from '../../../../features/sites/src/backend/transfer.mjs';
+
+import { favoritesTransfer } from '../../../../features/model-slider/src/backend/favorites.mjs';
+import { FEATURE_IDS } from '../config.mjs';
+
+export const MAX_TRANSFER_BYTES = 16 * 1024 * 1024;
+export function createDataTransfer({ paths, version, adapters = [
+  promptsTransfer(process.env.CODEX_NOTES_DATABASE || path.join(paths.notesDataDir, 'codex-notes.sqlite')),
+  sitesTransfer(process.env.MINECODEX_SITES_DATA_DIR || path.join(paths.supportDir, 'sites')),
+  favoritesTransfer(process.env.MINECODEX_MODEL_DATA_FILE || path.join(paths.supportDir, 'model-slider', 'favorites.sqlite')),
+] }) {
+  const registry = new Map(adapters.map(adapter => [adapter.id, adapter]));
+  function validate(bundle) {
+    if (!bundle || bundle.format !== 'minecodex-data' || bundle.version !== 1 || !bundle.features || typeof bundle.features !== 'object' || Array.isArray(bundle.features)) throw Object.assign(new Error('Unsupported MineCodex data file'), { statusCode: 400 });
+    try {
+      return Object.entries(bundle.features).map(([id, data]) => {
+        if (!registry.has(id)) throw new Error(`Unsupported feature: ${id}`);
+        return [id, registry.get(id).validate(data)];
+      });
+    } catch (error) { throw Object.assign(error, { statusCode: 400 }); }
+  }
+  return {
+    async inventory() { return { features: await Promise.all(FEATURE_IDS.map(async id => { const adapter = registry.get(id); if (!adapter) return { id, portable: false }; const { data, ...counts } = await adapter.snapshot(); return { id, portable: true, ...counts }; })) }; },
+    async export() {
+      const bundle = { format: 'minecodex-data', version: 1, appVersion: version, exportedAt: new Date().toISOString(), features: Object.fromEntries(await Promise.all(adapters.map(async adapter => [adapter.id, (await adapter.snapshot()).data]))) };
+      if (Buffer.byteLength(JSON.stringify(bundle, null, 2)) > MAX_TRANSFER_BYTES) throw Object.assign(new Error('Data file exceeds 16 MB'), { statusCode: 413 });
+      return bundle;
+    },
+    async preview(bundle) { return { features: await Promise.all(validate(bundle).map(async ([id, data]) => ({ id, ...await registry.get(id).preview(data) }))) }; },
+    async import(bundle) {
+      const entries = validate(bundle), results = [];
+      // 各领域独立提交；失败时保留已完成结果，重试依靠幂等合并。
+      for (const [id, data] of entries) {
+        try { results.push({ id, status: 'imported', ...await registry.get(id).apply(data) }); }
+        catch { results.push({ id, status: 'failed' }); }
+      }
+      return { complete: results.every(result => result.status === 'imported'), features: results };
+    },
+  };
+}

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

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { spawn } from "node:child_process";
 import { mkdir, open, readFile, rename, unlink, writeFile } from "node:fs/promises";
 import { ChatGPTLaunchCoordinator } from "./chatgpt-launch-coordinator.mjs";
@@ -189,6 +190,8 @@ export class RuntimeManager {
       MINECODEX_CODEX_BUILD: codexBuild ?? "",
       CODEX_IMAGE_HOST_DATA_DIR: this.paths.imagesDataDir,
       CODEX_NOTES_DATA_DIR: this.paths.notesDataDir,
+      MINECODEX_MODEL_DATA_FILE: process.env.MINECODEX_MODEL_DATA_FILE || path.join(this.paths.supportDir, "model-slider", "favorites.sqlite"),
+      MINECODEX_SITES_DATA_DIR: process.env.MINECODEX_SITES_DATA_DIR || path.join(this.paths.supportDir, "sites"),
       MINECODEX_ENABLED_FEATURES: features.join(","),
       MINECODEX_CODEX_PID_FILE: this.paths.codexPidPath,
       MINECODEX_RUNTIME_READY_FILE: this.paths.runtimeReadyPath,

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

@@ -254,6 +254,7 @@ export function createInjectionSource(features, {
     try {
       modelSlider = installModelSliderFeature(lifetime.signal, {
         feature: modelSelectorFeature, codex, ui: featureUI, createIcon: createMarkupIcon, requestRefresh: queueEnsure, locale,
+        requestAction: payload => requestPageHostAction(modelSelectorFeature.id, "model-favorites", payload),
       });
       if (modelSelectorFeature) {
         selfCheck.register(modelSelectorFeature.id, () => modelSlider.selfCheck());
@@ -736,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

@@ -36,6 +36,7 @@ import {
   attachFilesToComposer,
   createImageEditThread,
 } from "./host-actions.mjs";
+import { ModelFavorites } from "../../../features/model-slider/src/backend/favorites.mjs";
 import { SitesService } from "../../../features/sites/src/backend/sites-service.mjs";
 import { SessionStatusReader, threadIdFromLocation } from "../../../features/session-status/src/adapters/codex/session-reader.mjs";
 import { createCodexEnvironment } from "../../codex-adapter/src/renderer/environment.mjs";
@@ -108,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();
@@ -244,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;
@@ -576,6 +579,16 @@ export class CodexRuntime {
       }
       return;
     }
+    if (feature.id === "model-slider" && request.action === "model-favorites") {
+      try {
+        this.modelFavorites ??= new ModelFavorites();
+        const result = this.modelFavorites.action(request.payload);
+        await this.resolveHostAction(client, request.requestId, { ok: true, result });
+      } catch (error) {
+        await this.resolveHostAction(client, request.requestId, { ok: false, error: { code: "MODEL_FAVORITES_FAILED", message: error.message } });
+      }
+      return;
+    }
     if (feature.id === "sites" && request.action === "sites") {
       try {
         const result = await this.sitesService.action(request.payload);
@@ -703,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);
@@ -724,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;
@@ -748,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) => {
@@ -814,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; })()`,
@@ -865,6 +886,7 @@ export class CodexRuntime {
             client.socket.close();
             this.injectedTargets.delete(targetId);
             this.targetChecks.delete(targetId);
+            this.targetCheckDeadlines.delete(targetId);
             this.notifyStatusChange();
           }
         }
@@ -909,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/runtime-host/src/feature-registry.mjs

@@ -8,6 +8,7 @@ import { pathToFileURL } from "node:url";
 const MANIFEST_NAME = "codex-feature.json";
 const HOST_ACTIONS = new Set([
   "sites",
+  "model-favorites",
   "quick-prompts",
   "insert-text",
   "attach-file",

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

@@ -46,5 +46,27 @@ export function createNativeThemeAdapter(themeTokenNames,themeTokenAliases,theme
           : projectName && projectValue !== value ? "scope-mapping-mismatch" : null};
     });
   }
-  return {read,dispose,checkTokens,diagnostics:() => checkTokens(document.documentElement,themeTokenNames)};
+  // 局部组件的映射保留原生变量引用，随作用域和主题变化，不复制根节点的快照值。
+  function bindScope(element, names) {
+    const bindings = names.map(name => {
+      const projectName = themeBindings[name];
+      if (!projectName) throw new Error(`Unknown theme binding: ${name}`);
+      const candidates = [name, ...(themeTokenAliases[name] ?? [])].flatMap(candidate => candidate.startsWith("--color-")
+        ? [candidate, candidate.replace("--color-", "--app-color-")] : [candidate]);
+      const reference = candidates.reduceRight((value, candidate) => value ? `var(${candidate}, ${value})` : `var(${candidate})`, "");
+      const previous = element.style.getPropertyValue(projectName);
+      const priority = element.style.getPropertyPriority(projectName);
+      element.style.setProperty(projectName, reference);
+      return {projectName, reference, previous, priority};
+    });
+    return () => {
+      for (const {projectName, reference, previous, priority} of bindings) {
+        if (element.style.getPropertyValue(projectName) !== reference) continue;
+        if (previous) element.style.setProperty(projectName, previous, priority);
+        else element.style.removeProperty(projectName);
+      }
+    };
+  }
+  // 根清单仅展示已定义变量；必要值缺失仍由控件作用域检查报告。
+  return {read,dispose,checkTokens,bindScope,diagnostics:() => checkTokens(document.documentElement,themeTokenNames).filter(token => token.available)};
 }