dsh-pre-duediligence 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # 更新日志
 ## [Unreleased]
 
+## [0.1.24] - 2026-09-13
+
+- 左侧菜单在创建专属 Session 期间保持固定名称“访前尽调”，加载或失败状态不再替换菜单文案。
+- 初始页标题桥接适配新版 Host 的 composer sibling slot，稳定恢复“访前尽调一页纸智能体”、企查查蓝 LOGO，并在宿主重渲染后继续同步。
+- 任务历史卡片支持按来源 Session 打开只读详情、内嵌查看与下载已保存报告；缺少来源的旧记录仍明确保持只读摘要。
+
+## [0.1.23] - 2026-09-13
+
+- Host 存储兼容缺少 Workspace / Session 来源元数据的旧记录：记录继续进入 Profile 历史，但绝不匹配或重绑为当前 Session 任务。
+- 历史卡片对缺失来源明确显示“未记录（旧记录）”；客户端以 `HostedTaskListScope` 判别联合固化当前任务与 Profile 历史边界。
+- 新增可复用 TaskScope/History 契约及 Session A/B/legacy fixtures，并将跨 Session 历史来源纳入四种隔离 Chrome 布局回归。
+
 ## [0.1.22] - 2026-09-13
 
 - “任务历史”改为汇总当前 DSH Profile 内所有访前尽调 Session 的 Host 持久记录，重新打开插件或进入新会话后仍可查看既有任务。

package/README.md

@@ -1,13 +1,13 @@
 # dsh-pre-duediligence
 
-0.1.22 修复重新进入访前尽调后历史为空的问题：任务历史汇总当前 DSH Profile 内所有访前尽调 Session 的 Host 持久记录，并标注来源 Workspace / Session；当前任务与执行进度仍严格绑定当前 Session，不会误认领旧任务。已发布版本与验证边界见 [发布说明](docs/RELEASE-0.1.22.md)、[采用记录](docs/DSH-UX-001-ADOPTION.md)和[兼容矩阵](docs/COMPATIBILITY.md)。
+0.1.24 修复原生首页与历史交互：左侧菜单名称在打开期间保持“访前尽调”，新版 Host 布局下首页稳定显示“访前尽调一页纸智能体”，历史任务可按来源 Session 打开详情、查看及下载已保存报告。已发布版本与验证边界见 [发布说明](docs/RELEASE-0.1.24.md)、[作用域契约](docs/TASK-SCOPE-HISTORY-CONTRACT.md)、[采用记录](docs/DSH-UX-001-ADOPTION.md)和[兼容矩阵](docs/COMPATIBILITY.md)。
 
 ## 安装与三分钟上手
 
 访前尽调智能体：面向拜访前调查，提供企业尽调、客户尽调、客户背景调查、工商核验与风险信息整理；使用企查查 MCP，提供固定路由连续调用、主体确认、动态进度和可下载报告。
 
 ```sh
-dsh plugin --profile web add dsh-pre-duediligence@0.1.22
+dsh plugin --profile web add dsh-pre-duediligence@0.1.24
 ```
 
 请先满足下文的 DSH 与连接器要求；Better Sidebar 仅在需要可视化工作台时选装。安装后完整停止并重启对应 Profile。
