name: cny-rate-calculator version: 1.0.0 description: Auto-fetch Bank of Taiwan CNY exchange rates and calculate tiered pricing (base cost, 10K discount, 50K discount) using the Prairie Grasslands formula. REQUIRED: Channel configuration and Schedule setup must be completed before use. Supports Telegram, Discord, Slack, Signal, WhatsApp, iMessage, IRC, Google Chat, and webhooks.

CNY Rate Calculator (大草原匯率計算器)

Automatically fetch Bank of Taiwan CNY exchange rates and calculate tiered pricing.

🤖 Agent 指引（自動執行規則）

以下規則 Agent 必須優先遵守，在任何使用者互動之前先執行檢查。

規則一：Agent 啟動時 → 主動偵測並引導設定

Agent 每次啟動時，必須：

1. 讀取技能目錄下的 config.json
2. 檢查 schedule.enabled 是否為 true、channels 是否非空
3. 若任一條件不符（未完成設定），立即透過 OpenClaw 已啟用的頻道發送以下訊息：

🦞 大草原匯率計算器尚未完成設定

請選擇：
1. 快速設定
2. 自訂設定

4. 等待使用者回覆：

   • 回覆 1 或「快速設定」→ Agent 執行：

     python scripts/cny_rate.py --auto-setup
     

     自動套用基本設定（第一個已啟用頻道 + 預設排程：週一至週五 09:00–17:00 每小時）， 並回覆：「✅ 已套用基本設定，排程通知即將啟動。如需調整請輸入『設定匯率』。」
   • 回覆 2 或「自訂設定」→ Agent 在伺服器端執行：

     python scripts/cny_rate.py
     

     並回覆：「✅ 設定精靈已啟動，請依照終端提示完成設定。」

5. 設定精靈完成後自動將排程寫入 ~/.openclaw/cron/jobs.json

規則二：排程觸發事件 → 執行匯率通知

當收到系統事件「執行人民幣匯率計算並發送通知」時：

1. 先確認 config.json 的 schedule.enabled 為 true 且 channels 非空
2. 若已完成設定，執行：

   python scripts/cny_rate.py --run
   

3. 若尚未完成設定，改為執行設定精靈（同規則一步驟 3）

規則三：觸發設定精靈的關鍵字

使用者輸入以下任一關鍵字時，執行 python scripts/cny_rate.py：

• 設定匯率、匯率設定、初始化、重新設定
• setup、configure、init

⚠️ 使用前必須完成

本技能會自動檢測系統中已配置的頻道，並引導您完成設定。

🔍 自動檢測 + 交互式選擇 + 🧪 測試訊息

安裝後首次執行，技能會：

1. 自動掃描您的 OpenClaw 配置
2. 列出可用頻道讓您選擇
3. 自動保存配置
4. 🧪 發送測試訊息確認設定正確（就像印表機的測試頁！）

🧪 測試訊息流程

設定完成後，會詢問是否發送測試：

==================================================
🧪 設定完成！是否發送測試訊息？
==================================================

就像印表機安裝後列印測試頁一樣，
建議發送一次測試訊息確認設定正確。

發送測試訊息？(y/n): y

📤 發送測試訊息到 Telegram...
✅ 測試訊息發送成功！

測試訊息內容：

🦞 大草原匯率計算器 - 測試訊息

✅ 頻道設定：Telegram
✅ 排程設定：已啟用

這是一則測試訊息，確認設定正確。
正式匯率通知將依照排程時間發送。

測試時間：2025/03/16 12:00:00

1️⃣ 頻道設定（必需）

• 執行時自動檢測並提示選擇
• 或直接編輯 config.json
• 未設定頻道無法執行

2️⃣ 排程設定（必需）

• 編輯 config.json 設定發送時間
• 未設定排程無法執行

3️⃣ 🧪 測試訊息（建議）

• 設定完成後詢問是否發送測試
• 確認頻道設定正確
• 就像印表機的測試頁概念

設定流程

Step 0: 自動檢測（安裝後自動執行）

安裝後執行技能，會自動檢測您的 OpenClaw 配置：

==================================================
🔍 檢測到以下可用頻道:
==================================================

  1. Telegram
     狀態: 已啟用
     備註: 需要 Chat ID

  2. Discord
     狀態: 已啟用
     備註: 需要 Webhook URL

  3. Console (僅終端輸出，不發送)
  4. 取消設定

請選擇要使用的頻道 (1-4): 1

已選擇: Telegram
請輸入 Telegram Chat ID: 6462528054

✅ 已保存頻道配置: telegram

Step 1: 頻道設定（先完成）

根據自動檢測結果，編輯 config.json：

{
  "channels": [
    { "type": "telegram", "target": "YOUR_CHAT_ID" }
  ]
}

支援頻道：