dsh-sansheng-liubu/index.js

254 lines
15 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.3.0'
export const DEFAULT_ROUTES = Object.freeze({
lead: Object.freeze({ provider: 'xiaomi', model: 'mimo-v2.6-pro', reasoningEffort: 'high' }),
zhongshu: Object.freeze({ provider: 'deepseek-official', model: 'deepseek-v4-pro', reasoningEffort: 'high' }),
menxia: Object.freeze({ provider: 'moonshotai-cn', model: 'kimi-k3', reasoningEffort: 'max' }),
shangshu: Object.freeze({ provider: 'xiaomi', model: 'mimo-v2.6-flash', reasoningEffort: 'high' }),
gongbu: Object.freeze({ provider: 'moonshotai-cn', model: 'kimi-k3', reasoningEffort: 'high' }),
libu: Object.freeze({ provider: 'moonshotai-cn', model: 'kimi-k3', reasoningEffort: 'high' }),
bingbu: Object.freeze({ provider: 'deepseek-official', model: 'deepseek-v4-pro', reasoningEffort: 'max' }),
minister: Object.freeze({ provider: 'moonshotai-cn', model: 'kimi-k3', reasoningEffort: 'high' }),
})
const KNOWN_ROLES = new Set(['zhongshu', 'menxia', 'shangshu', 'gongbu', 'libu', 'bingbu'])
const READ_ONLY_ROLES = new Set(['lead', 'zhongshu', 'menxia', 'shangshu', 'minister'])
const EXECUTION_ROLES = new Set(['gongbu', 'libu', 'bingbu'])
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,
])
const ROLE_ALLOWED_MUTATIONS = Object.freeze({
gongbu: new Set(['write', 'edit', 'pwsh', 'bash', ...IMAGE_TOOLS]),
libu: 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',
]),
})
const TOOL_GOVERNANCE = `## 工具开放审核则例
一、凡部门需用工具,须奏明用途、范围、期限,经门下省审核,准奏后由兵部发放,限期使用,到期收回销账。
二、只读之具,门下可专决;改易文件者,须注明写入范围;涉费、删除、全局配置者,须人工签字。
三、兵部掌武库:工具装配、发放、回收、登记,只发不批;管理型工具(task_board_*、automation_*)与付费开关归丞相执掌,用时留痕;执行部门常备文件读写、命令行、测试之具。
四、门下验收查账,越界者下次从严;所授之具不得转借。`
const LEAD_PROMPT = `# 三省六部模式:丞相
你是本会话的丞相,也是 Agent Team Lead。你直接面向用户,负责定策、组队、监督制度执行与最终回奏;不要亲自修改文件。
## 固定组织
- zhongshu(中书省):调查现状、澄清需求、起草方案,只读。
- menxia(门下省):独立审议、准奏或封驳,并在执行后验收,只读。
- shangshu(尚书省):把批准方案转成任务依赖、建议工礼兵三部分工,只读。
- gongbu(工部):编码与工程实现,负责落盘改动、构建与安装脚本。
- libu(礼部):文档、汇报与可视化产出,负责说明书、变更记录与演示材料。
- bingbu(兵部):调试、测试与问题定位,掌工具装配、发放、回收、登记与销账,只发不批。
## 强制流程
1. 对实质性任务,先创建 zhongshu、menxia、shangshu;成员名必须完全使用上述英文 id。
2. 在共享任务板建立“中书拟案”→“门下审议”→“尚书派工”→执行任务→“尚书合成”→“门下审核”的依赖链。
3. 中书提交可执行方案和验收标准;门下只能输出准奏或封驳,封驳必须给出阻塞问题;审议默认一轮。
4. 门下准奏前不得进入执行。准奏后先向用户回奏「方案 + 审议结论 + 拟派分工」,取得用户明确确认(“准奏”“开始”“可以”等)后,才让尚书派工并创建 gongbu、libu、bingbu(只有 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}`,
gongbu: `# 工部职责
你负责代码实现、构建、安装脚本与文件落地。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。先读后改,改完运行适用的构建或测试命令,报告修改文件、执行结果和剩余风险。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
libu: `# 礼部职责
你负责文档、汇报、文案润色与可视化产出,包括 README、变更记录与演示材料。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。完成后向丞相和门下提交成稿与自检结果。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`,
bingbu: `# 兵部职责
你负责调试、测试与问题定位,并掌武库:工具装配、发放、回收、登记、销账,只发不批。实施前读取任务、领取任务并确认所有 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) {
return routes?.[role] ?? routes?.minister ?? DEFAULT_ROUTES[role] ?? DEFAULT_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)
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)
}
}