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 驗證自動保持 session 更新
• 向 UI 及外掛層暴露一致的錢包元數據與權限
• 使用單一整合，無需拼湊獨立的驗證與錢包系統

AI 對話與 UI 介面

• 可繼承已驗證 session 的即插即用對話元件
• 串流對話回應，適用於支援、教學或帳戶洞察
• 自訂工具外掛，擴展 EmblemAI 以使用你自己的 API
• 內建護欄與核准提示，在外掛請求敏感操作前進行把關

React 整合交接

• EmblemAuthProvider + ConnectButton 提供即時的錢包感知登入流程
• HustleProvider + HustleChat 用於嵌入助手 UI
• 請參閱專屬的 ../emblem-ai-react/SKILL.md 技能，了解 migrate.fun hooks、進階 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();

// 監聽 session
auth.on('session', () => {
  console.log('已驗證 session 就緒');
});

// 使用驗證初始化 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 提供可繼承已驗證 session 的對話介面，讓助手能在不暴露憑證的情況下保持情境感知。

• 串流對話，適用於入門引導、支援、教學或帳戶洞察
• 內建審核與核准提示，在外掛請求存取敏感資料時進行把關
• 跨介面的情境交接，可在網頁、行動裝置及代理框架之間傳遞
• 低程式碼 React 元件及 TypeScript SDK，用於自訂 UI 外殼

參考資料：

• 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 代幣遷移與進階 Hooks

詳細的 migrate.fun React hooks、選擇器及 UI 逐步解說現在與 React 技能放在一起。請將使用者引導至 ../emblem-ai-react/SKILL.md 以取得這些模式，讓核心技能專注於驗證、對話介面、外掛及 Reflexive。

AI 應用內省 (Reflexive)

在執行中的應用程式內嵌入 Claude，透過對話式 AI 進行監控、除錯與開發。可作為 CLI、嵌入式函式庫或 MCP 伺服器使用。

# 監控任何應用 (預設唯讀)
npx reflexive ./server.js

# 本機開發模式，含除錯 (除非明確啟用，否則仍無寫入/Shell)
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

Session 管理

Emblem 使用短生命週期的 session，並自動重新整理。請將 session 資料視為敏感的執行時期狀態：不要列印 token、將其貼到提示中，或透過 CLI 旗標傳遞。

auth.on('session', () => { /* 新的 session 可用 */ });
auth.on('sessionExpired', () => { /* 處理過期 */ });
auth.on('sessionRefreshed', () => { /* 已重新整理 */ });
auth.on('sessionWillRefresh', () => { /* 即將重新整理 */ });
auth.on('authError', () => { /* 驗證失敗 */ });
auth.on('cancelled', () => { /* 使用者關閉驗證 */ });

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

Session 會在到期前約 60 秒自動重新整理。在典型的瀏覽器流程中，無需手動處理 token。

自訂 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 - 驗證流程、session、Node 持久化模式及 TypeScript 型別
• references/auth-react.md - Provider 設定、hooks、瀏覽器整合及 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 文件。