教程文档AI Agent人工智能大模型【免费下载链接】awesome-agentic-ai-zhA trilingual (繁中 / English / 简中) learning roadmap for agentic AI: from LLM basics to multi-agent systems, with 240 curated resources and hands-on examples. 中文 AI agent 學習地圖。项目地址https://gitcode.com/gh_mirrors/aw/awesome-agentic-ai-zh点击查看免费下载本文依据仓库内计划文档 docs/plans/2026-08-27-track-a-core-terms-ratings.md 撰写并结合 Track A 三站正文A1-cli-intro.md、A2-cli-workflow.md、A3-cli-production.md与读者体验检查器源码check-reader-ux.py、reader-ux-pages.yml、check-anchors.py交叉印证。导读这份计划文档记录了 awesome-agentic-ai-zh 在 2026-08-27 对Track ACLI Power UserA1–A3 三站所做的一次读者体验reader-UX修复工程在保留「安全主线 渐进式揭露」成果的同时恢复被重写误删的路标图标、五星编辑评分、核心词粗体解释与首个可复制动作。文章以「核心词契约」「五星编辑评分」「渐进式揭露」「自动化 Gate」四条主线展开并深入scripts/下的检查器实现说明这些契约如何被机器逐行验证。读完本文你将理解如何为一份多语言学习路径定义「可见性契约」如何用编辑评分替代易变的 GitHub stars以及如何用check-reader-ux.pyreader-ux-pages.yml让三语页面在结构、顺序、资源与评分上保持严格镜像。背景一次重写引发的四个回归计划文档开头明确列出 2026-08-27 的 A1–A3 重写虽然把「安全主线与渐进式揭露」做好却也造成了四个回归、、、、✅路标消失——读者无法再通过图标快速定位「学习目标 / 必修阅读 / 动手练习 / 精选 Projects / 完成检查」。原有的五星编辑评分被连同事易变的 GitHub stars 一起移除——把「编辑建议」与「人气数字」混为一谈。A1、A2 的核心词只出现在表格标头——没有依全站契约粗体并完整解释读者无法在动手前建立词汇心智模型。A3 第一题没有可直接复制的建立 demo 资料夹指令——读者被迫去查工具文档才能开始第一个动作。这一层的修复范围被严格限定在 Track A 及直接相关的 CLI 指南、glossary、设计规则和 reader-UX gateStage 03 另开下一个 stacked PR避免越界改动。初学者主线不展开任何选单也必须「看得见」计划文档给出的核心设计原则是每页不展开任何details选单时读者都要看见「这一页解决什么、学习目标、核心词、第一个可复制动作、练习成果、精选资源入口与完成检查」。三站各自的主线是A1分清工具身分选一个 coding agent在 demo repo 完成可复原的小改动。A2分清长期规则、按需 Skill 与单次 prompt把重复 review 做成可重跑流程。A3分清 MCP、CI 与 observability把只读检查接到 demo PR。而时间、费用、完整步骤、工具差异、疑难排解与长资源表则默认收合放进details。同时既有 CLI-1 至 CLI-12 与 Playbook 4 的标题、anchor 和「一句话成果」不得移入details——因为它们是学习路径的导航骨架。这一设计在检查器里被量化为硬指标。阅读 check-reader-ux.py 的analyze_markdown()可以看到它逐行解析 Markdown把details内的正文视为「不可见」只统计可见源码的字符数visible_chars、details数量details_count、默认展开的details数量open_details_count并收集可见区内的标题序列outside_headings。再对照 reader-ux-pages.yml 中三页的配置页面可见字符上限zh-TW默认展开 details 上限必见章节顺序track-a166360learning-goals → core-terms → required-reading → hands-on → projects → completiontrack-a267680core-terms → learning-goals → required-reading → hands-on → projects → completiontrack-a380160learning-goals → core-terms → required-reading → hands-on → projects → completion三个页面全部要求max_open_details: 0——即「不展开任何选单」就是默认阅读态可见段落顺序由visible_section_order锁定三语不得把同一批可见段落排成不同顺序check-reader-ux.py会直接报错。核心词契约三语同 ID、同顺序、同解释计划文档定义了全站的核心词契约三语使用相同 ID、顺序、用途与限制。每个词第一次出现在可见正文时必须粗体并在第一个练习前回答四个问题——「它是什么、像什么、本章怎么用、不是/不适合放什么」。页面核心词A1LLM、Provider API、Router、Coding agent、Local runtimeA2Project instructions、Skill、One-off promptA3MCP、CI、Observability落地到三站正文可以看到完整的「四问」表格例如 A1 的「 先認識五個核心詞」LLM大型語言模型产生文字或代码的模型像工作台里负责想答案的大脑A1 里 Claude、GPT、Gemini 都是模型家族它不是不会自己管理 repo、档案权限或账单的东西。Provider API模型服務入口让工具向一家模型服务送出请求的门Anthropic/OpenAI/Gemini API 处理认证与计费不是会改档的 coding agent。Router路由器把同一个请求转给不同 provider 的转运站OpenRouter 可集中 API、routing 与 usage不是 LLM也不管理你的档案权限。Coding agent程式工作台能在终端机读档、改档与执行命令的工作台Claude Code、Codex、OpenCode、Pi 都属于这一类里面用的模型、provider 与 sandbox 要另外确认。Local runtime本機模型引擎在自己的电脑跑模型的引擎Ollama 可让支援它的 agent 呼叫本机模型不是 coding agent不会自己读 repo。A2 的三个核心词则强调「各自该放什么 / 不适合放什么」Project instructions專案規則放专案用途、禁止事项、测试指令与交付格式不放只用一次的任务Skill操作卡放 review、release、整理文件等重复流程但各 CLI 的路径、权限与 frontmatter 不同One-off prompt單次提示只放本次任务、范围、输入与成功条件不用它重复贴上每次都相同的专案规则。A3 的三个词MCP、CI、Observability在正文中还有一句关键辨析三者会一起出现但不是同一件事——MCP 负责「接工具」CI 负责「何时自动跑」observability 负责「跑完留下什么证据」。检查器如何验证「首次粗体 定义顺序 最少解释」这份契约不是靠人工 review 维持的。check-reader-ux.py中的_core_term_errors()逐条验证对应配置在 reader-ux-pages.yml 的core_terms块例如 track-a1 配置了section_id: core-terms、first_exercise_section_id: cli-1、min_definition_chars: 20以及五个词的term/label位置契约核心词区块core-terms必须出现在第一个练习cli-1/cli-5/cli-9之前否则报错core terms section must appear before the first exercise。首次使用粗体核心词第一次出现在可见正文时必须以**term**包裹支持 Markdown 粗体与strong两种写法_bold_label_spans()同时匹配两种。定义标签顺序每个核心词的粗体定义标签如**LLM大型語言模型**在核心词区块内的出现顺序必须与配置顺序一致starts ! sorted(starts)即报错。最少解释字符粗体标签之后到下一个标签之间的解释文字去空白后不得少于min_definition_chars本项目设为 20防止「有标题没解释」的摆设性定义。此外核心词术语本身必须存在于可见正文term is missing from visible prose避免三语页面上术语拼写漂移。资源表与五星编辑评分编辑建议 ≠ GitHub stars计划文档中有一句非常重要的定位评分是本学习地图的编辑建议不是 GitHub stars 或人气排名。因此移除会变动的★ 140k之类数字时不得顺手删掉⭐⭐⭐⭐⭐编辑评分。评分语义是⭐⭐⭐⭐⭐选择该工具路径时必读/必做不是要求安装所有五星工具。⭐⭐⭐⭐强烈建议优先看。⭐⭐⭐完成主线后再比较。⭐⭐历史或少数情境参考。三页资源表被固定为特定笔数与分组rowspan分组页面笔数分组rowspan评分处理A111452还原 8 个既有 CLI 与 Ollama 的原评分Pi、OpenRouter 依本章用途补分A21644422原有资源沿用旧分新官方文件依所选手工具路径标示A31845432原有资源沿用旧分新增官方安全文件依必要性标示表格结构要求同类型只显示一次分类栏每组分独立tbody并使用真正的th scoperowgroup rowspanN三语的 URL、顺序、分组与评分完全一致。机器如何验证表格结构与 URL→评分镜像check-reader-ux.py对资源表有两层检查_resource_table_errors()用正则切出table结构校验thead列头全部使用scopecol每个tbody的第一行必须恰好有一个scoperowgroup的th且其rowspan必须等于该组实际行数、并与配置的resource_group_rowspans如 track-a1 的[4, 5, 2]一致。这样三语表格的行数与分组被机械锁定。_resource_url_rating_pairs()逐行要求「恰好一个外部 URL」「恰好一个 1–5 星编辑评分」并返回(url, rating)配对。计划文档指出只检查 URL 顺序和星数总和是不够的——两个译文可能悄悄交换评分而旧检查仍全绿URL→评分配对检查正是为此而设resource_url_ratings: true。值得注意的是reader-ux-pages.yml中 track-a3 的forbidden_terms同时包含★与⭐相关约束A3只禁止代表 GitHub star 数量的★不再禁止编辑评分用的⭐。RATING_RE r(?!⭐)(⭐{1,5})(?!⭐)精确匹配 1–5 个编辑星而 HTML 属性里的星不会被计入_rendered_entry_metrics()会先中和属性中的链接样式文本。此外 track-a3 还禁止1-2 分钟、plan.yml、max_cost_usd等「会自然变旧或虚构成本」的表述。四工具身份辨析OpenRouter、OpenCode、Pi 与 Ollama计划文档把 A1 定位为四种工具身份的主要辨识入口完整比较保存在 resources/cli-agents-guide.md三语。四者的身份边界是OpenRouter 是 Router统一 API、账务与 provider routing它不读写 repo。OpenCode V2 是 coding agentharness能在授权范围内读档、改档与执行命令也能连 OpenRouter 或其他 provider。Pi 是可扩充的 local coding agentharnessproject trust 只控制专案资源载入不是 sandbox真正隔离要靠容器、VM 或 OS 边界。Ollama 是 local runtime负责在本机跑模型不会自己管理 repo 或命令权限。A1 正文中的「 精選 Projects」也给出了最短辨识法「不确定时只问三句——谁执行模型谁转送请求谁能读写我的档案」。表格按「官方模型生态 / 可换 provider / Router・本机引擎」三组呈现每组独立tbody正是上文rowspan452 的落地实例。计划文档还记录了一个官方查核发现的现行错误OpenCode V2 只探索AGENTS.md旧版文件的CLAUDE.mdfallback 不适用于 V2。因此 A1、CLI 指南与 developer path 三语都要修正。对照 A1-cli-intro.md 的 CLI-2可以看到当前表述已经是「OpenCode 以AGENTS.md优先没有AGENTS.md时CLAUDE.md是相容 fallback不要建立OPENCODE.md当作通用规则档」——这里的措辞compatibility fallback与 V2 只探索AGENTS.md的官方行为并不冲突但计划文档明确要求在 A1 镜像、developer path 三语中清除旧「无条件 fallback」残留相关文件因此被加入冻结清单。第一个可复制动作三站各自的「零门槛入口」计划文档为三站各指定一个「第一可复制动作」确保读者在还没读完任何展开内容时就能动手A1把只读请求放进textcode block读者可直接复制给已安装的 CLI。正文中的原文是請只讀取目前的 demo repo說明它的用途、找出測試指令並提出一個小型文件改動計畫。先不要修改檔案、不要刪除檔案也不要執行會改變資料的命令。完成标准能看到 repo 摘要、测试指令、待确认计划以及工具要求权限时的提示。A2保留完整可复制的最小 project-rules card 与SKILL.md。规则卡只有四件事用途、不可做、验证、回报正文给出可直接套用的 Markdown 模板SKILL.md则是带name/descriptionfrontmatter 的review-changes操作卡。A3在 CLI-9 可见区同时提供 PowerShell 与 macOS/Linux 建立a3-mcp-demo/hello.txt的指令设定差异才放进收合区New-Item -ItemType Directory -Force -Path a3-mcp-demo | Out-Null Set-Content -LiteralPath a3-mcp-demo/hello.txt -Value hello from A3mkdir -p a3-mcp-demo printf hello from A3\n a3-mcp-demo/hello.txt随后把官方 filesystem reference servermodelcontextprotocol/server-filesystem接到 CLI 时只传入这个文件夹的绝对路径不填~、home、磁盘根目录或整个工作区成功时 agent 能读出hello.txt要求读取范围外文件时应失败或要求重新授权。A2 的review-changesSkill 正文也值得直接引用它是可复制、可运行的完整实现--- name: review-changes description: Review the current git diff and report concrete risks. Use when the user asks to review local changes. --- 1. Read git diff --no-ext-diff HEAD without changing files. 2. Check for secrets, unsafe commands, broken links, and missing verification. 3. Report PASS when no problem is found; otherwise list each problem with its file and reason. 4. Do not edit, commit, push, deploy, or send messages.冻结文件清单31 个文件与 gate 的三次演进计划文档给出最终冻结的 31 个文件包括三语镜像与检查器脚本。关键点在于三语复查发现原 gate 只检查标题「存在」没有检查可见主线的「顺序」因此冻结清单中加入了 reader-UX checker 与其单元测试。而 strict anchor gate 随后经历了三次技术演进计划文档记录了完整的踩坑过程初始版本check-anchors.py只认标题 slug不认既有的a idcli-*稳定锚点 → 补上 HTML anchor 支持与 regression。首次独立 review 抓出两个正则 bug原 regex 会把data-id误认成idHTML_ID_RE匹配任何id属性也会错把明示 ID 做 slugify浏览器实际按精确 fragment 命中。修复方案是改用 HTML parser只接受真正的idname属性并以完全相同的 fragment 命中——对应 check-anchors.py 中的_ExplicitAnchorParser与collect_explicit_anchors()注释明确写道「Parsing attributes also preventsdata-idanddata-namefrom being mistaken for real targets」。OpenCode V2 旧 fallback 残留review 同时发现旧 fallback 残留在两个 A1 镜像、developer path 三语与先前计划文档因此这四个直接相依文件也被加入冻结清单恢复 A1 资源列改变了 repo 引用来源repository-freshness-snapshot.json必须由完整 GitHub API 扫描重建不能手改引用数字。冻结清单三语镜像按.*.md计包括tracks/cli/A1-cli-intro.*.md、A2-cli-workflow.*.md、A3-cli-production.*.md、resources/cli-agents-guide.*.md、resources/glossary.*.md、resources/style-guide.*.md、branches/for-developer.*.md以及docs/plans/2026-08-27-track-a-progressive-disclosure.md、scripts/check-anchors.py、scripts/check-reader-ux.py、scripts/reader-ux-pages.yml、scripts/repository-freshness-snapshot.json、scripts/test_check_anchors.py、scripts/test_reader_ux.py、stages/DESIGN.md、CHANGELOG.md和本计划档。计划文档强调不修改范例程序、Stage 03、README 或其他 branch 页面developer path 三语只修正同一个 OpenCode 规则档错误若后续再修改冻结范围审查指纹必须作废重跑。对照 glossary.md可以看到 glossary 同步补齐了Project Instructions、One-off Prompt、CI三个词条并把 Skills 的定义从 Claude Code 专属描述改成跨工具的SKILL.md行为包——「依 Agent Skills 规格一个 Skill 至少是一个含SKILL.md的目录也能附 scripts、references 与 assets安装第三方 Skill 前仍要读内容与权限」各工具的路径与权限仍分开说明。Gate 与验收从计划到可执行命令计划文档要求至少执行以下 gate均在仓库根目录下git diff --check python scripts/check-reader-ux.py python -m pytest scripts/test_reader_ux.py -q # 加上 stage template、strict anchors、anchor slug parity、mirror parity、locale links # zh-Hans 用语、OpenCC、image locale、duplicate repositories # freshness gate 与相关单元测试 python scripts/build-docs-tree.py python -m mkdocs build并做人工确认三语均符合核心 icon 存在核心词首次粗体且意思一致不展开仍知道下一步A1/A2/A3 的资源数量、分组、URL 与评分一致CLI-1、CLI-5、CLI-9 的第一个动作可直接复制OpenCode V2 不再沿用旧 fallback没有会自然变旧的 GitHub stars 数字。test_reader_ux.py约 950 行的回归测试展示了这些契约如何被单项测试覆盖_page()构造最小页面、_config()生成对应 YAML随后断言「核心词首次使用必须粗体」「定义标签必须按配置顺序」「可见段落顺序」「资源表 rowspan 形状」「URL→评分配对」等失败路径。从测试组织看checker 依赖md_fences.py全仓库共享的代码围栏解析器与check-anchors.py的slugify保证「代码块里的## Heading不会变成幽灵 anchor」这类跨 gate 的一致语义。Stack 与发布流程计划文档最后说明发布编排分支codex/track-a-reader-ux以 PR #146 的 commit11a83b82为基底完成后 PR base 指向codex/stage02-core-definitions不合并不删除远程或本地分支等使用者明确允许后按 stack 顺序处理。这体现了仓库「stacked PR 冻结清单 审查指纹」的治理方式改动范围被冻结清单锁死gate 是验收的唯一入口发布节奏由人工显式批准。结语把「读者体验」变成可测试的契约这份计划文档最有价值的地方在于它把「初学者看得懂、找得到、动得了手」这种模糊目标翻译成了可被脚本验证的机器契约可见字符上限、可见段落顺序、核心词首次粗体与定义顺序、资源表 rowspan 形状、URL→评分镜像、禁止 GitHub stars 数字。配合 check-reader-ux.py、reader-ux-pages.yml 与 check-anchors.py 的演进记录regex → HTML parser、data-id误认、slugify 误用读者可以完整复现「计划 → 实现 → 踩坑 → 回归 → 冻结」的工程闭环。对于任何想维护多语言技术学习路径的团队这套「编辑评分 ≠ 人气数字」「可见主线顺序锁定」「第一动作可复制」的做法都值得直接借鉴。如果你想继续深入推荐按此顺序阅读仓库先读 A1-cli-intro.md → A2-cli-workflow.md → A3-cli-production.md 看契约的页面形态再对照 check-reader-ux.py 与 reader-ux-pages.yml 看契约的机器形态最后用python scripts/check-reader-ux.py亲自验证一次需先按scripts/requirements-reader-ux.txt安装依赖。赞分享教程文档AI Agent人工智能大模型【免费下载链接】awesome-agentic-ai-zhA trilingual (繁中 / English / 简中) learning roadmap for agentic AI: from LLM basics to multi-agent systems, with 240 curated resources and hands-on examples. 中文 AI agent 學習地圖。项目地址https://gitcode.com/gh_mirrors/aw/awesome-agentic-ai-zh点击查看免费下载相关推荐Magnitude如何节省40%的Token成本深度解析记忆管理与Prompt缓存机制Magnitude如何节省40%的Token成本深度解析记忆管理与Prompt缓存机制 Magnitude 是一个开源的「视觉优先」浏览器 Agentbro教程文档AI Agent人工智能大模型IronClaw 工具发现评测契约渐进式工具披露的检索基线、端到端基准与上线门禁IronClaw 工具发现评测契约渐进式工具披露的检索基线、端到端基准与上线门禁 导读 本文基于 IronClaw 仓库 docs/internal/too人工智能AI 应用交互助手AI Agent240 AI Agent 学习资源怎么筛awesome-agentic-ai-zh 精选清单与五星推荐指南240 AI Agent 学习资源怎么筛awesome agentic ai zh 精选清单与五星推荐指南 学 AI Agent 最大的坑是资源太多、无从教程文档AI Agent人工智能大模型上一篇Azure AKS中XFS文件系统挂载失败问题分析与解决方案下一篇在Azure Kubernetes服务(AKS)中为Qdrant配置API密钥认证的最佳实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
