@fa-software/semi2-dsh 0.0.14-preview.20260927035651 → 0.0.15

package/lib/service/namespaces.js

@@ -1,16 +1,10 @@
-// @fa-software/semi2-dsh/service/namespaces —— 插件自身设置段与官方命名空间的读取（无环叶子模块）。
-// dsh 的设置段 = Profile 插件条目：字段声明（settings-sections）是状态 / 健康 / 工作区 tab 的展示来源，
-// 内容与模型路由一样经设置服务写进官方设置文档（适配器逐请求重读），不写 profile patch。
-// 这里只留读口径与自铸名字的形状。
-import { SEMI2_SETTINGS_ENTRY } from "../contract.js";
-export { SEMI2_SETTINGS_ENTRY };
 /** 本插件自铸的名字形状：路由 `semi2-<32 hex>`、密钥引用 `SEMI2_MODEL_KEY_<大写 hex>`。 */
 export const SELF_MINTED_ROUTE = /^semi2-[\da-f]{32}$/;
 export const SELF_MINTED_KEY_ENV = /^SEMI2_MODEL_KEY_[\dA-F]+$/;
 /** 本插件在官方 `llm-deepseek` 段表达过的三个键：服务端撤下 DEEPSEEK 连接时一并清掉。 */
 export const DEEPSEEK_OVERRIDE_KEYS = ['apiKeyEnv', 'baseURL', 'models'];
 /** 一个设置段的当前有效值：官方描述符的 `value` 是不透明值，本插件只认对象段，其余按空段处理。 */
