dsh-session-title-gen 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2026-09-19
+
+### 变更
+
+- docs(session-title-gen): 在 README 接入真实设置页效果图
+- feat(session-title-gen): 新增设置页面板，8 项配置可视化编辑（#385）
+
 ## [0.1.0] - 2026-09-06
 
 ### Added

package/README.md

@@ -14,6 +14,7 @@
 - **重启后标题保留**：经 DSH 核心 `session/title` 事件（log-backed）写入，DSH 原生会话列表与 observability 面板均显示新标题。
 - **失败静默回退**：LLM 不可用 / 超时 / 输出为空时不阻塞会话，核心标题机制照常工作。
 - **与核心标题机制协作**：不注册标题 provider，直接 append `session/title` 事件覆盖；核心生成的非结构化标题（fallback / provider）会触发本插件重新生成；用户手动重命名的标题（source: user）不被覆盖。
+- **设置页可视化配置**：「设置 → 插件 → 会话标题生成」可视化编辑全部 8 项配置，保存写回 profile 的 `cordis.patch.yml` 并**热生效**（不必重启），无需手写 yml。
 
 ## 配置
 
@@ -35,6 +36,23 @@
     template: '[{workspace}] {description}'
 ```
 
+## 设置页
+
+![设置 → 插件 → 会话标题生成：8 项配置可视化编辑](./assets/settings-panel.png)
+
+「设置 → 插件 → 会话标题生成」提供 8 项配置的可视化编辑（不写 yml 也能改）：
+
+| 分组 | 项                                                                        |
+| ---- | ------------------------------------------------------------------------- |
+| 开关 | `enabled`                                                                 |
+| 文本 | `template`（多行模板）、`provider`、`model`（后两者留空 = 跟随本次会话）  |
+| 数字 | `maxTitleBytes`、`maxInputBytes`、`maxOutputTokens`、`timeoutMs`（正整数） |
+
+- 保存走 `PUT /session-title-gen/api/config`：**先合并该行已有键再写回** profile 的 `cordis.patch.yml`——不会删掉你在同一行手写的其它配置键，也不会动别的插件行。
+- 保存**立即生效**：模板 / 上限改动对后续会话生效；关闭 `enabled` 后立刻停止监听会话事件（不必重启 DSH）。
+- 非法值只忽略该字段并回退默认值（同一次提交里的其它合法字段照常保存），保存后表单回填**实际生效值**，不会出现「看着存了、其实没生效」。
+- 禁用状态下设置页依然可打开——否则没有任何入口把插件重新打开。
+
 ## 安装
 
 ```bash

package/cordis.patch.yml

@@ -1,6 +1,12 @@
 # dsh-session-title-gen bundle patch: inserts the plugin row into the profile
 # roster. The row mounts the server half (session/event listener + LLM title
-# generation + session/title append). Install with:
+# generation + session/title append) and the client half (the
+# 「设置 → 插件 → 会话标题生成」settings tab for the 8 config keys below).
+#
+# 配置项（8 项）既可在 profile 的 cordis.patch.yml 的 config 下手写，也可在设置页
+# 可视化编辑：设置页保存走 PUT /session-title-gen/api/config，写回**本行**（行 id
+# `session-title-gen`）的 config 并热生效；写回前先合并本行已有键，不会删掉你手写的其它键。
+# Install with:
 #
 #   git clone https://github.com/baosfeng/my-dsh-plugins.git
 #   dsh plugin --profile web add link:<仓库路径>/plugins/dsh-session-title-gen

package/lib/client.js

