dsh-prime-memory 0.26.15 → 0.26.17

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 更新日志（Changelog）
 
+## [0.26.17] — 2026-11-02
+
+> **三条声明面修复：`memory:profile` 显式关插值(issue #24)、`memory_conflicts` 补两笔成熟度声明(issue #23)、DRSC 基址不再写死 8080(issue #20)**，并把「改视图忘改 schema」从注释纪律改成 CI 闸。无配置变更、无默认行为变更、`engines.dsh` 不动。
+
+### 修复
+
+- **`memory:profile` 关插值(#24)**：宿主对 systemPrompt 贡献项的 `interpolate` **缺省按 true 处理**，而画像正文由蒸馏产出、库里可能存着宿主自己发的字面 `{{TYPE_id}}` 脱敏 token——不合 `/^[a-z][a-z0-9_]*$/` 即在 prompt 组装期抛错、**整轮报废**。该正文从来不含宿主变量，插值只有风险没有收益，故注册时显式 `interpolate: false` 按原文注入。全 `src` 实测 `systemPrompt.context/section` 只有这一处注册点。
+- **`memory_conflicts` 补声明(#23)**：Phase 3 arm-2/arm-3 给视图加的两笔成熟度旁注(`maturityOf`)没同步到输出 schema，而该 schema 是 `additionalProperties: false`——宿主无损校验对每条返回逐字段拒结，工具自 0.26.11 起**任何调用都读不出**（`memory_resolve_conflict` 的描述还在把人往它指，公示的「先看后裁决」工作流事实上断链）。补 `winner_maturity`/`loser_maturity` 两键（用 `enum ['low','mid','high']` 钉死 `computeMaturity` 的三档值域）。该文件自己就写着「schema 必须跟视图同步」——纪律在注释里，闸在运行期，两者此前没有任何机械约束连着。
+- **DRSC 基址取宿主真实监听口(#20)**：`trustedHosts` 为空时回退写死 `http://127.0.0.1:8080`，而 DSH Desktop App 走随机端口 → `conversation_search` 与蒸馏背景窗在**默认配置下必坏**（0.26.x 的 L0 正文已停写、历史面完全依赖 DRSC，这条链是 load-bearing 的，不是可选增强）。现在第三档兜底取宿主监听 origin，取数逻辑抽到 `src/clients/web-server-origin.ts`（两条取数路径 + 三个抛错入口，需被单测钉住，而不是靠人肉真机核对）。**优先级与降级面钉死四件事**：① origin 只替换那句 8080，不抢 `trustedHosts` 位——现状 `explicit` 是死分支（插件没有该设置项），唯一真实旋钮是宿主 trustedHosts，放上去会把靠 `--trusted-host` 已能工作的用户改到另一个 authority，那是回归；② **优先 `getOrigin()`、再退 `port`**——两条宿主线不同形，已逐线实测取证，别拿一条线当事实：0.2.0-rc.2 源码仓的 webServer **没有** getOrigin（只有 `get port()`/`get host()`），而 0.2.1-rc.5 装机宿主（app.asar 类体）**已有** `getOrigin()`，返回 `${protocol}//${bindUrlHost(host)}:${listenedPort}`，protocol 认 TLS、bind host 走 URL 形式转换，这两个细节插件自己算不出；③ Host 头只在存在非空 trustedHosts 条目时回显（与旧版逐字同口径）——collector 信任门精确匹配 authority，拿条目原串去配带真实端口的 URL 只会把「端口不对」换成「Host 不被信任」；collector 把路由注册在宿主 webServer 上（同监听口），所以宿主 origin 就是正确基址；④ `getOrigin()` 在未 listen / 绑定地址带 zone id 时**主动抛错**（宿主类体原话：`origin read before the listener bound a port`），退 `port` 时又必须 `typeof port === 'number' && port > 0`（`listenedPort` 未 listen 读到 undefined，naive 拼接会产出 `http://127.0.0.1:undefined` 这种能发出但永远错的 URL）——取不到/抛错一律返回 undefined = **逐字节等价旧行为**。`inject` 未动（`webServer` 已在声明里），故老线零变更、`engines.dsh` 不动。
+
+### 纪律
+
+- 新增 `tests/tool-output-view-sync.test.ts`：对读工具**真实执行一次**，把返回对象的键路径拿去对照它自己声明的 `output.schema`，多一个键即红（`additionalProperties: false` 下这正是宿主的拒绝判据）。同文件另扫每个 `systemPrompt.context({`/`section({` 入参块必须显式含 `interpolate`。两条守卫均已做**红绿验证**：临时撤掉 #23/#24 的修复 → 分别报出 `$.items[0].winner_maturity` 与 `src/hooks/recall.ts:892`。
+- 覆盖面边界（文件头已如实标注）：只守「未声明的多余键」这一种（即 #23 的形状），不校验值类型/枚举，不含会改库的写侧工具。
+- 全量 **1880 例**/188 文件绿（基线 1863 例/186 文件；本版新增 	ests/tool-output-view-sync.test.ts 10 例与 	ests/web-server-origin.test.ts 7 例）。
+
 ## [0.26.15] — 2026-10-28
 
 > 真宿主验证（1197 条 L1 / 380 条 `work_method` 的真实库副本）发现 0.26.14 的**写放大**缺陷，本版修掉。单测没抱住它，因为夹具只有几条记录。

package/README.de.md

@@ -61,7 +61,7 @@ alt="DeepSeek Harness Hero-Banner: Unterhaltungen werden automatisch zu mehrschi
 > Kompatibilitätsmechanismus: Die Settings-Registrierung durchläuft zur Laufzeit drei Zweige
 > (`register` → `installSection`-Brücke → Dauerein-Notbetrieb), siehe Eintrag 0.11.0 im
 > [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` deklariert
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Schnellstart
 

package/README.en.md

@@ -61,7 +61,7 @@
 > Compatibility mechanism: settings registration uses a three-way runtime branch
 > (`register` → `installSection` bridge → always-on degradation); see the 0.11.0 entry
 > in [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` declares
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Getting Started
 

package/README.es.md

@@ -61,7 +61,7 @@ alt="Banner hero de DeepSeek Harness: las conversaciones se destilan automática
 > Mecanismo de compatibilidad: el registro de ajustes pasa en tiempo de ejecución por tres ramas
 > (`register` → puente `installSection` → degradación a siempre activado),
 > ver la entrada 0.11.0 del [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` declara
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Inicio rápido
 

package/README.fr.md

@@ -61,7 +61,7 @@ alt="Bannière hero de DeepSeek Harness : les conversations sont automatiquement
 > Mécanisme de compatibilité : l'enregistrement settings passe par trois branches à l'exécution
 > (`register` → pont `installSection` → dégradation en mode toujours actif),
 > voir l'entrée 0.11.0 du [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` déclare
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Démarrage rapide
 

package/README.it.md

@@ -61,7 +61,7 @@ alt="Banner hero di DeepSeek Harness: le conversazioni vengono distillate automa
 > Meccanismo di compatibilità: la registrazione delle impostazioni passa per tre rami a runtime
 > (`register` → ponte `installSection` → degrado a sempre-attivo),
 > vedi la voce 0.11.0 del [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` dichiara
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Avvio rapido
 

package/README.ja.md

@@ -62,7 +62,7 @@ alt="DeepSeek Harness ヒーロー画像：会話がバックグラウンドで
 
 > 互換メカニズム：settings 登録は 3 分岐のランタイム判定（`register` → `installSection` ブリッジ → 常時オン縮退）。
 > 詳細は [CHANGELOG.md](./CHANGELOG.md) の 0.11.0 エントリ参照。`dsh.plugin.json` は
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc） を宣言。
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc） を宣言。
 
 ## クイックスタート
 

package/README.ko.md

@@ -62,7 +62,7 @@ alt="DeepSeek Harness 히어로 이미지: 대화가 백그라운드에서 계
 
 > 호환 메커니즘: settings 등록은 3분기 런타임 분기（`register` → `installSection` 브리지 → 상시 온 강등）.
 > 자세한 내용은 [CHANGELOG.md](./CHANGELOG.md)의 0.11.0 항목 참조. `dsh.plugin.json`은
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc） 선언.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc） 선언.
 
 ## 빠른 시작
 

package/README.md

@@ -60,7 +60,7 @@ alt="DeepSeek Harness hero 横幅：对话自动分层蒸馏成记忆，模型
 
 > 兼容机制：settings 注册走运行时三分支（`register` → `installSection` 桥接 → 恒开降级），
 > 详见 [CHANGELOG.md](./CHANGELOG.md) 的 0.11.0 条目。`dsh.plugin.json` 声明
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）。
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）。
 
 ## 快速开始
 

package/README.ru.md

@@ -61,7 +61,7 @@ alt="Баннер hero DeepSeek Harness: диалоги автоматическ
 > Механизм совместимости: регистрация настроек на этапе исполнения идёт по трём ветвям
 > (`register` → мост `installSection` → деградация в режим «всегда включено»),
 > подробнее — запись 0.11.0 в [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` объявляет
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.5，20 rc）.
 
 ## Быстрый старт
 

package/dist/clients/drsc.d.ts

@@ -17,10 +17,13 @@
  * 分口径处理:蒸馏背景窗空窗降级(runner),工具面显式报错(tools)。
  *
  * 同源 Host 解析(steward drs-source 的 resolveDrsBaseUrl 同款):
- * 显式 baseUrl > 首个 trustedHosts 条目(补 http://)> `http://127.0.0.1:8080`
- * (宿主缺省口)。Host 头回显首个 trustedHosts 条目:collector 信任门是精确
- * 匹配,条目省略端口而 URL 带端口会失配。trustedHosts 惰性读取(webStartup
- * 可能晚于本插件就绪),每次请求现算,无缓存陈旧面。
+ * 显式 baseUrl > 首个 trustedHosts 条目(补 http://)> 宿主实际监听 origin
+ * (issue #20:Desktop App 走随机端口,写死 8080 永远对不上)> `http://127.0.0.1:8080`
+ * (宿主缺省口)。Host 头**只回显被选作基址的那个 trustedHosts 条目**:collector
+ * 信任门是精确匹配,条目省略端口而 URL 带端口会失配——所以基址来自 origin 兜底时
+ * 索性不回显(等价于旧版 trustedHosts 为空时的形状),而不是拿另一个 authority 去撞门。
+ * trustedHosts / origin 均惰性读取(webStartup、webServer 可能晚于本插件就绪),
+ * 每次请求现算,无缓存陈旧面。
  */
 import type { ConversationMessage } from '../types.js';
 /** collector API 路径(与其 DRS_API_PATH 字面一致;不跨包 import)。 */
@@ -33,11 +36,25 @@ export declare class DrscClientError extends Error {
         cause?: unknown;
     });
 }
+/** 基址与其来源。 */
+export interface ResolvedDrscBase {
+    url: string;
+    /** 基址是否取自显式配置或 trustedHosts 条目(即解析序的前两档)。 */
+    fromConfigured: boolean;
+}
+/** 供 Host 回显的条目:须与 {@link resolveDrscBaseUrl} 的选取口径逐字一致。 */
+export declare function firstDrscTrustedHost(trustedHosts?: readonly string[]): string | undefined;
 /**
- * 基址解析:显式配置 > 首个 trustedHosts 条目(补 http:// 前缀)>
- * `http://127.0.0.1:8080`(宿主默认口;trustedHosts 缺席的老线 collector 门本就放行)。
+ * 基址解析:显式配置 > 首个 trustedHosts 条目(补 http:// 前缀)> 宿主实际监听
+ * origin(issue #20 新增的兜底)> `http://127.0.0.1:8080`(宿主默认口;trustedHosts
+ * 缺席的老线 collector 门本就放行)。
+ *
+ * origin 刻意排在 trustedHosts **之下**:它只替换那句写死的 8080。放上去会把
+ * 已经能工作的配置(靠 `--trusted-host` 指过地址)改到另一个 authority 上,那是回归。
  */
-export declare function resolveDrscBaseUrl(explicit: string | undefined, trustedHosts?: readonly string[]): string;
+export declare function resolveDrscBaseUrl(explicit: string | undefined, trustedHosts?: readonly string[], fallbackOrigin?: string): string;
+/** {@link resolveDrscBaseUrl} 的带来源形态,供客户端决定 Host 回显。 */
+export declare function resolveDrscBaseUrlDetail(explicit: string | undefined, trustedHosts?: readonly string[], fallbackOrigin?: string): ResolvedDrscBase;
 /** `op=session` 的一个 segment 行(redact=1 时 text 为脱敏正文;wire 蛇形直取)。 */
 export interface DrscSessionRow {
     seq: number;
@@ -79,10 +96,15 @@ export declare function drscRoleOf(kind: string): 'user' | 'assistant' | undefin
  */
 export declare function drscRowToConversationMessage(row: DrscSessionRow, sessionId: string): ConversationMessage | undefined;
 export interface DrscClientOptions {
-    /** 显式基址(缺省走 trustedHosts → 127.0.0.1:8080,见 resolveDrscBaseUrl)。 */
+    /** 显式基址(缺省走 trustedHosts → 宿主 origin → 127.0.0.1:8080,见 resolveDrscBaseUrl)。 */
     baseUrl?: string;
     /** trustedHosts 惰性读取(webStartup 服务可能晚于装配;每次请求现取)。 */
     trustedHosts?: () => readonly string[] | undefined;
+    /**
+     * 宿主实际监听 origin 惰性读取(issue #20)。webServer 服务可能晚就绪/换实例/
+     * 下线,故与 trustedHosts 同款每次现取;取不到即返回 undefined → 落回 8080 老行为。
+     */
+    origin?: () => string | undefined;
     /** 注入面(单测);缺省全局 fetch。 */
     fetchImpl?: typeof fetch;
     /** 单请求超时 ms;缺省 {@link DRSC_DEFAULT_TIMEOUT_MS}。 */
@@ -93,8 +115,10 @@ export declare class DrscClient {
     private readonly fetchImpl;
     private readonly timeoutMs;
     constructor(options?: DrscClientOptions);
-    /** 每次请求现算基址与 Host 回显(trustedHosts 惰性;无缓存陈旧面)。 */
+    /** 每次请求现算基址与 Host 回显(trustedHosts/origin 惰性;无缓存陈旧面)。 */
     private base;
+    /** origin 探针失败(服务未就绪/属性读抛)不得影响请求:视作取不到,落老行为。 */
+    private safeOrigin;
     /** 一个 GET 的 JSON 包络(非 2xx / ok!==true / 超时 / 断网一律抛 DrscClientError)。 */
     private getJson;
     /**

package/dist/clients/drsc.js

@@ -9,16 +9,32 @@ export class DrscClientError extends Error {
         this.name = 'DrscClientError';
     }
 }
+/** 供 Host 回显的条目:须与 {@link resolveDrscBaseUrl} 的选取口径逐字一致。 */
+export function firstDrscTrustedHost(trustedHosts) {
+    return trustedHosts?.find((entry) => entry.trim() !== '')?.trim();
+}
 /**
- * 基址解析:显式配置 > 首个 trustedHosts 条目(补 http:// 前缀)>
- * `http://127.0.0.1:8080`(宿主默认口;trustedHosts 缺席的老线 collector 门本就放行)。
+ * 基址解析:显式配置 > 首个 trustedHosts 条目(补 http:// 前缀)> 宿主实际监听
+ * origin(issue #20 新增的兜底)> `http://127.0.0.1:8080`(宿主默认口;trustedHosts
+ * 缺席的老线 collector 门本就放行)。
+ *
+ * origin 刻意排在 trustedHosts **之下**:它只替换那句写死的 8080。放上去会把
+ * 已经能工作的配置(靠 `--trusted-host` 指过地址)改到另一个 authority 上,那是回归。
  */
-export function resolveDrscBaseUrl(explicit, trustedHosts) {
+export function resolveDrscBaseUrl(explicit, trustedHosts, fallbackOrigin) {
+    return resolveDrscBaseUrlDetail(explicit, trustedHosts, fallbackOrigin).url;
+}
+/** {@link resolveDrscBaseUrl} 的带来源形态,供客户端决定 Host 回显。 */
+export function resolveDrscBaseUrlDetail(explicit, trustedHosts, fallbackOrigin) {
     const trimmed = explicit?.trim() ?? '';
-    const pick = trimmed !== '' ? trimmed : trustedHosts?.find((entry) => entry.trim() !== '')?.trim();
-    if (pick === undefined || pick === '')
-        return 'http://127.0.0.1:8080';
-    return /^https?:\/\//u.test(pick) ? pick : `http://${pick}`;
+    const pick = trimmed !== '' ? trimmed : firstDrscTrustedHost(trustedHosts);
+    if (pick !== undefined && pick !== '') {
+        return { url: /^https?:\/\//u.test(pick) ? pick : `http://${pick}`, fromConfigured: true };
+    }
+    const origin = fallbackOrigin?.trim() ?? '';
+    if (origin !== '')
+        return { url: origin, fromConfigured: false };
+    return { url: 'http://127.0.0.1:8080', fromConfigured: false };
 }
 /** kind → L0 角色词表(memory 只收 user/assistant 两类,其余(tool/* 等)不映射)。 */
 export function drscRoleOf(kind) {
@@ -80,12 +96,28 @@ export class DrscClient {
         this.fetchImpl = options.fetchImpl ?? fetch;
         this.timeoutMs = options.timeoutMs ?? DRSC_DEFAULT_TIMEOUT_MS;
     }
-    /** 每次请求现算基址与 Host 回显(trustedHosts 惰性;无缓存陈旧面)。 */
+    /** 每次请求现算基址与 Host 回显(trustedHosts/origin 惰性;无缓存陈旧面)。 */
     base() {
         const trusted = this.options.trustedHosts?.() ?? [];
-        const base = resolveDrscBaseUrl(this.options.baseUrl, trusted).replace(/\/+$/u, '');
-        const first = trusted.find((entry) => entry.trim() !== '')?.trim();
-        return { url: `${base}${DRSC_API_PATH}`, ...(first !== undefined ? { hostHeader: first } : {}) };
+        const origin = this.safeOrigin();
+        const resolved = resolveDrscBaseUrlDetail(this.options.baseUrl, trusted, origin);
+        const base = resolved.url.replace(/\/+$/u, '');
+        // Host 头只在**存在非空 trustedHosts 条目**时回显(与旧版逐字同口径)。基址来自
+        // origin 兜底时本来就没有条目可回显,而 collector 信任门精确匹配 authority,
+        // 拿条目原串去配一个带真实端口的 URL 只会失配(#20 的报错面)。
+        const echo = resolved.fromConfigured ? firstDrscTrustedHost(trusted) : undefined;
+        return { url: `${base}${DRSC_API_PATH}`, ...(echo !== undefined ? { hostHeader: echo } : {}) };
+    }
+    /** origin 探针失败(服务未就绪/属性读抛)不得影响请求:视作取不到,落老行为。 */
+    safeOrigin() {
+        if (this.options.origin === undefined)
+            return undefined;
+        try {
+            return this.options.origin();
+        }
+        catch {
+            return undefined;
+        }
     }
     /** 一个 GET 的 JSON 包络(非 2xx / ok!==true / 超时 / 断网一律抛 DrscClientError)。 */
     async getJson(query) {

package/dist/clients/web-server-origin.d.ts

@@ -0,0 +1,35 @@
+/**
+ * issue #20:宿主实际监听 origin 的降级读取（DrscClient 的第三档兜底）。
+ *
+ * 为何不写在 index.ts 里：它有两条取数路径 + 三个抛错入口，是需要被单测钉住的可判定
+ * 逻辑；埋在装配文件里就只能靠人肉真机核对，而 #20 的整条因果链正是「没人核对过」。
+ *
+ * 优先取 `getOrigin()`，再退 `port`——两者的可用性已逐线实测取证，别拿一条线当事实：
+ * ・0.2.0-rc.2 源码仓的 webServer **没有** getOrigin()，只有 `get port()` / `get host()`；
+ * ・0.2.1-rc.5 装机宿主（app.asar 内类体）已有 `getOrigin()`，返回
+ *   `${protocol}//${bindUrlHost(host)}:${listenedPort}`——protocol 认 TLS、bind host 走
+ *   URL 形式转换，这两个细节本插件自己算不出来，所以新线一律用它。
+ *
+ * 三条硬降级理由（缺一就不能发）：
+ * ① `getOrigin()` 在未 listen / 绑定地址带 zone id 时**主动抛错**（不是返回 undefined），
+ *    所以必须包 try——这里抛错是预期的「还没就绪」，不是异常；
+ * ② 老线无 getOrigin 时退 `port`：宿主侧 `listenedPort` 未 listen 时读到 undefined，
+ *    naive 模板串会产出 `http://127.0.0.1:undefined` 这种能发出去但永远错的 URL，
+ *    故仅当 `typeof port === 'number' && port > 0` 才用（这条退化路径把 TLS / 非 loopback
+ *    绑定当作 http+127.0.0.1 处理——那正是旧版本写死 8080 也没解决的面，不比旧行为更差）；
+ * ③ cordis Proxy 面对未授权属性会直接抛，故与 webStartup 的 trustedHosts 读取同款两层 try。
+ *
+ * 一律「取不到就返回 undefined」：调用方据此落回写死的 8080，即逐字节等价旧行为。
+ */
+/** 本模块用到的 webServer 服务面（结构类型，不依赖宿主包类型导出）。 */
+export interface WebServerOriginFace {
+    /** 0.2.1-rc.5 起存在；未 listen / 绑定地址无 URL 形式时抛错。 */
+    getOrigin?: () => unknown;
+    /** OS 分配的实际监听口；未 listen 时为 undefined（老线只有这一档）。 */
+    port?: unknown;
+}
+/**
+ * 读取宿主监听 origin；任何取不到/抛错都返回 undefined（不抛，不影响请求）。
+ * @param ctx - 只用到 webServer 属性与可选的 ctx.get，故类型刻意收窄。
+ */
+export declare function readWebServerOrigin(ctx: unknown): string | undefined;

package/dist/clients/web-server-origin.js

@@ -0,0 +1,70 @@
+/**
+ * issue #20:宿主实际监听 origin 的降级读取（DrscClient 的第三档兜底）。
+ *
+ * 为何不写在 index.ts 里：它有两条取数路径 + 三个抛错入口，是需要被单测钉住的可判定
+ * 逻辑；埋在装配文件里就只能靠人肉真机核对，而 #20 的整条因果链正是「没人核对过」。
+ *
+ * 优先取 `getOrigin()`，再退 `port`——两者的可用性已逐线实测取证，别拿一条线当事实：
+ * ・0.2.0-rc.2 源码仓的 webServer **没有** getOrigin()，只有 `get port()` / `get host()`；
+ * ・0.2.1-rc.5 装机宿主（app.asar 内类体）已有 `getOrigin()`，返回
+ *   `${protocol}//${bindUrlHost(host)}:${listenedPort}`——protocol 认 TLS、bind host 走
+ *   URL 形式转换，这两个细节本插件自己算不出来，所以新线一律用它。
+ *
+ * 三条硬降级理由（缺一就不能发）：
+ * ① `getOrigin()` 在未 listen / 绑定地址带 zone id 时**主动抛错**（不是返回 undefined），
+ *    所以必须包 try——这里抛错是预期的「还没就绪」，不是异常；
+ * ② 老线无 getOrigin 时退 `port`：宿主侧 `listenedPort` 未 listen 时读到 undefined，
+ *    naive 模板串会产出 `http://127.0.0.1:undefined` 这种能发出去但永远错的 URL，
+ *    故仅当 `typeof port === 'number' && port > 0` 才用（这条退化路径把 TLS / 非 loopback
+ *    绑定当作 http+127.0.0.1 处理——那正是旧版本写死 8080 也没解决的面，不比旧行为更差）；
+ * ③ cordis Proxy 面对未授权属性会直接抛，故与 webStartup 的 trustedHosts 读取同款两层 try。
+ *
+ * 一律「取不到就返回 undefined」：调用方据此落回写死的 8080，即逐字节等价旧行为。
+ */
+/**
+ * 读取宿主监听 origin；任何取不到/抛错都返回 undefined（不抛，不影响请求）。
+ * @param ctx - 只用到 webServer 属性与可选的 ctx.get，故类型刻意收窄。
+ */
+export function readWebServerOrigin(ctx) {
+    const svc = getWebServerFace(ctx);
+    if (svc === undefined)
+        return undefined;
+    // 首选宿主自算的 origin：protocol 与 bind host 形式都由它给定
+    try {
+        if (typeof svc.getOrigin === 'function') {
+            const origin = svc.getOrigin();
+            if (typeof origin === 'string' && origin.trim() !== '')
+                return origin.trim();
+        }
+    }
+    catch {
+        /* 未 listen / 绑定地址带 zone id：落到 port 一档，再落不动即交给调用方缺省 */
+    }
+    try {
+        const port = svc.port;
+        if (typeof port !== 'number' || !Number.isFinite(port) || port <= 0)
+            return undefined;
+        return `http://127.0.0.1:${port}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** webServer 实例读取（服务可能晚于本插件就绪；属性读抛则当作未就绪）。 */
+function getWebServerFace(ctx) {
+    if (typeof ctx !== 'object' || ctx === null)
+        return undefined;
+    const carrier = ctx;
+    try {
+        const direct = carrier.webServer;
+        const svc = direct !== undefined
+            ? direct
+            : typeof carrier.get === 'function'
+                ? carrier.get('webServer')
+                : undefined;
+        return typeof svc === 'object' && svc !== null ? svc : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/hooks/recall.js

@@ -723,6 +723,11 @@ usage) {
             contextDisposers.push(agent.ctx.systemPrompt.context({
                 name: 'memory:profile',
                 order: 510,
+                // issue #24:正文由蒸馏产出(L3 画像),库里可能存着宿主自己发的字面
+                // `{{TYPE_id}}` 脱敏 token。宿主对 interpolate 缺省按 true 处理,遇到不合
+                // `/^[a-z][a-z0-9_]*$/` 的变量组即在 prompt 组装期抛错、整轮报废——而本
+                // 文本从来不含宿主变量,插值只有风险没有收益,故显式关闭按原文注入。
+                interpolate: false,
                 text: () => {
                     const final = composeStableText(agent.id);
                     const ledger = ledgerFor(agent.id);

package/dist/index.js

@@ -53,6 +53,7 @@ import { ObsoleteNoticeStore } from './store/obsolete-notices.js';
 import { registerSlotsProjection } from './projection/slots.js';
 import { registerRecallProjection } from './projection/recall.js';
 import { DrscClient } from './clients/drsc.js';
+import { readWebServerOrigin } from './clients/web-server-origin.js';
 import { errDetail, withFileLog } from './util/filelog.js';
 import { buildRouteChain, resolveModelRoute, invalidateEffortCache } from './llm.js';
 import { effectiveCfg } from './pipeline/runner.js';
@@ -84,6 +85,8 @@ function readStartupTrustedHosts(ctx) {
     }
     return undefined;
 }
+// issue #20:DrscClient 的第三档兜底。取数逻辑已抽到 clients/web-server-origin.ts
+// (两条取数路径 + 三个抛错入口,需要被单测钉住而不是靠人肉真机核对),此处只接线。
 /**
  * 硬依赖:蒸馏要用 llm,工具注册要用 tools,召回注入要用 systemPrompt。
  * 0.1.5 起 connection.rpc.handle() 把 /rpc 路由登记到 webServer 时按**调用方
@@ -213,8 +216,11 @@ export async function apply(ctx, config) {
         // 轨2 技能结晶生产者（issue #15 的缺失环节）：装配于下方（依赖 skillStore 就绪）。
         skills: undefined,
         // DRSC 客户端(T8.4 读切):蒸馏背景窗 + conversation_search 工具面的历史供给。
-        // 硬依赖无本地回退(l0 表退役);trustedHosts 惰性读取(webStartup 可能晚到)。
-        drsc: new DrscClient({ trustedHosts: () => readStartupTrustedHosts(ctx) }),
+        // 硬依赖无本地回退(l0 表退役);trustedHosts 与宿主 origin 均惰性读取(两者可能晚于本插件就绪)。
+        drsc: new DrscClient({
+            trustedHosts: () => readStartupTrustedHosts(ctx),
+            origin: () => readWebServerOrigin(ctx),
+        }),
         l0: new L0Store(db),
         l1: new L1Store(dataDir, db, embed, config.recall.strategy, logger, config.recall.decayHalfLifeDays, 
         // §D 第 3 路:图谱回链(声明于 stores 之前,embed 查询在下方接线)。

package/dist/tools/index.js

@@ -1666,7 +1666,7 @@ graphWrite) {
                                 loser_id: { type: 'string' },
                                 loser_content: { type: 'string', description: '同上' },
                                 created_at: { type: 'string' },
-                                // 以下 10 项与 conflict-service.listConflictPairs 视图逐一对齐(task 三轴/R1/Phase3):
+                                // 以下 12 项与 conflict-service.listConflictPairs 视图逐一对齐(task 三轴/R1/Phase3):
                                 // execute 直接返回该视图,additionalProperties:false 下少声明任何一个,
                                 // 宿主无损校验即拒("not a declared property"),整工具读不出——schema 必须跟视图同步。
                                 winner_valid_from_ms: { oneOf: [{ type: 'number' }, { type: 'null' }] },
@@ -1679,6 +1679,12 @@ graphWrite) {
                                 defer_count: { type: 'number', description: '复看次数(defer 上限 3)' },
                                 conflict_type: { type: 'string', description: '冲突类型(默认 hard)' },
                                 claim_key: { type: 'string', description: '同主题多对冲突的归并键(空串=未分组)' },
+                                // issue #23:Phase 3 arm-2/arm-3 给视图加了两笔成熟度旁注
+                                // (conflict-service.ts 的 maturityOf),声明面没跟着走 → `additionalProperties: false`
+                                // 下宿主无损校验逐条拒结,整工具读不出。`computeMaturity` 恒返三档、
+                                // 无 undefined 无第四值,故用 enum 而不是 free string。
+                                winner_maturity: { type: 'string', enum: ['low', 'mid', 'high'], description: '胜方成熟度(读时派生,不参与自动裁决)' },
+                                loser_maturity: { type: 'string', enum: ['low', 'mid', 'high'], description: '同上,败方' },
                             },
                             additionalProperties: false,
                         },

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.15",
+  "version": "0.26.17",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"
@@ -13,10 +13,10 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5"
   },
   "components": {
     "host": "dist/index.js",
     "client": "dist/client.js"
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.15",
+  "version": "0.26.17",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",
@@ -80,7 +80,7 @@
   },
   "engines": {
     "node": ">=22.16.0",
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5"
   },
   "keywords": [
     "dsh",
@@ -104,15 +104,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent": {
@@ -168,4 +168,4 @@
     "typescript-eslint": "^8.69.0",
     "vitest": "^4.1.11"
   }
-}
+}