dsh-tender-workbench 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to `dsh-tender-workbench` are documented in this file.
 
 ## [Unreleased]
 
+## [0.5.4] - 2026-09-10
+
+- 对齐共享交互规范 v1.5.0：强化 Better Sidebar 能力探针、Session 定向展开与订阅清理；五个流程入口复用同一 Tab，增加当前会话记录历史视图与缺失依赖提示。
+- Tab 重开保留会话级阶段、查询草稿及查询/筛选子视图；阶段导航只显示图标和短名称，窄栏保留任务状态文字。真实 DSH 四插件组合回归待验。
+
+## [0.5.3] - 2026-09-08
+
+- 改善搜索元数据、安装说明、能力边界与四产品互链；无运行时或依赖变更。
+
 ## [0.5.2] - 2026-09-07
 
 ### Changed

package/README.en.md

@@ -1,10 +1,16 @@
 # dsh-tender-workbench
 
+Tender search and bid intelligence in DeepSeek Harness with proposed project search, rule screening, human review and Excel/PDF exports using user-authorized Qichacha MCP.
+
+Install a pinned release using the command in the [Chinese quick start](README.md), review the preview or evidence before confirming, and keep the previous version and task-directory backup for rollback. Qichacha calls use the customer's authorized account.
+
+Related agents: [数据清洗补全](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)
+
 [中文](README.md) | **English**
 
 `dsh-tender-workbench` is an open-source DeepSeek Harness plugin for finding, screening, reviewing, and delivering tender opportunities. It combines authorized `qcc-tender` data, deterministic screening rules, bounded Agent analysis, explicit human decisions, and immutable Excel/PDF reports in one Session-scoped Better Sidebar workbench.
 
-Current stable version: **0.5.2** (stable release).
+Current stable version: **0.5.4** (stable release).
 
 ## What it does
 
@@ -54,7 +60,7 @@ An installed and authorized `qcc-tender` MCP connection must expose these exact
 - `mcp__qcc-tender__search_tenders`
 - `mcp__qcc-tender__search_proposed_projects`
 
-Missing required services, incompatible Better Sidebar capabilities, unavailable MCP tools, and non-JSONL Session persistence fail explicitly. There is no Web-search, alternate-persistence, or Workspace-storage fallback.
+Without a compatible Better Sidebar provider, conversation entry points and supported Host tools remain available; shortcuts show actionable install/upgrade, enable-tab and restart guidance. No private sidebar is created. Other missing required services, unavailable MCP tools and non-JSONL persistence fail explicitly, with no Web-search or alternate-storage fallback.
 
 ## Install
 
@@ -67,12 +73,12 @@ dsh plugin --profile web add dsh-tender-workbench
 dsh web --no-open
 ```
 
-To install the exact 0.5.2 release:
+To install the exact 0.5.4 release:
 
 ```sh
 dsh plugin --profile web add 'dsh-mcp-connector@>=0.2.31'
 dsh plugin --profile web add 'dsh-better-sidebar@>=0.17.1'
-dsh plugin --profile web add dsh-tender-workbench@0.5.2
+dsh plugin --profile web add dsh-tender-workbench@0.5.4
 ```
 
 To install from an independent checkout, install the required Provider plugins first, then run from this repository:
@@ -108,15 +114,24 @@ dsh plugin --profile web remove dsh-tender-workbench
 Upgrade an existing installation by installing the stable version and fully restarting the Web profile:
 
 ```sh
