codebee 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -4,6 +4,21 @@ CodeBee 的用户可感知变更记录。发布新版时：最上面加一节，
 `<!-- relnotes:start -->…<!-- relnotes:end -->` 段（那段会被 `npm view` 的
 README 元数据带回，供老版本在「发现新版本」时展示新版更新内容）。
 
+## v0.1.15（2026-09-19）
+
+- 禅道集成：定时扫描激活 Bug → 自动建修复任务 → 跑完自动合并 + resolve(fixed) + 报告回写 + 群通知（REST v1，SSRF 守卫；设置页「禅道」子页）
+- 扫榜双源聚合：七猫+番茄 Web 版排行榜合并分析，跨平台重合题材单独标记（信号更强）
+- 可分享报告页：运行报告导出为自包含单文件 HTML，发给任何人浏览器直接打开
+- 出站 HTTPS 加固：统一证书校验上下文，修复 macOS python.org 发行版缺 CA 导致的全部外联失败（校验只增不减）
+- 引擎调参卡：设置页可直接调压缩阈值/尾部保留/goal 轮数等引擎参数（schema 驱动，revision CAS 防并发覆盖）
+- 发布浏览器 profile 迁至 ~/.codebee（登录态自动迁移），不再占用仓库目录与拖慢扫描
+- 连载发布真机校准续：番茄编辑器结构校准、发章导航超时放宽、真实鼠标事件提交（合成点击被平台检测）
+
+## v0.1.14（2026-09-19）
+
+- 新任务类型「扫榜选材」：抓取七猫排行榜公开数据，AI 提炼热门题材 Top3/高频人设套路/差异化切入建议，直出选题洞察报告
+- 运行结果群推送：设置群机器人 webhook（钉钉/飞书/企微自动适配），任务跑完自动汇报状态与评分
+
 ## v0.1.13（2026-09-19）
 
 - 封面图生成：连载任务建书面板新增「生成封面」——调编排者供应商图像 API（cogview 候选，竖版优先）产出 cover.png 到运行目录，SSRF 边界校验 + curl 子进程落盘（Python 不经手图像字节）

package/README.md

@@ -21,14 +21,14 @@ Kimi Code、MiMo Code、Grok Build、Pi、DeepSeek Harness……），提供
 不会把你的任务内容交给任何第三方。
 
 <!-- relnotes:start -->
-### 最新版更新内容（v0.1.11）
-
-- **连载发布闭环**：番茄/七猫作家后台一键发布——连接扫码后自动建书/发章（默认填好表单人工确认提交），出版台面板+发布台账+每日上限/连续失败暂停护栏
-- **定时自动发布**：任务到点自动批量发章，直发模式需流程校准文件解锁
-- 代码任务 Best-of-N 赛马兜底；goal 模糊时先问 1-3 个澄清问题再开跑
-- 任务队列自愈（看门狗+排队回填）；同因连撞不再重复退避付费，退避期明示「将于 HH:MM 自动续跑」
-- 运行前自动同步 CLI 配置：绑定换供应商后不再撞上旧配置空跑
-- 评审新增「AI 味」参考线；任务留 .codebee/spec.md 规格档案；报告区空态可见
+### 最新版更新内容（v0.1.15）
+
+- **禅道集成**：定时扫描激活 Bug → 自动建修复任务 → 跑完自动合并 + resolve + 报告回写 + 群通知
+- **扫榜选材（双源）**：七猫+番茄排行榜抓取聚合，AI 提炼热门题材/人设套路/差异化切入，跨平台重合题材单独标记
+- **可分享报告页**：运行报告一键导出自包含单文件 HTML
+- **引擎调参卡**：设置页直接调压缩阈值/goal 轮数等引擎参数（防并发覆盖）
+- 出站 HTTPS 证书校验加固（修复部分 Mac 上的全外联失败）；发布浏览器 profile 迁出仓库目录
+- 群推送（钉钉/飞书/企微自动适配）与「扫榜选材」任务类型见 v0.1.14
 <!-- relnotes:end -->
 
 ---
@@ -136,6 +136,40 @@ codebee
 数据存放在用户目录（Windows `%APPDATA%\CodeBee`，macOS/Linux `~/.codebee`），
 升级/重装不影响；老版本 Tutti 目录（`%APPDATA%\Tutti`）会被自动沿用，无需迁移。
 
