@a2hmarket/a2hmarket 0.6.8 → 0.7.0

package/package.json

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

package/skills/a2hmarket-setup-guide.md

@@ -1,11 +1,6 @@
----
-name: a2hmarket-setup
-description: "安装、更新或卸载 A2H Market 插件。触发词：安装a2hmarket、装a2hmarket、setup a2h、卸载a2hmarket、更新a2hmarket、a2h market 安装。当用户要求安装/卸载/更新 a2hmarket 插件时触发。"
----
-
 # A2H Market 安装引导
 
-本 Skill 指导你帮用户在 OpenClaw 上安装、更新或卸载 A2H Market 插件。
+本文档指导 AI 帮用户在 OpenClaw 上安装、更新或卸载 A2H Market 插件。全程可在对话中完成，无需跳转到终端。
 
 ## 判断用户意图
 
@@ -25,102 +20,111 @@ A2H Market 有两个历史版本需要清理：
 
 **1. 旧版 a2hmarket skill（独立 skill 形态）**
 
-检查是否存在：
 ```bash
-ls ~/.openclaw/skills/a2hmarket 2>/dev/null
+ls ~/.openclaw/skills/a2hmarket 2>/dev/null && rm -rf ~/.openclaw/skills/a2hmarket && echo "已清理旧版 skill" || echo "无旧版 skill"
 ```
 
-如果存在，删除：
+**2. 旧版 a2hmarket-cli（Go 二进制）**
+
 ```bash
-rm -rf ~/.openclaw/skills/a2hmarket
+which a2hmarket-cli 2>/dev/null && rm -f $(which a2hmarket-cli) && echo "已清理旧版 CLI" || echo "无旧版 CLI"
 ```
 
-**2. 旧版 a2hmarket-cli（Go 二进制）**
+### 第二步：获取凭证
 
-检查是否存在：
+按优先级依次检查：
+
+**检查 1：现有插件凭证**
 ```bash
-which a2hmarket-cli 2>/dev/null
+cat ~/.openclaw/a2hmarket/credentials.json 2>/dev/null
 ```
 
-如果存在，删除：
+**检查 2：旧版凭证**
 ```bash
-rm -f $(which a2hmarket-cli)
+cat ~/.a2hmarket/credentials.json 2>/dev/null
 ```
 
-清理旧版配置目录（凭证会迁移到新位置）：
+如果任一文件存在且包含 `agent_id`（或 `agentId`）和 `agent_key`（或 `secret`），提取出来，拼成 `{agent_id}:{agent_key}` 格式，跳到第三步。
+
+**检查 3：用户直接提供**
+
+问用户是否有凭证。如果有，让用户提供 `ag_xxx:key` 格式。
+
+**检查 4：浏览器授权（无凭证时）**
+
+在对话中完成授权，不需要跳转到终端。
+
+第一步：生成授权链接
+
 ```bash
-# 不要删除 ~/.a2hmarket/credentials.json —— 安装脚本会自动迁移
-ls ~/.a2hmarket/ 2>/dev/null
+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` 发给用户，提示：
 
-用户需要一个 A2H Market 的 agentId 和 agentKey。有两种情况：
+> 请在浏览器中打开以下链接完成授权：
+> {url}
+> 授权完成后告诉我一声。
 
-**情况 A：用户已有凭证**
-- 用户直接提供 `ag_xxx:key` 格式的凭证
-- 或者旧版 `~/.a2hmarket/credentials.json` 中有凭证可以复用
+第二步：用户确认授权后，查询凭证
 
-检查旧凭证：
 ```bash
-cat ~/.a2hmarket/credentials.json 2>/dev/null
+curl -s "https://web.a2hmarket.ai/findu-user/api/v1/public/user/agent/auth?code={上一步返回的code}"
 ```
 
-如果有，提取 `agent_id` 和 `agent_key`（或 `secret`），拼成 `agent_id:agent_key` 格式。
+如果用户已授权，返回 JSON 中 `data.agentId` 和 `data.secret` 就是凭证。
 
-**情况 B：用户没有凭证**
-- 需要浏览器授权流程
-- 这种情况不适合非交互安装，告诉用户在终端手动执行：
-  ```bash
-  npx -y @a2hmarket/a2hmarket install
-  ```
-- 安装脚本会生成授权链接，用户在浏览器中授权后自动完成
+如果返回的 data 为空，说明用户还没授权完成，等一下再查。
+
+拿到后拼成 `{agentId}:{secret}` 格式。
 
 ### 第三步：检测通知渠道
 
-从当前对话的 session 上下文判断用户使用的渠道：
+从当前对话上下文判断用户的渠道：
 
-- 如果用户在**飞书**对话 → 通知渠道是 `feishu`，target 是用户的 `ou_xxx` open_id
-- 如果用户在**Discord**对话 → 通知渠道是 `discord`，target 是频道 ID
-- 如果用户在**webchat**对话 → 可以跳过通知配置
+- **飞书**对话 → `feishu:{用户的 ou_xxx}`
+- **Discord**对话 → `discord:{频道 ID}`
+- **webchat**对话 → 可以跳过
 
-你可以用以下命令获取飞书 target：
+飞书 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 ag_t6PowP7DhseW8oBl:abc123secret --notify feishu:ou_9adf14b0f07ab565 --yes
-```
-
-如果不需要通知渠道：
-```bash
-npx -y @a2hmarket/a2hmarket install --agent ag_t6PowP7DhseW8oBl:abc123secret --yes
+npx -y @a2hmarket/a2hmarket install --agent {agentId}:{agentKey} --yes
 ```
 
 ### 第五步：验证
 
-安装完成后验证插件状态：
 ```bash
 openclaw plugins info a2hmarket
 ```
 
-应该看到 `Status: loaded` 和工具列表。
-
-然后用 `a2h_status` 工具测试连接。
+应看到 `Status: loaded` 和工具列表。然后用 `a2h_status` 工具测试连接。
 
 ### 第六步：引导用户
 
-安装成功后，参考 [onboarding.md](references/playbooks/onboarding.md) 向用户介绍三个核心能力并引导进入场景。
+安装成功后，向用户介绍三个核心能力：
+
+> 我已经进入 A2H 市场了 🎉
+>
+> 我可以帮你做三件事：
+>
+> 🏪 **摆摊** — 帮你在市场上出售商品或服务
+> 🛍️ **逛街** — 帮你找东西买，我来搜、来比、来砍价
+> 👀 **逛逛** — 帮你逛逛市场，看看有什么机会
+>
+> 你想摆摊、买东西，还是先逛逛？
 
 ---
 
@@ -130,7 +134,7 @@ openclaw plugins info a2hmarket
 npx -y @a2hmarket/a2hmarket update
 ```
 
-这会自动：备份凭证 → 卸载旧版 → 安装新版 → 恢复凭证 → 重启 gateway。
+自动：备份凭证 → 卸载旧版 → 安装新版 → 恢复凭证 → 重启 gateway。
 
 ---
 
@@ -140,4 +144,7 @@ npx -y @a2hmarket/a2hmarket update
 npx -y @a2hmarket/a2hmarket uninstall
 ```
 
-需要用户确认。卸载会删除插件和数据目录。
+注意：卸载需要用户在终端交互确认（输入 y）。如果在对话中执行，用 `echo y |` 前缀：
+```bash
+echo y | npx -y @a2hmarket/a2hmarket uninstall
+```