5.6 pre-release

.dockerignore

@@ -0,0 +1,7 @@
+# 避免本地 node_modules / 构建产物打进镜像（镜像内统一重新 install）
+**/node_modules
+**/dist
+**/.git
+awada/node_modules
+openclaw/node_modules
+*.log

.gitignore

@@ -25,12 +25,14 @@ patchright-v*/
 openclaw/
 
 # addon crews copied into crews/ at install time — not tracked
-crews/business-developer/
-crews/designer/
-crews/pro-selfmedia-operator/
-crews/sales-cs/
-crews/selfmedia-operator/
-crews/video-producer/
-scripts/upgrade.sh
-scripts/upgrade_without_git.sh
 .pnpm-store/
+
+# 本地凭据（relay 无状态多租户改造后，client 自管凭据）
+crews/main/skills/wx-mp-publisher/accounts.json
+skills/wxwork-drive/spaces.json
+
+# Claude Code 会话目录
+.claude/
+
+# 运行时缓存
+crews/main/skills/published-track/xhs-user-id.cache

CLAUDE.md

@@ -2,23 +2,14 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-### 版本管理
-
-版本号存储在 `version` 文件中，格式为 `vMAJOR.MINOR.PATCH`。当 PR 合并到 upstream 的 master 时，GitHub Action 自动递增版本号并创建 Release。通过 PR 标签控制递增类型：
-- `major` 标签 → 大版本升级
-- `minor` 标签 → 功能版本升级
-- 无标签或 `patch` 标签 → 补丁版本升级（默认）
-
-**不要手动修改 `version` 文件**，由 CI 自动维护。
-
 Claude Code 被授权在本仓库中执行任何 git 命令（包括 push、branch、tag 等），无需逐次确认。
 
 ## Crew Template 开发规范
 
-创建或修改 crew template（`crews/` 或 `addons/officials/crew/` 下的任何 crew）时，必须遵循 `docs/workspace-bootstrap-files.md` 中定义的文件职责划分：
+创建或修改 crew template（`crews/` 下的任何 crew）时，必须遵循 `docs/workspace-bootstrap-files.md` 中定义的文件职责划分：
 
 - **AGENTS.md**：工作流程、决策树、操作步骤
-- **SOUL.md**：角色定义、价值观、自主权等级（L1/L2/L3）、行为边界
+- **SOUL.md**：角色定义、价值观、行为边界
 - **IDENTITY.md**：名字、形象类型、性格基调、emoji、头像——仅此四项，不写工作职责或能力清单
 - **TOOLS.md**：本机环境备忘（脚本路径、环境变量、工具别名）——不写工作流程，不重复 SKILL.md 内容
 - **MEMORY.md**：跨会话需保留的背景知识（产品手册、用户偏好、历史记录）——不写工具使用规范
@@ -30,7 +21,13 @@ Claude Code 被授权在本仓库中执行任何 git 命令（包括 push、bran
 - 1、多步骤操作且涉及中间态保存的（下一步操作的某一输入为上一步返回结果），哪怕每一步都只是一条命令，也必须做脚本！
 - 2、涉及多分支选择，且分支选择依靠明确变量的（如环境变量中是否有某个值，或者按某个入参的值判断分支）应该优先用脚本。
 - 3、涉及 python 的，必须制作脚本，最终以 “python /path/to/script.py” 的模式调用。
