refactor(account): S2 读写一次切换 —— CK/健康/重登彻底搬到账号，登录记录退化为历史

S1 加好了列，本提交把**读与写一起切**过去。这是设计里「同一份数据的读与写必须在同一个提交里切」的要求：先切读或先切写都会出现「写账号、读记录」的中间态，跑起来不报错，只是默默用错数据。 ## 核心改动 **判定「谁有 CK」不再借道登录记录** - `cookie_holding_filter()` / `cookie_operable_filter()` / `cookie_holding_account_ids_query()` / `visible_douyu_task_accounts()` 全部改为作用于 `Account`； - `cookie_operable_filter()` 的「在途排除」仍查 `login_tasks`（那是**某次尝试**的属性），用 `NOT EXISTS` 子查询 + 迁移 0042 新增的 `(account_id, attempt_status)` 索引； - 删除死代码 `latest_cookie_login_task()`；`latest_cookie()` 改为直接读账号。 **CK 写入** - `_write_login_success()` 写 `Account.cookie / cookie_updated_at / cookie_source`； - `_mark_attempt_failed()` 改看**账号**有没有 CK（决定是否沿用旧的失败语义）； - 检测模式的 `task.cookie = ""` **不再清空账号的 CK**（见下「行为变更」）。 **自动化作业按账号调度** - `ck_health`：`_select_tasks` → `_select_accounts`，`db.query(Account)`；新增 `count_remaining()`（刻意不带 LIMIT，否则积压数恒等于批次上限）； - `ck_relogin`：同样按账号选行；结算改为「账号 + 本轮尝试记录」，退避进度写账号；`settle_fresh_results(batch_id)` 按 `attempt_batch_id` 配对， `run_ck_relogin` 把 **account_ids** 交给 runner； - 顺带让**没有任何登录历史的账号**也能被巡检/重登（以前它们永远进不了队列）。 **登录批次** - `LoginBatchRunner` 去掉 `relogin_task_ids`，重登与登录统一走 `account_ids`； - 批次行复用逻辑重写：只保证「同一账号不并发两行」，不再关心「哪一行持有 CK」。失败行复用同时看 `attempt_status`（账号有 CK 时 `_mark_attempt_failed` 刻意不动 `status`，只看 status 会永远命不中 → 每次失败刷一行）。 **删除护栏语义变更（用户可感知）** - 去掉「持有 CK 的记录不可删」——CK 在账号上，删历史不再影响登录态，历史终于可清理； - **保留**「在途尝试不可删」（批次线程正拿着那条记录）。 ## 行为变更（需评审） 1. **账号检测不再清空 CK**。旧代码在 check 模式写 `task.cookie = ""`，而那时记录的 cookie 就是账号唯一凭证 —— 一次「批量检测」会把账号登录态删掉。解耦后「检测账号凭据」与「CK 是否有效」本就是两件事（后者归 `ck_health` 判），继续清空等于凭空制造不可逆的数据丢失（重登当前成功率极低）。 2. **Cookie 页的记录单位从「登录记录」变成「账号」**，所有接口的 id 入参/出参变成 `account_id`；`DELETE /cookies/{id}` 清的是该账号的 CK，**必写审计**。 3. 重复检测从「同一账号多行持 CK」改为「**同一个 CK 出现在多个账号上**」—— 后者才是真风险（两个账号共用一个登录态）。用 sha256 指纹分组： CK 是 AES-GCM + 随机 nonce 加密，**同一明文每次密文都不同**，比密文永远比不出重复。 ## 修掉一个真实并发缺陷 `_write_login_success` 原先被传入 `self.db`（runner 主会话），而它是在**工作线程**里用 `worker_db` 执行的。`emit()` 会往 `account_events` 插一行，其 `account_id` 外键对 `accounts` 那一行加**共享锁**；这把锁加在另一个会话上，紧接着本会话的 `UPDATE accounts SET cookie=...` 就被自己人挡住 —— 实测 **50 秒后 `Lock wait timeout exceeded`，登录明明成功却写不回 CK**（改造前 UPDATE 打在 `login_tasks` 上所以没撞上）。改为传 `worker_db`：事件本就该和状态变更同事务提交，顺带修掉跨线程共用一个 Session 的隐患。 ## 验证 - 全量 pytest **368 passed / 6 skipped**；迁移链 3 passed； - 前端 `tsc -b && vite build` 通过； - `ruff check` / `ruff format --check` 全绿（顺带修掉 main 上遗留的 F821）； - 新增/改写的关键回归：**删掉全部登录历史后账号的 CK 与健康状态仍在**、 **无登录历史的账号也能进巡检队列**、结算不碰 CK、删除护栏改为在途语义。仍未做（设计里排期的后续阶段）：`account_lifecycle` 状态收口（S3）、事件发射点补齐（S4）、业务事实直发事件（S5）、账号页重构（S6）。注意 `status` 目前只有模型默认值与迁移回填，所以 `disabled/archived` 还没有任何写入方——S3 落地时要把自动化选行的状态过滤一起补上。
2026-10-04 14:10:13 +08:00
parent e916a7015d
commit 00125fbfc4
26 changed files with 1380 additions and 1068 deletions
@@ -344,8 +344,8 @@ export interface AccountCheckBatch {
 // ==================== Cookie ====================

 export interface CookieItem {
+  // 2026-10-04 CK 解耦后，本页面的记录单位是**账号**，id 就是 account_id
  id: number;
-  batch_id: string;
  account_id: number;
  account_username: string;
  assigned_to: number | null;
@@ -395,7 +395,6 @@ export interface CookieCheckResult {
 export interface CookieDuplicateRecord {
  id: number;
  account_id: number;
-  batch_id: string;
  finished_at: string | null;
 }

@@ -989,7 +988,7 @@ export interface AutomationRunOutcome {
 }

 export interface AutomationManualSample {
-  task_id: number;
+  account_id: number;
  account_username: string;
  relogin_attempts: number;
  last_error: string;
@@ -155,7 +155,7 @@ export default function AutomationPage() {
  };

  const manualColumns: ColumnsType<AutomationManualSample> = [
-    { title: "记录", dataIndex: "task_id", width: 80 },
+    { title: "账号ID", dataIndex: "account_id", width: 80 },
    {
      title: "账号",
      dataIndex: "account_username",
@@ -165,9 +165,9 @@ export default function CookiePage() {
      const result = await cookieApi.duplicates();
      setDuplicateResult(result);
      if (result.duplicate_groups > 0) {
-        message.warning(`发现 ${result.duplicate_groups} 个重复账号，共 ${result.duplicate_rows} 条 CK 记录`);
+        message.warning(`发现 ${result.duplicate_groups} 组「多个账号共用同一份 CK」，涉及 ${result.duplicate_rows} 个账号`);
      } else {
-        message.success('未发现重复账号');
+        message.success('未发现共用 CK 的账号');
      }
    } catch (e: unknown) {
      message.error(getErrorMessage(e));
@@ -327,7 +327,7 @@ export default function CookiePage() {
  const handleDelete = async (id: number) => {
    try {
      await cookieApi.delete(id);
-      message.success('已删除');
+      message.success('已清除该账号的 CK');
      setSelectedRowKeys((prev) => prev.filter((k) => k !== id));
      loadCookies();
      loadSummary();
@@ -338,7 +338,7 @@ export default function CookiePage() {

  const handleDeleteSelected = async () => {
    if (selectedRowKeys.length === 0) {
-      message.warning('请先选择要删除的 Cookie');
+      message.warning('请先选择要清除 CK 的账号');
      return;
    }
    try {
@@ -461,7 +461,7 @@ export default function CookiePage() {
            </Popconfirm>
          )}
          {canExport && (
-            <Popconfirm title="确认删除？" onConfirm={() => handleDelete(record.id)}>
+            <Popconfirm title="确认清除该账号的 CK？不可逆" onConfirm={() => handleDelete(record.id)}>
              <Button danger size="small" icon={<DeleteOutlined />} />
            </Popconfirm>
          )}
@@ -486,13 +486,13 @@ export default function CookiePage() {
      render: (count: number) => <Tag color="error">{count}</Tag>,
    },
    {
-      title: '账号记录数',
+      title: '共用 CK 的账号数',
      dataIndex: 'account_count',
      width: 110,
      align: 'center' as const,
    },
    {
-      title: 'CK 记录 ID',
+      title: '账号 ID（共用同一份 CK）',
      dataIndex: 'cookie_ids',
      width: 220,
      ellipsis: true,
@@ -506,7 +506,7 @@ export default function CookiePage() {
      render: (ids: number[]) => ids.join(', '),
    },
    {
-      title: '最近记录',
+      title: '最近拿到 CK',
      width: 170,
      align: 'center' as const,
      render: (_: unknown, group: CookieDuplicateGroup) => formatTime(group.records[0]?.finished_at),
@@ -559,7 +559,7 @@ export default function CookiePage() {
          )}
          {canExport && (
            <Popconfirm
-              title={`确认删除选中的 ${selectedRowKeys.length} 条 Cookie？`}
+              title={`确认清除选中的 ${selectedRowKeys.length} 个账号的 CK？不可逆`}
              onConfirm={handleDeleteSelected}
              disabled={selectedRowKeys.length === 0}
            >
@@ -568,7 +568,7 @@ export default function CookiePage() {
                icon={<DeleteOutlined />}
                disabled={selectedRowKeys.length === 0}
              >
-                删除选中 {selectedRowKeys.length > 0 && `(${selectedRowKeys.length})`}
+                清除选中 {selectedRowKeys.length > 0 && `(${selectedRowKeys.length})`}
              </Button>
            </Popconfirm>
          )}
@@ -708,8 +708,8 @@ export default function CookiePage() {
              type={duplicateResult.duplicate_groups > 0 ? 'warning' : 'success'}
              showIcon
              message={duplicateResult.duplicate_groups > 0
-                ? `发现 ${duplicateResult.duplicate_groups} 个重复账号，共 ${duplicateResult.duplicate_rows} 条 CK 记录`
-                : '未发现重复账号'}
+                ? `发现 ${duplicateResult.duplicate_groups} 组「多个账号共用同一份 CK」，涉及 ${duplicateResult.duplicate_rows} 个账号`
+                : '未发现共用 CK 的账号'}
              style={{ marginBottom: 16 }}
            />
            {duplicateResult.groups.length > 0 ? (
@@ -722,7 +722,7 @@ export default function CookiePage() {
                scroll={{ x: 900 }}
              />
            ) : (
-              <Empty image={Empty.PRESENTED_IMAGE_SIMPLE} description="未发现重复账号" />
+              <Empty image={Empty.PRESENTED_IMAGE_SIMPLE} description="未发现共用 CK 的账号" />
            )}
          </>
        ) : null}