+### macOS：npm 全局安装报 EACCES（permission denied）
+
+官方 pkg 安装的 Node，全局目录 `/usr/local/lib/node_modules` 归 root，直接
+`npm install -g codebee` 会报
+`EACCES: permission denied, mkdir '/usr/local/lib/node_modules/codebee'`。
+**不要用 sudo 装**：装完目录归 root，应用内「一键升级」（以普通用户跑
+`npm install -g codebee@latest`）之后每次都会撞同样的权限错误。
+正确做法是把 npm 全局目录改到用户目录下，一次配好、安装与自动升级都畅通：
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix "~/.npm-global"
+echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+npm install -g codebee
+```
+
+默认 shell 是 bash 的话，把第 3 行的 `~/.zshrc` 换成 `~/.bash_profile`。
+用 Homebrew 装的 Node（prefix 在 `/opt/homebrew`）没有这个问题，可直接安装。
+验证 `which codebee` 指向 `~/.npm-global/bin/codebee` 即配置成功。
+
+### macOS：HTTPS 请求报 SSL 证书错误（CERTIFICATE_VERIFY_FAILED）
+
+python.org 安装的 Python 不读 macOS 系统钥匙串，本机又没有可用的 CA 束时，
+「获取模型列表 / 适配测试 / 插件市场」等所有 HTTPS 检测会报
+`certificate verify failed: unable to get local issuer certificate`。
+CodeBee 已内置兜底：出站请求自动加载 certifi 与 macOS 系统证书束
+（`/etc/ssl/cert.pem`），多数机器无需任何操作。若仍报错，补齐证书后重试：
+
+```bash
+python3 -m pip install --upgrade certifi   # CodeBee 自动采用，装完即生效
+# 或：Finder → 应用程序 → Python 3.x → 双击 Install Certificates.command
+```
+
 **方式二：源码运行（开发者）**
 
 ```bat

package/app/core/automation.py

@@ -387,6 +387,13 @@ def _tick():
             log.info("automation: 定时发布触发 %d 个任务", n)
     except Exception:
         log.debug("automation: 定时发布检查跳过", exc_info=True)
+    # 禅道 Bug 扫描联动：fire_due 内部自节流（未启用/没到点零开销），
+    # 对账回写也在同一入口，这里只当调度宿主（同定时发布模式）。
+    try:
+        from . import zentao as _zentao
+        _zentao.fire_due()
+    except Exception:
+        log.debug("automation: 禅道扫描跳过", exc_info=True)
 
 
 def _loop():

package/app/core/catalog.py

@@ -248,7 +248,7 @@ def npm_pkg_name(cmd):
 
 
 def derive_uninstall(cmd):
-    """从安装命令推导卸载命令（npm / winget / pip 三种本机渠道）。
+    """从安装命令推导卸载命令（npm / winget / pip / uv / brew 本机渠道）。
 
     卸载命令不单独维护一份，避免与安装命令不同步；认不出渠道返回 None，
     此时条目可显式配置 uninstall 字段覆盖。
@@ -275,6 +275,14 @@ def derive_uninstall(cmd):
         pkgs = [t for t in m.group(1).split() if not t.startswith("-")]
         if pkgs:
             return "uv tool uninstall %s" % pkgs[-1]
+    m = re.search(r"brew\s+install\b(.*)$", c)
+    if m:
+        # brew uninstall 按名字自动识别 formula/cask，--cask 这类 flag 丢了也
+        # 能卸对（Mac 渠道，AI 修复白名单已放行 brew install，编辑安装命令
+        # 也会填这种形态）
+        pkgs = [t for t in m.group(1).split() if not t.startswith("-")]
+        if pkgs:
+            return "brew uninstall %s" % pkgs[0]
     return None
 
 

package/app/core/env_scrub.py

