cortico 0.1.0 → 0.1.1

package/src/web/client/console-pages/builtins/llm-settings/panel.ts

@@ -13,7 +13,6 @@ import type {
 } from '../../../../shared/client-panel.ts';
 import { pricingEditor, type ModelQuote } from './pricing-panel.ts';
 import { panel } from './strings.ts';
-import { configField, type ConfigGroupEntry } from '../../../features/config/view.ts';
 
 /** 每个端点实例的模型与推理配置。 */
 interface Spec {
@@ -46,7 +45,6 @@ interface Instance {
   entry: Entry;
   quotes: ModelQuote[];
   secretConfigured: 'env' | 'file' | 'none';
-  config: ConfigGroupEntry[];
 }
 interface SettingsState {
   active: string;
@@ -80,7 +78,7 @@ interface ProbeResult {
 
 const DEFAULT_ENDPOINT_PATH = '/responses';
 
-/** 当前端点的模块面板插槽。 */
+/** 模块自有段落挂在这个插槽里，排在连接与模型档之间。 */
 const MODULE_SLOT = 'instance';
 
 /** 开放模式的 effort 格 ↔ spec 的 thinking/reasoningEffort。 */
@@ -159,7 +157,7 @@ export const llmSettingsPanel: ConsolePanel = {
     let selected = '';
     /** 模块段落的句柄，重画前先结束上一批。 */
     let sections: Disposable | null = null;
-    /** 仅最新一次 load 可以更新 DOM。 */
+    /** 重画代号：慢一步回来的那次 load 不再往 DOM 上贴。 */
     let generation = 0;
     const report = ui.msgline();
     const body = ui.h('div');
@@ -257,37 +255,26 @@ export const llmSettingsPanel: ConsolePanel = {
       const spec: Spec = structuredClone(entry.spec) ?? { model: '', thinking: open };
       const saveSpec = () => void patch({ spec });
 
-      function configInput(suffix: string, label: string, changed?: (value: unknown) => void | Promise<void>): HTMLElement {
-        const path = `providers.${current!.name}.${suffix}`;
-        const { group, values } = current!.config.find(({ group }) => path in group.schema.properties!)!;
-        const field = configField(ui, group.schema.properties![path], values?.[path], () => {
-          void (async () => {
-            const raw = field.read!();
-            const value = typeof raw === 'string' ? raw.trim() : raw;
-            try {
-              await ctx.setConfig(group.id, { [path]: value });
-              report.textContent = S.saved;
-              await ctx.refresh();
-              await changed?.(value);
-            } catch (error) {
-              report.textContent = String(error);
-            }
-          })();
-        }, ctx.signal);
-        (field.node.querySelector('input, select, textarea') ?? field.node).setAttribute('aria-label', label);
-        return field.node;
-      }
-
       // ---- 连接 ----
       const connection = ui.sheet({ title: S.connectionTitle, desc: S.connectionDescription });
       const options = entry.options ?? {};
-      const endpointPath =
+      let endpointPath =
         typeof options.endpointPath === 'string' ? options.endpointPath : DEFAULT_ENDPOINT_PATH;
       const jsonText = (value: unknown) =>
         value === undefined ? '' : JSON.stringify(value, null, 2);
-      const baseUrlInput = configInput('baseUrl', S.baseUrl, connectionChanged);
-      const secretNameInput = configInput('secret', S.secretName, connectionChanged);
-      (secretNameInput as HTMLInputElement).placeholder = S.secretNamePlaceholder;
+      const baseUrlInput = ui.input({
+        value: entry.baseUrl,
+        cls: 'mono',
+        onChange: (value) => void connectionChanged({ baseUrl: value.trim() }),
+      });
+      baseUrlInput.setAttribute('aria-label', S.baseUrl);
+      const secretNameInput = ui.input({
+        value: entry.secret ?? '',
+        placeholder: S.secretNamePlaceholder,
+        cls: 'mono',
+        onChange: (value) => void connectionChanged({ secret: value.trim() }),
+      });
+      secretNameInput.setAttribute('aria-label', S.secretName);
       connection.body.append(
         ui.field(S.baseUrl, baseUrlInput),
         ui.field(S.secretName, secretNameInput),
@@ -307,18 +294,24 @@ export const llmSettingsPanel: ConsolePanel = {
         connection.body.append(ui.field(S.secretStatus, row));
         if (!entry.secret) connection.body.append(ui.msgline(S.secretNameFirst));
       }
-      connection.body.append(ui.field(S.multimodal, configInput('multimodal', S.multimodal)));
+      connection.body.append(
+        ui.checkbox(S.multimodal, {
+          checked: entry.multimodal === true,
+          onChange: (checked) => void patch({ multimodal: checked }),
+        }).el,
+      );
       let extraHeaders: HTMLTextAreaElement | null = null;
       let extraBody: HTMLTextAreaElement | null = null;
-      let path: HTMLInputElement | null = null;
       if (open) {
-        const pathKey = `providers.${current.name}.options.endpointPath`;
-        const hasPath = current.config.some(({ group }) => pathKey in group.schema.properties!);
-        path = hasPath ? configInput('options.endpointPath', S.endpointPath) as HTMLInputElement : null;
-        if (path) {
-          path.value = endpointPath;
-          path.placeholder = DEFAULT_ENDPOINT_PATH;
-        }
+        const path = ui.input({
+          value: endpointPath,
+          cls: 'mono',
+          onChange: (value) => {
+            endpointPath = value.trim();
+            saveOptions();
+          },
+        });
+        path.setAttribute('aria-label', S.endpointPath);
         extraHeaders = ui.textarea({
           rows: 3,
           cls: 'mono',
@@ -335,7 +328,7 @@ export const llmSettingsPanel: ConsolePanel = {
         extraBody.setAttribute('aria-label', S.extraBody);
         connection.body.append(
           ui.section(S.advancedProtocolTitle, S.advancedProtocolDescription),
-          ...(path ? [ui.field(S.endpointPath, path)] : []),
+          ui.field(S.endpointPath, path),
           ui.field(S.extraHeaders, extraHeaders),
           ui.field(S.extraBody, extraBody),
         );
@@ -353,7 +346,7 @@ export const llmSettingsPanel: ConsolePanel = {
           return parsed;
         };
         const edited: Record<string, unknown> = {
-          endpointPath: path?.value.trim() ?? options.endpointPath,
+          endpointPath,
           extraHeaders: object(extraHeaders!, S.extraHeaders),
           extraBody: object(extraBody!, S.extraBody),
         };
@@ -438,7 +431,8 @@ export const llmSettingsPanel: ConsolePanel = {
         if (!ctx.signal.aborted) renderModelField();
       }
       /** 地址或密钥改过就重取目录:换了端点,上一份模型表不作数。 */
-      async function connectionChanged(): Promise<void> {
+      async function connectionChanged(fields: Record<string, unknown>): Promise<void> {
+        if (!(await patch(fields))) return;
         catalog = [];
         await fetchCatalog();
       }

package/src/web/client/console-pages/builtins/llm-settings/strings.ts

@@ -27,12 +27,12 @@ const zh = {
   extraBody: '附加请求体（JSON 对象）',
   jsonObjectRequired: (label: string) => `${label} 必须是 JSON 对象`,
   advancedProtocolTitle: '协议与请求扩展',
-  advancedProtocolDescription: '',
+  advancedProtocolDescription: '针对 OpenAI Responses 兼容端点的高级配置（端点路径与附加 JSON 字段）。',
   modelFieldLabel: '模型标识',
   effortFieldLabel: '推理强度',
   temperatureFieldLabel: '采样温度',
   specTitle: '模型档',
-  specDescription: '此端点的每次调用共用这份模型配置；fork 使用创建时的快照。',
+  specDescription: '配置此实例调用的模型及推理、温度和 Token 限制等生成参数。',
   modelName: '明确模型名',
   fetchModels: '取模型列表',
   modelsFetched: (count: number) => `取到 ${count} 个模型。`,
@@ -131,12 +131,12 @@ const en: typeof zh = {
   extraBody: 'Extra body (JSON object)',
   jsonObjectRequired: (label: string) => `${label} must be a JSON object`,
   advancedProtocolTitle: 'Protocol & Request Overrides',
-  advancedProtocolDescription: '',
+  advancedProtocolDescription: 'Advanced options for OpenAI Responses compatible endpoints (custom path and extra JSON fields).',
   modelFieldLabel: 'Model identifier',
   effortFieldLabel: 'Reasoning effort',
   temperatureFieldLabel: 'Sampling temperature',
   specTitle: 'Model',
-  specDescription: 'Calls on this endpoint share its model configuration; forks use the snapshot from their creation.',
+  specDescription: 'Configure model identifier, reasoning effort, temperature and token limits for this instance.',
   modelName: 'Exact model name',
   fetchModels: 'Fetch models',
   modelsFetched: (count: number) => `Fetched ${count} models.`,

package/src/web/client/console-pages/host.ts

@@ -380,11 +380,11 @@ export class ConsolePageHost {
 
   /** Persona 页才有工具表页签,且要部署挂着 /api/tool-schemas。 */
   private toolsTabOf(page: ConsolePageManifest): boolean {
-    if (page.kind !== 'persona') return false;
+    if (page.kind !== 'persona' || page.availability !== 'active') return false;
     return this.snapshot?.framework?.capabilities?.toolSchemas !== false;
   }
 
-  /** 工具表包含主循环与装配层补充的工具声明。 */
+  /** 工具表是整份装配结果,不按页筛:模型看见的那一张表就是这一张。 */
   private async showTools(pageId: string, gen: number): Promise<void> {
     const { slot } = this.ensurePanes();
     const lifecycle = new Lifecycle(this.deps.onError);

package/src/web/client/features/core/strings.ts

@@ -12,7 +12,7 @@ const zh = {
   subData: '数据',
   subConfig: '配置',
   dataTitle: 'Core 的数据',
-  dataDesc: '',
+  dataDesc: '事件库、session、运行日志、用量流水这些 Core 自己攒下的存储。',
   configTitle: 'Core 配置',
   configDesc: '修改自动保存到 config.json。标有重启要求的配置在重启后生效,其余立即生效。',
   configEmpty: 'Core 没有可调配置。',
@@ -89,7 +89,7 @@ const en: typeof zh = {
   subData: 'Data',
   subConfig: 'Config',
   dataTitle: 'Core data',
-  dataDesc: '',
+  dataDesc: 'Storage Core accumulates on its own: the event store, the session, run logs and the usage ledger.',
   configTitle: 'Core config',
   configDesc: 'Changes save to config.json automatically. Settings marked for restart apply after restarting; the rest apply immediately.',
   configEmpty: 'Core has no tunable settings.',

package/src/web/client/features/feature.ts

@@ -57,7 +57,7 @@ export type FrameworkFeature = {
   readonly label: string;
   /** 左栏图标。 World 那一页不走此字段。 */
   readonly icon?: ConsoleIconName;
-  /** 状态灯表中的键；缺省时不声明状态灯。 */
+  /** 这一行那盏灯在灯表里的键。省略就不点灯。 */
   readonly lampId?: string;
   /** 列出的 capability 任一已挂载即显示导航项；省略或为空时始终显示。 */
   readonly needsAny?: readonly string[];

package/src/web/client/features/live/index.ts

@@ -174,6 +174,7 @@ function mountLive(ctx: FeatureContext, env: SocketEnv): Disposable | void {
   view.append(timeline.el, composer.el);
   timeline.rebuild([], { empty: S.emptyConnecting });
 
+  // 没有可用端点时说清楚要去哪儿,而不是让操作员发出一条得不到回复的消息。
   let providerReady = false;
   ctx.lifecycle.own(subscribeLamps(ctx.root.ownerDocument, (lamps) => {
     const lamp = lamps[PROVIDERS_LAMP_ID]?.[0];
@@ -184,12 +185,17 @@ function mountLive(ctx: FeatureContext, env: SocketEnv): Disposable | void {
 
   const resumeRun = (): Promise<unknown> => post('/api/run/resume', {}, { signal: ctx.signal });
 
+  /**
+   * 开场引导认部署目录里那个一次性标记（`.onboarding`，自建部署时写入）。session 与事件游标
+   * 都当不了判据：全新部署起来就有一条系统前缀和一条 session 开场事件，而上下文交接后 session
+   * 反倒是空的。
+   */
   let onboarding: OnboardingView | null = null;
   /** 本次挂载里已经收过一次；销标记的请求在路上时状态帧还会报 pending。 */
   let dismissed = false;
   const dismissOnboarding = (): void => {
     dismissed = true;
-    void post('/api/onboarding/dismiss', {}, { signal: ctx.signal }).catch(() => { /* 删除失败时标记仍在，下次挂载仍显示引导。 */ });
+    void post('/api/onboarding/dismiss', {}, { signal: ctx.signal }).catch(() => { /* 下次打开再收 */ });
     syncOnboarding();
   };
   const syncOnboarding = (): void => {
@@ -212,6 +218,7 @@ function mountLive(ctx: FeatureContext, env: SocketEnv): Disposable | void {
       });
       onboarding.setProvider(providerReady);
       timeline.setHeader(onboarding.el);
+      // 引导期间系统前缀那张卡先收起来:这一页此刻要说的是怎么把 bot 配起来。
       timeline.setHideSystem(true);
       timeline.rebuild(state.messages, { head: state.head });
       return;

package/src/web/client/features/live/onboarding.ts

@@ -1,5 +1,5 @@
 /**
- * 开场引导的配置状态与操作入口。
+ * 新部署的开场引导：四条 Cortico 署名的气泡，用 assistant 直接输出那套气泡样式。
  * 端点状态由终端页从 providers 灯推进来，已启用的 World 在挂载时读一次接口。
  * 是否显示由终端页判定，这里只画。
  */
@@ -60,6 +60,7 @@ export function createOnboarding(deps: OnboardingDeps): OnboardingView {
     const box = ui.h('div', 'monolog');
     box.appendChild(ui.h('div', 'monolog-body', line));
     const state = ui.h('div', 'ob-state hidden');
+    // 外观取子页签那颗按钮（`.seg`），`ob-btn` 只挂本页的微调。
     const button = ui.h('button', action?.accent ? 'seg active ob-btn ob-go' : 'seg active ob-btn');
     button.type = 'button';
     if (action?.icon) button.appendChild(icon(doc, action.icon));
@@ -87,6 +88,7 @@ export function createOnboarding(deps: OnboardingDeps): OnboardingView {
   bubble(S.obPrompts, { label: S.obGoEdit, onClick: () => deps.go(['prompts']) });
 
   const startLabel = S.obStart;
+  // 最后那颗按的是「开始跑」，图标与左下角运行控制里的继续是同一个。
   const ready = bubble(S.obReady, {
     label: startLabel,
     icon: 'play',
@@ -106,6 +108,7 @@ export function createOnboarding(deps: OnboardingDeps): OnboardingView {
     el,
     setProvider(available) {
       provider.setState(available ? S.obProviderReady : S.obProviderNone, available ? 'ok' : 'bad');
+      // 最后一条只在还缺端点时说话：配好了就只剩那颗按钮。
       ready.setState(available ? null : S.obProviderNone, 'bad');
       ready.button.disabled = !available;
     },

package/src/web/client/features/live/strings.ts

@@ -111,14 +111,14 @@ const zh = {
 
   // onboarding.ts
   obWho: 'Cortico',
-  obWelcome: '欢迎使用 Cortico。',
-  obProvider: '配置模型提供商后即可开始对话。',
+  obWelcome: '欢迎使用 Cortico！现在，让我们开始部署你的第一个 Cortico Bot。',
+  obProvider: '首先，请配置模型提供商：',
   obProviderNone: '尚未配置可用的模型提供商',
   obProviderReady: '模型提供商已配置',
-  obWorlds: '按需启用 World，也可以仅使用终端对话。',
-  obWorldsState: (labels: readonly string[]) => `已启用 ${labels.length} 个 World：${labels.join('、')}`,
-  obPrompts: '系统提示词定义人格描述、行为规范和语言风格，可按需修改。',
-  obReady: '配置好后，可以邀请 bot 开口。',
+  obWorlds: '接下来，请启用并配置你的 Bot 接入的外部环境模组（Cortico World）。也可以先仅启用终端对话。',
+  obWorldsState: (labels: readonly string[]) => `当前已经启用了 ${labels.length} 个外部环境：${labels.join('、')}`,
+  obPrompts: '最后，你可以在这里方便地编辑系统提示词，来提供人格描述、行为规范、语言风格等定制化内容！',
+  obReady: '准备就绪！',
   obGoConfigure: '前往配置',
   obGoEdit: '开始编辑',
   obStart: '打个招呼？',
@@ -235,15 +235,15 @@ const en: typeof zh = {
 
   // onboarding.ts
   obWho: 'Cortico',
-  obWelcome: "Welcome to Cortico.",
-  obProvider: 'Configure a model provider to start chatting.',
+  obWelcome: "Welcome to Cortico! Let's set up your first Cortico Bot.",
+  obProvider: 'First, configure a model provider:',
   obProviderNone: 'No usable model provider yet',
   obProviderReady: 'Model provider configured',
-  obWorlds: 'Enable Worlds as needed, or use terminal chat alone.',
+  obWorlds: 'Next, enable and configure the external environments your bot reaches (Cortico Worlds). Terminal chat alone is a fine start.',
   obWorldsState: (labels: readonly string[]) =>
     `Currently ${labels.length} external environment${labels.length === 1 ? '' : 's'} enabled: ${labels.join(', ')}`,
-  obPrompts: 'You can edit the system prompt to set personality, behavior and language style.',
-  obReady: 'Once configured, you can invite the bot to speak.',
+  obPrompts: 'Finally, the system prompt is edited here: who it is, how it behaves, how it talks.',
+  obReady: 'Ready to go!',
   obGoConfigure: 'Configure',
   obGoEdit: 'Edit',
   obStart: 'Say hello?',

package/src/web/client/features/live/timeline.ts

@@ -100,7 +100,7 @@ export interface TimelineView {
   append(m: ContextRecord, index: number, live: boolean): void;
   /** 说话人展示名。头像图片加载不到时,ASSISTANT 组左栏的占位圆里印它的首字;下一次画到组时生效。 */
   setSpeaker(name: string): void;
-  /** 是否隐藏系统前缀，下一次重画生效。 */
+  /** 开场引导期间把系统前缀那张卡收起来，下一次重画生效。 */
   setHideSystem(hide: boolean): void;
   /** 在滚动区顶部挂一块外部内容，随时间线一起滚；传 null 取下。重画不动它。 */
   setHeader(node: HTMLElement | null): void;
@@ -131,6 +131,7 @@ export function createTimeline(deps: TimelineDeps): TimelineView {
   let turn: Turn | null = null;
   /** 头像占位圆里的字。 */
   let speakerInitial = 'B';
+  /** 收起系统前缀卡。 */
   let hideSystem = false;
   /** 挂在滚动区顶部的外部内容（开场引导）。 */
   let header: HTMLElement | null = null;

package/src/web/client/features/settings/general.ts

@@ -5,6 +5,7 @@ import { S } from './strings.ts';
 export function mountGeneral(ctx: FeatureContext): void {
   const { ui, root, signal } = ctx;
   const win = root.ownerDocument.defaultView!;
+  // 同页别处都是档案卡:标题与说明的字体从卡片来,这里自己写 h3/p 会与它们对不齐。
   const sheet = ui.sheet({ title: S.language, en: 'language', desc: S.languageDesc });
   const group = ui.h('div', 'rowbar');
   group.setAttribute('role', 'group');

package/src/web/client/features/settings/index.ts

@@ -73,6 +73,7 @@ export function mountSettings(ctx: FeatureContext): void {
   if (visible[0]) select(visible[0].id);
 }
 
+// 入口是底栏那颗齿轮,不占左栏一行;`hidden` 只保留路由。
 export const settingsFeature: FrameworkFeature = {
   route: 'settings',
   label: S.navLabel,

package/src/web/client/features/worlds/index.ts

@@ -179,6 +179,7 @@ export function mountWorlds(ctx: FeatureContext): void {
       );
       if (ctx.signal.aborted) return;
       setMsg(out?.result || (wantEnabled ? S.activated : S.deactivated));
+      // 左栏重排失败只是导航旧了一拍,激活本身已经成功,不进上面那行的失败文案。
       void ctx.refreshNav?.().catch(ctx.onError);
       await load();
     } catch (err) {

package/src/web/client/shell/index.ts

@@ -117,6 +117,7 @@ export function createShell(deps: ShellDeps): ConsoleShell {
   const el = ui.h('div');
   el.id = 'rail';
 
+  // 左上角只有框架字标。这个 bot 叫什么写在底栏头像旁边——那才是这一台的名字。
   const brand = ui.h('div', 'brand');
   brand.setAttribute('role', 'img');
   brand.setAttribute('aria-label', FRAMEWORK_NAME);
@@ -127,8 +128,14 @@ export function createShell(deps: ShellDeps): ConsoleShell {
 
   const foot = ui.h('div', 'railfoot');
   const avatar = createAvatarControl({ doc, ui, signal, onError });
-  const botName = ui.h('button', 'rail-name', DEFAULT_BRAND);
+  const botName = ui.h('button', 'rail-name');
   botName.type = 'button';
+  // 名字自己是按钮(点了就地改名);铅笔只在悬停时露出来,不占额外宽度。
+  const botNameText = ui.h('span', 'rail-name-text', DEFAULT_BRAND);
+  const botNameEdit = ui.h('span', 'rail-name-edit');
+  botNameEdit.setAttribute('aria-hidden', 'true');
+  botNameEdit.appendChild(icon(doc, 'pencil'));
+  botName.append(botNameText, botNameEdit);
   const who = ui.h('div', 'rail-who');
   who.append(avatar.el, botName);
   const footActions = ui.h('div', 'rail-actions');
@@ -137,16 +144,12 @@ export function createShell(deps: ShellDeps): ConsoleShell {
   const shutdownButton = ui.h('button', 'rail-action rail-shutdown');
   shutdownButton.type = 'button';
   shutdownButton.appendChild(icon(doc, 'power'));
-  // 重启 = 同一套收尾 + 退出前落重启标志,启动器循环把进程拉起来。
-  const restartButton = ui.h('button', 'rail-action rail-restart');
-  restartButton.type = 'button';
-  restartButton.appendChild(icon(doc, 'refresh'));
   const settingsButton = ui.h('button', 'rail-action');
   settingsButton.type = 'button';
   settingsButton.setAttribute('aria-label', S.settingsAria);
   settingsButton.title = S.settingsTitle;
   settingsButton.appendChild(icon(doc, 'settings'));
-  footActions.append(runButton, settingsButton, restartButton, shutdownButton);
+  footActions.append(runButton, settingsButton, shutdownButton);
   foot.append(who, footActions);
 
   let paused = false;
@@ -161,7 +164,7 @@ export function createShell(deps: ShellDeps): ConsoleShell {
   };
   renderRun();
 
-  /** 关机和重启共用请求锁，等待请求完成后释放。 */
+  /** 关机请求的锁，等待请求完成后释放。 */
   let shuttingDown = false;
   const renderPower = (): void => {
     const canShutdown = capabilities.shutdown === true;
@@ -169,45 +172,23 @@ export function createShell(deps: ShellDeps): ConsoleShell {
     shutdownButton.disabled = !canShutdown || shuttingDown;
     shutdownButton.setAttribute('aria-label', S.shutdownAria);
     shutdownButton.title = shuttingDown ? S.finishing : S.shutdownTitle;
-    const canRestart = capabilities.restart === true;
-    restartButton.hidden = !canRestart;
-    restartButton.disabled = !canRestart || shuttingDown;
-    restartButton.setAttribute('aria-label', S.restartAria);
-    restartButton.title = shuttingDown
-      ? S.finishing
-      : capabilities.supervised === true
-        ? S.restartTitleSupervised
-        : S.restartTitleUnsupervised;
   };
   renderPower();
 
-  const powerAction = async (kind: 'shutdown' | 'restart'): Promise<void> => {
+  const powerAction = async (): Promise<void> => {
     if (shuttingDown) return;
-    if (kind === 'shutdown' ? capabilities.shutdown !== true : capabilities.restart !== true) return;
-    const supervised = capabilities.supervised === true;
-    const first = await ui.confirm(kind === 'shutdown'
-      ? {
-          title: S.confirmShutdownTitle,
-          body: S.shutdownBody,
-          danger: true,
-        }
-      : {
-          title: S.confirmRestartTitle,
-          body: supervised ? S.restartSupervisedNote : S.restartUnsupervisedNote,
-          danger: true,
-        });
+    if (capabilities.shutdown !== true) return;
+    const first = await ui.confirm({
+      title: S.confirmShutdownTitle,
+      body: S.shutdownBody,
+      danger: true,
+    });
     if (!first || signal.aborted) return;
-    const second = await ui.confirm(kind === 'shutdown'
-      ? {
-          title: S.confirmShutdownAgainTitle,
-          body: S.confirmShutdownAgainBody,
-          danger: true,
-        }
-      : {
-          title: S.confirmRestartAgainTitle,
-          body: supervised ? S.confirmRestartAgainSupervised : S.confirmRestartAgainUnsupervised,
-          danger: true,
-        });
+    const second = await ui.confirm({
+      title: S.confirmShutdownAgainTitle,
+      body: S.confirmShutdownAgainBody,
+      danger: true,
+    });
     if (!second || signal.aborted) return;
     shuttingDown = true;
     renderPower();
@@ -217,7 +198,7 @@ export function createShell(deps: ShellDeps): ConsoleShell {
         ok?: boolean; localComplete?: boolean; result?: string; error?: string;
         steps?: Array<{ label: string; ok: boolean; ms: number; detail?: string }>;
         externalChecks?: Array<{ status: 'verified-ended' | 'still-live' | 'unknown' }>;
-      }>(kind === 'shutdown' ? '/api/run/shutdown' : '/api/run/restart', undefined, { signal });
+      }>('/api/run/shutdown', undefined, { signal });
       if (out?.error) throw new Error(out.error);
       const steps = out?.steps ?? [];
       const localComplete = out?.localComplete ?? steps.every((step) => step.ok);
@@ -225,13 +206,12 @@ export function createShell(deps: ShellDeps): ConsoleShell {
         .some((check) => check.status !== 'verified-ended');
       const lines = steps.map((s) =>
         `${s.ok ? '✓' : '✗'} ${s.label} · ${(s.ms / 1000).toFixed(1)}s${s.ok ? '' : ` — ${s.detail ?? S.stepIncomplete}`}`);
-      const done = kind === 'shutdown' ? S.doneShutdown : supervised ? S.doneRestartSupervised : S.doneRestart;
       void ui.confirm({
         title: !localComplete
           ? S.resultLocalIncomplete
           : externalUnverified
             ? S.resultExternalUnverified
-            : out?.ok === false ? S.resultUnverified : done,
+            : out?.ok === false ? S.resultUnverified : S.doneShutdown,
         body: [out?.result ?? S.resultDefault, '', ...lines].join('\n'),
       });
     } catch (err) {
@@ -246,8 +226,7 @@ export function createShell(deps: ShellDeps): ConsoleShell {
       renderPower();
     }
   };
-  shutdownButton.addEventListener('click', () => { void powerAction('shutdown'); }, { signal });
-  restartButton.addEventListener('click', () => { void powerAction('restart'); }, { signal });
+  shutdownButton.addEventListener('click', () => { void powerAction(); }, { signal });
 
   runButton.addEventListener('click', () => {
     if (runPending || capabilities.run !== true) return;
@@ -456,7 +435,8 @@ export function createShell(deps: ShellDeps): ConsoleShell {
   const setBrand = (name: string | null | undefined): void => {
     const shown = typeof name === 'string' && name.trim() !== '' ? name.trim() : DEFAULT_BRAND;
     shownName = shown;
-    botName.textContent = shown;
+    botNameText.textContent = shown;
+    // 悬停说的是这一下能做什么;全名在改名框里看得到。
     botName.title = S.renameTitle;
     avatar.setLabel(shown);
     doc.title = S.docTitle(shown);

package/src/web/client/shell/strings.ts

@@ -13,24 +13,13 @@ const zh = {
   settingsTitle: '设置',
   finishing: '正在关闭…',
   shutdownTitle: '关机',
-  restartAria: '重启',
-  restartTitleSupervised: '重启',
-  restartTitleUnsupervised: '退出后需手动启动',
   shutdownBody: '进程将退出，控制台连接将断开。',
   confirmShutdownTitle: '⚠ 关机',
-  confirmRestartTitle: '⚠ 重启',
-  restartSupervisedNote: '进程将重启。',
-  restartUnsupervisedNote: '进程将退出，需要手动重新启动。',
   confirmShutdownAgainTitle: '⚠⚠ 确认关机?',
   confirmShutdownAgainBody: '停止运行并退出进程？',
-  confirmRestartAgainTitle: '⚠⚠ 确认重启?',
-  confirmRestartAgainSupervised: '退出并重新启动进程？',
-  confirmRestartAgainUnsupervised: '退出进程？退出后需手动启动。',
   finishingToast: '正在关闭…',
   stepIncomplete: '未完成',
   doneShutdown: '已关机',
-  doneRestartSupervised: '已退出，等待重新启动',
-  doneRestart: '已退出',
   resultLocalIncomplete: '本地关闭步骤未全部完成',
   resultExternalUnverified: '本地已关机,外部状态未确认',
   resultUnverified: '关闭步骤已执行，状态未确认',
@@ -56,24 +45,13 @@ const en: typeof zh = {
   settingsTitle: 'Settings',
   finishing: 'Shutting down…',
   shutdownTitle: 'Shut down',
-  restartAria: 'Restart',
-  restartTitleSupervised: 'Restart',
-  restartTitleUnsupervised: 'Manual startup required after exit',
   shutdownBody: 'The process will exit and disconnect the console.',
   confirmShutdownTitle: '⚠ Shut down',
-  confirmRestartTitle: '⚠ Restart',
-  restartSupervisedNote: 'The process will restart.',
-  restartUnsupervisedNote: 'The process will exit and must be restarted manually.',
   confirmShutdownAgainTitle: '⚠⚠ Confirm shutdown?',
   confirmShutdownAgainBody: 'Stop running and exit the process?',
-  confirmRestartAgainTitle: '⚠⚠ Confirm restart?',
-  confirmRestartAgainSupervised: 'Exit and restart the process?',
-  confirmRestartAgainUnsupervised: 'Exit the process? You must start it manually afterwards.',
   finishingToast: 'Shutting down…',
   stepIncomplete: 'incomplete',
   doneShutdown: 'Shut down',
-  doneRestartSupervised: 'Exited; waiting to restart',
-  doneRestart: 'Exited',
   resultLocalIncomplete: 'Local shutdown steps incomplete',
   resultExternalUnverified: 'Shut down locally; external state unverified',
   resultUnverified: 'Shutdown steps executed; state unverified',

package/src/web/client/ui/icons.ts

@@ -17,6 +17,7 @@ export type ConsoleIconName =
   | 'text'
   | 'eye'
   | 'eye-off'
+  | 'pencil'
   | 'refresh';
 
 type Shape = readonly [tag: 'path' | 'circle' | 'rect' | 'line', attrs: Readonly<Record<string, string>>];
@@ -93,6 +94,10 @@ const SHAPES: Readonly<Record<ConsoleIconName, readonly Shape[]>> = {
     ['path', { d: 'M6.6 6.6C3.8 8.5 2 12 2 12s3.5 7 10 7c1.6 0 3-.4 4.3-1' }],
     ['path', { d: 'M9.9 9.9a3 3 0 0 0 4.2 4.2' }],
   ],
+  pencil: [
+    ['path', { d: 'M4 20h4.2L19.4 8.8a2.3 2.3 0 0 0-3.2-3.2L5 16.8V20Z' }],
+    ['path', { d: 'm12.6 6.5 4.9 4.9' }],
+  ],
   refresh: [
     ['path', { d: 'M21 12a9 9 0 1 1-2.6-6.4' }],
     ['path', { d: 'M21 3v6h-6' }],

package/src/web/console-pages.ts

@@ -318,7 +318,7 @@ export class ConsolePageRegistry {
   ): Promise<{ ok: true; value: unknown } | { ok: false; failure: InvokeFailure }> {
     const found = await this.resolvePanel(pageId, panelId, language);
     if (!found.ok) return found;
-    // GET 只允许 getMethods 声明的方法。
+    // GET 不过写请求的同源闸门,任何站点凭 <img src> 就能发出;只放行面板点名的方法。
     if (transport === 'get' && !(found.panel.getMethods ?? []).includes(method)) {
       return {
         ok: false,