
## AI 优先开发

我们推荐优先让 AI Agent 按项目约定完成环境准备、项目创建、SDK 接入、本地调试和提交前检查。

[查看完整的 AI Agent 开发流程](./guide/ai-agent-development.md)

## 手动开发路径

1. **了解运行边界**：先读[什么是小程序工坊](./guide/index.md)，确认工坊小程序与普通小程序的差异和当前限制。
2. **安装并初始化 SDK**：按照[安装](./guide/installation.md)创建项目，再用[快速开始](./guide/quick-start.md)完成 SDK 初始化和用户状态读取。
3. **调试并提交审核**：通过[CLI 与本地 mock 调试](./guide/cli.md)完成浏览器和真机验收，提交前检查[小程序工坊上架规则](./guide/mini-program-publishing-rules.md)。

<!-- hb-sdk-changelog-summary:start -->
## 最新稳定版

**[v0.9.5](./changelog/index.md#v0-9-5) · 2026-10-30**

[查看全部更新日志](./changelog/index.md)
<!-- hb-sdk-changelog-summary:end -->

## 按目标查找

| 目标                         | 入口                                       |
| ---------------------------- | ------------------------------------------ |
| 手动安装并初始化 SDK         | [安装](./guide/installation.md)               |
| 获取用户状态或主动登录       | [用户与登录](./guide/auth.md)                 |
| 读取 App、小程序和系统环境   | [环境信息](./guide/environment.md)            |
| 处理前后台和登录态变化       | [事件与生命周期](./guide/lifecycle.md)        |
| 提交分数并读取跨用户排名     | [云端排行榜](./guide/cloud-leaderboard.md)    |
| 了解文件与下载合同及支持状态 | [快速开始](./guide/quick-start.md#文件与下载) |
| 处理 SDK 和业务错误          | [错误处理](./guide/error-handling.md)         |
| 查询类型、方法与参数         | [API 参考](./reference/index.md)                   |
| 排查常见问题或提交开发反馈   | [常见问题](./guide/faq.md)                    |
| 查找可复用的业务组合         | [场景示例](./recipes/index.md)                     |