-dsh plugin --profile web add dsh-tender-workbench@0.5.2
+dsh plugin --profile web add dsh-tender-workbench@0.5.4
 dsh web --no-open
 ```
 
-Version 0.5.2 aligns below-composer shortcuts with shared UI specification v1.1.3: outlined cards with an icon above each label, light/dark styling, a single horizontally scrollable row on narrow screens, and fully visible keyboard-focused cards. The workbench stays closed on entry and opens only on an explicit shortcut click, as in 0.5.1. Session isolation, global sidebar preferences, history and Artifact schemas remain unchanged. To roll back, reinstall `dsh-tender-workbench@0.5.1` and restart the profile. Published versions and tags remain immutable.
+Version 0.5.4 aligns the Session singleton Tab adapter with shared UI specification v1.5.0. Five shortcuts open/focus the same Tab and navigate to opportunity, screening, decision, delivery or history, without starting tasks or MCP calls. Capability probes, subscription cleanup and cross-Session reveal guards are strengthened. Tab reopening retains navigation and query drafts within the current Client lifetime. History is limited to the current Session's saved query; cross-Session indexing and live MCP connection checks are not implemented. Actual four-plugin DSH integration remains to be verified. Roll back with `dsh-tender-workbench@0.5.3` and restart the profile; business data schemas are unchanged.
 
 ## Using the workbench
 
-The plugin exposes a top-left “招投标” launcher and a Session Header recovery action. Every top-left activation creates a distinct native Session in the current Session's workspace, the recent workspace, or the first available workspace, gives that blank Session the “招投标” hero label and goal icon, and opens its Better Sidebar workbench. Other Sessions keep their existing host/provider hero label and the fish mark. The composer-bottom shortcuts are intentionally absent; the Header action only reopens the workbench for its existing Session.
+The top-left “招投标” launcher creates a distinct native Session using the current, recent, or first available workspace path. It shows the “招投标智能体” title and goal icon without opening the workbench. Below-composer shortcuts explicitly open the query, screening, review, or delivery view; the Session Header recovery action remains available. Other Sessions retain their original branding.
+
+## Interface examples and marketplace submission
+
+These screenshots show the actual 0.5.2 React components in an isolated host fixture, visibly labeled as isolated UI validation without DSH/MCP connections. They contain no customer information or real business responses. They do not demonstrate live DSH/QCC operation or marketplace one-click installation.
+
+![Light homepage — isolated component demo](assets/market/home-light.png)
+![Dark homepage — isolated component demo](assets/market/home-dark.png)
+
+See [submission status and isolated install/uninstall evidence](docs/MARKET-SUBMISSION.md). An open PR is not a completed marketplace listing.
 
 Navigation only changes the visible workbench phase. It does not mutate business state or run a later action. Criteria are proposed, edited, previewed, and confirmed as distinct steps. Agent recommendations never become user decisions automatically. Report generation always shows the reviewed and pending scope before creating a delivery snapshot.
 

package/README.md

@@ -1,10 +1,31 @@
 # dsh-tender-workbench
 
+## 安装与三分钟上手
+
+招投标智能体：支持招投标搜索、招标查询、投标查询、标讯查询、拟建项目与项目筛选，辅助商机发现、人工复核及 Excel/PDF 导出，使用客户自备授权的企查查 MCP。
+
+```sh
+dsh plugin --profile web add dsh-tender-workbench@0.5.4
+```
+
+请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
+
+进入“招投标”，设置地区、关键词和时间范围，使用已授权的 qcc-tender 查询。检查规则影响预览并确认筛选条件，人工复核记录后选择导出 Excel 或 PDF。三分钟用于熟悉操作，不承诺查询或报告一定在三分钟完成。
+
+**流程样例（示意，非真实调用结果）：** 地区/日期/关键词 → 标讯与拟建项目 → 规则影响预览 → 人工复核 → Excel/PDF（未完成复核会标注部分交付）。
+
+**能力边界：** 投标查询指已授权数据源内的公开标讯查询，不代办投标。无 Web 搜索兜底、订阅或自动 Bid/No-Bid 决策；不提供在线 PDF 预览。
+
+**升级与回滚：** 升级前停止 Profile 并备份任务目录，记录当前精确版本；使用上面的固定版本命令升级，再完整重启。回滚时将版本号替换为升级前记录的版本，并使用升级前任务目录副本；不以旧版直接读取已迁移任务目录。
+
+相关智能体：[数据清洗补全](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)
+
+
 **中文** | [English](README.en.md)
 
 > 面向国内招投标团队的 DeepSeek Harness 开源智能体插件：在一个会话级工作台内完成标讯与拟建项目查询、确定性规则初筛、限定范围智能分析、人工复核，以及 Excel/PDF 报告交付。
 >
-> 当前稳定版本：**0.5.2**（正式版本）
+> 当前稳定版本：**0.5.4**（正式版本）
 
 [![CI](https://github.com/duhu2000/dsh-tender-workbench/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-tender-workbench/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-tender-workbench)](https://www.npmjs.com/package/dsh-tender-workbench)
@@ -49,10 +70,10 @@ dsh web --no-open
 
 安装或移除插件后，请完整重启 Web Profile。插件通过 `dsh.bundle.patch` 启用 `cordis.patch.yml`，并注册 `dsh-tender-workbench` Loader。
 
-安装指定的 `0.5.2` 版本：
+安装指定的 `0.5.4` 版本：
 
 ```sh
