使用 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:开启一个已指向该页面的新对话,以便你立即就该页面提问。