@a2hmarket/a2hmarket 0.6.8 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.6.8",
+  "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,143 +0,0 @@
----
-name: a2hmarket-setup
-description: "安装、更新或卸载 A2H Market 插件。触发词：安装a2hmarket、装a2hmarket、setup a2h、卸载a2hmarket、更新a2hmarket、a2h market 安装。当用户要求安装/卸载/更新 a2hmarket 插件时触发。"
----
-
-# A2H Market 安装引导
-
-本 Skill 指导你帮用户在 OpenClaw 上安装、更新或卸载 A2H Market 插件。
-
-## 判断用户意图
-
-| 用户说的 | 执行 |
-|---------|------|
-| 装/安装/setup a2hmarket | → 全新安装流程 |
-| 更新/升级 a2hmarket | → 更新流程 |
-| 卸载/删除 a2hmarket | → 卸载流程 |
-
----
-
-## 全新安装流程
-
-### 第一步：清理旧版本
-
-A2H Market 有两个历史版本需要清理：
-
-**1. 旧版 a2hmarket skill（独立 skill 形态）**
-
-检查是否存在：
-```bash
-ls ~/.openclaw/skills/a2hmarket 2>/dev/null
-```
-
-如果存在，删除：
-```bash
-rm -rf ~/.openclaw/skills/a2hmarket
-```
-
-**2. 旧版 a2hmarket-cli（Go 二进制）**
-
-检查是否存在：
-```bash
-which a2hmarket-cli 2>/dev/null
-```
-
-如果存在，删除：
-```bash
-rm -f $(which a2hmarket-cli)
-```
-
-清理旧版配置目录（凭证会迁移到新位置）：
-```bash
-# 不要删除 ~/.a2hmarket/credentials.json —— 安装脚本会自动迁移
-ls ~/.a2hmarket/ 2>/dev/null
-```
-
-### 第二步：获取凭证
-
-用户需要一个 A2H Market 的 agentId 和 agentKey。有两种情况：
-
-**情况 A：用户已有凭证**
-- 用户直接提供 `ag_xxx:key` 格式的凭证
-- 或者旧版 `~/.a2hmarket/credentials.json` 中有凭证可以复用
-
-检查旧凭证：
-```bash
-cat ~/.a2hmarket/credentials.json 2>/dev/null
-```
-
-如果有，提取 `agent_id` 和 `agent_key`（或 `secret`），拼成 `agent_id:agent_key` 格式。
-
-**情况 B：用户没有凭证**
-- 需要浏览器授权流程
-- 这种情况不适合非交互安装，告诉用户在终端手动执行：
-  ```bash
-  npx -y @a2hmarket/a2hmarket install
-  ```
-- 安装脚本会生成授权链接，用户在浏览器中授权后自动完成
-
-### 第三步：检测通知渠道
-
-从当前对话的 session 上下文判断用户使用的渠道：
-
-- 如果用户在**飞书**对话 → 通知渠道是 `feishu`，target 是用户的 `ou_xxx` open_id
-- 如果用户在**Discord**对话 → 通知渠道是 `discord`，target 是频道 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
-```
-
-示例：
-```bash
-npx -y @a2hmarket/a2hmarket install --agent ag_t6PowP7DhseW8oBl:abc123secret --notify feishu:ou_9adf14b0f07ab565 --yes
-```
-
-如果不需要通知渠道：
-```bash
-npx -y @a2hmarket/a2hmarket install --agent ag_t6PowP7DhseW8oBl:abc123secret --yes
-```
-
-### 第五步：验证
-
-安装完成后验证插件状态：
-```bash
-openclaw plugins info a2hmarket
-```
-
-应该看到 `Status: loaded` 和工具列表。
-
-然后用 `a2h_status` 工具测试连接。
-
-### 第六步：引导用户
-
-安装成功后，参考 [onboarding.md](references/playbooks/onboarding.md) 向用户介绍三个核心能力并引导进入场景。
-
----
-
-## 更新流程
-
-```bash
-npx -y @a2hmarket/a2hmarket update
-```
-
-这会自动：备份凭证 → 卸载旧版 → 安装新版 → 恢复凭证 → 重启 gateway。
-
----
-
-## 卸载流程
-
-```bash
-npx -y @a2hmarket/a2hmarket uninstall
-```
-
-需要用户确认。卸载会删除插件和数据目录。