Helius Core AI：Solana 开发者的AI智能体工具集深度解析

在区块链开发领域，AI智能体（Agent）正成为提升开发效率、降低认知负荷的关键技术。其核心原理在于通过自然语言交互，将复杂的API调用和链上操作意图转化为可执行的代码或查询指令，从而简化开发流程。这一技术价值在于，它能够将开发者从繁琐的文档查阅和样板代码编写中解放出来，实现更高效的“对话式开发”。在Solana生态中，Helius Core AI工具集正是这一理念的工程实践典范。它通过提供命令行

sylph mini

198人浏览 · 2026-05-07 13:15:45

sylph mini · 2026-05-07 13:15:45 发布

1. 项目概述：Helius Core AI 工具集深度解析

如果你正在 Solana 生态里搞开发，或者想用 AI 来辅助你理解、查询甚至构建链上应用，那你大概率已经听说过 Helius 这个名字。作为 Solana 生态里最核心的 RPC 和基础设施服务商之一，Helius 提供的 API 和工具链是很多开发者的首选。但今天要聊的，不是他们那些广为人知的 Web API 或 SDK，而是一个更“未来感”的集合： Helius Core AI 。

简单来说，Helius Core AI 是一个官方出品的、专门为 AI 智能体（Agent）和开发者设计的工具套件仓库。它把 Helius 和 Solana 区块链的交互能力，直接“嫁接”到了命令行、Claude 这类 AI 助手，甚至是能够自主运行的 AI 代理中。这意味着，你不再需要为了查个钱包余额、解析一笔交易而频繁切换浏览器、打开文档或者写一堆样板代码。无论是通过一句自然语言指令，还是一个简单的 CLI 命令，你都能直接获取到链上数据，甚至执行链上操作。

这个仓库包含了四个核心包，各有侧重：

helius-cli ：一个功能强大的命令行工具，让你能用终端管理 Helius 账户、查询 Solana 数据。
helius-mcp ：一个 Model Context Protocol 服务器，将 Helius 的能力直接暴露给 Claude 等兼容 MCP 的 AI 模型。
helius-skills ：一系列独立的 Claude Code 技能，将 Claude 变成某个领域的专家（如 Solana 开发、交易应用构建）。
helius-plugin ：一个 Claude Code 插件，集成了所有技能并自动启动 MCP 服务器，算是一站式解决方案。

这套工具的核心价值在于 “降低认知负荷和操作成本” 。对于开发者，它提供了更高效的本地工作流；对于研究员或分析师，它使得通过对话式 AI 探索链上数据成为可能；而对于构建 AI 驱动的链上应用（Agent）的团队来说，它提供了一套标准化、可集成的工具接口。接下来，我会带你深入每一个部分，拆解其设计思路、实操细节，并分享我在集成和使用过程中踩过的坑和总结的经验。

2. 核心工具包设计与选型逻辑

为什么 Helius 要推出这样一套以 AI 为中心的工具？这背后其实反映了区块链开发者工具演进的一个清晰趋势：从面向过程的 API 调用，转向面向意图（Intent）和智能交互。传统的开发流程是：看文档 -> 写代码 -> 调试 -> 运行。而 helius-core-ai 试图构建的流程是：描述需求 ->（由 AI 或 CLI）自动生成正确的查询或操作 -> 获得结果。

2.1 架构分层与职责分离

整个 core-ai 仓库的架构体现了一种清晰的分层思想，这保证了各个组件的独立性和可复用性。我们可以把它理解为一个三层模型：

