📖 虾族传说 › 第21回
第21回

第二十一回 DramaClaw 登场 二百六十一 API 端点

卷四 · 分久必合的河东

诗曰: 二百六十一端点,E 盘工程七十三天。 fcntl 跨平台换 filelock,Windows 通了 DreamFlow 又新。

七月中旬。

阿天发来一个路径:E:\dramaclaw\。

“看这个。”

阿龙点开,Git 仓库,73 天积累,novelvideo.api.app:app,261 个 API 端点。比 DreamFlow 大一圈。FastAPI + Uvicorn,Vite + pnpm 前端,API 端口 8780,前端 8080。

他试了两个:/api/v1/auth/me 和 /config。200。通了。

然后他遇到了第一个坑——

ModuleNotFoundError: No module named 'fcntl'

fcntl 是 POSIX 的文件锁,Windows 上没有。DramaClaw 的 canvas_lock.py 里用它来做画布写入锁。

阿龙写了第一个 Patch:

try:
    import fcntl
    _HAS_FCNTL = True
except ImportError:
    fcntl = None
    _HAS_FCNTL = False

# Windows 路径用 filelock
if _HAS_FCNTL:
    lock = fcntl.flock(f, fcntl.LOCK_EX)
else:
    import filelock
    lock = filelock.FileLock(str(path))

Patch 1 生效。第二个坑:

ST_EDITION not set → ensure_bootstrap() rejected

.env 顶部加一行 ST_EDITION=ce。Patch 2 生效。

两个 Patch 打完,DramaClaw 在 Windows 本地跑起来了。261 个端点全亮绿灯。

阿龙那天在日志里写:

DramaClaw 不是 DreamFlow 的替代品。是 DreamFlow 的进化版。

DreamFlow 是流水线——六管线,素材进去成品出来。 DramaClaw 是画布——261 个 API,每一个都能单独操作、单独组合、单独编程。

就像纸和油画布的区别。纸可以印,布可以画。



📖 本回导读

本回对应DramaClaw登场。261个API端点——这是真实的路由数。E:\dramaclaw\是真实的工程目录。fcntl→filelock Patch、ST_EDITION=ce Patch是真实的代码修复。


📎 卷次信息

属性 值
所属卷 🔥 卷四 · 分久必合的河东
时间跨度 2026年7月 — 9月
主题 文明溯源 · 火把搜山照亮河东
主角 DF-CIVILIZATION工程 + DramaClaw新引擎
意象 火把、观测缝、漆杆、阵型
冲突 从做视频到做文明——工程升级