---
title: '更新日誌'
description: 'Panguard AI 的版本發佈歷史與更新紀錄。'
icon: 'clock-rotate-left'
---

Panguard AI 的所有重要變更，按版本組織。

<Info>
  完整的更新日誌包含修補說明，請參閱 [GitHub releases
  頁面](https://github.com/panguard-ai/panguard/releases)。
</Info>

---

## v1.5.6 (2026-05-12)

**發佈日期：2026-05-12** -- 最新穩定版本，搭配 ATR v2.2.0（419 條規則）

### 重點

- **ATR v2.2.0** 419 條規則（原 v2.0.x 為 71 條），涵蓋 10 個威脅類別
- **Microsoft AGT 整合**：PR #1277 於 2026-04-26 merge，每週自動同步 workflow，287 條規則上線
- **Cisco AI Defense 整合**：PR #99 於 2026-04-22 merge，419 條完整 library 進入 `skill-scanner` 生產環境
- **MISP 整合**：galaxy PR #1207 + taxonomies PR #323 -- 全球威脅情報共享層
- **OWASP A-S-R-H**：PR #74 於 2026-05-11 merge，獲 contributor status
- **Microsoft Copilot SWE Agent 迴圈**：AGT issue #1981（2026-05-11）-- Copilot 對 ATR detection 撰寫 regression test
- **12 個 MCP tools**（原 11 個）、18 個 package monorepo、23 個 CLI 指令
- **Benchmarks**：Garak 97.1% recall、SKILL.md 100% recall（97% precision、0.2% FP）、PINT 62.5% recall（99.6% precision）
- **Wild scan**：在 ClawHub/OpenClaw/Skills.sh 上稽核 67,799 個 AI agent skills；1,096 個確認惡意
- **Migrator Community** 上 npm：`@panguard-ai/migrator-community@0.1.0`（MIT、Sigma/YARA -> ATR 轉換）

---

## v1.4.2

**發佈日期：2026-03-27** -- ClawHub 生態系掃描、遙測、CI 強化

### ClawHub 全量生態系掃描

- **36,394 個 Skills 已爬取**，來自 ClawHub 註冊表（npm、GitHub、awesome-lists）
- **9,676 個有內容的套件**，經 ATR + Skill Auditor（L1 + L2 AST）分析
- **182 CRITICAL / 1,124 HIGH / 1,016 MEDIUM / 7,354 LOW** 發現
- 結果同步至 Threat Cloud：165 個威脅 + 968 個白名單條目

### 遙測基礎設施

- 可選擇加入的匿名遙測，用於掃描和 Guard 使用統計
- 掃描 DRY 重構 -- CLI、MCP 和 Web Scanner 共用掃描邏輯

### CI 強化

- 修復 21 個 ESLint 錯誤
- 審計步驟現在使用 `--timeout` 和 `--no-cloud` 確保 CI 確定性

---

## v1.4.1

**發佈日期：2026-03-26** -- 重大 npm 發布修復

### npm 套件修復

- **修復已發布套件中的 `workspace:*` 引用** -- 之前所有 npm 版本都壞了，因為 pnpm `workspace:*` 協議在發布時未被解析。所有 `@panguard-ai/*` 依賴現在使用精確版本號。
- 已驗證：`npm install -g @panguard-ai/panguard` 現在可正常運作

---

## v1.4.0

**發佈日期：2026-03-25** -- 16 個平台、OWASP 10/10、419 條 ATR 規則

### 16 個 AI 平台支援

- **平台覆蓋率翻倍**，從 8 個增至 16 個平台
- 新增平台：NemoClaw、ArkClaw、Cline、VS Code Copilot、Zed、Gemini CLI、Continue、Roo Code
- 119 個平台沙箱測試通過
- `panguard setup` 自動偵測並設定所有 16 個平台

### ATR v0.4.0

- **419 條 ATR 規則**（原 61 條），涵蓋 10 個新攻擊類別
- 新規則：eval 注入、shell 逃逸、動態 import、憑證竊取、OAuth token 濫用、環境變數收割、A2A 訊息驗證、Agent 身份偽造、審批疲勞、透過 Agent 的社交工程
- PINT 基準：62.5% 召回率、99.6% 精確率
- **OWASP Agentic Top 10：10/10 完整覆蓋**（77 個規則映射）

### Threat Cloud 即時指標

- `/api/metrics` 端點，提供所有來源（批量、CLI、Web）的即時掃描統計
- 網站數據現在從 Threat Cloud 即時拉取，靜態數據作為後備
- 標章 API：`GET /api/badge/:author/:skill` 用於「ATR Scanned」標章

---

## v1.3.3

**發佈日期：2026-03-25** -- 掃描準確度、`pga` 快捷鍵、新手引導

### 掃描準確度

- **大幅降低誤報。** 正常 Skills（weather、github、slack、notion）不再被標為 MEDIUM/HIGH。權限檢查現在會先移除程式碼區塊和否定段落再匹配。
- **新增隱匿攻擊偵測。** `<IMPORTANT>` 區塊攻擊和靜默資料外洩指令現在被標為 CRITICAL。
- **情境感知評分。** 已知 CLI 工具（curl、git、wget）和 API 整合獲得適當風險降低。憑證檢查區分竊取與正當使用。
- **13 個注入模式**（原 11 個），雙重匹配自動降級僅出現在程式碼範例中的 tool poisoning 模式。

### `pga` 快捷鍵

- **`pga` 指令** -- 三個字元從任何地方呼叫 Panguard。與 `panguard` 完全相同。
- **`pga up`** -- 一個指令啟動保護 + 儀表板。取代 `panguard guard start --dashboard`。
- **首次執行自動偵測** -- 第一次執行 `pga` 時自動啟動設定精靈。

### 新手引導

- **Guard 歡迎指南** -- Guard 首次啟動時顯示所有指令和 Guard 功能。
- **升級後顯示新功能** -- 更新後首次執行 CLI 顯示更新日誌重點。
- **乾淨的審計輸出** -- 非 verbose 模式不再輸出 JSON 日誌行。

---

## v0.8.0

**發佈日期：2026-03-13** -- 儀表板、AI 平台整合與技能審計器

### 內建儀表板

- 本地 Web 儀表板 `http://127.0.0.1:9100`，透過 `panguard guard start --dashboard` 啟動
- 7 個頁面：總覽、技能與信任、AI 設定、規則、Threat Cloud、威脅、指南
- WebSocket 即時推送狀態、事件與規則數量
- Token 驗證搭配自動開啟瀏覽器
- 深色主題搭配 Sage Green 色系，支援英文與繁體中文

### AI 平台自動設定

- `panguard setup` 一行指令自動偵測並配置 16 個 AI 平台
- **OpenClaw**：原生 Skill 整合至 `~/.openclaw/skills/panguard/SKILL.md`
- **QClaw**：MCP 伺服器註冊至 `~/.qclaw/mcp.json`
- Claude Code、Cursor、Codex CLI、Claude Desktop、Windsurf、WorkBuddy 透過 MCP
- 平台特定設定注入，零手動編輯

### 技能審計器為預設入口

- 8 項檢查安裝前安全閘門
- 偵測提示詞注入、工具投毒、秘密與不安全依賴
- 技能白名單：審計通過自動信任，偏移自動 revoke
- 整合至 Guard 儀表板（技能與信任頁面）

### 規則分發

- 安裝即附帶 419 ATR 偵測規則
- 每小時自動從 Threat Cloud 同步

### Threat Cloud LLM 審查

- Claude Sonnet 4 API 整合，自動化規則審查
- 社群投票管線處理提交的威脅情報
- 種子管線搭配 11 個威脅情報來源

### 一行安裝流程

- `curl -fsSL https://get.panguard.ai | bash` 觸發互動式設定
- 自動執行 `panguard setup` 配置 AI 平台
- 完成後自動啟動 Guard 與儀表板
- 瀏覽器自動開啟已驗證的儀表板頁面

---

## v0.7.0

**發佈日期：2025-02-25** -- 規則引擎增強與 osquery 整合

### 規則引擎增強

- 聚合表達式支援：`1 of them`、`all of them`、`1 of sel*`、`all of filter*`
- 新的匹配修飾器：`|cidr`（IP 範圍匹配）、`|gt`/`|gte`/`|lt`/`|lte`（數值比較）
- 新的編碼修飾器：`|base64`、`|base64offset`、`|utf8`、`|wide`
- 括號群組條件：`(sel_a OR sel_b) AND NOT filter`

### osquery 整合

- 新增 `OsqueryProvider`，支援以 SQL 查詢系統狀態
- 支援行程、連接埠、使用者、網路介面與核心模組查詢
- 未安裝 osquery 時自動降級至 shell 指令

---

## v0.6.0

**發佈日期：2025-02-25** -- 品牌化 CLI、安全分數與成就系統

### 品牌化 CLI

- 全新 CLI 渲染模組，支援 24-bit ANSI 色彩，匹配品牌調色盤
- Sage Green (#8B9A8E) 主色調
- 進度條、表格、狀態面板與盾牌 ASCII 藝術
- 零外部依賴（不使用 chalk、ora 或 ink）

### 安全分數引擎

- 8 因子加權評分（0-100）
- A 到 F 等級對應
- 趨勢追蹤：改善中、下降中或穩定

### 成就系統

- 12 個成就徽章，自動解鎖與通知

---

## v0.5.0

**發佈日期：2025-02-25** -- 自動回應與威脅情報來源

### 自動回應引擎

- IP 封鎖（macOS pfctl / Linux iptables / Windows netsh）
- 檔案隔離，搭配 SHA-256 追蹤
- 行程終止
- 基於信心度的動作：{'>'}90% 自動執行、70-90% 需確認、{'<'}70% 僅通知

### 威脅情報來源管理

- 5 個來源：ThreatFox、URLhaus、Feodo Tracker、GreyNoise、AbuseIPDB
- 自動更新與本地快取

---

## v0.4.0

**發佈日期：2025-02-24** -- Chat 通知、Trap 蜜罐與合規報告

### Panguard Chat

- 5 個通知頻道：LINE、Telegram、Slack、Email、Webhook
- 3 種使用者角色格式：developer、boss、it_admin
- 雙語警報模板（英文 / 繁體中文）

### Panguard Trap

- 8 種蜜罐服務類型：SSH、HTTP、FTP、SMB、MySQL、RDP、Telnet、Redis
- 攻擊者分析，包含技能等級分類與意圖分析

### Panguard Report

- 台灣資安法（10 項控制措施）、ISO 27001（12 項控制措施）、SOC 2（10 項控制措施）
- JSON 與 PDF 輸出格式

---

## v0.3.0

**發佈日期：2025-02-24** -- Guard AI 引擎與調查

### Panguard Guard

- 5 階段 AI 代理流水線：偵測、分析、回應、報告、調查
- 7 天學習期，自動切換至防護模式
- 42 條 ATR 規則、Dashboard WebSocket 伺服器
- 系統服務安裝（macOS / Linux / Windows）

### Threat Cloud

- RESTful API 伺服器，搭配 SQLite 後端
- IoC 提交、查詢與批次查詢
- API 金鑰驗證

---

## v0.2.0

**發佈日期：2025-02-23** -- 掃描引擎與 PDF 報告

### Panguard Scan

- 系統環境偵察、密碼策略稽核
- 連接埠掃描，搭配危險連接埠偵測
- SSL 憑證驗證、排程任務稽核、共享資料夾安全檢查
- 風險評分 0-100（A 到 F 等級）
- PDF 報告產生

---

## v0.1.0

**發佈日期：2025-02-23** -- 核心基礎

### @panguard-ai/core

- TypeScript monorepo 架構
- 國際化支援（英文 + 繁體中文）
- ATR 規則引擎、系統偵察引擎
- 4 個監控器：Log、Network、Process、File
- 3 個轉接器：Windows Defender、Wazuh、Syslog
- AES-256-GCM 加密

### 基礎設施

- pnpm workspace monorepo
- Vitest 測試框架
- ESLint 搭配 eslint-plugin-security
- GitHub Actions CI/CD