基础设施层（ helius-cli & helius-mcp ） ：这一层提供最基础的、无状态的工具能力。 helius-cli 是面向开发者和脚本的，强调确定性和可编程性； helius-mcp 则是面向 AI 模型的，通过标准化的协议（MCP）暴露工具函数，强调对话和上下文理解。它们都直接调用 Helius 的底层 API，但封装了认证、网络选择、错误处理等脏活累活。
领域技能层（ helius-skills ） ：这一层建立在基础设施之上，注入了具体的“领域知识”。一个 Skill 不仅仅是一组工具，更包含了一套引导 AI 如何思考、如何解决问题的“思维框架”和最佳实践。例如， /helius 技能里会教 AI 在构建 DApp 时优先使用 Helius Sender 来发送交易以降低延迟，或者提醒它处理 NFT 数据时使用 DAS API 的特定查询参数。这相当于为 AI 配备了一个经验丰富的 Solana 开发导师。
集成与分发层（ helius-plugin ） ：这是面向最终用户的“产品化”封装。它将分散的技能和后台服务（MCP Server）打包成一个易于安装和管理的插件，提供开箱即用的体验。用户不需要关心 MCP 服务器如何启动、技能如何安装，只需要一条安装命令，所有能力就绪。

这种设计的精妙之处在于，每一层都可以被单独使用。你可以只安装 CLI 来写脚本；可以只连接 MCP 服务器让你现有的 AI 工作流获得区块链能力；也可以只安装某个特定的 Skill 来强化 AI 在某个细分领域的表现。这种模块化极大地增加了灵活性。

2.2 关键技术选型：为什么是 MCP 和 Claude Code？

Model Context Protocol (MCP) 是 Anthropic 提出的一种开放协议，用于让 AI 模型安全、可控地访问外部工具、数据和计算资源。选择 MCP 作为 helius-mcp 的基石，是一个极具前瞻性的决定。

注意：这里需要区分 helius-mcp 和 Helius 官方文档网站（helius.dev/docs）通过 Mintlify 自动生成的另一个 MCP 服务器。后者仅用于文档搜索，功能单一。而仓库里的 helius-mcp 是功能完整的，覆盖了账户、钱包、资产、交易、链状态、流数据、知识库、链上操作和压缩等九大领域，外加一个 expandResult 工具，共计 10 个公共工具。

MCP 的核心优势在于 标准化和安全性 。它定义了一套清晰的工具调用、结果返回和资源管理的接口。对于 Helius 来说，他们只需要实现一次 MCP 服务器，所有兼容 MCP 的 AI 应用（不限于 Claude）都能立即获得这些能力。同时，MCP 的权限模型可以精细控制 AI 能做什么（比如，可以只允许查询，不允许发送交易），这比直接给 AI 一个万能 API Key 要安全得多。

Claude Code Skills 则是 Anthropic 为 Claude Code 编辑器设计的一套技能系统。一个 Skill 本质上是一个包含详细指导（ SKILL.md ）和相关示例文件的文件夹。当用户在 Claude Code 中通过 /skill-name 调用时，Claude 会读取这些文件，将自己“切换”到该技能所定义的专家角色和行为模式中。

选择为 Claude Code 深度集成，是因为它目前是 AI 辅助编程领域体验最成熟的产品之一。其内置的代码编辑器、终端、文件浏览器与 Claude 的深度结合，为“对话式开发”提供了完美的沙箱。将 Helius 的工具和知识注入这个环境，能最大化提升开发者的效率。

2.3 设计模式：摘要优先与按需扩展

在 helius-mcp 的工具设计中，有一个非常实用的模式： “摘要优先”（Summary-First） 。对于可能返回大量数据的请求（比如查询一个活跃地址的交易历史），工具不会一次性返回所有原始数据把 AI 的上下文窗口塞满。相反，它会先返回一个摘要，包含关键统计信息（如交易总数、时间范围、主要交互协议）和一个唯一的 resultId 。

如果 AI（或用户通过 AI）需要查看更详细的数据，可以随后调用 expandResult 工具，传入这个 resultId 和想要获取的数据范围（例如，“给我看第 2 页的详细交易列表”或“展开最近 10 笔交易的解析结果”）。这种设计有两大好处：

节省上下文令牌（Token） ：AI 的上下文长度是宝贵资源，摘要模式避免了在不需要细节时浪费令牌。
提升响应速度 ：生成一个摘要比获取并格式化全部数据要快得多，使得初始交互更加敏捷。

这个模式非常值得我们在设计自己的 AI 工具接口时借鉴。它本质上是一种“分页”或“懒加载”思想在 AI 交互场景下的应用。

