codebee 0.1.72 → 0.1.74

package/app/core/retrieval.py

@@ -0,0 +1,137 @@
+"""Dependency-free retrieval index with traceable keyword scoring.
+
+This is intentionally a RAG-lite layer: SQLite/vector backends can be added
+later without changing the API contract. Every hit carries its source and the
+terms that caused the match.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import threading
+from pathlib import Path
+
+from . import paths
+
+_LOCK = threading.RLock()
+_FILE = paths.DATA_DIR / "retrieval_index.json"
+_WORD_RE = re.compile(r"[A-Za-z0-9_]+|[\u4e00-\u9fff]")
+_MAX_FILES = 500
+_MAX_BYTES = 20 * 1024 * 1024
+_SKIP_DIRS = {".git", "node_modules", "__pycache__", ".venv", "venv", ".idea", ".vscode"}
+
+
+def _terms(text):
+    return [x.lower() for x in _WORD_RE.findall(str(text or ""))]
+
+
+def _load():
+    try:
+        value = json.loads(_FILE.read_text(encoding="utf-8"))
+        return value if isinstance(value, dict) else {"documents": {}}
+    except Exception:
+        return {"version": 1, "documents": {}}
+
+
+def _save(value):
+    _FILE.parent.mkdir(parents=True, exist_ok=True)
+    tmp = _FILE.with_suffix(".tmp")
+    tmp.write_text(json.dumps(value, ensure_ascii=False, indent=1), encoding="utf-8")
+    tmp.replace(_FILE)
+
+
+def upsert(source, text, metadata=None, doc_id=""):
+    source = str(source or "").strip()[:500]
+    text = str(text or "").strip()
+    if not source or not text:
+        raise ValueError("source 和 text 不能为空")
+    root_hint = ""
+    if isinstance(metadata, dict):
+        root_hint = str(metadata.get("root") or "")[:500]
+    did = str(doc_id or hashlib.sha256((root_hint + "\0" + source).encode("utf-8")).hexdigest()[:20])[:100]
+    meta = metadata if isinstance(metadata, dict) else {}
+    meta = {str(k)[:80]: str(v)[:1000] for k, v in list(meta.items())[:30]}
+    row = {"id": did, "source": source, "text": text[:200000],
+           "terms": sorted(set(_terms(text))),
+           "metadata": meta}
+    with _LOCK:
+        data = _load()
+        data.setdefault("version", 1)
+        documents = data.setdefault("documents", {})
+        # Explicit IDs are client supplied; avoid silently replacing an
+        # unrelated document when two sources reuse the same short ID.
+        if did in documents and documents[did].get("source") != source:
+            suffix = hashlib.sha256((source + "\0" + text).encode("utf-8")).hexdigest()[:12]
+            did = (did[:87] + "-" + suffix)[:100]
+            row["id"] = did
+        documents[did] = row
+        _save(data)
+    return row
+
+
+def index_directory(root, extensions=(".md", ".txt", ".json"), limit=500,
+                    allowed_roots=None, max_bytes=_MAX_BYTES):
+    root = Path(root).expanduser().resolve()
+    if not root.is_dir():
+        raise ValueError("目录不存在")
+    if allowed_roots is not None:
+        roots = [Path(p).expanduser().resolve() for p in allowed_roots if p]
+        if not any(root == p or p in root.parents for p in roots):
+            raise ValueError("只能索引任务工作目录范围内的文件")
+    try:
+        file_limit = max(1, min(_MAX_FILES, int(limit)))
+    except (TypeError, ValueError):
+        raise ValueError("limit 必须是整数")
+    try:
+        byte_limit = max(1, min(_MAX_BYTES, int(max_bytes)))
+    except (TypeError, ValueError):
+        raise ValueError("max_bytes 必须是整数")
+    count = 0
+    total_bytes = 0
+    for path in root.rglob("*"):
+        if count >= file_limit or total_bytes >= byte_limit:
+            break
+        # Never follow a symlink while indexing user-controlled trees.
+        if path.is_symlink() or any(part in _SKIP_DIRS for part in path.relative_to(root).parts):
+            continue
+        if path.is_file() and path.suffix.lower() in extensions:
+            try:
+                resolved = path.resolve()
+                if resolved != root and root not in resolved.parents:
+                    continue
+                size = path.stat().st_size
+                if size > byte_limit - total_bytes:
+                    continue
+                upsert(str(path.relative_to(root)), path.read_text(encoding="utf-8", errors="replace"),
+                       {"root": str(root)})
+                count += 1
+                total_bytes += size
+            except OSError:
+                pass
+    return {"indexed": count, "bytes": total_bytes,
+            "total": len(_load().get("documents") or {})}
+
+
+def search(query, limit=10):
+    try:
+        n = max(1, min(50, int(limit or 10)))
+    except (TypeError, ValueError):
+        raise ValueError("limit 必须是整数")
+    terms = set(_terms(str(query or "")[:500]))
+    if not terms:
+        return []
+    with _LOCK:
+        docs = list((_load().get("documents") or {}).values())
+    rows = []
+    for doc in docs:
+        matched = sorted(terms.intersection(doc.get("terms") or []))
+        if not matched:
+            continue
+        score = len(matched) / max(1, len(terms))
+        rows.append({"id": doc.get("id"), "source": doc.get("source"),
+                     "score": round(score, 4), "matched_terms": matched,
+                     "snippet": str(doc.get("text") or "")[:600],
+                     "metadata": doc.get("metadata") or {}})
+    rows.sort(key=lambda x: (-x["score"], x["source"] or ""))
+    return rows[:n]

package/app/core/runner.py

@@ -12,6 +12,7 @@
 """
 from __future__ import annotations
 
