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

快速上手

deepseek-harness-sdr-plugin

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @xuxchloris/dsh-sdr

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

— 源: plugins.install

关键要点

• 只验证过 DSH 0.1.0-rc.6，其他版本未测。
• 默认 JSON 存储适合本地和单实例；多实例部署用 PostgreSQL adapter。
• 真实邮件、WhatsApp、CRM connector 不随包提供，只有接口和 dry-run 实现。
• 当前会话不支持 agent 交互提问时，审批请求会失败，任务冻结在原地，不会跳过审批继续跑。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后 DSH Web 模式菜单里没有「SDR 数字员工」怎么办？

重新执行 dsh plugin --profile web add ...，然后重启 dsh web 并新建一次会话；旧会话仍使用旧 preset，需要新建才能看到。源码见 README.md:21-23 与 cordis.patch.yml:3-6。

真实邮件会发出去吗？

默认不会。内置 Email / WhatsApp / CRM 三个 connector 的 send() 都返回 blocked-dry-run，没有真实凭证也不会触发实际发送。需要对接真实渠道时，由部署方注册自己的 connector 实现，审批流程不变。源码见 lib/domain.js:250-252 与 README.md:118-120。

开发信改过之后，原来的批准还算数吗？

不算。每条批准凭证绑定的是草稿内容的 SHA-256 哈希，只要 subject 或 body 变化，调用 sdr_review_drafts 就会被拒绝，必须重新审批。源码见 lib/domain.js:471-473。

任务状态保存在哪里？怎么改成自定义路径？

默认写入 $DSH_HOME/.dsh-sdr/state.json（Windows 下若未设 DSH_HOME，则为 %USERPROFILE%\.dsh\.dsh-sdr\state.json）。可通过环境变量 DSH_SDR_DATA_FILE 覆盖路径。源码见 lib/domain.js:652-655。

审批阶段卡住、返回 fetch failed 怎么办？

这意味着当前会话不支持向用户发起交互式提问（比如某些 CLI 模式或 headless 环境）。任务不会绕过审批继续推进，会冻结在 human_approval 阶段；改用支持交互的 DSH Web 模式菜单会话即可。源码见 README.md:43。

多实例部署能不能共享数据？

默认的本地 JSON 存储只适合单实例。多实例或生产环境请注入 PostgresKnowledgeRepository，并自己提供 pg pool、embedder、reranker；任务状态仍由部署方负责共享存储。源码见 lib/postgres-rag.js:81-92 与 README.md:146-147。

不想让 Agent 写入知识或改 connector 配置，应该怎么部署？

默认就是「不允许」。DSH_SDR_AGENT_KNOWLEDGE、DSH_SDR_AGENT_CONFIG、DSH_SDR_AGENT_LIVE_CONFIG 三个开关全部默认关闭，只有显式设为 1 才放行；且 Agent 写入密码、token、API key 等敏感字段会被拒绝。源码见 lib/index.js:155-157 与 lib/domain.js:84。

没有 DSH Web 也能跑吗？

可以做离线演示。在 packages/dsh-sdr 目录执行 npm test 跑 7 个 node:test 单元测试，或执行仓库根 scripts/demo_dsh_sdr.mjs 跑端到端 demo，全部使用合成数据，不需要任何凭证。源码见 README.md:60-65。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=20
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则