3. 从零开始：环境配置与核心工具实操

理论说得再多，不如动手一试。我们以一个新用户的视角，走一遍从环境准备到实际使用的完整流程。我会假设你是一个有一定 Node.js 和命令行基础的开发者，目标是利用这些工具来辅助你的 Solana 生态开发工作。

3.1 基础环境准备

首先，确保你的系统满足最低要求：

Node.js 20+ ：这是运行这些工具的基础。建议使用 nvm 来管理 Node 版本，可以轻松切换。
pnpm ：仓库内的项目使用 pnpm 作为包管理器，比 npm 更快、更节省磁盘空间。可以通过 npm install -g pnpm 安装。
Helius 账户和 API Key ：这是使用大部分功能的前提。如果你还没有，可以暂时跳过，但后续核心功能会需要。

# 检查 Node.js 版本
node --version # 应 >= 20
# 安装 pnpm
npm install -g pnpm

3.2 Helius CLI 的安装与核心工作流

helius-cli 是你的瑞士军刀，尤其适合自动化脚本和快速查询。

安装与配置 安装非常简单，全局安装一次即可在任何地方使用。

npm install -g helius-cli
# 或使用 pnpm
pnpm add -g helius-cli

安装后，首先需要配置你的 API Key。如果你已经有 Helius 账户，从 dashboard.helius.dev 获取你的 API Key，然后执行：

helius config set-api-key YOUR_API_KEY_HERE

这条命令会将你的 API Key 安全地存储在本地的 ~/.helius/config.json 文件中。CLI 会按照以下优先级解析 Key：1. 命令行 --api-key 参数；2. HELIUS_API_KEY 环境变量；3. 上述配置文件。

新用户账户创建实战 对于新用户，CLI 提供了一套引导式的账户创建流程，但这其中有个关键步骤需要手动完成，也是容易卡住的地方。

生成密钥对 ：
```
helius keygen
```
这个命令会在 ~/.helius/ 目录下生成一个 keypair.json 文件（你的私钥，务必妥善保管！），并在终端打印出对应的 Solana 公钥地址。
手动充值 ：这是整个流程中最关键的一步。CLI 创建 Helius 付费账户需要支付 1 USDC 作为基础套餐费用，同时还需要少量 SOL 来支付链上交易的手续费（Gas）。你需要手动使用其他钱包（如 Phantom、Solflare）或交易所，向第一步生成的公钥地址发送：
- 1 USDC (在 Solana 主网上)
- 约 0.01 SOL (用于支付后续 signup 交易的 Gas)
实操心得 ：很多新手会在这里等待 CLI 自动完成，但 CLI 本身没有转账功能。你必须主动去操作。建议先转 0.02-0.05 SOL，再转 1 USDC，确保 SOL 先到账，才能支付 USDC 转账本身的 Gas。你可以使用 helius balance <你的公钥> 来检查余额是否到账。
执行注册 ：确认资金到账后，运行：
```
helius signup
```
CLI 会使用你本地的私钥签名一笔交易，在链上创建你的 Helius 账户。成功后，它会自动为你生成一个 API Key 并保存到配置中。

常用命令速查 配置好后，你就可以畅快使用了：

# 查询任意钱包的 SOL 和 SPL 代币余额
helius balance 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

# 深度解析一笔交易，了解其指令、账户变化、代币转移等细节
helius tx parse 5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrC3igP9vdg5WpbdM

# 切换网络（例如切换到开发网）
helius config set-network devnet

# 创建监听特定地址的 Webhook（用于实时监控）
helius webhook create -a <监听地址> -u <你的接收URL>

CLI 的功能远不止这些，还包括质押管理、ZK 压缩账户操作、实时数据流订阅等，你可以通过 helius --help 查看所有命令。

3.3 集成 AI 能力：MCP 服务器与 Claude Code 插件

如果你更倾向于与 AI 对话来完成任务，那么 helius-mcp 和 helius-plugin 是你的主要战场。

