dsh-trello: 將 Trello 看板能力接入 DeepSeek Harness

DeepSeek Harness 的插件化設計允許將外部服務轉化爲原生工具。dsh-trello 是一個插件，它將 Trello 的看板、列表、卡片和評論轉化爲 DSH 的原生工具。

該插件由 Elec11 維護，開源（MIT）。它通過 Trello API Key + Token 認證，直接向 api.trello.com 發送 HTTPS 請求。它不依賴 OAuth 或 MCP，也不暴露公網域名或回調服務器。

核心功能¶

插件提供八種工具，覆蓋了 Trello 的主要操作：

1. trello_list_boards: 列出賬戶可訪問的看板
2. trello_get_board: 根據 ID 獲取單個看板
3. trello_list_lists: 列出指定看板內的列表
4. trello_list_cards: 列出指定列表中的卡片
5. trello_get_card: 根據 ID 獲取單個卡片
6. trello_create_card: 在列表中創建新卡片
7. trello_update_card: 更新卡片（僅修改提供的字段，通過 listId 可移動卡片）
8. trello_add_comment: 爲卡片添加評論

安裝與配置¶

安裝¶

使用 CLI 安裝插件（假設已安裝該插件包）：

dsh plugin --profile <profile> add <path>

或者通過 DeepSeek Harness 的圖形界面：在設置 -> 插件中，添加指向該文件夾絕對路徑的包。

配置¶

安裝完成後，需要在 cordis.patch.yml 中填入憑證。憑證讀取優先級爲：配置值 > 環境變量 TRELLO_API_KEY / TRELLO_TOKEN。

在插件的 cordis.patch.yml 中添加：

- id: tool-trello
  config:
    apiKey: PASTE_YOUR_API_KEY
    token: PASTE_YOUR_TOKEN

配置字段標記爲 secret，作爲易失性引用存儲。重啓 Harness 後，工具集會重建。

獲取憑證¶

1. 打開 Trello Apps Admin 創建新應用（App Type 選擇 Trello Auth）。
2. 複製 API Key 並生成 Token。
3. 建議使用僅包含所需權限的專用 Token。

只讀模式¶

插件默認處於完全模式。在設置 -> 插件 -> dsh-trello 中，可以切換“只讀模式”開關。

開啓只讀模式後，僅註冊以下五個只讀工具：
- trello_list_boards
- trello_get_board
- trello_list_lists
- trello_list_cards
- trello_get_card

創建、更新和評論工具將被註銷，防止智能體執行寫操作。

注意事項¶

• 刪除功能：當前版本未包含刪除卡片的功能。
• 錯誤處理：
  • 遇到速率限制會提示 Trello API request failed: rate limit exceeded. Retry after N seconds.，需等待 N 秒。
  • 服務端錯誤（HTTP 5xx）需等待或重試。
  • 認證失敗會提示檢查 Key 和 Token。
• 權限：若提示權限被拒，通常是因爲 Token 創建時未選擇相應的看板。