galbook 0.0.0-stage → 1.2.4

package/galbook/__init__.py

@@ -0,0 +1,15 @@
+"""galbook —— 让 agent 像人一样玩 galgame：读剧本、遇到选项自己选、存档/读档/回溯。
+
+组成：
+  ir.py        引擎无关的中间格式（story.json + scenes/*.json）与校验
+  expr.py      安全的小表达式求值（条件 / 赋值），不用 eval
+  engine.py    运行时：推进、选项、存档快照、已读跳过、回溯
+  store.py     多 agent 并发存储：每个 agent 一份档案 + 存档位，逐 agent 加锁、原子写
+  web.py       HTTP 接口（独立服务 python -m galbook serve，或嵌进任何 http.server；纯文本接口给 agent 省 token）
+  importers/   各引擎脚本 → 中间格式（qlie / kag(吉里吉里·Tyrano) / renpy / nscripter / galscript / textdump / legacy 书稿；可加插件）
+  server.py    独立 HTTP 服务（可选令牌、每个令牌绑定 agent 名）
+  mcp_server.py MCP（stdio）服务；tools.py 工具定义（MCP / OpenAI 共用）
+  i18n.py      文本接口 zh / en
+只用 Python 标准库。
+"""
+VERSION = "galbook-1.2.4"

package/galbook/__main__.py