@@ -0,0 +1,413 @@
+/**
+ * dsh-session-title-gen — client half (settings tab, issue #385). SOURCE TEMPLATE.
+ *
+ * 提供「设置 → 插件 → 会话标题生成」设置页签：可视化编辑 8 项配置
+ * （enabled / template / provider / model / maxTitleBytes / maxInputBytes /
+ * maxOutputTokens / timeoutMs），保存经 PUT 到插件配置端点，由 host 半写回
+ * profile 的 cordis.patch.yml 并热生效（详见 src/config-routes.ts）。
+ *
+ * 本插件的标题生成逻辑全在 server 端，client 半没有其它职责。
+ *
+ * BUILD NOTE: 本文件是源码模板（骨架）。scripts/build.mjs 先 tsc 编译
+ * src/client/index.ts → lib/.client-build/index.js（CommonJS 单文件），再把编译产物、
+ * src/client 的 part 片段（strings.ts / settings.ts 的产物）与 dsh-shared/client-parts
+ * 的样式注入件依次注入下方占位符，写出 lib/client.js —— DSH 实际提供的产物（单一
+ * __ModuleLoader__ bundle，无相对路径 require）。产物必须提交（CI 只跑
+ * node --check + 测试，不跑构建）。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-session-title-gen',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+    // useState / useEffect 供设置页 part 使用（模板静态分析看不到 part 内容，故在此一并解构）
+    const { createElement, useState, useEffect } = require('react')
+
+    // ── 共享样式注入（dsh-shared/client-parts，issue #186 P2）──────────
+    // ── shared plugin stylesheet injection (dsh-shared/client-parts) ──
+// 单一来源（issue #186 P2）：把「注入 <style data-<plugin>="styles"> 并随 fiber
+// teardown 卸载」这段逐字相同的样板从渲染插件收口到这里。当前调用方：
+// dsh-md-render（parts/apply.ts）/ dsh-mermaid-render（client/index.ts）/
+// dsh-think-zh-expand（client/index.ts）——各自 scripts/build.mjs 在构建期把本
+// 文件拼进 __ModuleLoader__ factory 作用域（构建时源文件，不经过 require 解析）。
+//
+// 为什么「无条件、最先注入、不进早退分支」：样式若挂在某个服务判空之后，
+// HMR / 服务缺省时样式就丢了（dsh-file-activity 踩坑，见三处调用点的原注释）。
+/**
+ * 注入插件样式表，随 ctx fiber 卸载（HMR/禁用无残留）。
+ *
+ * @param {{ effect: (fn: () => void | (() => void), label?: string) => void }} ctx cordis client ctx
+ * @param {string} attr 标识属性名（如 'data-dsh-md-render'；值固定为 'styles'）
+ * @param {string} css 样式表文本
+ * @param {string} label effect 标签（如 'dsh-md-render: styles'，HMR/调试定位用）
+ * @returns {void}
+ */
+function installStyles(ctx, attr, css, label) {
+  ctx.effect(() => {
+    if (typeof document === 'undefined' || document === null || typeof document.head === 'undefined') return () => {}
+    const style = document.createElement('style')
+    style.setAttribute(attr, 'styles')
+    style.textContent = css
+    document.head.appendChild(style)
+    return () => {
+      if (style.parentNode) style.parentNode.removeChild(style)
+    }
+  }, label)
+}
+
+
+    // ── 设置页文案（src/client/strings.ts 产物，issue #385）────────────
+    "use strict";
+// ── 设置页文案与本地化（issue #385）：按当前语言返回**单语** ──────────────
+// 判据沿用本仓库设置页惯例（docs/UI规范.md「文案与国际化」）：读到 <html lang>
+// （宿主 locale 写入）时优先它，避免「浏览器英文 + 宿主中文」错配；取不到再回退
+// navigator.language 前缀判 zh，try/catch 兜底英文。
+//
+// **文案一律写成惰性函数**（宿主靠重注册跟随语言切换），且**每种语言只出一份**——
+// 「中文 (English)」并排塞进同一段会让设置行视觉臃肿，是本仓库已纠正的写法。
+// 页签名与英文文案都避开 dsh-think-zh-expand 中文化词表的全等键（该插件会全局改写
+// 宿主渲染出的英文串，如 Session log → 会话日志）。
+//
+// 本文件是 part 片段（无 import/export）：由 scripts/build.mjs 注入
+// lib/client.src.js 的文案占位符，与设置页视图件共享 __ModuleLoader__ factory
+// 作用域（类型来自 globals.d.ts）。
+/** 页签 id：必须全局唯一——复用宿主已发出的 id 会**顶掉**对方那一格（静默故障）。 */
+const SESSION_TITLE_SETTINGS_TAB_ID = 'session-title-gen-settings';
+/** 配置端点（与 host 半 src/config-routes.ts 的 CONFIG_ROUTE_PREFIX + /config 一致）。 */
+const SESSION_TITLE_SETTINGS_API = '/session-title-gen/api/config';
+/** 当前界面语言是否为中文：宿主 locale（<html lang>）优先，回退 navigator.language。 */
+function sessionTitleIsZh() {
+    try {
+        const lang = document.documentElement?.getAttribute?.('lang');
+        if (typeof lang === 'string' && lang !== '')
+            return lang.toLowerCase().startsWith('zh');
+    }
+    catch {
+        // 极简宿主 / 测试桩没有 documentElement：回退 navigator.language
+    }
+    try {
+        return (navigator.language || 'en').toLowerCase().startsWith('zh');
+    }
+    catch {
+        return false;
+    }
+}
+/** 按语言二选一（单语；每次调用重新判定，不缓存）。 */
+function sessionTitleText(zh, en) {
+    return sessionTitleIsZh() ? zh : en;
+}
+/** 设置页文案（页签 / 状态提示 / 每个字段的标题与说明）。 */
+const SESSION_TITLE_SETTINGS_STRINGS = {
+    tabLabel: () => sessionTitleText('会话标题生成', 'Session titles'),
+    loading: () => sessionTitleText('加载中…', 'Loading…'),
+    loadFailed: () => sessionTitleText('配置加载失败', 'Failed to load settings'),
+    retry: () => sessionTitleText('重试', 'Retry'),
+    save: () => sessionTitleText('保存', 'Save'),
+    saved: () => sessionTitleText('已保存', 'Saved'),
+    saveFailed: () => sessionTitleText('保存失败', 'Save failed'),
+    errorRouteMissing: () => sessionTitleText('服务端插件未加载：' +
+        SESSION_TITLE_SETTINGS_API +
+        ' 不存在（请确认已安装并启用 dsh-session-title-gen 后重启 DSH）', 'Server plugin not loaded: ' +
+        SESSION_TITLE_SETTINGS_API +
+        ' is missing (install and enable dsh-session-title-gen, then restart DSH)'),
+    errorForbidden: () => sessionTitleText('请求被安全围栏拒绝（403）：请检查网络/代理设置', 'Rejected by the security fence (403): check network/proxy settings'),
+    errorNetwork: () => sessionTitleText('网络错误或响应异常：请检查 DSH 服务是否正常运行', 'Network error or unexpected response: check that the DSH server is running'),
+    fields: {
+        enabled: {
+            label: () => sessionTitleText('启用自动标题', 'Auto title generation'),
+            hint: () => sessionTitleText('关闭后不再自动生成会话标题', 'When off, no titles are generated automatically'),
+        },
+        template: {
+            label: () => sessionTitleText('标题模板', 'Title template'),
+            hint: () => sessionTitleText('{workspace} 表示归属、{description} 表示描述', '{workspace} is the project, {description} the summary'),
+        },
+        provider: {
+            label: () => sessionTitleText('模型提供方', 'Provider'),
+            hint: () => sessionTitleText('留空则跟随当前会话', 'Empty follows the session'),
+        },
+        model: {
+            label: () => sessionTitleText('模型', 'Model'),
+            hint: () => sessionTitleText('留空则跟随当前会话', 'Empty follows the session'),
+        },
+        maxTitleBytes: {
+            label: () => sessionTitleText('标题长度上限', 'Max title bytes'),
+            hint: () => sessionTitleText('超出部分会被截断', 'Longer titles get truncated'),
+        },
+        maxInputBytes: {
+            label: () => sessionTitleText('输入长度上限', 'Max input bytes'),
+            hint: () => sessionTitleText('送入模型的最大输入长度', 'Largest input sent to the model'),
+        },
+        maxOutputTokens: {
+            label: () => sessionTitleText('输出长度上限', 'Max output tokens'),
+            hint: () => sessionTitleText('生成标题的最大输出长度', 'Largest output for the title'),
+        },
+        timeoutMs: {
+            label: () => sessionTitleText('超时时间', 'Timeout (ms)'),
+            hint: () => sessionTitleText('单次生成的最长等待时间', 'Longest wait for one generation'),
+        },
+    },
+};
+
+
+    // ── 设置页视图与注册（src/client/settings.ts 产物，issue #385）──────
+    "use strict";
+// ── 设置页视图与页签注册（issue #385）：会话标题生成的 8 项配置 ───────────
+// 官方 slots 扩展点：设置 → 插件 → 会话标题生成。字段与 host 半一一对应
+// （enabled / template / provider / model / maxTitleBytes / maxInputBytes /
+// maxOutputTokens / timeoutMs），语义与默认值口径以 src/config.ts 为唯一来源：
+// 非法值只影响该字段（host 回退默认并把规整后的值回给本页回填）。
+// 保存走 PUT 到插件配置端点 → host 半写回 profile patch（持久化）+ 更新内存生效值
+// （保存即生效，不等 patch 热重载、不必重启 DSH）。
+//
+// 本文件是 part 片段：无 import/export，与 index.ts 的 tsc 产物、strings.ts 的文案件、
+// dsh-shared client-parts 共享 __ModuleLoader__ factory 作用域（类型来自 globals.d.ts），
+// 由 scripts/build.mjs 注入 lib/client.src.js 的设置页占位符（见该文件与 build.mjs 的
+// 设置页占位符常量；此处刻意不写出该占位符字面量，否则产物里会出现第二个同形字面量）。
+/** 设置页样式前缀（UI 规范：`dsh-<插件名>-`）。 */
+const SESSION_TITLE_SETTINGS_CLASS = 'dsh-session-title-gen-settings';
+/** 设置页样式：只用宿主语义变量（--dsw-*），跟随深浅主题，不硬编码色值。 */
+const SESSION_TITLE_SETTINGS_STYLES = `
+.${SESSION_TITLE_SETTINGS_CLASS}{display:flex;flex-direction:column;gap:8px;padding:12px}
+.${SESSION_TITLE_SETTINGS_CLASS}-row{display:flex;align-items:flex-start;justify-content:space-between;gap:10px;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2)}
+.${SESSION_TITLE_SETTINGS_CLASS}-info{display:flex;flex-direction:column;gap:2px;min-width:0;flex:auto}
+.${SESSION_TITLE_SETTINGS_CLASS}-label{font:var(--dsw-font-xs-strong-13);color:var(--dsw-alias-label-primary)}
+.${SESSION_TITLE_SETTINGS_CLASS}-hint{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-tertiary);line-height:1.5}
+.${SESSION_TITLE_SETTINGS_CLASS}-input{flex:none;width:190px;max-width:46%;box-sizing:border-box;padding:4px 8px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:var(--dsw-font-xxs-12)}
+.${SESSION_TITLE_SETTINGS_CLASS}-input:focus{outline:none;border-color:var(--dsw-alias-accent)}
+.${SESSION_TITLE_SETTINGS_CLASS}-input-multiline{width:100%;max-width:none;min-height:48px;resize:vertical;line-height:1.5}
+.${SESSION_TITLE_SETTINGS_CLASS}-toggle{flex:none;width:34px;height:20px;border-radius:10px;border:1px solid var(--dsw-alias-border-l2);background:color-mix(in srgb, var(--dsw-alias-label-tertiary) 30%, transparent);position:relative;cursor:pointer;transition:background var(--ds-transition-duration-slow) var(--ds-ease-in-out),border-color var(--ds-transition-duration-slow) var(--ds-ease-in-out)}
+.${SESSION_TITLE_SETTINGS_CLASS}-toggle[data-on="true"]{background:var(--dsw-alias-state-success-primary);border-color:transparent}
+.${SESSION_TITLE_SETTINGS_CLASS}-toggle::after{content:"";position:absolute;top:2px;left:2px;width:14px;height:14px;border-radius:50%;background:var(--dsw-alias-label-primary);transition:transform var(--ds-transition-duration-slow) var(--ds-ease-in-out),background var(--ds-transition-duration-slow) var(--ds-ease-in-out)}
+.${SESSION_TITLE_SETTINGS_CLASS}-toggle[data-on="true"]::after{transform:translateX(12px);background:var(--dsw-alias-label-primary-foreground)}
+.${SESSION_TITLE_SETTINGS_CLASS}-actions{display:flex;align-items:center;gap:8px;padding-top:2px}
+.${SESSION_TITLE_SETTINGS_CLASS}-btn{height:28px;padding:0 14px;border-radius:6px;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-interactive-bg);color:var(--dsw-alias-label-primary);font:var(--dsw-font-xxs-12)}
+.${SESSION_TITLE_SETTINGS_CLASS}-btn:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.${SESSION_TITLE_SETTINGS_CLASS}-status{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-tertiary)}
+.${SESSION_TITLE_SETTINGS_CLASS}-saved{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-state-success-primary)}
+.${SESSION_TITLE_SETTINGS_CLASS}-error{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-state-error-primary)}
+`;
+// ── 表单状态 ─────────────────────────────────────────────────────────
+/** 文本项（template 多行，provider / model 单行）。 */
+const SESSION_TITLE_TEXT_FIELDS = ['template', 'provider', 'model'];
+/** 数字项（host 侧只认正整数，非法值回退默认）。 */
+const SESSION_TITLE_NUMBER_FIELDS = ['maxTitleBytes', 'maxInputBytes', 'maxOutputTokens', 'timeoutMs'];
+/** 设置页暴露的字段顺序（enabled 开关在最前）。 */
+const SESSION_TITLE_FIELDS = ['enabled', ...SESSION_TITLE_TEXT_FIELDS, ...SESSION_TITLE_NUMBER_FIELDS];
+/** 首屏（配置未到达前）的表单初值：与 host 半 src/config.ts 的 DEFAULT_SETTINGS 同口径。 */
+const SESSION_TITLE_FALLBACK_FORM = {
+    enabled: true,
+    template: '[{workspace}] {description}',
+    provider: '',
+    model: '',
+    maxTitleBytes: '80',
+    maxInputBytes: '4096',
+    maxOutputTokens: '64',
+    timeoutMs: '30000',
+};
+/** 数字文本规整：数字原样，其余回退 fallback。 */
+function sessionTitleNumberText(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? String(value) : fallback;
+}
+/** 配置快照（GET / PUT 响应）→ 表单值：逐字段规整，缺失 / 非法回退初值。 */
+function sessionTitleFormOf(value) {
+    const raw = (value ?? {});
+    return {
+        enabled: typeof raw.enabled === 'boolean' ? raw.enabled : SESSION_TITLE_FALLBACK_FORM.enabled,
+        template: typeof raw.template === 'string' && raw.template !== '' ? raw.template : SESSION_TITLE_FALLBACK_FORM.template,
+        provider: typeof raw.provider === 'string' ? raw.provider : '',
+        model: typeof raw.model === 'string' ? raw.model : '',
+        maxTitleBytes: sessionTitleNumberText(raw.maxTitleBytes, SESSION_TITLE_FALLBACK_FORM.maxTitleBytes),
+        maxInputBytes: sessionTitleNumberText(raw.maxInputBytes, SESSION_TITLE_FALLBACK_FORM.maxInputBytes),
+        maxOutputTokens: sessionTitleNumberText(raw.maxOutputTokens, SESSION_TITLE_FALLBACK_FORM.maxOutputTokens),
+        timeoutMs: sessionTitleNumberText(raw.timeoutMs, SESSION_TITLE_FALLBACK_FORM.timeoutMs),
+    };
+}
+/** 表单值 → PUT payload：数字项非正数 / 非数字 / 空提交 null（host 按非法值回退默认）。 */
+function sessionTitleNumberOrNull(raw) {
+    const value = Number(raw);
+    return raw.trim() !== '' && Number.isFinite(value) ? value : null;
+}
+function sessionTitlePayloadOf(form) {
+    return {
+        enabled: form.enabled,
+        template: form.template,
+        provider: form.provider,
+        model: form.model,
+        maxTitleBytes: sessionTitleNumberOrNull(form.maxTitleBytes),
+        maxInputBytes: sessionTitleNumberOrNull(form.maxInputBytes),
+        maxOutputTokens: sessionTitleNumberOrNull(form.maxOutputTokens),
+        timeoutMs: sessionTitleNumberOrNull(form.timeoutMs),
+    };
+}
+/** 设置行（左：标题 + 说明；右：控件）。 */
+function SessionTitleSettingsRow(props) {
+    return createElement('div', { className: SESSION_TITLE_SETTINGS_CLASS + '-row' }, createElement('div', { className: SESSION_TITLE_SETTINGS_CLASS + '-info' }, createElement('div', { className: SESSION_TITLE_SETTINGS_CLASS + '-label' }, props.label), createElement('div', { className: SESSION_TITLE_SETTINGS_CLASS + '-hint' }, props.hint)), props.control);
+}
+/** 布尔项控件：button role=switch（UI 规范禁止原生 checkbox）。 */
+function sessionTitleToggle(form, onChange) {
+    const on = form.enabled;
+    return createElement('button', {
+        type: 'button',
+        className: SESSION_TITLE_SETTINGS_CLASS + '-toggle',
+        'data-field': 'enabled',
+        'data-on': String(on),
+        role: 'switch',
+        'aria-checked': String(on),
+        onClick: () => onChange('enabled', !on),
+    });
+}
+/** 文本 / 数字项控件（template 用多行输入）。 */
+function sessionTitleInput(field, form, onChange) {
+    const multiline = field === 'template';
+    const numeric = SESSION_TITLE_NUMBER_FIELDS.includes(field);
+    const className = multiline
+        ? SESSION_TITLE_SETTINGS_CLASS + '-input ' + SESSION_TITLE_SETTINGS_CLASS + '-input-multiline'
+        : SESSION_TITLE_SETTINGS_CLASS + '-input';
+    return createElement(multiline ? 'textarea' : 'input', {
+        className,
+        'data-field': field,
+        type: numeric ? 'number' : 'text',
+        value: String(form[field]),
+        onChange: (event) => onChange(field, String(event?.target?.value ?? '')),
+    });
+}
+/** 8 项配置行（顺序固定：开关 → 3 文本 → 4 数字）。 */
+function sessionTitleFieldRows(form, onChange) {
+    return SESSION_TITLE_FIELDS.map((field) => createElement(SessionTitleSettingsRow, {
+        key: field,
+        label: SESSION_TITLE_SETTINGS_STRINGS.fields[field].label(),
+        hint: SESSION_TITLE_SETTINGS_STRINGS.fields[field].hint(),
+        control: field === 'enabled' ? sessionTitleToggle(form, onChange) : sessionTitleInput(field, form, onChange),
+    }));
+}
+/** 加载失败提示：区分 404（服务端插件未加载）/ 403（安全围栏）/ 网络异常。 */
+function sessionTitleErrorHint(errorKind) {
+    if (errorKind === 'http:404')
+        return SESSION_TITLE_SETTINGS_STRINGS.errorRouteMissing();
+    if (errorKind === 'http:403')
+        return SESSION_TITLE_SETTINGS_STRINGS.errorForbidden();
+    return SESSION_TITLE_SETTINGS_STRINGS.errorNetwork();
+}
+/** 配置加载失败视图：失败原因（http 状态 / 网络）+ 针对性提示 + 重试。 */
+function SessionTitleSettingsLoadError(props) {
+    const cls = SESSION_TITLE_SETTINGS_CLASS;
+    return createElement('div', { className: cls }, createElement('div', { className: cls + '-error' }, SESSION_TITLE_SETTINGS_STRINGS.loadFailed()), createElement('div', { className: cls + '-status' }, sessionTitleErrorHint(props.errorKind)), createElement('div', { className: cls + '-actions' }, createElement('button', { type: 'button', className: cls + '-btn', onClick: props.onRetry }, SESSION_TITLE_SETTINGS_STRINGS.retry())));
+}
+/** 拉取当前配置并回填表单（成功 / 失败都落到状态上，不静默）。 */
+function loadSessionTitleSettings(apply, setLoading, setErrorKind) {
+    setLoading(true);
+    setErrorKind('');
+    fetch(SESSION_TITLE_SETTINGS_API)
+        .then((res) => {
+        if (!res.ok)
+            throw Object.assign(new Error('HTTP ' + res.status), { status: res.status });
+        return res.json();
+    })
+        .then((body) => {
+        if (body === null || body.ok !== true)
+            throw new Error('bad config response');
+        apply(sessionTitleFormOf(body.value));
+        setLoading(false);
+    })
+        .catch((err) => {
+        setLoading(false);
+        // 404 = 路由未注册（服务端插件未加载），403 = 安全围栏拒绝，其余为网络/响应异常。
+        setErrorKind(typeof err?.status === 'number' ? 'http:' + err.status : 'network');
+    });
+}
+/** 保存表单（PUT 完整 8 项）；成功用 host 规整后的值回填 + 提示，失败提示不静默。 */
+function saveSessionTitleSettings(form, apply, setSaved, setFailed) {
+    setSaved(false);
+    setFailed(false);
+    fetch(SESSION_TITLE_SETTINGS_API, {
+        method: 'PUT',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(sessionTitlePayloadOf(form)),
+    })
+        .then((res) => res.json())
+        .then((body) => {
+        if (body === null || body.ok !== true)
+            throw new Error('save failed');
+        // host 已把非法字段回退为默认值：用响应回填，用户看到的是**实际生效值**。
+        apply(sessionTitleFormOf(body.value));
+        setSaved(true);
+    })
+        .catch(() => setFailed(true));
+}
+/** 设置页主视图：加载当前配置 → 编辑 8 项 → 保存（PUT 配置端点）。 */
+function SessionTitleSettingsView() {
+    const [form, setForm] = useState(SESSION_TITLE_FALLBACK_FORM);
+    const [loading, setLoading] = useState(true);
+    const [errorKind, setErrorKind] = useState('');
+    const [saved, setSaved] = useState(false);
+    const [failed, setFailed] = useState(false);
+    const cls = SESSION_TITLE_SETTINGS_CLASS;
+    const load = () => loadSessionTitleSettings(setForm, setLoading, setErrorKind);
+    useEffect(() => {
+        load();
+    }, []);
+    if (loading) {
+        return createElement('div', { className: cls }, createElement('div', { className: cls + '-status' }, SESSION_TITLE_SETTINGS_STRINGS.loading()));
+    }
+    if (errorKind !== '')
+        return createElement(SessionTitleSettingsLoadError, { errorKind, onRetry: load });
+    // 函数式更新：同一批里连续改多个字段（宿主可能合并渲染）不会用陈旧闭包互相覆盖。
+    const onChange = (field, value) => setForm((prev) => ({ ...prev, [field]: value }));
+    return createElement('div', { className: cls }, sessionTitleFieldRows(form, onChange), createElement('div', { className: cls + '-actions' }, createElement('button', {
+        type: 'button',
+        className: cls + '-btn',
+        onClick: () => saveSessionTitleSettings(form, setForm, setSaved, setFailed),
+    }, SESSION_TITLE_SETTINGS_STRINGS.save()), saved ? createElement('span', { className: cls + '-saved' }, SESSION_TITLE_SETTINGS_STRINGS.saved()) : null, failed ? createElement('span', { className: cls + '-error' }, SESSION_TITLE_SETTINGS_STRINGS.saveFailed()) : null));
+}
+/**
+ * 注册设置页签。两处刻意的写法：
+ *  - `ctx.get('slots', false)`：**必须传 strict=false**——cordis 的
+ *    `ctx.get(name, strict = true)` 在服务提供者 fiber 尚未 active（首屏）时返回
+ *    undefined，页签会消失到下次 HMR；只有 strict=false 才拿得到实例。
+ *  - 服务缺失（精简上下文 / 老宿主）时静默跳过：设置页是增强，不能因为拿不到
+ *    slots 就让整个 client 挂掉。
+ */
+function attachSettingsTab(ctx) {
+    // 样式注入走共享实现，位置在任何早退分支之前（服务判空 / HMR 时样式不会丢）。
+    installStyles(ctx, 'data-dsh-session-title-gen-settings', SESSION_TITLE_SETTINGS_STYLES, 'dsh-session-title-gen: settings styles');
+    const slots = typeof ctx.get === 'function' ? ctx.get('slots', false) : undefined;
+    if (slots === undefined || slots === null)
+        return;
+    ctx.effect(() => {
+        slots.inject('settings.plugins.tab', () => slots.register({
+            name: 'settings.plugins.tab',
+            id: SESSION_TITLE_SETTINGS_TAB_ID,
+            order: 93,
+            // 惰性：宿主靠重注册跟随语言切换，这里每次取都按当前宿主/浏览器语言判定。
+            label: () => SESSION_TITLE_SETTINGS_STRINGS.tabLabel(),
+        }, SessionTitleSettingsView));
+        return undefined;
+    }, 'dsh-session-title-gen: settings tab registration');
+}
+
+
+    // ── Client bundle（编译自 src/client/index.ts）──────────────────
+    "use strict";
+// ── dsh-session-title-gen — client 半入口（设置页签，issue #385）──────────
+// 本插件是纯 server 形态（标题生成在主进程完成），client 半只承担一件事：
+// 在「设置 → 插件」注册「会话标题生成」设置页，让 8 项配置可可视化编辑
+// （此前只能手写 cordis.patch.yml）。
+//
+// 视图、文案与注册逻辑在 settings.ts / strings.ts（构建期由 build.mjs 注入同一
+// factory 作用域；本文件只做入口）。产物 lib/client.js 必须提交（CI 只跑
+// node --check + 测试，不跑构建）。
+// 注：编译产物内联进 factory 作用域后，module.exports 已在模板中声明。
+// 此处直接使用 module.exports（模板顶部已声明 var module = { exports: {} }）。
+const _exports = module.exports;
+_exports.inject = ['slots'];
+_exports.apply = function apply(ctx) {
+    // 设置页签（issue #385）：注册「设置 → 插件 → 会话标题生成」。
+    // 拿不到 slots（精简上下文 / 老宿主）时静默降级，见 settings.ts 的 attachSettingsTab。
+    attachSettingsTab(ctx);
+};
+
+
+    return module.exports
+  },
+})

