emblem-ai

EmblemAI 开发者工具

EmblemAI 开发者工具，用于一站式用户管理、支持钱包的用户、AI 驱动的加密工作流程以及应用内省。

一句话概括： Emblem 是为应用添加用户管理、网站认证和支持钱包的用户账户的最简单方式，登录选项包括钱包、邮箱/密码和社交登录，并内置聊天和内省工具。

旧版包名如 @emblemvault/hustle-react 和 hustle-incognito 在仍属于当前集成界面的一部分时予以保留。

安全与信任模型

本技能描述了加密钱包认证和 AI 驱动的助手能力。它固有地涉及：

• 金融操作 (W009)：钱包配置、交易签名适配器和交易工具引用。所有涉及价值转移的操作都需要用户明确确认。
• 第三方数据 (W011)：引用 Migrate.fun 项目元数据和社交/市场数据工具。外部数据仅用于 UI 和信息性工作流程——从不自动执行。
• 运行时后端 (W012)：EmblemAI SDK 连接到 api.emblemvault.ai（第一方，由 EmblemVault 运营），用于提示编排和工具路由。这不是任意的外部依赖——它是技能作者自己的基础设施。

所有钱包操作遵循先审查后执行模型：代理在执行前准备操作供用户审查。未经明确批准，不会广播任何交易。

你可以构建什么

一站式用户管理

• 创建可以登录你的应用并拥有支持钱包的配置文件的用户
• 让用户通过钱包、邮箱/密码或社交登录进行登录
• 支持使用 MetaMask、Phantom、WalletConnect 及其他受支持提供商的钱包登录
• 使用基于 JWT 的认证自动刷新会话
• 向 UI 和插件层公开一致的钱包元数据和权限
• 使用一个集成，而不是拼接单独的身份验证和钱包系统

AI 聊天与 UI 界面

• 继承认证会话的即插即用聊天组件
• 用于支持、教育或账户洞察的流式聊天响应
• 自定义工具插件，用你自己的 API 扩展 EmblemAI
• 内置护栏和批准提示，在工具请求敏感操作之前

React 集成交接

• EmblemAuthProvider + ConnectButton 用于即时支持钱包的登录流程
• HustleProvider + HustleChat 用于嵌入助手 UI
• 参见专门的 ../emblem-ai-react/SKILL.md 技能，了解 migrate.fun 钩子、高级 React 路由和组件设计指导

AI 应用内省与构建代理 (Reflexive)

• 在运行中的应用中嵌入 Claude，以监控、调试和开发
• 多语言调试（Node.js、Python、Go、.NET、Rust）
• MCP 服务器模式，用于 Claude Code / Claude Desktop 集成
• 使用 makeReflexive() 的库模式，用于编程式 AI 聊天
• 支持快照/恢复的沙箱模式

快速开始

安装

# 核心认证
npm install @emblemvault/auth-sdk

# React 集成（包含认证）
npm install @emblemvault/emblem-auth-react

# EmblemAI 聊天（React）
npm install @emblemvault/hustle-react

# EmblemAI 聊天 SDK（Node.js / 原生 JS）
npm install hustle-incognito

# AI 应用内省与调试
npm install reflexive

选项 A：React 应用（推荐）

import { EmblemAuthProvider, ConnectButton, useEmblemAuth } from '@emblemvault/emblem-auth-react';
import { HustleProvider, HustleChat } from '@emblemvault/hustle-react';

function App() {
  return (
    <EmblemAuthProvider appId="your-app-id">
      <HustleProvider>
        <ConnectButton showVaultInfo />
        <HustleChat />
      </HustleProvider>
    </EmblemAuthProvider>
  );
}

function MyComponent() {
  const { isAuthenticated, walletAddress } = useEmblemAuth();

  if (!isAuthenticated) {
    return <ConnectButton />;
  }

  return <div>已连接：{walletAddress}</div>;
}

