42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
# 問 AI 設定指南
|
||
|
||
## 1. 填入 API Key
|
||
|
||
側邊欄 **設定**，或開啟 `app/.env`：
|
||
|
||
```env
|
||
# 擇一或兩者都填，並選預設 provider
|
||
GROK_API_KEY=xai-...
|
||
GROK_MODEL=grok-3-mini
|
||
OPENCODE_GO_API_KEY=...
|
||
OPENCODE_GO_MODEL=...
|
||
AI_ACTIVE_PROVIDER=grok
|
||
|
||
# 總經資料（非 AI，但基地/市場需要）
|
||
FRED_API_KEY=...
|
||
```
|
||
|
||
儲存後後端立即生效；改 `PORT` 需重啟 `node server.js`。
|
||
|
||
## 2. 使用方式
|
||
|
||
- 右下角 **金幣貓頭鷹**：全站浮動問答
|
||
- 卡片右上角 **問 AI**：自動附上該卡片的頁面 context
|
||
- **技能快捷**：依頁面預設提問（可擴充為 skill / MCP）
|
||
|
||
## 3. Provider 架構
|
||
|
||
| Provider | 端點 | 環境變數 |
|
||
|----------|------|----------|
|
||
| Grok (xAI) | `api.x.ai/v1/responses` | `GROK_API_KEY`, `GROK_MODEL` |
|
||
| OpenCode Go | `opencode.ai/zen/go/v1/chat/completions` | `OPENCODE_GO_API_KEY`, `OPENCODE_GO_MODEL` |
|
||
|
||
後端代理：`POST /api/ai/chat`、`POST /api/ai/context`、`GET /api/ai/status`
|
||
|
||
## 4. Context 附帶內容
|
||
|
||
| 頁面 | view | 資料 |
|
||
|------|------|------|
|
||
| 基地 | `hub` | 總經分數、訊號、羅盤 |
|
||
| 市場世界 | `market` | 同上 + 分頁（板塊/日曆）|
|