minecodex 2.0.2 → 2.0.4

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

@@ -7,12 +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 生成速度。",
 }, 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.",
 } };
 function selectedCopy() {
   const language = document.documentElement.lang || navigator.languages?.[0] || navigator.language || "en";
@@ -21,6 +23,8 @@ function selectedCopy() {
 
 // 图标来自 Lucide Static 与 Phosphor Icons；许可见 vendor/。
 const icons = {
+  // Lucide info，使用官方 SVG 路径。
+  info: '<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>',
   statistics: '<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"><path d="m12 14 4-4"/><path d="M3.34 19a10 10 0 1 1 17.32 0"/></svg>',
   usage: '<svg aria-hidden="true" viewBox="0 0 256 256" fill="currentColor"><path d="M128,24C74.17,24,32,48.6,32,80v96c0,31.4,42.17,56,96,56s96-24.6,96-56V80C224,48.6,181.83,24,128,24Zm80,104c0,9.62-7.88,19.43-21.61,26.92C170.93,163.35,150.19,168,128,168s-42.93-4.65-58.39-13.08C55.88,147.43,48,137.62,48,128V111.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64ZM69.61,53.08C85.07,44.65,105.81,40,128,40s42.93,4.65,58.39,13.08C200.12,60.57,208,70.38,208,80s-7.88,19.43-21.61,26.92C170.93,115.35,150.19,120,128,120s-42.93-4.65-58.39-13.08C55.88,99.43,48,89.62,48,80S55.88,60.57,69.61,53.08ZM186.39,202.92C170.93,211.35,150.19,216,128,216s-42.93-4.65-58.39-13.08C55.88,195.43,48,185.62,48,176V159.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64V176C208,185.62,200.12,195.43,186.39,202.92Z"/></svg>',
 };
@@ -29,7 +33,7 @@ document.getElementById(STYLE_ID)?.remove();
 const style = document.createElement("style");
 style.id = STYLE_ID;
 style.textContent = `
-  [${MARKER}] { box-sizing:border-box; display:flex; flex-wrap:wrap; justify-content:center; align-items:center; gap:0 4px; margin:0 auto; padding-top:2px; max-width:100%; min-height:24px; min-width:0; font-family:var(--font-sans-default,inherit); font-size:var(--text-xs,12px); line-height:16px; font-variant-numeric:tabular-nums; color:var(--color-text-tertiary); }
+  [${MARKER}] { box-sizing:border-box; display:flex; flex-wrap:wrap; justify-content:center; align-items:center; gap:0 4px; margin:0 auto; padding-top:2px; max-width:100%; min-height:24px; min-width:0; font-family:var(--mcx-font-sans-default,inherit); font-size:var(--mcx-text-xs,12px); line-height:16px; font-variant-numeric:tabular-nums; color:var(--mcx-color-text-tertiary); }
   [${MARKER}][hidden] { display:none; }
   [data-minecodex-session-reveal] { display:grid; grid-template-rows:0fr; opacity:0; transition:grid-template-rows 200ms ease,opacity 160ms ease; }
   [data-minecodex-session-reveal][data-expanded] { grid-template-rows:1fr; opacity:1; }
@@ -39,40 +43,44 @@ style.textContent = `
   [data-minecodex-session-reveal]:not([data-expanded]) { pointer-events:none; }
   [data-minecodex-session-reveal][hidden] { display:none; }
   /* 仅展开状态行时缩减原生底部留白；收起或卸载后自动恢复。 */
-  .bottom-0.pb-4:has([data-minecodex-session-reveal][data-expanded]:not([hidden])) { padding-bottom:4px; }
-  [data-minecodex-context-trigger] { display:inline-flex; align-items:center; justify-content:center; flex:none; width:24px; height:var(--height-token-button-composer,28px); padding:0; border:0; border-radius:var(--radius-full); background:transparent; color:var(--color-text-tertiary); cursor:pointer; }
+  [data-thread-scroll-footer="true"]:has([data-minecodex-session-reveal][data-expanded]:not([hidden])) { --thread-composer-bottom-inset:4px; }
+  [data-minecodex-context-trigger] { display:inline-flex; align-items:center; justify-content:center; flex:none; width:24px; height:var(--height-token-button-composer,28px); padding:0; border:0; border-radius:var(--mcx-radius-full); background:transparent; color:var(--mcx-color-text-tertiary); cursor:pointer; }
   [data-minecodex-context-trigger][hidden] { display:none; }
   [data-context-progress] { transition:stroke-dashoffset 120ms ease-out; }
-  [data-minecodex-context-trigger]:hover { background:var(--color-background-primary-ghost-hover); }
-  [data-minecodex-context-trigger]:focus-visible { outline:2px solid var(--color-ring); }
+  [data-minecodex-context-trigger]:hover { background:var(--mcx-color-background-primary-ghost-hover); }
+  [data-minecodex-context-trigger]:focus-visible { outline:2px solid var(--mcx-color-ring); }
   [data-minecodex-context-trigger] svg { width:12px; height:12px; }
   [data-minecodex-native-context] { display:none !important; }
-  [data-minecodex-context-tooltip] { position:fixed; z-index:2147483000; pointer-events:none; width:max-content; padding:5px 12px; border:1px solid var(--color-border-tooltip); border-radius:var(--radius-2xl); background:var(--color-background-tooltip); color:var(--color-text-tooltip); box-shadow:var(--shadow-tooltip); font-family:var(--font-sans-default); font-size:var(--text-sm); line-height:18px; font-weight:var(--tooltip-compact-font-weight); letter-spacing:var(--tracking-tooltip); text-align:center; white-space:pre-line; }
+  [data-minecodex-context-tooltip] { width:max-content; text-align:center; white-space:pre-line; }
   @media (prefers-reduced-motion:reduce) { [data-minecodex-session-reveal], [data-context-progress] { transition:none; } }
-  [${MARKER}] button { box-sizing:border-box; display:inline-flex; align-items:center; gap:6px; height:22px; color:inherit; font:inherit; border:0; border-radius:var(--radius-xl,12px); background:transparent; padding:3px 6px; cursor:pointer; white-space:nowrap; }
+  [${MARKER}] button { box-sizing:border-box; display:inline-flex; align-items:center; gap:6px; height:22px; color:inherit; font:inherit; border:0; border-radius:var(--mcx-radius-xl,12px); background:transparent; padding:3px 6px; cursor:pointer; white-space:nowrap; }
   [${MARKER}] svg, [data-minecodex-session-status-panel] h3 svg { width:14px; height:14px; flex:none; stroke-width:1.75; }
   [${MARKER}] [data-kind="context"] svg, [data-minecodex-session-status-panel] h3 .context-ring { width:12px; height:12px; stroke-width:2; }
-  [${MARKER}] button:hover, [${MARKER}] button[aria-expanded="true"] { background:var(--color-token-list-hover-background); }
+  [${MARKER}] button:hover, [${MARKER}] button[aria-expanded="true"] { background:var(--mcx-color-token-list-hover-background); }
   [${MARKER}] button:focus-visible { outline:2px solid var(--input-outline-border-color-focus); outline-offset:1px; }
-  [data-minecodex-session-status-panel] { --mcx-purple:var(--app-block-accent-purple,light-dark(#8952ee,#7849d1)); --mcx-blue:var(--app-block-accent-blue,light-dark(#3a83f7,#2c67c5)); --mcx-green:var(--app-block-accent-green,light-dark(#53b559,#48a04c)); box-sizing:border-box; position:fixed; z-index:2147483000; min-width:260px; max-width:min(360px,calc(100vw - 24px)); padding:16px; border:1px solid var(--color-border-subtle); border-radius:var(--radius-xl,14px); background:var(--color-token-dropdown-background); color:var(--color-text-primary); font-family:var(--font-sans-default,inherit); font-size:13px; box-shadow:var(--shadow-lg,0 8px 28px rgba(0,0,0,.12)); }
-  [data-minecodex-session-status-panel] h3 { display:flex; align-items:center; gap:8px; margin:0 0 12px; padding:0 0 10px; border-bottom:1px solid var(--color-border-subtle); font-size:14px; font-weight:600; }
+  [data-minecodex-session-status-panel] { --mcx-purple:var(--app-block-accent-purple,light-dark(#8952ee,#7849d1)); --mcx-blue:var(--app-block-accent-blue,light-dark(#3a83f7,#2c67c5)); --mcx-green:var(--app-block-accent-green,light-dark(#53b559,#48a04c)); box-sizing:border-box; position:fixed;  min-width:260px; max-width:min(360px,calc(100vw - 24px)); padding:16px;  border-radius:var(--mcx-radius-xl,14px);  color:var(--mcx-color-text-primary); font-family:var(--mcx-font-sans-default,inherit); font-size:13px;  }
+  [data-minecodex-session-status-panel] h3 { display:flex; align-items:center; gap:8px; margin:0 0 12px; padding:0 0 10px; border-bottom:1px solid var(--mcx-color-border-subtle); font-size:14px; font-weight:600; }
   [data-minecodex-session-status-panel] dl { display:grid; grid-template-columns:minmax(0,1fr) auto; gap:8px 20px; margin:0; }
-  [data-minecodex-session-status-panel] dt { color:var(--color-text-tertiary); }
+  [data-minecodex-session-status-panel] dt { color:var(--mcx-color-text-tertiary); }
+  [data-minecodex-session-status-panel] .tps-label { display:flex; align-items:center; gap:6px; }
+  [data-minecodex-session-status-panel] .tps-info { display:inline-flex; align-items:center; padding:0; border:0; background:transparent; color:inherit; cursor:help; }
+  [data-minecodex-session-status-panel] .tps-info svg { width:12px; height:12px; }
+  [data-minecodex-session-status-panel] .tps-info:focus-visible { outline:2px solid var(--mcx-color-ring); outline-offset:2px; border-radius:var(--mcx-radius-full); }
   [data-minecodex-session-status-panel] dd { margin:0; text-align:right; font-variant-numeric:tabular-nums; white-space:nowrap; }
   [data-minecodex-session-status-panel] .context-head { display:flex; justify-content:space-between; gap:12px; margin-bottom:8px; }
-  [data-minecodex-session-status-panel] .context-head span:first-child { color:var(--color-text-tertiary); }
-  [data-minecodex-session-status-panel] .context-bar, [data-minecodex-session-status-panel] .mix-bar { display:flex; height:6px; overflow:hidden; border-radius:var(--radius-xl); background:var(--color-token-border-default); }
+  [data-minecodex-session-status-panel] .context-head span:first-child { color:var(--mcx-color-text-tertiary); }
+  [data-minecodex-session-status-panel] .context-bar, [data-minecodex-session-status-panel] .mix-bar { display:flex; height:6px; overflow:hidden; border-radius:var(--mcx-radius-xl); background:var(--color-token-border-default); }
   [data-minecodex-session-status-panel] .context-bar { margin-bottom:14px; }
   [data-minecodex-session-status-panel] .mix-bar { grid-column:1 / -1; margin:0 0 3px; }
   [data-minecodex-session-status-panel] .context-bar span, [data-minecodex-session-status-panel] .mix-bar span { display:block; flex:none; height:100%; }
   [data-minecodex-session-status-panel] .context-bar [data-segment="instructions"] { background:var(--mcx-purple); }
   [data-minecodex-session-status-panel] .context-bar [data-segment="messages"], [data-minecodex-session-status-panel] .context-bar [data-segment="overall"] { background:var(--mcx-blue); }
   [data-minecodex-session-status-panel] .context-bar [data-segment="tools"] { background:var(--mcx-green); }
-  [data-minecodex-session-status-panel] .context-bar [data-segment="other"] { background:var(--color-text-tertiary); opacity:.4; }
+  [data-minecodex-session-status-panel] .context-bar [data-segment="other"] { background:var(--mcx-color-text-tertiary); opacity:.4; }
   [data-minecodex-session-status-panel] .mix-bar [data-tone="purple"], [data-minecodex-session-status-panel] dt[data-tone="purple"]::before { background:var(--mcx-purple); }
   [data-minecodex-session-status-panel] .mix-bar [data-tone="blue"], [data-minecodex-session-status-panel] dt[data-tone="blue"]::before { background:var(--mcx-blue); }
   [data-minecodex-session-status-panel] .mix-bar [data-tone="green"], [data-minecodex-session-status-panel] dt[data-tone="green"]::before { background:var(--mcx-green); }
-  [data-minecodex-session-status-panel] .detail-divider { grid-column:1 / -1; margin-top:4px; border-top:1px solid var(--color-border-subtle); }
+  [data-minecodex-session-status-panel] .detail-divider { grid-column:1 / -1; margin-top:4px; border-top:1px solid var(--mcx-color-border-subtle); }
   [data-minecodex-session-status-panel] dt[data-tone] { display:flex; align-items:center; gap:7px; }
   [data-minecodex-session-status-panel] dt[data-tone]::before { content:""; flex:none; width:7px; height:7px; border-radius:2px; }
 `;
@@ -94,11 +102,7 @@ window.addEventListener("storage", (event) => {
 }, { signal });
 // Codex 会把离屏输入框搬到 Quick Chat 浮层；节点仍连接不代表当前页面是聊天。
 function isActiveComposer(composer) {
-  const card = composer.closest('[data-codex-composer-root]');
-  return Boolean(composer.isConnected
-    && card?.getAttribute('data-composer-placement') === 'thread'
-    && !composer.closest('[hidden], [inert], [aria-hidden="true"], [data-floating-chat-surface], [data-right-panel-composer-overlay-content]')
-    && composer.checkVisibility({ visibilityProperty: true }));
+  return Boolean(config.codex.composer(composer));
 }
 function createInstance(composerElement) {
 let copy = selectedCopy();
@@ -144,6 +148,7 @@ trigger.setAttribute("aria-controls", root.id);
 trigger.append(createContextRing());
 const tooltip = document.createElement("div");
 tooltip.id = `minecodex-context-tooltip-${instanceId}`;
+config.ui.tooltipSurface(tooltip);
 tooltip.dataset.minecodexContextTooltip = "";
 tooltip.setAttribute("role", "tooltip");
 tooltip.hidden = true;
@@ -217,6 +222,11 @@ collapse.innerHTML = '<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" st
 collapse.addEventListener("click", () => { setGlobalExpanded(false); trigger.focus(); hideTooltip(); }, { signal });
 root.append(collapse);
 let snapshot = null;
+// 统计刷新会重建浮窗，复用图标节点以保留 tooltip 的悬浮锚点。
+const tpsInfo = document.createElement("button");
+tpsInfo.type = "button";
+tpsInfo.className = "tps-info";
+tpsInfo.innerHTML = icons.info;
 let panel = null;
 let openKind = null;
 let rescanQueued = false;
@@ -308,6 +318,7 @@ function showPanel(kind) {
   anchor.setAttribute("aria-expanded", "true");
   panel = document.createElement("div");
   panel.dataset.minecodexSessionStatusPanel = kind;
+  config.ui.surface(panel, "popover");
   panel.setAttribute("role", "dialog");
   panel.setAttribute("aria-label", copy[kind]);
   const heading = document.createElement("h3");
@@ -319,7 +330,11 @@ function showPanel(kind) {
     row(dl, copy.turns, number(snapshot.turns));
     row(dl, copy.steps, number(snapshot.steps));
     row(dl, copy.firstToken, duration(snapshot.averageFirstTokenMs));
-    row(dl, copy.speed, snapshot.observedTps == null ? "—" : `${number(snapshot.observedTps)} tok/s`);
+    const speedLabel = row(dl, copy.speed, snapshot.observedTps == null ? "—" : `${number(snapshot.observedTps)} tok/s`);
+    speedLabel.className = "tps-label";
+    tpsInfo.setAttribute("aria-label", copy.speedHelp);
+    tpsInfo.setAttribute("data-minecodex-tooltip", copy.speedInfo);
+    speedLabel.append(tpsInfo);
   } else if (kind === "usage") {
     row(dl, copy.total, tokenValue(snapshot.totalTokens));
     const otherInput = snapshot.inputTokens == null || snapshot.cachedInputTokens == null
@@ -386,88 +401,13 @@ function findComposer() {
   return isActiveComposer(composerElement) ? composerElement : null;
 }
 function currentThreadId(composer) {
-  if (!composer) return null;
-  const card = composer.closest('[data-codex-composer-root]');
-  const portal = card?.querySelector('[data-above-composer-portal]');
-  // 只认 Codex 输入框绑定的会话；侧栏和 URL 在切换模式时可能仍指向旧会话。
-  if (card?.getAttribute('data-composer-placement') !== 'thread') return null;
-  const value = portal?.getAttribute('data-above-composer-conversation-id');
-  return value?.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? null;
+  return config.codex.currentThreadId(composer);
 }
 // 与原生 Context 指示器订阅同一会话状态；不以日志百分比覆盖它。
-const emptyNativeContext = () => ({ contextUsedTokens: null, contextWindow: null, contextPercent: null });
+const emptyNativeContext = () => ({ contextUsedTokens:null,contextWindow:null,contextPercent:null });
 let nativeContext = emptyNativeContext();
-let nativeContextFamily = null;
-let nativeContextSubscription = null;
-let nativeContextThread = null;
-function findNativeScope(element) {
-  let fiber;
-  for (let node = element; node && !fiber; node = node.parentElement) {
-    fiber = node[Object.keys(node).find((key) => key.startsWith("__reactFiber"))];
-  }
-  for (let depth = 0; fiber && depth < 200; depth++, fiber = fiber.return) {
-    const chain = fiber.memoizedProps?.value;
-    if (!(chain instanceof Map)) continue;
-    for (const node of chain.values()) {
-      if (node?.token?.__scopeBrand === "AppScope" && typeof node.store?.sub === "function") {
-        return { node, chain };
-      }
-    }
-  }
-  return null;
-}
-function contextFromNativeUsage(usage) {
-  const windowSize = usage?.modelContextWindow;
-  const total = usage?.last?.totalTokens;
-  if (!Number.isFinite(windowSize) || windowSize <= 0 || !Number.isFinite(total) || total < 0) {
-    return emptyNativeContext();
-  }
-  const used = Math.min(total, windowSize);
-  return { contextUsedTokens: used, contextWindow: windowSize, contextPercent: Math.round(used / windowSize * 100) };
-}
-function syncNativeContext(composer) {
-  if (nativeContextThread === activeThreadId && nativeContextSubscription) return;
-  nativeContextSubscription?.();
-  nativeContextSubscription = null;
-  nativeContextThread = null;
-  nativeContext = emptyNativeContext();
-  if (!activeThreadId || !nativeContextFamily) return;
-  const scope = findNativeScope(composer);
-  if (!scope) return;
-  try {
-    const threadId = activeThreadId;
-    const descriptor = nativeContextFamily.resolve(scope.node, scope.chain, threadId);
-    const atom = descriptor.resolve(scope.node, scope.chain);
-    const update = () => {
-      if (disposed || activeThreadId !== threadId) return;
-      nativeContext = contextFromNativeUsage(scope.node.store.get(atom));
-      render();
-    };
-    nativeContextThread = threadId;
-    nativeContextSubscription = scope.node.store.sub(atom, update);
-    update();
-  } catch {
-    nativeContextThread = null;
-  }
-}
-async function loadNativeContextFamily() {
-  try {
-    const url = [...document.querySelectorAll("link[rel=modulepreload]")].map((link) => link.href)
-      .find((name) => /\/app-shared-[^/]+\.js(?:$|\?)/.test(name));
-    if (!url) return;
-    const source = await (await fetch(url, { signal })).text();
-    // 从当前构建解析导出，避免依赖每次更新都会变化的压缩符号或资源哈希。
-    const local = source.match(/([\w$]+)=[\w$]+\(\(\{latestTokenUsageInfo:/)?.[1];
-    if (!local) return;
-    const exported = [...source.matchAll(/([\w$]+) as ([\w$]+)/g)]
-      .find((match) => match[1] === local)?.[2];
-    if (!exported) return;
-    const module = await import(url);
-    if (signal.aborted || disposed) return;
-    nativeContextFamily = module[exported];
-    syncNativeContext(findComposer());
-  } catch { /* 原生接口不可用时保留占位，不显示过期的日志百分比。 */ }
-}
+const nativeUsage = createContextUsageAdapter(signal, config.codex, value => { nativeContext=value; render(); });
+function syncNativeContext(composer) { nativeUsage.connect(activeThreadId, composer); }
 function requestRefresh() {
   if (!activeThreadId || signal.aborted) return;
   if (typeof window[config.bindingName] === "function") {
@@ -586,7 +526,7 @@ const localeObserver = new MutationObserver(() => {
 localeObserver.observe(document.documentElement, { attributes: true, attributeFilter: ["lang"] });
 setExpanded(globalExpanded);
 ensurePosition();
-void loadNativeContextFamily();
+
 const receiver = {
   update(value, revision) {
     ensurePosition();
@@ -604,7 +544,7 @@ const receiver = {
 return { update: receiver.update, setExpanded, dispose() {
   controller.abort();
   disposed = true;
-  nativeContextSubscription?.();
+  nativeUsage.dispose();
   clearTimeout(refreshTimer);
   clearTimeout(collapseTimer);
   observer.disconnect();

package/features/sidebar-focus/DESIGN.md

@@ -1,16 +1,17 @@
 # Sidebar Focus
 
+通用视觉、材质、按钮、Tooltip 与原生 sidebar 层级遵循根 [DESIGN.md](../../DESIGN.md)。本文件只记录功能特有组件、布局、数据语义与通用组件选型。
+
 保留当前任务所在分类与 Project，收起其他分支。再次点击恢复进入聚焦前的展开状态；聚焦期间切换任务跟随路径。用户手动调整分支时退出聚焦并保留手动布局，无撤销浮层。
 
 - 入口：展开侧栏的 Activity 与 Search 之间，随原生侧栏一起隐藏。
-- 图标：Lucide list-chevrons-down-up（聚焦）/ list-chevrons-up-down（还原），16px，24px viewBox 内 2px 描边。
-- 控件：继承原生 Activity 的 Button 类、28px 热区、secondary 颜色，始终使用 ghost。灰色背景仅在 hover 时出现，聚焦状态由图标切换表达，不保留选中底色。
-- 字体、颜色、圆角、动效全部使用原生控件，不新增主题覆盖。
+- 图标：固定使用 Lucide list-chevrons-down-up，开启和退出聚焦不切换图标。16px，24px viewBox，描边 1.575 units（实际 1.05px）。
+- 控件：继承原生 Activity 的 Button 类与 28px 热区。未激活为 secondary / ghost，激活为 info / soft，与原生 View activity 一致；aria-pressed 表达聚焦开关状态。
 - 中英文标题：Focus current task / 聚焦当前任务；Exit focus / 退出聚焦。
 - 折叠通过原生回调执行；React 元数据仅用于读取稳定分类、项目和会话身份。
 - 无可识别当前路径时禁用；Activity 列表展示期间暂停整理。
 - 状态仅作用于当前窗口；卸载不额外改变用户布局。
 
-始终显式使用 secondary 色，避免从激活的 Activity 按钮继承 info 蓝色。Activity 开启时按钮原生 disabled，暂停聚焦操作，关闭后恢复可用性。
+根据聚焦状态显式设置 data-color 与 data-variant，直接复用原生语义 token 适配明暗模式，不写死蓝色或背景色。Activity 开启时按钮原生 disabled，暂停聚焦操作，关闭后恢复可用性。
 
-聚焦与还原图标采用 24×24 viewBox、16px 显示尺寸，描边 1.575 units（实际 1.05px），对齐相邻原生铃铛和搜索的轮廓粗细。
+Tooltip 由共享组件库通过 `data-minecodex-tooltip` 管理；插件只提供随聚焦状态变化的文案，不维护独立材质、定位或显示事件。克隆入口时移除原控件的 `title` 与 `aria-describedby`。

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

@@ -12,7 +12,8 @@
   },
   "entry": {
     "kind": "page-script",
-    "script": "src/sidebar-focus.mjs"
+    "script": "src/sidebar-focus.mjs",
+    "sourceFactory": "src/injection-source.mjs"
   },
   "placement": {
     "order": 80

package/features/sidebar-focus/src/adapters/codex/renderer.mjs

@@ -0,0 +1,28 @@
+export function createFocusAdapter(codex) {
+  const sectionSelector="[data-app-action-sidebar-section]", projectSelector="[data-app-action-sidebar-project-row]";
+const props = (element,predicate) => codex.props(element,predicate,30) ?? {};
+function branches() {
+  return [...document.querySelectorAll("#app-shell-sidebar " + sectionSelector)].map(element => {
+    const native = props(element, p => !!p.sectionKey);
+    const data = props(element, p => Array.isArray(p.section?.threadKeys)).section;
+    return { element, key:"section:" + native.sectionKey, data, expanded:element.dataset.appActionSidebarSectionCollapsed === "false",
+      toggle:() => native.onCollapsedChange?.(element.dataset.appActionSidebarSectionCollapsed === "false") };
+  }).concat([...document.querySelectorAll("#app-shell-sidebar " + projectSelector)].map(element => ({
+    element, key:"project:" + element.dataset.appActionSidebarProjectId,
+    data:props(element, p => !!p.group?.projectId).group,
+    expanded:element.getAttribute("aria-expanded") === "true",
+    toggle:() => element.click(),
+  })));
+}
+function target(items) {
+  const selected = document.querySelector('#app-shell-sidebar [data-app-action-sidebar-thread-selected="true"]');
+  const id = codex.currentThreadId();
+  const key = selected?.dataset.appActionSidebarThreadId || (id ? "local:" + id : null);
+  const activeProject = items.map(b => props(b.element, p => p.activeProjectId != null).activeProjectId).find(Boolean);
+  const project = items.find(b => b.key.startsWith("project:") && (b.data?.threadKeys?.includes(key) || b.data?.projectId === activeProject));
+  const section = items.find(b => b.key.startsWith("section:") && (b.data?.threadKeys?.includes(key) || (activeProject && b.data?.itemKeys?.includes("codex:project:" + activeProject))))
+    || items.find(b => b.key.startsWith("section:") && (selected && b.element.contains(selected) || project && b.element.contains(project.element)));
+  return section ? { section, project } : null;
+}
+  return {branches,target};
+}

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

@@ -0,0 +1,6 @@
+import { readFile } from "node:fs/promises";
+import { createFocusAdapter } from "./adapters/codex/renderer.mjs";
+export async function createPageScriptSource() {
+  const source=await readFile(new URL("./sidebar-focus.mjs",import.meta.url),"utf8");
+  return `const createFocusAdapter=${createFocusAdapter.toString()};\n${source}`;
+}

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

@@ -1,81 +1,34 @@
-const COLLAPSE_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"16\"\n  height=\"16\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.575\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h8\" />\n  <path d=\"M3 12h8\" />\n  <path d=\"M3 19h8\" />\n  <path d=\"m15 5 3 3 3-3\" />\n  <path d=\"m15 19 3-3 3 3\" />\n</svg>\n";
-const EXPAND_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"16\"\n  height=\"16\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.575\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h8\" />\n  <path d=\"M3 12h8\" />\n  <path d=\"M3 19h8\" />\n  <path d=\"m15 8 3-3 3 3\" />\n  <path d=\"m15 16 3 3 3-3\" />\n</svg>\n";
-const sectionSelector = "[data-app-action-sidebar-section]";
-const projectSelector = "[data-app-action-sidebar-project-row]";
+const nativeFocus = createFocusAdapter(config.codex);
+const FOCUS_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"16\"\n  height=\"16\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.575\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h8\" />\n  <path d=\"M3 12h8\" />\n  <path d=\"M3 19h8\" />\n  <path d=\"m15 5 3 3 3-3\" />\n  <path d=\"m15 19 3-3 3 3\" />\n</svg>\n";
+
+
 const states = new Map();
-const tip = document.createElement("div");
-tip.id = "minecodex-focus-tooltip";
-tip.setAttribute("role", "tooltip");
-tip.hidden = true;
-const style = document.createElement("style");
-style.textContent = `#minecodex-focus-tooltip {position:fixed;z-index:2147483000;pointer-events:none;padding:5px 12px;border:1px solid var(--color-border-tooltip);border-radius:var(--radius-2xl);background:var(--color-background-tooltip);color:var(--color-text-tooltip);box-shadow:var(--shadow-tooltip);font-family:var(--font-sans-default);font-size:var(--text-sm);line-height:18px;font-weight:var(--tooltip-compact-font-weight);letter-spacing:var(--tracking-tooltip);}`;
-document.head.append(style);
-document.body.append(tip);
-function showTip() {
-  if (!button) return;
-  tip.hidden = false;
-  const rect = button.getBoundingClientRect();
-  tip.style.left = Math.max(8, rect.x + rect.width / 2 - tip.offsetWidth / 2) + "px";
-  tip.style.top = rect.bottom + 8 + "px";
-}
-function hideTip() { tip.hidden = true; }
 let active = false, restoring = false, button, timer, disposed = false;
 const text = (en, cn) => (document.documentElement.lang || navigator.language).startsWith("zh") ? cn : en;
-function props(element, predicate) {
-  let fiber = element?.[Object.keys(element).find(key => key.startsWith("__reactFiber"))];
-  for (let i = 0; fiber && i < 30; i++, fiber = fiber.return) {
-    if (predicate(fiber.memoizedProps || {})) return fiber.memoizedProps;
-  }
-  return {};
-}
-function branches() {
-  return [...document.querySelectorAll("#app-shell-sidebar " + sectionSelector)].map(element => {
-    const native = props(element, p => !!p.sectionKey);
-    const data = props(element, p => Array.isArray(p.section?.threadKeys)).section;
-    return { element, key:"section:" + native.sectionKey, data, expanded:element.dataset.appActionSidebarSectionCollapsed === "false",
-      toggle:() => native.onCollapsedChange?.(element.dataset.appActionSidebarSectionCollapsed === "false") };
-  }).concat([...document.querySelectorAll("#app-shell-sidebar " + projectSelector)].map(element => ({
-    element, key:"project:" + element.dataset.appActionSidebarProjectId,
-    data:props(element, p => !!p.group?.projectId).group,
-    expanded:element.getAttribute("aria-expanded") === "true",
-    toggle:() => element.click(),
-  })));
-}
+
+
 function remember(items) {
   for (const item of items) if (!states.has(item.key)) states.set(item.key, item.expanded);
 }
-function target(items) {
-  const selected = document.querySelector('#app-shell-sidebar [data-app-action-sidebar-thread-selected="true"]');
-  const id = document.querySelector("[data-above-composer-conversation-id]")?.dataset.aboveComposerConversationId;
-  const key = selected?.dataset.appActionSidebarThreadId || (id ? "local:" + id : null);
-  const activeProject = items.map(b => props(b.element, p => p.activeProjectId != null).activeProjectId).find(Boolean);
-  const project = items.find(b => b.key.startsWith("project:") && (b.data?.threadKeys?.includes(key) || b.data?.projectId === activeProject));
-  const section = items.find(b => b.key.startsWith("section:") && (b.data?.threadKeys?.includes(key) || (activeProject && b.data?.itemKeys?.includes("codex:project:" + activeProject))))
-    || items.find(b => b.key.startsWith("section:") && (selected && b.element.contains(selected) || project && b.element.contains(project.element)));
-  return section ? { section, project } : null;
-}
+
 function reconcile() {
   if (disposed) return;
   const sidebar = document.querySelector("#app-shell-sidebar");
   const bell = [...(sidebar?.querySelectorAll("button[aria-pressed]") || [])].find(e => /activity|活动|动态/.test(e.getAttribute("aria-label") || ""));
-  if (!bell) { button?.remove(); button = null; hideTip(); return; }
+  if (!bell) { button?.remove(); button = null; return; }
   if (!button?.isConnected) {
     button = bell.cloneNode(false);
     button.removeAttribute("id");
     button.setAttribute("data-minecodex-focus", "");
     // 复用原生内层容器，由其负责图标在热区内居中。
     const inner = bell.firstElementChild.cloneNode(false);
-    inner.innerHTML = COLLAPSE_GLYPH;
+    inner.innerHTML = FOCUS_GLYPH;
     button.replaceChildren(inner);
-    button.setAttribute("aria-describedby", tip.id);
-    button.addEventListener("pointerenter", showTip, { signal });
-    button.addEventListener("pointerleave", hideTip, { signal });
-    button.addEventListener("focus", showTip, { signal });
-    button.addEventListener("blur", hideTip, { signal });
+    button.removeAttribute("title");
+    button.removeAttribute("aria-describedby");
     button.addEventListener("click", () => {
-      hideTip();
       if (active) { active = false; restoring = true; }
-      else { states.clear(); remember(branches()); active = true; }
+      else { states.clear(); remember(nativeFocus.branches()); active = true; }
       schedule();
     }, { signal });
     // 作为原生按钮组的独立子项，继承组内 gap，不放进铃铛的 Tooltip 包装层。
@@ -87,18 +40,18 @@ function reconcile() {
   }
   const label = active ? text("Exit focus", "退出聚焦") : text("Focus current task", "聚焦当前任务");
   if (button.getAttribute("aria-label") !== label) button.setAttribute("aria-label", label);
-  if (tip.textContent !== label) tip.textContent = label;
+  button.setAttribute("data-minecodex-tooltip", label);
   const pressed = String(active);
   if (button.getAttribute("aria-pressed") !== pressed) {
     button.setAttribute("aria-pressed", pressed);
-    button.firstElementChild.innerHTML = active ? EXPAND_GLYPH : COLLAPSE_GLYPH;
   }
-  button.setAttribute("data-color", "secondary");
-  button.setAttribute("data-variant", "ghost");
-  const items = branches(), path = target(items);
+  // 与原生 View activity 共用 info / soft 激活态及明暗主题 token。
+  button.setAttribute("data-color", active ? "info" : "secondary");
+  button.setAttribute("data-variant", active ? "soft" : "ghost");
+  const items = nativeFocus.branches(), path = nativeFocus.target(items);
   const activityActive = bell.getAttribute("aria-pressed") === "true";
   button.disabled = activityActive || (!active && !restoring && !path);
-  if (activityActive) { hideTip(); return; }
+  if (activityActive) return;
   if (restoring) {
     // 先恢复已挂载的子分支，再恢复分类，避免父节点收起后子节点消失。
     const change = items.filter(b => b.key.startsWith("project:")).concat(items.filter(b => b.key.startsWith("section:")))
@@ -131,4 +84,4 @@ observer.observe(document.documentElement, { subtree:true, childList:true, attri
   "data-app-action-sidebar-section-collapsed", "data-above-composer-conversation-id", "lang"
 ] });
 reconcile();
-return () => { disposed = true; clearTimeout(timer); observer.disconnect(); button?.remove(); tip.remove(); style.remove(); };
+return () => { disposed = true; clearTimeout(timer); observer.disconnect(); button?.remove(); };

package/features/sites/DESIGN.md

@@ -0,0 +1,60 @@
+# Sites 扩展设计约定
+
+通用视觉、材质、按钮、Tooltip 与原生 sidebar 层级遵循根 [DESIGN.md](../../DESIGN.md)。本文件只记录功能特有组件、布局、数据语义与通用组件选型。
+
+状态：原生 Sites 增强，沿用宿主当前主题。开发来源与托管位置分开。
+
+## 用户路径
+
+Sites 标题工具区增加次要操作 Add site，保留官方 Create。添加弹窗默认展示 Codex 本地项目中的网页入口候选（含未启动网站），不显示重复的项目分组标题，项目名称仅在候选次级文本呈现；候选使用 checkbox 多选，点击整行切换勾选；已收录项勾选且禁用。两个模式底部统一提供 Cancel / Add，项目模式未选择时禁用 Add，点击后才批量收录；取消不保存选择。候选不自动收录；扫描不启动服务。打开已收录的未启动站点时，使用支持的启动方式按需启动。弹窗使用「Project / Custom」分段按钮切换；切换保留已填写的网址；项目模式自动扫描并直接展示候选，不显示搜索框、说明行或刷新按钮。「自定义网址」只提供网址和名称，默认作为外部网址收录，在无项目聊天中打开；不显示开发来源及说明。网址与名称均必填；名称不能仅含空白且最多160字符，网址须为不含嵌入凭证的有效 HTTP(S) 地址。不符合时禁用 Add，输入变化后实时更新。项目关联自动来自扫描，不在编辑弹窗暴露。
+
+通过 MineCodex 添加的条目统一展示在 Added by you 标签的列表/网格，Owned by you 和 Shared with you 保持官方条目；使用同一搜索框。标题下只显示主机地址与端口；访问列用图标 + Local address / External site，沿用原生 16px 图标、主文字色、text-sm 与 gap-1.5。Added by you 同时包含 Local 和 External，访问列继续区分地址类型。操作列复用原生外部箭头，在默认浏览器打开；Project 条目菜单只提供移除，Custom URL 可编辑网址与名称，沿用添加校验。移除只移除入口。
+
+## 原生 token 与组件
+
+- 列表：复用原生 row 的 grid/subgrid、82px 最小高度、16px 内边距、rounded-xl 与 primary-ghost-hover。
+- 网格：原生 210px 卡片，148px 预览与62px信息区；rounded-2xl、border-subtle、surface-card、shadow-sm。
+- 按钮：复用原生 `_Button` 与 `_ButtonInner` 类以及 data-color / data-variant / data-size 状态接口。Add site 为 secondary outline；确认沿用 primary solid。
+- 弹窗：选择通用 Dialog 的 opaque 分支（Sites Share），最大宽560px，不加独立操作区分隔线；当前通过 `config.ui` 接入。通用容器、遮罩、标题、Close及焦点契约遵循根规范。
+- 分段按钮：使用原生 segmented-control 的统一底板、等宽选项及选中块，复用 gap/gutter/background/font-weight/thumb-background/thumb-shadow/option-highlight token；控件尺寸为 control-size-md，支持方向键切换与选中状态语义。
+- 图标：从原生 Sites、Create、行菜单节点克隆 SVG；不重画。扫描结果和添加后的条目异步获取真实网页截图，本地缓存；完成后替换占位。没有截图时保留原生 Sites 图标，不阻塞选择和添加。
+
+## 打开与布局
+
+通过原生 router 的项目 state、本地执行模式（prefillLocalExecution / prefillComposerMode）新建项目草稿，或定位无项目 thread，随后打开原生浏览器。保留原生已有未发送草稿，不发送消息。源关联失效时提示从可用项目重新添加，不静默变成外部来源。
+
+浏览器就绪后收起聊天侧栏，调用原生 Enter full view，使当前网页占据完整工作区，并保留原生 Chat/网页标签及底部聊天输入框。已在 full view 时不反向切换；官方站点沿用原生打开路径，同样进入 full view。
+
+## 验证
+
+隔离 profile 验证发现、添加、路由、列表/网格、搜索、明暗主题、移除、服务停止后的保留；日常安装不注入开发实现。原生内部选择器变化时显示明确错误，不写死聊天宽度。
+
+自定义网址的添加与编辑使用相同的两项表单，不提供来源选择浮层。关闭调用共享外壳的原生 Close；项目网页直接展示扫描结果，不重复显示项目分组标题。添加网址仅在分段面板中填写，不再提供底部重复入口或二级返回跳转。
+
+More 菜单复用原生 Sites menu/menuitem/leadingIcon 类与 token：220px 最小宽度、4px gutter、菜单项 5px × 8px 内边距、16px 图标、6px 内容间距；文案为 Edit / Remove。Edit 复用原生 SVG，Remove 使用 Lucide trash-2，随主题继承文字色，悬停/聚焦时图标由75%到100%不透明度。
+
+预览图加载使用主题文字色与 surface 混合的6%/16%渐变、1.6s单向扫光与 reduced-motion 规则；图片解码成功后替换骨架，失败才显示图标占位。Project websites 缩略图固定96×60（8:5），各加载状态不改变布局。外部箭头通过 electronBridge.sendMessageFromView 发送 open-in-browser，不使用普通 window.postMessage。
+
+图标占位沿用预览区域的横幅比例和尺寸，不退回方形。使用 --color-background-primary-soft 浅灰底与 --color-text-primary 图标色（浅色模式黑色，深色模式对应主题色）。
+
+预览区域描边复用原生 Sites 的 inset 0 0 0 1px var(--color-border)，覆盖于图片/骨架/占位之上，不增加布局尺寸。项目站点副文本显示项目名；确认运行时附加全角括号中的端口号，例如 VonDoc（49706），未运行仅显示 VonDoc。不在界面展示历史时间。无项目归属的 Custom URL 继续显示地址。
+
+
+### 添加弹窗按钮（共享表单外壳）
+
+Add / Save 选择通用 primary（solid），Cancel 选择 ghost；有实质功能的次级操作选择 secondary（outline）。项目模式未选择候选、自定义模式表单无效时禁用确认。页面工具区按钮继续复用原生 `_Button`。
+
+模式选择使用真正的 segmented button：两项等宽，统一底板，选中块使用原生 thumb 背景及阴影；不再使用 Sites ownership tabs 的独立胶囊外观。尺寸与颜色引用原生 control / segmented-control token，随明暗主题变化。
+
+扫描等待使用三行结果骨架：96×60横幅、标题及项目名短条，复用预览图的原生 shimmer token，逐行错开动画相位。仅辅助技术读出查找状态，结果区标记 aria-busy；无虚构进度，扫描完成直接替换，沿用 reduced-motion 静态降级。
+
+未选中分段选项使用 secondary-solid 配色：底板 background-secondary-solid，文字 text-secondary-solid，悬浮和按下分别使用 secondary-solid-hover / active；不再单独混合透明色。选中块保持原生 thumb 样式。
+
+预览加载骨架绝对铺满图片区域，以窄斜向扫光带呈现明确运动，避免宽缓渐变看起来像静态灰块；图片解码完成才替换，失败才显示图标占位。
+
+Custom 地址分类：localhost/回环、IPv4私有网段及链路本地、IPv6私有及链路本地、.local 使用 Local address；公网IP及普通域名使用 External site，不推断访问权限。普通域名不做DNS推断，故内网自定义域名可能归为外部。已有条目读取时同步重新分类。
+
+打开 Project 网页前等待新草稿的 ComposerScope focusComposerNonce 与本次导航一致，避免仅检查输入框存在而误用旧聊天。浏览器打开消息同时携带站点目录（无目录时取项目根目录）作为 cwd。
+
+新版 Sites 位于 `/space/sites`；注入与离开页面的布局判断使用该路由，移除旧 `/sites` 判断。
+标题区通过 New 的语义定位创建入口；按钮容器复用原生 lg secondary Button，不再假设 New 提供 data-variant。

package/features/sites/README.md

@@ -0,0 +1,27 @@
+# Local & Self-hosted Sites
+
+Extends the native Sites page. **Add site** discovers website entries from local Codex project files, including stopped sites, and supplements them with running HTML services. Select candidates with checkboxes and confirm with Add, or use Custom URL to enter an HTTP/HTTPS URL and name. Both modes provide Cancel / Add; Add stays disabled until the selection or required fields are valid.
+
+- Project: opens a native new draft in that project.
+- Projectless chat: reopens the original conversation.
+- External: opens a native projectless draft.
+
+Existing unsent drafts are preserved; opening a site never sends a message. Saved entries remain when the service stops. Missing projects/chats prompt removal and addition from an available project. Project entries have no Edit site action; Custom URL editing only exposes URL and name. Remove from Sites only deletes the local shortcut.
+
+Opening a saved or official site collapses the chat sidebar and uses the native splitter's maximum browser width once. It does not save a new resize preference or continuously override manual dragging.
+
+## Storage and discovery
+
+Project entry identity uses project + directory rather than port. `project-history.json` stores actual MineCodex launch times (`lastStartedAt`) and observed online times (`lastSeenAt`). The UI displays the project name and adds the port in parentheses only when confirmed running. Custom URLs without a project display their address. Historical timestamps are not shown or inferred from file timestamps.
+
+Local records: `sites/sites.json` under the MineCodex application support directory. `MINECODEX_SITES_DATA_DIR` can isolate the store for development. Native OpenAI site records and sharing permissions are not modified.
+
+macOS discovery associates listening processes' working directories with Codex local project roots, then checks HTML responses with bounded time and size. APIs, unrelated processes and redirects are excluded. Simulator preview bridges (`serve-sim` and `swiftui-preview-browser`) are excluded by full process command before any HTTP request: their homepages may execute `simctl` and trigger Xcode installation. Processes whose full command is unavailable are also skipped; manual addition remains available. Windows uses listening-process command lines when they contain a known project path; Windows does not expose the same cwd metadata, so services with relative-only command lines require manual addition. Project file discovery is deterministic code: it recognizes simple Vite / Next dev / Astro dev scripts and package-free directories containing index.html. It traverses up to four levels with a 4,000-directory budget, skipping hidden directories, dependencies and common build outputs. It does not execute config files or use an LLM. External worktrees and remote hosts are not yet included; complex scripts and arbitrary subpath routes remain outside automatic detection. Manual URLs can include paths or self-hosted domains.
+
+Discovery never starts services. Opening a saved stopped site can start a supported, already-installed framework or a loopback-only static server; dependencies are not installed and arbitrary npm scripts are not executed. MineCodex stops only its own launched services when its runtime stops. No external network ranges are scanned, and no pages or thumbnails are uploaded. Discovery candidates and saved custom sites request background screenshots through an isolated headless Chrome/Edge profile. Previews are cached locally by URL in `previews/`, outside the site records, and reused after restart. Capture does not block Add/Remove. Browser absence, unavailable pages, simulator bridges, or capture failure leave the native placeholder; private browser login sessions are not reused. Screenshots currently capture a 960×600 viewport after a bounded render wait, and are not live previews.
+
+## Native UI boundary
+
+The renderer owns `data-mcx-sites` elements; the Local address filter temporarily hides native rows and updates tab selection styling, restoring them on exit. It uses native Sites layout classes, current semantic theme tokens, and the existing Prompts dialog/menu patterns. The route-state and resize adapters depend on native renderer internals and must be verified against app updates. Icon sources: native Sites controls, existing Prompts resources, and the Lucide monitor icon; Lucide license is included in `vendor/`.
+
+弹窗与浮层统一调用 UI 组件库提供的 `config.ui`（由 Runtime Host 注入），共享主题材质、标题、Close 和表单操作区；插件只维护内容及交互。

package/features/sites/codex-feature.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "id": "sites",
+  "version": "0.1.0",
+  "label": {
+    "en": "Local & Self-hosted Sites",
+    "zh-CN": "本地与自托管站点"
+  },
+  "description": {
+    "en": "Discover project web services and open saved sites in their development context.",
+    "zh-CN": "发现项目网页服务，快捷添加，并在对应开发聊天中打开站点。"
+  },
+  "entry": {
+    "kind": "page-script",
+    "script": "src/frontend/entry.mjs",
+    "sourceFactory": "src/injection-source.mjs",
+    "resources": {
+      "icons": "src/frontend/icons.json",
+      "styles": "src/frontend/styles.css"
+    }
+  },
+  "hostActions": [
+    "sites"
+  ],
+  "placement": {
+    "order": 90
+  }
+}

package/features/sites/src/adapters/codex/catalog.mjs

@@ -0,0 +1,26 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+// Codex 的项目目录与数据库结构在此转换为插件目录快照。
+export class CodexCatalog {
+  constructor(codexHome) { this.codexHome=codexHome; this.status={available:false,reason:"not-read"}; }
+  diagnostics() {return {...this.status};}
+  async snapshot() {
+    let state;
+    try { state = JSON.parse(await readFile(path.join(this.codexHome, ".codex-global-state.json"), "utf8")); }
+    catch (error) { if (error.code === "ENOENT") {this.status={available:false,reason:"catalog-state-unavailable"};return { projects: [], threads: [] };} throw error; }
+    this.status={available:true,reason:null};
+    const projects = Object.entries(state["local-projects"] ?? {}).map(([id, p]) => ({ id, name: p.name || id, rootPaths: (p.rootPaths ?? []).filter(r => typeof r === "string") }));
+    const ids = new Set(state["projectless-thread-ids"] ?? []);
+    let threads = [];
+    if (ids.size) {
+      let db;
+      try {
+        db = new DatabaseSync(path.join(this.codexHome, "state_5.sqlite"), { readOnly: true });
+        threads = db.prepare("SELECT id, title, name FROM threads WHERE archived = 0 ORDER BY updated_at DESC").all().filter(t => ids.has(t.id)).map(t => ({ id: t.id, title: t.name || t.title || t.id }));
+      } catch (error) { if (!/unable to open database/i.test(error.message)) throw error; this.status={available:false,reason:"thread-database-unavailable"}; }
+      finally { db?.close(); }
+    }
+    return { projects, threads };
+  }
+}