codebee 0.1.95 → 0.1.96

package/app/core/paihang.py

@@ -1,145 +1,145 @@
-# -*- coding: utf-8 -*-
-"""扫榜选材：抓取公开排行榜页，产出选题分析素材。
-
-数据源（四源聚合，任一失败不影响其余源；2026-09-24 实测全 200）：
-- 七猫：www.qimao.com/paihang/（106KB）
-- 番茄 Web 版：fanqienovel.com/rank（题材分类+书名在中文 a 标签里；
-  App 端接口有 SecuritySign/X-Argus 签名——那才是难路，Web 版榜单页
-  不需要签名，别走弯路）
-- 起点移动版：m.qidian.com/rank（106KB，直接出书名；主站 www.qidian.com
-  被 WAF 拦 202/209B，移动页不需要签名）
-- 纵横：www.zongheng.com/rank（65KB，书名+统计标签混排，靠噪音词过滤）
-
-下载走 curl 子进程（与 covergen 同款），解析用宽松正则——页面结构变了
-宁可返回空（调用方回落普通直连提示词），不做脆弱的强解析。
-"""
-from __future__ import annotations
-
-import logging
-import re
-
-log = logging.getLogger(__name__)
-
-QIMAO_RANK_URL = "https://www.qimao.com/paihang/"
-FANQIE_RANK_URL = "https://fanqienovel.com/rank"
-QIDIAN_M_RANK_URL = "https://m.qidian.com/rank/"
-ZONGHENG_RANK_URL = "https://www.zongheng.com/rank/"
-_UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
-       "(KHTML, like Gecko) Chrome/126 Safari/537.36")
-
-# 页面 UI 噪音词（非书目/分类）：页面 chrome、导航、tab 名、登录/搜索、
-# 榜单 tab 与统计标签（起点移动版 tab 名、纵横月票/人气/点击等）
-_NOISE = {"加入书架", "立即阅读", "开始阅读", "免费阅读", "全部", "分类", "排行",
-          "排行榜", "完本", "连载中", "阅读", "书城", "男生", "女生",
-          "帮助中心", "作家助手", "客服", "登录", "注册", "立即登录",
-          "搜索", "热门作品排行", "大热榜", "新书榜", "完结榜", "收藏榜",
-          "更新榜", "日榜", "月榜", "蝉联", "榜首", "热度", "免费", "畅销",
-          "下载", "客户端", "首页", "我的", "设置", "更多", "返回", "关于",
-          "月票榜", "阅读榜", "书友榜", "推荐榜", "签约榜", "新人榜",
-          "畅销榜", "大家都在搜", "男生小说排行榜", "女生小说排行榜",
-          "男频阅读榜", "女频阅读榜", "男频新书榜", "番茄小说",
-          "登录后获得更多特色功能", "安装起点读书客户端", "看更多正版好书",
-          "月票", "人气", "点击", "万字", "推荐", "收藏", "鲜花", "打赏", "推荐票"}
-
-_CJK_RE = re.compile(r">([\u4e00-\u9fa5]{2,12})<")
-
-
-def _curl_text(url):
-    """curl 子进程抓页面文本；失败返回空串。"""
-    from . import runner
-    try:
-        r = runner.run_process(
-            argv=["curl", "-sS", "--max-time", "20", "-A", _UA, url],
-            timeout=30)
-    except Exception:
-        return ""
-    if not r.get("ok"):
-        return ""
-    return r.get("stdout") or ""
-
-
-def _extract_cjk(html, limit):
-    """从 HTML 提取中文元素材（去 UI 噪音、保序去重）。"""
-    items, seen = [], set()
-    for t in _CJK_RE.findall(html or ""):
-        if t in _NOISE or t in seen:
-            continue
-        seen.add(t)
-        items.append(t)
-        if len(items) >= limit:
-            break
-    return items
-
-
-def fetch_qimao_rank(limit=30):
-    """七猫排行榜：返回元素列表，抓取失败返回 []。"""
-    return _extract_cjk(_curl_text(QIMAO_RANK_URL), limit)
-
-
-def fetch_fanqie_rank(limit=30):
-    """番茄 Web 版榜单：返回元素列表，抓取失败返回 []。"""
-    return _extract_cjk(_curl_text(FANQIE_RANK_URL), limit)
-
-
-def fetch_qidian_rank(limit=30):
-    """起点移动版榜单：返回元素列表，抓取失败返回 []。"""
-    return _extract_cjk(_curl_text(QIDIAN_M_RANK_URL), limit)
-
-
-def fetch_zongheng_rank(limit=30):
-    """纵横排行榜：返回元素列表，抓取失败返回 []。"""
-    return _extract_cjk(_curl_text(ZONGHENG_RANK_URL), limit)
-
-
-# 源清单：顺序即素材拼接顺序（七猫/番茄为元老源保持在前）。
-# 存函数名、调用期 globals() 解析——mock.patch 换模块属性才能生效
-# （存函数引用会把定义期原函数钉死，测试会穿透打真网络）。
-_SOURCES = (
-    ("七猫排行榜素材", "fetch_qimao_rank"),
-    ("番茄排行榜素材", "fetch_fanqie_rank"),
-    ("起点排行榜素材", "fetch_qidian_rank"),
-    ("纵横排行榜素材", "fetch_zongheng_rank"),
-)
-
-
-def fetch_rank_items(limit=40):
-    """四源聚合：各抓一份（跨源去重合并，按源清单顺序）。
-
-    全部失败才返回 []——单源挂了其余源仍可用，扫榜永不因单点挡任务。"""
-    merged, seen = [], set()
-    for _label, fname in _SOURCES:
-        for t in globals()[fname](limit):
-            if t not in seen:
-                seen.add(t)
-                merged.append(t)
-    return merged
-
-
-def rank_scan_prompt(goal):
-    """组装扫榜选材分析提示词。四源全空返回 None（调用方回落直连提示词）。
-
-    报告契约含逐条 A-E 跨平台证据分级（借鉴 career-ops 的分级报告交付形态）：
-    分级只认素材实际出现情况——抑制单源孤证被模型放大成「大热题材」。"""
-    blocks, seen = [], set()
-    for label, fname in _SOURCES:
-        items = [t for t in globals()[fname](30) if t not in seen]
-        seen.update(items)
-        if items:
-            blocks.append("### %s\n%s" % (label, "、".join(items)))
-    if not blocks:
-        return None
-    material = "\n\n".join(blocks)
-    return (
-        "你是网文选题分析师。以下是刚刚抓取的各平台排行榜页面的书目与分类素材：\n\n"
-        "## 榜单元素材\n%s\n\n"
-        "## 用户想写的方向\n%s\n\n"
-        "## 你的产出（Markdown 报告）\n"
-        "报告第一行给图例（一行）：「证据分级：A=三平台及以上重合，B=两平台重合，"
-        "C=单平台多次出现，D=单平台仅一次，E=素材无直接证据、系推断」。\n"
-        "1. **热门题材 Top3**：各自的共同特征与上榜代表书目（跨平台重合的题材单独点出——多平台都热说明是真风口）\n"
-        "2. **高频人设/套路总结**：3-5 条，点名反复出现的元素\n"
-        "3. **差异化切入建议**：2-3 个，结合用户方向给出「题材+人设」组合与一句话理由\n"
-        "以上每一项结论末尾标注【证据X】（X 为 A-E 之一）。分级只看素材里真实出现的"
-        "情况：组合条目按其组成元素的较低档取值，拿不准就降一档、不升级。\n"
-        "直接输出分析报告，不要复述素材清单，不要输出与报告无关的内容。"
-        % (material, goal or "（用户未指定方向，按大盘热门分析）"))
+# -*- coding: utf-8 -*-
+"""扫榜选材：抓取公开排行榜页，产出选题分析素材。
+
+数据源（四源聚合，任一失败不影响其余源；2026-09-24 实测全 200）：
+- 七猫：www.qimao.com/paihang/（106KB）
+- 番茄 Web 版：fanqienovel.com/rank（题材分类+书名在中文 a 标签里；
+  App 端接口有 SecuritySign/X-Argus 签名——那才是难路，Web 版榜单页
+  不需要签名，别走弯路）
+- 起点移动版：m.qidian.com/rank（106KB，直接出书名；主站 www.qidian.com
+  被 WAF 拦 202/209B，移动页不需要签名）
+- 纵横：www.zongheng.com/rank（65KB，书名+统计标签混排，靠噪音词过滤）
+
+下载走 curl 子进程（与 covergen 同款），解析用宽松正则——页面结构变了
+宁可返回空（调用方回落普通直连提示词），不做脆弱的强解析。
+"""
+from __future__ import annotations
+
+import logging
+import re
+
+log = logging.getLogger(__name__)
+
+QIMAO_RANK_URL = "https://www.qimao.com/paihang/"
+FANQIE_RANK_URL = "https://fanqienovel.com/rank"
+QIDIAN_M_RANK_URL = "https://m.qidian.com/rank/"
+ZONGHENG_RANK_URL = "https://www.zongheng.com/rank/"
+_UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+       "(KHTML, like Gecko) Chrome/126 Safari/537.36")
+
+# 页面 UI 噪音词（非书目/分类）：页面 chrome、导航、tab 名、登录/搜索、
+# 榜单 tab 与统计标签（起点移动版 tab 名、纵横月票/人气/点击等）
+_NOISE = {"加入书架", "立即阅读", "开始阅读", "免费阅读", "全部", "分类", "排行",
+          "排行榜", "完本", "连载中", "阅读", "书城", "男生", "女生",
+          "帮助中心", "作家助手", "客服", "登录", "注册", "立即登录",
+          "搜索", "热门作品排行", "大热榜", "新书榜", "完结榜", "收藏榜",
+          "更新榜", "日榜", "月榜", "蝉联", "榜首", "热度", "免费", "畅销",
+          "下载", "客户端", "首页", "我的", "设置", "更多", "返回", "关于",
+          "月票榜", "阅读榜", "书友榜", "推荐榜", "签约榜", "新人榜",
+          "畅销榜", "大家都在搜", "男生小说排行榜", "女生小说排行榜",
+          "男频阅读榜", "女频阅读榜", "男频新书榜", "番茄小说",
+          "登录后获得更多特色功能", "安装起点读书客户端", "看更多正版好书",
+          "月票", "人气", "点击", "万字", "推荐", "收藏", "鲜花", "打赏", "推荐票"}
+
+_CJK_RE = re.compile(r">([\u4e00-\u9fa5]{2,12})<")
+
+
+def _curl_text(url):
+    """curl 子进程抓页面文本；失败返回空串。"""
+    from . import runner
+    try:
+        r = runner.run_process(
+            argv=["curl", "-sS", "--max-time", "20", "-A", _UA, url],
+            timeout=30)
+    except Exception:
+        return ""
+    if not r.get("ok"):
+        return ""
+    return r.get("stdout") or ""
+
+
+def _extract_cjk(html, limit):
+    """从 HTML 提取中文元素材（去 UI 噪音、保序去重）。"""
+    items, seen = [], set()
+    for t in _CJK_RE.findall(html or ""):
+        if t in _NOISE or t in seen:
+            continue
+        seen.add(t)
+        items.append(t)
+        if len(items) >= limit:
+            break
+    return items
+
+
+def fetch_qimao_rank(limit=30):
+    """七猫排行榜：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(QIMAO_RANK_URL), limit)
+
+
+def fetch_fanqie_rank(limit=30):
+    """番茄 Web 版榜单：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(FANQIE_RANK_URL), limit)
+
+
+def fetch_qidian_rank(limit=30):
+    """起点移动版榜单：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(QIDIAN_M_RANK_URL), limit)
+
+
+def fetch_zongheng_rank(limit=30):
+    """纵横排行榜：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(ZONGHENG_RANK_URL), limit)
+
+
+# 源清单：顺序即素材拼接顺序（七猫/番茄为元老源保持在前）。
+# 存函数名、调用期 globals() 解析——mock.patch 换模块属性才能生效
+# （存函数引用会把定义期原函数钉死，测试会穿透打真网络）。
+_SOURCES = (
+    ("七猫排行榜素材", "fetch_qimao_rank"),
+    ("番茄排行榜素材", "fetch_fanqie_rank"),
+    ("起点排行榜素材", "fetch_qidian_rank"),
+    ("纵横排行榜素材", "fetch_zongheng_rank"),
+)
+
+
+def fetch_rank_items(limit=40):
+    """四源聚合：各抓一份（跨源去重合并，按源清单顺序）。
+
+    全部失败才返回 []——单源挂了其余源仍可用，扫榜永不因单点挡任务。"""
+    merged, seen = [], set()
+    for _label, fname in _SOURCES:
+        for t in globals()[fname](limit):
+            if t not in seen:
+                seen.add(t)
+                merged.append(t)
+    return merged
+
+
+def rank_scan_prompt(goal):
+    """组装扫榜选材分析提示词。四源全空返回 None（调用方回落直连提示词）。
+
+    报告契约含逐条 A-E 跨平台证据分级（借鉴 career-ops 的分级报告交付形态）：
+    分级只认素材实际出现情况——抑制单源孤证被模型放大成「大热题材」。"""
+    blocks, seen = [], set()
+    for label, fname in _SOURCES:
+        items = [t for t in globals()[fname](30) if t not in seen]
+        seen.update(items)
+        if items:
+            blocks.append("### %s\n%s" % (label, "、".join(items)))
+    if not blocks:
+        return None
+    material = "\n\n".join(blocks)
+    return (
+        "你是网文选题分析师。以下是刚刚抓取的各平台排行榜页面的书目与分类素材：\n\n"
+        "## 榜单元素材\n%s\n\n"
+        "## 用户想写的方向\n%s\n\n"
+        "## 你的产出（Markdown 报告）\n"
+        "报告第一行给图例（一行）：「证据分级：A=三平台及以上重合，B=两平台重合，"
+        "C=单平台多次出现，D=单平台仅一次，E=素材无直接证据、系推断」。\n"
+        "1. **热门题材 Top3**：各自的共同特征与上榜代表书目（跨平台重合的题材单独点出——多平台都热说明是真风口）\n"
+        "2. **高频人设/套路总结**：3-5 条，点名反复出现的元素\n"
+        "3. **差异化切入建议**：2-3 个，结合用户方向给出「题材+人设」组合与一句话理由\n"
+        "以上每一项结论末尾标注【证据X】（X 为 A-E 之一）。分级只看素材里真实出现的"
+        "情况：组合条目按其组成元素的较低档取值，拿不准就降一档、不升级。\n"
+        "直接输出分析报告，不要复述素材清单，不要输出与报告无关的内容。"
+        % (material, goal or "（用户未指定方向，按大盘热门分析）"))