+import glob
 import json
 import os
 import re
@@ -68,10 +69,50 @@ def find_git_bash():
     return None
 
 
+_CLI_EXTS = (".exe", ".cmd", ".bat")
+
+
+def _fallback_probe_cli(name):
+    """which() 落空时按常见安装位兜底找 CLI（Windows only），返回全路径或 None。
+
+    服务进程的 PATH 是启动那一刻的快照：CLI 在服务起跑之后才安装/迁移（如
+    2026-09-30 claude 转 winget 原生安装）时，快照里没有新目录，which 解析
+    不到、裸名直传 Popen 直接 FileNotFoundError，直到重启服务才自愈。这里
+    只探测磁盘已知落点，不改 PATH、不缓存（装没装是低频事件，探几次不亏）。
+    """
+    if os.name != "nt":
+        return None
+    name = str(name)
+    if not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]*", name):
+        return None   # 带斜杠/参数形态的不是裸命令名，交给原路径逻辑
+    local = os.environ.get("LOCALAPPDATA") or ""
+    home = os.path.expanduser("~")
+    appdata = os.environ.get("APPDATA") or os.path.join(home, "AppData", "Roaming")
+    flat_dirs = (
+        os.path.join(local, "Microsoft", "WinGet", "Links"),
+        os.path.join(home, ".local", "bin"),
+        os.path.join(appdata, "npm"),
+    )
+    for d in flat_dirs:
+        for ext in _CLI_EXTS:
+            p = os.path.join(d, name + ext)
+            if os.path.isfile(p):
+                return p
+    # winget 便携包：Packages\<厂商.Id_*>\name.EXE（目录名带来源哈希，glob 一层）
+    pkgs = os.path.join(local, "Microsoft", "WinGet", "Packages")
+    try:
+        for p in glob.glob(os.path.join(pkgs, "*", name + ".*")):
+            if p.lower().endswith(_CLI_EXTS) and os.path.isfile(p):
+                return p
+    except OSError:
+        pass
+    return None
+
+
 def resolve_command(command):
     """命令名 → 可直接 spawn 的 argv 前缀（.cmd/.bat 垫片必须经 cmd /c）。"""
-    path = shutil.which(command) or command
-    low = path.lower()
+    path = shutil.which(command) or _fallback_probe_cli(command) or command
+    low = str(path).lower()
     if low.endswith(".cmd") or low.endswith(".bat"):
         return ["cmd", "/c", path]
     return [path]
@@ -719,6 +760,16 @@ def run_process(argv=None, shell_cmd=None, stdin_text=None, cwd=None, env=None,
                 stdout=subprocess.PIPE, stderr=subprocess.PIPE,
                 creationflags=CREATE_NO_WINDOW,
                 start_new_session=(os.name != "nt"))  # POSIX 需独立进程组供 killpg 杀树；Windows 忽略该参数
