使用 AI 构建

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

安装 Fystack agent skill

agent skill 是一组指令包,编程助手会在任务需要时加载它。官方 Fystack skill 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:

npx skills add fystack/agent-skills

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

/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 是所有页面的简短索引,每页附一行描述。先让助手读取这里,它就能自行找到合适的页面。
  • llms-full.txt:https://docs.fystack.io/llms-full.txt 将所有页面合并在一个文件中。当你希望助手一次性加载全部文档,且工具的上下文窗口足够大时使用。
  • Markdown 页面:在任意文档 URL 末尾加上 .md 即可获取该页面的 Markdown 版本,例如 https://docs.fystack.io/wallets.md。
  • 内容协商:发送 Accept: text/markdown 请求头的 agent 可以直接从普通页面 URL 获取 Markdown,无需添加 .md。
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:开启一个已指向该页面的新对话,以便你立即就该页面提问。

保护你的密钥和资金安全

像对待其他团队成员一样对待 AI 助手

只给 AI 助手授予其所需的最小权限。开发时使用 sandbox API key,将密钥保存在环境变量中,而不是写在提示词或提交的文件里,并通过 IP 白名单限制生产环境的 key。使用策略和审批组保护生产钱包,这样即使助手出错,任何提现也无法在没有人工审批的情况下发出。