共识管线装完没反应？先查这五处

共识管线装完没反应先查这五处fangqian616/dsh-consensus-pipeline装起来只有一行命令装完「没反应」却分好几种点了没动静、直接抛错、跑到一半停住、界面中英混排。四类现象分属宿主插件层、Python 运行时层和管线自身的交互设计先按症状定位比从头重装省时间。先把症状对上位置症状大概率位置第一动作面板能开点开始没反应缺DEEPSEEK_API_KEYPhase 0 调不通查环境变量安装报路径不存在file:路径与 npm 包名混用确认是否 clone 过报 python 不存在或版本低没有 Python 3.10python3 -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 是设计出来的交互断点辩论几轮之后管线把「确实被引用、但缺全文且必要」的少数论文列成待导入清单停下来让你选暂停、继续还是跳过。它本来就在等人不是故障。导入的论文标weightcore确保进报告。解决。看面板提示选「跳过」就能继续想提高置信度就先把 PDF 放进fulltext_papers/再继续。无人值守的长任务都会挂在这一步。坑五 · 英文模式下标签中英混排现象。用--lang en出报告界面或文档里一部分标签是英文、一部分仍是中文。原因。README 把它列在Whats still rough第一条按 P0 记着属于已知未修完的翻译覆盖问题功能不受影响纯粹是显示层。解决。要么用默认的--lang zh要么接受混排。它不影响置信分与核验结论也不影响导出的 Markdown / DOCX / PDF 正文产出要直接给人看出稿前人工过一遍标签即可。还是不行怎么取证三步够用。第一看日志报错通常在最前面几行。第二看 Pythonpython3 -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 自动整理数据来源于插件详情页。