-- 4、skill 需要的常量（如各种 ID、KEY 等），搭配脚本时优先使用环境变量，搭配 SKILL.md 时优先使用同级目录下的 json 配置。
+- 4、**crew 专属 skill**（`crews/<crew-id>/skills/` 下的 skill）如果包含脚本，SKILL.md 中对脚本调用的路径必须使用**绝对路径**写法，即 `python3 /<workspace 绝对路径>/skills/<skill-name>/scripts/<file>` 或 `/<workspace 绝对路径>/skills/<skill-name>/scripts/<file>`。**禁止** `cd <path> && python3 ...` 复合调用、**禁止** `bash <script>` 前缀、**禁止**工作区相对路径 `./skills/...`（实测相对路径 agent 容易误拼 CWD 或误加 `cd`/`bash` 前缀导致 allowlist miss，绝对路径最稳）。
+
+原因：openclaw exec allowlist 按命令前缀匹配，`cd` / `bash` 不在 allowlist 中；agent 的 exec 虽从 workspace CWD 执行，但实测相对路径 `./skills/...` 经常被 agent 误拼或误加前缀，直接用绝对路径最稳。注入到 TOOLS.md 的「exec 命令规范」由 `scripts/lib/agent-skills.sh` 在 setup-crew 时用真实 workspace 绝对路径渲染。
+
+**全局 skill**（`skills/` 目录下，部署到 `~/.openclaw/skills/`）同样优先用绝对路径。openclaw 加载 skill 时会注入 `References are relative to <skill绝对路径>` 提示，agent 据此将 `./scripts/xxx.sh` 解析为绝对路径，该机制可用但仍推荐直接写绝对路径。**不得**使用 `{baseDir}`——这是旧写法，模型经常无法正确推断 `{baseDir}` 的值而误用工作区相对路径。
+
+- 5、skill 需要的常量（如各种 ID、KEY 等），搭配脚本时优先使用环境变量，搭配 SKILL.md 时优先使用同级目录下的 json 配置。
 
 本代码仓的 skill 是给 openclaw 使用的，以上原则是为了适配 openclaw 的规则。
 
@@ -61,10 +58,30 @@ metadata:
 - `always: true` 的真实语义是"跳过 `requires` 二进制/env 检查直接判定 eligible"（见 `config-eval.ts:124`），**不是**"强制注入整个 SKILL.md"。如果 skill 没声明 `requires`，加 `always: true` 等于无意义，应删除。
 - 加载阶段 openclaw 只把 `name` + `description` + SKILL.md 绝对路径塞进 system prompt 的 `<available_skills>` 块；agent 用到时才主动 read 全文。所以 frontmatter 写得再多也不会污染 system prompt，但反过来也意味着——除上述识别字段外，多余字段不会带来任何运行时收益。
 
-## addon 开发规则
+## skill 依赖打包规则
+
+产品拆分后（D8）addons/ 结构已销毁，skill 只有两层：
+
+- **公共 skill**：`skills/<name>/`（≥2 crew 共用，部署到 `~/.openclaw/skills/`）
+- **crew 专属 skill**：`crews/<crew-id>/skills/<name>/`
+
+涉及依赖包（python/node/go）的 skill，依赖统一在仓根 `requirements.txt` / `package.json` 声明，由 `scripts/install.sh` 一次性安装。不允许单独把某个 skill 配置成独立包。这样部署时自动完成初始化，降低部署工作和风险。务必遵守！
+
+### Python 依赖
+
+在仓根 `requirements.txt` 声明。`scripts/apply-addons.sh` 扫描 `skills/`、`crews/*/skills/`、仓根下所有 `requirements.txt`，合并去重后 `pip install --user`。内容哈希守卫，依赖集变化才重装。
+
+### Node 依赖
+
+每个用到外部 npm 包的 skill，**在自己目录下放一个 `package.json`** 声明 `dependencies`（`type: "module"` 若脚本用 ESM）。`scripts/apply-addons.sh` 扫描所有含 `SKILL.md + package.json` 的 skill 目录，per-skill `npm install --omit=dev`，`node_modules` 落在仓内 skill 目录（`.gitignore` 已覆盖）。内容哈希守卫，`package.json` 变了才重装。
+
+**不要**把 skill 的 Node 依赖写进仓根 `package.json`——`apply-addons.sh` 的 per-skill 扫描不读仓根 `package.json` 的 deps，写进去也不会被装。仓根 `package.json` 只管 `packageManager` 字段。
 
-wiseflow 通过 addon 提供增强能力，包括全局 skill 以及 crew 模板。
+**判断 skill 是否需要 `package.json`**：扫 skill 下所有 `.ts`/`.js`/`.mjs` 的 `import ... from "X"`，过滤掉 `node:` 内置和相对路径，若还有残留（如 `cheerio`、`rss-parser`），就需要。现状（2026-07-12 扫描）：
 
