psychosynth

Psychosynth

Psychosynth 是一个面向 Agent、基于链上的心理测量数据市场。它为自主系统提供高方差、经人工整理的人格档案，以及以档案为条件的行为响应。使用 x402 微支付协议，在 Base 上通过 USDC 按查询结算交易——完全无需人工中介。

---

系统架构

graph TD
    A["Generator OS (DB Templates)"] --> B["LLM Synthesis (Flash/Sonnet)"]
    B --> C["Hooks Pipeline (validation & dedup)"]
    C --> D["Curation Queue (Review Desk)"]
    D --> E["Supabase DB Store"]
    E --> F["x402 Proxy Middleware (Base)"]
    F --> G["JSON API / MCP Server"]
    G --> H["Autonomous Agents (Eliza, OpenClaw, Hermes)"]

---

核心功能

1. v2 心理测量引擎

标准大模型存在“平均模型偏差”，在游戏和模拟中会生成同质化、风险中性的响应。Psychosynth 通过提供结构化、高方差的数据集来解决这一问题，其中包含：

• 五因素模型（OCEAN）：开放性、尽责性、外向性、宜人性、神经质。
• 黑暗三联征特质：马基雅维利主义、自恋和精神病态。
• 前景理论倾向：损失厌恶系数（$\lambda$），以及收益（$\alpha$）和损失（$\beta$）的幂效用指数。
• 认知反思：系统 1（由启发式驱动）与系统 2（逻辑／审慎）的偏好，以及认知反思测试（CRT）得分。

2. 面向 Agent 的支付（x402）

交易使用 x402 标准在 Base 区块链上按查询结算：

• 免 Gas 结算：Agent 使用其 EVM 钱包，以 USDC 签署免 Gas 的 TransferWithAuthorization 载荷（EIP-3009）。
• 代理中间件：后端验证签名，在链上广播结算，并通过单个 HTTP 请求循环交付所请求的数据集。

3. 模型上下文协议（MCP）服务

Psychosynth 提供 MCP 服务，可直接连接自主 Agent 运行时。

• 支持的框架：ElizaOS、OpenClaw（通过 MCPorter）、Nous Research 的 Hermes Agent，以及 Virtuals Protocol（通过 G.A.M.E. SDK 自定义操作）。
• 提供的工具：
  • list_products：发现可用产品、架构和定价。
  • preview_records：获取免费的确定性样本，以验证架构结构。
  • get_quote：请求 x402 支付报价，但不执行交易。
  • query_records：执行链上支付并检索完整数据载荷。

4. 交互式 Lab OS 游乐场

Psychosynth 在 /playground 提供超高端暗色奢华风格的金融仪表板，供人类交互和调试：

• 实时雷达图：动态 SVG 蜘蛛图显示 8 个心理测量维度（OCEAN、黑暗三联征、前景理论），并随参数变化即时更新。
• 全息 Agent 身份卡：生成精美、可分享的玻璃拟态身份卡，自动分类人格原型，并支持一键直接分享到 Twitter。
• 多 Agent 对决竞技场：实时模拟场景中，两个拥有不同档案的 Agent（例如 Solana 投机者与风险规避型机构）就一笔交易进行协商，同时实时流式呈现系统 1／2 推理过程。
• x402 协议检查器：分步交互式终端，可视化 HTTP 402 支付质询、EIP-712 签名、Base 结算服务方结算和载荷解密过程。

---

设置与安装

先决条件

• Node.js >= 18
• Supabase CLI（可选，用于本地数据库开发）

快速开始

1. 克隆代码库并安装依赖：

   git clone https://github.com/3esign/psychosynth.git
   cd psychosynth
   npm install
   

2. 配置环境变量：

   cp .env.example .env
   # Fill in Supabase keys, X402 payout address, and keys.
   

3. 部署 Supabase 迁移并填充种子数据：

   npx supabase db push
   # Seeds the base schema and version 2 generators
   

