---
title: 本地开发与调试
description: 用 Gem Studio 起草、测试 gem,并安装到自己的机器上。
section: dev
order: 70
updated: 2026-11-12
---
# 本地开发与调试
Gem Studio 是 Notochord 里开发 gem 的地方:在这里起草、测试,装到自己的机器上用。
## 草稿
- 在 Gem Studio 里新建一个草稿,可以从模板开始。草稿就是一个 gem 的文件夹:`manifest.json`,加上工具、agent、SOP、页面、skill 和介绍文档。
- 文件可以在 Gem Studio 里编辑,也可以用你自己的 IDE 打开草稿所在的文件夹编辑。
- Gem Studio 里有一个助手,可以帮你写代码、检查 `SKILL.md` 里的路径、解释报错。没写过代码也可以靠它完成。
- 草稿有历史,可以回到以前的版本。
## 测试
- **工具**:在工具的页面上填入参数直接运行,看返回值和每一步的记录。
- **Agent**:在测试对话里和它聊,走的是和装好以后相同的运行路径。
- **SOP**:手动触发,查看每一步做了什么、结果是什么。
- **页面**:在 Gem Studio 里实时预览。
- 测试时用的权限、数据和装好以后相同:清单里没申请的,测试时也用不了。数据怎么保留、迁移怎么测,见[数据与存储](/zh/dev/storage.md#在-gem-studio-里测试)。
## 安装到自己的机器上
点「安装」,Notochord 把草稿打成安装包,走和商店里的 gem 相同的安装流程,同样的校验。这个包没有签名,按 Developer mode (unsigned) 处理。详见[打包与发布](/zh/dev/publishing.md)。
## 排错
- 安装失败时,报错里有错误码,对照[打包与发布](/zh/dev/publishing.md#安装时检查什么)里的表。
- 运行出错时,gem 的页面上有运行记录,点一条能看每一步的输入和结果;Gem Studio 里可以把错误交给助手分析。