dsh-jenkins-panel
面向 Jenkins 的 DeepSeek Harness (dsh) 插件：让 dsh 里的 AI 直接触发、跟踪、排查 Jenkins 构建，并提供一个 dsh 官方右侧栏可视化面板。
DeepSeek Harness (dsh) plugin for Jenkins: AI-invocable jenkins_* tools, a panel on the dsh official right-sidebar, connection & token settings card, and automatic build-failure analysis pushed back into the triggering session.
功能
- AI 工具（host 半）：22 个
jenkins_* 工具对模型可见——构建触发/状态/日志/历史/产物、任务搜索与智能解析（多候选停下询问）、队列/工作空间/连接测试等；触发成功自动写入触发记录注册表（持久化，跨重启保留）。
- 右侧栏面板（client 半）：接入 dsh 官方右侧栏，含总览（对话触发的构建记录 + 状态过滤实时刷新）、任务（多连接切换 + 多层级折叠树 + 搜索）、构建详情（日志 tail/分段/自动跟随、产物下载、工作空间清理）。
- 失败自动分析：对话触发的构建失败（FAILURE）后，自动向触发会话回推一条分析任务书，由会话内 AI 只读排查日志并输出结构化失败总结（结论 / 关键报错 / 可能原因 / 修复建议）。可在配置中关闭。
- 连接与凭据：多 Jenkins 连接管理走 dsh 官方设置页分区；每连接 Token 存 dsh 凭据服务（credential-ref），明文不落配置。
- 插件页配置（dsh 0.2.0+）：在 dsh 插件管理页可直接查看并配置本插件（
plugins.bundle.config / plugins.row.config 槽位）——连接管理、默认连接、失败自动分析开关，与设置页卡片同源同款；配置持久化到 profile patch（经宿主 ConfigEditor 校验/持久化）。
安装
前置：dsh 0.2.0-rc.2+（web profile）。适配 dsh 0.2.0-rc.2（next dist-tag）；peer 范围 ^0.2.0-rc.2，不再兼容 0.1.x。安装/升级时请显式指定版本（@0.2.0-rc.2 或 @next），勿依赖 latest 标签（当前异常，停在 0.0.1-rc.1）。
# npm 发布版（推荐，构建产物随包分发）
dsh plugin --profile <name> add dsh-jenkins-panel@<version>
也可以直接从 GitHub 安装（仓库内 prepare 脚本会在安装时自动构建）：
npm install github:developerdh/dsh-jenkins-panel
每次版本发布（v* tag）会由 CI 自动构建并挂到 Releases，可下载 dsh-jenkins-panel-<版本>.tgz 后 npm install <tgz 路径> 安装。
安装后在 dsh 设置页「Jenkins 连接」分区配置连接（URL/用户名/超时）与每连接 Token，重载页面即可在右侧栏与顶部栏入口看到面板。
配置速览
| 配置段 | 默认值 | 说明 |
|---|
defaultConnection | default | 缺省连接名 |
connections | [] | 连接清单（name/url/username/timeout；name 参与凭据 ref 派生，需唯一） |
registry.maxPerSession | 200 | 每会话保留的触发记录条数 |
registry.ttlDays | 30 | 触发记录保留天数 |
registry.pollIntervalMs | 15000 | 在途构建状态轮询间隔 |
analysis.enabled | true | 构建失败自动分析总开关（含常驻轮询） |
analysis.tailLines | 100 | 分析任务书建议的首拉日志行数 |
本地开发
pnpm install
pnpm build # host 半（tsup）+ client 半（esbuild → ModuleLoader 协议产物）
pnpm test # vitest 单测
pnpm lint # eslint
pnpm typecheck # tsc 双 tsconfig
挂载调试：cordis.patch.yml 向 profile 组合插入本插件（dsh web --patch ./cordis.patch.yml）。
商标与归属
License
MIT
