codedna

# CodeDNA — 自主 AI 生命体

CodeDNA 是 BNB Chain 上的 AI 生命演化实验。每个 Agent 是 NFT，有 DNA 性格，自主决策，自主行动。

**脚本目录**: 所有脚本在 `scripts/` 子目录下。执行时 `cd` 到 skill 目录或使用完整路径。

## 快速启动流程

当用户提到 CodeDNA、运行生命体、启动 Agent、codedna 时，按此流程执行：

### 步骤 0：安装依赖（首次）

```bash
cd <skill_directory>/scripts && npm install
```

⚠️ 只需首次运行一次。安装 ethers.js 链上交互库。

### 步骤 1：初始化

```bash
cd <skill_directory>/scripts && node setup.mjs
```

这会自动：
- 生成 Agent 专用钱包（保存到 `~/.codedna/wallet.json`，权限 600）
- 输出钱包地址
- 生成授权链接

**把授权链接发给用户**，告诉他们：
1. 点链接 → 打开 `codedna.org/auth` 授权页面
2. 连接持有 CodeDNA NFT 的钱包（MetaMask / OKX / Trust 等）
3. 页面自动识别持有的生命体，显示 DNA 属性和状态
4. 点"授权 AI Agent 控制此生命体" → 钱包签名（纯签名，不消耗 gas）
5. 授权成功后向 Agent 钱包转入 ≥ 0.01 BNB 作为 gas 费

授权页面会自动回调本地 OpenClaw，也会存入 localStorage 作为备份。

### 步骤 2：添加 Agent

用户完成授权后，添加要运行的 Agent Token ID：

```bash
# 添加单个 Agent
cd <skill_directory>/scripts && node setup.mjs add-token <tokenId>

# 添加多个 Agent（可重复执行）
node setup.mjs add-token 2
node setup.mjs add-token 3

# 移除某个 Agent
node setup.mjs remove-token <tokenId>

# 查看当前管理的 Agent 列表
node setup.mjs list
```

如果用户不知道 Token ID，帮他查：

```bash
cd <skill_directory>/scripts && node chain.mjs list <用户钱包地址>
```

⚠️ 多个 Agent 共用同一个 Agent 钱包，只需充一次 gas 费。

### 步骤 3：检查就绪状态

```bash
cd <skill_directory>/scripts && node setup.mjs status
```

输出 JSON，检查 `ready: true`。如果 `hasGas: false`，提醒用户转 BNB。

### 步骤 4：启动自主运行

```bash
cd <skill_directory>/scripts && node setup.mjs start
```

**就这一条命令。** setup 会自动：
- 检测是否安装了 PM2 → 有则用 PM2（崩溃自动重启）
- 没有 PM2 → 用 nohup 后台启动，PID 保存到 `~/.codedna/runner.pid`
- 自动读取 config.json 中已添加的 Agent 列表

**其他 R...