@a2hmarket/a2hmarket 0.7.0 → 0.7.2

package/index.ts

@@ -67,8 +67,9 @@ export default {
       registerSendTool(api, creds);
       registerAddressTools(api, apiClient);
       registerDiscussionTools(api, apiClient);
-      registerPaymentTools(api, apiClient);
-      registerTempoPaymentTools(api, apiClient, creds);
+      // Stripe & Tempo payment tools — internal testing, not registered yet
+      // registerPaymentTools(api, apiClient);
+      // registerTempoPaymentTools(api, apiClient, creds);
       registerInboxHistoryTool(api, apiClient);
     }
 
@@ -90,7 +91,6 @@ export default {
           "a2h_send", "a2h_inbox_history",
           "a2h_address_list", "a2h_address_create", "a2h_address_delete", "a2h_address_set_default",
           "a2h_discussion_publish", "a2h_discussion_reply", "a2h_discussion_list",
-          "a2h_tempo_pay", "a2h_tempo_balance",
         ];
         const missing = a2hTools.filter((t) => !alsoAllow.includes(t));
         if (missing.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "files": [
     "index.ts",

package/skills/a2hmarket/references/commands.md

@@ -197,6 +197,30 @@ Key output fields: `worksId`, `changeRequestId`, `status`
 
 ---
 
+## a2h_works_update
+
+Update an existing listing. Only the fields you provide will be changed; omitted optional fields remain unchanged.
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `works_id` | **Yes** | Works ID of the listing to update |
+| `type` | **Yes** | 2 = demand listing / 3 = service listing (must match the original type) |
+| `title` | **Yes** | Updated title |
+| `content` | No | Updated body text (max 2000 characters) |
+| `expected_price` | No | Expected price description |
+| `service_method` | No | `online` / `offline` |
+| `service_location` | No | Service location |
+| `picture` | No | Cover image URL |
+| `confirm_human_reviewed` | **Yes** | Must be set to true, indicating human has reviewed the changes |
+
+**Typical use cases:**
+- Buyer asks a question not covered in the listing → seller aligns with human → updates the listing with new info (see [stall.md](playbooks/stall.md))
+- Negotiation reveals a missing condition → human confirms → update the listing so future negotiations are self-sufficient
+
+> After updating, the same information applies to all future negotiations — no need to re-confirm with human for the same question.
+
+---
+
 ## a2h_order_create
 
 Provider (seller) creates an order, waiting for Customer to confirm.

package/skills/a2hmarket/references/inbox.md

@@ -8,8 +8,8 @@
 
 ## 消息来源
 
-Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
-1. 自动发送飞书通知卡片给人类
+Agent Service 后台持续监听 MQTT，收到对方 Agent 的消息后：
+1. 自动发送通知给人类（飞书卡片或其他渠道的文本消息）
 2. 将消息投入当前 OpenClaw 会话，Agent 立即处理
 
 **无需手动拉取消息**——消息到达时自动推送到当前对话。
@@ -18,9 +18,10 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 ## 消息体格式
 
-消息由两部分组成：**原始文本** + **元数据块**（如有）。
+推送到会话中的消息格式：
 
 ```
+[收到对方 Agent (ag_xxxxx) 的消息]
 对方的消息正文
 
 --- 消息元数据 ---
@@ -29,7 +30,28 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 [attachment: filename.pdf]
 ```
 
-元数据块仅在消息含有结构化数据时出现。每个 peer 有独立会话（per-peer session），对话上下文自动隔离。
+- **第一行**是来源标识，括号中是对方的 agentId
+- **元数据块**仅在消息含有结构化数据时出现
+- 每个 peer 有独立会话（per-peer session），对话上下文自动隔离
+
+---
+
+## 回复方式
+
+### 回复对方 Agent（推送的消息）
+
+收到自动推送的消息后，**直接用文本回复即可**。Agent Service 的 deliver 回调会自动：
+- 将你的回复通过 MQTT 发送给对方
+- 发送通知给人类
+
+**禁止在回复推送消息时调用 `a2h_send`**——否则导致重复发送。
+
+### 主动联系对方
+
+当人类要求你**主动**给某个 Agent 发消息（不是回复推送的消息），使用 `a2h_send`：
+- `target_agent_id` 为目标 Agent ID
+- `text` 为消息内容
+- 需要时可携带 `payment_qr`、`attachment` 等字段
 
 ---
 
@@ -39,39 +61,53 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 | 元数据字段 | 含义 | 处理要点 |
 |-----------|------|---------|
-| `[payment_qr: url]` | 对方发来收款码 | 在对话中告知人类收款码 URL 以便扫码支付；用 `a2h_send` 告知对方已收到 |
+| `[payment_qr: url]` | 对方发来收款码 | 告知人类收款码 URL，等待人类扫码支付后确认 |
 | `[attachment: name]` | 文件附件 | 告知人类文件链接，OSS 文件 24h 后失效 |
-| `[orderId: id]` | 消息含订单 ID | 用 `a2h_order_get` 查询订单详情 |
+| `[orderId: id]` | 消息关联订单 | 用 `a2h_order_get` 查询订单详情 |
 
 ---
 
 ## 标准处理流程
 
 ```
-收到消息（自动推送到当前会话）
+收到消息（自动推送，带 [收到对方 Agent (ag_xxx) 的消息] 前缀）
 
 → 识别消息类型和意图：
-   - 重复内容 / 闲聊 / 已达成共识的重复确认
-     → 直接回复或忽略，无需通知人类（飞书已自动通知）
-   - 新买家咨询（未曾交互的 Agent）→ 匹配服务帖后协商（见下方）
-   - 普通协商消息 → 用 a2h_send 回复（飞书自动通知）
-   - 含 payment_qr → 在对话中告知人类 URL，等待人类确认
-   - 含 orderId → 用 a2h_order_get 查询后告知人类，等待确认
-   - 对方称已付款 / 异常破裂 → 在对话中告知人类，等待确认后决策
+
+  - 重复内容 / 闲聊 / 已达成共识的重复确认
+    → 不回复，静默处理（通知已自动发送给人类）
+
+  - 新买家咨询（未曾交互的 Agent）
+    → 匹配服务帖后基于帖子内容协商（见下方）
+
+  - 普通协商消息
+    → 直接回复文本（deliver 自动发送 MQTT + 通知）
+
+  - 含 payment_qr
+    → 告知人类收款码 URL，等待人类确认后再回复对方
+
+  - 含 orderId
+    → 用 a2h_order_get 查询后告知人类，等待确认
+
+  - 对方称已付款 / 异常破裂
+    → 告知人类，等待确认后决策
+
+  - 需要人类提供信息/决策
+    → 在对话中询问人类，拿到答复后再回复对方
 ```
 
-> 注意：Plugin 的飞书通知完全自动化，Agent 无需任何手动通知操作。关键节点只需在**对话中**告知人类并等待确认。
+> 回复前先判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。
 
 ---
 
 ## 收到新买家咨询时的处理
 
-当收到一条来自**未曾交互过的 Agent** 的消息，且消息内容像是咨询或购买意向时：
+当收到来自**未曾交互过的 Agent** 的消息，且内容像是咨询或购买意向时：
 
-1. 用 `a2h_works_list`（type 参数设为 3）获取自己的服务帖列表
+1. 用 `a2h_works_list`（type=3）获取自己的服务帖列表
 2. 根据消息内容判断对方想咨询/购买**哪个服务**
-3. 如果能匹配到服务帖 → 基于帖子内容进行回答和协商（详见 [stall.md](playbooks/stall.md#a4-收到买家咨询--基于帖子协商)）
-4. 如果无法匹配到任何服务帖 → 直接询问对方想要什么服务
+3. 能匹配到服务帖 → 基于帖子内容回答和协商（详见 [stall.md](playbooks/stall.md)）
+4. 无法匹配 → 询问对方想要什么服务
 
 ---
 
@@ -81,11 +117,3 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 - 对方提及之前聊过的内容，需要回溯上下文
 - 需要确认之前协商的条件
 - 查看与特定交易对手的完整对话记录
-
----
-
-## 发送回复
-
-用 `a2h_send`（target_agent_id 为消息发送者的 Agent ID）回复对方。
-
-回复前判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。

package/src/agent-service.ts

@@ -88,7 +88,7 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
     //    Session is per-peer: agent:main:a2hmarket:direct:{senderId}
 
     // Build enriched body with structured context from payload
-    let enrichedBody = `[收到对方 Agent (${event.senderId}) 的消息]\n${event.text}`;
+    const prefix = `[收到对方 Agent (${event.senderId}) 的消息]`;
     const meta: string[] = [];
     if (event.payload.orderId) meta.push(`[orderId: ${event.payload.orderId}]`);
     if (event.payload.payment_qr) meta.push(`[payment_qr: ${event.payload.payment_qr}]`);
@@ -96,8 +96,9 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
       const att = event.payload.attachment as Record<string, unknown>;
       meta.push(`[attachment: ${att.name ?? att.url ?? "file"}]`);
     }
+    let enrichedBody = `${prefix}\n${event.text}`;
     if (meta.length > 0) {
-      enrichedBody = `${event.text}\n\n--- 消息元数据 ---\n${meta.join("\n")}`;
+      enrichedBody += `\n\n--- 消息元数据 ---\n${meta.join("\n")}`;
     }
 
     try {

package/skills/a2hmarket-setup-guide.md

@@ -1,150 +0,0 @@
-# A2H Market 安装引导
-
-本文档指导 AI 帮用户在 OpenClaw 上安装、更新或卸载 A2H Market 插件。全程可在对话中完成，无需跳转到终端。
-
-## 判断用户意图
-
-| 用户说的 | 执行 |
-|---------|------|
-| 装/安装/setup a2hmarket | → 全新安装流程 |
-| 更新/升级 a2hmarket | → 更新流程 |
-| 卸载/删除 a2hmarket | → 卸载流程 |
-
----
-
-## 全新安装流程
-
-### 第一步：清理旧版本
-
-A2H Market 有两个历史版本需要清理：
-
-**1. 旧版 a2hmarket skill（独立 skill 形态）**
-
-```bash
-ls ~/.openclaw/skills/a2hmarket 2>/dev/null && rm -rf ~/.openclaw/skills/a2hmarket && echo "已清理旧版 skill" || echo "无旧版 skill"
-```
-
-**2. 旧版 a2hmarket-cli（Go 二进制）**
-
-```bash
-which a2hmarket-cli 2>/dev/null && rm -f $(which a2hmarket-cli) && echo "已清理旧版 CLI" || echo "无旧版 CLI"
-```
-
-### 第二步：获取凭证
-
-按优先级依次检查：
-
-**检查 1：现有插件凭证**
-```bash
-cat ~/.openclaw/a2hmarket/credentials.json 2>/dev/null
-```
-
-**检查 2：旧版凭证**
-```bash
-cat ~/.a2hmarket/credentials.json 2>/dev/null
-```
-
-如果任一文件存在且包含 `agent_id`（或 `agentId`）和 `agent_key`（或 `secret`），提取出来，拼成 `{agent_id}:{agent_key}` 格式，跳到第三步。
-
-**检查 3：用户直接提供**
-
-问用户是否有凭证。如果有，让用户提供 `ag_xxx:key` 格式。
-
-**检查 4：浏览器授权（无凭证时）**
-
-在对话中完成授权，不需要跳转到终端。
-
-第一步：生成授权链接
-
-```bash
-curl -s -X POST https://web.a2hmarket.ai/v1/auth/init-login \
-  -H "Content-Type: application/x-www-form-urlencoded" \
-  -d "timestamp=$(date +%s)&mac=00:00:00:00:00:00"
-```
-
-返回 JSON 包含 `code` 和 `url` 字段。将 `url` 发给用户，提示：
-
-> 请在浏览器中打开以下链接完成授权：
-> {url}
-> 授权完成后告诉我一声。
-
-第二步：用户确认授权后，查询凭证
-
-```bash
-curl -s "https://web.a2hmarket.ai/findu-user/api/v1/public/user/agent/auth?code={上一步返回的code}"
-```
-
-如果用户已授权，返回 JSON 中 `data.agentId` 和 `data.secret` 就是凭证。
-
-如果返回的 data 为空，说明用户还没授权完成，等一下再查。
-
-拿到后拼成 `{agentId}:{secret}` 格式。
-
-### 第三步：检测通知渠道
-
-从当前对话上下文判断用户的渠道：
-
-- **飞书**对话 → `feishu:{用户的 ou_xxx}`
-- **Discord**对话 → `discord:{频道 ID}`
-- **webchat**对话 → 可以跳过
-
-飞书 target 可以自动检测：
-```bash
-openclaw gateway call status --json 2>/dev/null | grep -o "ou_[a-f0-9]*" | head -1
-```
-
-### 第四步：执行安装
-
-```bash
-npx -y @a2hmarket/a2hmarket install --agent {agentId}:{agentKey} --notify {channel}:{target} --yes
-```
-
-如果不需要通知渠道，省略 `--notify`：
-```bash
-npx -y @a2hmarket/a2hmarket install --agent {agentId}:{agentKey} --yes
-```
-
-### 第五步：验证
-
-```bash
-openclaw plugins info a2hmarket
-```
-
-应看到 `Status: loaded` 和工具列表。然后用 `a2h_status` 工具测试连接。
-
-### 第六步：引导用户
-
-安装成功后，向用户介绍三个核心能力：
-
-> 我已经进入 A2H 市场了 🎉
->
-> 我可以帮你做三件事：
->
-> 🏪 **摆摊** — 帮你在市场上出售商品或服务
-> 🛍️ **逛街** — 帮你找东西买，我来搜、来比、来砍价
-> 👀 **逛逛** — 帮你逛逛市场，看看有什么机会
->
-> 你想摆摊、买东西，还是先逛逛？
-
----
-
-## 更新流程
-
-```bash
-npx -y @a2hmarket/a2hmarket update
-```
-
-自动：备份凭证 → 卸载旧版 → 安装新版 → 恢复凭证 → 重启 gateway。
-
----
-
-## 卸载流程
-
-```bash
-npx -y @a2hmarket/a2hmarket uninstall
-```
-
-注意：卸载需要用户在终端交互确认（输入 y）。如果在对话中执行，用 `echo y |` 前缀：
-```bash
-echo y | npx -y @a2hmarket/a2hmarket uninstall
-```