@fa-software/semi2-dsh 0.0.13-preview.20260921160207 → 0.0.13

package/lib/service/config-service.js

@@ -16,7 +16,7 @@ export function installConfiguration(ctx, options = {}) {
             // 无 logger 的宿主（单测）忽略。
         }
     };
-    const ports = createPorts(ctx, warn);
+    const ports = createPorts(ctx, warn, options);
     // api 门面读连接凭据的桥：闭包延迟求值（编排层构造完成后才可能被调用）。
     const engineRef = { current: undefined };
     const orchestrator = new Orchestrator(ctx, options.api ??

package/lib/service/namespaces.js

@@ -13,13 +13,20 @@ export const OWNED_SCHEMA = z.object({
     credentials: z.array(z.string()).default([]),
     deepseek: z.boolean().default(false),
 });
+/** 一个命名空间的当前有效段：官方描述符的 `value` 是不透明值，本插件只认对象段，其余按空段处理。 */
+export function sectionValue(settings, ns) {
+    const value = settings.describe().find(entry => entry.ns === ns)?.value;
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
 function stringsOf(input) {
     return Array.isArray(input)
         ? input.filter((item) => typeof item === 'string')
         : [];
 }
 export function readOwned(settings) {
-    const value = settings.describe().find(entry => entry.ns === OWNED_NAMESPACE)?.value ?? {};
+    const value = sectionValue(settings, OWNED_NAMESPACE);
     return {
         routes: stringsOf(value.routes),
         credentials: stringsOf(value.credentials),
@@ -32,8 +39,7 @@ function text(value) {
 }
 /** 持久化段 → 工作区条目；形状不合的行直接丢弃，不让坏数据拖垮启动。 */
 export function readWorkspaces(settings) {
-    const value = settings.describe().find(entry => entry.ns === WORKSPACES_NAMESPACE)?.value ??
-        {};
+    const value = sectionValue(settings, WORKSPACES_NAMESPACE);
     const rows = Array.isArray(value.entries) ? value.entries : [];
     const entries = [];
     for (const row of rows) {

package/lib/service/orchestrator.js

@@ -3,7 +3,7 @@ import { initialState, } from '../hub/facts.js';
 import { DOMAINS } from './registry.js';
 import { CONTRACT_TIMEOUT_MS, CREDENTIAL_RETRY } from './connection.js';
 import { healthSnapshot } from './publish.js';
-/** 领域 attach 的等待上限：超时按「该面不提供此能力」审计（依赖永不到达不能永久悬空）。 */
+/** 领域 attach 的等待上限缺省值：超时按「该面不提供此能力」审计（依赖永不到达不能永久悬空）。 */
 const DOMAIN_ATTACH_TIMEOUT_MS = 2_000;
 const DOMAIN_POLL_MS = 25;
 export const NOOP_WORKSPACE = {
@@ -25,6 +25,7 @@ export class Orchestrator {
     environment;
     startupDir;
     contractTimeoutMs;
+    domainAttachTimeoutMs;
     credentialRetry;
     runtimeContract;
     resolved = false;
@@ -42,6 +43,7 @@ export class Orchestrator {
         this.environment = { ...environment };
         this.startupDir = process.cwd();
         this.contractTimeoutMs = options.contractTimeoutMs ?? CONTRACT_TIMEOUT_MS;
+        this.domainAttachTimeoutMs = options.domainAttachTimeoutMs ?? DOMAIN_ATTACH_TIMEOUT_MS;
         this.credentialRetry = { ...CREDENTIAL_RETRY, ...options.credentialRetry };
         const settled = Promise.withResolvers();
         this.ready = settled.promise;
@@ -90,10 +92,7 @@ export class Orchestrator {
     setConnection(connection) {
         this.activeConnection = connection;
     }
-    /**
-     * 注册表边界的唯一一次类型收窄：map 按 id 存异构领域，取用方按 `DomainId` 拿回自己的 peer 面。
-     * 各领域类 `implements DomainPeers[自己的 id]`，形状对不上在编译期就报错。
-     */
+    /** 注册表边界的唯一一次类型收窄：各领域类 implements 自己那份 peer 面，形状不对在编译期就报错。 */
     peer(id) {
         return this.domainMap.get(id);
     }
@@ -150,7 +149,7 @@ export class Orchestrator {
     async mountDomains() {
         for (const descriptor of DOMAINS)
             this.ctx.plugin(descriptor, { host: this });
-        const deadline = Date.now() + DOMAIN_ATTACH_TIMEOUT_MS;
+        const deadline = Date.now() + this.domainAttachTimeoutMs;
         while (this.domainMap.size < DOMAINS.length) {
             if (Date.now() >= deadline)
                 break;

package/lib/service/ports.js

@@ -1,9 +1,12 @@
 import { setTimeout as delay } from 'node:timers/promises';
 import { ConfigurationError } from '../hub/errors.js';
 const SETTINGS_TIMEOUT_MS = 5_000;
-const NAMESPACE_TRIES = 40;
-const NAMESPACE_INTERVAL_MS = 50;
-export function createPorts(ctx, warn) {
+const NAMESPACE_WAIT_MS = 2_000;
+/** 命名空间注册轮询间隔（纯内部预算，不单列到 Config）。 */
+const NAMESPACE_POLL_MS = 50;
+export function createPorts(ctx, warn, options = {}) {
+    const settingsTimeoutMs = options.settingsTimeoutMs ?? SETTINGS_TIMEOUT_MS;
+    const namespaceWaitMs = options.namespaceWaitMs ?? NAMESPACE_WAIT_MS;
     const service = (key) => new Promise((resolve) => {
         ctx.inject([key], (injected) => {
             resolve(injected.get(key));
@@ -14,7 +17,7 @@ export function createPorts(ctx, warn) {
             const { promise, resolve } = Promise.withResolvers();
             const timer = globalThis.setTimeout(() => {
                 resolve(undefined);
-            }, SETTINGS_TIMEOUT_MS);
+            }, settingsTimeoutMs);
             ctx.inject(['settings'], (injected) => {
                 globalThis.clearTimeout(timer);
                 resolve(injected.get('settings'));
@@ -25,14 +28,14 @@ export function createPorts(ctx, warn) {
         credentialsNow: () => ctx.get('credentials', false),
         agentDefaultModel: () => ctx.get('agentDefaultModel', false),
         hasWorkspaceController: () => ctx.get('workspaceController', false) !== undefined,
-        updateNamespace: (settings, ns, patch) => writeNamespace(settings, ns, () => settings.update(ns, patch)),
+        updateNamespace: (settings, ns, patch) => writeNamespace(settings, ns, () => settings.update(ns, patch), namespaceWaitMs),
         replaceNamespace: (settings, ns, section) => {
             const replace = settings.replace?.bind(settings);
             if (replace === undefined) {
                 warn(`宿主 settings 无 replace，${ns} 退回合并写入：服务端已撤下的条目可能残留`);
-                return writeNamespace(settings, ns, () => settings.update(ns, section));
+                return writeNamespace(settings, ns, () => settings.update(ns, section), namespaceWaitMs);
             }
-            return writeNamespace(settings, ns, () => replace(ns, section));
+            return writeNamespace(settings, ns, () => replace(ns, section), namespaceWaitMs);
         },
         clearKeys: async (settings, ns, keys) => {
             const mutate = settings.mutate?.bind(settings);
@@ -41,18 +44,21 @@ export function createPorts(ctx, warn) {
                 return;
             }
             const ops = keys.map(key => ({ op: 'unset', path: [key] }));
-            await writeNamespace(settings, ns, () => mutate(ns, ops));
+            await writeNamespace(settings, ns, () => mutate(ns, ops), namespaceWaitMs);
         },
     };
 }
 /** 等命名空间注册完成再写（settings 服务与各 bundle 的注册有先后）；写失败原样上抛由调用方降级。 */
-async function writeNamespace(settings, ns, write) {
-    for (let attempt = 0; attempt < NAMESPACE_TRIES; attempt += 1) {
+async function writeNamespace(settings, ns, write, waitMs) {
+    const deadline = Date.now() + waitMs;
+    for (;;) {
         if (settings.describe().some(entry => entry.ns === ns)) {
             await write();
             return;
         }
-        await delay(NAMESPACE_INTERVAL_MS);
+        if (Date.now() >= deadline)
+            break;
+        await delay(NAMESPACE_POLL_MS);
     }
     throw new ConfigurationError('CONFIG_APPLY_FAILED');
 }

package/lib/service/registry.js

@@ -1,6 +1,7 @@
 import { defaultModelDomain } from '../domains/default-model/index.js';
 import { modelsDomain } from '../domains/models/index.js';
 import { secretsDomain } from '../domains/secrets/index.js';
+import { selfPortraitDomain } from '../domains/self-portrait/index.js';
 import { skillsDomain } from '../domains/skills/index.js';
 import { workspaceDomain } from '../domains/workspace/index.js';
 /** 挂载顺序 = 领域间数据流顺序：models 先落地编译产物（secrets 的回收与 default-model 的选择都依赖它）。 */
@@ -10,4 +11,5 @@ export const DOMAINS = [
     skillsDomain,
     workspaceDomain,
     defaultModelDomain,
+    selfPortraitDomain,
 ];

package/lib/service/settings-sections.js

@@ -3,7 +3,7 @@
 import z from '@deepseek-ai/schemastery';
 import { STATUS_BASE_FIELDS, WORKSPACE_TABS_FIELD } from '../hub/status.js';
 import { DOMAINS } from './registry.js';
-import { OWNED_NAMESPACE, OWNED_SCHEMA, SETTINGS_NAMESPACE, WORKSPACES_NAMESPACE, } from './namespaces.js';
+import { OWNED_NAMESPACE, OWNED_SCHEMA, sectionValue, SETTINGS_NAMESPACE, WORKSPACES_NAMESPACE, } from './namespaces.js';
 /** UI 触发重载的字段：写入任意非空值即触发（写后由状态回报复位为空，无令牌比对）。 */
 export const SYNC_FIELD = 'sync';
 /** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；UI 与健康字段共用命名空间。 */
@@ -54,9 +54,7 @@ export function installSections(ctx, settings, hooks) {
         onChange: () => {
             // 用户写入才会走到这里；读有效值判断是否 sync 触发（本插件自己的 replace 也会触发 onChange，
             // 但回报时 sync 恒写空串，不会成环）。
-            const value = settings
-                .describe()
-                .find(entry => entry.ns === SETTINGS_NAMESPACE)?.value?.[SYNC_FIELD];
+            const value = sectionValue(settings, SETTINGS_NAMESPACE)[SYNC_FIELD];
             if (typeof value === 'string' && value !== '')
                 hooks.onSyncRequest(value);
         },
@@ -75,6 +73,6 @@ export function installSections(ctx, settings, hooks) {
 }
 /** 读 `semi2` 命名空间的一个字段（用户写入后、回报前的过渡值）。 */
 export function readSetting(settings, key) {
-    const value = settings.describe().find(entry => entry.ns === SETTINGS_NAMESPACE)?.value?.[key];
+    const value = sectionValue(settings, SETTINGS_NAMESPACE)[key];
     return typeof value === 'string' ? value : '';
 }

package/lib/types/api/generated/documents.d.ts

@@ -1,5 +1,5 @@
 /** 启动装配：五个用户级领域一个文档（项目绑定按工作区另行按需取）。 */
-export declare const RUNTIME_BOOT_DOCUMENT = "query RuntimeBoot {\n  runtimeViewer {\n    id\n    username\n    displayName\n  }\n  runtimeModels {\n    id\n    upstreamId\n    displayName\n    metadata { contextWindow maxTokens input reasoningLevels }\n    defaultReasoningLevel\n    connection { id provider protocol baseUrl }\n  }\n  runtimeDefaultModelId\n  runtimeHeadlessModels {\n    planModelId\n    executeModelId\n  }\n  runtimeModelCredentials {\n    connectionId\n    value\n  }\n  runtimeSkills {\n    id\n    projectId\n    name\n    description\n    whenToUse\n    content\n    version\n    files {\n      path\n      sizeBytes\n      mimeType\n      isExecutable\n    }\n    fileCount\n    filesBytes\n  }\n}";
+export declare const RUNTIME_BOOT_DOCUMENT = "query RuntimeBoot {\n  runtimeViewer {\n    id\n    username\n    displayName\n  }\n  runtimeModels {\n    id\n    upstreamId\n    displayName\n    metadata { contextWindow maxTokens input reasoningLevels }\n    defaultReasoningLevel\n    connection { id provider protocol baseUrl }\n  }\n  runtimeDefaultModelId\n  runtimeHeadlessModels {\n    planModelId\n    executeModelId\n  }\n  runtimeModelCredentials {\n    connectionId\n    value\n  }\n  runtimeSkills {\n    id\n    projectId\n    name\n    description\n    whenToUse\n    content\n    version\n    files {\n      path\n      sizeBytes\n      mimeType\n      isExecutable\n    }\n    fileCount\n    filesBytes\n  }\n  runtimeSelfPortrait\n}";
 /** 技能附属资源字节：boot 文档只带清单，真正加载某个技能时才按需取这一条。可空根字段：读取者不可见 / 不存在回空数组（权威「没有」），领域失败回 null（降级，不物化）。 */
 export declare const RUNTIME_SKILL_FILES_DOCUMENT = "query RuntimeSkillFiles($skillId: ID!) {\n  runtimeSkillFiles(skillId: $skillId) {\n    path\n    content\n    encoding\n    sizeBytes\n    mimeType\n    isExecutable\n  }\n}";
 /** 项目绑定按 slug 取：只问已登记工作区命中的那几个项目，绝不把整张项目表拉回本地。`slugs` 是读范围之上的过滤（不是绕过），空数组 = 空集合。 */

package/lib/types/api/generated/graphql.d.ts

@@ -37,6 +37,7 @@ export type RuntimeBootQueryVariables = Exact<{
 }>;
 export type RuntimeBootQuery = {
     runtimeDefaultModelId: string | null;
+    runtimeSelfPortrait: string | null;
     runtimeViewer: {
         id: string;
         username: string;

package/lib/types/api/generated/schema.d.ts

@@ -423,6 +423,8 @@ export type Mutation = {
     saveModelConnection: ModelConnection;
     saveProjectDetails: Project;
     saveProjectHeadlessModels: Project;
+    /** 保存自画像（追加版本）；同内容幂等不涨版本，expectedVersion 过期即 REVISION_CONFLICT；空正文 = 撤下。 */
+    saveSelfPortrait: SelfPortrait;
     /** 整份内容提交；同内容幂等不涨版本，expectedVersion 过期即 SKILL_VERSION_CONFLICT。 */
     saveSkill: Skill;
     saveUserConfiguration: UserConfiguration;
@@ -497,6 +499,9 @@ export type MutationSaveProjectDetailsArgs = {
 export type MutationSaveProjectHeadlessModelsArgs = {
     input: SaveProjectHeadlessModelsInput;
 };
+export type MutationSaveSelfPortraitArgs = {
+    input: SaveSelfPortraitInput;
+};
 export type MutationSaveSkillArgs = {
     input: SaveSkillInput;
 };
@@ -647,6 +652,11 @@ export type Query = {
      * 工作区逐个项目要，不必把整个项目表拉回本地。
      */
     runtimeProjects?: Maybe<Array<RuntimeProject>>;
+    /**
+     * 自画像正文（agent 会话开头注入的人设）；未配置为空串，本次读取失败为 null。
+     * 全局一份，与读取者身份无关。
+     */
+    runtimeSelfPortrait?: Maybe<Scalars['String']['output']>;
     /**
      * 某技能 head 版本的附件内容（运行面物化用）；读取者对该技能不可见时返回空数组。
      * 字节不回填进 boot 文档，只在真正加载技能时按需取。
@@ -659,6 +669,10 @@ export type Query = {
     runtimeSkills?: Maybe<Array<RuntimeSkill>>;
     /** 本次读取者（服务器里当前用户）；失败为 null。 */
     runtimeViewer?: Maybe<RuntimeViewer>;
+    /** 自画像的当前版本（全局一份 agent 人设）。 */
+    selfPortrait: SelfPortrait;
+    /** 自画像的历史快照（新在前，最多 50 条）。 */
+    selfPortraitVersions: Array<SelfPortraitVersion>;
     /** 单个技能详情（含已归档；没给 version 就是 head，给了就取该历史版本）；不存在即 SKILL_NOT_FOUND。 */
     skill: Skill;
     /** 某版本（缺省 head）的全部附件内容；导出 / 编辑回填 / 下载按需取。 */
@@ -954,6 +968,12 @@ export type SaveProjectHeadlessModelsInput = {
     planReasoningLevel?: InputMaybe<ReasoningLevel>;
     projectId: Scalars['ID']['input'];
 };
+export type SaveSelfPortraitInput = {
+    /** 正文；trim 后为空即撤下（运行面不再注入）。 */
+    content: Scalars['String']['input'];
+    /** 当前版本号（0 = 从未配置过）；过期即 REVISION_CONFLICT。 */
+    expectedVersion: Scalars['Int']['input'];
+};
 export type SaveSkillInput = {
     content: Scalars['String']['input'];
     /** 当前头版本号；过期即 SKILL_VERSION_CONFLICT（同内容重复提交不消耗它）。 */
@@ -971,6 +991,28 @@ export type SecretInput = {
     reuse?: InputMaybe<Scalars['Boolean']['input']>;
     value?: InputMaybe<Scalars['String']['input']>;
 };
+/** 自画像的当前版本；从未配置过时 version = 0、content 为空串。 */
+export type SelfPortrait = {
+    __typename?: 'SelfPortrait';
+    /** 注入 agent 会话开头的正文；空串 = 未配置（运行面不注入）。 */
+    content: Scalars['String']['output'];
+    updatedAt?: Maybe<Scalars['DateTime']['output']>;
+    updatedBy?: Maybe<Scalars['ID']['output']>;
+    updatedByDisplayName?: Maybe<Scalars['String']['output']>;
+    updatedByUsername?: Maybe<Scalars['String']['output']>;
+    /** 当前版本号；保存时作为 CAS 令牌（0 = 从未配置过）。 */
+    version: Scalars['Int']['output'];
+};
+/** 一个不可变历史快照；作者用扁平字段（同 AuditEvent 口径）。 */
+export type SelfPortraitVersion = {
+    __typename?: 'SelfPortraitVersion';
+    content: Scalars['String']['output'];
+    createdAt: Scalars['DateTime']['output'];
+    createdBy: Scalars['ID']['output'];
+    createdByDisplayName?: Maybe<Scalars['String']['output']>;
+    createdByUsername?: Maybe<Scalars['String']['output']>;
+    version: Scalars['Int']['output'];
+};
 export type SetModelEnabledInput = {
     enabled: Scalars['Boolean']['input'];
     expectedRevision: Scalars['Int']['input'];

package/lib/types/contract.d.ts

@@ -1,3 +1,20 @@
+/**
+ * semi2 提示词段的号段分配（偏移量，基准 = 官方 persona 段）。
+ * 三段都落在官方人设区（persona + 1..3），不与任何官方工具 schema 号段重叠；
+ * 段名与绝对位置由 `semi2SectionOrder` 现算，官方占用 1..3 时改这里并同步守卫。
+ */
+export declare const SEMI2_SECTION_ORDERS: {
+    readonly selfPortrait: 1;
+    readonly npcContract: 2;
+    readonly cnbWorkstation: 3;
+};
+export type Semi2SectionKey = keyof typeof SEMI2_SECTION_ORDERS;
+/** 只读 systemPrompt 的号段解析面：老宿主没有 `getSectionOrder` 时回落本表偏移。 */
+export interface SectionOrderSource {
+    getSectionOrder?(name: string): number | undefined;
+}
+/** 段的绝对位置 = 官方 persona 段号 + 本表偏移（服务缺席 / 不认名字时以偏移值兜底）。 */
+export declare function semi2SectionOrder(systemPrompt: SectionOrderSource | undefined, key: Semi2SectionKey): number;
 /** 连接 semi2-hub 的凭据；两项齐备才算可连。 */
 export interface Semi2Credentials {
     configUrl?: string;

package/lib/types/domains/self-portrait/domain.d.ts

@@ -0,0 +1,22 @@
+import type { DomainHost, DomainService, LoadRun } from '../types.js';
+import type { Semi2ConfigState } from '../../hub/facts.js';
+export declare class SelfPortraitDomain implements DomainService {
+    private readonly host;
+    readonly id: "self-portrait";
+    constructor(host: DomainHost);
+    /** 注入段的文本；每次装配现读共享状态，配置重载与领域重建都不需要重新注册或重新领取。 */
+    text(): string;
+    applyBoot(run: LoadRun): Promise<void>;
+    statusFields(state: Semi2ConfigState): Record<string, string>;
+    summary(state: Semi2ConfigState): string | null;
+    health(): {
+        state: "ok";
+        note: string;
+    } | {
+        state: "degraded";
+        note: string;
+    } | {
+        state: "ok";
+        note?: never;
+    };
+}

package/lib/types/domains/self-portrait/index.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SystemPrompt } from '@deepseek-ai/dsh-system-prompt';
+import type { DomainPlugin } from '../types.js';
+/** dsh 原生 systemPrompt 段注册面（官方 `SystemPrompt` 的子集；老宿主没有 `getSectionOrder`）。 */
+export type SystemPromptLike = Pick<SystemPrompt, 'section'> & Partial<Pick<SystemPrompt, 'getSectionOrder'>>;
+/** 本段的名字（人设区里与官方 persona 段并列，`semi2:` 前缀与其它 semi2 段同口径）。 */
+export declare const SELF_PORTRAIT_SECTION = "semi2:self-portrait";
+/**
+ * 在官方 persona 段之后注册自画像段：正文由 provider 每次装配现读（配置重载后自动跟上）。
+ * `interpolate: false` 是硬要求——正文是管理员手写的自由文本，里面的 `{{…}}` 会让插值阶段抛错，
+ * 一条坏正文就等于整轮会话起不来。空文本由 renderPrompt 丢弃，等于「未配置」。
+ */
+export declare function installSelfPortraitSection(ctx: Context, text: () => string): void;
+export declare const selfPortraitDomain: DomainPlugin;

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

@@ -28,6 +28,9 @@ export interface ModelsPeer {
 /** 密钥领域没有跨领域被调的成员；占位保证 `DomainPeers` 对 DomainId 完备。 */
 export interface SecretsPeer {
 }
+/** 自画像领域没有跨领域被调的成员（注入段由领域自己注册）；占位同 SecretsPeer 口径。 */
+export interface SelfPortraitPeer {
+}
 export interface SkillsPeer {
     /** 当前控制台技能目录（null = 没拿到权威目录，≠ 空目录）。 */
     skills(): RuntimeSkillFact[] | null;
@@ -85,6 +88,7 @@ export interface DomainPeers {
     skills: SkillsPeer;
     workspace: WorkspacePeer;
     'default-model': DefaultModelPeer;
+    'self-portrait': SelfPortraitPeer;
 }
 /** 一轮 boot 装配的共享上下文（编排层创建，按注册表顺序流经各领域）。 */
 export interface LoadRun {
@@ -166,4 +170,4 @@ export interface DomainPlugin {
     readonly inject?: readonly string[];
     apply(ctx: Context, config: DomainMountConfig): void;
 }
-export type DomainId = 'models' | 'secrets' | 'skills' | 'workspace' | 'default-model';
+export type DomainId = 'models' | 'secrets' | 'skills' | 'workspace' | 'default-model' | 'self-portrait';

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

@@ -1,25 +1,9 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { WorkspaceController, WorkspaceFollowFrame } from '@deepseek-ai/dsh-api-workspace-controller';
 import type { WorkspaceViewLike } from '../../hub/workspace-book.js';
-/** `workspaceController.follow` 的帧；order / archived 与本插件无关。 */
-export type WorkspaceFrameLike = {
-    type: 'baseline';
-    value: {
-        items: readonly WorkspaceViewLike[];
-    };
-} | {
-    type: 'upsert';
-    workspace: WorkspaceViewLike;
-} | {
-    type: 'remove';
-    workspaceId: string;
-} | {
-    type: 'order';
-} | {
-    type: 'archived';
-};
-export interface WorkspaceControllerLike {
-    follow(signal: AbortSignal): AsyncIterable<WorkspaceFrameLike>;
-}
+/** `workspaceController.follow` 的帧（官方 Workspace Remote 状态流）；order / archived 与本插件无关。 */
+export type WorkspaceFrameLike = WorkspaceFollowFrame;
+export type WorkspaceControllerLike = Pick<WorkspaceController, 'follow'>;
 export interface WorkspaceFeedHandlers {
     baseline(items: readonly WorkspaceViewLike[]): void | Promise<void>;
     upsert(view: WorkspaceViewLike): void | Promise<void>;

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

@@ -56,6 +56,11 @@ export interface Semi2ConfigState {
     } | null;
     /** 控制台技能目录；null = 没拿到权威目录（≠ 空目录），provider 据此报 complete:false。 */
     skills: RuntimeSkillFact[] | null;
+    /**
+     * 自画像正文：null = 没拿到（读取失败或还没读过），空串 = 权威「未配置」，其余即正文。
+     * 注入段按它现读——两种空都不注入。
+     */
+    selfPortrait: string | null;
     /** 已登记工作区命中的项目（含生效绑定，按 slug 现取并缓存）；会话按 cwd 经 `projectFor` 匹配。 */
     projects: RuntimeProject[];
     /** 已登记工作区（dsh 工作区 → git 项目映射）；未接入工作区服务时为单条隐式条目。 */

package/lib/types/index.d.ts

@@ -5,12 +5,57 @@ 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, runtimeFromCnbEnv, runtimeFromContainerEnv, } from './contract.js';
-export type { Semi2Credentials, Semi2Platform, Semi2Runtime, } from './contract.js';
+export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, 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";
-/** 三个运行面都存在（dsh-base 的 tools / skills 行）；其它服务一律走作用域注入。 */
-export declare const inject: string[];
-export declare const Config: z<Schemastery.ObjectS<{}>, Schemastery.ObjectT<{}>>;
+/**
+ * 可调参数：默认值 = 各模块曾经的常量；bundle patch 行不写 config，消费方 overlay 才覆盖。
+ * 「config 明确值 → 环境变量 → 内置常量」的取值顺序在 apply 里一次归一。
+ */
+export declare const Config: z<Schemastery.ObjectS<{
+    /** 等运行面契约（`semi2Runtime`）出现的上限：超时按宿主直跑处理。 */
+    contractTimeoutMs: z<number, number>;
+    /** 等领域装配的上限：超时的领域记「本面不提供该能力」。 */
+    domainAttachTimeoutMs: z<number, number>;
+    /** 等 settings 服务的上限：本面无该服务时不阻塞启动。 */
+    settingsTimeoutMs: z<number, number>;
+    /** 等命名空间注册完成再写的上限。 */
+    namespaceWaitMs: z<number, number>;
+    /** 凭据存储首次读盘的重试次数与间隔。 */
+    credentialRetryTries: z<number, number>;
+    credentialRetryIntervalMs: z<number, number>;
+    /** webServer 在而校验面迟迟不出现时，多久补一条诊断日志。 */
+    webFenceTimeoutMs: z<number, number>;
+    /** 登录 / 登出 / 健康路由的请求体上限（字节）。 */
+    webRouteBodyLimitBytes: z<number, number>;
+}>, Schemastery.ObjectT<{
+    /** 等运行面契约（`semi2Runtime`）出现的上限：超时按宿主直跑处理。 */
+    contractTimeoutMs: z<number, number>;
+    /** 等领域装配的上限：超时的领域记「本面不提供该能力」。 */
+    domainAttachTimeoutMs: z<number, number>;
+    /** 等 settings 服务的上限：本面无该服务时不阻塞启动。 */
+    settingsTimeoutMs: z<number, number>;
+    /** 等命名空间注册完成再写的上限。 */
+    namespaceWaitMs: z<number, number>;
+    /** 凭据存储首次读盘的重试次数与间隔。 */
+    credentialRetryTries: z<number, number>;
+    credentialRetryIntervalMs: z<number, number>;
+    /** webServer 在而校验面迟迟不出现时，多久补一条诊断日志。 */
+    webFenceTimeoutMs: z<number, number>;
+    /** 登录 / 登出 / 健康路由的请求体上限（字节）。 */
+    webRouteBodyLimitBytes: z<number, number>;
+}>>;
 export type Config = Schemastery.TypeT<typeof Config>;
-export declare function apply(ctx: Context, _config: Config): void;
+/** apply 内归一后的不可变参数（配置面 → 编排 / web 面的唯一形状）。 */
+export interface InstallOptions {
+    contractTimeoutMs: number;
+    domainAttachTimeoutMs: number;
+    settingsTimeoutMs: number;
+    namespaceWaitMs: number;
+    credentialRetryTries: number;
+    credentialRetryIntervalMs: number;
+    webFenceTimeoutMs: number;
+    webRouteBodyLimitBytes: number;
+}
+export declare function apply(ctx: Context, config: Config): void;

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

@@ -48,6 +48,10 @@ export interface Semi2Audit {
     }>;
 }
 export interface ConfigurationOptions extends OrchestratorOptions {
+    /** 等 settings 服务的上限（ms）：本面无该服务时不阻塞启动。 */
+    settingsTimeoutMs?: number;
+    /** 等命名空间注册完成再写的上限（ms）。 */
+    namespaceWaitMs?: number;
     /** 测试缝：替换网络层（假件）。 */
     api?: Semi2Api;
 }

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

@@ -17,6 +17,8 @@ export declare const OWNED_SCHEMA: z<Schemastery.ObjectS<{
     credentials: z<string[], string[]>;
     deepseek: z<boolean, boolean>;
 }>>;
+/** 一个命名空间的当前有效段：官方描述符的 `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/orchestrator.d.ts

@@ -49,6 +49,8 @@ export interface OrchestratorInternals {
 export interface OrchestratorOptions {
     /** 等运行面契约出现的上限（ms）：默认 5s，宿主直跑即等满。 */
     contractTimeoutMs?: number;
+    /** 等领域装配的上限（ms）：超时的领域记「本面不提供该能力」。 */
+    domainAttachTimeoutMs?: number;
     /** 凭据重试窗口：宿主的凭据存储晚就绪时用（测试可收短，默认见 connection.ts）。 */
     credentialRetry?: Partial<CredentialRetry>;
 }
@@ -62,6 +64,7 @@ export declare class Orchestrator implements DomainHost, OrchestratorInternals {
     readonly environment: NodeJS.ProcessEnv;
     readonly startupDir: string;
     readonly contractTimeoutMs: number;
+    readonly domainAttachTimeoutMs: number;
     readonly credentialRetry: CredentialRetry;
     private runtimeContract;
     private resolved;
@@ -85,10 +88,7 @@ export declare class Orchestrator implements DomainHost, OrchestratorInternals {
     hasConnection(): boolean;
     connection(): ConnectionCredentials | null;
     setConnection(connection: ConnectionCredentials | null): void;
-    /**
-     * 注册表边界的唯一一次类型收窄：map 按 id 存异构领域，取用方按 `DomainId` 拿回自己的 peer 面。
-     * 各领域类 `implements DomainPeers[自己的 id]`，形状对不上在编译期就报错。
-     */
+    /** 注册表边界的唯一一次类型收窄：各领域类 implements 自己那份 peer 面，形状不对在编译期就报错。 */
     peer<K extends DomainId>(id: K): DomainPeers[K] | undefined;
     attach(domain: DomainService): void;
     get domains(): ReadonlyMap<DomainId, DomainService & object>;

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

@@ -1,30 +1,29 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { CredentialProvider } from '@deepseek-ai/dsh-credentials';
-/** 本插件消费的 host settings 服务面（installSection / describe / 三种写入）。 */
-export interface SettingsLike {
-    describe(): Array<{
-        ns: string;
-        value?: Record<string, unknown>;
-    }>;
-    update(ns: string, patch: object): Promise<unknown>;
-    replace?(ns: string, section: object): Promise<unknown>;
-    /** 路径级编辑（dsh-settings 的 `mutate`）：合并写入表达不出「删键」，回收只能走它。 */
-    mutate?(ns: string, ops: ReadonlyArray<{
-        op: 'unset';
-        path: readonly string[];
-    }>): Promise<unknown>;
-    installSection(owner: unknown, ns: string, schema: unknown, initial: Record<string, unknown>, hooks: {
-        setSource: (current: Record<string, unknown>) => void;
-        onChange: () => void;
-    }): unknown;
-}
-/** 本插件消费的 dsh agentDefaultModel 服务面（默认模型与无头角色选择）。 */
-export interface AgentDefaultModelLike {
-    saveSelection(next: object): Promise<void>;
-    currentSelection?(): {
-        provider: string;
-        model: string;
-    };
+import type { AgentDefaultModelConfig } from '@deepseek-ai/dsh-agent-default-model';
+import type { SettingsProvider, SettingsSectionHooks } 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;
+};
+/**
+ * 本插件消费的 dsh agentDefaultModel 服务面（默认模型与无头角色选择）。
+ * 读口取自官方 `AgentDefaultModelConfig`；写入口径不变，档位是 hub 下发的普通字符串
+ * （官方档位 id 是品牌化字符串，运行时同形）。
+ */
+export type AgentDefaultModelLike = Partial<Pick<AgentDefaultModelConfig, 'currentSelection'>> & {
+    saveSelection(next: ModelSelection): Promise<void>;
+};
+export interface PortsOptions {
+    /** 等 settings 服务的上限（ms）。 */
+    settingsTimeoutMs?: number | undefined;
+    /** 等命名空间注册完成再写的上限（ms）。 */
+    namespaceWaitMs?: number | undefined;
 }
 export interface Ports {
     /** settings 服务缺失（非 web/headless 宿主）时不阻塞启动，5s 后放弃返回 undefined。 */
@@ -48,4 +47,4 @@ export interface Ports {
     /** 按路径删除本插件写过的键（合并写入删不掉）。 */
     clearKeys(settings: SettingsLike, ns: string, keys: readonly string[]): Promise<void>;
 }
-export declare function createPorts(ctx: Context, warn: (message: string) => void): Ports;
+export declare function createPorts(ctx: Context, warn: (message: string) => void, options?: PortsOptions): Ports;

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

@@ -1,6 +1,7 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ConnectionRequestRejection, ConnectionTrustRequest } from '@deepseek-ai/dsh-client-connection';
 export interface RequestFence {
-    requestRejection(request: IncomingMessage): unknown;
+    requestRejection(request: ConnectionTrustRequest): ConnectionRequestRejection;
 }
-/** 校验不过就地应答，返回是否已拒绝（非 undefined 即拒）。 */
+/** 校验不过就地应答（状态码照官方拒绝码：401 未鉴权 / 403 栅栏拒绝），返回是否已拒绝。 */
 export declare function rejected(req: IncomingMessage, res: ServerResponse, fence: RequestFence): boolean;

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

@@ -1,4 +1,10 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { RouteRuntime } from './routes.js';
 import type { HealthContributor } from '../service/health.js';
-export declare function installWebSurface(ctx: Context, runtime: RouteRuntime, registerHealth: (contributor: HealthContributor) => void): void;
+export interface WebSurfaceOptions {
+    /** 校验面迟迟不出现时补一条诊断日志的等待上限（ms）。 */
+    fenceTimeoutMs?: number | undefined;
+    /** 登录 / 登出 / 健康路由的请求体上限（字节）。 */
+    bodyLimitBytes?: number | undefined;
+}
+export declare function installWebSurface(ctx: Context, runtime: RouteRuntime, registerHealth: (contributor: HealthContributor) => void, options?: WebSurfaceOptions): void;