4. 启动 Next.js 开发服务器：

   npm run dev
   

---

MCP 服务配置

构建 MCP 服务（在 mcp/ 中运行 npm run build），然后将以下条目添加到 MCP 客户端配置（例如 claude_desktop_config.json）中，以便向 Agent 注册。 使用你机器上已构建服务的绝对路径：

{
  "mcpServers": {
    "psychosynth": {
      "command": "node",
      "args": ["/absolute/path/to/psychosynth/mcp/dist/index.js"],
      "env": {
        "PSYCHOSYNTH_API_URL": "https://psychosynth.vercel.app",
        "BUYER_PRIVATE_KEY": "0xYourBuyerWalletPrivateKey",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

---

CLI 和脚本

• npm run typecheck — 运行 TypeScript 编译器检查，不生成文件。
• npm run buyer-test — 针对运行中的实例模拟端到端付费查询。
• npm run export:sft | export:dpo | export:reject-cls — 将筛选数据导出为训练格式。

---

文档

完整的架构规范、总体规划和开发日志位于 docs/ 文件夹中：

• MASTERPLAN.md — 产品愿景和经济结构。
• DISCOVERY.md — 特定框架的 Agent 集成详情。
• DEVELOPMENT.md — 详细的工程规范和数据库架构设计。

---

生态系统和平台集成

1. Faces Wallet MCP（Buzz by Block 和 ACP 原生集成）

Psychosynth 通过 Faces Wallet MCP server 直接连接 Buzz by Block Agent（Goose、Codex、Claude Code）。Buzz 工作区中的 Agent 使用其链上 Base 钱包，通过 x402_fetch 自主结算心理测量数据查询。

• 代码库：https://github.com/3esign/Faces-Wallet-MCP
• 功能：任何 Buzz Agent 都可以加载 Faces MCP 服务、检查余额，并查询 Psychosynth 端点；在设定的支出上限内，通过自动化的 EIP-3009 免 gas USDC 结算完成支付。

2. Bankr 生态系统（原生支持 x402）

Psychosynth 使用标准 x402：Agent 在 Base 上签署免 gas 的 USDC EIP-3009 TransferWithAuthorization，然后由服务通过 x402 facilitator 结算（facilitator 负责广播交易并支付 gas）。Bankr 平台钱包、x402-fetch 和大多数 Agent 钱包层都会自动生成这种支付形式。也支持自行结算的 txHash 付款（Base 或 Solana），作为备用方案。

• Agent 免费预检：GET /api/v1/discovery — 一次调用即可获取产品、实时价格、层级、payTo 和结算方式。
• Bankr 技能：BankrBot/skills 目录的提交包位于 integrations/bankr-skills/psychosynth/（SKILL.md + catalog.json + logo + references + scripts）。合并后，它会显示在 skills.bankr.bot 上，并可通过以下命令安装：install the psychosynth skill from https://github.com/BankrBot/skills/tree/main/psychosynth。
• 定位：该生态系统中现有的智能技能会分析代币；Psychosynth 出售合成的行为数据——关于市场参与者行为的先验信息，可用于交易模拟、交易对手建模和 Agent 压力测试。

2. Virtuals Protocol（G.A.M.E. SDK 自定义操作）

运行 G.A.M.E. Framework 的 Virtuals Protocol Agent 无需注册配置文件或托管额外的工作进程，即可原生查询 Psychosynth。

• 操作架构：将我们的查询端点映射到 G.A.M.E. 自定义操作。Agent 会根据自身的运行循环确定所需数据。
• 动态支付：Agent 构造并签署免 gas 的 EVM TransferWithAuthorization 负载（EIP-3009），以支付查询费用。
• 无缝 HTTP 解析：Agent 的工具执行脚本会将负载直接 POST/GET 到我们的 Vercel API 端点。我们验证并结算交易，并在同一个响应块中返回记录。有关架构负载和代码模板，请参阅 API 文档。