dsh-mcp-connector 0.2.81 → 0.2.83

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；首个公开版本从 `0.1.0` 开始。
 
+## [0.2.83] - 2026-10-26
+
+### Fixed
+
+- #190 / PR #191：连接范围变更和回退的确认框限制最大高度，正文独立滚动，标题与确认、取消按钮保持可见；工具列表只展示前 12 项并注明总数。
+- 不修改连接范围应用、回退、乐观锁或凭据处理语义。
+
+### Documentation and verification
+
+- 同步当前版本文档，并重新采集本版本无凭据 Mock 截图及 GIF；素材不代表真实授权或业务调用成功。
+- macOS 浏览器组件验收覆盖 360×400、640×300、1000×720 视口、8 个 Server 各 125 个长工具名、正文滚动、键盘确认/取消及焦点恢复；不等同于 Windows Desktop 实机验收。
+- #178、#181 保持开放，继续等待原报告者 Windows 复测。
+
+## [0.2.82] - 2026-10-26
+
+### Added
+
+- 新增首次使用只读引导，将安装、授权、工具发现/缓存和真实业务调用拆成独立阶段；只读取当前作用域内的状态和缓存，不把“已安装”“有缓存”或“已复制草稿”误判为业务成功。
+- 新增“分享使用体验”草稿编辑器。用户选择公开教程模板、按实际情况填写版本与步骤状态后，只有明确点击才会把脱敏文本带入会话草稿；Host 返回成功前不宣称已带入，失败时保留预览供修正重试。
+- 新增确定性安全连接模板分享。输出只包含白名单允许的固定结构和审核过的公开目录引用；自定义 URL、连接名称、凭据、Header、OAuth Grant、stdio 命令与环境变量不会进入分享结果。
+
+### Changed
+
+- 增强外部分发源审计：以 npm `latest` 为规范版本，严格检查 awesome-dsh-plugin/DSH Market、dshopen 及受监控目录的版本与 npm 安装元数据；`stale`、`invalid`、`missing`、`unavailable` 均不能通过同步门禁。
+- 分发漂移继续由单一自动跟踪项维护；已有目录等待同步或元数据修正时，不重复提交外部上架 PR/Issue。
+
+### Security and privacy
+
+- 所有分享行为均需用户明确操作；插件不会自动发送消息、调用业务工具、公开发帖或上传业务数据。本版本不新增遥测，也不读取完整对话、真实工具返回、账号、凭据或现有连接配置来推断分享状态。
+- 非法版本或模板输入失败时保持选择器、内容和预览一致，并给出可纠正提示，不以半更新界面继续生成草稿。
+
+### Verification scope and known limitations
+
+- 完整 `npm run check`：502 项测试，494 通过、8 项按环境条件跳过、0 失败；99 个发布文件通过白名单以及凭据/本机路径扫描。跳过项不计作通过。
+- 自动化、无凭据 UI harness 与缓存/localhost 合成测试只证明代码路径和安全边界，不替代真实 DSH Host、真实 OAuth、真实连接、付费业务调用或搜索排名验收。
+- 2026-10-16 的企业简介证据只证明当时已有连接完成过一次获准的真实只读调用，不能外推为 v0.2.82 首次安装、首次授权、JSON 迁移、连接恢复或所有业务工具成功。
+- 仓库截图和 GIF 是标注版本的无凭据 Mock 素材；分发版本/安装元数据同步也不等于搜索排名、曝光、安装转化或业务成功。
+
 ## [0.2.81] - 2026-10-25
 
 ### Documentation
@@ -1072,7 +1110,9 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.48...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.83...HEAD
+[0.2.83]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.82...v0.2.83
+[0.2.82]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.81...v0.2.82
 [0.2.48]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.47...v0.2.48
 [0.2.47]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.46...v0.2.47
 [0.2.46]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.45...v0.2.46

package/README.en.md

@@ -106,7 +106,7 @@ As of 2026-10-24, the public Registry publishes 112 connector descriptors. After
 | Connection diagnostics and last-success cache |  |
 | ![Connection diagnostics](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/07-connection-diagnostics.png) |  |
 
-Assets `01`, `02`, `04`, and `07` are `v0.2.73` demos captured on 2026-10-16; `03` retains a historical `v0.2.37` snapshot; `05`, `06`, and the 43-second GIF retain `v0.2.46` demos. All are credential-free Mock UI harness assets, not evidence of real business acceptance on the current version. They contain no credentials, local paths, or query results. See [`docs/screenshots/README.md`](docs/screenshots/README.md) for provenance.
+<!-- generated:media -->Screenshots and GIF were captured from v0.2.83 (2026-10-26), using the credential-free Mock harness. They demonstrate UI, not real business acceptance; counts are fixtures. See [asset provenance](docs/screenshots/README.md).<!-- /generated:media -->
 
 ## Installation
 