@@ -0,0 +1,138 @@
+"""python3 -m galbook <命令> …
+
+  build   把解包目录转成可玩剧本      python3 -m galbook build --src 解包目录 --out books/<书>/story
+  detect  只认引擎                    python3 -m galbook detect 目录
+  serve   起 HTTP 服务（页面+接口）   python3 -m galbook serve --books books --data play-data
+  mcp     MCP 服务（stdio）           python3 -m galbook mcp --books books --data play-data --agent alice
+  play    命令行里玩一步              python3 -m galbook play books play-data <书> <名字> next n=20
+  do      同上，参数走环境变量（给 shell 工具用）
+                                      GALBOOK_BOOKS=books GALBOOK_DATA=play-data GALBOOK_BOOK=fog-harbor GALBOOK_AGENT=alice
+                                      python3 -m galbook do next n=20 ；python3 -m galbook do books ；python3 -m galbook do help
+  tools   打印工具定义                python3 -m galbook tools --format openai|mcp
+  demo    装自带的演示故事到 books/   python3 -m galbook demo --books books
+  version
+
+  serve / mcp / play / do 都认 --no-demo（或环境变量 GALBOOK_NO_DEMO=1）：books 为空时不自动装演示书"""
+import sys
+
+
+def _utf8_stdio():
+    """Windows 控制台/管道默认 GBK 之类，中文/日文会乱码或报错：统一 UTF-8。"""
+    for f in (sys.stdout, sys.stderr):
+        if hasattr(f, "reconfigure") and (f.encoding or "").lower().replace("-", "") != "utf8":
+            try:
+                f.reconfigure(encoding="utf-8", errors="replace")
+            except Exception:  # noqa
+                pass
+
+
+def do(argv):
+    """galbook do <动作> [k=v …] [--book B] [--agent A] [--books DIR] [--data DIR] [--lang en]"""
+    import os
+    from .play import Library
+    from . import tools
+    kw, rest, flags = {}, [], {}
+    it = iter(argv)
+    for x in it:
+        if x.startswith("--") and x[2:] in ("book", "agent", "books", "data", "lang"):
+            flags[x[2:]] = next(it, "")
+        elif "=" in x and not x.startswith("="):
+            k, _, v = x.partition("=")
+            kw[k] = v
+        else:
+            rest.append(x)
+    if not rest:
+        print(do.__doc__)
+        return 2
+    action = rest[0]
+    books = flags.get("books") or os.environ.get("GALBOOK_BOOKS", "books")
+    data = flags.get("data") or os.environ.get("GALBOOK_DATA", "play-data")
+    book = kw.pop("book", None) or flags.get("book") or os.environ.get("GALBOOK_BOOK")
+    agent = kw.pop("agent", None) or flags.get("agent") or os.environ.get("GALBOOK_AGENT")
+    lang = flags.get("lang") or os.environ.get("GALBOOK_LANG", "zh")
+    name = "galbook_" + {"skip": "next"}.get(action, action)
+    if action == "skip":
+        kw["skip_read"] = True
+    if "n" in kw:
+        kw["n"] = int(kw["n"])
+    if "steps" in kw:
+        kw["steps"] = int(kw["steps"])
+    if name == "galbook_choose" and kw.get("i", "random") != "random":
+        kw["i"] = int(kw["i"])
+    if "img" in kw:
+        kw["img"] = kw["img"] in ("1", "true")
+    try:
+        print(tools.call_tool(Library(books, data), name, kw, book, agent, lang, style="cli", lang_override=flags.get("lang")))
+    except Exception as e:  # noqa
+        from .i18n import msg
+        print("错误 / error: %s" % msg(lang, str(e)))
+        return 1
+    return 0
+
+
+def main(argv=None):
+    _utf8_stdio()
+    a = list(sys.argv[1:] if argv is None else argv)
+    if not a or a[0] in ("-h", "--help", "help"):
+        print(__doc__)
+        return 0
+    cmd, rest = a[0], a[1:]
+    if cmd in ("serve", "mcp", "play", "do"):
+        from .demo_boot import no_demo_flag
+        rest = no_demo_flag(rest)
+    if cmd == "build":
+        from .build import main as m
+    elif cmd == "serve":
+        from .server import main as m
+    elif cmd == "mcp":
+        from .mcp_server import main as m
+    elif cmd == "play":
+        from .cli import main as m
+    elif cmd == "tools":
+        from .tools import main as m
+    elif cmd == "detect":
+        from .importers import detect
+        for d in rest or ["."]:
+            print("%s: %s（%s）" % (d, *detect(d)))
+        return 0
+    elif cmd == "do":
+        return do(rest)
+    elif cmd == "demo":
+        return demo(rest)
+    elif cmd in ("version", "--version"):
+        from . import VERSION
+        print(VERSION)
+        return 0
+    else:
+        print("不认识的命令 %s\n%s" % (cmd, __doc__))
+        return 2
+    return m(rest)
+
+
+def demo(argv):
+    """把 galbook/demo/ 下的演示故事编译进 books/（图一起拷过去）。"""
+    import argparse
+    import os
+    import shutil
+    from .build import main as build
+    ap = argparse.ArgumentParser(prog="galbook demo")
+    ap.add_argument("--books", default="books")
+    a = ap.parse_args(argv)
+    root = os.path.join(os.path.dirname(os.path.abspath(__file__)), "demo")
+    for slug in sorted(os.listdir(root)):
+        src = os.path.join(root, slug)
+        if not os.path.isdir(src):
+            continue
+        dst = os.path.join(a.books, slug)
+        if os.path.isdir(os.path.join(src, "assets")):
+            shutil.copytree(os.path.join(src, "assets"), os.path.join(dst, "assets"), dirs_exist_ok=True)
+        print("== %s" % slug)
+        rc = build(["--src", src, "--out", os.path.join(dst, "story"), "--assets-dir", src])
+        if rc:
+            return rc
+    print("好了：python3 -m galbook serve --books %s   然后打开 http://127.0.0.1:8765/play/" % a.books)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/galbook/build.py

