codebee 0.1.18 → 0.1.20

package/CHANGELOG.md

@@ -4,6 +4,28 @@ CodeBee 的用户可感知变更记录。发布新版时：最上面加一节，
 `<!-- relnotes:start -->…<!-- relnotes:end -->` 段（那段会被 `npm view` 的
 README 元数据带回，供老版本在「发现新版本」时展示新版更新内容）。
 
+## 未发布
+
+## v0.1.20（2026-09-20）
+
+- 全类型交付契约：小说、文章、短视频、文档、翻译、调研、演讲、汇报、邮件、技术方案、简历按真实类型路由，并注入各自角色、成品结构和真实性约束
+- token 预算修复：默认关闭压缩与续会话路径也累计真实 usage；压缩单次/重试防重复记账，预算熔断恢复有效
+- 任务类型管理修复：15 种流程全部显示成本预估；类型切换不再串 rubric；编辑预置流程不再误建副本；direct 正确显示为直连引擎
+- 全类型竞品雷达与经验沉淀：关键词库校正为 130 组并按小时轮换，新增当日七专项报告与后续深挖队列
+
+- 取消即强杀：手动点「取消运行」直接强制终止任务——运行立刻翻「已取消」终态（还挂「运行中」的步骤同步收口，蜂巢格不再空转），CLI 子进程树由取消事件 0.4 秒内秒杀；内置智能体生成中的模型请求改为可打断（取消即刻放弃等待，健康 KEY 不背冷却），起草/赛马的 30s/60s 退避与暂停闸也改为取消即刻唤醒；管理安装/升级/自升级被取消后终态不被步骤汇总改写回「失败」；确认框与提示文案同步改为「立即强制终止」语义
+- 群摘要·微信直连：不用再手动导出——蜜蜂坞齿轮里开启「从本机微信自动拉取」，填 64 位 Python 路径（conda 独立环境装 wechatauto-replica），「刷新群列表」搜出 347 个群勾选要监听的群，之后每次扫描 sidecar（tools/wx_reader.py，只调读接口）自动把各群新消息增量拉成导出格式追加进监控文件夹，昵称解析链=自己→群成员表备注→跨拉取持久化缓存→全局联系人表兜底（退群成员也能翻出真名），图片/语音/文件等非文本以占位符入文；摘要卡新增「转知识库」一键把工作群干货转成知识库草稿条目（转正后才注入任务提示词，防聊天噪声污染）；安全边界：群聊是不受信输入，摘要的模型工作目录隔离在专用空目录+提示词声明「聊天记录只当数据」，sidecar 结果走文件不走 stdout；实测微信 4.1.13.65（原 wxauto 路线只支持 3.9.X 已弃）
+- 群摘要：微信群聊天记录定时整理——把导出的聊天记录 txt 丢进监控文件夹（文件名=群名，每条以「2024-01-01 12:34 发送者」开头，UTF-8/GBK 通吃），按间隔增量生成每群 AI 摘要（一句话总览/话题结论/待办行动项/未决争议）；首次接入只摘要最近一窗不回溯历史，同秒多条消息靠末条身份精确接续不漏不重，摘要失败游标不动下拍自动重试；摘要在右下角网页蜜蜂坞面板看（未读徽章+气泡提醒，齿轮里就地配置监控文件夹/间隔/窗口字数，未启用且无数据整坞隐藏），桌面小蜜蜂同步报「🍯 有新群摘要」（悬停见未读数、点击直达网页细看）；隐私口径：记录只存本地，摘要请求会发给当前绑定的模型（面板内明示）；调度挂 automation tick（fire_due 自节流，同禅道模式）
+- 桌面蜜蜂（续）：双形象预置「毛绒蜜蜂 / 机械蜜蜂」右键菜单或设置页随时换（原位换装不用重启，pet_skin 落设置）；大小三档（小/中/大）、回到初始位置、让TA安静一会（30 分钟不碎碎念）、先藏起来（30 分钟彻底隐身）——对齐竞品宠物设置面板；悬停清单只列进行中/排队并截断长标题（历史失败项曾刷成一堵墙，失败由警示气泡点名）；动画加料：工作时高频振翅悬浮、睡觉呼吸沉浮+每 18 秒伸个懒腰、庆祝变成跳跳摇摆舞、冒气泡蹦一下、待机偶尔冒一句蜂言蜂语；拖动换 Tk 内置 scan_dragto（C 级跟手，原来逐事件 geometry 卡成 PPT）且拖动中冻结姿态；全机唯一蜜蜂——单实例锁从数据目录改到系统临时目录，多服务实例/开发仓+正式版并存也只养一只（多只蜜蜂真机踩坑）
+- 桌面蜜蜂：CodeBee 桌宠（参考 Codex Pets 产品形态）——tkinter 零依赖自绘小蜜蜂常驻桌面右下角，实时反映蜂群状态：空闲打盹（Zzz）、任务运行振翅悬停（徽章显示数量+步骤进度条）、全部完工翻滚庆祝（气泡「N 个任务完工！」）、失败/取消警示抖动（气泡点名问题任务）；鼠标悬停弹出「蜂群动态」任务清单（进行中/排队/失败实时刷新，含当前步骤与进度）；左键打开 CodeBee、右键菜单（显示模式/语言/关闭）、按住拖动且位置记忆；跑在独立小进程（pick_dialog 同款进程隔离），服务关闭约 1 分钟内自离不留孤儿；设置页「皮肤」子页新增开关与「常驻 / 仅任务运行时」显示模式（默认开、常驻）；设置是唯一真源——关闭后蜜蜂下个轮询周期自离、看护线程不复活；单实例心跳锁防双开
+
+## v0.1.19（2026-09-20）
+
+- 知识库零负担化：条目默认直接转正参与注入（提炼提示词自带质量约束兜底），历史草稿启动时一次性转正
+- 发布管理器自愈：启动收尸把等扫码/忙状态的死线程改判 error；旧版冤判「等待登录超时」的记录后台复核，登录态还在的直接翻回已连接
+- 禅道地址自适应：REST 根路径 404 时自动探测 /zentao 子路径部署并缓存，另提供产品/账号清单接口供前端下拉
+- 新增竞品调研流程：抓取七猫+番茄排行榜公开数据，AI 提炼跨平台热门题材/人设/差异化切入点
+
 ## v0.1.18（2026-09-20）
 
 - 知识库：运行产出自动整理成可复用知识——编排者从产出材料（调研报告/文档）提炼知识条目（草稿态），人工「转正」后按任务类型+相关性自动注入同类任务的规划与评审提示词；与经验库分工（教训记「别这么做」，知识记「已知是这样」）；设置页独立「知识库」子页，搜索/状态/标签过滤+手动新建（即个人知识管理库）；事实带账龄，as_of 超 90 天注入时自动标注「可能过期」

