Herdr App and Herdr Core 教學手冊

herdr-app and herdr-core 教學手冊(企業級 AI Agent 協作開發:安裝、操作、Multi-Agent、逆向工程、框架升級與資安治理) 一句話定位:Herdr App 是「看」與「排」的桌面視窗,herdr-core(hc)是「跑」與「接」的背景 Runtime,AI Coding Agent 才是「做事」的人。本手冊教同仁把三者正確分工,用在新系統開發、Legacy 逆向工程與框架升級三種企業情境,並且知道哪些事 Herdr 不會替你做。 文件資訊 項目 內容 文件名稱 herdr-app and herdr-core 教學手冊 文件版本 1.1 更新日期 2026-11-12 文件目的 讓企業開發團隊能實際安裝、操作、整合、維運及導入 Herdr App 與 herdr-core,並以 AI Agent 完成 Web Application 開發、Legacy System 逆向工程與 Framework 升級 適用對象 PM、SA、系統架構師、前後端工程師、測試工程師、DevOps/Platform 工程師、資安工程師;以資深工程師的實戰與維運為主軸 技術範圍 Herdr App 0.1.15、herdr-core 0.1.20(API protocol generation 1)、OSC 7501 Program Status Protocol Rev 0.4、Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Gemini CLI、OpenCode、Git Worktree、Maven、Playwright、Trivy 適用環境 Windows 10/11(PowerShell 7、Git for Windows)為主要範例,另附 Linux/macOS 指令 文件語言 繁體中文(台灣),技術名詞保留英文 文件性質 作者閱讀兩個官方 Repository 的原始碼、由 binary help 產生的官方命令參考、OSC 7501 規格與各 Agent 官方資料後重新整理;不是官方文件翻譯。範例中的系統名稱、模組與任務都是虛構示範 參考資料 官方 Repository、herdr.dev、OSC 7501 規格、各 Agent 官方 Changelog;完整清單見參考資料 修訂紀錄 版本 日期 主要變更 1.0 2026-11-12 初版:7 篇 30 章+附錄 A~F+Checklist+參考資料;附 6 支實測過的企業延伸工具(OSC 7501 回報函式與驗證器、template/Mod/指令檢查器、Worktree 派工腳本、健康檢查腳本)與 3 個 JavaScript Mod 範例 1.1 2026-11-12 逐章重新查證(版本未變:App 0.1.15、Core 0.1.20)。修正:hc 名稱規則改依原始碼 addr.rs(以字母或數字開頭、不可像終端機 ID),同步修正派工腳本與 template_lint.py;Windows 單一引號字串走 cmd.exe、只有 template 需要 sh;Windows template 位置與 --help 字串的差異;KPI 的 Blocked 時間資料來源。新增:7.7 套件管理員安裝、21.10 行動裝置、23.8 version_check.py、25.4 導入前現實檢查、26.9 naming_lint.py、28.3 hc_kpi.py、29.5 已知未修正問題;第 22、25~30 章補齊「本章 AI 產出審查」;附錄 G AI 產出審查總表 版本基準與查證日期 本手冊查證基準日為 2026-11-12。Herdr 兩個專案幾乎每天都在改版(App 與 Core 都還是 0.1.x),使用前請用第 23.1 節的方法重新確認版本,不要直接沿用本手冊的版本號。 ...

November 12, 2026 · 152 min · 32222 words · Eric Cheng

Ghidra 教學手冊

