@zhushanwen/pi-rename-session 0.11.2 → 0.12.0

package/README.md

@@ -41,7 +41,9 @@ pi install npm:@zhushanwen/pi-rename-session
   "model": { "type": "ref", "ref": "deepseek/deepseek-chat" },
   "mode": "first-stop",
   "maxTitleLength": 50,
-  "thinkingLevel": "off"
+  "thinkingLevel": "off",
+  "style": "slug",
+  "customInstruction": ""
 }
 ```
 
@@ -52,6 +54,8 @@ pi install npm:@zhushanwen/pi-rename-session
 | `mode` | `"first-prompt" \| "first-stop" \| "agent-tool"` | `"first-stop"` | 触发模式（三值互斥）：首条请求即命名 / 首个成功 round 末命名（现状）/ agent 自主经 `rename_session` 工具命名。事件面每次事件 live 读（GUI 切换对活跃 session 的自动命名即时生效）；工具注册面在 extension 工厂执行时求值（每 session 创建一次——taiji 每 session 一个 pi 进程；原生 pi CLI 同进程 /fork、/session 新建 session 亦重新求值），session 存活期内不回溯（pi 无 unregisterTool），切换后已存活 session 的残留工具由 execute 内 live mode 守卫拒绝并给恢复指引 |
 | `maxTitleLength` | `number` | `50` | 标题最大长度（Unicode 码点数，须正整数） |
 | `thinkingLevel` | `ModelThinkingLevel` | `"off"` | 标题 LLM 的 thinking 级别（`off` = 不传 reasoning，provider 默认） |
+| `style` | `"slug" \| "sentence" \| "emoji" \| "custom"` | `"slug"` | 标题提示词风格：非 custom 枚举 = 内置词表（随版本升级自动跟随）；`custom` = 消费 `customInstruction`（taiji 设置页「会话重命名」可视化配置） |
+| `customInstruction` | `string` | `""` | 自定义标题提示词自由文本（仅 `style: "custom"` 时生效；**空串回落内置 slug 默认**；超 2000 码点防御截断；custom 非空时 systemPrompt 降级为「只输出标题文本」通用骨架，风格权威 = 用户指令） |
 
 文件缺失/坏 JSON 返回默认值，不抛错。改完保存即生效（mtime 读时刷新，每个 `turn_end` / `message_end` 重新 load）。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-rename-session",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "type": "module",
   "main": "index.ts",
   "taiji": {
@@ -16,7 +16,9 @@
           },
           "mode": "first-stop",
           "maxTitleLength": 50,
-          "thinkingLevel": "off"
+          "thinkingLevel": "off",
+          "style": "slug",
+          "customInstruction": ""
         }
       }
     ]
@@ -33,8 +35,8 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/pi-ext-guards": "0.4.4",
     "@zhushanwen/pi-extension-logger": "0.6.2",
+    "@zhushanwen/pi-ext-guards": "0.4.4",
     "@zhushanwen/pi-llm-shared": "0.11.2"
   },
   "devDependencies": {

package/skills/rename-session-ext-config/SKILL.md

@@ -45,9 +45,14 @@ interface RenameSessionConfig {
   mode: "first-prompt" | "first-stop" | "agent-tool";  // 触发模式，默认 "first-stop"
   maxTitleLength: number;  // 标题最大长度（Unicode 码点），默认 50
   thinkingLevel: ModelThinkingLevel;  // 标题 LLM 的 thinking 级别，默认 "off"
+  style: "slug" | "sentence" | "emoji" | "custom";  // 标题提示词风格，默认 "slug"
+  customInstruction: string;  // 自定义提示词自由文本（仅 custom 生效），默认 ""
 }
 ```
 
+> taiji 设置页（独立「会话重命名」菜单页）只暴露 first-prompt / first-stop 两档触发模式；
+> `agent-tool` 与 prompt 配置仍可经 pi CLI / 手改配置文件使用（底层 rename_session 工具保留）。
+
 ### ModelSelector（仅支持 ref 精确指定）
 
 | type | 形式 | 语义 |
