/
Semantic Pipeline
结构化诊断 Semantic Pipeline
6 个已验证漂移模式 · 结构化问诊 · 语义分级器。从症状到契约，一站式诊断。
3
结构化问诊入口（三层判定模型诊断器）
回答 3 组问题，自动匹配语义断层模式，输出诊断报告与 YAML 契约
第一层：组件类型识别
第二层：语义缺失判定
第三层：视觉表达校验
1
第一层：组件类型识别
Component Type Classification · 根据交互路径，而非视觉形态
用户在使用 AI 产品时，遇到了什么类型的界面？
错误提示
用户遭遇系统异常，操作被迫中断
例：报错、连接断开、服务繁忙
过程指示
AI 执行多步任务，用户等待过程中可见
例：搜索中、思考中、生成中
边界反馈
系统对请求作出拒绝、终止或升级审核响应
例：无法回答、会话已结束、需要审核
操作控件
用户主动发起，触发系统状态变更
例：删除、提交、确认按钮
状态提示
系统主动推送，提示用户注意风险或状态变化
例：告警卡片、系统通知、风险提示
2
第二层：语义缺失判定
Semantic Deficiency Detection · 提取语义关键词，匹配缺失模式
用户的核心困惑是什么？（可多选）
3
第三层：视觉表达校验
Visual Expression Validation · 记录与语义级别不匹配的视觉映射
当前界面的视觉表达有什么特征？（可多选）
颜色映射不匹配
所有错误都用红色，没有按严重程度区分
文案精度不足
使用模糊词汇（"出错了""请稍后"）或错误同义词
行动完整性缺失
没有提供与后果级别匹配的用户行动（刷新/等待/升级）
技术错误码暴露
429、500、DataInspectionFailed 等直接展示给用户
诊断报告
三层判定完成 · 置信度基于关键词匹配度 + 视觉校验一致性
高危操作风险未约束
AI 把不可逆操作做成普通按钮，没有二次确认
错误状态后果差异未分级
多种错误共用红色，用户无法判断后果严重程度
⚠️ 消息流中断
⏳ 网络连接不稳定
⏱️ 请求频率已达上限
告警文案语义降级
AI 把 Critical 写成严重，情绪权重降低
严重
→
Critical
同义词拦截：禁止情绪权重降级
过程状态认知阶段未显化
Searching/Reading 模糊，用户不知道 AI 在干什么
Searching → Reading → Wrapping up
边界动作权利差异未区分
拒绝和终止混为一谈，用户不知道权利还在不在
Claude has ended this chat
会话已终止，上下文已清空
高危操作确认强度不足
不可逆操作，必须输入账户名确认
删除账户
此操作不可恢复。请输入账户名确认。
E
ERR-001
Error
错误状态后果差异未分级
多种错误共用红色，用户无法判断后果严重程度
编译输出（一份 YAML，四种消费格式）
/
Dictionary
语义字典 Semantic Dictionary · 阶段二产出
组织级语义码本：语义域 / 语义令牌 / 场景映射。所有 YAML 契约必须引用字典中的已定义项，不可自创。
设计前 · 查询语义定义
设计中 · 统一沟通术语
写 PRD · 引用场景映射
/
Contract Library
语义契约化 Contract Library
6 个漂移模式 → 机器可读规则 → 4 种消费格式。设计师、DesignOps、前端、效能，各取所需。
语义字典
查询组织级语义码本，统一语义域、语义令牌与场景映射定义。
拿到契约了？去验证实验室跑一下
输入你的 AI 生成文案，看是否符合契约约束
版本管理
v1.1.0
2026-06-20
增加 "degraded" 级别；优化同义词防火墙匹配逻辑
v1.0.0
2026-06-01
初始版本：fatal / transient / retryable 三级错误状态语义分级
/
Validation Toolkit
验证闭环 Validation Toolkit
三层验证工具：语义分级器 · JSON 输入 · 快照模板。证明"加了规则后有效"。
输入任意错误文案，自动诊断语义分级并给出约束建议。用于快速判断一个错误提示属于哪一级 severity。
快速测试：
⚡
懒人模式
自动提取
粘贴一段错误文案或描述，系统自动提取关键字段并匹配模式。
粘贴组件语义快照 JSON，系统自动匹配已知模式。用于快速诊断一个组件是否符合语义规范。
组件语义快照（Semantic Snapshot）是一种结构化的组件描述格式，用于精确描述一个组件的语义特征，便于机器自动匹配模式。
{
"component_type": "Alert",
"visual": {
"color": "red",
"background": "solid",
"icon": "warning"
},
"copy": {
"title": "Error",
"description": "Something went wrong",
"tone": "urgent"
},
"interaction": {
"dismissible": true,
"actions": ["retry", "contact_support"]
},
"context": "system_error"
}
component_type
组件类型（Alert / Button / Modal / Progress 等）
visual
视觉特征（颜色、背景、图标）
copy
文案内容（标题、描述、语气）
interaction
交互特征（是否可关闭、可用操作）
context
使用场景（system_error / user_action / notification）
粘贴 JSON 到"JSON 输入"工具，即可自动匹配模式。