feat: Initial v0.9 release with API Key authentication

## v0.9.20260325_144654 ### Features - API Key Authentication System - Job Worker System - V2 Backup Versioning ### Bug Fixes - get_processor_results_by_job column mapping Co-authored-by: OpenCode
2026-03-25 14:52:51 +08:00
parent 47e86b696f
commit 383201cacd
193 changed files with 40268 additions and 422 deletions
--- a/docs/N8N_MCP_SETUP.md
+++ b/docs/N8N_MCP_SETUP.md
@@ -0,0 +1,211 @@
+# OpenCode n8n MCP 整合設定
+
+> 建立時間: 2026-03-23
+> 更新時間: 2026-03-23
+
+---
+
+## n8n MCP 工具列表 (43 個)
+
+### Workflows (10)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_workflows` | 列出所有 workflows |
+| `n8n_get_workflow` | 取得 workflow 詳情 |
+| `n8n_create_workflow` | 建立新 workflow |
+| `n8n_update_workflow` | 更新 workflow |
+| `n8n_delete_workflow` | 刪除 workflow |
+| `n8n_activate_workflow` | 啟用 workflow |
+| `n8n_deactivate_workflow` | 停用 workflow |
+| `n8n_execute_workflow` | 執行 workflow |
+| `n8n_get_workflow_tags` | 取得 workflow 標籤 |
+| `n8n_update_workflow_tags` | 更新 workflow 標籤 |
+
+### Executions (3)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_executions` | 列出執行記錄 |
+| `n8n_get_execution` | 取得執行詳情 |
+| `n8n_delete_execution` | 刪除執行記錄 |
+
+### Data Tables (8)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_datatables` | 列出資料表 |
+| `n8n_create_datatable` | 建立資料表 |
+| `n8n_get_datatable` | 取得資料表結構 |
+| `n8n_get_datatable_rows` | 取得資料表列 |
+| `n8n_insert_datatable_rows` | 插入資料列 |
+| `n8n_update_datatable_rows` | 更新資料列 |
+| `n8n_upsert_datatable_row` | 插入或更新資料列 |
+| `n8n_delete_datatable_rows` | 刪除資料列 |
+
+### Tags (5)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_tags` | 列出所有標籤 |
+| `n8n_get_tag` | 取得標籤 |
+| `n8n_create_tag` | 建立標籤 |
+| `n8n_update_tag` | 更新標籤 |
+| `n8n_delete_tag` | 刪除標籤 |
+
+### Credentials (4)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_credentials` | 列出憑證 |
+| `n8n_create_credential` | 建立憑證 |
+| `n8n_delete_credential` | 刪除憑證 |
+| `n8n_get_credential_schema` | 取得憑證 schema |
+
+### Users (3)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_users` | 列出使用者 |
+| `n8n_get_user` | 取得使用者 |
+| `n8n_delete_user` | 刪除使用者 |
+
+### Variables (3)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_variables` | 列出變數 |
+| `n8n_create_variable` | 建立變數 |
+| `n8n_delete_variable` | 刪除變數 |
+
+### 其他 (7)
+| 工具 | 說明 |
+|------|------|
+| `n8n_list_projects` | 列出專案 |
+| `n8n_create_project` | 建立專案 |
+| `n8n_update_project` | 更新專案 |
+| `n8n_delete_project` | 刪除專案 |
+| `n8n_generate_audit` | 產生安全審計報告 |
+| `n8n_health_check` | 健康檢查 |
+| `n8n_trigger_webhook` | 觸發 webhook |
+
+---
+
+## 安裝步驟
+
+### 1. 安裝 n8n MCP Server
+
+```bash
+npm install -g @nextoolsolutions/mcp-n8n
+```
+
+驗證：
+```bash
+which mcp-n8n
+# /opt/homebrew/bin/mcp-n8n
+```
+
+### 2. 取得 n8n API Key
+
+1. 開啟 n8n UI: `http://localhost:5678`
+2. 登入後點擊右上角 **Settings** → **API**
+3. 點擊 **Create New API Key**
+4. 複製產生的 key
+
+### 3. 設定 OpenCode MCP 設定檔
+
+建立或編輯 `~/.config/opencode/opencode.json`：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "gitea": {
+      "type": "local",
+      "enabled": true,
+      "command": [
+        "/opt/homebrew/bin/gitea-mcp-server",
+        "-token", "<GITEA_TOKEN>",
+        "-host", "http://localhost:3000"
+      ]
+    },
+    "n8n": {
+      "type": "local",
+      "enabled": true,
+      "command": ["/opt/homebrew/bin/mcp-n8n"],
+      "environment": {
+        "N8N_BASE_URL": "http://localhost:5678",
+        "N8N_API_KEY": "<N8N_API_KEY>"
+      }
+    }
+  }
+}
+```
+
+### 4. 驗證 MCP 運作
+
+重啟 OpenCode，確認 n8n MCP tools 可用。
+
+---
+
+## n8n API 端點
+
+n8n v2 REST API 路徑為 `/rest/`（不是 `/api/v1/`）
+
+| 端點 | 方法 | 說明 |
+|------|------|------|
+| `/rest/workflows` | GET | 列出 workflows |
+| `/rest/workflows/:id` | GET | 取得 workflow |
+| `/rest/workflows` | POST | 建立 workflow |
+| `/rest/workflows/:id` | PUT | 更新 workflow |
+| `/rest/workflows/:id` | DELETE | 刪除 workflow |
+| `/rest/workflows/:id/activate` | POST | 啟用 workflow |
+| `/rest/workflows/:id/deactivate` | POST | 停用 workflow |
+| `/rest/workflows/:id/execute` | POST | 執行 workflow |
+
+**認證方式：**
+```bash
+curl -H "X-N8N-API-KEY: YOUR_API_KEY" \
+     http://localhost:5678/rest/workflows
+```
+
+---
+
+## 疑難排解
+
+### API 404 問題
+
+如果 API 傳回 404，檢查：
+
+1. **n8n 是否運行中**
+   ```bash
+   curl http://localhost:5678
+   ```
+
+2. **n8n 初始設定（重要！）**
+   - 第一次使用必須在瀏覽器完成初始化
+   - 開啟 `http://localhost:5678`
+   - 按照畫面指示建立管理員帳號
+   - 完成後才能使用 API
+
+3. **API Key 是否正確**
+   ```bash
+   curl -H "X-N8N-API-KEY: YOUR_KEY" \
+        http://localhost:5678/rest/workflows
+   ```
+
+### n8n 初始設定（第一次使用）
+
+1. 開啟瀏覽器: `http://localhost:5678`
+2. 輸入 email 和密碼建立管理員帳號
+3. 完成後進入 Settings → API
+4. 建立 API Key 並複製
+
+### CLI Import vs PostgreSQL
+
+n8n 使用 PostgreSQL 儲存資料：
+- CLI `n8n import:workflow` 可能寫入 SQLite
+- 手動在 UI import 會寫入 PostgreSQL
+
+建議直接使用 UI 或 MCP import。
+
+---
+
+## 相關文件
+
+- [OPENCODE_GUIDE.md](./OPENCODE_GUIDE.md) - OpenCode 使用規範
+- [INSTALL_N8N.md](./INSTALL_N8N.md) - n8n 安裝指南
+- [N8N_DEMO_WORKFLOW.md](./N8N_DEMO_WORKFLOW.md) - n8n Workflow 範例