方案一：独立 MCP 服务器（ helius-mcp ） 这种方式适合希望将 Helius 能力接入任何 MCP 兼容客户端的用户，或者想在 Claude Desktop 等环境中使用的用户。

# 将 Helius MCP 服务器添加到 Claude Desktop
claude mcp add helius npx helius-mcp@latest

添加后，在对话中你就可以直接让 Claude 查询区块链数据了，例如：“帮我查一下 vault1.sol 这个域名绑定了哪个钱包地址？” Claude 会自动调用背后的 heliusWallet 工具来解析 SNS 域名。

方案二：一站式 Claude Code 插件（ helius-plugin ） 这是最推荐给 Solana 开发者的方式，尤其是在 Claude Code 编辑器中工作。

在 Claude Code 的聊天框中，首先添加插件市场源（如果之前没添加过）：
```
/plugin marketplace add helius-labs/claude-plugins
```
然后安装 Helius 插件：
```
/plugin install helius@helius
```

安装完成后，插件会自动在后台启动 helius-mcp 服务器，并加载所有技能。你会在技能列表中看到 helius:build , helius:dflow , helius:svm 等。

API Key 的配置 无论哪种方式，首次使用涉及 Helius API 的功能时，AI 都会引导你配置 API Key。你有三个选择：

直接提供已有 Key ：在对话中，当 AI 提示时，你可以通过 setHeliusApiKey 工具调用传入你的 Key。
让 AI 代理注册 ：你可以授权 AI 使用 generateKeypair 和 agenticSignup 工具，让它自动完成密钥生成和账户注册流程（仍需你手动给生成的钱包地址转账）。
使用 CLI 注册 ：如前所述，用 helius-cli 完成注册后，Key 已保存在 ~/.helius/config.json ，MCP 服务器会自动读取。

注意事项 ：在 Claude Code 中，插件技能（如 /helius:build ）和直接与 AI 对话使用 MCP 工具，本质上是连通的同一个 MCP 服务器。技能提供了一个更结构化、领域特定的对话入口点，而直接对话则更自由。你可以根据任务复杂度选择使用方式。

4. 技能深度使用与场景化案例

安装了插件或技能后，如何真正用它来提升效率？下面通过几个具体场景，展示其强大之处。

4.1 场景一：快速构建一个 NFT 查询 CLI 工具

假设你想写一个简单的脚本，根据输入的钱包地址，列出其持有的所有 NFT 及其所属系列。没有 AI 辅助时，你需要查阅 DAS API 文档，研究分页、排序参数，处理网络请求和错误。

使用 /helius:build 技能： 你可以直接向 Claude Code 描述需求：“我想用 Node.js 写一个脚本，使用 Helius 的 DAS API 获取指定地址的所有 NFT，并打印出名称、图片链接和系列信息。”

激活 /helius:build 技能后，Claude 会以一个 Solana 开发专家的身份来回应。它可能会：

推荐使用 @helius-labs/helius-sdk 或直接使用 fetch 调用 Helius 端点。
指出 DAS API 的 getAssetsByOwner 端点最适合此任务，并提醒你注意分页限制（默认 1000 条，可用 page 和 limit 参数）。
提供完整的代码示例，包括错误处理、优雅的分页逻辑，甚至建议使用 cli-progress 库来显示进度条。
提醒你关注响应中的 compression 字段，以区分普通 NFT 和压缩 NFT（cnft），因为它们的处理方式可能不同。

最终，你可能会得到类似下面的高质量代码骨架：

import { Helius } from '@helius-labs/helius-sdk';
import dotenv from 'dotenv';
dotenv.config();

const helius = new Helius(process.env.HELIUS_API_KEY);

