Files
AgentLab/frontend/src/lib/terms.ts
T
ThearchyHelios 3e311ec551 第三波收尾:跨模块整合、全站扫尾、检查脚本整合;网页工具认得本机代理的 fake-ip
整合(3c-integrate)
- 公共层:跨天时长(formatSpan / formatOffset / formatLapse)、本机署名(lib/actor)、检索分类色令牌、
  数据源目录(useDatasources)收进公共层;失败说明能一次列出多个写坏的自定义工具,查询超时指到数据源的查询时限
- 管理页收尾:设置页接入统一的离开前确认;检查脚本不再把沙箱里的真实值打进输出
- 画布 ↔ 右栏:点出具印章、点节点能跳到右栏对应位置;「定位」直接聚焦到出问题的字段
- 回答流 / 问数据 / 记录页:失败信息带「去哪修」且不再被翻译两遍;协作团队的结局按执行截取;
  等审批时断流重连、而运行已在空档里跑完的,补全事件

扫尾(3c-sweep)
- 术语统一:开始运行 / 继续运行、工作流最大步数;未保存的运行统一叫「未保存的工作流」(后端新运行同步)
- 沙箱报错不再带 Python 异常类名;新增 check-tokens,未定义的 CSS 变量为 0,两个旧别名迁移后删除

检查脚本(3c-checks)
- check-ui 跟上新界面(运行列表按 data 属性找行),加上令牌与选中态的回归断言,输出里的名字打码
- 新增 check-all:按顺序跑全部检查、汇总退出码,--repeat 列出偶发项
- 单节出错只记这一节失败、不再带崩整个脚本;外壳遥测浮层「重新检测」时焦点不再掉到 body

网页工具与 fake-ip
- Clash / mihomo 一类代理开 TUN + fake-ip 时,查什么都先拿到 198.18 段的假地址,被当成内网拦截。
  新增 AGENTLAB_HTTP_TOOL_FAKE_IP_RANGES(默认空):落在段里的解析结果改向公共 DNS(DoH)核实真实地址,
  公网放行、内网照拦、核实不了按拦截处理。DoH 默认先问境外的,境内公共 DNS 会对被封锁的域名返回污染结果
- 列表型环境变量接受逗号分隔(原来注释说逗号分隔、实际只认 JSON 数组);域名解析改为异步,不再阻塞事件循环

验证(沙箱):tsc 干净,pytest 866 passed(两遍),检查脚本全绿。
2026-09-27 23:37:32 +08:00

128 lines
5.1 KiB
TypeScript

