示例项目

入门项目是附属于手册各个赛道的小型、仓库自有代码示例。它们让读者 读完概念页后可以看到可检查的文件、清晰的边界和明确的下一步，同时 不会把自己包装成生产应用。 在打开单个项目指南或 GitHub 文件夹之前，先用这个页面作为入口。

​

当前入门项目

​

如何使用这些 starter

• 从每个项目索引链接到的相关实验室页面开始。
• 在本地运行 starter 代码检查之前，先使用 环境设置。
• 从仓库根目录运行 python3 scripts/verify_example_projects.py 来 对当前示例代码进行冒烟测试。

​

它们为什么在这里

这些项目是公开的 starter 示例，不是隐藏的内部草稿，也不是上游项目 移植。它们用本仓库自己的语境说明系统形态、代码边界和扩展点。 它们也有意保持不完整：

• 当前仓库中的任何示例项目都不能声称自己是已完成的生产应用
• 一些示例会验证核心 Python 行为，但尚未连接真实的 框架、协议传输、搜索适配器或持久化层
• 每个项目索引都应清楚说明该项目是 starter、 partial 还是 runnable

​

未来入门项目应放置的位置

未来的入门项目应保持在各自赛道内：

• patterns/examples/
• systems/examples/
• ecosystem/examples/
• case-studies/examples/