neko-harness 0.2.8 → 0.2.9

package/dist/client/index.html

@@ -9,7 +9,7 @@
 			href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'%3E%3Crect width='100' height='100' rx='26' fill='%23ffb7c5'/%3E%3Ctext x='50' y='70' font-size='58' text-anchor='middle' fill='%23ffffff' font-family='sans-serif' font-weight='bold'%3En%3C/text%3E%3C/svg%3E"
 		/>
 		<title>neko harness</title>
-		<script type="module" crossorigin src="/assets/index-BJ4XDkf5.js"></script>
+		<script type="module" crossorigin src="/assets/index-BKYqZ61y.js"></script>
 		<link rel="stylesheet" crossorigin href="/assets/index-BwqDUlvt.css">
 	</head>
 	<body>

package/dist/gateway.js

@@ -2,7 +2,7 @@
 // @bun
 
 // packages/gateway/src/cli-args.ts
-var GATEWAY_USAGE = `\u7528\u6CD5: main.ts [\u9009\u9879]
+var GATEWAY_USAGE = `\u7528\u6CD5: neko serve [\u9009\u9879]
 
 \u9009\u9879:
   --host <ip>          WebSocket \u76D1\u542C\u5730\u5740\uFF08\u9ED8\u8BA4 127.0.0.1\uFF0C\u4EC5\u672C\u673A\uFF09
