minecodex 2.0.4 → 2.0.6

package/DESIGN.md

@@ -44,7 +44,8 @@ Token 名称是实现依据；括号内数值是本版本观测值。读取实
 | Cancel 等取消操作（`ghost`） | 透明、无描边；hover 才出现底色 | `--color-text-secondary`、`--color-background-primary-ghost-hover` |
 | 有实际功能的次级操作（outline，现有API tone为`secondary`） | 透明底、内描边 | `--color-text-primary`、`--color-border-primary-outline`、`--color-background-primary-outline-hover` |
 | 主操作（solid，现有API tone为`primary`） | 实色底与配对文字色 | `--color-background-primary-solid`、`--color-text-primary-solid`、`--color-background-primary-solid-hover` |
-| 警戒操作（现有`danger`） | 警戒色，独立于主操作；插件负责确认业务 | `--color-background-danger-soft-alpha`、`--color-background-danger-soft-alpha-hover`、`--color-text-danger` |
+| 轻量警戒操作（现有`danger`） | 警戒色，独立于主操作；插件负责确认业务 | `--color-background-danger-soft-alpha`、`--color-background-danger-soft-alpha-hover`、`--color-text-danger` |
+| 实色警戒操作（`danger-solid`；原生 React 为 `dangerSolid`） | 用于明确的删除／移除动作，实色警戒底与配对文字；操作范围和二次确认由业务决定 | `--color-background-danger-solid`、`--color-text-danger-solid`；Library 动作条 hover 为 solid 90% alpha |
 
 尺寸：`--control-size-lg`（36px）、`--control-font-size-md`（13px）、`--font-weight-normal`（原生按钮400）、`--radius-full`。水平 gutter 为 `--control-gutter-md × --control-gutter-pill-scaling`（15.96px），图文 gap 为 `--button-gap-lg`。焦点使用 `--color-ring`；禁用保留语义并阻止 hover 反馈。
 
@@ -65,6 +66,12 @@ Dropdown 的 `--shadow-dropdown-overlay` 当前指向 `--shadow-xl-spread`，该
 
 Composer菜单的锚点是实际输入框主体（当前语义标记 `data-composer-body`），不是包含diff和请求队列的外层Root。挂载位置、可用高度、zoom与碰撞行为沿用对应原生组件，不为修复坐标问题盲目提高z-index。
 
+## Viewer 附属信息面板
+
+Codex 26.930.21537（2026-10-02 原生 File info DOM 与计算样式实测）：viewer 右侧附属信息面板使用不透明 `bg-surface-elevated-secondary`、`rounded-2xl`（20px）和 Electron `elevation-prominent`；没有容器模糊，也不额外叠加 CSS border 或 `shadow-lg`。该 elevation 自带 0.5px 边缘及两层柔和投影，应直接沿用原生 utility。此分支不同于 Dialog、Dropdown 和页面内容面。
+
+标题栏使用固定高度、原生 text-base/semibold 标题及圆形 `button-toolbar` 的 `bg-text/5` 按钮分支，hover 为 `bg-text/10`。面板宽度、viewer 工具栏避让及正文间距由所选原生信息面板的业务布局确定，在功能 DESIGN.md 记录。Images Prompt 采用当前 File info 分支。
+
 ## Page 与 sidebar
 
 页面内容面使用 `--color-surface`，当前不透明、无模糊，`--radius-xl-base`（12px）；外部PageSurface使用 `--app-shell-page-surface-shadow`，当前由 `--elevation-stroke-subtle` 与 `--shadow-card` 组成。区分内容面和窗口外壳，不重复施加阴影。
@@ -76,6 +83,18 @@ sidebar规则分状态：
 | 非peeking sidebar-navigation | `--color-surface` 65%（oklab混合），无CSS模糊、无浮窗阴影；可见桌面程度还取决于窗口材质 |
 | `data-slate-sidebar-peeking=true` | `--app-shell-sidebar-popover-background`强制alpha=1；`--app-shell-sidebar-popover-radius`当前为radius-xl-base减spacing（8px）；`--hairline`、`--app-shell-sidebar-popover-border`内边缘与`--shadow-card` |
 
+### 全页面功能的页面壳选择
+
+后续功能开发独立全页面时，先按页面自身的导航需求选择页面壳。没有专属二级导航的页面默认使用无二级侧栏的 Page 分支，以原生 Projects 为行为参照；只有任务确实需要常驻二级导航时才选择带侧栏的布局。不能因入口来自 Home、Space、Scheduled 就继承它们的常驻二级侧栏。
+
+页面是否带常驻二级侧栏，与用户的侧栏展开／收起偏好是两个独立语义。无二级侧栏页面只保留 Navbar，内容从 Navbar 右侧开始，不调用侧栏收起动作，也不修改用户的展开偏好。悬浮 Home、Space、Scheduled 等入口时，原生二级侧栏仍叠加在页面上，页面内容不移位；鼠标可进入操作，离开后沿用原生退出行为。
+
+页面壳、原生导航适配与恢复由共享 UI 维护，功能只声明所需分支并负责自己的内容。新功能不得复制侧栏状态机、直接切换原生侧栏按钮，或另写隐藏侧栏的 CSS。退出页面时区分返回原页面与用户主动选择原生导航；卸载／禁用时释放页面壳并恢复所属状态。
+
+验收至少覆盖：从 Home、Space、Scheduled 进入时无常驻二级侧栏；原有展开偏好不变；三个入口的悬浮侧栏覆盖页面且可操作，内容不移位；退出、原生导航与卸载恢复正确。
+
+原生依据与当前实现：Codex 26.930.21537 的源码与隔离窗口确认该布局由路由决定。当前注入 Page 借用 `/projects` 作为原生页面壳，关闭时恢复原位置，用户主动选择原生导航时交还路由；这是版本相关的适配实现，不是功能的业务路由规范。后续原生接口变化只更新共享 Adapter，不改变上述页面语义。
+
 保留原生的固定展开、收起与hover状态。hover sidebar应能覆盖注入页面，鼠标能进入操作，移回页面后可正常收起；不要通过页面层级、pointer-events或额外遮罩挡住它。原生overflow和contain切换负责浮出与裁切，插件不复制一套侧栏状态机。
 
 ## 左侧 Navbar
