WeKnora 企業級 AI Agent 開發教學手冊

WeKnora 企業級 AI Agent 開發教學手冊 Enterprise AI Agent Development & Knowledge Engineering Handbook for WeKnora 把散落在企業各處的文件、原始碼、資料庫結構與維運知識,轉換成 AI Agent 可檢索、可引用、可治理的企業知識中樞(Enterprise Knowledge Hub)——一份可直接作為團隊開發規範的完整導入手冊 文件資訊 項目 內容 文件名稱 WeKnora 企業級 AI Agent 開發教學手冊 文件版本 v1.1.0 文件日期 2026-09-22 技術來源 Tencent/WeKnora(官方 Repository)、weknora.weixin.qq.com(官方文件站) 研究版本 v0.8.0(VERSION 檔內容即 0.8.0;GitHub Release 發布於 2026-09-03;repo 最後推送 2026-09-21T16:29:17Z)。2026-09-22 複查:仍無 v0.8.1 或更新的正式 Release 最後查證日期 2026-09-22。查證範圍:官方 Repository 檔案樹、README.md、CHANGELOG.md、.env.example、docker-compose.yml、helm/README.md、mcp-server/README.md、LICENSE、VERSION、docs/ 全目錄(37 份技術文件)、docs/api/ 全目錄(24 份 API 文件)、docs/ROADMAP.md、dataset/README、GitHub Releases API、GitHub Repository API、GitHub Contents API。完整清單見 附錄 G 專案規模 ⭐ 28,580|Open Issues 607|Fork 3,843|Watchers 131|建立於 2025-07-22|主要語言 Go(另含 TypeScript/Vue 前端、Python DocReader)|Default branch main|Repo topics 含 rag、agent、wiki、multi-tenant、evaluation、dsh-plugin 授權 MIT License(Copyright © 2025 Tencent),但第三方元件另有 Apache-2.0 / BSD / Python-2.0 / MIT-CMU / CC-BY-4.0 / ISC 等多重授權,見 THIRD_PARTY_NOTICES.md 與 licenses/ 目錄。⚠️ GitHub API 因授權檔開頭含 Tencent 前言而回報 NOASSERTION/Other,企業法遵審查時務必以 LICENSE 全文與 THIRD_PARTY_NOTICES.md 為準,詳見 2.8 文件定位 企業正式技術標準 / Training Handbook / Developer Guide。實戰與維運導向;不是官方 README 翻譯,不是行銷文案轉述 適用對象 PM、SA、Architect、Developer、DBA、DevOps / SRE、DevSecOps、QA、AI Engineer、資安與 AI Governance 小組 適用環境 一般企業、大型企業、銀行/金融機構等高敏感資料環境。開發端以 Windows 11 + PowerShell 為主,同時提供 Linux / macOS 指令 安全基準 本手冊的安全章節(第 25、26 章)以金融業/高敏感資料環境為撰寫基準。一般企業可按 25.13 的分級表向下調整,但不建議跳過任何「紅線」項目 篇幅 卷首 + 9 個 Part,共 42 章 + 7 個附錄(A–G)、407 個小節。目錄展開至兩層,各章另有「本章目錄」 姊妹文件 RAGFlow教學手冊(同類 RAG 平台,橫向比較)、Anthropic Model Context Protocol (MCP) 教學手冊、Cognee 教學手冊(知識圖譜)、Claude Code企業級軟體開發教學手冊、Codex CLI 教學手冊、GitHub Copilot企業級軟體開發教學手冊、使用 GitHub Copilot 進行逆向工程並產出需求規格書 版本與文件基準 ⚠️ 這是全手冊最重要的一節,請勿跳過。 WeKnora 是快速演進中的開源專案——從 2025-07-22 建立到 2026-09-22,平均每個月都有功能發布,且 0.7.0 與 0.8.0 都帶有破壞性變更。任何「照著網路上舊文章操作」的行為都極可能失敗。 ...

September 22, 2026 · 258 min · 54806 words · Eric Cheng

Claude Code Team 企業導入與 AI 推動計畫-企業級教學手冊

