@fa-software/semi2-dsh 0.0.13 → 0.0.14-preview.20260922151653

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

@@ -0,0 +1,59 @@
+import type { DomainHost, DomainService, LoadRun, RevertRun } from '../types.js';
+import type { Semi2ConfigState } from '../../hub/facts.js';
+/** MCP 服务的命名空间（工具名 = `mcp__redmine__<tool>`）。 */
+export declare const REDMINE_SERVER_NAME = "redmine";
+/** 一次挂载的完整配置（形状由官方 mcp-client 的 Config 决定，这里逐字段收口）。 */
+export interface RedmineMcpConfig {
+    transport: 'stdio';
+    serverName: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd: string;
+    toolCallTimeoutMs: number;
+    failOnStartupError: boolean;
+}
+/** 挂载句柄：就绪面（激活 + 首次连接与工具发现）+ 官方 fiber 的卸载面。 */
+export interface MountedServer {
+    /** true = 工具已注册；false = 到上限仍未就绪或激活失败（光纤留着，官方那边会自己重连）。 */
+    ready: Promise<boolean>;
+    dispose(): Promise<void>;
+}
+/** 领域依赖的运行面能力（插件上下文与 process.env 都在 index.ts 里收口，领域自己不认识 cordis）。 */
+export interface RedmineFaces {
+    /** 挂一根官方 mcp-client 光纤；缺闭包 / 配置不合法时 reject（只 warn 降级）。 */
+    mount(config: RedmineMcpConfig): Promise<MountedServer>;
+    /** 起进程的命令与工作目录（env 覆盖、已登记工作区）。 */
+    command(): string;
+    cwd(): string;
+}
+/** boot 事实 → 挂载配置；密钥只进子进程 env，不落盘、不进日志。 */
+export declare function redmineMcpConfig(baseUrl: string, apiKey: string, faces: Pick<RedmineFaces, 'command' | 'cwd'>): RedmineMcpConfig;
+export declare class RedmineDomain implements DomainService {
+    private readonly host;
+    private readonly faces;
+    readonly id: "redmine";
+    private mounted;
+    private degraded;
+    private pending;
+    constructor(host: DomainHost, faces: RedmineFaces);
+    /**
+     * boot 事实落地：
+     * - 块缺失 / null（读取失败）→ 只 warn，保持现状（不动已挂的服务）；
+     * - 两项齐备 → 配置没变就不重挂，变了先卸再挂；
+     * - 任一项 null（权威未配置）→ 卸载。
+     */
+    applyBoot(run: LoadRun): Promise<void>;
+    /** 登出 / 服务端整体撤下：Redmine 工具随身份一起收走。 */
+    revert(_run: RevertRun): Promise<void>;
+    private unmount;
+    statusFields(state: Semi2ConfigState): Record<string, string>;
+    summary(state: Semi2ConfigState): string | null;
+    health(): {
+        state: "ok";
+        note: string;
+    } | {
+        state: "degraded";
+        note: string;
+    };
+}

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

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { DomainPlugin } from '../types.js';
+import { type RedmineFaces } from './domain.js';
+/** 起进程的命令：镜像里在 PATH 上；npm 消费者可用 `SEMI2_REDMINE_MCP_BIN` 指到别处（同 CodeGraph 口径）。 */
+export declare function redmineMcpCommand(env: NodeJS.ProcessEnv): string;
+/** 子进程工作目录 = 本面工作目录（同 CodeGraph 挂载行）。 */
+export declare function redmineMcpCwd(env: NodeJS.ProcessEnv): string;
+/** 运行面能力：动态 import 官方包 + 在本领域的 ctx 上挂一根光纤（dispose 由领域持有）。 */
+export declare function createRedmineFaces(ctx: Context): RedmineFaces;
+export declare const redmineDomain: DomainPlugin;

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

