Files
AgentLab/frontend/src/canvas/copilotMerge.ts
T
ThearchyHelios 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 并注明理由
2026-09-30 08:05:15 +08:00

194 lines
9.2 KiB
TypeScript
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.
/**
* 助手的 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') } : {}),
}
}