@qqbrowser/openclaw-qbot 0.0.88 → 0.0.90

package/docs/competitor-openclaw-analysis.md

@@ -1,390 +0,0 @@
-# 竞品 OpenClaw 包裁剪方案分析
-
-> 分析时间：2026-03-23
-> 竞品版本：openclaw@2026.3.13
-> 我们版本：@qqbrowser/openclaw-qbot@0.0.86
-> 竞品安装路径：`/Applications/QClaw.app/Contents/Resources/openclaw/`
-> 我们安装路径：`~/.openclaw-qbot/node/lib/node_modules/@qqbrowser/openclaw-qbot/`
-
----
-
-## 1. 总体数据对比
-
-| 维度 | 竞品 (openclaw) | 我们 (@qqbrowser/openclaw-qbot) | 差距 |
-|------|-----------------|--------------------------------|------|
-| **整个安装目录** | **431M** | **675M** | 1.6x |
-| **包自身大小** | 103M | — (包含在总大小中) | — |
-| **node_modules 总大小** | 249M (含 openclaw 103M) | 584M | 2.3x |
-| **node_modules 依赖数量** | 495 | 644 | +149 个 |
-| **dist 目录** | 68M | 56M | 我们更小 ✅ |
-| **extensions 目录** | 17M | 17M | 持平 |
-| **docs 目录** | 15M | 15M | 持平 |
-| **assets 目录** | 1.3M | 1.3M | 持平 |
-| **skills 目录** | 468K | 572K | 接近 |
-
-### 关键结论
-
-包自身内容（dist/extensions/docs/assets/skills）两边基本一致，**差距主要在 node_modules（依赖）**。
-
----
-
-## 2. 竞品的安装架构
-
-### 2.1 包装项目模式
-
-竞品**没有直接安装 openclaw 包**，而是使用了一个**独立的包装项目**：
-
-```json
-// /Applications/QClaw.app/Contents/Resources/openclaw/package.json
-{
-  "name": "@guanjia-openclaw/openclaw",
-  "version": "0.0.1",
-  "private": true,
-  "scripts": {
-    "postinstall": "npx patch-package"
-  },
-  "dependencies": {
-    "openclaw": "2026.3.13"
-  }
-}
-```
-
-**优势**：
-- 通过外层 package.json 精确控制安装行为
-- 可使用 `npm install --omit=optional` 跳过可选依赖
-- 安装后可通过脚本做二次清理/prune
-- 利用 `patch-package` 修改参数而不引入新依赖
-
-### 2.2 使用 npm 而非 pnpm
-
-竞品使用 **npm** 安装（有 `package-lock.json`），而我们用的是 **pnpm**。npm 的扁平化 node_modules 结构在这种场景下更容易做后处理清理。
-
-### 2.3 patch-package 调参
-
-竞品通过 `patches/openclaw+2026.3.13.patch` 直接修改 dist 中的构建产物，调整运行参数：
-
-```diff
-- const BASE_RUN_RETRY_ITERATIONS = 24;
-+ const BASE_RUN_RETRY_ITERATIONS = 0;
-- const RUN_RETRY_ITERATIONS_PER_PROFILE = 8;
-+ const RUN_RETRY_ITERATIONS_PER_PROFILE = 6;
-- const MIN_RUN_RETRY_ITERATIONS = 32;
-- const MAX_RUN_RETRY_ITERATIONS = 160;
-+ const MIN_RUN_RETRY_ITERATIONS = 6;
-+ const MAX_RUN_RETRY_ITERATIONS = 72;
-```
-
-### 2.4 config 目录
-
-竞品还有一个独立的 `config/` 目录，放置自定义的 `openclaw.json`、扩展和技能配置，与 openclaw 包解耦。
-
----
-
-## 3. 依赖差异分析
-
-### 3.1 我们有但竞品没有的 dependencies（共 12 个）
-
-| 依赖包 | 版本 | 安装大小 | 说明 |
-|--------|------|----------|------|
-| `@anthropic-ai/sandbox-runtime` | ^0.0.42 | 8.4M | 沙箱运行时，会拉入 @cloudflare 等 |
-| `@opentelemetry/api` | 1.9.0 | — | 遥测 API |
-| `@opentelemetry/exporter-metrics-otlp-http` | 0.213.0 | — | 遥测指标导出 |
-| `@opentelemetry/exporter-metrics-otlp-proto` | 0.213.0 | — | 遥测指标导出 |
-| `@opentelemetry/exporter-trace-otlp-proto` | 0.213.0 | — | 遥测追踪导出 |
-| `@opentelemetry/resources` | 2.6.0 | — | 遥测资源 |
-| `@opentelemetry/sdk-metrics` | 2.6.0 | — | 遥测指标 SDK |
-| `@opentelemetry/sdk-trace-base` | 2.6.0 | — | 遥测追踪基础 |
-| `@opentelemetry/sdk-trace-node` | 2.6.0 | — | 遥测追踪 Node |
-| `@opentelemetry/semantic-conventions` | 1.40.0 | — | 遥测语义约定 |
-| `tsx` | ^4.21.0 | — | TS 运行时（会拉入 esbuild） |
-| `uuid` | ^10.0.0 | — | UUID 生成 |
-
-**@opentelemetry 系列 9 个包合计安装大小：33M**
-
-### 3.2 竞品有但我们没有的 dependencies
-
-**无。** 竞品的 55 个 dependencies 是我们 67 个 dependencies 的子集。
-
-### 3.3 peerDependencies 对比
-
-| 维度 | 竞品 | 我们 |
-|------|------|------|
-| `@napi-rs/canvas` | ✅ peer (^0.1.89) | ✅ peer (^0.1.89) |
-| `node-llama-cpp` | ✅ peer (3.16.2) | ✅ peer (3.16.2) |
-| **peerDependenciesMeta** | ✅ `node-llama-cpp: { optional: true }` | ❌ **没有** |
-
-> ⚠️ **关键差异**：竞品通过 `peerDependenciesMeta` 将 `node-llama-cpp` 标记为可选，npm 安装时不会自动安装它。
-
----
-
-## 4. 竞品未安装的大依赖（安装后清理/跳过）
-
-### 4.1 通过 npm --omit=optional 跳过的可选依赖
-
-lockfile 中标记为 `optional` 的包有 **84 个**，其中 **75 个实际未安装**。主要包括：
-
-| 包名 | lockfile 中标记 | 实际安装 | 我们是否安装 | 我们的大小 |
-|------|----------------|---------|-------------|-----------|
-| `koffi` | optional: true | ❌ | ✅ | **87M** |
-| `@img/sharp-*` (29个) | optional: true | ❌ | ✅ (当前平台) | **16M** |
-| `@napi-rs/canvas-*` | optional: true | ❌ | ✅ (当前平台) | **26M** |
-| `@node-llama-cpp/*` | optional: true | ❌ | ✅ | **5M** |
-| `@cloudflare/workers-types` | optional: true | ❌ | ✅ | 9.2M |
-| `@lydell/node-pty-*` (平台包) | optional: true | 仅当前平台 | ✅ | — |
-| `@esbuild/*` | optional: true | ❌ | ✅ | 10M |
-
-### 4.2 安装后手动删除的包
-
-以下包在竞品的 lockfile 中**未标记为 optional**，但实际**不存在于 node_modules** 中，推测是安装后手动删除的：
-
-| 包名 | lockfile optional 标记 | 实际安装 | 说明 |
-|------|----------------------|---------|------|
-| `pdfjs-dist` | ❌ (非 optional) | ❌ 不存在 | 安装后被手动删除 |
-| `sharp` | ❌ (非 optional) | ❌ 不存在 | 安装后被手动删除 |
-
-> 💡 **推断**：竞品在打包进 App Bundle 前，通过构建脚本删除了 `pdfjs-dist`(40M) 和 `sharp`(含 @img 16M) 等运行时不必要的重包。
-
----
-
-## 5. 我们独有的大依赖汇总
-
-以下是我们安装了但竞品没有安装的大依赖，按大小排序：
-
-| 排名 | 包名 | 大小 | 来源 |
-|------|------|------|------|
-| 1 | `koffi` | **87M** | `@mariozechner/pi-tui` 的 optionalDep |
-| 2 | `pdfjs-dist` | **40M** | 直接 dependency |
-| 3 | `node-llama-cpp` | **35M** | peerDependency（竞品标记为 optional） |
-| 4 | `@opentelemetry/*` (9个包) | **33M** | 我们独有的 dependencies |
-| 5 | `@napi-rs/canvas-darwin-arm64` | **26M** | peerDependency 的平台包 |
-| 6 | `@img/sharp-*` | **16M** | sharp 的 native bindings |
-| 7 | `@octokit/*` | **12M** | @anthropic-ai/sandbox-runtime 传递依赖 |
-| 8 | `@esbuild/darwin-arm64` | **10M** | tsx 传递依赖 |
-| 9 | `@cloudflare/*` | **9.2M** | @anthropic-ai/sandbox-runtime 传递依赖 |
-| 10 | `@anthropic-ai/sandbox-runtime` | **8.4M** | 我们独有的 dependency |
-| 11 | `@types/*` | **8.0M** | 类型声明（生产环境不需要） |
-| 12 | `@node-llama-cpp/*` | **5.0M** | node-llama-cpp 的平台包 |
-| | **合计** | **~290M** | |
-
----
-
-## 6. 竞品 node_modules 大小 TOP 15
-
-| 排名 | 包名 | 大小 |
-|------|------|------|
-| 1 | openclaw (包自身) | 103M |
-| 2 | @mariozechner/* | 14M |
-| 3 | @google/genai | 11M |
-| 4 | @larksuiteoapi/node-sdk | 10M |
-| 5 | playwright-core | 8M |
-| 6 | openai | 7M |
-| 7 | @whiskeysockets/baileys | 7M |
-| 8 | web-streams-polyfill | 6M |
-| 9 | @mistralai/mistralai | 6M |
-| 10 | @line/bot-sdk | 6M |
-| 11 | zod | 5M |
-| 12 | @aws-sdk/* | 4M |
-| 13 | highlight.js | 3M |
-| 14 | @sinclair/typebox | 3M |
-| 15 | @silvia-odwyer/photon-node | 3M |
-
-> 竞品最大的非 openclaw 包仅 14M，没有任何超大的 native 依赖。
-
----
-
-## 7. 裁剪策略总结
-
-```
-竞品裁剪方案
-├── 1. 包装项目架构
-│   ├── 用独立的 private package.json 包装 openclaw
-│   ├── 使用 npm (非 pnpm) 安装
-│   └── 可控的安装参数 (--omit=optional)
-│
-├── 2. 依赖精简（少了 12 个 dependencies）
-│   ├── 不声明 @opentelemetry/* (9个包，33M)
-│   ├── 不声明 @anthropic-ai/sandbox-runtime (8.4M + 传递依赖 21M)
-│   ├── 不声明 tsx (传递拉入 @esbuild 10M)
-│   └── 不声明 uuid
-│
-├── 3. peerDependenciesMeta 控制
-│   └── node-llama-cpp 标记为 optional: true (35M + @node-llama-cpp 5M)
-│
-├── 4. npm --omit=optional 跳过可选依赖
-│   ├── koffi (87M) - @mariozechner/pi-tui 的 optionalDep
-│   ├── @img/sharp-* (16M) - sharp 的 native bindings
-│   ├── @napi-rs/canvas-* (26M) - peerDep 的平台包
-│   ├── @esbuild/* (10M)
-│   └── @cloudflare/workers-types (9.2M)
-│
-├── 5. 安装后手动删除
-│   ├── pdfjs-dist (40M) - 声明了但安装后删除
-│   └── sharp (含 native，声明了但安装后删除)
-│
-└── 6. patch-package 调参
-    └── 修改 dist 中的运行参数，无需引入额外依赖
-```
-
----
-
-## 8. 我们的优化建议
-
-### P0 - 立即可做（预计节省 ~200M）
-
-#### 8.1 添加 peerDependenciesMeta
-
-在 `package.json` 中添加：
-
-```json
-"peerDependenciesMeta": {
-  "node-llama-cpp": {
-    "optional": true
-  }
-}
-```
-
-**预计节省**：~40M（node-llama-cpp 35M + @node-llama-cpp 5M）
-
-#### 8.2 安装时使用 --omit=optional
-
-安装命令改为：
-
-```bash
-npm install --omit=optional
-```
-
-或配置 `.npmrc`：
-
-```ini
-optional=false
-```
-
-**预计节省**：~148M（koffi 87M + @img 16M + @napi-rs 26M + @esbuild 10M + @cloudflare 9M）
-
-### P1 - 需要代码改动（预计节省 ~74M）
-
-#### 8.3 将 @opentelemetry/* 改为可选/动态加载
-
-将 9 个 @opentelemetry 包从 `dependencies` 移除，改为动态 `import()` 按需加载：
-
-```typescript
-// 改为运行时按需加载
-let otel: typeof import('@opentelemetry/api') | undefined;
-try {
-  otel = await import('@opentelemetry/api');
-} catch {
-  // OpenTelemetry 不可用，静默降级
-}
-```
-
-**预计节省**：33M
-
-#### 8.4 移除 @anthropic-ai/sandbox-runtime
-
-从 `dependencies` 中移除，改为可选或运行时按需安装。
-
-**预计节省**：8.4M 直接 + ~21M 传递依赖（@octokit 12M + @cloudflare 9.2M）
-
-#### 8.5 移除 tsx
-
-构建后不再需要 TypeScript 运行时，`tsx` 会拉入 `esbuild`。
-
-**预计节省**：~10M
-
-### P2 - 安装后清理（预计节省 ~56M）
-
-#### 8.6 安装后删除 pdfjs-dist 和 sharp
-
-学习竞品做法，如果这两个包在桌面端不需要，安装后手动删除：
-
-```bash
-rm -rf node_modules/pdfjs-dist    # 40M
-rm -rf node_modules/sharp         # 含 native
-rm -rf node_modules/@img           # 16M
-```
-
-**预计节省**：~56M
-
-#### 8.7 清理 @types/* 和 bun-types
-
-生产安装中不需要类型声明包：
-
-```bash
-rm -rf node_modules/@types         # 8M
-```
-
-**预计节省**：~8M
-
-### P3 - 架构优化
-
-#### 8.8 采用包装项目模式
-
-学习竞品，用独立的安装 package.json 精确控制依赖树：
-
-```json
-{
-  "name": "@qqbrowser/openclaw-wrapper",
-  "private": true,
-  "scripts": {
-    "postinstall": "npx patch-package"
-  },
-  "dependencies": {
-    "@qqbrowser/openclaw-qbot": "0.0.86"
-  }
-}
-```
-
-### 优化效果预估
-
-| 优先级 | 措施 | 预计节省 | 实施难度 |
-|--------|------|----------|----------|
-| P0 | peerDependenciesMeta + --omit=optional | ~188M | 低 |
-| P1 | 移除 @opentelemetry/sandbox-runtime/tsx | ~74M | 中 |
-| P2 | 安装后清理 pdfjs-dist/sharp/@types | ~64M | 低 |
-| P3 | 包装项目架构 | 整体可控 | 中 |
-| **总计** | | **~326M** | |
-
-优化后预计总安装大小：**675M - 326M ≈ 349M**，接近竞品的 431M 水平。
-
----
-
-## 附录 A：竞品目录结构
-
-```
-/Applications/QClaw.app/Contents/Resources/openclaw/
-├── config/
-│   ├── extensions/        # 扩展配置
-│   ├── skills/            # 技能配置
-│   └── openclaw.json      # 主配置文件
-├── node_modules/          # 249M, 495 个依赖
-│   ├── openclaw/          # 103M (包自身)
-│   │   ├── dist/          # 68M
-│   │   ├── extensions/    # 17M
-│   │   ├── docs/          # 15M
-│   │   ├── assets/        # 1.3M
-│   │   ├── skills/        # 468K
-│   │   └── openclaw.mjs   # 4K (入口)
-│   ├── @mariozechner/*    # 14M
-│   ├── @google/genai      # 11M
-│   └── ... (其余 ~146M)
-├── patches/
-│   └── openclaw+2026.3.13.patch  # 参数调整补丁
-├── package.json           # 包装项目
-└── package-lock.json      # npm lock 文件
-```
-
-## 附录 B：files 字段对比
-
-| 竞品 | 我们 |
-|------|------|
-| CHANGELOG.md | CHANGELOG.md |
-| LICENSE | LICENSE |
-| openclaw.mjs | openclaw.mjs |
-| README-header.png | **preset-config.json** ← 我们独有 |
-| README.md | README-header.png |
-| assets/ | README.md |
-| dist/ | assets/ |
-| docs/ | dist/ |
-| extensions/ | docs/ |
-| skills/ | extensions/ |
-| | skills/ |