@xrn1997/dsh-session-delete 0.6.1 → 0.7.0

package/lib/index.js

@@ -4,14 +4,14 @@ import zlib from "node:zlib";
 import { homedir } from "node:os";
 //#region src/shared/wire.ts
 /**
-* 跨半 wire 契约：前缀、九个端点、请求/响应形状与失败码。
+* 跨半 wire 契约：前缀、十个端点、请求/响应形状与失败码。
 * Node 半（src/api/dispatch.ts）与浏览器半（src/client/remote.ts）共用这一份，不各写字面量。
 *
 * 构建约束：本文件零运行时依赖、无 import；浏览器半把整个文件 inline 进 bundle。
 * 信封 {ok:true,value} / {ok:false,error:{code,message,details?}} 也是两半的共同契约。
 */
 /**
-* 插件专属前缀（九段相对它命名）。
+* 插件专属前缀（十段相对它命名）。
 *
 * 为什么必须带插件名：宿主 `connection.fetch.register` 对**重复的精确路径**直接抛错
 * （`connection: exact Fetch route "…" is already registered`），撞了就是整棵插件树 boot 失败——
@@ -19,11 +19,11 @@ import { homedir } from "node:os";
 */
 const SESSION_DELETE_API_PREFIX = "/dsh-session-delete-api";
 /**
-* 唯一的取数基础路径：宿主 `/api` + 插件前缀。九段 exact Fetch 路由、客户端探测与附件 URL
+* 唯一的取数基础路径：宿主 `/api` + 插件前缀。十段 exact Fetch 路由、客户端探测与附件 URL
 * 都从它起；`SESSION_DELETE_API_PREFIX` 只作为段名的相对前缀与错误原文。
 */
 const OFFICIAL_SESSION_DELETE_API_PREFIX = `/api${SESSION_DELETE_API_PREFIX}`;