Claude Code Team 企業導入與 AI 推動計畫-企業級教學手冊 Enterprise Adoption and AI Enablement Program for Claude Code Team 把 Claude Code Team 從「買了授權的工具」變成「有制度、有治理、有度量、可持續改善的企業 AI 軟體工程能力」的完整導入手冊 文件資訊 項目 內容 文件版本 v6.1.0 初版日期 2026-09-17(v1.0.0) 本版更新日期 2026-11-19(v6.1.0、v6.0.0、v5.0.0、v4.0.0、v3.0.0、v2.1.0 與 v2.0.0 變更摘要見 C.5.2 變更紀錄) 最後查證日期 2026-11-19(v6.0)。重新下載 llms.txt 所列 205 個英文頁面(頁數與 v5.0 相同),比對 changelog 至 v2.1.328;以本機 Claude Code v2.1.328 實跑維運 Agent 唯讀限制、Remediation 白名單、TaskCompleted 品質 Hook 與緊急停止 Hook,並以正反例驗證 v6.0 新增的 5 支檢查腳本與 3 套 CI 範本(附錄 C.5.6、C.2.10);support.claude.com 方案文件沿用 v5.0(2026-11-16)的下載結果。v5.0 的查證:以官方文件索引 https://code.claude.com/docs/llms.txt 所列 205 個英文頁面為母體(v5.0 新增 code-mode 與 claude-models-on-google-cloud-anthropic-managed 2 頁;What’s New 週報子頁已併入單一頁面,全部頁面下載後與 v4.0 副本逐頁比對,見 附錄 C.2.9);比對 Claude Code changelog 至 v2.1.325;重新下載 12 份 support.claude.com 方案文件的 en 與 zh-TW 版本(含本次指定的 6 份);外部標準複查 NIST SSDF、OMB M-26-05、EU AI Act 與金管會代理 AI 諮詢文件(53.6.5)。v5.0 以本機 Claude Code v2.1.325 實跑模型白名單、denyInsteadOfPrompting、無效設定檔與 Bash 萬用字元規則(附錄 C.5.5);v4.0 與 v3.0 的實測見 附錄 C.5.4、C.5.3。查證清單與未覆核項目見 附錄 C.2 官方文件站 https://code.claude.com/docs/en/overview(注意:舊網址 docs.claude.com/en/docs/claude-code/* 已 301 轉址至此,本手冊 v1.0.0 之前的外部引用均需更新) 文件定位 企業標準技術白皮書。組織導入、治理制度、推動計畫與度量體系導向;不是 Claude Code 指令手冊,不是 官方文件翻譯,不是 AI 概論 目標產品 Claude Code,於 Claude for Teams / Enterprise 方案(並涵蓋 Anthropic Console、Amazon Bedrock、Claude Platform on AWS、Google Cloud’s Agent Platform、Microsoft Foundry 等 Provider 的導入取捨) 涵蓋介面(Surface) Terminal CLI、VS Code、JetBrains、Desktop App、Claude Code on the web(Cloud Sessions)、行動 App、Slack、Chrome、Remote Control、GitHub Actions、GitLab CI/CD 涵蓋治理機制 Managed Settings(Server-managed/plist/registry/managed-settings.json)、Permission Rules、Permission Modes(Manual/Auto/Accept Edits/Plan)、Sandboxing、Managed MCP、Plugin Marketplace 限制、Hook 限制與 ConfigChange、登入與版本強制、Corporate Launcher、OpenTelemetry、Analytics 與 Analytics API、Spend Limits、Zero Data Retention、Provider 與模型版本白名單(allowedProviders、availableModelsMatch)、Claude Mods 管控、Hook fail-closed(onFailure)、HIPAA 配置、managed 來源合併語意(managedSourcesBehavior)、啟動 fail-closed(forceRemoteSettingsRefresh)、寫入範圍限制(blockWritesOutsideWorkingDirectories)、Code Review 預算、沙箱自動允許(autoAllowBashIfSandboxed)、無人值守拒絕(denyInsteadOfPrompting)、模型白名單強制(enforceAvailableModels)、Code Mode 管控、群組化 server-managed settings 涵蓋推動制度 Workshop 體系、Pilot Program、四層 KPI、月報與 Dashboard、AI Maturity Model、AI Governance、Risk Register、12 個月 Roadmap,並對照 Anthropic 官方 Champion Kit 與 Communications Kit;v6.0 新增:AI 輔助維運與 SRE、CI 品質閘道與 Gate 自動化、任務自主等級 A0–A4、AI-ready Engineering Platform、DORA 與 Developer Experience、季度 AI Engineering Review、受控 L5 的 Entry/Exit Criteria(第 54~59 章) 適用對象 IT 部門與軟體開發部門主管、Enterprise Architect、Software Architect、SA、SD、PG、QA、PM、DevOps / SRE、DevSecOps、資安、AI Governance 小組、管理階層 對照的外部標準 NIST SSDF(SP 800-218/800-218A)、NIST AI RMF 與 GenAI Profile(AI 600-1)、ISO/IEC 42001、OWASP Top 10 for LLM Applications 2025、OWASP Top 10 for Agentic Applications 2026、DORA AI Capabilities Model、台灣金管會《金融業運用人工智慧(AI)指引》、《人工智慧基本法》與數位發展部《人工智慧風險分類框架》(第 53 章) 篇幅 9 部、59 章 + 3 個附錄(A–C);第 1~51、53~59 章結尾都有「本章審查與驗證清單」(v3.0 起;第 54~59 章為 v6.0 新增) 姊妹文件 Claude Code企業級軟體開發教學手冊(產品機制與實作細節)、Claude Code生態圈教學手冊(生態系總覽)。本手冊自成完整,重複的機制會重新以「導入與治理」視角寫齊,不要求讀者先讀其他文件 可信度標示制度(請務必先讀) Claude Code 的產品架構在 2025–2026 年間變動幅度極大:預設權限模式反轉、沙箱與 Managed Settings 由選配變成企業標配、官方文件站整站遷移。網路上(包含中文技術部落格、影片、AI 產生的文章)有大量內容已經過時,而過時的部分往往正是企業最在意的權限、沙箱、資料保護與計費設定。 ...

