duhu2000/dsh-pre-duediligence ↗★ 2
dsh-pre-duediligence
Pre-visit due diligence and company research in DeepSeek Harness with Host-tracked progress, fixed-route Qichacha MCP calls, entity confirmation, and downloadable reports.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:duhu2000/dsh-pre-duediligence说明文档
阅读完整 README ↗dsh-pre-duediligence
0.1.20 适配企查查 Provider 的真实中文业务对象与风险扫描结构：成功返回和明确零记录显示绿色，真实风险命中仍按黄色/红色呈现，待确认、未执行和失败不再混入“采集结果 / 核验结果”。已发布版本与验证边界见 发布说明、采用记录和兼容矩阵。
安装与三分钟上手
访前尽调智能体：面向拜访前调查，提供企业尽调、客户尽调、客户背景调查、工商核验与风险信息整理；使用企查查 MCP，提供固定路由连续调用、主体确认、动态进度和可下载报告。
dsh plugin --profile web add dsh-pre-duediligence@0.1.20
请先满足下文的 DSH 与连接器要求；Better Sidebar 仅在需要可视化工作台时选装。安装后完整停止并重启对应 Profile。
进入“访前尽调”，在提示词生成器填写拜访对象、角色和目标，核对范围与输出要求后发送任务。发送即表示同意在固定业务路由内连续调用企查查 MCP，不再二次确认或受插件次数上限阻断；如果搜索命中多个主体，只需再选择唯一法律实体。
流程样例（示意，非真实调用结果）： 拜访目标与客户主体 → 必要时主体消歧 → 事实与未知项 → 支持/反对证据 → 现场必问与覆盖声明。
能力边界： 访前研究不等于完整 AML/KYB、审计或授信结论；Provider 自身的账户额度、产品权限和限流仍然有效。多候选须人工消歧，报告必须披露未知项与覆盖范围。
升级与回滚： 升级前停止 Profile 并备份任务目录，记录当前精确版本；使用上面的固定版本命令升级，再完整重启。回滚时将版本号替换为升级前记录的版本，并使用升级前任务目录副本；不以旧版直接读取已迁移任务目录。
相关智能体：数据清洗补全 · AI填表 · 访前尽调 · 招投标
版本：0.1.20。本版保持 DSH-UX-001 v1.5.2 的 Workspace / Session 隔离、工作台初始关闭和核验完成门，并按用户真实企查查调用样本补齐中文 Provider 返回归一、风险扫描计数和状态色语义。成功取得的数据及明确的零记录使用绿色；真实风险命中继续使用黄色/红色；无法确认、无权限、未执行和失败保持独立状态，不伪装成完成。本轮实现来自真实界面问题样本，自动化仍使用合成 Provider 数据，不声明生产账号全链路验收通过。详见 更新日志、采用记录、兼容与验收矩阵和市场投稿登记。
面向 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 原生输入框和输入框下方五项快捷菜单：对象与目标、范围确认、资料采集、证据核验、任务历史；菜单采用数据清洗补全式单行描边卡片，上图标下短标签，窄屏在容器内横向滚动
- “当前任务 / 任务历史”主导航与五阶段业务导航分离：
- 对象与目标
- 范围确认
- 资料采集
- 证据核验
- 材料输出
- 右侧五阶段菜单采用招投标工作台样式：等宽分栏、图标在上、短标题在下；选中项使用浅蓝底、蓝字和底部蓝线，菜单不显示第二行描述并在窄屏内收缩
- 快捷菜单与阶段导航只切换视图，不伪造执行状态；只有捕获到完整报告后才显示“报告已生成”
- Better Sidebar 的 Session 单例 Tab 是唯一工作台容器；展开、收起、宽度、停靠和浮窗只由宿主管理，业务内容不提供同义箭头、X 或返回/关闭工作台按钮
- 宿主收起只改变可见性，宿主 Tab X 只移除业务 Tab；两者都不取消任务或删除历史、制品，从输入框下方同一组快捷按钮可聚焦或恢复并定位对应视图
- 进度与工具记录只投影当前 Session 的 Host 任务与真实高层工具调用；异步轮询会动态更新资料采集、证据核验、用量和错误状态
- 完整报告保留在 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：
dsh-mcp-connector@0.2.32：提供通用 MCP 连接器与市场，通过“企查查·企业工商”完成 OAuth，并动态挂载企业、风险、知产、经营、历史和董监高 MCP。dsh-pre-duediligence@0.1.20：提供左侧智能体入口、原生会话首页、提示词生成器、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.20 --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.20；仅在显式启用或原本已安装时看到 Sidebar。重启 DSH 并连接“企查查·企业工商”后，在左侧菜单点击“访前尽调”进入初始原生会话。无 Sidebar 时可继续生成提示词、回填/发送草稿并在会话中阅读报告；五项流程按钮会提示安装可选工作台。安装 Sidebar 时，右侧工作台仍默认关闭，点击业务按钮后才打开对应视图；其右侧“+”菜单不会列出该入口，普通会话保持 DSH 原样。
无 Sidebar 功能边界
| 能力 | 无 Sidebar | 安装兼容 Sidebar |
|---|---|---|
| 左侧入口与专属原生 Session | 可用 | 可用 |
| 提示词生成、草稿回填、原生发送 | 可用 | 可用 |
| bundled Skill、固定路由/主体确认与企查查工具链 | 可用；仍取决于模型、Connector、OAuth、权限和 Provider 额度 | 可用；条件相同 |
| 原生会话中的执行过程与最终报告 | 可用 | 可用 |
| 五阶段可视化、工作台任务历史与 HTML 下载 | 不可用；点击流程按钮给出安装提示，状态不丢失 | 可用 |
无 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：
- 先按选定基线安装 MCP 连接器和访前插件，完全重启 DSH。
- 打开“🧩 MCP连接器”，按界面提示迁移旧企查查授权；也可以重新连接“企查查·企业工商”。
- 先确认新连接健康，并在新连接上成功完成一次真实企业查询。
- 查询成功后停止 DSH，执行
dsh plugin --profile web remove qcc-dsh-mcp-oauth，然后完整重启并复核连接。
连接器只复制旧授权，不会自动删除旧插件或旧凭据；确认新连接可用后再移除旧插件。
本地开发
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 或企查查服务。
人工验收
- 在 DSH 选择一个工作空间和 Session。
- 点击左侧“访前尽调”，确认只进入专属初始会话，右侧工作台保持关闭；同时右侧 Better Sidebar 的“+”菜单不出现该入口，普通会话保持 DSH 原样。
- 点击“访前尽调”，确认首页标题为“访前尽调一页纸智能体”，LOGO 与菜单一致，说明行独立居中。
- 确认五项快捷菜单位于原生输入框下方，呈单行独立描边卡片、上图标下短标签；390px 窄屏只在菜单内部横向滚动且页面不越界，点击后才打开右侧工作台并切换到对应视图。
- 检查右侧五阶段菜单为等宽分栏、上图标下短标题且无第二行描述；选中项为浅蓝底、蓝字和底部蓝线，窄屏不横向越界。
- 打开输入框左上角“提示词生成”，检查四步、滚动、固定头尾、Tab 焦点环和 Escape 恢复焦点。
- 选择“银行/信贷客户经理、首次拜访、风险与涉诉、股权与实控人、15分钟标准、一页纸简报”并填写企业。
- 输入框已有自由文本时，分别验证取消、追加、替换；确认回填后不会自动发送。
- 点击 DSH 原生发送按钮，确认消息作为用户可见文本发送到当前 Session。
- 确认工作台只展示当前 Session 真实发生的企业、经营、知识产权和风险工具调用。
- 检查风险侧先出现企业风险扫描，零计数维度没有继续下钻。
- 中途关闭工作台，确认任务继续；点击输入框下方任一业务快捷按钮可恢复并进入对应视图。
- Agent 停止但未生成完整报告时应显示“等待确认 / 继续”；完整报告出现后才显示“报告已生成”。
- 检查报告有八段（含独立产业定位），假设包含支持/反对/未知，必问包含答 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