Skip to content

ZJU-REAL/Easel / skills/builtin/novel-writer

novel-writer

Verified

长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性。 当用户说“写小说/网文/盐选故事、连载、续写下一章、小说大纲、人物设定、世界观、黄金三章”时使用。 通用文章用 article-outline/social-content;单段改风格或润色用 style-transfer/text-polisher。

scripts/novel_ops.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""novel_ops.py — 网文连载的确定性状态管理(纯标准库)。

小说连载的**创意**(世界观/大纲/正文)交给 LLM;本脚本只负责**确定性 IO**:
搭书籍目录骨架、维护连载进度、机械扫 AI 味/重复措辞。核心思想是「文件即真相 +
按需加载」——AI 不靠上下文记忆,每写一章只加载相关切片,状态落文件、可 diff。

子命令:
    scaffold   为一本书搭出 bible/outline/state/chapters 目录 + 模板文件(不覆盖已存在)
    record     登记/更新某章进度(写 state/progress.json,重生成 state/progress.md 表)
    show       打印连载进度表
    slopcheck  机械扫描一段正文的 AI 味词 / 过度连接词 / 重复措辞(advisory)
    selftest   自检

用法举例:
    novel_ops.py scaffold --book "我的书名"
    novel_ops.py scaffold --book "我的书名" --root outputs
    novel_ops.py record --book "我的书名" --chapter 1 --title "重生" --words 4200 --status done
    novel_ops.py show --book "我的书名"
    novel_ops.py slopcheck -f outputs/我的书名/chapters/001.md
    echo "文本" | novel_ops.py slopcheck
