mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-22 00:21:59 +00:00
03c18c4d78
一、文案(前端约 1600 处,后端传到界面的约 880 处) - 术语统一:工作流层面用「运行」(继续运行、重新运行、试运行),节点和工具层面用「执行」,不再用「跑」; 总时长 / 执行时长 / 等待审批;服务端;助手;Agent;token;工作流;固定版本;模型接入;系统提示;批准 / 驳回;受管级别 - 口语改书面:取不到、没取回来、读不懂、连不上、多半、照样、兜底、揉成这类说法改成「无法 / 未能 / 失败 / 请」;去掉拟人写法 - 不再露出实现细节:界面上不写 checkpoint、同一拍、哈希(凭证处除外),不写改版历史(「以前…」「老数据」); 报错、校验、门禁、自动修复里裸写的配置键名和枚举值换成界面上的中文标签,由新的 backend/app/engine/labels.py 统一提供; 发布弹窗里结论句的选项不再是 off / require_citation - 同一件事只留一种说法:生成阶段文案、出具档位说明、画布锁定提示各合成一份 - 去掉界面上的工业场景示例(MES、ERP、「张工」「王工」)和真实产品名,换成通用示例 二、说错的提示(都有测试证明) - 数据库测连接失败时的专用提示以前从不出现(按报错文字全等比较,永远比不上):改为按错误类型判断,不再拼出重复的前缀 - 「设置 → 供应商」改指「设置 → 模型接入」;「在设置里建数据源」改指「数据」页 - 缺少 API Key、模型接入已停用的报错不再夹英文,写明去哪里填 - 两处原因说错(「这种引用在后续版本支持」「这一版还不支持」)改成真实原因 - 节点说明里不准确的说法改正:代码节点在 microVM 或系统沙箱中执行;报告撰写、口径卡的说明不再说过头 - 导出的证据 CSV 里两列同名,第三列改为「片段编号」 三、前后端对齐 - 前端按后端原文识别日志、报错的地方,新旧两种写法都认得(历史运行里存的是旧文字),逐条补了新旧原文的核对 - 后端交回模型的原指令放进单独的 for_model 字段,前端在解析响应时去掉,不会显示到界面上 四、检查 - 检查脚本里按原文匹配的断言改成新文案;改完会变成永远成立的反向断言逐条修正,并做了变异验证 - 新增 check-copy(静态扫描前端界面字符串和后端上界面的文案):再出现「跑」「后端」「多半」「令牌」、 界面上的 Copilot、裸写的配置键名、半角标点等就报错;确需保留的写进 scripts/copy-allow.json 并注明理由
194 lines
9.2 KiB
TypeScript
194 lines
9.2 KiB
TypeScript
/**
|
||
* 助手的 update_node 怎么落到节点上,以及改完之后工具绑定变了什么。
|
||
*
|
||
* 规则和后端 app/api/copilot.py 的 merge_node_config / tool_changes 一字不差:
|
||
* 流式期间画布按这里逐条落,收尾时 final.graph 是后端按同一套规则合好的整张图。
|
||
* 两边口径一不一样,画布就会在 final 到来那一下跳一次——更糟的是以前前端整体替换
|
||
* config,流到一半断掉时,画布上的半成品里 agent 的工具已经没了。
|
||
*
|
||
* 以前是整体替换:模型只想改一句提示词,也得把整份 config 抄一遍,漏抄的字段就没了。
|
||
* 真出过事——改写提示词时漏了 tools,要查库的 agent 全丢了工具,最后把一堆工具调用
|
||
* 的原始标记当答案交了出去。
|
||
*
|
||
* 纯函数,不依赖 React 和 store,检查脚本能直接 import。
|
||
*/
|
||
import type { ToolChange } from '../types'
|
||
|
||
type Config = Record<string, any>
|
||
|
||
/** 成员条目里写 remove: true 表示删掉这个成员 */
|
||
const REMOVE_MEMBER = 'remove'
|
||
|
||
const isObject = (v: unknown): v is Config => !!v && typeof v === 'object' && !Array.isArray(v)
|
||
|
||
// 和 engine/nodes/multi.py 的叫法一致:没起名字的成员按位置叫 agentN
|
||
const memberKey = (member: Config, index: number): string => String(member.name || `agent${index}`)
|
||
|
||
/** 按字段合并:写了的覆盖,写 null 的删掉,没写的原样保留。返回新对象 */
|
||
function mergeFields(old: Config, patch: Config): Config {
|
||
const out: Config = { ...old }
|
||
for (const [key, value] of Object.entries(patch)) {
|
||
if (value === null) delete out[key]
|
||
else if (value !== undefined) out[key] = value
|
||
}
|
||
return out
|
||
}
|
||
|
||
/** 协作成员按 name 合并。原有成员保持原来的次序,新名字接在后面 */
|
||
function mergeMembers(old: unknown[], patch: unknown[]): unknown[] {
|
||
const merged = [...old]
|
||
const where = new Map<string, number>()
|
||
merged.forEach((m, i) => { if (isObject(m)) where.set(memberKey(m, i), i) })
|
||
const dropped = new Set<number>()
|
||
patch.forEach((entry, i) => {
|
||
if (!isObject(entry)) return
|
||
const key = memberKey(entry, i)
|
||
const at = where.get(key)
|
||
if (entry[REMOVE_MEMBER] === true) {
|
||
if (at != null) dropped.add(at)
|
||
return
|
||
}
|
||
const { [REMOVE_MEMBER]: _flag, ...fields } = entry
|
||
if (at != null) {
|
||
merged[at] = mergeFields(merged[at] as Config, fields)
|
||
} else {
|
||
where.set(key, merged.length)
|
||
merged.push(Object.fromEntries(Object.entries(fields).filter(([, v]) => v != null)))
|
||
}
|
||
})
|
||
return merged.filter((_, i) => !dropped.has(i))
|
||
}
|
||
|
||
/**
|
||
* update_node 的 config 落到节点上:
|
||
* 1. 顶层按字段浅合并。写 null 删键;没写的保留;args、output_schema 这类嵌套对象整个换掉。
|
||
* 2. 只有 supervisor 的 agents 是列表时,成员按 name(没名字按 agentN)合并;
|
||
* 成员自己的字段同样浅合并(没写 tools 的保留原来的 tools)。
|
||
* 3. {name, remove: true} 删掉那个成员;不认识的名字接在后面,写 null 的字段不留。
|
||
*/
|
||
export function mergeNodeConfig(nodeType: string, old: Config, patch: Config): Config {
|
||
let next = patch
|
||
if (nodeType === 'supervisor' && Array.isArray(patch.agents)) {
|
||
const members = Array.isArray(old.agents) ? old.agents : []
|
||
next = { ...patch, agents: mergeMembers(members, patch.agents) }
|
||
}
|
||
return mergeFields(old, next)
|
||
}
|
||
|
||
// -------------------------------------------------------------------------
|
||
// 工具绑定变化
|
||
// -------------------------------------------------------------------------
|
||
|
||
/** GraphSpec 的节点和画布上的 FlowNode 都认:FlowNode 的 type 是 'card',真类型在 data.nodeType */
|
||
interface NodeLike {
|
||
id: string
|
||
type?: string
|
||
data?: { nodeType?: string; label?: string; config?: Config }
|
||
}
|
||
|
||
const toolNames = (value: unknown): string[] =>
|
||
Array.isArray(value) ? value.filter((t): t is string => typeof t === 'string' && !!t) : []
|
||
|
||
interface Binding { nodeId: string; member: string | null; label: string; field: string; tools: string[] }
|
||
|
||
/** (节点 id, 成员名) → 绑定的工具。成员名为 null 的是 agent 节点本身 */
|
||
function bindings(nodes: NodeLike[]): Map<string, Binding> {
|
||
const out = new Map<string, Binding>()
|
||
for (const node of nodes) {
|
||
const type = node.data?.nodeType ?? node.type
|
||
const cfg = node.data?.config ?? {}
|
||
const label = node.data?.label || node.id
|
||
if (type === 'agent') {
|
||
out.set(JSON.stringify([node.id, null]),
|
||
{ nodeId: node.id, member: null, label, field: 'tools', tools: toolNames(cfg.tools) })
|
||
} else if (type === 'supervisor' && Array.isArray(cfg.agents)) {
|
||
cfg.agents.forEach((m: unknown, i: number) => {
|
||
if (!isObject(m)) return
|
||
const member = memberKey(m, i)
|
||
out.set(JSON.stringify([node.id, member]),
|
||
{ nodeId: node.id, member, label, field: `agents[${i}].tools`, tools: toolNames(m.tools) })
|
||
})
|
||
}
|
||
}
|
||
return out
|
||
}
|
||
|
||
/**
|
||
* 改图前后都在、而绑定的工具不一样了的节点和成员,按改后的图排序。和后端 tool_changes
|
||
* 同一套口径:新加、删掉的节点不算,那是结构变化,回执本来就会列出来。
|
||
* 老后端的 final 不带 tool_changes 时用它自己比。
|
||
*/
|
||
export function toolChangesOf(before: NodeLike[], after: NodeLike[]): ToolChange[] {
|
||
const old = bindings(before)
|
||
const out: ToolChange[] = []
|
||
for (const [key, now] of bindings(after)) {
|
||
const was = old.get(key)
|
||
if (!was) continue
|
||
const a = new Set(was.tools)
|
||
const b = new Set(now.tools)
|
||
if (a.size === b.size && [...a].every((t) => b.has(t))) continue
|
||
out.push({
|
||
node_id: now.nodeId, label: now.label, member: now.member, field: now.field,
|
||
before: was.tools, after: now.tools,
|
||
added: now.tools.filter((t) => !a.has(t)),
|
||
removed: was.tools.filter((t) => !b.has(t)),
|
||
})
|
||
}
|
||
return out
|
||
}
|
||
|
||
/** 工具集合变小了的那几条。换一个工具(数量没少)是正常改图,不算 */
|
||
export function shrunkTools(changes: ToolChange[]): ToolChange[] {
|
||
return changes.filter((c) => c.removed.length > 0 && new Set(c.after).size < new Set(c.before).size)
|
||
}
|
||
|
||
/** 回执里的一行:「数据查询」:db_query__shop、db_schema__shop → 空 */
|
||
export function describeToolChange(c: ToolChange): string {
|
||
const who = c.member ? `「${c.label}」的成员「${c.member}」` : `「${c.label}」`
|
||
const list = (xs: string[]) => (xs.length ? xs.join('、') : '空')
|
||
return `${who}:${list(c.before)} → ${list(c.after)}`
|
||
}
|
||
|
||
/** 后端的 tools_dropped 提醒里用得上的那两个字段(check.warnings / final.issues 的一条) */
|
||
export interface DropWarning { node_id?: string | null; field?: string | null }
|
||
|
||
/**
|
||
* 变少了的工具绑定分两组:后端点了名(tools_dropped,同节点同字段)的是「这一轮没让删」,
|
||
* 其余是按要求删的。改图回执(toast)和右栏的卡片都按这一条分,免得两处说法不一
|
||
*/
|
||
export function splitShrunk(changes: ToolChange[], warnings: DropWarning[]): { unasked: ToolChange[]; asked: ToolChange[] } {
|
||
const shrunk = shrunkTools(changes)
|
||
// 老后端的提醒不带 field:同一个节点的就算
|
||
const warned = (c: ToolChange) => warnings.some((w) => w.node_id === c.node_id && (w.field == null || w.field === c.field))
|
||
return { unasked: shrunk.filter(warned), asked: shrunk.filter((c) => !warned(c)) }
|
||
}
|
||
|
||
/**
|
||
* 改图回执:一轮 final 落定之后那条 toast 写什么、什么色、要不要常驻。
|
||
*
|
||
* 工具绑定变了画布上看不出来,逐条写明前后。变少了的分两组:后端点了名(tools_dropped,
|
||
* 同节点同字段)的是「这一轮没让删」,warn 色、常驻到人看过——没工具的 agent 照样能跑,
|
||
* 跑出来的是模型「假设」查过库的答案;其余是按要求删的,另列一组、不催。以前整轮只要有
|
||
* 一条提醒,所有变少的都列在「没让删」底下,按要求删的也被说成改漏了,要紧的那句被冲淡
|
||
*/
|
||
export function copilotReceipt(r: {
|
||
total: number; left: number; missing: number; toolChanges: ToolChange[]; toolWarnings: DropWarning[]
|
||
}): { text: string; kind: 'ok' | 'warn'; sticky: boolean; detail?: string } {
|
||
const { unasked, asked } = splitShrunk(r.toolChanges, r.toolWarnings)
|
||
const shrunk = [...unasked, ...asked]
|
||
const head = r.left ? `已应用到画布,仍有 ${r.left} 处问题需要处理`
|
||
: r.missing ? `已应用 ${r.total} 处改动,另有 ${r.missing} 步未能应用`
|
||
: `已应用 ${r.total} 处改动`
|
||
const lines = [
|
||
...(unasked.length ? ['以下工具绑定被移除,但本轮并未要求删除,请确认是否遗漏:', ...unasked.map(describeToolChange)] : []),
|
||
...(asked.length ? ['已按要求移除以下工具绑定:', ...asked.map(describeToolChange)] : []),
|
||
]
|
||
return {
|
||
text: [r.toolChanges.length && !shrunk.length ? `${head} · 工具绑定变更 ${r.toolChanges.length} 处` : head, ...lines].join('\n'),
|
||
kind: r.left || r.missing || unasked.length ? 'warn' : 'ok',
|
||
sticky: unasked.length > 0,
|
||
// 加了、换了的那些不在正文里:放进详情
|
||
...(r.toolChanges.length > shrunk.length ? { detail: r.toolChanges.map(describeToolChange).join('\n') } : {}),
|
||
}
|
||
}
|