本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

DSH-pipeline-kernel

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:not-big-dog/DSH-pipeline-kernel

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 内核 = 管线无关的管理能力（通讯 / 台账 / UI 三大职责，见 docs/）；管线 = 数据（配置行）
• 业务能力（生图、视频等）是管线内部设置，不进内核
• 多语言：UI 与文档自动跟随 DSH 语言设置（中文 / English）
• 活动：各管线运行摘要（角色状态 / 进行中任务 / 最近完成 / 失败置顶）
• 管线：管线一等实体（Graph 缩略图 / KPI / 打包产物）；点击任务展开 Task Inspector

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后必须重启 dsh web 吗？

是。Cordis bundle 注册、HTTP 路由（/plugins/pipeline-kernel/state 等）和新工具命名空间都要重启 dsh web 后才生效；重启之后只有"新建的会话"会拿到 pipeline_* 工具，老会话工具目录是冻结的，需要重建会话。

这个内核自带预设管线吗？

不带。README 与 lib/index.js 明确说"默认无预置管线"——管线只是 pipelines 表里的一行配置，使用者用 pipeline_define 自行定义，第一条管线没有任何业务能力（生图、视频等）内置进来。

巡检（watchdog）能关掉吗？怎么调？

能。watchdog 默认开启，每 5 分钟跑一次（10 分钟补唤醒冷却、30 分钟静止汇报冷却）。在 cordis.patch.yml 的 pipeline-kernel 节点覆写 watchdogEnabled:false 即可关闭，或者改 watchdogStallMs、watchdogWakeCooldownMs 等参数；关掉后可以用 pipeline_reconcile 手动跑自愈。

归档和删除有什么区别？

归档（pipeline_archive）只是给管线打 archivedAt 标记、把它移到归档箱，所有任务/台账/收件箱/产物数据完整保留，可恢复。彻底删除（pipeline_purge）只在归档箱里才能执行，会把定义行从 pipelines 表删除——任务板和台账的历史记录会保留，但不再有关联。

怎么把一条做好的管线分享给别的项目？

用 pipeline_pack 生成打包文档（JSON+MD，落盘到 /packs/），再把这两个文件拷贝到目标项目，调用 /plugins/pipeline-kernel/pipeline-create 并在 body 带 fromPack 指向打包 JSON，一键恢复管线定义、播种会话并建齐节点目录。

工作文件夹和工作区会被卡得很死吗？

会卡。workspace.js 把所有路径强制在 projectRoot 之内；artifactRoot、inboxDir、pack 路径都必须是工作区下的相对路径、不能逃出去——这是为了防止 HTTP 端点（open-folder）被滥用，所以任意绝对路径都会被拒。

怎么卸载？

用 dsh plugin --profile web remove dsh-pipeline-kernel（自动从 profile.bundles 与 cordis.patch.yml 移除），重启 dsh web 即可；存在数据库里的 pipelines / tasks / ledger 数据需要手动清。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8+
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则