"""
from __future__ import annotations

import argparse
import json
import re
import sys
from pathlib import Path

DEFAULT_ROOT = "outputs"

# ── 目录树模板(scaffold 时按需 seed,已存在不覆盖,保护未提交/已写内容)──
_TEMPLATES: dict[str, str] = {
    "bible/world.md": "# 世界观设定(硬事实)\n\n> 时代/地域/力量体系/规则。这里写的都是全书不可违背的硬约束。\n",
    "bible/characters.md": "# 人物档案\n\n> 每个角色:身份 / 外貌 / 性格 / 目标 / 与他人关系。跨章一致的依据。\n\n## 主角\n\n",
    "bible/voice.md": "# 文风指纹 + 禁用清单\n\n## 文风指纹\n\n> 视角(第一/第三)、时态、句式节奏、用词偏好、叙事腔调。\n\n## 禁用词/AI 痕迹清单\n\n> 本书要避免的口头禅、陈词、句式(slopcheck 会机械扫这些)。\n",
    "bible/canon.md": "# Canon(跨章硬事实库)\n\n> 已发生的关键事件、时间线、伏笔状态(埋下/回收)。写新章前必读,写完 sync 时更新。\n\n## 时间线\n\n## 伏笔登记\n\n| 伏笔 | 埋于章 | 状态 | 计划回收 |\n|---|---|---|---|\n",
    "outline/overview.md": "# 全书梗概\n\n> 一句话卖点 + 核心冲突 + 主线走向 + 结局方向。\n",
    "outline/volumes.md": "# 分卷 Arc\n\n> 每卷:目标/转折/卷末高潮。\n\n## 第一卷\n",
    "outline/chapters.md": "# 章节目录\n\n| 章 | 标题 | 一句话钩子 | 涉及伏笔 |\n|---|---|---|---|\n",
    "state/summary.md": "# 滚动前情提要\n\n> 由 text-condenser 压缩已发生剧情生成,写下一章时加载它而非全文。\n",
    "state/character-state.md": "# 角色当前状态\n\n> 各角色此刻的位置/处境/关系/持有物,随剧情推进更新。\n",
    "state/plot-arcs.md": "# 情节线追踪\n\n> 各条明线/暗线的当前进度。\n",
}

_PROGRESS_JSON = "state/progress.json"
_PROGRESS_MD = "state/progress.md"

# ── slopcheck 词表(网文语境的 AI 味信号,advisory)──
_SLOP_MARKERS = [
    "值得注意的是", "总而言之", "综上所述", "不难看出", "众所周知",
    "在这个", "在这样一个", "首先", "其次", "最后", "此外", "然而,",
    "无疑", "无疑是", "可以说", "某种程度上", "在某种意义上",
    "空气仿佛凝固", "嘴角勾起一抹", "眼中闪过一丝", "心中五味杂陈",
    "不由得", "缓缓地", "深吸一口气", "微微一笑",
]
_OVERUSED_CONNECTORS = ["于是", "然后", "接着", "随后", "紧接着"]


def _die(msg: str, code: int = 1) -> None:
    print(f"ERROR: {msg}", file=sys.stderr)
    sys.exit(code)


def _book_dir(root: str, book: str) -> Path:
    return (Path(root).expanduser() / book).resolve()


# ── scaffold ──────────────────────────────────────────────────────────
def scaffold(root: str, book: str) -> dict:
    """搭书籍目录骨架,seed 模板文件(已存在不覆盖)。返回统计。"""
    if not book.strip():
        _die("--book 书名不能为空")
    base = _book_dir(root, book)
    created, skipped = [], []
    for sub in ("bible", "outline", "state", "chapters"):
        (base / sub).mkdir(parents=True, exist_ok=True)
    for rel, content in _TEMPLATES.items():
        p = base / rel
        if p.exists():
            skipped.append(rel)
        else:
            p.write_text(content, encoding="utf-8")
            created.append(rel)
    # 初始化空 progress
    pj = base / _PROGRESS_JSON
    if not pj.exists():
        pj.write_text(json.dumps({"book": book, "chapters": []},
                                 ensure_ascii=False, indent=2), encoding="utf-8")
        _render_progress_md(base, {"book": book, "chapters": []})
        created.append(_PROGRESS_JSON)
    return {"base": str(base), "created": created, "skipped": skipped}


# ── progress ──────────────────────────────────────────────────────────
def _load_progress(base: Path) -> dict:
    pj = base / _PROGRESS_JSON
    if not pj.exists():
        return {"book": base.name, "chapters": []}
    return json.loads(pj.read_text(encoding="utf-8"))


def _render_progress_md(base: Path, data: dict) -> None:
    rows = ["# 连载进度", "",
            "| 章 | 标题 | 字数 | 状态 | 更新 |",
            "|---|---|---|---|---|"]
    total = 0
    for c in sorted(data.get("chapters", []), key=lambda x: x["chapter"]):
        total += int(c.get("words", 0) or 0)
        rows.append(f"| {c['chapter']} | {c.get('title','')} | "
                    f"{c.get('words',0)} | {c.get('status','')} | {c.get('updated','')} |")
    done = sum(1 for c in data.get("chapters", []) if c.get("status") == "done")
    rows += ["", f"**合计**:{len(data.get('chapters', []))} 章 / "
             f"已定稿 {done} 章 / 累计 {total} 字"]
    (base / _PROGRESS_MD).write_text("\n".join(rows) + "\n", encoding="utf-8")


def record(root: str, book: str, chapter: int, title: str | None,
           words: int | None, status: str, when: str | None) -> dict:
    """登记/更新一章进度(幂等 upsert,按 chapter 号)。"""
    base = _book_dir(root, book)
    if not base.exists():
        _die(f"书籍目录不存在,请先 scaffold:{base}")
    data = _load_progress(base)
    chs = data.setdefault("chapters", [])
    hit = next((c for c in chs if c["chapter"] == chapter), None)
    if hit is None:
        hit = {"chapter": chapter}
        chs.append(hit)
    if title is not None:
        hit["title"] = title
    if words is not None:
        hit["words"] = words
    hit["status"] = status
    hit["updated"] = when or ""  # 时间戳由调用方传入(脚本内不取 Date,保持确定性)
    (base / _PROGRESS_JSON).write_text(
        json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
    _render_progress_md(base, data)
    return {"chapter": chapter, "status": status, "total_chapters": len(chs)}


def show(root: str, book: str) -> str:
    base = _book_dir(root, book)
    md = base / _PROGRESS_MD
    if md.exists():
        return md.read_text(encoding="utf-8")
    data = _load_progress(base)
    return json.dumps(data, ensure_ascii=False, indent=2)


# ── slopcheck ─────────────────────────────────────────────────────────
def slopcheck(text: str) -> dict:
    """机械扫 AI 味词 / 过度连接词 / 重复句首。返回命中清单(advisory)。"""
    hits: list[dict] = []
    for w in _SLOP_MARKERS:
        n = text.count(w)
        if n:
            hits.append({"type": "ai-marker", "term": w, "count": n})
    for w in _OVERUSED_CONNECTORS:
        n = text.count(w)
        if n >= 3:  # 连接词高频才算问题
            hits.append({"type": "overused", "term": w, "count": n})
    # 重复句首(同一开头连续/多次出现)
    starts: dict[str, int] = {}
    for line in text.splitlines():
        s = line.strip()[:4]
        if len(s) >= 2:
            starts[s] = starts.get(s, 0) + 1
    for s, n in starts.items():
        if n >= 4:
            hits.append({"type": "repeated-start", "term": s, "count": n})
    hits.sort(key=lambda h: -h["count"])
    return {"total_hits": sum(h["count"] for h in hits),
            "distinct": len(hits), "hits": hits}


def _read_input(path: str | None) -> str:
    if path and path != "-":
        return Path(path).expanduser().read_text(encoding="utf-8")
    data = sys.stdin.read()
    if not data:
        _die("没有输入。用 -f 指定文件,或 stdin 传入。")
    return data


# ── selftest ──────────────────────────────────────────────────────────
def _selftest() -> int:
    import tempfile
    ok = True

    def chk(name, cond):
        nonlocal ok
        print(f"[{'PASS' if cond else 'FAIL'}] {name}")
        ok = ok and cond

    with tempfile.TemporaryDirectory() as td:
        r = scaffold(td, "测试书")
        base = Path(r["base"])
        chk("scaffold 建目录", (base / "bible/world.md").is_file()
            and (base / "chapters").is_dir())
        chk("scaffold 建 progress", (base / _PROGRESS_JSON).is_file())
        # 二次 scaffold 不覆盖
        (base / "bible/world.md").write_text("我的内容", encoding="utf-8")
        scaffold(td, "测试书")
        chk("scaffold 不覆盖已有", (base / "bible/world.md").read_text(
            encoding="utf-8") == "我的内容")
        # record upsert
        record(td, "测试书", 1, "第一章", 4200, "done", "2026-08-04")
        record(td, "测试书", 2, "第二章", 3800, "draft", "2026-08-04")
        record(td, "测试书", 1, None, 4500, "done", "2026-08-05")  # 更新第1章
        data = _load_progress(base)
        c1 = next(c for c in data["chapters"] if c["chapter"] == 1)
        chk("record upsert 幂等", len(data["chapters"]) == 2 and c1["words"] == 4500)
        chk("progress.md 生成", "累计" in (base / _PROGRESS_MD).read_text(
            encoding="utf-8"))

    s = slopcheck("值得注意的是,他缓缓地深吸一口气。于是他走了。于是又停下。于是再走。")
    terms = {h["term"] for h in s["hits"]}
    chk("slopcheck 抓 ai-marker", "值得注意的是" in terms and "缓缓地" in terms)
    chk("slopcheck 抓过度连接词", "于是" in terms)
    chk("slopcheck 干净文本无命中", slopcheck("他推开门,风灌了进来。")["distinct"] == 0)

    print("✅ selftest 通过" if ok else "❌ selftest 失败")
    return 0 if ok else 1


def main() -> int:
    ap = argparse.ArgumentParser(
        description="网文连载确定性状态管理(scaffold/record/show/slopcheck)",
        formatter_class=argparse.RawDescriptionHelpFormatter, epilog=__doc__)
    sub = ap.add_subparsers(dest="cmd", required=True)

    ps = sub.add_parser("scaffold", help="搭书籍目录骨架")
    ps.add_argument("--book", required=True)
    ps.add_argument("--root", default=DEFAULT_ROOT)

    pr = sub.add_parser("record", help="登记/更新章节进度")
    pr.add_argument("--book", required=True)
    pr.add_argument("--root", default=DEFAULT_ROOT)
    pr.add_argument("--chapter", type=int, required=True)
    pr.add_argument("--title")
    pr.add_argument("--words", type=int)
    pr.add_argument("--status", default="draft",
                    choices=["draft", "done", "revised", "planned"])
    pr.add_argument("--when", help="更新时间戳(调用方传入,如 2026-08-04)")

    psh = sub.add_parser("show", help="打印进度表")
    psh.add_argument("--book", required=True)
    psh.add_argument("--root", default=DEFAULT_ROOT)

    pc = sub.add_parser("slopcheck", help="机械扫 AI 味/重复(advisory)")
    pc.add_argument("-f", "--file", help="正文文件(默认 stdin)")
    pc.add_argument("--json", action="store_true")

    sub.add_parser("selftest", help="自检")

    a = ap.parse_args()
    if a.cmd == "selftest":
        return _selftest()
    if a.cmd == "scaffold":
        r = scaffold(a.root, a.book)
        print(f"✅ {r['base']}")
        print(f"   新建 {len(r['created'])} 个文件,跳过已存在 {len(r['skipped'])} 个")
        return 0
    if a.cmd == "record":
        r = record(a.root, a.book, a.chapter, a.title, a.words, a.status, a.when)
        print(f"✅ 第 {r['chapter']} 章 [{r['status']}],共 {r['total_chapters']} 章")
        return 0
    if a.cmd == "show":
        print(show(a.root, a.book))
        return 0
    if a.cmd == "slopcheck":
        r = slopcheck(_read_input(a.file))
        if a.json:
            print(json.dumps(r, ensure_ascii=False, indent=2))
        else:
            if not r["hits"]:
                print("✅ 未命中 AI 味词/重复(advisory 通过)")
            else:
                print(f"⚠️ 命中 {r['distinct']} 类 / 共 {r['total_hits']} 处:")
                for h in r["hits"]:
                    print(f"  [{h['type']}] {h['term']} ×{h['count']}")
        return 0
    return 1


if __name__ == "__main__":
    sys.exit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall