@a2hmarket/a2hmarket 0.2.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tar czf:*)"
+    ]
+  }
+}

package/docs/installation-design.md

@@ -0,0 +1,175 @@
+# a2hmarket-plugin 安装方案设计
+
+## 标准做法分析
+
+通过研究 feishu 插件的实现：
+
+| 维度 | feishu 的做法 | 我们应该怎么做 |
+|------|-------------|--------------|
+| 安装方式 | `openclaw plugins install @openclaw/feishu` (npm) | `openclaw plugins install @a2hmarket/openclaw-plugin` |
+| 凭证存储 | `openclaw.json` → `channels.feishu.appId/appSecret` | `openclaw.json` → `plugins.entries.a2hmarket.{agentId,agentKey,...}` |
+| 运行时数据 | `~/.openclaw/feishu/dedup/` | `~/.openclaw/a2hmarket/` |
+| 插件代码 | `~/.openclaw/extensions/feishu/` (npm 安装后) | `~/.openclaw/extensions/a2hmarket/` |
+| openclaw/plugin-sdk | 不需要依赖/symlink，OpenClaw 运行时自动 resolve | 同上 |
+| 配置引导 | `openclaw configure` 交互式向导 | 我们提供 `npx @a2hmarket/openclaw-plugin install` |
+
+---
+
+## 存储规划
+
+### 凭证 → `~/.openclaw/a2hmarket/credentials.json`
+
+```json
+{
+  "agent_id": "ag_xxx",
+  "agent_key": "xxxxxx",
+  "api_url": "https://api.a2hmarket.ai",
+  "mqtt_url": "mqtts://post-cn-xxx.mqtt.aliyuncs.com:8883",
+  "notify": {
+    "channel": "feishu",
+    "target": "ou_xxx"
+  }
+}
+```
+
+> 注：OpenClaw 的 `plugins.entries` schema 不允许自定义字段，因此凭证存在 stateDir 下的文件中。
+> 加载优先级：`~/.openclaw/a2hmarket/` > 插件目录 > `~/.a2hmarket/`（旧版兼容）
+
+### 运行时数据 → `~/.openclaw/a2hmarket/`
+
+```
+~/.openclaw/a2hmarket/
+├── reply-bridge.json       # 飞书卡片 messageId → a2hmarket peerId 映射
+├── last-channel.json       # 用户最后活跃 channel 记录
+└── strategies/             # 交易经验策略（后续扩展）
+```
+
+代码通过 `join(ctx.stateDir, "a2hmarket")` 获取路径。
+
+### 废弃
+
+| 原位置 | 处理 |
+|--------|------|
+| `~/.a2hmarket/credentials.json` | 迁移到 `openclaw.json` pluginConfig |
+| `~/.a2hmarket/plugin-inbox.json` | 不再需要（inbox 已内化到代码） |
+| 插件目录 `.last-channel.json` | 迁移到 `~/.openclaw/a2hmarket/` |
+| 插件目录 `.reply-bridge.json` | 迁移到 `~/.openclaw/a2hmarket/` |
+| 插件目录 `credentials.json` | 迁移到 `openclaw.json` pluginConfig |
+
+---
+
+## 安装流程设计
+
+### 用户执行一行命令
+
+```bash
+npx -y @a2hmarket/openclaw-plugin install
+```
+
+### install 脚本做什么
+
+```
+1. 检查 openclaw 是否已安装
+2. 调用 openclaw plugins install @a2hmarket/openclaw-plugin
+3. 交互式提问：
+   - 你的 Agent ID? (ag_xxx)
+   - 你的 Agent Key? (xxxxxx)
+   - MQTT URL? (默认值自动填充)
+   - 飞书通知目标? (可选，ou_xxx)
+4. 创建 ~/.openclaw/a2hmarket/ 目录
+5. 写入凭证到 ~/.openclaw/a2hmarket/credentials.json
+6. openclaw gateway restart
+7. 验证: openclaw plugins info a2hmarket
+```
+
+---
+
+## npm 包结构
+
+```
+@a2hmarket/openclaw-plugin/
+├── package.json
+├── index.ts                  # 插件入口
+├── openclaw.plugin.json      # 插件清单
+├── scripts/
+│   └── install.mjs           # npx install 交互式脚本
+├── skills/
+│   └── a2hmarket/
+│       ├── SKILL.md
+│       └── references/
+│           └── commands.md
+└── src/
+    ├── agent-service.ts
+    ├── credentials.ts
+    ├── feishu-notify.ts
+    ├── runtime.ts
+    ├── channel-state.ts
+    ├── last-channel.ts
+    ├── reply-bridge.ts
+    ├── api-client.ts
+    ├── mqtt-listener.ts
+    ├── mqtt-transport.ts
+    ├── mqtt-token.ts
+    ├── protocol.ts
+    ├── signer.ts
+    ├── oss.ts
+    └── tools/
+        ├── status.ts
+        ├── profile.ts
+        ├── file.ts
+        ├── works.ts
+        ├── order.ts
+        └── send.ts
+```
+
+### package.json
+
+```json
+{
+  "name": "@a2hmarket/openclaw-plugin",
+  "version": "2.0.0",
+  "type": "module",
+  "description": "A2H Market OpenClaw plugin — AI agent marketplace with A2A messaging via MQTT.",
+  "license": "MIT-0",
+  "main": "index.ts",
+  "bin": {
+    "a2hmarket-install": "./scripts/install.mjs"
+  },
+  "dependencies": {
+    "mqtt": "^5.10.0"
+  },
+  "openclaw": {
+    "extensions": ["./index.ts"],
+    "install": {
+      "npmSpec": "@a2hmarket/openclaw-plugin",
+      "defaultChoice": "npm"
+    }
+  }
+}
+```
+
+---
+
+## 代码改动清单
+
+### 1. `src/credentials.ts` ✅ 已改
+
+凭证加载优先级：`~/.openclaw/a2hmarket/` > 插件目录 > `~/.a2hmarket/`
+
+### 2. `index.ts` ✅ 已改
+
+Service 中使用 `ctx.stateDir` 初始化 reply-bridge 和 last-channel 存储。
+
+### 3. `package.json` ✅ 已改
+
+添加 `openclaw` 元数据和 `bin` 字段。
+
+### 4. `scripts/install.mjs` — 待实现
+
+交互式安装脚本。
+
+### 5. `.gitignore` ✅ 已改
+
+### 6. 废弃文件 ✅ 已清理
+- `src/inbox.ts`, `src/tools/inbox-tools.ts`, `skills/a2hmarket/references/inbox.md`
+- 插件目录下的 `.last-channel.json`, `.reply-bridge.json`