yiyan-browser-agent 1.3.4 → 1.4.0

package/README.md

@@ -49,6 +49,9 @@ yiyan-browser-agent status
 
 # Clear saved session
 yiyan-browser-agent reset
+
+# Debug mode (output DOM info for troubleshooting)
+yiyan-browser-agent debug
 ```
 
 ### Node.js API
@@ -78,6 +81,9 @@ console.log('Session path:', status.sessionPath);
 
 // Clear saved session
 await agent.reset();
+
+// Debug mode (for troubleshooting selectors)
+await agent.debug();
 ```
 
 ## CLI Commands
@@ -88,6 +94,7 @@ await agent.reset();
 | `ask "question"` | Send question and get answer |
 | `status` | Check login status |
 | `reset` | Clear saved session |
+| `debug` | Debug mode: output DOM info for troubleshooting |
 
 ## CLI Options
 
@@ -135,6 +142,10 @@ Check login status.
 
 Clear saved session.
 
+##### `debug(): Promise<void>`
+
+Start browser in debug mode, output DOM information for troubleshooting selectors.
+
 ### Error Types
 
 | Type | Description |
@@ -191,6 +202,13 @@ yiyan-browser-agent ask "question" --headful --verbose
 yiyan-browser-agent ask "question" --headful
 ```
 
+### Selectors not working
+
+```bash
+# Use debug mode to see DOM structure
+yiyan-browser-agent debug
+```
+
 ## Comparison with deepseek-browser-agent
 
 This package follows similar architecture to [deepseek-browser-agent](https://github.com/Omar-Azam/deepseek-browser-agent):

package/dist/cli.d.ts

@@ -4,7 +4,7 @@ import { C as CliOutput } from './types-BhQ78DYf.js';
 declare function printHelp(): void;
 /** 解析后的 CLI 参数 */
 interface ParsedArgs {
-    command: 'ask' | 'status' | 'reset' | 'login' | 'help' | null;
+    command: 'ask' | 'status' | 'reset' | 'login' | 'debug' | 'help' | null;
     question?: string;
     timeout?: number;
     headful?: boolean;