254 lines
15 KiB
JavaScript
254 lines
15 KiB
JavaScript
const PRESET_ID = 'sansheng-liubu'
|
||
export const POLICY_VERSION = '0.3.3'
|
||
|
||
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)
|
||
}
|
||
}
|