@@ -0,0 +1,89 @@
+"""把一个解包目录转成可玩剧本。
+
+  python3 -m galbook build --src <解包目录> --out books/<书>/story [--engine auto] \\
+          [--assets-dir books/<书>] [--assets-list 文件] [--title 书名] [--entry 标签]
+
+--engine auto 按文件特征认引擎；认不出会说明卡在哪一步（要先用什么工具解包/反编译）。
+写出前先校验：所有跳转/选项目标都必须存在，否则不写（加 --force 才写）。"""
+import argparse
+import json
+import sys
+
+from .importers import detect, get, load_plugin, names
+from .importers.common import Assets
+from .ir import validate, save_story, story_from_dict
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser(prog="galbook.build")
+    ap.add_argument("--src", required=True)
+    ap.add_argument("--out", required=True)
+    ap.add_argument("--engine", default="auto", help="auto 或导入器名")
+    ap.add_argument("--plugin", action="append", default=[], help="额外的导入器插件 .py（可多次）")
+    ap.add_argument("--assets-dir", help="书目录（里面的 assets/ 会被索引，路径相对它）")
+    ap.add_argument("--assets-list", help="资源清单文件（每行一个相对 assets/ 的路径）")
+    ap.add_argument("--title")
+    ap.add_argument("--entry")
+    ap.add_argument("--force", action="store_true")
+    ap.add_argument("--strict", action="store_true",
+                    help="有未识别指令或选择点对不上就失败（默认只警告）")
+    ap.add_argument("--dry-run", action="store_true")
+    a = ap.parse_args(argv)
+    for p in a.plugin:
+        print("加载插件：%s" % load_plugin(p))
+    eng = a.engine
+    if eng != "auto" and eng not in names():
+        print("没有导入器 %s（有：%s）" % (eng, " ".join(names())))
+        return 2
+    if eng == "auto":
+        eng, why = detect(a.src)
+        print("认引擎：%s（%s）" % (eng or "认不出", why))
+        if not eng:
+            return 2
+    assets = Assets.from_dir(a.assets_dir) if a.assets_dir else (Assets.from_list(a.assets_list) if a.assets_list else Assets())
+    kw = {"entry": a.entry} if a.entry else {}
+    meta, scenes = get(eng).build(a.src, assets=assets, **kw)
+    if a.title:
+        meta["title"] = a.title
+    probs = validate(meta, scenes)
+    st = meta.get("stats", {})
+    hist = {}
+    for sc in scenes.values():
+        for op in sc.get("ops", []):
+            hist[op.get("op")] = hist.get(op.get("op"), 0) + 1
+    _sel = st.get("choices")
+    if isinstance(_sel, int) and _sel != hist.get("choice", 0):
+        probs.append("选择点对不上：脚本里认出 %d 个 .select/choice，生成出来的 choice op 只有 %d 个"
+                     "（中间可能被当成普通文本吃掉了）" % (_sel, hist.get("choice", 0)))
+    print("结构：" + json.dumps(hist, ensure_ascii=False))
+    print("分支：choice %d 个、jump %d 个、end %d 个%s" % (
+        hist.get("choice", 0), hist.get("jump", 0), hist.get("end", 0),
+        "   ← 一个选择点都没有，检查转换器是不是吞了选项" if len(scenes) > 3 and not hist.get("choice") else ""))
+    st["ops"] = hist
+    clicks = [op["click"] for sc in scenes.values() for op in sc.get("ops", []) if op.get("op") == "say" and op.get("click")]
+    if clicks:
+        st["clicks"] = len(clicks)
+        print("特殊机制：可点的句子 %d 处（say.click；读的时候条件成立会在句尾挂 ◇，do=click 触发）" % len(clicks))
+    print("统计：" + json.dumps({k: v for k, v in st.items() if k not in ("assets", "unknown")}, ensure_ascii=False))
+    print("图片解析：" + json.dumps(st.get("assets"), ensure_ascii=False))
+    print("未识别指令（前 20）：" + json.dumps(st.get("unknown"), ensure_ascii=False))
+    print("警告 %d 条%s" % (len(meta.get("warnings", [])), ("：" + "；".join(meta["warnings"][:5])) if meta.get("warnings") else ""))
+    print("校验：%s" % ("通过" if not probs else "%d 个问题：%s" % (len(probs), "；".join(probs[:10]))))
+    _w = story_from_dict(meta, scenes).warnings
+    if _w:
+        print("可疑：" + "；".join(_w))
+    if a.strict and (probs or st.get("unknown")):
+        print("--strict：有未识别指令或校验问题，按约定失败")
+        return 1
+    if probs and not a.force:
+        print("有校验问题，没写文件（--force 强制写）")
+        return 1
+    if a.dry_run:
+        return 0
+    n = save_story(a.out, meta, scenes)
+    print("写出 %d 个文件 → %s" % (n, a.out))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/galbook/cli.py