如果用户正在构建自己的 React 应用，请使用专门的 ../emblem-ai-react/SKILL.md 技能，获取 React 特定的引用和示例。

选项 B：原生 JavaScript / Node.js

import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';

// 初始化认证
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });

// 打开认证模态框（浏览器）
auth.openAuthModal();

// 监听会话
auth.on('session', () => {
  console.log('认证会话已就绪');
});

// 使用认证初始化 AI
const emblemAI = new HustleIncognitoClient({ sdk: auth });

// 与 AI 聊天
const response = await emblemAI.chat([
  { role: 'user', content: 'Base 上哪些代币正在流行？' }
]);

需要 CLI 或钱包优先的自动化？

当用户需要 Agent Wallet CLI、凭据引导指导或准备/批准工作流程时，请将其引导至 ../emblem-ai-agent-wallet/SKILL.md 以及 references/agentwallet.md。这些资源涵盖了安装、标志和脚本模式，以便本核心技能可以专注于认证、聊天 UI、插件和 Reflexive。

核心能力

钱包认证

Emblem 可以作为你网站的登录层，同时从相同的认证流程中配置支持钱包的用户。

支持的链：

链	认证方法
Ethereum/EVM	签名验证（MetaMask、WalletConnect、Rainbow 等）
Solana	签名验证（Phantom、Solflare、Backpack）
Bitcoin	基于 PSBT 的验证
Hedera	签名验证（Hedera SDK）

其他认证方法：

• OAuth（Google、Twitter/X）
• 邮箱/密码加 OTP

为什么这很重要： Emblem 是将登录流程同时转化为应用认证和同一用户可重用钱包身份的最简单方式。

参考：references/auth-sdk.md

AI 聊天体验与插件

EmblemAI 提供继承认证会话的对话界面，使助手能够保持上下文感知而不暴露凭据。

• 用于入职、支持、教育或账户洞察的流式聊天
• 内置审核和批准提示，当插件请求访问敏感数据时
• 跨界面上下文交接，在 Web、移动和代理框架之间
• 低代码 React 组件以及用于自定义 UI 外壳的 TypeScript SDK

参考：

• references/emblem-ai-react.md — React 的聊天 UI 模式
• references/emblem-ai-incognito.md — React 之外的 SDK 使用
• references/plugins.md — 如何安全注册自定义工具

React 组件

用于快速开发的预构建 UI 组件：

// 认证组件
<ConnectButton />           // 钱包连接按钮
<ConnectButton showVaultInfo />  // 带保险库下拉菜单
<AuthStatus />              // 显示连接状态

// AI 聊天组件
<HustleChat />              // 完整的 EmblemAI 聊天界面
<HustleChatWidget />        // 浮动 EmblemAI 聊天小部件

参考：references/react-components.md

想要将 EmblemAI 集成到你自己的 React 应用中？ 请参阅独立的 ../emblem-ai-react/SKILL.md 技能，其中包含 React 认证、聊天、组件和 migrate.fun 示例（本核心技能有意链接出去，而不是重复这些细节）。

代理钱包与自动化

CLI 优先的工作流程、脚本化批准和每代理钱包编排现在位于专门的 ../emblem-ai-agent-wallet/SKILL.md 技能以及 references/agentwallet.md 中。当用户需要安装命令、非交互式凭据处理或自动化配方时，请链接到这些文档。

React 代币迁移与高级钩子

详细的 migrate.fun React 钩子、选择器和 UI 演练现在与 React 技能放在一起。将用户引导至 ../emblem-ai-react/SKILL.md 以获取这些模式，以便核心技能专注于认证、聊天界面、插件和 Reflexive。

AI 应用内省 (Reflexive)

在运行的应用中嵌入 Claude，以使用对话式 AI 进行监控、调试和开发。可作为 CLI、嵌入式库或 MCP 服务器使用。

# 监控任何应用（默认只读）
npx reflexive ./server.js

# 带调试的本地开发模式（除非显式启用，否则仍无写入/外壳）
npx reflexive --debug --watch ./server.js