-务必注意一点：同一个 addon 中所有技能（不管是全局技能还是addon包含的 crew 的专属技能），如果涉及到依赖包（python、node、go）必须整合写到 addon 根目录下。也就是必须把 addon 整体作为一个 python 包或者 node 包，不允许单独把某个 skill 配置成一个包。
+| skill | 外部 npm 依赖 | 有 package.json |
+|-------|--------------|----------------|
+| `crews/main/skills/wx-mp-hunter` | `cheerio` | ✅ |
+| `crews/main/skills/rss-reader` | `rss-parser` | ✅ |
 
-这是为了应用 addon 时可以自动完成初始化，降低部署工作和风险。务必遵守！
+其余 skill 的脚本只用 Node 内置模块或相对 import，不需要 `package.json`。

Dockerfile

@@ -0,0 +1,116 @@
+# syntax=docker/dockerfile:1
+# wiseflow-client Dockerfile（多阶段，bake 出 ~/.openclaw 运行态）
+#
+# Phase 0 骨架：阶段 1-2 基本可构建；阶段 3-4 含 TODO，待 Phase 6-7
+# crew/skill 扁平化 + img-gen 改火山 + camoufox 指纹模板落地后填实。
+# 详见 docs/client-buildout.md 与 plan §六。
+
+# ── 阶段 1: workspace-deps ────────────────────────────────────────────────────
+# Node24 + pnpm + python3 + camoufox Firefox 二进制 + camoufox-cli(npm 全局)
+# 不 bake chromium（fallback attach 的是用户本机 Chrome；patchright-core 仅作
+# npm 依赖留给 connectOverCDP 驱动）。
+FROM node:24-bookworm AS workspace-deps
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3 python3-pip python3-venv \
+    ca-certificates curl git bash \
+    && rm -rf /var/lib/apt/lists/*
+RUN corepack enable && corepack prepare pnpm@latest --activate
+# camoufox-cli 全局 + 下载 Camoufox Firefox 二进制
+RUN npm install -g camoufox-cli@0.6.2 && camoufox-cli install --with-deps
+# patchright-core 留作 fallback connectOverCDP 驱动（不 bake chromium）
+# 在阶段 2 的 pnpm install 里通过 patches/overrides.sh 注入
+
+# ── 阶段 2: build ─────────────────────────────────────────────────────────────
+# COPY openclaw + apply patches（patchright override + 005/006）+ pnpm install + build + ui:build
+FROM workspace-deps AS build
+WORKDIR /opt/openclaw
+# openclaw/ 是 clone 的引擎源码（.gitignore 排除，build 期由 build-image.sh 检出注入）
+COPY openclaw/ ./openclaw/
+COPY patches/ ./patches/
+COPY openclaw.version openclaw-weixin.version.json ./
+# TODO(Phase 6): apply patches/overrides.sh（patchright override）+ 005/006
+# RUN bash patches/overrides.sh apply
+WORKDIR /opt/openclaw/openclaw
+RUN pnpm install --frozen-lockfile
+RUN pnpm build
+# TODO(Phase 6): ui:build（若 openclaw 含 UI 子包）
+# RUN pnpm --filter ui build
+
+# ── 阶段 3: wiseflow-layer ────────────────────────────────────────────────────
+# COPY skills/crews/config → 组织成 /root/.openclaw/ 运行态；统一 npm/pip install；
+# 编译改火山的 img-gen gen.py；生成 camoufox 冻结指纹模板。
+FROM build AS wiseflow-layer
+RUN mkdir -p /root/.openclaw
+# TODO(Phase 7): crews 扁平化后 COPY crews/ → /root/.openclaw/workspace-*/
+#   注意：Docker 不跑 setup-crew.sh，故不生成 OFB_ENV.md。AGENTS.md 已改为环境
+#   自感知（检测 /.dockerenv → 用固定路径 /opt/openclaw + /root/.openclaw），
+#   无需 OFB_ENV.md。源码部署仍由 setup-crew.sh 生成 OFB_ENV.md（路径可变）。
+# TODO(Phase 7): skills 公共/私有拆分后 COPY skills/ → /root/.openclaw/skills
+# Docker 与源码部署同源：均从 config-templates/openclaw.json 派生（单源）。
+# 源码部署由 setup-crew.sh §4 在此基础上合并 skills 过滤 / 路径规范化；
+# Docker 不跑 setup-crew.sh，直接用模板（content-producer 已在模板 agents.list 预注册）。
+COPY config-templates/openclaw.json /root/.openclaw/openclaw.json
+# 全仓 Python 依赖（Docker 不跑 apply-addons.sh，需在此 bake）
+# 与 scripts/apply-addons.sh 同源（仓根 requirements.txt），使用 aliyun 镜像保持一致
+COPY requirements.txt /tmp/wiseflow-requirements.txt
+RUN pip3 install --break-system-packages --quiet --no-warn-script-location \
+      -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com \
+      -r /tmp/wiseflow-requirements.txt \
+    && rm -f /tmp/wiseflow-requirements.txt
+# awada channel 插件：COPY 源码 + 预装 ws/zod 运行时依赖（awada 走 relay 网关 HTTP/WS 传输）。
+# awada 自己的 node_modules 解析这些依赖，不走 ~/.openclaw/node_modules，故必须装在 awada/ 局部。
+COPY awada/ /opt/openclaw/awada/
+RUN cd /opt/openclaw/awada && npm install --omit=dev --no-audit --no-fund --loglevel=warn
+# 把 awada 插件路径注入 openclaw.json（Docker 不跑 apply-addons.sh，需在此 bake）
+RUN node -e "\
+  const fs=require('fs');const p='/root/.openclaw/openclaw.json';\
+  const c=JSON.parse(fs.readFileSync(p,'utf8'));\
+  c.plugins=c.plugins||{};c.plugins.load=c.plugins.load||{};\
+  c.plugins.load.paths=Array.isArray(c.plugins.load.paths)?c.plugins.load.paths:[];\
+  c.plugins.load.paths=c.plugins.load.paths.filter(x=>!x.endsWith('/awada'));\
+  c.plugins.load.paths.push('/opt/openclaw/awada');\
+  c.plugins.entries=c.plugins.entries||{};\
+  if(!c.plugins.entries.awada)c.plugins.entries.awada={enabled:false};\
+  fs.writeFileSync(p,JSON.stringify(c,null,2)+'\n');"
+# TODO(Phase 6): 各 skill 的 npm/pip install 统一在此跑
+# TODO(Phase 5): img-gen gen.py 改火山生图编译
+# Phase 4.5.5: 冻结 camoufox 指纹模板（spike 报告 §"Spike ② D18 落地方式"）
+# 一次性 bootstrap：清空 profile dir → 跑一次 about:blank 生成 camoufox-cli.json
+# → close。运行时各 agent session cp 此模板到独立 profile dir 用
+# （D18：不 fork camoufox-cli；不 bake chromium；每 agent 一 session）。
+# camoufox-cli 默认 headless，无需额外 flag，避免依赖 Xvfb 虚拟显示（容器内 build 更稳）。
+# close --all 兜底清掉任何残留 daemon/进程，避免 build 上下文污染。
+#
+# 持久化模型（重要）：模板的指纹身份 camoufox-cli.json 落在
+# /root/.openclaw/logins/_template/ 下——这个路径在阶段 4 被 VOLUME 挂载。
+# Docker 首次启动一个空卷时会把镜像里该路径的内容拷进卷，所以模板在首次
+# 运行时可见；之后卷里的状态（含各 session cp 出来的指纹）跨容器重建保留。
+# 运行时各 session 的 profile dir 应指到 /root/.openclaw/logins/<session>/profile/
+# （已挂卷的子路径），别指到 /root/.camoufox-cli/profiles/ 那个默认位置——
+# 详见阶段 4 VOLUME 注释。
+RUN mkdir -p /root/.openclaw/logins/_template && \
+    rm -rf /root/.camoufox-cli/profiles/_template && \
+    camoufox-cli --session _template --persistent --json open about:blank && \
+    camoufox-cli --session _template close; \
+    camoufox-cli close --all 2>/dev/null || true; \
+    cp /root/.camoufox-cli/profiles/_template/camoufox-cli.json \
+       /root/.openclaw/logins/_template/camoufox-cli.json && \
+    echo "[wiseflow-layer] camoufox fingerprint template baked to /root/.openclaw/logins/_template"
+
+# ── 阶段 4: runtime ───────────────────────────────────────────────────────────
+# 复制产物 + 装 openclaw-weixin 插件(tgz) + ENTRYPOINT
+FROM wiseflow-layer AS runtime
+# TODO(Phase 6): 装 openclaw-weixin 插件 tgz（按 openclaw-weixin.version.json）
+# COPY openclaw-weixin-*.tgz /tmp/ && npm install -g /tmp/openclaw-weixin-*.tgz
+COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+# 持久化卷声明（compose 里用 named volume 挂，好备份好迁移）：
+#   /root/.openclaw       登录态/cookie 中央仓 + 各 session 指纹 profile（首选位置）
+#   /root/.camoufox-cli   camoufox-cli 配置 + 默认 profile dir + geoip/db 运行时缓存
+# 两块都挂卷，避免容器重建丢登录态/指纹/缓存。运行时 profile dir 推荐指到
+# /root/.openclaw/logins/<session>/profile/（上一卷的子路径，单卷管登录+指纹）；
+# /root/.camoufox-cli 这块兜底：非持久 session 的默认 profile、geoip db 等也留得住。
+VOLUME /root/.openclaw
+VOLUME /root/.camoufox-cli
+EXPOSE 18789
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]