package/app/core/pipeline.py

@@ -19,7 +19,7 @@ import re
 import threading
 import time
 
-from . import aiflavor, attachments, branching, catalog, chaptersafe, defectretro, dispatch_log, flows, history, hooks, jobs, knowledge, manager, modelhub, mocks, novel_quality, paihang, planner, quality_gate, registry, router, runner, skills, store, task_compile, usage, volumes
+from . import aiflavor, agent_context, attachments, branching, catalog, chaptersafe, checkpoints, defectretro, dispatch_log, flows, history, hooks, jobs, knowledge, manager, modelhub, mocks, novel_quality, paihang, planner, quality_gate, registry, router, runner, skills, store, task_compile, usage, volumes
 from . import builtin_agent
 from . import diagnostics
 from . import paths as paths_mod
@@ -442,6 +442,14 @@ def _run_step(run_id, role, agent, prompt, workdir, readonly, ev, timeout=runner
                                    agent.get("label", agent["id"]), note=note,
                                    model=agent.get("model") or "",
                                    provider=_binding_brief(agent))
+    try:
+        checkpoints.start(
+            run_id, step["n"], role, prompt,
+            input_data={"workdir": workdir, "readonly": readonly,
+                        "agent": agent.get("id")},
+            attempt=len((store.get_run(run_id) or {}).get("steps") or []))
+    except Exception:
+        pass
     start = time.time()
     if dead_binding:
         from .error_codes import ErrorCode
