lume-dsh-plugin 0.7.1 → 0.7.3

package/README.md

@@ -307,7 +307,7 @@ Lume 因此选择「观察 + 重锚」：压缩发生时记录规模，在随后
 
 ## 宿主兼容性
 
-- **RPC 通道必须注册在注入了 `webServer` 的作用域里**：宿主的 `connection.rpc.handle` 内部会以**调用方**的 ctx 执行 `webServer.register(route)`，所以正确写法只有 `ctx.inject(["webServer"], (webCtx) => webCtx.connection.rpc.handle(...))`（宿主自带的 `dsh-ppt`、`dsh-api-gateway` 同款）。0.7.1 起已修正；**0.6.2 / 0.7.0 在 DSH Desktop 0.9.1 上会导致 DSH 无法启动**（`cannot get property "webServer" without inject` → 插件树加载失败 → 进 safe mode），请升级。没有 web 载体的宿主只失去 RPC 通道，其余功能照常。
+- **RPC 通道必须注册在注入了 `webServer` 的作用域里，且不能包 `effect`**：宿主的 `connection.rpc.handle` 内部以**调用方 ctx** 执行 `webServer.register(route)`（`register(owner, ...)` 里是 `owner.effect(() => owner.webServer.register(route))`）。而 cordis 的 `effect` 会另起一个 **fiber**，**注入授权不随子 fiber 继承**——所以 `webCtx.effect(() => webCtx.connection.rpc.handle(...))` 仍然越权抛错（0.7.1 就栽在这），必须像宿主自带的 `dsh-ppt` 那样**直接在 inject 回调里调用**。该注册还被挪到 `apply` 末尾并加独立 try/catch：它只服务客户端菜单，失败绝不该影响人设注入与工具。0.6.2 / 0.7.0 / 0.7.1 在 DSH Desktop 0.9.1 上的故障（DSH 起不来、或界面人设菜单空白）都源于此，请升级到 ≥0.7.2。
 - **插件不会拖垮宿主**：`apply()` 外层有兜底 try/catch，插件内部的任何异常都降级为「部分功能不可用 + `logger.error`」，不再阻断 DSH 启动。
 - **peer 声明只留宿主运行时保证提供的包**：`@deepseek-ai/dsh-client-ui-primitives` 这类前端包由宿主模块图在运行时提供，**不声明为 peer**——新版桌面安装器做严格 peer 闭包校验，声明它会连带检查它自己的 peer（`dsh-client-runtime`），导致安装/更新被拒绝（desktop 会写进 `.generations-deferred.json` 并冻结整个 profile 迁移）。它仍在 `devDependencies`（tsc 类型与 tsdown external 需要）。
 

package/lib/host/rpc-bridge.js