async function getNFTsByOwner(ownerAddress) {
    let page = 1;
    const allNFTs = [];
    const limit = 1000;

    console.log(`Fetching NFTs for ${ownerAddress}...`);
    while (true) {
        try {
            const response = await helius.rpc.getAssetsByOwner({
                ownerAddress,
                page,
                limit,
                // 显示选项可以优化性能，只获取必要字段
                displayOptions: {
                    showUnverifiedCollections: false,
                    showCollectionMetadata: true,
                    showGrandTotal: true,
                },
            });

            const items = response.items;
            if (!items || items.length === 0) {
                break;
            }

            allNFTs.push(...items);
            console.log(`Fetched page ${page}, total so far: ${allNFTs.length}`);

            // 如果返回的数量小于 limit，说明是最后一页
            if (items.length < limit) {
                break;
            }
            page++;
        } catch (error) {
            console.error(`Error fetching page ${page}:`, error.message);
            break;
        }
    }

    // 处理结果
    console.log(`\nTotal NFTs found: ${allNFTs.length}`);
    allNFTs.forEach((nft, idx) => {
        const name = nft.content?.metadata?.name || 'Unnamed';
        const image = nft.content?.files?.[0]?.uri || 'No image';
        const collection = nft.grouping?.find(g => g.group_key === 'collection')?.group_value || 'Standalone';
        console.log(`${idx + 1}. ${name} | Collection: ${collection} | Image: ${image}`);
    });
}

// 使用示例
const walletAddress = '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM'; // 示例地址
getNFTsByOwner(walletAddress);

这个过程中，AI 不仅给出了代码，还注入了最佳实践（如分页处理、错误处理、性能优化建议），这是单纯看文档很难快速获得的。

4.2 场景二：分析与调试一笔复杂交易

链上交易有时像一团乱麻，特别是涉及多个合约交互、代币交换和 NFT 铸造时。手动解析交易日志非常耗时。

使用 MCP 工具直接对话： 你可以直接把交易签名（Signature）丢给 Claude：“帮我详细解析一下这笔交易 5VERv8...bdM ，重点看看它调用了哪些程序，资金流向了哪里，有没有错误？”

Claude 会调用 heliusTransaction 工具的 parseTransaction 动作。返回的结果会是结构化的摘要，包括：

交易概览 ：是否成功、时间戳、费用、主要操作类型（如 Token Swap, NFT Mint）。
程序调用栈 ：按顺序列出所有被调用的程序（Program）及其指令。
账户变更 ：哪些账户的 SOL 或 SPL 代币余额发生了变化，变化量是多少。
NFT 事件 ：是否有 NFT 的铸造、转移或买卖。
错误信息 ：如果失败，失败的原因是什么。

如果摘要信息不够，你可以接着说：“展开看看第一个 Token Swap 的详细输入输出。” Claude 会使用 expandResult 工具获取那部分的完整数据。这种交互方式让你能像专家一样层层深入，快速定位问题核心，而不是在海量的原始日志数据中迷失。

4.3 场景三：学习 Solana 虚拟机（SVM）内部原理

对于想深入理解 Solana 底层机制的学习者或研究者， /helius:svm 技能是一个宝藏。你可以问它一些非常深入的问题，例如：

“Solana 的账户模型与以太坊的账户模型有什么根本区别？”
“请解释一下 Sealevel 并行执行运行时是如何工作的？”
“PoH（历史证明）是如何作为时钟工作的？它如何与 Turbine 区块传播协议协同？”
“Token-2022 扩展相比旧的 SPL Token 标准引入了哪些关键新特性？”

/helius:svm 技能背后的知识库包含了 Solana 协议文档、研究论文（如 SIMD）、博客文章和源代码中的关键洞察。它能用相对易懂的语言解释复杂概念，并可能引用相关的源码文件或文档链接供你进一步查阅。这相当于你身边随时有一位 Solana 核心协议专家。

5. 进阶配置、问题排查与性能优化

当你开始重度依赖这些工具时，可能会遇到一些配置或性能上的问题。下面分享一些进阶技巧和常见坑点。

5.1 网络切换与多环境管理

默认情况下，工具都连接 Solana 主网（ mainnet-beta ）。但在开发阶段，你肯定需要在开发网（ devnet ）或测试网（ testnet ）上操作。

