---
title: 开发者文档
description: 编写、调试、打包与发布 Notochord Gem 的完整参考。
section: dev
order: 0
updated: 2026-11-05
---
# 开发者文档
一个 Gem 就是一个文件夹:一份清单(manifest),加上可选的工具、agent(每个一份带头部的提示词文件)、SOP、页面、一份给 AI 看的 skill、一份给人看的介绍文档(`docs/`,将来是商店里的介绍页)、数据声明和事件订阅。装好以后,gem 的页面上列出它能做什么;需要用户配置的(账号、邮箱、知识库)在用户打开之前都是关着的。
## 从这里开始
1. [Gem 是什么](/zh/dev/gem-overview.md) — 结构、生命周期、与会话的关系
2. [清单参考](/zh/dev/manifest.md) — manifest 的每个字段
3. [权限模型](/zh/dev/permissions.md) — 网络、模型、知识库、邮件、账号如何申请与校验;存储、文件、文档抽取不用申请
4. [数据与存储](/zh/dev/storage.md) — 用 `ctx.data` 存 gem 自己的数据:集合、Log、文档、Blob,以及迁移、加密与隔离
5. [知识库 API](/zh/dev/knowledge.md) — 通过 `ctx.knowledge` 读写用户的事实与文档
6. [工具 API](/zh/dev/tools.md) — 内置工具与自定义工具
7. [事件与触发](/zh/dev/events.md) — 手动、定时、平台事件三种触发方式,各自的输入和限制
8. [本地开发与调试](/zh/dev/local-dev.md) — Gem Studio 与草稿流程
9. [打包与发布](/zh/dev/publishing.md) — 安装包的组成、安装时的校验、签名与信任级别
## 机器可读的接口
- [`config.notochord.ai/v1/index.json`](https://config.notochord.ai/v1/index.json) — 客户端从 CDN 拉取的全部静态配置清单
- [`config.notochord.ai/v1/config.json`](https://config.notochord.ai/v1/config.json) — LLM 厂商、服务连接模板、邮箱预设、本地模型、站点链接
- [`config.notochord.ai/v1/gem-templates.json`](https://config.notochord.ai/v1/gem-templates.json) — Gem Studio 模板
- [`download.notochord.ai/gems/index.json`](https://download.notochord.ai/gems/index.json) — Gem 商店的列表(应用的商店页读它)
- [`/llms.txt`](/llms.txt) — 整站的 AI 索引