+        except FileNotFoundError as e:
+            # filename=None 时 %r 只有一句「系统找不到指定的文件」，无从排查
+            # （2026-09-30 claude winget 迁移实案：服务 PATH 快照过旧）。
+            tgt = str(argv[0]) if argv else ""
+            return {"ok": False, "exit_code": None, "stdout": "",
+                    "stderr": ("启动失败：找不到可执行文件「%s」。CLI 未安装或已卸载；"
+                               "若刚安装，重启 CodeBee 服务让 PATH 生效即可。"
+                               % tgt),
+                    "duration": 0.0, "cancelled": False, "timed_out": False,
+                    "stalled": False, "deadline_exceeded": False, "abort_marker": None}
         except Exception as e:
             return {"ok": False, "exit_code": None, "stdout": "",
                     "stderr": "启动失败: %r" % e, "duration": 0.0,
@@ -1578,6 +1629,30 @@ def _invalid_model(model):
     return str(model or "").strip().lower() in _INVALID_MODEL_NAMES
 
 
+# opencode 启动横幅形如「> build · glm-5.3」（ANSI 清洗后一行、圆点分隔）；
+# 真错误（配额/配置/网络）CLI 都会另打印文本，不会是纯横幅形态
+_OC_BANNER_LINE_RE = re.compile(r"^\s*>?\s*[^\s·•]+\s*[·•]\s*\S+\s*$")
+
+
+def _opencode_fast_banner_death(res):
+    """opencode 启动期秒退签名：退出码 1、总时长很短、输出清洗 ANSI 后只剩
+    启动横幅、没有任何错误文本。真实失败不走这个形态；该形态只值得原地
+    立即重试一次（配置写读竞态/端口抢占类瞬时抖动，2026-09-30 实案：
+    并行评审爆发期连续三发「退出码 1；stderr/stdout: > build · glm-5.3」，
+    数分钟后同进程自愈）。"""
+    if res.get("ok") or res.get("exit_code") != 1:
+        return False
+    try:
+        if float(res.get("duration") or 0) > 15.0:
+            return False
+    except (TypeError, ValueError):
+        return False
+    blob = clean_cli_text((res.get("stderr") or "") + "\n"
+                          + (res.get("stdout") or ""))
+    lines = [ln.strip() for ln in blob.splitlines() if ln.strip()]
+    return bool(lines) and all(_OC_BANNER_LINE_RE.match(ln) for ln in lines)
+
+
 def run_agent(agent, prompt, workdir=None, readonly=True,
               timeout=DEFAULT_TIMEOUT, cancel_event=None, log_path=None, resume=None,
               images=None, require_tools=False, deadline=None):
@@ -1801,6 +1876,14 @@ def run_agent(agent, prompt, workdir=None, readonly=True,
                    "provider_id": att.get("provider_id") or "",
                    "provider": att.get("provider") or {}}
             if not res["ok"]:
+                if (kind == "opencode" and attempt == 0
+                        and _opencode_fast_banner_death(res)
+                        and not (cancel_event is not None
+                                 and cancel_event.is_set())):
+                    _log_note(log_path,
+                              "opencode 启动即退（仅横幅无错误文本）——按瞬时抖动 2s 后原地重试一次")
+                    time.sleep(2.0)
+                    continue
                 # stderr 与 stdout 都要进错误串：codex 把 "Reading prompt from
                 # stdin..." 打在 stderr，真正的配额/限流错误全在 stdout 的 JSONL
                 # 里——只取其一会让 _quota_error/_transient_error 判空。

package/app/core/skillpacks/fanqie-novel.md

@@ -1,63 +1,69 @@
 # 番茄小说写作与流量守则（内置经验包）
 
-来源：番茄作家社区与作者群体的通行经验汇编 + 平台公开运营机制（2025）。
+来源：番茄作家社区与作者群体的通行经验汇编 + 平台公开运营机制（2025，B/C 级经验材料）；
+可复查入口：[番茄作家后台](https://fanqienovel.com/main/writer/)（当前政策以登录后页面为准）。
 签约字数、保底金额、全勤门槛、审核时长等**政策数字随年份调整，一律以「番茄作家后台」当前规则为准**，
 本包不固化具体数值。这是写作参考，不是官方规则，也不是爆款预测；不以格式检查推断过签/起量概率。
 
-## 〇、与传统编辑平台的根本区别：番茄是算法平台
-- 老牌免费站（编辑审稿制）= **编辑守门**（人审稿定签约）；番茄 = **算法守门**（数据定生死）。
-  签约只是门票，签约之后靠完读率/追读率挣流量，才真正决定这本书的死活。
-- 读者画像：下沉市场、碎片时间、耐心极低——**弃书零成本**（免费，右上角一点就走）。
-  开局漏斗比任何平台都陡：书名 → 简介/标签 → 第一章 → 前三章，每关都在大量筛人。
-- 收入模型 = 免费阅读 + 广告分成（读者读得越久、追得越多，广告收益越高），
-  叠加签约保底/全勤（若合同有）。所以 **追读率 > 文笔 > 一切自我感动**。
-
-## 一、新书生存线：流量池与数据指标
-- 通行理解的机制：新书发布后先进**小流量测试**，按数据逐级放量（书架/推荐/搜索）；
-  数据不达标就被限流直至"饿死"。**前 30 天左右的新书期是定生死窗口**。
-- 后台核心指标（以作家后台实际展示为准）：**完读率**（本章读完比例，决定能否进下一流量层）、
-  **追读率**（读了开头还在追最新章的比例，决定推荐是否持续）、留存、平均阅读时长。
-- 数据异常按段落定位病因：第一章完读低 = 开头崩（改开篇）；中段崩 = 节奏/爽点密度不足；
-  结尾追读崩 = 断章钩子或大坑久拖不兑现。**不要用"再等等"掩盖结构性问题**。
-- 反恐慌纪律：头几天数据小、噪声大，不要 48 小时一改动；到样本足够（约两周）仍差，
-  **果断切书开新**——算法平台的沉没成本陷阱比编辑平台大得多。
-
-## 二、开篇（黄金三章，番茄从严）
-- 番茄测的是**整前三章**的完读与追读，不是单看第一章：第一章钩人、第二章兑现金手指/核心设定、
-  第三章第一个完整爽点闭环，缺一章都撑不起数据。
-- 前 100 字：主角 + 具体冲突/异常直接进场；前 600 字：困境压到脸上。
-- 开篇禁忌（每条都有对应数据崩法）：世界观说明文（第一章完读崩）、慢热日常（第二章崩）、
-  多视角群像（读者找不到主角，追读崩）、倒叙解谜（下沉读者直接弃）。
+## 证据等级与使用边界（2026-09-30 更新）
+
+- **A级：当前后台/合同/官方公告**：用于确认投稿、签约、更新、版权和内容红线；公开经验不能覆盖当前页面。
+- **B级：多作者经验、编辑反馈或后台数据**：只作为可检验的诊断假设，必须写明样本、章节范围和下一步实验。
+- **C级：单个案例、固定字数或传闻算法权重**：不作硬门槛，不宣称推荐、签约或收入因果；没有样本就保留为待验证。
+- 质量报告按“文本质量 → 平台适配 → 当前政策”分层。每个结论都给出证据位置、未知项和可逆改动；完读率、追读率等数字是定位线索，不是文学评分。
+
+### 番茄与通用质量底线
+
+先检查具体事件是否触发主角主动选择，并产生可见后果、阶段性兑现和新的问题；再检查人物动机、因果连续性、文风一致、移动端可读性与内容安全。算法指标不能替代逐章阅读，也不能把“数据暂时好”写成质量已证实。
+
+## 〇、与传统编辑平台的差异（工作假设，非权重说明）
+- 番茄可按“数据参与分发”的工作假设来设计实验；这不等于知道算法权重，也不等于签约后完全无人审查。
+  “签约只是门票、完读率/追读率影响后续分发”是作者社区的工作假设，不能据此断言推荐权重或作品成败。
+- 作者社区常用“免费阅读、碎片时间、切换成本低”描述部分读者场景；这是受众假设，不代表所有番茄读者。
+  可按“书名 → 简介/标签 → 第一章 → 前三章”检查作品承诺是否连贯，但不预设各环节转化率。
+- 作者材料通常将番茄描述为免费阅读与广告变现模式，合同也可能包含保底/全勤；具体收入来源、结算和资格以当前平台说明及合同为准。
+  追读、留存和阅读时长可以帮助定位问题，但不能直接换算成收益、推荐因果，也不能推出“追读率 > 文笔”或任何平台保证。
+
+## 一、新书观察：流量池与数据指标
+- “先小范围试读、再按数据扩大分发”是作者对新书的常用工作假设；推荐路径和权重不可见，不能写成算法事实。
+- “前 30 天”只能作为一个可调整的早期观察窗口；具体窗口随频道、发书节奏和样本量变化，不是定生死的硬线。
+- 后台常见观察指标（名称与定义以作家后台实际展示为准）：完读、追读、留存、平均阅读时长；
+  报告使用平台给出的定义，不根据经验帖自行推导指标口径。它们是诊断线索，不能代替因果证据。
+- 数据异常可先按段落提出假设：第一章完读偏低就复查开篇，中段下滑就复查节奏/兑现，
+  章末流失就复查钩子与承诺回收；题材、流量、样本量和发布节奏也可能影响结果，需逐项复验。
+- 反恐慌纪律：头几天样本小、噪声大，不要用单日波动证明改稿有效；达到可解释的样本后，按段落和读者反馈做小步实验。是否重写、重开或继续，需结合作者成本、合同和目标，不给“48 小时/两周切书”固定建议。
+
+## 二、开篇（前三章观察框架，不是平台硬门槛）
+- 作者经验常用**前三章**做完读与追读对照：第一章交代钩子、第二章兑现核心设定、
+  第三章完成一个故事单元；缺一章不等于必然失败，须结合样本与正文证据。
+- 前 100/600 字可作为阅读负担取样点：记录主角、冲突和困境何时出现，不把位置数字当硬门槛。
+- 世界观说明文、慢热日常、多视角群像和倒叙解谜可列为待验证风险；不能直接把某种写法归因成数据崩溃。
 
 ## 三、节奏与爽点
-- **每章至少一个爽点或情绪波动 + 章尾强钩子**；番茄章节奏建议 1800-2500 字/章（短平快，
-  卡阅读间隙），别写 4000 字大章考验耐心。
-- 主线必须是"一句话能讲清的直线"：目标明确、单线推进、读者永远知道主角下一步要干什么。
-  多线叙事、慢热铺垫在番茄大概率数据判死刑。
-- 前 100 章要完成一次大爽点闭环（打脸/升级/身份跃迁的大兑现）；过渡章连续两章以上无兑现，
-  追读率就会肉眼可见地掉。
-- 跨平台通用的铁律仍然有效：主角主观能动性红线、打压为爆发服务、反派不能无脑。
+- **每章应有可感知的变化、情绪波动或兑现，并留下可追问的下一步**；1800-2500 字可作为一次节奏实验的起点，按题材、章节目标和后台数据调整，**不作硬门槛**。
+- 建议先用一句话说明主线目标和下一步；多线叙事、慢热铺垫可列为待验证风险，
+  先用章节目标、读者反馈和后台分段数据复核，不预设结果。
+- 早期长线应安排一次完整的大兑现（打脸/升级/身份跃迁等），具体章节不固定；连续多个章节无兑现时，先回到事件、选择、后果链查找原因，不把数据变化直接归因于某个数字。
+- 跨平台复查维度：主角是否有选择，阻碍是否有因果，对手是否有动机；具体呈现不强制一种人物模板。
 
 ## 四、题材、书名、标签与简介
-- 番茄大盘热门题材带（男频）：都市高武/都市脑洞、历史穿越、玄幻、悬疑脑洞（民俗/规则怪谈系在此，
-  守村人这类民俗悬疑素材适合往"悬疑脑洞"标签靠）；女频：脑洞言情、年代、萌宝。题材热度轮动快，
-  开书前扫一次当季榜单。
-- **分类/标签是流量匹配的第一步**：挂错分类 = 推给错的人 = 数据全差且查不出原因。
-  书名、简介、标签三者对题材的表达必须一致（算法按这些做人群匹配）。
+- 经验材料提及过的题材仅作历史参照，不当当前热度结论；开书前按当季榜单和作者后台实际类目复核，
+  再判断题材与目标读者是否匹配。
+- **分类/标签是作者常用的匹配入口假设**：挂错分类可能造成承诺与读者预期错位，但实际推荐机制不可见。
+  书名、简介、标签三者应与正文题材一致；不要把一致性检查写成已知算法规则。
 - 书名策略：长尾、带情绪、带题材关键词；简介三要素：身份处境 + 核心冲突 + 悬念钩子。
 
-## 五、更新纪律（算法平台命门）
-- **日更稳定 > 单日爆更**：断更打断追读链，数据直接塌方；全勤/推荐权重普遍与稳定日更挂钩
-  （具体门槛看当前合同与后台规则）。
-- 存稿 ≥10 万字再发书；新书期若存稿允许，日双更冲数据——推荐系统吃"活跃 + 追读"信号。
+## 五、更新纪律（可持续性优先）
+- **稳定更新是可检验的生产策略，不是推荐保证**：断更会影响读者预期，但全勤和推荐条件必须以当前合同/后台为准。
+- 存稿量、日更频率和是否双更按作者的可持续产能、章节质量和当前规则设定；“10 万字存稿”等经验数字不作硬门槛。
 - 卡文宁可降纲不降质：拆未来 3 章的单元（目标→行动→阻碍→反转），别水字数糊弄——
-  水章的完读率会当场出卖你。
+  水章可能在完读或读者反馈中暴露，但必须记录样本和改动范围再下结论。
 
 ## 六、签约与合同
 - 申请门槛（字数）、审核时长以作家后台当前规则为准；常见审核材料 = 开篇正文 + 大纲，
   大纲别只写一句"后面上架爆火"，要有明确的阶段目标与兑现节点。
-- 类型以**分成为主**，优质作品可谈保底；签前重点看清 **影视/动漫/版权衍生授权范围**与独家条款、
-  违约与切书条款——免费平台合同中 IP 衍生让渡比例是历来争议集中点。
+- 分成、保底及其他合作模式以当前后台可选项和合同为准；签前逐条核对影视/动漫/版权衍生授权范围、
+  独家义务、违约与解约条款，不沿用经验帖中的金额或比例。
 - 拒签自救：先归因（题材带匹配？开篇数据思维？大纲兑现链缺失？），改完再申；
   同一作品反复无修改重投没有意义。
 
@@ -69,12 +75,24 @@
 - **细节刻画力度**：每个爽点/反转标记"特写镜头"，五感 + 微动作 + 环境反馈把爆发那几秒写厚，
   铺垫在前、放大在中、余波在后；过渡章才可一笔带过。**"每章一小爽"不配特写等于没写**。
 
-## 八、开书/投稿前自检清单
+## 八、后台数据诊断卡（仅在样本足够时使用）
+
+| 观察到的信号 | 先检查的文本假设 | 可逆动作 | 复验方式 |
+| --- | --- | --- | --- |
+| 第一章完读偏低 | 冲突/主角/承诺是否晚于读者耐心 | 只改开篇一个变量 | 对照后续同类章节或下一批样本 |
+| 中段明显下滑 | 目标、阻碍和兑现是否断档 | 收紧一个故事单元 | 看后续章节完读与反馈是否同步改善 |
+| 章末到下一章流失 | 章尾问题是否可追问、前文承诺是否兑现 | 重写章尾或补回收 | 观察下一章首段和追读变化 |
+| 标签/简介点击与阅读不匹配 | 作品承诺与正文是否错位 | 先修承诺或分类，不同时改正文 | 记录改动范围后再看数据 |
+
+没有样本、后台指标含义不明或同时改了多个变量时，结论标为“证据不足”，不宣称掌握推荐权重。
+
+## 九、开书/投稿前自检清单
 - [ ] 书名/标签/简介一致表达题材，分类挂对
 - [ ] 第 1 章前 100 字冲突进场；前三章 = 钩子 + 设定兑现 + 完整爽点闭环
-- [ ] 每章 1800-2500 字，含至少一个爽点 + 章尾钩子
+- [ ] 每章有可感知的变化/情绪或兑现，章尾留下可追问的问题；字数仅作节奏实验，不作硬门槛
 - [ ] 主线一句话讲得清，单线推进，无慢热铺垫章节
-- [ ] 前 100 章有一次大兑现闭环的规划
-- [ ] 存稿 ≥10 万字；日更承诺可执行（含请假预案）
+- [ ] 早期长线有一次大兑现闭环的规划（章节位置可调整）
+- [ ] 存稿和日更承诺可持续，并已核对当前合同/后台（不套用固定数字）
 - [ ] 文笔三词（风格统一/流畅/细节力度）逐章自查过
 - [ ] 合同衍生授权与独家条款已看清
+- [ ] 后台数据只用于分段诊断，未把单次波动写成算法权重或签约结论

package/app/core/skillpacks/qimao-signing.md

@@ -1,61 +1,69 @@
 # 七猫签约标准与写作规范（内置经验包）
 
-来源：七猫作家交流区专栏《拒稿到签约：过稿经验分享》（26 篇，含女频编辑满星官方拒稿模板拆解）
-+ 签约作者（玄弈、竹简听雪、安澜瀧王、苝薇等）方法论。完整原文见
+来源：七猫作家交流区专栏《拒稿到签约：过稿经验分享》（26 篇，含女频编辑满星官方拒稿模板拆解及作者方法论）；
+可复查入口：[bbs.qimao.com/column/6859f2539995c](https://bbs.qimao.com/column/6859f2539995c)（经验帖，不等同当前政策）。
+签约作者（玄弈、竹简听雪、安澜瀧王、苝薇等）方法论。完整原文见
 `C:\Users\HP\.zcode\skills\qimao-signing-guide\SKILL.md`（含《不周山守村人》两次拒稿复盘）。
 
 > 这是写作参考与自检清单，不是平台官方规则或过签预测；按当前频道与后台要求核实。
 
-## 〇、平台底层逻辑（先懂平台再动笔）
-- 七猫 = **免费阅读**平台：收入靠广告分成 + 保底，读者要"即时爽"，不是付费站的"大悬念勾追读"。
-- 调性叫**"无线风"**：节奏比起点快、情绪比新媒体文稳、全程围绕爽。错配文扫开头 300 字就被 pass。
-- 主收题材——女频：总裁、宅斗、种田、年代、玄幻；男频：都市、玄幻、历史、系统文。
-- 核心公式：**网文本质是提供情绪价值（爽/虐/共情），以期待感为导向**。过稿 = 抓住主流读者情绪，
-  让读者代入、爽、乃至共情。
-- 工作观："你不是在写一本书，而是在经营一个产品。""方向>努力，结构>文笔，情绪>逻辑。"
-
-## 一、黄金一章（一章定生死）
-老编辑看第一章就能定过不过——**黄金三章已进化为黄金一章**：一章内展现以前三章的信息量。
-- **前 100 字**：主角登场，读者知道故事围绕谁。
-- **前 200 字**：已出现值得关心的异常、欲望或冲突。
-- **前 600 字**：眼前困境具体（退婚/背叛/陷害/侮辱/破产/误会/灾难/生死危机），不再铺垫。
-- **前 2000 字**：核心吸引点已实际展示（字数位置本身不证明吸引力）。
-- **第三章前**：主线明确（主角要干什么，像"鸣人要当火影"一样清楚）。
-- 第一章具名人物尽量少（五人可作阅读负担参考）；前三章要有实质局面变化；
+## 证据等级与使用边界（2026-09-30 更新）
+
+- **A级：当前平台事实**：只接受作家助手/合同/官方公告中当前可见的规则；投稿、独家、更新和内容红线必须回到原页面核对，历史材料不能代替政策。
+- **B级：多篇经验或明确拒稿原文**：可作为质量诊断假设，必须同时指出正文位置、读者/编辑反馈和可验证的下一步实验；不能写成“满足即过签”。
+- **C级：单个作者口诀或未给证据的数字**：只保留为待验证问题，不注入硬门禁，不据此推断签约率、推荐权重或收入。
+- 报告按“稿件质量 → 平台适配 → 当前政策”分层。每条结论都写清证据范围、未知项和风险；确定性字数/格式检查只能提示复查，不能替代文学判断。
+
+### 跨平台质量底线
+
+先检查首个故事单元是否有**具体事件、主角主动选择、可见后果、阶段性兑现和新的可追问问题**，再看爽点密度。人物动机、因果连续性、前后设定、文风锚、手机阅读段落和内容安全是独立维度；任何一项未读、未测或仅凭摘要得出，都标为“未证实”。
+
+## 〇、平台定位（经验假设，先核对当前频道）
+- 七猫的免费阅读、广告/保底和即时反馈，是选题与节奏的**定位假设**；不同频道、时期和合同可能不同，不能从定位直接推出收入或签约结果。
+- “无线风”、热门题材带和“开头很快给到情绪价值”来自历史经验帖，适合拿来设计对照实验；榜单与后台数据优先于口诀。
+- 核心问题不是套公式，而是：读者是否迅速知道主角、处境、目标和下一步；本章的承诺是否在正文兑现。
+- 工作观可保留为复盘提示：“方向、结构、情绪”分别写成可验证的事件、选择、后果，不把口号当质量结论。
+
+## 一、黄金一章（历史经验观察点，不是“一章定生死”）
+资料建议把第一章作为高信息密度取样点；以下位置是阅读负担观察参考，不代表编辑统一标准。逐项记录证据，未满足不等于质量不合格。
+- **前 100 字**：观察主角何时登场，读者是否知道故事围绕谁展开。
+- **前 200 字**：观察是否已有值得关心的异常、欲望或冲突。
+- **前 600 字**：观察眼前困境是否具体（退婚/背叛/陷害/侮辱/破产/误会/灾难/生死危机），而非只铺垫。
+- **前 2000 字**：观察核心吸引点是否实际展示（字数位置本身不证明吸引力）。
+- **第三章前**：观察主线是否明确（主角要干什么，像“鸣人要当火影”一样清楚）。
+- 第一章具名人物尽量少（五人只是阅读负担参考，不是硬门槛）；前三章要有实质局面变化；
   反转必须由前文条件引发，不为口诀机械加死亡/背叛。
-- 标准开篇节奏：**第一章立冲突+结尾小钩子 → 第二章亮金手指+明确短期目标 → 第三章第一次爽点/打脸**。
-- 三幕式开头：开端（置于巨大危机）→ 发展（金钥匙出现，开始反杀）→ 反转（幕后推手/新一轮追杀/新功能/好友捅刀）。
-- **开篇禁忌**：不堆设定、不铺世界观、不大段环境描写、不集中抛人物关系；不写无用剧情；
-  不玩倒叙花样；配角戏份不得压过主角。
-- 用对话开场最有效（悬念式/劲爆式/仇恨式）；行文"短平快"，写小说不是说明文。
+- 可复用的一种开篇节奏：**第一章建立冲突并留后续问题 → 第二章让核心能力/设定影响行动 → 第三章完成第一次阶段性兑现**；具体次序服务于本稿题材与因果。
+- 三幕式可以作为结构草图：开端（危机/目标）→发展（行动/代价）→转折（新信息/选择），不要求每稿套“金手指/背叛”等桥段。
+- 历史经验帖常提醒检查设定、世界观、环境和人物关系是否挤占事件；倒叙、群像或配角戏份本身不是禁写项，重点是读者能否跟住主线。
+- 部分经验帖推荐用对话开场（悬念式/劲爆式/仇恨式）；可检查开场是否尽快进入人物行动，不能据此规定所有题材都用对话。
 
 ## 二、爽点、期待感与钩子
-- **每章至少 1 个爽点或情绪爆点**，过渡章也要有小冲突小爽点；**三章一小爆，十章一大爆**。
-- 爽点要及时：忌主角第一章 1 级第十章还是 1 级。最简公式：**定个目标 → 完成它**。
-- 爽点 = 欲扬先抑：**"不是主角因为要被欺负而被欺负，而是主角为了爆发而被欺负。"**
-  打压必须有明确动机；打脸爽不爽取决于**反派心理变化**的描写。
-- **期待感三源**（掌握一种就够用）：① 信息差（读者知道、主角/对手不知道）；
+- 建议复查每章是否有可感知的变化、情绪或兑现；“三章一小爆，十章一大爆”是作者口诀，不能替代逐章判断。
+- 部分作者强调及时兑现：可检查目标是否持续推进、阶段结果是否可见，不以等级或固定章节位置判断有效性；"定个目标 → 完成它"可作构思起点。
+- 欲扬先抑是可选结构：打压应有情境动机，反击应有铺垫；反派心理变化可作为效果观察点，不要求每个故事都用打脸。
+- **三类期待构造方式**（构思工具，不是充分条件）：① 信息差（读者知道、主角/对手不知道）；
   ② 目标预告（"三年之约"式，读者等着看那一幕）；③ 悬念伏笔（小伏笔=断章钩子；大伏笔有伏必应）。
-- **每章结尾必留钩子**：断章、说话说一半、章尾挖坑、反转预告。免费站**章尾小爽点比大悬念更管用**。
-- 前期不断挖坑：神秘人暗中观察、有人准备下套、看似好人实则利用。
+- 建议复查章末是否留下可兑现的下一步问题：断章、说话说一半、挖坑或反转预告均可；“章尾小爽点更管用”只是部分作者经验，需结合读者反馈验证。
+- 伏笔不以数量取胜：记录前文铺设、当前承诺和后续回收；神秘人、陷阱或关系反转只有在符合因果并服务本稿时才加入。
 
 ## 三、主线与节奏
 - 一句话主线 + 主角目标细化；目标不细化 = 过程流水账。
-- **与当前重点无关的一律不写**；每章自问："这章结束，剧情有没有往前挪一步？"没有就删改。
-- 书的循环本质："起承转合无限循环，一波未平一波又起，**主角永远处于麻烦之中**。"
-- 小剧情单元：目标→行动→阻碍→反转；大剧情链：起因→发展→转折→高潮→结局。
+- 复查段落是否推动目标、关系、信息或情绪；若没有可辨认的作用，再考虑删改。休整章节也应有清楚的阅读功能。
+- 一种连载经验强调持续制造新局面；可用"起因→行动→阻碍→转折→结果"检查因果，但不要求主角永远处于危机。
+- 小剧情单元可用目标→行动→阻碍→结果检查；大剧情链可用起因→发展→转折→高潮→结局规划。
 - 同一件事不重复叙述；背景设定拆散夹在剧情里带出。
 - 分清剧情流/感情流，笔墨按类型分配。
 
-## 四、人物（红线）
-- **主角主观能动性是红线**：必须主动触发、推动剧情；全程被推着走 = 拒稿级致命伤。
-- 男频毒点：优柔寡断、不杀伐；不能当舔狗（舔必须有原因有好处且写出暗爽）。
-- **反派要有心机有手段，不能无脑**；配角要有动机。
+## 四、人物（经验复查维度）
+- 多篇拒稿复盘关注主角是否作出选择并推动事件；检查“目标 → 行动 → 后果”，但不把单一人物类型写成通用过稿红线。
+- 部分男频经验偏好果断与强反馈；是否适用取决于题材/人设，避免把复杂人物统一改成“杀伐果断”模板。
+- 对手和配角应有可理解的动机与行动；他们不必都强势或聪明，关键是冲突因果成立。
 - 人设四要素：基础设定、个性化标签（口头禅/小习惯）、反差萌、人物弧光。
 - **人设不崩是底线**；人设变化需要铺垫。
 
 ## 五、视角与文笔
-- **故事必须从主角视角展开**；上帝视角 = 读者找不到重点。
+- 开篇视角应让读者容易定位人物、信息来源和情绪距离；第三人称全知等视角不是禁项，需看执行是否清楚。
   例：×"昏暗的房间里，一个男人把南笙按在沙发上" → √"好痒……南笙迷迷糊糊苏醒，感觉腿上一阵瘙痒，
   随后一只粗糙的大手便摸上了她的大腿"。
 - 开篇即入主角视角，不用旁白自我介绍；读者未对主角产生好感前，不铺大篇幅受伤/惨状。
@@ -64,7 +72,7 @@
 - 段落短，适配手机阅读；少错别字病句。
 
 ### 编辑高频驳回话术拆解（实测复盘，动笔/改稿时逐条对照）
-以下三条是免费站签约评估最常见的"文笔类"驳回理由，本质都指向可自查的问题：
+以下三条是所汇编材料中反复出现的"文笔类"反馈，可转成自查问题；不代表所有频道或拒稿的完整原因：
 
 - **"风格不够统一"**：叙述语域/句式长短/人称距离在一章内忽高忽低（半文半白 + 网络梗 + 书面长句混用），
   或切场景/切视角时文风跟着变。**修法**：全篇定一个文风锚（如"短句 + 白描 + 口语但不过火"），
@@ -75,7 +83,7 @@
 - **"细节刻画力度稍弱"**：核心冲突/情绪爆点被一句话带过（该"放慢给特写"的地方按了快进），
   打压—反击缺生理与环境反应，爽点"打不满"。**修法**：每个爽点/反转标记为"特写镜头"，
   用五感 + 微动作 + 环境反馈把这几秒写"厚"（心跳、指节、周围人的呼吸与目光），
-  铺垫在前、放大在中、余波在后；过渡章才可一笔带过。**三章一小爆的"小爆"必须配特写，否则等于没爆。**
+  铺垫在前、放大在中、余波在后；场景篇幅按叙事重要性调整，不把"特写"固定套给每个爽点。
 
 ## 六、题材、书名、简介
 - 题材 = 个人兴趣 × 市场需求的最大公约数；风格要匹配题材。
@@ -83,23 +91,26 @@
 - 书名带情绪、有看点、有关键词；忌文艺含蓄无信息量。
 - 简介三要素：背景（身份+处境）+ 冲突（核心矛盾+情绪爆发）+ 悬念（埋钩子）。
 
-## 七、投稿与签约（流程约束）
-- 直发（推荐新人）：**满 2 万字申请签约评估**，满 3 万字可发布上架；3-5 个工作日出结果。
-- 一稿一投，不海投；超 7 天未果主动跟进一次；三个编辑都拒 = 写新稿。
-- 签约模式：纯分成 / 保底+超保底分成 / 超级纯分成。
-- 红线：涉政涉军涉敏低俗、抄袭洗稿、双男主双女主、非独家（外站内容必须全部下架）。
-
-## 八、签约自检清单（写完逐项过）
-**开篇（第一章）**
-- [ ] 前 100 字主角登场　[ ] 前 200 字出现冲突　[ ] 前 600 字冲突明确
-- [ ] 前 2000 字有大悬念或核心矛盾　[ ] 第一章具名人物 ≤ 5
-- [ ] 无世界观/环境/背景堆砌　[ ] 主角视角、无上帝视角旁白
-- [ ] 开场用冲突/悬念/对话　[ ] 章末有钩子
-**前三章**
-- [ ] 第二章亮金手指 + 短期目标明确　[ ] 第三章完成第一次打脸/爽点
-- [ ] 三章内有反转　[ ] 主线清晰（目标/障碍/要做什么）　[ ] 每章至少 1 个爽点
+## 七、投稿与签约（历史流程，提交前必须回后台核实）
+- 经验材料常见“2 万字/3 万字/3-5 个工作日”等节点，只能作为项目排期提示；当前频道的字数、审核时长和可投稿状态以作家助手页面为准。
+- 一稿一投、跟进节奏和签约模式是作者经验，不是过签条件；拒稿后保留原文、版本、编辑原话和修改范围，再决定重修、重立项或换稿。
+- 红线需按当前公告、合同和频道规则核对：涉政涉军涉敏低俗、抄袭洗稿、版权/独家义务等不能靠内部自检替代平台判断。
+
+## 八、投稿前质量与证据清单（逐项过；非签约保证）
+先给每个结论标注“当前规则 / 多源经验 / 待验证”，并记录实际读过的章节范围；没有证据的项目不标“通过”。
+
+**开篇（第一章；字数位置仅作观察点）**
+- [ ] 观察主角是否尽早登场、读者能否辨认主角　[ ] 观察异常/欲望/冲突何时出现
+- [ ] 观察困境是否具体、核心吸引点是否兑现　[ ] 复查具名人物是否过密（“五人”仅为阅读负担参考）
+- [ ] 复查设定/环境/背景是否挤占事件　[ ] 主角视角是否清楚、旁白距离是否符合本稿选择
+- [ ] 开场与题材承诺是否匹配　[ ] 章末是否有可兑现的后续问题
+**前三章（随题材调整，不强制套章纲）**
+- [ ] 核心设定或能力是否改变人物行动　[ ] 是否完成一个有因果的阶段性兑现
+- [ ] 是否有局面变化　[ ] 主线目标/障碍/下一步是否可复述
 **全书通用**
-- [ ] 主角主动推动剧情　[ ] 本章剧情比上章往前挪一步
-- [ ] 打压有动机、反击有铺垫　[ ] 反派有脑子有心理变化
-- [ ] 人设未崩、主角果断　[ ] 无重复叙述、无与主线无关描写
-- [ ] 细节用动作/神态替代直白情绪词　[ ] 段落短，适配手机阅读
+- [ ] 主角是否作出改变局面的选择　[ ] 本章事件是否推进目标或关系
+- [ ] 打压/阻碍有动机、反击/解决有铺垫　[ ] 对手与配角有各自目标
+- [ ] 人物变化有铺垫　[ ] 重复信息和与主线无关内容是否影响阅读
+- [ ] 情绪表达是否具体且适合本稿文风　[ ] 段落长度是否适配目标阅读场景
+- [ ] 每个故事单元都能指出事件、选择、后果、兑现和后续问题
+- [ ] 文风锚、因果链、连续性和内容安全分别复核，未把字数/格式当文学评分