-/** 九个段名（相对前缀）。**每项 `{ path, method }` 两键**：某段用什么方法也是线上形状的一部分
+/** 十段段名（相对前缀）。**每项 `{ path, method }` 两键**：某段用什么方法也是线上形状的一部分
 *  （ADR-0003），家就在这一张表——路由记录（`src/api/route-table.ts`）逐行投影（`ROUTES.x.method`），
 *  浏览器半的 GET 段同样投影、写段把 `ROUTES.x.method` 交给 `src/client/remote.ts` 的 `post()`，
 *  两半都不逐段手写一份。
@@ -38,7 +38,8 @@ const OFFICIAL_SESSION_DELETE_API_PREFIX = `/api${SESSION_DELETE_API_PREFIX}`;
 *    这一段只负责"有多少、在哪、多大"。
 *  - `attachment`：附件原始字节（全仓唯一的二进制响应段；失败仍回 JSON 信封）。
 *  - `attachmentOrphans`：无引用图片对象的扫描报告（纯读；数量/字节 + 供预览的对象清单）。
-*  - `attachmentClean`：清掉报告那一刻无引用的图片对象（聚合回执 `AttachmentCleanupWire`）。 */
+*  - `attachmentClean`：清掉报告那一刻无引用的图片对象（聚合回执 `AttachmentCleanupWire`）。
+*  - `config`：三只可调项的读/写共用一段——空体读当前值，带字段写回 profile 的 patch 层。 */
 const ROUTES = {
 	list: {
 		path: "/list",
@@ -49,6 +50,11 @@ const ROUTES = {
 		path: "/ping",
 		method: "GET"
 	},
+	/** 可调项：空体读（与 `/detail` 同法，用 POST 表达一个读）；带字段写，写必须进到达序链。 */
+	config: {
+		path: "/config",
+		method: "POST"
+	},
 	/** 单条详情（读回收站目录里那条会话自己的日志）。 */
 	detail: {
 		path: "/detail",
@@ -85,6 +91,22 @@ const ROUTES = {
 		method: "POST"
 	}
 };
+/** 三只可调项的接受范围（闭区间整数）。Node 半的归一与浏览器半的表单共用这一格：
+*  两处各写一份范围就会「表单说能存、宿主激活时说越界」。 */
+const CONFIG_LIMITS = {
+	orphanPreviewLimit: {
+		min: 1,
+		max: 1e4
+	},
+	maxAttachmentBytes: {
+		min: 1,
+		max: 209715200
+	},
+	maxJsonRefBytes: {
+		min: 1,
+		max: 104857600
+	}
+};
 /** 请求参数名：浏览器半发、Node 半读，同名同义（`empty` 没有入参）。
 *  附件段是 **query 参数**（GET 二进制响应，没有请求体）。 */
 const PARAMS = {
@@ -2158,6 +2180,7 @@ async function cleanOrphanGroup(deps, group) {
 //#endregion
 //#region src/ports/agent-handles.ts
 const CAPTURED_AGENT_HANDLES = Symbol.for("dsh-session-delete.captured-agent-handles");
+const CAPTURED_AGENT_WRAPPERS = Symbol.for("dsh-session-delete.captured-agent-wrappers");
 /** 在 `ctx.agents` 上包一层 `resume` / `create`，把返回的 agent handle 的 dispose 按会话 id 记下。
 *  服务缺席时走 `ctx.inject(['agents'])` **等服务挂上再装**——live profile 的插件激活顺序可能早于
 *  `agents` 服务就绪；只在 apply 时 `get` 一次会让捕获静默缺席（真机症状：重启前在回收站的能冷恢复，
@@ -2166,14 +2189,46 @@ const CAPTURED_AGENT_HANDLES = Symbol.for("dsh-session-delete.captured-agent-han
 *  **安装时机**：先 `get('agents')`，没装成再 `inject(['agents'])`（两者只装一次，符号表兜住）。
 *  **symbol 表**：句柄表挂在服务实例的 {@link CAPTURED_AGENT_HANDLES} 上；同一个 agents 服务上的第二次
 *  安装（`get` 与 `inject` 各一次，或第二个 `createHostPort`）看见它就直接共用，不把 wrapper 套第二层。
+*  **安装者拥有 wrapper**：包装记录先在闭包里留一份（`ownWrappers`，建立于 symbol 写入之前），同时挂到
+*  {@link CAPTURED_AGENT_WRAPPERS}；第一次成功安装时经 `ctx.effect` 注册一条卸载恢复——按 own property
+*  descriptor 的身份把 `resume` / `create` 写回目标自有的原函数（`restoreTo`；代理读回的影子不写回，
+*  别人后装的 wrapper 不动），并摘掉仍归本闭包的 symbol 表。恢复是总的：一条写回失败不跳过其余记录。
+*  恢复一次即锁死：晚到的安装与晚到的 handle 落地都被 `restored` 挡住。没有 `ctx.effect`（假件 / 旧 ctx）
+*  时包装照装，只是没有恢复。
 *  **读回判据**：cordis 的 traceable 服务代理每次读函数都会新包一层（`get` 里的 `createShadowMethod`），
 *  所以只能看 own property descriptor 的身份；拿 `service[name]` 读回比身份是必然的假警报。
 */
 function captureAgentHandles(ctx) {
 	let handles = /* @__PURE__ */ new Map();
+	/** 本闭包装上的包装记录：symbol 写入是 best-effort，恢复不能只靠它。 */
+	let ownWrappers;
 	let installed = false;
+	/** 卸载恢复只跑一次；同时是「清理之后不再安装、不再捕获」的闸。 */
+	let restored = false;
+	/**
+	* 卸载恢复：按记录倒序把仍是我们装的方法写回 `restoreTo`，再摘掉仍是本闭包那张表的 symbol 并清空
+	* 句柄表。身份判据挡两件事：别人后装的 wrapper 不被覆盖；别人换过的 symbol 表不被误删。
+	* 恢复必须走完：一条写回失败只跳过那一条，摘 symbol 与清表在 `finally` 里照做。
+	*/
+	const restore = (service) => {
+		if (restored) return;
+		restored = true;
+		const records = ownWrappers ?? service[CAPTURED_AGENT_WRAPPERS] ?? [];
+		try {
+			for (const record of [...records].reverse()) try {
+				if (Object.getOwnPropertyDescriptor(service, record.name)?.value === record.wrapped) service[record.name] = record.restoreTo;
+			} catch {}
+		} finally {
+			try {
+				if (service[CAPTURED_AGENT_HANDLES] === handles) Reflect.deleteProperty(service, CAPTURED_AGENT_HANDLES);
+				if (service[CAPTURED_AGENT_WRAPPERS] === records) Reflect.deleteProperty(service, CAPTURED_AGENT_WRAPPERS);
+			} finally {
+				handles.clear();
+			}
+		}
+	};
 	const install = (candidate) => {
-		if (installed) return;
+		if (installed || restored) return;
 		const service = candidate;
 		if (service === void 0 || service === null) return;
 		const existing = service[CAPTURED_AGENT_HANDLES];
@@ -2182,13 +2237,17 @@ function captureAgentHandles(ctx) {
 			installed = true;
 			return;
 		}
+		const wrappers = [];
 		let wrappedCount = 0;
 		for (const name of ["resume", "create"]) try {
 			const original = service[name];
 			if (typeof original !== "function") continue;
+			const own = Object.getOwnPropertyDescriptor(service, name)?.value;
+			const restoreTo = typeof own === "function" ? own : original;
 			const wrapped = function(...args) {
 				const result = Reflect.apply(original, this, args);
 				result.then((value) => {
+					if (restored) return;
 					const handle = value;
 					const id = handle?.agent?.id;
 					const dispose = handle?.dispose;
@@ -2201,13 +2260,24 @@ function captureAgentHandles(ctx) {
 			};
 			service[name] = wrapped;
 			if (Object.getOwnPropertyDescriptor(service, name)?.value !== wrapped) throw new Error(`agents.${name} is not writable`);
+			wrappers.push({
+				name,
+				original,
+				restoreTo,
+				wrapped
+			});
 			wrappedCount += 1;
 		} catch {}
 		if (wrappedCount === 0) return;
+		ownWrappers = wrappers;
 		try {
 			service[CAPTURED_AGENT_HANDLES] = handles;
+			service[CAPTURED_AGENT_WRAPPERS] = wrappers;
 		} catch {}
 		installed = true;
+		try {
+			ctx.effect?.(() => () => restore(service), "session-delete.agent-handles");
+		} catch {}
 	};
 	const service = ctx.get("agents");
 	if (service !== void 0 && service !== null) install(service);
@@ -2832,6 +2902,111 @@ function applyActions(deps, action, ids) {
 	}
 }
 //#endregion
+//#region src/config.ts
+/**
+* 可调项（Config，ADR-0037）：三只旋钮 + 本地 Standard Schema。
+*
+* 为什么不用 `@deepseek-ai/schemastery` 写 schema：那是宿主包，值 import 会破本仓「跨插件一律
+* `import type`」的硬约束；Cordis 的 Config 接受 Standard Schema（`@standard-schema/spec`），
+* 手写这一小段即可，不需要把宿主 schema 库搬进插件。代价是宿主只为 native Schemastery schema 投影
+* 字段表单，这枚手写的 Standard Schema 不在其列——字段表单由插件设置页的「可调项」卡提供
+* （ADR-0043），profile 的 `cordis.patch.yml` 仍是默认值与覆盖的家。
+*
+* 这里只做**默认值、归一与 schema**，不持有运行期现场：`apply` 归一一次，结果作为
+* `CoreDeps.config` 注入；读方从自己的 deps 读，不 import 模块级单例。
+* 客户端 6 秒撤销时长不在这里：它是浏览器半的产品决定，不跨半传。
+*/
+const DEFAULT_CONFIG = Object.freeze({
+	orphanPreviewLimit: 200,
+	maxAttachmentBytes: 20971520,
+	maxJsonRefBytes: 10485760
+});
+function intField(input, key, range) {
+	const value = input[key];
+	if (value === void 0) return DEFAULT_CONFIG[key];
+	if (typeof value !== "number" || !Number.isInteger(value) || value < range.min || value > range.max) throw new Error(`配置项 ${key} 需为 ${range.min}..${range.max} 的整数`);
+	return value;
+}
+/**
+* 把 patch 里的 `config` 归一成完整配置：缺省取默认值，未知键 / 非整数 / 越界都抛。
+* 抛错会让插件激活失败（响亮），而不是悄悄用半套配置跑。
+*/
+function normalizeConfig(value) {
+	if (value === void 0 || value === null) return DEFAULT_CONFIG;
+	if (typeof value !== "object" || Array.isArray(value)) throw new Error("配置需为对象");
+	const input = value;
+	const known = new Set(Object.keys(CONFIG_LIMITS));
+	for (const key of Object.keys(input)) if (!known.has(key)) throw new Error(`未知配置项：${key}`);
+	return {
+		orphanPreviewLimit: intField(input, "orphanPreviewLimit", CONFIG_LIMITS.orphanPreviewLimit),
+		maxAttachmentBytes: intField(input, "maxAttachmentBytes", CONFIG_LIMITS.maxAttachmentBytes),
+		maxJsonRefBytes: intField(input, "maxJsonRefBytes", CONFIG_LIMITS.maxJsonRefBytes)
+	};
+}
+/**
+* 插件 Config：Cordis 接受 Standard Schema，`~standard.validate` 交回归一后的配置。
+* 宿主在激活前校验；`apply` 再归一一次（同一份事实，不会漂）。
+*/
+const Config = { "~standard": {
+	version: 1,
+	vendor: "dsh-session-delete",
+	validate(value) {
+		try {
+			return { value: normalizeConfig(value) };
+		} catch (error) {
+			return { issues: [{ message: error instanceof Error ? error.message : String(error) }] };
+		}
+	}
+} };
+//#endregion
+//#region src/verbs/config.ts
+/**
+* `/config` 的读/写动词：三只可调项的当前值与写回。
+*
+* 读是免费快照（`apply` 归一后的那一份），写才碰宿主：
+* - 先按 `src/config.ts` 的 `normalizeConfig` 校验（未知键 / 非整数 / 越界回 400，不拿半套值写盘）；
+* - 再走宿主 `configEditor.edit(entry, change)`：完整 raw config 落进 profile 的 patch 层，
+*   由编辑器串行化、校验并让这一行重启（字段不是 volatile，重启是它给的语义）。
+* - `configEditor` / `entry` 缺席（老宿主、嵌套上下文）回 `io` 并在原文里说清替代路径——
+*   不静默假装保存成功。
+*
+* `entry` 由组合根从 `ctx.fiber.entry` 取（见 `src/index.ts`）；本文件不碰 ctx。
+*/
+/** `/config` 的请求体：`null` 或 `{}` 是读；只要带一个键就当写（未知键由 {@link normalizeConfig} 400 拒掉）。
+*  路由表按同一句话定纯度，所以别在别处再写一遍这个判据。 */
+function configPatchOf(body) {
+	if (body === null || Object.keys(body).length === 0) return void 0;
+	return body;
+}
+/** 空体 = 读当前值；带字段 = 写。请求体已经由适配器解析成对象或 null。 */
+function readOrSaveConfig(deps, body) {
+	const patch = configPatchOf(body);
+	if (patch === void 0) return deps.config;
+	return saveConfig(deps, patch);
+}
+async function saveConfig(deps, patch) {
+	let next;
+	try {
+		next = normalizeConfig({
+			...deps.config,
+			...patch
+		});
+	} catch (error) {
+		throw routeError("bad-request", 400, error instanceof Error ? error.message : String(error));
+	}
+	const editor = deps.configEditor;
+	if (editor === void 0 || deps.entry === void 0) throw verbError("io", "这一代宿主不能保存配置；请直接改 profile 的 cordis.patch.yml");
+	try {
+		await editor.edit(deps.entry, (current) => ({
+			...current,
+			...next
+		}));
+	} catch (error) {
+		throw verbError("io", `配置没有保存：${error instanceof Error ? error.message : String(error)}`, error);
+	}
+	return next;
+}
+//#endregion
 //#region src/trash/detail.ts
 /**
 * 回收站**单条详情**：从回收站目录里那条会话自己的日志读出元信息与正文块（用例见 `tests/trash-detail.test.ts`）。
@@ -3599,7 +3774,7 @@ function requireIdArray(body) {
 	return value;
 }
 /**
-* 九个段名各一行。`Record<段名, AnyRouteSpec>` 是闸：`wire.ts` 加了段名而这里没加，编译不过；
+* 十个段名各一行。`Record<段名, AnyRouteSpec>` 是闸：`wire.ts` 加了段名而这里没加，编译不过；
 * 每行的 `slice` 又把该行的 `run` 钉在自己那一格 deps 上（ADR-0032）。
 */
 const ROUTE_TABLE = {
@@ -3621,6 +3796,15 @@ const ROUTE_TABLE = {
 		response: "json",
 		run: async () => "pong"
 	},
+	[ROUTES.config.path]: {
+		slice: "config",
+		method: ROUTES.config.method,
+		body: "json",
+		purity: (body) => configPatchOf(body) === void 0 ? "pure" : "chained",
+		read: "none",
+		response: "json",
+		run: async (deps, body) => readOrSaveConfig(deps, body)
+	},
 	[ROUTES.attachment.path]: {
 		slice: "attachment",
 		method: ROUTES.attachment.method,
@@ -3704,7 +3888,7 @@ function routeOf(rest) {
 /**
 * /dsh-session-delete-api 的分发核心：只负责路由记录的执行。
 *
-* 传输适配器只有 `src/api/connection-route.ts` 一个：九段注册到宿主 `connection.fetch.register`
+* 传输适配器只有 `src/api/connection-route.ts` 一个：十段注册到宿主 `connection.fetch.register`
 * 的 exact Fetch 路由（`Request` / `Response`），Host/Origin/浏览器认证由宿主 `/api` bridge 完成
 * （ADR-0033）。`Request` 的字节闸 / JSON 解析、`Response` 的头与失败信封都归适配器；
 * 这里只收已经解析好的请求，做查表 → 按段注入窄面 → 跑处理 → 回结果。
@@ -3764,7 +3948,7 @@ function removalOf(full) {
 		config: full.config
 	};
 }
-/** 四格只建一次：收窄对象在 dispatcher 构造期固定，请求路径只做引用选择。 */
+/** 五格只建一次：收窄对象在 dispatcher 构造期固定，请求路径只做引用选择。 */
 function slicesOf(full) {
 	const core = coreOf(full);
 	return {
@@ -3774,6 +3958,11 @@ function slicesOf(full) {
 		attachment: {
 			...core,
 			attachments: full.attachments
+		},
+		config: {
+			...core,
+			...full.configEditor === void 0 ? {} : { configEditor: full.configEditor },
+			...full.entry === void 0 ? {} : { entry: full.entry }
 		}
 	};
 }
@@ -3824,7 +4013,7 @@ function createDispatcher(deps) {
 //#endregion
 //#region src/api/connection-route.ts
 /**
-* 现代宿主的 exact Fetch 路由适配器：把九段注册到 `connection.fetch.register`，
+* 现代宿主的 exact Fetch 路由适配器：把十段注册到 `connection.fetch.register`，
 * 由宿主 `/api` bridge 做 Host/Origin/浏览器认证（ADR-0033）。
 *
 * 为什么路径必须带 `/api`：宿主 `assertFetchRoute` 用 `endpointFromPath('/api', path)` 校验，
@@ -3963,7 +4152,7 @@ function toResponse(result) {
 	});
 }
 /**
-* 注册九段 exact Fetch 路由。返回一个组合 disposer；调用方把它挂在自己的 effect 上。
+* 注册十段 exact Fetch 路由。返回一个组合 disposer；调用方把它挂在自己的 effect 上。
 * `connection` 是插件的硬依赖（web UI / 桌面端都装 `client-connection`）；`fetch.register`
 * 缺席属于宿主形状漂移，直接抛——静默返回空 disposer 会让插件「在但没有入口」。
 * `dispatch` 与分发器同源。
@@ -4007,64 +4196,6 @@ function registerConnectionRoutes(service, dispatch) {
 	return disposeAll;
 }
 //#endregion
-//#region src/config.ts
-const DEFAULT_CONFIG = Object.freeze({
-	orphanPreviewLimit: 200,
-	maxAttachmentBytes: 20971520,
-	maxJsonRefBytes: 10485760
-});
-const LIMITS = {
-	orphanPreviewLimit: {
-		min: 1,
-		max: 1e4
-	},
-	maxAttachmentBytes: {
-		min: 1,
-		max: 209715200
-	},
-	maxJsonRefBytes: {
-		min: 1,
-		max: 104857600
-	}
-};
-function intField(input, key, range) {
-	const value = input[key];
-	if (value === void 0) return DEFAULT_CONFIG[key];
-	if (typeof value !== "number" || !Number.isInteger(value) || value < range.min || value > range.max) throw new Error(`配置项 ${key} 需为 ${range.min}..${range.max} 的整数`);
-	return value;
-}
-/**
-* 把 patch 里的 `config` 归一成完整配置：缺省取默认值，未知键 / 非整数 / 越界都抛。
-* 抛错会让插件激活失败（响亮），而不是悄悄用半套配置跑。
-*/
-function normalizeConfig(value) {
-	if (value === void 0 || value === null) return DEFAULT_CONFIG;
-	if (typeof value !== "object" || Array.isArray(value)) throw new Error("配置需为对象");
-	const input = value;
-	const known = new Set(Object.keys(LIMITS));
-	for (const key of Object.keys(input)) if (!known.has(key)) throw new Error(`未知配置项：${key}`);
-	return {
-		orphanPreviewLimit: intField(input, "orphanPreviewLimit", LIMITS.orphanPreviewLimit),
-		maxAttachmentBytes: intField(input, "maxAttachmentBytes", LIMITS.maxAttachmentBytes),
-		maxJsonRefBytes: intField(input, "maxJsonRefBytes", LIMITS.maxJsonRefBytes)
-	};
-}
-/**
-* 插件 Config：Cordis 接受 Standard Schema，`~standard.validate` 交回归一后的配置。
-* 宿主在激活前校验；`apply` 再归一一次（同一份事实，不会漂）。
-*/
-const Config = { "~standard": {
-	version: 1,
-	vendor: "dsh-session-delete",
-	validate(value) {
-		try {
-			return { value: normalizeConfig(value) };
-		} catch (error) {
-			return { issues: [{ message: error instanceof Error ? error.message : String(error) }] };
-		}
-	}
-} };
-//#endregion
 //#region src/ports/home.ts
 /**
 * 宿主数据根。官方解析器在 asar `dsh/node_modules/@deepseek-ai/dsh-home-paths/lib/index.js`：
@@ -4330,7 +4461,7 @@ const name = "@xrn1997/dsh-session-delete";
 * - `agents`：只给 handle 捕获用（`ctx.get('agents')`；缺席时 `ctx.inject(['agents'])` 等服务就绪再装）。
 *   它同样可能晚于本插件激活，写进插件 inject 只会让整个插件 pending。
 *
-* `connection` 是浏览器半取数通道的唯一承载者：九段注册到 `connection.fetch.register` 的
+* `connection` 是浏览器半取数通道的唯一承载者：十段注册到 `connection.fetch.register` 的
 * `/api/dsh-session-delete-api/*`，Host/Origin/浏览器认证由宿主 `/api` bridge 完成（ADR-0033）。
 * 支持面是 web UI 与桌面端，二者的标准组合都装 `client-connection`；服务缺席时插件停在 pending
 * ——可见的激活失败，而不是静默地没有入口。`webServer` 不再直接使用：exact route 仍由宿主的
@@ -4358,6 +4489,8 @@ function apply(ctx, rawConfig) {
 	const home = resolveHome();
 	const rawManifest = createHostStorageManifest(ctx);
 	const host = createHostPort(ctx);
+	const configEditor = ctx.get("configEditor");
+	const entry = ctx.fiber?.entry;
 	const deps = {
 		fs,
 		host,
@@ -4366,7 +4499,9 @@ function apply(ctx, rawConfig) {
 		presence: createMemberPresence(host),
 		config,
 		attachments: createAttachmentsPort(ctx),
-		now: () => Date.now()
+		now: () => Date.now(),
+		...configEditor === void 0 ? {} : { configEditor },
+		...entry === void 0 ? {} : { entry }
 	};
 	const connection = ctx.get("connection");
 	if (connection === void 0) throw new Error("session-delete: connection 服务缺席");

package/lib/types/api/connection-route.d.ts

@@ -15,7 +15,7 @@ export interface ConnectionFetchServiceLike {
     };
 }
 /**
- * 注册九段 exact Fetch 路由。返回一个组合 disposer；调用方把它挂在自己的 effect 上。
+ * 注册十段 exact Fetch 路由。返回一个组合 disposer；调用方把它挂在自己的 effect 上。
  * `connection` 是插件的硬依赖（web UI / 桌面端都装 `client-connection`）；`fetch.register`
  * 缺席属于宿主形状漂移，直接抛——静默返回空 disposer 会让插件「在但没有入口」。
  * `dispatch` 与分发器同源。

package/lib/types/api/dispatch.d.ts

@@ -18,7 +18,7 @@ export type ApiResult = {
 };
 /** 段名的 404 与方法的 405 只在这里判一次；空段名按插件前缀显示，避免 404 原文出现一个空串。 */
 export declare function resolveRoute(method: string, rest: string): RouteSpec;
-/** 四格只建一次：收窄对象在 dispatcher 构造期固定，请求路径只做引用选择。 */
+/** 五格只建一次：收窄对象在 dispatcher 构造期固定，请求路径只做引用选择。 */
 export declare function slicesOf(full: DeleteDeps): SliceDeps;
 /** 分发函数：查段 → 方法闸 → 读面 → 处理。 */
 export type Dispatch = (input: ApiInput) => Promise<ApiResult>;

package/lib/types/api/route-table.d.ts

@@ -12,7 +12,7 @@
  * 这张表只回答“怎么处理”。
  */
 import { type ApplyAction, type RouteName } from '../shared/wire.js';
-import type { CoreDeps, DeleteDeps, RemovalDeps } from '../deps.js';
+import type { ConfigEditorLike, CoreDeps, DeleteDeps, RemovalDeps } from '../deps.js';
 import type { AttachmentsPort } from '../ports/attachments-port.js';
 import type { TrashEntry } from '../trash/entry.js';
 /** 请求体：`json` 才读下来（GET 一律不读；读两遍会把流消费掉）。 */
@@ -35,9 +35,10 @@ export interface RouteRead {
     rows(): Promise<readonly TrashEntry[]>;
 }
 /** deps 切片（ADR-0032）：每一段只声明自己要的那一面。读与探测五段拿基础面，`attachment` 段另多一条
- *  宿主 `attachments` 读面，两个删盘段多删除能力，`/apply` 是唯一拿全量面的行——段的 run 里长出超面
- *  调用就是编译错，dispatch 也只按这一格注入（运行期收窄住 `src/api/dispatch.ts` 的 `slicesOf`）。 */
-export type RouteSlice = 'core' | 'removal' | 'full' | 'attachment';
+ *  宿主 `attachments` 读面，两个删盘段多删除能力，`/apply` 是唯一拿全量面的行，`/config` 只多
+ *  configEditor + entry 两件（段的 run 里长出超面调用就是编译错；dispatch 也只按这一格注入，
+ *  运行期收窄住 `src/api/dispatch.ts` 的 `slicesOf`）。 */
+export type RouteSlice = 'core' | 'removal' | 'full' | 'attachment' | 'config';
 /** 切片名 → 依赖面：{@link RouteSpec.run} 的 deps 参数类型与 `depsFor` 的返回类型都从这一格取。 */
 export type SliceDeps = {
     core: CoreDeps;
@@ -46,6 +47,10 @@ export type SliceDeps = {
     attachment: CoreDeps & {
         readonly attachments: AttachmentsPort;
     };
+    config: CoreDeps & {
+        readonly configEditor?: ConfigEditorLike;
+        readonly entry?: unknown;
+    };
 };
 interface BaseRouteSpec<S extends RouteSlice> {
     /** 这一行吃哪一格 deps：dispatch 按它注入，`run` 的 deps 参数类型也跟着它走。 */
@@ -58,7 +63,7 @@ interface BaseRouteSpec<S extends RouteSlice> {
      *  缺省不设闸——JSON 响应跨源读不到（没有 CORS），不需要它。 */
     readonly fetchGate?: 'same-origin';
 }
-/** JSON 段：处理函数拿请求体与读面；`query` 不在这里（九行里只有二进制段需要查询串）。 */
+/** JSON 段：处理函数拿请求体与读面；`query` 不在这里（十行里只有二进制段需要查询串）。 */
 export interface JsonRouteSpec<S extends RouteSlice = RouteSlice> extends BaseRouteSpec<S> {
     readonly response: 'json';
     /** 声明成函数属性而不是方法：方法签名是双变的，显式标注更宽的 deps 能绕过切片闸；属性按逆变校验。 */
@@ -70,13 +75,13 @@ export interface BinaryRouteSpec<S extends RouteSlice = RouteSlice> extends Base
     readonly run: (deps: SliceDeps[S], query: URLSearchParams) => Promise<BinaryResponse>;
 }
 export type RouteSpec<S extends RouteSlice = RouteSlice> = JsonRouteSpec<S> | BinaryRouteSpec<S>;
-/** 九行的并集（表的值类型）：每行由自己的 `slice` 与 `response` 字面量定型，`run` 的 deps 面随之收窄。 */
+/** 十行的并集（表的值类型）：每行由自己的 `slice` 与 `response` 字面量定型，`run` 的 deps 面随之收窄。 */
 export type AnyRouteSpec = {
     [S in RouteSlice]: RouteSpec<S>;
 }[RouteSlice];
 export declare const APPLY_ACTIONS: readonly ApplyAction[];
 /**
- * 九个段名各一行。`Record<段名, AnyRouteSpec>` 是闸：`wire.ts` 加了段名而这里没加，编译不过；
+ * 十个段名各一行。`Record<段名, AnyRouteSpec>` 是闸：`wire.ts` 加了段名而这里没加，编译不过；
  * 每行的 `slice` 又把该行的 `run` 钉在自己那一格 deps 上（ADR-0032）。
  */
 export declare const ROUTE_TABLE: Record<RouteName, AnyRouteSpec>;

package/lib/types/client/config-settings.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement } from 'react';
+import { type Translate } from './copy.js';
+import type { ConfigDeps } from './remote.js';
+export interface ConfigSettingsProps {
+    /** 整套 remote 的切片；测试可以只给维护那四件（缺这两件时本卡不渲染）。 */
+    readonly deps: Partial<ConfigDeps>;
+    readonly t?: Translate;
+}
+/**
+ * 卡片入口：两个方法都在才渲染。`useMaintenance` 与 `MaintenanceSettings` 的测试替身只造维护四件，
+ * 所以在那些用例里本卡整体缺席——不让"没给配置 deps"变成一次假渲染。
+ */
+export declare function ConfigSettings({ deps, t }: ConfigSettingsProps): ReactElement | null;

package/lib/types/client/context.d.ts

@@ -26,6 +26,9 @@ export interface ClientContextLike {
     slots: SlotsLike;
     /** 可选服务的读面（宿主自己的写法：`ctx.get('…')?.…`）。**缺省调用**：老宿主上没有这个方法。 */
     get?(name: string): unknown;
+    /** 可选服务迟到时的安装面（`ctx.inject(['…'], child => …)`）：服务就绪才回调，缺席就一直等。
+     *  **缺省调用**：老宿主上没有这个方法。 */
+    inject?(deps: readonly string[], callback: (child: ClientContextLike) => unknown): unknown;
     /** 挂一个随本插件卸载而撤销的副作用（返回的清理函数由框架接管）。
      *  属性声明：测试会把它当成员读（`expect(ctx.effect).not.toHaveBeenCalled()`），实现不读 `this`。 */
     effect: (execute: () => unknown, label?: string) => unknown;

package/lib/types/client/copy.d.ts

@@ -25,6 +25,7 @@ declare const ZH: {
     readonly 'trash.empty.hint': "在会话条目的「…」菜单里选「删除」，会话会先进到这里，随时可以恢复。";
     readonly 'trash.summary': "{count} 个会话 · 可释放 {size}";
     readonly 'trash.group.count': "{count} 个会话";
+    readonly 'trash.group.ungrouped': "未分组";
     readonly 'trash.project.unknown': "未记录项目";
     readonly 'trash.row.deletedNow': "刚刚删除";
     readonly 'trash.row.deletedAgo': "删除于 {n}{unit}前";
@@ -37,7 +38,8 @@ declare const ZH: {
     readonly 'trash.unit.months': "个月";
     readonly 'trash.unit.years': "年";
     readonly 'trash.row.restore': "恢复";
-    readonly 'trash.row.purge': "彻底删除…";
+    readonly 'trash.row.purge': "彻底删除";
+    readonly 'trash.row.purgeOne': "彻底删除「{title}」";
     readonly 'trash.footer.note': "回收站本体在宿主数据根下的 {dir} 里，不自动过期；清空后不可恢复。";
     readonly 'trash.emptyAll': "清空回收站…";
     readonly 'trash.confirm.all': "清空回收站？";
@@ -77,6 +79,22 @@ declare const ZH: {
     readonly 'trash.attachments.skipped': "附件未清理：{reason}";
     readonly 'trash.attachments.skippedPartial': "部分附件未清理：{reason}（已清理 {removed} 个）";
     readonly 'trash.attachments.alsoFailed': "；另有 {count} 个附件删除失败";
+    readonly 'config.title': "可调项";
+    readonly 'config.hint': "保存后插件会重启；本页用保存回执回填，重开本页会重新读取。也可以直接改 profile 的 cordis.patch.yml。";
+    readonly 'config.orphanPreviewLimit': "孤儿附件预览条数";
+    readonly 'config.maxAttachmentBytes': "附件单次响应上限";
+    readonly 'config.maxJsonRefBytes': "附件引用扫描的单 JSON 上限";
+    readonly 'config.unit.items': "条";
+    readonly 'config.unit.bytes': "字节";
+    readonly 'config.loading': "正在读当前值…";
+    readonly 'config.loadFailed': "读取失败：{message}";
+    readonly 'config.save': "保存";
+    readonly 'config.saving': "保存中…";
+    readonly 'config.saved': "已保存；插件正在重启。";
+    readonly 'config.saveFailed': "保存失败：{message}";
+    readonly 'config.retry': "重试";
+    readonly 'config.invalid': "需为 {min}–{max} 的整数";
+    readonly 'config.unchanged': "没有改动";
     readonly 'maintenance.title': "维护";
     readonly 'maintenance.orphans.title': "孤儿会话";
     readonly 'maintenance.orphans.hint': "父会话已不在会话列表或回收站里的子会话。检查只读，不会自动运行。";
@@ -105,8 +123,6 @@ declare const ZH: {
     readonly 'detail.noBody': "这条会话没有可显示的内容";
     readonly 'detail.field.created': "创建";
     readonly 'detail.field.lastActivity': "最后活动";
-    readonly 'detail.field.deletedAt': "删除于";
-    readonly 'detail.deletedAt.combined': "{relative}（{absolute}）";
     readonly 'detail.field.span': "活跃跨度";
     readonly 'detail.field.size': "大小";
     readonly 'detail.field.turns': "轮数";
@@ -138,8 +154,16 @@ declare const ZH: {
     readonly 'detail.block.truncated': "已截断";
     readonly 'detail.loadOlder': "加载更早";
     readonly 'detail.loadOlder.loading': "正在加载更早…";
-    readonly 'detail.expandAll': "全部展开";
-    readonly 'detail.collapseAll': "全部折叠";
+    readonly 'detail.viewMode.label': "工作步骤展示";
+    readonly 'detail.viewMode.compact': "简洁";
+    readonly 'detail.viewMode.standard': "标准";
+    readonly 'detail.viewMode.detailed': "详细";
+    readonly 'detail.viewMode.verbose': "完全展开";
+    readonly 'detail.compact.empty': "这段会话只有过程内容；切到「标准」可以看到。";
+    readonly 'detail.compact.pageOnly': "这一页只有过程内容；点「加载更早」继续往前看。";
+    readonly 'detail.process.header': "工作步骤";
+    readonly 'detail.process.step': "{n} 步";
+    readonly 'detail.process.steps': "{n} 步";
     readonly 'detail.injection.runtimeContext': "运行上下文";
     readonly 'detail.injection.timeContext': "时间上下文";
     readonly 'detail.injection.agentInstructions': "Agent 指令";
@@ -162,7 +186,8 @@ declare const ZH: {
     readonly 'detail.attachment.saving': "保存中…";
     readonly 'detail.attachment.saveFailed': "保存失败：{message}";
     readonly 'detail.back': "← 返回清单";
-    readonly 'detail.subagents.header': "子会话（{n}） · {size}";
+    readonly 'detail.subagents.header': "子会话（{n}） · {size}，随本条一起恢复或删除";
+    readonly 'detail.subagents.open': "查看子会话详情";
     readonly 'detail.subagents.truncated': "仅列出前 {shown} 条，共 {total} 条";
     readonly 'detail.backToParent': "← 返回父会话";
     readonly 'detail.list.label': "回收站清单";
@@ -240,12 +265,14 @@ export declare function localeProbe(t: Translate): string;
  */
 export declare function splitOn(sentence: string, inner: string): [string, string, string];
 /**
- * 绝对时间那一句串。清单行的 `title`、确认框里的meta、详情的元信息三处要的是同一个写法，
+ * 绝对时间那一句串。清单行的 `title`、确认框里的meta、详情的会话信息三处要的是同一个写法，
  * 各自 `new Date(...).toLocaleString()` 一遍迟早会漂成两种样子。
  */
 export declare function absoluteText(at: number): string;
 /** 单位词本身（调用方把它填进各自语言的整句模板里，语序由各语言自己钉）。 */
 export declare function unitWord(unit: RelativeTimeUnit, t: Translate): string;
+/** 「工作步骤 N 步」：英文 n=1 要单数、中文两条同形；选哪条键只住这里，调用方只报数。 */
+export declare function stepsText(n: number, t: Translate): string;
 /** 「7分钟前」这类**不带谓语**的相对短语；`now` 桶不套模板——"刚刚前"不是话。 */
 export declare function agoText(at: number, now: number, t: Translate): string;
 export {};