concepts/ 概念文档

gpt6-astra-usage-guide 概念文档——发布事实、行为模式、Prompt 配方、迁移生态

Open site Project Open in the app JSON README (API)

# concepts/ 概念文档

| 文档 | 说明 |
|------|------|
| [00-astra-release-and-features.md](00-astra-release-and-features.md) | 发布事实与规格、五项新特性（异步工具/中途引导/切档保缓存/偏离检测）与两项限制，含 Mermaid 事件图 |
| [01-behavior-patterns.md](01-behavior-patterns.md) | 五大行为模式机制解析与"Skill 被干掉"标题命题辨析 |
| [02-prompt-recipes.md](02-prompt-recipes.md) | 11 个官方 Prompt 配方中英对照（授权梯度/skill 溯源/去 AI Slop/委托/测试） |
| [03-migration-and-ecosystem.md](03-migration-and-ecosystem.md) | 迁移清单、选型成本考量、延伸资料与主题互链 |

```{toctree}
:hidden:
:maxdepth: 2

00-astra-release-and-features
01-behavior-patterns
02-prompt-recipes
03-migration-and-ecosystem
```

README

Loading documentation…

--- type: Reference title: Awesome OKF for Xuanspace sources: - id: xuanspace-readme resource: https://github.com/xinetzone/xuanspace title: XuanSpace（玄境）README 结构模板 - id: bundles-index resource: doc/bundles/index.md title: 知识包总索引（规模数据单一真相源） --- # Awesome OKF for Xuanspace > 技术为器、思想为道，器以载道 ![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-green) ![OKF Version: 0.2](https://img.shields.io/badge/OKF-v0.2-blue) ![Bundles: 693](https://img.shields.io/badge/Bundles-693-orange) ![Domains: 9](https://img.shields.io/badge/Domains-9-purple) ## 这是什么 **awesome-okf-xs** 是 [XuanSpace（玄境）](https://github.com/xinetzone/xuanspace) 项目的**开源知识格式（Open Knowledge Format，OKF）文档库**。它承载玄境项目"道"的一面——以 OKF bundle（知识包）为单元，系统化组织 **693 个知识包、9 大学科域、63 个分组**的中文教程，涵盖开源项目源码解读与人文经典/自然科学/社会科学著作的结构化阅读指南；与承载"器"（代码与工具）的 xuanspace 正反向协同，共同实践"器以载道"的理念。 > 📊 规模数据以 [知识包总索引](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/index.md) frontmatter 为单一真相源，当前实际值：**693 束 / 63 组 / 9 域**。 --- ## 为什么用 OKF bundle（而非散文档）普通 Markdown 文档堆的问题：**概念散、无信源、难迁移**。OKF 知识包用三层结构解决这三个痛点： | 特性 | 说明 | |------|------| | 🧱 **三层结构化** | 每个 bundle 固定包含 `concepts/`（概念定义）→ `examples/`（实战示例）→ `references/`（信源溯源）三层，避免"只有代码没解释、只有结论没证据" | | 🔗 **信源可追溯** | 所有事实陈述标注来源，关键概念经过双源/三源核对，不做无证据断言 | | 🤖 **AI Agent 就绪** | 内置 `AGENTS.md` 与 `.agents/` 规范目录，每篇文档有 OKF frontmatter，AI 可按结构批量生成、校验与迁移知识 | | 📦 **可迁移可复用** | bundle 是独立知识单元，跨仓库拷贝、按主题重组、增量同步均可直接操作 | | 🌐 **Sphinx 一键发布** | 文档直接构建为 Read the Docs 在线站，支持搜索、索引、交叉引用与 Mermaid 图表 | --- ## 30 秒快速开始 ### ① 在线阅读（推荐 · 零配置） 👉 **[📖 Read the Docs 文档站](https://awesome-okf-xs.readthedocs.io/)** — 直接浏览搜索，无需下载。 👉 **[🔍 知识保鲜台 · 轻量检索站](https://ai-agent-kepu-kit.app.workbuddy.host/)** — 基于本库内容文档的预生成索引：中文复合词可命中，支持 9 大学科域快捷入口、保鲜度（待复核队列）筛选、证据等级与信源跳转原文（WorkBuddy 1024 参赛作品）。 ### ② 本地预览文档 ```bash # 前置：Python >= 3.14 pip install -e ".[doc]" # 构建 HTML + 启动本地服务器预览 invoke build invoke browse # 自动打开浏览器预览 ``` ### ③ 本地开发 / 贡献 ```bash git clone git@github.com:awesome-flexloop/awesome-okf.git cd awesome-okf # 跑质量门（UTF-8 编码 + toctree 完整性 + 总索引计数对账） invoke gates.all ``` ### 🧭 你是谁？从这里开始不同背景的读者，推荐不同入门路径（更详细见 [知识包总索引推荐入门](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/index.md#推荐入门路径)）： | 读者画像 | 推荐路径 | 为什么 | |---------|---------|------| | 📜 **人文爱好者** | [国学](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/guoxue/index.md)（儒 → 道 → 易 → 阳明心学）→ [医学与养生](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/yixue/index.md) → [科学元典](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/kexue/index.md) | 从最经典的国学入门束开始，逐步打通医道互参、中西元典对读 | | ⚙️ **技术开发者** | [OKF 规范](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/meta/okf-spec/index.md) → [Python](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/jishu/python/index.md) → [构建](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/jishu/build/index.md) → [AI 生态](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/jishu/ai/index.md) | 先搞懂知识包的格式规范，再按技术栈直接定位到需要的源码解读 | | 🔄 **跨学科探索者** | [算学](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/guoxue/suanxue/index.md) ↔ [数学](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/kexue/math/index.md) · [道家](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/guoxue/daojia/index.md) ↔ [道医](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/yixue/daoyi/index.md) · [职场 OKR](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/sheke/workplace/index.md) ↔ [思维方法论](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/zhexue/methodology/index.md) | 中西对读、医道互参、理论与实践交叉，是这个库最有价值的打开方式 | --- ## 内容总览（9 大学科域）按知识包束数降序排列（完整 693 束清单 → [知识包总索引](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/index.md#九域分组导航)）： | # | 学科域 | 束数 | 组数 | 代表内容 | |:-:|--------|:---:|:---:|---------| | 1 | ⚙️ **技术（jishu）** | 511 | 19 | AI & 大模型 · 文档工程 · 构建/通信/容器/ML/PyData/Rust/Web/GUI/IoT/自动驾驶等技术生态 | | 2 | 👥 **社会科学（sheke）** | 84 | 9 | 职场管理 · 亲密关系 · 性学 · 理财 · 营销 · **AI 行业趋势** | | 3 | 📜 **国学（guoxue）** | 49 | 16 | 儒道释法墨易 · 河洛 · 老子/庄子/鬼谷子/周易 · 法家 · 道家 · 阳明心学 · 算学 | | 4 | 🔬 **科学（kexue）** | 17 | 3 | 中西化学经典对读 · 中西物理学经典 · 中外数学经典 | | 5 | 🌿 **医学与养生（yixue）** | 10 | 6 | 中医经典 · 黄帝内经 · 道医 · 养生 · 房中 · 东亚医学 | | 6 | 🎤 **艺术（yishu）** | 9 | 3 | 艺术疗愈 6 分支 · 声乐教学(咽音+手势) · 红歌教学 | | 7 | 💭 **哲学（zhexue）** | 8 | 2 | Ψhē 自指递归理论体系 · 思维方法论(第一性原理等) | | 8 | 📐 **规范与格式（meta）** | 3 | 3 | OKF v0.2 规范本体 · OKF 生态工具链 · OKF 桌面阅读器 | | 9 | ✒️ **文学（wenxue）** | 2 | 2 | 中国古典文学（浮生六记等） · 英语语法学习 | | **合计** | | **693** | **63** | 8 个学科域 + 1 个规范锚点 = **9 域** | > ⚠️ 本表数据以 [doc/bundles/index.md](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/index.md) frontmatter（`total_bundles` / `groups` / `domains`）为单一真相源。新增 / 删除 bundle 或分组后，请同步更新本表；`python scripts/check-bundles-index.py` 校验总索引自身五面一致，`python scripts/check-asset-baseline.py` 校验本表与 `doc/index.md` 的规模数字不与总索引矛盾。 --- ## 精选推荐（想先看这几篇试试） | 知识包 | 域/组 | 一句话亮点 | |--------|------|-----------| | [OKF v0.2 规范本体](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/meta/okf-spec/index.md) | 规范·格式 | 所有知识包的格式宪法——写包/读包之前先看这一本，含概念、示例、信源三层结构定义 | | [王阳明心学 5 束合集](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/guoxue/yangming/index.md) | 国学·阳明 | 《传习录》精读 + 心即理·知行合一·致良知·四句教 + 功夫论实践 + 生平年谱与弟子流派 | | [AI & 大模型生态（171 束）](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/jishu/ai/index.md) | 技术·AI | Trae / DeepSeek / Anthropic / Coze / 智谱 / 腾讯 NCNN / LangChain / 知乎 CLI 等 AI Agent 工具链源码教程 | | [第一性原理方法论](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/zhexue/methodology/index.md) | 哲学·方法论 | 可迁移的思维方法：哲学起源 → 物理学应用 → 商业创新案例 → 方法论框架 → 六步练习手册 | | [AI 行业与商业趋势 15 束](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/sheke/industry/index.md) | 社科·行业 | AI 变现指南 / Copilot 成本 / 国产大模型对比 / EMS 能源 / 硬件设计工具 / 监管治理快照分析 | --- ## 构建与质量体系（给贡献者） | 操作 | 命令 | 说明 | |------|------|------| | 构建 HTML 文档 | `invoke build` | Sphinx + MyST 构建，输出到 `_build/html/` | | 本地预览 | `invoke browse` | 构建后启动 HTTP 服务自动打开 | | 清理构建 | `invoke clean` | 移除 `_build/` | | **跑全部质量门** | **`invoke gates.all`** | ✅ UTF-8 编码无 BOM · ✅ toctree 无断链/孤立文档 · ✅ 总索引计数对账（frontmatter/表格/toctree 五面一致） | | 只查 toctree | `invoke gates.toctrees` | 新增/迁移 bundle 后必跑，防止断链 | | 只查计数对账 | `invoke gates.bundles` | 新增/删除束或分组后必跑，防止数字失真 | | 只查 UTF-8 | `invoke gates.utf8` | Windows 平台提交前注意 | **技术栈**：Python >= 3.14 · Sphinx + MyST Parser · sphinx-book-theme · Invoke（任务系统） · GitHub Actions + Read the Docs 自动部署。 --- ## 链接 - 📖 **在线文档**：[awesome-okf-xs.readthedocs.io](https://awesome-okf-xs.readthedocs.io/) - 🔍 **轻量检索站（知识保鲜台）**：[ai-agent-kepu-kit.app.workbuddy.host](https://ai-agent-kepu-kit.app.workbuddy.host/) — 基于本库的在线检索与保鲜度看板（WorkBuddy 1024 参赛作品） - 🏠 **基底项目（玄境代码）**：[xinetzone/xuanspace](https://github.com/xinetzone/xuanspace)（承载"器"的代码与工具） - 💾 **本仓库**：[awesome-flexloop/awesome-okf](https://github.com/awesome-flexloop/awesome-okf) - 🐛 **问题反馈**：[GitHub Issues](https://github.com/awesome-flexloop/awesome-okf/issues) - 📚 **知识包完整索引**：[doc/bundles/index.md](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/doc/bundles/index.md) - 📄 **许可证**：Apache License 2.0 — 详见 [LICENSE](https://github.com/awesome-flexloop/awesome-okf/blob/HEAD/LICENSE)

Details

Type: OKF bundles
Topic: Media, design & games
Publisher: awesome-flexloop
Source: okf_github
Category: Data
Version: 0.2
Copies (forks): 1
Last update: 2026-10-29T07:09:48Z
Project status: Active
Language: Python
License: Apache-2.0
Added: 2026-10-18 06:51:14
Updated: 2026-10-18 06:51:14
Source id: awesome-flexloop/awesome-okf:doc/bundles/jishu/ai/practice/gpt6-astra-usage-guide/concepts/index.md

concepts/ 概念文档

README

More