HagiTask 介绍
适用对象： 想了解 HagiTask 生态的使用者、维护者和贡献者。
前置条件： 无。若要安装或运行任务，请先准备好 HagiCode 应用及其后端服务。
HagiTask 是什么
HagiTask 是 HagiCode 的任务包和预设任务模型。一个任务包把任务身份、前端面板、后端提示词、模板、界面文案和商店介绍放在同一个可校验的目录中，应用可以据此发现、安装、管理并运行任务。
任务包不是应用本身，也不会取代应用的运行时配置。应用负责加载任务并执行任务声明的能力；任务包只提供经过约定格式组织的资源。
生态中的几个角色
| 角色 | 责任 |
|---|---|
| HagiTask | 维护共享 Schema 和随产品发布的内置预设包，是包格式的 source of truth。 |
| 内置预设 | 随应用或运行时提供的可用任务，例如 normal-session 和 research-investigation。 |
| Community Packages | 维护社区任务的源数据，目录位于 data/<taskId>/。 |
| HagiTask Site | 从社区包源生成目录、详情 JSON 和 ZIP 归档，发布到 Community Gallery。 |
| HagiCode 应用 | 展示任务、安装包、保存启用状态，并在运行时执行任务。 |
内置预设与社区任务使用相同的包 Schema，但来源和生命周期不同：内置预设由 HagiTask 仓库维护，社区任务由 Community Packages 仓库维护。站点上的 /index.json、详情文档和 ZIP 都是生成产物，不是贡献者直接编辑的源文件。
包管理和来源管理不是一回事
从 Gallery 安装一个 ZIP，是把包复制到应用的数据目录并登记版本、来源和启用状态。服务器来源管理则是配置服务器可见的目录，让运行时从该目录发现任务；它不会把浏览器本地文件夹上传为安装包。
有关操作边界和文件夹来源，请阅读使用 HagiTask。准备安装时，继续阅读安装 HagiTask；要创建或发布任务，请阅读参与社区贡献。
Source of truth 责任边界
- docs 维护面向使用者和贡献者的叙事与操作指南。
- HagiTask 维护共享 Schema 和内置预设源。
- Community Packages 维护社区包源数据。
- HagiTask Site 发布由包源生成的目录、详情和归档。
下一步： 安装 HagiTask。