package/README.md

@@ -21,10 +21,11 @@ Kimi Code、MiMo Code、Grok Build、Pi、DeepSeek Harness……），提供
 不会把你的任务内容交给任何第三方。
 
 <!-- relnotes:start -->
-### 最新版更新内容（v0.1.18）
+### 最新版更新内容（v0.1.20）
 
-- 新增「知识库」：产出材料自动提炼成知识条目，转正后按任务类型自动注入规划与评审——你的个人知识管理库
-- 新增封面生成（智谱 CogView）；七猫发布分类纠偏；管理操作排队补队治理
+- 11 类内容任务按真实类型路由，并带各自角色、成品结构和真实性约束
+- token 预算恢复有效：默认路径与续会话均累计真实 usage，压缩重试不重复记账
+- 15 种流程成本预估全覆盖；修复 rubric 串值、预置流程误建副本和 direct 标签
 <!-- relnotes:end -->
 
 ---
@@ -91,8 +92,8 @@ OpenCode / Continue / Cursor / Trae 十种工具的配置，一次带入全部
 
 ### 更多内置能力
 
-- **14 种任务类型**：代码、小说、连载小说、文档、翻译、调研、演讲、短视频脚本、
-  周报、邮件、技术方案、简历，以及「直接执行」对话模式；全部支持自定义流程
+- **15 种任务类型**：直接执行、代码、小说、连载小说、自媒体文章、短视频脚本、
+  文档、翻译、扫榜选材、调研报告、演讲稿、工作汇报、商务邮件、技术方案、简历；全部支持自定义流程
   （引擎 / 评审维度 / 阈值 / 轮数 / 提示词覆盖）；
 - **质量闸门与裁决**：评审失败≠0 分照过、降级大纲不开写、超时但已落盘的稿件照常
   送评审；需要人拍板的事项进「待裁决」队列（徽章 + 提示音），`tools/bee.py`
@@ -198,7 +199,8 @@ python tools\bee.py discard <task>    :: 否决——删除任务分支（需输
 ## 任务类型与自定义流程
 
 主表单的「类型」下拉即流程列表，点「管理」可新增/编辑自定义流程（引擎、评审维度、