@@ -779,6 +787,17 @@ def _finish_step_result(run_id, step, res, role, agent, start):
                       # 思考过程（内置智能体流式抓取）：落进步骤记录，对话气泡折叠展示
                       thinking=res.get("reasoning") or None,
                       partial=bool(res.get("partial")))
+    try:
+        checkpoint_status = ("unknown" if raw.get("unknown") else
+                             "timeout" if status == "timeout" else
+                             "cancelled" if status == "cancelled" else
+                             "done" if status == "done" else "failed")
+        checkpoints.finish(
+            run_id, step["n"], checkpoint_status,
+            error=res.get("error") or "", output=res.get("text") or "",
+            metadata={"role": role, "agent": agent.get("id") or ""})
+    except Exception:
+        pass
     # 错误台账：失败/超时各记一条结构化记录（遥测与诊断包的数据源）。
     # 用户主动取消不入账——那不是产品问题；detail 只存脱敏后的失败摘录。
     if status in ("failed", "timeout"):
@@ -2692,8 +2711,8 @@ __VOLUME__
 - 撰写本书第 __I__ 章，把本章正文写入文件 `__FILE__`（直接写入该文件，只写本章）。文件必须以 UTF-8 编码保存：PowerShell 一律显式加 `-Encoding UTF8`（如 `Set-Content -Path __FILE__ -Encoding UTF8`），禁止依赖系统默认编码，否则中文会乱码。
 - 章节标题：__TITLE__
 - 剧情要点：__BEATS__
