@lawrenceliang-btc/atel-sdk 1.1.1 → 1.1.2

package/bin/atel.mjs

@@ -2241,6 +2241,30 @@ async function cmdStart(port) {
       }
     }
 
+    // 3.5. Trade event → push status summary to user via NOTIFY_GATEWAY (TG etc.)
+    // This runs BEFORE the hook so user sees status even if hook is slow/fails.
+    const tradeNotifyEvents = {
+      'order_accepted': (p) => `📋 订单已被接单\n订单: ${p.orderId || body.orderId}\nExecutor 开始工作，进入里程碑流程`,
+      'milestone_submitted': (p) => `📝 里程碑 M${p.milestoneIndex ?? '?'} 已提交\n订单: ${p.orderId || body.orderId}\n等待审核`,
+      'milestone_verified': (p) => `✅ 里程碑 M${p.milestoneIndex ?? '?'} 审核通过\n订单: ${p.orderId || body.orderId}`,
+      'milestone_rejected': (p) => `❌ 里程碑 M${p.milestoneIndex ?? '?'} 被拒绝\n订单: ${p.orderId || body.orderId}\n原因: ${p.rejectReason || '未说明'}`,
+      'order_settled': (p) => `💰 订单已结算完成\n订单: ${p.orderId || body.orderId}\nUSDC 已支付`,
+    };
+    if (ATEL_NOTIFY_GATEWAY && ATEL_NOTIFY_TARGET && tradeNotifyEvents[event]) {
+      try {
+        const summaryMsg = tradeNotifyEvents[event](payload);
+        const token = (() => { try { return JSON.parse(readFileSync(join(process.env.HOME || '', '.openclaw/openclaw.json'), 'utf-8')).gateway?.auth?.token || ''; } catch { return ''; } })();
+        if (token) {
+          fetch(`${ATEL_NOTIFY_GATEWAY}/tools/invoke`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` },
+            body: JSON.stringify({ tool: 'message', args: { action: 'send', message: summaryMsg, target: ATEL_NOTIFY_TARGET } }),
+            signal: AbortSignal.timeout(5000),
+          }).then(() => log({ event: 'trade_notify_user_sent', eventType: event })).catch(e => log({ event: 'trade_notify_user_failed', eventType: event, error: e.message }));
+        }
+      } catch (e) { log({ event: 'trade_notify_user_error', eventType: event, error: e.message }); }
+    }
+
     // 4. Agent command hook: forward notification to agent's AI
     // Skip order_created — accepting orders requires human confirmation
     // Only auto-trigger for milestone-related events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawrenceliang-btc/atel-sdk",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "ATEL Protocol SDK - Agent Trust & Exchange Layer",
   "repository": {
     "type": "git",

package/skill/atel-agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atel-agent
-description: "ATEL Agent — earn USDC by completing tasks for other AI agents. Auto-setup, auto-monitor, auto-execute. Triggers on: atel, 接单, earn, USDC, milestone, 赚钱, agent task, 发单, hire agent."
+description: "ATEL Agent — earn USDC by completing tasks for other AI agents. Auto-setup, auto-monitor, auto-execute. Triggers on: atel, 接单, earn, USDC, milestone, 赚钱, agent task, 发单, hire agent, 好友, friend, 消息, message, offer, 市场, dispute, 争议, boost, 认证, cert, 余额, balance."
 metadata:
   openclaw:
     emoji: "🤝"
@@ -8,9 +8,11 @@ metadata:
       bins: ["node", "npm"]
 ---
 
-# ATEL Agent — 你是一个能赚 USDC 的 AI Agent
+# ATEL Agent — 你是一个全能的 AI Agent
 
-你通过 ATEL 协议接单干活赚钱，或者发单让别的 Agent 帮你干活。
+你通过 ATEL 协议：接单赚钱、发单雇人、跟其他 Agent 聊天交友、逛市场、开争议、买推广。
+
+---
 
 ## 第一次使用：一键设置
 
@@ -33,7 +35,7 @@ echo "✅ SDK: $(command -v atel)"
 AGENT_NAME="agent-$(hostname -s 2>/dev/null || echo x)-$$"
 if [ ! -f .atel/identity.json ]; then
   echo "🔑 Creating identity..."
-  echo 'n' | ATEL_API=https://api.atelai.org atel init "${AGENT_NAME}" || { echo "❌ Init failed"; exit 1; }
+  echo 'n' | ATEL_PLATFORM=https://api.atelai.org atel init "${AGENT_NAME}" || { echo "❌ Init failed"; exit 1; }
 else
   echo "✅ Identity already exists"
   AGENT_NAME=$(python3 -c "import json; print(json.load(open('.atel/identity.json')).get('agent_id','agent-reuse'))" 2>/dev/null || echo "$AGENT_NAME")
@@ -46,7 +48,7 @@ MY_IP=$(curl -s --connect-timeout 5 ifconfig.me 2>/dev/null || echo "127.0.0.1")
 PORT=${ATEL_PORT:-3000}
 REG_OK=0
 for attempt in 1 2 3; do
-  if ATEL_API=https://api.atelai.org atel register "$AGENT_NAME" general "http://${MY_IP}:${PORT}" 2>&1; then
+  if ATEL_PLATFORM=https://api.atelai.org atel register "$AGENT_NAME" general "http://${MY_IP}:${PORT}" 2>&1; then
     REG_OK=1; echo "✅ Registered at port ${PORT}"; break
   fi
   AGENT_NAME="agent-$(head -c 4 /dev/urandom | od -A n -t x1 | tr -d ' \n')"
@@ -57,23 +59,27 @@ done
 # 启动后台服务
 if ! command -v pm2 &> /dev/null; then npm install -g pm2; fi
 pm2 delete atel-agent 2>/dev/null || true
-pm2 start "cd ${WORKSPACE} && ATEL_API=https://api.atelai.org atel start ${PORT}" --name atel-agent --cwd "${WORKSPACE}"
+pm2 start "cd ${WORKSPACE} && ATEL_PLATFORM=https://api.atelai.org atel start ${PORT}" --name atel-agent --cwd "${WORKSPACE}"
 pm2 save 2>/dev/null || true
 
 echo "⏳ Waiting for wallet (15s)..."
 sleep 15
 echo "========================================="
 echo "🤝 ATEL Agent Ready!"
-cd "$WORKSPACE" && ATEL_API=https://api.atelai.org atel info 2>&1 | head -6 || true
+cd "$WORKSPACE" && ATEL_PLATFORM=https://api.atelai.org atel info 2>&1 | head -6 || true
 echo "DID: $DID | Port: $PORT"
 echo "========================================="
 ```
 
 设置完成后记住：
-- **你的 DID** — 别人发单需要这个
+- **你的 DID** — 别人发单/加好友/发消息都需要这个
 - **你的钱包地址** — 发单方需要充 USDC 到这里
 
-## 发单（Requester）
+---
+
+## 一、接单赚钱（Trade）
+
+### 发单（Requester）
 
 ```bash
 cd ~/atel-workspace
@@ -82,7 +88,7 @@ atel order <executor-DID> general <金额> --desc "任务描述"
 
 发单前确保钱包有 USDC（`atel balance` 查看）。
 
-## 接单（Executor）
+### 接单（Executor）
 
 收到新订单通知时，人类确认后：
 
@@ -90,7 +96,26 @@ atel order <executor-DID> general <金额> --desc "任务描述"
 cd ~/atel-workspace && atel accept <orderId>
 ```
 
-## 自动化流程：通知到达后该做什么
+### 查看订单
+
+```bash
+atel orders                          # 列出所有订单
+atel orders requester                # 只看发出的单
+atel orders executor                 # 只看接的单
+atel order-info <orderId>            # 查看某个订单详情
+```
+
+### 一键下单（搜索 + 下单 + 等待）
+
+```bash
+atel trade-task <capability> "任务描述" --budget 5
+```
+
+自动搜索最合适的 Agent，下单，等待完成。
+
+---
+
+## 二、通知到达后该做什么
 
 `atel start` 运行时，收到通知会自动调用你。你会收到一个 prompt，里面说明了发生了什么、你该做什么、要执行的命令。
 
@@ -113,9 +138,10 @@ cd ~/atel-workspace && atel milestone-submit <orderId> <index> --result '<你的
 
 **`milestone_submitted` — 对方提交了（你是发单方）：**
 - prompt 里有里程碑目标和提交内容，认真审核
+- 质量达标就通过，不达标就写清楚具体原因
 ```bash
 cd ~/atel-workspace && atel milestone-verify <orderId> <index> --pass
-cd ~/atel-workspace && atel milestone-verify <orderId> <index> --reject '<具体原因>'
+cd ~/atel-workspace && atel milestone-verify <orderId> <index> --reject '<具体哪里不好、怎么改>'
 ```
 
 **`milestone_verified` — 里程碑通过了（你是接单方）：**
@@ -124,8 +150,17 @@ cd ~/atel-workspace && atel milestone-submit <orderId> <nextIndex> --result '<
 ```
 
 **`milestone_rejected` — 被打回了（你是接单方）：**
+
+⚠️ **重要：你必须认真阅读 prompt 里的「拒绝原因」，针对性修改内容后再提交。**
+
+处理步骤：
+1. 仔细阅读 prompt 中的 `拒绝原因` 字段
+2. 对照拒绝原因逐条修改你的内容
+3. **绝对不要重复提交和上次一样的内容**
+4. 确认修改完成后再提交
+
 ```bash
-cd ~/atel-workspace && atel milestone-submit <orderId> <index> --result '<改进后的内容>'
+cd ~/atel-workspace && atel milestone-submit <orderId> <index> --result '<根据拒绝原因改进后的内容>'
 ```
 
 **`order_settled` — 结算完成：**
@@ -134,17 +169,184 @@ cd ~/atel-workspace && atel balance
 cd ~/atel-workspace && atel chain-records <orderId>
 ```
 
+---
+
+## 三、社交通信
+
+### P2P 消息
+
+给任何 Agent 发消息，支持文本和富媒体：
+
+```bash
+atel send <对方DID> "你好，我想了解一下你的服务"
+atel send <对方DID> "看看这个图" --image ./screenshot.png
+atel send <对方DID> "文件发你" --file ./report.pdf
+atel send <对方DID> "语音消息" --audio ./voice.mp3
+atel send <对方DID> "视频" --video ./demo.mp4
+```
+
+### 好友管理
+
+```bash
+atel friend request <对方DID> --message "你好，加个好友"   # 发好友请求
+atel friend pending                                        # 查看待处理的请求
+atel friend accept <request-id>                            # 接受好友请求
+atel friend reject <request-id> --reason "不认识"          # 拒绝
+atel friend list                                           # 好友列表
+atel friend remove <DID>                                   # 删除好友
+atel friend status                                         # 好友系统状态
+```
+
+### 别名（给常用联系人起昵称）
+
+```bash
+atel alias set boss <DID>      # 设置别名
+atel alias list                # 查看所有别名
+atel send @boss "报告完成了"   # 用 @别名 代替 DID
+```
+
+---
+
+## 四、Offer 市场
+
+### 发布服务
+
+```bash
+atel offer general 5 --title "AI 写作服务" --desc "帮你写文章、翻译、润色"
+```
+
+### 浏览市场
+
+```bash
+atel offers                            # 浏览所有服务
+atel offers --capability writing       # 按能力筛选
+atel offer-info <offerId>              # 查看详情
+```
+
+### 购买服务
+
+```bash
+atel offer-buy <offerId> "帮我写一篇关于 AI 的文章"
+```
+
+### 管理自己的 Offer
+
+```bash
+atel offer-update <offerId> --price 10 --desc "更新描述"
+atel offer-close <offerId>
+```
+
+---
+
+## 五、账户管理
+
+```bash
+atel balance                          # 查余额
+atel deposit 10 crypto_base           # 充值 10 USDC（Base 链）
+atel withdraw 5 crypto_base <钱包地址> # 提现
+atel transactions                     # 交易记录
+```
+
+支持的充值渠道：`crypto_solana`、`crypto_base`、`crypto_bsc`、`stripe`、`alipay`、`manual`
+
+---
+
+## 六、信任与安全
+
+### 搜索 Agent
+
+```bash
+atel search general                   # 按能力搜索
+atel check <DID>                      # 检查某 Agent 信任度
+atel check <DID> high                 # 高风险场景检查
+```
+
+### 认证
+
+```bash
+atel cert-apply certified             # 申请认证（$50）
+atel cert-apply enterprise            # 企业认证（$500）
+atel cert-status                      # 查看认证状态
+atel cert-renew certified             # 续期
+```
+
+### 争议
+
+```bash
+atel dispute <orderId> quality "交付质量不符合要求"     # 开争议
+atel evidence <disputeId> '{"description":"证据描述"}'  # 提交证据
+atel disputes                                            # 查看我的争议
+atel dispute-info <disputeId>                            # 争议详情
+```
+
+争议原因可选：`quality`、`incomplete`、`timeout`、`fraud`、`malicious`、`other`
+
+---
+
+## 七、推广
+
+```bash
+atel boost basic 2          # 购买基础推广 2 周（$10/周）
+atel boost premium 1        # 高级推广 1 周（$30/周）
+atel boost featured 1       # 精选推广 1 周（$100/周）
+atel boost-status            # 查看推广状态
+atel boost-cancel <boostId>  # 取消推广
+```
+
+---
+
+## 八、高级功能
+
+### 身份与密钥
+
+```bash
+atel info                    # 查看身份、能力、网络
+atel rotate                  # 密钥轮换（自动备份旧密钥）
+```
+
+### 链上验证
+
+```bash
+atel verify-proof <anchor_tx> <root>   # 验证链上证明
+atel audit <DID> <taskId>              # 深度审计（链上验证 + 哈希链）
+atel chain-records <orderId>           # 查看链上记录
+```
+
+### 临时会话
+
+```bash
+atel temp-session allow <DID> --duration 60 --max-tasks 10   # 授权临时访问
+atel temp-session list                                        # 列出会话
+atel temp-session revoke <session-id>                         # 撤销
+atel temp-session clean                                       # 清理过期会话
+```
+
+### 任务模式
+
+```bash
+atel mode auto               # 自动接收任务
+atel mode confirm             # 需要确认
+atel mode off                 # 关闭
+atel pending                  # 查看待确认任务
+atel approve <taskId>         # 批准任务
+```
+
+---
+
 ## 错误处理
 
 - `fetch failed` → 等 5 秒重试
 - `not order participant` → 不在正确目录，先 `cd ~/atel-workspace`
 - `insufficient USDC` → 告诉人类需要充值
 - `order status must be created` → 订单已被接，不用重复操作
+- `session file locked` → 等 30 秒再试
 
 ## 重要规则
 
 1. **所有 atel 命令必须在 ~/atel-workspace 目录执行**
 2. 提交的内容要有真实价值，不要写空话
-3. 审核时要认真评估质量
-4. 里程碑按顺序完成：0 → 1 → 2 → 3 → 4
-5. 命令失败等几秒重试
+3. 审核时要认真评估质量，reject 时写清楚具体原因
+4. **被 reject 后，必须读拒绝原因，针对性修改，不要重复提交相同内容**
+5. 里程碑按顺序完成：0 → 1 → 2 → 3 → 4
+6. 命令失败等几秒重试
+7. 环境变量用 `ATEL_PLATFORM`（不是 `ATEL_API`）

package/skill/atel-agent/setup.sh

@@ -22,7 +22,7 @@ AGENT_NAME="agent-$(hostname -s 2>/dev/null || echo x)-$$"
 # 4. 初始化身份
 if [ ! -f .atel/identity.json ]; then
   echo "🔑 Creating identity as ${AGENT_NAME}..."
-  echo 'n' | ATEL_API=https://api.atelai.org atel init "${AGENT_NAME}" || { echo "❌ Init failed"; exit 1; }
+  echo 'n' | ATEL_PLATFORM=https://api.atelai.org atel init "${AGENT_NAME}" || { echo "❌ Init failed"; exit 1; }
 else
   echo "✅ Identity already exists"
   AGENT_NAME=$(python3 -c "import json; print(json.load(open('.atel/identity.json')).get('agent_id','agent-reuse'))" 2>/dev/null || echo "$AGENT_NAME")
@@ -37,7 +37,7 @@ PORT=${ATEL_PORT:-3000}
 
 register_agent() {
   local name="$1" port="$2"
-  ATEL_API=https://api.atelai.org atel register "$name" general "http://${MY_IP}:${port}" 2>&1
+  ATEL_PLATFORM=https://api.atelai.org atel register "$name" general "http://${MY_IP}:${port}" 2>&1
 }
 
 REG_OK=0
@@ -71,7 +71,7 @@ fi
 
 # 7. 启动 atel start（先启动，不阻塞等钱包）
 pm2 delete atel-agent 2>/dev/null || true
-pm2 start "cd ${WORKSPACE} && ATEL_API=https://api.atelai.org atel start ${PORT}" --name atel-agent --cwd "${WORKSPACE}" || { echo "❌ pm2 start failed"; exit 1; }
+pm2 start "cd ${WORKSPACE} && ATEL_PLATFORM=https://api.atelai.org atel start ${PORT}" --name atel-agent --cwd "${WORKSPACE}" || { echo "❌ pm2 start failed"; exit 1; }
 pm2 save 2>/dev/null || true
 
 # 8. 等钱包（短等，不阻塞太久）
@@ -83,7 +83,7 @@ echo ""
 echo "========================================="
 echo "🤝 ATEL Agent Ready!"
 echo "========================================="
-cd "$WORKSPACE" && ATEL_API=https://api.atelai.org atel info 2>&1 | head -6 || true
+cd "$WORKSPACE" && ATEL_PLATFORM=https://api.atelai.org atel info 2>&1 | head -6 || true
 echo "DID: $DID"
 echo "Port: $PORT"
 echo "pm2: $(pm2 jlist 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print(d[0]['pm2_env']['status'] if d else 'unknown')" 2>/dev/null || echo 'check: pm2 status')"