minecodex 2.0.5 → 2.0.7

package/DESIGN.md

@@ -116,6 +116,7 @@ sidebar规则分状态：
 层级数字是本版本实现值，不是原生CSS设计token；共同约束应集中维护语义角色与挂载点。
 
 - 内容页面位于原生sidebar悬浮层下方；MineCodex当前Page使用20，原生左侧栏40。
+- 通知使用共享 `notification` 挂载角色（当前30），位于内容页面之上、原生sidebar与模态浮层之下；通知业务负责在原生侧栏 peeking 时暂停呈现，不抢占原生导航。
 - 原生Dialog、Dropdown、Popover和Composer Floating父容器通常为50；同数值不保证相同层级，仍受挂载顺序与stacking context影响。
 - 模态层挂在窗口根容器/原生Portal，遮罩覆盖整个窗口；不要嵌在Page的低层级容器内。原生`dialog.showModal()`使用top layer，不能仅用z-index推断。
 - Tooltip使用专用角色与层级；现有MineCodex实现值不是原生标准，不传播为通用token。
@@ -171,3 +172,21 @@ Navbar 在入口右侧居中，使用 `data-minecodex-tooltip-side="right"`；
 ### Library 多选动作条的实色警戒按钮
 
 Codex 26.930.21537（2026-10-02 原生源码与隔离窗口）：Library 选中动作条的 Delete 使用 `dangerSolid`、full radius、toolbar size，图标 16px，警戒底与白色配对文字；hover 使用 danger solid 90% alpha，禁用保留原生 40% opacity 与禁止交互。确认弹窗也使用实色警戒提交按钮。共享 DOM 入口为 `ui.action(button, "danger-solid")`，和既有 soft `danger` 分支并存，不迁移原有功能的语义。通用组件只提供视觉和交互状态，删除确认、隐藏／回收站／永久删除的范围由所属功能明确告知。
+
+## MineCodex 项目品牌图标
+
+项目标识采用实心镐子与 Codex 原生六瓣外圈，唯一可编辑源为 `assets/brand/minecodex-icon.svg`。内部镐子使用 `translate(6.24 6.24) scale(.48)`，纯填充、无描边；保留已确认的留白比例。此标识代表 MineCodex，不替换插件功能图标、模型厂商图标或 Codex 原生应用图标。
+
+内联使用 `currentColor` 跟随所在表面的语义文字色；外链明暗版本分别使用 `#0d0d0d` / `#fafafa`，透明背景。favicon 在 SVG 内通过 `prefers-color-scheme` 适配系统主题，Dashboard 标题通过 CSS mask 跟随页面 `--ink`。明暗版本、favicon 和 README 标识由 `npm run build:icons` 从同一源文件生成，修改几何后运行该命令。
+
+macOS 后台服务 App 在明确的原生资源修订 1.0.1 中接入实心图标，采用浅色圆角底板，保证在明暗系统表面均可辨认。ICNS 来自同一项目几何。安装器先注销旧后台项，再验证并替换 bundle，最后重新注册；不能直接修改已安装的签名资源。后续普通 JavaScript 发布保留此原生 bundle 的签名身份，升级流程与验收边界见 `packages/cli/native/README.md`。
+
+### 账号菜单中的 MineCodex 入口
+
+Codex 26.930.21537（2026-10-03 安装包源码与隔离 DOM）：`profile-dropdown-items` 的 Settings 使用原生菜单行，紧接 Help 前的 Separator；`onOpenSettings` / `settingsShortcut` 标识其行为，外层 `onClose` 关闭账号面板。MineCodex 行插在 Settings 与 Separator 之间，复制脱离 React 的原生行，保留原始 Settings 及其所属层级。左侧使用实心项目标识，右侧使用 Lucide ArrowUpRight；右侧沿用快捷键区域的间距，图标使用原生 Help 右侧箭头的 `text-tertiary` 色与 opacity 1（当前浅色为 rgba(13,13,13,0.482)），不套左侧图标的 0.75 / hover、focus 时 1 的透明度。隔离 DOM 确认左侧普通态与 Settings 同为 rgb(13,13,13)、opacity 0.75，hover / focus 时为 1。
+
+左侧保留原生 CompactSource / LeadingSource 两套结构，只替换其中 SVG；分别继承原生 SVG 的 width、height、class 和 style。菜单标识复用当前 `codex-light-16` / `codex-light-20` 的真实填充外圈路径，引用存于 `assets/brand/references/codex-menu-16.svg` / `codex-menu-20.svg`；内部镐子仍从品牌源生成，由 `npm run build:icons` 输出两套 `packages/ui/assets/minecodex-menu-*.svg`。不能将 24px 品牌外圈缩小代替原生菜单的路径粗细。账号图标沿用原生 `currentColor` 与 `--profile-menu-icon-opacity`（桌面默认 0.75，行 hover / focus 时为 1），不另设固定灰色。此项为安装包源码核对，实际窗口视觉仍待手动验收。
+
+右侧箭头的两段几何合并在单个 SVG path 中一次描边，避免 `currentColor` 自带 alpha 时，两个独立 path 在交叉点重复叠色。保留原资源的形状与端点规则；24px viewBox 中 stroke-width 为 1.575，在 16px 显示时实际线宽 1.05px，与原生 Help 箭头的线条粗细对齐。
+
+入口随账号菜单重建恢复且只出现一次；补齐 Settings → MineCodex → Help 的上下键导航与 Enter/Space，保留原生 Escape 关闭行为。点击经已认证 Host bridge 调用 `mcx gui`；成功后关闭菜单，失败时显示实际错误。原生 UI 手动验收本次因 Computer Use 拒绝操作应用而未完成；隔离 DOM 契约页验证了位置、明暗颜色、点击、键盘、重建去重与清理。