@@ -231,7 +231,7 @@ npm run dev:ui
 
 Every Registry merge regenerates `catalog-stats.json`; an hourly workflow in this repository synchronizes the Chinese and English product copy plus a local stats snapshot. The static npm README updates with package releases, while the live badges above read the Registry directly and therefore stay current without another npm release.
 
-The current public version is [`dsh-mcp-connector@0.2.81`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.81](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.81).
+<!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.83`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.83](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.83).<!-- /generated:version -->
 
 See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
 

package/README.md

@@ -108,7 +108,7 @@ Desktop 需要完全退出并重新启动应用；Web 需要停止原 `dsh web`
 | 连接诊断与最后成功缓存 |  |
 | ![连接诊断](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/07-connection-diagnostics.png) |  |
 
-`01`、`02`、`04`、`07` 为 2026-10-16 的 `v0.2.73` 演示；`03` 保留 `v0.2.37` 历史快照；`05`、`06` 与 43 秒 GIF 保留 `v0.2.46` 演示。全部来自无凭据 Mock UI harness，不是当前版本的真实业务验收证据，不包含凭据、本机路径或查询结果。详见 [`docs/screenshots/README.md`](docs/screenshots/README.md)。
+<!-- generated:media -->截图与 GIF 采集自 v0.2.83（2026-10-26）无凭据 Mock 页面，展示界面而非真实业务验收；市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
 
 ## 安装
 
@@ -226,7 +226,7 @@ npm run dev:ui
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.81`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.81](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.81)。
+<!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.83`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.83](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.83)。<!-- /generated:version -->
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/docs/DATA-MCP-CONTRIBUTION-REVIEW.md

@@ -0,0 +1,60 @@
+# 数据 MCP 贡献与验收模板
+
+## 原则
+
+自动发现分数、`initialize`、`tools/list` 或元数据工具成功，都不等于业务数据验收通过。新卡片只能在官方证据、条款、去重、限定范围真实只读调用与具名人工批准都完成后进入 Registry PR。
+
+## 禁止推荐清单
+
+以 Registry `docs/DEFERRED-CONNECTORS.md` 为当前人工决策依据，本轮继续保留全部 5 项，不因自动发现命中而重新推荐：
+
+- `dsh-qixin-insight-mcp-oauth`
+- `dsh-plugin-xparse`
+- `shuididata/mcp-server`（机器规则中的稳定身份为 `shuidi-enterprise-data`）
+- `mcp-cnbs`
+- `chinese-law-mcp`
+
+注：`discovery-sources/exclusions.json` 当前只稳定阻断后 3 类身份；启信慧眼与 TextIn xParse 仍需在 Registry 的独立变更中补齐机器规则和回归测试。本工作线不修改 Registry。
+
+## 候选提交字段
+
+```text
+候选名称：
+提供方与国内/海外属性：
+用途与数据范围：
+官方页面 / 官方仓库 / Official Registry / 包或端点：
+鉴权、付费与额度：
+代码许可证、数据许可与服务条款：
+维护状态（是否归档、最近更新、版本）：
+重复关系（稳定身份、端点、上游数据、已上架卡片）：
+协议验收（initialize / tools/list / 只读注解）：
+业务验收（指定工具、最小参数、返回字段、来源、单位、时间范围、缺失值）：
+状态：PASS / SKIP / FAIL / DEFERRED
+失败或延期原因：
+评分与下一步：
+审核人与日期：
+```
+
+不记录凭据、完整业务响应、客户数据、个人数据或本机路径。运行证据只保留时间、版本、工具名、状态、字段摘要与脱敏哈希。
+
+## 验收门槛
+
+| 层级 | 通过条件 | 未通过时状态 |
+|---|---|---|
+| 身份与条款 | 提供方、代码/数据许可、服务条款、鉴权与费用可核对 | `DEFERRED` 或 `SKIP` |
+| 去重与排除 | 与现有卡片、稳定身份及禁止清单完成对照 | `SKIP` |
+| 协议 | `initialize`、`tools/list` 成功，工具的读写/破坏性边界明确 | `DEFERRED` 或 `FAIL` |
+| 业务数据 | 至少一次限定范围的真实只读调用，并核对字段、来源、时间、单位与缺失值 | `DEFERRED` |
+| 人工决策 | 具名批准且范围与已验收能力一致 | 不得创建正式卡片 |
+
+## 2026-10-25 候选证据清单
+
+最新 [Issue #17](https://github.com/duhu2000/dsh-mcp-connector-registry/issues/17) 报告扫描 3,187 条、识别 606 个数据候选，自动 `selected` 仍为 0。[Issue #19](https://github.com/duhu2000/dsh-mcp-connector-registry/issues/19) 的自动排序不替代许可、条款与真实调用验收。本轮没有可直接上架的新候选：
+
+| 候选 | 已有证据 | 未完成 | 状态 |
+|---|---|---|---|
+| HKEX 上市公司公告检索（社区） | 协议可达，4 个工具，`get_server_info` 元数据调用成功 | 未执行公告检索/读取，未核对来源、字段与时间范围 | `DEFERRED` |
+| UNESCO UIS 全球教育统计（社区） | 协议可达，5 个工具，`uis_list_geo_units` 元数据调用成功 | 未查询统计值，未核对单位、版本、来源与缺失值 | `DEFERRED` |
+| Shumi 加密市场研究 | 协议可达，33 个工具有 `readOnlyHint` | 无授权测试 Key，业务调用、额度与条款边界未验收 | `DEFERRED` |
+
+结论：三者都不得因协议或元数据成功而标为业务 `PASS`，不创建新卡片、不批量上架。

package/docs/SHAREABLE-CONNECTION-TEMPLATES.md

@@ -0,0 +1,92 @@
+# 安全可分享连接模板
+
+## 定位
+
+可分享模板不是完整配置备份，也不是可自动执行的安装脚本。它只保留让另一位用户理解“连什么”所必需的最小字段；凭据必须在目标本机重新填写，OAuth 和 stdio 目录项必须回到市场重新授权或确认。
+
+## 核心契约
+
+`lib/shareable-connection-template.js` 导出：
+
+- `createShareableTemplateFromConnection(record, options)`：仅用于用户明确选择的连接；复用已有脱敏导出后再按白名单重建。
+- `createShareableTemplateFromCatalog({connectorId, serverKey})`：只按 ID 从包内已审计、已发布目录解析；不接受用户粘贴的 descriptor。
+- `assertShareableConnectionTemplate(input)`：严格白名单校验，未知字段直接拒绝，不静默过滤。
+- `previewShareableConnectionTemplate(input)`：返回预览、待补字段、后续动作和 `requiresExplicitConfirmation=true`；不连接、不写入。
+- `stringifyShareableConnectionTemplate(input)`：只序列化已通过上述严格校验的文档。
+
+导入仍使用现有 `normalizeJsonImport()` 与 Host 显式确认链。凭据占位符 `<REDACTED:REENTER>` 未替换时，现有导入器会整体拒绝。本模块不提供绕过确认的执行 API。
+
+## 允许与拒绝
+
+| 输入 | 结果 | 原因 |
+|---|---|---|
+| 无额外 Header 的用户自定义 HTTP | 允许，但 URL、显示名和 serverName 都改为固定重填/公开值 | host、路径、子域名与自定义名称都可能携带租户或凭据 |
+| Bearer/API Key HTTP | 允许，凭据改为占位符 | 目标用户必须在本机重填；API Key Header 只允许四个通用名称 |
+| 用户自定义 URL（包括 userinfo、子域、路径、查询串、fragment、IP） | 不输出原值 | 整个 URL 改为重填占位符，不分享端点、租户或内网拓扑 |
+| 自定义 Headers | 拒绝 | 不用 Header 名黑名单猜测值是否敏感 |
+| 自定义 stdio | 拒绝 | 命令、参数、env、cwd 可能含凭据、本机路径或任意执行 |
+| 包内已审计公开目录连接（HTTP / OAuth / stdio） | 仅输出 `connectorId/serverKey` 及 `connect-from-catalog` 引用 | 目标端从当前已审计目录重新解析；不复制 URL、Header、Grant、CLI、args 或 env |
+| 用户粘贴或伪造的“公开 descriptor” | 拒绝 | `redacted=true` 不能证明 ID、名称或子域是公开信息 |
+| 含未知字段的“模板” | 拒绝 | fail closed，不做过滤后继续 |
+
+### 允许样例（节选）
+
+```json
+{
+  "format": "dsh-mcp-connector.share-template",
+  "version": 1,
+  "redacted": true,
+  "source": { "kind": "user-provided" },
+  "connections": [{
+    "name": "自定义 MCP 连接",
+    "serverName": "custom-mcp",
+    "transport": "streamable-http",
+    "url": "<REDACTED:REENTER>",
+    "headers": {},
+    "authMode": "api-key",
+    "apiKeyHeader": "X-Api-Key",
+    "apiKeyValue": "<REDACTED:REENTER>",
+    "redactedFields": ["url", "apiKeyValue"]
+  }]
+}
+```
+
+### 拒绝样例
+
+```json
+{
+  "transport": "stdio",
+  "command": "<LOCAL_PATH>/private-mcp",
+  "args": ["--token", "secret"],
+  "env": { "VENDOR_TOKEN": "secret" }
+}
+```
+
+拒绝结果不回显上述值，只说明应改用经审计的公开目录模板。
+
+## P0 前端接入
+
+`ui/connection-template-sharing.js` 是无数据权限的纯前端 ES module。它不将安全性交给 LLM，而是在浏览器内执行确定性的白名单转换，然后由用户显式选择复制、下载或带入新会话草稿。
+
+宿主必须把当前已审计且 `published !== false` 的目录转换为仅含 `connectorId/serverKey/name/serverName` 的 `catalogReferences`；不能将用户 JSON 当成白名单。
+
+```js
+import { mount } from '/mcp-connector/ui/connection-template-sharing.js';
+
+const dispose = mount(container, {
+  catalogReferences: publishedCatalog.flatMap((connector) =>
+    connector.servers.map((server) => ({
+      connectorId: connector.id,
+      serverKey: server.serverKey,
+      name: connector.name,
+      serverName: server.serverName,
+    }))),
+  openDraft: async (text) => { /* start-session → Host setDraft，不发送 */ },
+  showMessage: (message, type) => { /* type 为 'success' 或 'error' */ },
+});
+
+// 卸载面板时
+dispose();
+```
+
+模块不读取 API、storage、真实连接、凭据或业务结果，也不提供粘贴 URL/Token/Header 值的输入框。预览本身不产生外部写入；复制、下载和 `openDraft(text)` 都要求独立点击。`openDraft` 只接收已生成的安全 JSON，文本只进入新会话草稿，不自动发送。样式在模块内按 `.mcp-safe-template-share` 作用域注入，无第三方依赖。

package/docs/screenshots/README.md

@@ -1,29 +1,30 @@
-# UI 素材说明
+# 产品截图与演示的来源及更新
 
-本目录保存 `dsh-mcp-connector` 的公开界面截图。所有素材均来自无凭据 UI harness：外层浏览器视口为 1280×720，harness 复刻 `lib/client.js` 中定义的 800px 产品面板，因此桌面端稳定为一行 2 张卡片。画面只展示公开目录元数据、示例 Prompt 和明确标识为 Mock 的工具数据，不包含 OAuth Token、API Key、本机路径、用户会话或查询结果。
+<!-- generated:media -->本组 7 张截图和 GIF 均从 v0.2.83 于 2026-10-26 重新采集，未修改截图中的版本文字。<!-- /generated:media -->
 
-素材分为三组，避免把历史截图误写成当前版本：
+全部素材由真实产品 UI 的无凭据 Mock harness 渲染：1280×720 浏览器视口、800px 产品面板、桌面两列卡片。顶部保留“无凭据 Mock”标识；目录数、连接数与工具数是演示夹具，不代表生产统计或真实授权、业务验收。不会读取用户 profile、调用服务商或上传业务数据。
 
-- `01`、`02`、`04` 和 `07` 是 2026-10-16 从 `v0.2.73` 隔离 UI harness 采集的当前 Mock 素材，分别展示市场、OAuth 连接器详情、JSON 导入和故障诊断。
-- `03` 是 2026-09-06 从 `v0.2.37` 采集的历史工具发现快照。
-- `05`、`06` 和 `../demo.gif` 是 2026-09-14 从 `v0.2.46` UI harness 采集的历史工具搜索、参数和演示素材。harness 中的目录数量、连接数量和工具数量属于测试夹具，不代表生产市场统计。
+根目录 [screenshots.json](../../screenshots.json) 保持外部市场兼容的 7 张图片路径与顺序；[assets.json](assets.json) 是采集版本、日期、源码指纹、SHA-256、尺寸和 GIF 时长的唯一记录。
 
-旧素材曾直接以 1280px 打开内部 iframe，绕过真实产品的 800px 宿主面板，因此触发 `auto-fill/minmax(300px)` 的 3 列布局；这是采集 harness/视口过期，不是产品 CSS 漂移。当前全部登记素材都从浏览器中的真实页面状态直接截取，没有后期重排卡片或修改连接状态。
+| 文件 | 内容 |
+|---|---|
+| 01-market-overview.jpg | 初始市场与未连接卡片 |
+| 02-connector-detail.jpg | 连接器详情、权限与示例 |
+| 03-tool-discovery.jpg | Mock 连接后的工具发现 |
+| 04-json-import.jpg | JSON 导入与作用域 |
+| 05-unified-tool-search.png | 跨连接工具查询 |
+| 06-tool-parameters.png | 参数结构详情 |
+| 07-connection-diagnostics.png | 模拟发现失败与诊断 |
 
-仓库根目录的 [`screenshots.json`](../../screenshots.json) 按市场总览、连接器详情、工具发现、JSON 导入、统一工具搜索、参数详情和连接诊断的顺序声明 7 张图片，供 awesome-dsh-plugin 和 DSH Market 的 App Store 风格详情页采集。根清单保持外部消费者兼容的路径数组；[`assets.json`](assets.json) 记录采集版本、视口、产品面板、无凭据状态，以及每张截图和 `demo.gif` 的 SHA-256、尺寸与 GIF 时长。
+`docs/demo.gif` 由当前截图状态顺序编码，仅缩放和调色，不修改版本号或连接状态。旧素材可通过 Git 历史查看，不继续用作当前产品首屏。
 
-| 文件 | 展示内容 |
-|---|---|
-| `01-market-overview.jpg` | `v0.2.73` 当前 Mock 市场：800px 面板、桌面两列、推荐章节和 9 分类；未连接企查查卡片显示“连接” |
-| `02-connector-detail.jpg` | `v0.2.73` 当前 Mock OAuth 连接器详情：权限边界、试用 Prompt 和未连接工具状态 |
-| `03-tool-discovery.jpg` | `v0.2.37` Context7 无凭据 Mock 健康状态、Mock 工具数量/描述、搜索和独立滚动区 |
-| `04-json-import.jpg` | `v0.2.73` 当前 Mock Streamable HTTP / stdio JSON 导入、格式化、作用域和本机凭据提示 |
-| `05-unified-tool-search.png` | `v0.2.46` 统一工具搜索：跨连接结果、来源、发现失败和最后成功缓存 |
-| `06-tool-parameters.png` | `v0.2.46` 参数详情：必填、类型、枚举、嵌套结构和原始安全 Schema |
-| `07-connection-diagnostics.png` | `v0.2.73` 当前 Mock 连接诊断：成功缓存、模拟网络与传输失败、建议、“检查连接”和“重新发现工具” |
+## 更新与发布
 
-`../demo.gif` 由 6 个真实浏览器状态顺序编码：市场、连接器详情、工具详情、统一搜索、参数 Schema、连接诊断。时长 43 秒，分辨率 960×540；编码只做等比例缩放和 GIF 调色，不改变布局或状态。
+GitHub Markdown 不执行变量。`package.json.version` 是版本唯一源，运行 `npm run docs:sync` 生成有标记的当前版本文案；历史 Changelog、验收日期、最低支持版本和已发布文章记录不作全局替换。
 
-`npm run storefront:check` 校验路径、顺序、格式、文件存在性、哈希、尺寸和采集约束；`npm run check` 已包含该门禁。更新 UI 后继续使用 1280×720 浏览器视口、800px 产品面板和无凭据初始状态采集，并检查桌面两列、企查查卡片不出现“需重新授权”，且画面不包含凭据、本机路径、真实会话、查询结果或其他不应公开的内容。
+1. 修改版本或产品 UI 后，安装开发采集依赖：`npm install --no-save --legacy-peer-deps playwright@1.62.1`，并运行 `npx playwright install chromium`；另需 ffmpeg 和中文字体。
+2. 执行 `npm run storefront:capture`。脚本只启动随机回环端口，隔离浏览器不加载外部资源；支持 `CHROMIUM_EXECUTABLE` 指定本机 Chromium，`PLAYWRIGHT_MODULE` 指定开发依赖路径。
+3. 执行 `npm run docs:sync && npm run storefront:freshness && npm run check`，人工查看全部截图及 GIF，再随 PR 提交。不要仅修改 assets.json 的版本或日期。
+4. Release 工作流在发布前验证采集版本、源码指纹和 14 天有效期；旧图不会静默进入新的正式版本。先准备素材再打 Tag，不在不可变 Tag 上改图。
 
-截图顶部“无凭据 Mock”标识和工具名中的 `mock_` 前缀用于明确区分验收数据与真实授权。真实用户的已安装数量、授权状态和服务健康度会因本机环境而不同。
+产品素材工作流在 UI 主线更新、正式 Release 后、每周及手动触发时检查；需要更新时生成截图与文案，并更新同一个维护 PR。自动化只提出 PR，不自动合并，不向社交平台发布。GitHub/npm/CDN 缓存可能延迟，外部市场同步仍需复核。

package/docs/screenshots/assets.json

@@ -1,8 +1,9 @@
 {
   "schemaVersion": 1,
   "capture": {
-    "capturedOn": "2026-10-16",
-    "sourceVersion": "0.2.73",
+    "capturedOn": "2026-10-26",
+    "sourceVersion": "0.2.83",
+    "sourceFingerprint": "4a677c677d57b6389199d2bf6dfd5b376182444dd1105ba7afd34c335eb3b29e",
     "browserViewport": {
       "width": 1280,
       "height": 720
@@ -10,74 +11,73 @@
     "productPanelWidth": 800,
     "desktopCardColumns": 2,
     "state": "credential-free-mock",
-    "preservedLegacyScreenshots": 1,
-    "notes": "01, 02, 04 and 07 were captured from the v0.2.73 credential-free UI harness on 2026-10-16; 03 preserves the 2026-09-06 v0.2.37 snapshot; 05, 06 and demo.gif preserve the 2026-09-14 v0.2.46 harness capture."
+    "notes": "All assets re-rendered from the current credential-free harness; no production profile, credentials or provider calls."
   },
   "screenshots": [
     {
       "path": "docs/screenshots/01-market-overview.jpg",
-      "sha256": "2f681896cf8a6af274483d8e3a1b422062830d25373d088296641d7c65710900",
+      "sha256": "97265e2142b290c8ffdf75a402e65da6c1c34939adaba28ea4175d834a4252fa",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-10-16",
-      "sourceVersion": "0.2.73"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/02-connector-detail.jpg",
-      "sha256": "388090d0aecbfde81973b4841401ab31c73c36d67b8939a2476ba59cf99b11b2",
+      "sha256": "5c4433afc32d5ff629f3ce13c546ac8ed0ee7a09cfa321dadb691aae980192db",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-10-16",
-      "sourceVersion": "0.2.73"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/03-tool-discovery.jpg",
-      "sha256": "5eeb896db75a5f141a8463f128f7733ffe89af6a447cecb2d1b19f8287a3e1ec",
+      "sha256": "058f5aea7d11845677fb77937af82b4ad2957db363fde412e45aa9e579d7b586",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-09-06",
-      "sourceVersion": "0.2.37"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/04-json-import.jpg",
-      "sha256": "72634174da158d39bdf796466cf3852b1fc4445fad1c17e2ee23e98a44ccaf1f",
+      "sha256": "1d40f4d02b0338c192419f7f71dbf420faa8c92d4d0a5fd9f7676b7822bfcdb8",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-10-16",
-      "sourceVersion": "0.2.73"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/05-unified-tool-search.png",
-      "sha256": "a75119afeccdb666e1496917ab1cac50e368882412fe5ce16cfdb268c2a6595b",
+      "sha256": "e172da60d9abcf77639287180a4fd6b4b5dca1a95ba0f3967d7d36488fdae795",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-09-14",
-      "sourceVersion": "0.2.46"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/06-tool-parameters.png",
-      "sha256": "199a960e6c07c84ff2e3b99acf64536b6875f2ebf08b5a86a1df971cc120da70",
+      "sha256": "f09f04513af0f3ee40c455df5c537b1635ae42e83073c455bfd25db0e35625b7",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-09-14",
-      "sourceVersion": "0.2.46"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     },
     {
       "path": "docs/screenshots/07-connection-diagnostics.png",
-      "sha256": "810ea245b4f41a850b99a6cd302b9f03b10bdb50498401635fdb16befe8d07e8",
+      "sha256": "457898c3a256c06f613cc602dcd69193f54fcc59b5ca278228e66fc31a7e32cc",
       "width": 1280,
       "height": 720,
-      "capturedOn": "2026-10-16",
-      "sourceVersion": "0.2.73"
+      "capturedOn": "2026-10-26",
+      "sourceVersion": "0.2.83"
     }
   ],
   "demo": {
     "path": "docs/demo.gif",
-    "sha256": "69250ef0d6730d2c708c1fea6a3c8041d495008a40f53a02a894238601f165ec",
+    "sha256": "7501018e2e32d565a309473c666f1cf02601746ce78e04d2452a4368f851c1f1",
     "width": 960,
     "height": 540,
-    "durationSeconds": 43,
-    "capturedOn": "2026-09-14",
-    "sourceVersion": "0.2.46"
+    "capturedOn": "2026-10-26",
+    "sourceVersion": "0.2.83",
+    "durationSeconds": 36
   }
 }

package/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md

@@ -8,7 +8,7 @@
 
 | 项目 | 验收要求 |
 |---|---|
-| 前提 | 正式 `dsh-mcp-connector@0.2.59+`；当前 Workspace；企查查 OAuth 可用；测试账号具有目标企业数据权限 |
+| 前提 | <!-- generated:version -->正式 `dsh-mcp-connector@0.2.83`<!-- /generated:version -->；当前 Workspace；企查查 OAuth 可用；测试账号具有目标企业数据权限 |
 | 权限/管理员 | 账号权限、组织授权和可见字段由服务商控制；企业组织可能需要管理员开通，当前文档不能替代审批 |
 | 费用 | 可能受套餐、次数或字段权限影响；MCP连接器无法确认本次费用，调用前在服务商侧核对 |
 | 运行/数据去向 | 远程 MCP Server；企业名称、查询参数和调用结果经 DSH Host 发送到/返回自 `agent.qcc.com` |

package/docs/tutorials/SHARING-AUTHOR-ASSETS.md

@@ -0,0 +1,30 @@
+# 分享体验作者素材索引
+
+本索引帮助作者区分真实业务证据、真实界面观察、Mock 界面和仅有流程/测试的材料。素材可引用不等于流程已经验收；每次分享仍应由用户主动编辑，并按实际状态填写“成功 / 失败 / 未测试”。
+
+## 案例与教程
+
+| 素材 | 证据类别 | 已证明 | 未证明 | 公开使用边界 |
+|---|---|---|---|---|
+| [企业简介首次成功案例](ONE-SUCCESS-CASE.md) | 历史真实只读调用的脱敏摘要 | 2026-10-16 已有 `qcc-company` 连接完成一次 `get_company_profile` 只读调用，返回主体名称一致 | 当前版本流程、首次安装、首次 OAuth、JSON 迁移、连接恢复 | 可引用文档中的脱敏结论；不得复制原始业务正文、账号或凭据 |
+| [JSON 迁移教程](JSON-MIGRATION.md) | 流程文档 + localhost/合成测试 | 导入标准化、连接记录、Host 透传等代码路径有自动化覆盖 | 获授权真实 Server 的导入、发现和业务调用端到端成功 | 必须写“自动测试通过；真实 E2E 未测试/待验收” |
+| [工具查找与恢复教程](TOOL-SEARCH-RECOVERY.md) | 流程文档 + localhost/合成测试 | 失败保留最后成功缓存、重新发现恢复、筛选/分页/限流等代码路径有自动化覆盖 | 真实连接从故障到恢复，以及恢复后的真实业务调用 | 缓存、健康检查和重新发现都不能写成业务调用成功 |
+| [社区分享素材包](SHARING-KIT.md) | 作者指引 | 提供可复现提纲、披露和人工记录方法 | 尚未发生的发帖、转化或业务成功 | 不要求好评、Star 或转发；当前没有自动公开发布 |
+
+## 截图与视频
+
+仓库公开截图和 GIF 的尺寸、SHA-256、采集日期与来源版本见[截图来源说明](../screenshots/README.md)和 [`assets.json`](../screenshots/assets.json)。它们全部是无凭据 Mock 界面素材：
+
+| 资产 | 来源版本 | 可以说明 | 不能说明 | 建议图注 |
+|---|---|---|---|---|
+| `01`–`07`、`demo.gif` | 见 [assets.json](../screenshots/assets.json) | 无凭据 Mock 界面与操作流程 | 真实授权、真实恢复或业务成功 | 引用素材清单中的采集版本与日期，标注“无凭据 Mock”。 |
+
+`workspace/p0-evidence-2026-10-16/` 中的图片是本机真实 DSH Market 搜索页面，但仅用于搜索排名复核，未上传公共仓库且仍需隐私审查；它们不能证明连接、恢复或业务调用成功。
+
+## 不作为公开素材的证据
+
+- `workspace/MCP-CONNECTOR-P1-QCC-READONLY-EVIDENCE-2026-10-16.md` 保存内部真实调用证据，可能包含不应扩散的原始业务内容。公开分享只引用 `ONE-SUCCESS-CASE.md` 中的脱敏结论。
+- Token、API Key、OAuth 回调参数、账号/组织标识、本机绝对路径、完整对话和完整工具返回均不得进入体验草稿。
+- npm 下载量、连接数量、工具缓存、草稿预览或“复制到会话草稿”成功均不是业务调用证据。
+
+应用内接入契约与样式类见[分享体验模块接入说明](SHARING-UI-INTEGRATION.md)。

package/docs/tutorials/SHARING-KIT.md

@@ -18,7 +18,7 @@
 
 ## 图片与视频素材
 
-使用[截图目录及来源说明](../screenshots/README.md)，不要重制或抹掉 Mock 标记。`01`、`02`、`04`、`07` 为 `v0.2.73`，`03` 为 `v0.2.37`，`05`、`06` 与 GIF 为 `v0.2.46`；它们用于解释界面，不是最新版本的真实调用截图。
+使用[截图目录及来源说明](../screenshots/README.md)，不要重制或抹掉 Mock 标记。采集版本与日期统一以[素材清单](../screenshots/assets.json)为准；不能把界面演示当作真实调用截图。
 
 可用图注：“MCP连接器界面演示，Mock 数据；素材版本见来源说明，实际界面以安装版本为准。”
 
@@ -41,3 +41,5 @@
 自愿提交脱敏案例或问题到 [Issues](https://github.com/duhu2000/dsh-mcp-connector/issues)。希望参与开发可看[贡献指南](../../CONTRIBUTING.md)。Star 表达认可，Fork 用于实际修改与贡献，都不是使用条件。
 
 首轮邀请 5–10 位自愿体验者，手工记录安装、授权、工具发现、首次调用各阶段的成功/失败/未测试、实际耗时和阻塞原因。未计时不补估值，不新增遥测；样本仅用于改进体验，不外推整体转化率。npm 下载量也不等于独立用户或成功调用人数。
+
+作者在引用案例、教程、截图或 GIF 前，应先查看[分享体验作者素材索引](SHARING-AUTHOR-ASSETS.md)，区分历史真实只读摘要、流程/合成测试和 Mock 界面素材。应用内草稿模块的 P0 接入契约见[分享体验模块接入说明](SHARING-UI-INTEGRATION.md)。

package/docs/tutorials/SHARING-UI-INTEGRATION.md

@@ -0,0 +1,63 @@
+# 分享体验模块接入说明
+
+独立模块位于 [`ui/sharing-experience.js`](../../ui/sharing-experience.js)。本文件只描述 P0 集成契约；当前模块不会自行出现在 `ui/index.html`，也不会自动读取或发布任何内容。
+
+## 挂载接口
+
+```js
+import { mount } from './sharing-experience.js';
+
+const dispose = mount(container, {
+  openDraft: async (text) => {
+    const session = await startSession();
+    await host.setDraft(session, text);
+  },
+  showMessage: (text, type) => showMessage(text, type),
+});
+
+// 面板卸载时调用
+dispose();
+```
+
+接口约束：
+
+- `mount(container, { openDraft, showMessage })` 返回一个 `dispose()` 函数。
+- `openDraft(text)` **只在用户点击“复制到会话草稿”后调用**。P0 负责复用现有 `start-session → Host setDraft` 流程；只写入输入草稿，不发送消息。
+- `showMessage(text, type)` 是可选宿主提示；调用失败不会改变或发送草稿。
+- 未提供 `openDraft` 时按钮禁用，预览与编辑仍可使用。
+- 模块不接收会话、连接、工具缓存、工具返回、凭据或账号对象，不访问网络、storage、剪贴板或遥测接口。
+
+## 纯函数接口
+
+- `createSharingExperience(input)`：只接受 `task`、`versions`、`steps`、`limitations`（及固定 `schemaVersion`）。未知字段拒绝。
+- `createSharingExperienceFromTemplate(templateId, versions)`：加载 `companyProfile`、`jsonMigration`、`toolRecovery` 三个公开教程模板；所有步骤默认“未测试”。
+- `editSharingExperience(current, patch)`：显式编辑白名单字段，不修改原对象。
+- `renderSharingExperiencePreview(draft)`：生成纯 Markdown 预览，转义用户文本。
+- `createSharingCopyPayload(draft)`：返回纯文本载荷，固定 `copied: false`、`businessOutcome: unchanged`，不执行复制。
+- `SHARING_AUTHOR_ASSETS`：提供案例、教程和 Mock 截图的来源/边界索引。
+
+疑似 Bearer、API Key、Token/Secret、OAuth `code/state/token` 回调、`file:` URL，以及 macOS/Linux/Windows 用户绝对路径会被拒绝并要求先脱敏。版本字段为空时显示“未填写”；填写时必须是语义版本。
+
+## 样式与依赖
+
+模块无第三方依赖，不注入样式。P0 可在共享 UI 中按现有设计系统样式化以下类：
+
+- `.sharing-experience`
+- `.sharing-experience-form`
+- `.sharing-experience-field`
+- `.sharing-experience-steps`
+- `.sharing-experience-step`
+- `.sharing-experience-actions`
+- `.sharing-experience-message`
+- `.sharing-experience-preview`
+
+预览节点使用 `<pre>.textContent`，不得改为把 Markdown 作为 HTML 注入。
+
+## 测试
+
+```bash
+node --test test/sharing-experience.test.mjs
+npm run check
+```
+
+专门测试覆盖模板默认状态、显式编辑、未知信号拒绝、凭据/回调/路径拒绝、Markdown 转义、素材证据分类、用户点击前不调用 `openDraft`、复制后业务状态不变、销毁监听器，以及源码无网络/storage/剪贴板/连接访问。

package/lib/catalog.js

@@ -42,6 +42,19 @@ export function loadBundledCatalog() {
   }
 }
 
+/** Sharing trust root: fixed package catalog only, never merged/config/remote sources. */
+export function bundledTemplateReferences() {
+  return loadBundledCatalog().filter((item) => item.published !== false).flatMap((item) => {
+    const descriptor = auditDescriptor(item);
+    return descriptor.servers.map((server) => ({
+      connectorId: descriptor.id,
+      serverKey: server.serverKey,
+      name: descriptor.name,
+      serverName: server.serverName,
+    }));
+  });
+}
+
 /** 安全审计：目录禁止携带密钥、URL 协议白名单、header 名白名单。 */
 export function auditDescriptor(descriptor) {
   const oauthHttpResources = new Set(

package/lib/index.js

@@ -26,7 +26,7 @@ import {
 } from './constants.js';
 import { defineConnectorDomain, ConnectionStore, GrantStore, CatalogStore, SnapshotStore, GovernanceStore, ConnectionScopeStore, ToolCatalogStore } from './stores.js';
 import { normalizeConnectorDescriptor, normalizeConnectionRecord } from './schema.js';
-import { loadBundledCatalog, fetchRemoteCatalogWithFallback, visibleDynamicDescriptors, mergeCatalog, listCatalog, auditDescriptor, auditRawDescriptor, readLimitedJson } from './catalog.js';
+import { bundledTemplateReferences, loadBundledCatalog, fetchRemoteCatalogWithFallback, visibleDynamicDescriptors, mergeCatalog, listCatalog, auditDescriptor, auditRawDescriptor, readLimitedJson } from './catalog.js';
 import { describeOAuthAuthorizationError, oauthAuthorize } from './connectors/oauth-connector.js';
 import { buildManualRecord } from './connectors/manual-connector.js';
 import { normalizeJsonImport } from './connectors/json-connector.js';
@@ -1897,6 +1897,14 @@ export async function apply(ctx, config) {
       }
     },
 
+    async templateCatalogReferences() {
+      try {
+        return { ok: true, detail: { items: bundledTemplateReferences() } };
+      } catch {
+        return { ok: false, message: '随包公开目录不可用，未读取任何本机连接。' };
+      }
+    },
+
     async catalog({ category, keyword, workspaceId } = {}) {
       const items = listCatalog(state.merged, { category, keyword, publishedOnly: true }).map((d) => {
         const health = connectorHealth(d.id);