dash-devtools 1.0.0__tar.gz → 2.0.1__tar.gz

dash_devtools-2.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 SeiKai Kyo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{dash_devtools-1.0.0/dash_devtools.egg-info → dash_devtools-2.0.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: dash-devtools
-Version: 1.0.0
+Version: 2.0.1
 Summary: 大許開發工具集 DashAI DevTools - 驗證、遷移、文件產生工具
-Author-email: DashAI <dev@dashai.dev>
+Author: DashAI
 License: MIT
 Project-URL: Homepage, https://github.com/seikaikyo/dash-devtools
 Project-URL: Repository, https://github.com/seikaikyo/dash-devtools
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: click>=8.0
 Requires-Dist: rich>=13.0
 Requires-Dist: pyyaml>=6.0
@@ -35,10 +36,23 @@ Provides-Extra: report
 Requires-Dist: python-docx>=1.1.0; extra == "report"
 Requires-Dist: matplotlib>=3.8.0; extra == "report"
 Requires-Dist: pillow>=10.0; extra == "report"
+Provides-Extra: analyze
+Requires-Dist: deptry>=0.22; extra == "analyze"
+Requires-Dist: pip-audit>=2.7; extra == "analyze"
+Requires-Dist: vulture>=2.11; extra == "analyze"
+Requires-Dist: radon>=6.0; extra == "analyze"
+Requires-Dist: pip-licenses>=5.0; extra == "analyze"
+Requires-Dist: liccheck>=0.9; extra == "analyze"
+Requires-Dist: dotenv-linter>=0.7; extra == "analyze"
+Provides-Extra: api-test
+Requires-Dist: schemathesis>=3.36; extra == "api-test"
+Provides-Extra: git-analytics
+Requires-Dist: gitchangelog>=3.0; extra == "git-analytics"
 Provides-Extra: all
-Requires-Dist: dash-devtools[ai,dev,report,vision]; extra == "all"
+Requires-Dist: dash-devtools[ai,analyze,api-test,dev,git-analytics,report,vision]; extra == "all"
+Dynamic: license-file
 
-# DashAI DevTools v2.0
+# DashAI DevTools v2.1
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
@@ -235,8 +249,10 @@ npm install -D prisma-dbml-generator
 
 - 檔案行數限制 (500 行)
 - 命名規範 (kebab-case)
-- 禁止 Emoji (程式碼中)
+- 禁止 Emoji (程式碼和 commit message)
 - 禁止簡體字
+- 禁止中國用語 (56 組詞彙，如「視頻→影片」「內存→記憶體」)
+- AI 寫作痕跡偵測 (「值得注意的是」「至關重要」等)
 
 ## v2.0 新功能
 
@@ -544,30 +560,29 @@ dash doctor
 
 顯示：系統資訊、Python 路徑、套件版本、環境變數
 
-## Git Hooks
+## Git Hooks (Pre-push v3)
 
-安裝 pre-push hook 自動驗證：
+全域 pre-push hook，所有專案推送前自動檢查：
 
 ```bash
-# 基本安裝
-dash hooks install .
-
-# 嚴格模式：測試失敗會阻止推送
-dash hooks install . --strict
+# 安裝全域 hook
+git config --global core.hooksPath ~/.config/git/hooks
+cp scripts/pre-push ~/.config/git/hooks/pre-push
+chmod +x ~/.config/git/hooks/pre-push
+```
 
-# 啟用 E2E 煙霧測試
-dash hooks install . --e2e https://your-app.vercel.app
+Push 前自動執行（依專案類型動態調整步驟數）：
 
-# 嚴格 E2E 模式：E2E 失敗會阻止推送
-dash hooks install . --e2e https://your-app.vercel.app --strict-e2e
-```
+| 步驟 | 前端 | 後端 | 說明 |
+|------|:----:|:----:|------|
+| Emoji 掃描 | v | v | 只掃 git diff 變更檔 + commit message |
+| commit message 格式 | v | v | 禁止 Emoji，建議 `類型: 描述` 格式 |
+| 機敏資料掃描 | v | v | GitGuardian 或本地規則 |
+| TypeScript 建構 | v | - | vue-tsc / ng build / tsc（自動偵測） |
+| Python Ruff lint | - | v | check + format 檢查 |
+| 專案驗證 | v | v | dash validate（簡體字、AI 痕跡、品質） |
 
-Push 前會自動執行：
-1. 檢查 Emoji
-2. 掃描機敏資料 (GitGuardian 或本地規則)
-3. 驗證專案規範
-4. 執行測試 (vitest/jest/pytest)
-5. E2E 煙霧測試 (如有設定)
+錯誤阻擋推送，警告放行但顯示提示。每步驟附計時。
 
 ## 模板
 
@@ -789,24 +804,6 @@ cat file | claude -p "問題"    # 管道輸入
 
 ---
 
-## 專案清單
-
-| 專案 | 類型 | 說明 |
-|------|------|------|
-| MES 製造執行 | Angular + PrimeNG | 再生廠製造執行系統 |
-| SSO 管理後台 | Vite + Shoelace | 用戶與權限管理 |
-| EAP 設備自動化 | Vite + Shoelace | 設備自動化平台 |
-| VAC 承攬商門禁 | Vite + Shoelace | 承攬商門禁管理系統 |
-| RFID 追蹤 | Vite + Shoelace | RFID 標籤追蹤系統 |
-| MCS 物料控制 | Vite + Shoelace | 物料控制系統 |
-| MIDS 材料追蹤 | Vite + Shoelace | 材料識別與追蹤系統 |
-| GHG 碳排管理 | Vite + Shoelace | 溫室氣體排放管理系統 |
-| BPM 簽核流程 | Vite + Shoelace | 簽核流程管理系統 |
-| RMS 配方管理 | Vite + Shoelace | 配方管理系統 |
-| 8D 問題管理 | Vite + Shoelace | 8D 問題解決流程管理 |
-| Vision AI | Python | AI 影像辨識系統 |
-| API Center | Vite + Shoelace | API 管理中心與開發文件 |
-
 ## 開發
 
 ```bash
@@ -829,6 +826,61 @@ black .
 - **[Google Gemini](https://ai.google.dev/)** - AI 視覺分析引擎
 - **[Rich](https://github.com/Textualize/rich)** - 終端 UI 美化
 
+## 更新歷程
+
+### v2.0.0 (2026-05-20)
+
+發布至 PyPI，自此 README 歷程與套件版本號統一。彙整 v2.2 (2026-03-15) 之後至 2026-05-17 的改動。
+
+- **語意層驗證器**: 新增 4 個語意層驗證器 (Next.js SEO 與安全標頭、i18n key 一致性、a11y)，警告顯示細節
+- **Logto 認證 pattern 驗證**: 認 Logto / Clerk 與通用共 6 種 pattern，public proxy 以 @public-proxy 註解標示
+- **Flat OpenSpec adapter**: 扁平 OpenSpec 自動跳過 orphan check (specs 以 [[ref]] opt-in)
+- **禁用概念掃描**: 自動攔截已移除概念 (傍通曆、五行、暦注、六害宿等)
+- **架構文件完整性**: 新增 dash architecture check/diff 指令，pre-push 步驟 5 架構檢查
+- **開源工具整合**: 整合 9 個開源工具，health 評分精準化
+- **品質與安全修復**: a11y 精準度提升 (排除有文字或 sr-only 的按鈕)、regex 收斂並跳過 test 目錄降低假陽性、knowledge_ JSON 檔加入 allowlist、ggshield stdin pipe 修正、新增 verify 指令
+
+### v2.2 (2026-03-15)
+
+- **大型檔案拆分**: 消除所有超過 500 行的檔案警告
+  - cli.py 1528 → 62 行，拆為 `commands/` 目錄 (10 個模組)
+  - test_suite.py 690 → 393 行，抽出 `test_runners/` (4 個 runner)
+  - word_report.py 689 → 485 行，抽出 `reporters/templates` + `charts`
+  - report.py 667 → 453 行，抽出 `reporters/report_data` + `screenshot`
+  - quality.py 510 → 429 行，詞庫常數抽為 `constants.py`
+  - browser.py 541 → 354 行，便捷函數抽至 `browser_helpers.py`
+- **品質修復**: 中國用語修正、.gitignore 補齊 node_modules
+- **dash validate 達成 0 錯誤 0 警告**
+
+### v2.1 (2026-03-14)
+
+- **Pre-push Hook v3**: 合併全域版與專案版，動態步驟數
+  - 新增 TypeScript 建構檢查 (vue-tsc / ng build / tsc)
+  - 新增 commit message 格式檢查（禁止 Emoji）
+  - Emoji 掃描改用 git diff（只查變更檔，速度提升）
+  - 新增 Python Ruff lint (check + format)
+  - 錯誤/警告分級，每步驟計時
+- **品質檢查擴充**
+  - 新增中國用語禁用詞 (56 組，來源: pjchender/cn2tw4programmer)
+  - 新增 AI 寫作痕跡偵測 (check_ai_slop)
+
+### v2.0 (2026-02)
+
+- OpenSpec 規格驅動開發 (SDD)
+- 專案健康評分
+- 程式碼統計儀表板
+- 四大測試套件 (UIT/Smoke/E2E/UAT)
+- AI 視覺分析 (Gemini)
+- UptimeRobot 監控管理
+
+### v1.0 (2026-01)
+
+- 專案驗證 (dash validate)
+- 機敏資料掃描 (dash scan)
+- E2E 煙霧測試 (agent-browser)
+- 資料庫遷移管理 (Alembic)
+- dbdiagram.io 圖表產生
+
 ## 授權
 
 MIT License - DashAI

dash_devtools-1.0.0/PKG-INFO → dash_devtools-2.0.1/README.md

@@ -1,44 +1,4 @@
-Metadata-Version: 2.4
-Name: dash-devtools
-Version: 1.0.0
-Summary: 大許開發工具集 DashAI DevTools - 驗證、遷移、文件產生工具
-Author-email: DashAI <dev@dashai.dev>
-License: MIT
-Project-URL: Homepage, https://github.com/seikaikyo/dash-devtools
-Project-URL: Repository, https://github.com/seikaikyo/dash-devtools
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.0
-Requires-Dist: rich>=13.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: jinja2>=3.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: ruff>=0.1; extra == "dev"
-Provides-Extra: vision
-Requires-Dist: opencv-python>=4.8; extra == "vision"
-Requires-Dist: pillow>=10.0; extra == "vision"
-Requires-Dist: numpy>=1.24; extra == "vision"
-Provides-Extra: ai
-Requires-Dist: google-genai>=1.0.0; extra == "ai"
-Requires-Dist: python-dotenv>=1.0.0; extra == "ai"
-Provides-Extra: report
-Requires-Dist: python-docx>=1.1.0; extra == "report"
-Requires-Dist: matplotlib>=3.8.0; extra == "report"
-Requires-Dist: pillow>=10.0; extra == "report"
-Provides-Extra: all
-Requires-Dist: dash-devtools[ai,dev,report,vision]; extra == "all"
-
-# DashAI DevTools v2.0
+# DashAI DevTools v2.1
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
@@ -235,8 +195,10 @@ npm install -D prisma-dbml-generator
 
 - 檔案行數限制 (500 行)
 - 命名規範 (kebab-case)
-- 禁止 Emoji (程式碼中)
+- 禁止 Emoji (程式碼和 commit message)
 - 禁止簡體字
+- 禁止中國用語 (56 組詞彙，如「視頻→影片」「內存→記憶體」)
+- AI 寫作痕跡偵測 (「值得注意的是」「至關重要」等)
 
 ## v2.0 新功能
 
@@ -544,30 +506,29 @@ dash doctor
 
 顯示：系統資訊、Python 路徑、套件版本、環境變數
 
-## Git Hooks
+## Git Hooks (Pre-push v3)
 
-安裝 pre-push hook 自動驗證：
+全域 pre-push hook，所有專案推送前自動檢查：
 
 ```bash
-# 基本安裝
-dash hooks install .
-
-# 嚴格模式：測試失敗會阻止推送
-dash hooks install . --strict
+# 安裝全域 hook
+git config --global core.hooksPath ~/.config/git/hooks
+cp scripts/pre-push ~/.config/git/hooks/pre-push
+chmod +x ~/.config/git/hooks/pre-push
+```
 
-# 啟用 E2E 煙霧測試
-dash hooks install . --e2e https://your-app.vercel.app
+Push 前自動執行（依專案類型動態調整步驟數）：
 
-# 嚴格 E2E 模式：E2E 失敗會阻止推送
-dash hooks install . --e2e https://your-app.vercel.app --strict-e2e
-```
+| 步驟 | 前端 | 後端 | 說明 |
+|------|:----:|:----:|------|
+| Emoji 掃描 | v | v | 只掃 git diff 變更檔 + commit message |
+| commit message 格式 | v | v | 禁止 Emoji，建議 `類型: 描述` 格式 |
+| 機敏資料掃描 | v | v | GitGuardian 或本地規則 |
+| TypeScript 建構 | v | - | vue-tsc / ng build / tsc（自動偵測） |
+| Python Ruff lint | - | v | check + format 檢查 |
+| 專案驗證 | v | v | dash validate（簡體字、AI 痕跡、品質） |
 
-Push 前會自動執行：
-1. 檢查 Emoji
-2. 掃描機敏資料 (GitGuardian 或本地規則)
-3. 驗證專案規範
-4. 執行測試 (vitest/jest/pytest)
-5. E2E 煙霧測試 (如有設定)
+錯誤阻擋推送，警告放行但顯示提示。每步驟附計時。
 
 ## 模板
 
@@ -789,24 +750,6 @@ cat file | claude -p "問題"    # 管道輸入
 
 ---
 
-## 專案清單
-
-| 專案 | 類型 | 說明 |
-|------|------|------|
-| MES 製造執行 | Angular + PrimeNG | 再生廠製造執行系統 |
-| SSO 管理後台 | Vite + Shoelace | 用戶與權限管理 |
-| EAP 設備自動化 | Vite + Shoelace | 設備自動化平台 |
-| VAC 承攬商門禁 | Vite + Shoelace | 承攬商門禁管理系統 |
-| RFID 追蹤 | Vite + Shoelace | RFID 標籤追蹤系統 |
-| MCS 物料控制 | Vite + Shoelace | 物料控制系統 |
-| MIDS 材料追蹤 | Vite + Shoelace | 材料識別與追蹤系統 |
-| GHG 碳排管理 | Vite + Shoelace | 溫室氣體排放管理系統 |
-| BPM 簽核流程 | Vite + Shoelace | 簽核流程管理系統 |
-| RMS 配方管理 | Vite + Shoelace | 配方管理系統 |
-| 8D 問題管理 | Vite + Shoelace | 8D 問題解決流程管理 |
-| Vision AI | Python | AI 影像辨識系統 |
-| API Center | Vite + Shoelace | API 管理中心與開發文件 |
-
 ## 開發
 
 ```bash
@@ -829,6 +772,61 @@ black .
 - **[Google Gemini](https://ai.google.dev/)** - AI 視覺分析引擎
 - **[Rich](https://github.com/Textualize/rich)** - 終端 UI 美化
 
+## 更新歷程
+
+### v2.0.0 (2026-05-20)
+
+發布至 PyPI，自此 README 歷程與套件版本號統一。彙整 v2.2 (2026-03-15) 之後至 2026-05-17 的改動。
+
+- **語意層驗證器**: 新增 4 個語意層驗證器 (Next.js SEO 與安全標頭、i18n key 一致性、a11y)，警告顯示細節
+- **Logto 認證 pattern 驗證**: 認 Logto / Clerk 與通用共 6 種 pattern，public proxy 以 @public-proxy 註解標示
+- **Flat OpenSpec adapter**: 扁平 OpenSpec 自動跳過 orphan check (specs 以 [[ref]] opt-in)
+- **禁用概念掃描**: 自動攔截已移除概念 (傍通曆、五行、暦注、六害宿等)
+- **架構文件完整性**: 新增 dash architecture check/diff 指令，pre-push 步驟 5 架構檢查
+- **開源工具整合**: 整合 9 個開源工具，health 評分精準化
+- **品質與安全修復**: a11y 精準度提升 (排除有文字或 sr-only 的按鈕)、regex 收斂並跳過 test 目錄降低假陽性、knowledge_ JSON 檔加入 allowlist、ggshield stdin pipe 修正、新增 verify 指令
+
+### v2.2 (2026-03-15)
+
+- **大型檔案拆分**: 消除所有超過 500 行的檔案警告
+  - cli.py 1528 → 62 行，拆為 `commands/` 目錄 (10 個模組)
+  - test_suite.py 690 → 393 行，抽出 `test_runners/` (4 個 runner)
+  - word_report.py 689 → 485 行，抽出 `reporters/templates` + `charts`
+  - report.py 667 → 453 行，抽出 `reporters/report_data` + `screenshot`
+  - quality.py 510 → 429 行，詞庫常數抽為 `constants.py`
+  - browser.py 541 → 354 行，便捷函數抽至 `browser_helpers.py`
+- **品質修復**: 中國用語修正、.gitignore 補齊 node_modules
+- **dash validate 達成 0 錯誤 0 警告**
+
+### v2.1 (2026-03-14)
+
+- **Pre-push Hook v3**: 合併全域版與專案版，動態步驟數
+  - 新增 TypeScript 建構檢查 (vue-tsc / ng build / tsc)
+  - 新增 commit message 格式檢查（禁止 Emoji）
+  - Emoji 掃描改用 git diff（只查變更檔，速度提升）
+  - 新增 Python Ruff lint (check + format)
+  - 錯誤/警告分級，每步驟計時
+- **品質檢查擴充**
+  - 新增中國用語禁用詞 (56 組，來源: pjchender/cn2tw4programmer)
+  - 新增 AI 寫作痕跡偵測 (check_ai_slop)
+
+### v2.0 (2026-02)
+
+- OpenSpec 規格驅動開發 (SDD)
+- 專案健康評分
+- 程式碼統計儀表板
+- 四大測試套件 (UIT/Smoke/E2E/UAT)
+- AI 視覺分析 (Gemini)
+- UptimeRobot 監控管理
+
+### v1.0 (2026-01)
+
+- 專案驗證 (dash validate)
+- 機敏資料掃描 (dash scan)
+- E2E 煙霧測試 (agent-browser)
+- 資料庫遷移管理 (Alembic)
+- dbdiagram.io 圖表產生
+
 ## 授權
 
 MIT License - DashAI

{dash_devtools-1.0.0 → dash_devtools-2.0.1}/dash_devtools/__init__.py

@@ -4,5 +4,5 @@ DashAI DevTools - 大許開發工具集
 統一的開發、驗證、遷移工具
 """
 
-__version__ = "1.0.0"
+__version__ = "2.0.1"
 __author__ = "DashAI"

{dash_devtools-1.0.0 → dash_devtools-2.0.1}/dash_devtools/browser.py

@@ -109,7 +109,7 @@ class AgentBrowser:
         return self._run(*args, timeout=timeout)
 
     def back(self) -> BrowserResult:
-        """返回上一頁"""
+        """回到上一頁"""
         return self._run('back')
 
     def forward(self) -> BrowserResult:
@@ -350,192 +350,5 @@ class AgentBrowser:
         return self._run('errors')
 
 
-# ========== 便捷函數 ==========
-
-def quick_screenshot(url: str, output_path: str, wait_ms: int = 3000, mobile: bool = False) -> bool:
-    """
-    快速截圖
-
-    Args:
-        url: 網址
-        output_path: 輸出路徑
-        wait_ms: 等待時間 (毫秒)
-        mobile: 是否使用手機版視窗
-
-    Returns:
-        是否成功
-    """
-    browser = AgentBrowser()
-    try:
-        result = browser.open(url)
-        if not result.success:
-            return False
-
-        # 等待頁面載入
-        browser.wait(str(wait_ms))
-
-        # 截圖
-        result = browser.screenshot(output_path, full_page=True)
-        return result.success
-
-    finally:
-        browser.close()
-
-
-def check_page_errors(url: str, timeout: int = 30) -> Dict:
-    """
-    檢查頁面 JS 錯誤
-
-    Args:
-        url: 網址
-        timeout: 超時時間 (秒)
-
-    Returns:
-        {
-            'success': bool,
-            'url': str,
-            'title': str,
-            'errors': List[str],
-            'load_time': int
-        }
-    """
-    import time
-    browser = AgentBrowser()
-    result = {
-        'success': True,
-        'url': url,
-        'title': '',
-        'errors': [],
-        'load_time': 0
-    }
-
-    try:
-        start = time.time()
-        open_result = browser.open(url, timeout=timeout)
-        result['load_time'] = int((time.time() - start) * 1000)
-
-        if not open_result.success:
-            result['success'] = False
-            result['errors'].append(open_result.error or "頁面載入失敗")
-            return result
-
-        # 等待 JS 執行
-        browser.wait('2000')
-
-        # 取得標題
-        result['title'] = browser.get_title()
-
-        # 取得錯誤
-        errors_result = browser.errors()
-        if errors_result.output:
-            # 解析錯誤訊息
-            error_lines = [
-                line.strip()
-                for line in errors_result.output.split('\n')
-                if line.strip() and 'favicon' not in line.lower()
-            ]
-            result['errors'] = error_lines
-
-        result['success'] = len(result['errors']) == 0
-
-    except Exception as e:
-        result['success'] = False
-        result['errors'].append(str(e))
-
-    finally:
-        browser.close()
-
-    return result
-
-
-def fill_form(url: str, fields: Dict[str, str], submit_ref: Optional[str] = None) -> BrowserResult:
-    """
-    填寫表單
-
-    Args:
-        url: 網址
-        fields: {ref: value} 對應
-        submit_ref: 送出按鈕 ref (可選)
-
-    Returns:
-        操作結果
-    """
-    browser = AgentBrowser()
-    try:
-        result = browser.open(url)
-        if not result.success:
-            return result
-
-        browser.wait('2000')
-
-        # 填寫欄位
-        for ref, value in fields.items():
-            result = browser.fill(ref, value)
-            if not result.success:
-                return result
-
-        # 送出表單
-        if submit_ref:
-            result = browser.click(submit_ref)
-            browser.wait_load('networkidle')
-
-        return BrowserResult(success=True, output="表單填寫完成")
-
-    finally:
-        browser.close()
-
-
-def login_and_save_state(
-    login_url: str,
-    username_ref: str,
-    password_ref: str,
-    submit_ref: str,
-    username: str,
-    password: str,
-    state_file: str,
-    success_url_pattern: Optional[str] = None
-) -> BrowserResult:
-    """
-    登入並儲存狀態
-
-    Args:
-        login_url: 登入頁面網址
-        username_ref: 帳號輸入框 ref
-        password_ref: 密碼輸入框 ref
-        submit_ref: 登入按鈕 ref
-        username: 帳號
-        password: 密碼
-        state_file: 狀態儲存檔案
-        success_url_pattern: 登入成功後的網址 pattern
-
-    Returns:
-        操作結果
-    """
-    browser = AgentBrowser()
-    try:
-        result = browser.open(login_url)
-        if not result.success:
-            return result
-
-        browser.wait('2000')
-
-        # 填寫登入資訊
-        browser.fill(username_ref, username)
-        browser.fill(password_ref, password)
-        browser.click(submit_ref)
-
-        # 等待登入完成
-        if success_url_pattern:
-            browser.wait_url(success_url_pattern, timeout=30)
-        else:
-            browser.wait_load('networkidle')
-
-        # 儲存狀態
-        result = browser.state_save(state_file)
-        if result.success:
-            return BrowserResult(success=True, output=f"登入成功，狀態已儲存至 {state_file}")
-        else:
-            return result
-
-    finally:
-        browser.close()
+# 便捷函數 re-export（向下相容）
+from .browser_helpers import quick_screenshot, check_page_errors, fill_form, login_and_save_state  # noqa: E402, F401