package/lib/client.src.js

@@ -0,0 +1,41 @@
+/**
+ * dsh-session-title-gen — client half (settings tab, issue #385). SOURCE TEMPLATE.
+ *
+ * 提供「设置 → 插件 → 会话标题生成」设置页签：可视化编辑 8 项配置
+ * （enabled / template / provider / model / maxTitleBytes / maxInputBytes /
+ * maxOutputTokens / timeoutMs），保存经 PUT 到插件配置端点，由 host 半写回
+ * profile 的 cordis.patch.yml 并热生效（详见 src/config-routes.ts）。
+ *
+ * 本插件的标题生成逻辑全在 server 端，client 半没有其它职责。
+ *
+ * BUILD NOTE: 本文件是源码模板（骨架）。scripts/build.mjs 先 tsc 编译
+ * src/client/index.ts → lib/.client-build/index.js（CommonJS 单文件），再把编译产物、
+ * src/client 的 part 片段（strings.ts / settings.ts 的产物）与 dsh-shared/client-parts
+ * 的样式注入件依次注入下方占位符，写出 lib/client.js —— DSH 实际提供的产物（单一
+ * __ModuleLoader__ bundle，无相对路径 require）。产物必须提交（CI 只跑
+ * node --check + 测试，不跑构建）。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-session-title-gen',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+    // useState / useEffect 供设置页 part 使用（模板静态分析看不到 part 内容，故在此一并解构）
+    const { createElement, useState, useEffect } = require('react')
+
+    // ── 共享样式注入（dsh-shared/client-parts，issue #186 P2）──────────
+    /*__PART_STYLE_TAG__*/
+
+    // ── 设置页文案（src/client/strings.ts 产物，issue #385）────────────
+    /*__PART_STRINGS__*/
+
+    // ── 设置页视图与注册（src/client/settings.ts 产物，issue #385）──────
+    /*__PART_SETTINGS__*/
+
+    // ── Client bundle（编译自 src/client/index.ts）──────────────────
+    /*__CLIENT_BUNDLE__*/
+
+    return module.exports
+  },
+})