@@ -0,0 +1,29 @@
+"""命令行里玩（不用起服务）：
+  python3 -m galbook play <books目录> <存档目录> <书> <agent> <操作> [k=v ...]
+例：python3 -m galbook play books play-data lighthouse alice next n=30"""
+import sys
+
+from .play import Library
+from .web import render_text
+
+
+def main(argv=None):
+    a = list(argv if argv is not None else sys.argv[1:])
+    if len(a) < 5:
+        print(__doc__)
+        return 2
+    books, data, book, agent, do = a[:5]
+    kw = dict(x.split("=", 1) for x in a[5:])
+    if kw.pop("skip", "") in ("1", "true"):
+        kw["skip_read"] = True
+    img = kw.pop("img", "") in ("1", "true")
+    lang = kw.get("lang") if do == "new" else kw.pop("lang", None)
+    lib = Library(books, data)
+    r = lib.act(book, agent, do, **kw)
+    lang = lang or ((r.get("opts") or (lib.store.peek_run(book, agent) or {}).get("opts") or {}).get("lang")) or "zh"
+    sys.stdout.write(render_text(r, do, img, book, agent, lang))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/galbook/demo/fog-harbor/assets/cg_dawn_together.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#f2c27b"/><stop offset="1" stop-color="#f6e7c8"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">CG 黎明</text></svg>

package/galbook/demo/fog-harbor/assets/cg_old_letter.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#6b5133"/><stop offset="1" stop-color="#e8d6b0"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">CG 旧信</text></svg>

package/galbook/demo/fog-harbor/assets/cg_ship.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#24496b"/><stop offset="1" stop-color="#9fc4dd"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">CG 归航</text></svg>

package/galbook/demo/fog-harbor/assets/harbor_night.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#0b1630"/><stop offset="1" stop-color="#27406b"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">港口·夜</text></svg>

package/galbook/demo/fog-harbor/assets/lamp_room.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#2a1d12"/><stop offset="1" stop-color="#7a5a2e"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">灯室</text></svg>

package/galbook/demo/fog-harbor/assets/lamp_room_dawn.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#3a2a40"/><stop offset="1" stop-color="#e9b872"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">灯室·黎明</text></svg>

package/galbook/demo/fog-harbor/assets/path_tide.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#13263a"/><stop offset="1" stop-color="#3c6a80"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">涨潮的小路</text></svg>

package/galbook/demo/fog-harbor/assets/shio_normal.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 140 205 L 180 205" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor/assets/shio_smile.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 140 200 Q 160 222 180 200" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor/assets/shio_surprised.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 152 208 a 8 10 0 1 0 16 0 a 8 10 0 1 0 -16 0" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor/assets/warehouse.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#1d1a17"/><stop offset="1" stop-color="#5a4b3a"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">仓库</text></svg>

package/galbook/demo/fog-harbor/story.gal

