codebee 0.1.95 → 0.1.97

package/app/core/planner.py

@@ -250,21 +250,25 @@ __GOAL__
 ## 背景与上下文
 __CONTEXT__"""
 
-SERIAL_OUTLINE_PROMPT = """你是网文主编，熟悉签约平台（番茄/七猫/起点）的过稿标准。
+SERIAL_OUTLINE_PROMPT = """你是小说结构编辑。你不代表番茄、七猫或其他平台，也不能预测签约或流量结果。
 
 __SKILLS__
 请为下面的小说目标设计一份连载大纲：共 __N__ 章，每章约 __W__ 字。
 只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {"book_title": "书名", "style_anchor": "全书文风锚（80字内，具体可执行：叙述视角与人称、句长基调、语域、对白风格、禁用表达）", "chapters": [{"title": "章节标题", "beats": "本章剧情要点（50-120字：事件/冲突/推进）", "hook": "章末钩子（一句话）", "highlight": "本章爽点/情绪爆点（一句话：谁在哪里完成什么反转或释放什么情绪）"}]__VOLUMES_KEY__}
+字段说明：hook 可为自然收束、留白或继续阅读理由，不强制悬念；highlight 表示主要戏剧/情绪变化或回报，无显著爆点时说明叙事功能，不要强造爆点。
 硬性要求：
 - book_title 4-15 字，必须考虑平台书名全站唯一（撞名建不了书）：避开「我的XX藏不住」
   「开局XX」等高频套路组合，书名里带本书独有的专名（人名/金手指/设定词），独有专名越多越不易撞名；
-- 第 1-3 章是黄金三章：第 1 章前 100 字出现主角、前 200 字出现异常或欲望、前 600 字进入具体困境，
-  第 3 章末留大钩子；不要用世界观或环境描写拖延切入；
-- 每章都写清“主角主动选择 → 阻碍 → 局面变化 → 章末钩子”，禁止水字数的日常流水账和硬旁白推剧情；
+- 把开篇字数位置当阅读观察点而非硬门槛：尽早让读者辨认视角人物、故事承诺和正在发生的事，
+  但按题材、叙述策略与实际效果决定节奏，不为数字机械塞冲突；
+- 每章要有清楚的叙事功能（推进事件、人物/关系、信息、氛围或情绪之一或多项），并检查因果与局面变化；
+  不强制每章都打脸、反转或以悬念断章；
+- 章末可自然收束或留白；大纲中的 highlight 描述主要戏剧/情绪变化或回报，无显著爆点时写清叙事功能，不要强造爆点。
 - 大纲中的情感转折必须给出触发事件和人物选择，不能只写“误会加深/感情升温”；
 - style_anchor 是全书唯一的文风锚，每章起草/修订/评审都会注入：必须写明视角人称与句长基调等可执行约束，不要空话；
-- 每章必须给出 highlight（爽点/情绪爆点）：没有爆点的章节要重新设计，过渡章也要有小冲突小反转；
+- highlight 是本章主要情绪/戏剧变化或读者回报，可为爽、暖、痛、惊、趣味、亲密、发现、安定等；
+  平静或过渡章节可承担必要功能，不为填字段伪造高潮；
 - 结局必须闭环（完本感），主角有成长弧光；
 - 题材健康，无违规内容，符合平台签约调性。
 __VOLUMES__
@@ -286,7 +290,7 @@ __SKILLS__
 - 主线沿既有脉络推进，新冲突尽量从已埋伏笔中生长，人物性格与前文一致；
 - 若下方给出「锁定章纲」：本批各章 title/beats/hook 必须逐章从对应章纲提炼对齐
   （标题沿用、视角不换、节拍不裁并、伏笔揭示位不提前），不得虚构章纲之外的主线事件；
-- 每章都写清“主角主动选择 → 阻碍 → 局面变化 → 章末钩子”，禁止水字数的日常流水账；
+- 在关键章节写清人物选择、阻碍与后果；不要求每章都有完整冲突闭环或悬念钩子，避免无功能重复；
 - 复杂情感必须落到触发事件、动作/生理反应和潜台词，不能用一句概括代替；
 - 延续既定叙述视角和语言锚点（见下方既定文风锚），删掉重复复述，避免节奏变慢；
 - 题材健康，无违规内容，符合平台签约调性。
@@ -749,15 +753,17 @@ def make_serial_outline(task, author_agent=None, workdir=None, ev=None, log_path
 
 # 开篇重设计提示词（开篇闸门专用）：第 1 章签约评估的开篇吸引力未达线时，
 # 回大纲层重设计前三章节拍而不是只修稿——切入点不行是结构病，修文案救不了。
-SERIAL_OPENING_REBUILD_PROMPT = """你是网文主编，熟悉签约平台（番茄/七猫/起点）的过稿标准。
-这本书的第 1 章在签约预评估中「开篇吸引力」未达线，评审意见如下：
+SERIAL_OPENING_REBUILD_PROMPT = """你是小说结构编辑，不代表任何平台，也不能预测签约结果。
+这本书的开篇评审发现吸引力风险，实际意见如下：
 __CRITIQUE__
 
-请重设计前 __COUNT__ 章的大纲节拍（只动这 __COUNT__ 章，不碰后续章节），让开篇符合黄金一章标准：
-第 1 章前 100 字出现主角、前 200 字出现异常或冲突、前 600 字进入具体困境、章末留可兑现的钩子；
-切入点必须是具体事件（退婚/陷害/背叛/生死危机等），禁止世界观铺垫开局。
+请重设计前 __COUNT__ 章的大纲节拍（只动这 __COUNT__ 章，不碰后续章节），针对反馈解决具体问题。
+先保留原稿有效之处，再提出能改变事件、人物选择或后果的改动；不能只换词、加怪声或添加钩子。
+前 100/200/600 字只是阅读观察点，不是硬指标；不预设危机、金手指、背叛或打脸。
+判断开篇是否成立，要看题材承诺是否兑现、事件是否具体、读者能否理解人物处境和下一步，尊重本稿叙述方式。
 只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
 {"chapters": [{"title": "章节标题", "beats": "本章剧情要点（50-120字：事件/冲突/推进）", "hook": "章末钩子（一句话）", "highlight": "本章爽点/情绪爆点（一句话）"}]}
+其中 hook 可为自然收束、留白或继续阅读理由，不强制悬念；highlight 无显著爆点时说明叙事功能，不要强造爆点。
 章序与原大纲一致（从第 1 章起），必须保持书名、主角与核心设定不变，只强化切入与钩子设计。
 
 ## 全书目标

package/app/core/policy.py

@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+"""Execution policy primitives shared by tools and runners."""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+
+def normalize_sandbox(spec=None, workdir=None):
+    spec = spec if isinstance(spec, dict) else {}
+    root = Path(workdir or os.getcwd()).expanduser().resolve()
+    roots = []
+    requested_roots = spec.get("allowed_roots")
+    if requested_roots is not None and not isinstance(requested_roots, (list, tuple)):
+        raise ValueError("allowed_roots 必须是路径列表")
+    explicit_roots = bool(requested_roots)
+    for value in requested_roots or [str(root)]:
+        try:
+            candidate = Path(value).expanduser().resolve()
+        except (TypeError, OSError, ValueError):
+            continue
+        # The task payload is not an authority to grant host filesystem access.
+        # Sandbox roots may narrow the selected workspace, never widen it.
+        if candidate != root and root not in candidate.parents:
+            continue
+        if candidate not in roots:
+            roots.append(candidate)
+    if not roots:
+        if explicit_roots:
+            raise ValueError("allowed_roots 没有工作目录内的有效路径")
+        roots = [root]
+    env = []
+    for value in spec.get("env_allowlist") or []:
+        name = str(value or "").strip()
+        if name and name.replace("_", "a").isalnum() and name not in env:
+            env.append(name)
+    try:
+        timeout = max(1, min(7 * 24 * 3600, int(spec.get("timeout_s") or 3600)))
+    except (TypeError, ValueError):
+        timeout = 3600
+    try:
+        output = max(1024, min(100 * 1024 * 1024, int(spec.get("max_output_bytes") or 10 * 1024 * 1024)))
+    except (TypeError, ValueError):
+        output = 10 * 1024 * 1024
+    network_value = spec.get("network", True)
+    if isinstance(network_value, bool):
+        network = network_value
+    elif isinstance(network_value, str) and network_value.strip().lower() in ("true", "false"):
+        network = network_value.strip().lower() == "true"
+    else:
+        # Invalid policy input must never silently widen network access.
+        network = False
+    return {"allowed_roots": [str(x) for x in roots], "env_allowlist": env,
+            "network": network, "timeout_s": timeout,
+            "max_output_bytes": output,
+            "disabled_tools": normalize_disabled_tools(spec.get("disabled_tools"))}
+
+
+def normalize_disabled_tools(items):
+    if not isinstance(items, (list, tuple, set)):
+        return []
+    out = []
+    for value in items:
+        name = str(value or "").strip()[:120]
+        if name and name not in out:
+            out.append(name)
+        if len(out) >= 200:
+            break
+    return out
+
+
+def path_allowed(path, sandbox):
+    try:
+        candidate = Path(path).expanduser().resolve()
+        return any(candidate == Path(root) or Path(root) in candidate.parents
+                   for root in (sandbox or {}).get("allowed_roots") or [])
+    except (TypeError, OSError, ValueError):
+        return False
+
+
+def filter_env(env, sandbox):
+    values = env if isinstance(env, dict) else {}
+    allow = (sandbox or {}).get("env_allowlist") or []
+    return {str(k): str(v) for k, v in values.items() if str(k) in allow}

package/app/core/portguard.py

@@ -1,111 +1,111 @@
-# -*- coding: utf-8 -*-
-"""启动端口清场（用户拍板 2026-09-21）：端口被占时先清场再启动。
-
-- **自家旧实例**（命令行含本包 main.py 完整路径，或 npm 包内 app/main.py）
-  → 杀树（TerminateProcess 直杀）——升级/重启最常见的占用者就是没退干净
-  的 CodeBee 自己；控制台进程对温和信号（WM_CLOSE）无反应，温和关不掉
-  正是用户「旧进程太难杀」的痛点，所以自家实例直接强杀。
-- **别人的进程** → 只报告占用者，不发送任何信号；启动流程不得替用户
-  关闭可能正在开发中的服务。
-- 系统/自身进程拒关（portscan 内置护栏）。
-"""
-from __future__ import annotations
-
-import logging
-import os
-import shlex
-import subprocess
-
-from . import portscan, runner
-
-log = logging.getLogger(__name__)
-
-PS_EXE = "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"
-
-
-def proc_cmdline(pid):
-    """读进程命令行；失败返回空串。仅用于确认旧 CodeBee 实例身份。"""
-    try:
-        pid = int(pid)
-    except (TypeError, ValueError):
-        return ""
-    if pid <= 0:
-        return ""
-    if os.name != "nt":
-        try:
-            with open("/proc/%d/cmdline" % pid, "rb") as fh:
-                return fh.read().decode("utf-8", "replace").replace("\x00", " ").strip()
-        except Exception:
-            return ""
-    try:
-        r = subprocess.run(
-            [PS_EXE, "-NoProfile", "-Command",
-             "(Get-CimInstance Win32_Process -Filter 'ProcessId = %d').CommandLine" % pid],
-            capture_output=True, timeout=10)
-        return r.stdout.decode("utf-8", "replace").strip() if r.returncode == 0 else ""
-    except Exception:
-        return ""
-
-
-def _command_tokens(cmdline):
-    try:
-        return [token.strip().strip('"').strip("'")
-                for token in shlex.split(str(cmdline or ""), posix=False)]
-    except (TypeError, ValueError):
-        return []
-
-
-def is_own_instance(cmdline, main_script, port=None):
-    """按启动器、脚本独立参数和端口精确确认 CodeBee 实例。"""
-    tokens = _command_tokens(cmdline)
-    if len(tokens) < 2:
-        return False
-    launcher = os.path.splitext(os.path.basename(tokens[0]))[0].lower()
-    if launcher not in ("python", "python3", "py"):
-        return False
-    script = ""
-    for token in tokens[1:]:
-        if token.startswith("-"):
-            continue
-        script = token
-        break
-    if not script or not os.path.isabs(script):
-        return False
-    actual = os.path.normcase(os.path.normpath(os.path.abspath(script)))
-    expected = os.path.normcase(os.path.normpath(os.path.abspath(str(main_script))))
-    packaged = actual.replace("\\", "/").lower().endswith(
-        "/node_modules/codebee/app/main.py")
-    if actual != expected and not packaged:
-        return False
-    if port is None:
-        return True
-    try:
-        wanted = str(int(port))
-    except (TypeError, ValueError):
-        return False
-    explicit_port = None
-    for i, token in enumerate(tokens):
-        if token == "--port" and i + 1 < len(tokens):
-            explicit_port = tokens[i + 1]
-        elif token.startswith("--port="):
-            explicit_port = token.split("=", 1)[1]
-    # argparse 默认端口可不出现在旧实例参数中；非默认端口必须显式相符。
-    return ((explicit_port == wanted) if explicit_port is not None
-            else wanted == "8765")
-
-
-def clear_stale_port(port, main_script):
-    """清掉占用端口的进程。返回 (是否清掉, 人话说明)。"""
-    holders = [p for p in portscan.listening_ports() if p.get("port") == int(port)]
-    if not holders:
-        return True, ""
-    pid = int(holders[0].get("pid") or 0)
-    if pid <= 4 or pid == os.getpid():
-        return False, "占用者是系统进程/自身，拒绝清理"
-    if is_own_instance(proc_cmdline(pid), main_script, port=port):
-        try:
-            runner._kill_tree(pid)
-            return True, "已结束旧实例 PID %d" % pid
-        except Exception as e:
-            return False, "旧实例 PID %d 清理失败 %s" % (pid, str(e)[:80])
-    return False, "占用者非 CodeBee（PID %d），未自动关闭" % pid
+# -*- coding: utf-8 -*-
+"""启动端口清场（用户拍板 2026-09-21）：端口被占时先清场再启动。
+
+- **自家旧实例**（命令行含本包 main.py 完整路径，或 npm 包内 app/main.py）
+  → 杀树（TerminateProcess 直杀）——升级/重启最常见的占用者就是没退干净
+  的 CodeBee 自己；控制台进程对温和信号（WM_CLOSE）无反应，温和关不掉
+  正是用户「旧进程太难杀」的痛点，所以自家实例直接强杀。
+- **别人的进程** → 只报告占用者，不发送任何信号；启动流程不得替用户
+  关闭可能正在开发中的服务。
+- 系统/自身进程拒关（portscan 内置护栏）。
+"""
+from __future__ import annotations
+
+import logging
+import os
+import shlex
+import subprocess
+
+from . import portscan, runner
+
+log = logging.getLogger(__name__)
+
+PS_EXE = "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"
+
+
+def proc_cmdline(pid):
+    """读进程命令行；失败返回空串。仅用于确认旧 CodeBee 实例身份。"""
+    try:
+        pid = int(pid)
+    except (TypeError, ValueError):
+        return ""
+    if pid <= 0:
+        return ""
+    if os.name != "nt":
+        try:
+            with open("/proc/%d/cmdline" % pid, "rb") as fh:
+                return fh.read().decode("utf-8", "replace").replace("\x00", " ").strip()
+        except Exception:
+            return ""
+    try:
+        r = subprocess.run(
+            [PS_EXE, "-NoProfile", "-Command",
+             "(Get-CimInstance Win32_Process -Filter 'ProcessId = %d').CommandLine" % pid],
+            capture_output=True, timeout=10)
+        return r.stdout.decode("utf-8", "replace").strip() if r.returncode == 0 else ""
+    except Exception:
+        return ""
+
+
+def _command_tokens(cmdline):
+    try:
+        return [token.strip().strip('"').strip("'")
+                for token in shlex.split(str(cmdline or ""), posix=False)]
+    except (TypeError, ValueError):
+        return []
+
+
+def is_own_instance(cmdline, main_script, port=None):
+    """按启动器、脚本独立参数和端口精确确认 CodeBee 实例。"""
+    tokens = _command_tokens(cmdline)
+    if len(tokens) < 2:
+        return False
+    launcher = os.path.splitext(os.path.basename(tokens[0]))[0].lower()
+    if launcher not in ("python", "python3", "py"):
+        return False
+    script = ""
+    for token in tokens[1:]:
+        if token.startswith("-"):
+            continue
+        script = token
+        break
+    if not script or not os.path.isabs(script):
+        return False
+    actual = os.path.normcase(os.path.normpath(os.path.abspath(script)))
+    expected = os.path.normcase(os.path.normpath(os.path.abspath(str(main_script))))
+    packaged = actual.replace("\\", "/").lower().endswith(
+        "/node_modules/codebee/app/main.py")
+    if actual != expected and not packaged:
+        return False
+    if port is None:
+        return True
+    try:
+        wanted = str(int(port))
+    except (TypeError, ValueError):
+        return False
+    explicit_port = None
+    for i, token in enumerate(tokens):
+        if token == "--port" and i + 1 < len(tokens):
+            explicit_port = tokens[i + 1]
+        elif token.startswith("--port="):
+            explicit_port = token.split("=", 1)[1]
+    # argparse 默认端口可不出现在旧实例参数中；非默认端口必须显式相符。
+    return ((explicit_port == wanted) if explicit_port is not None
+            else wanted == "8765")
+
+
+def clear_stale_port(port, main_script):
+    """清掉占用端口的进程。返回 (是否清掉, 人话说明)。"""
+    holders = [p for p in portscan.listening_ports() if p.get("port") == int(port)]
+    if not holders:
+        return True, ""
+    pid = int(holders[0].get("pid") or 0)
+    if pid <= 4 or pid == os.getpid():
+        return False, "占用者是系统进程/自身，拒绝清理"
+    if is_own_instance(proc_cmdline(pid), main_script, port=port):
+        try:
+            runner._kill_tree(pid)
+            return True, "已结束旧实例 PID %d" % pid
+        except Exception as e:
+            return False, "旧实例 PID %d 清理失败 %s" % (pid, str(e)[:80])
+    return False, "占用者非 CodeBee（PID %d），未自动关闭" % pid

package/app/core/presence.py

@@ -1,77 +1,77 @@
-"""Small local agent presence registry for the operator dashboard."""
-from __future__ import annotations
-
-import json
-import threading
-import time
-
-from . import paths
-
-_LOCK = threading.RLock()
-_FILE = paths.DATA_DIR / "agent_presence.json"
-_STALE_S = 180
-
-
-def _load():
-    try:
-        value = json.loads(_FILE.read_text(encoding="utf-8"))
-        return value if isinstance(value, dict) else {}
-    except Exception:
-        return {}
-
-
-def _save(value):
-    _FILE.parent.mkdir(parents=True, exist_ok=True)
-    tmp = _FILE.with_suffix(".tmp")
-    tmp.write_text(json.dumps(value, ensure_ascii=False, indent=2), encoding="utf-8")
-    tmp.replace(_FILE)
-
-
-def heartbeat(agent_id, label="", capabilities=None, task_id="", status="idle", metadata=None):
-    aid = str(agent_id or "").strip()[:100]
-    if not aid:
-        raise ValueError("agent_id 必填")
-    if capabilities is not None and not isinstance(capabilities, list):
-        raise ValueError("capabilities 必须是列表")
-    if status is not None and not isinstance(status, str):
-        raise ValueError("status 必须是文本")
-    now = time.time()
-    with _LOCK:
-        data = _load()
-        safe_meta = metadata if isinstance(metadata, dict) else {}
-        # Presence is a hot, user-controlled endpoint; keep the durable
-        # registry bounded even when an agent sends oversized diagnostics.
-        safe_meta = {str(k)[:80]: str(v)[:500] for k, v in list(safe_meta.items())[:30]}
-        data[aid] = {"agent_id": aid, "label": str(label or aid)[:120],
-                     "capabilities": [str(x)[:80] for x in (capabilities or [])][:30],
-                     "task_id": str(task_id or "")[:100], "status": str(status or "idle")[:30],
-                     "metadata": safe_meta,
-                     "last_seen": now}
-        _save(data)
-        return data[aid]
-
-
-def list_agents():
-    now = time.time()
-    with _LOCK:
-        rows = []
-        for row in _load().values():
-            item = dict(row)
-            try:
-                last_seen = float(item.get("last_seen") or 0)
-            except (TypeError, ValueError):
-                last_seen = 0.0
-            age = max(0, now - last_seen)
-            item["age_s"] = int(age)
-            item["online"] = age <= _STALE_S
-            rows.append(item)
-        return sorted(rows, key=lambda x: (not x["online"], x.get("label") or ""))
-
-
-def remove(agent_id):
-    with _LOCK:
-        data = _load()
-        existed = str(agent_id or "") in data
-        data.pop(str(agent_id or ""), None)
-        _save(data)
-        return existed
+"""Small local agent presence registry for the operator dashboard."""
+from __future__ import annotations
+
+import json
+import threading
+import time
+
+from . import paths
+
+_LOCK = threading.RLock()
+_FILE = paths.DATA_DIR / "agent_presence.json"
+_STALE_S = 180
+
+
+def _load():
+    try:
+        value = json.loads(_FILE.read_text(encoding="utf-8"))
+        return value if isinstance(value, dict) else {}
+    except Exception:
+        return {}
+
+
+def _save(value):
+    _FILE.parent.mkdir(parents=True, exist_ok=True)
+    tmp = _FILE.with_suffix(".tmp")
+    tmp.write_text(json.dumps(value, ensure_ascii=False, indent=2), encoding="utf-8")
+    tmp.replace(_FILE)
+
+
+def heartbeat(agent_id, label="", capabilities=None, task_id="", status="idle", metadata=None):
+    aid = str(agent_id or "").strip()[:100]
+    if not aid:
+        raise ValueError("agent_id 必填")
+    if capabilities is not None and not isinstance(capabilities, list):
+        raise ValueError("capabilities 必须是列表")
+    if status is not None and not isinstance(status, str):
+        raise ValueError("status 必须是文本")
+    now = time.time()
+    with _LOCK:
+        data = _load()
+        safe_meta = metadata if isinstance(metadata, dict) else {}
+        # Presence is a hot, user-controlled endpoint; keep the durable
+        # registry bounded even when an agent sends oversized diagnostics.
+        safe_meta = {str(k)[:80]: str(v)[:500] for k, v in list(safe_meta.items())[:30]}
+        data[aid] = {"agent_id": aid, "label": str(label or aid)[:120],
+                     "capabilities": [str(x)[:80] for x in (capabilities or [])][:30],
+                     "task_id": str(task_id or "")[:100], "status": str(status or "idle")[:30],
+                     "metadata": safe_meta,
+                     "last_seen": now}
+        _save(data)
+        return data[aid]
+
+
+def list_agents():
+    now = time.time()
+    with _LOCK:
+        rows = []
+        for row in _load().values():
+            item = dict(row)
+            try:
+                last_seen = float(item.get("last_seen") or 0)
+            except (TypeError, ValueError):
+                last_seen = 0.0
+            age = max(0, now - last_seen)
+            item["age_s"] = int(age)
+            item["online"] = age <= _STALE_S
+            rows.append(item)
+        return sorted(rows, key=lambda x: (not x["online"], x.get("label") or ""))
+
+
+def remove(agent_id):
+    with _LOCK:
+        data = _load()
+        existed = str(agent_id or "") in data
+        data.pop(str(agent_id or ""), None)
+        _save(data)
+        return existed