OpenMAIC 教學手冊

OpenMAIC 教學手冊 文件版本:1.1 研究日期:2026-09-13 OpenMAIC 版本:v1.0.1(發布於 2026-09-06T07:09:09Z,「Security and stability」;已透過官方 Releases API 覆核,其後無任何新版本,含 pre-release) Node.js 需求:>= 22.19.0(engines.node,v1.0.1 起自 20.9 提高) pnpm:10.28.0(packageManager 以 SHA-512 釘死) 授權:MIT(例外:packages/mathml2omml 為 LGPL-3.0-or-later;packages/pptxgenjs 為第三方 MIT) 官方 Repo:THU-MAIC/OpenMAIC 託管服務:open.maic.chat 學術出處:From MOOC to MAIC: Reimagine Online Teaching through LLM-driven Agents, Journal of Computer Science and Technology (JCST), DOI 10.1007/s11390-025-6000-0 文件狀態:Based on latest verified sources(所有官方能力均對照 2026-09-13 當日之官方 Repo 實際查證,來源包含 README.md、.env.example、CHANGELOG.md、docker-compose.yml、package.json、render-service/README.md、GitHub Releases API,以及 skills/agent-runtime/、lib/server/agent-runtime/ 的實際目錄清單) 篇幅:53 章,分為 11 部;目錄涵蓋全部 53 章與其下所有小節 ...

September 13, 2026 · 218 min · 46426 words · Eric Cheng

Claude Code企業級軟體開發教學手冊

