drissionpage-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drissionpage-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: DrissionPage CLI - Token-efficient browser automation for coding agents
 Author: DrissionPage-MCP Contributors
 License: Apache-2.0
@@ -25,11 +25,15 @@ Requires-Dist: DrissionPage>=4.0.0
 Dynamic: license-file
 
 # DrissionPage-cli
-
 Token-efficient browser automation CLI for coding agents, powered by [DrissionPage](https://DrissionPage.cn).
 
 Mirrors the architecture of [playwright-cli](https://github.com/microsoft/playwright-cli) but uses DrissionPage as the backend — pure Python, no Node.js required.
 
+## Why use drissionpage-cli
+
+If you know, you know. If you don't, go use playwright-cli.
+
+
 ## Why CLI + Skills over MCP
 
 Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI-based workflows exposed as **SKILLs** over MCP because CLI invocations are more token-efficient: they avoid loading large tool schemas and verbose accessibility trees into the model context. This makes CLI + SKILLs better suited for high-throughput agents that must balance browser automation with large codebases within limited context windows.
@@ -41,18 +45,18 @@ Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI
 
 ## Installation
 
-### From source (development)
+### From PyPI (recommended)
 
 ```bash
-git clone https://github.com/nicekate/DrissionPage-MCP.git
-cd DrissionPage-MCP/DrissionPage-cli
-pip install -e .
+pip install drissionpage-cli
 ```
 
-### Dependencies only
+### From source (development)
 
 ```bash
-pip install DrissionPage>=4.0.0
+git clone https://github.com/nicekate/DrissionPage-MCP.git
+cd DrissionPage-MCP/DrissionPage-cli
+pip install -e .
 ```
 
 After installation the `drissionpage-cli` command is available globally:
@@ -70,6 +74,29 @@ drissionpage-cli install --skills
 
 This copies the SKILL.md and reference guides into `.claude/skills/drissionpage-cli/` so that Claude Code (or any compatible agent) can discover them automatically.
 
+**One-liner** — install the package and set up Claude Code skills in a single command:
+
+```bash
+pip install drissionpage-cli && drissionpage-cli install --skills
+```
+
+#### What gets installed
+
+The `install --skills` command copies the following into `.claude/skills/drissionpage-cli/`:
+
+| File | Purpose |
+|------|---------|
+| `SKILL.md` | Skill definition & quick-start guide for the agent |
+| `references/element-locators.md` | CSS, XPath, text, and attribute locator syntax |
+| `references/running-code.md` | Custom DrissionPage Python code execution |
+| `references/session-management.md` | Multiple concurrent browser sessions |
+| `references/storage-state.md` | Cookies, localStorage, sessionStorage management |
+| `references/screenshots-pdf.md` | Visual capture and PDF generation |
+| `references/network-listening.md` | Network request monitoring |
+| `references/dual-mode.md` | Browser + HTTP request mode switching |
+
+Once installed, Claude Code automatically discovers the skill and can use `drissionpage-cli` commands for browser automation tasks.
+
 ## Quick Start
 
 ```bash
@@ -276,28 +303,29 @@ python3 -m pytest tests/ -v
 
 ```
 DrissionPage-cli/
-  drissionpage_cli.py              # Main CLI (40+ commands)
-  pyproject.toml                   # Python packaging
-  requirements.txt                 # DrissionPage>=4.0.0
-  pytest.ini                       # Test configuration
+  drissionpage_cli/                  # Main package
+    __init__.py                      # CLI entry point (59 commands)
+    skills/drissionpage-cli/         # Bundled skill files
+      SKILL.md
+      references/
+        element-locators.md
+        running-code.md
+        session-management.md
+        storage-state.md
+        screenshots-pdf.md
+        network-listening.md
+        dual-mode.md
+  pyproject.toml                     # Python packaging
+  requirements.txt                   # DrissionPage>=4.0.0
+  pytest.ini                         # Test configuration
   README.md
   LICENSE
   scripts/
-    update.py                      # Skill update script
-  skills/drissionpage-cli/
-    SKILL.md                       # Agent skill definition
-    references/
-      element-locators.md          # CSS, XPath, text, attribute locators
-      running-code.md              # run-code for custom automation
-      session-management.md        # Multiple browser sessions
-      storage-state.md             # Cookies, localStorage, sessionStorage
-      screenshots-pdf.md           # Visual capture
-      network-listening.md         # Network monitoring
-      dual-mode.md                 # Browser + HTTP requests mode
+    update.py                        # Skill update script
   tests/
-    conftest.py                    # Shared fixtures
-    test_unit.py                   # 92 unit tests (mocked, no browser)
-    test_integration.py            # 30+ integration tests (real browser)
+    conftest.py                      # Shared fixtures
+    test_unit.py                     # 92 unit tests (mocked, no browser)
+    test_integration.py              # 30+ integration tests (real browser)
 ```
 
 ## Environment Variables

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/README.md

@@ -1,9 +1,13 @@
 # DrissionPage-cli
-
 Token-efficient browser automation CLI for coding agents, powered by [DrissionPage](https://DrissionPage.cn).
 
 Mirrors the architecture of [playwright-cli](https://github.com/microsoft/playwright-cli) but uses DrissionPage as the backend — pure Python, no Node.js required.
 
+## Why use drissionpage-cli
+
+If you know, you know. If you don't, go use playwright-cli.
+
+
 ## Why CLI + Skills over MCP
 
 Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI-based workflows exposed as **SKILLs** over MCP because CLI invocations are more token-efficient: they avoid loading large tool schemas and verbose accessibility trees into the model context. This makes CLI + SKILLs better suited for high-throughput agents that must balance browser automation with large codebases within limited context windows.
@@ -15,18 +19,18 @@ Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI
 
 ## Installation
 
-### From source (development)
+### From PyPI (recommended)
 
 ```bash
-git clone https://github.com/nicekate/DrissionPage-MCP.git
-cd DrissionPage-MCP/DrissionPage-cli
-pip install -e .
+pip install drissionpage-cli
 ```
 
-### Dependencies only
+### From source (development)
 
 ```bash
-pip install DrissionPage>=4.0.0
+git clone https://github.com/nicekate/DrissionPage-MCP.git
+cd DrissionPage-MCP/DrissionPage-cli
+pip install -e .
 ```
 
 After installation the `drissionpage-cli` command is available globally:
@@ -44,6 +48,29 @@ drissionpage-cli install --skills
 
 This copies the SKILL.md and reference guides into `.claude/skills/drissionpage-cli/` so that Claude Code (or any compatible agent) can discover them automatically.
 
+**One-liner** — install the package and set up Claude Code skills in a single command:
+
+```bash
+pip install drissionpage-cli && drissionpage-cli install --skills
+```
+
+#### What gets installed
+
+The `install --skills` command copies the following into `.claude/skills/drissionpage-cli/`:
+
+| File | Purpose |
+|------|---------|
+| `SKILL.md` | Skill definition & quick-start guide for the agent |
+| `references/element-locators.md` | CSS, XPath, text, and attribute locator syntax |
+| `references/running-code.md` | Custom DrissionPage Python code execution |
+| `references/session-management.md` | Multiple concurrent browser sessions |
+| `references/storage-state.md` | Cookies, localStorage, sessionStorage management |
+| `references/screenshots-pdf.md` | Visual capture and PDF generation |
+| `references/network-listening.md` | Network request monitoring |
+| `references/dual-mode.md` | Browser + HTTP request mode switching |
+
+Once installed, Claude Code automatically discovers the skill and can use `drissionpage-cli` commands for browser automation tasks.
+
 ## Quick Start
 
 ```bash
@@ -250,28 +277,29 @@ python3 -m pytest tests/ -v
 
 ```
 DrissionPage-cli/
-  drissionpage_cli.py              # Main CLI (40+ commands)
-  pyproject.toml                   # Python packaging
-  requirements.txt                 # DrissionPage>=4.0.0
-  pytest.ini                       # Test configuration
+  drissionpage_cli/                  # Main package
+    __init__.py                      # CLI entry point (59 commands)
+    skills/drissionpage-cli/         # Bundled skill files
+      SKILL.md
+      references/
+        element-locators.md
+        running-code.md
+        session-management.md
+        storage-state.md
+        screenshots-pdf.md
+        network-listening.md
+        dual-mode.md
+  pyproject.toml                     # Python packaging
+  requirements.txt                   # DrissionPage>=4.0.0
+  pytest.ini                         # Test configuration
   README.md
   LICENSE
   scripts/
-    update.py                      # Skill update script
-  skills/drissionpage-cli/
-    SKILL.md                       # Agent skill definition
-    references/
-      element-locators.md          # CSS, XPath, text, attribute locators
-      running-code.md              # run-code for custom automation
-      session-management.md        # Multiple browser sessions
-      storage-state.md             # Cookies, localStorage, sessionStorage
-      screenshots-pdf.md           # Visual capture
-      network-listening.md         # Network monitoring
-      dual-mode.md                 # Browser + HTTP requests mode
+    update.py                        # Skill update script
   tests/
-    conftest.py                    # Shared fixtures
-    test_unit.py                   # 92 unit tests (mocked, no browser)
-    test_integration.py            # 30+ integration tests (real browser)
+    conftest.py                      # Shared fixtures
+    test_unit.py                     # 92 unit tests (mocked, no browser)
+    test_integration.py              # 30+ integration tests (real browser)
 ```
 
 ## Environment Variables

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/drissionpage_cli/__init__.py

@@ -15,7 +15,7 @@ import time
 import traceback
 from pathlib import Path
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 # Session storage directory
 CLI_DIR = Path(os.environ.get("DRISSIONPAGE_CLI_DIR", ".drissionpage-cli"))
@@ -108,7 +108,13 @@ def _get_page(session_name, create=False, options=None):
 
     # Create new session
     co = ChromiumOptions()
-    co.auto_port()  # pick a free port to avoid conflicts with stale browsers
+
+    use_system_user_path = options and options.get("system_user_path")
+    if use_system_user_path:
+        # use_system_user_path is incompatible with auto_port (auto_port creates a temp profile)
+        co.use_system_user_path(True)
+    else:
+        co.auto_port()  # pick a free port to avoid conflicts with stale browsers
 
     if options:
         if options.get("headless") is not None:
@@ -182,6 +188,32 @@ def _find_element(page, ref):
 # Command handlers
 # ---------------------------------------------------------------------------
 
+_CONSOLE_CAPTURE_JS = """
+if (!window.__dp_console_capture_installed) {
+    window.__dp_console_logs = window.__dp_console_logs || [];
+    ['log', 'info', 'warn', 'error', 'debug'].forEach(function(t) {
+        var orig = console[t];
+        console[t] = function() {
+            var text = Array.prototype.slice.call(arguments).map(function(a) {
+                try { return (typeof a === 'object') ? JSON.stringify(a) : String(a); }
+                catch(e) { return String(a); }
+            }).join(' ');
+            window.__dp_console_logs.push({type: t === 'warn' ? 'warning' : t, text: text});
+            orig.apply(console, arguments);
+        };
+    });
+    window.__dp_console_capture_installed = true;
+}
+"""
+
+
+def _inject_console_capture(page):
+    """Inject console capture script into the page if not already installed."""
+    try:
+        page.run_js(_CONSOLE_CAPTURE_JS)
+    except Exception:
+        pass
+
 
 def cmd_open(args):
     """Open a browser, optionally navigate to a URL."""
@@ -190,6 +222,7 @@ def cmd_open(args):
         "headless": not getattr(args, "headed", False),
         "user_data_path": getattr(args, "profile", None),
         "port": getattr(args, "port", None),
+        "system_user_path": getattr(args, "system_user_path", False),
     }
     page = _get_page(session, create=True, options=options)
 
@@ -197,6 +230,7 @@ def cmd_open(args):
     if url:
         page.get(url)
 
+    _inject_console_capture(page)
     print(_format_snapshot(page))
 
 
@@ -205,6 +239,7 @@ def cmd_goto(args):
     session = _get_session_name(args)
     page = _get_page(session)
     page.get(args.url)
+    _inject_console_capture(page)
     print(_format_snapshot(page))
 
 
@@ -448,7 +483,13 @@ def cmd_pdf(args):
         ensure_cli_dir()
         filename = str(CLI_DIR / f"page-{timestamp}.pdf")
 
-    page.save(path=filename, as_pdf=True)
+    # Use CDP directly to avoid DrissionPage bug: open(..., 'wb', newline='\n')
+    # is invalid since binary mode doesn't accept a newline argument.
+    from base64 import b64decode
+    r = page._run_cdp('Page.printToPDF', transferMode='ReturnAsBase64', printBackground=True)
+    pdf_bytes = b64decode(r['data'])
+    with open(filename, 'wb') as f:
+        f.write(pdf_bytes)
     print(f"PDF saved to {filename}")
 
 
@@ -529,7 +570,7 @@ def cmd_mousemove(args):
     """Move mouse to coordinates."""
     session = _get_session_name(args)
     page = _get_page(session)
-    page.actions.move_to(args.x, args.y)
+    page.actions.move_to((args.x, args.y))
     print("Mouse moved to", args.x, args.y)
 
 
@@ -651,7 +692,7 @@ def cmd_cookie_list(args):
     """List cookies."""
     session = _get_session_name(args)
     page = _get_page(session)
-    cookies = page.cookies(as_dict=False, all_info=True)
+    cookies = page.cookies(all_info=True)
     domain = getattr(args, "domain", None)
     if domain:
         cookies = [c for c in cookies if domain in c.get("domain", "")]
@@ -663,7 +704,7 @@ def cmd_cookie_get(args):
     """Get a cookie by name."""
     session = _get_session_name(args)
     page = _get_page(session)
-    cookies = page.cookies(as_dict=False, all_info=True)
+    cookies = page.cookies(all_info=True)
     for c in cookies:
         if c.get("name") == args.name:
             print(json.dumps(c, indent=2, ensure_ascii=False))
@@ -813,6 +854,8 @@ def cmd_console(args):
     """List console messages."""
     session = _get_session_name(args)
     page = _get_page(session)
+    # Ensure the interceptor is installed (no-op if already installed)
+    _inject_console_capture(page)
     result = page.run_js("""
         return JSON.stringify(
             (window.__dp_console_logs || []).map(e => ({
@@ -820,17 +863,17 @@ def cmd_console(args):
             }))
         )
     """)
-    if result:
-        logs = json.loads(result)
-        min_level = getattr(args, "level", None)
-        levels = ["error", "warning", "info", "debug"]
-        if min_level and min_level in levels:
-            allowed = set(levels[: levels.index(min_level) + 1])
-            logs = [l for l in logs if l.get("type", "info") in allowed]
+    logs = json.loads(result) if result else []
+    min_level = getattr(args, "level", None)
+    levels = ["error", "warning", "info", "debug"]
+    if min_level and min_level in levels:
+        allowed = set(levels[: levels.index(min_level) + 1])
+        logs = [l for l in logs if l.get("type", "info") in allowed]
+    if logs:
         for log in logs:
             print(f"[{log.get('type', 'info')}] {log.get('text', '')}")
     else:
-        print("No console messages captured. Use run-code to inject console capture first.")
+        print("No console messages captured yet. Console interceptor is now active — any future console.log/warn/error calls will be recorded.")
 
 
 def cmd_network(args):
@@ -961,7 +1004,7 @@ def cmd_state_save(args):
         ensure_cli_dir()
         filename = str(CLI_DIR / f"state-{timestamp}.json")
 
-    cookies = page.cookies(as_dict=False, all_info=True)
+    cookies = page.cookies(all_info=True)
     local_storage = page.run_js(
         "return JSON.stringify(Object.entries(localStorage))"
     )
@@ -1069,6 +1112,8 @@ def build_parser():
     p.add_argument("url", nargs="?", help="URL to navigate to")
     p.add_argument("--headed", action="store_true", help="Run in headed mode")
     p.add_argument("--profile", help="User data directory path")
+    p.add_argument("--system-user-path", action="store_true", dest="system_user_path",
+                   help="Use system default Chrome profile (inherits login sessions)")
     p.add_argument("--port", type=int, help="CDP debugging port")
     p.set_defaults(func=cmd_open)
 

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/drissionpage_cli/skills/drissionpage-cli/SKILL.md

@@ -146,7 +146,9 @@ drissionpage-cli run-code --filename=script.py
 ```bash
 # Run in headed mode (browser window visible)
 drissionpage-cli open --headed
-# Use persistent user profile
+# Use system default Chrome profile (inherits all login sessions)
+drissionpage-cli open --system-user-path
+# Use a specific user profile directory
 drissionpage-cli open --profile=/path/to/profile
 # Use specific CDP port
 drissionpage-cli open --port=9222

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/drissionpage_cli/skills/drissionpage-cli/references/session-management.md

@@ -90,7 +90,10 @@ drissionpage-cli -s=variant-b screenshot
 ### Persistent Profile
 
 ```bash
-# Use persistent profile
+# Use system default Chrome profile (inherits all login sessions)
+drissionpage-cli open --system-user-path
+
+# Use a specific profile directory
 drissionpage-cli open https://example.com --profile=/path/to/profile
 
 # Specific CDP port

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/drissionpage_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drissionpage-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: DrissionPage CLI - Token-efficient browser automation for coding agents
 Author: DrissionPage-MCP Contributors
 License: Apache-2.0
@@ -25,11 +25,15 @@ Requires-Dist: DrissionPage>=4.0.0
 Dynamic: license-file
 
 # DrissionPage-cli
-
 Token-efficient browser automation CLI for coding agents, powered by [DrissionPage](https://DrissionPage.cn).
 
 Mirrors the architecture of [playwright-cli](https://github.com/microsoft/playwright-cli) but uses DrissionPage as the backend — pure Python, no Node.js required.
 
+## Why use drissionpage-cli
+
+If you know, you know. If you don't, go use playwright-cli.
+
+
 ## Why CLI + Skills over MCP
 
 Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI-based workflows exposed as **SKILLs** over MCP because CLI invocations are more token-efficient: they avoid loading large tool schemas and verbose accessibility trees into the model context. This makes CLI + SKILLs better suited for high-throughput agents that must balance browser automation with large codebases within limited context windows.
@@ -41,18 +45,18 @@ Modern coding agents (Claude Code, GitHub Copilot, etc.) increasingly favour CLI
 
 ## Installation
 
-### From source (development)
+### From PyPI (recommended)
 
 ```bash
-git clone https://github.com/nicekate/DrissionPage-MCP.git
-cd DrissionPage-MCP/DrissionPage-cli
-pip install -e .
+pip install drissionpage-cli
 ```
 
-### Dependencies only
+### From source (development)
 
 ```bash
-pip install DrissionPage>=4.0.0
+git clone https://github.com/nicekate/DrissionPage-MCP.git
+cd DrissionPage-MCP/DrissionPage-cli
+pip install -e .
 ```
 
 After installation the `drissionpage-cli` command is available globally:
@@ -70,6 +74,29 @@ drissionpage-cli install --skills
 
 This copies the SKILL.md and reference guides into `.claude/skills/drissionpage-cli/` so that Claude Code (or any compatible agent) can discover them automatically.
 
+**One-liner** — install the package and set up Claude Code skills in a single command:
+
+```bash
+pip install drissionpage-cli && drissionpage-cli install --skills
+```
+
+#### What gets installed
+
+The `install --skills` command copies the following into `.claude/skills/drissionpage-cli/`:
+
+| File | Purpose |
+|------|---------|
+| `SKILL.md` | Skill definition & quick-start guide for the agent |
+| `references/element-locators.md` | CSS, XPath, text, and attribute locator syntax |
+| `references/running-code.md` | Custom DrissionPage Python code execution |
+| `references/session-management.md` | Multiple concurrent browser sessions |
+| `references/storage-state.md` | Cookies, localStorage, sessionStorage management |
+| `references/screenshots-pdf.md` | Visual capture and PDF generation |
+| `references/network-listening.md` | Network request monitoring |
+| `references/dual-mode.md` | Browser + HTTP request mode switching |
+
+Once installed, Claude Code automatically discovers the skill and can use `drissionpage-cli` commands for browser automation tasks.
+
 ## Quick Start
 
 ```bash
@@ -276,28 +303,29 @@ python3 -m pytest tests/ -v
 
 ```
 DrissionPage-cli/
-  drissionpage_cli.py              # Main CLI (40+ commands)
-  pyproject.toml                   # Python packaging
-  requirements.txt                 # DrissionPage>=4.0.0
-  pytest.ini                       # Test configuration
+  drissionpage_cli/                  # Main package
+    __init__.py                      # CLI entry point (59 commands)
+    skills/drissionpage-cli/         # Bundled skill files
+      SKILL.md
+      references/
+        element-locators.md
+        running-code.md
+        session-management.md
+        storage-state.md
+        screenshots-pdf.md
+        network-listening.md
+        dual-mode.md
+  pyproject.toml                     # Python packaging
+  requirements.txt                   # DrissionPage>=4.0.0
+  pytest.ini                         # Test configuration
   README.md
   LICENSE
   scripts/
-    update.py                      # Skill update script
-  skills/drissionpage-cli/
-    SKILL.md                       # Agent skill definition
-    references/
-      element-locators.md          # CSS, XPath, text, attribute locators
-      running-code.md              # run-code for custom automation
-      session-management.md        # Multiple browser sessions
-      storage-state.md             # Cookies, localStorage, sessionStorage
-      screenshots-pdf.md           # Visual capture
-      network-listening.md         # Network monitoring
-      dual-mode.md                 # Browser + HTTP requests mode
+    update.py                        # Skill update script
   tests/
-    conftest.py                    # Shared fixtures
-    test_unit.py                   # 92 unit tests (mocked, no browser)
-    test_integration.py            # 30+ integration tests (real browser)
+    conftest.py                      # Shared fixtures
+    test_unit.py                     # 92 unit tests (mocked, no browser)
+    test_integration.py              # 30+ integration tests (real browser)
 ```
 
 ## Environment Variables

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "drissionpage-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "DrissionPage CLI - Token-efficient browser automation for coding agents"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{drissionpage_cli-0.1.0 → drissionpage_cli-0.1.2}/tests/test_unit.py

@@ -26,7 +26,7 @@ import drissionpage_cli as cli
 
 class TestVersionAndHelp:
     def test_version_string(self):
-        assert cli.__version__ == "0.1.0"
+        assert cli.__version__ == "0.1.2"
 
     def test_build_parser(self):
         parser = cli.build_parser()
@@ -292,6 +292,17 @@ class TestVersionAndHelp:
         assert args.command == "open"
         assert args.profile == "/tmp/profile"
 
+    def test_parse_open_with_system_user_path(self):
+        parser = cli.build_parser()
+        args = parser.parse_args(["open", "--system-user-path"])
+        assert args.command == "open"
+        assert args.system_user_path is True
+
+    def test_parse_open_system_user_path_default_false(self):
+        parser = cli.build_parser()
+        args = parser.parse_args(["open"])
+        assert args.system_user_path is False
+
     def test_parse_console_command(self):
         parser = cli.build_parser()
         args = parser.parse_args(["console", "warning"])
@@ -578,6 +589,57 @@ class TestStateSaveLoad:
         assert any("sessionStorage.setItem" in str(call) for call in mock_page.run_js.call_args_list)
 
 
+# ---------------------------------------------------------------------------
+# _get_page options (mocked ChromiumOptions / ChromiumPage)
+# ---------------------------------------------------------------------------
+
+
+class TestGetPageOptions:
+    """Test that _get_page passes options correctly to ChromiumOptions."""
+
+    def _make_mock_co(self):
+        return MagicMock()
+
+    def _run_get_page(self, options, tmp_path, mock_co, mock_page):
+        sessions_file = tmp_path / "sessions.json"
+        cli_dir_path = tmp_path / ".drissionpage-cli"
+        cli_dir_path.mkdir()
+
+        with patch.object(cli, "SESSIONS_FILE", sessions_file), \
+             patch.object(cli, "CLI_DIR", cli_dir_path), \
+             patch("DrissionPage.ChromiumOptions", return_value=mock_co), \
+             patch("DrissionPage.ChromiumPage", return_value=mock_page):
+            mock_page.address = "127.0.0.1:9333"
+            mock_page.process_id = 999
+            cli._get_page("default", create=True, options=options)
+
+    def test_system_user_path_calls_use_system_user_path(self, tmp_path):
+        mock_co = self._make_mock_co()
+        mock_page = MagicMock()
+        self._run_get_page({"system_user_path": True}, tmp_path, mock_co, mock_page)
+        mock_co.use_system_user_path.assert_called_once_with(True)
+
+    def test_system_user_path_skips_auto_port(self, tmp_path):
+        mock_co = self._make_mock_co()
+        mock_page = MagicMock()
+        self._run_get_page({"system_user_path": True}, tmp_path, mock_co, mock_page)
+        mock_co.auto_port.assert_not_called()
+
+    def test_no_system_user_path_calls_auto_port(self, tmp_path):
+        mock_co = self._make_mock_co()
+        mock_page = MagicMock()
+        self._run_get_page({"system_user_path": False}, tmp_path, mock_co, mock_page)
+        mock_co.auto_port.assert_called_once()
+        mock_co.use_system_user_path.assert_not_called()
+
+    def test_system_user_path_with_headed(self, tmp_path):
+        mock_co = self._make_mock_co()
+        mock_page = MagicMock()
+        self._run_get_page({"system_user_path": True, "headless": False}, tmp_path, mock_co, mock_page)
+        mock_co.use_system_user_path.assert_called_once_with(True)
+        mock_co.headless.assert_called_once_with(False)
+
+
 # ---------------------------------------------------------------------------
 # Command handlers (mocked browser)
 # ---------------------------------------------------------------------------