cortico 0.1.0 → 0.1.1

package/README.md

@@ -15,8 +15,7 @@ import type { EventEnvelope, WorldHost } from 'cortico/core/types.ts';
 
 Inside a running instance those specifiers are resolved by the host's module hook to the
 framework that instance runs. This package supplies the same files to the editor, the type
-checker and the test runner before the extension is installed anywhere, which is the whole of
-what it does: it has no entry point and starts nothing.
+checker and the test runner. It has no entry point and starts nothing.
 
 ## Install
 
@@ -34,14 +33,8 @@ the packaging rules.
 
 ## Running a bot
 
-Running Cortico itself means cloning the repository; deployments, bot packages and the web
-console live in the checkout.
-
-```bash
-git clone https://github.com/Pal-AI-Lab/Cortico.git
-cd Cortico
-corepack pnpm install
-pnpm start
-```
+Deployments, bot packages and the web console live in a checkout of the repository, which is
+where a bot runs from:
+[Quick Start](https://github.com/Pal-AI-Lab/Cortico#quick-start).
 
 MIT licensed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "A TypeScript framework for event-driven, long-running persona bots",
   "license": "MIT",
@@ -36,8 +36,6 @@
     "@types/express": "^4.17.21",
     "@types/ws": "^8.5.13",
     "express": "^4.21.2",
-    "fflate": "0.8.3",
-    "tar-stream": "3.2.1",
     "ws": "^8.18.0"
   }
 }

package/src/bot.ts