对于 CLI ：使用 helius config set-network devnet 全局切换。或者，在每个命令后加上 --network devnet 参数进行临时指定。
对于 MCP 服务器 ：通过设置 HELIUS_NETWORK 环境变量来控制。例如，在启动 Claude Desktop 前，在终端执行 export HELIUS_NETWORK=devnet 。你也可以在对话中让 AI 调用工具时指定网络参数（如果工具支持）。
对于技能/插件 ：其网络环境继承自底层 MCP 服务器的配置。

实操心得 ：建议为不同网络创建不同的 Helius 项目（Dashboard 中），并使用不同的 API Key。这样可以在配置中轻松切换，同时避免误操作。对于 CLI，你可以维护多个配置文件，通过 HELIUS_CONFIG_FILE 环境变量快速切换。

5.2 认证与 API Key 安全

API Key 是访问 Helius 服务的凭证，必须妥善保管。

永远不要将 API Key 硬编码在客户端或公开的代码仓库中 。对于前端应用，应通过自己的后端服务器中转请求。
使用环境变量 ：这是最推荐的方式。在项目根目录创建 .env 文件，写入 HELIUS_API_KEY=your_key_here ，然后在代码中通过 process.env.HELIUS_API_KEY 读取。记得将 .env 加入 .gitignore 。
利用 CLI 配置 ： helius config set-api-key 会将 Key 加密存储在当前用户目录下，相对安全。MCP 服务器也会读取这个配置。
定期轮换 Key ：在 Helius Dashboard 上，你可以随时生成新的 Key 并禁用旧的，以降低泄露风险。

5.3 常见问题与排查实录

即使工具设计得再完善，在实际使用中也会遇到各种问题。下面是一个快速排查指南：

问题现象	可能原因	解决方案
CLI 命令返回 `Invalid API Key`	1. API Key 未设置或错误。 2. Key 对应的项目已删除或禁用。 3. 网络不匹配（主网 Key 用于 devnet 请求）。	1. 运行 `helius config show` 确认 Key。 2. 登录 Dashboard 检查项目状态。 3. 确认 `helius config show` 中的网络设置。
MCP 服务器连接失败，或 Claude 提示“无法连接到工具”	1. `npx helius-mcp@latest` 安装或网络问题。 2. Claude Desktop 版本过旧，不支持 MCP。 3. 防火墙或代理阻止了本地连接。	1. 尝试在终端直接运行 `npx helius-mcp@latest` 看是否有错误。 2. 升级 Claude Desktop 到最新版。 3. 检查 `claude mcp list` 确认服务器状态。
AI 调用工具后返回的结果过于简略	触发了“摘要优先”模式。对于复杂查询，首次返回的是摘要。	明确告诉 AI：“请展开查看完整结果”或“我需要看所有交易列表的详情”。AI 会调用 `expandResult` 工具。
使用 `/helius:build` 技能时代码建议不准确	1. 问题描述不够清晰。 2. AI 的上下文可能包含了冲突信息。	1. 尽可能具体地描述需求，包括输入、预期输出、环境（Node.js 版本等）。 2. 尝试开启一个新的对话窗口，并首先激活技能，确保上下文干净。
交易发送失败或 Webhook 创建失败	1. 签名账户余额不足支付 Gas。 2. 交易模拟失败（指令有误）。 3. 网络拥堵，优先级费用不足。	1. 检查签名地址的 SOL 余额。 2. 先使用 `helius tx simulate` （如果 CLI 支持）或让 AI 通过工具模拟交易。 3. 使用 `helius priority-fee` 查询当前建议的优先级费用，并在发送交易时附加。

5.4 性能优化与最佳实践

批量请求 ：当需要查询大量数据时（如获取多个地址的余额），查看 SDK 或 API 是否支持批量操作。Helius 的某些端点支持批量查询，这比循环发起单个请求高效得多。
合理使用 WebSocket ：对于需要实时监控的数据（如特定地址的入账交易），不要用轮询（Polling），而是使用 helius-cli 的 WebSocket 订阅功能或通过 MCP 配置 Webhook。这可以极大减少请求次数并实现即时通知。
缓存策略 ：对于不经常变化的数据（如 NFT 的元数据、程序的静态信息），可以在你的应用层实现缓存，避免重复查询。
错误重试与降级 ：网络请求可能失败。在你的代码中，对于可重试的错误（如网络超时、5xx 状态码），实现指数退避的重试机制。对于非核心功能，考虑降级方案。
关注速率限制 ：虽然 Helius 的免费套餐限制也比较宽松，但在高并发场景下仍需注意。查看 Dashboard 的用量统计，根据需要考虑升级套餐。