@@ -0,0 +1,122 @@
+/**
+ * Connection RPC 的**桥接协议**实现（纯函数 + 一个路由工厂）。
+ *
+ * 为什么需要它：宿主 `connection.rpc.handle(channel, handler)` 内部要求
+ * 「频道注册属于**调用方 fiber**」（见 dsh-client-connection 的 `register(owner, …)` →
+ * `owner.effect(() => owner.webServer.register(route))`），在 DSH Desktop 0.9.1 上我们的
+ * 入口 fiber 解析不到 `webServer` → 抛 `cannot get property "webServer" without inject`。
+ * 于是准备一条**不依赖 connection.rpc 的回退路径**：照宿主自己的写法把 HTTP 路由挂到
+ * `webServer` 上（宿主自带的 dsh-ppt 就是这么做的），报文与客户端 `conn.rpc.call` 完全一致：
+ *
+ *   请求  POST {channel}/{endpoint}   content-type: application/json
+ *         { type: "client-request", rpcId, method: endpoint, payload }
+ *   响应  200 { type: "server-response", rpcId, result: { ok, value|error } }
+ *
+ * 纯函数部分（解析/组装）可单测，路由工厂只做 Node req/res 的胶水。
+ */
+/** 端点段白名单，与宿主 ENDPOINT_SEGMENT_PATTERN 一致。 */
+const ENDPOINT_SEGMENT_PATTERN = /^[A-Za-z0-9_$.-]+$/;
+/** 组装一条回信（含 rpcId 与错误信封补全）。 */
+export function connectionResponse(rpcId, result) {
+    return JSON.stringify({ type: "server-response", rpcId, result: withErrorDetails(result) });
+}
+/**
+ * 补全错误信封：客户端的 `parseConnectionResponse` 要求失败时
+ * `error.details` 是对象，缺失会直接抛 "invalid server-response failure"。
+ * （这是 0.7.2 之前一直存在的隐患：任何错误路径都会让客户端调用炸掉。）
+ */
+export function withErrorDetails(result) {
+    const envelope = result;
+    if (!envelope || typeof envelope !== "object" || envelope.ok !== false)
+        return result;
+    const error = envelope.error ?? {};
+    return {
+        ok: false,
+        error: {
+            code: typeof error.code === "string" ? error.code : "bad-request",
+            message: typeof error.message === "string" ? error.message : "unknown error",
+            details: error.details && typeof error.details === "object" ? error.details : {},
+        },
+    };
+}
+/** 解析客户端请求。与宿主的 rpcFetchHandler 语义对齐（404/415/400 + 信封校验）。 */
+export function parseClientRequest(channel, request) {
+    if ((request.method ?? "GET").toUpperCase() !== "POST")
+        return { kind: "respond", status: 404, body: "not found", contentType: "text/plain" };
+    const pathname = (request.url ?? "/").split("?")[0] ?? "/";
+    if (!pathname.startsWith(`${channel}/`))
+        return { kind: "respond", status: 404, body: "not found", contentType: "text/plain" };
+    const endpoint = pathname.slice(channel.length + 1);
+    if (endpoint.split("/").some((segment) => segment === "" || segment === "." || segment === ".." || !ENDPOINT_SEGMENT_PATTERN.test(segment))) {
+        return { kind: "respond", status: 404, body: "not found", contentType: "text/plain" };
+    }
+    const mime = (request.contentType ?? "").split(";")[0]?.trim().toLowerCase();
+    if (mime !== "application/json")
+        return { kind: "respond", status: 415, body: "content type must be application/json", contentType: "text/plain" };
+    let body;
+    try {
+        body = JSON.parse(request.rawBody);
+    }
+    catch {
+        return { kind: "respond", status: 400, body: "body is not JSON", contentType: "text/plain" };
+    }
+    const envelope = body;
+    if (!envelope || typeof envelope !== "object" || envelope.type !== "client-request" || typeof envelope.rpcId !== "string" || typeof envelope.method !== "string") {
+        const rpcId = typeof envelope?.rpcId === "string" ? String(envelope.rpcId) : "invalid-request";
+        return { kind: "respond", status: 200, body: connectionResponse(rpcId, { ok: false, error: { code: "gateway/bad-request", message: "invalid client-request message" } }), contentType: "application/json" };
+    }
+    if (envelope.method !== endpoint) {
+        return { kind: "respond", status: 200, body: connectionResponse(envelope.rpcId, { ok: false, error: { code: "gateway/bad-request", message: `endpoint mismatch: ${envelope.method} vs ${endpoint}` } }), contentType: "application/json" };
+    }
+    return { kind: "dispatch", rpcId: envelope.rpcId, endpoint, payload: envelope.payload };
+}
+/**
+ * 组装可交给 `webServer.register()` 的路由（宿主自带 dsh-ppt 同形：
+ * `{ kind: "prefix", path: channel, handler(req, res) }`）。
+ *
+ * @param channel - RPC 频道（须匹配 /^\/[A-Za-z0-9._~-]+$/，且不得为 /api）
+ * @param dispatch - 业务分发（endpoint + payload → lume 信封）
+ * @param guard - 可选的浏览器信任闸（宿主 connection.requestRejection），返回状态码即拒绝
+ */
+export function makeRpcRoute(channel, dispatch, guard) {
+    return {
+        kind: "prefix",
+        path: channel,
+        handler: async (req, res) => {
+            const rejection = guard?.(req);
+            if (rejection !== undefined) {
+                res.writeHead(rejection);
+                res.end(rejection === 401 ? "unauthorized" : "forbidden");
+                return;
+            }
+            let rawBody = "";
+            try {
+                for await (const chunk of req)
+                    rawBody += typeof chunk === "string" ? chunk : String(chunk);
+            }
+            catch {
+                /* 客户端断开：下面按空 body 处理并回 400 */
+            }
+            const parsed = parseClientRequest(channel, {
+                method: req?.method,
+                url: req?.url,
+                contentType: req?.headers?.["content-type"] ?? null,
+                rawBody,
+            });
+            if (parsed.kind === "respond") {
+                res.writeHead(parsed.status, { "content-type": parsed.contentType });
+                res.end(parsed.body);
+                return;
+            }
+            let result;
+            try {
+                result = await dispatch(parsed.endpoint, parsed.payload);
+            }
+            catch (error) {
+                result = { ok: false, error: { code: "internal", message: String(error?.message ?? error) } };
+            }
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(connectionResponse(parsed.rpcId, result));
+        },
+    };
+}

