{"id":50528394,"url":"https://github.com/microclaw/buildbook","last_synced_at":"2026-06-03T10:30:32.312Z","repository":{"id":356246421,"uuid":"1162342682","full_name":"microclaw/buildbook","owner":"microclaw","description":"Building MicroClaw Systems from Scratch","archived":false,"fork":false,"pushed_at":"2026-05-07T07:40:52.000Z","size":11870,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T09:27:30.825Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microclaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-20T06:23:44.000Z","updated_at":"2026-05-07T07:40:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/microclaw/buildbook","commit_stats":null,"previous_names":["microclaw/buildbook"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/microclaw/buildbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microclaw%2Fbuildbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microclaw%2Fbuildbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microclaw%2Fbuildbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microclaw%2Fbuildbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microclaw","download_url":"https://codeload.github.com/microclaw/buildbook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microclaw%2Fbuildbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33860961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-03T10:30:31.354Z","updated_at":"2026-06-03T10:30:32.298Z","avatar_url":"https://github.com/microclaw.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Analyzing MicroClaw Book\n\n本仓库是《剖析与实现 MicroClaw》书稿工程，采用 `Markdown + Pandoc + Typst` 流水线。\n\n目标：只保留“写作与出版必须文件”，删除无源价值文件（临时文件、编辑器状态、可再生构建产物）。\n\n版本基线：`microclaw/microclaw` v0.1.38。\n\n## 快速开始\n\n```bash\ncd /Users/eevv/focus/buildbook\nmake check\nmake audit\nmake pdf\n```\n\n构建产物默认输出到 `dist/`（已加入 `.gitignore`，不作为源码管理）。\n\n## 仓库结构（全部有效文件）\n\n### 根目录\n\n- `README.md`：仓库总说明与文件治理规则\n- `AGENTS.md`：仓库协作约束与执行规则\n- `todo.md`：从写作到发布的执行清单\n- `surface.png`：书籍封面图（PDF 首页）\n- `Makefile`：一键命令入口（`check`/`audit`/`pdf`/`clean`）\n- `.gitignore`：忽略编辑器与构建产物\n- `scripts/build-book.sh`：主构建脚本（固定编译顺序）\n- `scripts/audit-files.sh`：文件治理审计脚本（检测“无用途文件”）\n- `assets/figures/*.svg`：正文图表资源\n\n### 书稿控制文件（根目录）\n\n- `00-项目总览.md`：范围定义（做什么/不做什么）\n- `01-全书目录.md`：唯一权威目录\n- `02-写作规范.md`：术语、证据、章节写法规范\n- `03-写作路线图.md`：阶段推进计划\n- `04-进度看板.md`：章节状态管理\n- `05-出版构建.md`：构建与排版操作手册\n- `06-封面设计-prompt.md`：封面生成提示词\n\n### 排版与构建配置\n\n- `build/metadata.yaml`：书籍元数据\n- `theme/book-theme.typ`：Typst 版式主题\n\n### 正文章节\n\n- `chapters/part-1-foundation/*.md`：基础篇（Chapter 1-4）\n- `chapters/part-2-kernel/*.md`：内核篇（Chapter 5-12）\n- `chapters/part-3-production/*.md`：生产篇（Chapter 13-18）\n\n### 附录\n\n- `appendices/appendix-a-能力矩阵.md`\n- `appendices/appendix-b-源码导读索引.md`\n- `appendices/appendix-c-实施模板.md`\n- `appendices/appendix-d-最小实现主线.md`\n\n### 研究资料（仅用于写作参考）\n\n- `research/compare/01-microclaw-vs-openclaw.md`\n- `research/compare/02-microclaw-vs-nanoclaw.md`\n- `research/compare/03-microclaw-vs-moltis.md`\n- `research/compare/04-microclaw-vs-zeroclaw.md`\n- `research/compare/05-microclaw-vs-nanobot.md`\n- `research/compare/06-microclaw-vs-nullclaw.md`\n- `research/compare/README.md`\n\n## 文件治理规则\n\n满足以下任一条件的文件会被删除：\n\n1. 可由命令重新生成（如 `dist/*.pdf`、`dist/*.typ`）。\n2. 仅包含编辑器本地状态（如 `.obsidian/*`）。\n3. 与当前目录体系重复且无新增信息。\n4. 无法被目录、章节或构建流程引用。\n\n## 写作原则\n\n1. 目录先行：章节结构以 `01-全书目录.md` 为准。\n2. 证据先行：关键结论必须可追溯。\n3. 工程先行：先讲架构决策，再讲实现细节。\n4. 可落地先行：每章必须给出实践清单。\n\n## 参与与反馈\n\n- 上游仓库：\u003chttps://github.com/microclaw/microclaw\u003e\n- 如果项目或这本书对你有帮助，欢迎给 `microclaw/microclaw` 点一个 `star`。\n- 如果你发现书稿、源码或构建链路中的问题，欢迎提交 `issue`。\n- 如果你补充了修正、文档、图表或示例，欢迎提交 `PR`。\n- 也欢迎关注我的其它作品：\u003chttps://github.com/everettjf\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroclaw%2Fbuildbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicroclaw%2Fbuildbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroclaw%2Fbuildbook/lists"}