Skip to content

Commit 91a944c

Browse files
committed
feat(site): split standalone landing page from book
aibuzhiyu.com -> independent HTML landing (brand portal) aibuzhiyu.com/book/ -> mdbook trilogy Workflow now composes the site by copying landing/ to root and mdbook output into /book/. CNAME generated in workflow at root. mdbook site-url is /book/ so internal links resolve correctly. intro.md reverted to book-specific content (general preface) since brand portal lives separately now.
1 parent 2e542cd commit 91a944c

5 files changed

Lines changed: 489 additions & 67 deletions

File tree

.github/workflows/book.yml

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,26 @@ jobs:
4343
working-directory: ./book
4444
run: mdbook build
4545

46+
- name: Compose site (landing at root + book at /book/)
47+
run: |
48+
mkdir -p _site
49+
# 1) Landing 页放在根(index.html + 静态资源)
50+
cp -r landing/. _site/
51+
# 2) mdbook 输出放到 /book/ 子路径
52+
mkdir -p _site/book
53+
cp -r book/book/. _site/book/
54+
# 3) CNAME 必须在根(GitHub Pages 要求)
55+
echo "aibuzhiyu.com" > _site/CNAME
56+
# 4) 调试用:列出最终发布树的关键文件
57+
echo "--- _site root ---"
58+
ls -la _site/
59+
echo "--- _site/book ---"
60+
ls _site/book/ | head -10
61+
4662
- name: Upload artifact
4763
uses: actions/upload-pages-artifact@v3
4864
with:
49-
path: ./book/book
65+
path: ./_site
5066

5167
deploy:
5268
needs: build

book/book.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ preferred-dark-theme = "navy"
1212
git-repository-url = "https://github.com/jnMetaCode/ai-coding-guide"
1313
git-repository-icon = "fa-github"
1414
edit-url-template = "https://github.com/jnMetaCode/ai-coding-guide/edit/main/book/{path}"
15-
site-url = "/"
15+
site-url = "/book/"
1616

1717
[output.html.search]
1818
enable = true

book/src/CNAME

Lines changed: 0 additions & 1 deletion
This file was deleted.

book/src/intro.md

Lines changed: 23 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -1,79 +1,38 @@
1-
# AI不止语
1+
# 总序
22

3-
> AI 编程工具迭代很快,方法论永生。
4-
> 这里是过滤后的精华——**读源码、做核实、写指南**
3+
> 这套书的最大野心:让你看完之后,再也不用问"这个任务该用哪个 AI 工具"。
54
6-
---
5+
## 这套书是什么
76

8-
## 📚 内容矩阵
7+
这不是 9 本工具说明书,也不是一篇又一篇博客拼起来的合订本。
98

10-
### 📖 三卷书:AI 编程实战
9+
它是把 [ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide) 仓库里两年沉淀的 **10 款主流 AI 编程工具教程 + 7 套通用方法论 + 多个端到端实战脚本**,按 **读者画像** 而不是按工具,重新编排成的渐进式读物。
1110

12-
把 10 款主流 AI 编程工具教程 + 7 套通用方法论 + 多个实战脚本,按读者画像重组的渐进式读本
11+
工具会换代,方法论永生。所以这套书的结构是:**先教你方法,再用工具佐证**
1312

14-
|| 适合 | 入口 |
15-
|---|------|------|
16-
| **卷一 · 入门** | AI 编程零基础 / 只用过 Tab 补全 | [开始读 →](./v1-intro.md) |
17-
| **卷二 · 工作流** | 已经会用 1-2 款工具,想把效率往上拔 | [开始读 →](./v2-intro.md) |
18-
| **卷三 · 架构** | 团队 lead / 平台工程师 / CTO | [开始读 →](./v3-intro.md) |
19-
| **别册 · 速查手册** | 案头字典 / 30 秒选工具 | [打开 →](./cheatsheet.md) |
13+
## 三卷分别给谁
2014