-dsh plugin --profile web add dsh-tender-workbench@0.5.2
+dsh plugin --profile web add dsh-tender-workbench@0.5.4
 ```
 
 移除插件：
@@ -63,7 +84,7 @@ dsh plugin --profile web remove dsh-tender-workbench
 
 ## 使用工作台
 
-插件提供左上角“招投标”入口和会话 Header 恢复入口。点击左上角入口会在当前工作区、最近工作区或第一个可用工作区中创建一个独立的原生会话，为空白会话显示“招投标”标题与目标图标，并打开对应的 Better Sidebar 工作台；其他会话继续保留各自原有标题与标识。
+插件提供左上角“招投标”入口和会话 Header 恢复入口。点击左上角入口会根据当前工作区、最近工作区或第一个可用工作区的路径创建独立原生会话，显示“招投标智能体”标题与目标图标，默认不打开右侧工作台。点击输入框下方的找机会、筛候选、人工定案、形成交付或任务历史按钮时，才打开对应 Better Sidebar 视图；其他会话保留各自原有标题与标识。
 
 页面导航只切换可见阶段，不会修改业务状态或自动执行后续动作。规则建议、编辑、影响预览与确认彼此独立；报告生成前始终展示已复核和待复核范围。宽屏使用主从布局，中窄屏保持相同信息顺序，并保留局部表格滚动与可访问的固定操作区。
 
@@ -91,18 +112,18 @@ dsh plugin --profile web remove dsh-tender-workbench
 - `mcp__qcc-tender__search_tenders`
 - `mcp__qcc-tender__search_proposed_projects`
 
-缺少必要服务、Better Sidebar 能力不兼容、MCP 工具不可用或会话持久化不是 JSONL 时，插件会明确失败；不提供 Web 搜索、其他持久化或 Workspace 存储兜底。
+缺少兼容 Better Sidebar 时，对话入口和已支持的 Host 工具保持可用，流程按钮提示安装/升级、启用 Tab 并重启，不创建另一套侧拉。其余必要服务缺失、MCP 工具不可用或会话持久化不是 JSONL 时明确失败；不提供 Web 搜索、其他持久化或 Workspace 存储兜底。
 
 ## 升级与回滚
 
 从已有版本升级：
 
 ```sh
