dsh-pre-duediligence

dsh plugin --profile web add dsh-pre-duediligence

访前尽调智能体 · dsh-pre-duediligence

拜访客户前，快速了解企业背景、经营动态与风险线索，整理值得核实的问题，生成可追溯的访前报告。面向银行客户经理、销售/BD、采购、投资及园区招商人员，在 DeepSeek Harness 原生会话中使用企查查 MCP 数据。

• 资料采集：确认企业主体，按拜访目标整理客观数据摘要与覆盖范围。
• 证据核验：区分事实、推断、支持与反证，突出风险线索及待确认事项。
• 报告与复访：在线预览，导出 HTML、Word、PDF；查看历史，继续尽调并保留报告版本。

[安装与上手](#安装与三分钟上手) · [功能概览](#功能概览) · [兼容说明](docs/COMPATIBILITY.md) · [更新日志](CHANGELOG.md) · [历史文档](docs/archive/legacy-changes/README.md)

当前发布版本：0.1.40。本版完善地区、分层行业、主营产品与规模的采集摘要，保留五阶段工作台及实验卡片默认关闭策略；详见 [发布说明](docs/RELEASE-0.1.40.md)。

安装与三分钟上手

访前尽调智能体：面向拜访前调查，提供企业尽调、客户尽调、客户背景调查、工商核验与风险信息整理；使用企查查 MCP，提供固定路由连续调用、主体确认、动态进度和可下载报告。

dsh plugin --profile web add dsh-pre-duediligence@0.1.40

请先满足下文的 DSH 与连接器要求；Better Sidebar 仅在需要可视化工作台时选装。安装后完整停止并重启对应 Profile。

进入“访前尽调”，在提示词生成器填写拜访对象、角色和目标，核对范围与输出要求后发送任务。发送即表示同意在固定业务路由内连续调用企查查 MCP，不再二次确认或受插件次数上限阻断；如果搜索命中多个主体，只需再选择唯一法律实体。

流程样例（示意，非真实调用结果）： 拜访目标与客户主体 → 必要时主体消歧 → 事实与未知项 → 支持/反对证据 → 现场必问与覆盖声明。

能力边界： 访前研究不等于完整 AML/KYB、审计或授信结论；Provider 自身的账户额度、产品权限和限流仍然有效。多候选须人工消歧，报告必须披露未知项与覆盖范围。

升级与回滚： 升级前停止 Profile 并备份任务目录，记录当前精确版本；使用上面的固定版本命令升级，再完整重启。回滚时将版本号替换为升级前记录的版本，并使用升级前任务目录副本；不以旧版直接读取已迁移任务目录。

相关智能体：数据清洗补全 · AI填表 · 访前尽调 · 招投标

开发与验收资料：[作用域契约](docs/TASK-SCOPE-HISTORY-CONTRACT.md) · [规范采用记录](docs/DSH-UX-001-ADOPTION.md) · [兼容与验收矩阵](docs/COMPATIBILITY.md) · [市场投稿登记](docs/MARKETPLACE.md)。自动化测试不等同于真实 DSH 与生产数据全链路验收。

面向 DeepSeek Harness 的 Session 级访前尽调智能体。业务人员从左侧菜单进入，在会话级工作台定义一次拜访；Agent 调用企查查五类 MCP，使用机会与风险双引擎完成经营状态识别、假设与反证、风险核验，最终交付可追溯的访前尽调报告。

功能概览

本版本参考 dsh-data-cleaning-agent 的独立智能体交互原则，以及 dsh-tender-workbench 的 Session-scoped Better Sidebar 工作台范式，并吸收产品 handoff v0.2 的访前推理规范。

工作台

• Better Sidebar 为可选工作台依赖，不是基础安装前置；缺失时保留原生会话、提示词生成、原生发送、Skill/工具链和会话报告阅读，点击工作台流程按钮时明确提示且不清空草稿或任务状态
• 只在 DSH 左侧菜单增加“访前尽调”入口；对应工作台标签在 Better Sidebar 的右侧“+”菜单中隐藏
• 访前专属 Session 直接归属当前 Workspace，不进入“未分组”；DSH 原生“新建会话”不会复用四款业务智能体的空 Session
• 菜单、首页与工作台统一使用企查查蓝 Mockup 的线性建筑 LOGO；初始页面为“访前尽调一页纸智能体”
• 点击左侧入口只创建并进入访前 Session，初始页不打开右侧工作台；点击输入框下方五项业务按钮后才打开对应视图
• 首页只保留简洁说明、DSH 原生输入框和输入框下方五项快捷菜单：对象与目标、范围确认、资料采集、证据核验、任务历史；菜单采用数据清洗补全式单行描边卡片，上图标下短标签，窄屏在容器内横向滚动
• “当前任务 / 任务历史”主导航与五阶段业务导航分离：

1. 对象与目标

2. 范围确认

3. 资料采集

4. 证据核验

5. 材料输出

• 右侧五阶段菜单采用招投标工作台样式：等宽分栏、图标在上、短标题在下；选中项使用浅蓝底、蓝字和底部蓝线，菜单不显示第二行描述并在窄屏内收缩
• 快捷菜单与阶段导航只切换视图，不伪造执行状态；只有捕获到完整报告后才显示“报告已生成”
• Better Sidebar 的 Session 单例 Tab 是唯一工作台容器；展开、收起、宽度、停靠和浮窗只由宿主管理，业务内容不提供同义箭头、X 或返回/关闭工作台按钮
• 宿主收起只改变可见性，宿主 Tab X 只移除业务 Tab；两者都不取消任务或删除历史、制品，从输入框下方同一组快捷按钮可聚焦或恢复并定位对应视图
• 当前任务、进度与工具记录只投影当前 Session 的 Host 任务与真实高层工具调用；异步轮询会动态更新资料采集、证据核验、用量和错误状态
• 任务历史从 Host 持久库汇总当前 DSH Profile 内所有访前尽调 Session，并标注来源 Workspace / Session；重新打开插件或进入新会话不会隐藏既有记录，也不会把旧任务认领为当前任务
• 完整报告保留在 DSH 原生会话中，并通过 previsit_finalize 存为 Host 报告制品；如果 Agent 遗漏完成工具，前端会将已捕获的合格八段报告回写 Host

点选拼句器

• 输入框左上角提供四步提示词生成器：拜访对象 → 角色场景 → 范围深度 → 确认输出
• 向导使用居中弹窗、固定头尾、滚动正文、Escape 关闭与 Tab 焦点环
• 生成结果只回填 DSH 原生输入框，不自动发送；已有草稿必须显式选择替换、追加或取消
• 前端不预选角色、档位或输出形态，默认逻辑只存在于 Skill
• 支持角色、拜访场合（首次 / 谈判前 / 复访）、重点关注、尽调深度和输出形态；签约/准入类核查归入「准入尽调」，定期复查归入「持续尽调」
• 拼句路由词与 Skill 逐字绑定，并有自动化契约测试
• 用户只在企业占位符处输入名称时，继续点选会保留企业名称
• 用户自由修改文本后进入保护模式，点选条件不会覆盖原文
• “按条件补充”只会另起一句追加要求
• 最终发送的是用户可见自然语言，不发送隐藏结构化参数

访前业务内核

• 五类 MCP：qcc-company、qcc-risk、qcc-ipr、qcc-operation、qcc-executive
• 唯一法律实体硬门；多候选必须停下消歧
• Agent-owned 执行链：previsit_begin → previsit_query(entity_search) → previsit_confirm_entity → previsit_query → previsit_finalize。Host 固定业务路由，经 ToolRuntime 调用；只有多候选主体需用户选择
• 用户发送任务即授权固定业务路由内的连续调用；fast / standard / deep 只控制覆盖优先级与目标深度，不设插件调用次数上限，也不弹出额度二次确认
• 机会轨：八种经营状态 → 状态 × 角色假设 → 支持/反对/未知 → 反证
• 风险轨：全量扫描 → 零计数不下钻 → 非零维度明细 → 拜访影响
• 行为信号超过 24 个月只作历史沿革
• 公开数据阶段禁止“高置信度”
• 银行对公客户经理状态内容库
• 八段访前尽调报告：核心研判、产业定位、近期动态、业务假设、红线提示、现场必问、触达开场、覆盖说明；作战交付阶段可一键下载 demo 样式的 HTML 报告

安装

前置条件：Node.js 22.19+（22 LTS）或 24 LTS、固定版本 DeepSeek Harness、可用的 pnpm，以及已经配置好的模型。基础 stable 基线为 DSH 0.1.1-rc.2 / Connector 0.2.32，基础 candidate 基线为 DSH 0.1.2-rc.1 / Connector 0.2.37。Better Sidebar 不默认安装；启用可视化工作台时，stable 配对 Sidebar 0.17.1，candidate 配对 Sidebar 0.18.1。若 candidate Profile 已安装可选的 dsh-context，已验证共存版本为 0.48.0；访前尽调本身不要求也不会自动安装 Context。

一键安装（推荐）

~~~bash

bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-pre-duediligence/main/install.sh)