package/lib/config-routes.js

@@ -0,0 +1,140 @@
+/**
+ * dsh-session-title-gen — 设置页配置端点与路由注册（issue #385）。
+ *
+ * 「设置 → 插件 → 会话标题生成」的保存链路：client PUT `<prefix>/config` → 本模块校验
+ * → 写回 profile 层 patch 文件（持久化）→ 更新内存生效值并通知 apply 侧**热切换**
+ * （保存即生效，不必等 watchUserPatches 热重载、不必重启 DSH）。
+ *
+ * 写回复用 dsh-shared 的配置原语（currentProfile / patchFileOf / extractConfig /
+ * writePatchConfig），并**先合并该行已有键再写**：`writePatchConfig` 的语义是
+ * 「删除同 id 旧条目 → 追加新条目」，直接写会把用户手写的其它键（如 `disabled: true`）
+ * 一起抹掉（数据破坏，issue #385 验收项「写回不删掉用户手写的其它键」）。
+ *
+ * 注册契约（真实环境「设置页恒报配置加载失败」的修复依据）：
+ *  1. 服务经 `ctx.inject(['webServer'], cb)` **局部等待**，不用 `ctx.get('webServer')`
+ *     一次性取值 —— cordis 的 get 带严格就绪检查且**没有重试**，webServer 晚于本插件
+ *     就绪时永久错过，路由从未注册 → client 端 404。
+ *  2. 注册承载在**常驻 root**（`ctx.root ?? ctx`）的 inject 子 fiber 上 —— profile 插件
+ *     自身 fiber 在 apply 结束后被 loader 回收，挂在它上面的 `ctx.effect` 会一并注销
+ *     （路由同样消失 → 404）。
+ *  3. 顶层 `inject` **不**声明 webServer：那会让整个插件在无 webServer 的 profile
+ *     （tui / headless）里 fiber PENDING、apply 根本不执行 —— 标题生成是主功能，不能陪葬。
+ */
+import { readFile } from 'node:fs/promises';
+import { currentProfile, extractConfig, isTrustedApiRequest, patchFileOf, readJsonBody, writeJson, writePatchConfig, } from 'dsh-shared';
+import { mergePatchEntries, normalizeConfigPatch } from './config.js';
+/** 配置读写路由前缀（client 端 GET/PUT `<prefix>/config`）。 */
+export const CONFIG_ROUTE_PREFIX = '/session-title-gen/api';
+/** 写回行 id：必须与 plugins/dsh-session-title-gen/cordis.patch.yml 的插件行 id 一致
+ *  （loader 按行 id 匹配配置，id 不符会新增孤儿行、原行配置不变）。 */
+export const CONFIG_ROW_ID = 'session-title-gen';
+/** 读取 patch 文件中该行已有的 config 块（文件不存在 / 解析失败 → 空对象）。 */
+async function readExistingConfig(file) {
+    try {
+        return extractConfig(await readFile(file, 'utf8'), CONFIG_ROW_ID) ?? {};
+    }
+    catch {
+        // 首次保存（文件还不存在）或文件不可读：按空配置合并，写入侧会创建目录。
+        return {};
+    }
+}
+/** 写回 profile 层 patch 文件：合并已有键后整体重写（保留用户手写的其它配置）。 */
+export async function persistSettingsConfig(next) {
+    const file = patchFileOf(currentProfile());
+    await writePatchConfig(file, CONFIG_ROW_ID, mergePatchEntries(await readExistingConfig(file), next));
+}
+/** PUT 处理：校验 → 落盘（失败 500、内存不动）→ 回规整后的完整 8 项。 */
+async function handleConfigPut(request, response, read, write) {
+    let next;
+    try {
+        next = normalizeConfigPatch(await readJsonBody(request), read());
+    }
+    catch {
+        next = undefined;
+    }
+    if (next === undefined) {
+        writeJson(response, 400, { ok: false, error: { message: 'invalid config' } });
+        return;
+    }
+    try {
+        await write(next);
+    }
+    catch (error) {
+        // 落盘失败绝不当成成功：client 侧据此提示「保存失败」，内存生效值保持原样。
+        writeJson(response, 500, { ok: false, error: { message: `config write failed: ${String(error)}` } });
+        return;
+    }
+    writeJson(response, 200, { ok: true, value: next });
+}
+/** 构造读写配置的 handler：fence → GET/PUT `<prefix>/config` → 403/404 兜底。 */
+export function createConfigHandler(read, write) {
+    return async (request, response) => {
+        // loopback 信任围栏与 /api 网关同一契约（仅本机可访问；trustedHosts 本插件不使用）。
+        if (!isTrustedApiRequest(request, [])) {
+            writeJson(response, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } });
+            return;
+        }
+        const pathname = new URL(request.url ?? '/', 'http://dsh.internal').pathname;
+        if (pathname === `${CONFIG_ROUTE_PREFIX}/config`) {
+            if (request.method === 'GET') {
+                writeJson(response, 200, { ok: true, value: read() });
+                return;
+            }
+            if (request.method === 'PUT') {
+                await handleConfigPut(request, response, read, write);
+                return;
+            }
+        }
+        writeJson(response, 404, { ok: false, error: { message: 'unknown dsh-session-title-gen API method' } });
+    };
+}
+/** 已注册配置路由的 disposer（以常驻 root ctx 为键，用于重复 apply 去重）。 */
+const routeDisposers = new WeakMap();
+/** 在 inject 子 scope 上挂载配置路由；注册失败只告警，绝不让插件 fatal。 */
+function mountConfigRoute(hostCtx, scope, state, onSaved) {
+    // loader 会多次 apply 同一插件：root 常驻意味着上一轮注册不会自动消失，而宿主
+    // WebServer.register 对重复 (kind, path) 直接抛错 → 先撤上一轮再注册。
+    routeDisposers.get(hostCtx)?.();
+    scope.effect(() => {
+        const webServer = scope.webServer;
+        try {
+            const dispose = webServer?.register({
+                kind: 'prefix',
+                path: CONFIG_ROUTE_PREFIX,
+                handler: createConfigHandler(() => state.current, async (next) => {
+                    await persistSettingsConfig(next);
+                    state.current = next;
+                    onSaved(next);
+                }),
+            });
+            if (dispose === undefined)
+                return undefined;
+            routeDisposers.set(hostCtx, dispose);
+            return () => {
+                if (routeDisposers.get(hostCtx) === dispose)
+                    routeDisposers.delete(hostCtx);
+                dispose();
+            };
+        }
+        catch (error) {
+            // 宿主拒绝注册（同 path 已被占用等）：降级为「无配置路由」，不冒泡成 fatal。
+            scope.logger?.warn(`[dsh-session-title-gen] 配置路由注册被宿主拒绝：${String(error)}`);
+            return undefined;
+        }
+    }, 'dsh-session-title-gen: config route');
+}
+/** 注册配置读写路由（契约见文件头）；无 webServer 的 profile 下静默不注册。 */
+export function registerConfigRoute(ctx, state, onSaved) {
+    const hostCtx = ctx.root ?? ctx;
+    try {
+        if (typeof hostCtx.inject !== 'function') {
+            ctx.logger?.warn('[dsh-session-title-gen] ctx.inject 不可用，配置路由未注册（设置页不可用）');
+            return;
+        }
+        hostCtx.inject(['webServer'], (scope) => mountConfigRoute(hostCtx, scope, state, onSaved));
+    }
+    catch (error) {
+        // inactive ctx 上建 inject 子 fiber 可能抛错：降级为「无配置路由」，不 fatal。
+        ctx.logger?.warn(`[dsh-session-title-gen] webServer 局部注入失败，配置路由未注册：${String(error)}`);
+    }
+}

