dsh-session-title-gen 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+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.0] - 2026-09-06
+
+### Added
+
+- 会话标题自动生成：监听会话首条人类消息，LLM 生成结构化标题（`[工作区名] 简要描述`），经核心 `session/title` 事件写入（重启保留）
+- 与核心标题机制协作：核心 fallback/provider 非结构化标题触发重新生成；生成失败静默回退；用户手动标题不被覆盖
+- 可配置：开关（`enabled`）、格式模板（`template`）、LLM 路由覆盖（`provider`/`model`）、字节/token/超时上限

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bsfeng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# dsh-session-title-gen
+
+[![插件生态](https://img.shields.io/badge/插件生态-topic%20dsh-4d6bfe)](https://github.com/topics/dsh)
+
+<div align="center">
+  <img alt="会话列表：新会话首条消息后，标题被自动改写为 LLM 生成的简短描述" src="./assets/session-list.png" width="720" />
+</div>
+
+**DSH 会话标题自动生成插件**：监听会话首条人类消息，用 LLM 生成类似 git commit 的**结构化标题**——先标明当前会话属于哪个工作区（项目），再写一段简要描述，如 `[my-dsh-plugins] 修复记忆页签崩溃`。会话列表一眼可辨归属与主题。
+
+## 功能
+
+- **结构化标题自动生成**：首条人类消息后生成 `[工作区名] 简要描述`；工作区名 = 会话工作目录的项目根 basename，描述由 LLM 生成（system prompt 强制单行格式，语言跟随消息）。
+- **重启后标题保留**：经 DSH 核心 `session/title` 事件（log-backed）写入，DSH 原生会话列表与 observability 面板均显示新标题。
+- **失败静默回退**：LLM 不可用 / 超时 / 输出为空时不阻塞会话，核心标题机制照常工作。
+- **与核心标题机制协作**：不注册标题 provider，直接 append `session/title` 事件覆盖；核心生成的非结构化标题（fallback / provider）会触发本插件重新生成；用户手动重命名的标题（source: user）不被覆盖。
+
+## 配置
+
+| 配置项                              | 默认值                        | 说明                                      |
+| ----------------------------------- | ----------------------------- | ----------------------------------------- |
+| `enabled`                           | `true`                        | 总开关（`false` 完全关闭，不监听事件）    |
+| `template`                          | `[{workspace}] {description}` | 标题格式模板（两个占位符）                |
+| `provider` / `model`                | 缺省                          | LLM provider / model 覆盖                 |
+| `maxTitleBytes`                     | `80`                          | 标题 UTF-8 字节上限                       |
+| `maxInputBytes` / `maxOutputTokens` | `4096` / `64`                 | 送入 LLM 的消息字节上限 / 输出 token 上限 |
+| `timeoutMs`                         | `30000`                       | LLM 调用超时（超时静默回退）              |
+
+配置写在 profile 的 `cordis.patch.yml`：
+
+```yaml
+- id: session-title-gen
+  config:
+    enabled: true
+    template: '[{workspace}] {description}'
+```
+
+## 安装
+
+```bash
+# npm 安装（推荐）
+dsh plugin --profile web add dsh-session-title-gen --trust-lockfile
+
+# 本地 link（本仓库开发者）
+git clone https://github.com/baosfeng/my-dsh-plugins.git
+dsh plugin --profile web add link:<仓库路径>/plugins/dsh-session-title-gen
+```
+
+## 相关文档
+
+→ [会话标题自动生成概述](../../docs/会话标题自动生成/概述.md)
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# 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:
+#
+#   git clone https://github.com/baosfeng/my-dsh-plugins.git
+#   dsh plugin --profile web add link:<仓库路径>/plugins/dsh-session-title-gen
+- insert:
+    - id: session-title-gen
+      name: 'dsh-session-title-gen'

package/lib/generate.js

@@ -0,0 +1,86 @@
+/**
+ * dsh-session-title-gen — 单会话标题生成流程（issue #232 拆分：控制 apply 体量）。
+ *
+ * 纯逻辑 + 注入依赖：宿主 ctx 不再参与，便于测试与审查。
+ */
+import { workspaceNameOf } from './workspace.js';
+import { foldTitle, generateTitle, isStructuredTitle, sessionEvents } from './title.js';
+/** 本插件写入标题的 source.provider 标识。 */
+const PROVIDER_ID = 'dsh-session-title-gen';
+/**
+ * Generate and append the structured title for one session.
+ *
+ * 任何失败都不 append（核心标题保留、不阻塞会话），但会经 `warn` 留下痕迹。
+ * @param input - { session, llm, warn, config }.
+ */
+export async function generateSessionTitle({ session, llm, warn, config }) {
+    try {
+        const cwd = session.header?.cwd;
+        const workspace = await workspaceNameOf(cwd);
+        if (workspace === '') {
+            // 不接受"静默无前缀"（issue #232）：取不到工作区名时把事实写进日志，
+            // 让"标题缺 [工作区] 前缀"可被发现、可排查，而不是无声降级。
+            warn(`session "${session.id}": no workspace name resolved (session header cwd=${typeof cwd === 'string' ? JSON.stringify(cwd) : String(cwd)}); the generated title carries no [workspace] prefix`);
+        }
+        const messages = collectMessages(session);
+        if (messages.length === 0)
+            return;
+        const route = routeOf(session);
+        const signal = AbortSignal.any([AbortSignal.timeout(config.timeoutMs)]);
+        const result = await generateTitle({ llm }, { session, workspace, messages, route, signal, config });
+        session.append('session/title', {
+            title: result.title,
+            messageSeqs: messages.map((message) => message.seq),
+            source: { kind: 'provider', provider: PROVIDER_ID, model: result.model },
+        });
+    }
+    catch (error) {
+        warn(`session "${session.id}": structured title generation failed: ${String(error)}`);
+    }
+}
+/** 是否跳过生成：已有我们生成的 / 用户手动 / 结构化标题。 */
+export function shouldSkip(session) {
+    const current = foldTitle(session);
+    if (current === undefined)
+        return false;
+    if (current.source?.kind === 'user')
+        return true;
+    if (current.source?.provider === PROVIDER_ID)
+        return true;
+    return isStructuredTitle(current.title);
+}
+/** 是否为人类用户消息（过滤插件注入）。 */
+export function isUserMessage(event) {
+    return event?.data?.source?.kind === 'user';
+}
+/** 收集会话中人类用户消息（文本 + seq）。 */
+function collectMessages(session) {
+    const messages = [];
+    for (const event of sessionEvents(session)) {
+        if (!isUserMessage(event))
+            continue;
+        const text = textOf(event);
+        if (text === '')
+            continue;
+        messages.push({ seq: event.seq, text });
+    }
+    return messages;
+}
+/** 提取 user/message 事件的文本内容（text blocks 拼接）。 */
+function textOf(event) {
+    const blocks = event.data?.content;
+    if (!Array.isArray(blocks))
+        return '';
+    return blocks
+        .filter((block) => block?.type === 'text')
+        .map((block) => block.text ?? '')
+        .join('\n')
+        .trim();
+}
+/** 会话请求路由（provider/model），无则 undefined。 */
+function routeOf(session) {
+    const config = session.requestHeader?.()?.config;
+    if (config === null || typeof config !== 'object')
+        return undefined;
+    return { provider: config.provider, model: config.model };
+}

package/lib/host.js

@@ -0,0 +1,63 @@
+/**
+ * dsh-session-title-gen — 宿主契约适配（issue #232）。
+ *
+ * DSH 0.1.5-rc.1 下 profile 插件与宿主 root 存在三处可见性差异，任何一处踩错
+ * 都会让插件**静默失效**（不报错、标题退回核心机制、缺 `[工作区]` 前缀）：
+ *  1. 事件实例隔离：`ctx.events !== ctx.root.events`，会话事件只在 root 派发；
+ *  2. 插件 ctx 在 apply 返回后 inactive，动态取服务抛
+ *     `cannot get required service "llm" in inactive context`；
+ *  3. loader 会回收插件 fiber 上的 effect，root 监听器不能用 `ctx.effect` 托管。
+ *
+ * 本模块把这些适配收敛在一处，供 index.ts 保持薄 apply。
+ */
+/**
+ * root 上的 session/event 监听器注册表（每个 root ctx 一份）。
+ *
+ * 以 root ctx 为键保存 disposer：插件重载时先移除上一个监听器，避免同一事件
+ * 被多个残留监听器重复处理（root 注册不随插件 fiber 卸载自动清理）。
+ */
+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).
+ */
+export function listenSessionEvents(listenCtx, handler) {
+    rootListeners.get(listenCtx)?.();
+    // { global: true } 跳过 cordis 的 scope 过滤（@deepseek-ai/dsh-scope 的 carrier
+    // filter）；缺了它，打有 scope tag 的监听器会被静默排除。
+    rootListeners.set(listenCtx, listenCtx.on('session/event', handler, { global: true }));
+}
+/**
+ * Resolve the llm service from a listener-safe source.
+ * @param primary - root context, whose services stay reachable for the app lifetime.
+ * @param fallback - instance captured while the plugin ctx was still active.
+ * @returns a usable llm service.
+ */
+export function selectLlm(primary, fallback) {
+    try {
+        const fromRoot = primary.llm;
+        if (fromRoot !== undefined)
+            return fromRoot;
+    }
+    catch {
+        // root 不暴露该服务时回退到 apply 期捕获的实例
+    }
+    return fallback;
+}
+/**
+ * Build a logging function that can never break title generation.
+ * @param logger - plugin logger captured while the ctx was still active.
+ * @returns a warn sink that swallows its own failures.
+ */
+export function createWarn(logger) {
+    return (message) => {
+        try {
+            logger?.warn?.(message);
+        }
+        catch {
+            // 日志失败不影响标题生成
+        }
+    };
+}

package/lib/index.js

@@ -0,0 +1,99 @@
+/**
+ * dsh-session-title-gen — structured session title generation (issue #160).
+ *
+ * 监听会话首条人类消息，用 LLM 生成类似 git commit 的结构化标题
+ * （先归属后描述，如 `[my-dsh-plugins] 修复 #143 记忆页签崩溃`），经核心
+ * `session/title` 事件写入（log-backed，重启保留）。
+ *
+ * 与核心 dsh-session-title 的协作：
+ *  - 核心 bundle 已注册唯一 provider（session-title-first-prompt-llm），
+ *    本插件不注册 provider，直接 append session/title 事件覆盖；
+ *  - 核心 fallback/provider 生成的非结构化标题会触发本插件重新生成
+ *    （监听 session/title 事件兜底竞态）；
+ *  - 生成失败不 append（核心标题保留，不阻塞会话）。
+ *
+ * 宿主契约适配见 host.ts（issue #232：profile 插件的 events 实例隔离、
+ * Session.events 私有化、插件 ctx 在监听器执行时已 inactive），
+ * 单会话生成流程见 generate.ts。
+ */
+import { generateSessionTitle, isUserMessage, shouldSkip } from './generate.js';
+import { createWarn, listenSessionEvents, selectLlm } from './host.js';
+import { DEFAULT_TEMPLATE } from './title.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();
+    // 注册点与服务都必须按宿主 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);
+    ctx.effect(() => () => {
+        state.clear();
+    }, 'dsh-session-title-gen: state lifecycle');
+    /** session/event 监听器：人类消息或标题事件触发结构化标题生成。 */
+    function onSessionEvent(session, event) {
+        const sess = session;
+        const evt = event;
+        if (evt?.type === 'user/message') {
+            if (!isUserMessage(evt))
+                return;
+            return maybeGenerate(sess);
+        }
+        if (evt?.type === 'session/title')
+            return maybeGenerate(sess);
+        return undefined;
+    }
+    /** 生成结构化标题（fire-and-forget；同一会话同时只跑一次）。 */
+    async function maybeGenerate(session) {
+        if (session === null || typeof session !== 'object' || typeof session.id !== 'string')
+            return;
+        if (shouldSkip(session))
+            return;
+        if (state.get(session.id)?.generating)
+            return;
+        const promise = generateSessionTitle({ session, llm, warn, config: cfg });
+        state.set(session.id, { generating: promise });
+        try {
+            await promise;
+        }
+        finally {
+            state.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/lib/title.js

@@ -0,0 +1,201 @@
+/**
+ * dsh-session-title-gen — title generation core.
+ *
+ * 纯函数 + LLM 生成：模板格式化、结构化判断、轻量流组装（只收集
+ * text-delta 与 finish reason，不依赖 @deepseek-ai/dsh-llm 的
+ * BlockAssembler）、标题折叠读取、UTF-8 截断。
+ */
+/** 默认格式模板：先归属后描述（类似 git commit 的 type(scope)）。 */
+export const DEFAULT_TEMPLATE = '[{workspace}] {description}';
+/**
+ * Format a title from the template, replacing {workspace} and {description}.
+ * @param template - format template with {workspace}/{description} placeholders.
+ * @param workspace - workspace name (may be '').
+ * @param description - LLM-generated description.
+ * @returns the formatted one-line title, or '' when description is empty.
+ */
+export function formatTitle(template, workspace, description) {
+    const desc = String(description ?? '').trim();
+    if (desc === '')
+        return '';
+    const ws = String(workspace ?? '').trim();
+    let tpl = String(template ?? DEFAULT_TEMPLATE);
+    if (ws === '') {
+        // 无工作区时移除 `[{workspace}]` 占位（split/join 无正则回溯，避免
+        // 用户配置的 template 含大量空白时触发 ReDoS；`\s+` 规范化是线性匹配）
+        tpl = tpl.split('[{workspace}]').join(' ');
+    }
+    const title = tpl.replaceAll('{workspace}', ws).replaceAll('{description}', desc);
+    return title.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Heuristic: whether a title already looks structured (bracket-prefixed,
+ * the default template shape `[workspace] description`).
+ * @param title - title text to inspect.
+ * @returns true when the title starts with a `[...]` prefix.
+ */
+export function isStructuredTitle(title) {
+    return typeof title === 'string' && /^\[[^\]]+\]/.test(title);
+}
+/**
+ * Lightweight stream assembly: collect text-delta text and the finish
+ * reason kind from an llm.stream async iterable.
+ * @param chunks - async iterable of stream chunks.
+ * @returns { text, finish } — joined text and finish kind ('stop'/'error'/…).
+ */
+export async function collectStreamText(chunks) {
+    let text = '';
+    let finish = undefined;
+    let failure = undefined;
+    for await (const chunk of chunks) {
+        if (chunk === null || typeof chunk !== 'object')
+            continue;
+        if (chunk.type === 'text-delta')
+            text += chunk.text ?? '';
+        else if (chunk.type === 'finish') {
+            finish = chunk.reason?.kind;
+            failure = chunk.reason?.failure;
+        }
+    }
+    return { text, finish, failure };
+}
+/**
+ * Read a session's committed events.
+ *
+ * DSH 0.1.5-rc.1 起 `Session.events` 变为 private（宿主类型只剩
+ * `private eventsSnapshot`），公开读取入口是 `snapshotEvents()`；直接读
+ * `session.events` 得到 undefined，会让消息收集与标题折叠**静默**返回空
+ * （issue #232 实测：插件执行了却从不 append 标题）。这里优先用公开 API，
+ * 并为旧宿主保留 `events` 数组回退。
+ *
+ * @param session - live session (or mock) carrying either accessor.
+ * @returns committed events in log order, or an empty array.
+ */
+export function sessionEvents(session) {
+    if (session === null || typeof session !== 'object')
+        return [];
+    const candidate = session;
+    if (typeof candidate.snapshotEvents === 'function') {
+        try {
+            const events = candidate.snapshotEvents();
+            if (Array.isArray(events))
+                return events;
+        }
+        catch {
+            // 公开 API 不可用时回退到 events 数组（旧宿主）
+        }
+    }
+    return Array.isArray(candidate.events) ? candidate.events : [];
+}
+/**
+ * Fold the latest session/title event data from a session log.
+ * @param session - live session (or mock) with committed events.
+ * @returns the latest title event data, or undefined.
+ */
+export function foldTitle(session) {
+    const events = sessionEvents(session);
+    for (let i = events.length - 1; i >= 0; i--) {
+        const event = events[i];
+        if (event?.type === 'session/title')
+            return event.data;
+    }
+    return undefined;
+}
+/**
+ * Truncate a string to a UTF-8 byte budget without splitting a code point.
+ * @param input - title text.
+ * @param maxBytes - positive byte budget.
+ * @returns the longest leading code-point prefix within the budget.
+ */
+function truncateUtf8(input, maxBytes) {
+    if (Buffer.byteLength(input, 'utf8') <= maxBytes)
+        return input;
+    let used = 0;
+    let output = '';
+    for (const character of input) {
+        const bytes = Buffer.byteLength(character, 'utf8');
+        if (used + bytes > maxBytes)
+            break;
+        output += character;
+        used += bytes;
+    }
+    return output;
+}
+/**
+ * Generate a structured title through the llm service.
+ * @param services - object exposing the llm service (a `DshContext` qualifies).
+ * @param options - { session, workspace, messages, route, signal, config }.
+ * @returns { title, model } — formatted title and the used model route.
+ * @throws when the LLM call fails, produces no text, or no route is available.
+ */
+export async function generateTitle(services, { session, workspace, messages, route, signal, config }) {
+    const framed = frameMessages(messages);
+    assertInputSize(framed, config.maxInputBytes);
+    const resolved = resolveRoute(config, route);
+    const options = buildOptions({ session, framed, route: resolved, signal, config });
+    const { text, finish, failure } = await collectStreamText(services.llm.stream(options));
+    assertFinish(finish, failure);
+    const description = String(text ?? '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    const title = formatTitle(config.template, workspace, description);
+    return { title: finalizeTitle(title, config.maxTitleBytes), model: resolved };
+}
+/** Frame exact messages as JSON so user text cannot break structural delimiters. */
+function frameMessages(messages) {
+    return `Generate the session title from this JSON array of human messages:\n${JSON.stringify(messages)}`;
+}
+/** Reject oversized input before it reaches the model. */
+function assertInputSize(framed, maxInputBytes) {
+    const inputBytes = Buffer.byteLength(framed, 'utf8');
+    if (inputBytes > maxInputBytes) {
+        throw new Error(`session-title-gen: input is ${inputBytes} bytes, exceeding maxInputBytes ${maxInputBytes}`);
+    }
+}
+/** Resolve the explicit route pair or the session request route. */
+function resolveRoute(config, route) {
+    const provider = config.provider ?? route?.provider;
+    const model = config.model ?? route?.model;
+    if (provider === undefined || model === undefined) {
+        throw new Error('session-title-gen: no LLM route available; configure provider and model together');
+    }
+    return { provider, model };
+}
+/** Build the llm.stream options for one title request. */
+function buildOptions({ session, framed, route, signal, config, }) {
+    return {
+        provider: route.provider,
+        model: route.model,
+        messages: [{ role: 'user', content: [{ type: 'text', text: framed }] }],
+        system: systemPrompt(),
+        maxTokens: config.maxOutputTokens,
+        sessionId: session.id,
+        purpose: 'session-title',
+        signal,
+    };
+}
+/** Translate a terminal error finish into a thrown failure. */
+function assertFinish(finish, failure) {
+    if (finish === 'error') {
+        throw new Error(`session-title-gen: LLM call failed: ${failure?.message ?? 'unknown error'}`);
+    }
+}
+/** Normalize and truncate the formatted title; reject empty results. */
+function finalizeTitle(title, maxBytes) {
+    if (title === '')
+        throw new Error('session-title-gen: title model produced an empty title');
+    const truncated = truncateUtf8(title, maxBytes);
+    if (truncated === '')
+        throw new Error('session-title-gen: title empty after truncation');
+    return truncated;
+}
+/** Stable system instruction: structured title, workspace first. */
+function systemPrompt() {
+    return [
+        'Create a concise title for an AI coding-assistant session from the supplied human messages.',
+        'The title MUST start with the workspace name in square brackets, then a brief description, like a git commit subject: [workspace] description.',
+        'Return only the title on one line, in plain text of natural language, with no quotes, prefix, explanation, Markdown, XML, or terminal control codes. No code is allowed.',
+        'Use the language of the messages.',
+        'Aim for about 8 words in non-CJK languages or 16 CJK characters for the description part.',
+    ].join('\n');
+}

package/lib/workspace.js

@@ -0,0 +1,19 @@
+/**
+ * dsh-session-title-gen — workspace-name resolution.
+ *
+ * 工作区名 = 会话 cwd 的项目根 basename：findProjectRoot 向上找最近
+ * .git 祖先（dsh-shared），取目录名作为归属标识（如 `[my-dsh-plugins]`）。
+ */
+import { basename } from 'node:path';
+import { findProjectRoot } from 'dsh-shared';
+/**
+ * Resolve the workspace name for a session cwd.
+ * @param cwd - session working directory (absolute path), or empty.
+ * @returns the project-root basename, or '' when cwd is missing.
+ */
+export async function workspaceNameOf(cwd) {
+    if (typeof cwd !== 'string' || cwd === '')
+        return '';
+    const root = await findProjectRoot(cwd);
+    return basename(root);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "dsh-session-title-gen",
+  "version": "0.1.0",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baosfeng/my-dsh-plugins"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "npx tsc -p tsconfig.json",
+    "typecheck": "npx tsc --noEmit -p tsconfig.json",
+    "test": "npx vitest run --coverage && cucumber-js test/features --import \"test/features/steps/*.mjs\""
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "assets"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "cordis": "^4.0.0-rc.10",
+    "dsh-shared": "^0.1.4"
+  },
+  "peerDependenciesMeta": {
+    "cordis": {
+      "optional": true
+    }
+  },
+  "license": "MIT"
+}