跳轉到主要內容
OpenYida 內置強大的診斷工具 doctor，幫助開發者檢查環境、診斷問題、自動修復、持續監控應用健康度。

​
功能概述

環境檢查

檢查 Node.js、Playwright、登錄態等環境依賴。

應用診斷

檢查 PRD、頁面源碼、Schema 緩存、React Hooks 規範。

智能修復

自動修復可修復的問題，提供手動修復指導。

健康監控

持續監控應用健康度，生成趨勢報告。

​
基本用法

​
運行診斷

openyida doctor

​
自動修復

openyida doctor --fix

​
生成報告

# Markdown 格式
openyida doctor --report markdown

# JSON 格式
openyida doctor --report json

# HTML 格式
openyida doctor --report html

​
環境檢查項

檢查項說明自動修復
CLI 版本檢查 openyida 版本是否與 SKILL.md 一致✅
project/ 初始化檢查 project/ 工作目錄是否存在✅
Node.js 版本檢查是否 ≥ 18❌
Playwright檢查是否安裝✅
config.json檢查配置文件✅
宜搭登錄檢查登錄態✅
網絡連通檢查 aliwork.com 連通性❌

​
應用診斷項

檢查項說明
PRD 文件檢查是否存在需求文檔
頁面源碼檢查源碼文件、console.log、空文件
Schema 緩存檢查緩存文件格式
React Hooks檢查 Hooks 使用規範

​
健康監控模式

啓動持續監控，每分鐘檢查一次： 
openyida doctor --monitor
健康監控功能目前處於 Beta 測試階段。API 和輸出格式在後續版本中可能會發生變化。
輸出示例： 
[14:32:01] 健康度: 95/100 📈
  通過: 18/19 | 錯誤: 0 | 警告: 1

[14:33:01] 健康度: 100/100 ➡️
  通過: 19/19 | 錯誤: 0 | 警告: 0
按 Ctrl+C 停止監控。

​
線上診斷

針對已發佈應用的線上診斷： 
openyida doctor --production --app <appId>
檢查內容：
  • 應用 ID 有效性
  • 線上錯誤日誌
  • 性能指標

​
工單與 VOC

​
創建工單（Bug）

openyida doctor --create-ticket
交互式輸入標題和描述，自動提交到 GitHub Issues。

​
創建 VOC（需求）

openyida doctor --create-voc

​
智能提交

系統自動判斷是 Bug 還是需求： 
openyida doctor --auto-submit

​
診斷報告示例

​
控制檯輸出

🔍 檢查 OpenYida 環境依賴...

✅ openyida 版本：2026.04.02（SKILL 期望：2026.04.02）
✅ project/ 工作目錄已初始化
✅ Node.js v18.19.0（要求 ≥ 18）
✅ Playwright 已安裝
✅ config.json 存在且格式正確
✅ 宜搭登錄態：已登錄
✅ 網絡連通性（aliwork.com）
✅ PRD 文件（2 個）
✅ 頁面源碼（3 個文件）
✅ Schema 緩存（5 個）
✅ React Hooks 規範

通過 11 項檢查，未發現問題
使用自定義輸出格式生成報告是實驗性功能。HTML 和 JSON 輸出模式在後續更新中可能會進行優化。

​
Markdown 報告

openyida doctor --report markdown
報告保存到 .cache/reports/doctor-2024-01-15T10-30-00-000Z.md

​
預檢查

在關鍵操作前自動執行檢查：

​
發佈前檢查

# 自動執行
openyida publish 前會自動運行預檢查

​
創建前檢查

# 自動執行
openyida create-app 前會自動運行預檢查

​
修復類型

類型說明示例
AUTO自動修復創建 config.json、刪除損壞緩存
COMMAND命令修復運行 pip install playwright
MANUAL手動修復安裝 gh CLI、編寫 PRD

​
健康度計算

健康度分數（0-100）計算公式： 
健康度 = 通過率 × 100 - 錯誤數 × 10 - 警告數 × 3
分數狀態
90-100優秀 🟢
70-89良好 🟡
50-69一般 🟠
< 50需改進 🔴