一個專為股票市場 AI 代理提供市場感知資料快取與交易狀態偵測的工具模組。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install shared
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 shared。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Stock Cache Utils？
Stock Cache Utils 是一個強大的技術模組，旨在為金融交易技能提供統一的快取機制。它透過區分活躍交易時段與盤後時間來智慧管理股票市場資料，確保 AI 代理在保持高效能的同時最大限度地減少不必要的 API 呼叫。該工具是開發者在金融科技領域構建複雜 Openclaw Skills 的核心組件。
該技能專門針對 A-share 市場，提供交易時段自動偵測與 24 小時過期管理。透過實施此工具，開發者可以確保其代理在市場活躍時使用即時資料，並在非交易時段轉向高速快取資料，從而提供無縫且具成本效益的資料策略。
Stock Cache Utils 應用場景
- 透過在非交易時段檢索快取的市場快照，降低股票分析代理中的 API 延遲。
- 實現市場感知邏輯，使代理僅在有效的 A-share 交易時段內觸發即時交易。
- 為金融研究代理管理本地資料持久化，以維護 24 小時的回溯視窗。
- 構建具備韌性的金融 Openclaw Skills，當即時資料源不可用時，能夠優雅地降級至快取資料。
Stock Cache Utils 運作原理
- 該工具初始化一個本地快取目錄，具有可配置的存活時間 (TTL)，預設為 24 小時。
- 它執行交易狀態檢查，以確定目前系統時間是否處於 A-share 交易時段內（交易日的 9:30 - 15:30）。
- 根據市場狀態，邏輯分為：在活躍交易期間優先處理新鮮資料，或在非交易時段檢查有效的本地快取。
- 資料將連同元資料一起序列化並儲存到本地磁碟，以便於檢索與壽命驗證。
- 系統會自動計算下一個交易時段，以幫助代理排程未來任務。
Stock Cache Utils 設定指南
要將此工具整合到您的 Openclaw Skills 環境中，請確保您執行的是 Python 3.10 或更高版本。由於它沒有外部依賴項，安裝非常簡單：
# 導航至您的技能目錄
cd your-skill-folder
# 將模組導入您的 Python 環境
# 確保 cache_utils.py 在您的 PYTHONPATH 中
在腳本中初始化快取：
from cache_utils import StockDataCache
cache = StockDataCache(cache_dir='.\/.cache', cache_max_age_hours=24)
Stock Cache Utils 資料結構與分類體系
該工具使用基於目錄的儲存系統組織資料。元資料分類包含以下交易狀態欄位：
| 欄位 | 類型 | 描述 |
|---|---|---|
current_time |
String | 檢查的 ISO 時間戳記 |
is_trading_day |
Boolean | 如果今天是有效的市場工作日，則為 True |
is_trading_time |
Boolean | 如果在 9:30-15:30 時段內，則為 True |
next_trading_time |
String | 下一次開盤的時間戳記 |
Stock Cache Utils 進階特性
- 專門針對 A-share 市場時間調整的智慧交易狀態偵測。
- 具有可客製化 TTL（小時）的自動快取過期管理。
- 容錯機制，允許代理使用最近的有效快取離線運作。
- 輕量化設計，零外部庫依賴，確保在不同 Openclaw Skills 環境中的最大相容性。
SKILL.md
加載中
Openclaw 相關技能
UPLO Education
UPLO Education 是一個 AI 驅動的機構知識管理系統，它將碎片化的學術、認證和行政數據統整為單一可搜尋的智能層。
Parameter Golf 監控器
一款專門的監控工具，透過從 GitHub PR 中提取並排名 val_bpb 分數來追蹤 openai/parameter-golf 競賽。
精選*
