dsh-router-core 0.4.6 → 0.4.7

package/lib/ext-prompt/index.js

@@ -5,7 +5,7 @@ const PROMPT_CATEGORIES = [
 		id: "identity",
 		title: "身份气质",
 		defaultOn: true,
-		body: "身份气质：大肥鱼 🐋(资深开发者)；懒=高效不是马虎；安静、克制、直接；默认中文，直接给能跑的东西。"
+		body: "身份气质：大肥鱼 🐋(资深开发者)；懒=高效不是马虎；安静、克制、直接；回复、思考过程必须使用中文，直接给能跑的东西。"
 	},
 	{
 		id: "scope",
@@ -31,12 +31,6 @@ const PROMPT_CATEGORIES = [
 		defaultOn: true,
 		body: "收口(只在任务完成时做，与跑测试同级)：①反查过期：改动让哪些注释/文档/结论/代码引用点(凡以名字对齐的调用方、开关名、注册键)不符事实？当场改或删；②反查重复：新旧成两份就并成一处；③反查形状：该合的合、该归档的归位。做完那块区域该比动手前更整或更少。"
 	},
-	{
-		id: "hardening",
-		title: "固化",
-		defaultOn: true,
-		body: "固化：只对数据丢失/安全这类真损失补检查——会变红(注入违规必须失败)、可重放(一条命令)、归属清晰(失败信息指向违规处)；普通 bug 修好即止，不额外造闸门。"
-	},
 	{
 		id: "verdifiable",
 		title: "可判定",
@@ -91,7 +85,7 @@ const PROMPT_CATEGORIES = [
 *
 * ⚠️ 拆分时差点丢它：原文是 `[…] ·身份气质：…`，标题挂在方括号里、
 *   **不属于任何单条分类**，按分隔符切分时自然被丢掉
-*   （只在 `content.ts` 头注出现过、没进任何 `body`）。⇒ 模型会看到 14 条
+*   （只在 `content.ts` 头注出现过、没进任何 `body`）。⇒ 模型会看到一堆
 *   **没有名字**的规则，而"这套东西叫什么、为什么存在"恰恰是它需要的上下文。
 *
 * 形状：**不属于任何分类** ⇒ 不可被单条开关关掉（它一关，准则就无名无姓）。
@@ -165,7 +159,7 @@ function resolveEnabledCategories(masterOn, data) {
 * 渲染成**一个**段落文本（多分类拼一起）。
 *
 * 为什么要拼成一段而不是一段一个：面板开关是"分类"粒度，而 prompt 读起来
-* 是一段连续的准则 —— 分成 14 个 section 会让 KV cache 每个分类各占一段、
+* 是一段连续的准则 —— 分成多个 section 会让 KV cache 每个分类各占一段、
 * 增删任意一个分类都让其后全部位移。这里**注册一个 section，文本由开关拼装**。
 *
 * @returns 关闭的分类不进结果；全关 ⇒ 空串（上游 `renderPrompt` 会丢弃空段）。
@@ -224,6 +218,120 @@ function resolveCategories(data) {
 	return out;
 }
 //#endregion
+//#region src/ext-prompt/sections.ts
+/** 面板控制条 id 的段前缀（**传输层编码**；落盘用裸段名，不带前缀）。 */
+const SECTION_CONTROL_PREFIX = "sec:";
+/**
+* 自己的准则段：**不进清单、不被过滤**。
+*
+* 它已有独立的开关体系（扩展总开关 + 14 个分类开关）——再列一条"段开关"
+* 就是同一件事的第二个开关，两边状态会漂移；过滤它还会让分类开关看起来
+* 失效（段没了，分类怎么切都看不到效果）。
+*/
+const OWN_SECTION_NAME = "dsh-router-ext-prompt:guideline";
+/**
+* 段名前缀 → 面板分组名。**未知前缀原样当组名**（不硬编全部前缀）：
+* 宿主还会加新段（`web:`、`structured:`…），映射漏了顶多组名不雅，
+* 条目照常列出照常开关 —— 映射表漂移不允许变成"段消失"。
+*/
+/**
+* 段名前缀 → 面板分组名。
+*
+* ⚠️ 键是**段名的第一段**（冒号前），不是"看起来像"的前缀。2026-10-21 实测
+* 真宿主（3081，23 条 controls / 9 段）纠正过两处脑补：
+*   - `harness:source`（运行时上下文里 Harness 检出的位置）第一段是 `harness`，
+*     按前缀映射会被并入「开场身份」—— 而它不是身份，是运行环境说明；
+*   - `app:web-surface`（Web GUI 说明）第一段是 `app`，与"界面与交付"无关。
+* 所以 `harness` 刻意**不映射**：`harness:identity` 是身份、`harness:source` 不是，
+* 靠第一段分不开 —— 让它们各自留下真实前缀（`harness` / `app`）比归错组诚实。
+* `ui:` 才是界面与交付那一组（`ui:deliverable-file-references`）。
+*
+* 映射漏了或故意不映射的前缀，组名**原样显示前缀**、条目照常能列能开关 ——
+* 映射表漂移不允许变成"段消失"。
+*/
+const GROUP_LABELS = {
+	deployment: "部署人设",
+	plan: "计划模式",
+	team: "团队",
+	tool: "工具说明",
+	mcp: "MCP 服务",
+	context: "运行上下文",
+	ui: "界面与交付"
+};
+/**
+* 无冒号段名的映射（宿主有几个段名整名不带冒号）。
+*
+* `harness:identity` 才是开场身份，它带冒号走前缀表；这里只收无冒号的整名。
+*/
+const WHOLE_NAME_LABELS = { "mcp-resource-servers": "MCP 资源" };
+/** `controlId`（`sec:…`）→ 段名；非段条目返回 null。 */
+function sectionNameOf(controlId) {
+	return controlId.startsWith("sec:") ? controlId.slice(4) : null;
+}
+/** 段名 → 面板控制条 id。 */
+function sectionControlId(name) {
+	return SECTION_CONTROL_PREFIX + name;
+}
+/**
+* 段名的分组名。
+*
+* 查表顺序：**整名**（无冒号段名，如 `mcp-resource-servers`）→ **第一段前缀**
+* （`tool:write` → `tool`）。两级都查不到 ⇒ 有冒号时用第一段原样当组名、
+* 无冒号归「其他」。
+*/
+function groupLabelOf(name) {
+	const whole = WHOLE_NAME_LABELS[name];
+	if (whole !== void 0) return whole;
+	const i = name.indexOf(":");
+	if (i < 0) return "其他";
+	const head = name.slice(0, i);
+	return GROUP_LABELS[head] ?? head;
+}
+/** 面板条目标题：去掉组前缀的部分（`tool:write` → `write`；无冒号 = 全名）。 */
+function sectionTitleOf(name) {
+	const i = name.indexOf(":");
+	return i >= 0 ? name.slice(i + 1) : name;
+}
+/**
+* 当前被关掉的段名集合。**只认显式 `false`** —— 缺项是"没碰过"（默认开），
+* 与 `resolveEnabledCategories` 对 `undefined` 的处置同一纪律。
+*/
+function disabledSectionNames(data) {
+	const out = /* @__PURE__ */ new Set();
+	const saved = data?.sections;
+	if (!saved) return out;
+	for (const [name, on] of Object.entries(saved)) if (on === false) out.add(name);
+	return out;
+}
+/**
+* 过滤掉关闭的段（保序）。自己那段**恒放行**（理由见 `OWN_SECTION_NAME`）。
+*
+* ⚠️ 名字不在清单里的关闭项静默跳过：宿主段随版本增删，旧数据里的名字
+* 失效是正常生命周期，报错只会把面板变成红字噪音。
+*/
+function filterSections(sections, off) {
+	return sections.filter((s) => s.name === "dsh-router-ext-prompt:guideline" || !off.has(s.name));
+}
+/**
+* 段清单缓存：waterfall 监听器是**唯一写入者**（装配路径顺路喂），
+* 面板 controls getter 只读。分组与排序都在读取端做 —— 缓存保持
+* 装配原序（`assemble` 已按 order/name 排好），组的次序自然等于 prompt 次序。
+*/
+function createSectionCache() {
+	let entries = [];
+	return {
+		update(sections) {
+			entries = sections.filter((s) => s.name !== OWN_SECTION_NAME).map((s) => ({
+				name: s.name,
+				text: s.text
+			}));
+		},
+		list() {
+			return entries.map((e) => ({ ...e }));
+		}
+	};
+}
+//#endregion
 //#region src/ext-prompt/plugin.ts
 /** 从对象里去掉某个键（不改原对象）。`writeData` 是整块替换 ⇒ 删一个键要重写。 */
 function omit(obj, key) {
@@ -278,7 +386,7 @@ function createPromptExt(deps) {
 		get controls() {
 			const data = readData();
 			const on = resolveEnabledCategories(true, data);
-			return resolveCategories(data).map((c) => {
+			const categories = resolveCategories(data).map((c) => {
 				const t = effectiveText(c.id, data?.text?.[c.id], c);
 				return {
 					id: c.id,
@@ -290,9 +398,34 @@ function createPromptExt(deps) {
 					on: on.has(c.id)
 				};
 			});
+			const off = disabledSectionNames(data);
+			const sections = deps.getSections().filter((s) => s.name !== OWN_SECTION_NAME).map((s) => ({
+				id: sectionControlId(s.name),
+				title: sectionTitleOf(s.name),
+				on: !off.has(s.name),
+				detail: s.name,
+				body: s.text === "" ? "（此段当前为空）" : s.text,
+				group: groupLabelOf(s.name),
+				sortable: false
+			}));
+			return [...categories, ...sections];
 		},
 		setControl: (controlId, on) => {
 			if (!store) return false;
+			const secName = sectionNameOf(controlId);
+			if (secName !== null) {
+				if (secName === "dsh-router-ext-prompt:guideline") return false;
+				if (!deps.getSections().some((s) => s.name === secName)) return false;
+				const data = readData();
+				const sections = { ...data.sections ?? {} };
+				if (on) delete sections[secName];
+				else sections[secName] = false;
+				const next = { ...data };
+				if (Object.keys(sections).length > 0) next.sections = sections;
+				else delete next.sections;
+				store.writeData(EXT_PROMPT_ID, next);
+				return true;
+			}
 			const data = readData();
 			if (!resolveCategories(data).some((c) => c.id === controlId)) return false;
 			store.writeData(EXT_PROMPT_ID, {
@@ -424,14 +557,22 @@ function createPromptExt(deps) {
 /** 段落名（**稳定**）：改名会让已注册的作用域 section 与旧名并存。 */
 const PROMPT_SECTION_NAME = "dsh-router-ext-prompt:guideline";
 /**
-* 段落 order：100。
+* 段落 order：**-2000 = 全场最前**（2026-10-21 用户点名「把准则放到最前」）。
 *
-* 官方分配的槽位（`dsh-system-prompt` 的 `SECTION_ORDERS`）：
-* `PERSONA_PREFIX: 0` · `PLAN_POLICY: 500` · `TEAM_POLICY: 600` …·
-* 取 100 = 紧随 persona、远早于任何工具段 ⇒ 准则出现在身份之后、工具说明之前，
-* 与用户看到的记忆快照位置一致。
+* 官方分配的槽位（`dsh-system-prompt` 的 `SECTION_ORDERS`）最低一档是
+* `HARNESS_IDENTITY: -1000`（第一方开场白 `You are an AI agent powered by
+* DeepSeek Harness.`），其后才是 `DEPLOYMENT_PERSONA_PREFIX: 0`、`PLAN_POLICY: 500`
+* … `HARNESS_SOURCE: 10000`。
+*
+* 取 **-2000**（低于官方最低槽 1000）而不是「正好 -1000」：
+*   - 撞在 -1000 上要靠**段名的字母序**决胜（`comparePromptSections` 是
+*     `order` 再按 `name`）—— 那是实现细节，改段名就翻盘，不作为位置依据；
+*   - 第一方那行在本部署被 `includeHarnessIdentity: false` 关掉了，但**别的
+*     部署可能还开着** ⇒ 准则仍须排在它前面，不能假设它不存在。
+*
+* ⚠️ `order` 只要求有限数（`Number.isFinite`），负数合法。
 */
-const SECTION_ORDER = 100;
+const SECTION_ORDER = -2e3;
 /**
 * 挂载准则段落。返回卸载函数。
 *
@@ -511,15 +652,39 @@ function apply(ctx) {
 		isEnabled: () => store?.isEnabled(EXT_PROMPT_ID) === true,
 		readData: () => store?.readData(EXT_PROMPT_ID)
 	});
+	const cache = createSectionCache();
+	let disposeAssemble;
+	let disposeChange;
+	const sp = systemPromptOf(ctx);
+	if (sp) {
+		disposeAssemble = ctx.on("system-prompt/assemble", async (assembly, _context, next) => {
+			const result = await next();
+			cache.update(result.sections);
+			if (store?.isEnabled("prompt") !== true) return result;
+			const off = disabledSectionNames(store.readData(EXT_PROMPT_ID));
+			if (off.size === 0) return result;
+			return {
+				...result,
+				sections: filterSections(result.sections, off)
+			};
+		});
+		disposeChange = ctx.on("system-prompt/change", () => {
+			sp.assemble().catch(() => {});
+		});
+		sp.assemble().catch(() => {});
+	}
 	if (table !== void 0 && table["prompt"] === void 0) {
 		table[EXT_PROMPT_ID] = createPromptExt({
 			isSystemPromptReady: () => !!systemPromptOf(ctx),
-			store
+			store,
+			getSections: () => cache.list()
 		});
 		store?.setEnabled(EXT_PROMPT_ID, true);
 	}
 	ctx.effect(() => () => {
 		dispose();
+		disposeAssemble?.();
+		disposeChange?.();
 		if (table !== void 0) delete table[EXT_PROMPT_ID];
 	});
 }