@@ -0,0 +1,97 @@
+# 雾港灯塔 —— galbook 自带的演示故事（CC0，随便用）。3 个选项点、4 个结局、1 条通关后解锁的隐藏线。
+title: 雾港灯塔
+author: galbook demo
+license: CC0-1.0
+
+=== prologue 序章
+@bg harbor_night
+@bgm calm_sea
+入夜后，港口被雾吞没。只有远处的灯塔还在一明一灭。
+你是来送最后一班信件的邮差。信封上写着：「致灯塔守夜人·汐」。
+@show 汐 shio_normal center
+汐：「这么大的雾还送信？……你胆子不小。」
+汐：「灯里的油快没了。我得去仓库拿，可那条路被潮水淹了一半。」
+? 你会怎么做？
+- 「我陪你去。」 -> help do f.trust += 1; f.brave += 1
+- 「我在这儿帮你看着灯。」 -> stay do f.trust += 1
+- 「信送到了，我该走了。」 -> leave
+- 「……那封信，其实是寄给二十年前的你吧？」 -> secret if s.cleared_light
+
+* help
+@hide 汐
+@bg path_tide
+冰冷的海水没过脚踝。汐走在前面，提灯在雾里晕成一团。
+汐：「你走路怎么这么吵……不过，谢谢。」
+-> warehouse#
+
+* stay
+@bg lamp_room
+你守在灯旁，替她转动沉重的反光镜。雾里传来汽笛声——有船在找方向。
+汐（远处）：「镜子别停！他们看得见！」
+$ f.saved_ship = 1
+-> warehouse#
+
+* leave
+@clear
+@bg harbor_night
+你把信放在门口的石阶上，转身离开。回头时，灯光比来时暗了一些。
+@end ending 雾里的背影
+
+=== warehouse 仓库
+@bg warehouse
+@show 汐 shio_smile center
+仓库里堆满了旧油桶，和一摞没有拆开的信。全是寄给她的。
+汐：「……我从来不敢拆。怕里面写的是『别等了』。」
+? 你要不要劝她拆开？
+- 「拆吧。不管写什么，你都等得起。」 -> open do f.trust += 1
+- 「不想拆就不拆。灯亮着就好。」 -> keep
+- 偷偷把最上面一封塞进她的外套口袋 -> sneak if f.brave >= 1
+
+* open
+汐撕开信封的手在发抖。读着读着，她笑出了声，又哭了。
+汐：「他说……他说他每天晚上都在海那边看这盏灯。」
+-> finale#
+
+* keep
+汐把信重新码好，像码一摞旧书。
+汐：「谢谢你没逼我。」
+-> finale#
+
+* sneak
+你把信塞进她口袋的时候，她其实看见了，只是没说。
+$ f.trust += 2
+-> finale#
+
+=== finale 黎明
+@bg lamp_room_dawn
+雾散了。天边是一层很薄的金色。
+if f.trust >= 2 -> good
+if f.saved_ship == 1 -> ship
+-> normal
+
+* good
+@cg cg_dawn_together
+汐：「明天……你还送信吗？」
+汐：「我是说，如果有寄给我的。」
+$ s.cleared_light = 1
+@end ending 灯火
+
+* ship
+@cg cg_ship
+港口里停着一艘被灯光救回来的船。船长托人送来一桶新油。
+$ s.cleared_light = 1
+@end ending 归航
+
+* normal
+汐朝你挥了挥手，转身去擦那面镜子。
+@end ending 寻常的早晨
+
+=== secret 二十年前的信
+@route 隐藏线
+@bg lamp_room
+@show 汐 shio_surprised center
+汐：「……你怎么知道？」
+你把信封翻过来。邮戳上的年份，是她来到这座灯塔的那一年。
+汐：「原来，那时候就有人在等我回信了。」
+@cg cg_old_letter
+@end ending 回信

package/galbook/demo/fog-harbor-en/assets/cg_dawn_together.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#f2c27b"/><stop offset="1" stop-color="#f6e7c8"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">cg_dawn_together</text></svg>

package/galbook/demo/fog-harbor-en/assets/cg_old_letter.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#6b5133"/><stop offset="1" stop-color="#e8d6b0"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">cg_old_letter</text></svg>

package/galbook/demo/fog-harbor-en/assets/cg_ship.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#24496b"/><stop offset="1" stop-color="#9fc4dd"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">cg_ship</text></svg>

package/galbook/demo/fog-harbor-en/assets/harbor_night.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#0b1630"/><stop offset="1" stop-color="#27406b"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">harbor_night</text></svg>

package/galbook/demo/fog-harbor-en/assets/lamp_room.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#2a1d12"/><stop offset="1" stop-color="#7a5a2e"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">lamp_room</text></svg>