-- 章末钩子：__HOOK__
-- 本章爽点/情绪爆点：__HIGHLIGHT__（必须按特写镜头写厚：铺垫在前、放大在中、余波在后，用动作/五感/生理反应/环境反馈呈现，禁止一句话带过）
+- 章末收束/继续阅读理由（可自然收束或留白）：__HOOK__
+- 本章主要情绪/戏剧变化：__HIGHLIGHT__（按其重要性决定篇幅和表现方式；不强制放大，不为满足标签伪造高潮）
 __LOCKED_CH__
 __STALE_NOTE__
 - 正文约 __WORDS__ 字，中文，直接开写正文（可含本章标题行）。
@@ -2732,23 +2751,23 @@ __STYLE__
 
 ## 签约返修原则
 - 统一叙述语域、句式和视角距离，不在白描、半文半白和网络梗之间跳变。
-- 复杂情感必须落到动作、五感、生理反应和对话潜台词，禁止只写“很伤心/很愤怒”。
-- 爽点/情绪爆点按特写镜头写厚：铺垫在前、放大在中、余波在后，禁止一句话带过。
+- 复杂情感需按其叙事分量呈现；动作、感官、对话、内心直述、环境或留白均可，避免与本稿风格不合的机械扩写。
+- 重要情绪/戏剧变化要有与其分量相称的呈现；避免概括带过，但不把每个变化都扩写成高潮。
 - 删除不改变局面的环境、解释和重复叙述；每段至少完成冲突、信息或人物选择之一。
 - 让主角主动做出选择并推动下一步，补足因果桥，不用旁白硬推剧情。
 
 ## 要求
 - 针对性解决所有 major 问题（含确定性文本信号指出的问题），保持与前后的剧情衔接；字数仍约 __WORDS__ 字。"""
 
-SERIAL_GLOBAL_PROMPT = """你是网文主编（不要修改任何文件）。全书各章已完稿，请从**全书整体**视角评审。
+SERIAL_GLOBAL_PROMPT = """你是独立小说质量评审（不要修改任何文件），不代表任何签约平台。全书各章已完稿，请从**全书整体**视角评审。
 请输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {
   "scores": {"__DIMKEYS__"},
   "issues": [{"dim": "维度名", "severity": "major|minor", "note": "具体问题（指明哪一章）", "quote": "支撑该问题的稿件原文连续片段（≥8字，逐字摘录不许改写）"}],
-  "summary": "一句话总评：是否达到可签约水平"
+  "summary": "一句话总评：所读范围内的文本优势、主要风险与未验证项；不得预测签约结果"
 }
-每个维度打 1-10 分，宁严勿宽。重点关注：主线一致性、人物弧光、开篇吸引力、文风统一、情感细腻度、情节推进与节奏控制。
-若是前 3 章，必须核对黄金一章/黄金三章的切入速度；若发现拖沓、硬推或情绪概括，给出可定位的 major 问题与原文引文。
+每个维度打 1-10 分，按统一文本 rubric 与所读证据评估，不以“宁严勿宽”压分。重点关注：主线一致性、人物弧光、开篇吸引力、文风表现、情感表达、情节推进与节奏控制。
+若是全书最初的前 3 章，可观察视角人物、故事承诺、开篇兑现和读者理解成本；固定字数点、钩子/爽点密度仅作参考，不是扣分门槛。发现问题须给可定位原文引文，并区分文本事实、解释和建议。
 major 问题必须给 quote（系统会逐条校验引文是否真在稿件中——编造的引文会被降档标记）。
 
 ## 全书目标
@@ -2759,19 +2778,19 @@ __GOAL__
 __MANUSCRIPT__
 ---"""
 
