Import vendor/dsh-sansheng-liubu/workbench/host/index.mjs

This commit is contained in:
QQ 2026-11-12 00:14:47 +08:00
parent b1fab908f6
commit 344ccf439f
1 changed files with 230 additions and 0 deletions

View File

@ -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