/**
* 术语表:界面文案里同一件事只有一种叫法。
*
* 之前「正式」一个词指三件事(发布等级、运行类别、出具档位),探索态有四五种
* 叫法;「工作流 / 图 / 画布 / 流程」「审批 / 确认 / 介入 / 放行」混用,门禁报错
* 引用的词界面上从没出现过。这三层(发布等级、运行类别、出具档位)是「受限动态
* 编排」的骨架,彼此独立:一次正式运行完全可能降档出具。说法必须分开。
*
* 规则:
* - 「工作流」指存下来的资产,「画布」指编辑区,「图」只在技术细节里出现
* (执行图、走线)。
* - 「运行」名词动词都用它;导航里的历史页叫「记录」。
* - 人工节点叫「人工审批」,agent / tool / code 上的选项叫「审批策略」,等人
* 处理的那张卡叫「审批卡」。
* - 右栏叫「助手」;Copilot 只作为产品功能名出现在按钮提示里。
*
* 枚举值(formal / degraded / withheld 等)不动,只换显示。
*/
import type { NodeType } from '../types'
export const TERMS = {
workflow: '工作流',
canvas: '画布',
run: '运行',
records: '记录',
assistant: '助手',
copilot: 'Copilot',
humanNode: '人工审批',
approvalPolicy: '审批策略',
approvalCard: '审批卡',
formalRun: '正式运行',
exploratoryRun: '探索运行',
} as const
/** 工作流状态(发布等级) */
export const WORKFLOW_STATUS_LABEL: Record<'draft' | 'published' | 'governed', string> = {
draft: '草稿',
published: '已发布',
governed: '受管',
}
/** 发布弹窗里的选项说明:和工具栏 chip「已发布 v4」说法对得上 */
export const WORKFLOW_STATUS_HINT: Record<'draft' | 'published' | 'governed', string> = {
draft: '草稿 — 只能发起探索运行',
published: '已发布 — 可发起正式运行',
governed: '受管 — 可发起正式运行,并受治理门禁约束',
}
/** 运行类别 */
export const RUN_CLASS_LABEL: Record<'formal' | 'exploratory', string> = {
formal: '正式运行',
exploratory: '探索运行',
}
/** 按钮上的运行类别:「正式运行 v3」 */
export function runClassLabel(runClass: 'formal' | 'exploratory' | null | undefined, version?: number | null): string {
if (runClass === 'formal') return version != null ? `正式运行 v${version}` : '正式运行'
return '探索运行'
}
/**
* 没挂在工作流上的运行:画布或问数据当场搭的,从没存成工作流。后端给它的名字老数据是
* 「临时图」、新的是「未保存的工作流」,也可能是空的;界面上一律叫「未保存的工作流」。
* 运行和审批都带 workflow_id / workflow_name,记录页、命令面板、审批卡、通知走同一处
*/
export const UNSAVED_NAME = '未保存的工作流'
export const UNSAVED_HINT = '这次运行跑的是画布或问数据当场搭的工作流,没有存下来,所以回不到画布里'
const UNSAVED_NAMES = new Set(['临时图', UNSAVED_NAME])
type WorkflowRef = { workflow_id?: string | null; workflow_name?: string | null }
export const isUnsaved = (x: WorkflowRef): boolean =>
!x.workflow_id && (!x.workflow_name || UNSAVED_NAMES.has(x.workflow_name))
export const runName = (x: WorkflowRef): string =>
isUnsaved(x) ? UNSAVED_NAME : x.workflow_name ?? ''
/** 出具档位 */
export const ISSUANCE_LABEL: Record<'formal' | 'degraded' | 'withheld', string> = {
formal: '完整出具',
degraded: '降档出具',
withheld: '不予出具',
}
export function issuanceLabel(tier: string | null | undefined): string {
if (!tier) return '—'
return (ISSUANCE_LABEL as Record<string, string>)[tier] ?? tier
}
/**
* 节点类型的中文名。画布节点库、运行流、门禁报错、GraphPeek 的 chip 都用这一张。
*
* 这是短名:节点库条目上的「成果 / 出具」是在短名后面补了一句用途,那是节点库
* 自己的展示,不是另一个名字。后端 schema.py / governance.py 的报错也按这张表写。
*/
export const NODE_TYPE_LABEL: Record<NodeType, string> = {
input: '输入',
output: '成果',
llm: '模型调用',
agent: 'Agent',
supervisor: '多 Agent 协作',
tool: '调用工具',
code: '沙箱代码',
branch: '条件分支',
loop: '循环',
subgraph: '子工作流',
memory: '长期记忆',
retrieve: '知识检索',
transform: '数据整形',
human: '人工审批',
validate: '结构校验',
metrics: '口径卡',
}
/** 与 decode.ts 里旧名字同名的出口,第二波改成从这里导入时不用改调用处 */
export const TYPE_LABEL: Record<string, string> = NODE_TYPE_LABEL
/** 未知类型原样返回:Copilot 可能编出不存在的类型,显示原码比显示空白好查 */
export function nodeTypeLabel(type: string | null | undefined): string {
if (!type) return '—'
return TYPE_LABEL[type] ?? type
}
/** 审批策略的选项文字:agent / tool / code 三处共用一套说法 */
export const APPROVAL_POLICY_LABEL: Record<'dangerous' | 'always' | 'never', string> = {
dangerous: '仅危险工具需要审批',
always: '每次调用都审批',
never: '全部自动放行',
}