package/lib/config.js

@@ -0,0 +1,128 @@
+import { DEFAULT_TEMPLATE } from './title.js';
+/** 8 项配置的默认值（唯一来源：apply 回退 / 设置页回填 / PUT 非法字段回退共用）。 */
+export const DEFAULT_SETTINGS = {
+    enabled: true,
+    template: DEFAULT_TEMPLATE,
+    provider: '',
+    model: '',
+    maxTitleBytes: 80,
+    maxInputBytes: 4096,
+    maxOutputTokens: 64,
+    timeoutMs: 30000,
+};
+/** 设置页暴露的 8 个字段名（GET 契约的键集合；PUT 至少含其一才算一次可应用的提交）。 */
+export const SETTINGS_FIELDS = [
+    'enabled',
+    'template',
+    'provider',
+    'model',
+    'maxTitleBytes',
+    'maxInputBytes',
+    'maxOutputTokens',
+    'timeoutMs',
+];
+/** 布尔字段规整：只认布尔，其余（含字符串 "false"）回退 fallback。 */
+function normalizeBool(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+/** 非空字符串规整：非字符串 / 空串回退 fallback（template 用）。 */
+function normalizeString(value, fallback) {
+    return typeof value === 'string' && value !== '' ? value : fallback;
+}
+/** provider/model 规整：字符串（含空串 = 跟随会话）生效，其余回退 ''。 */
+function normalizeFollow(value, fallback) {
+    return typeof value === 'string' ? value.trim() : fallback;
+}
+/** 数字字段规整：只有正整数生效（0 / 负数 / NaN / 字符串一律回退默认）。 */
+function normalizePositiveInt(value, fallback) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : fallback;
+}
+/**
+ * 单个字段取值：payload 里**有**该键 → 规整（非法值回退 fallback）；**没有**该键 → 保留
+ * 当前生效值。这样「非法字段只忽略该字段」与「部分提交不清空其它字段」同时成立。
+ */
+function pick(raw, key, current, fallback, normalize) {
+    return key in raw ? normalize(raw[key], fallback) : current;
+}
+/** 应用层配置 → 生效值（8 项全必填；缺省 / 非法一律回退 {@link DEFAULT_SETTINGS}）。 */
+export function resolveConfig(config) {
+    const source = config ?? {};
+    return {
+        enabled: source.enabled !== false,
+        template: normalizeString(source.template, DEFAULT_SETTINGS.template),
+        provider: normalizeFollow(source.provider, DEFAULT_SETTINGS.provider),
+        model: normalizeFollow(source.model, DEFAULT_SETTINGS.model),
+        maxTitleBytes: normalizePositiveInt(source.maxTitleBytes, DEFAULT_SETTINGS.maxTitleBytes),
+        maxInputBytes: normalizePositiveInt(source.maxInputBytes, DEFAULT_SETTINGS.maxInputBytes),
+        maxOutputTokens: normalizePositiveInt(source.maxOutputTokens, DEFAULT_SETTINGS.maxOutputTokens),
+        timeoutMs: normalizePositiveInt(source.timeoutMs, DEFAULT_SETTINGS.timeoutMs),
+    };
+}
+/** payload 是否至少包含一个 8 项字段（`{}` / 空 body 不算一次可应用的提交 → 400）。 */
+function hasSettingsField(raw) {
+    return SETTINGS_FIELDS.some((field) => field in raw);
+}
+/**
+ * PUT payload → 生效值：非对象（null / 数组 / 标量）或**不含任何 8 项字段**（空 body /
+ * `{}`）返回 undefined，调用方回 400 且**不落盘**；对象内**非法字段只忽略该字段并回退
+ * 默认**（不整单拒绝——设置页一次提交 8 项，因一项非法而丢掉其余 7 项合法修改，用户会
+ * 误以为保存无效）。
+ */
+export function normalizeConfigPatch(payload, current) {
+    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
+        return undefined;
+    const raw = payload;
+    if (!hasSettingsField(raw))
+        return undefined;
+    return {
+        enabled: pick(raw, 'enabled', current.enabled, DEFAULT_SETTINGS.enabled, normalizeBool),
+        template: pick(raw, 'template', current.template, DEFAULT_SETTINGS.template, normalizeString),
+        provider: pick(raw, 'provider', current.provider, DEFAULT_SETTINGS.provider, normalizeFollow),
+        model: pick(raw, 'model', current.model, DEFAULT_SETTINGS.model, normalizeFollow),
+        maxTitleBytes: pick(raw, 'maxTitleBytes', current.maxTitleBytes, DEFAULT_SETTINGS.maxTitleBytes, normalizePositiveInt),
+        maxInputBytes: pick(raw, 'maxInputBytes', current.maxInputBytes, DEFAULT_SETTINGS.maxInputBytes, normalizePositiveInt),
+        maxOutputTokens: pick(raw, 'maxOutputTokens', current.maxOutputTokens, DEFAULT_SETTINGS.maxOutputTokens, normalizePositiveInt),
+        timeoutMs: pick(raw, 'timeoutMs', current.timeoutMs, DEFAULT_SETTINGS.timeoutMs, normalizePositiveInt),
+    };
+}
+/** 生效值 → 标题生成配置：空串 provider/model 转 undefined（走会话请求路由）。 */
+export function toTitleConfig(settings) {
+    return {
+        template: settings.template,
+        provider: settings.provider === '' ? undefined : settings.provider,
+        model: settings.model === '' ? undefined : settings.model,
+        maxTitleBytes: settings.maxTitleBytes,
+        maxInputBytes: settings.maxInputBytes,
+        maxOutputTokens: settings.maxOutputTokens,
+        timeoutMs: settings.timeoutMs,
+    };
+}
+/** 落盘形状：8 项中空串 provider/model **不写键**（保持 patch 文件干净，读回时空串）。 */
+function patchEntries(next) {
+    const entries = {
+        enabled: next.enabled,
+        template: next.template,
+        maxTitleBytes: next.maxTitleBytes,
+        maxInputBytes: next.maxInputBytes,
+        maxOutputTokens: next.maxOutputTokens,
+        timeoutMs: next.timeoutMs,
+    };
+    if (next.provider !== '')
+        entries.provider = next.provider;
+    if (next.model !== '')
+        entries.model = next.model;
+    return entries;
+}
+/**
+ * 合并落盘条目：保留该行**用户手写的其它键**（如 `disabled`、私有实验字段），只覆盖本次
+ * 提交的 8 项；provider/model 置空则删除该键（否则旧值留在文件里被读回，形成「设置页显示空、
+ * 实际仍生效」的幽灵配置）。调用方负责先读该行已有 config（见 config-routes.ts）。
+ */
+export function mergePatchEntries(existing, next) {
+    const merged = { ...existing };
+    if (next.provider === '')
+        delete merged.provider;
+    if (next.model === '')
+        delete merged.model;
+    return { ...merged, ...patchEntries(next) };
+}

