Files
UHD_Media_Tool/apps/web
rootandClaude Opus 5.5 4480fc346d refactor(copy): 术语统一——收录版本、模型服务、智能体等(DEAI-2)
- 版本目标 → 收录版本(前后端用户可见字符串、能力描述、给模型的提示)
- Agent 上游 / 上游 → 模型服务;界面上的 Agent / Agent 会话 → 智能体 / 智能体会话
- 身份歧义 / 识别有歧义 / 无法确定作品 → 没识别出作品;待识别(池) → 未识别
- 建档 → 加入媒体库;资产 → 文件;库根 → 媒体库目录;纳管 → 本工具 / 外部任务;
  哨兵 → 标记文件 / 检查目录;站点快照 → 抓取;Feed / RSS 订阅 / 来源健康 → RSS
- 代码标识符、API 字段名、迁移文件不改;glossary.md 同步;smoke 选择器跟随

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 20:35:43 +08:00
..
2026-09-29 03:27:14 +08:00

@umt/web

React Router 7 SPA 控制台(ssr:false),沿用 uhd_web 设计系统(token 见 app/app.css,规范见 docs/design/)。只通过 /api/v1 与 server 通信,请求/响应类型一律来自 @umt/contracts,不手写重复 DTO。开发端口 5180,/api 代理到 http://localhost:4380。

命令

在仓库根目录执行:

  • deno task dev:web:开发服务器(5180)。
  • cd apps/web && deno task build:生产构建到 build/client,由 server 的 WEB_ROOT 同端口托管。
  • cd apps/web && deno task test:单测(app/**/*.test.ts)。
  • deno task test:web:smoke:Playwright 全页面冒烟,前提与环境变量见仓库 README。
  • deno task check:tokens:设计 token 守卫。

目录

  • app/routes/:页面(routes.ts 登记全部路由);app/routes/console/ 为控制台。
  • app/api/:按资源分的 react-query hook,路径与 schema 取 @umt/contracts 的 Api 注册表。
  • app/components/:业务组件与 ui/ 基础组件。
  • Agent 页的 ?mock=1 演示模式只在开发构建或后端 pi.provider = "fake" 时生效,生产构建连真实模型时忽略。