@@ -97,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。
@@ -147,3 +167,22 @@ Navbar 在入口右侧居中，使用 `data-minecodex-tooltip-side="right"`；
 这里的规范名称是稳定的项目映射键。Codex 更新名称时补充原生别名，不能跟着重命名插件消费的项目 token。新增实际使用的语义才增加映射；不预建完整的第三方 token 系统。`native/theme.mjs` 为直接注入容器写入同一快照，Runtime Host 将它传给 iframe；卸载恢复原值。主题变化丢失某个 token 时清除旧项目值，继续使用该组件既有的明确默认值或不可用状态，不复用上一主题颜色。
 
 这些映射不改变原生组件分类、材质分支和 hover sidebar 层级，也不重写原生 Tailwind utility class。插件复用 native Adapter 返回的原生模板；特殊样式使用项目 token，Dialog、Button、Tooltip 等通用表现继续由组件库维护。
+
+
+### 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 安装包源码）：`profile-dropdown-items` 的 Settings 使用原生菜单行，紧接 Help 前的 Separator；`onOpenSettings` / `settingsShortcut` 标识其行为，外层 `onClose` 关闭账号面板。MineCodex 行插在 Settings 与 Separator 之间，复制脱离 React 的原生行，保留原始 Settings 及其所属层级。左侧使用实心项目标识，右侧使用 Lucide ArrowUpRight，复用 Settings 快捷键区域的 class、间距与 `text-codex-description` 颜色。
+
+入口随账号菜单重建恢复且只出现一次；补齐 Settings → MineCodex → Help 的上下键导航与 Enter/Space，保留原生 Escape 关闭行为。点击经已认证 Host bridge 调用 `mcx gui`；成功后关闭菜单，失败时显示实际错误。原生 UI 手动验收本次因 Computer Use 拒绝操作应用而未完成；隔离 DOM 契约页验证了位置、明暗颜色、点击、键盘、重建去重与清理。

package/README.md

@@ -13,10 +13,10 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **Model Slider** | 更清晰、更顺滑的模型切换面板：具备品牌标识、常用收藏与流畅交互 |
 | **Prompts** | 专页分类管理提示词与调用统计，输入框 Quick Prompts 快速调用 |
 | **Usage Meter** | 在 Help 与 Account 之间显示剩余额度环，悬浮查看周 / 五小时额度，点击进入 Usage 设置 |
-| **Images** | 在原生 Library 图片详情中查看并复制提示词 |
+| **Images** | 在原生 Images 中浏览本地 Image Gen 图片，查看并复制提示词 |
 | **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
 | **Session Status** | 在输入框下方查看当前任务的步骤、观测速度、Token 用量与上下文明细 |
-| **Task Switcher** | 点击聊天标题或标签页前的任务按钮，查看并切换工作中与未读会话 |
+| **Task Switcher** | 会话侧栏不可见时显示通知条，点击跳转到已完成未读或需要处理的会话 |
 
 ## 安装
 
@@ -56,7 +56,7 @@ mcx open
 
 ## 工作原理
 
-MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。Model Slider、Prompts 各自管理操作界面，Images 增强原生 Library 的提示词查看；Session Status 只读汇总本机 Codex 会话事件，Hide Upsell Banner 优化界面展示。所有功能按需开启，关闭后即停止运行。
+MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。Model Slider、Prompts 各自管理操作界面，Images 在原生 Images 中接入本地生成图片和提示词查看；Session Status 只读汇总本机 Codex 会话事件，Hide Upsell Banner 优化界面展示。所有功能按需开启，关闭后即停止运行。
 
 ## 开发
 
@@ -68,6 +68,8 @@ npm run pack:check
 npm run pack:audit
 ```
 
+维护者发布流程见 [GitHub Actions 发布说明](docs/npm-publishing.md)。发布工作流仅允许维护者本人触发，使用 npm 可信发布，无需长期访问令牌。
+
 ## 许可
 
 MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；第三方图标、品牌和兼容资产遵循各自的权利说明，见 [`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md) 与 [`features/session-status/vendor/lucide-LICENSE`](features/session-status/vendor/lucide-LICENSE)。
@@ -75,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>