PentAGI 教學手冊

PentAGI 企業級教學手冊(實戰與維運) 一句話定位:PentAGI 是一套自我託管(self-hosted)的多 Agent AI 滲透測試平台。它用 LLM 規劃測試步驟,在 Docker 容器裡呼叫 nmap、sqlmap 等安全工具執行,並把過程、結果與記憶存進 PostgreSQL/pgvector。它能加速授權範圍內的安全驗證,但不會自動讓你的系統安全,也不能取代資安人員、SAST/DAST/SCA 與正式安全驗收。 適用對象:資深工程師、架構師、DevSecOps、資安測試人員、平台維運人員。SA、PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git 與至少一種 AI Coding 工具(Claude Code、GitHub Copilot、Codex 等)。 版本基準: 項目 內容 PentAGI 版本 v2.2.0(GitHub Release,2026-10-05 發布);本手冊所有原始碼與設定核對都以 tag v2.2.0 為準 main 追蹤 研究日 main 為 cffed94(2026-10-22),領先 v2.2.0 共 3 個 commit,全部是 README 文件修改,沒有程式或設定變更;另有多個尚未合併的安全與穩定性 PR 需追蹤(見 16.2、16.2.1) 前一版 v2.1.0(2026-05-29)、v2.0.0(2026-04-11);v2.1.0 以前受 CVE-2026-14784 影響(見 6.4) 授權 原始碼 MIT;另有 EULA(僅限合法滲透測試用途、可撤銷)與 NOTICE(VXControl Cloud SDK 授權說明);官方另販售 Enterprise Edition 授權。不能只看 GitHub 的 MIT 標籤(見 20.8) 原始碼核對範圍 README.md、.env.example、docker-compose*.yml、EULA.md、NOTICE、backend/docs/{docker,config,database}.md、examples/guides/{worker_node,installation_configuration}.md、examples/prompts/*、backend/pkg/config/config.go、backend/pkg/docker/{client,sandbox}.go、Release notes v2.0.0~v2.2.0 研究基準日期 2026-10-29(1.1 版於同日重新查核上游 Release、main、Docker Hub digest、NVD 與 open issue/PR) 實測狀態 未在實機安裝 PentAGI(需要真實 LLM API Key、Docker 主機,且平台本身會主動發起攻擊行為)。所有 PentAGI 指令都對照 v2.2.0 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 3 支企業自訂審查工具(.env 安全檢查、任務範圍檢查、弱點報告檢查)與第 18 章的稽核 SQL 已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8(僅用於撰寫與驗證審查工具,只用標準函式庫);PostgreSQL 16(Podman 暫時容器,只用於驗證第 18 章 SQL) 手冊版本 1.1(2026-10-29;補齊第 18 章、加入上游已知問題與待合併修補;版本紀錄見 21.12) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、系統與資料全部虛構(使用 example.com、corp.example、10.x、192.0.2.x 等保留或私有範圍)。 ...

October 29, 2026 · 114 min · 24088 words · Eric Cheng

NemoClaw 教學手冊

NemoClaw 企業級 AI Agent 沙盒參考堆疊教學手冊(實戰與維運) 一句話定位:NVIDIA NemoClaw 是一套「把受支援的 AI Agent 裝進 NVIDIA OpenShell 沙盒」的開源參考技術堆疊。它提供引導式安裝(onboarding)、版本化 Blueprint、託管推理路由、網路政策 preset、狀態保存與生命週期指令;真正執行隔離、攔截網路、保管憑證的是底下的 OpenShell。NemoClaw 讓你「少做整合工作」,不會讓 Agent「自動變安全」。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理者。PM、SA、SD 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git,以及至少一種 AI Coding 工具。 版本基準: 項目 內容 NemoClaw 版本 v0.0.139(tag commit a08ae7a,2026-10-26);官方文件站 latest 已對應此版 安裝程式預設版本 官方安裝程式預設追蹤 lkg(last known good)標籤,研究當日指向 v0.0.137(f00fb1d,2026-10-21);要用 v0.0.139 必須明確指定 NEMOCLAW_INSTALL_TAG=v0.0.139(第 4 章) 搭配的 OpenShell 0.0.116(Blueprint 的 min_openshell_version 與 max_openshell_version 都是 0.0.116;@nvidia/openshell-sdk 也釘 0.0.116) 支援的 Agent OpenClaw(預設)、Hermes、LangChain Deep Agents Code(dcode 0.1.71);三者在官方平台矩陣皆為 Tested,但 Hermes 官方註明「尚未宣稱與 OpenClaw 的正式環境同等」 專案階段 alpha/Early preview(官方平台矩陣:自 2026-03-16 起),維護者以 best effort 回應、無 SLA 原始碼核對 NVIDIA/NemoClaw tag v0.0.139:docs/(官方文件原始檔)、install.sh、scripts/install-openshell.sh、nemoclaw-blueprint/(Blueprint 與政策)、agents/*/(各 Agent 的 manifest 與政策)、src/lib/(CLI 實作) 研究基準日期 2026-10-27;main 追蹤至 bafe6cc(2026-10-26,領先 v0.0.139 共 18 個 commit);另有 Rust 重寫的 v1 分支(見 1.7)。1.1 版於同日再核對:沒有新 tag,lkg 仍指向 v0.0.137,main 仍為 bafe6cc(18.11) 實測狀態 未在實機安裝 NemoClaw 或 OpenShell。所有 NemoClaw/OpenShell 指令都對照 v0.0.139 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 5 支企業自訂審查工具(政策 lint、交付報告比對、架構依賴檢查、逆向工程引用檢查、測試弱化檢查)、安全公告版本下限腳本與 ArchUnit 範例,已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8、PyYAML 6.0.3、OpenJDK 21.0.4、Maven 3.9.9、Node.js 24.16.0(僅用於撰寫與驗證審查工具) 手冊版本 1.1(2026-10-27;1.0 於同日初版;版本紀錄見 18.13) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、corp.example、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 117 min · 24890 words · Eric Cheng