-export function sectionValue(settings, ns = SEMI2_SETTINGS_ENTRY) {
+export function sectionValue(settings, ns) {
     const value = settings.describe().find(entry => entry.ns === ns)?.value;
     return isRecord(value) ? value : {};
 }
@@ -22,14 +16,14 @@ export function hasSection(settings, ns) {
  * 该段的**用户层**原始内容（只认 `describe()` 的 `user`：组合层与 schema 默认不算用户写过）。
  * 写入前用它保住用户写在同一段里的其他键——`replace` 会把用户层整体对齐到给定内容。
  */
-export function userSection(settings, ns = SEMI2_SETTINGS_ENTRY) {
+export function userSection(settings, ns) {
     return persistedSection(settings.describe(), ns);
 }
 /**
  * 该段的**组合层**内容（`describe()` 的 `base`，已带 schema 默认）＝部署默认；
  * 登出撤下默认模型时用它把选择交还给组合层。
  */
-export function baseSection(settings, ns = SEMI2_SETTINGS_ENTRY) {
+export function baseSection(settings, ns) {
     const base = settings.describe().find(entry => entry.ns === ns)?.base;
     return isRecord(base) ? base : {};
 }

package/lib/service/orchestrator.js

@@ -3,7 +3,6 @@ import { initialState, } from "../hub/facts.js";
 import { DOMAINS } from "./registry.js";
 import { NOOP_WORKSPACE } from "./workspace-ops.js";
 import { CONTRACT_TIMEOUT_MS, CREDENTIAL_RETRY } from "./connection.js";
-import { scheduleStatusPublish } from "./publish.js";
 /** 领域 attach 的等待上限缺省值：超时按「该端不提供此能力」审计（依赖永不到达不能永久悬空）。 */
 const DOMAIN_ATTACH_TIMEOUT_MS = 2_000;
 const DOMAIN_POLL_MS = 25;
@@ -67,9 +66,6 @@ export class Orchestrator {
         this.ctx.emit('semi2/workspaces-updated', this.current);
         this.notifyDomains();
     }
-    requestStatusPublish() {
-        scheduleStatusPublish(this);
-    }
     settings() {
         return this.settingsService;
     }

package/lib/service/ports.js

@@ -27,7 +27,6 @@ export function createPorts(ctx, warn, options = {}) {
         throw new ConfigurationError('CONFIG_APPLY_FAILED');
     };
     const hasWorkspaceController = () => ctx.get('workspaceController', false) !== undefined;
-    const hasWebServer = () => ctx.get('webServer', false) !== undefined;
     return {
         settings: () => {
             const { promise, resolve } = Promise.withResolvers();
@@ -44,17 +43,6 @@ export function createPorts(ctx, warn, options = {}) {
         credentialsNow: () => ctx.get('credentials', false),
         agentDefaultModel: () => ctx.get('agentDefaultModel', false),
         hasWorkspaceController,
-        hasAudience: () => hasWebServer() || hasWorkspaceController(),
-        applyStatusRow: async (ns, section) => {
-            const entry = runtimeEntry(ctx, ns);
-            if (entry === undefined)
-                return false;
-            await entry.update({ config: { ...(entry.options.config ?? {}), ...section } });
-            // 运行期 config 变更本身不广播：设置服务重算摘要时才发 `settings/document-updated`。
-            const settings = ctx.get('settings', false);
-            settings?.describe();
-            return true;
-        },
         replaceNamespace: async (settings, ns, section) => {
             await requireNamespace(settings, ns);
             const replace = settings.replace?.bind(settings);
@@ -75,26 +63,8 @@ export function createPorts(ctx, warn, options = {}) {
             const ops = keys.map(key => ({ op: 'unset', path: [key] }));
             await writes.run(ns, () => mutate(ns, ops));
         },
-        hideSettingsPage: (settings, owner) => {
-            const configure = settings.configure?.bind(settings);
-            if (configure === undefined)
-                return;
-            try {
-                // 回收器挂在本插件光纤上：插件卸载后不留一条指向已死光纤的展示策略。
-                const dispose = configure({ auto: false }, owner.fiber);
-                owner.effect(() => dispose);
-            }
-            catch (error) {
-                warn(`设置页自动生成关闭失败（${error instanceof Error ? error.message : String(error)}）`);
-            }
-        },
     };
 }
-/** 活动条目里按 id 找运行期 config 的写入口；loader 服务或条目缺席都返回 undefined。 */
-function runtimeEntry(ctx, id) {
-    const loader = ctx.get('loader', false);
-    return loader?.entries?.().find(entry => entry.options.id === id);
-}
 /** 等设置段可描述（条目 ACTIVE 且声明了 volatile 字段）；超时返回 false，不抛。 */
 async function waitForNamespace(settings, ns, waitMs) {
     const deadline = Date.now() + waitMs;

package/lib/service/registry.js

@@ -1,3 +1,4 @@
+import { STATUS_BASE_FIELDS } from "../hub/status.js";
 import { defaultModelDomain } from "../domains/default-model/index.js";
 import { modelsDomain } from "../domains/models/index.js";
 import { projectProfileDomain } from "../domains/project-profile/index.js";
@@ -17,3 +18,13 @@ export const DOMAINS = [
     projectProfileDomain,
     redmineDomain,
 ];
+/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；状态视图与健康字段共用这一段。 */
+export const STATUS_FIELDS = [
+    ...STATUS_BASE_FIELDS,
+    ...DOMAINS.flatMap(domain => [...domain.statusKeys]),
+];
+/** 健康字段键（能力 + 领域，值是 `状态:说明` 形式的编码串；读侧拆码）。 */
+export const HEALTH_FIELDS = [
+    'healthWeb',
+    ...DOMAINS.map(domain => `health:${domain.id}`),
+];

package/lib/service/status.js

@@ -0,0 +1,89 @@
+import { statusFields, workspaceTabs, WORKSPACE_TABS_FIELD, } from "../hub/status.js";
+import { aggregateHealth, healthText } from "./health.js";
+import { DOMAINS } from "./registry.js";
+import { reportEvent } from "./audit.js";
+/** 契约钉了凭据（部署目录 env）= 只读部署：登录 / 登出 / 同步对用户关闭（`CREDENTIAL_SOURCE_READONLY`）。 */
+export function credentialsWritable(engine) {
+    const credentials = engine.contract()?.credentials;
+    if (credentials === undefined)
+        return true;
+    const filled = (value) => {
+        const trimmed = value?.trim();
+        return trimmed !== undefined && trimmed !== '';
+    };
+    return !(filled(credentials.configUrl) || filled(credentials.accessToken));
+}
+/**
+ * 一份状态视图：`writable` + 状态字段 + 健康编码（`状态:说明` 串，读侧拆码）+ 工作区 tab。
+ * 值全部是展示标量，不含任何密钥；每次请求从编排层现算。
+ */
+export function statusSection(engine) {
+    const facts = {
+        credentialSource: engine.connection()?.source ?? null,
+        platform: engine.platform,
+        startupDir: engine.startupDir,
+    };
+    const slices = [];
+    for (const descriptor of DOMAINS) {
+        const domain = engine.domains.get(descriptor.id);
+        if (domain !== undefined)
+            slices.push(domain.statusFields(engine.state()));
+    }
+    const health = healthSnapshot(engine);
+    return {
+        writable: credentialsWritable(engine),
+        ...statusFields(engine.state(), facts, slices),
+        ...Object.fromEntries(Object.entries(health).map(([key, item]) => [key, `${item.state}:${healthText(item)}`])),
+        [WORKSPACE_TABS_FIELD]: workspaceTabs(engine.state()),
+    };
+}
+/** 整体读取失败：只落 state.error 与失败态，不注入任何配置（可重载重试）。 */
+export async function failedState(engine, code) {
+    engine.patchState({
+        status: 'failed',
+        error: code,
+        workspaces: engine.workspace().tracked(),
+    });
+    engine.emitConfigUpdated();
+    // 启动期的整体失败落一条运行端事件：判「本端起没起来」不必翻容器日志。
+    await reportEvent(engine, {
+        action: 'SESSION_FAILED',
+        outcome: 'ERROR',
+        code,
+    });
+}
+/** boot 事实 → ready 状态（技能切片取自 skills 领域；项目缓存随装配作废，由工作区同步重取）。 */
+export function appliedState(engine, boot, compiled, errorCode) {
+    const defaultModelId = boot.runtimeDefaultModelId ?? null;
+    const selection = compiled === null || defaultModelId === null
+        ? null
+        : (compiled.selections.get(defaultModelId) ?? null);
+    const skills = engine.peer('skills')?.skills() ?? null;
+    const current = engine.state();
+    return {
+        ...current,
+        status: 'ready',
+        error: errorCode,
+        consoleUrl: engine.connection()?.url ?? current.consoleUrl,
+        loadedAt: new Date().toISOString(),
+        identity: boot.runtimeViewer ?? null,
+        model: selection === null
+            ? null
+            : { id: selection.model, provider: selection.provider },
+        skills,
+        projects: [],
+    };
+}
+/** 健康快照：领域项按注册表（缺席记 unavailable）+ 能力贡献者按登记。 */
+export function healthSnapshot(engine) {
+    return aggregateHealth(DOMAINS.map(domain => domain.id), (id) => {
+        // 本端没有 settings 服务：没有任何领域被装配（写不进去就不装），整端记不适用。
+        if (engine.settingsMissing()) {
+            return { state: 'unavailable', note: '本端无 settings 服务，不注入配置' };
+        }
+        const domain = engine.domains.get(id);
+        if (domain === undefined)
+            return { state: 'unavailable', note: '本端不提供该能力（依赖缺席）' };
+        return domain.health();
+    }, engine.healthContributorsView());
+}

package/lib/types/contract.d.ts

@@ -10,11 +10,6 @@ export declare const SEMI2_SECTION_ORDERS: {
     readonly cnbWorkstation: 4;
 };
 export type Semi2SectionKey = keyof typeof SEMI2_SECTION_ORDERS;
-/**
- * 插件自身设置段的条目 id：dsh 的设置命名空间就是 Profile 插件条目 id（bundle patch 里那一行的 id），
- * 状态 / 健康 / 工作区映射都写在这一段里。host 与浏览器半边共用这一个常量。
- */
-export declare const SEMI2_SETTINGS_ENTRY = "semi2-dsh";
 /** 动作通道前缀：登录 / 登出 / 同步都经官方 connection 的逻辑 RPC，一次调用落在 POST <前缀>/<endpoint>。 */
 export declare const SEMI2_ACTION_CHANNEL = "/semi2";
 /** 只读 systemPrompt 的号段解析接口：老宿主没有 `getSectionOrder` 时回落本表偏移。 */

package/lib/types/domains/project-profile/domain.d.ts

@@ -19,7 +19,7 @@ export interface ProjectProfile {
     } | null;
 }
 /** 项目画像实际消费的宿主接口；测试只需要铸造这些成员。 */
-export interface ProjectProfileHost extends Pick<DomainHost, 'patchState' | 'requestStatusPublish' | 'state' | 'warn'> {
+export interface ProjectProfileHost extends Pick<DomainHost, 'patchState' | 'state' | 'warn'> {
     api: Pick<DomainHost['api'], 'projectProfile'>;
     peer: (id: 'workspace') => {
         projectForCwd: (cwd: string | undefined) => Promise<{

package/lib/types/domains/types.d.ts

@@ -130,7 +130,7 @@ export interface DomainService {
 export interface DomainHost {
     /** 领域 apply 内同步调用：登记本领域；编排层等齐注册表全部领域后才开始首轮取数。 */
     attach(service: DomainService): void;
-    /** 共享状态打补丁（编排层持有唯一权威副本，发布与事件也由它负责）。 */
+    /** 共享状态打补丁（编排层持有唯一权威副本，事件也由它负责；状态视图按请求现算）。 */
     patchState(patch: Partial<Semi2ConfigState>): void;
     readonly api: Semi2Api;
     readonly ports: Ports;
@@ -145,8 +145,6 @@ export interface DomainHost {
     /** 当前是否持有连接凭据（未连接时按需取数直接跳过，不问 hub）。 */
     hasConnection(): boolean;
     emitWorkspacesUpdated(): void;
-    /** 会话期产生的新状态（项目画像同步结果）：请求编排层立刻回写状态页；fire-and-forget。 */
-    requestStatusPublish(): void;
     /** 迟绑定的跨领域事实：按 id 取 peer 接口；该领域未就位返回 undefined。 */
     peer<K extends DomainId>(id: K): DomainPeers[K] | undefined;
 }

package/lib/types/index.d.ts

@@ -5,7 +5,7 @@ export type { RuntimeIdentity, RuntimeSkillFact, RuntimeSkillFileContentFact, Ru
 export type { ConfigStatus, Semi2Config, Semi2Audit, Semi2Health, Semi2Session, } from './service/config-service.ts';
 export type { HeadlessModelOutcome } from './domains/types.ts';
 export type { Semi2PlatformKind } from './hub/facts.ts';
-export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, SEMI2_SETTINGS_ENTRY, runtimeFromCnbEnv, semi2SectionOrder, } from './contract.ts';
+export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, runtimeFromCnbEnv, semi2SectionOrder, } from './contract.ts';
 export type { SectionOrderSource, Semi2Credentials, Semi2Platform, Semi2Runtime, Semi2SectionKey, } from './contract.ts';
 import './events.ts';
 export declare const name = "semi2-dsh";

package/lib/types/service/config-service.d.ts

@@ -66,7 +66,9 @@ export interface ConfigurationInstall {
     session: Semi2Session;
     /** 诊断接口 → `ctx.semi2Health`。 */
     health: Semi2Health;
-    /** 上报接口 → `ctx.semi2Audit`。 */
+    /** 状态视图（`GET /semi2/status` 按请求现算）→ web 路由。 */
+    status(): Record<string, unknown>;
+    /** 上报接口 → `ctx.semi2Audit`：运行端（NPC 端）回报生命周期与交付事实，失败只 warn。 */
     audit: Semi2Audit;
     /** 能力项（web 应用）登记健康贡献者。 */
     registerHealth(contributor: HealthContributor): void;

package/lib/types/service/lifecycle.d.ts

@@ -5,7 +5,7 @@ export declare function start(engine: OrchestratorInternals): Promise<void>;
 export declare function reload(engine: OrchestratorInternals): Promise<ReturnType<OrchestratorInternals['state']>>;
 /**
  * 界面「同步」动作：`workspace:<slug>` 只同步那一个工作区，其余（含空串）整体重载。
- * 两条路都补发状态行；失败只 warn（面板上的错误由状态字段承载）。
+ * 失败只 warn（面板上的错误由状态字段承载，浏览器半边动作返回后会重新拉取）。
  */
 export declare function syncByScope(engine: OrchestratorInternals, scope: string): Promise<void>;
 /** 读取一次运行配置；整体失败只落 state.error，绝不 throw（start/reload 均可重试）。 */

package/lib/types/service/namespaces.d.ts

@@ -1,22 +1,20 @@
-import { SEMI2_SETTINGS_ENTRY } from '../contract.ts';
 import type { SettingsLike } from './ports.ts';
-export { SEMI2_SETTINGS_ENTRY };
 /** 本插件自铸的名字形状：路由 `semi2-<32 hex>`、密钥引用 `SEMI2_MODEL_KEY_<大写 hex>`。 */
 export declare const SELF_MINTED_ROUTE: RegExp;
 export declare const SELF_MINTED_KEY_ENV: RegExp;
 /** 本插件在官方 `llm-deepseek` 段表达过的三个键：服务端撤下 DEEPSEEK 连接时一并清掉。 */
 export declare const DEEPSEEK_OVERRIDE_KEYS: readonly ["apiKeyEnv", "baseURL", "models"];
 /** 一个设置段的当前有效值：官方描述符的 `value` 是不透明值，本插件只认对象段，其余按空段处理。 */
-export declare function sectionValue(settings: SettingsLike, ns?: string): Record<string, unknown>;
+export declare function sectionValue(settings: SettingsLike, ns: string): Record<string, unknown>;
 /** 设置段是否已可描述（条目 ACTIVE 且声明了 volatile 字段）。 */
 export declare function hasSection(settings: SettingsLike, ns: string): boolean;
 /**
  * 该段的**用户层**原始内容（只认 `describe()` 的 `user`：组合层与 schema 默认不算用户写过）。
  * 写入前用它保住用户写在同一段里的其他键——`replace` 会把用户层整体对齐到给定内容。
  */
-export declare function userSection(settings: SettingsLike, ns?: string): Record<string, unknown>;
+export declare function userSection(settings: SettingsLike, ns: string): Record<string, unknown>;
 /**
  * 该段的**组合层**内容（`describe()` 的 `base`，已带 schema 默认）＝部署默认；
  * 登出撤下默认模型时用它把选择交还给组合层。
  */
-export declare function baseSection(settings: SettingsLike, ns?: string): Record<string, unknown>;
+export declare function baseSection(settings: SettingsLike, ns: string): Record<string, unknown>;

package/lib/types/service/orchestrator.d.ts

@@ -14,7 +14,6 @@ export interface OrchestratorInternals {
     readonly api: Semi2Api;
     readonly ports: Ports;
     readonly environment: NodeJS.ProcessEnv;
-    /** 本进程唯一的内存配置覆盖器（含上一轮行集与残留警告去重）。 */
     /** 启动目录（迁移与状态展示共用同一个事实；状态渲染因此保持纯函数）。 */
     readonly startupDir: string;
     readonly contractTimeoutMs: number;
@@ -85,7 +84,6 @@ export declare class Orchestrator implements DomainHost, OrchestratorInternals {
     setCurrent(next: Semi2ConfigState): void;
     patchState(patch: Partial<Semi2ConfigState>): void;
     emitWorkspacesUpdated(): void;
-    requestStatusPublish(): void;
     settings(): SettingsLike | undefined;
     setSettings(settings: SettingsLike | undefined): void;
     settingsMissing(): boolean;

package/lib/types/service/ports.d.ts

@@ -18,22 +18,10 @@ export type SettingsLike = Pick<SettingsForms, 'describe' | 'update'> & Partial<
 export type AgentDefaultModelLike = Partial<Pick<AgentDefaultModelConfig, 'currentSelection'>> & {
     saveSelection(next: ModelSelection): Promise<void>;
 };
-/** loader 里的一个 profile 条目：只留运行期 config 的读写面（`update` 走官方 volatile 提交）。 */
-export interface RuntimeEntryLike {
-    options: {
-        id?: string | undefined;
-        config?: Record<string, unknown> | undefined;
-    };
-    update: (options: {
-        config: Record<string, unknown>;
-    }) => Promise<unknown>;
-}
 /**
- * 本插件消费的 dsh loader 服务接口：`entries()` 列出活动条目，`await()` 等整棵树空闲。
- * `update({ config })` 只改运行期 config（volatile 字段原地提交、不重挂载），因此不落盘。
+ * 本插件消费的 dsh loader 服务接口：`await()` 等整棵树空闲（设置写入的宿主就绪门）。
  */
 export interface LoaderLike {
-    entries?: (() => RuntimeEntryLike[]) | undefined;
     await?: (() => Promise<unknown>) | undefined;
 }
 export interface PortsOptions {
@@ -55,18 +43,6 @@ export interface Ports {
     agentDefaultModel(): AgentDefaultModelLike | undefined;
     /** workspaceController 的即时宽松读取（缺席 = headless 应用，走隐式工作区）。 */
     hasWorkspaceController(): boolean;
-    /**
-     * 本端有没有状态行的读者：有网页服务（客户端）或有 dsh 工作区服务都算。
-     * 两个都没有 = NPC 那样的一次性 headless 容器，状态段发了也没人看。
-     */
-    hasAudience(): boolean;
-    /**
-     * 状态段的内存行：把展示状态写进该 loader 条目的**运行期 config**（官方 volatile 提交，不落盘、不重挂载），
-     * 盘上组合层里用户写的调参原样保留。随后让官方设置服务重算一次摘要——浏览器半边的 describe 镜像靠
-     * 它发出的 `settings/document-updated` 重读，否则运行期 config 变更对客户端不可见。
-     * 返回 false = 条目还不在 loader 树里（激活时序），调用方按「没发出去」重判。
-     */
-    applyStatusRow(ns: string, section: Record<string, unknown>): Promise<boolean>;
     /**
      * 权威写入：把该条目的用户层整体对齐到给定内容。
      * `update` 是**递归合并**（dsh-settings 的 mergeLayers），只增不减——服务端撤掉的条目
@@ -76,7 +52,5 @@ export interface Ports {
     replaceNamespace(settings: SettingsLike, ns: string, section: object): Promise<void>;
     /** 按路径删除本插件写过的键（合并写入删不掉；命中组合层的键会回继承该值）。 */
     clearKeys(settings: SettingsLike, ns: string, keys: readonly string[]): Promise<void>;
-    /** 关掉该条目自动生成的设置页（状态段只作展示，不是给用户编辑的表单）。 */
-    hideSettingsPage(settings: SettingsLike, owner: Context): void;
 }
 export declare function createPorts(ctx: Context, warn: (message: string) => void, options?: PortsOptions): Ports;

package/lib/types/service/registry.d.ts

@@ -1,3 +1,7 @@
 import type { DomainPlugin } from '../domains/types.ts';
 /** 挂载顺序 = 领域间数据流顺序：models 先落地编译产物（secrets 的回收与 default-model 的选择都依赖它）。 */
 export declare const DOMAINS: readonly DomainPlugin[];
+/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；状态视图与健康字段共用这一段。 */
+export declare const STATUS_FIELDS: readonly string[];
+/** 健康字段键（能力 + 领域，值是 `状态:说明` 形式的编码串；读侧拆码）。 */
+export declare const HEALTH_FIELDS: readonly string[];

package/lib/types/service/status.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeBootFacts } from '../api/index.ts';
+import type { LoadRun } from '../domains/types.ts';
+import type { Semi2ConfigState } from '../hub/facts.ts';
+import type { OrchestratorInternals } from './orchestrator.ts';
+/** 契约钉了凭据（部署目录 env）= 只读部署：登录 / 登出 / 同步对用户关闭（`CREDENTIAL_SOURCE_READONLY`）。 */
+export declare function credentialsWritable(engine: OrchestratorInternals): boolean;
+/**
+ * 一份状态视图：`writable` + 状态字段 + 健康编码（`状态:说明` 串，读侧拆码）+ 工作区 tab。
+ * 值全部是展示标量，不含任何密钥；每次请求从编排层现算。
+ */
+export declare function statusSection(engine: OrchestratorInternals): Record<string, unknown>;
+/** 整体读取失败：只落 state.error 与失败态，不注入任何配置（可重载重试）。 */
+export declare function failedState(engine: OrchestratorInternals, code: string): Promise<void>;
+/** boot 事实 → ready 状态（技能切片取自 skills 领域；项目缓存随装配作废，由工作区同步重取）。 */
+export declare function appliedState(engine: OrchestratorInternals, boot: RuntimeBootFacts, compiled: LoadRun['compiled'], errorCode: string | null): Semi2ConfigState;
+/** 健康快照：领域项按注册表（缺席记 unavailable）+ 能力贡献者按登记。 */
+export declare function healthSnapshot(engine: OrchestratorInternals): import("./health.ts").HealthSnapshot;

package/lib/types/web/routes.d.ts

@@ -4,15 +4,17 @@ import { type RequestFence } from './fence.ts';
 /** 注册路由所需的 webServer 服务（dsh-host-webserver 的 `register`）。 */
 export type WebServerRouteSink = Pick<WebServer, 'register'>;
 /**
- * 本模块消费的配置项（健康快照）：由入口按运行实例直接传入。
+ * 本模块消费的配置项，由入口按运行实例直接传入。
  * 不用 `ctx.get('semi2Health')`——同 fiber 在 apply 里刚 provide 的严格查找会拿到 undefined。
  */
 export interface RouteRuntime {
     /** 健康快照（诊断与端到端断言用；GET /semi2/health）。 */
     health(): Record<string, unknown>;
+    /** 状态视图（GET /semi2/status）：浏览器半边经它拉取展示状态。 */
+    status(): Record<string, unknown>;
 }
 /**
- * 注册健康路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
+ * 注册只读路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
  * `connection`）。模块内不做「依赖缺席就静默不装」的判断；注册一律走 ctx.effect 保证可回收。
  */
 export declare function installRoutes(ctx: Context, webServer: WebServerRouteSink, runtime: RouteRuntime, fence: RequestFence): void;

package/lib/web/routes.js

@@ -1,14 +1,16 @@
 import { rejected } from "./fence.js";
 import { sendJson as send } from "./json.js";
 const HEALTH_PATH = '/semi2/health';
+/** 浏览器半边唯一的状态来源：状态 / 健康 / 工作区 tab 按请求现算。 */
+const STATUS_PATH = '/semi2/status';
 /**
- * 注册健康路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
+ * 注册只读路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
  * `connection`）。模块内不做「依赖缺席就静默不装」的判断；注册一律走 ctx.effect 保证可回收。
  */
 export function installRoutes(ctx, webServer, runtime, fence) {
-    ctx.effect(() => webServer.register({
+    const get = (path, produce) => ctx.effect(() => webServer.register({
         kind: 'exact',
-        path: HEALTH_PATH,
+        path,
         handler: (req, res) => {
             if (rejected(req, res, fence))
                 return;
@@ -16,7 +18,9 @@ export function installRoutes(ctx, webServer, runtime, fence) {
                 send(res, 405, { code: 'METHOD_NOT_ALLOWED' });
                 return;
             }
-            send(res, 200, runtime.health());
+            send(res, 200, produce());
         },
     }));
+    get(HEALTH_PATH, () => runtime.health());
+    get(STATUS_PATH, () => runtime.status());
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fa-software/semi2-dsh",
-  "version": "0.0.14-preview.20260927035651",
+  "version": "0.0.15",
   "type": "module",
   "description": "Semi2 单插件：semi2-hub 配置引导 + 公共 Web 能力。",
   "license": "MIT",