rootandClaude Opus 5.5
d53df25fc8
- adapters/websearch: Brave client (X-Subscription-Token, error classes), result normalization with redaction/truncation, SSRF guard, HTML→text fetch (10s, 512KB, text/html|text/plain only) - modules/websearch: 10-min PG cache (region websearch), cross-process per-minute limit, web.fetch allowlist = URLs from the caller's latest web.search; POST /websearch/test - settings.agent.webSearch (key write-only → secret_ref); settings card under Agent; web.* offered to the model only when enabled, plus a system prompt rule; outputs marked untrusted - capability count 27 → 29; e2e E13; runbook docs/runbook/websearch.md Co-Authored-By: Claude Opus 5.5 <[email protected]>
6.4 KiB
6.4 KiB
术语表与文案规则
界面、错误信息、Agent 提示词里同一概念只用一个名字。代码标识符(slot、decision、feed)不受限制。依据 REQ v0.7 §3.1。
术语
| 概念(代码) | 界面用词 | 不用 |
|---|---|---|
| MediaEntity | 作品 | 媒体实体、条目、影片 |
| ContentUnit | 季 / 集;统称"内容单元" | 单元、分集单元 |
| Slot | 版本目标 | Slot、收录目标、目标槽。给模型的说明可写一次"版本目标(slot)"对应参数名 |
| AcquisitionPolicy | 收录策略(版本号称"策略版本") | 收录规则、规则集 |
| RuleGroup | 规则组;条件叫"关键字"(内置)/"自定义条件";只有一条规则的组在规则页以"偏好"标签显示 | 偏好标签、过滤规则、规则集 |
| 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 上游、模型上游 |
| PiUpstream | Agent 上游;在 Agent 设置分区和上游页内简称"上游" | Pi 上游、模型上游、Provider 配置 |
| OAuth 型上游的登录 | 订阅登录 | OAuth 登录、账号授权 |
| 密钥、Cookie、密码、令牌的统称 | 凭证 | 凭据、认证信息 |
| ScheduledJob | 定时任务 | 计划任务、周期作业、cron 任务 |
| kind=agent_check 的定时任务 | 巡检 | 巡查、Agent 定时任务 |
| 定时任务每次执行的记录 | 运行记录 | 历史、执行历史 |
| AgentRun(parent_run_id 非空) | 子会话;派生它的叫"父会话" | 子代理、子 Agent、subagent |
| AgentRun 被中止 | 停止;状态"已停止" | 中止、取消 |
| AutomationGrant | 持续授权 | 自动化授权、automation_grant |
| agent.plan 的步骤清单 | 步骤;进度写"步骤 2/5" | 计划(计划只指下载计划 / 整理计划)、TODO、任务列表 |
| web.search / web.fetch | 网页搜索 / 读取网页;设置卡叫"网页搜索",提供方叫"搜索服务" | 联网、上网、爬取、网络代理 |
| agent.propose_options | 方案;动作叫"选定",都不要叫"退回" | 选项、提案 |
| scope.proposeFirst | 先看方案再执行 | 只要方案、只给方案、plan_only 模式 |
| 工作流引擎的一次执行 | 运行 | run |
| 正在写心跳的进程(process_heartbeat 当前行) | 当前实例;横幅按角色称呼:API / io worker / Agent worker / 单进程 | 活进程、在线实例 |
| 已退出、容器已重建或被同容器新进程替换的心跳行 | 已下线实例;正常退出的标"已退出" | 历史实例、僵尸进程、死进程 |
文案规则
- 先说结果。能删的词删掉,删后不影响理解、判断、操作就删。
- 错误说清发生了什么和怎么办,最多两句;不知道原因就不猜。
- 按钮 2–6 字,以动词开头:"保存""重新预览""移入回收站"。
- 空态一句:这里会出现什么,下一步做什么。
- 说明文字只写用户做决定需要的事实(条件、后果、是否可恢复)。
- 不写"您""请""欢迎""我们""系统将""温馨提示"。
- 不用营销词和 AI 高频词:轻松、无需、只需、极致、智能、赋能、一站式;不写"不是…而是…"和排比对仗。
- 数字和状态来自数据,不写产品没有的承诺。
- 技术词保留原文:API Key、Cookie、TMDB、infohash、hash。
- 标题、按钮、标签、Toast 末尾不加句号。
- 订阅登录的条款提示只陈述事实:借用哪个官方客户端身份、可能违反条款、账号可能被限流或封禁;不劝阻,不美化。
- 给模型看的文字(巡检目标、调查提示)同样适用:具体、短,用界面同一套术语。
标点
界面文字、错误信息、给模型看的提示都按这一节写。deno task check:copy(scripts/check-copy-punctuation.mjs)检查源码里的字符串字面量与 JSX 文本,--fix 自动改能确定的项;确需例外的行写 copy-allow: 原因。
- 中文句子用全角标点:
，。；：？！、。半角, ; : ? !只出现在代码、路径、URL、键值、时间(12:30)和整句英文里。 - 全角标点前后不加空格;不叠用标点(不写
，。、！！、？！)。 - 括号里有中文用全角
（）,紧贴前后文字;括号里只有英文、数字、代码时用半角(),前面是英文时空一格:Oppenheimer (2023)、读取失败(ENOTCONN)。 - 中文与英文、数字之间空一个半角空格:
3 个作品、打开 Agent、TMDB 不可用;行首行尾和全角标点旁不加。 - 数字与单位:
%、°紧贴数字(80%);英文单位空一格,与formatBytes输出一致(1.1 TB、15 s);数字和字母组成的记号连写(1080p、S01E02、H.265、4K)。 - 省略号只用一个
…(U+2026),不用...或……;进行中状态写加载中…,菜单项"需要再选一步"写移动到…。 - 标题、按钮、标签、表头、列表项、Toast 末尾不加句号(同文案规则 10)。
- 说明文字(空态描述、表单说明、段落)每句以句号结尾;只有一句短语时可以不加。
- 错误信息:一句不加句号;两句("发生了什么。怎么办")句间用句号,末尾不加。
- 引用界面上的词、用户起的名字用直角引号
「」(勾选「同时退役资产」、删除「默认规则」？),不用“”或"";代码、命令、键名用代码样式,不加引号。