From 344ccf439ff87b94bb8e324e1536b5bfdb409588 Mon Sep 17 00:00:00 2001 From: QQ Date: Thu, 12 Nov 2026 00:14:47 +0800 Subject: [PATCH] Import vendor/dsh-sansheng-liubu/workbench/host/index.mjs --- .../workbench/host/index.mjs | 230 ++++++++++++++++++ 1 file changed, 230 insertions(+) create mode 100644 vendor/dsh-sansheng-liubu/workbench/host/index.mjs diff --git a/vendor/dsh-sansheng-liubu/workbench/host/index.mjs b/vendor/dsh-sansheng-liubu/workbench/host/index.mjs new file mode 100644 index 0000000..5263d3f --- /dev/null +++ b/vendor/dsh-sansheng-liubu/workbench/host/index.mjs @@ -0,0 +1,230 @@ +// Host 侧装配:把账本、业务服务、会话层和 HTTP 路由接在一起。 +// +// 这一层是唯一知道“账本文件在哪、损坏了怎么办”的地方: +// - 账本损坏(不是 JSON / schemaVersion 不符)时不崩溃:把坏文件改名留存, +// 从空账本启动,并把 warning 交给调用方(index.js / 诊断页)显示。 +// 悄悄删掉或不说话都会让人以为“历史记录丢了”。 +// - 宿主没有 webServer 时照常返回 service,只是路由不注册,registered=false; +// 若宿主稍后提供了 webServer,用 ctx.inject 补注册一次(不重复建 store)。 +// - 宿主没有 sessionController 时,工作台仍能读写账本(投影可用), +// 但派发只落账不投递,UI 显示“尚未接通”,绝不假装成功。 +// +// 与 workbench-host.mjs 的关系:那边是「账本 + 会话层 + 对账」的纯逻辑外壳, +// 这边负责文件、损坏隔离、HTTP 与生命周期,并把路由钩子接到外壳上。 + +import { existsSync, renameSync } from 'node:fs' +import { WorkbenchStore, SCHEMA_VERSION } from '../core/store.mjs' +import { corruptPathFor, ensureSidecarDir, resolveSidecarDir, resolveStorePath } from './paths.mjs' +import { registerWorkbenchRoutes } from './routes.mjs' +import { createWorkbenchHost as createWorkbenchShell } from './workbench-host.mjs' + +export { createWorkbenchService } from './service.mjs' +export { createMemoryStore, MemoryError, MEMORY_FILE_MAX_CHARS, MEMORY_EXCERPT_CHARS } from '../core/memory.mjs' +export { + createWorkbenchHost as createWorkbenchShell, + CONTRACT_ACTIONS, + CONTRACT_ACTION_PREFIX, + describeContract, + parseContractLines, + WORKBENCH_HOST_VERSION, +} from './workbench-host.mjs' +export { + buildRouteTable, + listWorkbenchRoutes, + registerWorkbenchRoutes, + MAX_BODY_BYTES, + ROUTE_PREFIX, +} from './routes.mjs' +export { + SIDECAR_DIR_NAME, + corruptPathFor, + ensureSidecarDir, + quarantineFile, + readJsonSafe, + resolveSidecarDir, + resolveSidecarFile, + resolveStorePath, + writeFileAtomic, + writeJsonAtomic, +} from './paths.mjs' + +/** + * 创建 Host 侧工作台。 + * + * @param {object|null} ctx 宿主上下文(可为 null:服务仍可用,只是没有路由/会话)。 + * @param {object} [options] + * @param {string} [options.file] 账本路径;默认 %DSH_HOME%/sansheng-liubu/workbench.json。 + * @param {object} [options.env] 计算默认路径用的环境变量。 + * @param {() => number} [options.clock] 注入时钟。 + * @param {() => string} [options.random] 注入随机源(测试里固定 ID 用)。 + * @param {boolean} [options.load=true] 是否从磁盘加载既有账本。 + * @param {string} [options.presetId] 部门会话使用的 agentPreset,默认「上朝」。 + * @param {boolean} [options.startReconciler=true] 是否启动周期对账。 + * @param {number} [options.longPollMs] 事件长轮询上限(毫秒)。 + * @param {number} [options.pollIntervalMs] 长轮询内部检查间隔(毫秒)。 + * @returns {object} 见文件末尾 return 语句的字段说明。 + */ +export function createWorkbenchHost(ctx, options = {}) { + const env = options.env ?? process.env + const clock = options.clock ?? Date.now + const file = options.file === undefined ? resolveStorePath(env) : options.file + const warnings = [] + const log = typeof options.log === 'function' ? options.log : () => {} + + // 测试与嵌入场景可以自带账本;自带时不碰磁盘路径,也不做损坏隔离(那是文件的责任)。 + const injectedStore = options.store ?? null + const store = injectedStore ?? new WorkbenchStore({ + file, + clock, + env, + ...(options.random === undefined ? {} : { random: options.random }), + }) + + if (injectedStore === null && options.load !== false && file !== null && file !== '') { + ensureSidecarDir(env) + if (existsSync(file)) { + try { + store.load() + } catch (error) { + // 损坏与版本不符都是“这个文件不能用”:改名留存后从空账本启动。 + // 绝不覆盖原文件——里面可能是用户唯一一份历史。 + const stamp = new Date(clock()).toISOString().replace(/[:.]/g, '-') + let quarantined = corruptPathFor(file, stamp) + try { + renameSync(file, quarantined) + } catch (renameError) { + // 改名失败(被占用/权限不足):不能继续往同一个文件写,退回纯内存账本。 + quarantined = null + warnings.push( + `账本损坏且无法改名留存(${renameError?.code ?? 'UNKNOWN'}):${error?.message ?? ''};本次使用内存账本`, + ) + } + if (quarantined !== null) { + warnings.push( + `账本损坏(${error?.code ?? 'ERROR'}:${error?.message ?? ''}),已改名留存为 ${quarantined},以空账本启动`, + ) + } + } + } + } + + // 外壳持有 store 与 service,并在宿主有能力时装配会话层/派发/对账。 + const shell = createWorkbenchShell(ctx, { + store, + presetId: options.presetId, + startReconciler: options.startReconciler, + clock, + // 成果文件是否还在,由宿主文件系统回答(A23 失效显示);测试可注入替身。 + fileExists: options.fileExists ?? existsSync, + }) + const service = shell.service + + const hooks = routeHooks(shell, service) + let routes = registerWorkbenchRoutes(ctx, service, { ...options, ...hooks }) + let registered = routes.registered !== false + if (!registered) warnings.push(`工作台接口未注册:${routes.reason ?? '宿主未提供 webServer'}`) + + // 宿主稍后才提供 webServer 时补注册一次;cordis 会在依赖出现时回调, + // 插件卸载时随作用域一起清理,不需要手工跟踪。 + if (!registered && ctx !== null && typeof ctx?.inject === 'function') { + try { + ctx.inject(['webServer'], (scoped) => { + if (registered) return + const late = registerWorkbenchRoutes({ webServer: scoped?.webServer }, service, { ...options, ...hooks }) + if (late.registered === false) return + routes = late + registered = true + }) + } catch (error) { + warnings.push(`工作台接口补注册失败:${error?.message ?? error}`) + } + } + + // 会话层也可能晚到:apply 时 sessionController 还没装好,等它出现再挂载一次, + // 这样用户不必为了「接通部门」而多重启一次 DSH。 + if (shell.hasSessions === false && ctx !== null && typeof ctx?.inject === 'function') { + try { + ctx.inject(['sessionController'], (scoped) => { + if (shell.hasSessions === true) return + const controller = scoped?.sessionController ?? scoped?.remote?.session ?? null + if (controller === null) return + if (!shell.attachSessions(controller)) return + log('[sansheng-liubo] 会话层已就绪,部门可以接通与派发') + }) + } catch (error) { + warnings.push(`会话层补挂失败:${error?.message ?? error}`) + } + } + + shell.start() + + const dispose = () => { + try { + routes() + } finally { + shell.dispose() + } + } + + return { + store, + service, + shell, + routes, + get sessions() { + return shell.sessions + }, + get reconciler() { + return shell.reconciler + }, + get dispatchService() { + return shell.dispatchService + }, + get hasSessions() { + return shell.hasSessions + }, + attachSessions: shell.attachSessions, + presetId: shell.presetId, + connectDepartment: shell.connectDepartment, + dispatchTask: shell.dispatchTask, + ingestAgentOutput: shell.ingestAgentOutput, + file: store.file, + sidecarDir: resolveSidecarDir(env), + get registered() { + return registered + }, + warning: warnings.length === 0 ? null : warnings.join(';'), + warnings, + /** 卸载路由与后台服务(幂等);账本不删除,下次启动继续用。 */ + dispose, + schemaVersion: SCHEMA_VERSION, + } +} + +/** + * 路由钩子:只有宿主真有能力时才接管,否则让路由退回“只落账”的保守路径。 + * 这样“没接通”永远不会被伪装成“已发送”。 + */ +function routeHooks(shell, service) { + return { + connect: (input) => shell.connectDepartment(input), + ingest: (input) => shell.ingestAgentOutput(input), + // 会话层可能晚到,所以钩子恒挂:真挂上了就走派发,没挂上就退回「只落账」, + // 绝不把「没接通」伪装成「已发送」。 + dispatch: (input) => { + if (shell.hasSessions === true) return shell.dispatchTask(input) + return service.dispatchTask({ + projectId: input.projectId, + taskId: input.taskId, + idempotencyKey: input.idempotencyKey, + sourceRoleId: input.sourceRoleId, + targetRoleId: input.targetRoleId, + targetSessionId: input.targetSessionId, + bindingGeneration: input.bindingGeneration, + packet: input.packet, + }) + }, + } +} + +export default createWorkbenchHost