21-
> 想要 PDF 版?去[书的发布仓](https://github.com/jnMetaCode/ai-coding-trilogy)(即将上线)。
15+
|| 适合谁 | 看完能做什么 |
16+
|---|--------|------------|
17+
| **卷一 · 入门** | AI 编程零基础 / 只用过 Tab 补全 | 从命令行 Agent 到 IDE 集成,4 款主流工具任选其一独立完成日常任务 |
18+
| **卷二 · 工作流** | 已经会用 1-2 款工具,想把效率往上拔 | 多工具组合、Skill / Hook / Subagent 编排、典型场景的端到端剧本 |
19+
| **卷三 · 架构** | 团队 lead / 平台工程师 / CTO | 把 AI 编程接进 CI、安全策略、企业治理;MCP 生态选型 |
2220

23-
### 📝 公众号「AI不止语」
21+
**别册** 是一页 `cheatsheet.md`——所有工具关键命令、配置文件、组合方案的横向速查。案头放一份,每天翻两眼。
2422

25-
技术问答 · 项目更新 · 实战长文。微信搜索 `AI_BuZhiYu`
23+
## 怎么读最高效
2624

27-
---
25+
- **顺读**:按卷一→卷二→卷三的顺序——是为完全新手设计的
26+
- **挑章读**:每章互相独立,目录里看到顺眼的就跳进去——卷二/卷三尤其如此
27+
- **遇到工具不熟**:随时退回卷一对应章节补课
28+
- **别册当字典**:写代码时遇到"那个命令叫啥来着",直接搜别册
2829

29-
## 🛠 开源项目矩阵
30+
## 信息源与可信度
3031

31-
完整 AI 编程链路——**学会用工具 → 注入方法论 → 加载专家 → 多角色编排 → 安全防护**
32+
每条工具的 CLI flag、配置字段、子命令、模型名都对照过相应仓库的源码(特别是 Codex CLI 那章,6 轮源码核实)。社区博客里常见的过期信息(如 `--full-auto``bubblewrap` 等)已修正——任何被否决的"常识"都附了源码出处链接。
3233

33-
| 项目 | 定位 | 一句话 |
34-
|------|------|------|
35-
| [**ai-coding-guide**](https://github.com/jnMetaCode/ai-coding-guide) | 📖 教程主仓 | 10 工具最佳实践 + 66 Claude Code 技巧 + 7 方法论 + 配置模板 |
36-
| [**ai-coding-trilogy**](https://github.com/jnMetaCode/ai-coding-trilogy) | 📚 三卷书发布仓 | 本站内容的 PDF 产品形态(CC BY-NC-SA 4.0) |
37-
| [**superpowers-zh**](https://github.com/jnMetaCode/superpowers-zh) | 🧠 工作方法论 | 20 个 skills 教 AI 怎么干活(TDD / 调试 / 代码审查等) |
38-
| [**agency-agents-zh**](https://github.com/jnMetaCode/agency-agents-zh) | 🎭 专家角色库 | 211 个即插即用 AI 专家(含 46 中国原创) |
39-
| [**agency-orchestrator**](https://github.com/jnMetaCode/agency-orchestrator) | 🚀 编排引擎 | 一句话 → 211 专家协作出方案(9 家 LLM / 6 免费) |
40-
| [**shellward**](https://github.com/jnMetaCode/shellward) | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测(含 MCP Server) |
34+
工具迭代快,每一版的"信息核实截止日期"在对应章节末尾标注。如果你看的版本距今超过 6 个月,建议先扫一眼 [项目更新日志](./changelog.md) 看有没有 breaking change。
4135

42-
---
36+
## 上游仓库
4337

44-
## 🔬 内容标准
45-
46-
每条 CLI flag、配置字段、子命令、模型名都对照过相应仓库的源码——特别是 Codex CLI 那章,**6 轮源码核实**。社区博客里常见的过期信息(如 `--full-auto``bubblewrap` 等)已修正,任何被否决的"常识"都附了源码出处链接。
47-
48-
工具迭代快,每章末尾标注"信息核实截止日期"。
49-
50-
---
51-
52-
## 💼 商业合作
53-
54-
出版社 / 企业内训(10 人以上)/ 付费课程 / 演讲分享 / 咨询,请通过:
55-
56-
- 公众号 **「AI不止语」** 后台留言「合作」
57-
- GitHub Issue 标题加 `[BUSINESS]` 前缀:[提交咨询](https://github.com/jnMetaCode/ai-coding-guide/issues/new?title=%5BBUSINESS%5D+)
58-
59-
> License:本书内容 CC BY-NC-SA 4.0(个人免费 / 商业用途请先联系)。
60-
> 教程主仓 Apache-2.0 永久免费。
61-
> [详细 license 说明 →](https://github.com/jnMetaCode/ai-coding-guide/blob/main/book/LICENSE.zh-CN.md)
62-
63-
---
64-
65-
## 💬 渠道
66-
67-
| 平台 | 链接 |
68-
|------|------|
69-
| 公众号 | 「AI不止语」(搜索 `AI_BuZhiYu`|
70-
| GitHub | [@jnMetaCode](https://github.com/jnMetaCode) |
71-
| X (Twitter) | [@aibuzhiyu](https://twitter.com/aibuzhiyu) |
72-
| QQ 群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)(群号 1071280067) |
73-
| 微信群 | 关注公众号后回复「群」 |
74-
75-
---
76-
77-
> **新读者建议**
78-
>
79-
> 不知道从哪开始?先读 → [**别册速查表**](./cheatsheet.md)(30 秒选工具),决定看哪一卷。
38+
GitHub: [jnMetaCode/ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide) — 欢迎 issue 和 PR。

0 commit comments

Comments
 (0)