---
title: "使用 AI 构建"
description: "通过 Fystack agent skill、llms.txt 和 Markdown 页面，将 Fystack 与 Claude Code、Cursor、Codex 和 ChatGPT 等 AI 编程助手配合使用。"
url: https://docs.fystack.io/zh/building-with-ai
last_updated: 2026-11-13
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.fystack.io/llms.txt
> Use it to discover all available pages before exploring further.

# 使用 AI 构建

Fystack 文档既面向开发者，也面向他们所使用的 AI 助手。每个页面都提供干净的 Markdown 版本，整个站点也都索引在 `llms.txt` 文件中，因此 Claude Code、Cursor、Codex 和 ChatGPT 等工具可以直接读取文档，而无需抓取 HTML。

## 安装 Fystack agent skill

[agent skill](https://agentskills.io) 是一组指令包，编程助手会在任务需要时加载它。官方 Fystack skill [fystack/agent-skills](https://github.com/fystack/agent-skills) 会教你的助手如何基于 Fystack 进行开发：

- **REST API**：每个 endpoint 及其关键字段，以及在任意语言中使用 HMAC 或 Ed25519 进行请求签名。
- **官方 SDK**：TypeScript 的 `@fystack/sdk` 和 Go 的 `github.com/fystack/platform-sdk-go`。
- **Webhook**：签名验证，以及确保充值只入账一次。
- **审批**：角色、审批组、自动审批额度和策略，因此它既能回答配置问题，也能编写代码。

它还会让你的助手遵循安全默认做法：先在 sandbox 环境中开发，不在代码中存放密钥，并且绝不绕过对资金操作的人工审批。该 skill 在工作时会读取这些文档，因此 API 变更时它也能保持最新。

为任何支持 agent skill 的助手安装它，包括 Claude Code、Cursor、Codex、Gemini CLI 和 GitHub Copilot：

```bash
npx skills add fystack/agent-skills
```

在 Claude Code 中，你也可以将其作为插件安装：

```text
/plugin marketplace add fystack/agent-skills
/plugin install fystack@fystack
```

如需手动安装，请将仓库中的 `skills/fystack` 文件夹复制到助手的 skills 文件夹中，例如项目中的 `.claude/skills/fystack`。

安装后无需特意提及该 skill。只需向助手提出 Fystack 相关任务，例如创建钱包或验证 webhook，它就会自动加载该 skill。

## 纯文本文档

AI 工具最适合处理纯文本。Markdown 所用的 token 远少于渲染后的 HTML，并且能完整保留代码示例、参数列表和表格。Fystack 以以下形式发布文档：

- **`llms.txt`**：[https://docs.fystack.io/llms.txt](https://docs.fystack.io/llms.txt) 是所有页面的简短索引，每页附一行描述。先让助手读取这里，它就能自行找到合适的页面。
- **`llms-full.txt`**：[https://docs.fystack.io/llms-full.txt](https://docs.fystack.io/llms-full.txt) 将所有页面合并在一个文件中。当你希望助手一次性加载全部文档，且工具的上下文窗口足够大时使用。
- **Markdown 页面**：在任意文档 URL 末尾加上 `.md` 即可获取该页面的 Markdown 版本，例如 [https://docs.fystack.io/wallets.md](https://docs.fystack.io/wallets.md)。
- **内容协商**：发送 `Accept: text/markdown` 请求头的 agent 可以直接从普通页面 URL 获取 Markdown，无需添加 `.md`。

```bash
curl -H "Accept: text/markdown" https://docs.fystack.io/wallets
```

## 将页面复制到助手中

每个页面标题旁都有一个 **Copy page** 按钮。你可以用它来：

- **Copy page**：将当前页面复制为 Markdown，可直接粘贴到任意聊天或编程助手中。
- **View as Markdown**：在新标签页中打开该页面的 Markdown 版本。
- **Open in ChatGPT** 或 **Open in Claude**：开启一个已指向该页面的新对话，以便你立即就该页面提问。

## 保护你的密钥和资金安全

> **Warning: 像对待其他团队成员一样对待 AI 助手.** 只给 AI 助手授予其所需的最小权限。开发时使用 sandbox API key，将密钥保存在环境变量中，而不是写在提示词或提交的文件里，并通过 IP 白名单限制生产环境的 key。使用[策略](https://docs.fystack.io/policies.md)和[审批组](https://docs.fystack.io/product/approval-group.md)保护生产钱包，这样即使助手出错，任何提现也无法在没有人工审批的情况下发出。