-阈值、轮数、产出文件名、起草/评审提示词覆盖）。内置 14 种：
+阈值、轮数、产出文件名、起草/评审提示词覆盖）。内置 15 种；禅道工单是自动转成
+`code` 修复任务的集成入口，不另占菜单类型：
 
 | 类型 | 引擎 | 流程 |
 |---|---|---|
@@ -206,13 +208,17 @@ python tools\bee.py discard <task>    :: 否决——删除任务分支（需输
 | 💻 代码 | code | 实现 → 验证 → 跨厂商评审 → 自动修复/换将 |
 | 📖 小说 | review | 起草 → 多维评审（情节/人物/文笔/节奏/吸引力）→ 修订 → 发布门禁 |
 | 📚 连载小说 | review | 大纲 → 逐章起草/评审/修订 → 全局一致性评审 → 合并成书（断点续跑/继续连载） |
+| 📰 自媒体文章 | review | 平台化标题/开头/结构 → 多维评审 → 修订 → 发布门禁 |
+| 🎬 短视频脚本 | review | 画面 + 口播 + 字幕/音效 → 多维评审 → 修订 → 发布门禁 |
 | 📝 文档 | review | 起草 → 多维评审（准确性/结构/表达/实用）→ 修订 → 门禁 |
 | 🌐 翻译 | review | 起草 → 多维评审（忠实度/流畅度/术语/风格）→ 修订 → 门禁 |
+| 📈 扫榜选材 | direct | 抓七猫 + 番茄公开榜单 → 跨平台题材/人设/切入点洞察 |
 | 🔍 调研报告 | review | 起草 → 多维评审（全面性/深度/论据/结论）→ 修订 → 门禁 |
 | 🎤 演讲稿 | review | 起草 → 多维评审（主题/结构/感染力/语言）→ 修订 → 门禁 |
-| 🎬 短视频脚本 / 📅 周报 / ✉️ 邮件 / 📋 技术方案 / 📄 简历 | review | 各自专属评审维度 |
+| 📅 工作汇报 / ✉️ 商务邮件 / 📋 技术方案 / 📄 简历 | review | 各自专属角色、交付约束与评审维度 |
 
-两种引擎：
+三种引擎：
+- **direct 引擎**：单智能体直接执行目标，保留会话上下文，适合问答、探索和无需评审链的快捷任务；
 - **code 引擎**：实现者在工作目录直接改代码 → 执行验证命令（确定性结果）→ 跨厂商评审
   （结构化 JSON）→ 不通过则自动修复循环（至多 2 轮）→ 仍失败自动换将全量重实现；
 - **review 引擎**：作者起草产出文件 → 多个评审智能体按维度独立打分 + 提问题 →

package/app/core/automation.py

@@ -394,6 +394,25 @@ def _tick():
         _zentao.fire_due()
     except Exception:
         log.debug("automation: 禅道扫描跳过", exc_info=True)
+    # 微信群摘要联动：监控文件夹增量扫描（fire_due 自节流，同上）。
+    try:
+        from . import wxdigest as _wxd
+        r = _wxd.fire_due()
+        if r and not r.get("skipped") and (r.get("made") or r.get("error")):
+            log.info("automation: 群摘要扫描完成 made=%s err=%s",
+                     r.get("made"), r.get("error") or "-")
+    except Exception:
+        log.debug("automation: 群摘要扫描跳过", exc_info=True)
+    # 每日垃圾清理联动：启用且当天没清过才真跑（fire_due 自节流，同上）。
+    try:
+        from . import cleanup as _cleanup
+        r = _cleanup.fire_due()
+        if r and (r.get("freed") or r.get("errors")):
+            log.info("automation: 每日清理完成 释放 %.1f MB%s",
+                     r.get("freed", 0) / 1048576.0,
+                     ("，%d 项失败" % len(r.get("errors") or [])) if r.get("errors") else "")
+    except Exception:
+        log.debug("automation: 每日清理跳过", exc_info=True)
 
 
 def _loop():

package/app/core/backup.py

