feat(creator): 新增「运营」模块 —— 多账号扫码登录与创作者后台数据
Deploy VitePress site to Pages / build (push) Canceled after 0s
Deploy VitePress site to Pages / Deploy (push) Canceled after 0s

侧边栏在「监控」右边加了「运营」:账号列表 → 点进二级详情看该账号的数据。

【为什么是独立模块而不是监控的子视图】两者形状不同:监控是公开数据(点赞/收藏/评论/分享)的每轮快照+差分;运营是创作者后台按日期给出的曝光/观看/完播率/涨粉。凭据不同、采集方式也不同 —— 那边要浏览器登录态,这边是纯请求。硬塞进同一个模型会同时污染两边。

【扫码登录的关键差异】监控的扫码把登录态写进浏览器默认 profile(爬虫要复用)。运营要的是 cookie 字符串(纯请求够用),所以每次登录开一个**临时上下文**,扫完取出 cookie 就丢弃 —— 登第二个账号不会把第一个顶掉,也不影响监控那个登录态,十个账号互不干扰。

【决策依据】tools/probe_creator_api.py 的 Phase 0 实测:签名可自造(XYW_:MD5 → base64 → AES-128-CBC,与 xhshow 内置实现常量逐字节一致);主站 cookie 即可认证创作者后台;接口与参数已与真实页面对齐。

后端:
- api/creator/models.py: creator_account / creator_note_stat。**复用 MonitorBase**,这样 create_all 与上一轮改成元数据驱动的 _ensure_columns 会自动覆盖新表
- api/creator/signing.py: XYW_ 签名,带三条实测结论(url= 前缀、appId=ugc、401 与 406 的区别)
- api/creator/client.py: 纯 httpx 客户端。字段名尚未亲眼验证过,所以写成多别名匹配;解析不出来存 None 而非 0
- api/creator/service.py: 账号 CRUD 与同步。cookie 绝不进入对外结构,只给 has_cookie
- api/creator/login.py: 临时上下文的扫码登录
- api/routers/creator.py: 8 条路由,全部带鉴权

前端:
- 侧边栏「运营」+ OperationView(账号列表 → 二级详情)+ AddAccountDialog
- 权限状态显眼呈现:pending 时照抄后台原话「已为您申请数据权限,次日可查看」,并说明此时同步返回 0 条是正常的,不是采集失败

测试:tests/test_creator_client.py 新增 48 例,含「cookie 不得出现在对外结构里」这条不变量,以及权限未生效时空壳响应的处理。
This commit is contained in:
2026-10-07 16:30:45 +08:00
parent 2613f7577f
commit c2b310c7bf
17 changed files with 2348 additions and 2 deletions
+25
View File
@@ -18,6 +18,12 @@ import type {
TaskCreatePayload,
WebhookStatus,
} from '@/types/monitor'
import type {
CreatorAccount,
CreatorAccountDetail,
CreatorLoginState,
CreatorSyncResult,
} from '@/types/creator'
const api = axios.create({
baseURL: '/api',
@@ -274,4 +280,23 @@ export const monitorApi = {
testWebhook: (url?: string) => api.post('/monitor/webhook/test', { url: url ?? null }),
}
/**
* 运营模块。与 `monitorApi` 并列 —— 它管的是自己的账号,走的是纯请求的创作者后台,
* 和公开数据监控不是一回事。
*/
export const creatorApi = {
listAccounts: () => api.get<{ accounts: CreatorAccount[] }>('/creator/accounts'),
getAccount: (id: number) => api.get<CreatorAccountDetail>(`/creator/accounts/${id}`),
deleteAccount: (id: number) => api.delete(`/creator/accounts/${id}`),
checkAccount: (id: number) => api.post<CreatorAccount>(`/creator/accounts/${id}/check`),
// 同步在后端后台跑(分页 + 节流可能几分钟),这里只负责触发。
syncAccount: (id: number, days = 90) =>
api.post<CreatorSyncResult>(`/creator/accounts/${id}/sync`, null, { params: { days } }),
// 扫码新增账号。cookie 只在后端内存里流转,不会出现在这些响应里。
startLogin: () => api.post<CreatorLoginState>('/creator/login'),
getLogin: () => api.get<CreatorLoginState>('/creator/login'),
cancelLogin: () => api.delete<CreatorLoginState>('/creator/login'),
}
export default api