Files
UHD_Media_Tool/docs/design/glossary.md
T
2026-09-28 02:09:39 +08:00

2.7 KiB

术语表与文案规则

界面、错误信息、Agent 提示词里同一概念只用一个名字。代码标识符(slot、decision、feed)不受限制。依据 REQ v0.7 §3.1。

术语

概念(代码) 界面用词 不用
MediaEntity 作品 媒体实体、条目、影片
ContentUnit 季 / 集;统称"内容单元" 单元、分集单元
Slot 版本目标 Slot、收录目标、目标槽。给模型的说明可写一次"版本目标(slot)"对应参数名
AcquisitionPolicy 收录策略(版本号称"策略版本") 收录规则、规则集
Subscription 订阅 追剧、关注
Site / SiteAccount 站点 / 站点账号 PT 源
FeedSource Feed RSS 源、订阅源
站点列表/搜索结果的一次抓取 快照
SourceRelease 资源 来源资源、站点资源、种子(种子只指 .torrent 文件)
资源按版本目标评估后 候选
Decision 待处理事项;入口叫"待处理" 决策、工单、待决
Approval 审批(名词);按钮用"批准 / 拒绝" 授权记录
DownloadTask 下载任务 下载单
Organization record 整理记录;动作叫"整理",结果状态叫"已入库" 转移、入库记录
整理方式 复制 / 移动 / 硬链接 Copy / Move
Library root 库根 媒体库根、根目录
文件管理可浏览的目录(库根 + 下载器路径映射) 登记目录 登记根、根
MediaAsset / AssetLocation 资产 / 资产位置(登记进媒体库的文件) 媒体文件记录
ExternalIdentity 外部身份(TMDB/TVDB/IMDb ID) 外部 ID 映射、外部标识
未确认身份的文件/资源 待识别 未识别(IA 重构时若改名,全站一起改)
Trash 回收站 垃圾桶
Agent Agent;上游模型配置叫"Agent 上游" 助手、智能体、AI、Pi 上游
工作流引擎的一次执行 运行 run

文案规则

  1. 先说结果。能删的词删掉,删后不影响理解、判断、操作就删。
  2. 错误说清发生了什么和怎么办,最多两句;不知道原因就不猜。
  3. 按钮 2–6 字,以动词开头:"保存""重新预览""移入回收站"。
  4. 空态一句:这里会出现什么,下一步做什么。
  5. 说明文字只写用户做决定需要的事实(条件、后果、是否可恢复)。
  6. 不写"您""请""欢迎""我们""系统将""温馨提示"。
  7. 不用营销词和 AI 高频词:轻松、无需、只需、极致、智能、赋能、一站式;不写"不是…而是…"和排比对仗。
  8. 数字和状态来自数据,不写产品没有的承诺。
  9. 技术词保留原文:API Key、Cookie、TMDB、infohash、hash。
  10. 标题、按钮、标签、Toast 末尾不加句号。