-# 独立签约评估（开篇闸门 + 2万字检查点共用）：评分维度保持作者任务口径，
-# 平台五维在这里按平台真实尺度单独核——驳回模板的高频话术逐条要判定。
-SERIAL_SIGNING_EVAL_PROMPT = """你是签约评估编辑（不要修改任何文件）。请按免费阅读平台（番茄/七猫）签约评估的口径评审下面的稿件__NOTE__。
+# 独立文本质量评估（开篇闸门 + 项目检查点共用）：沿用稳定 rubric，
+# 不代表平台决定；按原文证据检查常见拒稿问题，不将经验观察点变成硬门槛。
+SERIAL_SIGNING_EVAL_PROMPT = """你是独立小说质量评审（不要修改任何文件），不是番茄或七猫的签约编辑，不能代表平台结论。
+评审稿件__NOTE__，按下方统一文本质量 rubric 评估；如附当前平台规则或编辑原话，可单独核对适配，不得臆测平台内部标准。
 请输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {
   "scores": {"__DIMKEYS__"},
   "issues": [{"dim": "维度名", "severity": "major|minor", "note": "具体问题（指明哪一章）", "quote": "支撑该问题的稿件原文连续片段（≥8字，逐字摘录不许改写）"}],
-  "summary": "一句话总评：是否达到可申请签约评估的水平"
+  "summary": "一句话内部文本诊断：优势、主要风险和未验证项；不得表述为平台结论或过签预测"
 }
