A 股智能投顾哨兵

Project Sentinel

A 股智能投顧系統，透過 AkShare 採集即時行情，Gemini AI 分析，輸出交易建議。

使用方式

重要: 必須先 cd 到專案目錄，並啟動虛擬環境。

產生分析報告

# 午盤分析（預設），輸出到終端
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday

# 收盤復盤
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode close

# 早報
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode morning

# 產生並推送到 Telegram
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target telegram

# 同時推送到飛書和 Telegram
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target feishu telegram

# JSON 格式輸出（供程式消費）
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --output json

追問分析

# 追問最近一次分析
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "黃金ETF今天怎麼樣"

# 追問指定日期
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "半導體板塊情況如何" --date 2026-02-07

# 追問收盤分析
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "明天怎麼操作" --mode close

趨勢分析

# 一週趨勢（自動偵測趨勢關鍵字）
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "最近一週市場趨勢如何"

# 一個月趨勢
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "這個月持倉表現怎麼樣"

使用場景

⚠️ 核心路由規則（必須嚴格遵守）:

• 只有使用者**明確要求「跑分析/產生報告/推送」**時，才執行 --mode 命令
• 所有其他問題（包括追問、評價、詢問準確率、閒聊等）一律使用 --ask "使用者的原始問題" 轉發給 Sentinel CLI
• 禁止自行編造回答來代替 CLI 輸出。必須執行命令並將 stdout 原樣回傳給使用者
• 當不確定該用哪個命令時，預設使用 --ask

產生報告（僅當使用者明確要求產生/跑/推送時）

當使用者說：

• "跑一下午盤分析"
• "產生收盤復盤"
• "早報分析一下"

執行：cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday

推送 Telegram

當使用者說：

• "把分析推到 Telegram"
• "推送到 Telegram"
• "發一下午盤報告"

執行：cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target telegram

同時推送飛書和 Telegram

當使用者說：

• "推送到所有渠道"
• "飛書和 Telegram 都發"

執行：cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target feishu telegram

所有其他問題（追問、準確率、評價、閒聊等）

當使用者說任何非「產生報告」的話，包括但不限於：

• 追問標的：「黃金ETF今天怎麼樣」、「紫金礦業能買嗎」
• 準確率相關：「準不準」、「準確率」、「命中率」、「靠譜嗎」、「可信嗎」、「勝率」
• 趨勢相關：「最近一週市場走勢」、「這個月持倉趨勢」
• 其他任何問題

一律執行：cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "使用者的原始問題"

將 stdout 輸出原樣回傳給使用者，不要自行加工或編造內容。

資料快取

• SQLite 資料庫: data/sentinel.db
• JSON 快照: data/latest_context.json
• 支援歷史回放: --replay 參數