September 21, 2026 · 520 min · 110674 words · Eric Cheng

Context Mode 企業級 AI Agent 軟體開發教學手冊

Context Mode 企業級 AI Agent 軟體開發教學手冊 Enterprise Context Engineering Handbook for AI Coding Agents 把 AI Coding Agent 從「把資料搬進 Context Window 的搬運工」改造成「設計分析程式的工程師」——一份可直接作為團隊開發規範的完整導入手冊 文件資訊 項目 內容 文件名稱 Context Mode 企業級 AI Agent 軟體開發教學手冊 文件版本 v1.1.0(前版 v1.0.0;本版更新摘要見 文件維護) 文件日期 2026-09-18 技術來源 mksglu/context-mode 研究版本 v1.0.169(GitHub Release 發布於 2026-06-29;repo 最後推送 2026-09-17)。⚠️ 此版本有 compaction 迴圈重大缺陷,導入前必讀 第 25 章專節 最後查證日期 2026-09-18。查證範圍:官方 Repository 檔案樹、README 全文、BENCHMARK.md、package.json、skills/context-mode/SKILL.md、GitHub Releases API、GitHub Issues API、官方網站 context-mode.com。查證清單見 附錄 D 專案規模 ⭐ 23,466|Fork 1,689|Open Issues 257|建立於 2026-02-23|主要語言 TypeScript 授權 Elastic License 2.0(ELv2,source-available)。可使用、fork、修改、散布;不可作為 hosted / managed service 對外提供,不可移除授權標示。此條款直接影響企業「共用中央服務」的設計,詳見 22.4 Runtime 需求 Node.js ≥ 22.5(或 Bun)。Linux + Node < 22.5 為官方不支援組合 文件定位 企業正式技術標準 / Training Handbook / Developer Guide。實戰與維運導向;不是官方 README 翻譯,不是行銷文案轉述 適用對象 PM、SA、Architect、Developer、QA、DevOps / SRE、DevSecOps、AI Engineer、資安與 AI Governance 小組 適用環境 一般企業、大型企業、銀行 / 金融機構。開發端以 Windows 11 + PowerShell 為主,同時提供 macOS / Linux 指令 商業模式 雙層產品:OSS Plugin(免費,ELv2,全本機)+ Insight Platform(每席 USD 20/月,須 opt-in)。企業採購與治理影響見 23.3 篇幅 卷首 + 9 個 Part + 6 個附錄(A–F),共 31 章 姊妹文件 RTK (Rust Token Killer) 教學手冊、headroom 教學手冊、Anthropic Model Context Protocol (MCP) 教學手冊、Claude Code企業級軟體開發教學手冊。本手冊自成完整,不要求先讀其他文件;重疊的概念會以 Context Engineering 視角重新寫齊 可信度標示制度(請務必先讀) Context Mode 是一個高速演進中的 source-available 專案:2026-02 建立,到 2026-09 已發布 169 個版本,平均約 1.2 天一個版本。網路上(包含中文技術文章、影片、AI 產生的內容)有大量描述已經過時,而過時的部分往往正是企業最在意的:平台支援範圍、Hook 能力、安全邊界、節省比例。 ...

September 18, 2026 · 142 min · 30130 words · Eric Cheng

Refactoring to Patterns 企業級軟體開發教學手冊

