Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 0 additions & 21 deletions .claude/20260307_done.md

This file was deleted.

5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
# v5.2

- combine ofb and wiseflow
- publish sales-db and self-media operator

# v5.0

upgrage workflow to Agent!
Expand Down
70 changes: 0 additions & 70 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,76 +2,6 @@

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Wiseflow v5.x is an **OpenClaw_for_business add-on** that enhances browser automation with anti-detection capabilities for [openclaw](https://github.com/openclaw/openclaw). It replaces Playwright with Patchright (undetected fork) and adds tab recovery, agent skills, and anti-bot strategies. In future, it may add some extension/plugin to openclaw.

The distributable unit is the `wiseflow/` directory, which would be applied to OpenClaw by a script developed by another team: https://github.com/bigbrother666sh/openclaw_for_business/blob/main/scripts/apply-addons.sh.

we must keep working with both the latest openclaw project and openclaw_for_business project.

**OpenClaw_for_business is also called "OFB" for short.**

## OpenClaw_for_business Add-on Architecture

### Three-Layer Add-on Loading

OpenClaw_for_business's `apply-addons.sh` processes our add-ons in this order:

1. **`overrides.sh`** — pnpm overrides that swap `playwright-core` → `patchright-core` at the package manager level. Controlled by `PATCHRIGHT_VERSION` env var (default: 1.57.0). Also patches documentation references.

2. **`patches/*.patch`** — Git patches applied to OpenClaw source. Currently `001-browser-tab-recovery.patch` adds snapshot-based tab recovery when the target tab disappears mid-session.

**must use scripts/generate-patch.sh to generate the final patch file**

3. **`skills/*/SKILL.md`** — Agent skill definitions installed into OpenClaw's skill system. `browser-guide/SKILL.md` teaches the agent login wall handling, CAPTCHA strategies, lazy-load scrolling, paywall detection, and tab cleanup.

### Key Files

| Path | Purpose |
|------|---------|
| `wiseflow/addon.json` | Package manifest (name, version, openclaw dependency) |
| `wiseflow/overrides.sh` | pnpm override script, receives `$ADDON_DIR` and `$OPENCLAW_DIR` |
| `wiseflow/patches/001-browser-tab-recovery.patch` | Tab resilience patch for browser tool |
| `wiseflow/skills/browser-guide/SKILL.md` | Agent browser best practices |
| `tests/run-managed-tests.mjs` | Automated test suite (Node.js ESM) |
| `docs/anti-detection-research.md` | Technical analysis of detection mechanisms |
| `version` | Current version string (v5.0) |

### Deployment Model

```
openclaw_for_business/
addons/
wiseflow/ ← copy of wiseflow/ directory
addon.json
overrides.sh
patches/
skills/
```

Install: copy `wiseflow/` → `<openclaw>/addons/wiseflow`, then restart OpenClaw.

## Development Workflow

### 远程仓库

- **origin** → `git@github.com:bigbrother666sh/wiseflow.git`(个人开发仓库)
- **upstream** → `git@github.com:TeamWiseFlow/wiseflow.git`(TeamWiseflow 正式发布仓库)

### 开发流程与注意事项

1. 默认在 `master` 分支上开发,按需创建功能分支
2. 本项目是基于 openclaw 进行 patch,同时必须遵循 openclaw_for_business(OFB)的 add-on 加载机制。因此你应该保证在 代码仓根目录始终克隆一份来自 https://github.com/openclaw/openclaw 的代码,同时下载一份 https://github.com/bigbrother666sh/openclaw_for_business/blob/main/scripts/apply-addons.sh
每次开发前都应该进行一次拉取,然后基于最新的 openclaw 代码进行开发,并保证最后的产出适配 apply-addons.sh
3. 遵循 tdd(测试驱动开发)流程,每次开发之后必须进行完整测试
4. 本项目建立在其他一些开源项目基础上,比如[patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright), 随着项目发展,你需要记录一份我们的依赖清单,对于每一个你都可以 clone 一份代码到项目根目录下,以便随时查看我们是否有必要跟着升级,但记得同步更新 .gitignore 文件, 避免混入提交
5. 开发完成后推送到 **origin**(个人仓库)
6. 阶段性成果通过 GitHub PR 从 origin 合并到 **upstream**(TeamWiseflow 正式仓库)
7. **upstream**(TeamWiseflow 正式仓库)每次合并 PR 后自动更新版本号并触发 release 打包发布

注:有时我会通过在 .claude/ 中留下 TODO.md 的方式下发开发任务,这些任务你完成后需要把 TODO.md 改名为 {date}_done.md

### 版本管理

版本号存储在 `version` 文件中,格式为 `vMAJOR.MINOR.PATCH`。当 PR 合并到 upstream 的 master 时,GitHub Action 自动递增版本号并创建 Release。通过 PR 标签控制递增类型:
Expand Down
4 changes: 2 additions & 2 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Open Source License

wiseflow is licensed under a modified version of the Apache License 2.0, with the following additional conditions:
wiseflow 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:

Expand All @@ -27,4 +27,4 @@ Apart from the specific conditions mentioned above, all other rights and restric

The interactive design of this product is protected by appearance patent.

© 2025 Team Wiseflow
© 2026 Team Wiseflow
Loading
Loading