docs(plan): v0.2 adds Pi subagents and scheduled-jobs board

Co-Authored-By: Claude Fable 5.1 <[email protected]>
This commit is contained in:
rootandClaude Fable 5.1 committed 2026-09-28 02:09:39 +08:00
1 parent b839ed4056
commit 16ab2a6c84
97 files changed
+592 -648

No files matched your search

+44
View File
@@ -0,0 +1,44 @@
# 术语表与文案规则
界面、错误信息、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 末尾不加句号。
+2
View File
@@ -97,3 +97,5 @@ scripts dev/ci 辅助脚本
## 7. v0.2 方向(用户 2026-09-28)
- Pi 上游全覆盖:pi-ai 全部 provider + 订阅式 OAuth 登录(Codex/ChatGPT、OpenCode Go、Claude、Copilot、Google 等),多上游共存与默认上游,服务端 token 刷新;方案 `docs/design/pi-providers.md`。
- 控制台信息架构重构:参考 MoviePilot 前端("发现→订阅→下载→整理→设定"流程;设定按接入对象分区),方案 `docs/design/console-ia.md`,用户审阅后实施(nav/路由重定向、设置页重构 + settings 迁移、页面合并)。
- **Pi 子代理**(用户 2026-09-28):SDK 无子代理,自研 `agent.spawn` 能力:父 run 派生有界子 run(同 runAgent 任务、独立会话文件),继承父授权上限、共享总预算与取消状态、并发上限(settings.pi.subagents{enabled,maxConcurrent,maxDepth}),子结果回填父会话为工具输出;UI 在会话页显示子会话树。
- **定时任务看板**(用户 2026-09-28,参考 MP「服务」页):`scheduled_job` 表 + 注册表统一管理所有周期任务(feed 轮询、站点快照、订阅搜索、qB 同步、对账、缓存清理、回收站清理、Pi token 刷新、备份、待识别复查)与「Agent 巡检」(目标模板、能力白名单、预算、触发条件);每项:间隔/cron、开关、立即执行、上次/下次运行、最近结果与耗时、失败原因、历史;各模块的 `start()` 计时器改为向注册表登记;页面做成看板(卡片分组:采集/下载/整理/维护/Agent 巡检)。