Refactoring to Patterns 教學手冊 文件版本:1.1 資訊確認日期:2026-09-16 理論基礎:Joshua Kerievsky,《Refactoring to Patterns》(Addison-Wesley Professional,2004-08-05 出版,Addison-Wesley Signature Series (Fowler),ISBN 978-0-321-21335-8);Industrial Logic 官方 catalog 的 27 個 pattern-directed refactorings 程式碼版本基準:Before 範例刻意使用 Java 8 + Spring Boot 2.x + javax(貼近企業 Legacy 現況);After 範例使用 Java 25(LTS)+ Spring Boot 4.1.x + Spring Framework 7.x + Jakarta EE 11 測試框架:JUnit 6 為主(官方當前世代,需 Java 17+/Kotlin 2.1+),並標註 JUnit 5(Jupiter)對照寫法;ArchUnit 1.5.0(archunit-junit6) 前端:Vue 3(Composition API)與 Angular v22(Standalone + Signals + Zoneless)等量並列,TypeScript 7.0 適用對象:PM、SA、Software Architect、Senior Developer、Developer、QA、DevOps、維運人員、AI Coding Agent 使用者、Legacy 系統維護團隊、Framework Upgrade 團隊 篇幅:46 章,分為 11 部,另含 27 個 refactoring 完整條目、21 個 Code Smell、5 個實作 Lab、10 個企業案例、20 組 AI Agent Prompt 與 9 份附錄 版本時效:所有技術版本宣稱的來源 URL 與查證日期,集中列於 附錄 I;該附錄同時提供每季複查的 SOP 文件狀態:catalog 條目清單以 Industrial Logic 官方頁面查證為準。本手冊自行整理的分組、流程與治理設計均明確標示為「本手冊的工程建議」,不冒充原作觀點;查不到的資訊一律標示「原始資料未說明」,不猜測、不補完。 ...

September 16, 2026 · 244 min · 51769 words · Eric Cheng

ArchUnit 企業級軟體架構測試與 AI Agent 開發教學手冊

ArchUnit 企業級軟體架構測試與 AI Agent 開發教學手冊 文件版本:1.1 資訊確認日期:2026-09-16 ArchUnit 版本:1.5.0(2026-08-04 發布,本手冊所有 API 以此版為準) Java:Java 25(LTS)為主要範例環境,並說明 Java 17 / 21 / 27 的差異 Spring Boot:4.x(2025-11-20 GA)/Spring Framework:7.x/Jakarta EE:11 JUnit:JUnit 5(Jupiter 5.x)與 JUnit 6.0(2025-09-30 GA,Java 17 baseline)雙軌說明 建置工具:Maven、Gradle CI/CD:GitHub Actions、GitLab CI 適用對象:PM、SA、Software Architect、Java Developer、Frontend Developer、QA、DevOps、Security、AI Engineer、AI Coding Agent 使用者、Legacy 系統維護人員、Framework Upgrade 團隊 篇幅:68 章,分為 11 部,另含 10 個實作 Lab、12 組 AI Agent Prompt 與 7 份附錄 文件狀態:所有 ArchUnit API、設定鍵與版本資訊均對照官方 User Guide、官方網站、GitHub Release Notes 與 ArchUnit 1.5.0 原始碼查證。查不到的資訊一律標示「官方資料未說明」,不猜測、不補完。 ...

September 16, 2026 · 179 min · 38041 words · Eric Cheng

Praxist 教學手冊

Praxist 教學手冊 文件版本:1.1 研究日期:2026-09-13(初版)/2026-09-14(本次覆核與增補) Praxist 版本:v0.5.0(Beta),發布於 2026-08-27(已對照 PyPI 與 GitHub Tags 覆核;官方 Releases 頁面目前尚無任何 Release 條目,v0.5.0 為 Repo 上唯一的 tag,commit 92b7853。2026-09-14 再次覆核 PyPI,最新版仍為 0.5.0,未有新版發布) Python 需求:CPython >= 3.11(官方持續測試範圍為 3.11 / 3.12) OS 支援:Linux + CPython 3.11/3.12(release CI 持續測試);macOS + CPython 3.11+(相容性目標,非持續測試);Windows 原生環境經官方明文排除於 research-runtime contract 之外,須改用 WSL2 或 Linux(見第 18.1 節) 授權:Fair Source License 1.0(Source Available,非 OSI 認可之 Open Source;年營收低於 US$1M 之組織可免費商用,學術與非營利研究機構不受營收門檻限制) 官方 Repo:sapientinc/PRAXIST 官方文件:praxist.sapient.inc/en/docs 學術出處:Praxist: From Experimental Artifacts to Solution Lineages,arXiv:2608.25955(v1,2026-08-26 投稿,共 16 位作者) 文件狀態:Based on latest verified sources。所有官方能力均對照官方 Repo main 分支實際查證,來源包含 README.md、docs/ 完整檔案樹、getting-started/*、concepts/*、guides/*、reference/*、operations/*、about/*、legal/*、PyPI 套件 JSON API、GitHub Tags 與 commit 歷史,以及 arXiv 論文摘要 篇幅:60 章,分為 10 部,另含 17 份附錄 ...

September 13, 2026 · 403 min · 85681 words · Eric Cheng

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