package/lib/index.js

@@ -21,6 +21,7 @@ import z from "@deepseek-ai/schemastery";
 import { buildPersonaContractSection, buildPersonaRuntimeSection } from "./host/injection.js";
 import { loadPersonalities, NONE_PERSONA } from "./host/personalities.js";
 import { createLumeRpcHandler } from "./host/rpc.js";
+import { makeRpcRoute } from "./host/rpc-bridge.js";
 import { FilePersonaStore, migrateLegacyState, PersonaStore } from "./host/store.js";
 import { IdentityStore, LUME_IDENTITY_SPEC, zodLike } from "./host/identity.js";
 import { PersonaRegistry } from "./host/registry.js";
@@ -1214,24 +1215,9 @@ function applyInner(ctx, config = {}) {
         },
     });
     // ── RPC 通道 ──
-    // 必须在**注入了 webServer 的作用域**里注册：新宿主的 `connection.rpc.handle` 内部会
-    // 用调用方 ctx 执行 `owner.webServer.register(route)`（见 dsh-client-connection 的
-    // `owner.effect(() => owner.webServer.register(route))`），缺注入时 cordis 直接抛
-    // "cannot get property \"webServer\" without inject"。宿主自带的 dsh-ppt / dsh-api-gateway
-    // 也都是 `ctx.inject(["webServer"], (webCtx) => webCtx.connection.rpc.handle(...))` 这个写法。
-    // 用作用域注入而不是把 webServer 塞进顶层 inject：没有 web 载体的宿主（headless）里只
-    // 失去 RPC 通道，插件其余功能照常工作，不会被 inject 卡住。
-    ctx.inject(["webServer"], (webCtx) => {
-        webCtx.effect(() => webCtx.connection.rpc.handle(LUME_CHANNEL, async (endpoint, payload) => {
-            currentStore ??= await storesReady;
-            identity ??= await identityReady;
-            const result = await handleEndpoint(endpoint, payload);
-            if (endpoint !== "list" && endpoint !== "getSessionPersona") {
-                webCtx.logger?.warn?.(`lume: rpc ${endpoint} ${JSON.stringify(payload ?? {})} → ok=${result.ok}${result.ok ? "" : ` code=${result.error.code}`}`);
-            }
-            return result;
-        }, { authority: "trusted-host" }), "lume: rpc channel");
-    });
+    // 挪到 apply 的最后注册：它只服务客户端菜单（人设列表/蒸馏/管理），
+    // 绝不该挡住人设段、工具与易变段的注册（0.7.1 的教训：这里抛错 → 整段 apply 中断 → 界面看不到人设）。
+    // 注册本身见下方 registerRpcChannel()。
     // ── 系统提示词段落 ──
     ctx.effect(() => ctx.systemPrompt.section({
         name: LUME_PERSONA_SECTION,
@@ -1292,4 +1278,70 @@ function applyInner(ctx, config = {}) {
             },
         });
     }, "lume.tool-notice-context()");