package/galbook/demo/fog-harbor-en/assets/lamp_room_dawn.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#3a2a40"/><stop offset="1" stop-color="#e9b872"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">lamp_room_dawn</text></svg>

package/galbook/demo/fog-harbor-en/assets/path_tide.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#13263a"/><stop offset="1" stop-color="#3c6a80"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">path_tide</text></svg>

package/galbook/demo/fog-harbor-en/assets/shio_normal.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 140 205 L 180 205" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor-en/assets/shio_smile.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 140 200 Q 160 222 180 200" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor-en/assets/shio_surprised.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="720" viewBox="0 0 320 720"><path d="M60 720 L80 300 Q160 250 240 300 L260 720 Z" fill="#2f4f6f"/><path d="M70 150 Q160 40 250 150 L260 330 L60 330 Z" fill="#3b2a24"/><circle cx="160" cy="180" r="70" fill="#f3dccb"/><circle cx="135" cy="170" r="7" fill="#333"/><circle cx="185" cy="170" r="7" fill="#333"/><path d="M 152 208 a 8 10 0 1 0 16 0 a 8 10 0 1 0 -16 0" stroke="#a04040" stroke-width="5" fill="none"/></svg>

package/galbook/demo/fog-harbor-en/assets/warehouse.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#1d1a17"/><stop offset="1" stop-color="#5a4b3a"/></linearGradient></defs><rect width="1280" height="720" fill="url(#g)"/><text x="40" y="70" font-size="36" fill="#ffffff" fill-opacity=".55" font-family="sans-serif">warehouse</text></svg>

package/galbook/demo/fog-harbor-en/story.gal

@@ -0,0 +1,97 @@
+# Fog Harbor Lighthouse — galbook demo story (CC0). 3 choice points, 4 endings, 1 route unlocked after a clear.
+title: Fog Harbor Lighthouse
+author: galbook demo
+license: CC0-1.0
+
+=== prologue Prologue
+@bg harbor_night
+@bgm calm_sea
+After dark the harbor drowns in fog. Only the distant lighthouse still blinks.
+You are the courier with the last letter of the day. The envelope reads: "To Shio, keeper of the light."
+@show Shio shio_normal center
+Shio: "Delivering mail in this fog? ...You've got nerve."
+Shio: "The lamp is almost out of oil. I need to fetch some from the warehouse, but the tide has flooded half the path."
+? What do you do?
+- "I'll come with you." -> help do f.trust += 1; f.brave += 1
+- "I'll watch the lamp for you." -> stay do f.trust += 1
+- "The letter's delivered. I should go." -> leave
+- "...That letter was written to you twenty years ago, wasn't it?" -> secret if s.cleared_light
+
+* help
+@hide Shio
+@bg path_tide
+Cold seawater rises over your ankles. Shio walks ahead, her lantern a blur in the fog.
+Shio: "You're so loud when you walk... but thanks."
+-> warehouse#
+
+* stay
+@bg lamp_room
+You stay by the lamp and turn the heavy mirror for her. A ship's horn sounds in the fog, searching for its way.
+Shio: "Don't stop the mirror! They can see it!"
+$ f.saved_ship = 1
+-> warehouse#
+
+* leave
+@clear
+@bg harbor_night
+You leave the letter on the stone step and walk away. When you look back, the light seems dimmer than before.
+@end ending A Back in the Fog
+
+=== warehouse Warehouse
+@bg warehouse
+@show Shio shio_smile center
+The warehouse is full of old oil drums, and a stack of unopened letters. All addressed to her.
+Shio: "...I never dared open them. In case they say 'stop waiting'."
+? Do you encourage her to open them?
+- "Open them. Whatever they say, you can bear it." -> open do f.trust += 1
+- "If you don't want to, don't. The light is enough." -> keep
+- Quietly slip the top letter into her coat pocket -> sneak if f.brave >= 1
+
+* open
+Her hands shake as she tears the envelope. Reading, she laughs, then cries.
+Shio: "He says... he watches this light every night from across the sea."
+-> finale#
+
+* keep
+Shio stacks the letters back neatly, like old books.
+Shio: "Thank you for not pushing me."
+-> finale#
+
+* sneak
+She saw you slip the letter into her pocket. She just didn't say anything.
+$ f.trust += 2
+-> finale#
+
+=== finale Dawn
+@bg lamp_room_dawn
+The fog lifts. A thin line of gold appears on the horizon.
+if f.trust >= 2 -> good
+if f.saved_ship == 1 -> ship
+-> normal
+
+* good
+@cg cg_dawn_together
+Shio: "Will you... deliver mail again tomorrow?"
+Shio: "I mean, if there's any for me."
+$ s.cleared_light = 1
+@end ending The Light
+
+* ship
+@cg cg_ship
+In the harbor sits a ship the light brought home. The captain sends a barrel of fresh oil.
+$ s.cleared_light = 1
+@end ending Homecoming
+
+* normal
+Shio waves at you, then turns to polish the mirror.
+@end ending An Ordinary Morning
+
+=== secret Twenty Years Ago
+@route Hidden route
+@bg lamp_room
+@show Shio shio_surprised center
+Shio: "...How did you know?"
+You turn the envelope over. The postmark's year is the year she came to this lighthouse.
+Shio: "So even back then, someone was waiting for my reply."
+@cg cg_old_letter
+@end ending The Reply

package/galbook/demo_boot.py

@@ -0,0 +1,63 @@
+"""首次运行引导：books 目录不存在或为空时，把自带演示书装进去。
+
+场景：`npm i galbook` 之后用户手里只有包，没有剧本目录；直接 `python -m galbook mcp`
+会因为找不到书而什么都玩不了。这里补一步，让“装完就能玩”成立。
+"""
+import os
+import shutil
+
+
+def demo_enabled():
+    """GALBOOK_NO_DEMO=1/true/yes → 不自动装演示书。"""
+    return os.environ.get("GALBOOK_NO_DEMO", "").strip().lower() not in ("1", "true", "yes", "on")
+
+
+def no_demo_flag(argv):
+    """从参数里摘掉 --no-demo；有的话设 GALBOOK_NO_DEMO=1（各入口共用）。返回剩下的参数。"""
+    argv = list(argv)
+    if "--no-demo" in argv:
+        argv = [x for x in argv if x != "--no-demo"]
+        os.environ["GALBOOK_NO_DEMO"] = "1"
+    return argv
+
+
+def empty(books_dir):
+    if not os.path.isdir(books_dir):
+        return True
+    try:
+        with os.scandir(books_dir) as it:
+            return not any(it)
+    except OSError:
+        return True
+
+
+def ensure_demo_books(books_dir):
+    """返回装了几本；目录里已经有书就不动。
+
+    注意：build() 会往 stdout 打一堆日志。MCP 走 stdio 时 stdout 是协议通道，
+    这里必须把它的输出吞掉，否则握手直接坏掉（实测过）。
+    """
+    if not empty(books_dir):
+        return 0
+    import contextlib
+    import io
+
+    from .build import main as build
+
+    root = os.path.join(os.path.dirname(os.path.abspath(__file__)), "demo")
+    if not os.path.isdir(root):
+        return 0
+    n = 0
+    for slug in sorted(os.listdir(root)):
+        src = os.path.join(root, slug)
+        if not os.path.isdir(src):
+            continue
+        dst = os.path.join(books_dir, slug)
+        if os.path.isdir(os.path.join(src, "assets")):
+            shutil.copytree(os.path.join(src, "assets"), os.path.join(dst, "assets"), dirs_exist_ok=True)
+        buf = io.StringIO()
+        with contextlib.redirect_stdout(buf):
+            rc = build(["--src", src, "--out", os.path.join(dst, "story"), "--assets-dir", src])
+        if rc == 0:
+            n += 1
+    return n