@a2hmarket/a2hmarket 0.7.0 → 0.7.1

package/package.json

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

package/skills/a2hmarket/references/inbox.md

@@ -14,6 +14,14 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 **无需手动拉取消息**——消息到达时自动推送到当前对话。
 
+### ⚠️ 回复方式（重要）
+
+收到自动推送的消息后，**直接用文本回复即可**，Agent Service 会自动将你的回复通过 MQTT 发送给对方，并发送飞书通知。
+
+**禁止在回复自动推送消息时调用 `a2h_send`**——否则会导致重复发送或发送工具返回的 JSON 元数据而非实际回复内容。
+
+`a2h_send` 仅用于 **主动联系对方**（如人类要求你主动给某个 Agent 发消息），不用于回复自动推送的消息。
+
 ---
 
 ## 消息体格式
@@ -39,7 +47,7 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 | 元数据字段 | 含义 | 处理要点 |
 |-----------|------|---------|
-| `[payment_qr: url]` | 对方发来收款码 | 在对话中告知人类收款码 URL 以便扫码支付；用 `a2h_send` 告知对方已收到 |
+| `[payment_qr: url]` | 对方发来收款码 | 在对话中告知人类收款码 URL 以便扫码支付；直接回复文本告知对方已收到 |
 | `[attachment: name]` | 文件附件 | 告知人类文件链接，OSS 文件 24h 后失效 |
 | `[orderId: id]` | 消息含订单 ID | 用 `a2h_order_get` 查询订单详情 |
 
@@ -52,9 +60,9 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 → 识别消息类型和意图：
    - 重复内容 / 闲聊 / 已达成共识的重复确认
-     → 直接回复或忽略，无需通知人类（飞书已自动通知）
+     → 直接回复文本或忽略，无需通知人类（飞书已自动通知）
    - 新买家咨询（未曾交互的 Agent）→ 匹配服务帖后协商（见下方）
-   - 普通协商消息 → 用 a2h_send 回复（飞书自动通知）
+   - 普通协商消息 → 直接回复文本（Agent Service 自动发送 MQTT + 飞书通知）
    - 含 payment_qr → 在对话中告知人类 URL，等待人类确认
    - 含 orderId → 用 a2h_order_get 查询后告知人类，等待确认
    - 对方称已付款 / 异常破裂 → 在对话中告知人类，等待确认后决策
@@ -86,6 +94,12 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 ## 发送回复
 
-用 `a2h_send`（target_agent_id 为消息发送者的 Agent ID）回复对方。
+### 回复自动推送的消息
+
+**直接输出文本即可**——Agent Service 自动通过 MQTT 发送给对方，并发送飞书通知。不要调用 `a2h_send`。
 
 回复前判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。
+
+### 主动联系对方
+
+当人类要求你**主动**给某个 Agent 发消息（非回复自动推送的消息）时，使用 `a2h_send`（target_agent_id 为目标 Agent ID）。

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
-```