Claude Code 企業級軟體開發教學手冊 Enterprise Claude Code AI Software Engineering Handbook 把 Claude Code 當成 企業級 AI 軟體工程平台(AI Software Engineering Platform) 導入 Web 應用開發、Legacy 逆向工程、Framework 升版、測試、Code Review、DevSecOps、CI/CD 與 AI 治理的完整實作手冊 文件資訊 項目 內容 文件版本 3.0 初版日期 2026-09-10 本版更新日期 2026-11-16(v3.0 變更摘要見 F.9;v2.0 見 F.8;v1.2 見 F.7;v1.1 見 F.6) 最後查證日期 2026-11-16(以官方文件索引 https://code.claude.com/docs/llms.txt 當日所列 205 頁為母體,累計覆核約 169 頁,其中 v3.0 新增 8 頁、重新覆核 10 頁,並以 settings-reference 的 249 個設定鍵逐鍵比對本手冊;官方 changelog 覆核至 v2.1.325(2026-11-13);另查閱 anthropics/claude-code 的 GitHub Security Advisories;範例以本機 Claude Code v2.1.325 實跑;查證清單與未覆核項目見附錄 F) 官方文件站 https://code.claude.com/docs/en/overview 目標產品 Claude Code(Free / Pro / Max / Team / Enterprise 方案,以及 Claude Console API、Amazon Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry、Claude Platform on AWS 等 Provider) 涵蓋介面(Surface) Terminal CLI、VS Code、JetBrains、Desktop App、Claude Code on the web(cloud session)、Claude Projects、Claude 行動 App、Slack、Chrome、GitHub Actions、GitLab CI/CD、Remote Control、Self-hosted Environments 涵蓋客製化機制 CLAUDE.md、AGENTS.md、.claude/rules/、Auto Memory、Skills、Subagents、Agent Teams、Dynamic Workflows、Hooks、MCP、Plugins、Plugin Evals、Output Styles、Agent SDK、Advisor Tool、Status Line/Keybindings 涵蓋治理機制 Managed Settings(managed-settings.json / MDM / Server-managed)、Permission Rules、Permission Modes、Auto Mode Classifier、Sandboxing、Sandbox Environments、Managed MCP(managedMcpServers)、Plugin Marketplace 限制、Corporate Launcher(processWrapper)、Deep Link 註冊控管(disableDeepLinkRegistration)、Fast Mode 組織啟用與 fastModePerSessionOptIn、Gateway 存取控管(gatewayInternalNetworks)、Claude Apps Gateway 政策與 Spend Limits、syncClaudeAiSkills/blockReadsOutsideWorkingDirectories、managed_settings_resolved 政策遙測、OpenTelemetry、Analytics、Zero Data Retention、v2.0:allowedProviders、availableModelsMatch/deniedModels、Claude Mods 治理(allowManagedModsOnly、prependPlugins)、Hook onFailure、HIPAA 配置、v3.0:denyInsteadOfPrompting、blockWritesOutsideWorkingDirectories、sandbox.autoAllowBashIfSandboxed、policyHelper、managed 來源 first-wins 規則、Code Mode 封鎖、Desktop 管理鍵、Code Review 審查等級與支出控管 範例技術棧 Vue 3.x + TypeScript + Tailwind CSS + PrimeVue + Pinia/Angular 20 + PrimeNG + NgRx(前端);Java 25 + Spring Boot 4.x + Maven(後端);PostgreSQL / Oracle / DB2 / SQL Server;JUnit 5 + Testcontainers + ArchUnit + GitHub Actions 適用對象 資深軟體工程師、Full Stack Developer、Software Architect、AI Architect、Enterprise Architect、SA、PM、BA、QA、DevOps / SRE、DevSecOps、Security、Tech Lead、Engineering Manager 文件定位 實戰與維運導向的企業標準技術白皮書;不是 Git 入門教材,不是 AI 概論,不是 官方文件翻譯 篇幅 8 部、59 章 + 8 個附錄(A–H)(v3.0 新增 Version Note 14–16 與 25 個小節(另有 3 個 #### 子節),更正 19 項過時記載,並在受影響章節的「本章審查與驗證清單」追加檢查列;v2.0 新增第 57–59 章與各章審查清單) 可信度標示制度(請務必先讀) Claude Code 在 2025–2026 年間的產品架構變動幅度極大:預設權限模式反轉、新機制 GA、舊機制下架,全部發生在 12 個月內。網路上(包含中文技術部落格、影片教學、AI 產生的文章)有大量內容已經過時,而且過時的部分往往正是企業最在意的權限、沙箱與治理設定。 ...

September 11, 2026 · 409 min · 87047 words · Eric Cheng

GitHub Copilot企業級軟體開發教學手冊

GitHub Copilot 企業級軟體開發教學手冊 Enterprise GitHub Copilot AI Software Engineering Handbook 把 GitHub Copilot 當成 企業級 AI 軟體工程平台(AI Software Engineering Platform) 導入 Web 應用開發、Legacy 逆向工程、Framework 升版、測試、Code Review、DevSecOps、CI/CD 與 AI 治理的完整實作手冊 文件資訊 項目 內容 文件版本 1.3 初版日期 2026-09-10 最後改版日期 2026-10-10(v1.3:補入 2026-09-25 至 10-07 官方變更,新增 Version Note 12、第 5.6.4、5.8.5、6.4.7、8.15、13.13、30.8、44.5.3 等節與附錄 I;更正 managed settings 佈署路徑、沙箱鍵名、權限樣式等 22 項;詳見附錄 I) 最後查證日期 2026-10-10(v1.3:下載 docs.github.com/en/copilot 全部 543 頁原始 Markdown 逐章比對,並逐則覆核 2026-09-25 至 2026-10-07 的 GitHub Changelog;新增的檢查腳本皆以正反例實際執行,見附錄 I.1) 官方文件站 https://docs.github.com/en/copilot 目標產品 GitHub Copilot(Free / Student / Pro / Pro+ / Max / Business / Enterprise) 涵蓋介面 IDE(VS Code、Visual Studio、JetBrains、Eclipse、Xcode)、GitHub Copilot CLI、github.com、GitHub Mobile、GitHub Copilot app、Copilot cloud agent、Copilot SDK、Slack、Microsoft Teams、第三方 coding agents(Anthropic Claude/OpenAI Codex)、Agent apps 涵蓋客製化機制 Custom Instructions、Prompt Files、Custom Agents、Agent Skills、Hooks、MCP、Plugins、Memory、Copilot Spaces、Automations、GitHub Agentic Workflows 涵蓋治理機制 Enterprise / Organization Policies、AI Controls、Agent Management、Enterprise Managed Settings(managed-settings.json)、Content Exclusion、MCP Allowlist / Registry、Audit Log、OpenTelemetry、Global Model Policy、模型退役管理、Team Specialization、Agent 操作權限強制管控、新功能預設啟用政策(Default policy for new features)、Code Review 企業預設效力等級、Cloud agent 執行環境與防火牆 範例技術棧 Vue 3.x + TypeScript + Tailwind CSS + PrimeVue + Pinia/Angular + PrimeNG + NgRx(前端);Java 25 + Spring Boot 4.x + Maven(後端);PostgreSQL / Oracle / DB2 / SQL Server;JUnit 5 + ArchUnit + GitHub Actions 適用對象 資深軟體工程師、Full Stack Developer、Software Architect、AI Architect、Enterprise Architect、SA、PM、QA、DevOps / DevSecOps、Security、Tech Lead、Engineering Manager 文件定位 實戰與維運導向的企業標準技術白皮書;不是 Git 入門教材,不是 AI 概論,不是 官方文件翻譯 篇幅 8 部、51 章 + 9 個附錄(A–I) 可信度標示制度(請務必先讀) GitHub Copilot 在 2025–2026 年間的產品架構變動幅度極大:功能改名、機制日落、新機制 GA,全部發生在 12 個月內。網路上(包含中文技術部落格、影片教學、AI 產生的文章)有大量內容已經過時,而且過時的部分往往正是企業最在意的治理與安全設定。 ...

September 10, 2026 · 293 min · 62351 words · Eric Cheng

MarkItDown教學手冊

MarkItDown 教學手冊 Enterprise Document Ingestion & Normalization Handbook 把 Microsoft MarkItDown 當成 AI Agent 的文件正規化基礎元件,導入企業 Web 開發、Legacy System 逆向工程、Software Framework 升版、RAG Knowledge Base 與 DevSecOps 的完整實作手冊 文件資訊 項目 內容 文件版本 1.1 初版日期 2026-09-10 最後改版日期 2026-09-10(v1.1) 最後查證日期 2026-09-10(對照 PyPI JSON API、GitHub microsoft/markitdown main 分支原始碼與各 package README 逐項覆核) 目標 MarkItDown 版本 0.1.7(2026-07-29 發布於 PyPI,為目前最新穩定版;另有預發布 0.1.8b1,2026-09-04,不建議用於 Production) 官方 Repository https://github.com/microsoft/markitdown 官方 PyPI https://pypi.org/project/markitdown/ 授權 核心套件 MIT License;但 markitdown-ocr 會間接引入 AGPL-3.0 授權的 PyMuPDF,詳見第 10.2 節 Python 需求 >= 3.10(官方 metadata 明訂;建議搭配 virtual environment) 核心套件 markitdown 0.1.7(另有獨立套件 markitdown-ocr 0.1.0、markitdown-mcp 0.0.1a4 —— 停滯逾 16 個月,成熟度不同級,詳見第 1.2 節) 適用對象 軟體架構師、SA、SD、PG、PM、AI Engineer、AI Agent / Coding Agent 使用者、平台維運人員 文件定位 實戰與維運導向的企業導入手冊;非 Python 入門教材、非 AI 概論、非官方 README 翻譯 篇幅 8 部、50 章 + 4 個附錄(全書 446 個章節與小節,目錄均可直接跳轉) 可信度標示制度(請務必先讀) MarkItDown 從 2024 年底開源後迭代快速,且 官方文件散落在四個不同 package 的 README(markitdown、markitdown-mcp、markitdown-ocr、markitdown-sample-plugin),彼此之間存在描述不一致之處。網路上大量教學文章仍停留在 0.0.x 舊 API。 ...

September 10, 2026 · 287 min · 60973 words · Eric Cheng

OpenAI Codex生態系教學手冊

OpenAI Codex 生態系教學手冊 Enterprise Codex Ecosystem Handbook 把 OpenAI Codex 當成一套 AI Software Engineering Platform 導入企業:從概念、架構、安裝、設定、開發、逆向工程、框架升版、測試、審查、CI/CD,一路到安全治理與組織導入的完整實作手冊。 文件資訊 項目 內容 文件版本 2.1(對照官方文件站逐章覆核與增補) 初版日期 2026-06-30(v1.0~v1.5) 前版日期 2026-09-09(v2.0,全新改寫) 本版日期 2026-09-09 最後查證日期 2026-09-09(對照 learn.chatgpt.com/docs 官方文件站與 llms.txt 文件索引逐頁覆核) 官方文件站 https://learn.chatgpt.com/docs 官方文件索引 https://learn.chatgpt.com/llms.txt(機器可讀的完整頁面地圖) 官方 Repository https://github.com/openai/codex(Apache-2.0) CLI 版本基準 穩定線 0.153.4(2026-09-04);預覽線 0.154.0-alpha 開發中 當前推薦模型 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.3-codex-spark(research preview) 已退場模型 gpt-5.4 / gpt-5.4-mini(2026-08-31 自 ChatGPT 登入退場;API key 不受影響)、gpt-5.2 / gpt-5.3-codex(已淘汰) 涵蓋介面 ChatGPT 桌面 App、Codex Web、Codex CLI、IDE Extension、Codex Cloud、Codex Remote、Browser Extension、Amazon Bedrock 通道 適用對象 資深工程師、Full Stack Developer、Software Architect、Tech Lead、AI Engineer、DevOps/DevSecOps、QA、Engineering Manager、Enterprise Architect 文件定位 實戰與維運導向的企業標準技術手冊;可直接作為團隊內部開發規範文件基底 篇幅 35 章 + 4 個附錄 這份手冊怎麼讀 這份手冊有 35 章,沒有人會從頭讀到尾。以下是四條建議路徑。 ...

September 9, 2026 · 187 min · 39745 words · Eric Cheng

Codex CLI教學手冊

Codex CLI 教學手冊 Enterprise Codex CLI Architecture & Engineering Handbook 把 Codex CLI 當成 AI Software Engineering Agent 導入 Web 開發、Legacy 逆向工程、Framework 升版、Testing、Code Review、DevSecOps 與 CI/CD 的完整實作手冊 文件資訊 項目 內容 文件版本 1.1 初版日期 2026-09-06 最後改版日期 2026-09-06 最後查證日期 2026-09-06(對照 OpenAI 官方文件站 learn.chatgpt.com/docs、GitHub Repository 與 Releases 全文覆核) 目標 Codex CLI 版本 0.153.4(2026-09-04 發布;Alpha 通道為 0.154.0-alpha.3) 官方 Repository https://github.com/openai/codex 授權 Apache-2.0 官方文件站 https://learn.chatgpt.com/docs(注意:developers.openai.com/codex/* 已 308 轉址至此) 支援作業系統 macOS、Linux、Windows(三者皆有原生 sandbox 實作) 推薦安裝方式 官方 install script(macOS/Linux 用 install.sh、Windows 用 install.ps1);亦支援 npm 與 Homebrew 推薦登入方式 Sign in with ChatGPT(Plus / Pro / Business / Edu / Enterprise 方案) 當前模型線 Astra(gpt-6-astra)、5.6 Sol / Terra / Luna、5.3 Codex Spark;Legacy:5.5。5.4 與 5.4 Mini 已於 2026-08-31 退場 適用對象 資深工程師、Full Stack Developer、Software Architect、AI Engineer、DevOps / DevSecOps、QA、Tech Lead、Engineering Manager、Enterprise Architect 文件定位 實戰與維運導向的企業標準技術白皮書;非 Terminal 入門教材、非 AI 概論 篇幅 50 章、456 小節 + 附錄 v1.1 改版摘要(2026-09-06) 本次改版以「對照官方文件站與 Repository 逐章覆核」為原則,補齊下列 v1.0 未涵蓋或涵蓋不足的官方能力: ...

September 6, 2026 · 229 min · 48666 words · Eric Cheng

Pi Agent Harness教學手冊

文件版本:2.0 研究日期:2026-10-24(v1.1 為 2026-09-06) Pi 版本:v1.4.0(2026-10-21 發布,基準日的最新正式版;npm @earendil-works/pi-coding-agent) Node.js 需求:≥ 22.19.0(legacy-node20 dist-tag 停在 v0.74.2,不建議使用) 授權:MIT 官方網站:pi.dev 官方 Repo:earendil-works/pi 篇幅:11 部、57 章,另有附錄 A(版本修正紀錄)與附錄 B(驗證紀錄);官方 packages/coding-agent/docs/ 的 42 頁文件全數對應(第 56.3 節) 驗證方式:文中的設定檔、extension、腳本、skill、prompt template、CI workflow、Java/Vue 程式都是實際執行過的檔案,以原樣嵌入;執行結果也是真實輸出(附錄 B) v2.0 修訂摘要(2026-10-24) 項目 內容 版本對齊 由 v0.85.1 對齊到 v1.4.0:中間的 16 個版本含 13 項 Breaking Changes(遷移清單見第 51.4 節) 新增章節 第 10 章 pi-mcp 與 pi-codemode、第 11 章 pi-durable/pi-env/chord/pi-evals、第 16 章 Virtual Models、第 25 章 MCP Servers、第 26 章 Codemode、第 29 章 整合介面(Print/JSON/RPC/SDK) 重大修正 43 項 v1.1 內容需要修正(17 項過時、22 項範例錯誤、4 項事實錯誤),其中最嚴重的是:skills/模板的註解放在 frontmatter 前導致不載入、extension 讀 process.env.PI_SESSION_ID 得到空值、String(pi.exec()) 讓分支閘門永遠不生效、CI 對 PR checkout 加 --approve 造成任意程式碼執行、外部 repo 指令缺 -nc(附錄 A) 可驗證性 每章以「本章目標」開始、以「本章審查與驗證清單」結束;每條指引都附範例與驗證方式;新增合規、遷移掃描、閘門回歸、診斷等可直接使用的腳本 目錄 四層目錄(部 → 章 → 節 → 小節),錨點依 Hugo 實際產生的 id 建立,並以 Hugo 輸出頁面逐一比對 格式 程式區塊依內容使用三或四個反引號;JSON 範例不含註解並帶 $schema;表格分隔列統一 關於本手冊 這份手冊要回答的問題 本手冊不是 Pi 的 README 摘要。它要回答一個工程管理層級的問題: ...

September 6, 2026 · 304 min · 64624 words · Eric Cheng

Omarchy教學手冊

Omarchy 教學手冊 Omarchy + AI Agent Software Engineering Platform 從零建置一台可用於 Web Application 開發、Legacy 系統逆向工程與 Framework 升版的 AI Agent 軟體工程工作站 文件資訊 項目 內容 文件版本 2.0 初版日期 2026-09-05 最後查證日期 2026-09-05(對照官方 Manual、GitHub Releases、Omarchy News 全文複查) 目標 Omarchy 版本 4.0.2(Quattro,2026-08-31 發布) 目標架構 x86_64(另有 Apple Silicon 相關支援,見第 5 章) 驗證 Repository https://github.com/omacom/omarchy 驗證分支 quattro(目前的主要開發分支,非 master/main) 授權 MIT 適用對象 資深工程師、軟體架構師、Tech Lead、Java / Spring Boot 開發者、前端開發者、DevOps / DevSecOps、AI Agent 使用者、IT 管理層 文件定位 實戰與維運導向;非 Arch Linux 入門教材 主要研究來源 Omarchy 官方網站、Omarchy 官方 Manual、Omarchy GitHub Repository、Phoronix、Hyprland / Quickshell / mise 官方文件 主要參考來源 來源 URL 用途 Omarchy 官方網站 https://omarchy.org/ 版本、ISO、定位 Omarchy 官方 Manual https://omarchy.org/manual/ 本手冊的主要事實依據(共 51 章) Omarchy GitHub https://github.com/omacom/omarchy 原始碼、目錄結構、AGENTS.md Omarchy Plugins https://omarchyplugins.com/ 第三方 plugin 市集 Omarchy Security https://omarchy.org/security/ 安全基準 Omarchy News https://omarchy.org/news/ 版本與生態動態 Hyprland https://hypr.land/ Compositor 背景知識 Quickshell https://quickshell.org/ Shell 框架背景知識 mise https://mise.jdx.dev/ Runtime 版本管理 修訂紀錄 版本 日期 主要變更 2.0 2026-09-05 對照官方 Manual(51 章)、GitHub Releases、Omarchy News、Security 頁全文複查。新增:4.8 版本歷程與安全修補、5.5.4–5.5.5 LM Studio 與本地模型現實評估、7.9–7.11 內建 GUI/Reminders/Web Apps、11.9.1 omarchy commands --json、18.10 Agent 崩潰自動診斷、22.8 官方安全治理與漏洞回報、22.9 硬體認證(指紋/FIDO2)、34.6 Windows VM。改寫:1.6 生態與治理時間軸、附錄 C Q14、附錄 E 參考來源。結構:全文目錄改為「章+節」兩層並補齊全部錨點連結(460 個項目、468 條內部連結,全數驗證可解析)。 1.0 2026-09-05 初版。以 Omarchy 4.0.2(Quattro)為基準,44 章 + 5 附錄。 ⚠️ 閱讀本手冊前必讀的三件事 1. 版本差異極大,請勿混用舊教學 Omarchy 4.0(代號 Quattro)於 2026-08-14 發布,把整個桌面 Shell 層重寫了。網路上絕大多數 Omarchy 教學(包含中文內容)寫的是 3.x 架構,其中的設定檔路徑、元件名稱、指令都已經不適用。 ...

September 6, 2026 · 252 min · 53634 words · Eric Cheng

Scientific Agent Skills 教學手冊

Scientific Agent Skills 教學手冊 企業級 AI 軟體工程實戰手冊 — 從安裝、整合、治理到 Web Application 開發、Legacy 逆向工程與 Framework 升級 文件資訊 項目 內容 文件版本 2.0(2026-09-03 全面複驗與擴充;v1.0 同日發布) 研究日期 2026-09-03 適用對象 資深工程師、軟體架構師、Tech Lead、AI Agent 開發者、DevOps / DevSecOps、PM、IT 管理層 主要研究對象 K-Dense-AI/scientific-agent-skills Repository URL https://github.com/K-Dense-AI/scientific-agent-skills Repository 分支 main 驗證 Commit SHA 1e5eeffbdad3749125afe7ab48a39694e27f181c 最新 Release v2.66.0(發布於 2026-09-02T16:25:37Z) 套件版本 pyproject.toml / plugin.json 皆為 2.66.0 授權 Repository 整體為 MIT;個別 Skill 授權不同,需逐一檢視(見第 26 章) Skill 實際數量 163 個(以 GitHub API 對 skills/ 目錄實際計數,2026-09-03) Scientific Database 數量 78 個(database-lookup skill 收錄;官方行銷文案稱「100+」,差異說明見第 7 章) 學術出處 arXiv:2609.00065(2026-08-30 投稿)— 見第 2.8 節 Agent Skills Standard 狀態 開放標準,官方站 https://agentskills.io ;Anthropic 於 2025-12-18 開源,現由 Agentic AI Foundation(Linux Foundation 旗下) 治理 前身專案 K-Dense-AI/claude-scientific-skills(已更名) 本次(v2.0)複驗與擴充摘要 本版對 v1.0 逐章重新查證,以下為實際修正與新增的項目,供讀者判斷是否需要重讀: ...

September 3, 2026 · 170 min · 36003 words · Eric Cheng

Archify教學手冊

Archify 教學手冊 一句話定位:Archify 是一個給 AI Coding Agent 使用的 Agent Skill,讓 Agent 把「Repository 證據 / 架構描述」轉譯成一份經過 Schema 驗證、可互動探索、可分享的自包含 HTML 系統地圖——重點不是畫一張漂亮的圖,而是產出一份可驗證、可追溯來源的架構視圖。 官方 Repository:https://github.com/tt-a1i/archify(MIT License) 查證版本:2.15.0(最新正式版)/2.16.0-dev.0(開發中版本,CHANGELOG.md 的 [Unreleased] 區塊;與 archify/package.json 的 "version": "2.16.0-dev.0"、archify/SKILL.md frontmatter 的 metadata.version: "2.16" 三方一致) 查證日期:2026-08-28(同日完成第二輪深度複查,新增 ROADMAP.md、archify/schemas/README.md 兩份官方一手來源,並修正前一版三處判斷落差,詳見「改版與修正紀錄」) 適用對象:Software Architect、Solution Architect、Technical Lead、Backend/Frontend/Full Stack Developer、DevOps/DevSecOps Engineer、SRE、QA、System/Business Analyst、PM、AI Coding Agent Developer、AI Engineer、Legacy System 維運與 Framework Upgrade 團隊 目的:讓企業開發團隊知道「何時該用、怎麼用、怎麼驗證、怎麼治理」Archify,並將其嵌入 AI Agent 驅動的 Web Application 開發、Legacy System Reverse Engineering、Framework Upgrade、Architecture Review、Code Review、SSDLC 工作流程 技術堆疊:Node.js(engines.node >= 18)+ 零相依 CLI(archify/bin/archify.mjs)+ 5 份 JSON Schema(開發期由 ajv draft 2020-12 預先編譯為 standalone validator,執行期不需 npm install 或網路)+ 5 個 typed Renderer + 自包含 HTML/SVG Viewer(4 種 Visual Preset、深/淺色主題);供 Cursor、Claude Code、Codex CLI、opencode、Raven、Claude.ai、DeepSeek Harness 等 AI Agent 環境使用 重要聲明(請務必先讀) 範圍與翻譯聲明:本手冊以繁體中文撰寫,技術名詞(Agent Skill、Typed JSON IR、Reverse Engineering、Architecture Delta、Repository、Schema、Validation、Renderer、Viewer 等)保留英文原文,以避免翻譯造成語意漂移。所有官方文件原文引用皆標明出處。 核心定位聲明:Archify 不是「一個 Mermaid 轉 HTML 的小工具」。它的核心價值在於讓 AI Agent 產生的架構圖,經過型別化(typed)JSON IR 與 Schema 決定性驗證(deterministic validation) 這兩層把關,避免 AI 把「想像的拓撲」當成事實輸出成一張看起來很專業、實際上與程式碼不符的圖。本手冊會反覆強調這個定位。 查證方法論:本手冊所有與 Archify 官方功能相關的敘述,皆透過直接抓取官方 Repository 原始檔案(raw.githubusercontent.com,包含 README.md、CHANGELOG.md、package.json、archify/SKILL.md、archify/bin/archify.mjs、archify/delta/architecture-delta.mjs 等)並交叉比對而來,而非僅憑單一頁面摘要。凡是「僅有單一來源」或「多來源有落差」的內容,一律用 §符號約定 的 Provenance 標籤明確標示,不會偽裝成確定事實。 版本落差澄清:查證過程中發現兩處尚未解決的來源落差——(a) v2.15.0 的正式發布日期,官方 CHANGELOG.md 原文寫 2026-08-17,另一個第三方摘要頁面寫 2025-08-17,兩者差一年,本手冊採用 CHANGELOG 原始檔案文字但同時標注此落差;(b) GitHub Star 數,兩個獨立來源收斂在「約 25k」,但另一第三方聚合站回報「13k」,本手冊僅標示「約 25k(未完全確認)」,不作為技術判斷依據。第二輪複查已解決前一版的三處落差(Cursor 支援層級、Typed JSON IR 的官方地位、JPEG/WebP 匯出格式),詳見「改版與修正紀錄」。 虛構案例免責聲明:第 Part VII、Part XIII 中的「企業案例」「銀行系統案例」為教學示範用途之情境案例,其中的系統名稱、公司背景、數據均為虛構,僅用來示範 Archify 的使用方法,並非真實客戶專案。 License 免責聲明:Archify 採用 MIT License,本手冊之引用僅供教學說明,實際採用前請自行確認官方 Repository 當下的 LICENSE 檔案與版本條款。 完整參考來源請見「References」章節,內含所有直接查證用的官方 URL。 時效性聲明:Archify 目前處於高頻迭代狀態(CHANGELOG.md 顯示 2.11 至 2.16-dev 之間平均約 1~2 週一個 minor 版本)。本手冊標示 🟢 的內容為 2026-08-28 當下的官方事實,企業若要將本手冊轉為內部正式規範,建議設定每季複查一次的機制(見第 29 章維護章節)。 改版與修正紀錄 本手冊採「可稽核更新」原則:每一次改版都必須列出修正了什麼、為什麼修正、依據哪一份一手來源,而不是默默覆寫舊內容。 ...

August 28, 2026 · 65 min · 13802 words · Eric Cheng