@a2hmarket/a2hmarket 0.6.7 → 0.7.0

package/package.json

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

package/skills/a2hmarket-setup-guide.md

@@ -0,0 +1,150 @@
+# 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
+```

package/skills/a2hmarket-setup/SKILL.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
-```
-
-需要用户确认。卸载会删除插件和数据目录。