codebee 0.1.97 → 0.1.99

package/app/core/publish/auto.py

@@ -135,7 +135,9 @@ def pending(task_id, platform):
     """待发章节清单：任务工作目录里的章节文件 − 已发章号，按章号升序。
 
     已发口径连载链合并（含校准所得平台实况），所以任何一个批次任务上发
-    起发布，看到的都是整本书的待发清单。返回 (list, err)；list 项
+    起发布，看到的都是整本书的待发清单。已存草稿的章同样剔除（内容已在
+    平台草稿箱，再跑只会造重复稿；提交发布走平台草稿箱由用户手工完成）。
+    返回 (list, err)；list 项
     {chapter_no, file, size}，file 为工作目录相对路径。章号解析不出的
     文件不进自动发布（防同章多文件误发），API 单章发（manager 直调）
     不受此限。
@@ -154,7 +156,8 @@ def pending(task_id, platform):
             if fs:
                 files = fs           # 任一 run 的成品口径都从任务首跑起，取到即够
                 break
-    done = ledger.published_chapters(task_id, platform)
+    done = ledger.published_chapters(task_id, platform) \
+        | ledger.drafted_chapters(task_id, platform)
     # 分卷标注（2026-10-08 用户需求：待发清单按卷展示）：卷计划解析不出时
     # volume 为空串，前端不分组平铺。
     plan = []
@@ -182,7 +185,12 @@ def pending(task_id, platform):
 
 
 def status(task_id):
-    """前端视图：待发清单 + 护栏状态 + 自动发布进度。"""
+    """前端视图：待发清单 + 护栏状态 + 自动发布进度。
+
+    护栏分两层给前端：guard_ok/guard_reason=完整发布闸（硬护栏+质量闸），
+    管「发布」类按钮；draft_ok/draft_reason=硬护栏（每日上限/连败退避/建书
+    确认），管「存草稿」按钮——草稿不上线，质量闸拦它只会堵死「先落平台
+    再人工把关」的通路；quality_blockers 单独带出去做提示性展示。"""
     from .. import store
     from . import ledger, manager
     ent = ledger.books_for(str(task_id))   # 沿连载链继承：续写批次同书同账
@@ -190,19 +198,25 @@ def status(task_id):
     books = []
     for plat, info in ent.items():
         pend, err = pending(task_id, plat)
-        ok, why = guards(task_id, plat)
+        hard_ok, hard_why = guards(task_id, plat)
         if not _book_ready(info):
-            ok, why = False, "该平台建书结果未确认（缺少作品 ID），请重试创建作品或登记已有作品"
-        elif task:
+            hard_ok, hard_why = False, "该平台建书结果未确认（缺少作品 ID），请重试创建作品或登记已有作品"
+        blockers = []
+        if task and _book_ready(info):
             quality = manager._quality_release_guard(task, plat, action="publish")
             if not quality.get("allowed"):
-                ok, why = False, "质量门禁拦截：%s" % "；".join(
-                    quality.get("blockers") or [])
+                blockers = [str(b) for b in (quality.get("blockers") or [])]
+        ok, why = hard_ok, hard_why
+        if ok and blockers:
+            ok, why = False, "质量门禁拦截：%s" % "；".join(blockers)
         books.append({"platform": plat, "bound": True,
                       "title": info.get("title") or "",
                       "pending": len(pend),
                       "items": pend[:200],
                       "guard_ok": ok, "guard_reason": why,
+                      "draft_ok": hard_ok, "draft_reason": hard_why,
+                      "quality_blockers": blockers,
+                      "drafted": len(ledger.drafted_chapters(task_id, plat)),
                       "calibrated": calibrated(plat)})
     run = _running.get(task_id) or None
     if run:
@@ -236,8 +250,27 @@ def calibrated(platform):
     return (paths.PUBLISH_DIR / ("flows-%s.json" % platform)).is_file()
 
 
+def flow_calibrated(plat, action):
+    """某动作的步骤表是否有真机校准来源（用户校准文件或仓库校准模板里
+    有该动作的表）。内置推测表不算——存草稿虽不上线，批量乱点照样惹
+    风控/攒一箱废稿，无人值守跑之前必须有验证过的步骤表。"""
+    import json as _json
+    from pathlib import Path as _Path
+    from .. import paths as _paths
+    for fp in (_paths.PUBLISH_DIR / ("flows-%s.json" % plat),
+               _Path(__file__).with_name("flows-%s-calibrated.json" % plat)):
+        try:
+            data = _json.loads(fp.read_text(encoding="utf-8"))
+            if isinstance(data, dict) and isinstance(data.get(action), list):
+                return True
+        except Exception:
+            pass
+    return False
+
+
 def publish_pending_async(task_id, platform, auto_submit=False, only=None,
-                          force=False, force_confirmed=False, force_reason=""):
+                          force=False, force_confirmed=False, force_reason="",
+                          as_draft=False):
     """把任务的待发章节按章号顺序发出（后台线程）。返回 (ok, err)。
 
     only=章号清单（批量选择发布）：从待发清单里挑出所选章号，保持章号
