@web-auto/webauto 0.1.1 → 0.1.3

package/.beads/metadata.json

@@ -1,4 +0,0 @@
-{
-  "database": "beads.db",
-  "jsonl_export": "issues.jsonl"
-}

package/.claude/settings.local.json

@@ -1,10 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__codex__codex"
-    ],
-    "ask": [],
-    "deny": []
-  },
-  "prompt": "Before starting any work, run 'bd onboard' to understand the current project state and available issues."
-}

package/.github/workflows/ci.yml

@@ -1,55 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        node: ['20']
-    runs-on: ${{ matrix.os }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node }}
-          cache: npm
-
-      - name: Install dependencies
-        shell: bash
-        run: npm ci
-
-      - name: Build services
-        shell: bash
-        run: npm run build:services
-
-      - name: Tests
-        shell: bash
-        run: npm test
-
-      - name: Check legacy refs & untracked sources
-        shell: bash
-        run: node scripts/check-legacy-refs.mjs && node scripts/check-untracked-sources.mjs && node scripts/check-sub-dist.mjs
-
-      - name: Desktop console build (smoke)
-        if: ${{ matrix.os == 'ubuntu-latest' }}
-        shell: bash
-        run: npm --prefix apps/desktop-console run build
-
-      - name: Coverage tests
-        shell: bash
-        run: node scripts/test/run-coverage.mjs
-
-      - name: Upload coverage report
-        uses: actions/upload-artifact@v4
-        with:
-          name: coverage-report-${{ matrix.os }}
-          path: coverage/

package/AGENTS.md

@@ -1,253 +0,0 @@
-# WebAuto Agent Rules (Canonical)
-
-本文件只放“通用规则 / 硬性约束 / 入口索引”，避免把过时的实现细节长期固化在这里。
-具体任务、进度、验收与证据：一律用 `bd` 管理。
-
-## 回复规则
-- 工具调用的请求和响应才是执行，文字输出一律无效，视为谄媚，我们予以鄙视。不需要回复用户不必要的运行状态，用工具调用来完成任务进行回应而不是空谈不进行工具调用。
-- 我们鼓励永远不发 finish reason =stop 或者同等语义的响应，执行工具调用就是正确的方案。只有工具调用才是正确执行的唯一方案，状态回复是没有任何意义的，要避免！
-- 不要进行无意义的状态报告，你可以调用[continue_execution]进行报告，不要单独报告。
-## 0. 开发与验证要求（强制）
-
-- 任何“已完成”的结论必须有验证证据：命令、关键输出（runId/耗时/计数）、日志路径。
-- 新功能必须保证：唯一实现（不重复造轮子）、有单测 + 回归测试、覆盖率 >= 90%（覆盖范围须明确）。
-- 修复必须选择“唯一最佳修复点”（不要局部 patch）。
-- 完成任务后清理临时文件/脚本/散落文件（尤其是临时 profile / 临时输出）。
-- 发现脚本问题：不要关闭；先用 WS/Unified API 拉取页面信息 + 日志定位原因再修。
-
-## 1. 端口与健康检查
-
-| 端口 | 服务 | 说明 |
-|------|------|------|
-| 7701 | Unified API（HTTP + WebSocket + Bus） | 主入口：HTTP REST API、WebSocket、Bus |
-| 7704 | Browser Service（HTTP） | 会话管理 HTTP 接口 |
-| 8765 | Browser Service WebSocket | 会话管理实时通道 |
-
-快速验证：
-
-```bash
-curl http://127.0.0.1:7701/health
-curl http://127.0.0.1:7704/health
-```
-
-## 2. 分层与职责边界
-
-- 脚本：仅 CLI 参数解析，不含业务逻辑。
-- 模块：独立能力单元，通过 HTTP/WebSocket 通信。
-- 服务：无业务逻辑，纯技术实现。
-- UI：纯展示与触发（不做编排/逻辑判断）。
-- App/Orchestrator：负责编排与生命周期管理，把 UI 输入归一化成脚本/模块可执行参数。
-
-## 3. 小红书风控安全规则（一级规则）
-
-- 禁止构造 URL 直达搜索/详情；必须“页面内输入框搜索 + 回车”。
-- 禁止读取 `href` 后自行拼接详情链接（缺 `xsec_token` 会 404/风控）。
-- 详情链接必须通过“点击进入帖子后读取当前 URL（含 xsec_token）”。
-- 所有搜索必须先走 SearchGate（60s 窗口最多 2 次/同 key）。
-
-## 4. 系统级操作原则（强制）
-
-- 所有点击/输入/滚动/返回必须使用系统级 API（Playwright mouse/keyboard），禁止 DOM click/JS scroll/history.back。
-- 允许的 JS：仅用于读取状态（如 rect/可见性）。
-
-## 5. 视口约束（强制）
-
-- 所有操作必须基于视口内可见元素；离屏元素必须先滚动带入视口。
-- 每步操作需要 anchor + rect 验证，并支持高亮闭环。
-
-## 6. 调试与诊断（必须会用）
-
-- 出错时优先：
-  - 读取当前 URL/DOM 摘要/截图（通过 Unified API / WS）。
-  - 查看 `~/.webauto/logs` 与 `~/.webauto/download/.../run.log`、`run-events.jsonl`。
-
-常用脚本入口（示例）：
-
-- `node scripts/browser-status.mjs <profile> [--site xiaohongshu|weibo] [--url URL]`
-- `node scripts/container-op.mjs <profile> <containerId> <operationId> [--config JSON]`
-
-## 7. Beads (bd) 任务管理（强制）
-
-AGENTS.md 只放规则；所有具体任务/进度/证据都必须写到 bd。
-
-### bd 的 git 同步最佳实践（强制，团队统一）
-
-目标：团队只通过 git 同步 `.beads/issues.jsonl`（以及必要的元数据文件），**不提交本地数据库文件**，并把“忘了导出/导入”的风险降到最低。
-
-- **统一模式**：`bd sync mode set git-portable`
-- **一次性初始化**：`bd init`
-  - 若 main 受保护：用 `bd init --branch beads-sync` 建一个元数据分支
-- **自动护栏（强烈推荐）**：`bd hooks install`
-  - 安装 `pre-commit / post-merge / pre-push / post-checkout` 等 hooks
-  - 保证提交前 flush、拉取/切分支后 import、推送前不允许 stale
-- **日常最省心流程**：`git pull --rebase` → 正常 `bd create/update/close` → 正常 `git commit/push`
-  - hooks 会自动处理大部分同步
-- **关键时刻强制落盘**：会话结束/交接前跑一次 `bd sync`
-  - 把 debounce 窗口里的改动立刻刷到 JSONL
-- **仓库约定（必须遵守）**：git 只追踪以下文件：
-  - `.beads/issues.jsonl`
-  - `.gitattributes`
-  - `.beads/.gitignore`
-  - （以及 `.beads/` 目录本身）
-  - **禁止提交**：`.beads/beads.db` 等本地数据库文件
-- **git worktree 注意**：别开 daemon
-  - `export BEADS_NO_DAEMON=1` 或每次加 `--no-daemon`
-  - 主要依赖 hooks + 必要时手动 `bd sync`
-
-- 初始化（推荐个人本地，不污染仓库）：`bd init --stealth`
-- 查看可做任务：`bd ready`
-- 创建任务：`bd create "Title" -p 0 --description "..."`
-- 建依赖：`bd dep add <child> <parent>`
-- 看任务详情：`bd show <id>`
-- 搜索（全文检索）：`bd search "关键词"`
-- 列表筛选（字段过滤）：`bd list --status open --priority 1`
-
-bd 搜索速查（全文检索 + 字段过滤）：
-
-1) bd search：全文检索（标题/描述/ID）
-
-- 基础：
-  - `bd search "关键词"`
-  - `bd search "authentication bug"`
-  - `bd search "bd-a3f8"`
-  - `bd search --query "performance"`
-- 常用过滤：
-  - `bd search "bug" --status open`
-  - `bd search "database" --label backend --limit 10`
-  - `bd search "refactor" --assignee alice`
-  - `bd search "security" --priority-min 0 --priority-max 2`
-- 时间范围：
-  - `bd search "bug" --created-after 2025-01-01`
-  - `bd search "refactor" --updated-after 2025-01-01`
-  - `bd search "cleanup" --closed-before 2025-12-31`
-- 排序与展示：
-  - `bd search "bug" --sort priority`
-  - `bd search "task" --sort created --reverse`
-  - `bd search "design" --long`
-- sort 支持字段：`priority, created, updated, closed, status, id, title, type, assignee`
-
-2) bd list：字段级精确过滤（缩小范围）
-
-- 状态/优先级/类型：
-  - `bd list --status open --priority 1`
-  - `bd list --type bug`
-- 标签：
-  - `bd list --label bug,critical`
-  - `bd list --label-any frontend,backend`
-- 字段包含（子串）：
-  - `bd list --title-contains "auth"`
-  - `bd list --desc-contains "implement"`
-  - `bd list --notes-contains "TODO"`
-- 日期范围：
-  - `bd list --created-after 2024-01-01`
-  - `bd list --updated-before 2024-12-31`
-  - `bd list --closed-after 2024-01-01`
-- 空字段筛选：
-  - `bd list --empty-description`
-  - `bd list --no-assignee`
-  - `bd list --no-labels`
-- 优先级范围：
-  - `bd list --priority-min 0 --priority-max 1`
-  - `bd list --priority-min 2`
-- 组合过滤：
-  - `bd list --status open --priority 1 --label-any urgent,critical --no-assignee`
-
-任务描述必须包含：目标、验收标准、证据路径/命令（runId、日志路径）、禁止事项。
-
-## 8. 参考文档索引
-
-- `container-library/README.md`
-- `container-library/xiaohongshu/README.md`
-- `scripts/xiaohongshu/README.md`
-- `scripts/xiaohongshu/README-workflows.md`
-- `docs/arch/SEARCH_GATE.md`
-- `docs/arch/REGRESSION_CHECKLIST.md`
-
-## 9. 执行模式约束（强制）
-
-### 9.1 Daemon 模式（强制）
-- **所有后续执行必须使用 daemon 模式**，禁止前台阻塞执行
-- 目的：避免会话中断导致任务终止，保证长任务（采集、互动）持续运行
-- 使用方式：
-  ```bash
-  # 正确（daemon 模式，立即返回，后台持续执行）
-  node scripts/xiaohongshu/phase2-collect.mjs --keyword "xxx" --target 100 --env debug --profile xxx
-  
-  # 错误（前台模式，会话中断即终止）
-  node scripts/xiaohongshu/phase2-collect.mjs --keyword "xxx" ... --foreground
-  ```
-- 查看进度：
-  ```bash
-  tail -f ~/.webauto/logs/daemon.$(date +%Y-%m-%dT%H-%M-%S).log
-  # 或查看具体任务日志
-  tail -f ~/.webauto/download/xiaohongshu/debug/<keyword>/run.log
-  ```
-- 停止任务：
-  ```bash
-  # 找到 daemon PID
-  ps aux | grep "phase2-collect\|phase3-interact\|phase4-harvest"
-  # 或
-  cat ~/.webauto/daemon/*.pid
-  # 终止
-  kill <PID>
-  ```
-
-### 9.2 分片与多 Tab 约束（当前状态）
-- **当前未启用分片**：单账号单进程执行，无多账号并行
-- **当前已启用多 Tab（4-Tab 轮转）**：Phase3 启用 4-Tab 轮转，Phase4 保持单线程（详情页不支持多 Tab 并行），无 4-Tab 轮转
-- 如需启用分片/多 Tab，需先通过 bd 建立独立任务，验证通过后再写入本文件
-
-## 10. 开发指南（合规约束）
-
-- 所有修复/变更必须：先建 bd 任务 → 记录目标/验收/证据 → 执行 → 写入日志证据 → 关闭任务。
-- 任何验证结果必须包含：命令 + 关键输出（runId/耗时/计数）+ 日志路径。
-- 禁止“只口头说明”或“未调用工具”的执行声明。
-- 所有执行脚本必须使用 daemon 模式；前台执行仅允许在诊断短流程（≤30s）且需注明原因。
-- 修复完成需清理临时文件/临时脚本/临时输出；不要提交本地数据库或敏感信息。
-- 出错先拉取：URL/DOM 摘要/截图（Unified API/WS）+ 查看 ~/.webauto/logs 与 run.log/run-events.jsonl。
-- 服务与浏览器的启动/停止必须统一由 stop-all/core-daemon 管理，避免孤儿进程。
-- 点击/输入/滚动必须走系统级 API；JS 仅用于读取状态（rect/可见性）。
-
-
-## 11. LSP Code Analysis 使用规范（强制）
-
-### 11.1 强制前置流程（每次会话）
-
-1. 更新检查：`/Users/fanzhang/.codex/skills/lsp-code-analysis/scripts/update.sh`
-   - 若提示 `lsp` 不在 PATH，先执行：`export PATH="/Users/fanzhang/.local/bin:$PATH"`
-2. 启动 Server：`lsp server start <repo_path>`
-   - 若启动失败，**禁止进入任何 LSP 分析流程**
-3. 验证语言支持：`lsp server list` 必须看到当前仓库对应语言（如 `typescript <repo_path>`）
-
-### 11.2 入口流程（固定顺序）
-
-1. `lsp outline <file>`（先看结构）
-2. `lsp doc <file> --scope <symbol>`（看签名/类型）
-3. `lsp definition <file> --scope <symbol>`（跳定义）
-4. `lsp reference <file> --scope <symbol>`（看调用链）
-
-### 11.3 精准定位规则
-
-- 优先使用：`--scope <symbol_path>`（示例：`A.b.c`）
-- 需要精确点位时追加：`--find "<|>token"`
-- 大结果集必须使用：`--pagination-id` + `--max-items` + `--start-index`
-
-### 11.4 兜底规则
-
-- 只有 LSP 无法覆盖场景（注释、纯文本、日志串）才允许使用 `rg/read`
-
-### 11.5 会话收尾（强制）
-
-- 会话结束必须执行：`lsp server stop <repo_path>`，避免后台残留
-- 可选全局清理：`lsp server shutdown`
-
-## 12. Git 提交流程约束（强制）
-
-### 12.1 编译前门禁检查
-- **所有新代码文件必须先 git add 再编译**：`scripts/check-untracked-sources.mjs` 已在 `npm run prebuild` 中作为门禁。若存在未 track 的源码文件，编译失败。
-
-### 12.2 git add 前检查清单
-- **禁止临时文件入版本**：`git add` 前自检新增文件内容，排除测试用 `*.bak`、临时日志 `*.log`、调试产物、草稿文件等废文件。
-- **禁止空文件/占位文件**：禁止为了通过编译检查而创建空文件或无实际功能的占位文件。
-- **机制**：建议在个人环境配置 alias：`git add` 前运行 `node scripts/check-untracked-sources.mjs --staged-only`（若该脚本支持 staged-only 模式），或人工确认新增文件均为必需代码。
-- **违规处理**：若发现废文件通过 CI，提交者负责在后续 commit 中清理。

package/apps/desktop-console/README.md

@@ -1,27 +0,0 @@
-# WebAuto Desktop Console
-
-目标：提供一个 Electron（跨平台）多 Tab 管理台，用于管理 profile 登录池、流程调用与结果浏览。UI 仅负责参数/交互，实际业务执行仍走现有 `scripts/` 与 `dist/`。
-
-## 开发
-
-```bash
-# 从仓库根目录（推荐：通过 webauto CLI）
-npm link
-npm --prefix apps/desktop-console install
-npm --prefix apps/desktop-console run build
-npm run build:services
-webauto ui console
-
-# 或者直接进入目录
-cd apps/desktop-console
-npm install
-npm run build
-npm start
-```
-
-## Tabs
-
-- 预处理：ProfilePool 管理 + 批量登录/补登录
-- 调用：按模板拼装 CLI 参数并运行脚本（支持 `--dry-run`）
-- 结果：浏览 `~/.webauto/download` 并预览截图
-- 设置：优先保存到 `~/.webauto/config.json` 的 `desktopConsole` 配置块（如 `dist/modules/config` 不存在则 fallback 到 legacy settings 文件）