OpenShell 教學手冊

OpenShell 企業級 AI Agent 安全執行環境教學手冊(實戰與維運) 一句話定位:NVIDIA OpenShell 是讓 AI Agent「在受控邊界內做事」的安全執行與治理 Runtime。它不是模型、不是 Agent Framework,也不只是容器管理工具;它把檔案、程序、網路、憑證四件事從 Agent 手中收回,交給 Agent 碰不到的 Gateway 與 Supervisor 來決定。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理人員。PM、SA、SD 可依 1.6 的學習路徑選讀。內容偏實戰與維運,假設讀者熟悉 Linux、容器、Git 與至少一種 AI Coding 工具。 版本基準: 項目 內容 OpenShell 版本 v0.1.5(Stable,2026-10-20 發布,tag commit bdb956f) 官方文件版本 docs.nvidia.com/openshell/latest(頁首標示「Latest (v0.1.5)」) 原始碼核對 NVIDIA/OpenShell tag v0.1.5:crates/openshell-cli/src/main.rs(CLI 參數)、providers/*.yaml(Provider Profile 範例)、examples/(官方範例) 研究基準日期 2026-10-27;main 分支追蹤至 commit 2ff59bf(2026-10-26),未發布變更見 18.2.1 實測狀態 未在本機安裝或實測(使用者決定只依文件撰寫)。所有指令都對照 v0.1.5 官方文件與 CLI 原始碼,標 📖;需要實際環境才能確認的內容標 🧪,並附驗證步驟與預期結果。1.1 新增的 4 支審查工具(policy-lint.py、check-test-evidence.py、check-dockerfile.sh、引用檢查)已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300(僅用於撰寫與文件驗證,未安裝 OpenShell) 手冊版本 1.1(2026-10-27:新增 AI 產出審查方法與工具、main 未發布變更追蹤;版本紀錄見 24.11) 文件性質:企業內部教育訓練與開發規範。內容為重新整理與組織,不是官方文件翻譯;所有範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、example.internal、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 124 min · 26236 words · Eric Cheng

Pstack 教學手冊

pstack:企業級 AI 輔助軟體工程教學手冊(Claude Code、Codex、Pi 實戰與維運) 一句話定位:pstack 是一包純文字的 Agent Skills(skills/<name>/SKILL.md)加上 24 條工程原則,目標是讓 AI 寫「更少但更扎實」的程式碼。本手冊把它從「個人工作風格」整理成「團隊可執行、可稽核、可維護」的企業做法。 適用對象:資深工程師、架構師、DevSecOps、QA、技術主管。偏實戰與維運,假設你已熟悉 Git、Node.js 與至少一種 AI Coding Agent。 研究對象:pstack 的兩個來源,兩者指令不可混用(詳見 1.1 與 5.1): 上游:cursor/plugins 儲存庫的 pstack/ 目錄,https://github.com/cursor/plugins/tree/main/pstack 獨立 mirror:backnotprop/pstack,https://github.com/backnotprop/pstack Claude Code Plugin 實際安裝的內容:上游根目錄的 harness/pstack/claude-code/(由 pstack/ 產生,詳見 1.1),https://github.com/cursor/plugins/tree/main/harness/pstack/claude-code 版本基準: 項目 內容 pstack 版本 技能、原則、範例逐檔核對的基準是 0.15.28(mirror 0c3333f/上游 d457567);上游 cursor/plugins/pstack 在 2026-10-20 已前進到 0.15.29(88d4751,只改 /sharpen 與同步文件,無新增技能、無可執行檔變更,見 14.2.1) mirror 最新 commit 0c3333f(2026-10-19,訊息為「Sync upstream cursor/plugins/pstack @ d457567 (0.15.28)」);2026-10-20 查證時尚未同步 0.15.29 技能資料夾數量 56(32 個一般技能+24 個 principle-*;Skills CLI 與本機 clone 兩種方式數量一致) 授權 MIT(LICENSE 署名 Lauren Tan,2026) 版本機制 沒有 release tag,只有 plugin.json 的版本字串與 commit hash;鎖版請用 commit hash(第 14 章) 事實查證日期 2026-10-20(官方文件、GitHub 原始碼、本機實測) 實測環境 Windows 11 Pro(10.0.26300)、Git Bash/PowerShell、Node.js 24.16.0、npm 11.13.0、Git 2.45.2、Skills CLI 1.7.4、Claude Code 2.1.303(查證日最新為 2.1.304)、JDK 21 教學環境 Windows 11(原生 PowerShell/Git Bash)為主;WSL、macOS、Linux 為補充(依官方文件,未實測) 手冊版本 1.1(2026-10-20):1.0 為同日初版;1.1 依上游 0.15.29、Claude Code 2.1.299~2.1.304、Codex Plugin 與 Pi 最新文件增補(版本紀錄見 19.5) 文件性質:企業內部教育訓練與開發規範。內容為作者整理後重新組織,非官方文件翻譯;引用來源列於第 19 章。範例中的帳號、密碼、金額、客戶資料全部是虛構資料。 ...

October 20, 2026 · 151 min · 32040 words · Eric Cheng

e2e 教學手冊

e2e:AI Agent 驅動的企業級端到端測試、逆向工程與軟體升級教學手冊 一句話定位:用 e2e(TesterArmy 開源專案)把「使用者看得到的行為」寫成可重複執行的驗收測試,讓 AI Coding Agent 在開發、逆向工程、Framework 升級時有一把可以量測的尺。 適用對象:資深前後端工程師、測試/品質工程師、DevOps、架構師。偏實戰與維運,假設你已熟悉 Node.js、TypeScript、Git 與 CI/CD。 研究對象:tester-army/e2e(npm 套件名稱 e2e),不是泛指所有 E2E 工具,也不等於 Playwright。 官方 Repository:https://github.com/tester-army/e2e 官方文件:https://e2e.tester.army/docs 官方介紹文章:https://tester.army/blog/introducing-e2e 版本基準: 項目 內容 e2e 版本 0.21.2(npm latest,GitHub Release 日期 2026-10-16) 搭配套件 @e2e-dev/web 0.15.2(已實測)、@e2e-dev/github 0.4.2(已實測,選用)、@e2e-dev/mobile 0.12.3(僅依 Release 資訊,未實測) 實測環境 Windows 11 原生、Node.js 24.16.0、npm 11.13.0、Chromium 156(Playwright 1.64.0);詳見 17.3 Node.js 需求 ^22.22.3 或 >=24.8.0(官方 CI 範例使用 Node 26) 授權 Apache-2.0 專案狀態 pre-1.0,積極開發中;官方明講 API 與設定在 minor 版本之間可能變動 資料研究日期 2026-10-19 事實查證日期 2026-10-19(以官方文件與 npm registry 為準) 教學環境 Windows 10/11 + WSL2(Ubuntu)(官方要求);Linux、macOS、GitHub Actions 為補充 文件性質:企業內部教育訓練與開發規範。內容為作者整理後重新組織,非官方文件翻譯;引用來源列於第 18 章。 ...

October 19, 2026 · 158 min · 33503 words · Eric Cheng

銀行大型共用平台:資料庫設計、建置、安全治理與維運教學手冊

銀行大型共用平台:資料庫設計、建置、安全治理與維運教學手冊 文件資訊 項目 內容 文件名稱 銀行大型共用平台:資料庫設計、建置、安全治理與維運教學手冊 英文代號 database-design-handbook 版本 v2.0.0(企業標準技術白皮書版) 查核基準日 2026-10-15(本手冊所有外部來源之查核日期,除另有註明外皆同) 前一版本 v1.0(初版) 適用對象 資深工程師、SA、DBA、軟體架構師、資安人員、維運人員、新進同仁 適用範圍 新建系統、逆向工程、版本升級、資料庫整併與遷移、多租戶共用平台、跨區域部署 涵蓋產品 Oracle Database、IBM Db2(LUW)、PostgreSQL、Microsoft SQL Server 文件性質 企業內部技術標準草案與教育訓練教材,正式施行前須經架構、資安、法遵審查 版本基準與說明 本手冊範例以下列版本為基準。原廠支援狀態會隨時間變動,正式選用前必須再次查核原廠生命週期頁面。 產品 本手冊基準版本 查核結果與備註 Oracle Database 19c(長期支援版)、AI Database 26ai Oracle AI Database 26ai 已於 2025-10 取代 23ai:既有 23ai 套用 2025 年 10 月 Release Update 即成為 26ai,不需資料庫升級;地端 Linux x86-64 Enterprise Edition 自 2026-01 季度 RU(23.26.1)起提供。其他平台時程以 MOS Doc ID 742060.1 為準 IBM Db2 LUW 11.5、12.1 各 Mod Pack/Fix Pack 支援期限以 IBM Support 生命週期頁面為準(查核日官方頁面無法存取,列入待確認清單) PostgreSQL 17、18 查核日 18.6 為最新正式版(18 於 2025-09-25 發布,社群支援至 2030-11);19 為 Beta 4(2026-09-24);14 將於 2026-11-12 終止支援 SQL Server 2022、2025(17.x) 2025 於 2025-11 GA,查核日已發布至 CU9 以上;2022 仍持續發佈 CU。2025 停止提供 Web edition、DQS、MDS 本版重要版本差異速查 產品 對資料庫工程有直接影響的新能力 本手冊對應章節 PostgreSQL 18 uuidv7()、虛擬計算欄位成為預設、RETURNING 可取 OLD/NEW、WITHOUT OVERLAPS 與 PERIOD 時態約束、非同步 I/O(io_method)、多欄 B-tree skip scan、OAuth 2.0 認證、md5 密碼認證列為棄用、initdb 預設啟用 data checksums、pg_upgrade 保留統計資訊與 --swap、idle_replication_slot_timeout 5、8、9、13、16、17、20 SQL Server 2025 原生 json 型別、vector 型別、REGEXP_* 函數、Optimized Locking、ZSTD 備份壓縮、備份至不可變 Blob、次要複本可做完整與差異備份、TLS 1.3/TDS 8.0 全面支援、PBKDF2 密碼雜湊預設 3、8、9、13、15、16 Oracle AI Database 26ai SQL Firewall、Data Privacy Protection(列/欄/儲存格層級控制與動態遮罩)、資料傳輸 ML-KEM 抗量子演算法、True Cache、Globally Distributed Database(RAFT 複寫)、Annotations 與 Usage Domains、BOOLEAN 型別 3、5、13、15 Db2 12.1 以 IBM 官方 What’s New 為準(待確認細節) 3、16 所有 SQL、Shell、組態範例皆為示範用途、待各專案環境驗證,未在本文件撰寫過程中於正式環境執行。 ...

October 15, 2026 · 100 min · 21205 words · Eric Cheng

REA 教學手冊

REA 教學手冊 REA(Reverse Engineer Anything)— 讓 AI Coding Agent 具備「有證據可追溯」的逆向工程能力層 適用對象:資深工程師、架構師、Tech Lead、資安與 DevSecOps 人員、維運人員、導入專案 PM 文件性質:企業內部 REA 導入、實作、維運與治理的培訓教材與開發規範 版本基準:官方 GitHub morluto/rea、npm 套件 rea-agents 6.4.0(CHANGELOG 日期 2026-10-11;npm 發佈時間 2026-10-11 04:02 UTC); 本手冊查證日期 2026-10-12;授權 MIT 實測環境:Windows 11、Node.js 24.16.0;rea-agents@6.4.0 與 6.3.0 皆以 --ignore-scripts 安裝於隔離目錄,只分析自建的虛構測試應用(4.9) 重要聲明(請務必先讀) ⚠️ 以下 7 點是使用本手冊前必須理解的前提。 REA 迭代極快,且每個 minor 版本都可能包含 breaking change。 官方 CHANGELOG 中 6.1.0、6.2.0、6.3.0、6.4.0 皆列有 breaking changes,6.2.0 還附專屬遷移指南 docs/migration-6.2.md,並自述採 always-bump-minor 政策 (「包含 breaking changes,不是向下相容承諾」)。本手冊的所有指令、工具名稱、參數,只代表 2026-10-12 對照 6.4.0 的查證結果。 正式導入前,請以你實際安裝的版本與 binary_session 回傳的工具清單為準(見 第 2 章)。 ...

October 12, 2026 · 123 min · 26018 words · Eric Cheng

AX 教學手冊

AX 企業級 AI Agent 開發與維運教學手冊 研究對象: Google google/ax — open agentic orchestration runtime 官方 Repository: https://github.com/google/ax 官方網站: https://agentexecutor.io API 版本: ax.io/v1alpha1(Alpha) 最新 Release: v0.3.1(2026-09-25;歷史版本:v0.1.0 2026-05-20 → v0.2.0v0.2.3 2026-0708 → v0.3.0 2026-09-20) 資料擷取日期: 2026-10-07(以當日 main branch 的 README、DESIGN.md、docs/、examples/ 為準,並對照 v0.3.1 release) 授權: Apache License 2.0 適用對象: SA / Architect、SD、PG、AI Engineer、DevOps / DevSecOps、Kubernetes 管理人員、平台工程師、PM 文件等級: 企業內部 Engineering Handbook / AI Development Standard [!WARNING] 重要風險聲明(請所有讀者先讀) AX 官方 README 明確表示: “AX and several of its features are in heavy development. We are actively refining our core concepts, protocols, and specifications, and will likely introduce major breaking changes prior to a stable release.” ...

October 7, 2026 · 117 min · 24770 words · Eric Cheng

OpenRig 教學手冊

OpenRig 企業級 AI Multi-Agent 軟體開發教學手冊 對應版本:OpenRig @openrig/cli v0.6.6(撰寫時 2026-10 之最新 Release) 資料擷取日期:2026-10-07(官方 README、docs/reference/*.md、SECURITY.md、ROADMAP.md、Release Notes v0.6.0–v0.6.6) 執行環境:Node.js 22 / 24、tmux、macOS / Linux 適用對象:軟體架構師、PM / AI Project Manager、SA / SD、前後端工程師、DevOps / Platform Engineer 授權:Apache License 2.0 官方 Repository:mvschwarz/openrig 官方網站:openrig.dev 原始規劃檔名:OpenRig-Enterprise-AI-Agent-Development-Handbook.md(本 repo 依團隊慣例存為「OpenRig 教學手冊.md」,全部內容集中於單一檔案) 本手冊閱讀約定 本手冊會清楚區分「官方行為」與「團隊建議」,請閱讀時特別留意以下標記: 標記 意義 📘 官方功能 已由 OpenRig 官方 Repository、docs/reference/*.md 或 Release Notes 確認 🏢 企業建議 本手冊作者依企業(特別是銀行 / 金融)實務提出的規範或做法,不是 OpenRig 內建功能 ⚠️ Version-dependent 指令參數、欄位或行為可能隨版本變動,或官方文件未完整列出;使用前請以 rig <command> --help 或 rig context get help 確認 🔒 安全注意 涉及權限、Credential、Prompt Injection 等安全議題 核心觀念:OpenRig 不是「多開幾個 Claude Code Terminal」。它是把多個 AI Coding Agent 組成「有角色、有拓撲、能溝通、可持久化、可被人類控制」之 Agent Team 的 Harness / Orchestration 層。 ...

October 7, 2026 · 85 min · 17907 words · Eric Cheng

IBM MQ 系統管理與 Java 開發教學手冊

IBM MQ 系統管理與 Java 開發教學手冊 文件版本:1.1 資訊確認日期:2026-10-03 IBM MQ 基準版本:IBM MQ 10.0(LTS,2026-06 GA);同時標示 9.3 / 9.4 的差異 Java 基準版本:**Java 25(LTS)**為主要範例環境,並標示 Java 17 / 21 差異 Spring Boot 基準版本:Spring Boot 4.x(Spring Framework 7.x、Jakarta EE 11)為主,並說明 3.x 差異 Java Messaging API:IBM MQ classes for Jakarta Messaging 3.0(新開發首選)、IBM MQ classes for JMS 2.0(維護既有系統)、IBM MQ classes for Java(功能凍結,僅維護) 適用對象:Java 開發人員、前後端工程師、SA、軟體架構師、IBM MQ 系統管理員、DevOps / DevSecOps、維運人員、PM / Technical PM、Legacy 維護人員、逆向工程人員、Framework 升級團隊、AI Coding Agent 使用者 文件狀態:版本資訊均對照 IBM 官方文件(IBM Documentation,IBM MQ 10.0.x)與 IBM 官方 GitHub(ibm-messaging)查證。查不到或可能隨修補版變動的資訊,一律標示「需依目前 IBM 官方文件確認」,不猜測、不補完。 ...

October 4, 2026 · 146 min · 31081 words · Eric Cheng