package/README.md

@@ -16,7 +16,7 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **Images** | 在原生 Images 中浏览本地 Image Gen 图片，查看并复制提示词 |
 | **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
 | **Session Status** | 在输入框下方查看当前任务的步骤、观测速度、Token 用量与上下文明细 |
-| **Task Switcher** | 点击聊天标题或标签页前的任务按钮，查看并切换工作中与未读会话 |
+| **Task Switcher** | 会话侧栏不可见时显示通知条，点击跳转到已完成未读或需要处理的会话 |
 
 ## 安装
 
@@ -77,3 +77,7 @@ MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有
 ### Sidebar Focus / 侧栏聚焦
 
 展开侧栏时，点击铃铛与搜索之间的聚焦按钮，保留当前任务路径并收起其他分支。再次点击恢复原先布局；切换任务时跟随路径，手动调整分支时退出聚焦。
+
+### 从账号菜单打开控制台
+
+在 Codex Navbar 底部打开账号菜单，点击 Settings 下方的 **MineCodex ↗**，即可在外部默认浏览器打开本地控制台，等同于 `mcx gui`。macOS 默认 Safari、Chrome/Chromium、Edge、Brave 和 Vivaldi 会定位已有控制台标签页，没有时才新建；首次定位可能需要系统自动化权限。其他浏览器与 Windows 仍由系统打开 URL。

package/apps/dashboard/DESIGN.md

@@ -1,45 +1,67 @@
 # MineCodex Dashboard Design System
 
-## Theme
+The standalone control panel follows the root DESIGN.md semantic color and interaction
+contract. It uses local light/dark tokens because no Codex renderer theme bridge exists here.
 
-The control panel is a restrained Codex-native settings surface. It follows system light/dark
-appearance, uses one system sans family, and reserves accent color for enabled switches, focus,
-and the primary restart action.
+## Layout and reference
 
