yiyan-browser-agent 1.10.1 → 1.10.2

package/CHANGELOG.md

@@ -32,6 +32,71 @@ This project uses [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [1.10.2] — 2026-06-02
+
+### 🎛️ Parameter Enhancement
+
+**新增 `--headless` 参数支持交互模式无头运行**
+
+- **NEW: `--headless` parameter** (`src/index.js`)
+  - 强制使用无头模式（即使交互模式）
+  - 优先级高于 `--show-browser` 参数
+  - 适合后台服务部署
+
+- **CHANGED: HEADLESS 优先级逻辑**
+  ```
+  优先级（从高到低）:
+  1. --headless        强制无头
+  2. --show-browser    强制有头
+  3. 模式默认          单任务无头，交互有头
+  ```
+
+- **NEW: 冲突处理**
+  - `yiyan-agent -i --headless --show-browser` → HEADLESS = true
+  - `--headless` 优先级高于 `--show-browser`
+
+- **ENHANCED: Help documentation**
+  - 清晰说明优先级规则
+  - 提供示例场景
+  - 浏览器显示逻辑说明
+
+### Usage Examples
+
+**单任务模式:**
+```bash
+yiyan-agent "创建文件"          # 无头模式（默认）
+yiyan-agent --show-browser      # 强制有头
+```
+
+**交互模式:**
+```bash
+yiyan-agent -i                  # 有头模式（默认，便于调试）
+yiyan-agent -i --headless       # 无头模式（后台服务）
+```
+
+**后台服务部署:**
+```bash
+# 启动无头交互服务器
+yiyan-agent -i --headless
+
+# 客户端提交任务（自动转发到服务器）
+yiyan-agent "创建 Express 项目"
+```
+
+### Test Results
+
+```
+HEADLESS 参数测试: 8/8 passed (100%)
+- 单任务默认无头 ✓
+- 交互默认有头 ✓
+- --headless 强制无头 ✓
+- --show-browser 强制有头 ✓
+- 参数优先级正确 ✓
+- 冲突处理正确 ✓
+```
+
+---
+
 ## [1.10.1] — 2026-06-02
 
 ### ⚡ Performance Optimization

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yiyan-browser-agent",
-  "version": "1.10.1",
-  "description": "AI coding agent powered by Yiyan (文心一言) via browser automation — no API key needed. Performance-optimized with aggressive timing configuration (30-40% faster). Enhanced with comprehensive security: command validation, path traversal protection, and file overwrite protection.",
+  "version": "1.10.2",
+  "description": "AI coding agent powered by Yiyan (文心一言) via browser automation — no API key needed. Performance-optimized (30-40% faster). New --headless parameter for interactive mode. Enhanced with comprehensive security.",
   "main": "src/index.js",
   "bin": {
     "yiyan-agent": "src/index.js",

package/src/index.js

@@ -11,13 +11,14 @@ const AgentClient = require('./client');
 
 function parseArgs(argv) {
   const args = argv.slice(2);
-  const opts = { task: null, interactive: false, debug: false, showBrowser: false, workingDir: null, calibrate: false, help: false };
+  const opts = { task: null, interactive: false, debug: false, showBrowser: false, headless: false, workingDir: null, calibrate: false, help: false };
 
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a === '-i' || a === '--interactive') opts.interactive = true;
     else if (a === '--debug') opts.debug = true;
     else if (a === '--show-browser') opts.showBrowser = true;
+    else if (a === '--headless') opts.headless = true;  // 新增：强制无头模式
     else if (a === '--calibrate') opts.calibrate = true;
     else if (a === '-h' || a === '--help') opts.help = true;
     else if (a === '-d' || a === '--dir') opts.workingDir = args[++i];
@@ -37,10 +38,22 @@ USAGE
 
 OPTIONS
   -i, --interactive    交互模式（启动 TCP 服务，端口 9527）
-  --show-browser       显示浏览器
+  --show-browser       显示浏览器（强制有头模式）
+  --headless           无头模式（强制隐藏浏览器，即使交互模式）
   --debug              调试模式
   -h, --help           帮助
 
+浏览器显示逻辑（优先级从高到低）
+  1. --headless        强制无头（隐藏浏览器）
+  2. --show-browser    强制有头（显示浏览器）
+  3. 模式默认          单任务无头，交互模式有头
+
+示例
+  yiyan-agent "创建文件"          # 无头模式执行（默认）
+  yiyan-agent -i                  # 有头模式交互（默认显示浏览器）
+  yiyan-agent -i --headless       # 无头模式交互（后台运行，不显示浏览器）
+  yiyan-agent --show-browser      # 强制显示浏览器
+
 进程间通信
   当交互模式运行时，其他 yiyan-agent 进程会自动检测并转发任务，
   避免每次重新启动浏览器。
@@ -56,8 +69,21 @@ async function main() {
 
   if (opts.debug) config.DEBUG = true;
 
-  // Headless: 单任务默认隐藏，交互模式显示
-  config.HEADLESS = !(opts.interactive || opts.calibrate || opts.showBrowser);
+  // ── Headless 配置优先级逻辑 ─────────────────────────────────────────────
+  // 优先级：--headless > --show-browser > 模式默认
+  if (opts.headless) {
+    // 用户明确指定无头模式（最高优先级）
+    config.HEADLESS = true;
+  } else if (opts.showBrowser) {
+    // 用户明确指定有头模式
+    config.HEADLESS = false;
+  } else if (opts.interactive || opts.calibrate) {
+    // 交互模式和校准模式默认有头（便于调试）
+    config.HEADLESS = false;
+  } else {
+    // 单任务模式默认无头（性能优先）
+    config.HEADLESS = true;
+  }
 
   if (opts.workingDir) {
     const resolved = path.resolve(opts.workingDir);