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 创建时未选择相应的看板。