@@ -0,0 +1,470 @@
+# -*- coding: utf-8 -*-
+"""整机数据备份：导出 / 导入（换电脑、换路径安装时的数据搬家）。
+
+备份包是一个 zip，布局：
+    manifest.json                     清单（app/schema/旧路径/计数/未打包目录）
+    data/…                            整个数据目录（见下方排除清单）
+    workspace/<相对默认保存路径的路径>  任务工作目录（手稿/成品文件——真正的劳动成果）
+
+排除不打包（易失或机器相关，导入后也无意义）：
+  - 发布浏览器 profile（data/publish/profiles 迁移残留 + 家目录 ~/.codebee/
+    publish_profiles 本来就在数据目录外）——GB 级且登录态 cookie 与机器绑定；
+  - 日志（data 根 *.log）、pet.lock、chat_cache、pending（运行中信箱）、
+    exports/imports（备份模块自己的输出/暂存区）。
+运行过程日志（runs/*/steps/*.log）默认打包，include_logs=False 可去掉减小体积。
+
+导入路径重映射：任务记录/设置里存的是旧机器的绝对路径。manifest 记下旧
+data 目录与旧默认保存路径，导入时把所有 JSON 值里以旧路径开头的字符串改写
+为新机器对应路径（长前缀优先，避免父子前缀互吞），工作目录文件按相对路径
+落到新默认保存路径下。导入前自动把当前小体积状态（根 *.json + tasks/*.json）
+备份到 <data>/imports/pre-import-<ts>.zip 供反悔。
+
+导入要求没有运行中/排队中的任务（记录与文件正被使用）；完成后必须重启
+服务（各模块的内存态与 import 期绑定只认启动时的数据目录）。
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import shutil
+import time
+import zipfile
+from pathlib import Path
+
+from . import paths, settings as settings_mod
+
+_SEG_SPLIT = re.compile(r"[\\/]")
+_DRIVE_RE = re.compile(r"^[A-Za-z]:")
+
+MANIFEST_NAME = "manifest.json"
+SCHEMA = 1
+APP_ID = "codebee"
+
+# 数据目录内不打包的一级目录 / 文件名（易失、缓存或备份模块自留地）
+_EXCLUDE_TOP_DIRS = {"exports", "imports", "chat_cache", "pending"}
+_EXCLUDE_TOP_FILES = {"pet.lock"}
+# publish/profiles 是 GB 级浏览器 profile 迁移残留（登录态与机器绑定），不打包
+_LOG_SUFFIXES = (".log", ".tmp")
+
+
+def _app_version():
+    try:
+        pkg = paths.ROOT / "package.json"
+        return str(json.loads(pkg.read_text(encoding="utf-8")).get("version") or "")
+    except Exception:
+        return ""
+
+
+def _iter_files(base: Path):
+    """yield (绝对路径, 相对 Path)。符号坏链等交给调用方逐文件兜底。"""
+    for cur, dirs, files in os.walk(base):
+        cur_p = Path(cur)
+        for f in files:
+            p = cur_p / f
+            try:
+                yield p, p.relative_to(base)
+            except ValueError:
+                continue
+
+
+def _export_skip(rel: Path, include_logs=True):
+    """导出时是否跳过该相对路径（rel 相对 DATA_DIR）。"""
+    parts = rel.parts
+    if not parts:
+        return True
+    if parts[0] in _EXCLUDE_TOP_DIRS:
+        return True
+    if parts[0] == "publish" and len(parts) > 1 and parts[1] == "profiles":
+        return True
+    if parts[0] in _EXCLUDE_TOP_FILES:
+        return True
+    if rel.suffix.lower() in _LOG_SUFFIXES:
+        # 运行过程日志按开关保留；数据根的服务日志一律不打包（易失）
+        if not (include_logs and parts[0] == "runs"):
+            return True
+    return False
+
+
+def _collect_workspace_dirs():
+    """收集该打包的任务工作目录。
+
+    只打包「默认保存路径」下的目录（当初由默认路径自动放置的 app 管辖区，
+    与 store.migrate_task_workdirs 同一口径）；落在数据目录里的（如 demo）
+    随 data/ 打包；两者之外的是用户自己的目录（代码仓库等），不打包、只在
+    manifest.external_workdirs 里点名提醒。
+    返回 (根目录, [相对 Path…], [外部目录…])。
+    """
+    root = Path(settings_mod.default_workdir())
+    from . import store
+    wds = set()
+    try:
+        for t in store.list_tasks(limit=10 ** 6):
+            wd = str(t.get("workdir") or "").strip()
+            if wd:
+                wds.add(Path(wd))
+    except Exception:
+        pass
+    try:
+        from . import automation
+        for at in automation.list_tasks():
+            wd = str(at.get("workdir") or "").strip()
+            if wd:
+                wds.add(Path(wd))
+    except Exception:
+        pass
+    inside, external = [], []
+    seen = set()
+    for wd in sorted(wds, key=lambda p: str(p).lower()):
+        s = str(wd)
+        if s.lower() in seen:
+            continue
+        seen.add(s.lower())
+        try:
+            rel = wd.resolve().relative_to(root.resolve())
+        except (ValueError, OSError):
+            try:
+                wd.resolve().relative_to(Path(paths.DATA_DIR).resolve())
+                continue  # 数据目录内的随 data/ 打包，不重复收
+            except (ValueError, OSError):
+                external.append(s)
+                continue
+        if wd.is_dir():
+            inside.append(rel)
+    return root, inside, external
+
+
+# ---------------------------------------------------------------- 导出
+
+def export_data(target_dir="", include_logs=True, include_workspace=True):
+    """打包当前数据目录 + 任务工作目录到 zip。返回信息 dict；参数非法抛 ValueError。"""
+    data_dir = Path(paths.DATA_DIR)
+    if not data_dir.is_dir():
+        raise ValueError("数据目录不存在: %s" % data_dir)
+    target = Path(target_dir).expanduser() if str(target_dir or "").strip() \
+        else (Path.home() / "Downloads")
+    if not target.is_absolute():
+        raise ValueError("导出位置必须是绝对路径")
+    try:
+        target.mkdir(parents=True, exist_ok=True)
+    except OSError as e:
+        raise ValueError("导出位置不可创建: %s（%s）" % (target, e))
+
+    root, ws_rels, external = _collect_workspace_dirs()
+    manifest = {
+        "app": APP_ID, "schema": SCHEMA,
+        "exported_at": time.strftime("%Y-%m-%d %H:%M:%S"),
+        "version": _app_version(),
+        "data_dir": str(data_dir),
+        "default_workdir": str(root),
+        "include_logs": bool(include_logs),
+        "include_workspace": bool(include_workspace),
+        "external_workdirs": external,
+        "workspace_dirs": [str(r) for r in ws_rels],
+    }
+    out = target / ("codebee-backup-" + time.strftime("%Y%m%d-%H%M%S") + ".zip")
+    counts = {"data_files": 0, "workspace_files": 0, "tasks": 0, "runs": 0}
+    warnings = []
+    try:
+        counts["tasks"] = sum(1 for _ in (data_dir / "tasks").glob("t-*.json"))
+        rdir = data_dir / "runs"
+        counts["runs"] = sum(1 for _ in rdir.iterdir()) if rdir.is_dir() else 0
+    except OSError:
+        pass
+    manifest["counts"] = counts
+
+    zf = None
+    try:
+        zf = zipfile.ZipFile(str(out), "w", zipfile.ZIP_DEFLATED)
+        for p, rel in _iter_files(data_dir):
+            if _export_skip(rel, include_logs=include_logs) or p == out:
+                continue
+            try:
+                zf.write(str(p), str(Path("data") / rel))
+                counts["data_files"] += 1
+            except OSError as e:
+                warnings.append("跳过 %s（%s）" % (rel, e.strerror or e))
+        if include_workspace:
+            for rel in ws_rels:
+                base = root / rel
+                for p, frel in _iter_files(base):
+                    try:
+                        zf.write(str(p), str(Path("workspace") / rel / frel))
+                        counts["workspace_files"] += 1
+                    except OSError as e:
+                        warnings.append("跳过 %s（%s）" % (rel / frel, e.strerror or e))
+        # manifest 最后写：此刻 data/workspace 计数才是终值
+        zf.writestr(MANIFEST_NAME, json.dumps(manifest, ensure_ascii=False, indent=2))
+    finally:
+        if zf is not None:
+            zf.close()
+    manifest["counts"] = counts
+    return {"path": str(out), "size": out.stat().st_size,
+            "tasks": counts["tasks"], "runs": counts["runs"],
+            "data_files": counts["data_files"],
+            "workspace_files": counts["workspace_files"],
+            "external_workdirs": external, "warnings": warnings}
+
+
+# ---------------------------------------------------------------- 预览
+
+def _read_manifest(zf):
+    try:
+        raw = zf.read(MANIFEST_NAME)
+    except KeyError:
+        raise ValueError("不是 CodeBee 备份包（缺少 manifest.json）")
+    try:
+        m = json.loads(raw.decode("utf-8"))
+    except Exception:
+        raise ValueError("备份包 manifest.json 无法解析")
+    if not isinstance(m, dict) or m.get("app") != APP_ID:
+        raise ValueError("不是 CodeBee 备份包（manifest 不匹配）")
+    if int(m.get("schema") or 0) > SCHEMA:
+        raise ValueError("备份包版本较新（schema %s > %d），请先升级 CodeBee 再导入"
+                         % (m.get("schema"), SCHEMA))
+    return m
+
+
+def _safe_join(base: Path, name: str):
+    """zip 条目名 → base 下安全路径（zip slip 四道闸，拒绝一切逃逸形态）。
+
+    ①条目名含 .. 字面量即拒绝（任何形态的父目录逃逸，构造路径之前完成）；
+    ②按 / 与 \\ 切段后出现 .. 段、盘符（C:）同样拒绝；③只用纯段名 join 回
+    基线（base / 带盘符的 name 在 Windows 会整体替换掉 base，故绝不直接拼）；
+    ④normpath 后必须仍在 base 之内（双保险）。"""
+    if ".." in name:
+        raise ValueError("备份包含非法路径条目: %s" % name[:120])
+    parts = [p for p in _SEG_SPLIT.split(name) if p not in ("", ".")]
+    if (not parts or any(p == ".." for p in parts)
+            or _DRIVE_RE.match(parts[0])):
+        raise ValueError("备份包含非法路径条目: %s" % name[:120])
+    resolved = Path(os.path.normpath(os.path.join(str(base), *parts)))
+    try:
+        resolved.relative_to(base)
+    except ValueError:
+        raise ValueError("备份包含非法路径条目: %s" % name[:120])
+    return resolved
+
+
+def _busy_runs():
+    from . import store
+    out = []
+    try:
+        for r in store.list_runs(limit=10 ** 6):
+            if r.get("status") in ("queued", "running"):
+                out.append(r.get("id"))
+    except Exception:
+        pass
+    return out
+
+
+def inspect_backup(zip_path):
+    """解析备份包，返回预览信息（不落任何盘）。包打不开/不是本家包抛 ValueError。"""
+    p = Path(str(zip_path or "").strip())
+    if not p.is_file():
+        raise ValueError("备份包不存在: %s" % p)
+    try:
+        zf = zipfile.ZipFile(str(p))
+    except Exception as e:
+        raise ValueError("备份包打不开：%s" % e)
+    with zf:
+        m = _read_manifest(zf)
+        names = zf.namelist()
+    data_n = sum(1 for n in names if n.startswith("data/"))
+    ws_n = sum(1 for n in names if n.startswith("workspace/"))
+    old_data = str(m.get("data_dir") or "")
+    old_wd = str(m.get("default_workdir") or "")
+    cur_data = str(Path(paths.DATA_DIR))
+    cur_wd = settings_mod.default_workdir()
+    return {
+        "exported_at": m.get("exported_at"), "version": m.get("version"),
+        "tasks": (m.get("counts") or {}).get("tasks"),
+        "runs": (m.get("counts") or {}).get("runs"),
+        "data_files": data_n, "workspace_files": ws_n,
+        "include_logs": bool(m.get("include_logs", True)),
+        "external_workdirs": m.get("external_workdirs") or [],
+        "old_data_dir": old_data, "old_workdir": old_wd,
+        "cur_data_dir": cur_data, "cur_workdir": cur_wd,
+        "remap_needed": (old_data.lower() != cur_data.lower()
+                         or old_wd.lower() != cur_wd.lower()),
+        "busy_runs": _busy_runs(),
+        "same_machine": old_data.lower() == cur_data.lower(),
+    }
+
+
+# ---------------------------------------------------------------- 导入
+
+def _pre_import_backup(ts):
+    """把当前小体积状态备份到 <data>/imports/pre-import-<ts>.zip（反悔用）。"""
+    data_dir = Path(paths.DATA_DIR)
+    bdir = data_dir / "imports"
+    bdir.mkdir(parents=True, exist_ok=True)
+    out = bdir / ("pre-import-" + ts + ".zip")
+    with zipfile.ZipFile(str(out), "w", zipfile.ZIP_DEFLATED) as zf:
+        for p in sorted(data_dir.glob("*.json")):
+            try:
+                zf.write(str(p), p.name)
+            except OSError:
+                pass
+        tdir = data_dir / "tasks"
+        if tdir.is_dir():
+            for p in sorted(tdir.glob("*.json")):
+                try:
+                    zf.write(str(p), str(Path("tasks") / p.name))
+                except OSError:
+                    pass
+    return out
+
+
+def _remap_value(v, pairs):
+    """字符串值按前缀对改写（长前缀优先）；命中返回 (新串, True)。"""
+    if not isinstance(v, str) or not v:
+        return v, False
+    for old, new in pairs:  # pairs 已按 len(old) 降序
+        if old.lower() == v.lower():
+            return new, True
+        lo = v.lower()
+        if lo.startswith(old.lower()):
+            tail = v[len(old):]
+            if tail and tail[0] not in "\\/":
+                continue  # 只是碰巧同前缀（如 E:\GoOut2），不是旧路径
+            return new + tail, True
+    return v, False
+
+
+def _remap_obj(o, pairs, stat):
+    if isinstance(o, dict):
+        return {k: _remap_obj(v, pairs, stat) for k, v in o.items()}
+    if isinstance(o, list):
+        return [_remap_obj(v, pairs, stat) for v in o]
+    nv, hit = _remap_value(o, pairs)
+    if hit:
+        stat[0] += 1
+    return nv
+
+
+def _remap_all_json(pairs):
+    """数据目录内所有 JSON 的字符串值做旧→新路径改写。返回 (文件数, 值数)。"""
+    data_dir = Path(paths.DATA_DIR)
+    files = hits = 0
+    for p in data_dir.rglob("*.json"):
+        rel = p.relative_to(data_dir)
+        if rel.parts[0] in ("imports", "exports"):
+            continue
+        try:
+            raw = p.read_text(encoding="utf-8")
+            obj = json.loads(raw)
+            if not isinstance(obj, (dict, list)):
+                continue
+            stat = [0]
+            new_obj = _remap_obj(obj, pairs, stat)
+            if stat[0]:
+                tmp = p.with_suffix(".tmp")
+                tmp.write_text(json.dumps(new_obj, ensure_ascii=False, indent=2),
+                               encoding="utf-8")
+                os.replace(str(tmp), str(p))
+                files += 1
+                hits += stat[0]
+        except Exception:
+            continue  # 单个文件坏/被锁不阻塞整体导入
+    return files, hits
+
+
+def _extract(zf, names, base, prefix, skip=None):
+    n = 0
+    for name in names:
+        if not name.startswith(prefix) or name == prefix:
+            continue
+        rel = name[len(prefix):]
+        if not rel:
+            continue
+        if skip and skip(rel):
+            continue
+        target = _safe_join(base, rel)
+        if name.endswith("/"):
+            target.mkdir(parents=True, exist_ok=True)
+            continue
+        target.parent.mkdir(parents=True, exist_ok=True)
+        with zf.open(name) as src, open(str(target), "wb") as dst:
+            shutil.copyfileobj(src, dst)
+        n += 1
+    return n
+
+
+def apply_import(zip_path, mode="merge", remap=True, include_workspace=True):
+    """应用备份包。mode=merge 现有数据保留、同名覆盖；replace 先清空再落（不碰
+    imports/ 与 pet.lock）。返回信息 dict；校验失败/有运行中任务抛 ValueError。"""
+    p = Path(str(zip_path or "").strip())
+    if not p.is_file():
+        raise ValueError("备份包不存在: %s" % p)
+    mode = mode if mode in ("merge", "replace") else "merge"
+    busy = _busy_runs()
+    if busy:
+        raise ValueError("有 %d 个任务正在运行或排队（%s…），导入会踩到正在写的"
+                         "文件；等它们跑完或取消后再试"
+                         % (len(busy), "、".join(busy[:3])))
+
+    cur_wd = settings_mod.default_workdir()
+    data_dir = Path(paths.DATA_DIR)
+    zf = zipfile.ZipFile(str(p))
+    try:
+        m = _read_manifest(zf)
+        names = [n for n in zf.namelist() if not n.endswith("/")]
+        # 事前把全部条目做 zip-slip 校验，任何一个不合法就整体拒绝
+        for name in names:
+            if name.startswith("data/"):
+                _safe_join(data_dir, name[len("data/"):])
+            elif name.startswith("workspace/"):
+                _safe_join(Path(cur_wd), name[len("workspace/"):])
+            elif name != MANIFEST_NAME:
+                raise ValueError("备份包含无法识别的条目: %s" % name)
+        ts = time.strftime("%Y%m%d-%H%M%S")
+        backup_path = _pre_import_backup(ts)
+        if mode == "replace":
+            for child in data_dir.iterdir():
+                if child.name in ("imports", "pet.lock"):
+                    continue
+                try:
+                    if child.is_dir():
+                        shutil.rmtree(str(child), ignore_errors=True)
+                    else:
+                        child.unlink()
+                except OSError:
+                    pass
+        n_data = _extract(zf, names, data_dir, "data/")
+        n_ws = 0
+        if include_workspace:
+            Path(cur_wd).mkdir(parents=True, exist_ok=True)
+            n_ws = _extract(zf, names, Path(cur_wd), "workspace/")
+    finally:
+        zf.close()
+
+    # 路径重映射：长前缀优先（工作目录可能在数据目录之下，避免被短前缀截走）
+    old_data = str(m.get("data_dir") or "")
+    old_wd = str(m.get("default_workdir") or "")
+    pairs = []
+    if remap:
+        for old, new in ((old_wd, cur_wd), (old_data, str(data_dir))):
+            if old and old.lower() != new.lower():
+                pairs.append((old, new))
+        pairs.sort(key=lambda x: len(x[0]), reverse=True)
+    remapped_files = remapped_values = 0
+    if pairs:
+        remapped_files, remapped_values = _remap_all_json(pairs)
+
+    # 导入的 settings.json 里若带着旧机器默认路径，上面已重映射；把当前生效值对齐
+    try:
+        from . import store
+        with store.LOCK:
+            store._TASKS.clear()
+            store._RUNS.clear()
+        store.load_all()
+        store.bump_state()
+    except Exception:
+        pass
+    return {"mode": mode, "data_files": n_data, "workspace_files": n_ws,
+            "remap": {"applied": bool(pairs), "files": remapped_files,
+                      "values": remapped_values, "pairs": [[o, n] for o, n in pairs]},
+            "backup_path": str(backup_path),
+            "external_workdirs": m.get("external_workdirs") or [],
+            "restart_required": True}

package/app/core/bookmeta.py

@@ -426,11 +426,14 @@ def _resolve_author(task):
 
 def make_book_meta(task, platform, author_agent=None, log_path=None):
     """生成一个平台的作品信息。返回 (meta dict, source 字符串)；模板兜底永远有返回。"""
-    from . import modelhub, planner, runner, skills  # 惰性导入，同 planner
+    from . import knowledge, modelhub, planner, runner, skills  # 惰性导入，同 planner
     material, outline = _collect_material(task)
     schema = {"fanqie": FANQIE_SCHEMA, "qimao": QIMAO_SCHEMA}.get(platform) or ""
     plat_label = PLATFORMS[platform]["label"]
     sk_block, _ = skills.block_for(task)
+    kb_block = knowledge.block_for(task)
+    if kb_block:
+        sk_block = (sk_block + "\n\n" + kb_block) if sk_block else kb_block
     goal = task.get("goal") or ""
     # 真实选项注入：分类/标签表按平台与读者频段给全（模型只能从表里选）
     options = (_fq_options_block(goal) if platform == "fanqie" else _qm_options_block(goal))

package/app/core/builtin_agent.py

@@ -16,6 +16,7 @@ import io
 import json
 import mimetypes
 import os
+import threading
 from pathlib import Path
 
 from . import modelhub, runner
@@ -321,6 +322,32 @@ def _post_json(url, headers, body, allow_private, timeout):
     return modelhub._post_json_http(url, headers, body, allow_private, timeout=timeout)
 
 
+def _post_interruptible(url, headers, body, allow_private, timeout, cancel_event):
+    """可打断的模型调用：cancel_event 置位即刻放弃等待返回。
+
+    单次生成最长可跑满 timeout，取消不能陪跑到自然结束——HTTP 交给守护
+    线程自行收尾（响应被丢弃，socket 随线程结束释放），主流程立即返回。
+    服务端仍会把这次生成跑完（token 已花），但任务本身即刻终止。"""
+    box = {}
+
+    def _go():
+        try:
+            box["r"] = _post_json(url, headers, body, allow_private, timeout)
+        except Exception as e:
+            box["r"] = (0, None, repr(e))
+
+    th = threading.Thread(target=_go, daemon=True)
+    th.start()
+    if cancel_event is None:
+        th.join(timeout + 10)
+    else:
+        while th.is_alive() and not cancel_event.wait(0.5):
+            pass
+    if cancel_event is not None and cancel_event.is_set():
+        return 0, None, "已取消"
+    return box.get("r") or (0, None, "无响应")
+
+
 def _m_openai(m):
     """内部消息 → openai 消息。tool_results: [(call_id, 结果文本)]。"""
     if m["role"] == "assistant":
@@ -507,7 +534,12 @@ def run(bi, prompt, workdir, timeout=180, cancel_event=None, log=None, images=No
             for kk in keys:
                 url, headers, body = _build_request(proto, pbase, kk["key"], model,
                                                     system, msgs, tools_ok)
-                status, data, err = _post_json(url, headers, body, allow_private, timeout)
+                status, data, err = _post_interruptible(url, headers, body,
+                                                        allow_private, timeout,
+                                                        cancel_event)
+                if cancel_event is not None and cancel_event.is_set():
+                    # 取消先于一切记账：健康 KEY 不能因被放弃的请求背上冷却
+                    return _fail("已取消")
                 if status == 0 or not (200 <= status < 300):
                     msg = ""
                     if isinstance(data, dict):