~~~

安装脚本默认向 DSH Web profile 安装两个基础 Bundle：

1. dsh-mcp-connector@0.2.32：提供通用 MCP 连接器与市场，通过“企查查·企业工商”完成 OAuth，并动态挂载企业、风险、知产、经营、历史和董监高 MCP。

2. dsh-pre-duediligence@0.1.40：提供左侧智能体入口、原生会话首页、提示词生成器、Host 执行门和 Skill。

默认不会安装 Better Sidebar。需要 Session 级可视化工作台时显式开启：

~~~bash

DSH_PREVISIT_WORKBENCH=on bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-pre-duediligence/main/install.sh)

~~~

脚本先读取 JSON 插件清单并检查全部共同依赖；已有版本不匹配会在安装前停止，不自动降级或覆盖。现有匹配依赖跳过安装。候选组合使用 DSH_PREVISIT_BASELINE=candidate；开发包路径通过 DSH_PRE_DUEDILIGENCE_SPEC 指定。安装前完整停止对应 Profile 的 DSH Web。

两套工作台配对必须成套使用：不要把 DSH 0.1.2-rc.1 与 Sidebar 0.17.1 混装，也不要把 DSH 0.1.1-rc.2 与 Sidebar 0.18.1 混装。即使本次只安装基础智能体，只要 Profile 已存在会阻断宿主启动的不兼容 Sidebar，脚本仍会在任何写入前停止。升级到 candidate 时，先停止 DSH，再升级完整 DSH Host；若 Profile 已有 Context，则同步升级到 dsh-context@0.48.0，最后安装 Connector、访前插件及显式选择的 Sidebar 并完整重启。

~~~bash

DSH_PREVISIT_BASELINE=candidate bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-pre-duediligence/main/install.sh)

~~~

安装完成后停止旧的 DSH Web 进程并重新运行：

~~~bash

dsh web

~~~

首次使用时打开左侧“🧩 MCP连接器”，选择“企查查·企业工商”并完成 OAuth 授权。授权完成后会注册 qcc-company、qcc-risk、qcc-ipr、qcc-operation、qcc-history 和 qcc-executive，不需要分别安装这些 MCP Server。

手动安装

~~~bash

dsh plugin --profile web add dsh-mcp-connector@0.2.32

dsh plugin --profile web add dsh-pre-duediligence@0.1.40 --allow-build=node-pty,dsh-pre-duediligence

dsh web

~~~

如需 stable 工作台，停止 DSH 后另行安装 dsh-better-sidebar@0.17.1 --allow-build=node-pty；candidate 对应 dsh-better-sidebar@0.18.1。不要跨基线混装。

工作台检查 Better Sidebar 的 targetedOpen、stateSubscription 及注册/打开接口；Sidebar `0.1

…(truncated)