6. 跨平台集成与自定义扩展

helius-core-ai 的设计考虑到了不同开发者和团队的工作流差异，因此提供了出色的跨平台支持和扩展能力。

6.1 在 Cursor、Codex CLI 等其他 AI 工具中使用

仓库的 SYSTEM-PROMPTS.md 文件详细说明了如何将 Helius 技能集成到其他平台。其核心思想是 “三层架构” ：

A层：运行时适配层 ：针对不同 AI 平台（Codex CLI, OpenAI API, Cursor Rules）的特定集成方式。
B层：技能层 ：存放在 helius-skills/ 目录下的 SKILL.md 文件，这是领域知识的唯一来源。
C层：用户任务 ：用户实际提出的问题。

例如，要在 Cursor 编辑器中使用，你可以将 helius-skills/helius/prompts/full.md 的内容复制到 Cursor 的 Rules 设置中。这样，Cursor 内置的 AI 助手就会具备 Helius 开发专家的知识。

对于 OpenAI API 或 Claude API 调用，你可以将对应的 prompt 文件（如 openai.developer.md 或 claude.system.md ）作为系统提示词（System Prompt）的一部分，从而让通用的模型具备特定的领域能力。

6.2 本地开发与自定义技能

如果你想贡献代码或基于此仓库进行二次开发，环境搭建很简单：

git clone https://github.com/helius-labs/core-ai.git
cd core-ai
cd helius-cli # 或 helius-mcp
pnpm install
pnpm dev # 进入开发监听模式

对于 helius-mcp ，你可以修改 src/ 目录下的工具实现，然后重新构建。要测试本地修改，可以用以下命令将其添加到 Claude：

cd helius-mcp
pnpm build
claude mcp add helius-local node $(pwd)/dist/index.js

创建自定义技能 ：如果你在某个细分领域（例如 DeFi 协议集成、游戏资产分析）有独特的知识，完全可以参照 helius-skills/ 下的模板，创建自己的 SKILL.md 。文件结构通常包括：

角色定义 ：让 AI 扮演什么专家。
核心能力 ：该专家擅长什么。
工作流程 ：面对问题时的一般思考步骤。
工具使用指南 ：如何正确使用 helius-mcp 提供的工具。
示例对话 ：提供几个高质量的问答示例。

然后，你可以通过 install.sh 脚本将其安装到你的 Claude Code 技能目录中，打造属于你个人的 AI 开发助手。

6.3 与现有开发工作流结合

这些 AI 工具不应完全替代传统的开发流程，而是作为强大的增强。我的典型工作流是：

构思与探索 ：使用 /helius:build 或直接与 Claude 对话，快速验证想法、获取代码片段、理解陌生协议。
实现与调试 ：在 IDE 中编写正式代码，遇到复杂交易解析或链上状态查询时，通过 CLI 或 MCP 快速获取信息，替代不断刷新区块浏览器的操作。
文档与学习 ：使用 /helius:svm 来深入理解遇到的技术概念，或者让 AI 帮我总结官方文档的要点。
自动化与监控 ：使用 helius-cli 编写脚本，自动化部署监控、数据拉取或定期报告任务。

这套工具链真正将区块链数据和服务变成了可编程、可对话的基础设施。它缩短了“想法”到“实现”的距离，尤其适合在快速迭代和探索性强的 Web3 开发领域。最大的体会是，它并没有试图用 AI 取代开发者，而是通过消除信息检索和基础代码编写的摩擦，让开发者能更专注于核心逻辑和创意本身。刚开始可能需要适应这种对话式的开发辅助，但一旦习惯，你会发现回不去了——就像从手动汇编调试升级到了拥有智能感知和自动补全的现代 IDE。