@@ -867,7 +867,7 @@ export function deriveConsolePageSources(
   parts: { assembly: WorldAssembly; persona?: Persona },
   /**
    * bot 标识、展示名、Memory 名与配置组;配置组归入 Persona 页面。
-   * 展示名由部署配置提供；Persona 页标题取 Persona 的类名。
+   * 展示名是这一台 bot 的名字(底栏头像旁边那个),Persona 页的标题另取 Persona 的类名。
    */
   bot?: { id: string; label: string; memoryName?: string; configGroups?: readonly ConfigGroup[] },
 

package/src/core/README.md

@@ -77,12 +77,8 @@ handler 异常转为失败回执。流式生成时 `EagerDispatch` 可提前执
 `Persona.onHandoff(snapshot, { hardTokens })` 返回 `{ tail, trim? }`。Core 重建 system 前缀，
 按 `hardTokens − estimate(prefix)` 限制保留上下文，其中 prefix 包括 system 前缀和 Persona 的合成
 开头(`sessionHead()`)。Core 校验工具调用配对，并重置 session。
-合成开头每次请求现取，不写入持久 session；Core 不据此判定远端缓存是否命中。
 阶段预算与保留比例由 Persona 决定，模型配置来自当前 provider。
 
-存储清单使用 `StorageOwner` 标识 Core、Persona、Memory 与 World 的归属。
-页面组织和 Memory 展示名称由装配层处理。
-
 ## 错误隔离
 
 装配层将 World 构造失败限制在该 World。`start()` 抛错时不挂载；`stop()` 失败或超时会记录

package/src/core/types.ts

@@ -930,7 +930,7 @@ export interface Persona {
   /**
    * session 的合成开头:每次请求置于 system 前缀之后、持久历史之前,不写入 session,交接时
    * 不进保留内容。Core 每次出请求前调用一次,丢弃 system 与 developer 项,补齐工具配对,
-   * 计入 hardTokens。内容由 Persona 的当前输入决定。
+   * 计入 hardTokens。内容只应随 Persona 自己的输入变化;每次不同就每次打穿前缀缓存。
    */
   sessionHead?(): Item[];
   /** Memory 实例。Core 不读它的内容;bot 没给 memoryName 时控制台以它的类名作 Memory 页标题。 */

package/src/core/util.ts

@@ -372,7 +372,8 @@ export function shortId(prefix = ''): string {
 }
 
 /**
- * 按 BOM 读取 UTF-8 或 UTF-16 LE 文本，返回值不含 BOM；无 BOM 时使用 UTF-8。
+ * 读一个手写的文本文件:按 BOM 选编码,UTF-8 与 UTF-16 LE 都读得出来,BOM 不进返回值。
+ * 没有 BOM 就是 UTF-8。Windows 的 shell 重定向写出的是带 BOM 的 UTF-8 或 UTF-16 LE。
  */
 export function readTextFile(file: string): string {
   const bytes = readFileSync(file);

package/src/deploy.ts

@@ -3,12 +3,11 @@
  * 部署文件中的 providers 字段不参与合并。Core、Persona 与 World 的默认值由各自所有者提供。
  * 运行时共享合并后的配置对象，控制台和调参工具原位更新。
  */
-import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { isAbsolute, resolve } from 'node:path';
 import type { CoreConfig, LLMProviderEntry } from './core/types.ts';
 import { deepMerge, type LoadedConfig } from './core/config.ts';
 import { secretReader } from './core/secrets.ts';
-import { readTextFile } from './core/util.ts';
 import { deploymentRoot, repoRoot as codeRepoRoot } from './paths.ts';
 
 export type { LoadedConfig } from './core/config.ts';
@@ -27,7 +26,10 @@ export function listBots(root = deploymentRoot()): string[] {
 /** 部署根下一份部署都没有时自建的那份，以及它引用的 bot 代码包。 */
 export const DEFAULT_DEPLOYMENT = { name: 'mybot', bot: 'cormini' } as const;
 
-/** 部署目录中的开场引导标记。 */
+/**
+ * 开场引导的一次性标记，放在部署目录下。自建部署时写入，控制台见到它才给引导，操作员
+ * 开口或按下那颗按钮后删除。手动建的部署没有这个文件，也就不会看到引导。
+ */
 export const ONBOARDING_FLAG_FILE = '.onboarding';
 
 /** 部署根下另有用途的目录名，不能拿来当部署名。 */
@@ -88,7 +90,7 @@ function globalProviders(providersDir: string): Record<string, LLMProviderEntry>
     const file = resolve(providersDir, name, 'config.json');
     if (!existsSync(file)) continue;
     try {
-      table[name] = JSON.parse(readTextFile(file)) as LLMProviderEntry;
+      table[name] = JSON.parse(readFileSync(file, 'utf8')) as LLMProviderEntry;
     } catch (err) {
       throw new Error(`${file} 解析失败:${err instanceof Error ? err.message : String(err)}`);
     }
@@ -108,7 +110,7 @@ function packageWorldOverrides(pkgDir: string): Record<string, unknown> {
     const file = resolve(ioDir, id, 'config.json');
     if (!existsSync(file)) continue;
     try {
-      worlds[id] = JSON.parse(readTextFile(file));
+      worlds[id] = JSON.parse(readFileSync(file, 'utf8'));
     } catch (err) {
       throw new Error(`${file} 解析失败:${err instanceof Error ? err.message : String(err)}`);
     }
@@ -135,7 +137,7 @@ export function loadDeployment<C extends CoreConfig>(
   const providers = resolve(providersDir);
   const cfgPath = resolve(dir, 'config.json');
   const raw: Partial<C> & Record<string, unknown> = existsSync(cfgPath)
-    ? (JSON.parse(readTextFile(cfgPath)) as Partial<C> & Record<string, unknown>)
+    ? (JSON.parse(readFileSync(cfgPath, 'utf8')) as Partial<C> & Record<string, unknown>)
     : {};
   // 部署文件不能覆盖共享端点表。
   delete raw.providers;

package/src/providers/README.md

@@ -1,4 +1,4 @@
-<!-- Owner: src/providers/base.ts, src/providers/registry.ts, src/providers/console/settings.ts, src/providers/console/config.ts, src/providers/openai-responses-compat/config.ts -->
+<!-- Owner: src/providers/base.ts, src/providers/registry.ts -->
 
 # src/providers
 
@@ -27,10 +27,9 @@ effort 收任意非空串)、`serviceTiers`、`create(name, entry, host)`。可
 `validateEntry()`、`validateModel()`、`accepts()`(多模态判定)、`config()` 与 `console()`
 (附加配置组与面板)、`prices()`、`estimateTokens()`、`contextOverflow()`。
 
-地址、密钥变量名与图像开关由 `console/config.ts` 声明为 ConfigGroup。模块自己的
-配置通过 `config()` 声明。模块可在 `instance` 插槽中渲染这些 schema,
-通过 `ctx.setConfig` 保存;`console().config` 显式为空时省略独立配置页签,
-配置组仍参与服务端校验。运行时启停和模型操作由面板 invoke 提供。
+地址、密钥变量名与图像开关由控制台的端点面板编辑,模块不为它们声明配置组。模块自己的
+`options.*` 要么走 `config()` 的配置组,要么由 `console()` 声明一块挂进 `instance` 插槽的面板——
+内建 llamacpp 的运行时与模型两段走的是后者。
 
 `create()` 返回 `ProviderInstance`:`client`(实现 `respond`)、`listModels?`、`control?`、
 `compatibilityKey?`、`start?` / `stop?`、`contextWindow?(model)`。

package/src/providers/base.ts

@@ -60,7 +60,7 @@ export interface ProviderInstance {
   contextWindow?(model: string): number | undefined;
 }
 
-/** 端点是否满足本地配置条件；不探测远端可达性或生成结果。 */
+/** 一个端点此刻能不能发起生成。判断只看本地状态,不连上游。 */
 export interface ProviderAvailability {
   ready: boolean;
   /** 不可用的原因,控制台语言;可用时不带。 */

package/src/providers/configuration.ts

@@ -47,7 +47,8 @@ export function validateSpec(
 }
 
 /**
- * 返回第一项不满足的本地条件；通用条件满足后才询问模块。
+ * 端点能不能用:选了模型、声明的密钥读得到,模块自己的条件也满足。
+ * 通用条件不满足就不问模块,第一条不满足的就是回给操作员的那句话。
  */
 export function endpointAvailability(
   module: ProviderModule,

package/src/providers/console/settings.ts

@@ -27,14 +27,13 @@ import { responseRequest } from '../../protocol/open-responses/context-helpers.t
 import { record } from '../../protocol/open-responses/context.ts';
 import { text } from './strings.ts';
 import type { ProviderConsoleHost } from './types.ts';
-import { connectionGroup } from './config.ts';
 
 export type SecretStatus = 'env' | 'file' | 'none';
 
 /** Output token limit used by the connectivity probe. */
 const PROBE_MAX_OUTPUT_TOKENS = 256;
 
-/** 从磁盘加载的密钥变量名按字面匹配。 */
+/** 密钥变量名由操作员自由填写,拼进正则前按字面转义。 */
 function escapeRegExp(s: string): string {
   return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -71,8 +70,7 @@ export class ProviderSettings {
   private declaredGroups(language: Language) {
     return this.modules.flatMap((module) =>
       this.entries(module).flatMap(({ name, entry }) =>
-        [connectionGroup(name, entry, language), ...(module.config?.(name, entry, language) ?? [])]
-          .map((group) => ({ name, group })),
+        (module.config?.(name, entry, language) ?? []).map((group) => ({ name, group })),
       ),
     );
   }
@@ -250,6 +248,7 @@ export class ProviderSettings {
     })) satisfies ConsolePageSource[];
   }
 
+  /** 端点能不能用:通用条件由框架查,模块自己的条件由模块答。 */
   availability(name: string, language: Language = 'zh'): ProviderAvailability {
     const entry = this.config.providers[name];
     if (!entry) return { ready: false, reason: text(language).unknownInstance };
@@ -263,7 +262,8 @@ export class ProviderSettings {
   }
 
   /**
-   * 汇总端点的本地可用性，附第一个可用端点或最后一个不可用原因。
+   * 这批端点里有没有一个能用。灯亮=有;悬停说明给出第一个可用的端点名,
+   * 或者最后一个端点的不可用原因。
    */
   private availableLamp(
     entries: ReadonlyArray<{ name: string }>,
@@ -281,7 +281,7 @@ export class ProviderSettings {
     return { label: S.availableLamp, state: 'offline', hint: reason };
   }
 
-  /** 汇总所有模块的端点可用性。 */
+  /** 所有模块合起来有没有一个可用端点。控制台左栏「语言模型」那一行点的就是它。 */
   providersLamp(language: Language = 'zh'): ConsoleLamp {
     return this.availableLamp(
       this.modules.flatMap((module) => this.entries(module)),
@@ -334,7 +334,7 @@ export class ProviderSettings {
         },
         ...(extra.panels ?? []),
       ],
-      config: extra.config ?? entries.flatMap(
+      config: entries.flatMap(
         ({ name, entry }) => module.config?.(name, entry, language) ?? [],
       ),
       invoke: async (panel, method, args) => {
@@ -358,8 +358,6 @@ export class ProviderSettings {
             instances: this.entries(module).map(({ name, entry }) => ({
               name,
               entry,
-              config: this.declaredGroups(language).filter((item) => item.name === name)
-                .map(({ group }) => ({ group, values: this.values(group.id, language) })),
               secretConfigured: this.secretStatus(name, entry),
               quotes: (entry.spec ? [entry.spec] : []).map((spec) => ({
                 model: spec.model,
@@ -385,7 +383,7 @@ export class ProviderSettings {
         const name = body.name;
         if (method === 'create') {
           this.assertNewName(name, language);
-          // 未设置端点价目覆盖，报价仍可来自模块。
+          // 报价留空:用量页把这条端点的调用记成未计价,而不是零元。
           this.save(name, {
             kind: module.id,
             baseUrl: String(body.baseUrl || module.defaultBaseUrl || ''),

package/src/providers/llamacpp/console/runtime-panel.ts

@@ -3,12 +3,11 @@
  * The endpoint comes from `ctx.scope.instance`; edits are written on change.
  */
 import type { ConsolePanel, ConsolePanelContext } from '../../../web/shared/client-panel.ts';
-import type { ConfigValues } from '../../../core/config-schema.ts';
-import { configField } from '../../../web/client/features/config/view.ts';
-import type { RuntimePanelState } from './server.ts';
+import type { LaunchOptions } from '../options.ts';
+import type { RuntimeState } from '../runtime.ts';
 import { panel } from '../strings.ts';
 
-type Row = RuntimePanelState;
+type Row = RuntimeState & { name: string };
 
 const POLL_MS = 2_000;
 
@@ -43,31 +42,18 @@ export const runtimePanel: ConsolePanel = {
       await load(true);
     }
 
-    async function saveConfig(groupId: string, values: ConfigValues): Promise<void> {
-      if (busy) return;
-      busy = true;
-      message.textContent = '';
-      try {
-        await ctx.setConfig(groupId, values);
-      } catch (error) {
-        message.textContent = String(error);
-      } finally {
-        busy = false;
-      }
-      await load(true);
-    }
-
-    function renderConfig(row: Row, index: number, body: HTMLElement): void {
-      const { group, values } = row.config[index];
-      body.append(ui.section(group.schema.title));
-      for (const [path, property] of Object.entries(group.schema.properties)) {
-        const field = configField(ui, property, values[path], () => {
-          if (field.read) void saveConfig(group.id, { [path]: field.read() });
-        }, ctx.signal);
-        field.node.setAttribute('aria-label', property.title);
-        body.append(ui.field(property.title, field.node));
-        if (property.description) body.append(ui.msgline(property.description));
-      }
+    /** One launch field; empty input sends NaN so the endpoint reports the same error as a bad value. */
+    function launchNumber(row: Row, key: keyof LaunchOptions, label: string, min: number): HTMLElement {
+      const current = row.launch?.[key];
+      const input = ui.input({
+        type: 'number',
+        value: current === undefined ? '' : String(current),
+        onChange: (value) => void act('configure', { launch: { [key]: Number(value) } }),
+      });
+      input.min = String(min);
+      input.step = '1';
+      input.setAttribute('aria-label', label);
+      return ui.field(label, input);
     }
 
     function renderUnmanaged(row: Row, body: HTMLElement): void {
@@ -88,8 +74,42 @@ export const runtimePanel: ConsolePanel = {
         : install.phase === 'extracting' ? ui.pill(S.extracting, 'plain')
         : ui.pill(S.absent, 'off');
 
-      renderConfig(row, 0, body);
-      body.append(ui.kv([{ k: S.installStatus, v: installPill }]));
+      body.append(ui.section(S.runtimeSection, S.runtimeSectionDesc));
+      const release = ui.input({
+        value: row.release ?? '',
+        cls: 'mono',
+        onChange: (value) => void act('configure', { release: value }),
+      });
+      release.setAttribute('aria-label', S.release);
+      const backend = ui.select({
+        value: row.backend ?? '',
+        options: row.backendChoices,
+        onChange: (value) => void act('configure', { backend: value }),
+      });
+      backend.setAttribute('aria-label', S.backend);
+      backend.disabled = row.own;
+      const dir = ui.input({
+        value: row.own ? row.runtimeDir ?? '' : '',
+        cls: 'mono',
+        onChange: (value) => void act('configure', { runtimeDir: value }),
+      });
+      dir.setAttribute('aria-label', S.runtimeDir);
+      const dirRow = ui.rowbar();
+      dirRow.append(dir, ui.button(S.browse, {
+        size: 'sm',
+        onClick: async () => {
+          const picked = await ctx.pickPath({ kind: 'directory', title: S.runtimeDir, currentPath: dir.value });
+          if (picked) await act('configure', { runtimeDir: picked });
+        },
+      }));
+      body.append(
+        ui.field(S.release, release),
+        ui.msgline(S.releaseHint),
+        ui.field(S.backend, backend),
+        ui.field(S.runtimeDir, dirRow),
+        ui.msgline(S.runtimeDirHint),
+        ui.kv([{ k: S.installStatus, v: installPill }]),
+      );
       if (row.smartAppControl === 1) body.append(ui.msgline(S.sacWarning, true));
       if (install.phase === 'downloading' || install.phase === 'extracting') {
         const progress = ui.progress({
@@ -113,7 +133,28 @@ export const runtimePanel: ConsolePanel = {
       installBar.append(ui.h('span', 'grow'), ui.button(S.disable, { onClick: () => void act('disable') }));
       body.append(installBar);
 
-      renderConfig(row, 1, body);
+      body.append(ui.section(S.launchSection, S.launchSectionDesc));
+      const launchRow = ui.rowbar();
+      launchRow.append(
+        launchNumber(row, 'contextSize', S.contextSize, 1),
+        launchNumber(row, 'nGpuLayers', S.nGpuLayers, 0),
+        launchNumber(row, 'parallel', S.parallel, 1),
+      );
+      const extraArgs = ui.input({
+        value: row.launch?.extraArgs ?? '',
+        cls: 'mono',
+        onChange: (value) => void act('configure', { launch: { extraArgs: value } }),
+      });
+      extraArgs.setAttribute('aria-label', S.extraArgs);
+      body.append(
+        launchRow,
+        ui.field(S.extraArgs, extraArgs),
+        ui.msgline(S.extraArgsHint),
+        ui.checkbox(S.autoStart, {
+          checked: row.autoStart,
+          onChange: (checked) => void act('configure', { autoStart: checked }),
+        }).el,
+      );
 
       body.append(ui.section(S.serverSection, S.serverSectionDesc));
       const server = row.server;

package/src/providers/llamacpp/console/server.ts

@@ -8,9 +8,6 @@ import type { ProviderConsoleHost } from '../../console/types.ts';
 import type { RouterCatalog, RouterModel } from '../catalog.ts';
 import { LAUNCH_DEFAULTS, PINNED_RELEASE, backendChoices, defaultBackend, llamacppOptions, type LaunchOptions } from '../options.ts';
 import type { LlamaRuntime } from '../runtime.ts';
-import type { RuntimeState } from '../runtime.ts';
-import { runtimeConfig } from '../config.ts';
-import { getByPath, type ConfigGroup, type ConfigValues } from '../../../core/config-schema.ts';
 import { text } from '../strings.ts';
 
 interface Control {
@@ -26,11 +23,6 @@ export interface ModelsState {
   models: RouterModel[];
 }
 
-export type RuntimePanelState = RuntimeState & {
-  name: string;
-  config: Array<{ group: ConfigGroup; values: ConfigValues }>;
-};
-
 /** The launch fields the panel edits, each optional and applied over the stored values. */
 type LaunchPatch = Partial<Record<keyof LaunchOptions, unknown>>;
 
@@ -50,7 +42,6 @@ export function llamacppConsole(host: ProviderConsoleHost): Partial<ConsolePageC
     return found.entry;
   };
   return {
-    config: [],
     panels: [
       { id: 'runtime', title: S.runtimePanel, description: S.runtimePanelDescription, slot: 'instance' },
       { id: 'models', title: S.modelsPanel, description: S.modelsPanelDescription, slot: 'instance' },
@@ -59,17 +50,7 @@ export function llamacppConsole(host: ProviderConsoleHost): Partial<ConsolePageC
       if (panel === 'runtime') {
         const value = body(args);
         const name = value.name as string;
-        if (method === 'state') {
-          const entry = entryOf(name);
-          const prefix = `providers.${name}.`;
-          const config = runtimeConfig(name, entry, host.language).map((group) => ({
-            group,
-            values: Object.fromEntries(Object.keys(group.schema.properties).map((path) => [
-              path, getByPath(entry as unknown as Record<string, unknown>, path.slice(prefix.length)) ?? '',
-            ])) as ConfigValues,
-          }));
-          return { name, ...(await control(name).runtime.state(host.language)), config } satisfies RuntimePanelState;
-        }
+        if (method === 'state') return { name, ...(await control(name).runtime.state(host.language)) };
         if (method === 'enable') {
           const entry = entryOf(name);
           const options = llamacppOptions(entry);

package/src/providers/llamacpp/index.ts

@@ -4,7 +4,6 @@ import type { Language } from '../../core/language.ts';
 import { isContextOverflow } from '../transport/errors.ts';
 import { modelsRoot, runtimesRoot } from '../../paths.ts';
 import { RouterCatalog } from './catalog.ts';
-import { runtimeConfig } from './config.ts';
 import { llamacppConsole } from './console/server.ts';
 import { LlamaCppProvider } from './native.ts';
 import { backendChoices, llamacppOptions, normalizeLlamaCpp } from './options.ts';
@@ -28,7 +27,6 @@ export default {
   baseUrlSuggestions: ['http://127.0.0.1:8090/v1', 'http://127.0.0.1:8080/v1'],
   normalize: normalizeLlamaCpp,
   console: llamacppConsole,
-  config: runtimeConfig,
   reasoningTiers: reasoningTiers('zh'),
   localize: (language) => ({ reasoningTiers: reasoningTiers(language) }),
   serviceTiers: [],

package/src/providers/llamacpp/options.ts

@@ -42,8 +42,6 @@ export function normalizeLlamaCpp(entry: LLMProviderEntry): LLMProviderEntry {
   if (options.runtime && typeof options.runtime === 'object') {
     const runtime = options.runtime as Partial<RuntimeOptions>;
     options.runtime = { ...runtime, release: runtime.release ?? PINNED_RELEASE, backend: runtime.backend ?? defaultBackend() };
-    if (typeof options.runtime.release === 'string') options.runtime.release = options.runtime.release.trim();
-    if (typeof options.runtime.runtimeDir === 'string') options.runtime.runtimeDir = options.runtime.runtimeDir.trim();
     if (options.runtime.runtimeDir === '') delete options.runtime.runtimeDir;
     options.launch = { ...LAUNCH_DEFAULTS, ...(options.launch ?? {}) };
   }

package/src/providers/llamacpp/strings.ts

@@ -101,9 +101,9 @@ const panelZh = {
     '启动失败时可在 Windows 安全中心核对拦截记录；若确认被拦截，请使用符合信任要求的运行时。',
   server: '服务进程',
   serverSection: '服务进程与端点',
-  serverSectionDesc: '',
+  serverSectionDesc: 'llama-server 本地服务管理与监听状态。',
   runtimeSection: '二进制运行环境',
-  runtimeSectionDesc: '',
+  runtimeSectionDesc: '官方 llama.cpp 二进制包与运行依赖管理。',
   releaseHint: '上游 release tag，如 b10930；换了要重新下载。',
   backendHint: '按本机平台给出的官方构建;CUDA 版自动搭配上游的 cudart 包。',
   runtimeDirHint: '填了就不下载:目录里要有 llama-server 及其动态库(自编译、Linux CUDA、签过名的构建)。',
@@ -141,7 +141,7 @@ const panelZh = {
   pullPlaceholder: 'HuggingFace 仓库,如 ggml-org/Qwen2.5-Coder-7B-Instruct-GGUF',
   localDir: '本机 GGUF 目录',
   cacheDir: '缓存目录',
-  noModels: '暂无 GGUF 模型。可下载模型，或将 .gguf 文件放入本机目录后重新扫描。',
+  noModels: '暂无可用的 GGUF 模型：可通过上方输入拉取，或将 .gguf 文件放入本机目录后点击重扫。',
   modelStatusLabel: {
     loaded: '已加载',
     loading: '加载中',
@@ -175,9 +175,9 @@ const panelEn: typeof panelZh = {
     'If startup fails, check Windows Security for a block record. If a block is confirmed, use a runtime that meets the trust requirements.',
   server: 'Server',
   serverSection: 'Server Process & Endpoint',
-  serverSectionDesc: '',
+  serverSectionDesc: 'llama-server local process and listening status.',
   runtimeSection: 'Binary Runtime Environment',
-  runtimeSectionDesc: '',
+  runtimeSectionDesc: 'Official llama.cpp binary and dependencies.',
   releaseHint: 'Upstream release tag, such as b10930; changing it downloads another build.',
   backendHint: 'Official builds for this platform; CUDA builds are paired with the upstream cudart package.',
   runtimeDirHint: 'When set nothing is downloaded: the directory holds llama-server and its shared libraries (self-built, Linux CUDA, signed builds).',
@@ -215,7 +215,7 @@ const panelEn: typeof panelZh = {
   pullPlaceholder: 'HuggingFace repo, e.g. ggml-org/Qwen2.5-Coder-7B-Instruct-GGUF',
   localDir: 'Local GGUF directory',
   cacheDir: 'Cache directory',
-  noModels: 'No GGUF models. Download a model, or place GGUF files in the local directory and rescan.',
+  noModels: 'No models yet: pull one above, or drop GGUF files into the local directory and rescan.',
   modelStatusLabel: {
     loaded: 'loaded',
     loading: 'loading',

package/src/providers/openai-responses-compat/index.ts

@@ -3,7 +3,6 @@ import type { LLMProviderEntry } from '../../core/types.ts';
 import { isContextOverflow } from '../transport/errors.ts';
 import { ModelCatalog, ResponsesProvider } from './native.ts';
 import { text } from './strings.ts';
-import { protocolConfig } from './config.ts';
 
 /** Suggested base URLs for the console field; operators may enter other URLs. */
 const BASE_URLS: readonly string[] = [
@@ -46,8 +45,6 @@ export default {
   defaultBaseUrl: BASE_URLS[0],
   baseUrlSuggestions: BASE_URLS,
   normalize: normalizeCompat,
-  config: protocolConfig,
-  console: () => ({ config: [] }),
   reasoningTiers: [],
   effortSuggestions: EFFORTS,
   serviceTiers: [],

package/src/web/README.md

@@ -1,4 +1,4 @@
-<!-- Owner: src/web/server.ts, src/web/shared/console-protocol.ts, src/web/shared/client-panel.ts, src/web/client/console-pages/builtins/llm-settings/panel.ts -->
+<!-- Owner: src/web/server.ts, src/web/shared/console-protocol.ts, src/web/shared/client-panel.ts -->
 
 # src/web
 
@@ -50,13 +50,9 @@ manifest 的 `CONSOLE_PROTOCOL_VERSION` 不匹配时，浏览器拒绝加载。
 扩展面板通过 `/assets/extensions/<包>/<版本>/<文件>` 提供，仅允许 manifest 声明的脚本与样式文件。
 
 `createBot()` 通过 `WebAppDeps` 注入事件库、session、运行控制、配置、存储、`consolePageSources` 和扩展信息。
-调试流以 `head` 提供本次 `Persona.sessionHead()` 的合成开头；它不属于持久 session。
-`providersLamp` 汇总本地端点可用性，由状态灯接口提供给浏览器。
 
 ## 浏览器
 
-`llm-settings` 从端点状态中的 ConfigGroup 渲染连接字段与声明的请求路径,使用 `ctx.setConfig` 保存。
-
 `main.ts` 的 `FEATURES` 包含 `live`、`core`、`usage`、`provider`、`world`、`extensions`、`prompts`、
 `appearance`、`settings`。贡献页由 manifest 加载，保留路由段 `provider` 交由 `ConsolePageHost` 处理。
 `features/config/view.ts` 与 `features/storage/view.ts` 是配置组与存储清单的通用视图,运行诊断页与