共识管线装完没反应？先查这五处
@fangqian616/dsh-consensus-pipeline装起来只有一行命令，装完「没反应」却分好几种：点了没动静、直接抛错、跑到一半停住、界面中英混排。四类现象分属宿主插件层、Python 运行时层和管线自身的交互设计，先按症状定位，比从头重装省时间。
先把症状对上位置
| 症状 | 大概率位置 | 第一动作 |
|---|---|---|
| 面板能开，点开始没反应 | 缺DEEPSEEK_API_KEY，Phase 0 调不通 | 查环境变量 |
| 安装报路径不存在 | file:路径与 npm 包名混用 | 确认是否 clone 过 |
| 报 python 不存在或版本低 | 没有 Python 3.10+ | python3 -V |
| 进度长时间停在某处 | Phase 5.5 等导入 PDF | 选继续或跳过 |
| 界面中英混排 | 英文模式标签未译完 | 换--lang zh |
表里顺序不是随意的：越靠前越常见，也越容易被误判成「插件坏了」。装之前先确认装的是不是这个名字，同类插件清单可以先扫一眼 DeepSeek Harness Hub 插件清单，免得把名字相近的 fork 当成同一件东西。
五个坑，按排查顺序
坑一 · 装上了却跑不动，先怀疑 Python 而不是 Node
现象。插件显示已启用，右下角 📊 按钮也出来了，点开面板、填主题、按开始，几秒后报错或干脆没有下文，控制台只有一行 Python 堆栈。
原因。这不是纯 Node 插件。宿主侧只注册原生工具与/consensus-pipeline/面板路由，MCP server 甚至只用标准库、零依赖；但真正干活的管线是 Python 写的，要Python 3.10+（建议 3.11+）、git和pip install -r requirements.txt，首次装依赖约 1–2 分钟。MCP server 能启动，不等于辩论能跑。
解决。先python3 -V确认版本，低于 3.10 就先升 Python；再进项目目录手动装一次依赖，看有没有编译型包报错。装依赖放在前台跑，别塞进后台静默步骤，否则失败信息会被吞掉。
坑二 · 手册里的 file: 路径，和站点的包名不是同一条路
现象。照着仓库 README 敲dsh plugin --profile web add file:./consensus-pipeline/dsh-plugin，报路径不存在，或提示找不到dsh-plugin目录。
原因。README 面向「已经把仓库 clone 到本地」的人，file:是相对路径，前提是当前目录下真有consensus-pipeline/dsh-plugin；站点给的是 npm 包名@fangqian616/dsh-consensus-pipeline，不需要本地源码。两条路各自合法，混着用必然失败。
解决。没 clone 过就用包名那条；想改代码、要读实现，再走file:。判断很朴素：ls consensus-pipeline/dsh-plugin有输出才谈得上用file:。npm 包最新 0.2.0，未声明engines、无依赖，这也解释了它为什么装得上却跑不动——包很薄，重量全在 Python 侧。
坑三 · 卡在需求访谈，多半是少了 DEEPSEEK_API_KEY
现象。面板能开、按钮能点，任务刚起步就停住或报鉴权错误，检索阶段一篇论文都没出现。
原因。管线从 Phase 0 的需求访谈就开始调 LLM，不是等到辩论才用模型。DEEPSEEK_API_KEY没设、设在了另一个 shell、或写进没被加载的配置，都会让它在最前面断掉，看起来像插件没反应，实际请求根本没发出去。
解决。在启动 DSH 的同一个 shell 里export DEEPSEEK_API_KEY=...，再重启宿主。想确认密钥可用，用curl https://api.deepseek.com/v1/models -H "Authorization: Bearer $DEEPSEEK_API_KEY"试一次，比反复点开始快。密钥只影响调模型，不影响检索——但 Phase 0 过不去，后面全都不会开始。
坑四 · 跑到一半停住，Phase 5.5 在等你导入 PDF
现象。进度到中后段后长时间不动，日志不报错，机器也不忙。
原因。Phase 5.5 是设计出来的交互断点：辩论几轮之后，管线把「确实被引用、但缺全文且必要」的少数论文列成待导入清单，停下来让你选暂停、继续还是跳过。它本来就在等人，不是故障。导入的论文标weight=core，确保进报告。
解决。看面板提示，选「跳过」就能继续；想提高置信度就先把 PDF 放进fulltext_papers/再继续。无人值守的长任务都会挂在这一步。
坑五 · 英文模式下标签中英混排
现象。用--lang en出报告，界面或文档里一部分标签是英文、一部分仍是中文。
原因。README 把它列在What's still rough第一条，按 P0 记着，属于已知未修完的翻译覆盖问题；功能不受影响，纯粹是显示层。
解决。要么用默认的--lang zh，要么接受混排。它不影响置信分与核验结论，也不影响导出的 Markdown / DOCX / PDF 正文；产出要直接给人看，出稿前人工过一遍标签即可。
还是不行，怎么取证
三步够用。第一，看日志，报错通常在最前面几行。第二，看 Python：python3 -V和依赖列表各对一遍，很多「跑不动」是 3.9 下装的包在 3.11 里找不到。第三，看路由：DSH 面板走/consensus-pipeline/，独立跑是streamlit run app.py，默认http://localhost:8501；面板打不开就先用独立入口验证管线本身。
装之前还该知道两件事：它需要联网，安全扫描结果是 🔵 含敏感能力、尚无人工评估。这不影响排错，但影响你要不要在有权限的机器上跑它。
总结
五个坑没有一个是「插件写坏了」：两个是环境（Python、密钥），一个是路径口径，一个是设计（Phase 5.5 等人），最后一个是已知显示瑕疵；按顺序排查，多数「没反应」第一步就能定性。想对照同类插件的中文清单见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：愿意先配好 Python 3.10+ 与依赖的人；需要带置信度与引用核验的文献综述、愿意读引用标注的人；能接受中途停下来导 PDF 的人；想在面板里发起长任务的人。
不适合：要纯 Node 零依赖、装完就能跑的人；不愿碰 Python 与 pip 的人；要无人值守全自动、不能中途处理交互断点的人；想要「一键出终稿、不看引用」的人。
标签：consensus-pipeline、DeepSeek Harness、DSH 插件排错、文献综述
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
