yiyan-browser-agent 1.11.1 → 1.11.2

package/README.md

@@ -82,55 +82,38 @@ npx playwright install-deps chromium  # 安装系统依赖
 
 ## 🚀 Quick Start
 
-### Windows
+### 第一步：登录文心一言（首次使用）
 
-**1. 首次运行 — 登录文心一言:**
+**Windows:**
 ```powershell
 yiyan-agent -i
 ```
-浏览器窗口打开后，登录你的百度账号，然后回到终端按 Enter。会话会保存 — 只需登录一次。
-
-**2. 给任务:**
-```powershell
-yiyan-agent "创建一个 Express REST API，带用户认证"
-```
-
-**3. 发送任务到已运行的服务器:**
-```powershell
-# 终端 1: 启动交互模式 (作为 HTTP 服务器)
+**Linux / macOS:**
+```bash
 yiyan-agent -i
-
-# 终端 2: 发送任务 (转发到服务器，不启动新浏览器)
-yiyan-agent "上海天气，20个字"
 ```
+浏览器窗口打开后，登录你的百度账号，然后回到终端按 Enter。会话会保存 — 只需登录一次。
 
-### Ubuntu / Linux
+### 第二步：通过 HTTP API 发送任务
 
-**1. 首次运行 — 登录文心一言:**
-```bash
-yiyan-agent -i
-```
+登录完成后，交互模式会自动启动 HTTP 服务（端口 9527），通过 API 发送任务：
 
-**2. 给任务:**
 ```bash
-yiyan-agent "build a REST API in Express with user authentication"
+curl -X POST http://localhost:9527/task \
+  -H "Content-Type: application/json" \
+  -d '{"task": "创建一个 Express REST API，带用户认证"}'
 ```
 
-**3. 从任意目录使用短别名 `ya`:**
-```bash
-cd ~/my-project
-ya "add input validation to all my API routes"
-```
+> 💡 更多用法见 [HTTP API](#-http-api) 章节。
 
 ---
 
 ## 💻 Usage
 
 ```
-yiyan-agent [OPTIONS] [TASK]
+yiyan-agent [OPTIONS]
 
-  -t, --task <task>    Task to run (or just type it as the last argument)
-  -i, --interactive    Keep browser open, run multiple tasks (starts HTTP server)
+  -i, --interactive    Start interactive mode with HTTP server on port 9527
   -d, --dir <path>     Set working directory (default: current directory)
   --debug              Print raw AI responses to the terminal
   --show-browser       Show browser window (non-interactive mode)
@@ -141,22 +124,22 @@ Aliases:
   ya                   Short form of yiyan-agent
 ```
 
-### Examples
+### 典型工作流
 
 ```bash
-# Single task — runs and exits
-yiyan-agent "create a Python script that scrapes Hacker News"
-
-# Interactive mode — keeps browser open, starts HTTP server on port 9527
+# 1. 启动交互模式（登录 + 启动 HTTP 服务）
 yiyan-agent -i
+# → Server listening on port 9527
 
-# Run on a specific project
-ya --dir ~/projects/my-app "refactor all callbacks to async/await"
+# 2. 通过 HTTP API 发送任务（另开终端）
+curl -X POST http://localhost:9527/task \
+  -H "Content-Type: application/json" \
+  -d '{"task": "创建一个 Python 爬虫"}'
 
-# Debug mode (shows what Yiyan is actually outputting)
-ya --debug "build a calculator"
+# 3. 查看任务状态
+curl http://localhost:9527/status
 
-# In interactive mode, type 'quit' or 'q' to exit:
+# 在交互模式中，输入 quit 或 q 退出：
 ❯ quit
 ```
 
@@ -193,9 +176,10 @@ When interactive mode (`-i`) is running, an HTTP server starts on port **9527**,
 yiyan-agent -i
 # → Server listening on port 9527
 
-# Terminal 2: Send task (forwarded to server, no new browser)
-yiyan-agent "北京天气，15个字"
-# → Found running server on port 9527, forwarding task...
+# Terminal 2: Send task via HTTP API
+curl -X POST http://localhost:9527/task \
+  -H "Content-Type: application/json" \
+  -d '{"task": "北京天气，15个字"}'
 ```
 
 ### HTTP POST API
@@ -220,8 +204,8 @@ yiyan-agent "北京天气，15个字"
 **Response:**
 ```json
 {
-  "question": "上海天气，20个字",
-  "answer": "上海今日晴，气温25°C...",
+  "question": "创建一个 Express REST API",
+  "answer": "好的，我来创建...",
   "duration": 5234,
   "status": "success"
 }
@@ -323,19 +307,21 @@ curl http://localhost:9527/task/abc123
 ### Windows CMD (curl)
 
 ```cmd
-curl -X POST http://localhost:9527/task -H "Content-Type: application/json" -d "{\"task\":\"上海天气，20个字\"}"
+curl -X POST http://localhost:9527/task -H "Content-Type: application/json" -d "{\"task\":\"创建一个 Express REST API\"}"
 ```
 
 ### PowerShell
 
 ```powershell
-Invoke-RestMethod -Uri "http://localhost:9527/task" -Method POST -Body '{"task":"上海天气"}' -ContentType "application/json"
+Invoke-RestMethod -Uri "http://localhost:9527/task" -Method POST -Body '{"task":"创建一个 Express REST API"}' -ContentType "application/json"
 ```
 
 ### Ubuntu / Linux (curl)
 
 ```bash
-curl -X POST http://localhost:9527/task -H "Content-Type: application/json" -d '{"task":"上海天气，20个字"}'
+curl -X POST http://localhost:9527/task \
+  -H "Content-Type: application/json" \
+  -d '{"task": "创建一个 Express REST API"}'
 ```
 
 ### From Other Programming Languages
@@ -343,11 +329,10 @@ curl -X POST http://localhost:9527/task -H "Content-Type: application/json" -d '
 **Python:**
 ```python
 import requests
-import json
 
 response = requests.post(
     'http://localhost:9527/task',
-    json={'task': '上海天气，20个字'}
+    json={'task': '创建一个 Express REST API'}
 )
 result = response.json()
 print(result)
@@ -357,7 +342,7 @@ print(result)
 ```javascript
 const http = require('http');
 
-const body = JSON.stringify({ task: '上海天气，20个字' });
+const body = JSON.stringify({ task: '创建一个 Express REST API' });
 
 const req = http.request({
   hostname: 'localhost',
@@ -495,13 +480,14 @@ Everything lives in `~/.yiyan-agent/` in your home directory:
 ### Agent responds but creates no files
 The browser DOM rendered the AI's response in a way the parser didn't catch. Run with `--debug` to see exactly what's being received:
 ```bash
-yiyan-agent --debug "build a calculator"
+yiyan-agent --debug -i
+# Then send a task via HTTP API and observe the raw output
 ```
 
 ### Agent stops responding / loops
 Yiyan's UI may have changed. Run the calibration tool — it inspects the live DOM and prints updated selectors:
 ```bash
-yiyan-agent --calibrate
+node src/calibrate.js
 ```
 
 ### Login session expired
@@ -605,7 +591,7 @@ Open an issue on GitHub with:
 - What you ran
 - What you expected
 - What actually happened
-- Output of `yiyan-agent --debug "your task"` if relevant
+- Debug output from `yiyan-agent --debug -i` if relevant
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yiyan-browser-agent",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "AI coding agent powered by Yiyan (文心一言) via browser automation (chat.baidu.com) — no API key needed. Performance-optimized. Enhanced with comprehensive security.",
   "main": "src/index.js",
   "bin": {