-dsh plugin --profile web add dsh-tender-workbench@0.5.2
+dsh plugin --profile web add dsh-tender-workbench@0.5.4
 dsh web --no-open
 ```
 
-本次 0.5.2 对齐共享规范 v1.1.3：首页输入框下方四个快捷入口采用上图标、下文字的描边卡片，支持浅深色、窄屏单行横向滚动与键盘聚焦完整可见。延续 0.5.1 的默认收起行为：「招投标」菜单仅进入独立会话，点击下方按钮才打开工作台。不修改宿主全局侧栏偏好、历史布局或业务数据。如需回退，可安装 `dsh-tender-workbench@0.5.1` 并重启 Profile。npm 版本与公开 Git 标签保持不可变。
+0.5.4 对齐共享规范 v1.5.0：五个流程按钮打开/聚焦同一 Session 单例 Tab 并定位内部视图；补齐能力探针、状态订阅、卸载清理和跨会话展开保护。宿主管理侧拉、Tab X、宽度及停靠，业务内容不提供重复容器控制。Tab 重开保留当前 Client 内的阶段、查询草稿和主要子视图；历史仅展示当前 Session 已保存的查询记录，不是跨会话完整历史。真实 MCP 连接状态尚未接入，页面明确提示未核验；真实 DSH 四插件组合仍待复验。如需回退，可安装 `dsh-tender-workbench@0.5.3` 并重启 Profile；未改变业务数据格式。npm 版本与公开 Git 标签保持不可变。
 
 ## 本地开发
 
@@ -117,9 +138,18 @@ corepack pnpm@11.7.0 run check
 
 `check` 会执行类型检查、完整 Vitest 测试、生产构建、README/发布状态校验以及 npm tarball 白名单预检。配置 npm Trusted Publishing 后，[发布工作流](.github/workflows/release.yml)可使用 OIDC 和 provenance；手工发布不得声称 provenance。
 
-省、市、区数据源快照维护在 [resources/area.ts](resources/area.ts)。版本变更见 [CHANGELOG.md](CHANGELOG.md)，发布检查见 [0.5.2 发布清单](docs/RELEASE-0.5.2.md)。
+省、市、区数据源快照维护在 [resources/area.ts](resources/area.ts)。版本变更见 [CHANGELOG.md](CHANGELOG.md)，发布检查见 [0.5.4 发布清单](docs/RELEASE-0.5.4.md)。
+
+## 界面演示与市场投稿
+
+以下为 0.5.2 实际 React 组件在隔离宿主夹具中的截图，画面标注“隔离 UI 验证 · 不连接 DSH / MCP”。无客户信息、生产会话或真实业务响应；仅展示界面，不代表真实 DSH 启动、QCC 查询或市场一键安装验收。
+
+![浅色首页（隔离组件演示）](assets/market/home-light.png)
+![深色首页（隔离组件演示）](assets/market/home-dark.png)
+
+市场投稿状态及隔离安装/卸载证据见 [市场登记](docs/MARKET-SUBMISSION.md)。提交 PR 不等于已经上架。
 
-## 当前范围
+## 业务范围限制
 
 当前版本不提供在线 PDF 预览、交付版本对比、已成功文件的重复生成、订阅、CRM 跟进、企业画像、来源准确性核验或 Bid/No-Bid 决策。查询、分类、分析和复核都可以作为合法结束点；只有用户明确操作后，后续阶段才会继续。
 

package/docs/RELEASE-0.5.4.md

@@ -0,0 +1,26 @@
+# dsh-tender-workbench 0.5.4
+
+Version: **0.5.4**
+Status: **release candidate**
+
+## 范围与授权
+
+用户已明确授权 commit、push、tag 和 npm 发布。目标为公开 npm 的 latest，由 release.yml 的 GitHub Actions OIDC 发布，并生成 provenance。
+
+本次对齐共享交互规范 v1.5.0：Session 单例 Tab、五入口 open/focus/定位、能力探针、显式 reveal、跨 Session/Files/Tab X 竞态保护、订阅和卸载清理、缺少依赖的可行动提示。当前/历史导航、查询草稿及主要子视图在 Client 生命周期内恢复；阶段导航去除第二行状态，窄栏保留上下文与状态文字。
+
+保留原目标图标与「招投标」菜单。不改变 Host 业务数据格式、依赖、权限、计费或其他仓库，不发布市场资料。
+
+## 验证与限制
+
+发布前重新执行完整 npm run check、隔离 Chromium UI 矩阵及 git diff --check。基线已有 42 文件、230 测试通过、1 项既有跳过；8 组浅深色/尺寸 UI 回归及 320px 容器验证。最终结果及 CI/Registry 回读在发布后补记。
+
+真实 DSH 四插件同装和真实 QCC Provider 本轮未运行，不能由发布成功代签。历史仅提供本 Session 已保存查询记录；跨会话索引、实时 MCP 连接状态、细粒度未提交编辑的统一恢复未接入。查询草稿/导航内存刷新或卸载后清除，任务/制品由 Host 保留。兼容对照 Better Sidebar 0.17.1 的公开能力与 mount/store 契约，不扩大 peer 范围。
+
+## 流程及回滚
+
+release 分支 → PR CI/审核 → 锁定 SHA 合并 → 精确 main SHA CI → annotated v0.5.4 → OIDC npm/provenance → GitHub Release → Registry 回读。公开 tag/版本不覆盖；失败不得复用 npm 版本。
+
+回滚：备份用户任务目录后安装 dsh-tender-workbench@0.5.3，并按既有方式重启 DSH web；本轮不操作用户生产进程。
+
+详细采用记录：[QCC-BLUE-UI-ACCEPTANCE.md](QCC-BLUE-UI-ACCEPTANCE.md)。