-## Color
+Reference: VPN Dashboard settings source, inspected 2026-10-03. Its card grid uses a 16px
+radius/gap, top icon and trailing arrow, followed by a title and description. The live URL
+required login; this reference is source-based, not a live visual match.
 
-Use semantic OKLCH tokens rather than brand colors:
+MineCodex uses one centered 1064px column without a sidebar or category groups. The header
+holds the shared brand and appearance control; a runtime notice appears below only when the service needs attention.
+There is no tagline or visible section introduction. Save feedback remains available to screen readers.
+Nine independent cards form a three-column grid, two columns at 960px and one at 600px.
+Each card has an icon and switch at the top, name and purpose below, and a readable actual-state line
+at the bottom of every card. Enabled switches and runtime state remain distinct information. A card is not itself clickable. The footer shows only the MineCodex version
+and adjacent update check (16px gap, regular weight, refresh icon), with persistent update feedback below it. No install path or plugin versions.
 
-- Canvas: neutral near-white / near-black.
-- Surface: one subtle elevation step from the canvas.
-- Ink: high-contrast neutral foreground.
-- Secondary and tertiary ink: still meet AA for their text size.
-- Border: quiet neutral separator.
-- Accent: Codex-like blue used only for action and active state.
-- Success and warning: paired with labels or icons, never color alone.
+## Tokens and components
 
-## Typography
+- Canvas: cool #edf1f7 / deep blue #101722, with a decorative ASCII voxel world.
+- Surface: white / #1b2533, with a hard 3px lower edge for a block-like silhouette; no blur.
+- Border: #d7dfe9 / #334359; blue #3478d4 / #71a8f3 switches and active state accents.
+- Ink, secondary ink, accent, success, warning and danger use the local semantic CSS tokens.
+- `--card-radius`: 8px; `--grid-gap`: 16px; `--card-padding`: 24px.
+- Card minimum height: 216px desktop, 204px mobile; content can grow without clipping.
+- System sans family; pixel brand title 36–64px/700, feature name 16px/600, description 14px/1.65,
+  state metadata 13px/1.5. Each description is one short statement of purpose; remove promotional filler while preserving each feature’s actual state.
+- Feature icons: 24px display size, uniform 2.1-unit stroke in a 24×24 viewBox, matching Prompts. The control-server normalizes only dashboard output; original injected assets stay unchanged.
+- Icons: existing manifest assets, with official Lucide bell, panel-left and globe for
+  Task Switcher, Sidebar Focus and Sites. Lucide ISC license is retained in
+  `packages/ui/assets/lucide-LICENSE.txt`.
+- Checkbox switches expose switch semantics, feature labels, descriptions and state text.
+  Track is 36×21px with a 32px-high label hit area. Pending requests disable only their switch;
+  failures restore the previous value and focus. Enabled and active remain distinct facts.
+- Appearance uses the VPN reference’s two-segment sun/moon capsule (32px segments, 4px gap and padding). A sliding selected circle and aria-pressed expose selection. It initially follows the system; manual choices persist locally.
+- Restart and error notices use a neutral card, colored left edge, status icon, compact copy and trailing action; toast errors share that material. Restart notice appears only for a pending restart. No automatic restart.
+- Update checks retain loading, result and retryable failure states; installation stays with
+  the existing `mcx update` flow.
 
-Use `-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif`. Page title is 20px/600,
-plugin names 15px/600, body text 13px/1.5, and compact metadata 12px. No display type,
-uppercase tracking, or fluid heading sizes.
+## Motion
 
-## Layout
+`--ease-out: cubic-bezier(0.23, 1, 0.32, 1)`. Switch thumb: 180ms transform;
+button press: 140ms transform to scale(0.97). No stagger, card lift, layout motion or continuous
+loading shimmer. Hover is limited to fine pointers. Keyboard actions disable transitions;
+reduced-motion preferences disable movement. Focus rings remain visible in both themes.
 
