前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」，旨在将外部服务能力无缝接入 AI 工作流。在 CI/CD 场景中，Jenkins 是常用的构建引擎，但传统的对接方式往往需要编写额外的脚本或通过 API 手动触发，缺乏与 AI 对话的直接交互能力。
dsh-jenkins-panel 插件解决了这一割裂。它通过在 DSH 中暴露 22 个 jenkins_* 工具，让 AI 能够直接触发、查询、跟踪 Jenkins 构建，并在 DSH 官方右侧栏提供可视化的交互面板，将构建状态与日志分析闭环。
插件定位¶
dsh-jenkins-panel 是一个面向 Jenkins 的 DeepSeek Harness 插件，由开发者 developerdh 维护。它主要解决两个问题：一是让 AI 模型具备调用 Jenkins API 的能力，二是为开发者提供一个可视化的右侧栏面板，用于监控和管理构建任务。
核心功能¶
1. AI 工具（Host 半）¶
插件在 Host 端暴露了 22 个以 jenkins_ 开头的工具，供 AI 模型直接调用。这些工具覆盖了构建生命周期的全流程：
- 构建控制：触发构建、查询状态、获取日志、查看历史记录、下载产物。
- 任务管理：任务搜索与智能解析（遇到多候选时暂停并询问）。
- 运维操作：查看队列状态、清理工作空间、测试连接。
- 持久化记录：触发成功后自动写入触发记录注册表，数据跨重启保留。
2. 右侧栏面板（Client 半）¶
在 Client 端，插件接入 DSH 官方右侧栏，提供可视化的构建管理视图：
- 总览：展示对话触发的构建记录，支持按状态实时过滤和刷新。
- 任务树：多 Jenkins 连接切换、多层级折叠树形结构、任务搜索。
- 构建详情：日志实时滚动（tail/分段/自动跟随）、产物下载、工作空间清理。
3. 失败自动分析¶
当对话触发的构建状态变为 FAILURE 时，插件会自动向触发会话回推一条分析任务书。AI 只读模式排查日志后，输出结构化的失败总结，包含结论、关键报错、可能原因及修复建议。该功能可在配置中关闭。
4. 插件页配置（dsh 0.2.0+）¶
在 dsh 插件管理页（0.2.0+ 版本），可直接通过 plugins.bundle.config / plugins.row.config 槽位配置插件。支持连接管理、设置默认连接、以及开关失败自动分析功能。配置持久化到 profile patch。
安装与启用¶
前置要求：dsh 版本需在 0.2.0-rc.2 及以上（web profile），不再兼容 0.1.x。
安装步骤：
- 确保本地安装了兼容版本的 dsh。
- 执行以下命令安装插件（请显式指定版本，例如
@0.2.0-rc.2或@next）：
dsh plugin --profile <name> add dsh-jenkins-panel@<version>
启用与配置：
安装完成后，进入 dsh 设置页的「Jenkins 连接」分区，配置连接信息（包括 URL、用户名、超时）以及每连接对应的 Token。重载页面后，即可在右侧栏与顶部栏入口看到插件面板。
典型用法¶
- 配置连接：在设置页完成 Jenkins 连接的配置与 Token 绑定。
- 触发构建：在 DSH 对话中，利用
jenkins_trigger等工具直接触发构建。 - 排查失败：构建失败后，查看右侧栏的构建详情，或等待 AI 自动推送的分析任务书。
- 切换连接：在右侧栏面板的任务视图中，切换不同的 Jenkins 连接进行管理。
适用场景与注意¶
本插件适合需要在 DSH 环境中直接管理 Jenkins 任务、利用 AI 辅助排查构建问题的开发者。
- 版本兼容：请务必使用 0.2.0-rc.2+ 版本的 dsh，且安装时显式指定版本标签（如
@0.2.0-rc.2），避免使用latest标签（当前异常，停留在 0.0.1-rc.1）。 - 权限与来源：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。
- 商标声明：Jenkins® 是 LF Charities, Inc. 的注册商标。本插件为独立的第三方工具，与 Jenkins 官方项目及 LF Charities 无隶属或背书关系；插件内使用的 Jenkins 图标依据 CC BY-SA 3.0 许可分发。
结语¶
dsh-jenkins-panel 通过标准化的工具接口和可视化的面板，将 Jenkins 的构建能力深度集成到 DeepSeek Harness 中，让 AI 能够更直接地参与 CI/CD 流程。更多细节可参考插件目录或 GitHub 仓库。
