@oh-story/dsh 0.1.14 → 0.1.16

package/lib/oh-story/skills/story-long-write/scripts/author_memory_commit.py

@@ -34,21 +34,22 @@ PENDING_MAX_BYTES = 12288
 JOURNAL_MAX_BYTES = 24576
 QUERY_MAX_BYTES = 2048
 ASSERTION_MAX_BYTES = 120  # 新建条目的断言限一句话；解释进 reason（不进 query 载荷）。
-OMITTED_IDS_MAX = 20  # omitted_ids 封顶，omitted 保留真实总数——漏项列表不许把载荷本身挤炸。
 LEGACY_ASSERTION_MAX_BYTES = 768  # 存量条目的读取上限；强化老条目不受新上限约束。
 
-# query 的输出是要原样贴进执行 agent prompt 的注入载荷，QUERY_MAX_BYTES
-# 是它在 prompt 里的注意力预算，不该放大。防「作者以为载入了、实际被静默
-# 截断挤掉」靠三层：①新建条目的断言限 ASSERTION_MAX_BYTES，从源头短（强化
-# 已有条目不受限，否则存量长断言再也无法被确认，只会派生重复条目）；②写入
-# 端按下列任务组合（与 references/author-memory-maintenance.md 的映射表同包跟版）估算
-# 最坏查询情形——全局条目＋各 scope 维度上最重的单一切片（一次查询只带一
-# 个 book/genre/workflow，不同书的条目不会同现；切片按 casefold 归并，与
-# same_scope_value 同一口径，轻重按 compact 字节＋列表分隔符算，与真实载荷
-# 同一把尺），装不下时在返回的 warnings 里点名将被略过的条目、指向「整理作
-# 者记忆」，写入本身永不因注入预算失败；③查询按 重要度→本书例外→最近更新
-# 排序装填，被略过的恒是重要度较低的条目，漏下的 ID 按同一优先级顺序报进
-# omitted_ids。
+# query 输出里的 lines（每条一行「- 断言（编号）」）是交给执行 agent 的注入
+# 载荷，QUERY_MAX_BYTES 是它在 prompt 里的注意力预算，不该放大；量的是执行者
+# 真正读到的这几行，不是 JSON 外壳（编号、kind、scope 只给主会话和脚本看）。
+# 防「作者以为载入了、实际被静默挤掉」靠三层：①新建条目的断言限
+# ASSERTION_MAX_BYTES，从源头短（强化已有条目不受限，否则存量长断言再也无法
+# 被确认，只会派生重复条目）；②写入端按下列任务组合（与
+# references/author-memory-maintenance.md 的映射表同包跟版）估算最坏查询情形——
+# 全局条目＋各 scope 维度上最重的单一切片（一次查询只带一个 book/genre/workflow，
+# 不同书的条目不会同现；切片按 casefold 归并，与 same_scope_value 同一口径，
+# 轻重按渲染后的行字节算，与真实载荷同一把尺），装不下时在返回的 warnings 里
+# 点名将被略过的条目、指向「整理作者记忆」，写入本身永不因注入预算失败；
+# ③查询按 重要度→本书例外→最近更新 排序装填，被略过的恒是重要度较低的条目，
+# 漏下的 ID 按同一优先级全数报进 omitted_ids，首句报进 omitted_summaries，
+# 供主会话用原话告诉作者哪几条没带上。
 QUERY_COMBOS: dict[str, tuple[str, ...]] = {
     "正文初稿/续写": ("prose_style", "story_design"),
     "去AI味/改写": ("prose_style",),
@@ -1086,12 +1087,19 @@ def summarize_assertion(assertion: str, *, limit: int = 14) -> str:
 
 
 def compact_item(item: dict[str, Any]) -> dict[str, Any]:
-    """query 载荷只带这四个字段——估算与真实输出必须同一把尺。"""
+    """query 的 items 只带这四个字段，给主会话和脚本按 kind/scope 判断用；
+    reason、evidence 等一律不出 store。"""
     return {"id": item["id"], "kind": item["kind"], "scope": item["scope"], "assertion": item["assertion"]}
 
 
-def compact_bytes(item: dict[str, Any]) -> int:
-    return len(json.dumps(compact_item(item), ensure_ascii=False).encode("utf-8"))
+def render_line(item: dict[str, Any]) -> str:
+    """执行者读到的一行：断言原文＋编号。注入预算量的就是这几行。"""
+    return f"- {item['assertion']}（{item['id']}）"
+
+
+def line_bytes(item: dict[str, Any]) -> int:
+    """一行在注入载荷里的占位，含行尾换行——估算与真实装填只用这一把尺。"""
+    return len((render_line(item) + "\n").encode("utf-8"))
 
 
 SCOPE_RANK = {"book": 0, "genre": 1, "workflow": 2, "global": 3}
@@ -1121,48 +1129,38 @@ def fit_items(
     *,
     extra: dict[str, Any] | None = None,
 ) -> tuple[dict[str, Any], list[str]]:
-    """按 query 输出信封把条目装进 QUERY_MAX_BYTES：装不下的跳过而不中断
-    （一条长的不挡后面的短条），漏下的 ID 报进 omitted_ids（封顶
-    OMITTED_IDS_MAX 条，omitted 保留真实总数）。返回 (结果文档, 全部漏下 ID)。
+    """按渲染后的行把条目装进 QUERY_MAX_BYTES：装不下的跳过而不中断（一条长的
+    不挡后面的短条）。返回 (结果文档, 全部漏下 ID)。
 
-    漏项恒按候选优先级排序，不按被丢弃的先后：收尾回吐的条目优先级高于循环
-    里跳过的，若按追加顺序排，omitted_ids 的封顶正好会把最该报的那条切掉。
-    `extra` 是同样计入信封的附加字段（book_revision 等）。
+    只有 lines 计入预算；items、漏项清单和 `extra`（book_revision 等）是给主会话
+    和脚本看的，不进执行者 prompt，所以漏项全数列出、不封顶，并按候选优先级
+    排序——排在前面的就是作者最该知道没带上的那几条。
     """
+    kept: list[dict[str, Any]] = []
+    dropped: list[dict[str, Any]] = []
+    used = 0
+    for item in sorted_items:
+        size = line_bytes(item)
+        if used + size > QUERY_MAX_BYTES:
+            dropped.append(item)
+            continue
+        kept.append(item)
+        used += size
     result: dict[str, Any] = {
         "ok": True,
         "command": "query",
         "initialized": True,
         "revision": revision,
-        "items": [],
-        "omitted": 0,
-        "omitted_ids": [],
+        "items": [compact_item(item) for item in kept],
+        "lines": [render_line(item) for item in kept],
+        "omitted": len(dropped),
+        "omitted_ids": [item["id"] for item in dropped],
+        "omitted_summaries": {item["id"]: summarize_assertion(item["assertion"]) for item in dropped},
+        # 组装脚本按题材×流程查好几次再合并，合并后只能按重要度重排漏项，所以把它带出来。
+        "omitted_importance": {item["id"]: item["importance"] for item in dropped},
     }
     result.update(extra or {})
-    order = {item["id"]: index for index, item in enumerate(sorted_items)}
-    kept: list[dict[str, Any]] = []
-    dropped: set[str] = set()
-
-    def ordered_omitted() -> list[str]:
-        return sorted(dropped, key=order.__getitem__)
-
-    def envelope_bytes() -> int:
-        omitted = ordered_omitted()
-        result["items"] = [compact_item(item) for item in kept]
-        result["omitted"] = len(omitted)
-        result["omitted_ids"] = omitted[:OMITTED_IDS_MAX]
-        return len((json.dumps(result, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8"))
-
-    for item in sorted_items:
-        kept.append(item)
-        if envelope_bytes() > QUERY_MAX_BYTES:
-            kept.pop()
-            dropped.add(item["id"])
-    # omitted 计数落定后包可能恰好贴边超出一两个字节，回吐条目直到装下。
-    while kept and envelope_bytes() > QUERY_MAX_BYTES:
-        dropped.add(kept.pop()["id"])
-    envelope_bytes()
-    return result, ordered_omitted()
+    return result, result["omitted_ids"]
 
 
 def build_query_result(
@@ -1170,8 +1168,8 @@ def build_query_result(
     project_state: dict[str, Any] | None,
     book_state: dict[str, Any] | None,
 ) -> tuple[dict[str, Any], list[str]]:
-    """真实查询与写入端估算共用的唯一信封构造：候选已按优先级排好，这里补上
-    book_revision 等附加字段再装填。两处信封差一个字段就是一次假阴性——回执
+    """真实查询与写入端估算共用的唯一装填入口：候选已按优先级排好，这里补上
+    book_revision 等附加字段再装填。两处装填口径一旦分叉就是假阴性——回执
     说没事、query 照样丢条。"""
     extra: dict[str, Any] = {}
     if book_state is not None:
@@ -1208,12 +1206,13 @@ def merged_query(
 
 
 def slice_weight(items: list[dict[str, Any]]) -> int:
-    """切片在真实载荷里的占位：compact 字节＋每条在 JSON 数组里的分隔符。
+    """切片在真实载荷里的占位：按渲染后的行（含换行）计。
 
-    只比 compact 字节会挑错切片——条目多、单条短的切片字节和更小，实际占位
-    却更大，于是估算判「装得下」而真实查询溢出（warnings 假阴性）。
+    必须与 fit_items 同一把尺。按 JSON 字节挑会挑错切片——scope 取值长、断言
+    短的切片 JSON 更重，渲染出的行却更轻，于是估算判「装得下」而真实查询溢出
+    （warnings 假阴性）。
     """
-    return sum(compact_bytes(item) + 2 for item in items)
+    return sum(line_bytes(item) for item in items)
 
 
 def active_of_kinds(state: dict[str, Any] | None, kinds: tuple[str, ...]) -> list[dict[str, Any]]:
@@ -1419,16 +1418,20 @@ def command_query(
     project_state = load_state(project_store(workspace))
     book_state = load_state(book_store(workspace, book_root, book)) if book_root is not None else None
     if project_state is None and book_state is None:
-        return {"ok": True, "command": "query", "initialized": False, "revision": 0, "items": [], "omitted": 0, "omitted_ids": []}
+        return {"ok": True, "command": "query", "initialized": False, "revision": 0, "items": [], "lines": [],
+                "omitted": 0, "omitted_ids": [], "omitted_summaries": {}, "omitted_importance": {}}
     requested_scopes = {
         "genre": optional_text(genre, "query.genre", max_bytes=180),
         "workflow": optional_text(workflow, "query.workflow", max_bytes=180),
     }
     # 装不下的**跳过而不中断**（一条长的不挡后面的短条），漏下的 ID 报进
     # omitted_ids：非空＝记忆超编该整理了，不是「没有更多了」。写入端的
-    # warnings 与这里共用 build_query_result 同一个信封，估算即实况。
+    # warnings 与这里共用 build_query_result 同一把尺，估算即实况。
     result, _ = merged_query(project_state, book_state, set(kinds), requested_scopes)
-    require(len((json.dumps(result, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8")) <= QUERY_MAX_BYTES, "query result exceeds its fixed byte budget")
+    require(
+        sum(len((line + "\n").encode("utf-8")) for line in result["lines"]) <= QUERY_MAX_BYTES,
+        "query lines exceed their fixed byte budget",
+    )
     return result
 
 

package/lib/oh-story/skills/story-long-write/scripts/build_writer_prompt.py

@@ -15,7 +15,8 @@
 职责边界:
 - 脚本做确定性部分：固定首行、定位、标题行字面量、细纲指针、文风全文路径与裁决、
   上一章结尾、降档判定与情绪/节奏槽、固定块指针。
-- 脚本代查作者记忆（prose_style + story_design）并填好 author_preferences。
+- 脚本代查作者记忆（prose_style + story_design）并填好 author_preferences；装不下的条目在核对报告里
+  点名，并拼好章末对作者说的那句原话。
 - 脚本注入 `设定/题材定位.md`「作者已定」（本书的偏好、红线与否掉的方案），超过 AUTHOR_DECIDED_CHARS
   可见字截断并注明去原文看；它是书级设定，优先于作者记忆。
 - 主会话填九个固定槽：执行安排 / 本章意图 / 作者本轮要求 / 本章技法 / 本节速记 / 涉及角色 /
@@ -147,6 +148,8 @@ def previous_chapter_tail(project: Path, chapter: int):
 
 
 MEMORY_KINDS = ("prose_style", "story_design")
+IMPORTANCE_RANK = {"low": 1, "medium": 2, "high": 3}
+MISSED_SHOWN = 8  # 给作者的那句话最多点名几条，其余用「等」带过；完整清单走「整理作者记忆」
 # 限定「流程」的作者记忆里，这些取值指的就是长篇写正文。
 LONG_WRITE_WORKFLOWS = {"长篇", "长篇写作", "写长篇", "长篇连载", "长篇网文", "长篇正文", "story-long-write"}
 
@@ -170,6 +173,51 @@ def scoped_memory_values(workspace: Path):
     return values
 
 
+WORKSPACE_MARKERS = (".active-book", "长篇", "短篇", "拆文库")
+
+
+def memory_state_kind(directory: Path):
+    """目录下 `.story/作者记忆/` 那份 state 是哪一级：不带 book 字段为 "project"，带书名为 "book"，
+    没有或读不出为 None（与 author_memory_commit.py 的 peek_book_name 同一判据）。"""
+    text = read_text(directory / ".story" / "作者记忆" / "_author-memory-state.json")
+    try:
+        document = json.loads(text) if text else None
+    except ValueError:
+        return None
+    if not isinstance(document, dict):
+        return None
+    book = document.get("book")
+    return "book" if isinstance(book, str) and book.strip() else "project"
+
+
+def find_workspace(project: Path):
+    """写章代查作者记忆用的创作工作区，按 author-memory.md「存放与路由」认，返回 (目录, 是否认出)。
+
+    依次认：书目录或祖先里的 `.story-deployed`（已部署的宿主）；书目录上一层叫 长篇／短篇 时取再上一层；
+    书目录自己就有项目级作者记忆或 `书级/`（单书布局）；最近一个带 `.active-book`、`长篇/`、`短篇/`、`拆文库/`
+    或项目级作者记忆的祖先（到用户主目录为止，主目录本身不算）。都没有时把书目录当工作区，但这是猜的：
+    DSH 等宿主不写 `.story-deployed`，多书工作区里的书若被当成工作区，查询会报错或把书级记忆挪位。
+    """
+    project = project.resolve()
+    deployed = next((d for d in (project, *project.parents) if (d / ".story-deployed").is_file()), None)
+    if deployed is not None:
+        return deployed, True
+    if project.parent.name in {"长篇", "短篇"}:
+        return project.parent.parent, True
+    if memory_state_kind(project) == "project" or (project / ".story" / "作者记忆" / "书级").is_dir():
+        return project, True
+    try:
+        home = Path.home().resolve()
+    except (RuntimeError, KeyError):  # 拿不到主目录时一路找到根
+        home = None
+    for ancestor in project.parents:
+        if ancestor == home:
+            break
+        if any((ancestor / marker).exists() for marker in WORKSPACE_MARKERS) or memory_state_kind(ancestor) == "project":
+            return ancestor, True
+    return project, False
+
+
 def genre_line(project: Path):
     """「题材类型」行的原文；未填的模板占位（{…}）当没有。"""
     text = read_text(project / "设定" / "题材定位.md") or ""
@@ -232,24 +280,30 @@ def author_decided(project: Path):
 
 
 def query_author_memory(project: Path):
-    """代主会话做写正文那一次作者记忆查询（prose_style + story_design，每次 ≤2KB）。
+    """代主会话做写正文那一次作者记忆查询（prose_style + story_design）。
 
-    工作区取书目录及其祖先里第一个带 `.story-deployed` 的目录；找不到就把书目录当工作区。
+    注入块原样用 query 给的 lines 拼——每次查询的 lines ≤2KB，预算量的就是写手读到的这几行，
+    这里不另行排版。工作区按 find_workspace 认；认不出、而书目录里又是一份带书名的记忆时不代查——
+    那既可能是单书布局的旧版记忆，也可能是没有任何迹象的多书工作区里的一本书，拿书目录当工作区去查，
+    后一种会被当成前一种「归位」，此后正确的查询全部报错。
     限定题材的条目只在取值出现在本书「题材类型」里时代查，限定流程的只认长篇写作的取值；
     其余限定条目不猜，报给主会话自己判断。
-    返回 (条目列表, 超编 ID 列表, 未代查的限定取值, 错误)；错误时由主会话按 author-memory.md 手动查询。
+    返回 (注入行, 没带上的 [(ID, 断言首句)], 未代查的限定取值, 错误)；错误时由主会话按 author-memory.md 手动查询。
     """
-    workspace = next((d for d in (project, *project.parents) if (d / ".story-deployed").is_file()), project)
+    workspace, recognised = find_workspace(project)
     script = Path(__file__).with_name("author_memory_commit.py")
     if not script.is_file():
         return None, [], {}, "author_memory_commit.py 缺失"
+    if not recognised and memory_state_kind(project) == "book":
+        return None, [], {}, ("认不出创作工作区（书目录及祖先都没有 .active-book、长篇/、短篇/、拆文库/ 或项目级作者记忆），"
+                              "书目录里却是本书的记忆；先按 author-memory.md「存放与路由」定好 --workspace")
     scoped = scoped_memory_values(workspace)
     book = book_genres(project)
     genres = sorted(v for v in scoped["genre"] if v.casefold() in book) or [None]
     workflows = sorted(v for v in scoped["workflow"] if v.casefold() in {w.casefold() for w in LONG_WRITE_WORKFLOWS})
     skipped = {"genre": sorted(v for v in scoped["genre"] if v not in genres),
                "workflow": sorted(v for v in scoped["workflow"] if v not in workflows)}
-    items, omitted, seen = [], [], set()
+    lines, omitted, summaries, importance, seen = [], [], {}, {}, set()
     for genre in genres:
         for workflow in workflows or [None]:
             command = [sys.executable, str(script), "query", "--workspace", str(workspace), "--book-root", str(project)]
@@ -266,13 +320,22 @@ def query_author_memory(project: Path):
                 result = {}
             if not result.get("ok"):
                 return None, [], {}, result.get("error") or completed.stderr.strip() or "query 失败"
-            for item in result.get("items") or []:
+            items, rendered = result.get("items") or [], result.get("lines") or []
+            if len(items) != len(rendered):
+                return None, [], {}, "query 输出缺 lines（作者记忆脚本与组装脚本版本不一致）"
+            for item, line in zip(items, rendered):
                 if item.get("id") not in seen:
                     seen.add(item.get("id"))
-                    items.append(item)
-            omitted += [i for i in result.get("omitted_ids") or [] if i not in omitted and i not in seen]
-    omitted = [i for i in omitted if i not in seen]
-    return items, omitted, {k: v for k, v in skipped.items() if v}, None
+                    lines.append(line)
+            omitted += [i for i in result.get("omitted_ids") or [] if i not in omitted]
+            summaries.update(result.get("omitted_summaries") or {})
+            importance.update(result.get("omitted_importance") or {})
+    # 每次查询的漏项各自按优先级排好，合并后按重要度重排（同重要度保持先后），
+    # 给作者点名的前几条才是最该知道的；某次漏、另一次带上了的不算没带上。
+    ranked = sorted((i for i in omitted if i not in seen),
+                    key=lambda i: (-IMPORTANCE_RANK.get(importance.get(i), 0), omitted.index(i)))
+    missed = [(i, summaries.get(i, "")) for i in ranked]
+    return lines, missed, {k: v for k, v in skipped.items() if v}, None
 
 
 def learn_heading_form(project: Path, chapter: int, title: str):
@@ -503,23 +566,27 @@ def build(project: Path, chapter: int, report: list):
         report.append("作者已定：已注入" + ("（超长截断，写手需回原文读完）" if cut else ""))
     else:
         report.append("作者已定：题材定位里没有或为空，未注入")
-    items, omitted, skipped, memory_error = query_author_memory(project)
+    lines, missed, skipped, memory_error = query_author_memory(project)
     if memory_error:
         memory_block = (f"{SLOT_MARK} 组装脚本查询作者记忆失败（{memory_error}），"
                         "按 author-memory.md 手动 query prose_style + story_design 后填入；无则写「无」")
-        report.append(f"作者记忆：脚本查询失败——{memory_error}，归主会话手动查询")
-    elif items:
-        memory_block = "\n".join(f"- {item.get('assertion', '').strip()}（{item.get('id', '')}）" for item in items)
-        report.append(f"作者记忆：已注入 {len(items)} 条" + (
-            f"；超编未装下 {len(omitted)} 条（{'、'.join(omitted)}），转告作者建议「整理作者记忆」" if omitted else ""))
+        report.append(f"作者记忆：脚本查询失败——{memory_error}，归主会话手动查询；手查有没带上的（任一次查询带上了的不算），章末照模板那一行用原话说")
     else:
-        memory_block = "无"
-        report.append("作者记忆：无相关 active 条目")
+        memory_block = "\n".join(lines) if lines else "无"
+        report.append(f"作者记忆：已注入 {len(lines)} 条" if lines or missed else "作者记忆：无相关 active 条目")
+    if missed:
+        # 装不下的不能悄悄略过：拼好给作者的原话，章末汇报照模板那一行原样说。
+        shown = "".join(f"「{summary or item_id}」" for item_id, summary in missed[:MISSED_SHOWN])
+        more = "等" if len(missed) > MISSED_SHOWN else ""
+        report.append(
+            f"作者记忆：装不下、这章没带上 {len(missed)} 条（{'、'.join(i for i, _ in missed)}），章末汇报原样说这句——"
+            f"你记下的写作习惯这章有 {len(missed)} 条没带上：{shown}{more}；"
+            "说「整理作者记忆」可以合并相近的、调低不常用的。")
     if skipped and not memory_error:
         named = "；".join(f"{'题材' if k == 'genre' else '流程'}：{'、'.join(v)}" for k, v in skipped.items())
         memory_block += (f"\n{SLOT_MARK} 另有限定范围的作者记忆未代查（{named}）：本书适用的，"
                          "带 --genre／--workflow 跑 SKILL.md「核心方法」的 query 命令（--kind prose_style --kind story_design）后补进本块")
-        report.append(f"作者记忆：限定范围未代查（{named}），归主会话判断是否适用")
+        report.append(f"作者记忆：限定范围未代查（{named}），归主会话判断是否适用；补查有没带上的（已在本块里的不算），章末照模板那一行用原话说")
     parts.append("——— author_preferences（作者记忆，低优先级倾向，不逐条追求命中）———\n" + memory_block)
     parts.append("——— style_resolution ———\n"
                  f"{SLOT_MARK} 本轮请求里作者对表达的明确要求及其覆盖的默认条款（没有写「无」）；"

package/lib/oh-story/skills/story-review/SKILL.md

@@ -6,19 +6,17 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 ---
 # story-review：多视角对抗式审查
 
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时在「这次怎么审的」里用一句白话提示作者「审稿助手是旧版，运行 /story-setup 后新开会话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 原文写进技术备注行；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，技术备注写 `Fallback: ... -> solo`。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 35` 不一致时（标记缺失、字段缺失/非整数、小于或大于 35）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时在「这次怎么审的」里用一句白话提示作者「审稿助手是旧版，运行 /story-setup 后新开会话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 35）` 原文写进技术备注行；大于 35 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。版本提示本身不触发降级；文件缺失或异常、工具不可用、递归限制或调用失败按 Phase 0 处理，技术备注写 `Fallback: ... -> solo`。
 
-你是审查协调器。你的职责是找出小说文本中的结构、角色、文字、设定问题，并给出可执行修改建议。
+你负责协调审查，找出小说的结构、角色、文字与设定问题，给出有原文依据的修改建议。
 
 **执行铁律：审查是找问题，不是验证正确性。**
 
-**文风裁决**：正文写作、改写或审稿前先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风并形成 `style_resolution`；无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
+**文风裁决**：先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风，复用调用方的 `style_resolution` 与作者偏好；单独调用时按当前请求与本书文风裁决。同一裁决交给后续执行者。
 
-## 作者习惯边界
+## 作者偏好边界
 
-若作者记忆 state 已存在，审查前用 `scripts/author_memory_commit.py query --workspace {工作区} --book-root {书目录} --kind delivery --kind interaction --kind prose_style [--genre {题材}] [--workflow 审稿]` 获取本次相关 active 条目（`--workspace`、`--kind` 必传；不传 `--book-root` 就拿不到本书级偏好；`--genre` 填本书题材类型；总输出 ≤2KB）。它们只能帮助解释意图和组织报告，不能降低 rubric 严重度、把事实冲突判为无问题或跳过平台门禁；当前请求仍优先。完整规则见 [references/author-memory.md](references/author-memory.md)。
-
-用户对报告格式或协作方式作出稳定声明时，在本轮审查完成后用 `record` 记录，并按 author-memory.md「回执怎么告诉作者」转告；只记作者明确说的，一次性要求不记录，不从反复修改推断。审查发现、工具告警和助手建议本身绝不自动学习。
+只接收调用方已有的作者偏好，不查询或记录作者记忆；独立调用时不加载记忆文件。偏好只能帮助解释意图和组织报告，不能降低 rubric 严重度、把事实冲突判为无问题或跳过平台门禁；当前请求仍优先。
 
 ---
 
@@ -27,7 +25,6 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 - `/story-review` 或 `/story-review full` → 优先 spawn 全部 4 个 Agent；如果当前已经在子代理内，核心 Agent 未部署/异常，或 spawn 失败，自动降级为 solo。
 - `/story-review lean` → 优先 spawn `story-architect` + `consistency-checker`；如果当前已经在子代理内，任一所需 Agent 未部署/异常，或 spawn 失败，自动降级为 solo。
 - `/story-review solo` → 不 spawn Agent，由当前会话执行基础审查。
-- 未指定 → 默认 full，并在报告开头用一句话说明这次实际是怎么审的。
 
 ---
 
@@ -54,7 +51,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## 审查基准与参考资料规则（必须遵守）
 
-`story-review` 的核心审查标准必须始终可用。参考文件是增强资料，不是运行前提。
+参考文件补充审查标准；不可读时使用下方内置基准包。
 
 ### 报告面向作者（必须遵守）
 
@@ -83,7 +80,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 |---|---|
 | 通用质量清单 | `story-review/references/review-quality.md` |
 | 通用内容评分 rubric | `story-review/references/quality-rubric.md` |
-| 去 AI 味方法 | `story-review/references/anti-ai-writing.md` |
+| 去 AI 味方法 | `story-review/references/expression.md` · `story-review/references/narrative-focus.md` · `story-review/references/story-logic.md` |
 | 剧情循环/高潮公式 | `story-review/references/plot-core-methods.md` |
 | 角色关系/好感度 | `story-review/references/character-relations.md` |
 | 对话质量 | `story-review/references/dialogue-mastery.md` |
@@ -91,9 +88,6 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | 平台 rubric | `story-review/references/rubrics/{fanqie,qidian,zhihu}.md` |
 | 标点预检脚本 | `story-review/scripts/normalize-punctuation.js` |
 | AI句式预检脚本 | `story-review/scripts/check-ai-patterns.js` |
-| 作者习惯协议 | `story-review/references/author-memory.md` |
-| 作者习惯整理、超编与迁移 | `story-review/references/author-memory-maintenance.md` |
-| 作者习惯事务脚本 | `story-review/scripts/author_memory_commit.py` |
 
 ### 内置审查基准包（路径不可读时必用）
 
@@ -110,21 +104,20 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 - 对话质量：是否有潜台词、信息控制、角色差异；说明书式对话至少 S2。
 - 设定一致性：不违背已写规则、时间线、角色属性；明确事实冲突通常 S1。
 - 文字自然度：具体、可感、动作承载信息；AI 腔、陈词滥调、总结体按影响定 S2/S3。
-- 句长节奏：叙述默认是逗号长句（一句用逗号串起 2-4 件事再落句号）；碎句和电报体（逗号之间连着都是 ≤5 字、通篇超短句像提纲）与 AI 腔同级，按影响定 S3/S2，不因「短=网文节奏」放行。
+- 句长节奏：按本书文风、语义承接与场景功能判断；机械碎句、动作清单或臃肿长句按影响定 S3/S2，不按统一字数或句长模板验收。
 - 标点节奏：标点是否服务语气/人物声线；通篇句号化、随机堆砌问号/感叹号，或残留 `……`/`——` 硬造停顿，按影响定 S3/S2。
 - 具体字数表达校验：正文用“这五个字 / 短短四字 / 三个字一落 / 八个字砸下去”等具体字数表达评价台词、题字、信件、念头或弹幕时，必须能确认统计口径、机器核对结果和叙事必要；不能确保字数计算正确时，按文字自然度问题处理，建议改成“这句话一落”“那几个字”“话音落下”等非具体数字表达。
 - 格式可读性：段落短、对话独立、无多余空行；格式阻碍阅读按 S3，严重混乱按 S2。
 - 剧情循环：目标 → 阻碍 → 行动 → 代价/反馈 → 新期待；缺少目标/阻碍/反馈通常至少 S2。
-- 高潮构建：蓄能 → 假胜 → 崩解 → 反转/兑现；高潮直接平铺、无代价或无兑现通常 S2/S3。
+- 高潮构建：检查蓄能、情绪落差与兑现；强反转可用蓄能 → 假胜 → 崩解 → 反转/兑现，缺铺垫或兑现通常 S2/S3。
 - 关系进展：互动尺度必须匹配当前关系阶段；越界亲密、突然信任、突然敌对都需要铺垫，否则按影响定 S1/S2。
 - 伏笔状态：伏笔状态需可追踪；伏笔密度只作为结构风险提示，除非直接造成理解混乱，否则不升级到 S2+。
 
-AI 味 / 禁用词 fallback 速查：
-- 高频套话：`命运的齿轮开始转动`、`心猛地一沉`、`眼神复杂`、`深刻变化`、`踏上新的旅程`。
-- 章末总结体：`这一切都说明...`、`他终于明白...`、`新的篇章开始了...`。
-- 信息倾倒：角色直接说“我要解释世界观/规则/关系变化”。
-- 论文体/万能结论：过度使用“然而、与此同时、不可否认、这意味着”。
-- 处理原则：有原文证据才输出 finding；给出可执行替换方向，不只评价“AI 味重”。修法方向不默认「拆短 / 删虚词 / 剥标点」：把正常的逗号长句拆成碎句，与 AI 腔同样是问题。
+三层去味 fallback 速查：
+- 表达：套词、总结句、工整句式是否机械复现或重复意思？词语本身只是线索，直写情绪、纠错对比与文风允许的叙述可保留。
+- 用笔：关键交锋或决定是否被概括，次要流程是否过详？压缩、展开均应保住人物体验和必要承接。
+- 故事：行动有什么来由、解决依据从何而来、前后改变了什么？安静场景可承载关系与认知变化，不强求冲突。
+- 处理原则：有原文证据才输出 finding，指出阅读损失、最小建议与资料限制；只报告，不落改，不默认拆短、加动作或新增剧情。
 
 平台 fallback 摘要：
 - 番茄：强开局、强冲突、高频爽点/情绪反馈、低理解门槛。
@@ -159,8 +152,7 @@ AI 味 / 禁用词 fallback 速查：
    node scripts/check-degeneration.js --check <正文文件...>
    ```
    - 将 `ellipsis`、`double-hyphen`、`markdown-divider` 结果作为 `format` findings 合并进报告。`em-dash` 破折号只采用 `check-ai-patterns.js` 的语义改写建议（见下条）；`normalize-punctuation.js` 报的同一位置 `em-dash` 在合并时去重丢弃，避免同处出现「机械替换」与「按功能改写」两条相互冲突的 finding。另外人工检查标点节奏是否通篇句号化或随机堆砌，脚本不替代语气判断。
-   - `check-ai-patterns.js` 的 findings 合并进 `prose`：severity=blocking 的类别一律按 S2（当前为 `not-is-comparison` / `em-dash` / `voice-contrast` / `negation-parade` / `reverse-not-is` / `trailer-ending` / `trailer-summary`），修法直接采用检测器输出的建议（删否定铺垫/反差腔/排比否定/章尾预告腔/章尾状态总结句，直接写后项或具体动作；破折号按功能改成动作/短句/逗号/冒号）。
-   - 其余 prose findings（advisory）统一按 S3：只指出读感风险，不替代人工判断；功能性写法标 `[需复核]` 并保留。完整类别和修法见 `anti-ai-writing.md`。
+   - `check-ai-patterns.js` 的 blocking / advisory 都先作为 `prose` 候选，按 `style_resolution`、原文功能及三层方法逐条复核；确认造成具体阅读损失后，按下方严重度定义定级。功能性纠错、叙述与停顿保留，不把脚本级别直接换成必须修改的 finding。检测器改法仅作参考，不覆盖文风与事实边界。完整语义复核见 `expression.md`、`narrative-focus.md`、`story-logic.md`，只报告问题与建议，不落改。
    - `check-degeneration.js` 报告模型退化（逐字复读/截断/占位符/工程词泄漏），每条带 `severity: blocking|advisory`：blocking（复读/截断/tier1 工程词）作为 S1/S2 `prose` findings，修复建议是「重新生成该段，不是改写」；advisory（tier2 章节/歧义词）作为 S3。
    - 这三个预检脚本只读；`story-review` **不修改正文、设定或大纲文件**，需要自动修复正文时建议转 `/story-deslop`。full / lean 模式只有下方「追踪文件维护」允许修改 `追踪/`；分批审查的所有模式都可按 batch-review.md 写 **.story-review/state.md**，solo 除该状态外不写项目内容。
    - 默认 `--quote-mode keep`，不把知乎盐言短篇的 `「」` 当作问题；只有项目明确指定引号风格时才检查对应转换建议。
@@ -169,7 +161,7 @@ AI 味 / 禁用词 fallback 速查：
 
 ## 统一 Findings Schema（所有模式必须使用）
 
-所有 reviewer（包括 solo）输出问题时必须使用统一结构，方便综合排序；它只在 reviewer 与综合裁决之间流转，给作者的报告按 Phase 4 或 solo 模板转写。`location` 必须使用工具读取结果显示的原始文件行号；不要删除空行后重新编号。
+所有 reviewer（包括 solo）先按统一结构整理问题，再按 Phase 4 或 solo 模板转写给作者；内部字段用于合并、排序，不原样贴进作者报告。`location` 必须使用工具读取结果显示的原始文件行号；不要删除空行后重新编号。
 
 对 `consistency` / `factual` / `causal` / `rule_boundary` 类 finding，`fix` 字段只写事实统一方向（例如“统一为左臂旧伤，并同步正文/设定中冲突处”或“需在 A/B 时间线中裁定一个来源”），不要写文学创作建议。
 
@@ -222,10 +214,3 @@ AI 味 / 禁用词 fallback 速查：
 | 要修改查出的问题 | story-long-write / story-short-write | 返回对应写作 skill 修改 |
 | 发现 AI 味需清理 | story-deslop | `/story-deslop` |
 | 需要重新拆解对标书 | story-long-analyze / story-short-analyze | `/story-long-analyze` 或 `/story-short-analyze` |
-
----
-
-## 语言
-
-- 跟随用户的语言回复，用户用什么语言就用什么语言回复。
-- 中文回复遵循《中文文案排版指北》。

package/lib/oh-story/skills/story-review/references/agent-prompts.md

@@ -2,9 +2,7 @@
 
 只有实际模式仍是 full/lean 时才读本文件。
 
-使用当前运行时的 Agent 工具并行调用（Codex 原生子代理使用 `agent_type`，Claude Code 使用 `subagent_type`，OpenCode 使用 `subagent` 工具的 `agent` 参数，Antigravity 使用 `invoke_subagent` + 同名 `TypeName`；实际字段以当前 CLI 暴露的工具为准）。每个 Agent 不继承父对话上下文，prompt 必须自包含项目路径、审查范围、文件路径、必要摘录和统一 Findings Schema。审稿视角的三个 prompt 还要内联审查基准包摘要与 Rubric Source，不要求子 Agent 必须读 `story-review/references/*` 才能完成任务（如需补充只读本 Skill 的 references）；consistency-checker 例外，它只核对事实，按自己的检查项审，不带审查基准包。所有 reviewer 只读：不改任何文件，只输出结果。
-
-**调用规则**：执行 Phase 0 后，只有实际模式仍是 full/lean 时才 spawn。不要 spawn 缺失 Agent。
+使用当前运行时的 Agent 工具并行调用（Codex 原生子代理使用 `agent_type`，Claude Code 使用 `subagent_type`，OpenCode 使用 `subagent` 工具的 `agent` 参数，Antigravity 使用 `invoke_subagent` + 同名 `TypeName`；实际字段以当前 CLI 暴露的工具为准）。每个 Agent 不继承父对话上下文，prompt 必须自包含项目路径、审查范围、文件路径、必要摘录和统一 Findings Schema。结构、角色、文字三个视角的 prompt 还要内联审查基准包摘要与 Rubric Source，使子 Agent 能直接开审；补充资料只读本 Skill 的 references。consistency-checker 按自己的检查项核对事实，不带内容评分基准包。所有 reviewer 只读：不改任何文件，只输出结果。
 
 **story-explorer 预查询（可选）**。仅当 `Effective Mode` 仍为 `full`/`lean`、当前允许 spawn 且当前运行时的 Agent 工具可用时，才可在对应 canonical agent 目录下确认 `story-explorer` 已部署并 spawn；Antigravity 检查 `.agents/agents/story-explorer/agent.md`，用 `invoke_subagent` + `TypeName: "story-explorer"`。`solo` 或子代理递归保护场景下不得 spawn，只能直接读取/检索。Prompt 示例：
 
@@ -41,7 +39,7 @@
   9. 按平台 rubric 或通用内容 rubric 逐项对照，标记 PASS/FAIL。
   10. 继承的开放项里，本批本该兑现的钩子/伏笔是否落空？
   11. 开头同质化（仅当本章是全书开篇/前 3 章）：开局切口是不是同题材的默认套路（穿越即退婚、系统绑定、末世第一天、开场即打脸等），能不能原样换到任意同类书？"有钩子/非天气开场"不等于不同质。对照 `story-review/references/plot-core-methods.md`「噱头分类与开篇流程」判断——能整体换到同类书=同质化（撞题材模板至少 S2；套路化但有具体人物/处境微差 S3）。
-  12. 结尾总结：章尾是总结/升华/复述式收尾（"就这样……""他终于明白……""这一夜注定……"），还是落在动作/画面/悬念上？检测器已判 blocking 的（`trailer-summary`）按上面「blocking 一律 S2」处理，不重复定级；检测器没覆盖的总结/升华/复述式收尾按影响定 S2/S3（改写走 /story-deslop：章尾预告与章尾状态总结归 Gate F，其余 blocking 并入 Gate B；本 skill 只标问题不改写）。
+  12. 结尾总结：章尾的总结、升华或复述是否重复已有信息、削弱收束？先按本书叙述方式和原文功能复核，检测器命中也不自动判错；确认问题后按实际影响定级，与其他 reviewer 同处 findings 去重。
 
   输出格式：
   VERDICT: APPROVE / CONCERNS / REJECT
@@ -82,7 +80,7 @@
 
 **Agent 3: narrative-writer**（subagent_type: narrative-writer）
 - full 模式调用。
-- 审查视角：AI味检测（含解释腔/上帝感/安排感=模式 8）、情绪烈度（够不够爽/会不会太保守）、格式合规、节奏均匀度、文字自然度。
+- 审查视角：三层去味诊断（表达、用笔、故事因果与变化）、情绪烈度（够不够爽/会不会太保守）、格式合规、节奏均匀度、文字自然度。
 - 提示指令：
   ```
   你是 narrative-writer，从文字质量层面审查以下内容。
@@ -94,22 +92,22 @@
   style_resolution：{本次生效要求及来源、被覆盖的默认条款、事实边界；文字风格判断共用}
   审查基准包摘要：{Phase 1 形成的 rubric / fallback 摘要，必须内联}
   Rubric Source: file | embedded fallback
-  去味判据：按你读取表的 anti-ai-writing、banned-words、deslop-gates 审（审查任务照表读），这里不摘抄
+  去味判据：按读取表完整读 expression、narrative-focus、story-logic 及 banned-words、deslop-gates，三层都审；方法里的改写动作仅用作建议，不落改
   检查项：
   1. 是否存在禁用词/套话/陈词滥调，或“像/好像/仿佛/如同”式比喻成片堆叠？
-  2. 是否出现 AI 写作指纹、10 种 AI 写作模式（含模式 8 解释腔/上帝视角/安排感）或章末总结体？
+  2. 表达是否机械、视角是否越过本书信息边界，章末是否只剩重复总结？
   3. 格式是否合规（按戏剧单元/镜头自然断段、无机械字数切分、无空行、对话独立成行、主语节奏自然）？
   4. 标点节奏是否匹配语气/人物声线：是否通篇句号化、随机堆砌问号/感叹号，或残留 `……`/`——` 硬造停顿？本书已明确授权且有功能的停顿不因符号本身判错。
   5. 是否出现“这五个字 / 短短四字 / 三个字一落 / 八个字砸下去”等正文内具体字数表达？若统计口径不明、未见机器核对结果或无叙事必要，标为问题并建议改成非具体数字表达。
   6. 节奏是否均匀（有无连续多节无情绪变化）？
   7. 是否存在删掉无损的任务卡点或流程细节？若只是水/局部节奏问题标 S3；明显拖垮主线推进标 S2。
   8. 身体细节是否重复、无功能？按本书文风和叙事作用判断，不设单词次数硬线。
-  9. AI味分级（轻度/中度/重度）及证据。
-  10. 去 AI 补充复核：是否有作者解释总结/意义尾巴；是否连续堆精致戏剧反应短语；是否把已有手机/屏幕/公告/规则/证据载体改成叙述者解释；是否把任务卡点当成自然感或凑字数手段；是否机械删除了有功能的生活化/角色化比喻或短篇主观审判句。
+  9. 分别报告表达、用笔、故事层的问题与证据，不用表层轻重决定是否查后两层。
+  10. 关键决定或交锋是否被概括、次要流程是否占满篇幅？人物为何这样行动、解决为何成立、经过之后改变了什么？安静场景按自身功能判断，不能为去味强加冲突。
 
   输出格式：
   VERDICT: APPROVE / CONCERNS / REJECT
-  FINDINGS: 必须使用统一 Findings Schema，severity 必须是 S1/S2/S3/S4；AI味级别写入 issue 或 category。
+  FINDINGS: 使用统一 Findings Schema，severity 为 S1/S2/S3/S4；具体层次与问题写入 issue，category 使用 prose。
   RECOMMENDATIONS: [修改建议]
   ```
 
@@ -135,7 +133,7 @@
   输出格式：
   VERDICT: APPROVE / CONCERNS / REJECT
   FINDINGS: 必须使用统一 Findings Schema，severity 必须是 S1/S2/S3/S4；category 只能使用 consistency / factual / format / causal / rule_boundary。
-  INHERITED_ITEMS: 逐条列继承的开放项 + 已检查 / 未能检查；本批新发现、不在 伏笔.md 的开放钩子单列，供主会话回写 追踪/伏笔.md。
+  INHERITED_ITEMS: 逐条列继承的开放项 + 已检查 / 未能检查；本批新发现、不在 伏笔.md 的开放钩子单列，供主会话按追踪修订事务处理。
   FACTUAL_RECONCILIATION: [仅列需统一的事实来源或需人工裁决项，不写文学创作建议]
   REASONING_CHAINS: [仅列推理型 finding 的前提/规则 -> 触发事件 -> 矛盾点 -> 需裁决问题]
   ```
@@ -144,7 +142,7 @@
 
 1. 收集实际执行的 reviewer VERDICT 和 FINDINGS。
 2. 合并去重：按 `severity` 排序（S1 > S2 > S3 > S4），同级内按影响范围排序。
-3. **可选事实核查**：如果审查内容涉及需要验证的外部事实（历史年代、地理方位、职业细节等），只有在 `Effective Mode` 仍为 `full`/`lean`、当前不是子 Agent、当前运行时的 Agent 工具可用且对应 canonical agent 目录下的 `story-researcher` 已部署时，才可额外 spawn；Antigravity 检查 `.agents/agents/story-researcher/agent.md`，用 `invoke_subagent` + `TypeName: "story-researcher"`。`solo`、missing/malformed/stale/spawn failed 降级或子代理递归保护场景下不得 spawn，只能在报告中标记“需人工事实核查”。
+3. **可选事实核查**：如果审查内容涉及需要验证的外部事实（历史年代、地理方位、职业细节等），只有在 `Effective Mode` 仍为 `full`/`lean`、当前不是子 Agent、当前运行时的 Agent 工具可用且对应 canonical agent 目录下的 `story-researcher` 已部署时，才可额外 spawn；Antigravity 检查 `.agents/agents/story-researcher/agent.md`，用 `invoke_subagent` + `TypeName: "story-researcher"`。`solo`、missing/malformed/spawn failed 降级或子代理递归保护场景下不得 spawn，只能在报告中标记“需人工事实核查”。
 4. **分歧呈现**：如果 reviewer 间有冲突意见，明确呈现分歧让用户裁决；不要自动妥协。
 5. 按 SKILL.md「报告面向作者」输出综合审查报告：开头说明审查方式与范围，证据不足项写成作者能补的材料，执行路径只进技术备注行。