去 AI 味、去工程味审查(DEAI-1)
2026-09-29 · 只审查,不改代码。依据:human-copy 文案规范、用户品味清单、glossary.md、console-ia.md;对照 MoviePilot 前端 src/locales/zh-CN.ts。
截图:登录 https://127.0.0.1 只读抓取(非 GET 的 /api 请求一律拦截,未碰站点搜索),存在 apps/web/test/screenshots/deai/(不进 git),下文用文件名前缀引用,如 01-home。
缺口:库里没有订阅,订阅详情页无法截图,该页条目来自源码字符串(routes/console/subscriptions.$id.tsx、components/subscriptions/*)。
1. 总诊断
问题主要有五类,根源都是「界面是从数据模型和实现往外长出来的,没有先问用户此刻要什么」。
- 数据模型直接当界面。表名、状态码、枚举值原样上屏:
identity_unknown、blocked:target_exists、capability.invoke、tmdb:tv:90228、agent_run_event、r1。整理记录、待处理、下载时间线、审计都有。
- 每个字段都想解释,解释的是实现而不是后果。计划页 29 行说明里有「对照 MP 启动时的 clear_temp」「observation,按 created_at」「umt backup(宿主机 cron 调用)」;设置页讲哨兵文件
.uhd-root、负缓存、三个进程共用。用户看不懂,看懂了也做不了决定。
- 为可审计而堆证据。Agent 会话一屏里同时有「模型说的(未经核查)」「仅供参考,不作为完成依据」「系统核实的结果」、5 个状态徽章、4 个 0 计数、数据来源说明、token 数和四位小数的美元费用。可信度是靠一句话和一个链接建立的,不是靠把账本摊开。
- 内部概念名直接露给用户。版本目标、内容单元、临时单元、资产、外部身份、库根、纳管、快照、候选、修订、草案、抑制记录、持续授权、幂等。MP 用「洗版」「已入库 / 缺失」「媒体库目录」「整理」「识别」这类用户早就会说的词。
- 同一件事多种说法、多重信号。「身份歧义 / 识别有歧义 / 无法确定作品」「RSS 订阅 / 来源健康 / Feed」「媒体概览 / 媒体库」「整理冲突 / 路径冲突 / target_exists」;「自动化运行中」同时用播放图标、绿点徽章「总开关开」和一句口号表达。
另有一个事实性问题:首页写「0 个订阅在追踪,自动收录、下载和整理」,数字为 0 时后半句是空承诺。
2. 术语对照表
「界面」一列:显示 = 默认视图可以出现;详情 = 只在详情页 / 折叠区 / 高级设置出现;隐藏 = 只在代码、日志、给模型的提示里。
| 当前用词 |
用户视角的说法(参考 MP / 常识) |
界面 |
说明 |
| 版本目标 / Slot |
「想要的版本」;升级动作沿用 MP 的「洗版」 |
显示(改名后) |
首页「版本目标满足率」改「想要的版本已到齐 x / y」;列名「版本目标」→「版本」。需拍板,见 §5.4 |
| 资源(SourceRelease) |
资源 |
显示 |
保留,和 MP 一致 |
| 候选 |
不单独命名;说「可下载的资源」「选一个下载」 |
隐藏 |
「候选被选中后生成计划」这种句子直接删 |
| 观察(observation) |
不出现 |
隐藏 |
目前出现在设置「Feed 观察」、计划页「观察记录清理」、下载时间线「观察 · 无」 |
| 内容单元 |
季 / 集 |
隐藏 |
作品详情面板标题「内容单元」→「季与集」 |
| 临时单元 |
「未确认的集」或不提示 |
详情 |
徽章「临时单元」→「编号待确认」 |
| 资产 / 资产位置 |
文件 / 已入库文件 |
显示为「文件」 |
首页「资产 5 已入库视频」→「已入库文件 5」 |
| 运行 / run / 引擎运行 |
任务(用户侧);引擎步骤只在详情折叠区 |
详情 |
「未关联业务对象 · ce28d777」这种行默认不进任务列表 |
| 租约 / 控制权 / 接管(浏览器) |
「你在操作」/「交还给 Agent」 |
显示(按钮) |
「租约」一词不出现 |
| 纳管 / 接管(下载器) |
「由本工具管理」;筛选叫「来源:本工具 / 其他」 |
显示(改名后) |
下载列表每行的「接管」徽章删掉,只在不是本工具管理的行标「外部任务」 |
| 证据 / 原始证据 / 证据等级 |
「详情」「依据」 |
详情 |
待处理的「原始证据」→「详细信息」;身份的「证据 人工确认 · 校验通过 · r1」→「你确认的」/「自动匹配」 |
| 能力 / capability |
「Agent 能做的事」;具体项用动作名(查作品、提交下载) |
详情 |
审计里的 capability.invoke / capability.denied 显示为「Agent 查询 · 订阅列表」「Agent 被拒绝 · 检测站点健康」 |
| Agent 上游 / 上游 |
模型服务 / 模型 |
显示(改名后) |
MP 叫「AI Agent / 上游 provider」也不好;「上游登录刷新」每 10 分钟刷屏,见 §3.2。需拍板 |
| 巡检 |
巡检 |
显示 |
可保留;说明里去掉「能力白名单」 |
| 待识别 / 待识别池 |
未识别 |
显示 |
MP 用「未识别到媒体信息」。「池」字去掉(console-ia §6.4 早已记为遗留) |
| 身份 / 外部身份 |
「TMDB / IMDb 编号」;动作叫「识别」「改匹配」 |
详情 |
「身份歧义」统一成「识别有歧义」;tmdb:tv:90228 显示为「TMDB 90228」链接 |
| TMDB 映射 |
匹配的 TMDB 条目 |
详情 |
|
| 持续授权 |
「允许 Agent 自动执行 xx」 |
详情 |
只在 Agent 设置和巡检编辑框出现,不带 ID 前缀 |
| 审批 |
批准 / 拒绝 |
显示 |
保留;「会话内审批有效期」→「等你批准的最长时间」 |
| 幂等 / 幂等键 |
不出现 |
隐藏 |
工具调用卡片上的「幂等」徽章删,幂等键进审计详情 |
| 整理记录 |
整理记录 |
显示 |
与 MP「媒体整理 / 历史记录」一致,保留 |
| 库根 |
媒体库目录 |
显示(改名后) |
MP 叫「媒体库目录」;「实际路径与库根」→「文件位置」 |
| 登记目录 |
不单独命名,就是「目录」 |
隐藏 |
文件管理左栏已经按「下载目录 / 媒体库」分组,不需要这个词 |
| 哨兵 / 哨兵文件 |
「目录检查」;失败时说「目录不可访问或未挂载」 |
详情 |
按钮「检查哨兵」→「检查目录」 |
| 快照 |
「站点最新资源」/「抓取」 |
详情 |
站点卡「快照 22 分钟前」→「资源更新于 22 分钟前」;「实时补查」→「去站点搜」 |
| 账本 / 本地账本 |
不出现 |
隐藏 |
「本地账本:作品、版本目标、资产与外部身份」整句删 |
| 建档 / 已建档 |
「加入媒体库」/「已在库中,未下载」 |
显示(改名后) |
「建档不订阅」→「只加入媒体库」 |
| 修订 r1 / 草案 / 策略版本 |
「最后修改于…」;草案叫「未启用」 |
详情 |
列表的「修订」列删 |
| 抑制记录 |
「已忽略的资源」 |
显示(改名后) |
规则页签名 |
| 收录策略 |
「自动收新作品」 |
显示(改名后) |
规则页签;只在开启新作品自动收录时有意义 |
| 缓存卷 / 硬阈值 / 恢复水位 |
下载盘 / 暂停线 / 恢复线 |
显示(改名后) |
「保留期锁定 287.92 MB」→「做种保留中 288 MB」 |
| 进程 / 心跳 / SSE / 事件循环延迟 |
不出现在首页 |
详情 |
只在运行状态页的「高级」折叠区 |
3. 页面级问题
格式:截图 · 现象(原文) · 为什么 · 改成。
3.1 首页
| 截图 |
现象 |
为什么 |
改成 |
| 01-home |
横幅「自动化运行中」+ 绿点徽章「总开关开」+ 播放图标 +「0 个订阅在追踪,自动收录、下载和整理。」 |
三个信号说一件事;0 订阅配口号是空承诺 |
一行:「自动化已开启 · 0 个订阅」+ 右侧「暂停」。订阅为 0 时换成「还没有订阅。去搜索添加」 |
| 01-home |
首页有「只读对账」开关 |
恢复备份才用的运维开关,放首页既吓人又易误点 |
移到设置 → 自动化 → 高级;首页只在它开启时显示一条警告「只读模式:不会自动下载和整理」 |
| 01-home |
「排队 0 · 下载中 0 · 无进展 0 · 入库中 0」「满足 0 / 0 · 需关注 0 · 下载中 0」「新计划 0 · 提交下载 4 · 入库文件 5 · 升级 0」 |
0 值全部铺开,读者要自己找非零项 |
只显示非零项;全为 0 时不显示这一行 |
| 01-home |
「版本目标满足率 —」 |
内部指标名;分母为 0 时显示横线等于没说 |
分母为 0 时整块隐藏;有数据时「想要的版本已到齐 12 / 15」 |
| 01-home |
「最近完成 / 失败」6 行全是绿色「完成」徽章,副标题「处理待处理事项」「核验入库」 |
徽章泛滥;副标题是工作流名 |
只列失败和入库完成;成功不加徽章;副标题写结果「已入库」「识别失败」 |
| 01-home |
「缓存与保留:阈值 90% / 恢复 85% · 在途 0 B · 可清理 0 B · 保留期锁定 287.92 MB」 |
5 个运维参数挤一行 |
「下载盘 36% 已用 · 剩 1 TB」,细节进下载面板 |
| 01-home |
「运行状态:进程 3 在线 · 待执行 0 · 24 小时失败率 0.2% · 数据库 5.3 毫秒」 |
首页给普通用户看数据库延迟 |
正常时只显示「运行正常」一行或不显示;异常时显示问题本身 |
| 01-home |
「近 7 天 $0.0191」 |
四位小数制造精确感 |
「近 7 天 $0.02」,不足一分写「< $0.01」 |
3.2 任务
| 截图 |
现象 |
为什么 |
改成 |
| 02-tasks |
页描述「每次运行都是一条任务,不论定时、事件、手动还是 Agent 触发。」 |
解释数据模型,排比式列举 |
删,或「最近处理了什么、有没有失败」 |
| 02-tasks |
「评估候选 · 未关联业务对象 · ce28d777」「识别资源 · 未关联业务对象 · 37b8a16c」成片出现 |
内部步骤和短 ID 占满列表 |
默认隐藏无业务对象的运行,筛选里提供「显示系统任务」 |
| 02-tasks |
「上游登录刷新」每 10 分钟一条 |
后台保活刷屏 |
维护类定时任务成功时不进任务列表,只记在计划页 |
| 02-tasks |
耗时「20 毫秒」「206 毫秒」 |
毫秒级精度对用户无意义 |
小于 1 秒写「< 1 秒」 |
| 02b-tasks-failed |
标题「下载 c062c84a」,「未开始 · 19 小时前」 |
用 ID 当标题 |
用作品名 + 资源名;无作品时用资源标题 |
| 02-tasks |
行副标题「核验入库 · 下载」「处理待处理事项 · 待处理事项」 |
工作流名 + 对象类型,重复且拗口 |
只留一个:「入库检查」「识别」 |
3.3 计划
| 截图 |
现象 |
为什么 |
改成 |
| 03-schedules |
「图片缓存清理:删除超过保留天数的图片代理缓存文件(对照 MP 启动时的 clear_temp)」 |
实现备忘写进界面 |
「删除过期的海报缓存」 |
| 03-schedules |
「观察记录清理 … (observation,按 created_at)」「SSE 事件清理 … (sse_event,按 at;发布方另按条数裁剪)」「审计清理 …(audit_event…)」 |
表名、字段名上屏 |
把 18 项「维护」合并成一行「数据清理(9 项)」,展开后每项一句人话 |
| 03-schedules |
「备份:…目前用 umt backup(宿主机 cron 调用),未接入调度」,状态「未运行 · 未配置」 |
开发状态说明;一个不能用的开关占一行 |
未接入就不列;或只在运行状态页写「备份:上次 2026-09-28」 |
| 03-schedules |
「统计信息更新:对全库执行 ANALYZE,刷新查询规划用的统计信息」 |
数据库运维 |
放进「数据清理」组,文案「数据库维护」 |
| 03-schedules |
「到期重评:到了重评时间的收录位重新评估(忙时延后的发布、定时)」 |
「收录位」是术语表外的第三个 Slot 名 |
「重新检查等待中的资源」 |
| 03b-schedules-checks |
巡检卡片直接显示目标模板「巡检待处理({{now}}):有 {{openDecisions}} 条…」 |
模板变量上屏 |
卡片只显示一句用途「检查待处理并给建议」,模板进编辑框 |
| 03b-schedules-checks |
每张卡有「能力」6 个标签 + 3、预算、上游、触发条件、间隔、下次、每次费用、最近结果、最近会话 9 项 |
字段全铺 |
默认:名称、开关、间隔、上次结果与费用;其余进编辑框 |
3.4 Agent 会话与抽屉
| 截图 |
现象 |
为什么 |
改成 |
| 04b-agent-run |
「模型说的(未经核查)」+「仅供参考,不作为完成依据。」+「系统核实的结果」 |
同一个免责声明说了三遍,措辞防御 |
回复区不加标题;下面一行「实际结果:没有提交下载或整理」,有动作时列出链接 |
| 04b-agent-run |
徽章「没有产生业务动作」「运行已完成」「工具成功 7」「失败 1」「被拒绝 1」+ 四个 0 计数 + 「取自下载计划、下载任务和整理记录(生成于 …)。「已提交」指已进入下载器,整理成功才算入库。」 |
为可审计堆证据;0 计数和数据来源说明是噪音 |
只在有动作时显示计数;工具统计进「步骤」折叠区;数据来源说明删 |
| 04b-agent-run |
步骤列表显示 site.list(inclu…、site.health_c… |
工具函数名上屏 |
步骤只写人话,工具名进展开详情 |
| 04b-agent-run |
右栏「预算与用量:工具调用 9 · token 320.7k · 时长 41s · 费用(估算)$0.014」;头部「opencode-go/deepseek-v4.1-flash」 |
token、模型 ID 对普通用户无意义 |
默认只显示「费用约 $0.01 · 41 秒」,token 与模型进「详情」 |
| 04-agent |
会话列表标题是原始提示词:「在浏览器会话 16be7338-… 上直接调用一次 browser.solve_challenge,参数:…」 |
UUID、JSON 当标题 |
标题取模型生成的短摘要或截断到第一句;子会话默认折叠在父会话下 |
| 04-agent / 04c |
「交代目标,边做边汇报」出现在侧栏按钮、悬浮按钮;抽屉又写「交代目标,Agent 在授权范围内执行并汇报。(Ctrl+J 开关,Esc 关闭)」,输入框下再写「Agent 列出步骤后直接执行…Enter 发送,Shift+Enter 换行。」 |
口号式对仗重复 3 处;快捷键提示重复 4 处 |
侧栏按钮只写「Agent」+ 快捷键;删悬浮按钮或侧栏按钮其一;抽屉只保留 placeholder「例如:把沙丘:第二部的 4K 收进来」 |
| 04c |
收起按钮是带渐变描边的胶囊「收起 Ctrl+J / Esc 关闭」 |
渐变描边 + 发光,和侧栏、悬浮按钮三处同款 |
普通关闭按钮 × |
| agent-conversation.tsx |
「有副作用的能力需要有效的持续授权或单次审批,由服务端在执行前核对,模型声称"用户已同意"无效。」;工具卡片「幂等」徽章 |
安全设计说明写给用户 |
拒绝时只说「未执行:需要你批准」+「批准」按钮 |
3.5 站点与站点详情
| 截图 |
现象 |
为什么 |
改成 |
| 05-sites |
页描述「凭证、账号数据和健康状态;点站点名看资源、快照与 Feed」 |
列内容 + 操作指引,都能从界面看出 |
删 |
| 05-sites |
卡片:「健康检测 正常 · 1201 ms · 4 小时前」「快照 22 分钟前」「限流 默认」 |
毫秒延迟、限流、快照是运维字段 |
卡片只留账号数据 + 一行状态「正常 · 资源更新于 22 分钟前」;异常时写原因 |
| 05-sites |
徽章「账号正常」「Cookie」「VIP」 |
登录方式不需要徽章 |
只留「VIP」这类等级;状态正常不加徽章,异常才标 |
| 05b-site-overview |
「快照每 1 小时 1 页 · 健康检测每 6 小时 · 详情缓存 24 小时」「近 24 小时请求 22 次」「代理 不使用」 |
配置回显 |
放进「编辑站点」 |
| 05b / 03 |
站点页「健康检测每 6 小时」,计划页「站点健康检测 每 1 小时」 |
两个数字说的是扫描间隔和单站间隔,用户看到的是矛盾 |
计划页写「每 1 小时检查一次哪些站点到期」或直接不在计划页列出 |
| 05c-site-resources |
每行资源都有「已识别,无版本目标」 |
默认情况重复 50 次 |
只标需要注意的:「未识别」「已在库中」「可洗版」 |
| 05c-site-resources |
按钮「快照」「实时补查」,角落「近 24 小时请求站点 22 次」 |
实现术语 |
「刷新」「去站点搜」;请求次数进站点详情 |
| 05e-site-accounts |
账号页的「Passkey」(站点 RSS 密钥)与账户设置里的「Passkey」(登录用生物识别)同名 |
同名两物 |
站点这边写「站点 Passkey(RSS 与下载链接用)」,账户那边写「通行密钥(Passkey)」 |
| 截图 |
现象 |
为什么 |
改成 |
| 06-rss |
侧栏叫「RSS 订阅」,页标题叫「来源健康」,表格节标题叫「FEED」,术语表叫「Feed」 |
一物三名 |
全站统一「RSS」;页标题「RSS」,节标题「RSS 地址」 |
| 06-rss |
页描述「单个站点的快照、Feed 和账号在站点页管理。」 |
用说明文字修补 IA |
删;站点名本身可点 |
| 06-rss |
「站点」表格与站点页重复(健康、账号、最近快照) |
同一信息两处 |
本页只列 RSS;站点健康只在站点页 |
| 06-rss |
列「用途:通用」 |
只有一个取值时是噪音 |
只有非通用时显示 |
3.7 订阅与订阅详情(源码)
| 位置 |
现象 |
为什么 |
改成 |
| 07-subscriptions |
筛选栏 11 组(类型、批量、状态 6 值、站点、规则组、来源、洗版、排序),库里 0 条订阅时全部显示 |
空库也铺满控件 |
0 条时只显示空态和「新建订阅」 |
| 07-subscriptions |
空态「从媒体库、搜索或 Agent 添加,也可以点「新建订阅」。」 |
列举三个入口 |
「还没有订阅。」+ 按钮「新建订阅」 |
| coverage-matrix.tsx |
「临时单元」「还没有正式的内容单元」「按版本目标逐集对比」 |
内部概念 |
「编号待确认」「按版本逐集查看」 |
| subscriptions.$id.tsx |
「按选择顺序串联;不选 = 订阅默认规则组。版本目标自己的规则组另算」「空 = 24;0 = 关」「空 = 按 TMDB;不锁定时只升不降」 |
规则引擎语义写成等式 |
字段默认值直接填进输入框作为 placeholder;规则组说明只留「不选时用默认规则组」 |
| subscriptions.$id.tsx |
「季建好后不能改;要换季就新建订阅」 |
好文案 |
保留 |
3.8 规则
| 截图 |
现象 |
为什么 |
改成 |
| 08-rules |
页描述「规则组决定哪些资源能下载、同一作品优先挑哪个。收录策略决定哪些新作品自动收录。」 |
两句对仗定义 |
删;页签名本身要自解释 |
| 08-rules |
页签「规则组 / 自定义条件 / 默认值 / 收录策略 / 抑制记录」 |
五个里三个是内部名 |
「规则组 / 自定义条件 / 默认规则 / 自动收新作品 / 已忽略」 |
| 08-rules |
列「修订 r1」「引用 默认链」 |
版本号与引用关系 |
删「修订」列;「引用」写「订阅默认」这种具体用途 |
| 08b-rules-atoms |
13 个关键字各写「不支持,规则串里出现会报错」;标题「对齐 MoviePilot;判定依据按解析字段优先」 |
列出不支持的东西;实现备忘 |
不支持的关键字不列,或合并为一行「音乐相关关键字暂不支持」;副标题删 |
| 08c-rules-defaults |
「链上的组按顺序串联,任一组拒绝即拒绝,优先级取最后一个带层的组。」 |
算法描述 |
「按顺序检查,任一组不通过就不下载。」「带层」概念不出现 |
| 08d-rules-policies |
策略名「AGENT-REAL 最小收录策略(测试)」,按钮「新建策略草案」「基于 r1 新建草案」 |
测试数据留在用户栈;草案 / 发布模型外露 |
清理测试数据(数据问题,另开);按钮「新建」「复制并修改」 |
3.9 下载面板
| 截图 |
现象 |
为什么 |
改成 |
| 09-downloads |
页描述「阈值暂停不能手动绕过;无进展只记录,不自动换源。」 |
两条否定式声明当首屏第一句 |
删;在暂停的任务行上写「磁盘超过 90%,已暂停」 |
| 09-downloads |
「qB 测试 36.2% · 604.4 GB / 1.6 TB · 硬阈值 90% / 恢复 85% · 在途 0 B · 预留 0 B · 可清理 0 B · 保留锁定 287.9 MB」 |
7 个数一排 |
进度条 + 「已用 604 GB / 1.6 TB」;其余进「详情」 |
| 09-downloads |
每行徽章「接管」,筛选「纳管」 |
内部概念,且每行都一样 |
删徽章;筛选「来源:本工具 / 其他」 |
| 09-downloads |
Interstellar 行状态「下载完成」,但整理两次失败 |
状态没反映真实问题 |
状态列写「入库失败:目标已存在」并链到待处理 |
| 09c-download-detail |
时间线「0/0 文件成功 · identity_unknown」「blocked:target_exists」 |
错误码原样上屏 |
「没有识别出作品」「媒体库里已有同名文件」 |
| 09c-download-detail |
时间线筛选「观察 · 无 / 计划 · 无 / 下载 · 2 / 整理 · 2 / Agent · 无 / 任务 · 2」,标题「业务时间线」 |
空类别也列;「业务」是开发词 |
标题「经过」;只显示有记录的类别 |
| 09c-download-detail |
「torrent hash 31090bf…」直接列在概况 |
技术信息占首屏 |
进「详情」折叠 |
| 09b-download-plans |
「候选被选中后生成计划,同时预留版本目标、空间与预算。」 |
机制说明 |
删;空态「还没有下载计划」 |
3.10 整理记录
| 截图 |
现象 |
为什么 |
改成 |
| 10-organize |
失败原因列显示 identity_unknown、blocked:target_exists |
服务端把错误码当 message 返回(organize.ts:393、:641),前端原样显示 |
服务端给中文 message;前端已有映射 organize-wizard/model.ts 的 target_exists: "目标已存在",统一复用 |
| 10-organize |
「未关联作品 · — · 失败 · 复制 0/0」连续 4 行 |
0 文件的失败记录 |
合并为一行「4 次未识别,未整理」或只在待处理出现 |
| 10b-organize-detail |
「变更游标 35」「记录 ID」「任务 ID」「执行进程本地」「未知或未授权」 |
同步接口字段、内部 ID |
进「技术信息」折叠;「未知或未授权」改「未整理」 |
| 10b-organize-detail |
按钮「让 Agent 排查」 |
可以 |
保留 |
| 10-organize |
页描述「每次整理的前后路径与逐文件结果,自动和手动整理都记在这里。」 |
能看出来 |
删 |
3.11 文件管理
| 截图 |
现象 |
为什么 |
改成 |
| 11-files |
左栏下载目录与媒体库各带「正常」徽章和「剩余 1 TB」,底部又一处「剩余 1 TB」 |
同一信息两次;正常态徽章 |
正常不标;剩余空间只在底栏 |
| 11-files |
行摘要「1 视频 · 0 已登记」 |
「已登记」是内部状态 |
「1 个视频 · 未入库」 |
| 11-files |
筛选「临时文件」「已登记」 |
同上 |
「未完成下载」「已入库」 |
| 库根设置 |
「没有可写的库根。在设置里把库根设为纳管后再选。」(dir-picker.tsx) |
双重术语 |
「没有可写入的媒体库目录。去设置添加」 |
3.12 媒体概览与作品详情
| 截图 |
现象 |
为什么 |
改成 |
| 12-library |
侧栏「媒体概览」,详情页面包屑「媒体库」 |
一物两名 |
统一「媒体库」(MP 同) |
| 12-library |
描述「本地账本:作品、版本目标、资产与外部身份。自动匹配不覆盖人工锁定的外部身份。」 |
比喻 + 规则声明 |
删 |
| 12-library |
页签「作品 / 待识别 / 外部身份 / 别名」 |
后两个是维护工具 |
默认只留「作品 / 未识别」;外部身份、别名进作品详情 |
| 12c-library-identities |
行「tmdb:tv:90228 · 已确认 · 人工确认 · 校验通过 · r1 · 23 分钟前」 |
键值串 + 三个同义状态 |
「TMDB 90228 · 你确认的」 |
| 12a-library-unidentified |
原因「未命中订阅」,列「尝试 1 次 · 26 分钟前」「下次复查 24 小时后」 |
未命中订阅不是问题,不该叫原因 |
这类资源默认不进「未识别」,只放真正需要人处理的 |
| 12b-library-detail |
标题下直接显示 UUID d1fd8828-…;「以本地 ID 为准,外部身份可修改」 |
内部 ID 与实现声明 |
UUID 进「更多 → 复制 ID」;说明删 |
| 12b-library-detail |
「字段来源与锁:锁定的字段刷新时不变」,每字段「来源 TMDB · zh-CN · 26 分钟前 · 候选:TMDB「2014」」 |
字段溯源铺满 |
默认折叠为「元数据来自 TMDB · 更新于 26 分钟前 · 编辑」 |
| 12b-library-detail |
别名一次铺出 80 多种语言 |
无筛选的数据倾倒 |
只显示中英文与用户添加的,其余「+83」 |
| 12b-library-detail |
「实际路径与库根:路径绑定建立后不随译名变化」,每个文件「主位置 · 可访问 · 已核验」 |
同上 |
「文件」一节,每行路径 + 大小;异常才标 |
3.13 设置(9 区)
| 截图 |
现象 |
为什么 |
改成 |
| 13-settings-automation |
「存储预算」「流水数据保留」「缓存有效期」三组 13 个天数 / GB 字段,含「Feed 观察」「实时事件」「进程心跳(小时)」「能力调用统计」「负缓存」 |
每张表一个旋钮 |
用户层只留:源文件保留天数、日志保留天数、图片缓存上限;其余进「高级」且默认折叠 |
| 13-settings-automation |
「只读对账:从备份恢复后先开启:只核对库存与路径,不做自动写入。核对完再关闭。」 |
好文案,位置不对 |
文案保留,移入「高级」 |
| 13-settings-sites |
「浏览器服务:原站视图和 Agent 打开站点网页用的 camofox-browser。部署自带的一台由环境变量登记(camofox-env)。」 |
组件名、部署细节 |
「浏览器服务:打开站点网页用。」;实例名显示「内置」 |
| 13-settings-library |
「登记或改路径时会在目录里写哨兵文件 .uhd-root,据此判断库根是否在线」;按钮「检查哨兵」 |
实现机制 |
「保存时会在目录里放一个标记文件,用来判断目录是否挂载。」按钮「检查目录」 |
| 13-settings-library |
命名模板变量表里的「MP 无」标签 |
给开发者的对照 |
删 |
| 13-settings-metadata |
「旧行为。每条资源约 1–2 次搜索 + 命中时 1 次详情(识别缓存命中为 0);每小时 100 条的 RSS 约每天 2400–7200 次请求…」 |
实现细节 + 「旧行为」是开发者口吻 |
「每条新资源都查一次 TMDB。RSS 量大时每天可能上千次请求。」 |
| 13-settings-agent |
MCP 区块「Streamable HTTP(POST / GET / DELETE)」「read 16 个 · read + organize.execute 26 个 · admin 35 个」「授权、审计、幂等与控制台一致」 |
接入文档写在设置里 |
设置只留开关、端点、复制配置;其余进 docs 链接 |
| 13-settings-agent |
「fake 脚本(JSON):只对 fake 上游生效」「会话目录:api 与 worker 都要可读写」 |
开发调试项 |
生产构建隐藏 |
| 13-settings-api-keys |
scope 名 organize.read / organize.execute 直接作为选项 |
可接受(给开发者用的页) |
保留英文 scope,前面加中文名「只读 / 读整理记录 / 执行整理 / 管理员」 |
| 全部分区 |
页描述「全局参数、实例与凭证。凭证保存后不回显。」 |
前半句空泛 |
只留「密钥保存后不再显示。」 |
3.14 运行状态
| 截图 |
现象 |
为什么 |
改成 |
| 14-status |
进程表「9428df7231e2 · pid 29」「io 4 · Agent 0」「SSE 3」 |
容器 ID 与 pid |
这是管理员页,可以保留,但放在「进程」折叠区;默认视图是一行结论「全部正常」 |
| 14-status |
「体积最大的表(前 10)· 含索引与 TOAST」列出 metadata_field、agent_run_event、openworkflow.workflow_runs |
数据库内部表 |
移到「高级 → 数据库」,默认折叠 |
| 14-status |
首页「失败 0」,本页「24 小时失败运行 2」,任务页失败页签「2」 |
三处口径不同 |
首页计划块写「上次失败 0 项」,和本页「24 小时失败」分开表述 |
| 14-status |
「已下线实例 33 个 · 不计入告警,24 小时后清理」 |
容器重建历史 |
删,或只在进程折叠区 |
| 14-status |
图表图例「api · 29api · 29api · 29…」重复拼接 |
渲染问题 |
修图例(bug,单独处理) |
3.15 待处理 / 收件箱
| 截图 |
现象 |
为什么 |
改成 |
| 15-inbox |
身份类事项只有「原始证据」和「忽略」,没有主操作 |
用户来这里就是要处理,最重要的按钮缺了 |
加「指定作品」主按钮;「原始证据」→「详细信息」 |
| 15-inbox |
每条都挂「警告」「待处理」两个徽章 |
全部一样的徽章等于没有 |
删状态徽章(页面已按状态筛选);级别只标「严重」 |
| 15-inbox |
分组「身份歧义 · 尚未归属作品」「路径冲突 · 系统级」 |
分组名是内部分类 |
「没识别出作品」「媒体库里已有同名文件」 |
| 15-inbox |
路径冲突事项正文 target_exists |
错误码 |
「媒体库里已有《星际穿越 (2014)》的同名文件」 |
| 15-inbox |
描述「Agent 调查和重试后仍未解决的事项,按作品和问题类型合并」;事项创建于「刚刚」 |
声称经过调查,实际未必 |
「需要你决定的事」 |
| 15b-inbox-bell |
铃铛下拉写「识别有歧义」,页面写「身份歧义」,首页写「无法确定作品」 |
一物三名 |
统一「没识别出作品」 |
3.16 全局搜索与作品预览
| 截图 |
现象 |
为什么 |
改成 |
| 17-search |
描述「先看作品和库内状态,需要时再到站点搜资源。」 |
教用户流程 |
删 |
| 17-search |
状态「已建档 · 未入库」「未收录」 |
「建档」「收录」都是内部词,两者区别用户不懂 |
「在媒体库 · 未下载」「不在媒体库」(MP:「已入库 / 缺失」) |
| 17b-command-palette |
底部三条提示「作品卡上可以选站点搜资源」「↑↓ 选择 ↵ 打开」「搜资源在作品详情页」 |
两条说同一件事 |
只留键位提示 |
| 18-tmdb-preview |
按钮「订阅 / 搜索资源 / 建档不订阅」 |
「建档」 |
「订阅 / 搜索资源 / 加入媒体库」 |
| 18-tmdb-preview |
「库内对比:本地账本按 TMDB 身份对应;Emby 查询失败记为未知,不等于缺失」 |
实现声明 |
标题「库中情况」;说明删,Emby 失败时就写「Emby 查询失败」 |
3.17 审计与外壳
| 截图 |
现象 |
为什么 |
改成 |
| 16-audit |
每行动作列同时显示中文和代码「登录 admin.login_success」,对象列显示 UUID |
双语重复 + ID |
代码与 ID 进行详情;对象显示名称 |
| 16-audit |
「capability.denied」没有中文名 |
翻译漏了 |
「Agent 操作被拒绝」 |
| 全局 |
页面标题 + 描述 + 侧栏说明三层,几乎每页描述都在解释页面 |
模板化 |
列表页默认不写描述;只在需要做决定的页(设置分区)写一句 |
| 全局 |
Agent 入口三处:侧栏顶部渐变按钮、右下渐变悬浮按钮、侧栏「Agent 会话」 |
冗余 + 发光渐变 |
保留侧栏项和快捷键;悬浮按钮删或只在窄屏出现 |
4. 设计层面
信息层级。每页默认视图只回答「现在有没有事要我管」。技术信息分三层:正常视图(名称、状态、结果)→ 详情(路径、时间线、来源)→ 技术信息折叠区(ID、hash、trace、token、模型 ID、错误码)。现在大多数页把第三层放在第一层。
首页该回答的三个问题:
- 有没有要我处理的?(待处理数 + 前 3 条,每条带主操作)
- 最近拿到了什么?(今日入库的作品,海报或列表,MP 的「近期入库」)
- 有没有东西坏了?(只在出问题时出现:站点登录失效、下载盘快满、服务异常)
计划带、运行状态、缓存参数、版本目标满足率都不属于这三个问题,移出首页或改为异常时才出现。
徽章、图标、色块。徽章只用于「不正常」和「需要区分的类别」。正常态(完成、正常、已启用、账号正常、待处理)不加徽章。一行最多一个徽章。卡片内的小卡片(首页媒体概览的三个统计块、待处理页顶部三张计数卡)改成一行文字数字,去掉套娃圆角。
表格 vs 卡片。同类对象多于 5 个用表格(任务、整理记录、下载、计划);站点这种少量、每个有多项数据的对象用卡片。计划页巡检卡字段太多,应改表格 + 编辑框。
动效信号。「实时」徽章 + 「更新于 刚刚」+ 刷新按钮 + 自动刷新,四个信号说一件事,留一个「更新于 刚刚」即可。Agent 按钮的彩色渐变描边与发光在侧栏、悬浮按钮、抽屉收起按钮三处重复,品牌色集中在一处用。
5. 优先级改造清单
5.1 P0:误导或吓人
| # |
改什么 |
文件 |
工作量 |
| 1 |
错误码不上屏:整理失败 message 改中文(identity_unknown、blocked:*),前端统一走一张原因映射表 |
apps/server/src/modules/acquisition-organize/services/organize.ts、apps/web/app/lib/labels.ts、routes/console/organize*.tsx、routes/console/inbox.tsx、components/downloads/business-timeline.tsx |
0.5 天 |
| 2 |
待处理身份类事项加主按钮「指定作品」 |
routes/console/inbox.tsx |
0.5 天 |
| 3 |
首页「0 个订阅在追踪,自动收录…」改为按数据说话;0 值行隐藏 |
routes/console/home.tsx |
0.3 天 |
| 4 |
下载行状态反映入库失败,而不是「下载完成」 |
routes/console/downloads.tsx、components/downloads/* |
0.5 天 |
| 5 |
「只读对账」移出首页 |
routes/console/home.tsx、components/settings/automation.tsx |
0.2 天 |
| 6 |
「身份歧义 / 识别有歧义 / 无法确定作品」统一一个说法 |
components/library/labels.ts、lib/labels.ts、服务端 routes/decisions.ts |
0.3 天 |
5.2 P1:高频页面的噪音
| # |
改什么 |
文件 |
工作量 |
| 1 |
Agent 会话:三段免责合并为一行「实际结果」;token、模型 ID、工具名进详情;会话标题不用原始提示词 |
components/agent/agent-conversation.tsx、routes/console/agent.tsx |
1 天 |
| 2 |
Agent 入口去重与去口号(「交代目标,边做边汇报」删,悬浮按钮删或限窄屏) |
components/console/agent-launcher.tsx、components/agent/agent-drawer.tsx、routes/console/layout.tsx |
0.5 天 |
| 3 |
任务列表默认隐藏无业务对象的运行和维护类成功运行;标题不用 ID |
components/tasks/task-stream.tsx、routes/console/tasks.tsx |
0.5 天 |
| 4 |
计划页维护类 18 项合并折叠,说明去表名 |
components/schedules/auto-task-list.tsx、服务端定时任务描述(modules/system/retention.ts 等) |
0.5 天 |
| 5 |
首页重排为三个问题;运行状态、缓存参数、满足率移出或异常才显示 |
routes/console/home.tsx |
1 天 |
| 6 |
全站删解释型页描述(约 15 处),只保留设置分区的一句话 |
components/console/nav.ts、各 routes/console/*.tsx 的 PageHeader |
0.5 天 |
| 7 |
正常态徽章清理:完成、正常、账号正常、接管、待处理 |
home.tsx、sites/site-card.tsx、downloads.tsx、inbox.tsx、files.tsx |
0.5 天 |
| 8 |
术语落地:RSS 统一、媒体库统一、「建档 / 收录」、「资产」「账本」「纳管」「哨兵」「快照」按 §2 改,同步更新 glossary.md |
全站 + docs/design/glossary.md |
1 天 |
| 9 |
作品详情:UUID、字段来源、别名全集、路径核验折叠 |
routes/console/library.$id.tsx |
0.5 天 |
5.3 P2:细节
| # |
改什么 |
文件 |
工作量 |
| 1 |
费用统一两位小数,< 0.01 写「< $0.01」;耗时 < 1 秒写「< 1 秒」 |
lib/format*.ts |
0.2 天 |
| 2 |
规则页:不支持的关键字不列;「修订」列删;页签改名 |
components/rules/tabs.tsx、components/rules/labels.ts |
0.3 天 |
| 3 |
设置高级项折叠:存储预算、流水保留、缓存有效期、fake 脚本、会话目录、MCP 详情 |
components/settings/*.tsx、packages/contracts/src/settings.ts(字段加 advanced 标记) |
0.5 天 |
| 4 |
运行状态页默认只显示结论,表体积、进程、已下线实例折叠;修图例重复 |
routes/console/status.tsx、components/status/* |
0.5 天 |
| 5 |
审计行去掉代码与 UUID,补 capability.denied 中文 |
routes/console/audit.tsx |
0.2 天 |
| 6 |
站点 Passkey 与登录 Passkey 区分命名 |
components/sites/site-accounts-tab.tsx、components/settings/account*.tsx |
0.1 天 |
| 7 |
命令面板提示去重 |
命令面板组件 |
0.1 天 |
| 8 |
清掉用户栈里的测试策略「AGENT-REAL 最小收录策略(测试)」 |
数据,不是代码 |
另开 |
合计约 P0 2.3 天、P1 6 天、P2 2 天。
5.4 需要用户拍板
- 「版本目标」是否改名。候选:「想要的版本」(直白,略长)或沿用 MP 的思路只在升级场景说「洗版」、其余场景说「版本」。改名涉及 139 处字符串和给模型的提示词。
- 是否默认隐藏技术信息。建议:ID、hash、token、模型 ID、错误码、表名一律进「技术信息」折叠区;是否提供全局开关「显示技术细节」(管理员默认关)。
- 「Agent 上游」改不改成「模型服务」。glossary 刚定过「Agent 上游」;用户侧「模型」更好懂,但设置里有 provider / 认证 / 订阅登录,改名要一起理。
- 计划页是否只展示用户关心的 11 项,18 项维护任务收成一行「数据清理」。
- 首页是否删掉「运行状态」「计划」两块,只在异常时出现。
- 「收录」「建档」两个词是否全站退场,换成「加入媒体库 / 在媒体库 / 已下载」。
- Agent 会话里「模型说的(未经核查)」这层防护是否保留。建议保留一个很轻的标记(回复旁一行「以下是模型的说法」),删掉另外两处。
6. DEAI-2 处理情况(2026-09-29)
用户拍板(见 docs/plan/00-first-version-plan.md):「版本目标」→「收录版本」;「Agent 上游」→「模型服务」;界面上的 Agent → 「智能体」;技术信息默认折叠(设置 → 界面可默认展开);首页只留三块;计划页维护类收成「数据清理」、智能体巡检置顶;「未经核查」只在最终汇报留一处。术语落地见 glossary.md。
P0
| # |
状态 |
说明 |
| 1 |
完成 |
原因码表 packages/contracts/src/reasons.ts,服务端整理记录 message、冲突事项标题/摘要与前端(整理记录、下载时间线、待处理摘要、任务详情)共用;原码进「技术信息」 |
| 2 |
完成 |
「指定作品」主按钮:搜媒体库 + TMDB,走已有 decision resolve(local_entity / manual_tmdb);整理类事项打开重新整理,整理成功后自动关闭事项 |
| 3 |
完成 |
首页状态行按数据说话,0 订阅写「还没有订阅。去搜索添加」 |
| 4 |
部分 |
下载详情在「下载完成但最近一次整理失败」时单独提示入库失败并链到待处理;下载列表行状态未改——需要服务端在下载任务上带最近整理结果,QB-1 正在改整理服务,留给合并后另做 |
| 5 |
完成 |
只读对账移出首页,放进设置 → 自动化 →「高级」 |
| 6 |
完成 |
统一为「没识别出作品」(事项);未确认身份的资源叫「未识别」 |
P1
| # |
状态 |
说明 |
| 1 |
完成 |
见提交说明;对话组件结构不动(另有代理出易用性方案) |
| 2 |
完成 |
删口号;悬浮按钮只在无侧栏的窄屏出现,抽屉打开时不再显示胶囊 |
| 3 |
完成 |
默认隐藏系统任务(可一键显示),标题不用 ID |
| 4 |
完成 |
维护类合成「数据清理」组;自动任务按分类折叠并记忆;说明去表名 |
| 5 |
完成 |
|
| 6 |
完成 |
约 14 处页描述删除或改一句 |
| 7 |
完成 |
首页、站点卡、下载、待处理、文件管理、整理记录 |
| 8 |
完成 |
RSS、媒体库、建档 / 收录、资产、账本、纳管、哨兵、快照;「外部身份」一词在作品详情改「匹配的 TMDB 条目」,其余处保留 |
| 9 |
完成 |
UUID、字段来源、别名全集、路径核验 |
P2
| # |
状态 |
说明 |
| 1 |
完成 |
formatUsd、formatDuration |
| 2 |
完成 |
|
| 3 |
部分 |
自动化分区的只读对账 / 存储预算 / 流水保留 / 缓存有效期收进「高级」;会话目录与 fake 脚本只在开发构建显示;没有在 contracts 加 advanced 标记(纯前端即可) |
| 4 |
完成 |
进程、趋势、最大表折叠;图例同名序列加序号 |
| 5 |
完成 |
|
| 6 |
完成 |
|
| 7 |
完成 |
|
| 8 |
不做 |
用户栈数据,不是代码 |
页面级条目中不做的
- 05b 站点概况的配置回显、05c 资源行「已识别,无收录版本」、「实时补查」按钮位置:DETAIL-1 / SEARCH-3 正在改站点详情与资源列表,只改了名词(抓取、去站点搜),结构留给它们。
- 10 整理记录里连续的 0 文件失败行合并:需要服务端按下载任务聚合,放到 QB-1 合并之后。
- 12 媒体库页签只留「作品 / 未识别」、「未命中订阅」不进未识别:DH-1 正在改身份服务,避免冲突。
- 13-settings-agent MCP 区块的能力计数与接入说明移到文档:保留,只改了一句说明。
- 14 「已下线实例 N 个」文案:已随进程区折叠,文案不改。