-The page uses a centered 880px content column with a compact header, one restart notice when
-needed, a vertical plugin settings group, and a low-emphasis diagnostics footer. At narrow widths
-the rows wrap their status and switch controls beneath the copy without horizontal scrolling.
+## Project identity
 
-## Components
+The masthead uses self-hosted Silkscreen Bold (SIL OFL, bundled license in assets/OFL.txt),
+with a stone-colored face, dark outline and stepped text shadow inspired by Minecraft lettering.
+The shared pickaxe mark is 76px desktop / 48px mobile. Body and state text retain the legible
+project sans-serif contract. This is a dashboard-specific visual treatment; the brand geometry
+and other injected plugin UI remain governed by root DESIGN.md.
 
-- Plugin row: icon, name, description, actual-state label, and native checkbox switch.
-- Status dot: always accompanied by readable state text.
-- Restart notice: inline surface between header and plugin group, not a modal.
-- Buttons: one primary restart button and quiet secondary actions with full hover, focus,
-  active, disabled, and loading states.
-- Loading: skeleton rows preserve layout; errors use an inline retry surface.
+Dashboard icons are official Lucide SVGs, covered by packages/ui/assets/lucide-LICENSE.txt.
+All font and icon assets are served locally and included in the npm package.
 
-## Motion
+## ASCII agent world
 
-Use 160–200ms ease-out transitions only for switch position, button feedback, and the restart
-notice appearing. Disable nonessential transitions under `prefers-reduced-motion: reduce`.
+A fixed, pointer-transparent and aria-hidden canvas renders deterministic terraced terrain,
+ASCII water, paths and coding nodes (>_, {}, git, </>, [AI], $). It rotates around its vertical
+axis once every 240 seconds, rendered at at most 20 fps and device pixel ratio capped at 2.
+The world stays behind opaque cards; text and controls never rotate. Reduced motion freezes
+the view, hidden tabs pause the animation. The terrain module has no external dependency
+or network request and does not consume user or session data.

package/apps/dashboard/app.js