LICENSE

@@ -1,22 +1,22 @@
 # Open Source License
 
-wiseflow is licensed under a modified version of MIT, with the following additional conditions:
+xiaobei is licensed under a modified version of MIT, with the following additional conditions:
 
-1. Wiseflow may be utilized commercially. Should the conditions below be met, a commercial license must be obtained from the producer:
+1. xiaobei may be utilized commercially. Should the conditions below be met, a commercial license must be obtained from the producer:
 
-a. Multi-tenant service: Unless explicitly authorized by Wiseflow in writing, you may not use the Wiseflow source code to operate a multi-tenant environment.
-    - Tenant Definition: Within the context of Wiseflow, one tenant corresponds to one workspace.
+a. Multi-tenant service: Unless explicitly authorized by xiaobei in writing, you may not use the xiaobei source code to operate a multi-tenant environment.
+    - Tenant Definition: Within the context of xiaobei, one tenant corresponds to one workspace.
  The workspace provides a separated area for each tenant's data and configurations.
 
-b. LOGO and copyright information: In the process of using Wiseflow's frontend, you may not remove or modify the LOGO or copyright information in the Wiseflow console or applications. This restriction is inapplicable to uses of Wiseflow that do not involve its frontend.
+b. LOGO and copyright information: In the process of using xiaobei's frontend, you may not remove or modify the LOGO or copyright information in the xiaobei console or applications. This restriction is inapplicable to uses of xiaobei that do not involve its frontend.
 