Ghidra 教學手冊(Ghidra + AI Agent 軟體逆向工程企業標準:安裝、分析、Headless 自動化、MCP Adapter、AI 協作、品質審查與維運) 一句話定位:Ghidra 負責從 Binary 擷取可以驗證的證據,例如函式、位址、字串、交叉參照與反編譯虛擬碼;AI Agent 負責整理與推理;人員負責確認與核准。本手冊教你把這三者接成一條可重跑、可稽核、可審查的企業流程,而不是「把 EXE 丟給 AI,問它在做什麼」。 文件資訊 項目 內容 文件名稱 Ghidra 教學手冊 文件版本 2.1(十篇、41 章;新增「行為層級」的驗證工具與 12.2 新功能) 更新日期 2026-11-12 文件等級 企業標準技術白皮書。可直接作為專案團隊的逆向工程作業規範與教育訓練教材 文件目的 讓同仁能夠:(1) 獨立安裝與操作 Ghidra;(2) 用 Headless 管線批次產出結構化分析資料;(3) 透過企業自建的唯讀 MCP Adapter,讓 Claude Code、Codex、GitHub Copilot 使用 Ghidra;(4) 用可重跑的檢查工具審查 AI 產出的逆向工程報告;(5) 依 SOP 維運、升級與管控整個平台 適用對象 資深工程師、Reverse Engineer、系統分析師、軟體架構師、AI Engineer、DevSecOps、PM。主軸是實戰與維運;初學者可以依第一~三篇循序學習 技術範圍 Ghidra 12.2(JDK 25)、PyGhidra 3.2.0、Headless Analyzer、Ghidra Extension(Gradle 9.8.0)、MCP Python SDK 2.3.0、Claude Code 2.1.322、OpenAI Codex、GitHub Copilot(VS Code 1.145.3) 適用環境 主要範例為 Windows 10/11(PowerShell 7);另附 Linux 指令(以 Temurin 25 容器實測)與 macOS 指令 文件語言 繁體中文(台灣)。技術名詞保留英文,第一次出現時附中文說明 文件性質 作者閱讀 Ghidra 官方原始碼、發行包文件、官方 GitHub 與各 AI 工具官方文件,並在本機實測後重新組織而成;不是任何官方文件的翻譯。範例中的銀行規則、帳號與表名都是虛構的 Lab 資料 參考資料 完整清單見第 41 章與文末「參考資料」 修訂紀錄 版本 日期 主要變更 1.0(第一部分) 2026-11-12 第一~四篇(第 1~15 章)。第五篇起的撰寫中斷,未收錄 2.0 2026-11-12 全面重寫並補齊十篇 41 章:(1) 新增第五~十篇:AI 整合架構、MCP 比較與自建 Adapter、Claude Code/Codex/Copilot 整合、四個實戰案例、維運、升級、安全、導入、Prompt、Skills、品質管理、教育訓練、Roadmap、附錄(2) 每章最後都有「本章 AI 產出審查」,列出好例、壞例與可重跑的檢查指令(3) 重新查證版本,並重跑 Lab 管線、MCP Adapter 驗收測試與報告審查工具(4) 目錄改依 Hugo 實際錨點產生,並逐一比對 2.1 2026-11-12 逐章查證並補強深度(上游版本與 2.0 相同,未全面重寫):(1) 新增行為層級的驗證:P-Code 模擬驗證規則(12.14)、案例檔審查、可執行的驗收基準(26.11)、BSim 版本差異(27.11)、考題自動驗證(37.8)(2) 新增 12.2 相關主題:DWARF/PDB 與簽章來源(10.14)、Go/Rust/Swift(10.15)、企業型別庫(8.10)、Debugger 與 Timeless Debugging(3.19、31.15)、Server 憑證與 Allow List(29.12)、VS Code/jshellRun(13.14)(3) 新增 8 支實測工具與附錄 A.5 的 Lab 變體(C、Go、Rust);FAQ 新增 4 個實際踩到的問題(40.16~40.19)(4) 修正:EmulatorHelper 已 deprecated(改用 PcodeEmulator);Demangler 安全公告改以官方 GHSA 為準;第 39.11 節的抽取程式略過 markdownlint 註解 版本基準與查證日期 本手冊的查證基準日是 2026-11-12。Ghidra 大約每 1~3 個月發布一次修正版,AI 工具更是每週改版。使用前請先用第 30.1 節的方法重新確認,不要直接沿用下表。 ...

November 12, 2026 · 206 min · 43819 words · Eric Cheng