@@ -3,13 +3,11 @@ document.documentElement.lang = locale;
 
 const copy = {
   en: {
-    subtitle: "Personal plugins for Codex",
     connecting: "Connecting…",
     runtimeActive: "Active in Codex",
     runtimeStopped: "Runtime unavailable",
     runtimeNotInjected: "Runtime running — restart Codex to apply plugins",
-    plugins: "Plugins",
-    pluginsCopy: "Choose which enhancements appear in Codex.",
+    plugins: "Your extensions",
     restartTitle: "Restart Codex to apply changes",
     restartCopy: "Your plugin choices are saved. Restart when you are ready.",
     restart: "Restart Codex",
@@ -30,10 +28,9 @@ const copy = {
     loadErrorCopy: "Check that the background service is running.",
     retry: "Try again",
     version: "Version",
-    installation: "Installation",
-    runtimeHost: "RuntimeHost",
-    running: "Running",
-    stopped: "Stopped",
+    darkAppearance: "Dark appearance",
+    lightAppearance: "Light appearance",
+    updateFailed: "Couldn’t check for updates. Please try again.",
     checkUpdates: "Check for updates",
     checkingUpdates: "Checking…",
     current: "You’re up to date.",
@@ -43,13 +40,11 @@ const copy = {
     failureDetail: "Health or renderer status could not be confirmed.",
   },
   "zh-CN": {
-    subtitle: "为 Codex 准备的个人插件",
     connecting: "正在连接…",
     runtimeActive: "已在 Codex 中生效",
     runtimeStopped: "运行服务不可用",
     runtimeNotInjected: "运行服务已启动——重启 Codex 以应用插件",
-    plugins: "插件",
-    pluginsCopy: "选择要在 Codex 中启用的增强功能。",
+    plugins: "功能扩展",
     restartTitle: "重启 Codex 以应用更改",
     restartCopy: "插件选择已经保存，可以在准备好后统一重启。",
     restart: "重启 Codex",
@@ -70,10 +65,9 @@ const copy = {
     loadErrorCopy: "请检查后台服务是否正在运行。",
     retry: "重试",
     version: "版本",
-    installation: "安装位置",
-    runtimeHost: "运行服务",
-    running: "运行中",
-    stopped: "已停止",
+    darkAppearance: "深色外观",
+    lightAppearance: "浅色外观",
+    updateFailed: "暂时无法检查更新，请稍后重试。",
     checkUpdates: "检查更新",
     checkingUpdates: "正在检查…",
     current: "当前已是最新版本。",
@@ -85,7 +79,6 @@ const copy = {
 }[locale];
 
 const elements = {
-  subtitle: document.querySelector("#subtitle"),
   runtimeDot: document.querySelector("#runtime-dot"),
   runtimeLabel: document.querySelector("#runtime-label"),
   restartNotice: document.querySelector("#restart-notice"),
@@ -93,7 +86,6 @@ const elements = {
   restartCopy: document.querySelector("#restart-copy"),
   restartButton: document.querySelector("#restart-button"),
   pluginsHeading: document.querySelector("#plugins-heading"),
-  pluginsCopy: document.querySelector("#plugins-copy"),
   saveState: document.querySelector("#save-state"),
   pluginList: document.querySelector("#plugin-list"),
   loadError: document.querySelector("#load-error"),
@@ -102,9 +94,9 @@ const elements = {
   retryButton: document.querySelector("#retry-button"),
   versionLabel: document.querySelector("#version-label"),
   versionValue: document.querySelector("#version-value"),
-  installLabel: document.querySelector("#install-label"),
-  hostLabel: document.querySelector("#host-label"),
-  hostValue: document.querySelector("#host-value"),
+  themeToggle: document.querySelector(".theme-toggle"),
+  themeButtons: [...document.querySelectorAll("[data-theme-choice]")],
+  updateResult: document.querySelector("#update-result"),
   updateButton: document.querySelector("#update-button"),
   toast: document.querySelector("#toast"),
 };
@@ -114,20 +106,16 @@ let toastTimer = null;
 const pendingFeatureIds = new Set();
 
 function applyStaticCopy() {
-  elements.subtitle.textContent = copy.subtitle;
   elements.runtimeLabel.textContent = copy.connecting;
   elements.restartTitle.textContent = copy.restartTitle;
   elements.restartCopy.textContent = copy.restartCopy;
   elements.restartButton.querySelector(".button-label").textContent = copy.restart;
   elements.pluginsHeading.textContent = copy.plugins;
-  elements.pluginsCopy.textContent = copy.pluginsCopy;
   elements.errorTitle.textContent = copy.loadError;
   elements.errorCopy.textContent = copy.loadErrorCopy;
   elements.retryButton.textContent = copy.retry;
   elements.versionLabel.textContent = copy.version;
-  elements.installLabel.textContent = copy.installation;
-  elements.hostLabel.textContent = copy.runtimeHost;
-  elements.updateButton.textContent = copy.checkUpdates;
+  elements.updateButton.querySelector(".button-label").textContent = copy.checkUpdates;
 }
 
 function featureState(feature) {
@@ -164,23 +152,25 @@ function createPluginCard(feature) {
   icon.setAttribute("aria-hidden", "true");
   const image = element("img");
   image.alt = "";
-  image.width = 18;
-  image.height = 18;
+  image.width = 24;
+  image.height = 24;
   icon.append(image);
 
   const pluginCopy = element("div", "plugin-copy");
   const titleLine = element("div", "plugin-title-line");
   const name = element("h3", "plugin-name");
-  const version = element("span", "plugin-version");
-  titleLine.append(name, version);
+  titleLine.append(name);
   const description = element("p", "plugin-description");
   pluginCopy.append(titleLine, description);
 
-  const control = element("div", "plugin-control");
+  const heading = element("div", "plugin-topline");
   const label = element("label", "switch");
   const input = element("input");
   input.type = "checkbox";
   input.name = `feature-${feature.id}`;
+  input.setAttribute("role", "switch");
+  input.setAttribute("aria-describedby", `description-${feature.id} state-${feature.id}`);
+  description.id = `description-${feature.id}`;
   const track = element("span", "switch-track");
   track.setAttribute("aria-hidden", "true");
   label.append(input, track);
@@ -188,9 +178,10 @@ function createPluginCard(feature) {
   const dot = element("span", "status-dot");
   dot.setAttribute("aria-hidden", "true");
   const stateLabel = element("span", "plugin-state-label");
+  stateLabel.id = `state-${feature.id}`;
   pluginState.append(dot, stateLabel);
-  control.append(label, pluginState);
-  card.append(icon, pluginCopy, control);
+  heading.append(icon, label);
+  card.append(heading, pluginCopy, pluginState);
   return card;
 }
 
@@ -199,14 +190,12 @@ function updatePluginCard(card, feature) {
   const input = card.querySelector('input[type="checkbox"]');
   const image = card.querySelector(".plugin-icon img");
   const name = card.querySelector(".plugin-name");
-  const version = card.querySelector(".plugin-version");
   const description = card.querySelector(".plugin-description");
   const dot = card.querySelector(".plugin-state .status-dot");
   const stateLabel = card.querySelector(".plugin-state-label");
   card.dataset.featureId = feature.id;
-  image.src = feature.iconUrl;
+  image.src = `${feature.iconUrl}?v=stroke-2.1`;
   name.textContent = feature.label;
-  version.textContent = feature.version;
   description.textContent = feature.description;
   input.checked = Boolean(feature.enabled);
   input.disabled = pendingFeatureIds.has(feature.id);
@@ -249,13 +238,13 @@ function renderRuntime() {
       && Number(renderer.injectedTargets) > 0,
   );
   const active = runtimeRunning && rendererCurrent;
+  elements.runtimeLabel.closest(".overview").hidden = active;
   elements.runtimeDot.className = `status-dot ${active ? "is-active" : "is-warning"}`;
   elements.runtimeLabel.textContent = active
     ? copy.runtimeActive
     : runtimeRunning
       ? copy.runtimeNotInjected
       : copy.runtimeStopped;
-  elements.hostValue.textContent = runtimeRunning ? copy.running : copy.stopped;
   elements.versionValue.textContent = state?.version ?? "—";
   elements.restartNotice.hidden = !state?.pendingRestart;
 }
@@ -302,6 +291,7 @@ async function load() {
     elements.loadError.hidden = false;
     elements.runtimeDot.className = "status-dot is-warning";
     elements.runtimeLabel.textContent = copy.runtimeStopped;
+    elements.runtimeLabel.closest(".overview").hidden = true;
   }
 }
 
@@ -369,19 +359,45 @@ elements.retryButton.addEventListener("click", () => {
 
 elements.updateButton.addEventListener("click", async () => {
   elements.updateButton.disabled = true;
-  elements.updateButton.textContent = copy.checkingUpdates;
+  elements.updateButton.querySelector(".button-label").textContent = copy.checkingUpdates;
+  elements.updateResult.hidden = true;
   try {
     const response = await fetch("/api/update");
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
     const update = await response.json();
-    showToast(update.available ? copy.updateAvailable(update.latest) : copy.current);
+    elements.updateResult.textContent = update.available ? copy.updateAvailable(update.latest) : copy.current;
+    elements.updateResult.hidden = false;
   } catch {
-    showToast(copy.loadErrorCopy);
+    elements.updateResult.textContent = copy.updateFailed;
+    elements.updateResult.hidden = false;
   } finally {
     elements.updateButton.disabled = false;
-    elements.updateButton.textContent = copy.checkUpdates;
+    elements.updateButton.querySelector(".button-label").textContent = copy.checkUpdates;
   }
 });
 
+const systemTheme = matchMedia("(prefers-color-scheme: dark)");
+let selectedTheme = null;
+try { selectedTheme = localStorage.getItem("minecodex-appearance"); } catch { /* 存储不可用时仍允许本次切换。 */ }
+function applyTheme() {
+  const dark = selectedTheme === "dark" || (selectedTheme !== "light" && systemTheme.matches);
+  document.documentElement.dataset.theme = dark ? "dark" : "light";
+  elements.themeToggle.setAttribute("aria-label", locale === "zh-CN" ? "外观" : "Appearance");
+  for (const button of elements.themeButtons) {
+    button.setAttribute("aria-label", button.dataset.themeChoice === "light" ? copy.lightAppearance : copy.darkAppearance);
+    button.setAttribute("aria-pressed", String(button.dataset.themeChoice === (dark ? "dark" : "light")));
+  }
+}
+elements.themeToggle.addEventListener("click", (event) => {
+  const button = event.target.closest("[data-theme-choice]");
+  if (!button) return;
+  selectedTheme = button.dataset.themeChoice;
+  try { localStorage.setItem("minecodex-appearance", selectedTheme); } catch { /* 保留内存中的选择。 */ }
+  applyTheme();
+});
+systemTheme.addEventListener("change", applyTheme);
+document.addEventListener("keydown", () => { document.documentElement.dataset.input = "keyboard"; });
+document.addEventListener("pointerdown", () => { document.documentElement.dataset.input = "pointer"; });
 applyStaticCopy();
+applyTheme();
 void load();

package/apps/dashboard/assets/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2001 The Silkscreen Project Authors (https://github.com/googlefonts/silkscreen)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/apps/dashboard/assets/info.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <circle cx="12" cy="12" r="10" />
+  <path d="M12 16v-4" />
+  <path d="M12 8h.01" />
+</svg>

package/apps/dashboard/assets/moon.svg

@@ -0,0 +1,13 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401" />
+</svg>

package/apps/dashboard/assets/refresh-cw.svg

@@ -0,0 +1,16 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8" />
+  <path d="M21 3v5h-5" />
+  <path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16" />
+  <path d="M8 16H3v5" />
+</svg>

package/apps/dashboard/assets/sun.svg

@@ -0,0 +1,21 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <circle cx="12" cy="12" r="4" />
+  <path d="M12 2v2" />
+  <path d="M12 20v2" />
+  <path d="m4.93 4.93 1.41 1.41" />
+  <path d="m17.66 17.66 1.41 1.41" />
+  <path d="M2 12h2" />
+  <path d="M20 12h2" />
+  <path d="m6.34 17.66-1.41 1.41" />
+  <path d="m19.07 4.93-1.41 1.41" />
+</svg>

package/apps/dashboard/assets/terrain.js

@@ -0,0 +1,89 @@
+// 纯装饰字符地形；不读取会话数据，也不参与界面交互。
+const canvas = document.querySelector('#agent-world');
+const context = canvas.getContext('2d');
+const reduced = matchMedia('(prefers-reduced-motion: reduce)');
+const points = [];
+const agents = [];
+const heightAt = (x, z) => {
+  const ridge = Math.sin(x * .16 + Math.cos(z * .13)) * 2.4 + Math.cos(z * .21) * 1.8;
+  const island = Math.max(0, 1 - Math.hypot(x / 31, z / 26));
+  return Math.max(-1, Math.floor(island * 9 + ridge - 2));
+};
+for (let z = -28; z <= 28; z++) {
+  for (let x = -32; x <= 32; x++) {
+    const y = heightAt(x, z);
+    if (x * x / 1100 + z * z / 850 > 1.15) continue;
+    const path = Math.abs(z - Math.round(Math.sin(x * .12) * 9)) < 1;
+    points.push({ x, y, z, glyph: y < 0 ? '~' : path ? ':' : y > 5 ? '#' : '+', kind: path ? 'path' : 'land' });
+    // 用垂直字符层显示台阶断面，保留体素地形的厚度。
+    const bottom = Math.min(heightAt(x + 1, z), heightAt(x, z + 1));
+    for (let h = bottom + 1; h < y; h++) points.push({ x, y: h, z, glyph: '|', kind: 'side' });
+  }
+}
+for (const [x, z, label] of [[-20, -9, '>_'], [20, 9, '{ }'], [-8, 20, 'git'], [10, -20, '</>'], [-23, 15, '[AI]'], [24, -12, '$']]) {
+  const base = heightAt(x, z);
+  for (let y = base + 1; y <= base + 5; y++) points.push({ x, y, z, glyph: y === base + 5 ? '[]' : '|', kind: 'node' });
+  agents.push({ x, y: base + 7, z, glyph: label, kind: 'node' });
+}
+let width = 0, height = 0, frame = 0, angle = .65, last = 0;
+let dark = false;
+function resize() {
+  width = innerWidth;
+  height = innerHeight;
+  const ratio = Math.min(devicePixelRatio || 1, 2);
+  canvas.width = Math.round(width * ratio);
+  canvas.height = Math.round(height * ratio);
+  context.setTransform(ratio, 0, 0, ratio, 0, 0);
+  draw();
+}
+function draw() {
+  if (!context || !width) return;
+  context.clearRect(0, 0, width, height);
+  const scale = Math.max(width / 62, height / 42);
+  const sin = Math.sin(angle), cos = Math.cos(angle);
+  const project = (point) => {
+    const x = point.x * cos - point.z * sin;
+    const depth = point.x * sin + point.z * cos;
+    return { ...point, sx: width / 2 + x * scale, sy: height * .58 + (depth * .48 - point.y * .95) * scale, depth };
+  };
+  const visible = [...points, ...agents].map(project).sort((a, b) => a.depth - b.depth);
+  const fontSize = Math.max(10, Math.min(14, scale * .52));
+  context.font = `${fontSize}px ui-monospace, SFMono-Regular, Consolas, monospace`;
+  context.textAlign = 'center';
+  // 同一字符格只保留前景点，避免山体投影堆叠成杂乱笔画。
+  const cells = new Map();
+  for (const point of visible) cells.set(`${Math.round(point.sx / (fontSize * .7))}:${Math.round(point.sy / fontSize)}`, point);
+  for (const p of cells.values()) {
+    if (p.sx < -30 || p.sx > width + 30 || p.sy < -20 || p.sy > height + 20) continue;
+    const alpha = p.kind === 'node' ? .48 : p.kind === 'path' ? .34 : p.kind === 'side' ? .14 : .22;
+    context.fillStyle = dark ? `rgba(112,166,245,${alpha})` : `rgba(52,101,174,${alpha})`;
+    context.fillText(p.glyph, p.sx, p.sy);
+  }
+}
+function tick(time) {
+  if (time - last >= 50) {
+    if (last) angle = (angle + Math.min(time - last, 100) * Math.PI * 2 / 240000) % (Math.PI * 2);
+    last = time;
+    draw();
+  }
+  frame = requestAnimationFrame(tick);
+}
+function syncMotion() {
+  cancelAnimationFrame(frame);
+  last = 0;
+  if (!document.hidden && !reduced.matches) frame = requestAnimationFrame(tick);
+  else draw();
+}
+function syncTheme() {
+  dark = document.documentElement.dataset.theme === 'dark';
+  draw();
+}
+new MutationObserver(syncTheme).observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
+addEventListener('resize', resize);
+document.addEventListener('visibilitychange', syncMotion);
+reduced.addEventListener('change', syncMotion);
+addEventListener('pagehide', () => cancelAnimationFrame(frame));
+addEventListener('pageshow', syncMotion);
+syncTheme();
+resize();
+syncMotion();