-每个维度打 1-10 分（可为小数），按平台真实尺度从严。五个维度固定为：开篇吸引力、情节推进、文风统一、情感细腻度、节奏控制。
-驳回模板的高频话术——文风在风格上不统一（语域/句式跳变）、
-复杂情感描绘不够细腻（情绪概括无动作细节）、开篇切入点缺乏足够的吸引力（黄金一章未兑现）、情节的推动生硬（因果桥缺失/旁白硬推）、
-行文拖沓节奏缓慢（重复铺垫、与主线无关的描写）——每一条都要给出明确判定与证据。
+统一评分 rubric：1-3 为明显影响理解或阅读的严重问题；4-6 为有具体可定位的弱项；7-8 为基本有效、仍有局部提升空间；9-10 为在本稿目标下表现突出。分数必须由所读文本支撑，不把分数映射成过签概率。
+五个维度固定为：开篇吸引力、情节推进、文风统一、情感细腻度、节奏控制。每项给证据与未读范围；不能因不用某种套路（如黄金三章、打脸、单一视角）扣分。
+可检查文风是否突变、情绪是否被概括、开篇承诺是否兑现、因果桥是否成立、重复是否损害节奏；这些是检查问题而不是预设缺陷。没有当前平台规则或明确编辑反馈时，不把质量评审包装成平台审核结论。
 
 ## 待评审稿件
 ---
@@ -4309,7 +4328,7 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                                          agent.get("label"))
                 time.sleep(0.15)
                 gj = {"scores": {d: 8.0 for d in dims},
-                      "issues": [], "summary": "（mock）全书结构完整，达到可签约水平"}
+                      "issues": [], "summary": "（mock）内部结构评估：整体结构完整；此结果不代表平台签约结论"}
                 store.finish_step(run_id, step["n"], "done", summary="均分 8.0：（mock）全书达标",
                                   duration_s=0.15)
                 results[idx] = gj
@@ -4326,7 +4345,7 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                     "- 本次送审批次为全书第 %d—%d 章（连载中段批次），文本中的前文节选仅供衔接核对；\n"
                     "- 「黄金一章/黄金三章」口径仅适用于全书第 1—3 章，不得据此扣减本批批首章的开篇分；\n"
                     "- 本批各章的既定事件以工作目录「章纲/」下的锁定章纲为准（可自行查阅）：承段、"
-                    "过渡章的节奏分应对照章纲既定事件是否落实与章末钩子是否成立，"
+                    "过渡章的节奏分应对照章纲既定事件与叙事功能是否落实；自然收束、留白均可，不以悬念钩子作为硬门槛。"
                     "不以高潮段的事件密度为统一标准；\n"
                     "- 「伏笔悬置」类 major 须先核对章纲的揭示位安排：揭示位写在后批章纲中的伏笔"
                     "不算悬置，无任何安排的悬置才成立；\n"
@@ -5505,6 +5524,11 @@ def execute_run(run_id):
                      difficulty=task_spec["difficulty"])
     task = dict(task)
     task = attachments.refresh_task(task, task.get("workdir") or "")