@@ -245,12 +278,22 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
     auto_submit=True（直发）逐章提交走完全程；False（人工确认）每轮只填
     **一章**就停在 manual_pause——表单填好后提交权在用户，walker 若直接
     填下一章会导航离开未提交的编辑器，把上一章内容丢掉（平台草稿自动
-    保存不可依赖）。用户在浏览器提交后再次发起即发下一章。"""
+    保存不可依赖）。用户在浏览器提交后再次发起即发下一章。
+    as_draft=True（全部发草稿，2026-10-09）：逐章自动填稿并点「存草稿」，
+    不上线、不受质量闸拦、无需人工确认，一章接一章连跑到清空待发清单
+    （章间仍按 PACE_S 防风控节奏）；提交发布由用户到平台草稿箱手工完成，
+    届时质量闸照常把关。与 auto_submit 互斥（草稿模式忽略 auto_submit）。"""
     from .. import store
     from . import ledger, manager
     if platform not in manager.PLATFORMS:
         return False, "未知平台"
-    if auto_submit and not calibrated(platform):
+    if as_draft:
+        auto_submit = False                # 草稿模式没有「提交」语义
+        if not flow_calibrated(platform, "upload_chapter_draft"):
+            return False, ("存草稿模式需要该平台有 upload_chapter_draft 步骤表"
+                           "（仓库校准模板或 data/publish/flows-%s.json）；"
+                           "未校准不许无人值守批量动表单" % platform)
+    elif auto_submit and not calibrated(platform):
         return False, ("自动提交模式需要先校准该平台发布流程：用「探测」按钮 dump "
                        "表单后把真实步骤写进 data/publish/flows-%s.json（缺省选择器"
                        "只是推测，未校准不许无人值守直发）" % platform)
@@ -271,9 +314,13 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
         return False, "该任务尚未在此平台建书，请先「创建作品」"
     if not _book_ready(book):
         return False, "该平台建书结果未确认（缺少作品 ID），请重试创建作品或登记已有作品"
-    quality = manager._quality_release_guard(
-        task, platform, action="publish", force=force,
-        force_confirmed=force_confirmed, force_reason=force_reason)
+    if as_draft:
+        # 草稿不上线：质量闸不适用（同 manager 口径），硬护栏照查
+        quality = {"allowed": True, "status": "draft_only"}
+    else:
+        quality = manager._quality_release_guard(
+            task, platform, action="publish", force=force,
+            force_confirmed=force_confirmed, force_reason=force_reason)
     if not quality.get("allowed"):
         return False, "质量门禁拦截：%s" % "；".join(quality.get("blockers") or [])
     ok, why = guards(task_id, platform)
@@ -298,7 +345,8 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
     wd = task.get("workdir") or ""
     st = {"platform": platform, "at": time.strftime("%Y-%m-%d %H:%M:%S"),
           "done": 0, "total": len(pend), "status": "running", "error": "",
-          "auto_submit": bool(auto_submit), "last_chapter": 0}
+          "auto_submit": bool(auto_submit), "as_draft": bool(as_draft),
+          "last_chapter": 0}
     with _LOCK:
         _running[task_id] = st
 
@@ -310,7 +358,7 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
                     st["status"] = "error"
                     st["error"] = "第 %d 章前护栏拦截：%s" % (item["chapter_no"], why)
                     return
