harness-mix 0.1.2 → 0.1.3

package/src/native-ui/renderer-extension/src/settings/accounts.css

@@ -30,11 +30,87 @@
 }
 
 .settings-harness-account {
-  display: grid;
-  grid-template-columns: minmax(180px, 1fr) minmax(0, 2fr);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 20px;
+  padding: 20px 24px;
+}
+
+.settings-harness-account > .settings-account-row__person {
+  flex: 1 1 280px;
+  min-width: 0;
+}
+
+.settings-harness-account > .settings-account-usage {
+  flex: 1 1 220px;
+  min-width: 0;
+}
+
+.settings-harness-account > .settings-harness-account__actions {
+  flex: 0 0 auto;
+}
+
+.settings-harness-account__badge {
+  display: inline-flex;
   align-items: center;
-  gap: 24px;
-  padding: 24px;
+  padding: 1px 7px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 500;
+  line-height: 16px;
+}
+
+.settings-harness-account__badge--ready {
+  background: rgba(16, 185, 129, 0.12);
+  color: #10b981;
+  border: 1px solid rgba(16, 185, 129, 0.28);
+}
+
+.settings-harness-account__badge--unconfigured {
+  background: rgba(245, 158, 11, 0.12);
+  color: #f59e0b;
+  border: 1px solid rgba(245, 158, 11, 0.28);
+}
+
+.settings-harness-account__badge--not_installed {
+  background: rgba(156, 163, 175, 0.12);
+  color: var(--settings-muted);
+  border: 1px solid rgba(156, 163, 175, 0.25);
+}
+
+.settings-harness-account__config-hint {
+  margin-top: 6px;
+  font-size: 11px;
+  color: var(--settings-muted);
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.settings-harness-account__config-hint code {
+  font-family: ui-monospace, Consolas, monospace;
+  font-size: 11px;
+  background: var(--settings-surface);
+  border: 1px solid var(--settings-border);
+  padding: 1px 5px;
+  border-radius: 4px;
+}
+
+.settings-harness-account__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.settings-harness-account__login-btn {
+  font-size: 12px;
+  padding: 6px 12px;
+  white-space: nowrap;
 }
 
 .settings-harness-account + .settings-harness-account {

package/src/native-ui/renderer-extension/src/settings/connections-page.ts

@@ -27,7 +27,7 @@ export const HARNESS_INSTALL_COMMANDS: Readonly<Partial<Record<ExternalRendererA
   "deepseek-harness": { command: "pip install deepseek-harness" },
   opencode: { command: "npm install -g opencode-ai" },
   grok: { command: "npm install -g @xai/grok-cli" },
-  omp: { command: "npm install -g @oh-my-prompt/omp" },
+  omp: { command: "npm install -g @oh-my-pi/pi-coding-agent" },
   antigravity: { command: "npm install -g @google/antigravity-cli" },
   openclaw: { command: "npm install -g openclaw" },
   hermes: { command: "pip install hermes-agent" },
@@ -76,7 +76,7 @@ export interface RendererConnectionDiagnostics {
   refresh(): Promise<void>;
   openWebUi?(hostId: string, agent: ExternalRendererAgent): Promise<void>;
   inspectHarness?(hostId: string, agent: ExternalRendererAgent): Promise<HarnessInspection>;
-  installHarness?(hostId: string, agent: ExternalRendererAgent): Promise<{ success: boolean; command?: string; stdout?: string; stderr?: string; error?: string }>;
+  installHarness?(hostId: string, agent: ExternalRendererAgent, options?: { terminal?: boolean }): Promise<{ success: boolean; command?: string; stdout?: string; stderr?: string; error?: string }>;
   subscribe(listener: () => void): () => void;
 }
 
@@ -446,52 +446,87 @@ function renderOneClickInstallSection(
   head.append(icon, copy);
 
   const commandInfo = HARNESS_INSTALL_COMMANDS[agent];
+
+  const actions = document.createElement("div");
+  actions.className = "settings-install-actions";
+
+  const feedback = document.createElement("div");
+  feedback.className = "settings-install-feedback";
+
+  const downloadLink = document.createElement("a");
+  downloadLink.href = HARNESS_INSTALL_URLS[agent];
+  downloadLink.target = "_blank";
+  downloadLink.rel = "noopener noreferrer";
+  downloadLink.append(createRendererSettingsIcon("external-link", 15), messages.officialDownload);
+
+  const refreshBtn = document.createElement("button");
+  refreshBtn.type = "button";
+  refreshBtn.className = "settings-command-button settings-command-button--secondary";
+  refreshBtn.append(createRendererSettingsIcon("diagnose", 15), messages.refreshDetection);
+  refreshBtn.addEventListener("click", () => {
+    void diagnostics?.refresh();
+  });
+
+  // If this harness does not have a CLI npm/pip install command (e.g. standalone IDEs/tools like Kiro, Cursor, CodeBuddy, Trae, ZCode)
+  if (!commandInfo) {
+    const manualCard = document.createElement("div");
+    manualCard.className = "settings-install-manual-card";
+    const manualBadge = document.createElement("div");
+    manualBadge.className = "settings-install-manual-badge";
+    manualBadge.textContent = messages.manualInstallTitle;
+    const manualNotice = document.createElement("p");
+    manualNotice.className = "settings-install-manual-notice";
+    manualNotice.textContent = messages.manualInstallNotice;
+
+    const stepsList = document.createElement("ol");
+    stepsList.className = "settings-install-steps";
+    for (const stepText of [messages.manualInstallStep1, messages.manualInstallStep2, messages.manualInstallStep3]) {
+      const stepItem = document.createElement("li");
+      stepItem.textContent = stepText;
+      stepsList.append(stepItem);
+    }
+    manualCard.append(manualBadge, manualNotice, stepsList);
+
+    downloadLink.className = "settings-command-button";
+    actions.append(downloadLink, refreshBtn);
+    section.append(head, manualCard, actions, feedback);
+    container.append(section);
+    return;
+  }
+
+  // Harness has a CLI command:
   const commandBox = document.createElement("div");
   commandBox.className = "settings-install-command-box";
-  commandBox.hidden = !commandInfo;
   const commandLabel = document.createElement("span");
   commandLabel.className = "settings-install-command-label";
   commandLabel.textContent = messages.installCommandLabel;
   const commandRow = document.createElement("div");
   commandRow.className = "settings-install-command-row";
   const code = document.createElement("code");
-  code.textContent = commandInfo?.command ?? `npm install -g ${agent}`;
+  code.textContent = commandInfo.command;
   commandRow.append(code);
   commandBox.append(commandLabel, commandRow);
 
-  const actions = document.createElement("div");
-  actions.className = "settings-install-actions";
+  downloadLink.className = "settings-command-button settings-command-button--secondary";
 
   const installBtn = document.createElement("button");
   installBtn.type = "button";
-  installBtn.hidden = !commandInfo;
-  installBtn.disabled = !commandInfo;
   installBtn.className = "settings-command-button";
   installBtn.append(createRendererSettingsIcon("download", 15), messages.oneClickInstall);
 
+  const terminalBtn = document.createElement("button");
+  terminalBtn.type = "button";
+  terminalBtn.className = "settings-command-button settings-command-button--secondary";
+  terminalBtn.append(createRendererSettingsIcon("external-link", 15), messages.installInTerminal);
+  terminalBtn.title = messages.installInTerminal;
+
   const copyBtn = document.createElement("button");
   copyBtn.type = "button";
-  copyBtn.hidden = !commandInfo;
   copyBtn.className = "settings-command-button settings-command-button--secondary";
   copyBtn.append(createRendererSettingsIcon("copy", 15), messages.copyInstallCommand);
 
-  const downloadLink = document.createElement("a");
-  downloadLink.className = "settings-command-button settings-command-button--secondary";
-  downloadLink.href = HARNESS_INSTALL_URLS[agent];
-  downloadLink.target = "_blank";
-  downloadLink.rel = "noopener noreferrer";
-  downloadLink.append(createRendererSettingsIcon("external-link", 15), messages.officialDownload);
-
-  const refreshBtn = document.createElement("button");
-  refreshBtn.type = "button";
-  refreshBtn.className = "settings-command-button settings-command-button--secondary";
-  refreshBtn.append(createRendererSettingsIcon("diagnose", 15), messages.refreshDetection);
-
-  const feedback = document.createElement("div");
-  feedback.className = "settings-install-feedback";
-
   copyBtn.addEventListener("click", () => {
-    const text = commandInfo?.command ?? `npm install -g ${agent}`;
+    const text = commandInfo.command;
     const clipboard = document.defaultView?.navigator?.clipboard;
     if (clipboard) {
       void clipboard.writeText(text).then(() => {
@@ -503,8 +538,12 @@ function renderOneClickInstallSection(
     }
   });
 
-  refreshBtn.addEventListener("click", () => {
-    void diagnostics?.refresh();
+  terminalBtn.addEventListener("click", () => {
+    feedback.className = "settings-install-feedback settings-feedback-success";
+    feedback.textContent = messages.terminalInstalling;
+    if (diagnostics?.installHarness) {
+      void diagnostics.installHarness(hostId, agent, { terminal: true });
+    }
   });
 
   installBtn.addEventListener("click", () => {
@@ -516,7 +555,7 @@ function renderOneClickInstallSection(
 
     const run = async () => {
       if (!diagnostics?.installHarness) {
-        const text = commandInfo?.command ?? `npm install -g ${agent}`;
+        const text = commandInfo.command;
         await document.defaultView?.navigator?.clipboard?.writeText(text);
         feedback.className = "settings-install-feedback settings-feedback-warning";
         feedback.textContent = messages.oneClickInstallFailed;
@@ -549,7 +588,7 @@ function renderOneClickInstallSection(
     void run();
   });
 
-  actions.append(installBtn, copyBtn, downloadLink, refreshBtn);
+  actions.append(installBtn, terminalBtn, copyBtn, downloadLink, refreshBtn);
   section.append(head, commandBox, actions, feedback);
   container.append(section);
 }

package/src/native-ui/renderer-extension/src/settings/harness-accounts.ts

@@ -1,12 +1,14 @@
 import type { HarnessAccountListResult } from "@codexhost/shared-contracts";
 import { KNOWN_RENDERER_AGENTS } from "../agent-selection-state.js";
 import { createRendererAgentIcon } from "../renderer-agent-icon.js";
+import { createRendererSettingsIcon } from "./icons.js";
 import { renderAccountUsage, type AccountUsageDisplay } from "./accounts-usage.js";
 import type { RendererSettingsPageMountContext } from "./core.js";
 import type { RendererSettingsMessages } from "./localization.js";
 
 export interface RendererHarnessAccountClient {
   listHarnessAccounts?(): Promise<HarnessAccountListResult>;
+  loginHarnessAccount?(input: { harnessId: string }): Promise<{ success: boolean; command?: string | undefined; error?: string | undefined }>;
 }
 
 /** Read-only telemetry, deliberately separate from Codex Account IDs and mutations. */
@@ -22,7 +24,7 @@ export function mountHarnessAccounts(
   section.hidden = true;
   const heading = document.createElement("h2");
   heading.className = "settings-harness-accounts__title";
-  heading.textContent = messages.harnessAccountsTitle;
+  heading.textContent = messages.harnessAccountsPageTitle || messages.harnessAccountsTitle;
   const list = document.createElement("div");
   list.className = "settings-account-list";
   section.append(heading, list);
@@ -31,6 +33,7 @@ export function mountHarnessAccounts(
   let refreshing = false;
   let query = "";
   let display: AccountUsageDisplay = "remaining";
+  let refresh: () => Promise<void>;
 
   const render = (): void => {
     section.hidden = accounts.length === 0;
@@ -71,14 +74,44 @@ export function mountHarnessAccounts(
         plan.textContent = account.plan;
         metadata.append(plan);
       }
+      if (account.status) {
+        if (accountName || account.plan) {
+          const separator = document.createElement("span");
+          separator.textContent = "·";
+          separator.setAttribute("aria-hidden", "true");
+          metadata.append(separator);
+        }
+        const statusBadge = document.createElement("span");
+        statusBadge.className = `settings-harness-account__badge settings-harness-account__badge--${account.status}`;
+        statusBadge.textContent =
+          account.status === "ready"
+            ? messages.harnessAccountStatusReady
+            : account.status === "not_installed"
+              ? messages.harnessAccountStatusNotInstalled
+              : messages.harnessAccountStatusUnconfigured;
+        metadata.append(statusBadge);
+      }
       if (metadata.childElementCount) identity.append(metadata);
-      const usage = renderAccountUsage(
-        document,
-        { status: "ready", credits: account.credits },
-        messages,
-        display,
-        () => undefined,
-      );
+      if (account.configHint) {
+        const configHint = document.createElement("div");
+        configHint.className = "settings-harness-account__config-hint";
+        configHint.title = account.configHint;
+        const label = document.createElement("span");
+        label.textContent = `${messages.harnessAccountConfigGuide}: `;
+        const code = document.createElement("code");
+        code.textContent = account.configHint;
+        configHint.append(label, code);
+        identity.append(configHint);
+      }
+      const usage = account.credits
+        ? renderAccountUsage(
+            document,
+            { status: "ready", credits: account.credits },
+            messages,
+            display,
+            () => undefined,
+          )
+        : null;
       const person = document.createElement("div");
       person.className = "settings-account-row__person";
       const agent = KNOWN_RENDERER_AGENTS.find((agent) => agent === account.harnessId);
@@ -92,6 +125,32 @@ export function mountHarnessAccounts(
       person.append(identity);
       row.append(person);
       if (usage) row.append(usage);
+      const actions = document.createElement("div");
+      actions.className = "settings-harness-account__actions";
+      if (account.loginCommand) {
+        const loginBtn = document.createElement("button");
+        loginBtn.type = "button";
+        loginBtn.className = "settings-command-button settings-command-button--secondary settings-harness-account__login-btn";
+        loginBtn.append(createRendererSettingsIcon("external-link", 14), messages.harnessAccountLogin);
+        loginBtn.title = account.loginCommand;
+        loginBtn.addEventListener("click", () => {
+          const client = getClient();
+          if (!client?.loginHarnessAccount) return;
+          loginBtn.disabled = true;
+          loginBtn.textContent = messages.harnessAccountLoginStarted;
+          void client.loginHarnessAccount({ harnessId: account.harnessId }).finally(() => {
+            document.defaultView?.setTimeout(() => {
+              loginBtn.disabled = false;
+              loginBtn.replaceChildren(createRendererSettingsIcon("external-link", 14), messages.harnessAccountLogin);
+              void refresh();
+            }, 3000);
+          });
+        });
+        actions.append(loginBtn);
+      }
+      if (actions.childElementCount > 0) {
+        row.append(actions);
+      }
       list.append(row);
     }
     if (accounts.length && !visible.length) {
@@ -101,6 +160,27 @@ export function mountHarnessAccounts(
       list.append(empty);
     }
   };
+  refresh = async (): Promise<void> => {
+    if (refreshing || context.signal.aborted) return;
+    const client = getClient();
+    if (!client?.listHarnessAccounts) return;
+    refreshing = true;
+    onChange();
+    try {
+      const result = await client.listHarnessAccounts();
+      if (!context.signal.aborted) accounts = result.accounts;
+    } catch {
+      // Older Hosts and unavailable authentication have no read-only rows.
+      if (!context.signal.aborted) accounts = [];
+    } finally {
+      refreshing = false;
+      if (!context.signal.aborted) {
+        render();
+        onChange();
+      }
+    }
+  };
+
   return {
     get refreshing() {
       return refreshing;
@@ -110,25 +190,6 @@ export function mountHarnessAccounts(
       display = nextDisplay;
       render();
     },
-    async refresh(): Promise<void> {
-      if (refreshing || context.signal.aborted) return;
-      const client = getClient();
-      if (!client?.listHarnessAccounts) return;
-      refreshing = true;
-      onChange();
-      try {
-        const result = await client.listHarnessAccounts();
-        if (!context.signal.aborted) accounts = result.accounts;
-      } catch {
-        // Older Hosts and unavailable authentication have no read-only rows.
-        if (!context.signal.aborted) accounts = [];
-      } finally {
-        refreshing = false;
-        if (!context.signal.aborted) {
-          render();
-          onChange();
-        }
-      }
-    },
+    refresh,
   };
 }

package/src/native-ui/renderer-extension/src/settings/localization.ts

@@ -172,6 +172,22 @@ export interface RendererSettingsMessages {
   readonly oneClickInstalling: string;
   readonly oneClickInstallSuccess: string;
   readonly oneClickInstallFailed: string;
+  readonly installInTerminal: string;
+  readonly terminalInstalling: string;
+  readonly manualInstallTitle: string;
+  readonly manualInstallNotice: string;
+  readonly manualInstallStep1: string;
+  readonly manualInstallStep2: string;
+  readonly manualInstallStep3: string;
+  readonly harnessAccountsPageTitle: string;
+  readonly harnessAccountsPageDescription: string;
+  readonly harnessAccountLogin: string;
+  readonly harnessAccountLoginStarted: string;
+  readonly harnessAccountConfigGuide: string;
+  readonly harnessAccountStatusReady: string;
+  readonly harnessAccountStatusUnconfigured: string;
+  readonly harnessAccountStatusNotInstalled: string;
+  readonly checkUpdateNow: string;
   readonly installCommandLabel: string;
   readonly copyInstallCommand: string;
   readonly installCommandCopied: string;
@@ -401,6 +417,22 @@ const ENGLISH_MESSAGES: RendererSettingsMessages = Object.freeze({
   oneClickInstalling: "Installing Harness in background...",
   oneClickInstallSuccess: "Installed successfully! Status refreshed.",
   oneClickInstallFailed: "Installation failed. Please try running the command manually.",
+  installInTerminal: "Install in Terminal",
+  terminalInstalling: "Installation launched in a visible terminal window. Click Refresh when done.",
+  manualInstallTitle: "Standalone Application / Manual Install",
+  manualInstallNotice: "This Harness is a standalone desktop application or binary and must be installed via its official installer.",
+  manualInstallStep1: "1. Click the button below to visit the official website and download the installer.",
+  manualInstallStep2: "2. Run the application and complete its authentication login.",
+  manualInstallStep3: "3. Ensure its CLI executable is in your PATH environment variable, then click Refresh.",
+  harnessAccountsPageTitle: "Harness Account Management",
+  harnessAccountsPageDescription: "View and manage login status, credentials, and usage quotas for each native harness. Credentials remain stored locally by each harness.",
+  harnessAccountLogin: "Log In / Authorize",
+  harnessAccountLoginStarted: "Login launched in terminal window. Click Refresh when done.",
+  harnessAccountConfigGuide: "Credential Guide",
+  harnessAccountStatusReady: "Ready",
+  harnessAccountStatusUnconfigured: "Needs Config / Not Logged In",
+  harnessAccountStatusNotInstalled: "Not Installed",
+  checkUpdateNow: "Check for Updates Now",
   installCommandLabel: "Install Command",
   copyInstallCommand: "Copy Command",
   installCommandCopied: "Command Copied",
@@ -635,6 +667,22 @@ const CHINESE_MESSAGES: RendererSettingsMessages = Object.freeze({
   oneClickInstalling: "正在后台安装 Harness……",
   oneClickInstallSuccess: "安装成功！状态已自动刷新。",
   oneClickInstallFailed: "安装失败，请尝试复制下方命令在终端手动运行。",
+  installInTerminal: "在终端中打开安装",
+  terminalInstalling: "已在独立终端窗口启动安装，请在终端完成后点击刷新检测。",
+  manualInstallTitle: "独立安装程序 / 手动安装指引",
+  manualInstallNotice: "此 Harness 为独立客户端程序或二进制工具，不支持通过 npm 一键安装。",
+  manualInstallStep1: "1. 点击下方按钮前往官网下载安装包并完成安装；",
+  manualInstallStep2: "2. 运行应用并在终端中完成该 Harness 的认证登录；",
+  manualInstallStep3: "3. 确保该 CLI 可执行文件已加入系统 PATH 环境变量，然后点击【刷新检测】。",
+  harnessAccountsPageTitle: "Harness 账号与授权管理",
+  harnessAccountsPageDescription: "查看与管理各原生 Harness 的登录状态、授权凭据与模型用量配额。所有认证均保存在本地原生 Harness 中，Harness Mix 绝不代存您的账号密码。",
+  harnessAccountLogin: "登录 / 授权",
+  harnessAccountLoginStarted: "已在终端窗口启动登录认证，请在终端完成后点击刷新状态。",
+  harnessAccountConfigGuide: "凭据配置指引",
+  harnessAccountStatusReady: "已就绪",
+  harnessAccountStatusUnconfigured: "待配置 / 未登录",
+  harnessAccountStatusNotInstalled: "未安装",
+  checkUpdateNow: "立即检查更新",
   installCommandLabel: "推荐安装命令",
   copyInstallCommand: "复制安装命令",
   installCommandCopied: "已复制命令",

package/src/native-ui/renderer-extension/src/settings/pages.ts

@@ -173,6 +173,23 @@ export function aboutPage(messages: RendererSettingsMessages): RendererSettingsP
       const tagline = document.createElement("strong");
       tagline.className = "settings-about-tagline";
       tagline.textContent = messages.aboutTagline;
+      const versionRow = document.createElement("div");
+      versionRow.className = "settings-about-version-row";
+      const versionBadge = document.createElement("span");
+      versionBadge.className = "settings-about-version-badge";
+      versionBadge.textContent = "v0.1.2";
+      const checkUpdateBtn = document.createElement("button");
+      checkUpdateBtn.type = "button";
+      checkUpdateBtn.className = "settings-command-button settings-command-button--secondary";
+      checkUpdateBtn.append(createRendererSettingsIcon("updates", 14), messages.checkUpdateNow);
+      checkUpdateBtn.addEventListener("click", () => {
+        const shell = document.querySelector("[data-codexhost-settings-shell]");
+        const updatesNavBtn = (shell?.shadowRoot ?? document).querySelector<HTMLButtonElement>(
+          'button[data-page-id="updates"]',
+        );
+        updatesNavBtn?.click();
+      });
+      versionRow.append(versionBadge, checkUpdateBtn);
       const introduction = document.createElement("div");
       introduction.className = "settings-about-copy";
       for (const paragraphText of messages.aboutParagraphs) {
@@ -200,14 +217,14 @@ export function aboutPage(messages: RendererSettingsMessages): RendererSettingsP
         repositoryUrl,
       );
       repositorySection.append(openSource, repository);
-      panel.append(product, tagline, introduction, starCallout, repositorySection);
+      panel.append(product, tagline, versionRow, introduction, starCallout, repositorySection);
       context.content.append(heading, panel);
       return undefined;
     },
   });
 }
 
-function updatesPage(
+export function updatesPage(
   messages: RendererSettingsMessages,
   getClient: () => RendererUpdateClient | null,
 ): RendererSettingsPageDefinition {

package/src/native-ui/renderer-extension/src/settings/shell.css

@@ -1390,6 +1390,25 @@ button {
   line-height: 24px;
 }
 
+.settings-about-version-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin: 4px 0 8px;
+}
+
+.settings-about-version-badge {
+  display: inline-flex;
+  align-items: center;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--settings-text);
+  background: var(--settings-surface);
+  border: 1px solid var(--settings-border);
+  padding: 4px 10px;
+  border-radius: 6px;
+}
+
 .settings-about-copy {
   display: grid;
   max-width: 660px;
@@ -2174,3 +2193,46 @@ button {
   margin-top: 2px;
   overflow-wrap: anywhere;
 }
+
+.settings-install-manual-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  background: var(--settings-inset);
+  padding: 12px 14px;
+  border-radius: 8px;
+  border: 1px solid var(--settings-border);
+  margin-top: 6px;
+  margin-bottom: 4px;
+}
+
+.settings-install-manual-badge {
+  display: inline-flex;
+  align-items: center;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--settings-accent, #10a37f);
+  background: var(--settings-accent-subtle, rgba(16, 163, 127, 0.1));
+  padding: 2px 8px;
+  border-radius: 4px;
+  width: fit-content;
+}
+
+.settings-install-manual-notice {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--settings-text);
+  margin: 0;
+}
+
+.settings-install-steps {
+  margin: 0;
+  padding-left: 18px;
+  font-size: 12px;
+  line-height: 20px;
+  color: var(--settings-muted);
+}
+
+.settings-install-steps li {
+  margin-bottom: 2px;
+}

package/src/native-ui/renderer-extension/src/settings/shell.ts

@@ -186,7 +186,7 @@ export function mountRendererSettingsShell(
   let otherSectionAdded = false;
   appendNavigationSection(messages.generalSection);
   for (const definition of resolvedRegistry.pages) {
-    if (definition.id === "about" && !otherSectionAdded) {
+    if ((definition.id === "updates" || definition.id === "about") && !otherSectionAdded) {
       appendNavigationSection(messages.otherSection);
       otherSectionAdded = true;
     }

package/src/native-ui/renderer-extension/test/renderer-collab-cards.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import {
+  parseCollabPayload,
+  formatDiffHtml,
+  installCollabCards,
+} from "../src/renderer-collab-cards.js";
+
+describe("renderer-collab-cards", () => {
+  it("parses collaboration payloads correctly", () => {
+    expect(parseCollabPayload("")).toBeNull();
+    expect(parseCollabPayload("hello world")).toBeNull();
+
+    const payload = {
+      task_id: "task-123",
+      child_thread_id: "thread-child-456",
+      agent_type: "pi",
+      status: "completed",
+    };
+    const text = `Agent 协作 · Pi\n${JSON.stringify(payload)}`;
+    const parsed = parseCollabPayload(text);
+    expect(parsed).not.toBeNull();
+    expect(parsed?.task_id).toBe("task-123");
+    expect(parsed?.child_thread_id).toBe("thread-child-456");
+    expect(parsed?.agent_type).toBe("pi");
+  });
+
+  it("formats diff HTML with color coding", () => {
+    expect(formatDiffHtml("")).toContain("暂无文件改动");
+
+    const diff = `--- a/file.txt\n+++ b/file.txt\n@@ -1,3 +1,3 @@\n-old line\n+new line\n context`;
+    const html = formatDiffHtml(diff);
+    expect(html).toContain("+new line");
+    expect(html).toContain("-old line");
+    expect(html).toContain("#22c55e1a");
+    expect(html).toContain("#ef44441a");
+  });
+
+  it("handles environment safely when document is not in global scope", () => {
+    const control = installCollabCards();
+    expect(typeof control.scan).toBe("function");
+    expect(typeof control.dispose).toBe("function");
+    control.scan();
+    control.dispose();
+  });
+});

package/src/native-ui/renderer-extension/test/renderer-model-client.test.ts

@@ -306,6 +306,7 @@ describe("Renderer fixed Model request client", () => {
       "listHarnessSessions",
       "listSessionImportSources",
       "listThreadOwnership",
+      "loginHarnessAccount",
       "messageThread",
       "openHarnessWebUi",
       "readUpdateStatus",