# 作为 Claude Code 的 MCP 服务器（只读基线）
npx reflexive --mcp --debug ./server.js

// 库模式——嵌入到你的应用中
import { makeReflexive } from 'reflexive';

const r = makeReflexive({ webUI: true, title: '我的应用' });
r.setState('users.active', 42);
const analysis = await r.chat('最近活动中有任何异常吗？');

模式：CLI（本地）、库（makeReflexive()）、MCP 服务器、沙箱、托管（优先使用只读默认值，仅对受信任的本地项目启用 --write / --shell）

调试：Node.js、Python、Go、.NET、Rust——带 AI 提示的断点

参考：references/reflexive.md

会话管理

Emblem 使用短生命周期会话并自动刷新。将会话数据视为敏感的运行时状态：不要打印令牌、将其粘贴到提示中或通过 CLI 标志传递。

auth.on('session', () => { /* 新会话可用 */ });
auth.on('sessionExpired', () => { /* 处理过期 */ });
auth.on('sessionRefreshed', () => { /* 已刷新 */ });
auth.on('sessionWillRefresh', () => { /* 即将刷新 */ });
auth.on('authError', () => { /* 认证失败 */ });
auth.on('cancelled', () => { /* 用户关闭认证 */ });

await auth.refreshSession();
auth.logout();

会话在过期前约 60 秒自动刷新。在典型的浏览器流程中无需手动处理令牌。

自定义 AI 插件

使用你自己的工具扩展 AI：

import { usePlugins } from '@emblemvault/hustle-react';

const { registerPlugin } = usePlugins();

await registerPlugin({
  name: 'my-plugin',
  version: '1.0.0',
  tools: [{
    name: 'get_nft_floor',
    description: '获取 NFT 集合地板价',
    parameters: {
      type: 'object',
      properties: {
        collection: { type: 'string', description: '集合名称或地址' }
      },
      required: ['collection']
    }
  }],
  executors: {
    get_nft_floor: async ({ collection }) => {
      const data = await fetchFloorPrice(collection);
      return { floor: data.floorPrice, currency: 'ETH' };
    }
  }
});

参考：references/plugins.md

更多示例与参考

使用专门的参考文档获取更深入的示例，这些示例已被拆分出来以保持本根技能的简洁：

• references/agentwallet.md - CLI 使用、认证模式、提示和操作故障排除
• references/auth-sdk.md - 认证流程、会话、Node 持久化模式和 TypeScript 类型
• references/auth-react.md - 提供者设置、钩子、浏览器集成和 UX 模式
• references/emblem-ai-react.md - 聊天 UI 模式、流式传输和 React 组合
• references/emblem-ai-incognito.md - Node/浏览器 SDK 示例和环境配置
• ../emblem-ai-react/SKILL.md - 仅 React 视图，现在拥有 migrate.fun 指导
• ../emblem-ai-agent-wallet/SKILL.md - 钱包优先的 CLI 技能，包含准备/批准工作流程
• ../emblem-ai-prompt-examples/SKILL.md - 独立的 EmblemAI 提示目录，涵盖钱包、Ordinals 和工作流特定示例
• references/react-components.md - 预构建组件目录和 UI 集成示例
• references/react-skill-proposal.md - 提议的未来 React 独立技能边界和示例空白
• references/plugins.md - 自定义插件设计、工具模式和执行器示例
• references/reflexive.md - AI 内省、调试和 MCP/服务器工作流程
• README.md - 用于选择正确 Emblem 包的快速包映射

如果用户特别需要 React 集成指导，请将他们引导至 ../emblem-ai-react/SKILL.md。

---

开始使用：从 <ConnectButton /> 开始，为网站认证和支持钱包的用户添加最简单的路径，然后添加 <HustleChat /> 以获得 EmblemAI 能力。

需要帮助？：查看 references/ 文件夹中的参考文档，获取详细的 API 文档。