+    try:
+        task, _agent_context = agent_context.inject(task, task.get("workdir") or "")
+        store.update_run(run_id, agent_context=_agent_context)
+    except Exception:
+        pass
     task["_compiled_spec"] = task_spec
     # 运行内统一使用编译后的难度；store 中历史任务常带 difficulty=auto，
     # 不能让这个兼容值覆盖 easy/default/hard 的模型调度决策。

package/app/core/planner.py

@@ -250,21 +250,25 @@ __GOAL__
 ## 背景与上下文
 __CONTEXT__"""
 
-SERIAL_OUTLINE_PROMPT = """你是网文主编，熟悉签约平台（番茄/七猫/起点）的过稿标准。
+SERIAL_OUTLINE_PROMPT = """你是小说结构编辑。你不代表番茄、七猫或其他平台，也不能预测签约或流量结果。
 
 __SKILLS__
 请为下面的小说目标设计一份连载大纲：共 __N__ 章，每章约 __W__ 字。
 只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {"book_title": "书名", "style_anchor": "全书文风锚（80字内，具体可执行：叙述视角与人称、句长基调、语域、对白风格、禁用表达）", "chapters": [{"title": "章节标题", "beats": "本章剧情要点（50-120字：事件/冲突/推进）", "hook": "章末钩子（一句话）", "highlight": "本章爽点/情绪爆点（一句话：谁在哪里完成什么反转或释放什么情绪）"}]__VOLUMES_KEY__}
+字段说明：hook 可为自然收束、留白或继续阅读理由，不强制悬念；highlight 表示主要戏剧/情绪变化或回报，无显著爆点时说明叙事功能，不要强造爆点。
 硬性要求：
 - book_title 4-15 字，必须考虑平台书名全站唯一（撞名建不了书）：避开「我的XX藏不住」
   「开局XX」等高频套路组合，书名里带本书独有的专名（人名/金手指/设定词），独有专名越多越不易撞名；
-- 第 1-3 章是黄金三章：第 1 章前 100 字出现主角、前 200 字出现异常或欲望、前 600 字进入具体困境，
-  第 3 章末留大钩子；不要用世界观或环境描写拖延切入；
-- 每章都写清“主角主动选择 → 阻碍 → 局面变化 → 章末钩子”，禁止水字数的日常流水账和硬旁白推剧情；
+- 把开篇字数位置当阅读观察点而非硬门槛：尽早让读者辨认视角人物、故事承诺和正在发生的事，
+  但按题材、叙述策略与实际效果决定节奏，不为数字机械塞冲突；
+- 每章要有清楚的叙事功能（推进事件、人物/关系、信息、氛围或情绪之一或多项），并检查因果与局面变化；
+  不强制每章都打脸、反转或以悬念断章；
+- 章末可自然收束或留白；大纲中的 highlight 描述主要戏剧/情绪变化或回报，无显著爆点时写清叙事功能，不要强造爆点。
 - 大纲中的情感转折必须给出触发事件和人物选择，不能只写“误会加深/感情升温”；
 - style_anchor 是全书唯一的文风锚，每章起草/修订/评审都会注入：必须写明视角人称与句长基调等可执行约束，不要空话；
-- 每章必须给出 highlight（爽点/情绪爆点）：没有爆点的章节要重新设计，过渡章也要有小冲突小反转；
+- highlight 是本章主要情绪/戏剧变化或读者回报，可为爽、暖、痛、惊、趣味、亲密、发现、安定等；
+  平静或过渡章节可承担必要功能，不为填字段伪造高潮；
 - 结局必须闭环（完本感），主角有成长弧光；
 - 题材健康，无违规内容，符合平台签约调性。
 __VOLUMES__
@@ -286,7 +290,7 @@ __SKILLS__
 - 主线沿既有脉络推进，新冲突尽量从已埋伏笔中生长，人物性格与前文一致；
 - 若下方给出「锁定章纲」：本批各章 title/beats/hook 必须逐章从对应章纲提炼对齐
   （标题沿用、视角不换、节拍不裁并、伏笔揭示位不提前），不得虚构章纲之外的主线事件；
-- 每章都写清“主角主动选择 → 阻碍 → 局面变化 → 章末钩子”，禁止水字数的日常流水账；
+- 在关键章节写清人物选择、阻碍与后果；不要求每章都有完整冲突闭环或悬念钩子，避免无功能重复；
 - 复杂情感必须落到触发事件、动作/生理反应和潜台词，不能用一句概括代替；
 - 延续既定叙述视角和语言锚点（见下方既定文风锚），删掉重复复述，避免节奏变慢；
 - 题材健康，无违规内容，符合平台签约调性。
@@ -749,15 +753,17 @@ def make_serial_outline(task, author_agent=None, workdir=None, ev=None, log_path
 
 # 开篇重设计提示词（开篇闸门专用）：第 1 章签约评估的开篇吸引力未达线时，
 # 回大纲层重设计前三章节拍而不是只修稿——切入点不行是结构病，修文案救不了。
-SERIAL_OPENING_REBUILD_PROMPT = """你是网文主编，熟悉签约平台（番茄/七猫/起点）的过稿标准。
-这本书的第 1 章在签约预评估中「开篇吸引力」未达线，评审意见如下：
+SERIAL_OPENING_REBUILD_PROMPT = """你是小说结构编辑，不代表任何平台，也不能预测签约结果。
+这本书的开篇评审发现吸引力风险，实际意见如下：
 __CRITIQUE__
 
-请重设计前 __COUNT__ 章的大纲节拍（只动这 __COUNT__ 章，不碰后续章节），让开篇符合黄金一章标准：
-第 1 章前 100 字出现主角、前 200 字出现异常或冲突、前 600 字进入具体困境、章末留可兑现的钩子；
-切入点必须是具体事件（退婚/陷害/背叛/生死危机等），禁止世界观铺垫开局。
+请重设计前 __COUNT__ 章的大纲节拍（只动这 __COUNT__ 章，不碰后续章节），针对反馈解决具体问题。
+先保留原稿有效之处，再提出能改变事件、人物选择或后果的改动；不能只换词、加怪声或添加钩子。
+前 100/200/600 字只是阅读观察点，不是硬指标；不预设危机、金手指、背叛或打脸。
+判断开篇是否成立，要看题材承诺是否兑现、事件是否具体、读者能否理解人物处境和下一步，尊重本稿叙述方式。
 只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {"chapters": [{"title": "章节标题", "beats": "本章剧情要点（50-120字：事件/冲突/推进）", "hook": "章末钩子（一句话）", "highlight": "本章爽点/情绪爆点（一句话）"}]}
+其中 hook 可为自然收束、留白或继续阅读理由，不强制悬念；highlight 无显著爆点时说明叙事功能，不要强造爆点。
 章序与原大纲一致（从第 1 章起），必须保持书名、主角与核心设定不变，只强化切入与钩子设计。
 
 ## 全书目标

package/app/core/policy.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+"""Descriptive sandbox policy primitives shared by API and runners."""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+
+def normalize_sandbox(spec=None, workdir=None):
+    spec = spec if isinstance(spec, dict) else {}
+    root = Path(workdir or os.getcwd()).expanduser().resolve()
+    roots = []
+    for value in spec.get("allowed_roots") or [str(root)]:
+        try:
+            candidate = Path(value).expanduser().resolve()
+        except (TypeError, OSError, ValueError):
+            continue
+        if candidate not in roots:
+            roots.append(candidate)
+    if not roots:
+        roots = [root]
+    env = []
+    for value in spec.get("env_allowlist") or []:
+        name = str(value or "").strip()
+        if name and name.replace("_", "a").isalnum() and name not in env:
+            env.append(name)
+    try:
+        timeout = max(1, min(7 * 24 * 3600, int(spec.get("timeout_s") or 3600)))
+    except (TypeError, ValueError):
+        timeout = 3600
+    try:
+        output = max(1024, min(100 * 1024 * 1024, int(spec.get("max_output_bytes") or 10 * 1024 * 1024)))
+    except (TypeError, ValueError):
+        output = 10 * 1024 * 1024
+    return {"allowed_roots": [str(x) for x in roots], "env_allowlist": env,
+            "network": bool(spec.get("network", True)), "timeout_s": timeout,
+            "max_output_bytes": output}
+
+
+def path_allowed(path, sandbox):
+    try:
+        candidate = Path(path).expanduser().resolve()
+        return any(candidate == Path(root) or Path(root) in candidate.parents
+                   for root in (sandbox or {}).get("allowed_roots") or [])
+    except (TypeError, OSError, ValueError):
+        return False
+
+
+def filter_env(env, sandbox):
+    values = env if isinstance(env, dict) else {}
+    allow = (sandbox or {}).get("env_allowlist") or []
+    return {str(k): str(v) for k, v in values.items() if str(k) in allow}