🖥️ CGS Server / MCP

目前主要用于托盘化提供给 rv-app 通讯下载的能力，使用参考左侧视频 01:50 之后

托盘启动入口在主界面进配置窗口点 CGS Server 按钮

要点解析

下载运行时互斥：主界面打开则 托盘进程 进 被占用 ，
主界面退出则释放，避免交叉提交
托盘管理窗口带一些基本的日志状态等信息，可以自行检察状态

托盘管理窗口

Schedule / Server / MCP 三标签页

Schedule = 订阅执行面

追更的 检查与下载只由 CGS Server 托盘调度执行。主界面订阅管理面板（窗体标题「订阅管理」）只维护档案、书目、检查窗、站点代理开关、分享链 / 订阅源；
没有「立即执行」。需要手动跑一轮时，用托盘菜单「调度执行」。

标签页	内容
Schedule	下次检查、自动化状态、立刻执行、运行阶段、pending、历史、缓存状态、Debug payload
Server	connect URL / bind / surfaces；错误列表仅收 Server 自身错误，点行看详情
MCP	endpoint / bridge / Auth、tools / resources、调用记录、详情、Debug 抽屉

订阅 / Schedule

职责拆分

位置	做什么	不做什么
主界面「订阅管理」	档案绑定、书目卡片、卡级 / 档案默认检查窗、站点是否走 `conf.proxies`、分享链 / follow	不提交巡检、不下载章节
托盘 / `Schedule`	按检查窗与后巡查调度；菜单或面板「立刻执行」触发 `run_once`；展示上次 / 下次与 pending	不编辑书目与档案结构（配置回主界面）

普通用户主路径是 追更：从预览页勾选作品加入追更，设检查日和时间，保持 CGS Server 托盘在跑，后台按调度检查新章节并提交下载。订阅源 是高级路径：添加他人发布的 follow bid，按拉取间隔获取 metadata feed，并在开启自动下载时提交新内容。

手动立刻执行（仅托盘）

主界面配置窗口 → CGS Server 启动托盘（或已有托盘进程）。
系统托盘图标右键 → 立刻执行；或打开托盘管理窗口 → Schedule → 立刻执行。
运行结果回写 Schedule 的上次执行 / pending / 历史；订阅管理状态条只读展示缓存中的上次 / 下次时间。

Schedule 面板显示：

区域	说明
Plan	当前模式、状态、下次检查、检查时间、publish bid、对象数量、阻塞原因和下一步
Sources	已配置的作品、作者/标签、follow bid 列表
Run	当前/最近一次运行的 run id、trigger、阶段、扫描数、pending 数、提交数
Pending Items	待下载条目、来源、章节、阶段、打开来源入口
History	最近订阅运行事件和错误摘要
Debug	脱敏后的原始 Schedule payload，仅用于诊断

常见阻塞原因：

原因	下一步
没有启用的追更对象	从预览页勾选作品加入追更，或在主窗口启用已有对象
未选择自动检查日期	在追更配置里选择至少一个检查日
分享链尚未发布	本地追更检查和下载仍可运行；如需同步给订阅源，再发布分享链生成 publish bid
订阅源自动下载已关闭	在订阅源配置里开启自动下载
没有订阅源 follow bid	添加至少一个 follow bid
CGS Server runtime 不空闲	等待当前任务结束，或关闭占用中的前台任务

隐私和合规边界：metadata pkl 托管在 Discord attachment CDN，Cloudflare Worker 只保存 {bid -> attachment_url} 索引；订阅源运行不会轮询 Discord 频道消息。本地追更检查和下载不依赖 token；发布分享链、metadata 索引同步和订阅源拉取 follow feed 时需要本机配置中的 discord_share_user_token，界面 Debug 内容会做 token 脱敏。

接口

text

GET  /health          # 唯一免 token
GET  /sites
POST /search
POST /submit-books
GET  /status
GET  /events
POST /foreground/enter
POST /foreground/leave
MCP  /mcp

text

%LOCALAPPDATA%/CGS/runtime/cgs-server-*.json

状态对照

显示	原因
前台占用	主界面正开着
任务运行中	已有下载在跑
未找到 Server	未启动或发现记录过期
未授权	没带 token

🖥️ CGS Server / MCP ​

托盘管理窗口 ​

订阅 / Schedule ​

职责拆分 ​

手动立刻执行（仅托盘） ​

接口 ​

状态对照 ​