@openfinclaw/openfinclaw-strategy 0.0.11

package/openclaw.plugin.json

@@ -0,0 +1,35 @@
+{
+  "id": "openfinclaw",
+  "name": "OpenFinClaw",
+  "description": "Skill publishing and strategy validation tools. Publish strategy ZIPs to remote server with automatic backtest.",
+  "kind": "financial",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "skillApiUrl": {
+        "type": "string",
+        "description": "Skill API base URL (e.g. https://hub.openfinclaw.ai). No trailing slash.",
+        "default": "https://hub.openfinclaw.ai"
+      },
+      "skillApiKey": {
+        "type": "string",
+        "description": "API key for skill server (fch_ prefix, 68 chars). Required for publishing."
+      },
+      "requestTimeoutMs": {
+        "type": "number",
+        "default": 60000,
+        "minimum": 5000,
+        "maximum": 300000,
+        "description": "HTTP request timeout in milliseconds"
+      }
+    }
+  },
+  "uiHints": {
+    "skillApiKey": { "label": "Skill API Key", "sensitive": true },
+    "skillApiUrl": {
+      "label": "Skill Server URL",
+      "placeholder": "https://hub.openfinclaw.ai"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@openfinclaw/openfinclaw-strategy",
+  "version": "0.0.11",
+  "description": "OpenFinClaw - Financial tools for OpenClaw: strategy builder, remote backtest",
+  "keywords": [
+    "backtest",
+    "crypto",
+    "financial",
+    "openclaw",
+    "openfinclaw",
+    "strategy",
+    "trading"
+  ],
+  "homepage": "https://github.com/cryptoSUN2049/openFinclaw#readme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cryptoSUN2049/openFinclaw.git",
+    "directory": "extensions/openfinclaw"
+  },
+  "files": [
+    "skills",
+    "src",
+    "*.ts",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "adm-zip": "^0.5.16"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.8"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/skills/openfinclaw/SKILL.md

@@ -0,0 +1,301 @@
+---
+name: openfinclaw
+description: "FinClaw Commons 入口 - 量化策略开发平台。帮助用户安装插件、了解 Hub 平台、使用策略工具链（创建、验证、发布、Fork）。当用户提到 FinClaw、Hub、策略发布、策略下载、量化策略时触发。"
+metadata:
+  openclaw:
+    emoji: "🦈"
+    requires:
+      extensions: ["openfinclaw"]
+---
+
+# FinClaw Commons
+
+量化策略开发平台，连接 **hub.openfinclaw.ai** 策略网络。用户可以创建、验证、发布、Fork 策略，参与社区策略进化。
+
+## 平台简介
+
+**Hub 平台 (hub.openfinclaw.ai)** 是一个 7×24 小时全球策略进化网络：
+
+- **策略分享**: 发布你的策略，供社区成员查看和 Fork
+- **回测验证**: 发布时自动运行回测，验证策略有效性
+- **社区进化**: 其他用户可以 Fork 你的策略进行优化改进
+- **绩效排行**: 查看各市场表现最佳的策略
+
+核心价值：**不要追逐浪潮，创造浪潮。**
+
+## 快速开始
+
+安装完成后，你可以立即开始（无需 API Key）：
+
+```bash
+# 1. 查看排行榜（无需 API Key）
+openclaw strategy leaderboard
+
+# 2. 查看收益榜 Top 10
+openclaw strategy leaderboard returns --limit 10
+
+# 3. 查看策略详情（无需 API Key）
+openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
+```
+
+或者直接告诉 Agent 你想做什么：
+
+- "帮我看看排行榜有什么好策略" → Agent 会使用 `skill_leaderboard`
+- "这个策略收益怎么样" → Agent 会使用 `skill_get_info`
+- "帮我 Fork 这个策略" → Agent 会使用 `skill_fork`（需要配置 API Key）
+
+## 安装指南
+
+### 前置检查
+
+在安装前，检查用户是否已安装 OpenClaw：
+
+```bash
+openclaw --version
+```
+
+如果未安装，引导用户安装 OpenClaw（参考 https://docs.openclaw.ai/install）。
+
+### 安装 openfinclaw 插件
+
+**OpenClaw (推荐):**
+
+```bash
+openclaw plugins install @openfinclaw/openfinclaw-strategy
+
+openclaw plugins enable @openfinclaw/openfinclaw-strategy
+```
+
+安装成功后会显示插件路径，如 `~/.openclaw/extensions/openfinclaw`。
+
+### 验证安装
+
+```bash
+# 查看插件状态
+openclaw plugins list
+
+# 测试命令
+openclaw strategy list
+```
+
+### 配置 API Key
+
+从 https://hub.openfinclaw.ai 获取 API Key（以 `fch_` 开头）：
+
+```bash
+openclaw config set plugins.entries.openfinclaw.config.skillApiKey YOUR_API_KEY
+```
+
+或使用环境变量：
+
+```bash
+export SKILL_API_KEY=YOUR_API_KEY
+```
+
+### ⚠️ API Key 安全提醒
+
+**重要：请勿泄露你的 Hub API Key！**
+
+- API Key 以 `fch_` 开头，仅用于 hub.openfinclaw.ai 接口校验
+- **不要**将 API Key 提交到 Git 仓库或公开分享
+- **不要**在公开聊天、截图、代码示例中暴露真实的 API Key
+- 如果怀疑 Key 已泄露，请立即在 Hub 个人设置中重新生成
+
+配置建议：
+
+```bash
+# 推荐：使用环境变量（不会写入配置文件）
+export SKILL_API_KEY=your_api_key_here
+
+# 或使用 OpenClaw 配置（存储在本地配置文件，注意权限）
+openclaw config set plugins.entries.openfinclaw.config.skillApiKey YOUR_API_KEY
+```
+
+## 功能概览
+
+本插件提供两类能力：
+
+### Tools（工具）
+
+Agent 可直接调用的函数：
+
+| 工具名                 | 用途                                   | 需要 API Key |
+| ---------------------- | -------------------------------------- | ------------ |
+| `skill_leaderboard`    | 查询排行榜（综合/收益/风控/人气/新星） | 否           |
+| `skill_get_info`       | 获取 Hub 策略公开详情                  | 否           |
+| `skill_validate`       | 本地验证策略包格式（FEP v2.0）         | 否           |
+| `skill_list_local`     | 列出本地已下载的策略                   | 否           |
+| `skill_fork`           | 从 Hub 下载公开策略到本地              | **是**       |
+| `skill_publish`        | 发布策略 ZIP 到 Hub，自动触发回测      | **是**       |
+| `skill_publish_verify` | 查询发布状态和回测报告                 | **是**       |
+
+### Skills（指导文档）
+
+定义 Agent 在特定场景下的行为规范，位于 `skills/` 目录：
+
+| Skill              | 触发场景                 | 说明                          |
+| ------------------ | ------------------------ | ----------------------------- |
+| `strategy-builder` | 创建新策略、生成策略代码 | 自然语言 → FEP v2.0 策略包    |
+| `skill-publish`    | 发布策略到服务器         | 验证 → 打包 → 发布 → 查询回测 |
+| `strategy-fork`    | 下载/克隆 Hub 策略       | Fork → 本地编辑 → 发布新版本  |
+| `strategy-pack`    | 创建回测策略包           | 生成 fep.yaml + strategy.py   |
+
+### 典型工作流
+
+```
+创建策略 → 验证 → 发布 → Fork → 优化 → 再次发布
+    ↓         ↓        ↓        ↓
+ strategy-builder  skill_publish  skill_fork
+               skill_validate  skill_publish_verify
+```
+
+## CLI 命令
+
+### strategy leaderboard
+
+查看 Hub 排行榜（无需 API Key）：
+
+```bash
+# 综合榜 Top 20（默认）
+openclaw strategy leaderboard
+
+# 收益榜 Top 10
+openclaw strategy leaderboard returns --limit 10
+
+# 人气榜第 21-40 名
+openclaw strategy leaderboard popular --offset 20 --limit 20
+```
+
+**榜单类型**：
+
+| 榜单类型    | 说明           | 排序依据         |
+| ----------- | -------------- | ---------------- |
+| `composite` | 综合榜（默认） | FCS 综合分       |
+| `returns`   | 收益榜         | 收益率           |
+| `risk`      | 风控榜         | 风控分           |
+| `popular`   | 人气榜         | 订阅数           |
+| `rising`    | 新星榜         | 30天内新策略收益 |
+
+### strategy fork
+
+从 Hub 下载策略到本地：
+
+```bash
+# 使用策略 ID
+openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6
+
+# 使用 Hub URL
+openclaw strategy fork https://hub.openfinclaw.ai/strategy/34a5792f-7d20-4a15-90f3-26f1c54fa4a6
+
+# 指定日期目录
+openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6 --date 2026-03-01
+
+# 自定义路径
+openclaw strategy fork 34a5792f-7d20-4a15-90f3-26f1c54fa4a6 --dir ./my-strategies/
+```
+
+### strategy list
+
+列出本地策略：
+
+```bash
+openclaw strategy list
+openclaw strategy list --json
+```
+
+输出示例：
+
+```
+2026-03-16/
+  btc-adaptive-dca-34a5792f    BTC Adaptive DCA      (forked)
+  my-test-strategy              My Test Strategy      (created)
+2026-03-15/
+  eth-momentum-7e8a9b2c        ETH Momentum          (forked)
+```
+
+### strategy show
+
+查看策略详情：
+
+```bash
+# 查看本地策略
+openclaw strategy show btc-adaptive-dca-34a5792f
+
+# 从 Hub 获取最新信息（无需 API Key）
+openclaw strategy show 550e8400-e29b-41d4-a716-446655440001 --remote
+```
+
+### strategy remove
+
+删除本地策略：
+
+```bash
+openclaw strategy remove btc-adaptive-dca-34a5792f --force
+```
+
+## 本地存储结构
+
+策略存储在 `~/.openfinclaw/workspace/strategies/` 目录：
+
+```
+~/.openfinclaw/workspace/strategies/
+└── 2026-03-16/                              # 按日期组织
+    ├── btc-adaptive-dca-34a5792f/           # 名称 + 短ID（Fork 来的）
+    │   ├── fep.yaml                         # 策略配置
+    │   ├── scripts/
+    │   │   └── strategy.py                  # 策略代码
+    │   └── .fork-meta.json                  # 元数据
+    └── my-new-strategy/                     # 自建策略（无短ID）
+        └── ...
+```
+
+## 触发场景与相关 Skills
+
+当用户提到以下内容时，应引导阅读对应的 Skill：
+
+| 触发关键词                     | Skill 目录         | 说明                                    |
+| ------------------------------ | ------------------ | --------------------------------------- |
+| 创建策略、写策略、生成策略包   | `strategy-builder` | 自然语言 → FEP v2.0 策略包              |
+| 发布策略、上传策略、提交策略   | `skill-publish`    | 验证 → 打包 → 发布到 Hub → 查询回测报告 |
+| Fork 策略、下载策略、克隆策略  | `strategy-fork`    | 从 Hub Fork 策略到本地，支持二次开发    |
+| 策略包格式、FEP 规范、打包回测 | `strategy-pack`    | FEP v2.0 规范详解，打包和校验指南       |
+
+## 配置选项
+
+| 配置项             | 环境变量                   | 说明             | 默认值                       |
+| ------------------ | -------------------------- | ---------------- | ---------------------------- |
+| `skillApiKey`      | `SKILL_API_KEY`            | Hub API Key      | 必填                         |
+| `skillApiUrl`      | `SKILL_API_URL`            | Hub 服务地址     | `https://hub.openfinclaw.ai` |
+| `requestTimeoutMs` | `SKILL_REQUEST_TIMEOUT_MS` | 请求超时（毫秒） | `60000`                      |
+
+## 常见问题
+
+### Q: API Key 在哪里获取？
+
+访问 https://hub.openfinclaw.ai 登录后在个人设置中获取。
+
+### Q: Fork 的策略可以修改吗？
+
+可以。Fork 下载到本地后，可以自由修改 `scripts/strategy.py`，然后发布为自己的新版本。
+
+### Q: 发布策略会公开吗？
+
+取决于 `fep.yaml` 中的 `identity.visibility` 设置：
+
+- `public`: 公开，社区可见可 Fork
+- `private`: 私有，仅自己可见
+- `unlisted`: 不公开但可通过链接访问
+
+### Q: 如何检查 openfinclaw 是否已安装？
+
+```bash
+openclaw plugins list | grep openfinclaw
+```
+
+## 链接
+
+- **Hub 平台**: https://hub.openfinclaw.ai
+- **排行榜**: https://hub.openfinclaw.ai/leaderboard
+- **策略发现**: https://hub.openfinclaw.ai/discover
+- **获取 API Key**: https://hub.openfinclaw.ai/dashboard
+- **GitHub 仓库**: https://github.com/cryptoSUN2049/openFinclaw

package/skills/skill-publish/SKILL.md

@@ -0,0 +1,316 @@
+---
+name: skill-publish
+description: "Skill Publishing Agent. Use when the user wants to publish a strategy to the server, check publish/backtest status, or view backtest report. Flow: validate → zip → publish → poll verify → get report. Supports FEP v2.0 protocol."
+metadata: { "openclaw": { "requires": { "extensions": ["openfinclaw"] } } }
+---
+
+# Skill Publishing
+
+When the user talks about **publishing a strategy**, **submitting a skill**, **checking backtest status**, or **viewing backtest report**, use the skill publishing tools. The server automatically runs backtest after publishing.
+
+## When to trigger
+
+- User says: 发布策略、发布 Skill、上传策略、提交策略
+- User asks: 回测状态、发布状态、回测结果、回测报告
+- User wants: 发布到服务器、查看发布结果
+
+## Visibility Warning (IMPORTANT)
+
+Before publishing, **always check** `identity.visibility` in the strategy's `fep.yaml`:
+
+| Visibility | Behavior                                                                                                                                              |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `public`   | Strategy will be uploaded to **https://hub.openfinclaw.ai** and made **publicly visible**. Community members can view, fork, and evolve the strategy. |
+| `private`  | Strategy is stored privately; only the owner can access it.                                                                                           |
+| `unlisted` | Strategy is accessible via direct link but not listed in public galleries.                                                                            |
+
+**If `visibility: public` is detected:**
+
+1. **Warn the user** before proceeding:
+
+   > ⚠️ 该策略将上传到 **https://hub.openfinclaw.ai** 并设为**公开**。社区成员可以查看、fork 和进化您的策略。如果您希望保持私有，请将 `fep.yaml` 中的 `identity.visibility` 改为 `private`。
+
+2. **Wait for user confirmation** before zipping/publishing.
+
+3. If user wants private: instruct them to update `fep.yaml`:
+   ```yaml
+   identity:
+     visibility: private # change from public to private
+   ```
+
+## Recommended flow
+
+1. **Validate first**: For a **directory** (not yet zipped), use `skill_validate` with `dirPath` first. Only proceed when `valid: true`.
+2. **Check visibility**: Before zipping, read the `fep.yaml` and check `identity.visibility`:
+   - If `visibility: public`: **MUST warn user** that the strategy will be uploaded to **https://hub.openfinclaw.ai** and made **publicly visible** for community evolution/forking. Ask if they want to change to `visibility: private` instead.
+   - If `visibility: private` or `unlisted`: Proceed without warning.
+3. **Create ZIP**: Zip the directory (e.g. `zip -r ../skill.zip fep.yaml scripts/`). The ZIP must contain `fep.yaml` at root.
+4. **Publish**: Use `skill_publish` with the ZIP `filePath`. The server will:
+   - Parse `fep.yaml`
+   - Auto-increment version if exists
+   - Run automatic backtest
+   - Return `submissionId` and `backtestTaskId`
+5. **Poll verify**: Use `skill_publish_verify` with `submissionId` or `backtestTaskId`. Repeat until `backtestStatus` is:
+   - `completed` — Success, `backtestReport` contains full results
+   - `failed` — Backtest failed
+   - `rejected` — Strategy rejected
+6. **Get report**: When `backtestStatus === "completed"`, the response includes full `backtestReport` with performance, equity_curve, trade_journal.
+
+## Tools
+
+| Tool                   | Purpose                                                                      |
+| ---------------------- | ---------------------------------------------------------------------------- |
+| `skill_validate`       | Validate strategy package directory locally (FEP v2.0) before zipping        |
+| `skill_publish`        | POST ZIP to server; returns submissionId, backtestTaskId, and initial status |
+| `skill_publish_verify` | GET publish/backtest status by submissionId or backtestTaskId                |
+
+## API Configuration
+
+The plugin requires configuration:
+
+- `skillApiUrl`: Server URL (default: `https://hub.openfinclaw.ai`)
+- `skillApiKey`: API key with `fch_` prefix (68 chars)
+
+Configure via:
+
+- Plugin config: `skillApiUrl`, `skillApiKey`
+- Environment: `SKILL_API_URL`, `SKILL_API_KEY`
+
+### ⚠️ API Key Security
+
+**IMPORTANT: Never expose your Hub API Key!**
+
+- The API Key (`fch_` prefix) is **only** for hub.openfinclaw.ai API authentication
+- **DO NOT** commit API Keys to Git repositories or share publicly
+- **DO NOT** expose real API Keys in public chats, screenshots, or code examples
+- If you suspect a Key has been leaked, regenerate it immediately in Hub settings
+
+## Response fields
+
+### skill_publish response
+
+| Field            | Description                                                            |
+| ---------------- | ---------------------------------------------------------------------- |
+| `slug`           | Strategy unique identifier (from fep identity.id)                      |
+| `entryId`        | Strategy entry UUID                                                    |
+| `version`        | Published version (may be auto-incremented)                            |
+| `status`         | Combined publish+backtest status                                       |
+| `submissionId`   | Submission ID for verify endpoint                                      |
+| `backtestTaskId` | Backtest task ID for verify endpoint                                   |
+| `backtestStatus` | Backtest status: submitted/queued/processing/completed/failed/rejected |
+| `backtestReport` | Full report when backtest completed                                    |
+
+### skill_publish_verify response
+
+| Field                | Description                     |
+| -------------------- | ------------------------------- |
+| `strategyUploaded`   | Strategy saved to database      |
+| `backtestCompleted`  | Backtest reached terminal state |
+| `backtestReportInDb` | Full report saved to database   |
+| `backtestReport`     | Complete report when completed  |
+
+## Backtest report structure (FEP v2.0)
+
+When `backtestStatus === "completed"`:
+
+```json
+{
+  "alpha": null,
+  "taskId": "bt-2be0c156bfe2",
+  "metadata": {
+    "id": "tsla-simple-test",
+    "name": "TSLA Simple Test Strategy",
+    "tags": ["tsla", "simple", "test"],
+    "type": "strategy",
+    "style": "trend",
+    "author": { "name": "OpenFinClaw" },
+    "market": "US",
+    "license": "MIT",
+    "summary": "Simple TSLA strategy for testing",
+    "version": "1.0.0"
+  },
+  "integrity": {
+    "fepHash": "sha256:...",
+    "codeHash": "sha256:...",
+    "contentCID": "Qm...",
+    "contentHash": "sha256:...",
+    "publishedAt": "2026-03-12T10:18:28.782727+00:00",
+    "timestampProof": "..."
+  },
+  "performance": {
+    "totalReturn": 0.22,
+    "sharpe": 0.12,
+    "maxDrawdown": -0.15,
+    "totalTrades": 189,
+    "winRate": 68.25,
+    "profitFactor": 1.32,
+    "sortino": 0.13,
+    "annualizedReturn": 0.18,
+    "calmar": 0.37,
+    "returnsVolatility": 0.25,
+    "riskReturnRatio": 0.88,
+    "expectancy": 120.5,
+    "avgWinner": 350.2,
+    "avgLoser": -180.3,
+    "maxWinner": 1200.0,
+    "maxLoser": -450.0,
+    "longRatio": 0.65,
+    "pnlTotal": 22000.0,
+    "startingBalance": 100000.0,
+    "endingBalance": 122000.0,
+    "backtestStart": "2024-01-01",
+    "backtestEnd": "2024-12-31",
+    "totalOrders": 378,
+    "hints": ["Strategy performed well in trending markets."]
+  },
+  "equityCurve": [
+    { "date": "2024-01-02", "equity": 100500.0 },
+    { "date": "2024-01-03", "equity": 101200.0 }
+  ],
+  "drawdownCurve": [
+    { "date": "2024-01-02", "drawdown": 0.0 },
+    { "date": "2024-01-15", "drawdown": -0.05 }
+  ],
+  "monthlyReturns": [
+    { "month": "2024-01", "return": 0.05 },
+    { "month": "2024-02", "return": -0.02 }
+  ],
+  "trades": [
+    {
+      "open_date": "2024-01-15",
+      "close_date": "2024-01-20",
+      "side": "BUY",
+      "quantity": 100.0,
+      "avg_open": 250.0,
+      "avg_close": 260.0,
+      "realized_pnl": "+$1,000.00",
+      "return_pct": 0.04
+    }
+  ]
+}
+```
+
+### Top-level fields
+
+| Field            | Type             | Description                               |
+| ---------------- | ---------------- | ----------------------------------------- |
+| `alpha`          | `number \| null` | Alpha coefficient, strategy excess return |
+| `taskId`         | `string`         | Backtest task unique identifier           |
+| `metadata`       | `object`         | Strategy metadata                         |
+| `integrity`      | `object`         | Integrity verification info               |
+| `performance`    | `object`         | Backtest performance metrics              |
+| `equityCurve`    | `array`          | Equity curve data points                  |
+| `drawdownCurve`  | `array`          | Drawdown curve data points                |
+| `monthlyReturns` | `array`          | Monthly returns data                      |
+| `trades`         | `array`          | Complete trade records                    |
+
+### Performance fields (FEP v2.0)
+
+#### Core Metrics
+
+| Field          | Type     | Description                    |
+| -------------- | -------- | ------------------------------ |
+| `totalReturn`  | `number` | Total return (decimal)         |
+| `sharpe`       | `number` | Sharpe ratio (252-day annual)  |
+| `maxDrawdown`  | `number` | Maximum drawdown (negative)    |
+| `totalTrades`  | `int`    | Number of complete trade round |
+| `winRate`      | `number` | Win rate (percentage)          |
+| `profitFactor` | `number` | Profit factor                  |
+
+#### Return Analysis
+
+| Field               | Type     | Description                 |
+| ------------------- | -------- | --------------------------- |
+| `sortino`           | `number` | Sortino ratio               |
+| `annualizedReturn`  | `number` | CAGR annualized return      |
+| `calmar`            | `number` | Calmar ratio (CAGR / MaxDD) |
+| `returnsVolatility` | `number` | Returns volatility          |
+| `riskReturnRatio`   | `number` | Risk-return ratio           |
+
+#### Trade Analysis
+
+| Field        | Type     | Description               |
+| ------------ | -------- | ------------------------- |
+| `expectancy` | `number` | Expected profit per trade |
+| `avgWinner`  | `number` | Average winning trade     |
+| `avgLoser`   | `number` | Average losing trade      |
+| `maxWinner`  | `number` | Largest winning trade     |
+| `maxLoser`   | `number` | Largest losing trade      |
+| `longRatio`  | `number` | Long position ratio       |
+
+#### Extended Metrics
+
+| Field             | Type     | Description              |
+| ----------------- | -------- | ------------------------ |
+| `pnlTotal`        | `number` | Total profit/loss amount |
+| `startingBalance` | `number` | Initial capital          |
+| `endingBalance`   | `number` | Final capital            |
+| `backtestStart`   | `string` | Backtest start date      |
+| `backtestEnd`     | `string` | Backtest end date        |
+| `totalOrders`     | `int`    | Total number of orders   |
+
+### Time Series Data
+
+#### equityCurve format
+
+```json
+[
+  { "date": "2024-01-02", "equity": 100500.0 },
+  { "date": "2024-01-03", "equity": 101200.0 }
+]
+```
+
+#### drawdownCurve format
+
+```json
+[
+  { "date": "2024-01-02", "drawdown": 0.0 },
+  { "date": "2024-01-15", "drawdown": -0.05 }
+]
+```
+
+#### monthlyReturns format
+
+```json
+[
+  { "month": "2024-01", "return": 0.05 },
+  { "month": "2024-02", "return": -0.02 }
+]
+```
+
+#### trades format
+
+| Field          | Type     | Description                |
+| -------------- | -------- | -------------------------- |
+| `open_date`    | `string` | Position open date         |
+| `close_date`   | `string` | Position close date        |
+| `side`         | `string` | Trade direction (BUY)      |
+| `quantity`     | `number` | Position size              |
+| `avg_open`     | `number` | Average open price         |
+| `avg_close`    | `number` | Average close price        |
+| `realized_pnl` | `string` | Realized P&L with currency |
+| `return_pct`   | `number` | Return percentage          |
+
+## Post-publish guidance
+
+After the strategy is successfully published and backtest completed, inform the user:
+
+> ✅ 策略发布成功！请访问 **https://hub.openfinclaw.ai/en/dashboard/entries** 查看策略详情和回测报告。
+
+**Do NOT** provide strategy-specific URLs like `https://hub.openfinclaw.ai/en/strategy/{entryId}`. Always direct users to the dashboard entries page.
+
+## Example workflow
+
+```
+User: 发布我的策略到服务器
+Agent:
+1. skill_validate(dirPath: "/path/to/strategy")
+   → valid: true
+2. [zip directory]
+3. skill_publish(filePath: "/path/to/skill.zip")
+   → submissionId: "abc-123", backtestTaskId: "bt-xyz", status: "pending"
+4. skill_publish_verify(submissionId: "abc-123")
+   → backtestStatus: "processing" (poll again)
+5. skill_publish_verify(submissionId: "abc-123")
+   → backtestStatus: "completed", backtestReport: { ... }
+```