package/lib/host.js

@@ -21,13 +21,30 @@ const rootListeners = new WeakMap();
  * Register the session/event listener where the host actually dispatches it.
  * @param listenCtx - the context to register on (root when available).
  * @param handler - listener receiving (session, event).
- * @returns the registered context (for diagnostics/tests).
+ * @returns disposer removing exactly this registration (idempotent).
  */
 export function listenSessionEvents(listenCtx, handler) {
-    rootListeners.get(listenCtx)?.();
+    stopSessionEvents(listenCtx);
     // { global: true } 跳过 cordis 的 scope 过滤（@deepseek-ai/dsh-scope 的 carrier
     // filter）；缺了它，打有 scope tag 的监听器会被静默排除。
-    rootListeners.set(listenCtx, listenCtx.on('session/event', handler, { global: true }));
+    const dispose = listenCtx.on('session/event', handler, { global: true });
+    const wrapped = () => {
+        if (rootListeners.get(listenCtx) === wrapped)
+            rootListeners.delete(listenCtx);
+        dispose();
+    };
+    rootListeners.set(listenCtx, wrapped);
+    return wrapped;
+}
+/**
+ * Remove the session/event listener registered by {@link listenSessionEvents}.
+ *
+ * 热生效用（issue #385）：设置页把 `enabled` 关掉时立刻停止监听（零开销），
+ * 重新打开时再挂回来 —— 不必重启 DSH。
+ * @param listenCtx - the context the listener was registered on.
+ */
+export function stopSessionEvents(listenCtx) {
+    rootListeners.get(listenCtx)?.();
 }
 /**
  * Resolve the llm service from a listener-safe source.

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * dsh-session-title-gen — structured session title generation (issue #160).
+ * dsh-session-title-gen — structured session title generation (issue #160)。
  *
  * 监听会话首条人类消息，用 LLM 生成类似 git commit 的结构化标题
  * （先归属后描述，如 `[my-dsh-plugins] 修复 #143 记忆页签崩溃`），经核心
@@ -15,37 +15,45 @@
  * 宿主契约适配见 host.ts（issue #232：profile 插件的 events 实例隔离、
  * Session.events 私有化、插件 ctx 在监听器执行时已 inactive），
  * 单会话生成流程见 generate.ts。
+ *
+ * 配置面（issue #385）：8 项配置经「设置 → 插件 → 会话标题生成」可视化编辑，
+ * 保存写回 profile 的 cordis.patch.yml 并**热生效** —— 配置端点与注册契约见
+ * config-routes.ts，默认值与规整口径见 config.ts。
  */
