Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

:loud_sound: Log local kernel request failures for desktop diagnostics

Danielaaa022cdc8d6
diff --git a/app/electron/kernelRequestLog.js b/app/electron/kernelRequestLog.js
new file mode 100644
index 0000000000..e6650cffc4
--- /dev/null
+++ b/app/electron/kernelRequestLog.js
@@ -0,0 +1,69 @@
+const installedSessions = new WeakSet();
+
+// 只记录接口名或资源类别,不记录文档、附件名称、查询参数及请求内容。
+const getRequestPath = (pathname) => {
+ if (/^\/api\/(?:[A-Za-z]+\/)?[A-Za-z]+$/.test(pathname) || pathname === "/ws") {
+ return pathname;
+ }
+ for (const prefix of ["/api/", "/assets/", "/stage/", "/appearance/", "/plugins/"]) {
+ if (pathname.startsWith(prefix)) {
+ return prefix + "[resource]";
+ }
+ }
+ return "/[resource]";
+};
+
+const installKernelRequestLog = (session, {getTarget, writeLog, now = Date.now}) => {
+ if (installedSessions.has(session)) {
+ return;
+ }
+ installedSessions.add(session);
+ let intervalStart = now();
+ let count = 0;
+ const logFailure = (details) => {
+ const target = getTarget(details.webContentsId);
+ if (target?.mode !== "local" || details.error === "net::ERR_ABORTED") {
+ return;
+ }
+ let url;
+ try {
+ url = new URL(details.url);
+ // WebSocket 握手与 HTTP 请求按同一个内核地址归属。
+ if (url.protocol === "ws:") url.protocol = "http:";
+ if (url.protocol === "wss:") url.protocol = "https:";
+ if (url.origin !== target.origin) return;
+ } catch (error) {
+ return;
+ }
+ // 限制集中失败时的日志量,避免资源加载失败淹没启动与退出记录。
+ const time = now();
+ if (time - intervalStart >= 30000) {
+ intervalStart = time;
+ count = 0;
+ }
+ count++;
+ if (count > 30) {
+ if (count === 31) {
+ writeLog("local kernel request failures suppressed until the next 30-second interval");
+ }
+ return;
+ }
+ writeLog("local kernel request failed " + JSON.stringify({
+ webContentsId: details.webContentsId,
+ port: url.port,
+ method: details.method,
+ path: getRequestPath(url.pathname),
+ resourceType: details.resourceType,
+ error: details.error,
+ statusCode: details.statusCode,
+ }));
+ };
+ session.webRequest.onErrorOccurred(logFailure);
+ session.webRequest.onCompleted((details) => {
+ if (details.statusCode >= 400) {
+ logFailure(details);
+ }
+ });
+};
+
+module.exports = {installKernelRequestLog};
diff --git a/app/electron/kernelRequestLog.test.js b/app/electron/kernelRequestLog.test.js
new file mode 100644
index 0000000000..8f62e4ad6a
--- /dev/null
+++ b/app/electron/kernelRequestLog.test.js
@@ -0,0 +1,93 @@
+const assert = require("node:assert/strict");
+const {test} = require("node:test");
+const {installKernelRequestLog} = require("./kernelRequestLog");
+
+const setup = () => {
+ const listeners = {};
+ const logs = [];
+ const targets = new Map([
+ [1, {mode: "local", origin: "https://127.0.0.1:6806"}],
+ [2, {mode: "local", origin: "http://127.0.0.1:6807"}],
+ [3, {mode: "remote", origin: "https://remote.example"}],
+ ]);
+ const session = {webRequest: {
+ onErrorOccurred: callback => { assert.equal(listeners.error, undefined); listeners.error = callback; },
+ onCompleted: callback => { assert.equal(listeners.completed, undefined); listeners.completed = callback; },
+ }};
+ let time = 0;
+ const options = {getTarget: id => targets.get(id), writeLog: message => logs.push(message), now: () => time};
+ installKernelRequestLog(session, options);
+ const request = {webContentsId: 1, url: "https://127.0.0.1:6806/api/transactions?token=secret",
+ method: "POST", resourceType: "xhr", error: "net::ERR_CERT_DATABASE_CHANGED"};
+ return {listeners, logs, targets, session, options, request, advance: ms => { time += ms; }};
+};
+
+test("logs native local API failures without request contents or credentials", () => {
+ const {listeners, logs, request} = setup();
+ listeners.error({...request, uploadData: [{bytes: "private document"}],
+ requestHeaders: {Authorization: "secret"}, referrer: "private"});
+ const data = JSON.parse(logs[0].slice("local kernel request failed ".length));
+ assert.deepEqual(data, {webContentsId: 1, port: "6806", method: "POST", path: "/api/transactions",
+ resourceType: "xhr", error: "net::ERR_CERT_DATABASE_CHANGED"});
+});
+
+test("only observes requests to the sending window's local kernel", () => {
+ const {listeners, logs, request, targets} = setup();
+ for (const override of [{webContentsId: 99}, {webContentsId: 3, url: "https://remote.example/api/transactions"},
+ {url: "https://127.0.0.1:6807/api/transactions"}, {url: "https://external.example/image"},
+ {url: "invalid"}, {error: "net::ERR_ABORTED"}]) {
+ listeners.error({...request, ...override});
+ }
+ assert.equal(logs.length, 0);
+ listeners.error({...request, webContentsId: 2, url: "http://127.0.0.1:6807/api/filetree/getDoc"});
+ assert.equal(logs.length, 1);
+ targets.delete(2);
+ listeners.error({...request, webContentsId: 2, url: "http://127.0.0.1:6807/api/filetree/getDoc"});
+ assert.equal(logs.length, 1);
+});
+
+test("records failed WebSocket handshakes for HTTPS and HTTP kernels", () => {
+ const {listeners, logs, request} = setup();
+ listeners.error({...request, url: "wss://127.0.0.1:6806/ws?app=secret&id=private", resourceType: "webSocket"});
+ listeners.error({...request, webContentsId: 2, url: "ws://127.0.0.1:6807/ws?app=secret", resourceType: "webSocket"});
+ assert.equal(logs.length, 2);
+ for (const log of logs) {
+ assert.ok(log.includes('"path":"/ws"'));
+ assert.ok(!log.includes("secret"));
+ }
+});
+
+test("redacts resource names and keeps only static API routes", () => {
+ const {listeners, logs, request} = setup();
+ for (const path of ["/assets/private-document.png", "/stage/private.js", "/appearance/private.css",
+ "/plugins/private-plugin/index.js", "/api/file/123456-private", "/private-document"]) {
+ listeners.error({...request, url: "https://127.0.0.1:6806" + path});
+ }
+ assert.equal(logs.length, 6);
+ assert.ok(logs.every(log => log.includes("[resource]") && !log.includes("private")));
+});
+
+test("records HTTP errors but leaves successful responses unlogged", () => {
+ const {listeners, logs, request} = setup();
+ for (const statusCode of [200, 202, 204, 304, 401, 403, 404, 500]) {
+ listeners.completed({...request, error: undefined, statusCode});
+ }
+ assert.equal(logs.length, 4);
+ assert.ok(logs[3].includes('"statusCode":500'));
+});
+
+test("bounds failure bursts and resumes logging in the next interval", () => {
+ const {listeners, logs, request, advance} = setup();
+ for (let i = 0; i < 100; i++) listeners.error(request);
+ assert.equal(logs.length, 31);
+ assert.ok(logs[30].includes("suppressed"));
+ advance(30000);
+ listeners.error(request);
+ assert.equal(logs.length, 32);
+ assert.ok(logs[31].includes("ERR_CERT_DATABASE_CHANGED"));
+});
+
+test("installs session listeners once without replacing them for another window", () => {
+ const {session, options} = setup();
+ installKernelRequestLog(session, options);
+});
diff --git a/app/electron/main.js b/app/electron/main.js
index ecd00a61c8..7954720dff 100644
--- a/app/electron/main.js
+++ b/app/electron/main.js
@@ -44,6 +44,7 @@ const gNet = require("net");
const childProcess = require("child_process");
const remote = require("@electron/remote/main");
const {probeRemoteKernelAuthentication} = require("./remoteKernelAuth");
+const {installKernelRequestLog} = require("./kernelRequestLog");
const {saveRemoteExport} = require("./remoteExport");
const remoteExportSenders = new WeakSet();
const {createConnectionManager, getRemoteSession} = require("./connectionManager");
@@ -2983,6 +2984,7 @@ app.whenReady().then(() => {
});
// 前端菜单同步完成前也保留原生编辑操作,避免复制、粘贴依赖界面初始化成功。
setStartupApplicationMenu();
+ installKernelRequestLog(session.defaultSession, {getTarget: getWindowKernelTarget, writeLog});
// 仅本进程启动的本地内核允许自签名证书,远程内核始终使用系统信任链。
session.defaultSession.setCertificateVerifyProc((request, callback) => {
const kernelMode = remoteKernelTarget ? "remote" : "local";