@@ -66,10 +71,17 @@ interface RenameSessionConfig {
 
 标题 LLM 的 thinking 级别，枚举 `off` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（pi 的 `ModelThinkingLevel`）。默认 `"off"`：直接透传给 llm-shared，由 llm-shared 映射为不传 reasoning（provider 默认行为）；`minimal`~`max` 透传给 reasoning（provider 不支持时静默忽略）。缺失或非法值回落 `"off"`。
 
+### style + customInstruction（标题提示词风格）
+
+- `style` 枚举 `slug` / `sentence` / `emoji` / `custom`，默认 `"slug"`（现状行为，零迁移）：非 custom 枚举由内置词表（llm.ts `BUILTIN_TEMPLATES`）承载 user 指令，随 extension 版本升级自动跟随；`custom` 消费 `customInstruction`（taiji 设置页「会话重命名」可视化配置的写入面）
+- `customInstruction`：自定义自由文本，**空串/全空白回落内置 slug 默认**（「空 = 内置默认」语义，不要把默认文本写死进配置）；超 2000 码点防御截断（与 runtime 写侧/runtime RENAME_INSTRUCTION_MAX_LENGTH 同限）
+- systemPrompt 分流：非 custom → slug 风格 systemPrompt（与词表自洽）；custom 且指令非空 → 「只输出标题文本」通用骨架（风格权威 = 用户指令，消解双处风格冲突）
+- 缺失/非法 `style` 回落 `"slug"`；非 string `customInstruction` 回落空串（粒度容错，坏字段不影响其他字段）
+
 ## 默认值
 
 ```json
-{ "enabled": false, "model": { "type": "ref", "ref": "" }, "mode": "first-stop", "maxTitleLength": 50, "thinkingLevel": "off" }
+{ "enabled": false, "model": { "type": "ref", "ref": "" }, "mode": "first-stop", "maxTitleLength": 50, "thinkingLevel": "off", "style": "slug", "customInstruction": "" }
 ```
 
 ## 配置示例

package/src/__tests__/llm.test.ts

@@ -32,6 +32,8 @@ vi.mock("../pure.js", async (importActual) => {
 import { callLLM, resolveModel } from "@zhushanwen/pi-llm-shared";
 
 import {
+	BUILTIN_TEMPLATES,
+	GENERIC_SYSTEM_PROMPT,
 	RENAME_INSTRUCTION,
 	RENAME_SYSTEM_PROMPT,
 	buildTitleMessages,
@@ -39,6 +41,7 @@ import {
 	extractFinalText,
 	extractUserPromptText,
 	isSubagentSession,
+	resolveTitlePrompt,
 	truncateForTitle,
 } from "../llm.js";
 import { cleanTitle, type RenameSessionConfig } from "../pure.js";
@@ -258,6 +261,44 @@ describe("RENAME_SYSTEM_PROMPT / RENAME_INSTRUCTION", () => {
 	});
 });
 
+// resolveTitlePrompt（rename-prompt-config 设计：风格 → 词表 / custom 自定义，system 骨架分流）
+// ────────────────────────────────────────────────────
+
+describe("resolveTitlePrompt", () => {
+	const baseCfg = { ...BASE_CONFIG };
+
+	it("slug/sentence/emoji → BUILTIN_TEMPLATES 词表 + slug systemPrompt", () => {
+		expect(resolveTitlePrompt({ ...baseCfg, style: "slug" })).toEqual({
+			systemPrompt: RENAME_SYSTEM_PROMPT,
+			instruction: RENAME_INSTRUCTION,
+		});
+		expect(resolveTitlePrompt({ ...baseCfg, style: "sentence" }).instruction).toBe(BUILTIN_TEMPLATES.sentence);
+		expect(resolveTitlePrompt({ ...baseCfg, style: "emoji" }).instruction).toBe(BUILTIN_TEMPLATES.emoji);
+		// 非 custom 风格的 system 恒为 slug 版（词表与 slug 约束自洽）
+		expect(resolveTitlePrompt({ ...baseCfg, style: "sentence" }).systemPrompt).toBe(RENAME_SYSTEM_PROMPT);
+	});
+
+	it("custom 且指令非空 → 自定义指令 + GENERIC_SYSTEM_PROMPT（风格权威 = 用户指令）", () => {
+		const r = resolveTitlePrompt({ ...baseCfg, style: "custom", customInstruction: "生成不超过 12 字的中文标题" });
+		expect(r.instruction).toBe("生成不超过 12 字的中文标题");
+		expect(r.systemPrompt).toBe(GENERIC_SYSTEM_PROMPT);
+	});
+
+	it("custom 但指令为空/全空白 → 回落 slug 默认（「空 = 内置默认」语义）", () => {
+		const r = resolveTitlePrompt({ ...baseCfg, style: "custom", customInstruction: "   " });
+		expect(r.instruction).toBe(RENAME_INSTRUCTION);
+		expect(r.systemPrompt).toBe(RENAME_SYSTEM_PROMPT);
+	});
+
+	it("内置词表非空且含「只输出标题文本」输出契约（防模板回归退化为空串）", () => {
+		for (const t of Object.values(BUILTIN_TEMPLATES)) {
+			expect(t.length).toBeGreaterThan(0);
+			expect(t).toContain("只输出标题文本");
+		}
+		expect(GENERIC_SYSTEM_PROMPT).toContain("只输出标题文本");
+	});
+});
+
 // ────────────────────────────────────────────────────
 // 空 ref fallback（空 ref → ctx.model 跟随会话主模型；非空无效 ref → 静默跳过 + warn）
 // ────────────────────────────────────────────────────
@@ -395,6 +436,8 @@ const BASE_CONFIG: RenameSessionConfig = {
 	mode: "first-stop",
 	maxTitleLength: 50,
 	thinkingLevel: "off",
+	style: "slug",
+	customInstruction: "",
 };
 
 /** 触发 turn 的最终 assistant message（turn_end 的 event.message）——thinking 混排验证只取 text。 */

package/src/__tests__/pure.test.ts

@@ -8,6 +8,7 @@ import { clearConfigCache, getConfigPath } from "@zhushanwen/pi-llm-shared";
 
 import {
 	DEFAULT_RENAME_CONFIG,
+	RENAME_INSTRUCTION_MAX_LENGTH,
 	cleanTitle,
 	countSuccessfulAssistantReplies,
 	countUserMessages,
@@ -207,12 +208,21 @@ describe("cleanTitle", () => {
 // ────────────────────────────────────────────────────
 
 describe("DEFAULT_RENAME_CONFIG", () => {
-	it("默认值：enabled=false / model=空 ref / mode=first-stop / maxTitleLength=50 / thinkingLevel=off", () => {
+	it("默认值：enabled=false / model=空 ref / mode=first-stop / maxTitleLength=50 / thinkingLevel=off / style=slug / customInstruction=空串", () => {
 		expect(DEFAULT_RENAME_CONFIG.enabled).toBe(false);
 		expect(DEFAULT_RENAME_CONFIG.model).toEqual({ type: "ref", ref: "" });
 		expect(DEFAULT_RENAME_CONFIG.mode).toBe("first-stop");
 		expect(DEFAULT_RENAME_CONFIG.maxTitleLength).toBe(50);
 		expect(DEFAULT_RENAME_CONFIG.thinkingLevel).toBe("off");
+		// 三处默认值真相（本常量 / runtime rename-session-config.ts 镜像 / package.json
+		// startupConfig.content）同批收敛的字面值锁定：改任一侧须双侧同步（runtime 测试侧
+		// 以建文件基底断言锁定同值，单侧改动必红）
+		expect(DEFAULT_RENAME_CONFIG.style).toBe("slug");
+		expect(DEFAULT_RENAME_CONFIG.customInstruction).toBe("");
+	});
+
+	it("RENAME_INSTRUCTION_MAX_LENGTH = 2000（与 @taiji/shared 协议字面值同值的手写镜像锁定，改任一侧双侧同步）", () => {
+		expect(RENAME_INSTRUCTION_MAX_LENGTH).toBe(2000);
 	});
 });
 
@@ -238,6 +248,8 @@ describe("normalizeRenameConfig", () => {
 			mode: "first-prompt",
 			maxTitleLength: 30,
 			thinkingLevel: "high",
+			style: "emoji",
+			customInstruction: "自定义指令",
 		};
 		expect(normalizeRenameConfig(cfg)).toEqual(cfg);
 	});
@@ -266,6 +278,8 @@ describe("normalizeRenameConfig", () => {
 			mode: "first-stop",
 			maxTitleLength: 20,
 			thinkingLevel: "off",
+			style: "slug",
+			customInstruction: "",
 		});
 	});
 
@@ -330,8 +344,43 @@ describe("normalizeRenameConfig", () => {
 			mode: "first-stop",
 			maxTitleLength: 20,
 			thinkingLevel: "off",
+			style: "slug",
+			customInstruction: "",
 		});
 	});
+
+	// ── style + customInstruction（rename-prompt-config 设计）──
+
+	it("style 四个合法值（slug/sentence/emoji/custom）→ 原样保留", () => {
+		for (const style of ["slug", "sentence", "emoji", "custom"] as const) {
+			expect(normalizeRenameConfig({ style }).style).toBe(style);
+		}
+	});
+
+	it("style 缺失/非法 → 默认 slug（零迁移，现状行为）", () => {
+		expect(normalizeRenameConfig({}).style).toBe("slug");
+		expect(normalizeRenameConfig({ style: "fancy" }).style).toBe("slug");
+		expect(normalizeRenameConfig({ style: 42 }).style).toBe("slug");
+		expect(normalizeRenameConfig({ style: null }).style).toBe("slug");
+	});
+
+	it("customInstruction 非 string → 空串；合法值原样保留", () => {
+		expect(normalizeRenameConfig({ customInstruction: 42 }).customInstruction).toBe("");
+		expect(normalizeRenameConfig({ customInstruction: null }).customInstruction).toBe("");
+		expect(normalizeRenameConfig({ customInstruction: "生成标题" }).customInstruction).toBe("生成标题");
+	});
+
+	it("customInstruction 超长防御截断（码点数，不劈开代理对）", () => {
+		const long = "a".repeat(RENAME_INSTRUCTION_MAX_LENGTH + 10);
+		expect(Array.from(normalizeRenameConfig({ customInstruction: long }).customInstruction)).toHaveLength(
+			RENAME_INSTRUCTION_MAX_LENGTH,
+		);
+		// emoji 星面字符（占 2 UTF-16 码元）按码点截断后仍可无损重组（无未配对代理残留）
+		const emojiPad = "😀".repeat(RENAME_INSTRUCTION_MAX_LENGTH + 1);
+		const truncated = normalizeRenameConfig({ customInstruction: emojiPad }).customInstruction;
+		expect(Array.from(truncated)).toHaveLength(RENAME_INSTRUCTION_MAX_LENGTH);
+		expect(Array.from(truncated).join("")).toBe(truncated);
+	});
 });
 
 // ────────────────────────────────────────────────────