+import { resolveConfig, toTitleConfig } from './config.js';
+import { registerConfigRoute } from './config-routes.js';
 import { generateSessionTitle, isUserMessage, shouldSkip } from './generate.js';
-import { createWarn, listenSessionEvents, selectLlm } from './host.js';
-import { DEFAULT_TEMPLATE } from './title.js';
+import { createWarn, listenSessionEvents, selectLlm, stopSessionEvents } from './host.js';
 export const name = 'dsh-session-title-gen';
 export const inject = ['llm'];
-/** 默认配置（可被 cordis.patch.yml config 覆盖）。 */
-const DEFAULTS = {
-    enabled: true,
-    template: DEFAULT_TEMPLATE,
-    provider: undefined,
-    model: undefined,
-    maxTitleBytes: 80,
-    maxInputBytes: 4096,
-    maxOutputTokens: 64,
-    timeoutMs: 30000,
-};
 export function apply(ctx, config) {
-    const cfg = resolveConfig(config);
-    if (!cfg.enabled)
-        return;
-    const state = new Map();
+    // 生效值容器：设置页保存后原地更新（热生效），生成逻辑每次读最新值。
+    const state = { current: resolveConfig(config) };
+    const generating = new Map();
     // 注册点与服务都必须按宿主 root 规则取（详见 host.ts）：会话事件只在 root 的
     // events 实例上派发，而插件 ctx 在监听器执行时已 inactive，动态取服务会抛错。
     const listenCtx = ctx.root ?? ctx;
     const llm = selectLlm(listenCtx, ctx.llm);
     const warn = createWarn(ctx.logger);
-    listenSessionEvents(listenCtx, onSessionEvent);
+    let listening = false;
+    /** 挂载 / 卸载 session/event 监听（设置页保存 enabled 后立即热切换）。 */
+    function syncListeners(enabled) {
+        if (enabled === listening)
+            return;
+        listening = enabled;
+        if (enabled)
+            listenSessionEvents(listenCtx, onSessionEvent);
+        else
+            stopSessionEvents(listenCtx);
+    }
+    // 配置路由**无条件注册**（含禁用状态）：否则用户在设置页里没有入口把插件重新打开；
+    // enabled=false 只影响标题生成，不影响配置面。
+    registerConfigRoute(ctx, state, (next) => syncListeners(next.enabled));
+    syncListeners(state.current.enabled);
     ctx.effect(() => () => {
-        state.clear();
+        generating.clear();
     }, 'dsh-session-title-gen: state lifecycle');
+    ctx.logger?.info(`[dsh-session-title-gen] 结构化会话标题${state.current.enabled ? '已启用' : '已禁用（可在「设置 → 插件」中开启）'}`);
     /** session/event 监听器：人类消息或标题事件触发结构化标题生成。 */
     function onSessionEvent(session, event) {
         const sess = session;
@@ -65,35 +73,17 @@ export function apply(ctx, config) {
             return;
         if (shouldSkip(session))
             return;
-        if (state.get(session.id)?.generating)
+        if (state.current.enabled === false)
+            return;
+        if (generating.get(session.id)?.generating)
             return;
-        const promise = generateSessionTitle({ session, llm, warn, config: cfg });
-        state.set(session.id, { generating: promise });
+        const promise = generateSessionTitle({ session, llm, warn, config: toTitleConfig(state.current) });
+        generating.set(session.id, { generating: promise });
         try {
             await promise;
         }
         finally {
-            state.delete(session.id);
+            generating.delete(session.id);
         }
     }
 }
-/** 配置解析：缺省值 + 类型护栏。 */
-function resolveConfig(config) {
-    const candidate = config ?? {};
-    return {
-        enabled: candidate.enabled !== false,
-        template: nonEmptyString(candidate.template, DEFAULTS.template),
-        provider: nonEmptyString(candidate.provider, DEFAULTS.provider),
-        model: nonEmptyString(candidate.model, DEFAULTS.model),
-        maxTitleBytes: positiveInt(candidate.maxTitleBytes, DEFAULTS.maxTitleBytes),
-        maxInputBytes: positiveInt(candidate.maxInputBytes, DEFAULTS.maxInputBytes),
-        maxOutputTokens: positiveInt(candidate.maxOutputTokens, DEFAULTS.maxOutputTokens),
-        timeoutMs: positiveInt(candidate.timeoutMs, DEFAULTS.timeoutMs),
-    };
-}
-function nonEmptyString(value, fallback) {
-    return typeof value === 'string' && value !== '' ? value : fallback;
-}
-function positiveInt(value, fallback) {
-    return Number.isInteger(value) && value > 0 ? value : fallback;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-title-gen",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DSH 会话标题自动生成插件：监听会话首条人类消息，用 LLM 生成类似 git commit 的结构化标题（先标明归属工作区，再写简要描述），经核心 session/title 事件写入（重启保留），失败自动回退核心标题机制。DSH web plugin: structured session titles like git commit messages (workspace first, then description), written through the core session/title event.",
   "type": "module",
   "main": "lib/index.js",
@@ -12,15 +12,18 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "npx tsc -p tsconfig.json",
-    "typecheck": "npx tsc --noEmit -p tsconfig.json",
+    "build": "npx tsc -p tsconfig.json && node scripts/build.mjs",
+    "typecheck": "npx tsc --noEmit -p tsconfig.json && npx tsc --noEmit -p tsconfig.client.json",
     "test": "npx vitest run --coverage && cucumber-js test/features --import \"test/features/steps/*.mjs\""
   },
   "exports": {
     ".": {
       "default": "./lib/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./client": {
+      "default": "./lib/client.js"
+    }
   },
   "files": [
     "lib",
@@ -33,15 +36,22 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
     }
   },
   "peerDependencies": {
     "cordis": "^4.0.0-rc.10",
-    "dsh-shared": "^0.1.4"
+    "dsh-shared": "^0.1.4",
+    "react": "^18.2.0 || ^19.3.0"
   },
   "peerDependenciesMeta": {
     "cordis": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "license": "MIT"