《言效引擎统一 UI 中台对接标准》

一、唯一权威来源

从现在开始，言效引擎所有系统的共享 UI 资产唯一来源是：

https://dev.ui.resultrex.com

核心资产：
- https://dev.ui.resultrex.com/assets/ui_asset.php?file=core

系统适配层：
- 服务系统：https://dev.ui.resultrex.com/assets/ui_asset.php?file=service
- 任务系统：https://dev.ui.resultrex.com/assets/ui_asset.php?file=task
- 知识库系统：https://dev.ui.resultrex.com/assets/ui_asset.php?file=knowledge
- 管理系统：https://dev.ui.resultrex.com/assets/ui_asset.php?file=admin

所有旧的本地 UI 逻辑，从现在开始都只允许作为“代理入口”存在，不允许继续作为长期主样式源维护。

二、硬性原则

1. 先共享层，后业务页
- 只允许修改系统的共享入口文件来接入 dev.ui。
- 禁止在单个业务页面继续散落手写搜索框、下拉箭头、焦点高光、表格操作列、卡片描边。

2. 一处修改，多处生效
- 后续 UI 样式调整，只改 dev.ui.resultrex.com 中台资产。
- 已接入系统不得要求再次逐页改样式。

3. 清理旧 UI 逻辑
- 旧的 local inline CSS、旧 gradient 箭头、旧 search wrapper、旧双层 input 壳，必须逐步清理。
- 禁止继续新增任何旧写法。

三、各系统标准接入方式

1. 服务系统
- 共享入口文件：/www/wwwroot/dev.api.resultrex.com/layout/ui_standard.php
- 该文件只允许作为代理入口输出 dev.ui 的远程 CSS 资源。

2. 任务系统
- 共享入口文件：/www/wwwroot/dev.task.resultrex.com/ui_standard.css
- 该文件只允许保留 import dev.ui 资产，不再长期维护大段本地样式。

3. 知识库系统
- 共享入口文件：/www/wwwroot/dev.knowledge.resultrex.com/layout/ui_standard.css
- 该文件只允许保留 import dev.ui 资产，不再长期维护大段本地样式。

4. 管理系统
- 共享入口文件：/www/wwwroot/dev.admin.resultrex.com/manage/layout/ui_theme.php
- 该文件只允许作为代理入口输出 dev.ui 的远程 CSS 资源。

5. 新系统（代理系统 / 客户系统 / 后续新增系统）
- 不允许再单独设计一套 UI。
- 直接引用：
  - https://dev.ui.resultrex.com/assets/ui_asset.php?file=core
- 如有系统级差异，再新增新的中台适配层文件，不允许把差异放回业务页。

四、控件骨架硬标准

1. 搜索框
- 统一 DOM：
  <div class="yx-search">
    <span class="yx-search__icon">...</span>
    <input type="search" class="yx-search__input">
  </div>

- 只允许追加：
  <span class="yx-search__tag">标签</span>

- 禁止：
  - search-box
  - toolbar-search
  - keyword-search
  - orange-search
  - 双层输入框
  - 内外两重边框

2. 输入框 / 下拉 / 文本域
- 控件高度：44px
- 控件圆角：12px
- 边框：#eeeeee
- 焦点：橙色边框 + 橙色光圈
- 下拉箭头：统一使用小 V SVG
- 焦点与非焦点必须是同一图标，只允许颜色变化
- 禁止再使用 linear-gradient 双三角箭头

3. 按钮
- 保存按钮文案统一：保存
- 保存按钮统一放模块标题行最右侧
- 主按钮：橙底白字
- 文本操作按钮：蓝色文字、无外框

4. 卡片
- 主卡片圆角：20px
- 阴影：轻阴影，不能黑硬
- 边框：1px #eeeeee

5. 表格
- 表头背景：#fafafa
- 斑马纹：浅橙白
- 操作列固定右侧
- 操作按钮统一为蓝色文字按钮

五、旧逻辑禁令

以下逻辑不得再新增，也必须逐步删掉：

- 页面内联定义 select 的 gradient 箭头
- 页面内联覆写 .yx-search 焦点效果
- 页面内联覆写 .yx-search__input 边框
- 业务页手写搜索壳，导致双层文本框
- 旧的 .search-box / .toolbar-search / .list-search 类名
- 每个系统各自维护不同的 focus 颜色、不同圆角、不同边框灰度

六、开发执行顺序

1. 先确认业务页是否已经通过共享层接入 dev.ui
2. 再删除该页遗留的本地旧 UI 样式
3. 最后检查 JS 是否依赖旧类名或旧 DOM 结构

七、验收标准

验收必须满足：

- 搜索框无双层输入框
- 搜索框焦点必有橙色高光
- 下拉箭头是小 V 图标，不是双三角
- 焦点和非焦点箭头图形一致，只是颜色变更
- 表格操作列固定右侧
- 文本操作按钮为蓝色文字，无外框
- 不再出现同系统不同页面风格断裂

八、对接人硬指令

从现在开始，所有系统 UI 问题处理原则只有一句话：

先接 dev.ui 中台，再删旧本地逻辑，禁止继续手写旧 UI。