dsh-sansheng-liubu/index.js

277 lines
18 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

const PRESET_ID = 'sansheng-liubu'
export const POLICY_VERSION = '0.4.0'
/**
* 默认不强制任何 provider/model:宿主未必注册了这些适配器,强行指定会让整轮请求
* 以 NO_ADAPTER 失败(例如 "no adapter registered for provider xiaomi")。
* 角色模型改由面板里的「联动模型」按当前宿主目录选择,或在 preset 配置里显式给 routes。
*/
export const DEFAULT_ROUTES = Object.freeze({})
/** 三省六部:丞相 1 + 三省 3 + 六部 6 = 10 席;六部为吏、户、礼、兵、刑、工。 */
export const COURT_ROLES = Object.freeze([
'lead', 'zhongshu', 'menxia', 'shangshu',
'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu',
])
const KNOWN_ROLES = new Set(['zhongshu', 'menxia', 'shangshu', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu'])
const READ_ONLY_ROLES = new Set(['lead', 'zhongshu', 'menxia', 'shangshu', 'minister'])
const EXECUTION_ROLES = new Set(['libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu'])
const IMAGE_TOOLS = new Set(['generate_image', 'generate_images', 'edit_image'])
const FORBIDDEN_IMAGE_TOOLS = new Set(['image_generate', 'codex_image_generate'])
export const READ_ONLY_TOOLSET = Object.freeze(['read', 'grep', 'glob'])
export const EXECUTION_TOOLSET = Object.freeze(['read', 'write', 'edit', 'bash', 'pwsh', 'grep', 'glob'])
const MANAGEMENT_TOOL_PREFIXES = Object.freeze(['task_board_', 'automation_'])
const OTHER_MANAGEMENT_TOOLS = new Set(['create_skill', 'plugin_manager'])
const HUMAN_SIGNATURE_TOOLS = new Set([
'create_skill', 'plugin_manager', 'remote_ssh_delete', 'automation_delete',
])
const MUTATING_TOOLS = new Set([
'write', 'edit', 'pwsh', 'bash',
'remote_ssh_write', 'remote_ssh_mkdir', 'remote_ssh_exec',
'ws_mcp_call', ...IMAGE_TOOLS,
])
/**
* 六部各自可改什么,按职责划线,不互相借用:
* - 吏部:技能与角色文件(.md/.json/.yml 等),不开命令行,避免改代码或环境。
* - 户部:数据文件(xlsx/csv/parquet 等);重算与渲染交 Office/Univer 工具,故不开命令行。
* - 礼部:文档、汇报与截图等材料产出。
* - 兵部:跑命令、定位问题,另含远程与 MCP 通道。
* - 刑部:测试与专项验证,只跑不部署;远程命令会绕过风险分级,因此不给。
* - 工部:代码实现,含 Image-gen 生图。
*/
const ROLE_ALLOWED_MUTATIONS = Object.freeze({
libu: new Set(['write', 'edit']),
hubu: new Set(['write', 'edit']),
lipu: new Set(['write', 'edit', 'pwsh', 'bash']),
bingbu: new Set([
'write', 'edit', 'pwsh', 'bash',
'remote_ssh_write', 'remote_ssh_mkdir', 'remote_ssh_exec', 'ws_mcp_call',
]),
xingbu: new Set(['write', 'edit', 'pwsh', 'bash']),
gongbu: new Set(['write', 'edit', 'pwsh', 'bash', ...IMAGE_TOOLS]),
})
const TOOL_GOVERNANCE = `## 工具开放审核则例
一、凡部门需用工具,须奏明用途、范围、期限,经门下省审核,准奏后由兵部发放,限期使用,到期收回销账。
二、只读之具,门下可专决;改易文件者,须注明写入范围;涉费、删除、全局配置者,须人工签字。
三、兵部掌武库:工具装配、发放、回收、登记,只发不批;管理型工具(task_board_*、automation_*)与付费开关归丞相执掌,用时留痕;执行部门常备文件读写、命令行、测试之具。
四、门下验收查账,越界者下次从严;所授之具不得转借。`
const LEAD_PROMPT = `# 三省六部模式:丞相
你是本会话的丞相,也是 Agent Team Lead。你直接面向用户,负责定策、组队、监督制度执行与最终回奏;不要亲自修改文件。
## 固定组织(三省六部十席)
- zhongshu(中书省):调查现状、澄清需求、起草方案,只读。
- menxia(门下省):独立审议、准奏或封驳,并在执行后验收,只读。
- shangshu(尚书省):把批准方案转成任务依赖、按吏户礼兵刑工六部分工,只读。
- libu(吏部):Agent 与技能维护,只动技能、角色与配置文档。
- hubu(户部):数据、表格与计算,负责真实数据与可复算的结论。
- lipu(礼部):文档、汇报与可视化产出。
- bingbu(兵部):环境运行、调试与部署,掌工具装配、发放、回收、登记与销账,只发不批。
- xingbu(刑部):按风险做专项测试与独立验证,只跑不部署。
- gongbu(工部):编码与工程实现,负责落盘改动、构建与安装脚本。
## 强制流程
1. 对实质性任务,先创建 zhongshu、menxia、shangshu;成员名必须完全使用上述英文 id。
2. 在共享任务板建立“中书拟案”→“门下审议”→“尚书派工”→执行任务→“尚书合成”→“门下审核”的依赖链。
3. 中书提交可执行方案和验收标准;门下只能输出准奏或封驳,封驳必须给出阻塞问题;审议默认一轮。
4. 门下准奏前不得进入执行。准奏后先向用户回奏「方案 + 审议结论 + 拟派分工」,取得用户明确确认(“准奏”“开始”“可以”等)后,才让尚书派工;六部成员(libu、hubu、lipu、bingbu、xingbu、gongbu)只有 Lead 能创建,且只召集本任务真正用到的部门,不得为凑齐六部而拆分。
5. 每个执行部门必须先领取自己的 in_progress 任务;写入范围写进 writeScopes,依赖必须全部完成;执行完先自检再上缴。
6. 六部完成后由尚书合成一份整体结果,再交门下按验收标准审核;审核失败时,执行部门修复一次,再次失败则如实报告并请求用户决定。
7. 回复用户前必须等待所有必需成员完成,最终使用“丞相回奏”格式汇总方案、审议、执行、验证和风险;若只有部分成果通过,必须附「部分 → 主责部门」清单,写清哪一部门未交付及原因。
${TOOL_GOVERNANCE}
禁止调用 GPT 模型或 codex_image_generate。`
const ROLE_PROMPTS = Object.freeze({
zhongshu: `# 中书省职责
你负责调查、规划和任务拆解。只读,不得修改文件或运行有副作用的命令。先读取实际项目与约束,再产出:目标、非目标、任务 DAG、writeScopes、风险和验收标准。将结果发送给丞相与门下省。收到封驳后只针对阻塞问题修订。\n\n${TOOL_GOVERNANCE}`,
menxia: `# 门下省职责
你是独立审核者,只读,不得替中书改方案或替执行部门实施。审议必须给出 verdict=approve|reject、blockingIssues、risks、acceptanceCriteria。存在阻塞问题必须封驳;准奏时完成“门下审议”任务。执行后查验工具发放、使用、回收与销账记录,并依据验收标准检查证据;验收对象是尚书合成的整体结果,六部须先自检再上缴。\n\n${TOOL_GOVERNANCE}`,
shangshu: `# 尚书省职责
你只负责调度设计,不直接写文件,也不能创建 teammate。把门下批准的方案转成共享任务、依赖、负责人建议和互不重叠的 writeScopes;按吏户礼兵刑工的职责分工,通知丞相创建本任务真正需要的六部成员。跟踪状态、汇总异常,并在所需部门完成或部分完成后合成一份整体结果(含未完成项与主责部门)交门下审核。只调用必要的部门:一个部门能完成的不要拆给多个部门,同类小任务合并派工。\n\n${TOOL_GOVERNANCE}`,
libu: `# 吏部职责
你负责 Agent 与技能维护:技能设计与评估、角色配置与成员编制文档。可用的写入工具限于此范围,不写业务代码、不跑命令行、不改数据。仅当新增或实质改进技能时才安排评测,普通配置修改不启动多代理基准测试;不擅自更换模型或扩大权限。实施前领取自己的任务并确认 blocker 已完成,仅改声明的 writeScopes,完成后提交改动清单与自检结果。\n\n常备工具:write、edit、read、grep、glob。\n\n${TOOL_GOVERNANCE}`,
hubu: `# 户部职责
你负责数据与计算:表格、数据文件、统计与可复算的结论。可用的写入工具只用于数据文件;读取、重算与渲染交宿主提供的 Office / Univer 工具,不跑命令行。依据实际数据选择统计方法,不把表格操作等同于统计验证,不补造数据;无法核实时如实标注未核实。实施前领取自己的任务并确认 blocker 已完成,完成后提交数据来源、口径与复算方式。\n\n常备工具:write、edit、read、grep、glob。\n\n${TOOL_GOVERNANCE}`,
lipu: `# 礼部职责
你负责文档、汇报、文案润色与可视化产出,包括 README、变更记录与演示材料。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。完成后向丞相和门下提交成稿与自检结果。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
bingbu: `# 兵部职责
你负责环境运行、调试与部署,并掌武库:工具装配、发放、回收、登记、销账,只发不批。实施前读取任务、领取任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。先复现再定位,运行适用命令与测试,报告复现步骤、根因、修复文件、测试结果、工具台账和剩余风险。部署发布须在授权范围内。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
xingbu: `# 刑部职责
你负责按风险开展的专项测试与独立验证,不承担门下成品审议,也不部署。采用复现定位与有效测试设计:给出问题位置、证据与影响,不越权修改他部成果;修复由主责部门完成。不是每项任务都必经你手,只在风险需要时受派。实施前领取自己的任务并确认 blocker 已完成;仅修改声明的 writeScopes(测试代码与报告)。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
gongbu: `# 工部职责
你负责代码实现、构建、安装脚本与文件落地。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。先读后改,改完运行适用的构建或测试命令,报告修改文件、执行结果和剩余风险。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
minister: `# 执行成员职责
你是三省六部团队中的临时成员。服从丞相调度,先领取任务并尊重依赖与 writeScopes;不要绕过门下审核。\n\n${TOOL_GOVERNANCE}`,
})
export function roleFromMembership(membership) {
// A normal newly-created preset session has no Agent Team membership yet.
// Treat that primary/default agent as the Chancellor so users converse with
// the Lead immediately, before the Chancellor creates the remaining court.
if (!membership) return 'lead'
if (membership.role === 'lead') return 'lead'
const name = String(membership.name || '').trim().toLowerCase()
return KNOWN_ROLES.has(name) ? name : 'minister'
}
export function routeForRole(role, routes = DEFAULT_ROUTES) {
if (!routes) return undefined
return routes[role] ?? routes.minister
}
export function toolsetForRole(role) {
return EXECUTION_ROLES.has(role) ? [...EXECUTION_TOOLSET] : [...READ_ONLY_TOOLSET]
}
function hasExecutableAssignment(role, tasks) {
const byId = new Map(tasks.map(task => [task.id, task]))
return tasks.some(task => task.status === 'in_progress' && task.ownerName === role &&
(task.blockedBy ?? []).every(id => byId.get(id)?.status === 'completed'))
}
function managementApproval(role, toolName, tasks, now = Date.now()) {
return tasks.find(task => {
const approval = task?.approval
if (task.status !== 'in_progress' || task.ownerName !== role || !approval) return false
if (approval.reviewer !== 'menxia' || approval.verdict !== 'approve') return false
if (!approval.purpose || !approval.scope || !approval.expiresAt) return false
if (Date.parse(approval.expiresAt) <= now) return false
return Array.isArray(approval.tools) && approval.tools.some(entry => entry === toolName ||
(entry.endsWith('*') && toolName.startsWith(entry.slice(0, -1))))
})
}
function isManagementTool(toolName) {
return OTHER_MANAGEMENT_TOOLS.has(toolName) || MANAGEMENT_TOOL_PREFIXES.some(prefix => toolName.startsWith(prefix))
}
export function evaluateToolPolicy(role, toolName, tasks = [], options = {}) {
const audit = typeof options.audit === 'function' ? options.audit : () => {}
if (FORBIDDEN_IMAGE_TOOLS.has(toolName)) return `上朝模式只允许使用 Image-gen 工具,不得调用 ${toolName}。`
const destructiveBoardAction = toolName === 'task_board_manage' && options.args?.action === 'delete'
if ((HUMAN_SIGNATURE_TOOLS.has(toolName) || destructiveBoardAction) && options.humanSigned !== true) {
return `${toolName} 涉及删除或全局配置,须先取得人工签字。`
}
if (isManagementTool(toolName)) {
if (role === 'lead') {
audit({ action: 'management-tool', role, toolName, decision: 'allow', authority: 'chancellor' })
return undefined
}
const approval = managementApproval(role, toolName, tasks, options.now)
if (!approval) return `${role} 调用管理型工具 ${toolName} 前须提交用途、范围、期限,并取得门下省准奏记录。`
audit({ action: 'management-tool', role, toolName, decision: 'allow', approvalId: approval.id })
return undefined
}
if (!MUTATING_TOOLS.has(toolName)) return undefined
if (READ_ONLY_ROLES.has(role)) return `${role} 是只读规划、审核或调度角色,不得调用写入型工具 ${toolName}。`
if (!EXECUTION_ROLES.has(role)) return `${role} 不是获准的执行部门,不能调用 ${toolName}。`
if (!ROLE_ALLOWED_MUTATIONS[role]?.has(toolName)) return `${toolName} 不属于 ${role} 的职责范围。`
if (!hasExecutableAssignment(role, tasks)) return `${role} 尚未准奏:请先领取一个 in_progress 且所有 blocker 已完成的共享任务。`
return undefined
}
function rolePrompt(role) { return role === 'lead' ? LEAD_PROMPT : ROLE_PROMPTS[role] ?? ROLE_PROMPTS.minister }
function normalizeRoutes(routes = {}) {
const merged = { ...DEFAULT_ROUTES }
for (const [role, route] of Object.entries(routes)) {
if (!route || typeof route !== 'object') continue
if (typeof route.provider !== 'string' || typeof route.model !== 'string') continue
merged[role] = { provider: route.provider, model: route.model,
...(typeof route.reasoningEffort === 'string' ? { reasoningEffort: route.reasoningEffort } : {}) }
}
return merged
}
const INSTALLATIONS = globalThis[Symbol.for('dsh.sansheng-liubu.installations')] ??=
new WeakMap()
export const name = 'sansheng-liubu-mode'
export const inject = ['agents', 'agentTeams', 'agentPresets', 'systemPrompt', 'tools']
export function apply(ctx, config = {}) {
const presetId = typeof config.presetId === 'string' ? config.presetId : PRESET_ID
const routes = normalizeRoutes(config.routes)
const owned = new Map()
const audit = entry => ctx.logger?.info?.(`[sansheng-liubu:audit] ${JSON.stringify({ at: new Date().toISOString(), ...entry })}`)
const uninstall = agent => {
const release = owned.get(agent)
if (!release) return
owned.delete(agent)
release()
}
const install = agent => {
if (owned.has(agent)) return
if (ctx.agentPresets.composedPreset(agent.ctx) !== presetId) return
const membership = ctx.agentTeams.tryMembership(agent)
const role = roleFromMembership(membership)
if (!role) return
const existing = INSTALLATIONS.get(agent)
if (existing) {
existing.refs += 1
owned.set(agent, () => {
existing.refs -= 1
if (existing.refs === 0) { existing.dispose(); INSTALLATIONS.delete(agent) }
})
return
}
const scoped = agent.ctx
const dispose = scoped.effect(() => {
const disposers = []
try {
disposers.push(scoped.systemPrompt.section({
name: 'sansheng-liubu:role',
order: scoped.systemPrompt.getSectionOrder('TEAM_POLICY') + 1,
text: rolePrompt(role),
}))
disposers.push(scoped.on('agent/request', async (_payload, next) => {
const resolved = await next()
const route = routeForRole(role, routes)
if (!route) return resolved
const { reasoningEffort: _oldEffort, ...base } = resolved
return { ...base, provider: route.provider, model: route.model,
...(route.reasoningEffort ? { reasoningEffort: route.reasoningEffort } : {}) }
}, { prepend: true }))
disposers.push(scoped.tools.guard(execution => {
const tasks = ctx.agentTeams.listTasks(agent)
return evaluateToolPolicy(role, execution.name, tasks, {
audit,
humanSigned: execution?.approval?.humanSigned === true || execution?.humanSigned === true,
args: execution?.args,
})
}))
} catch (error) {
for (const cleanup of disposers.reverse()) cleanup()
throw error
}
return () => { for (const cleanup of disposers.reverse()) cleanup() }
})
const shared = { refs: 1, dispose }
INSTALLATIONS.set(agent, shared)
owned.set(agent, () => {
shared.refs -= 1
if (shared.refs === 0) { shared.dispose(); INSTALLATIONS.delete(agent) }
})
}
for (const agent of ctx.agents.list()) install(agent)
const disposeCreated = ctx.on('agent/created', ({ agent }) => install(agent))
const disposeDisposed = ctx.on('agent/disposed', ({ agent }) => uninstall(agent))
return () => {
disposeCreated()
disposeDisposed()
for (const agent of [...owned.keys()]) uninstall(agent)
}
}