DigitalPlat FreeDomain 学习指南的体系设计:US.KG 教程的 BOOK_PLAN 双轨课程架构与产品边界原则
本篇解析 BOOK_PLAN.md 所定义的学习指南总体方案:它以 DigitalPlat FreeDomain 产品为起点,明确划出产品文档(Category A)与通用域名/DNS/建站教材(Category B)的类别边界,并给出统一的编辑原则、章节结构与完成标准。读完本文后,你可以理解这套教程为什么采用"注册与委派"和"外部权威 DNS 记录编辑"双轨分离的组织方式,并能对照仓库中的实际目录验证该规划的落地一致性。
一、方案目标:从免费域名注册到通用运维的完整学习路径
BOOK_PLAN.md 的开篇 Goal 一节给出全书定位:
Create a book-length English learning path that begins with the DigitalPlat FreeDomain product, then clearly transitions to general domain, DNS, website, email, security, and operations education.
也就是说,这本"书"(即 documents/tutorial/ 下的教程体系)要完成一次从具体产品操作到通用网络工程的过渡:读者先学会在 DigitalPlat FreeDomain 上注册域名并完成外部名称服务器委派,再转入通用的域名、DNS、网站构建、邮件、安全与运维教学。该目标在整个仓库中有多处呼应:LEARN.md 将教程明确拆分为 "Category A: DigitalPlat FreeDomain" 与 "Category B: General Textbook" 两个区块;教程总索引 的导语同样强调"two clearly separated categories",并声明 DigitalPlat 将注册的域名委派给外部权威名称服务器、不提供普通 DNS 记录编辑器。
二、类别边界 A:DigitalPlat FreeDomain 产品章节
BOOK_PLAN 将 Category A 限定为产品特定章节,覆盖以下主题:
- 账号注册(account registration)
- FreeDomain 域名注册(FreeDomain registration)
- 外部权威名称服务器的提交(submission of external authoritative nameservers)
- 域名状态与续费(domain status and renewal)
- 注册数据与政策(registration data and policies)
- 当前已记录的账号与 API 能力(currently documented account and API areas)
其中最重要的是边界禁令,原文表述为:
DigitalPlat delegates domains to external authoritative nameservers. It does not provide an ordinary DNS record editor. Product chapters must never instruct a reader to create
A,AAAA,CNAME,MX,TXT, or other zone records in DigitalPlat.
这条禁令在产品文档中得到了一致的执行。Category A 总览 开篇即声明:"DigitalPlat does not provide a DNS record editor. Records such as A, AAAA, CNAME, MX, and TXT are created and managed at the external authoritative DNS service, not in the DigitalPlat Dashboard." 而 产品边界章节 进一步把边界细化为三层职责:
- DigitalPlat 职责:账号注册与登录、域名可用性与注册、命名空间政策确认、外部权威名称服务器提交、域名状态与到期信息、续费流程、注册联系数据管理、产品公告与账号功能;
- 外部 DNS 职责:托管区域(zone)并提供名称服务器,
A/AAAA/CNAME/MX/TXT/CAA/SRV等记录在外部服务中管理; - Web 托管职责:存储或运行网站、接受 HTTP/HTTPS 连接——DigitalPlat 注册不负责上传代码、创建 Web 服务器、开放端口、配置反向代理、签发证书或创建邮箱。
该书还给出了一段关系图,说明三层之间的委派链条:
DigitalPlat registration
|
| delegates the domain to external NS hostnames
v
External authoritative DNS
|
| publishes A, CNAME, MX, TXT, and other records
v
Website, email, and other services
并在 产品边界章节 中提供了"按故障层定位"的排查表(域名不在账号内查 DigitalPlat Domain List;委派 NS 错误查 DigitalPlat 名称服务器设置;NS 正确但缺 A 记录查外部 DNS 区域;DNS 正确但连接超时查服务器与防火墙等),这正是 BOOK_PLAN 所要求的"可观测验证"原则在产品文档中的具体化。
三、类别边界 B:通用域名与网站教材
Category B 覆盖与具体产品无关的通用知识:
- 互联网、终端与域名基础
- 外部权威 DNS 记录与故障排查
- HTML、CSS、可访问性与性能
- 静态与动态网站部署
- HTTP、HTTPS、反向代理与证书
- 邮件相关 DNS 记录
- 备份、监控、事件响应与服务器加固
- 架构、自动化与容量规划
BOOK_PLAN 对 Category B 给出了一条总规则:"All ordinary DNS record examples belong to the external authoritative DNS service." 各分册的 index 文件都忠实执行了这条规则,例如 Part 2 总览 声明 "All record-editing examples in this category are performed at the external authoritative DNS service, not at the registration platform";Part 4 总览 声明邮件记录同样在外部权威 DNS 服务创建,并提醒"不要把示例邮件记录直接复制进生产区域"。
从源码结构看(即仓库目录组织),Category B 被落实为 6 个目录:foundations/(Part 0 入门基础)、dns/(Part 2 外部 DNS)、website/(Part 3 建站与部署)、email/(Part 4 邮件与服务记录)、operations/(Part 5 运维与安全)、advanced/(Part 6 高级架构与参考),每个目录都有独立的 index.md 作为分册入口。
四、Integrated Capstone:连接两个类别的综合项目
BOOK_PLAN 的 "Integrated Capstone" 一节说明综合项目是把两类知识串起来的唯一桥梁:
The capstone connects both categories: DigitalPlat registers and delegates the name; external DNS publishes zone records; the web server hosts the site and HTTPS.
Part 7 总览 给出了完整的交付物清单:书面架构与所有权计划、完成委派验证的已注册域名、两页可访问静态网站、测试过的服务器配置、正确的根域与 www DNS 记录、规范的 HTTPS URL、续费与证书监控计划、可恢复的备份、变更日志与运维 runbook。同时该目录还特别警告:注册、续费、删除和名称服务器变更会产生外部副作用,提交前必须核对最终值——这与 BOOK_PLAN 编辑原则中的"可观测验证与回滚"相互印证。
五、编辑原则:九条可执行的质量约束
BOOK_PLAN 的 Editorial Principles 一节列出了 9 条原则,它们贯穿全部章节的文风与示例设计:
- 零前提假设:Assume no previous DNS, terminal, server, or web development experience.(假设读者没有任何 DNS、终端、服务器或 Web 开发经验)
- 渐进式路径:Progress from mental models to local labs, public deployment, and advanced operations.(从心智模型走向本地实验、公网部署、高级运维)
- 先讲原因再讲步骤:Explain the reason before the procedure.
- 使用虚构数据:Use fictional names and documentation IP ranges.(使用虚构名称与文档专用 IP 段,避免读者把示例值当真实数据使用)
- 第三方中立:Keep third-party guidance neutral and avoid guarantees.(对第三方服务保持中立,不作保证)
- 以当前公告为准:Treat current Dashboard notices, policies, prices, suffixes, limits, and capabilities as authoritative.(可用性、限额、价格、暂停与要求会变化,以 Dashboard 当前公告与政策为权威)
- 截图脱敏:Never expose passwords, keys, contact data, private domains, balances, or unrelated content in screenshots.(截图中绝不暴露密码、密钥、联系人数据、私有域名、余额或无关内容)
- 可验证可回滚:Provide observable verification and rollback for operational changes.
- 配套练习资产:Include exercises, suggested answers, decision trees, and reusable checklists.(随书提供练习、建议答案、决策树与可复用检查清单)
第 9 条在仓库中有直接对应:appendices/ 目录包含 Workbook、Suggested Answers、Troubleshooting Decision Trees 与 Checklists and Templates 四个文件,正好是"exercises、answers、decision trees、checklists"四件套。第 8 条则在 Part 2 总览 中被凝练为一条工作规则:"Make one DNS change at a time, record the previous value, wait for the authoritative answer to update, and verify the result before changing another layer." 教程总索引 的 Safety Rules 一节进一步汇总了全书安全底线:部署前替换虚构域名与文档 IP、不泄露凭据与注册数据、变更前备份旧值并定义回滚方案等。
六、书籍结构与仓库目录的映射
BOOK_PLAN 的 Book Structure 一节定义了 9 个组成部分:
| # | BOOK_PLAN 规划 | 仓库落地位置 |
|---|---|---|
| 1 | Category A: DigitalPlat FreeDomain Guide | documents/tutorial/platform/(9 章,从 project-overview 到 1.6-api-overview) |
| 2 | Category B, Part 0: Beginner Foundations | documents/tutorial/foundations/(0.1–0.6 共 6 章) |
| 3 | Part 2: External DNS | documents/tutorial/dns/(2.0–2.4 共 5 章) |
| 4 | Part 3: Website Building and Deployment | documents/tutorial/website/(3.0–3.9 共 10 章) |
| 5 | Part 4: Email and Service Records | documents/tutorial/email/(4.1–4.2 共 2 章) |
| 6 | Part 5: Operations and Security | documents/tutorial/operations/(5.1–5.9 共 9 章) |
| 7 | Part 6: Advanced Architecture and Reference | documents/tutorial/advanced/(6.1–6.5 + 术语表与参考) |
| 8 | Part 7: Integrated Capstone Project | documents/tutorial/capstone/(7.1–7.5 共 5 章) |
| 9 | Appendices: Workbook, Answers, Decision Trees, Templates | documents/tutorial/appendices/(4 个附录文件) |
从仓库目录结构看,规划中的 9 个部分与 documents/tutorial/ 下的 9 个目录(platform、foundations、dns、website、email、operations、advanced、capstone、appendices)一一对应,且 教程总索引 还额外提供了 Quick Paths(快速路径):例如"只需要把 DigitalPlat 域名接到外部 DNS"的三步短路径(产品边界 → 连接外部名称服务器 → 委派原理),以及"完整课程"路径(Category A → Part 0 → Capstone → Workbook),把 BOOK_PLAN 的章节组织转化为面向具体问题的导航。
需要说明的一个细节:教程章节编号中存在 Part 0 之后直接跳到 Part 2 的断号(没有 Part 1),这是刻意的——Part 0 承担"入门准备",产品特定的注册操作被单独放在 Category A,两者互不混淆,正好体现 Goal 中"clearly transitions"的过渡设计。
七、完成标准:以读者可验证的能力为终点
BOOK_PLAN 最后给出 Completion Standard:
The book is complete when a new reader can identify the product boundary, register a domain, delegate it to external nameservers, manage records at the external DNS service, build and deploy an accessible HTTPS site, operate it safely, complete the capstone, and navigate every chapter through README and the book index.
这条标准把"完成"定义为读者能力的 8 项可验证行为:识别产品边界、注册域名、委派外部名称服务器、在外部 DNS 服务管理记录、构建并部署可访问的 HTTPS 站点、安全地运维它、完成综合项目、通过 README 与书籍索引导航到每一章。仓库层面可以观察到这套标准的部分落地证据:Category A 总览 的 "Product Completion Check" 要求账号可登录、域名出现在 Domain List、外部 DNS 区域已建立、dig NS 返回预期的名称服务器;综合项目验收章节 与 Part 7 总览 的交付物清单覆盖了部署、安全与备份能力;教程总索引 的 Quick Paths 与 LEARN.md 的完整目录共同承担了"通过 README 与索引导航到每一章"的要求。
八、小结:一套以"边界清晰"为核心方法论的教学架构
综合来看,BOOK_PLAN.md 的价值不在于罗列章节,而在于确立了这条学习路径的三个核心方法论:
- 产品边界优先:Category A 章节严禁出现任何在 DigitalPlat 中创建 zone 记录的指导,从源头上消除"在注册 Dashboard 里找 A 记录"这类最常见的配置错误;
- 编辑原则可审计:零前提假设、先因后果、虚构数据、截图脱敏、变更可回滚等 9 条原则约束了全书每一章的写作方式,且 appendices/ 的练习/答案/决策树/清单四件套提供了练习闭环;
- 完成标准能力化:以读者"能否独立完成注册—委派—建站—运维"的端到端流程作为书籍完成判据,而非以章节数量衡量。
对维护者而言,该文件是教程仓库的"元文档":任何新增章节都应当先对照 Category Boundary 判断归属(Category A 还是 Category B),再对照 Editorial Principles 检查写作方式;对读者而言,它解释了你看到的 教程总索引 为什么长这个样——双类别目录、断号的 Part 0/2、唯一的综合项目、以及练习附录,全部都能在这份规划中找到依据。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0624
Hy4-previewHy4 preview 是由腾讯混元团队研发的新一代混合专家(MoE)旗舰模型。模型总参数量 770B,每个 token 激活 49B,主干共包含78层,第一层采用标准 FFN,其余 77 层均为 MoE 结构,每层包含 256 个路由专家与 1 个共享专家,每个 token 激活 top-8 路由专家及共享专家。主干之外原生内置 1 层 MTP(总参数量 10B,激活 0.7B)以支持投机解码。Python00
GLM-5.3GLM-5.3 与 GLM-5.2 使用相同的基座模型——所有提升均来自后训练。与 GLM-5.2 相比,它在复杂编程和长程任务上的表现显著提升。Jinja00
GLM-5.3-FlashGLM-5.3-Flash (320B-A18B),是GLM-5系列的首个原生多模态模型。320B总参数,能力超过GLM-5.2Jinja00
Spark-X2.5-4BSpark-X2.5-4B 旨在让强大的 AI 更实用、更高效、更易获得。在广泛日常任务中表现强劲,涵盖对话、写作、翻译、推理、编码、工具调用以及智能体工作流,并在同等规模的开源模型中取得领先成绩。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python00
Spark-X2.5-1.7BSpark-X2.5-1.7B 旨在让强大的 AI 更加实用、高效且易于获取。这些模型在广泛的日常任务中表现出色,涵盖对话、写作、翻译、推理、编程、工具调用和智能体工作流,并在同等规模的开源模型中取得领先结果。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python00