@@ -427,6 +476,8 @@ describe("loadRenameConfig / saveRenameConfig", () => {
 			mode: "first-prompt" as const,
 			maxTitleLength: 30,
 			thinkingLevel: "off",
+			style: "custom" as const,
+			customInstruction: "自定义指令文本",
 		};
 		const saveResult = saveRenameConfig(cfg);
 		expect(saveResult.success).toBe(true);
@@ -441,6 +492,8 @@ describe("loadRenameConfig / saveRenameConfig", () => {
 			mode: "agent-tool",
 			maxTitleLength: 50,
 			thinkingLevel: "off",
+			style: "slug",
+			customInstruction: "",
 		});
 		const filePath = path.join(tmpAgentDir, "config", "rename-session-ext-config.json");
 		expect(fs.existsSync(filePath)).toBe(true);

package/src/llm.ts

@@ -7,7 +7,7 @@ import { isRecord } from "@zhushanwen/pi-ext-guards";
 import { getLogger } from "@zhushanwen/pi-extension-logger";
 import { callLLM, joinTextBlocks, resolveModel } from "@zhushanwen/pi-llm-shared";
 
-import { type RenameSessionConfig, cleanTitle, truncateCodePoints } from "./pure.js";
+import { type RenameSessionConfig, type RenameStyle, cleanTitle, truncateCodePoints } from "./pure.js";
 
 const logger = getLogger("rename-session");
 
@@ -32,6 +32,57 @@ export const RENAME_SYSTEM_PROMPT =
 export const RENAME_INSTRUCTION =
 	"根据以上对话，为这个会话生成一个 slug 式标题。要求：\n- 名词或动名词词组，例：「修复登录超时」「重构配置加载」「refactor-config-loader」\n- 反例（错误）：「我帮你修复了登录 bug」「This session is about fixing bugs」\n- 英文小写 kebab-case，中文直接用词组，不要句号\n使用对话所用的语言。只输出标题文本。";
 
+/**
+ * 「完整短句」风格内置词表（rename-prompt-config 设计）：不超过 20 字的完整短句，概括任务
+ * 目标或结果。与 slug 风格同为 user 指令形态（追加在对话末尾），正反例锚定与 RENAME_INSTRUCTION 同范式。
+ * 仅 BUILTIN_TEMPLATES 消费（renderer 侧是跨包字面量对拍测试，不 import 本模块）。
+ */
+const SENTENCE_INSTRUCTION =
+	"根据以上对话，为这个会话生成一个简短标题：一个不超过 20 字的完整短句，概括本次任务的目标或结果，不加句尾标点。反例（错误）：「重构」。使用对话所用的语言。只输出标题文本。";
+
+/**
+ * 「Emoji 点缀」风格内置词表（rename-prompt-config 设计）：以贴切 emoji 开头 + 不超过 15 字
+ * 词组或短句。正例锚定输出形态，避免模型漏掉 emoji 或输出多行。
+ * 仅 BUILTIN_TEMPLATES 消费（同 SENTENCE_INSTRUCTION，renderer 侧字面量对拍不 import）。
+ */
+const EMOJI_INSTRUCTION =
+	"根据以上对话，为这个会话生成一个标题：以一个贴切的 emoji 开头，后接不超过 15 字的词组或短句。例：「🔧 重构配置加载」「🐛 修复登录超时」。使用对话所用的语言。只输出标题文本。";
+
+/**
+ * 自定义指令时的通用 systemPrompt 骨架（rename-prompt-config 设计）：只保留「你是标题生成器 +
+ * 只输出标题文本」的输出契约，剥离 slug 风格细节——避免「system 说 slug、user 自定义说短句」
+ * 的风格冲突（用户自定义指令时唯一风格权威 = 用户指令）。
+ */
+export const GENERIC_SYSTEM_PROMPT =
+	"你是会话标题生成器。根据对话生成一个简短标题，只输出标题文本。";
+
+/**
+ * 内置风格词表（rename-prompt-config 设计）：style 非 custom 时的 user 指令映射。
+ * custom 不在此表（消费 config.customInstruction，空串回落 slug 默认）。
+ */
+export const BUILTIN_TEMPLATES: Readonly<Record<Exclude<RenameStyle, "custom">, string>> = {
+	slug: RENAME_INSTRUCTION,
+	sentence: SENTENCE_INSTRUCTION,
+	emoji: EMOJI_INSTRUCTION,
+};
+
+/**
+ * 按配置解析生效的标题提示词（rename-prompt-config 设计核心收敛点）：
+ * - 非 custom 枚举风格 → BUILTIN_TEMPLATES 词表 + RENAME_SYSTEM_PROMPT（slug 约束与词表自洽）
+ * - custom 且自定义指令非空 → 自定义指令 + GENERIC_SYSTEM_PROMPT（风格权威 = 用户指令，
+ *   system 降级为输出契约骨架，消解双处风格冲突）
+ * - custom 但自定义指令为空（含全空白）→ 回落 slug 默认（与「空 = 内置默认」语义一致）
+ */
+export function resolveTitlePrompt(config: RenameSessionConfig): { systemPrompt: string; instruction: string } {
+	if (config.style === "custom" && config.customInstruction.trim() !== "") {
+		return { systemPrompt: GENERIC_SYSTEM_PROMPT, instruction: config.customInstruction };
+	}
+	// custom 但自定义指令为空（含全空白）→ 回落 slug 默认（「空 = 内置默认」语义）；
+	// 其余枚举 → 词表直查（Record 键完备，无 fallback 分支）
+	const style: Exclude<RenameStyle, "custom"> = config.style === "custom" ? "slug" : config.style;
+	return { systemPrompt: RENAME_SYSTEM_PROMPT, instruction: BUILTIN_TEMPLATES[style] };
+}
+
 // ──────────────────────── 纯函数 ────────────────────────
 
 /**
@@ -283,11 +334,15 @@ export async function callRenameLLM(
 	}
 	const finalText = extractFinalText(finalMessage);
 
+	// 提示词解析（rename-prompt-config）：内置风格 → 词表 + slug system；custom 非空 →
+	// 自定义指令 + 通用骨架 system（风格权威 = 用户指令）。事件面 live 读 config 后每次调用重解析。
+	const { systemPrompt, instruction } = resolveTitlePrompt(config);
+
 	// 两段输入信号各截断 4000 码点（成本可控，标题语义足够）
 	const messages = buildTitleMessages(
 		truncateForTitle(userPrompt),
 		truncateForTitle(finalText),
-		RENAME_INSTRUCTION,
+		instruction,
 	);
 
 	// debug 内省：日志与 callLLM 收到的是同一 messages 对象，日志内容即 LLM 收到的内容；
@@ -300,7 +355,7 @@ export async function callRenameLLM(
 	const sessionId = ctx.sessionManager.getSessionId();
 	const result = await callLLM(ctx, {
 		model,
-		systemPrompt: RENAME_SYSTEM_PROMPT,
+		systemPrompt,
 		messages,
 		// 输出预算必须覆盖「thinking + 标题」两部分：thinking 计入 maxTokens 的模型
 		//（StepFun step-5-preview 实测 thinking 600-1500 tokens 且不可禁用/不可压低，

package/src/pure.ts

@@ -17,6 +17,20 @@ import {
 /** 触发模式三值枚举：互斥，默认 "first-stop"（零行为迁移）。 */
 export type RenameMode = "first-prompt" | "first-stop" | "agent-tool";
 
+/**
+ * 标题提示词风格枚举（设计 rename-prompt-config）：slug/sentence/emoji = 内置词表（随 extension
+ * 版本升级自动跟随），custom = 用户自定义自由文本（customInstruction 承载，空串回落内置 slug）。
+ * 与 @taiji/shared RenameStyle 值域同构（跨包不 import，本包 role=universal）。
+ */
+export type RenameStyle = "slug" | "sentence" | "emoji" | "custom";
+
+/**
+ * 自定义标题提示词长度上限（Unicode 码点数）——与 @taiji/shared RENAME_INSTRUCTION_MAX_LENGTH
+ * 同值（跨包不 import 的镜像，改值须双侧同步）。三消费点：本包 normalize 防御截断 /
+ * runtime setRenamePrompt 写侧归一 / renderer 编辑器计数。
+ */
+export const RENAME_INSTRUCTION_MAX_LENGTH = 2000;
+
 /**
  * rename-session 配置 schema（落盘到 `<agentDir>/config/rename-session-ext-config.json`，路径由 llm-shared 推导）。
  *
@@ -25,7 +39,11 @@ export type RenameMode = "first-prompt" | "first-stop" | "agent-tool";
  *   auto-rename-enabled flag 文件（live 覆盖源，存在即开，见下方 [COMPAT] 契约）
  * - model 从「搭便车 ctx.model」改为独立 `ModelSelector`（仅支持 ref 精确指定；空 ref 跟随会话主模型，见 llm.ts 的空 ref fallback）
  * - maxTitleLength 保留（默认 50）
- * - renameInstruction 不进配置（i18n 留未来），由代码常量 RENAME_INSTRUCTION 承载
+ * - style + customInstruction：标题提示词风格（rename-prompt-config 设计）：非 custom 枚举 =
+ *   内置词表（llm.ts BUILTIN_TEMPLATES，随版本升级），custom = 自定义自由文本（空串回落
+ *   内置 slug 默认）。GUI 配置页（taiji RenameSessionPage）经 runtime config.get/setRenamePrompt
+ *   读写，pi CLI 用户亦可直接改本文件
+ * - renameInstruction 内置默认由代码常量 RENAME_INSTRUCTION 承载（llm.ts）
  * - mode：first-prompt 首条 user 消息触发 / first-stop 首个成功 round 末触发（默认，现状）/
  *   agent-tool 不自动生成、注册 rename_session 工具由 agent 自主改名
  */
@@ -38,6 +56,13 @@ export interface RenameSessionConfig {
 	mode: RenameMode;
 	/** 标题最大长度（Unicode 码点数）。 */
 	maxTitleLength: number;
+	/**
+	 * 标题提示词风格（默认 "slug"，现状行为）。非 custom 枚举由 llm.ts BUILTIN_TEMPLATES
+	 * 提供词表；custom 消费 customInstruction（空串回落内置 slug 默认）。
+	 */
+	style: RenameStyle;
+	/** 自定义标题提示词自由文本（仅 style=custom 时生效；超长由 normalize 防御截断）。 */
+	customInstruction: string;
 	/**
 	 * 标题生成 LLM 的 thinking 级别（字符串透传；合法档位按模型 supportedLevels 在调用点判定）。
 	 * 默认 "off"：不传 pi-ai reasoning（provider 默认行为，与旧版本一致）；
@@ -51,6 +76,9 @@ export interface RenameSessionConfig {
 /** 合法触发模式清单（与 RenameMode 一致；normalize 校验用）。Set 免 as 断言。 */
 const RENAME_MODES: ReadonlySet<string> = new Set(["first-prompt", "first-stop", "agent-tool"]);
 
+/** 合法提示词风格清单（与 RenameStyle 一致；normalize 校验用）。 */
+const RENAME_STYLES: ReadonlySet<string> = new Set(["slug", "sentence", "emoji", "custom"]);
+
 /**
  * 类型谓词：unknown 是否为合法触发模式（normalizeRenameConfig 校验用，单点断言）。
  * Set.has 运行时兜底 + 类型收窄，调用方无需再断言。
@@ -59,13 +87,20 @@ function isRenameMode(raw: unknown): raw is RenameMode {
 	return typeof raw === "string" && RENAME_MODES.has(raw);
 }
 
-/** 默认配置：关闭、空 ref（跟随会话主模型，见 llm.ts 的空 ref fallback）、first-stop 触发、标题上限 50、不启用 thinking。 */
+/** 类型谓词：unknown 是否为合法提示词风格（与 isRenameMode 同款范式，单点断言）。 */
+function isRenameStyle(raw: unknown): raw is RenameStyle {
+	return typeof raw === "string" && RENAME_STYLES.has(raw);
+}
+
+/** 默认配置：关闭、空 ref（跟随会话主模型，见 llm.ts 的空 ref fallback）、first-stop 触发、标题上限 50、不启用 thinking、slug 内置风格、无自定义指令。 */
 export const DEFAULT_RENAME_CONFIG: RenameSessionConfig = {
 	enabled: false,
 	model: { type: "ref", ref: "" },
 	mode: "first-stop",
 	maxTitleLength: 50,
 	thinkingLevel: "off",
+	style: "slug",
+	customInstruction: "",
 };
 
 /** llm-shared loadConfig/saveConfig 的包名（决定文件名 rename-session-ext-config.json，llm-shared getConfigPath 追加 -ext-config.json 后缀）。 */
@@ -145,7 +180,18 @@ export function normalizeRenameConfig(raw: unknown): RenameSessionConfig {
 
 	const thinkingLevel = normalizeThinkingLevel(obj.thinkingLevel) ?? DEFAULT_RENAME_CONFIG.thinkingLevel;
 
-	return { enabled, model, mode, maxTitleLength, thinkingLevel };
+	// style 逐字段校验：旧 config 无字段 / 非法值 → 默认 slug（零迁移，现状行为）
+	const style = isRenameStyle(obj.style) ? obj.style : DEFAULT_RENAME_CONFIG.style;
+
+	// customInstruction：非字符串 → 空串；超长防御截断（码点数，与 runtime 写侧归一同限）
+	const rawInstruction = typeof obj.customInstruction === "string" ? obj.customInstruction : "";
+	const instructionChars = Array.from(rawInstruction);
+	const customInstruction =
+		instructionChars.length > RENAME_INSTRUCTION_MAX_LENGTH
+			? instructionChars.slice(0, RENAME_INSTRUCTION_MAX_LENGTH).join("")
+			: rawInstruction;
+
+	return { enabled, model, mode, maxTitleLength, thinkingLevel, style, customInstruction };
 }
 
 /**