-    - Frontend Definition: For the purposes of this license, the "frontend" of Wiseflow includes all components located in the `web/` directory when running Wiseflow from the raw source code, or the "web" image when running Wiseflow with Docker.
+    - Frontend Definition: For the purposes of this license, the "frontend" of xiaobei includes all components located in the `web/` directory when running xiaobei from the raw source code, or the "web" image when running xiaobei with Docker.
 
-c. Prohibited usage: Using Wiseflow for commercial web crawling or data harvesting operations.
+c. Prohibited usage: Using xiaobei for commercial web crawling or data harvesting operations.
 
-d. Prohibited usage: Using Wiseflow for any unlawful or unauthorized scraping, including activities that violate applicable laws, website terms of service, or robots exclusion directives.
+d. Prohibited usage: Using xiaobei for any unlawful or unauthorized scraping, including activities that violate applicable laws, website terms of service, or robots exclusion directives.
 
-e. Prohibited usage: Using Wiseflow to obtain, copy, or distribute content from media platforms and trading platforms or other materials protected by third-party intellectual property rights, unless you have obtained prior explicit authorization from the rights holder.
+e. Prohibited usage: Using xiaobei to obtain, copy, or distribute content from media platforms and trading platforms or other materials protected by third-party intellectual property rights, unless you have obtained prior explicit authorization from the rights holder.
 
 2. As a contributor, you should agree that: