codebee 0.1.64 → 0.1.66

package/app/core/bookmeta.py

@@ -4,13 +4,13 @@
 用户在详情页「成果」分区点按钮触发（不做自动生成），后台线程调编排者模型
 提炼 大纲 + 故事圣经 + 已有章节 的精华，按平台表单字段归一化后存任务
 book_meta 字段，同时在工作目录落一份 Markdown 归档。降级链与大纲一致：
-编排者 API → 作者 CLI → 模板兜底（模板只做搬运归纳，必填字段仍保证可建书）。
+编排者 API → 作者 CLI → 模板兜底（模板只做搬运归纳，必填字段仍保证可建书）。
 """
 from __future__ import annotations
 
-import os
-import re
-import time
+import os
+import re
+import time
 from pathlib import Path
 
 PLATFORMS = {
@@ -26,8 +26,8 @@ def template_only():
     """只走模板兜底（跳过编排者/作者 CLI）：env TUTTI_BOOKMETA_TEMPLATE_ONLY=1。
 
     离线环境、不想为开书资料再花一次模型调用、以及测试要确定性输出时使用；
-    产出仍是结构完整的字段，书名/简介直接取大纲与目标，平台必填字段由生成阶段
-    的官方目录兜底补齐。"""
+    产出仍是结构完整的字段，书名/简介直接取大纲与目标，平台必填字段由生成阶段
+    的官方目录兜底补齐。"""
     return str(os.environ.get("TUTTI_BOOKMETA_TEMPLATE_ONLY") or "").strip() in ("1", "true", "yes")
 
 
@@ -208,7 +208,14 @@ def _name(v, limit):
 
 
 def _summary(v):
-    return str(v or "").strip()[:500]
+    """剥 markdown 装饰后截断。2026-09-23 实案：简介混成调研报告标题
+    「# 网文选题分析报告…」——模型把研究素材当小说素材时输出的是标题行，
+    至少不能把 #/* 符号和报告腔标题原样带进建书表单。"""
+    t = re.sub(r"^\s*#{1,6}\s*", "", str(v or "").strip())
+    t = re.sub(r"(?m)^\s*[-*•]\s*", "", t)
+    t = t.replace("**", "").replace("__", "")
+    t = re.sub(r"\n{2,}", "\n", t).strip()
+    return t[:500]
 
 
 def _in_table(v, table, limit=10):
@@ -378,7 +385,7 @@ def _material_text(task, outline):
     return material
 
 
-def _fill_tag_gaps(task, platform, meta, outline):
+def _fill_tag_gaps(task, platform, meta, outline):
     """llm 归一化后仍为空的标签组：用素材词面扫描补一轮（命中多少算多少）。
 
     模型偶尔整组漏给（实测 codex-cli 只填了内容标签前两组）；空着用户就得
@@ -402,137 +409,172 @@ def _fill_tag_gaps(task, platform, meta, outline):
     for key, table, limit in pairs:
         if not meta.get(key):
             meta[key] = _scan_table(material, table, limit)
-    return meta
-
-
-def _material_names(material):
-    """从圣经/大纲/章节里提取明确标注的人物名。
-
-    只接受带人物语义的短语（如“女主：阿禾”或“男主叫陆沉”），避免把
-    普通句子里的名词误当成主角。返回顺序去重后的最多两个名字。
-    """
-    text = str(material or "")
-    out = []
-    patterns = (
-        r"(?:主角|主人公|男主(?:角)?|女主(?:角)?|男一|女一|姓名|名字)"
-        r"\s*(?:是|叫|为|：|:)\s*([\u4e00-\u9fffA-Za-z][\u4e00-\u9fffA-Za-z·]{1,7})",
-        r"人物\s*[：:]\s*([^\n。；;]{2,40})",
-    )
-    for pat in patterns:
-        for m in re.finditer(pat, text):
-            raw = m.group(1)
-            chunks = re.split(r"[、,，/和及与]|\s+", raw)
-            for chunk in chunks:
-                name = re.sub(r"[^\u4e00-\u9fffA-Za-z·]", "", chunk)
-                if 2 <= len(name) <= 8 and name not in out:
-                    out.append(name[:5])
-                if len(out) >= 2:
-                    return out
-    return out
-
-
-def _pick_option(material, table, keywords=()):
-    """从官方选项表中按素材命中词选择一个，完全命中不到时用首项。"""
-    text = str(material or "")
-    for item in table:
-        if len(item) >= 2 and item in text:
-            return item
-    for key, item in keywords:
-        if key and key in text and item in table:
-            return item
-    return table[0] if table else ""
-
-
-def _has_value(value):
-    """判断建书字段是否真正有值（兼容列表和历史占位文本）。"""
-    placeholders = {"待补充", "（待补充）", "(待补充)"}
-    if isinstance(value, list):
-        return any((text := str(x or "").strip()) and text not in placeholders
-                   for x in value)
-    text = str(value or "").strip()
-    return bool(text) and text not in placeholders
-
-
-def _fill_required_fields(task, platform, meta, outline, material):
-    """生成阶段的必填字段闸门。
-
-    ``_norm`` 仍保持“表外值清空”的纯校验语义，供旧数据修复和单测使用；
-    这里仅在真正交付作品信息前补齐平台建书表单的必填项，避免 UI 展示一整
-    屏“待补充”而无法直接复制建书。所有分类/标签仍来自官方目录。
-    """
-    from . import bookmeta_catalog as cat
-
-    material = str(material or "")
-    names = _material_names(material)
-    female_words = ("女频", "女生", "女主", "言情", "古言", "恋爱")
-    female = any(x in ((task.get("goal") or "") + material) for x in female_words)
-    defaults = ("沈知微", "顾砚川", "林知夏") if female else ("陆沉", "苏晚", "程野")
-    if not _has_value(meta.get("protagonist_1")):
-        meta["protagonist_1"] = names[0] if names else defaults[0]
-    if not _has_value(meta.get("protagonist_2")):
-        candidate = names[1] if len(names) > 1 else defaults[1]
-        if candidate == meta["protagonist_1"]:
-            candidate = next((name for name in defaults if name != meta["protagonist_1"]), defaults[2])
-        meta["protagonist_2"] = candidate
-
-    if platform == "fanqie":
-        reader = meta.get("target_reader") or ("女频" if female else "男频")
-        if reader not in ("男频", "女频"):
-            reader = "女频" if female else "男频"
-        meta["target_reader"] = reader
-        cats, theme, role, plot = _fq_tables(reader)
-        c_plot, c_emo, c_char, c_world = _fq_content_tables()
-        if meta.get("category") not in cats:
-            meta["category"] = _pick_option(
-                material, cats,
-                (("戍边", "古风世情"), ("边关", "古风世情"),
-                 ("军", "抗战谍战"), ("悬疑", "女频悬疑" if female else "悬疑脑洞"),
-                 ("种田", "种田"), ("都市", "都市脑洞")))
-        groups = (("tags_theme", theme, 2), ("tags_role", role, 2),
-                  ("tags_plot", plot, 2), ("content_plot", c_plot, 4),
-                  ("content_emotion", c_emo, 2), ("content_character", c_char, 4),
-                  ("content_world", c_world, 1))
-    else:
-        reader = meta.get("target_reader") or ("女生" if female else "男生")
-        if reader not in ("男生", "女生"):
-            reader = "女生" if female else "男生"
-        meta["target_reader"] = reader
-        channel = cat.QIMAO_CATS.get(reader) or cat.QIMAO_CATS["男生"]
-        main = meta.get("category_main")
-        if main not in channel:
-            main = _pick_option(
-                material, list(channel),
-                (("戍边", "古代言情"), ("边关", "古代言情"),
-                 ("古代", "古代言情"), ("军事", "军事"),
-                 ("军", "军事"), ("都市", "都市"),
-                 ("玄幻", "玄幻奇幻"), ("悬疑", "奇闻异事")))
-            meta["category_main"] = main
-        subs = channel.get(main) or []
-        sub = meta.get("category_sub")
-        if sub not in subs:
-            located = cat.qimao_locate_sub(sub)
-            if located:
-                reader, main = located
-                meta["target_reader"] = reader
-                meta["category_main"] = main
-                subs = cat.QIMAO_CATS[reader][main]
-            else:
-                sub = ""
-        if sub not in subs:
-            meta["category_sub"] = _pick_option(material, subs)
-        groups = (("tags_style", cat.QIMAO_TAG_GROUPS["风格"], 3),
-                  ("tags_role", cat.QIMAO_TAG_GROUPS["角色"], 3),
-                  ("tags_plot", cat.QIMAO_TAG_GROUPS["情节"], 3),
-                  ("tags_bg", cat.QIMAO_TAG_GROUPS["背景"], 3))
-    for key, table, limit in groups:
-        values = meta.get(key)
-        if not isinstance(values, list):
-            values = []
-        values = [str(v).strip() for v in values if str(v or "").strip() in table]
-        if not values:
-            values = [_pick_option(material, table)]
-        meta[key] = values[:limit]
-    return meta
+    return meta
+
+
+def _material_names(material):
+    """从圣经/大纲/章节里提取明确标注的人物名。
+
+    只接受带人物语义的短语（如“女主：阿禾”或“男主叫陆沉”），避免把
+    普通句子里的名词误当成主角。返回顺序去重后的最多两个名字。
+    """
+    text = str(material or "")
+    out = []
+    patterns = (
+        r"(?:主角|主人公|男主(?:角)?|女主(?:角)?|男一|女一|姓名|名字)"
+        r"\s*(?:是|叫|为|：|:)\s*([\u4e00-\u9fffA-Za-z][\u4e00-\u9fffA-Za-z·]{1,7})",
+        r"人物\s*[：:]\s*([^\n。；;]{2,40})",
+    )
+    for pat in patterns:
+        for m in re.finditer(pat, text):
+            raw = m.group(1)
+            chunks = re.split(r"[、,，/和及与]|\s+", raw)
+            for chunk in chunks:
+                name = re.sub(r"[^\u4e00-\u9fffA-Za-z·]", "", chunk)
+                if 2 <= len(name) <= 8 and name not in out:
+                    out.append(name[:5])
+                if len(out) >= 2:
+                    return out
+    return out
+
+
+def _pick_option(material, table, keywords=()):
+    """从官方选项表中按素材命中词选择一个，完全命中不到时用首项。"""
+    text = str(material or "")
+    for item in table:
+        if len(item) >= 2 and item in text:
+            return item
+    for key, item in keywords:
+        if key and key in text and item in table:
+            return item
+    return table[0] if table else ""
+
+
+def _has_value(value):
+    """判断建书字段是否真正有值（兼容列表和历史占位文本）。"""
+    placeholders = {"待补充", "（待补充）", "(待补充)"}
+    if isinstance(value, list):
+        return any((text := str(x or "").strip()) and text not in placeholders
+                   for x in value)
+    text = str(value or "").strip()
+    return bool(text) and text not in placeholders
+
+
+def _md_plain(text):
+    """markdown 轻洗（在 _summary 净化之上）：每行剥标题/列表/引用符与行内
+    强调符，合并成一段正文文字（建书表单简介是单行框）。"""
+    out = []
+    for ln in _summary(text).splitlines():
+        ln = re.sub(r"^\s*(#{1,6}\s*|[-*+]\s+|>\s*|\d+[.、)）]\s*)", "", ln)
+        ln = re.sub(r"[*_`#>]+", "", ln).strip()
+        if ln:
+            out.append(ln)
+    return "".join(out)
+
+
+def _summary_ok(value):
+    """简介够不够格进建书表单：番茄表单硬性要求 50-500 字（占位文案即
+    「请输入50-500字」），markdown 标题/占位符过不了平台提交校验，且自动
+    化流程看不到平台的字段报错，只会误报成「未登录或改版」。"""
+    return 50 <= len(_md_plain(value)) <= 500
+
+
+def _prose_summary(cur, material):
+    """简介兜底清理：markdown 洗成正文；洗完仍不足 50 字就从素材正文取。
+    取不出够长的正文时原样返回——由建书前置闸拦停并提示补写，不硬编。"""
+    text = _md_plain(cur)
+    if len(text) >= 50:
+        return text[:500]
+    body = _md_plain(material)
+    if len(body) >= 50:
+        return body[:500]
+    return str(cur or "").strip()
+
+
+def _fill_required_fields(task, platform, meta, outline, material):
+    """生成阶段的必填字段闸门。
+
+    ``_norm`` 仍保持“表外值清空”的纯校验语义，供旧数据修复和单测使用；
+    这里仅在真正交付作品信息前补齐平台建书表单的必填项，避免 UI 展示一整
+    屏“待补充”而无法直接复制建书。所有分类/标签仍来自官方目录。
+    """
+    from . import bookmeta_catalog as cat
+
+    material = str(material or "")
+    names = _material_names(material)
+    female_words = ("女频", "女生", "女主", "言情", "古言", "恋爱")
+    female = any(x in ((task.get("goal") or "") + material) for x in female_words)
+    defaults = ("沈知微", "顾砚川", "林知夏") if female else ("陆沉", "苏晚", "程野")
+    if not _has_value(meta.get("protagonist_1")):
+        meta["protagonist_1"] = names[0] if names else defaults[0]
+    if not _has_value(meta.get("protagonist_2")):
+        candidate = names[1] if len(names) > 1 else defaults[1]
+        if candidate == meta["protagonist_1"]:
+            candidate = next((name for name in defaults if name != meta["protagonist_1"]), defaults[2])
+        meta["protagonist_2"] = candidate
+
+    # 简介质量：平台建书表单对简介有硬字数校验（番茄 50-500 字），markdown
+    # 标题/占位文本过不了提交且流程看不到报错——洗成正文，不够长从素材取
+    meta["summary"] = _prose_summary(meta.get("summary"), material)
+
+    if platform == "fanqie":
+        reader = meta.get("target_reader") or ("女频" if female else "男频")
+        if reader not in ("男频", "女频"):
+            reader = "女频" if female else "男频"
+        meta["target_reader"] = reader
+        cats, theme, role, plot = _fq_tables(reader)
+        c_plot, c_emo, c_char, c_world = _fq_content_tables()
+        if meta.get("category") not in cats:
+            meta["category"] = _pick_option(
+                material, cats,
+                (("戍边", "古风世情"), ("边关", "古风世情"),
+                 ("军", "抗战谍战"), ("悬疑", "女频悬疑" if female else "悬疑脑洞"),
+                 ("种田", "种田"), ("都市", "都市脑洞")))
+        groups = (("tags_theme", theme, 2), ("tags_role", role, 2),
+                  ("tags_plot", plot, 2), ("content_plot", c_plot, 4),
+                  ("content_emotion", c_emo, 2), ("content_character", c_char, 4),
+                  ("content_world", c_world, 1))
+    else:
+        reader = meta.get("target_reader") or ("女生" if female else "男生")
+        if reader not in ("男生", "女生"):
+            reader = "女生" if female else "男生"
+        meta["target_reader"] = reader
+        channel = cat.QIMAO_CATS.get(reader) or cat.QIMAO_CATS["男生"]
+        main = meta.get("category_main")
+        if main not in channel:
+            main = _pick_option(
+                material, list(channel),
+                (("戍边", "古代言情"), ("边关", "古代言情"),
+                 ("古代", "古代言情"), ("军事", "军事"),
+                 ("军", "军事"), ("都市", "都市"),
+                 ("玄幻", "玄幻奇幻"), ("悬疑", "奇闻异事")))
+            meta["category_main"] = main
+        subs = channel.get(main) or []
+        sub = meta.get("category_sub")
+        if sub not in subs:
+            located = cat.qimao_locate_sub(sub)
+            if located:
+                reader, main = located
+                meta["target_reader"] = reader
+                meta["category_main"] = main
+                subs = cat.QIMAO_CATS[reader][main]
+            else:
+                sub = ""
+        if sub not in subs:
+            meta["category_sub"] = _pick_option(material, subs)
+        groups = (("tags_style", cat.QIMAO_TAG_GROUPS["风格"], 3),
+                  ("tags_role", cat.QIMAO_TAG_GROUPS["角色"], 3),
+                  ("tags_plot", cat.QIMAO_TAG_GROUPS["情节"], 3),
+                  ("tags_bg", cat.QIMAO_TAG_GROUPS["背景"], 3))
+    for key, table, limit in groups:
+        values = meta.get(key)
+        if not isinstance(values, list):
+            values = []
+        values = [str(v).strip() for v in values if str(v or "").strip() in table]
+        if not values:
+            values = [_pick_option(material, table)]
+        meta[key] = values[:limit]
+    return meta
 
 
 def store_read_bible(task):
@@ -560,9 +602,19 @@ def make_book_meta(task, platform, author_agent=None, log_path=None):
     """生成一个平台的作品信息。返回 (meta dict, source 字符串)；模板兜底永远有返回。"""
     from . import knowledge, modelhub, planner, runner, skills  # 惰性导入，同 planner
     material, outline = _collect_material(task)
+    # 素材充分性门：没有大纲也没有章稿/圣经的任务（如「帮我定方向」的选题
+    # 研究任务）没有可推介的小说要素——生成只会产出报告腔垃圾
+    # （2026-09-23 实案：简介=「# 网文选题分析报告…」）。宁明确拒绝。
+    if not outline and "## 第一章开头" not in material and "## 故事圣经" not in material:
+        raise ValueError(
+            "该任务还没有小说大纲、正文或故事圣经，无法生成作品信息——"
+            "先完成大纲/首批章节后再来一键生成")
     schema = {"fanqie": FANQIE_SCHEMA, "qimao": QIMAO_SCHEMA}.get(platform) or ""
     plat_label = PLATFORMS[platform]["label"]
     sk_block, _ = skills.block_for(task)
+    # 实案教训（2026-09-23）：素材偏研究向时模型把简介写成「分析报告标题」
+    summary_rule = ("- summary 必须是面向读者的小说推介文案：点出题材、主角、核心冲突与悬念，"
+                    "200/500 字内成段；绝不允许写成报告标题、要点清单或任务说明。")
     kb_block = knowledge.block_for(task)
     if kb_block:
         sk_block = (sk_block + "\n\n" + kb_block) if sk_block else kb_block
@@ -572,7 +624,8 @@ def make_book_meta(task, platform, author_agent=None, log_path=None):
     prompt = (PROMPT_HEAD.replace("__PLATFORM__", plat_label)
               .replace("__SKILLS__", sk_block)
               .replace("__SCHEMA__", schema)
-              .replace("__OPTIONS_RULE__", options) + "\n\n## 小说素材\n" + material)
+              .replace("__OPTIONS_RULE__", options + "\n" + summary_rule)
+              + "\n\n## 小说素材\n" + material)
 
     orch = None
     if not template_only():
@@ -587,12 +640,12 @@ def make_book_meta(task, platform, author_agent=None, log_path=None):
         planner._log_usage("bookmeta", "bookmeta", task, res, model=model,
                            provider=prov.get("name", prov.get("id", "")),
                            provider_id=prov.get("id", ""))
-        if res["ok"]:
-            meta = _norm(runner.extract_json(res.get("text") or ""), platform, goal)
-            if meta:
-                meta = _fill_tag_gaps(task, platform, meta, outline)
-                return _fill_required_fields(task, platform, meta, outline, material), \
-                    "编排者(%s · %s)" % (prov.get("name", prov["id"]), model)
+        if res["ok"]:
+            meta = _norm(runner.extract_json(res.get("text") or ""), platform, goal)
+            if meta:
+                meta = _fill_tag_gaps(task, platform, meta, outline)
+                return _fill_required_fields(task, platform, meta, outline, material), \
+                    "编排者(%s · %s)" % (prov.get("name", prov["id"]), model)
         orch_err = str(res.get("error") or "返回内容无法解析为作品信息")[:200]
 
     if author_agent and author_agent.get("mode") == "real" and not template_only():
@@ -600,16 +653,16 @@ def make_book_meta(task, platform, author_agent=None, log_path=None):
                                workdir=task.get("workdir"), readonly=True,
                                timeout=BOOKMETA_TIMEOUT, log_path=log_path)
         planner._log_usage("bookmeta", "bookmeta", task, res, agent=author_agent)
-        if res["ok"]:
-            meta = _norm(runner.extract_json(res.get("text") or ""), platform, goal)
-            if meta:
-                meta = _fill_tag_gaps(task, platform, meta, outline)
-                return _fill_required_fields(task, platform, meta, outline, material), "llm(%s)" % author_agent["id"]
+        if res["ok"]:
+            meta = _norm(runner.extract_json(res.get("text") or ""), platform, goal)
+            if meta:
+                meta = _fill_tag_gaps(task, platform, meta, outline)
+                return _fill_required_fields(task, platform, meta, outline, material), "llm(%s)" % author_agent["id"]
         orch_err = orch_err or str(res.get("error") or "")[:200]
 
-    meta = _template_meta(task, platform, outline)
-    meta = _fill_required_fields(task, platform, meta, outline, material)
-    meta["source"] = ("模板兜底（编排者不可用：%s）" % orch_err) if orch_err else "模板兜底"
+    meta = _template_meta(task, platform, outline)
+    meta = _fill_required_fields(task, platform, meta, outline, material)
+    meta["source"] = ("模板兜底（编排者不可用：%s）" % orch_err) if orch_err else "模板兜底"
     return meta, meta["source"]
 
 
@@ -663,7 +716,7 @@ def generate_async(task_id, platform, author_agent=None):
     store.set_book_meta(task_id, platform, entry)
 
 
-def recover_orphans():
+def recover_orphans():
     """启动收尸：后台生成线程随进程重启死掉后，落盘的 running 无人写终态——
     前端永远「生成中」（按钮禁用）+ 接口幂等拒绝，卡死不可自愈。启动时把
     遗留 running 统一改判 failed，交还「重试」按钮。返回改判条数。"""
@@ -677,65 +730,67 @@ def recover_orphans():
                     "error": "生成随服务重启中断，请点重试",
                     "at": time.strftime("%Y-%m-%d %H:%M:%S")})
                 n += 1
-    return n
-
-
-def repair_existing():
-    """补齐历史已生成记录中的必填字段。
-
-    旧版本允许分类/主角为空并把结果标成 done；只要字段缺失就按当前官方
-    目录和已有素材补一次，已有非空字段保持不变。返回修复条数，供启动日志
-    和升级诊断使用。
-    """
-    from . import store
-    repaired = 0
-    for task in store.list_tasks(limit=10 ** 9):
-        book_meta = task.get("book_meta") or {}
-        for platform in PLATFORMS:
-            entry = book_meta.get(platform) or {}
-            if entry.get("status") != "done" or not isinstance(entry.get("data"), dict):
-                continue
-            data = dict(entry["data"])
-            if platform == "fanqie":
-                reader = data.get("target_reader")
-                cats, _, _, _ = _fq_tables(reader if reader in ("男频", "女频") else "男频")
-                required_ok = (
-                    data.get("category") in cats
-                    and all(_has_value(data.get(key)) for key in (
-                        "tags_theme", "tags_role", "tags_plot", "content_plot",
-                        "content_emotion", "content_character", "content_world"))
-                    and _has_value(data.get("protagonist_1"))
-                    and _has_value(data.get("protagonist_2")))
-            else:
-                from . import bookmeta_catalog as cat
-                reader = data.get("target_reader")
-                channel = cat.QIMAO_CATS.get(reader) or {}
-                main = data.get("category_main")
-                required_ok = (
-                    main in channel
-                    and data.get("category_sub") in (channel.get(main) or [])
-                    and all(_has_value(data.get(key)) for key in (
-                        "tags_style", "tags_role", "tags_plot", "tags_bg"))
-                    and _has_value(data.get("protagonist_1"))
-                    and _has_value(data.get("protagonist_2")))
-            if required_ok:
-                continue
-            try:
-                material, outline = _collect_material(task)
-                fixed = _fill_required_fields(task, platform, data, outline, material)
-                if fixed == entry["data"]:
-                    continue
-                payload = dict(entry)
-                payload["data"] = fixed
-                payload["source"] = (str(entry.get("source") or "") + "；已补齐必填字段").lstrip("；")
-                store.set_book_meta(task["id"], platform, payload)
-                try:
-                    fp = Path(task.get("workdir") or "") / PLATFORMS[platform]["file"]
-                    if fp.parent.is_dir():
-                        fp.write_text(render_markdown(task, platform, fixed), encoding="utf-8")
-                except OSError:
-                    pass
-                repaired += 1
-            except Exception:
-                continue
-    return repaired
+    return n
+
+
+def repair_existing():
+    """补齐历史已生成记录中的必填字段。
+
+    旧版本允许分类/主角为空并把结果标成 done；只要字段缺失就按当前官方
+    目录和已有素材补一次，已有非空字段保持不变。返回修复条数，供启动日志
+    和升级诊断使用。
+    """
+    from . import store
+    repaired = 0
+    for task in store.list_tasks(limit=10 ** 9):
+        book_meta = task.get("book_meta") or {}
+        for platform in PLATFORMS:
+            entry = book_meta.get(platform) or {}
+            if entry.get("status") != "done" or not isinstance(entry.get("data"), dict):
+                continue
+            data = dict(entry["data"])
+            if platform == "fanqie":
+                reader = data.get("target_reader")
+                cats, _, _, _ = _fq_tables(reader if reader in ("男频", "女频") else "男频")
+                required_ok = (
+                    data.get("category") in cats
+                    and all(_has_value(data.get(key)) for key in (
+                        "tags_theme", "tags_role", "tags_plot", "content_plot",
+                        "content_emotion", "content_character", "content_world"))
+                    and _has_value(data.get("protagonist_1"))
+                    and _has_value(data.get("protagonist_2"))
+                    and _summary_ok(data.get("summary")))
+            else:
+                from . import bookmeta_catalog as cat
+                reader = data.get("target_reader")
+                channel = cat.QIMAO_CATS.get(reader) or {}
+                main = data.get("category_main")
+                required_ok = (
+                    main in channel
+                    and data.get("category_sub") in (channel.get(main) or [])
+                    and all(_has_value(data.get(key)) for key in (
+                        "tags_style", "tags_role", "tags_plot", "tags_bg"))
+                    and _has_value(data.get("protagonist_1"))
+                    and _has_value(data.get("protagonist_2"))
+                    and _summary_ok(data.get("summary")))
+            if required_ok:
+                continue
+            try:
+                material, outline = _collect_material(task)
+                fixed = _fill_required_fields(task, platform, data, outline, material)
+                if fixed == entry["data"]:
+                    continue
+                payload = dict(entry)
+                payload["data"] = fixed
+                payload["source"] = (str(entry.get("source") or "") + "；已补齐必填字段").lstrip("；")
+                store.set_book_meta(task["id"], platform, payload)
+                try:
+                    fp = Path(task.get("workdir") or "") / PLATFORMS[platform]["file"]
+                    if fp.parent.is_dir():
+                        fp.write_text(render_markdown(task, platform, fixed), encoding="utf-8")
+                except OSError:
+                    pass
+                repaired += 1
+            except Exception:
+                continue
+    return repaired