duhu2000/dsh-pre-duediligence

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

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

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

安装与上手 · 功能概览 · 兼容说明 · 更新日志 · 历史文档

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

安装与三分钟上手

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

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

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

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

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

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

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

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

开发与验收资料：作用域契约 · 规范采用记录 · 兼容与验收矩阵 · 市场投稿登记。自动化测试不等同于真实 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 <(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 级可视化工作台时显式开启：

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 并完整重启。

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

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

dsh web

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

手动安装

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.18.1 已通过隔离真实宿主的入口、Tab 恢复、视图定位与草稿回填验收，真实企查查 Provider 结论仍以验收矩阵为准。安装命令显式允许插件构建；Better Sidebar 使用的 node-pty 也需要允许构建。

如果 pnpm 仍提示 Ignored build scripts，请按终端提示在 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 中允许对应包，然后重新执行失败的安装命令。

安装后检查

dsh plugin --profile web list --depth 0

应始终看到所选基线的 Connector 和 dsh-pre-duediligence@0.1.40；仅在显式启用或原本已安装时看到 Sidebar。重启 DSH 并连接“企查查·企业工商”后，在左侧菜单点击“访前尽调”进入初始原生会话。无 Sidebar 时可继续生成提示词、回填/发送草稿并在会话中阅读报告；五项流程按钮会提示安装可选工作台。安装 Sidebar 时，右侧工作台初始仍关闭；点击业务按钮可主动打开，正式发送任务被接纳后会自动展开一次。仅回填不会展开，收起后轮询不会重新打开。其右侧“+”菜单不会列出该入口，普通会话保持 DSH 原样。

无 Sidebar 功能边界

无 Sidebar 不等于已完成业务验收：未配置模型或企查查连接时只能验证入口、提示词和草稿流程，不能声明数据查询或报告成功。

从旧访前尽调包迁移

新旧包会注册同一项访前能力，请勿同时安装。若 Web profile 已有 qcc-previsit-dsh，先执行：

dsh plugin --profile web remove qcc-previsit-dsh

然后安装 dsh-pre-duediligence 并完整重启 DSH。安装脚本检测到旧包时会停止并提示，不会自动删除用户现有插件。

从旧企查查 OAuth 插件升级

如果 Web profile 已安装 qcc-dsh-mcp-oauth，不要让它与 MCP 连接器同时管理同名企查查 Server：

1. 先按选定基线安装 MCP 连接器和访前插件，完全重启 DSH。
2. 打开“🧩 MCP连接器”，按界面提示迁移旧企查查授权；也可以重新连接“企查查·企业工商”。
3. 先确认新连接健康，并在新连接上成功完成一次真实企业查询。
4. 查询成功后停止 DSH，执行 dsh plugin --profile web remove qcc-dsh-mcp-oauth，然后完整重启并复核连接。

连接器只复制旧授权，不会自动删除旧插件或旧凭据；确认新连接可用后再移除旧插件。

本地开发

0.1.30 包含产品 fix11 合并增量：工作台「拜访客户」旁可导入 PNG、JPEG、WebP 或 PDF（最大 8 MiB），原生输入框支持拖入、粘贴。识别需要已连接支持本机 file_path 的文档解析 MCP；缺失时可改发文字名单。候选企业在计划卡或会话交互中确认后逐家执行，每家独立保存报告。报告框架可选择重点展开段落，最终仍保留八段。图片凭证仅在来源会话使用，15 分钟后过期。具体合并范围见 fix11 合并记录。

git clone https://github.com/duhu2000/dsh-pre-duediligence.git
cd dsh-pre-duediligence
pnpm install
pnpm check
pnpm test:ui

pnpm check 会执行 TypeScript 类型检查、Vitest 测试和 Host/Client 构建。pnpm test:ui 使用本机 Headless Chrome，在隔离宿主中检查浅色/深色与桌面/移动布局，不连接真实 DSH 或企查查服务。

人工验收

1. 在 DSH 选择一个工作空间和 Session。
2. 点击左侧“访前尽调”，确认只进入专属初始会话，右侧工作台保持关闭；同时右侧 Better Sidebar 的“+”菜单不出现该入口，普通会话保持 DSH 原样。
3. 点击“访前尽调”，确认首页标题为“访前尽调一页纸智能体”，LOGO 与菜单一致，说明行独立居中。
4. 确认五项快捷菜单位于原生输入框下方，呈单行独立描边卡片、上图标下短标签；390px 窄屏只在菜单内部横向滚动且页面不越界，点击后才打开右侧工作台并切换到对应视图。
5. 检查右侧五阶段菜单为等宽分栏、上图标下短标题且无第二行描述；选中项为浅蓝底、蓝字和底部蓝线，窄屏不横向越界。
6. 打开输入框左上角“提示词生成”，检查四步、滚动、固定头尾、Tab 焦点环和 Escape 恢复焦点。
7. 选择“银行/信贷客户经理、首次拜访、风险与涉诉、股权与实控人、15分钟标准、一页纸简报”并填写企业。
8. 输入框已有自由文本时，分别验证取消、追加、替换；确认回填后不会自动发送。
9. 点击 DSH 原生发送按钮，确认消息作为用户可见文本发送到当前 Session。
10. 确认工作台只展示当前 Session 真实发生的企业、经营、知识产权和风险工具调用。
11. 检查风险侧先出现企业风险扫描，零计数维度没有继续下钻。
12. 中途关闭工作台，确认任务继续；点击输入框下方任一业务快捷按钮可恢复并进入对应视图。
13. Agent 停止但未生成完整报告时应显示“等待确认 / 继续”；完整报告出现后才显示“报告已生成”。
14. 检查报告有八段（含独立产业定位），假设包含支持/反对/未知，必问包含答 A/B 分支，覆盖声明区分零记录和调用失败。

自动化契约

src/skill-contract.test.ts 会检查拼句器中的档位、角色、关注维度和输出形态是否仍逐字存在于 Skill。修改任何 phrase 时必须同步更新 Skill，否则测试失败。

项目结构

dsh-pre-duediligence/
├── src/
│   ├── index.ts
│   ├── client.tsx
│   ├── workbench-v2.tsx
│   ├── workbench-style.ts
│   ├── better-sidebar.ts
│   ├── previsit-brand.tsx
│   ├── previsit-home.tsx
│   ├── previsit-prompt.tsx
│   ├── composer-model.ts
│   ├── workbench-state.ts
│   └── skill-contract.test.ts
├── skills/qcc-previsit-onepager/
│   ├── SKILL.md
│   └── references/
│       ├── reasoning-framework.md
│       ├── bank-rm-content-bank.md
│       ├── tool-routing.md
│       ├── fact-contract.md
│       └── report-template.md
├── scripts/build.mjs
├── cordis.patch.yml
└── package.json

安全与边界

• 插件不保存企查查 Token。
• 插件只在左侧栏增加独立入口，并把承载工作台的 Better Sidebar 标签从右侧“+”菜单隐藏；业务 CSS 只作用于 .qcc* 自有节点，普通会话不挂载业务 DOM，也不修改 DSH 原生文案。
• 企业事实只能来自本次企查查 MCP 返回。
• 条件仅生成用户可见文本，不在 Client 侧调用 MCP。
• 提示词向导只回填；用户点击 DSH 原生发送按钮或工作台“开始尽调”后才发送。
• 工作台状态绑定当前 Session，不根据聊天文本猜测业务结论。
• Agent 不输出信用评分或替用户作授信、合作、投资决定。

设计参考与许可

• dsh-tender-workbench：https://github.com/Sunhh3221/dsh-tender-workbench
• dsh-data-cleaning-agent：https://github.com/duhu2000/dsh-data-cleaning-agent
• 交互参考：DSH智能体_企查查蓝_UI_Mockup_v1.1.0.html 与 DSH智能体开发交互规范方案.md
• 产品输入：桌面 handoff 中的系统提示词 v0.2、拼句器配置 v1.2.1、推理规范、业务内核和银行角色内容库
• 第三方许可见 THIRD_PARTY_NOTICES.md

License

MIT