+    registerRpcChannel(ctx);
+    /**
+     * 注册客户端 RPC 通道（`/lume`）。放在最后 + 独立 try/catch：
+     * 它只服务客户端菜单，任何失败都不该影响人设注入、工具与易变段。
+     *
+     * 关键细节（0.7.1 踩过）：必须**直接在注入作用域里调用** `connection.rpc.handle`，
+     * 不能包 `effect`——新宿主的实现在 `register(owner, ...)` 里执行
+     * `owner.effect(() => owner.webServer.register(route))`，而 cordis 的 `effect` 会另起
+     * 一个 fiber，**注入授权不随子 fiber 继承**，于是 `owner.webServer` 再次越权并抛
+     * "cannot get property \"webServer\" without inject"。宿主自带的 dsh-ppt 也正是直接在
+     * inject 回调里调用（不包 effect）。没有 web 载体的宿主（headless）只是没有 RPC 通道。
+     */
+    function registerRpcChannel(scope) {
+        const dispatch = async (endpoint, payload) => {
+            currentStore ??= await storesReady;
+            identity ??= await identityReady;
+            return handleEndpoint(endpoint, payload);
+        };
+        // 依赖组合与宿主自带 dsh-api-gateway 一致（["connection", "webServer"]）。
+        scope.inject(["connection", "webServer"], (webCtx) => {
+            const notes = [];
+            try {
+                // ── 主路径：宿主公开 API。频道注册归属**调用方 fiber**，所以必须在注入作用域里调用。
+                webCtx.connection.rpc.handle(LUME_CHANNEL, async (endpoint, payload) => {
+                    const result = await dispatch(endpoint, payload);
+                    if (endpoint !== "list" && endpoint !== "getSessionPersona") {
+                        webCtx.logger?.warn?.(`lume: rpc ${endpoint} → ok=${result.ok}${result.ok ? "" : ` code=${result.error.code}`}`);
+                    }
+                    return result;
+                }, { authority: "trusted-host" });
+                notes.push("connection.rpc.handle");
+            }
+            catch (error) {
+                notes.push(`rpc.handle 失败(${describeError(error)})`);
+                // ── 回退：自己往 webServer 注册 HTTP 路由（宿主自带 dsh-ppt 的写法）。
+                // 报文与客户端 conn.rpc.call 完全一致，见 host/rpc-bridge.ts。
+                try {
+                    const guard = typeof webCtx.connection?.requestRejection === "function"
+                        ? (req) => webCtx.connection.requestRejection(req)
+                        : undefined;
+                    webCtx.webServer.register(makeRpcRoute(LUME_CHANNEL, dispatch, guard));
+                    notes.push("webServer.register(自注册路由)");
+                }
+                catch (fallbackError) {
+                    notes.push(`webServer.register 失败(${describeError(fallbackError)})`);
+                }
+            }
+            // 两条都失败时补上环境形状，便于下一轮定位（宿主 API 变更时这行就是证据）。
+            if (!notes.some((note) => !note.includes("失败"))) {
+                notes.push(`shapes: connection=${typeof webCtx.connection} rpc=${typeof webCtx.connection?.rpc} handle=${typeof webCtx.connection?.rpc?.handle} webServer=${typeof webCtx.webServer} get=${typeof webCtx.get}`);
+            }
+            webCtx.logger?.warn?.(`lume: RPC 通道 ${LUME_CHANNEL} = ${notes.join(" | ")}`);
+        });
+    }
+    /** 把任意抛出物变成可读的一行（宿主 logger 直接打对象会变成 `{}`，所以要自己转字符串）。 */
+    function describeError(error) {
+        if (error instanceof Error)
+            return error.message;
+        try {
+            const text = JSON.stringify(error);
+            return text && text !== "{}" ? text : String(error);
+        }
+        catch {
+            return String(error);
+        }
+    }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lume-dsh-plugin",
   "description": "微光 (Lume) — DSH Desktop 增强插件：给会话装上工程纪律与真实关系。纪律层约束「如何正确完成任务」——意图路由、阶段门控、真实工具证据、交付前复核、文档能力感知；方法层把量化需求、改动台账、假设台账与项目知识变成可检查的产出，并用行为触发器在轨迹上纠偏（撒网不收敛 / 连写不验 / 死路重撞）；人设层塑造「以何种风格表达」——从聊天记录、小说、剧本、设定文档蒸馏具名角色，长期记忆与风格随对话演进。约束按需注入，闲聊不额外付 token。",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {