deepspider 0.2.9 → 0.2.10

package/.trellis/spec/backend/quality-guidelines.md

@@ -193,24 +193,48 @@ console.log('[DeepSpider:' + type + ']' + loc, data);
 
 ## Release Process
 
+### 原生模块依赖处理
+
+项目依赖 `isolated-vm` 等原生 C++ 模块，需要编译环境。
+
+**postinstall 自动处理**:
+```json
+{
+  "scripts": {
+    "postinstall": "patchright install chromium && npm rebuild isolated-vm 2>/dev/null || true"
+  }
+}
+```
+
+**编译环境要求**:
+- macOS: `xcode-select --install`
+- Ubuntu: `sudo apt install build-essential`
+- Windows: Visual Studio Build Tools
+
+> **注意**: `2>/dev/null || true` 确保编译失败不会阻塞安装，但沙箱功能可能不可用。
+
+---
+
 ### 版本发布流程
 
-升级版本时必须同步创建 git tag：
+升级版本并推送 tag，GitHub Actions 会自动发布到 npm：
 
 ```bash
 # 1. 升级 package.json 版本
-npm version patch --no-git-tag-version
+# 编辑 package.json 中的 version 字段
 
 # 2. 提交版本变更
 git add package.json
 git commit -m "chore: bump version to x.x.x"
 
 # 3. 创建并推送 git tag
-git tag vx.x.x
+git tag -a vx.x.x -m "vx.x.x"
 git push && git push origin vx.x.x
 ```
 
-**原因**: npm 版本和 git tag 需要保持同步，便于版本追踪和回溯。
+> **注意**: 推送 tag 后 GitHub Actions 会自动触发 npm 发布，无需手动 `npm publish`。
+
+**原因**: 自动化发布避免手动操作失误，确保版本一致性。
 
 ---
 

package/README.md

@@ -22,22 +22,23 @@
 ### 安装
 
 ```bash
-# 方式一：npm 全局安装
+# 方式一：npm 全局安装（推荐）
 npm install -g deepspider
 
-# 方式二：克隆仓库
+# 方式二：pnpm 全局安装
+pnpm approve-builds -g deepspider isolated-vm # 首次需要批准构建脚本
+pnpm install -g deepspider
+
+# 方式三：克隆仓库
 git clone https://github.com/ma-pony/deepspider.git
 cd deepspider
 pnpm install
-
-# 安装 Python 加密库（用于运行生成的 Python 代码）
-pnpm run setup:crypto
-
-# 配置环境变量
-cp .env.example .env
-# 编辑 .env 填入配置（见下方环境变量说明）
+cp .env.example .env  # 配置环境变量
+pnpm run setup:crypto  # 安装 Python 加密库（可选）
 ```
 
+安装完成后，首次运行会提示配置环境变量（LLM API）。
+
 > **注意**: 项目依赖 `isolated-vm` 原生模块，需要 C++ 编译环境：
 > - macOS: `xcode-select --install`
 > - Ubuntu: `sudo apt install build-essential`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepspider",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "智能爬虫工程平台 - 基于 DeepAgents + Patchright 的 AI 爬虫 Agent",
   "type": "module",
   "main": "src/index.js",

package/src/agent/setup.js

@@ -35,17 +35,13 @@ export function ensureConfig() {
 
 配置方式（任选其一）：
 
-1. 环境变量：
+1. 环境变量（推荐）：
    export DEEPSPIDER_API_KEY=sk-xxx
    export DEEPSPIDER_BASE_URL=https://api.openai.com/v1
    export DEEPSPIDER_MODEL=gpt-4o
 
-2. .env 文件（推荐）：
-   cp .env.example .env
-   # 编辑 .env 填入配置
-
-3. 一行命令：
-   DEEPSPIDER_API_KEY=sk-xxx DEEPSPIDER_BASE_URL=https://api.openai.com/v1 DEEPSPIDER_MODEL=gpt-4o npx deepspider <url>
+2. 一行命令：
+   DEEPSPIDER_API_KEY=sk-xxx DEEPSPIDER_BASE_URL=https://api.openai.com/v1 DEEPSPIDER_MODEL=gpt-4o deepspider <url>
 
 常用供应商配置：
    OpenAI:   BASE_URL=https://api.openai.com/v1      MODEL=gpt-4o