@@ -2707,7 +2707,7 @@ import { dirname as dirname5, join as join7 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // packages/core/src/application-version.ts
-var RUNNING_VERSION = "0.2.8";
+var RUNNING_VERSION = "0.2.9";
 var APPLICATION_PROTOCOL = 1;
 function stableVersion(value) {
   return typeof value === "string" && /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(value) && value.split(".").every((n) => Number.isSafeInteger(Number(n)));
@@ -4955,7 +4955,7 @@ if (gateway.socketPath !== undefined)
   console.log(`  Unix socket: ${gateway.socketPath}`);
 if (gateway.wsUrl !== undefined)
   console.log(`  WebSocket:   ${gateway.wsUrl}`);
-console.log("Ctrl-C \u505C\u6B62\u3002");
+console.log("\u6309 Ctrl+C \u505C\u6B62\u3002");
 var stopping = false;
 var stop = () => {
   if (stopping)

package/dist/neko.js

@@ -79,7 +79,7 @@ function updateAction(input) {
     return "install";
   return "none";
 }
-var RUNNING_VERSION = "0.2.8", APPLICATION_PROTOCOL = 1, ApplicationProtocolError;
+var RUNNING_VERSION = "0.2.9", APPLICATION_PROTOCOL = 1, ApplicationProtocolError;
 var init_application_version = __esm(() => {
   ApplicationProtocolError = class ApplicationProtocolError extends Error {
     constructor() {
@@ -3115,39 +3115,39 @@ var init_palette = __esm(() => {
     "syntaxPunctuation"
   ];
   DARK_PALETTE = {
-    panel: { bg: "#38313C" },
-    selection: { bg: "#523349", fg: "#FFFFFF", bold: true },
-    userBg: { bg: tianyi.s900 },
-    toolPendingBg: { bg: "#2C2733" },
-    toolSuccessBg: { bg: "#223128" },
-    toolErrorBg: { bg: "#382631" },
-    codeBg: { bg: "#222A38" },
-    accent: { fg: sakura.s300 },
-    model: { fg: tianyi.s300 },
-    muted: { fg: ink.s400 },
-    dim: { fg: ink.s500 },
-    thinking: { fg: "#93A1B5", italic: true },
-    ok: { fg: "#9DCB9A" },
-    warning: { fg: "#FFC79B" },
-    error: { fg: "#FF8FA3" },
-    userText: { fg: ink.s50 },
-    toolTitle: { fg: sakura.s200 },
-    toolOutput: { fg: ink.s400 },
-    codeFg: { fg: sakura.s200 },
-    border: { fg: ink.s600 },
-    borderMuted: { fg: ink.s700 },
-    diffAdded: { fg: "#9DCB9A" },
-    diffRemoved: { fg: "#FF8FA3" },
-    diffContext: { fg: ink.s500 },
-    syntaxComment: { fg: ink.s500, italic: true },
-    syntaxKeyword: { fg: sakura.s300, bold: true },
-    syntaxFunction: { fg: sakura.s200 },
-    syntaxVariable: { fg: ink.s100 },
-    syntaxString: { fg: tianyi.s200 },
-    syntaxNumber: { fg: tianyi.s300 },
-    syntaxType: { fg: tianyi.s300 },
-    syntaxOperator: { fg: ink.s300 },
-    syntaxPunctuation: { fg: ink.s400 }
+    panel: { bg: "#24283B", fg: "#C0CAF5" },
+    selection: { bg: "#343B58", fg: "#E1E7FF", bold: true },
+    userBg: { bg: "#292E42", fg: "#C0CAF5" },
+    toolPendingBg: { bg: "#222638", fg: "#C0CAF5" },
+    toolSuccessBg: { bg: "#232C32", fg: "#C0CAF5" },
+    toolErrorBg: { bg: "#302735", fg: "#C0CAF5" },
+    codeBg: { bg: "#1A1B26", fg: "#C0CAF5" },
+    accent: { fg: "#7AA2F7" },
+    model: { fg: "#7DCFFF" },
+    muted: { fg: "#A9B1D6" },
+    dim: { fg: "#9AA5CE" },
+    thinking: { fg: "#9AA5CE", italic: true },
+    ok: { fg: "#9ECE6A" },
+    warning: { fg: "#E0AF68" },
+    error: { fg: "#F7768E" },
+    userText: { fg: "#C0CAF5" },
+    toolTitle: { fg: "#7AA2F7" },
+    toolOutput: { fg: "#C0CAF5" },
+    codeFg: { fg: "#C0CAF5" },
+    border: { fg: "#737DA2" },
+    borderMuted: { fg: "#545E7C" },
+    diffAdded: { fg: "#9ECE6A" },
+    diffRemoved: { fg: "#F7768E" },
+    diffContext: { fg: "#9AA5CE" },
+    syntaxComment: { fg: "#8993B3", italic: true },
+    syntaxKeyword: { fg: "#BB9AF7", bold: true },
+    syntaxFunction: { fg: "#7AA2F7" },
+    syntaxVariable: { fg: "#C0CAF5" },
+    syntaxString: { fg: "#9ECE6A" },
+    syntaxNumber: { fg: "#FF9E64" },
+    syntaxType: { fg: "#7DCFFF" },
+    syntaxOperator: { fg: "#89DDFF" },
+    syntaxPunctuation: { fg: "#A9B1D6" }
   };
   LIGHT_PALETTE = {
     panel: { bg: ink.s50 },
@@ -3187,7 +3187,42 @@ var init_palette = __esm(() => {
 });
 
 // packages/tui/src/theme/slots.ts
-import { getTerminalColorMode, parseColor, styleText } from "@earendil-works/pi-tui";
+import {
+  backgroundAnsi,
+  foregroundAnsi,
+  getTerminalColorMode,
+  parseColor,
+  styleText
+} from "@earendil-works/pi-tui";
+function surfaceText(text, fg, bg) {
+  return text.replace(/\x1b\[([0-9;:]*)m/g, (sequence, parameters) => {
+    const codes = parameters.split(";");
+    let resetFg = false;
+    let resetBg = false;
+    for (let i = 0;i < codes.length; i++) {
+      const code = Number(codes[i].split(":")[0]);
+      if (code === 0) {
+        resetFg = true;
+        resetBg = true;
+      } else if (code === 39)
+        resetFg = true;
+      else if (code === 49)
+        resetBg = true;
+      else if (code === 38 || code === 48) {
+        if (code === 38)
+          resetFg = false;
+        else
+          resetBg = false;
+        if (!codes[i].includes(":"))
+          i += codes[i + 1] === "2" ? 4 : codes[i + 1] === "5" ? 2 : 0;
+      } else if (code >= 30 && code <= 37 || code >= 90 && code <= 97)
+        resetFg = false;
+      else if (code >= 40 && code <= 47 || code >= 100 && code <= 107)
+        resetBg = false;
+    }
+    return sequence + (resetFg ? fg : "") + (resetBg ? bg : "");
+  });
+}
 function createTheme(palette) {
   const colorCache = new Map;
   const colorOf = (hex) => {
@@ -3201,14 +3236,19 @@ function createTheme(palette) {
   const theme = {};
   for (const name of SLOT_NAMES) {
     const style = palette[name];
-    theme[name] = (text) => styleText(text, {
-      ...style.fg !== undefined ? { fg: colorOf(style.fg) } : {},
-      ...style.bg !== undefined ? { bg: colorOf(style.bg) } : {},
-      ...style.bold !== undefined ? { bold: style.bold } : {},
-      ...style.italic !== undefined ? { italic: style.italic } : {},
-      ...style.strikethrough !== undefined ? { strikethrough: style.strikethrough } : {},
-      ...style.underline !== undefined ? { underline: style.underline } : {}
-    }, getTerminalColorMode());
+    theme[name] = (text) => {
+      const mode = getTerminalColorMode();
+      if (palette === DARK_PALETTE && style.fg && style.bg)
+        text = surfaceText(text, foregroundAnsi(colorOf(style.fg), mode), backgroundAnsi(colorOf(style.bg), mode));
+      return styleText(text, {
+        ...style.fg !== undefined ? { fg: colorOf(style.fg) } : {},
+        ...style.bg !== undefined ? { bg: colorOf(style.bg) } : {},
+        ...style.bold !== undefined ? { bold: style.bold } : {},
+        ...style.italic !== undefined ? { italic: style.italic } : {},
+        ...style.strikethrough !== undefined ? { strikethrough: style.strikethrough } : {},
+        ...style.underline !== undefined ? { underline: style.underline } : {}
+      }, mode);
+    };
   }
   return theme;
 }
@@ -12886,6 +12926,7 @@ var THINKING_COLLAPSED_LABEL = "\u2727 Thinking\u2026 (click to expand)", Assist
 var init_assistant_message = __esm(() => {
   init_theme();
   AssistantMessageComponent = class AssistantMessageComponent extends Container {
+    #renderTheme = getActiveThemeMode();
     #lastContent;
     #isStreaming = false;
     #thinkingExpanded = false;
@@ -12896,6 +12937,10 @@ var init_assistant_message = __esm(() => {
         this.updateContent(content, isStreaming);
     }
     render(width) {
+      if (this.#renderTheme !== getActiveThemeMode()) {
+        this.#renderTheme = getActiveThemeMode();
+        this.#rebuild();
+      }
       this.#renderWidth = width;
       return super.render(width);
     }
@@ -13748,8 +13793,46 @@ var init_picker = __esm(() => {
   init_theme();
 });
 
+// packages/tui/src/components/themed-text.ts
+import { Text as Text3, TruncatedText } from "@earendil-works/pi-tui";
+
+class ThemedTruncatedText {
+  #content;
+  #paddingX;
+  #paddingY;
+  constructor(content, paddingX = 1, paddingY = 0) {
+    this.#content = content;
+    this.#paddingX = paddingX;
+    this.#paddingY = paddingY;
+  }
+  invalidate() {}
+  render(width) {
+    return new TruncatedText(this.#content(), this.#paddingX, this.#paddingY).render(width);
+  }
+}
+var ThemedText;
+var init_themed_text = __esm(() => {
+  ThemedText = class ThemedText extends Text3 {
+    #raw;
+    #color;
+    constructor(text, color, paddingX = 1, paddingY = 0) {
+      super("", paddingX, paddingY);
+      this.#raw = text;
+      this.#color = color;
+    }
+    setText(text) {
+      this.#raw = text;
+      this.invalidate();
+    }
+    render(width) {
+      super.setText(this.#color(this.#raw));
+      return super.render(width);
+    }
+  };
+});
+
 // packages/tui/src/components/tool-execution.ts
-import { Box, Container as Container3, MouseRegion as MouseRegion2, Text as Text3 } from "@earendil-works/pi-tui";
+import { Box, Container as Container3, MouseRegion as MouseRegion2, Text as Text4 } from "@earendil-works/pi-tui";
 function currentToolFrame() {
   return SPINNER_FRAMES[spinnerFrame];
 }
@@ -13789,6 +13872,7 @@ var init_tool_execution = __esm(() => {
   init_theme();
   SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
   ToolExecutionComponent = class ToolExecutionComponent extends Container3 {
+    #renderTheme = getActiveThemeMode();
     #state;
     #expanded = false;
     #box;
@@ -13796,12 +13880,19 @@ var init_tool_execution = __esm(() => {
     constructor(state) {
       super();
       this.#state = state;
-      this.#text = new Text3("", 0, 0);
+      this.#text = new Text4("", 0, 0);
       this.#box = new Box(1, 0, theme.toolPendingBg);
       this.#box.addChild(new MouseRegion2(this.#text, (event) => this.#onClick(event)));
       this.addChild(this.#box);
       this.rebuild();
     }
+    render(width) {
+      if (this.#renderTheme !== getActiveThemeMode()) {
+        this.#renderTheme = getActiveThemeMode();
+        this.rebuild();
+      }
+      return super.render(width);
+    }
     get isRunning() {
       return this.#state.phase === "running";
     }
@@ -13859,11 +13950,12 @@ ${theme.error(state.note)}`;
 });
 
 // packages/tui/src/components/user-message.ts
-import { Container as Container4, Markdown as Markdown2, MouseRegion as MouseRegion3, Text as Text4 } from "@earendil-works/pi-tui";
+import { Container as Container4, Markdown as Markdown2, MouseRegion as MouseRegion3, Text as Text5 } from "@earendil-works/pi-tui";
 var UserMessageComponent;
 var init_user_message = __esm(() => {
   init_theme();
   UserMessageComponent = class UserMessageComponent extends Container4 {
+    #renderTheme = getActiveThemeMode();
     #text;
     #skill;
     #defaultImagePrompt;
@@ -13884,6 +13976,10 @@ var init_user_message = __esm(() => {
       this.#rebuild();
     }
     render(width) {
+      if (this.#renderTheme !== getActiveThemeMode()) {
+        this.#renderTheme = getActiveThemeMode();
+        this.#rebuild();
+      }
       const bar = theme.userBg(theme.accent("\u258D"));
       return super.render(Math.max(1, width - 1)).map((line) => `${bar}${line}`);
     }
@@ -13891,14 +13987,14 @@ var init_user_message = __esm(() => {
       this.clear();
       const prompt = this.#defaultImagePrompt;
       if (prompt) {
-        this.addChild(new MouseRegion3(new Text4(theme.dim(`${this.#expanded ? "v" : ">"} Default image prompt \xB7 Click to ${this.#expanded ? "hide" : "view"}`), 1, 0, theme.userBg), (event) => {
+        this.addChild(new MouseRegion3(new Text5(theme.dim(`${this.#expanded ? "v" : ">"} Default image prompt \xB7 Click to ${this.#expanded ? "hide" : "view"}`), 1, 0, theme.userBg), (event) => {
           if (event.type !== "click" || event.button !== "left")
             return;
           this.setExpanded(!this.#expanded);
           return { handled: true };
         }));
         if (this.#expanded)
-          this.addChild(new Text4(prompt.text, 1, 0, theme.userBg));
+          this.addChild(new Text5(prompt.text, 1, 0, theme.userBg));
         if (!this.#text.trim())
           return;
       }
@@ -13908,7 +14004,7 @@ var init_user_message = __esm(() => {
         const preview = args.length > 100 ? `${args.slice(0, 99)}\u2026` : args;
         const head = `${theme.toolTitle(`\u2726 skill:${invocation.name}`)}${preview ? ` ${theme.userText(preview)}` : ""}`;
         const source = theme.dim(`skill body from ${invocation.location} (collapsed)`);
-        this.addChild(new Text4(`${head}
+        this.addChild(new Text5(`${head}
 ${source}`, 1, 0, theme.userBg));
         return;
       }
@@ -14002,6 +14098,21 @@ async function queryTerminalMode(ui, onLateReply) {
   }
   return modeFromColors(colors) ?? detectColorFgBgMode() ?? "light";
 }
+function followTerminalTheme(ui, apply) {
+  let active = true;
+  const accept = (mode) => {
+    if (active)
+      apply(mode);
+  };
+  ui.setTerminalColorSchemeNotifications(true);
+  const unsubscribe = ui.onTerminalColorSchemeChange(accept);
+  queryTerminalMode(ui, accept).then(accept, () => {});
+  return () => {
+    active = false;
+    unsubscribe();
+    ui.setTerminalColorSchemeNotifications(false);
+  };
+}
 var THEME_QUERY_TIMEOUT_MS = 100;
 
 // packages/core/src/file-mentions.ts
@@ -16822,7 +16933,7 @@ var init_image_input = __esm(() => {
 });
 
 // packages/tui/src/layout.ts
-import { Text as Text5, VStack } from "@earendil-works/pi-tui";
+import { Text as Text6, VStack } from "@earendil-works/pi-tui";
 function createAppLayout(parts) {
   const normal = (v) => {
     parts.footer.panelOpen = parts.panelOpen();
@@ -16832,7 +16943,7 @@ function createAppLayout(parts) {
   };
   return new VStack([
     {
-      component: new Text5("Terminal too small. Resize to 40x10. Ctrl+C Exit", 0, 0),
+      component: new Text6("Terminal too small. Resize to 40x10. Ctrl+C Exit", 0, 0),
       visible: (v) => !normal(v),
       grow: 1
     },
@@ -16840,7 +16951,7 @@ function createAppLayout(parts) {
     { component: parts.panel, basis: 0, grow: 1, minSize: 1, visible: (v) => normal(v) && parts.panelOpen() },
     { component: parts.notices, maxSize: 1, shrink: 0, visible: normal },
     {
-      component: parts.busy ?? new Text5("", 0, 0),
+      component: parts.busy ?? new Text6("", 0, 0),
       maxSize: 2,
       shrink: 0,
       visible: (v) => normal(v) && (parts.busyVisible?.() ?? false)
@@ -17016,6 +17127,7 @@ class SkillDetailView {
 
 class SkillPreviewView {
   #header = null;
+  #renderTheme = getActiveThemeMode();
   #markdown = null;
   #error = "";
   #offset = 0;
@@ -17026,7 +17138,7 @@ class SkillPreviewView {
   constructor(name, client, panel) {
     this.#panel = panel;
     client.skillMarket.preview({ name }).then((preview) => {
-      this.#header = [`${theme.dim("files:")} ${preview.files.join("  ")}`, ""];
+      this.#header = preview.files.join("  ");
       this.#markdown = new Markdown3(preview.body, 0, 0, getMarkdownTheme());
       this.#panel.changed();
     }).catch((error) => {
@@ -17046,7 +17158,11 @@ class SkillPreviewView {
   lines(width, height) {
     if (this.#markdown === null || this.#header === null)
       return [this.#error !== "" ? theme.error(`Error: ${this.#error}`) : theme.dim("Loading preview...")];
-    const flat = [...this.#header, ...this.#markdown.render(width)];
+    if (this.#renderTheme !== getActiveThemeMode()) {
+      this.#renderTheme = getActiveThemeMode();
+      this.#markdown.invalidate();
+    }
+    const flat = [`${theme.dim("files:")} ${this.#header}`, "", ...this.#markdown.render(width)];
     const max = Math.max(0, flat.length - height);
     this.#offset = Math.min(this.#offset, max);
     return flat.slice(this.#offset, this.#offset + height);
@@ -17083,7 +17199,7 @@ var init_skill_market_ui = __esm(() => {
 });
 
 // packages/tui/src/version-ui.ts
-import { matchesKey as matchesKey6, Text as Text6 } from "@earendil-works/pi-tui";
+import { matchesKey as matchesKey6, Text as Text7 } from "@earendil-works/pi-tui";
 function actionFor(state, installed, runningVersion) {
   const action = updateAction({ gateway: state, frontend: runningVersion, installed });
   return action === "install" && !newer(state?.latestVersion, runningVersion) ? "none" : action;
@@ -17156,7 +17272,7 @@ class VersionDetail {
     this.body = body;
   }
   lines(width, height) {
-    const lines = new Text6(this.body, 0, 0).render(width);
+    const lines = new Text7(this.body, 0, 0).render(width);
     this.#offset = Math.min(this.#offset, Math.max(0, lines.length - height));
     return lines.slice(this.#offset, this.#offset + height);
   }
@@ -17245,8 +17361,6 @@ import {
   matchesKey as matchesKey7,
   ProcessTerminal,
   ScrollView,
-  Text as Text7,
-  TruncatedText,
   TuiAltScreen
 } from "@earendil-works/pi-tui";
 
@@ -17467,7 +17581,7 @@ class NekoTuiApp {
       const notice = versionNotice(this.#gateway.client.application.info.value ?? null, installed);
       this.#versionNotice.clear();
       if (notice)
-        this.#versionNotice.addChild(new TruncatedText(formatNotice(notice, "info"), 1, 0));
+        this.#versionNotice.addChild(new ThemedTruncatedText(() => formatNotice(notice, "info"), 1, 0));
       this.#ui.requestRender();
     };
     this.#versionStop = this.#gateway.client.application.info.subscribe(() => void refreshVersion());
@@ -17797,7 +17911,7 @@ class NekoTuiApp {
     const options = [
       { value: "auto", label: "Auto", description: "Follow the terminal background" },
       { value: "light", label: "Light \xB7 sakura-day", description: "Brand light theme" },
-      { value: "dark", label: "Dark \xB7 sakura-night", description: "Brand dark theme" }
+      { value: "dark", label: "Dark", description: "Cool dark theme" }
     ];
     const ready = this.#panel.show("Theme", async () => options.map((option) => ({
       value: option.value,
@@ -17868,7 +17982,7 @@ class NekoTuiApp {
       this.#ui.requestRender();
     }, 5000);
     this.#notices.clear();
-    this.#notices.addChild(new TruncatedText(formatNotice(text, level), 1, 0));
+    this.#notices.addChild(new ThemedTruncatedText(() => formatNotice(text, level), 1, 0));
     this.#ui.requestRender();
   }
   scheduleApply() {
@@ -18009,7 +18123,7 @@ class NekoTuiApp {
       this.#items.set(item.key, { kind: "tool", component });
       return;
     }
-    const component = new Text7(theme.dim(item.text), 1, 0);
+    const component = new ThemedText(item.text, theme.dim, 1, 0);
     this.#imageTranscript.addItem(component);
     this.#items.set(item.key, { kind: "system", component });
   }
@@ -18027,7 +18141,7 @@ class NekoTuiApp {
       return;
     }
     if (entry.kind === "system" && item.type === "system") {
-      entry.component.setText(theme.dim(item.text));
+      entry.component.setText(item.text);
     }
   }
   #toolCard(call) {
@@ -18116,13 +18230,10 @@ class NekoTuiApp {
   #startThemeDetection() {
     if (this.#themePreference !== "auto" || this.#terminalSchemeUnsubscribe !== undefined)
       return;
-    this.#ui.setTerminalColorSchemeNotifications(true);
-    this.#terminalSchemeUnsubscribe = this.#ui.onTerminalColorSchemeChange((scheme) => {
-      this.#applyThemeMode(scheme);
+    this.#terminalSchemeUnsubscribe = followTerminalTheme(this.#ui, (mode) => {
+      if (!this.#exitStarted && this.#themePreference === "auto")
+        this.#applyThemeMode(mode);
     });
-    queryTerminalMode(this.#ui, (late) => {
-      this.#applyThemeMode(late);
-    }).then((mode) => this.#applyThemeMode(mode), () => {});
   }
   #applyThemeMode(mode) {
     if (this.#exitStarted || mode === getActiveThemeMode())
@@ -18208,6 +18319,7 @@ var init_tui = __esm(() => {
   init_login();
   init_notice();
   init_picker();
+  init_themed_text();
   init_tool_execution();
   init_user_message();
   init_welcome();
@@ -18293,19 +18405,19 @@ function parseArgs(argv) {
     ...theme !== undefined ? { theme } : {}
   };
 }
-var USAGE = `Usage: neko tui [options]
+var USAGE = `\u7528\u6CD5: neko tui [\u9009\u9879]
 
-Options:
-  --cwd <dir>          Workspace (default: launch directory; not an access sandbox)
-  --model <ref>        provider/modelId for a spawned gateway
-  --storage <path>     SQLite storage (default: ~/.neko/neko.sqlite)
-  --socket-path <path> Gateway Unix socket\uFF08POSIX\uFF1BWindows \u7ECF\u7AEF\u53E3\u6587\u4EF6\u53D1\u73B0 ws \u5730\u5740\uFF09
-  --theme <mode>       light / dark / auto (overrides NEKO_THEME)
-  -h, --help           Show help
+\u9009\u9879:
+  --cwd <dir>          \u5DE5\u4F5C\u76EE\u5F55\uFF08\u9ED8\u8BA4\u542F\u52A8\u76EE\u5F55\uFF1B\u975E\u8BBF\u95EE\u6C99\u7BB1\uFF09
+  --model <ref>        \u6A21\u578B\uFF0C\u683C\u5F0F provider/modelId\uFF08\u7528\u4E8E\u62C9\u8D77\u7684\u7F51\u5173\uFF09
+  --storage <path>     SQLite \u5B58\u50A8\u6587\u4EF6\uFF08\u9ED8\u8BA4 ~/.neko/neko.sqlite\uFF09
+  --socket-path <path> \u7F51\u5173 Unix socket \u8DEF\u5F84\uFF08\u4EC5 POSIX\uFF1BWindows \u7ECF\u7AEF\u53E3\u6587\u4EF6\u53D1\u73B0 ws \u5730\u5740\uFF09
+  --theme <mode>       \u4E3B\u9898 light / dark / auto\uFF08\u8986\u76D6 NEKO_THEME\uFF09
+  -h, --help           \u663E\u793A\u6B64\u5E2E\u52A9
 
-Resumes the most recently used session in this workspace, or creates one.
-A gateway is started when needed and stopped when its owning TUI exits.
-Configure DeepSeek with /login or DEEPSEEK_API_KEY.`;
+\u6062\u590D\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u6700\u8FD1\u4F7F\u7528\u7684\u4F1A\u8BDD\uFF0C\u4E0D\u5B58\u5728\u5219\u521B\u5EFA\u3002
+\u6309\u9700\u62C9\u8D77\u7F51\u5173\uFF0C\u5C5E\u4E3B TUI \u9000\u51FA\u65F6\u968F\u4E4B\u505C\u6B62\u3002
+\u53EF\u7528 /login \u6216 DEEPSEEK_API_KEY \u914D\u7F6E\u51ED\u636E\u3002`;
 var init_main = __esm(async () => {
   init_tui();
   try {
@@ -18768,7 +18880,7 @@ function parseArgs2(argv) {
     ...model !== undefined ? { model } : {}
   };
 }
-var USAGE2 = `\u7528\u6CD5: main.ts [\u9009\u9879]
+var USAGE2 = `\u7528\u6CD5: neko web [\u9009\u9879]
 
 \u9009\u9879:
   --port <n>           \u9759\u6001 HTTP \u7AEF\u53E3\uFF08\u9ED8\u8BA4 8322\uFF09
@@ -18779,12 +18891,11 @@ var USAGE2 = `\u7528\u6CD5: main.ts [\u9009\u9879]
   --storage <path>     SQLite \u5B58\u50A8\u6587\u4EF6\uFF08\u9ED8\u8BA4 ~/.neko/neko.sqlite\uFF09
   --cwd <dir>          \u4F1A\u8BDD\u5DE5\u5177\u7684\u5DE5\u4F5C\u76EE\u5F55\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09
   --model <ref>        \u6A21\u578B\uFF0C\u683C\u5F0F provider/modelId\uFF08\u9ED8\u8BA4 deepseek/deepseek-flash\uFF09
-  --no-open           \u4E0D\u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668\uFF08\u9002\u7528\u4E8E\u8FDC\u7A0B\u6216\u65E0\u684C\u9762\u73AF\u5883\uFF09
+  --no-open            \u4E0D\u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668\uFF08\u9002\u7528\u4E8E\u8FDC\u7A0B\u6216\u65E0\u684C\u9762\u73AF\u5883\uFF09
   -h, --help           \u663E\u793A\u6B64\u5E2E\u52A9
 
-\u53EF\u5728 Web \u8BBE\u7F6E\u9875\u914D\u7F6E Key\uFF1Bgateway \u5B50\u8FDB\u7A0B\u4E5F\u4F1A\u7EE7\u627F DEEPSEEK_API_KEY\u3002`;
+\u53EF\u5728 Web \u8BBE\u7F6E\u9875\u914D\u7F6E Key\uFF1B\u7F51\u5173\u5B50\u8FDB\u7A0B\u4E5F\u4F1A\u7EE7\u627F DEEPSEEK_API_KEY\u3002`;
 var init_main2 = __esm(async () => {
-  init_src();
   init_open_browser();
   init_server();
   try {
@@ -18799,14 +18910,12 @@ var init_main2 = __esm(async () => {
         ...options.storagePath !== undefined ? { storagePath: options.storagePath } : {},
         ...options.cwd !== undefined ? { cwd: options.cwd } : {},
         ...options.model !== undefined ? { model: options.model } : {},
-        onLog: (line) => console.log(`  [gateway] ${line}`)
+        onLog: (line) => console.log(`[gateway] ${line}`)
       }
     });
-    const model = options.model ?? DEFAULT_MODEL;
-    console.log(`neko web \u5DF2\u542F\u52A8: ${server.url}`);
-    console.log(`  \u7F51\u5173: ${server.gateway.wsUrl}\uFF08serverId: ${server.gateway.serverId}\uFF09`);
-    console.log(`  \u6A21\u578B: ${model.provider}/${model.modelId}`);
-    console.log("\u6309 Ctrl+C \u505C\u6B62\u3002");
+    console.log(`[web] neko web \u5DF2\u542F\u52A8: ${server.url}`);
+    console.log(`[web]   gateway: ${server.gateway.wsUrl}\uFF08serverId: ${server.gateway.serverId}\uFF09`);
+    console.log("[web] \u6309 Ctrl+C \u505C\u6B62\u3002");
     const shutdown = () => {
       console.log(`
 \u6B63\u5728\u5173\u95ED\u2026`);
@@ -18914,7 +19023,7 @@ function parseGatewayArgs(argv) {
     options.port = port;
   return options;
 }
-var GATEWAY_USAGE = `\u7528\u6CD5: main.ts [\u9009\u9879]
+var GATEWAY_USAGE = `\u7528\u6CD5: neko serve [\u9009\u9879]
 
 \u9009\u9879:
   --host <ip>          WebSocket \u76D1\u542C\u5730\u5740\uFF08\u9ED8\u8BA4 127.0.0.1\uFF0C\u4EC5\u672C\u673A\uFF09
@@ -18958,22 +19067,26 @@ var init_main3 = __esm(async () => {
     console.log(`  Unix socket: ${gateway.socketPath}`);
   if (gateway.wsUrl !== undefined)
     console.log(`  WebSocket:   ${gateway.wsUrl}`);
-  console.log("Ctrl-C \u505C\u6B62\u3002");
+  console.log("\u6309 Ctrl+C \u505C\u6B62\u3002");
   process.on("SIGINT", stop);
   process.on("SIGTERM", stop);
 });
 
 // packages/cli/src/main.ts
 init_application_version();
-var USAGE3 = `\u7528\u6CD5: neko <command> [options]
+var USAGE3 = `\u7528\u6CD5: neko <\u547D\u4EE4> [\u9009\u9879]
 
 \u547D\u4EE4:
-  tui     \u542F\u52A8\u7EC8\u7AEF\u4EA4\u4E92\u754C\u9762\uFF08\u81EA\u52A8\u62C9\u8D77 gateway\uFF09
-  web     \u542F\u52A8 Web UI \u9759\u6001\u6258\u7BA1\uFF08\u81EA\u52A8\u62C9\u8D77 gateway\uFF09
+  tui     \u542F\u52A8\u7EC8\u7AEF\u4EA4\u4E92\u754C\u9762\uFF08\u81EA\u52A8\u62C9\u8D77\u7F51\u5173\uFF09
+  web     \u542F\u52A8 Web UI \u9759\u6001\u6258\u7BA1\uFF08\u81EA\u52A8\u62C9\u8D77\u7F51\u5173\uFF09
+  serve   \u4EC5\u542F\u52A8\u7F51\u5173\uFF08WebSocket\uFF1BPOSIX \u53E6\u6709 Unix socket\uFF09
   update  \u5347\u7EA7\u5F53\u524D Bun \u5168\u5C40\u5B89\u88C5\uFF08Windows \u663E\u793A\u624B\u52A8\u5347\u7EA7\u547D\u4EE4\uFF09
-  serve   \u4EC5\u542F\u52A8 gateway\uFF08WebSocket\uFF1BPOSIX \u53E6\u6709 Unix socket\uFF09
 
-\u5404\u547D\u4EE4\u7684\u9009\u9879\u900F\u4F20\uFF0C\u8BE6\u89C1 neko <command> --help\u3002
+\u9009\u9879:
+  -v, --version  \u663E\u793A\u7248\u672C\u53F7
+  -h, --help     \u663E\u793A\u6B64\u5E2E\u52A9
+
+\u5404\u547D\u4EE4\u7684\u9009\u9879\u8BE6\u89C1 neko <\u547D\u4EE4> --help\u3002
 \u53EF\u901A\u8FC7 TUI /login\u3001Web \u8BBE\u7F6E\u9875\u6216 DEEPSEEK_API_KEY / TAVILY_API_KEY \u914D\u7F6E\u51ED\u636E\u3002`;
 var [command2, ...rest] = process.argv.slice(2);
 switch (command2) {
@@ -18981,9 +19094,12 @@ switch (command2) {
     if (rest.length) {
       if (rest.length === 1 && (rest[0] === "--help" || rest[0] === "-h"))
         console.log(`\u7528\u6CD5: neko update
+
 \u5347\u7EA7\u5F53\u524D Bun \u5168\u5C40\u5B89\u88C5\uFF1B\u5B8C\u6210\u540E\u91CD\u65B0\u542F\u52A8 neko\u3002
 Windows\uFF1A\u5148\u9000\u51FA neko\uFF0C\u518D\u8FD0\u884C bun add --global neko-harness@latest\u3002
-  -h, --help \u663E\u793A\u5E2E\u52A9`);
+
+\u9009\u9879:
+  -h, --help  \u663E\u793A\u6B64\u5E2E\u52A9`);
       else {
         console.error("\u7528\u6CD5: neko update");
         process.exitCode = 1;

package/package.json

@@ -24,7 +24,7 @@
 	},
 	"packageManager": "bun@1.4.2",
 	"trustedDependencies": [],
-	"version": "0.2.8",
+	"version": "0.2.9",
 	"description": "A local AI coding assistant with terminal and web interfaces, powered by Pi and Bun.",
 	"keywords": [
 		"ai",