@@ -23,7 +23,7 @@ dsh plugin --profile web add dsh-pre-duediligence@0.1.22
 相关智能体：[数据清洗补全](https://github.com/duhu2000/dsh-data-cleaning-agent) · [AI填表](https://github.com/duhu2000/dsh-form-fill-agent) · [访前尽调](https://github.com/duhu2000/dsh-pre-duediligence) · [招投标](https://github.com/duhu2000/dsh-tender-workbench)
 
 
-版本：**0.1.22**。本版保持 DSH-UX-001 v1.5.2 的 Workspace / Session 隔离、工作台初始关闭和核验完成门；当前任务、阶段进度、报告回写及下载仍绑定当前 Session，任务历史则从 Host 持久库汇总当前 Profile 的全部访前 Session。每条历史记录显示来源 Workspace / Session，完整消息与证据仍保留在来源原生会话。本轮自动化使用合成 Host 记录，不声明生产账号全链路验收通过。详见 [更新日志](CHANGELOG.md)、[采用记录](docs/DSH-UX-001-ADOPTION.md)、[兼容与验收矩阵](docs/COMPATIBILITY.md)和[市场投稿登记](docs/MARKETPLACE.md)。
+版本：**0.1.24**。本版保持 DSH-UX-001 v1.5.2 的 Workspace / Session 隔离、工作台初始关闭和核验完成门，并修复 Host 布局变化后的首页标题定位、菜单加载态文案以及历史详情与报告下载。当前任务、阶段进度、报告回写及下载仍绑定当前 Session；历史详情只读取记录所属 Session，不重新调用企查查。旧记录缺少来源时继续明确显示“未记录（旧记录）”，只进入 Profile 历史且不会被当前 Session 认领。本轮自动化使用合成 Host 记录，不声明生产账号全链路验收通过。详见 [更新日志](CHANGELOG.md)、[作用域契约](docs/TASK-SCOPE-HISTORY-CONTRACT.md)、[采用记录](docs/DSH-UX-001-ADOPTION.md)、[兼容与验收矩阵](docs/COMPATIBILITY.md)和[市场投稿登记](docs/MARKETPLACE.md)。
 
 面向 DeepSeek Harness 的 Session 级访前尽调智能体。业务人员从左侧菜单进入，在会话级工作台定义一次拜访；Agent 调用企查查五类 MCP，使用机会与风险双引擎完成经营状态识别、假设与反证、风险核验，最终交付可追溯的访前尽调报告。
 
@@ -92,7 +92,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-pre-duediligenc
 安装脚本默认向 DSH Web profile 安装两个基础 Bundle：
 
 1. `dsh-mcp-connector@0.2.32`：提供通用 MCP 连接器与市场，通过“企查查·企业工商”完成 OAuth，并动态挂载企业、风险、知产、经营、历史和董监高 MCP。
-2. `dsh-pre-duediligence@0.1.22`：提供左侧智能体入口、原生会话首页、提示词生成器、Host 执行门和 Skill。
+2. `dsh-pre-duediligence@0.1.24`：提供左侧智能体入口、原生会话首页、提示词生成器、Host 执行门和 Skill。
 
 默认不会安装 Better Sidebar。需要 Session 级可视化工作台时显式开启：
 
@@ -120,7 +120,7 @@ dsh web
 
 ~~~bash
 dsh plugin --profile web add dsh-mcp-connector@0.2.32
-dsh plugin --profile web add dsh-pre-duediligence@0.1.22 --allow-build=node-pty,dsh-pre-duediligence
+dsh plugin --profile web add dsh-pre-duediligence@0.1.24 --allow-build=node-pty,dsh-pre-duediligence
 dsh web
 ~~~
 
@@ -136,7 +136,7 @@ dsh web
 dsh plugin --profile web list --depth 0
 ~~~
 
-应始终看到所选基线的 Connector 和 `dsh-pre-duediligence@0.1.22`；仅在显式启用或原本已安装时看到 Sidebar。重启 DSH 并连接“企查查·企业工商”后，在左侧菜单点击“访前尽调”进入初始原生会话。无 Sidebar 时可继续生成提示词、回填/发送草稿并在会话中阅读报告；五项流程按钮会提示安装可选工作台。安装 Sidebar 时，右侧工作台仍默认关闭，点击业务按钮后才打开对应视图；其右侧“+”菜单不会列出该入口，普通会话保持 DSH 原样。
+应始终看到所选基线的 Connector 和 `dsh-pre-duediligence@0.1.24`；仅在显式启用或原本已安装时看到 Sidebar。重启 DSH 并连接“企查查·企业工商”后，在左侧菜单点击“访前尽调”进入初始原生会话。无 Sidebar 时可继续生成提示词、回填/发送草稿并在会话中阅读报告；五项流程按钮会提示安装可选工作台。安装 Sidebar 时，右侧工作台仍默认关闭，点击业务按钮后才打开对应视图；其右侧“+”菜单不会列出该入口，普通会话保持 DSH 原样。
 
 ### 无 Sidebar 功能边界
 

package/docs/COMPATIBILITY.md

@@ -1,5 +1,25 @@
 # 访前尽调兼容与验收记录
 
+## 0.1.24：Host 首页布局与历史详情（2026-09-13）
+
+| 实测问题 | 修复契约 | 验证边界 |
+| --- | --- | --- |
+| 菜单点击后显示“正在打开…” | 可见菜单名固定为“访前尽调”，加载状态只进入无障碍与控件状态 | 重复点击仍由 busy guard 阻止，不创建重复 Session |
+| 首页退回“探索未至之境 预览版” | 兼容 marker 与 Hero 为兄弟分支的 Host DOM，监听同一页面范围内的宿主重渲染 | 只改写本插件专属空白会话，卸载时恢复原文案与标记 |
+| 历史清单不能进入任务与下载报告 | 以历史记录自身的来源 Session 读取详情和报告；返回清单不改变当前任务 | 来源缺失的旧记录仍只能看摘要，不猜测 Session |
+
+本地 Node 24.19.0 门禁覆盖严格类型检查、全量自动化测试、Host/Client 构建，以及浅色/深色 × 桌面/窄屏 4 个隔离 Chrome 场景。真实 DSH 与生产企查查 Provider 仍以安装后的用户验收为准。
+
+## 0.1.23：旧记录来源与显式 TaskScope（2026-09-13）
+
+| 实测问题 | 修复契约 | 验证边界 |
+| --- | --- | --- |
+| 旧 Host 记录缺少 Workspace / Session 时被丢弃 | 兼容读取并以空来源哨兵持久化，继续进入 Profile 历史 | 旧记录不进入任何当前 Session 列表，也不被猜测或重绑 |
+| 历史卡片来源空白，无法判断归属 | 缺失项明确显示“来源：Workspace 未记录（旧记录） · Session 未记录（旧记录）”，使用中性样式 | 无法恢复从未持久化的真实来源，完整会话仍需回到原生会话查阅 |
+| 可选 `sessionId` 参数让当前任务与历史查询边界含糊 | 客户端改用 `HostedTaskListScope` 判别联合；Session A/B/legacy fixtures 固化可见性 | 单任务读取、报告回写和下载继续由 Host 强制校验当前 `sessionId` |
+
+本地 Node 24.19.0 发布门禁通过严格类型检查、23 个测试文件 / 165 项测试、Host/Client 构建，以及浅色/深色 × 桌面/窄屏 4 个隔离 Chrome 场景。自动化覆盖当前 Session A、跨 Session B 与缺少来源的 legacy 记录，并检查长来源文本和旧记录标识不造成横向溢出。生产 DSH Profile 与真实企查查 Provider 未在本轮自动化中调用，仍以安装后的用户验收为准。
+
 ## 0.1.22：跨 Session 历史汇总（2026-09-13）
 
 | 实测问题 | 修复契约 | 验证边界 |

package/docs/DSH-UX-001-ADOPTION.md

@@ -1,5 +1,26 @@
 # DSH-UX-001 采纳与验收记录
 
+## 0.1.24：稳定入口、首页品牌与历史详情
+
+日期：2026-09-13。
+
+| 交互要求 | 当前实现 |
+| --- | --- |
+| 菜单名称不能被加载或错误状态替换 | 左侧入口始终显示“访前尽调”；处理中仅使用 `aria-busy` 与禁用态，错误通过标题提示 |
+| Host 调整 Hero 与 composer slot 层级后仍要显示业务首页 | 从本插件 composer seat 向上定位同一首页标题，宿主重渲染后继续同步“访前尽调一页纸智能体”、业务 LOGO 与预览标记 |
+| 历史任务必须能打开和下载 | 携带该记录自身来源 Session 读取只读详情、内嵌报告与下载制品；不会重新查询或污染当前任务 |
+
+## 0.1.23：旧记录兼容与 TaskScope 契约
+
+日期：2026-09-13。
+
+| 交互要求 | 当前实现 |
+| --- | --- |
+| 历史升级不能丢弃旧 Host 记录 | 缺少 Workspace / Session 的合法旧记录继续进入 Profile 历史，并规范化为空来源哨兵 |
+| 来源缺失不得猜测或重绑 | 卡片明确显示“未记录（旧记录）”；旧记录不匹配任何当前 Session，也不能由当前页下载或回写 |
+| 当前任务与历史查询边界应可复用 | `HostedTaskListScope` 显式区分 `current` 和 `profile-history`；独立 TaskScope 文档覆盖 Session A/B/legacy fixtures |
+| 长来源信息不能破坏布局 | 浅色/深色 × 桌面/窄屏四种隔离 Chrome 场景检查跨 Session 长路径与旧记录标识 |
+
 ## 0.1.22：跨 Session 历史汇总
 
 日期：2026-09-13。

package/docs/MARKETPLACE.md

@@ -7,8 +7,8 @@
 | 项目 | 已核验值 |
 | --- | --- |
 | 仓库 | `https://github.com/duhu2000/dsh-pre-duediligence`，公开、未归档 |
-| npm | `dsh-pre-duediligence@0.1.22`，发布后核验 `latest=0.1.22` |
-| Release | `https://github.com/duhu2000/dsh-pre-duediligence/releases/tag/v0.1.22` |
+| npm | `dsh-pre-duediligence@0.1.24`，发布后核验 `latest=0.1.24` |
+| Release | `https://github.com/duhu2000/dsh-pre-duediligence/releases/tag/v0.1.24` |
 | 许可证 | MIT |
 | Topic | `dsh-plugin` |
 | Manifest | `package.json` 的 `dsh.bundle.patch` 指向 `./cordis.patch.yml` |
@@ -28,7 +28,7 @@
 - 企查查数据采用 BYO QCC：用户需要自行安装并配置兼容的 MCP Connector，使用自己的企查查账号、产品权限和可用额度完成 OAuth；本插件不附带账号、数据权限或查询额度。
 - 多候选时需要用户确认唯一法律实体；用户发送任务即表示同意固定路由内连续执行，不再二次询问，也不受插件调用次数硬上限阻断。
 - 零记录、无权限、额度不足和调用失败是不同状态；未执行或失败的维度不得写成“零风险”。
-- 0.1.22 已补齐跨访前 Session 的 Host 历史汇总，同时保持当前任务严格按 Session 隔离，并完成自动化契约、构建和隔离 UI 回归；生产账号端到端复测仍以用户验收为准，市场描述不把待验项写成已通过。
+- 0.1.24 保持显式 TaskScope 与旧记录只读边界，并补齐稳定菜单名、Host 新版首页标题定位及历史详情/报告下载；生产账号端到端复测仍以用户验收为准，市场描述不把待验项写成已通过。
 
 ## 安装、卸载与截图证据
 

package/docs/RELEASE-0.1.23.md

@@ -0,0 +1,22 @@
+# v0.1.23 发布说明
+
+本版补齐 v0.1.22 跨 Session 历史汇总中的旧记录兼容边界。
+
+## 修复
+
+- 合法旧 Host 记录即使缺少 Workspace / Session 来源元数据，也会继续出现在当前 DSH Profile 的任务历史中。
+- 历史卡片明确显示“未记录（旧记录）”，不再空白，也不会把未知来源伪装成当前 Workspace 或 Session。
+- 客户端以 `HostedTaskListScope` 判别联合显式区分当前 Session 列表与 Profile 历史列表。
+- 当前任务认领、单任务读取、报告回写和下载继续严格校验 Session；旧记录只可浏览，不会被当前 Session 重绑。
+
+## 验证
+
+- Session A/B/legacy fixtures 覆盖当前任务隔离、跨 Session 历史汇总和旧记录展示。
+- 浅色/深色 × 桌面/窄屏四种隔离 Chrome 场景覆盖长来源文本、旧记录标识与横向溢出。
+- 严格类型检查、单元/集成测试、Host/Client 构建与 npm 包清单门禁均纳入发布流程。
+
+本轮验证使用合成 Host 记录，没有读取或修改生产 DSH Profile，也没有调用真实企查查 Provider；生产账号端到端结果仍以安装后的用户验收为准。
+
+```sh
+dsh plugin --profile web add dsh-pre-duediligence@0.1.23
+```

package/docs/RELEASE-0.1.24.md

@@ -0,0 +1,22 @@
+# v0.1.24 发布说明
+
+本版修复访前尽调入口、原生首页与历史详情在新版 Host 布局中的交互问题。
+
+## 修复
+
+- 左侧入口在创建专属 Session 期间始终显示“访前尽调”；不再改成“正在打开…”或错误文案。
+- 原生首页兼容业务 marker 与 Hero 标题位于 composer sibling 分支的 Host DOM，稳定替换为“访前尽调一页纸智能体”、企查查蓝建筑 LOGO，并可在宿主重渲染后恢复。
+- 历史任务卡片可打开只读详情，内嵌查看已保存报告，并使用该记录自己的来源 Session 下载 HTML 制品。
+- 缺少来源 Workspace / Session 的旧记录继续保留清单摘要，不猜测来源、不绑定当前任务。
+
+## 验证
+
+- 菜单文案、Hero sibling slot、宿主重渲染与可逆清理均有回归覆盖。
+- 历史任务详情验证读取记录所属 Session，并覆盖详情、下载与返回清单交互。
+- 严格类型检查、全量单元/集成测试、Host/Client 构建与隔离 Chrome UI 门禁纳入发布流程。
+
+本轮使用合成 Host 记录和隔离浏览器页面验证，没有读取或修改生产 DSH Profile，也没有调用真实企查查 Provider；生产账号结果仍以安装后的用户验收为准。
+
+```sh
+dsh plugin --profile web add dsh-pre-duediligence@0.1.24
+```

package/docs/SEARCH-CONVERSION.md

@@ -12,14 +12,14 @@ npm keywords 已在包清单内更新。GitHub description 建议使用上述英
 
 验收：使用实时完整目录和原版搜索函数对比登记描述更新前后；记录语言、命中位置、结果数与版本。独立目录缺失条目必须标为未上线，不能把模拟添加的结果当作上线结果。
 
-发布清单：0.1.22 已获得发布授权；完成仓库 check、README 与包清单差异审核后，以新的不可变 tag 和 npm 版本发布，不覆盖旧版本或移动旧 tag。仅登记 YAML 更新仍无需重复发布 npm。
+发布清单：0.1.24 已获得发布授权；完成仓库 check、README 与包清单差异审核后，以新的不可变 tag 和 npm 版本发布，不覆盖旧版本或移动旧 tag。仅登记 YAML 更新仍无需重复发布 npm。
 
 ## 安装与三分钟上手
 
 访前尽调智能体：面向拜访前调查，提供企业尽调、客户尽调、客户背景调查、工商核验与风险信息整理；使用企查查 MCP，提供固定路由连续调用、主体确认、动态进度和可下载报告。
 
 ```sh
-dsh plugin --profile web add dsh-pre-duediligence@0.1.22
+dsh plugin --profile web add dsh-pre-duediligence@0.1.24
 ```
 
 请先满足下文的 DSH 与连接器要求；Better Sidebar 只在需要可视化工作台时选装。安装后完整停止并重启对应 Profile。

package/docs/TASK-SCOPE-HISTORY-CONTRACT.md

@@ -0,0 +1,24 @@
+# TaskScope 与任务历史契约
+
+本契约供访前尽调及其它 DSH 业务智能体复用。它区分“当前工作真相”和“历史浏览索引”，避免跨 Session 串单。
+
+## 作用域
+
+| 能力 | TaskScope | 请求 | 允许行为 |
+| --- | --- | --- | --- |
+| 当前任务发现与进度 | 当前 Session | `GET /previsit/api/tasks?sessionId=A` | 只能认领 Session A 的任务 |
+| 当前任务正文与报告回写 | 当前 Session | `GET/PUT /previsit/api/tasks/:id...?sessionId=A` | Host 必须校验记录归属 A |
+| 当前任务报告下载 | 当前 Session | `GET /previsit/api/tasks/:id/report?sessionId=A` | 不允许从 A 下载 B 的制品 |
+| 任务历史列表 | 当前 DSH Profile | `GET /previsit/api/tasks` | 可汇总 A、B 等访前 Session 的 Host 持久记录 |
+
+历史列表不是第二套浏览器数据库，也不是重新认领入口。完整对话与证据引用继续归属于来源 DSH 原生会话。
+
+## A/B/legacy fixtures
+
+| 记录 | origin Workspace / Session | 当前 A 视图 | Profile 历史 | 展示规则 |
+| --- | --- | --- | --- | --- |
+| Task A | `/workspace-a` / `session-a` | 可认领 | 可见 | 显示真实来源 |
+| Task B | `/workspace-b` / `session-b` | 不可认领 | 可见 | 显示真实来源 |
+| Legacy | 缺失 / 缺失 | 不可认领 | 可见 | 显示“未记录（旧记录）”，不得猜测为 A |
+
+实现以 `HostedTaskListScope` 的 `current` / `profile-history` 判别联合为客户端契约；Host 对单任务、报告回写和下载继续强制校验 `sessionId`。旧记录缺失来源时使用空字符串兼容哨兵，只用于 Profile 历史，不参与任一当前 Session 匹配。

package/install.sh

@@ -5,7 +5,7 @@ set -euo pipefail
 readonly PROFILE_NAME="${DSH_PROFILE:-web}"
 readonly BASELINE="${DSH_PREVISIT_BASELINE:-stable}"
 readonly WORKBENCH_MODE="${DSH_PREVISIT_WORKBENCH:-off}"
-readonly PREVISIT_SPEC="${DSH_PRE_DUEDILIGENCE_SPEC:-dsh-pre-duediligence@0.1.22}"
+readonly PREVISIT_SPEC="${DSH_PRE_DUEDILIGENCE_SPEC:-dsh-pre-duediligence@0.1.24}"
 readonly LEGACY_PREVISIT_NAME="qcc-previsit-dsh"
 readonly LEGACY_QCC_OAUTH_NAME="qcc-dsh-mcp-oauth"