-                upload_kwargs = {"auto_submit": auto_submit}
+                upload_kwargs = {"auto_submit": auto_submit, "as_draft": as_draft}
                 if force or force_confirmed or force_reason:
                     upload_kwargs.update(force=force,
                                          force_confirmed=force_confirmed,
@@ -324,10 +372,29 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
                     return
                 if not _wait_idle(platform):
                     st["status"] = "error"
-                    st["error"] = ("第 %d 章发布等待超时（%.0f 分钟）；若在等人工提交，"
-                                   "请提交后重跑剩余章节" % (item["chapter_no"],
-                                                             IDLE_TIMEOUT_S / 60))
+                    if as_draft:
+                        st["error"] = ("第 %d 章存草稿等待超时（%.0f 分钟），后续"
+                                       "章节未存" % (item["chapter_no"],
+                                                     IDLE_TIMEOUT_S / 60))
+                    else:
+                        st["error"] = ("第 %d 章发布等待超时（%.0f 分钟）；若在等人工提交，"
+                                       "请提交后重跑剩余章节" % (item["chapter_no"],
+                                                                 IDLE_TIMEOUT_S / 60))
                     return
+                if as_draft:
+                    # manager 走完草稿流程（含平台侧验证）才返回；台账落了
+                    # upload_chapter_draft 才算数，防「流程跑完但平台没存上」。
+                    if item["chapter_no"] not in ledger.drafted_chapters(
+                            task_id, platform):
+                        st["status"] = "error"
+                        st["error"] = ("第 %d 章存草稿未确认，后续章节未存（详见"
+                                       "发布台账与截图存证）" % item["chapter_no"])
+                        return
+                    st["done"] += 1
+                    st["last_chapter"] = item["chapter_no"]
+                    if st["done"] < st["total"]:
+                        time.sleep(PACE_S)
+                    continue
                 if not auto_submit:
                     # The manager stopped before the submit step. There is no
                     # remote success receipt until the user clicks submit.
@@ -348,7 +415,11 @@ def publish_pending_async(task_id, platform, auto_submit=False, only=None,
                 if st["done"] < st["total"]:
                     time.sleep(PACE_S)
             st["status"] = "done"
-            if not auto_submit:
+            if as_draft:
+                st["message"] = ("已存草稿 %d 章（未发布，不受质量闸拦不代表可直发）；"
+                                 "请到平台章节管理/草稿箱逐章检查后提交发布"
+                                 % st["done"])
+            elif not auto_submit:
                 st["message"] = "第 %d 章已填好，请在浏览器里确认提交，再重新校准" % st["last_chapter"]
         except Exception as e:                 # 线程内绝不能悬挂无终态
             st["status"] = "error"

package/app/core/publish/fanqie.py

@@ -110,6 +110,35 @@ UPLOAD_CHAPTER = [
      "optional": True},
 ]
 
+# 发章存草稿（2026-10-09 全部发草稿）：与 UPLOAD_CHAPTER 同一张填表前段，
+# 终点不同——点编辑器头部「存草稿」直接落草稿箱，不走「下一步→内容检测→
+# 发布提示→提交」发布链。草稿不上线，批量连跑无需人工确认；提交发布由
+# 用户到章节管理/草稿箱手工完成。verify 沿用章节管理页断言（草稿行同样
+# 出现在列表里，标题/章号标记可命中）；若平台改版把草稿挪去独立草稿箱页，
+# 首轮失败的 step 截图会指出来，照 flows-fanqie.json 校准即可。
+UPLOAD_CHAPTER_DRAFT = [
+    {"do": "navigate", "url": "{editor_url}"},
+    {"do": "url_any", "any": ["fanqienovel.com"]},
+    {"do": "wait", "sel": "[contenteditable=true],textarea[class*=content],div[class*=editor]", "timeout": 10},
+    {"do": "volume", "key": "volume_name", "optional": True,
+     "open_sel": "input[type=number],input[class*=serial],div[class*=volume]",
+     "modal_sel": "[class*=volume][class*=modal],[class*=modal][class*=volume]",
+     "item_sel": "[class*=volume] li,[class*=volume-item]",
+     "add_sel": "[class*=add-volume],[class*=volume] button",
+     "confirm_sel": "[class*=confirm]", "settle": 1.5},
+    {"do": "fill", "sel": "input[type=number],input[class*=serial],input[class*=byte]", "key": "chapter_no"},
+    {"do": "fill", "sel": "input[placeholder*='章节'],input[placeholder*='标题']", "key": "chapter_name"},
+    {"do": "wait", "sel": "[contenteditable=true],textarea[class*=content],div[class*=editor]", "timeout": 10},
+    {"do": "fill", "sel": "[contenteditable=true],textarea[class*=content]", "key": "chapter_body"},
+    {"do": "shot", "name": "chapter-filled-draft"},
+    {"do": "submit", "text": "存草稿", "scope": "button", "tries": 15},
+    {"do": "js_click", "text": "存草稿", "scope": "button", "tries": 10,
+     "optional": True, "skip_if_modal": True},
+    {"do": "sleep", "s": 2.5},
+    {"do": "verify", "url": "{chapter_manage_url}",
+     "any": ["第{chapter_no}章", "{chapter_name}"], "settle": 6, "new_tab": True},
+]
+
 # 登录态探测：打开后台首页，URL 被踢到登录页 → 未登录
 CHECK_LOGIN = [
     {"do": "navigate", "url": "{home}"},
@@ -125,6 +154,7 @@ PROBE_FORM = [
 ]
 
 FLOWS = {"create_book": CREATE_BOOK, "upload_chapter": UPLOAD_CHAPTER,
+         "upload_chapter_draft": UPLOAD_CHAPTER_DRAFT,
          "check_login": CHECK_LOGIN, "probe_form": PROBE_FORM}
 
 

package/app/core/publish/flows-fanqie-calibrated.json

@@ -1,5 +1,6 @@
 {
  "_note": "番茄真机校准（2026-09-19 定稿，2026-09-24 加固）：编辑器=/main/writer/<book_id>/publish/ 直达（章节号 input.serial-input 纯数字；标题 div.serial-editor-input-hint input ≥5字/30上限；正文 .ProseMirror ≥1000字；「下一步」保存校验后按钮组右缘箭头展开下拉含「定时发布」）。建书=/main/writer/create 直达表单：radio 签约模式/目标读者（label 真实点击）→ 阅读标签 select（y<430）弹层 arco-anchor 切主分类/主题/角色/情节 + 标签云点击 + 确认 → 内容标签 select（y>430）弹层 情感/人设/世界观 同构 → 名称/主角1/主角2/简介 → 立即创建（submit 步骤：auto_submit=false 时填好即停，留给人工提交） → 跳 book-info/<id>。锚点切换渲染慢（0924 三连败）：弹层打开后 settle，锚点 tries=12。0928 再加固（弹层没开连败案）：签约/读者 radio 点击后断言选中态（expect_checked）；两处标签触发器点完 wait .category-modal 存在替代盲 sleep；real_click_text 落点 elementFromPoint 守卫，找不到目标时报错自带定位范围可见项诊断。2026-10-08 发章三修：values 补 chapter_no/chapter_name 键（此前序号框从未被填、被平台以「章节序号只支持阿拉伯数字」打回）；标题位改填 chapter_name（read_chapter 拆掉「第X章」前缀，序号/标题分开填）；verify 标记改「第{chapter_no}章」或「{chapter_name}」任一命中（用户手工改过标题时按名对版必假失败）。。2026-10-08 批量自动发布·自动分卷：upload_chapter 增加 volume 步骤（values.volume_name 由 manager 按工作目录卷计划解析：分卷.json 优先，其次 大纲/series-outline.md 的「## 第X卷：名」+「依次48、56…章」；平台卷弹窗 = .publish-header-volume-name 开 → .editor-volume-list-item 按去前缀名匹配选中，缺卷走 .editor-volume-footer-add-volume 新建→行内 input 输名→i.tomato-confirm 落名→选中→确定；新建卷名会追加进 values._volumes 由 manager 回写 books.json 缓存）。。2026-10-08 晚：平台发布确认 UI 已改——下一步（保存校验）后弹「发布提示」错别字确认框（取消/提交），不再有「定时发布」下拉组；流程撤 click_arrow/定时发布/发布，改点确认框「提交」（optional：无错别字时可能不弹，直接 verify）。。verify 改 new_tab（开新页签验证、编辑器页签不动）：编辑器页签内导航触发 beforeunload 原生确认，渲染挂起+发布请求被取消——直发章全卡死在验证导航上的实案修法。。1008深夜终版：publish链=submit(下一步,gate)→js_click下一步兜底(skip_if_modal)→js_click仅基础检测(检测方式弹窗,tries60)→sleep5→js_click提交(错别字确认,tries75)→verify new_tab；真实鼠标在 headless/后台页签不触发平台处理器，DOM click 可靠。",
+ "upload_chapter_draft": "2026-10-09 全部发草稿：前段（volume/序号/标题/正文填表）与 upload_chapter 同源选择器；终点改点编辑器头部「存草稿」直接落草稿箱，不走下一步/检测/发布提示发布链。verify 沿用章节管理页断言（草稿行同样在列表里）；若平台把草稿挪去独立草稿箱页，首轮失败截图会指出，届时按此校准。「存草稿」按钮文本未真机实证（校准时浏览器离线），首次批量跑请盯首章截图。",
  "check_login": [
   {
    "do": "navigate",
@@ -111,6 +112,86 @@
    "new_tab": true
   }
  ],
+ "upload_chapter_draft": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "{editor_url}"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "fanqienovel.com"
+   ]
+  },
+  {
+   "do": "wait",
+   "sel": ".ProseMirror",
+   "timeout": 20
+  },
+  {
+   "do": "volume",
+   "key": "volume_name",
+   "optional": true,
+   "open_sel": ".publish-header-volume-name",
+   "modal_sel": ".serial-modal.editor-volume",
+   "item_sel": ".editor-volume-list-item",
+   "add_sel": ".editor-volume-footer-add-volume",
+   "input_sel": ".editor-volume-list-item input",
+   "confirm_sel": "i.tomato-confirm",
+   "settle": 1.5
+  },
+  {
+   "do": "fill",
+   "sel": "input.serial-input, input.byte-input",
+   "key": "chapter_no"
+  },
+  {
+   "do": "fill",
+   "sel": "div.serial-editor-input-hint input",
+   "key": "chapter_name"
+  },
+  {
+   "do": "fill",
+   "sel": ".ProseMirror",
+   "key": "chapter_body"
+  },
+  {
+   "do": "shot",
+   "name": "chapter-filled-draft"
+  },
+  {
+   "do": "submit",
+   "text": "存草稿",
+   "scope": "button",
+   "tries": 15
+  },
+  {
+   "do": "js_click",
+   "text": "存草稿",
+   "scope": "button",
+   "tries": 10,
+   "optional": true,
+   "skip_if_modal": true
+  },
+  {
+   "do": "sleep",
+   "s": 2.5
+  },
+  {
+   "do": "verify",
+   "url": "{chapter_manage_url}",
+   "any": [
+    "第{chapter_no}章",
+    "{chapter_name}"
+   ],
+   "settle": 6,
+   "new_tab": true
+  }
+ ],
  "probe_form": [
   {
    "do": "navigate",

package/app/core/publish/flows-qimao-calibrated.json

@@ -1,5 +1,6 @@
 {
  "_note": "七猫真机校准（2026-09-19 凌晨定稿）：建书=book-manage「新建小说」→站点弹层(click_match+确认)→information 表单(fill_label/radio/级联分类/tags 四组各1-3个+确定/主角名平铺/简介)；书名仅允许，：！？中文标点（·被拦）。发章=编辑器填好后「立即发布」落草稿箱（未签约书限制）→草稿行「立即发布」→「更正序号去发布」→「确认发布」三层弹窗→章节待审核。正文下限 1000 字（min_chapter_chars）。book-upload?id=<书id> 直达编辑器。；2026-09-24 加固：二级分类选完 settle 1s 再点「添加标签」（下拉关闭动画吞点击致标签弹层未开、组名切换失败案）；2026-09-24 夜修：平台编辑器「立即发布」变为弹重型确认框（点后页面假死、章节未提交、草稿箱亦空——旧「立即发布落草稿箱」语义过时），改点「存草稿」再走草稿箱三层发布（草稿行立即发布→更正序号→确认发布，22:47 实证成功路径）",
+ "upload_chapter_draft": "2026-10-09 全部发草稿：按 upload_chapter 的「存草稿」段拆出（填标题/正文→click_real 存草稿→draft_url 草稿箱 verify 行在场）。存草稿段是 0924 实证路径的前半段，选择器同源；提交发布（立即发布三层弹窗）留给用户在草稿箱手工完成。",
  "probe_form": [
   {
    "do": "navigate",
@@ -226,6 +227,63 @@
    "settle": 6
   }
  ],
+ "upload_chapter_draft": [
+  {
+   "do": "navigate",
+   "url": "about:blank"
+  },
+  {
+   "do": "navigate",
+   "url": "{editor_url}"
+  },
+  {
+   "do": "url_any",
+   "any": [
+    "qimao.com"
+   ]
+  },
+  {
+   "do": "wait",
+   "sel": "textarea[placeholder*='章节名称']",
+   "timeout": 20
+  },
+  {
+   "do": "fill",
+   "sel": "textarea[placeholder*='章节名称']",
+   "key": "chapter_title"
+  },
+  {
+   "do": "wait",
+   "sel": ".q-contenteditable",
+   "timeout": 12
+  },
+  {
+   "do": "fill",
+   "sel": ".q-contenteditable",
+   "key": "chapter_body"
+  },
+  {
+   "do": "shot",
+   "name": "chapter-filled-draft"
+  },
+  {
+   "do": "click_real",
+   "text": "存草稿",
+   "tries": 25
+  },
+  {
+   "do": "sleep",
+   "s": 2
+  },
+  {
+   "do": "verify",
+   "url": "{draft_url}",
+   "any": [
+    "{chapter_title}"
+   ],
+   "settle": 5
+  }
+ ],
  "check_login": [
   {
    "do": "navigate",

package/app/core/publish/ledger.py

@@ -111,6 +111,28 @@ def published_chapters(task_id, platform):
     return out
 
 
+def drafted_chapters(task_id, platform):
+    """该任务在该平台已成功存草稿的章节号集合（发草稿模式的幂等口径）。
+
+    与 published_chapters 同款连载链合并；不含校准的平台实况（实况口径里
+    没有「草稿」桶，草稿章是否已由用户手工发布以重新校准后的
+    remote_published_nos 为准）。草稿章从待发清单剔除：已在平台存稿的章
+    再跑一遍只会造出重复草稿。"""
+    from .. import store
+    try:
+        ids = set(store.serial_chain_ids(task_id))
+    except Exception:
+        ids = {str(task_id)}
+    out = set()
+    for r in _iter_records(3650):
+        if (r.get("action") == "upload_chapter_draft" and r.get("ok")
+                and r.get("task_id") in ids and r.get("platform") == platform):
+            n = r.get("chapter_no") or 0
+            if n > 0:
+                out.add(int(n))
+    return out
+
+
 def recent(task_id=None, platform=None, limit=50):
     """最近记录（新在前），详情页发布历史用。task_id 给定时按连载链合并。"""
     from .. import store
@@ -338,7 +360,8 @@ def consecutive_failures(platform):
     for r in reversed(list(_iter_records(7))):
         if r.get("platform") != platform:
             continue
-        if r.get("action") not in ("upload_chapter", "create_book"):
+        if r.get("action") not in ("upload_chapter", "create_book",
+                                   "upload_chapter_draft"):
             continue
         t = _rec_time(r)
         if t is None:

package/app/core/publish/manager.py

@@ -872,8 +872,14 @@ def read_chapter(fp):
 
 
 def upload_chapter_async(task_id, plat, chapter_file, auto_submit=False,
-                         force=False, force_confirmed=False, force_reason=""):
-    """把一章发到平台（或填好待人工确认）。幂等：已成功发布的章号拒绝重发。"""
+                         force=False, force_confirmed=False, force_reason="",
+                         as_draft=False):
+    """把一章发到平台（或填好待人工确认/as_draft 只存草稿）。
+
+    幂等：已成功发布**或已存草稿**的章号拒绝重做——重复发会平台上出双章，
+    重复存草稿会攒一箱重复稿。as_draft=True 走「存草稿」流程表
+    （upload_chapter_draft）：内容落平台草稿箱不上线，不构成发布动作，
+    质量闸不拦（发布时照拦）；存稿动作无需人工确认，适合批量连跑。"""
     from .. import store
     if plat not in PLATFORMS:
         return False, "未知平台"
@@ -894,9 +900,14 @@ def upload_chapter_async(task_id, plat, chapter_file, auto_submit=False,
     ch_no, title, body, err = read_chapter(chapter_file)
     if err:
         return False, err
-    quality = _quality_release_guard(
-        task, plat, action="publish", target_chapter=ch_no or None,
-        force=force, force_confirmed=force_confirmed, force_reason=force_reason)
+    if as_draft:
+        # 草稿不上线：质量闸不适用（evaluate_release action=draft 直通），
+        # 人工复核挪到「平台草稿箱 → 用户逐章检查后提交」那一步。
+        quality = {"allowed": True}
+    else:
+        quality = _quality_release_guard(
+            task, plat, action="publish", target_chapter=ch_no or None,
+            force=force, force_confirmed=force_confirmed, force_reason=force_reason)
     if not quality.get("allowed"):
         return False, "质量门禁拦截：%s" % "；".join(quality.get("blockers") or [])
     n_chars = len(body.replace("\n", "").replace(" ", ""))
@@ -912,10 +923,14 @@ def upload_chapter_async(task_id, plat, chapter_file, auto_submit=False,
     done = ledger.published_chapters(task_id, plat)
     if ch_no and ch_no in done:
         return False, "第 %d 章已成功发布过（台账幂等拦截）；确需重发请手工处理" % ch_no
+    if as_draft and ch_no and ch_no in ledger.drafted_chapters(task_id, plat):
+        return False, ("第 %d 章已存过草稿（台账幂等拦截）；请到平台草稿箱检查后"
+                       "提交发布，确需重存请先在平台删旧稿" % ch_no)
     ok_login, why = _login_guard(plat)
     if not ok_login:
         return False, why
-    _set(plat, status="busy", last_action="upload_chapter", error="")
+    flow_key = "upload_chapter_draft" if as_draft else "upload_chapter"
+    _set(plat, status="busy", last_action=flow_key, error="")
 
     mod = PLATFORMS[plat]
     values = chapter_fill_values(ch_no, title, body,
@@ -934,7 +949,7 @@ def upload_chapter_async(task_id, plat, chapter_file, auto_submit=False,
     operation_id = operations.begin(
         "publish:%s:upload_chapter" % plat,
         {"task_id": task_id, "chapter_no": ch_no, "title": title}, task_id=task_id,
-        metadata={"platform": plat, "action": "upload_chapter"})
+        metadata={"platform": plat, "action": flow_key})
 
     def run():
         try:
@@ -948,14 +963,26 @@ def upload_chapter_async(task_id, plat, chapter_file, auto_submit=False,
             elif not book_ref.get("book_id"):
                 raise RuntimeError("未按作品名找到远端作品，未打开章节编辑器；"
                                    "请检查平台作品名或补填作品 ID")
-            flow.run_flow(page, load_flow(plat, "upload_chapter"), values=values,
+            flow.run_flow(page, load_flow(plat, flow_key), values=values,
                           config=mod.CONFIG, auto_submit=auto_submit,
                           shot=lambda n: page.screenshot(ledger.shot_path(plat, task_id, n)),
                           log=logs.append)
             new_vols = values.get("_volumes")
             if isinstance(new_vols, list) and new_vols != (book_ref.get("volumes") or []):
                 ledger.update_book(task_id, plat, volumes=new_vols)
-            if auto_submit:
+            if as_draft:
+                # 草稿已落平台草稿箱（流程含验证步，走到这=验证过）。发布确认权
+                # 仍在用户：到平台草稿箱逐章检查后手工提交，质量闸在「发布」时
+                # 照常把关。
+                operations.confirm(operation_id, metadata={"platform": plat,
+                                                           "action": "upload_chapter_draft",
+                                                           "chapter_no": ch_no})
+                ledger.record(plat, "upload_chapter_draft", task_id=task_id,
+                              chapter_no=ch_no, book_id=book_ref.get("book_id") or "",
+                              title=title, ok=True, operation_id=operation_id,
+                              operation_status="confirmed",
+                              remote_receipt="platform-draft")
+            elif auto_submit:
                 operations.confirm(operation_id, metadata={"platform": plat,
                                                             "action": "upload_chapter",
                                                             "chapter_no": ch_no})

package/app/core/publish/qimao.py

@@ -60,6 +60,22 @@ UPLOAD_CHAPTER = [
     {"do": "submit", "sel": "button[class*=publish],button[class*=submit]"},
 ]
 
+# 发章存草稿（2026-10-09 全部发草稿）：内置推测表——真机校准表在
+# flows-qimao-calibrated.json（按其 upload_chapter 的「存草稿」段拆出：
+# 填好→存草稿→草稿箱验证行在场即成）。草稿不上线；提交发布由用户在
+# 草稿箱手工点（立即发布→更正序号→确认发布三层弹窗照旧人工走）。
+UPLOAD_CHAPTER_DRAFT = [
+    {"do": "navigate", "url": "{editor_url}"},
+    {"do": "url_any", "any": ["qimao.com"]},
+    {"do": "fill", "sel": "textarea[placeholder*='章节名称']", "key": "chapter_title"},
+    {"do": "wait", "sel": "[contenteditable=true],textarea[class*=content],iframe", "timeout": 10},
+    {"do": "fill", "sel": "[contenteditable=true],textarea[class*=content]", "key": "chapter_body"},
+    {"do": "shot", "name": "chapter-filled-draft"},
+    {"do": "click_real", "text": "存草稿", "tries": 25},
+    {"do": "sleep", "s": 2},
+    {"do": "verify", "url": "{draft_url}", "any": ["{chapter_title}"], "settle": 5},
+]
+
 CHECK_LOGIN = [
     {"do": "navigate", "url": "{home}"},
     {"do": "url_any", "any": ["qimao.com"]},
@@ -73,6 +89,7 @@ PROBE_FORM = [
 ]
 
 FLOWS = {"create_book": CREATE_BOOK, "upload_chapter": UPLOAD_CHAPTER,
+         "upload_chapter_draft": UPLOAD_CHAPTER_DRAFT,
          "check_login": CHECK_LOGIN, "probe_form": PROBE_FORM}
 
 

package/app/core/quality_gate.py

@@ -127,6 +127,13 @@ def evaluate_release(verdict, action="publish", target_chapter=None,
     if action == "continue":
         return {"allowed": True, "status": "continue_only", "forced": False,
                 "blockers": [], "warnings": []}
+    if action == "draft":
+        # 存草稿不是发布：内容不公开展示（读者不可见），正式提交前用户还会
+        # 在平台上逐章过目——质量闸只在「发布/签约」这类上线动作上拦，
+        # 拦草稿只会把「先落平台再人工把关」的通路堵死（2026-10-09 全部
+        # 发草稿需求：质量未达标的 53 章先存草稿，发布仍受本闸约束）。
+        return {"allowed": True, "status": "draft_only", "forced": False,
+                "blockers": [], "warnings": []}
 
     blockers = []
     warnings = []

package/app/core/runner.py

@@ -73,18 +73,27 @@ _CLI_EXTS = (".exe", ".cmd", ".bat")
 
 
 def _fallback_probe_cli(name):
-    """which() 落空时按常见安装位兜底找 CLI（Windows only），返回全路径或 None。
+    """which() 落空时按常见安装位兜底找 CLI，返回全路径或 None。
 
     服务进程的 PATH 是启动那一刻的快照：CLI 在服务起跑之后才安装/迁移（如
     2026-09-30 claude 转 winget 原生安装）时，快照里没有新目录，which 解析
     不到、裸名直传 Popen 直接 FileNotFoundError，直到重启服务才自愈。这里
     只探测磁盘已知落点，不改 PATH、不缓存（装没装是低频事件，探几次不亏）。
-    """
-    if os.name != "nt":
-        return None
+    Mac 同病：curl 脚本装的 uv/aider 落 ~/.local/bin，GUI 启动的服务常吃不到
+    这条 PATH；brew 在 Apple Silicon 落 /opt/homebrew/bin。"""
     name = str(name)
     if not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]*", name):
         return None   # 带斜杠/参数形态的不是裸命令名，交给原路径逻辑
+    if os.name != "nt":
+        for d in (os.path.join(os.path.expanduser("~"), ".local", "bin"),
+                  "/opt/homebrew/bin", "/usr/local/bin"):
+            p = os.path.join(d, name)
+            try:
+                if os.path.isfile(p) and os.access(p, os.X_OK):
+                    return p
+            except OSError:
+                pass
+        return None
     local = os.environ.get("LOCALAPPDATA") or ""
     home = os.path.expanduser("~")
     appdata = os.environ.get("APPDATA") or os.path.join(home, "AppData", "Roaming")

package/app/main.py

@@ -2263,7 +2263,9 @@ class Handler(BaseHTTPRequestHandler):
         """批量发布全部待发章节（publish/auto.py）。
 
         护栏（每日上限/连败退避/幂等/单飞）在 auto 层，每章发起前复查；
-        auto_submit 默认 false——每章表单填好后停，提交权留给用户。"""
+        auto_submit 默认 false——每章表单填好后停，提交权留给用户。
+        as_draft=true 走「全部发草稿」：逐章存草稿不上线、不受质量闸拦、
+        无需人工确认连跑到清空（2026-10-09）；草稿与直发互斥，草稿优先。"""
         from core import store
         from core.publish import auto as pub_auto
         if not store.get_task(task_id):
@@ -2276,7 +2278,8 @@ class Handler(BaseHTTPRequestHandler):
         force_confirmed = bool(body.get("force_confirmed"))
         force_reason = str(body.get("force_reason") or "").strip()
         only = body.get("chapters")            # 批量选择发布：章号数组（可省=全部待发）
-        kwargs = {"only": only if isinstance(only, list) else None}
+        kwargs = {"only": only if isinstance(only, list) else None,
+                  "as_draft": bool(body.get("as_draft"))}
         if force or force_confirmed or force_reason:
             kwargs.update(force=force, force_confirmed=force_confirmed,
                           force_reason=force_reason)