@@ -13,7 +13,7 @@ export declare class SkillsDomain implements DomainService, SkillsPeer {
     invalidate(): void;
     skills(): RuntimeSkillFact[] | null;
     /**
-     * 控制台技能目录：`runtimeSkills` 为 null/undefined 都算「没拿到权威目录」——null 只降级该块，
+     * 控制台技能目录：`runtimeSkillCatalog` 为 null/undefined 都算「没拿到权威目录」——null 只降级该块，
      * null ≠ 空数组（provider 据此报 complete:false，dsh 才不把抖动缓存成空目录）。
      */
     applyBoot(run: LoadRun): Promise<void>;

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

@@ -4,7 +4,7 @@ import type { RuntimeSkillFact, RuntimeSkillFileContentFact, Semi2ConfigState }
 import type { CompiledConfiguration, RuntimeProject } from '../hub/compile.js';
 import type { WorkspaceEntry } from '../hub/workspace-book.js';
 import type { Ports, SettingsLike } from '../service/ports.js';
-/** 本插件写过什么的归属表（`semi2-providers` 命名空间；models 记 routes/deepseek、secrets 记 credentials）。 */
+/** 本插件写过什么的归属表（插件自身设置段；models 记 routes/deepseek、secrets 记 credentials）。 */
 export interface OwnedFacts {
     /** 注入到 `llm-pi-ai` 的路由（最终落地的键）。 */
     routes: string[];
@@ -12,6 +12,8 @@ export interface OwnedFacts {
     credentials: string[];
     /** 是否覆盖着内置 `llm-deepseek` 段。 */
     deepseek: boolean;
+    /** 写入官方 DeepSeek 搜索段的密钥引用；null = 当前值归用户或未写。 */
+    deepseekSearchKeyEnv: string | null;
 }
 /** 附件读取结果：null = 本次放弃物化（调用方保留正文）；空数组 = 权威「没有附件」。 */
 export interface SkillsFileOutcome {
@@ -31,6 +33,9 @@ export interface SecretsPeer {
 /** 自画像领域没有跨领域被调的成员（注入段由领域自己注册）；占位同 SecretsPeer 口径。 */
 export interface SelfPortraitPeer {
 }
+/** Redmine 领域没有跨领域被调的成员（挂载与卸载都由它自己的生命周期驱动）；占位同 SecretsPeer 口径。 */
+export interface RedminePeer {
+}
 export interface SkillsPeer {
     /** 当前控制台技能目录（null = 没拿到权威目录，≠ 空目录）。 */
     skills(): RuntimeSkillFact[] | null;
@@ -89,6 +94,7 @@ export interface DomainPeers {
     workspace: WorkspacePeer;
     'default-model': DefaultModelPeer;
     'self-portrait': SelfPortraitPeer;
+    redmine: RedminePeer;
 }
 /** 一轮 boot 装配的共享上下文（编排层创建，按注册表顺序流经各领域）。 */
 export interface LoadRun {
@@ -170,4 +176,4 @@ export interface DomainPlugin {
     readonly inject?: readonly string[];
     apply(ctx: Context, config: DomainMountConfig): void;
 }
-export type DomainId = 'models' | 'secrets' | 'skills' | 'workspace' | 'default-model' | 'self-portrait';
+export type DomainId = 'models' | 'secrets' | 'skills' | 'workspace' | 'default-model' | 'self-portrait' | 'redmine';

package/lib/types/hub/facts.d.ts

@@ -22,6 +22,11 @@ export interface RuntimeSkillFileContentFact {
     mimeType: string;
     isExecutable: boolean;
 }
+/** dsh 调用策略：两个目录各自独立，false/false 的技能不会从 hub 下发。 */
+export interface RuntimeSkillInvocationFact {
+    modelInvocable: boolean;
+    userInvocable: boolean;
+}
 /** 运行面下发的技能事实；`content` 是正文（frontmatter 已剥），是否对本 cwd 生效由 provider 裁定。 */
 export interface RuntimeSkillFact {
     id: string;
@@ -30,6 +35,9 @@ export interface RuntimeSkillFact {
     name: string;
     description: string;
     whenToUse: string | null;
+    invocation: RuntimeSkillInvocationFact;
+    /** dsh 标准 metadata；null = 未配置。 */
+    metadata: Record<string, unknown> | null;
     content: string;
     version: number;
     /** 附件清单（boot 只给清单，字节走 `skillFiles`）；无附件为空数组。 */
@@ -41,6 +49,14 @@ export interface RuntimeIdentity {
     username: string;
     displayName: string;
 }
+/**
+ * Redmine 接缝事实：地址来自全局配置、密钥来自本人；两项齐备运行面才挂只读 MCP 服务。
+ * 与服务端契约同口径——任一为 null 就是权威「这一项没配」。
+ */
+export interface RuntimeRedmineFact {
+    baseUrl: string | null;
+    apiKey: string | null;
+}
 export interface Semi2ConfigState {
     status: ConfigStatus;
     /** 最近一次成功读取的时间（ISO），未成功过为 null。 */
@@ -61,6 +77,8 @@ export interface Semi2ConfigState {
      * 注入段按它现读——两种空都不注入。
      */
     selfPortrait: string | null;
+    /** Redmine 地址 + 本人密钥：null = 没拿到（不改变现状），任一字段 null = 权威未配置（不挂服务）。 */
+    redmine: RuntimeRedmineFact | null;
     /** 已登记工作区命中的项目（含生效绑定，按 slug 现取并缓存）；会话按 cwd 经 `projectFor` 匹配。 */
     projects: RuntimeProject[];
     /** 已登记工作区（dsh 工作区 → git 项目映射）；未接入工作区服务时为单条隐式条目。 */

package/lib/types/index.d.ts

@@ -5,47 +5,51 @@ export type { RuntimeIdentity, RuntimeSkillFact, RuntimeSkillFileContentFact, Ru
 export type { ConfigStatus, Semi2Config, Semi2Audit, Semi2Health, Semi2Session, } from './service/config-service.js';
 export type { HeadlessModelOutcome } from './domains/types.js';
 export type { Semi2Surface } from './hub/facts.js';
-export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, runtimeFromCnbEnv, runtimeFromContainerEnv, semi2SectionOrder, } from './contract.js';
+export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, SEMI2_SETTINGS_ENTRY, runtimeFromCnbEnv, runtimeFromContainerEnv, semi2SectionOrder, } from './contract.js';
 export type { SectionOrderSource, Semi2Credentials, Semi2Platform, Semi2Runtime, Semi2SectionKey, } from './contract.js';
 import './events.js';
 export declare const name = "semi2-dsh";
 /**
  * 可调参数：默认值 = 各模块曾经的常量；bundle patch 行不写 config，消费方 overlay 才覆盖。
  * 「config 明确值 → 环境变量 → 内置常量」的取值顺序在 apply 里一次归一。
+ *
+ * 状态 / 健康 / 工作区 tab / 归属表 / 工作区映射（`STATE_CONFIG_FIELDS`）同在这一段里，但全部声明为
+ * volatile（可实时写、不重挂载）：dsh 的 `describe()` 只认有 volatile 字段的条目，本插件的设置段
+ * 靠它才存在。这些字段一律经 `describe()` 读写，不在 `apply` 里当普通值取（volatile 字段在 config 上是引用）。
  */
-export declare const Config: z<Schemastery.ObjectS<{
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     /** 等运行面契约（`semi2Runtime`）出现的上限：超时按宿主直跑处理。 */
-    contractTimeoutMs: z<number, number>;
+    contractTimeoutMs: z<number, number, "defined">;
     /** 等领域装配的上限：超时的领域记「本面不提供该能力」。 */
-    domainAttachTimeoutMs: z<number, number>;
+    domainAttachTimeoutMs: z<number, number, "defined">;
     /** 等 settings 服务的上限：本面无该服务时不阻塞启动。 */
-    settingsTimeoutMs: z<number, number>;
-    /** 等命名空间注册完成再写的上限。 */
-    namespaceWaitMs: z<number, number>;
+    settingsTimeoutMs: z<number, number, "defined">;
+    /** 等设置段可读可写（条目 ACTIVE 且声明了 volatile 字段）的上限。 */
+    namespaceWaitMs: z<number, number, "defined">;
     /** 凭据存储首次读盘的重试次数与间隔。 */
-    credentialRetryTries: z<number, number>;
-    credentialRetryIntervalMs: z<number, number>;
+    credentialRetryTries: z<number, number, "defined">;
+    credentialRetryIntervalMs: z<number, number, "defined">;
     /** webServer 在而校验面迟迟不出现时，多久补一条诊断日志。 */
-    webFenceTimeoutMs: z<number, number>;
-    /** 登录 / 登出 / 健康路由的请求体上限（字节）。 */
-    webRouteBodyLimitBytes: z<number, number>;
-}>, Schemastery.ObjectT<{
+    webFenceTimeoutMs: z<number, number, "defined">;
+    /** 登录 / 登出 / 同步 / 健康路由的请求体上限（字节）。 */
+    webRouteBodyLimitBytes: z<number, number, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
     /** 等运行面契约（`semi2Runtime`）出现的上限：超时按宿主直跑处理。 */
-    contractTimeoutMs: z<number, number>;
+    contractTimeoutMs: z<number, number, "defined">;
     /** 等领域装配的上限：超时的领域记「本面不提供该能力」。 */
-    domainAttachTimeoutMs: z<number, number>;
+    domainAttachTimeoutMs: z<number, number, "defined">;
     /** 等 settings 服务的上限：本面无该服务时不阻塞启动。 */
-    settingsTimeoutMs: z<number, number>;
-    /** 等命名空间注册完成再写的上限。 */
-    namespaceWaitMs: z<number, number>;
+    settingsTimeoutMs: z<number, number, "defined">;
+    /** 等设置段可读可写（条目 ACTIVE 且声明了 volatile 字段）的上限。 */
+    namespaceWaitMs: z<number, number, "defined">;
     /** 凭据存储首次读盘的重试次数与间隔。 */
-    credentialRetryTries: z<number, number>;
-    credentialRetryIntervalMs: z<number, number>;
+    credentialRetryTries: z<number, number, "defined">;
+    credentialRetryIntervalMs: z<number, number, "defined">;
     /** webServer 在而校验面迟迟不出现时，多久补一条诊断日志。 */
-    webFenceTimeoutMs: z<number, number>;
-    /** 登录 / 登出 / 健康路由的请求体上限（字节）。 */
-    webRouteBodyLimitBytes: z<number, number>;
-}>>;
+    webFenceTimeoutMs: z<number, number, "defined">;
+    /** 登录 / 登出 / 同步 / 健康路由的请求体上限（字节）。 */
+    webRouteBodyLimitBytes: z<number, number, "defined">;
+}>>, "plain">;
 export type Config = Schemastery.TypeT<typeof Config>;
 /** apply 内归一后的不可变参数（配置面 → 编排 / web 面的唯一形状）。 */
 export interface InstallOptions {

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

@@ -1,5 +1,15 @@
 import type { OrchestratorInternals } from './orchestrator.js';
 import type { RuntimeEventReport } from '../api/index.js';
+/** 上报结果：调用方（NPC 面的 `semi2Audit` 出口）要据此记一行「未接受」。 */
+export interface ReportOutcome {
+    ok: boolean;
+    code: string | null;
+}
+/**
+ * 上报一条运行面事件并回结果：本面标识（`face`）与运行面契约里的任务引用在这里补齐，
+ * 调用方（会话订阅 / 适配器）不必各自知道这两个事实从哪来。
+ */
+export declare function reportEventResult(engine: OrchestratorInternals, event: RuntimeEventReport): Promise<ReportOutcome>;
 /** 生命周期事件：动作名与结果名都用 hub SDL 的枚举名，两侧不各维护一张映射表。 */
 export declare function reportEvent(engine: OrchestratorInternals, event: RuntimeEventReport): Promise<void>;
 /** 本面标识：契约里有就用它；宿主直跑没有契约，记 host。 */

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

@@ -22,7 +22,7 @@ export interface Semi2Config {
         cwd?: string;
     }): Promise<HeadlessModelOutcome>;
 }
-/** 动作面（`ctx.semi2Session`）：设置页登录 / 登出；web 路由仍由入口传参取（同 fiber 严格查找拿不到）。 */
+/** 动作面（`ctx.semi2Session`）：设置页登录 / 登出 / 同步；web 路由仍由入口传参取（同 fiber 严格查找拿不到）。 */
 export interface Semi2Session {
     /** 一步换取用户密钥 → 写入 dsh credentials 存储 → 立即重新读取；失败抛（code 由 UI 展示）。 */
     login(input: {
@@ -34,6 +34,8 @@ export interface Semi2Session {
     }>;
     /** 清掉登录凭据，并把本插件写过的本地条目整体回收；部署面凭据不受影响。 */
     logout(): Promise<void>;
+    /** 界面「同步」：`workspace:<slug>` 只同步该工作区，其余（含空串）整体重载；失败只 warn。 */
+    sync(scope: string): Promise<void>;
 }
 /** 诊断面（`ctx.semi2Health`）：健康快照，诊断路由与设置页健康行共用。 */
 export interface Semi2Health {

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

@@ -3,6 +3,11 @@ import type { OrchestratorInternals } from './orchestrator.js';
 export declare function start(engine: OrchestratorInternals): Promise<void>;
 /** 手动重新读取并应用；未配凭据时只重解析连接（登录/登出显式重走两条路）。 */
 export declare function reload(engine: OrchestratorInternals): Promise<ReturnType<OrchestratorInternals['state']>>;
+/**
+ * 界面「同步」动作：`workspace:<slug>` 只同步那一个工作区，其余（含空串）整体重载。
+ * 两条路都把结果回写状态段；失败只 warn（面板上的错误由状态字段承载）。
+ */
+export declare function syncByScope(engine: OrchestratorInternals, scope: string): Promise<void>;
 /** 读取一次运行配置；整体失败只落 state.error，绝不 throw（start/reload 均可重试）。 */
 export declare function load(engine: OrchestratorInternals): Promise<ReturnType<OrchestratorInternals['state']>>;
 /** 密码登录 → 写 dsh credentials 存储 → 立即重新读取；失败抛（code 由 UI 展示）。 */

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

@@ -1,24 +1,22 @@
 import z from '@deepseek-ai/schemastery';
+import { SEMI2_SETTINGS_ENTRY } from '../contract.js';
 import type { OwnedFacts } from '../domains/types.js';
 import type { WorkspaceEntry } from '../hub/workspace-book.js';
 import type { SettingsLike } from './ports.js';
-/** 侧栏 Semi2 主页面的命名空间：sync 由 UI 写（触发重载），状态字段由本插件写（展示）。 */
-export declare const SETTINGS_NAMESPACE = "semi2";
-/** 归属表：预设连接的路由键就是 dsh 的提供方 id，光看名字分不清是插件的还是用户手写的 profile。 */
-export declare const OWNED_NAMESPACE = "semi2-providers";
-/** 工作区 → git 项目映射的持久化命名空间：本地事实（换台机器要重解析），只存目录与解析结果。 */
-export declare const WORKSPACES_NAMESPACE = "semi2-workspaces";
-export declare const OWNED_SCHEMA: z<Schemastery.ObjectS<{
-    routes: z<string[], string[]>;
-    credentials: z<string[], string[]>;
-    deepseek: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-    routes: z<string[], string[]>;
-    credentials: z<string[], string[]>;
-    deepseek: z<boolean, boolean>;
-}>>;
-/** 一个命名空间的当前有效段：官方描述符的 `value` 是不透明值，本插件只认对象段，其余按空段处理。 */
-export declare function sectionValue(settings: SettingsLike, ns: string): Record<string, unknown>;
+export { SEMI2_SETTINGS_ENTRY };
+/**
+ * 归属表字段：预设注入的路由与密钥引用。
+ * 「上次注入的条目」与「用户自己写的同名条目」无法从名字分辨，这份账本是唯一依据。
+ */
+export declare const OWNED_FIELDS: Record<string, z>;
+/** 工作区 → git 项目映射的字段：本地事实（换台机器要重解析），只存目录与解析结果。 */
+export declare const WORKSPACES_FIELDS: Record<string, z>;
+/** 一个设置段的当前有效值：官方描述符的 `value` 是不透明值，本插件只认对象段，其余按空段处理。 */
+export declare function sectionValue(settings: SettingsLike, ns?: string): Record<string, unknown>;
+/**
+ * 本插件写过什么的账本；账本缺失（升级时旧设置段迁不进来、或换了台机器）时按自铸引用名认领：
+ * 认领只会多回收自己写过的东西，不会碰用户手写的段。
+ */
 export declare function readOwned(settings: SettingsLike): OwnedFacts;
 /** 持久化段 → 工作区条目；形状不合的行直接丢弃，不让坏数据拖垮启动。 */
 export declare function readWorkspaces(settings: SettingsLike): WorkspaceEntry[];

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

@@ -1,16 +1,14 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { CredentialProvider } from '@deepseek-ai/dsh-credentials';
 import type { AgentDefaultModelConfig } from '@deepseek-ai/dsh-agent-default-model';
-import type { SettingsProvider, SettingsSectionHooks } from '@deepseek-ai/dsh-settings';
+import type { SettingsForms } from '@deepseek-ai/dsh-settings';
 import type { ModelSelection } from '../hub/compile.js';
-/** 本插件消费的 host settings 服务面：读 / 写口径照官方 `SettingsProvider`；`replace` / `mutate` 是可缺的降级口。 */
-export type SettingsLike = Pick<SettingsProvider, 'describe' | 'update'> & Partial<Pick<SettingsProvider, 'replace' | 'mutate'>> & {
-    /**
-     * 命名空间注册：schema 与初始段由插件按运行期注册表构造（形状不在编译期），
-     * 故这两项按官方语义放宽成 `unknown` / 对象；`hooks` 与官方 `SettingsSectionHooks` 同义。
-     */
-    installSection(owner: unknown, ns: string, schema: unknown, initial: Record<string, unknown>, hooks: SettingsSectionHooks<Record<string, unknown>>): unknown;
-};
+/**
+ * 本插件消费的 host settings 服务面：读 / 写口径照官方 `SettingsForms`。
+ * 设置段 = Profile 插件条目 id，`describe()` 只列出「光纤 ACTIVE 且 Config 声明了 volatile 字段」的条目，
+ * 因此写与读都要先等目标条目可描述（`awaitNamespace`）；`replace` / `mutate` 是可缺的降级口。
+ */
+export type SettingsLike = Pick<SettingsForms, 'describe' | 'update'> & Partial<Pick<SettingsForms, 'replace' | 'mutate' | 'configure'>>;
 /**
  * 本插件消费的 dsh agentDefaultModel 服务面（默认模型与无头角色选择）。
  * 读口取自官方 `AgentDefaultModelConfig`；写入口径不变，档位是 hub 下发的普通字符串
@@ -22,7 +20,7 @@ export type AgentDefaultModelLike = Partial<Pick<AgentDefaultModelConfig, 'curre
 export interface PortsOptions {
     /** 等 settings 服务的上限（ms）。 */
     settingsTimeoutMs?: number | undefined;
-    /** 等命名空间注册完成再写的上限（ms）。 */
+    /** 等设置段可读可写的上限（ms）。 */
     namespaceWaitMs?: number | undefined;
 }
 export interface Ports {
@@ -36,15 +34,21 @@ export interface Ports {
     agentDefaultModel(): AgentDefaultModelLike | undefined;
     /** workspaceController 的即时宽松读取（缺席 = headless 面，走隐式工作区）。 */
     hasWorkspaceController(): boolean;
+    /**
+     * 等设置段出现在 `describe()`（= 条目 ACTIVE 且声明了 volatile 字段）；超时返回 false。
+     * 读路径超时按空段降级，写路径超时按 `CONFIG_APPLY_FAILED` 拒绝，都由调用方决定。
+     */
+    awaitNamespace(settings: SettingsLike, ns: string): Promise<boolean>;
     updateNamespace(settings: SettingsLike, ns: string, patch: object): Promise<void>;
     /**
-     * 权威写入：把用户段整体替换成给定内容。
-     * `update` 是**递归合并**（dsh-settings 的 mergeLayers），只增不减——服务端撤掉的条目
-     * 会在本地留成残渣，provider 路由尤其致命：目录里已不存在的模型继续可选。
-     * 所以凡是本插件全权决定的段（`llm-pi-ai` 只此一个键）都走替换。
+     * 权威写入：把该条目的用户层整体对齐到给定内容。
+     * 0.1.7 的 `replace` 是「先回到组合层再合并给定字段」，不会留下服务端已撤下的条目；
+     * 只用于**本插件全权决定的段**（`llm-pi-ai` 的 `providers`）：状态段一用就会连归属表一起重置。
      */
     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/publish.d.ts

@@ -2,7 +2,12 @@ import type { RuntimeBootFacts } from '../api/index.js';
 import type { LoadRun } from '../domains/types.js';
 import type { Semi2ConfigState } from '../hub/facts.js';
 import type { OrchestratorInternals } from './orchestrator.js';
-/** 状态 + 健康 + 工作区 tab 一次写回（权威 replace；sync 字段复位为空，无令牌比对）。 */
+/**
+ * 状态 + 健康 + 工作区 tab 一次写回。
+ *
+ * 用合并写入而不是 `replace`：这一段落里还有归属表与工作区映射，`replace` 会把它们一起重置。
+ * 状态字段名是编译期常量集合，合并写入不存在「服务端撤下的条目残留」问题。
+ */
 export declare function publishStatus(engine: OrchestratorInternals): Promise<void>;
 /** 整体读取失败：只落 state.error 与失败态，不注入任何配置（可重载重试）。 */
 export declare function publishFailed(engine: OrchestratorInternals, code: string): Promise<void>;

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

@@ -0,0 +1,8 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { OrchestratorInternals } from './orchestrator.js';
+/**
+ * 挂上会话订阅：dsh 的会话是事件源的（`session/created` / `session/disposed`），
+ * 本插件只旁听，不改会话行为。`sessions` 服务缺席时整块跳过。
+ * 返回订阅光纤（可 await 到就绪），测试据它确认监听已挂上。
+ */
+export declare function installSessionReporting(engine: OrchestratorInternals, ctx?: Context): PromiseLike<unknown>;

package/lib/types/service/settings-sections.d.ts

@@ -1,16 +1,7 @@
-import type { Context } from '@deepseek-ai/cordis';
-import type { SettingsLike } from './ports.js';
-/** UI 触发重载的字段：写入任意非空值即触发（写后由状态回报复位为空，无令牌比对）。 */
-export declare const SYNC_FIELD = "sync";
-/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；UI 与健康字段共用命名空间。 */
+import z from '@deepseek-ai/schemastery';
+/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；UI 与健康字段共用这一段。 */
 export declare const STATUS_FIELDS: readonly string[];
-/** 健康字段 schema（能力 + 领域，值是 `ok:正常` 形式的编码串；读侧拆码）。 */
+/** 健康字段 schema 键（能力 + 领域，值是 `ok:正常` 形式的编码串；读侧拆码）。 */
 export declare const HEALTH_FIELDS_SCHEMA_KEYS: readonly string[];
-export interface SectionHooks {
-    /** 用户写 `sync` 字段即触发：`global` = 整体重载，`workspace:<slug>` = 只同步该工作区。 */
-    onSyncRequest(value: string): void;
-}
-/** 安装三个命名空间；只在拿到 settings 服务后调用一次。 */
-export declare function installSections(ctx: Context, settings: SettingsLike, hooks: SectionHooks): void;
-/** 读 `semi2` 命名空间的一个字段（用户写入后、回报前的过渡值）。 */
-export declare function readSetting(settings: SettingsLike, key: string): string;
+/** 插件 Config 的可写字段表（并入入口的 Config schema）。 */
+export declare const STATE_CONFIG_FIELDS: Record<string, z>;

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

@@ -8,7 +8,7 @@ export interface RouteOptions {
     bodyLimitBytes?: number | undefined;
 }
 /**
- * 本模块消费的配置面（登录 / 登出 / 健康）：由入口按运行实例直接传入。
+ * 本模块消费的配置面（登录 / 登出 / 同步 / 健康）：由入口按运行实例直接传入。
  * 不用 `ctx.get('semi2Config')`——同 fiber 在 apply 里刚 provide 的严格查找会拿到
  * undefined（fiber 尚未 ACTIVE），路由会静默不注册（登录链路无声失效的事故根因）。
  */
@@ -21,11 +21,13 @@ export interface RouteRuntime {
         userName: string;
     }>;
     logout(): Promise<void>;
+    /** 界面「同步」：`workspace:<slug>` 只同步该工作区，其余（含空串）整体重载。 */
+    sync(scope: string): Promise<void>;
     /** 健康快照（诊断与端到端断言用；GET /semi2/health）。 */
     health(): 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, options?: RouteOptions): void;

package/lib/types/web/welcome-ack.d.ts

@@ -5,8 +5,8 @@ import type { Context } from '@deepseek-ai/cordis';
  * 陈旧值只退化为原生行为。
  */
 export declare const WELCOME_NOTICE_VERSION = "2026-08-13.1";
-/** 产品级 GUI onboarding 事实的 durable settings 命名空间。 */
-export declare const WELCOME_NOTICE_NAMESPACE = "ui-onboarding";
+/** 产品级 GUI onboarding 事实的 durable settings 段（= Profile 条目 id）。 */
+export declare const WELCOME_NOTICE_NAMESPACE = "ui-settings-general";
 /** 记录已确认的欢迎声明文案版本。 */
 export declare const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
 /** 本模块依赖的最小 host settings 服务面。 */
@@ -28,7 +28,7 @@ export interface SeedOptions {
 }
 export declare const SEED_INTERVAL_MS = 50;
 export declare const SEED_ATTEMPTS = 40;
-/** 等 "ui-onboarding" 注册后并入当前版本号（幂等）；拒绝/失败会 reject 交调用方降级，命名空间始终未就绪返回 false。 */
+/** 等 "ui-settings-general" 段出现后并入当前版本号（幂等）；拒绝/失败会 reject 交调用方降级，段始终未就绪返回 false。 */
 export declare function seedWelcomeAcknowledgement(settings: SettingsLike, options?: SeedOptions): Promise<boolean>;
 /** 在可选 `settings` 服务上 best-effort 预置：只降级。 */
 export declare function installWelcomeAck(ctx: Context): void;

package/lib/web/routes.js

@@ -1,6 +1,7 @@
 import { rejected } from './fence.js';
 const LOGIN_PATH = '/semi2/login';
 const LOGOUT_PATH = '/semi2/logout';
+const SYNC_PATH = '/semi2/sync';
 const HEALTH_PATH = '/semi2/health';
 function send(res, status, body) {
     const payload = JSON.stringify(body);
@@ -27,7 +28,7 @@ function text(value) {
     return typeof value === 'string' ? value.trim() : '';
 }
 /**
- * 注册三条路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
+ * 注册四条路由：依赖全部由调用方传入（webServer 来自 `inject(['webServer'])` 作用域、fence 来自
  * `connection`）。模块内不做「依赖缺席就静默不装」的判断；注册一律走 ctx.effect 保证可回收。
  */
 export function installRoutes(ctx, webServer, runtime, fence, options = {}) {
@@ -82,6 +83,29 @@ export function installRoutes(ctx, webServer, runtime, fence, options = {}) {
             }
         },
     }));
+    ctx.effect(() => webServer.register({
+        kind: 'exact',
+        path: SYNC_PATH,
+        handler: async (req, res) => {
+            if (rejected(req, res, fence))
+                return;
+            if (req.method !== 'POST') {
+                send(res, 405, { code: 'METHOD_NOT_ALLOWED' });
+                return;
+            }
+            try {
+                const raw = await readJson(req, maxBody);
+                const body = raw !== null && typeof raw === 'object'
+                    ? raw
+                    : {};
+                await runtime.sync(text(body.scope));
+                send(res, 200, { ok: true });
+            }
+            catch {
+                send(res, 400, { code: 'SYNC_FAILED' });
+            }
+        },
+    }));
     ctx.effect(() => webServer.register({
         kind: 'exact',
         path: HEALTH_PATH,

package/lib/web/welcome-ack.js

@@ -4,8 +4,8 @@
  * 陈旧值只退化为原生行为。
  */
 export const WELCOME_NOTICE_VERSION = '2026-08-13.1';
-/** 产品级 GUI onboarding 事实的 durable settings 命名空间。 */
-export const WELCOME_NOTICE_NAMESPACE = 'ui-onboarding';
+/** 产品级 GUI onboarding 事实的 durable settings 段（= Profile 条目 id）。 */
+export const WELCOME_NOTICE_NAMESPACE = 'ui-settings-general';
 /** 记录已确认的欢迎声明文案版本。 */
 export const WELCOME_NOTICE_ACK_FIELD = 'welcomeNoticeVersion';
 export const SEED_INTERVAL_MS = 50;
@@ -13,7 +13,7 @@ export const SEED_ATTEMPTS = 40;
 function defaultWait(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
-/** 等 "ui-onboarding" 注册后并入当前版本号（幂等）；拒绝/失败会 reject 交调用方降级，命名空间始终未就绪返回 false。 */
+/** 等 "ui-settings-general" 段出现后并入当前版本号（幂等）；拒绝/失败会 reject 交调用方降级，段始终未就绪返回 false。 */
 export async function seedWelcomeAcknowledgement(settings, options = {}) {
     const namespace = options.namespace ?? WELCOME_NOTICE_NAMESPACE;
     const intervalMs = options.intervalMs ?? SEED_INTERVAL_MS;
@@ -44,9 +44,9 @@ export function installWelcomeAck(ctx) {
             return;
         void seedWelcomeAcknowledgement(settings).then((seeded) => {
             if (!seeded)
-                warn(ctx, 'ui-onboarding 命名空间未就绪，跳过欢迎声明预置');
+                warn(ctx, 'ui-settings-general 段未就绪，跳过欢迎声明预置');
         }).catch((error) => {
-            warn(ctx, '写入 ui-onboarding 欢迎声明确认失败: ' + (error instanceof Error ? error.message : String(error)));
+            warn(ctx, '写入 ui-settings-general 欢迎声明确认失败: ' + (error instanceof Error ? error.message : String(error)));
         });
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fa-software/semi2-dsh",
-  "version": "0.0.13",
+  "version": "0.0.14-preview.20260922151653",
   "type": "module",
   "description": "Semi2 单插件：semi2-hub 配置引导 + 公共 Web 能力，并挂载 CodeGraph 官方 MCP 服务。",
   "main": "lib/index.js",
@@ -38,16 +38,18 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-mcp-client": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent-default-model": {
@@ -65,9 +67,15 @@
     "@deepseek-ai/dsh-host-webserver": {
       "optional": true
     },
+    "@deepseek-ai/dsh-mcp-client": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-settings": {
       "optional": true
     },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-skill": {
       "optional": true
     },