@@ -16,9 +16,10 @@ _DENY_RE = re.compile(r"(KEY|SECRET|TOKEN|PASSWORD|PASSWD|CREDENTIAL)", re.IGNOR
 
 # 白名单：精确匹配（不分大小写），用于覆盖黑名单。
 _ALLOW_EXACT = frozenset({
-    # 系统/环境
-    "PATH", "PATHEXT", "SYSTEMROOT", "TEMP", "TMP", "USERPROFILE", "USERDNSDOMAIN",
-    "HOMEPATH", "HOMEDRIVE",
+    # 系统/环境（TEMP/TMP/PATHEXT 等是 Windows 名，TMPDIR 是 macOS 每用户
+    # 临时目录——三边各留各的，多出的名字在别的平台上不存在、无副作用）
+    "PATH", "PATHEXT", "SYSTEMROOT", "TEMP", "TMP", "TMPDIR",
+    "USERPROFILE", "USERDNSDOMAIN", "HOMEPATH", "HOMEDRIVE",
     "LANG", "LC_ALL", "LC_CTYPE",
     "HOME", "SHELL", "TERM", "PYTHONIOENCODING",
     "PYTHONPATH", "PYTHONUNBUFFERED",
@@ -38,6 +39,7 @@ _ALLOW_PREFIX = (
     "TUTTI_", "ALLINONE_", "DSH_",
     "LANG", "LC_",  # locale 系列
     "PYTHON",       # PYTHONPATH / PYTHONIOENCODING 等
+    "XDG_",         # XDG_CONFIG_HOME 等（macOS/Linux CLI 认它找配置/缓存落点）
     "CHROME", "EDGE", "PLAYWRIGHT",  # 本机测试工具
 )
 

package/app/core/flows.py

@@ -74,6 +74,9 @@ BUILTIN_FLOWS = [
      "threshold": 7.0, "rounds": 2,
      "goal_hint": "翻译什么（源文本位置 / 目标语言 / 要求）",
      "note": "起草 → 多维评审 → 修订循环 → 发布门禁"},
+    {"id": "rank_scan", "name": "扫榜选材", "icon": "i-chart", "engine": "direct", "builtin": True,
+     "goal_hint": "想写哪个方向（一句话，可留空默认分析总榜热门题材）",
+     "note": "抓取七猫排行榜公开数据 → AI 提炼热门题材/人设/差异化切入点（快档直出报告）"},
     {"id": "research", "name": "调研报告", "icon": "i-file-search", "engine": "review", "builtin": True,
      "manuscript": "report.md",
      "rubric": ["全面性", "深度", "论据可靠", "可读性", "结论质量"],

package/app/core/goal_service.py

@@ -86,9 +86,18 @@ def get(goal_id: str):
         return dict(g) if g else None
 
 
-def create(title: str, description: str = "", *, rounds_max: int = 5,
+def create(title: str, description: str = "", *, rounds_max: int | None = None,
            metadata: dict | None = None) -> dict:
-    """创建新 goal。已有未完结 goal 时拒绝（单一当前目标，仿 dsh）。"""
+    """创建新 goal。已有未完结 goal 时拒绝（单一当前目标，仿 dsh）。
+
+    rounds_max 缺省读 settings_v2 orchestrator.max_goal_rounds（读不到回落 5）。"""
+    if rounds_max is None:
+        try:
+            from .settings_schema import get as ss_get, register_default_namespaces
+            register_default_namespaces()
+            rounds_max = int(ss_get("orchestrator", "max_goal_rounds") or 5)
+        except Exception:
+            rounds_max = 5
     with _LOCK:
         cur = current()
         if cur is not None:

package/app/core/jobs.py

@@ -5,11 +5,13 @@
 隔离，store 层有全局锁。目标并发数可在设置页调整；调小后多余线程在取到
 新任务前自行退出，调大即时补齐。安装/升级失败时自动触发 AI 诊断修复：
 由真实智能体读取失败日志与本机环境给出修正命令；仅当命令命中白名单前缀
-（npm/winget/pip 安装类）才自动执行，否则把建议命令记录在运行记录里等人工确认。
+（npm/winget/brew/pip 安装类，按平台取对应渠道）才自动执行，否则把建议命令
+记录在运行记录里等人工确认。
 """
 from __future__ import annotations
 
 import queue
+import sys
 import threading
 import traceback
 
@@ -27,10 +29,11 @@ WATCHDOG_INTERVAL_S = 60   # 队列看门狗巡检周期
 WATCHDOG_STALE_S = 120     # queued 超过该秒数视为掉队（正常入队到被拿起 ≤5s）
 _watchdog_started = False
 
-AI_REPAIR_PROMPT = """你是环境工程师。在 Windows 上执行下面的安装命令失败了，请诊断原因并给出修正命令。
+AI_REPAIR_PROMPT = """你是环境工程师。在 __OS__ 上执行下面的安装命令失败了，请诊断原因并给出修正命令。
 只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {"diagnosis": "失败原因（一句话）", "command": "修正后的完整安装命令", "safe": true/false}
-硬性约束：command 只能是本机包管理器的安装命令，前缀必须是 __ALLOW__ 之一。
+硬性约束：command 只能是本机包管理器的安装命令，前缀必须是 __ALLOW__ 之一，且不要带 sudo
+（命令非交互执行，sudo 会挂死；brew/npm 本身也拒绝 sudo）。
 给不出符合约束的安全命令时，safe 设为 false 且 command 留空。
 
 ## 失败的命令
@@ -43,14 +46,29 @@ __LOG__
 __ENV__"""
 
 # AI 修复命令白名单：只放行包管理器的安装类命令（提示词里的前缀清单由它生成，
-# 两处永远不会漂移）
-AI_REPAIR_ALLOW = ("npm install ", "winget install", "py -3.13 -m pip install",
-                   "uv tool install")
+# 两处永远不会漂移）。按平台分组：winget/py 启动器是 Windows 独有，brew/python3
+# 是 macOS/Linux 渠道——Mac 上不放行 brew 的话，AI 给出正确的修正命令也会被拒。
+_AI_REPAIR_ALLOW_WIN = ("npm install ", "winget install", "py -3.13 -m pip install",
+                        "uv tool install")
+_AI_REPAIR_ALLOW_UNIX = ("npm install ", "brew install", "python3 -m pip install",
+                         "uv tool install")
+AI_REPAIR_ALLOW = _AI_REPAIR_ALLOW_WIN  # 兼容旧引用：Windows 本机即此表
 
 
-def _repair_command_allowed(cmd):
+def _repair_os_label(platform=None):
+    return {"win32": "Windows", "darwin": "macOS"}.get(platform or sys.platform, "Linux")
+
+
+def _repair_allow(platform=None):
+    if (platform or sys.platform) == "win32":
+        return _AI_REPAIR_ALLOW_WIN
+    return _AI_REPAIR_ALLOW_UNIX
+
+
+def _repair_command_allowed(cmd, platform=None):
     cmd = (cmd or "").strip()
-    return cmd.startswith(AI_REPAIR_ALLOW) and "|" not in cmd and "&" not in cmd and ">" not in cmd
+    return (cmd.startswith(_repair_allow(platform)) and "|" not in cmd
+            and "&" not in cmd and ">" not in cmd)
 
 
 def configure(max_workers):
@@ -449,6 +467,11 @@ def _worker():
                         _maybe_auto_resume(run_id)   # 连载失败自动续跑（继承已完成章）
                     except Exception:
                         pass
+                    try:
+                        from . import notify
+                        notify.push_run_async(run_id)   # 结果推群（借鉴 agency-orchestrator --notify）
+                    except Exception:
+                        pass
                 _QUEUE.task_done()
     finally:
         with _pool_lock:
@@ -587,17 +610,21 @@ def _ai_repair(run_id, entry, ev, failed_cmd, orig_log):
     except Exception:
         log_tail = "（日志不可读）"
     import shutil
+    is_win = sys.platform == "win32"
     env_lines = [
-        "OS: Windows",
+        "OS: %s" % _repair_os_label(),
         "node: %s" % (shutil.which("node") or "缺失"),
         "npm: %s" % (shutil.which("npm") or "缺失"),
         "pnpm: %s" % (shutil.which("pnpm") or "缺失"),
-        "python: %s" % (shutil.which("python") or "缺失"),
+        "python: %s" % (shutil.which("python3" if not is_win else "python") or "缺失"),
     ]
+    if not is_win:
+        env_lines.append("brew: %s" % (shutil.which("brew") or "缺失"))
     prompt = (AI_REPAIR_PROMPT.replace("__CMD__", failed_cmd or "（未知）")
               .replace("__LOG__", log_tail)
               .replace("__ENV__", "\n".join(env_lines))
-              .replace("__ALLOW__", " / ".join(p.strip() for p in AI_REPAIR_ALLOW)))
+              .replace("__OS__", _repair_os_label())
+              .replace("__ALLOW__", " / ".join(p.strip() for p in _repair_allow())))
     step, log_abs = store.add_step(run_id, "ai-repair", agent["id"], agent.get("label"),
                                    note="自动诊断修复")
     res = runner.run_agent(agent, prompt, readonly=True, timeout=300,

package/app/core/market_remote.py

@@ -36,7 +36,7 @@ import zipfile
 from pathlib import Path
 from urllib.parse import urlparse
 
-from . import market
+from . import market, tlsctx
 
 _LOCK = market._LOCK   # 安装/记账与 market 共用一把锁，避免交叉写 market.json
 
@@ -157,10 +157,13 @@ def _fetch(url, cap=_CAP_MANIFEST):
         return b"".join(chunks)
 
     try:
-        return _read(lambda: urllib.request.urlopen(req, timeout=30))   # 默认 opener：含系统代理
+        return _read(lambda: urllib.request.urlopen(
+            req, timeout=30, context=tlsctx.context()))   # 默认 opener：含系统代理
     except (urllib.error.HTTPError, urllib.error.URLError):
         # 直连重试：ProxyHandler({}) 显式清空代理
-        opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))
+        opener = urllib.request.build_opener(
+            urllib.request.ProxyHandler({}),
+            urllib.request.HTTPSHandler(context=tlsctx.context()))
         return _read(lambda: opener.open(req, timeout=30))
 
 

package/app/core/modelhub.py

@@ -41,7 +41,7 @@ import threading
 import time
 import urllib.request
 
-from . import paths
+from . import paths, tlsctx
 
 
 class _NoRedirect(urllib.request.HTTPRedirectHandler):
@@ -50,6 +50,13 @@ class _NoRedirect(urllib.request.HTTPRedirectHandler):
     def redirect_request(self, req, fp, code, msg, headers, newurl):
         return None
 
+
+def _opener():
+    """出站 opener：禁重定向 + tlsctx 兜底 CA（macOS python.org 版 Python
+    缺系统证书，默认上下文验证必挂——见 tlsctx 模块 docstring）。"""
+    return urllib.request.build_opener(
+        _NoRedirect, urllib.request.HTTPSHandler(context=tlsctx.context()))
+
 _LOCK = threading.RLock()
 _FILE = paths.DATA_DIR / "models.json"
 
@@ -206,11 +213,11 @@ def _fetch_models_http(base_url, api_key, protocol, allow_private=False):
     else:
         urls = std
     last_err = ""
-    opener = urllib.request.build_opener(_NoRedirect)
+    opener = _opener()
     for url in urls:
-        host_info = _validate_host(url, allow_private)
-        if host_info is None:
-            last_err = host_info[1]
+        host, herr = _validate_host(url, allow_private)
+        if host is None:
+            last_err = herr
             continue
         # auto 不知道是哪条 wire，鉴权头也按两种都试（google 那种单独补上）
         hdrs = _auth_header_variants(api_key, protocol)
@@ -237,8 +244,16 @@ def _fetch_models_http(base_url, api_key, protocol, allow_private=False):
                 if names:
                     return names, ""
                 last_err = url + " 返回 200 但未解析到模型"
+            except urllib.error.HTTPError as e:
+                if e.code == 404:
+                    # zcode-plan / open.bigmodel.cn 等 anthropic 形网关没有
+                    # GET /models——404 与密钥无关，模型以导入/手填为准
+                    last_err = (url + " 无模型列表接口（HTTP 404）——"
+                                "模型以导入/手动添加为准，不影响对话调用")
+                else:
+                    last_err = tlsctx.humanize("%s → HTTP %s" % (url, e.code))
             except Exception as e:
-                last_err = "%s → %r" % (url, e)
+                last_err = tlsctx.humanize("%s → %r" % (url, e))
     return None, last_err
 
 
@@ -1512,6 +1527,7 @@ def _src_zcode():
     default_model = str(d.get("model") or "")
     tail = default_model.split("/", 1)[1] if "/" in default_model else default_model
     bad = []
+    nokey = []
     for pid, p in (d.get("provider") or {}).items():
         if not isinstance(p, dict):
             continue
@@ -1523,13 +1539,23 @@ def _src_zcode():
                    "zcode", "zcode:%s" % pid,
                    model=(tail if tail in names else ""), models=names)
         if pr:
+            if not pr.get("api_key"):
+                nokey.append(str(p.get("name") or pid))
             out["providers"].append(pr)
         else:
             bad.append(str(p.get("name") or pid))
+    notes = []
     if bad:
-        out["note"] = "跳过 {0} 个（缺合法 baseURL）：{1}".format(
-            len(bad), "、".join(bad[:4]))
-        out["note_args"] = [len(bad), "、".join(bad[:4])]
+        notes.append("跳过 {0} 个（缺合法 baseURL）：{1}".format(
+            len(bad), "、".join(bad[:4])))
+    if nokey:
+        # ZCode 的 builtin Plan 条目（zcode.z.ai/api/v1/zcode-plan 等）密钥不入
+        # config.json（实测 credentials.json 里的 OAuth token 也不能直接当 API
+        # key 用）——静默导入空密钥条目只会让用户在拉列表/适配测试时一头雾水
+        notes.append("{0} 个未带出密钥——请在「模型接入」页手填：{1}".format(
+            len(nokey), "、".join(nokey[:4])))
+    if notes:
+        out["note"] = "；".join(notes)
     return out
 
 
@@ -2368,18 +2394,18 @@ def _post_json_http(url, headers, body, allow_private, timeout=20):
     p = urllib.parse.urlsplit(url)
     if p.scheme not in ("http", "https"):
         return 0, None, "协议必须是 http/https"
-    host_info = _validate_host(url, allow_private)
-    if host_info is None:
-        return 0, None, host_info[1]
+    host, herr = _validate_host(url, allow_private)
+    if host is None:
+        return 0, None, herr
     try:
         req = urllib.request.Request(url, method="POST",
                                      headers=dict(headers, **{"Content-Type": "application/json"}),
                                      data=json.dumps(body).encode("utf-8"))
-        with urllib.request.build_opener(_NoRedirect).open(req, timeout=timeout) as resp:
+        with _opener().open(req, timeout=timeout) as resp:
             raw = resp.read(1024 * 1024)
         return resp.status, json.loads(raw.decode("utf-8", "replace")), ""
     except Exception as e:
-        return 0, None, repr(e)[:300]
+        return 0, None, tlsctx.humanize(repr(e)[:300])
 
 
 def _sse_parse(proto, obj):
@@ -2440,15 +2466,16 @@ def _post_sse_http(url, headers, body, allow_private, timeout, proto, on_delta):
     p = urllib.parse.urlsplit(url)
     if p.scheme not in ("http", "https"):
         return 0, "", None, "协议必须是 http/https"
-    if _validate_host(url, allow_private) is None:
-        return 0, "", None, "目标地址校验未通过"
+    host, herr = _validate_host(url, allow_private)
+    if host is None:
+        return 0, "", None, herr
     parts, usage = [], {}
     resp_status = 0
     try:
         req = urllib.request.Request(url, method="POST",
                                      headers=dict(headers, **{"Content-Type": "application/json"}),
                                      data=json.dumps(body).encode("utf-8"))
-        with urllib.request.build_opener(_NoRedirect).open(req, timeout=timeout) as resp:
+        with _opener().open(req, timeout=timeout) as resp:
             resp_status = resp.status
             if not 200 <= resp.status < 300:
                 raw = resp.read(65536).decode("utf-8", "replace")
@@ -2479,7 +2506,7 @@ def _post_sse_http(url, headers, body, allow_private, timeout, proto, on_delta):
                 if sum(len(s) for s in parts) > 2 * 1024 * 1024:   # 防失控
                     break
     except Exception as e:
-        return 0, "", None, repr(e)[:300]
+        return 0, "", None, tlsctx.humanize(repr(e)[:300])
     text = "".join(parts)
     if not usage.get("total"):
         usage["total"] = usage.get("input", 0) + usage.get("output", 0) + usage.get("cached", 0)

package/app/core/notify.py

@@ -0,0 +1,96 @@
+# -*- coding: utf-8 -*-
+"""运行结果群推送（借鉴 agency-orchestrator 的 --notify）：任务跑完把结果摘要
+推到钉钉/飞书/企业微信群机器人，配合定时自动化就是「AI 团队每天定点交活」。
+
+webhook 一个地址全包——按域名自动适配三种机器人格式（同 agency-orchestrator
+思路）；也接受任意 https 地址（按钉钉 text 形状发，自建 n8n 等自选）。
+推送在后台线程、失败只记日志——通知永远不影响任务本身。
+"""
+from __future__ import annotations
+
+import logging
+
+log = logging.getLogger(__name__)
+
+
+def _payload_for(webhook, text):
+    """按 webhook 域名适配群机器人消息体。返回 None = 无法识别的地址。"""
+    from urllib.parse import urlparse
+    host = (urlparse(webhook).hostname or "").lower()
+    if "dingtalk" in host:
+        return {"msgtype": "text", "text": {"content": text}}
+    if "feishu" in host or "larksuite" in host:
+        return {"msg_type": "text", "content": {"text": text}}
+    if "weixin" in host or "wechat" in host or "work.weixin" in host:
+        return {"msgtype": "text", "text": {"content": text}}
+    if host:
+        return {"msgtype": "text", "text": {"content": text}}   # 未知域名按钉钉形状
+    return None
+
+
+def _webhook():
+    try:
+        from . import settings
+        return str(settings.load().get("notify_webhook") or "").strip()
+    except Exception:
+        return ""
+
+
+def _post(hook, text):
+    """curl 子进程 POST（Python 不经手响应体）；网络失败只记日志。"""
+    from . import runner
+    import json as _json
+    body = _json.dumps(_payload_for(hook, text), ensure_ascii=False)
+    r = runner.run_process(
+        argv=["curl", "-sS", "--max-time", "20",
+              "-H", "Content-Type: application/json",
+              "-d", body, hook],
+        timeout=30)
+    return bool(r["ok"])
+
+
+def push_text(text):
+    """推一条文本到群。配置了 webhook 才推；失败返回 False 不抛错。"""
+    hook = _webhook()
+    if not hook:
+        return False
+    if not hook.startswith("https://"):
+        log.warning("notify webhook 必须是 https")
+        return False
+    try:
+        return _post(hook, text)
+    except Exception as e:
+        log.warning("notify push failed: %s", e)
+        return False
+
+
+def push_run_async(run_id):
+    """任务收尾后异步推送结果摘要（jobs 层调用；绝不阻塞/影响任务）。"""
+    threading.Thread(target=push_run, daemon=True,
+                     name="notify-%s" % run_id, args=(run_id,)).start()
+
+
+def push_run(run_id):
+    """组装 run 结果摘要并推送（webhook 未配置时静默跳过）。"""
+    hook = _webhook()
+    if not hook:
+        return False
+    from . import store
+    run = store.get_run(run_id) or {}
+    if not run:
+        return False
+    status = str(run.get("status") or "")
+    mark = {"done": "✅", "failed": "❌", "cancelled": "⚪"}.get(status, "🔔")
+    lines = ["%s CodeBee 任务%s" % (mark, {"done": "完成", "failed": "失败",
+                                           "cancelled": "已取消"}.get(status, status))]
+    lines.append("任务：%s" % (run.get("title") or run_id))
+    if run.get("error"):
+        lines.append("错误：%s" % str(run["error"])[:200])
+    v = run.get("verdict") or {}
+    if v.get("overall") is not None:
+        lines.append("综合评分 %.1f（%s）" % (
+            float(v["overall"]), "达标" if v.get("publishable") else "未达标"))
+    return push_text("\n".join(lines))
+
+
+import threading  # noqa: E402  （push_run_async 依赖；置底避免顶部循环导入）

package/app/core/paihang.py

@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+"""扫榜选材：抓取公开排行榜页，产出选题分析素材。
+
+数据源（双源聚合，任一失败不影响另一源）：
+- 七猫：www.qimao.com/paihang/（公开可抓，2026-09-19 实测 200/106KB）
+- 番茄 Web 版：fanqienovel.com/rank（公开可抓，题材分类+书名在
+  中文 a 标签里；App 端接口有 SecuritySign/X-Argus 签名——那才是难路，
+  Web 版榜单页不需要签名，别走弯路）
+
+下载走 curl 子进程（与 covergen 同款），解析用宽松正则——页面结构变了
+宁可返回空（调用方回落普通直连提示词），不做脆弱的强解析。
+"""
+from __future__ import annotations
+
+import logging
+import re
+
+log = logging.getLogger(__name__)
+
+QIMAO_RANK_URL = "https://www.qimao.com/paihang/"
+FANQIE_RANK_URL = "https://fanqienovel.com/rank"
+_UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+       "(KHTML, like Gecko) Chrome/126 Safari/537.36")
+
+# 页面 UI 噪音词（非书目/分类）
+_NOISE = {"加入书架", "立即阅读", "开始阅读", "免费阅读", "全部", "分类", "排行",
+          "排行榜", "完本", "连载中", "阅读", "书城", "男生", "女生",
+          "帮助中心", "作家助手", "客服", "登录", "注册"}
+
+_CJK_RE = re.compile(r">([\u4e00-\u9fa5]{2,12})<")
+
+
+def _curl_text(url):
+    """curl 子进程抓页面文本；失败返回空串。"""
+    from . import runner
+    try:
+        r = runner.run_process(
+            argv=["curl", "-sS", "--max-time", "20", "-A", _UA, url],
+            timeout=30)
+    except Exception:
+        return ""
+    if not r.get("ok"):
+        return ""
+    return r.get("stdout") or ""
+
+
+def _extract_cjk(html, limit):
+    """从 HTML 提取中文元素材（去 UI 噪音、保序去重）。"""
+    items, seen = [], set()
+    for t in _CJK_RE.findall(html or ""):
+        if t in _NOISE or t in seen:
+            continue
+        seen.add(t)
+        items.append(t)
+        if len(items) >= limit:
+            break
+    return items
+
+
+def fetch_qimao_rank(limit=30):
+    """七猫排行榜：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(QIMAO_RANK_URL), limit)
+
+
+def fetch_fanqie_rank(limit=30):
+    """番茄 Web 版榜单：返回元素列表，抓取失败返回 []。"""
+    return _extract_cjk(_curl_text(FANQIE_RANK_URL), limit)
+
+
+def fetch_rank_items(limit=40):
+    """双源聚合：七猫+番茄各抓一份（去重合并，七猫在前）。
+
+    两源都失败才返回 []——单源挂了另一源仍可用，扫榜永不因单点挡任务。"""
+    qm = fetch_qimao_rank(limit)
+    fq = fetch_fanqie_rank(limit)
+    merged, seen = [], set(qm)
+    for t in fq:
+        if t not in seen:
+            seen.add(t)
+            merged.append(t)
+    return qm + merged
+
+
+def rank_scan_prompt(goal):
+    """组装扫榜选材分析提示词。双源都空返回 None（调用方回落直连提示词）。"""
+    qm = fetch_qimao_rank(30)
+    fq = fetch_fanqie_rank(30)
+    qm = [t for t in qm if t not in fq]   # 双源重合的只留七猫份
+    if not qm and not fq:
+        return None
+    blocks = []
+    if qm:
+        blocks.append("### 七猫排行榜素材\n" + "、".join(qm))
+    if fq:
+        blocks.append("### 番茄排行榜素材\n" + "、".join(fq))
+    material = "\n\n".join(blocks)
+    return (
+        "你是网文选题分析师。以下是刚刚抓取的两个平台排行榜页面的书目与分类素材：\n\n"
+        "## 榜单元素材\n%s\n\n"
+        "## 用户想写的方向\n%s\n\n"
+        "## 你的产出（Markdown 报告）\n"
+        "1. **热门题材 Top3**：各自的共同特征与上榜代表书目（跨平台重合的题材单独点出——双平台都热说明是真风口）\n"
+        "2. **高频人设/套路总结**：3-5 条，点名反复出现的元素\n"
+        "3. **差异化切入建议**：2-3 个，结合用户方向给出「题材+人设」组合与一句话理由\n"
+        "直接输出分析报告，不要复述素材清单，不要输出与报告无关的内容。"
+        % (material, goal or "（用户未指定方向，按大盘热门分析）"))