dsh-mcp-connector 0.2.28 → 0.2.30

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 ## [Unreleased]
 
+## [0.2.30] - 2026-08-30
+
+### Added
+
+- 新增营销元数据事实源与线上/离线漂移检查，统一 npm 描述与关键词、GitHub About/Topics、中英文首屏 CTA 和外部分发文案。
+- 新增贡献模板、good first issue 入口、自然搜索/转化基线与发布前监控检查。
+
+### Changed
+
+- 更新中英文产品介绍、npm 检索词与 GitHub Topics，突出 MCP Server 连接、Registry、OAuth 2.0 PKCE 与 stdio/HTTP 能力。
+- 重新录制无真实凭据的市场截图与演示 GIF：实际两列卡片布局，企查查卡片不再展示“需重新授权”。
+- 已安装但尚无连接时不再强制弹出转化引导；首次连接成功或存在历史连接后才展示，且每页面生命周期仅一次。
+
+### Verification
+
+- 152 项自动测试、lint、npm 发布包白名单/敏感内容扫描、商店素材哈希与尺寸校验通过。
+
+## [0.2.29] - 2026-08-30
+
+### Fixed
+
+- 更新服务返回 `RELEASE_TOO_FRESH` 时明确提示“发布安全等待期”，不再误写为镜像同步；主动跳过等待的操作也改为“立即更新（跳过等待）”。
+- DSH Desktop 或其他无兼容 Update Provider 的宿主直接展示精确版本升级命令，并支持一键复制与打开 npm 页面，不再只给出泛化的“查看更新方式”。
+
 ## [0.2.28] - 2026-08-29
 
 ### Documentation
@@ -449,7 +473,9 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.28...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.30...HEAD
+[0.2.30]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.29...v0.2.30
+[0.2.29]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.28...v0.2.29
 [0.2.28]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.27...v0.2.28
 [0.2.27]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.26...v0.2.27
 [0.2.26]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.25...v0.2.26

package/CONTRIBUTING.md

@@ -9,6 +9,7 @@ Thank you for contributing. Never put tokens, API keys, cookies, OAuth credentia
 - 报告缺陷或提交功能建议：[GitHub Issues](https://github.com/duhu2000/dsh-mcp-connector/issues)
 - 为公共市场增加连接器：阅读 [Connector onboarding](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)，连接器描述与插件代码分仓管理。
 - 修复插件或改进文档：Fork 本仓库，从最新 `main` 创建单一目的的分支并提交 PR。
+- 第一次参与：从带有 [`good first issue`](https://github.com/duhu2000/dsh-mcp-connector/labels/good%20first%20issue) 标签的任务开始，并按[首次贡献路径](docs/FIRST-CONTRIBUTION.md)完成本地校验。
 - 搭建私有目录：参考 [README 配置说明](README.md#配置) 和 [市场注册指南](docs/MARKET-REGISTRATION.md)。
 
 ## 本地开发
@@ -53,3 +54,7 @@ npm run check
 ```
 
 提交时说明用户问题、解决方案、测试结果与必要的手工验收步骤。
+
+## 维护者如何准备首次贡献任务
+
+首次贡献任务应边界清楚、无需真实凭据或私有 DSH 环境，并在 Issue 中写明背景、建议修改文件、验收标准和验证命令。适合的范围包括文档示例、无凭据测试夹具、可访问性文案和小型校验器改进；涉及发布、OAuth 凭据、Registry 上架审批或大规模重构的工作不应标记为 `good first issue`。

package/README.en.md

@@ -8,7 +8,7 @@ Manage MCP connections from different providers in one place inside DeepSeek Har
 
 [简体中文](README.md)
 
-[Chinese user guide](docs/USER-GUIDE.md) · [Connector onboarding](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/duhu2000/dsh-mcp-connector/issues)
+[Chinese user guide](docs/USER-GUIDE.md) · [Connector onboarding](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [First contribution](docs/FIRST-CONTRIBUTION.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/duhu2000/dsh-mcp-connector/issues)
 
 [![CI](https://github.com/duhu2000/dsh-mcp-connector/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-mcp-connector/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-mcp-connector.svg)](https://www.npmjs.com/package/dsh-mcp-connector)
@@ -30,7 +30,7 @@ Fully restart DeepSeek Harness Desktop or `dsh web` after installation or upgrad
 
 ![16-second MCP Connector walkthrough](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/demo.gif)
 
-If the plugin helps you connect an MCP server faster, consider [starring the repository](https://github.com/duhu2000/dsh-mcp-connector/stargazers). Connector submissions, compatibility fixes, and documentation pull requests are welcome.
+If the plugin helps you connect an MCP server faster, consider [starring the repository](https://github.com/duhu2000/dsh-mcp-connector/stargazers), [submitting a connector](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md), or [contributing a fix](CONTRIBUTING.md).
 
 ## Why use MCP Connector
 
@@ -72,7 +72,7 @@ As of 2026-08-27, the public Registry publishes 79 connector descriptors. After
 | Tool discovery, descriptions, and scrolling | JSON import |
 | ![Tool discovery](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/03-tool-discovery.jpg) | ![JSON import](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/04-json-import.jpg) |
 
-The assets are captured from a local DSH `web` acceptance environment and show only public marketplace metadata, example prompts, and tool descriptions. They contain no credentials, local paths, or query results. See [`docs/screenshots/README.md`](docs/screenshots/README.md) for provenance.
+The assets are captured from a credential-free UI acceptance harness that mirrors the real 800px product panel, producing two cards per desktop row. They show only public marketplace metadata, example prompts, and explicitly marked mock tool descriptions—never credentials, local paths, or query results. See [`docs/screenshots/README.md`](docs/screenshots/README.md) for provenance.
 
 ## Installation
 
@@ -107,7 +107,9 @@ The detailed [Chinese user guide](docs/USER-GUIDE.md) covers category browsing,
 - [Plugin updates: version discovery, providers, and rollback](docs/PLUGIN-UPDATE.md)
 - [Marketplace registration: local cards, the public Registry, and OAuth requirements](docs/MARKET-REGISTRATION.md)
 - [Third-party connector onboarding](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)
+- [First contribution: from a good first issue to your first PR](docs/FIRST-CONTRIBUTION.md)
 - [Development, forks, and contributions](CONTRIBUTING.md)
+- [Growth baseline and monthly review template](docs/GROWTH-BASELINE.md)
 
 ## Connector catalog
 
@@ -137,17 +139,18 @@ Set `catalogUrl` to an empty string for an explicitly offline/private setup. A c
 
 ```bash
 npm run check
+npm run marketing:check:live
 npm run registry:build
 npm run registry:validate
 npm run market:check
 npm run dev:ui
 ```
 
-`npm run check` performs syntax checks, README/package version consistency validation, automated tests, and an npm package allowlist/sensitive-content audit. `npm run market:check` tracks the external DSH marketplace PR and live directory. Tags matching `v*` trigger GitHub Actions; the tag must match `package.json`. npm releases use Trusted Publishing through GitHub OIDC and do not require a long-lived `NPM_TOKEN`.
+`marketing/metadata.json` is the source of truth for the npm description/keywords, GitHub About/Topics, bilingual first-screen CTAs, and external listing copy. `npm run check` blocks repository drift offline; `npm run marketing:check:live` also compares the public GitHub and npm metadata for metadata changes and monthly reviews. `npm run market:check` tracks the external DSH marketplace PR and live directory. Tags matching `v*` trigger GitHub Actions; the tag must match `package.json`. npm releases use Trusted Publishing through GitHub OIDC and do not require a long-lived `NPM_TOKEN`.
 
 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.28`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.28](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.28).
+The current public version is [`dsh-mcp-connector@0.2.30`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.30](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.30).
 
 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

@@ -8,7 +8,7 @@
 
 [English](README.en.md)
 
-[用户手册](docs/USER-GUIDE.md) · [第三方连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [参与贡献](CONTRIBUTING.md) · [问题反馈](https://github.com/duhu2000/dsh-mcp-connector/issues)
+[用户手册](docs/USER-GUIDE.md) · [第三方连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [首次贡献](docs/FIRST-CONTRIBUTION.md) · [参与贡献](CONTRIBUTING.md) · [问题反馈](https://github.com/duhu2000/dsh-mcp-connector/issues)
 
 [![CI](https://github.com/duhu2000/dsh-mcp-connector/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-mcp-connector/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-mcp-connector.svg)](https://www.npmjs.com/package/dsh-mcp-connector)
@@ -30,7 +30,7 @@ dsh plugin --profile web add dsh-mcp-connector
 
 ![MCP 连接器 16 秒演示](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/demo.gif)
 
-如果它帮你更快地接入 MCP Server，欢迎在 [GitHub 点个 Star](https://github.com/duhu2000/dsh-mcp-connector/stargazers)；新的连接器、兼容性修复和文档改进也欢迎提交 PR。
+如果它帮你更快地接入 MCP Server，欢迎 [GitHub 点个 Star](https://github.com/duhu2000/dsh-mcp-connector/stargazers)、[提交新的连接器](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)或[参与贡献](CONTRIBUTING.md)。
 
 ## 为什么使用 MCP连接器
 
@@ -74,7 +74,7 @@ dsh plugin --profile web add dsh-mcp-connector
 | 工具发现、描述与独立滚动 | JSON 导入 |
 | ![工具发现](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/03-tool-discovery.jpg) | ![JSON 导入](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/04-json-import.jpg) |
 
-素材从本机 DSH `web` 验收环境采集，只展示公开市场元数据、示例 Prompt 和工具说明，不包含凭据、本机路径或查询结果。详见 [`docs/screenshots/README.md`](docs/screenshots/README.md)。
+素材从复刻真实 800px 产品面板的无凭据 UI 验收环境采集，桌面端一行 2 张卡片；只展示公开市场元数据、示例 Prompt 和明确标识的 Mock 工具说明，不包含凭据、本机路径或查询结果。详见 [`docs/screenshots/README.md`](docs/screenshots/README.md)。
 
 ## 安装
 
@@ -109,7 +109,9 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/m
 - [插件更新：版本检测、Provider 与回滚](docs/PLUGIN-UPDATE.md)
 - [市场注册：本地卡片、公共 Registry 与 OAuth 要求](docs/MARKET-REGISTRATION.md)
 - [第三方连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)
+- [首次贡献：从 good first issue 到第一个 PR](docs/FIRST-CONTRIBUTION.md)
 - [开发、Fork 与贡献指南](CONTRIBUTING.md)
+- [增长基线与月度复盘模板](docs/GROWTH-BASELINE.md)
 
 ## 配置
 
@@ -132,17 +134,18 @@ Bundle 默认配置位于 `cordis.patch.yml`：
 
 ```bash
 npm run check
+npm run marketing:check:live
 npm run registry:build
 npm run registry:validate
 npm run market:check
 npm run dev:ui
 ```
 
-`check` 执行语法检查、README/包版本一致性校验、自动测试和 npm 发布包白名单校验；`market:check` 检查外部 DSH 市场 PR 与线上目录；`dev:ui` 启动不含真实凭据的本地 mock 市场。CI 使用 `--legacy-peer-deps` 安装显式测试依赖，DSH 运行期 peer 仍由 Host 提供。`v*` Tag 会触发 GitHub Actions；Tag 必须与 `package.json` 版本一致。Release 通过 npm Trusted Publishing (GitHub OIDC) 发布，不依赖长期 `NPM_TOKEN`。
+`marketing/metadata.json` 是 npm 描述/关键词、GitHub About/Topics、中英文首屏 CTA 和外部分发文案的事实源。`check` 会离线阻断仓库内漂移；`marketing:check:live` 进一步核对线上 GitHub 与 npm，供元数据调整和月度复盘时执行。`market:check` 检查外部 DSH 市场 PR 与线上目录；`dev:ui` 启动不含真实凭据的本地 mock 市场。CI 使用 `--legacy-peer-deps` 安装显式测试依赖，DSH 运行期 peer 仍由 Host 提供。`v*` Tag 会触发 GitHub Actions；Tag 必须与 `package.json` 版本一致。Release 通过 npm Trusted Publishing (GitHub OIDC) 发布，不依赖长期 `NPM_TOKEN`。
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.28`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.28](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.28)。
+当前公开版本为 [`dsh-mcp-connector@0.2.30`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.30](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.30)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/docs/FIRST-CONTRIBUTION.md

@@ -0,0 +1,31 @@
+# 首次贡献 / First contribution
+
+欢迎第一次参与 `dsh-mcp-connector`。优先选择带有 [`good first issue`](https://github.com/duhu2000/dsh-mcp-connector/labels/good%20first%20issue) 标签、且尚未被认领的任务；在 Issue 留言后再开始，避免重复劳动。
+
+Welcome! Start with an unassigned [`good first issue`](https://github.com/duhu2000/dsh-mcp-connector/labels/good%20first%20issue). Leave a short comment before working on it so contributors do not duplicate effort.
+
+## 适合第一次参与的范围
+
+- 中英文文档示例、安装或故障排查说明。
+- 不需要真实 Token、API Key 或私有服务的测试用例。
+- 键盘操作、可访问性标签和小型界面文案改进。
+- 元数据校验器与贡献者工具链的小改进。
+
+新的公共连接器描述不提交到本仓库，请改走独立 Registry 的[连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)。
+
+## 从 Issue 到 PR
+
+```bash
+git switch main
+git pull --ff-only
+git switch -c docs/<short-purpose>
+npm install --legacy-peer-deps
+npm run check
+```
+
+1. 只处理 Issue 定义的单一问题；不提交真实凭据、业务数据或本机路径。
+2. 中英文用户文案保持同步；行为变化需补测试。
+3. PR 中链接对应 Issue，并写清问题、改动、验证结果和必要的手工检查。
+4. 维护者确认验收标准后合并；版本发布由维护者统一安排。
+
+如果任务描述不够清楚，请先在 Issue 提问。首次贡献不要求拥有 DSH 私有环境，也不要求发布 npm 包。

package/docs/PLUGIN-UPDATE.md

@@ -25,7 +25,9 @@ DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始，要求 `s
 5. 完整性校验通过后，按 Provider 返回的激活结论展示“刷新生效”或重启提示。Web 且 Provider 明确允许进程重启时才展示“立即重启”；Desktop 等由外壳管理生命周期的宿主只提示用户重启，不自行杀进程。
 6. Provider 保留恢复点时展示“回滚”。回滚仍由 Provider 执行，MCP连接器不直接修改 profile、lockfile 或 `node_modules`。
 
-失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、镜像同步、版本未变化、超时和权限拒绝，以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。可重试失败保留重试操作；Registry 刚发布但镜像仍未同步时，用户可在看到明确提示后选择强制重试。
+失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、发布安全等待、镜像同步、版本未变化、超时和权限拒绝，以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。`RELEASE_TOO_FRESH` 明确显示为约 24 小时的发布安全等待期，并提供“立即更新（跳过等待）”；真正的镜像同步故障保留独立提示，不再混用同一文案。
+
+当 DSH Desktop 或其他宿主没有兼容 Update Provider 时，标题区直接展示绑定 npm 精确版本的 CLI 命令，例如 `dsh plugin --profile web add --config.minimumReleaseAge=0 dsh-mcp-connector@<目标版本>`，并提供复制按钮与 npm 页面入口。运行时会把 `<目标版本>` 替换为 npm 已发布的确切版本；命令中的单次覆盖只用于用户主动跳过本次发布安全等待。Connector 仍不自行执行包管理器命令。
 
 ## 安全边界
 

package/docs/screenshots/README.md

@@ -0,0 +1,35 @@
+# UI 素材说明
+
+本目录用于保存 `dsh-mcp-connector` 的公开界面截图。素材于 2026-08-30 从当前源码的
+无凭据 UI harness 采集：外层浏览器视口为 1280×720，harness 复刻产品宿主在
+`lib/client.js` 中定义的 800px 市场面板，因此桌面端稳定为一行 2 张卡片。公开 Registry
+快照含 79 条描述，与 4 张随包唯一卡片合并后市场显示 83 张。画面只展示公开市场元数据、
+示例 Prompt 和明确标识为 Mock 的工具数据，不包含 OAuth Token、API Key、本机路径、
+用户会话或查询结果。
+
+旧素材直接以 1280px 打开内部 iframe，绕过了真实产品的 800px 宿主面板，因此触发
+`auto-fill/minmax(300px)` 的 3 列布局；这是采集 harness/视口过期，不是当前产品 CSS 漂移。
+本次素材从浏览器中的真实页面状态直接截取，没有后期重排卡片或修改连接状态。
+
+仓库根目录的 [`screenshots.json`](../../screenshots.json) 按市场总览、连接器详情、工具发现、
+JSON 导入的顺序声明这 4 张图片，供 awesome-dsh-plugin 和 DSH Market 的 App Store 风格详情页
+直接采集。根清单保持外部消费者兼容的路径数组；[`assets.json`](assets.json) 记录
+1280×720 视口、800px 产品面板、2 列、无凭据状态，以及每张截图和 `demo.gif` 的
+SHA-256、尺寸与 GIF 时长。
+`npm run storefront:check` 会校验路径、顺序、格式、文件存在性、哈希、尺寸和采集约束；
+`npm run check` 已包含该门禁。
+
+| 文件 | 展示内容 |
+|---|---|
+| `01-market-overview.jpg` | 83 张合并市场卡片、桌面两列、推荐章节、9 分类和固定分类栏；企查查卡片均为未连接的“连接”状态 |
+| `02-connector-detail.jpg` | Seedream 第三方服务说明、精选 Prompt 和未连接状态 |
+| `03-tool-discovery.jpg` | Context7 无凭据 Mock 健康状态、Mock 工具数量/描述、搜索和独立滚动区 |
+| `04-json-import.jpg` | Streamable HTTP / stdio JSON 导入与本机凭据提示 |
+
+`../demo.gif` 由以上 4 个真实浏览器状态顺序编码，时长 16 秒，分辨率 960×540；编码只做
+等比例缩放和 GIF 调色，不改变布局或状态。更新 UI 后应继续使用 1280×720 浏览器视口、
+800px 产品面板和无凭据初始状态重新采集，并检查桌面两列、企查查卡片不出现
+“需重新授权”，且画面不包含凭据、本机路径、真实会话、查询结果或其他不应公开的内容。
+
+截图顶部“无凭据 Mock”标识和工具名中的 `mock_` 前缀用于明确区分验收数据与真实授权。
+真实用户的已安装数量、授权状态和服务健康度会因本机环境而不同。

package/docs/screenshots/assets.json

@@ -0,0 +1,46 @@
+{
+  "schemaVersion": 1,
+  "capture": {
+    "capturedOn": "2026-08-30",
+    "browserViewport": {
+      "width": 1280,
+      "height": 720
+    },
+    "productPanelWidth": 800,
+    "desktopCardColumns": 2,
+    "state": "credential-free-mock"
+  },
+  "screenshots": [
+    {
+      "path": "docs/screenshots/01-market-overview.jpg",
+      "sha256": "856dc020a285752f4cd4a1c1025df9ce68ace2cd90ee1aa06c6b0699c78763f6",
+      "width": 1280,
+      "height": 720
+    },
+    {
+      "path": "docs/screenshots/02-connector-detail.jpg",
+      "sha256": "0e15a26bbd21f8587b6354174d6d3411a6487e7a2df45d20c89f396b26f2ef65",
+      "width": 1280,
+      "height": 720
+    },
+    {
+      "path": "docs/screenshots/03-tool-discovery.jpg",
+      "sha256": "ca1eccf06506c829fc23212eee39306e64c5781da9c1eff959d4b597d5df2f97",
+      "width": 1280,
+      "height": 720
+    },
+    {
+      "path": "docs/screenshots/04-json-import.jpg",
+      "sha256": "2619ae8ba8f5d40131c6dfa2a367ee5ee64b8fee7782e5f4eddebd2a1cc79934",
+      "width": 1280,
+      "height": 720
+    }
+  ],
+  "demo": {
+    "path": "docs/demo.gif",
+    "sha256": "4fa49853df79faa1c53d28938d79dd43bde3603712ecdc2e3b62d93a4c219d9a",
+    "width": 960,
+    "height": 540,
+    "durationSeconds": 16
+  }
+}

package/lib/client.js

@@ -135,6 +135,29 @@ window.__ModuleLoader__.load({
 	gap: 6px;
 	min-width: 0;
 }
+.mcpConnectorManualUpdate {
+	display: flex;
+	align-items: center;
+	gap: 6px;
+	min-width: 0;
+	flex: 1 1 360px;
+}
+.mcpConnectorManualCommand {
+	box-sizing: border-box;
+	min-width: 0;
+	max-width: 430px;
+	overflow-x: auto;
+	padding: 5px 8px;
+	color: #374151;
+	background: #f9fafb;
+	border: 1px solid #d1d5db;
+	border-radius: 8px;
+	font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+	font-size: 11px;
+	line-height: 1.35;
+	white-space: nowrap;
+	user-select: text;
+}
 .mcpConnectorUpdateStatus {
 	max-width: 240px;
 	overflow: hidden;
@@ -175,6 +198,7 @@ window.__ModuleLoader__.load({
 	.mcpConnectorUpdateButton:focus-visible { background: #3730a3; }
 	.mcpConnectorUpdateStatus { color: #bbf7d0; background: #14532d; }
 	.mcpConnectorUpdateStatus[data-tone="error"] { color: #fecaca; background: #7f1d1d; }
+	.mcpConnectorManualCommand { color: #e5e7eb; background: #111827; border-color: #4b5563; }
 	.mcpConnectorUpdateSecondary { color: #d1d5db; background: transparent; border-color: #4b5563; }
 	.mcpConnectorMarketClose { color: #c4c8d0; }
 	.mcpConnectorMarketClose:hover,
@@ -361,7 +385,8 @@ window.__ModuleLoader__.load({
 			const labels = {
 				AGENTS_RUNNING: "有任务正在运行，请结束后重试",
 				OPERATION_BUSY: "插件市场正在处理其他任务",
-				RELEASE_TOO_FRESH: "新版本仍在镜像同步",
+				RELEASE_TOO_FRESH: "新版本处于发布安全等待期（约 24 小时）",
+				MIRROR_SYNC_PENDING: "镜像尚未同步完整安装包",
 				VERSION_UNCHANGED: "下载后版本未变化",
 				DOWNGRADE_DETECTED: "已阻止版本降级",
 				RESOLVED_VERSION_MISMATCH: "下载版本与预期不一致",
@@ -373,6 +398,21 @@ window.__ModuleLoader__.load({
 			return labels[failure?.code] ?? failure?.message ?? "更新失败";
 		}
 
+		function manualUpgradeCommand(version) {
+			const parsed = parseClientVersion(version);
+			if (parsed === null) return null;
+			return `dsh plugin --profile web add --config.minimumReleaseAge=0 ${PLUGIN_PACKAGE_NAME}@${parsed.normalized}`;
+		}
+
+		async function copyManualUpgradeCommand(command) {
+			if (typeof window.navigator?.clipboard?.writeText === "function") {
+				await window.navigator.clipboard.writeText(command);
+				return true;
+			}
+			window.prompt?.("请复制以下升级命令", command);
+			return false;
+		}
+
 		function parseClientVersion(value) {
 			if (typeof value !== "string") return null;
 			const normalized = value.trim().replace(/^v/i, "");
@@ -530,6 +570,7 @@ window.__ModuleLoader__.load({
 			const [updateStarting, setUpdateStarting] = (0, react.useState)(false);
 			const [rollbackRunning, setRollbackRunning] = (0, react.useState)(false);
 			const [restarting, setRestarting] = (0, react.useState)(false);
+			const [manualCommandCopied, setManualCommandCopied] = (0, react.useState)(false);
 			const frameRef = (0, react.useRef)(null);
 			const closeRef = (0, react.useRef)(null);
 			(0, react.useEffect)(() => {
@@ -600,6 +641,9 @@ window.__ModuleLoader__.load({
 					window.clearTimeout(pollTimer);
 				};
 			}, [open]);
+			(0, react.useEffect)(() => {
+				if (open) setManualCommandCopied(false);
+			}, [open, versionStatus?.latestVersion]);
 			(0, react.useEffect)(() => {
 				if (!open) return void 0;
 				let disposed = false;
@@ -788,7 +832,7 @@ window.__ModuleLoader__.load({
 								type: "button",
 								className: "mcpConnectorUpdateButton",
 								onClick: () => startUpdate(force),
-								children: force ? "强制重试" : "重试更新"
+								children: updateOperation.failure?.code === "RELEASE_TOO_FRESH" ? "立即更新（跳过等待）" : force ? "强制重试" : "重试更新"
 							}),
 							rollbackRunning && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "mcpConnectorUpdateStatus",
@@ -887,12 +931,43 @@ window.__ModuleLoader__.load({
 						children: `一键更新到 v${providerUpdateCheck.latestVersion}`
 					});
 				}
+				const command = manualUpgradeCommand(versionStatus?.latestVersion);
+				if (command !== null) {
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "mcpConnectorManualUpdate",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+								className: "mcpConnectorManualCommand",
+								title: command,
+								children: command
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mcpConnectorUpdateButton",
+								onClick: () => {
+									copyManualUpgradeCommand(command).then((copied) => {
+										if (copied) setManualCommandCopied(true);
+									}, (error) => {
+										console.warn("[mcp-connector] copy upgrade command failed:", error);
+										window.prompt?.("请复制以下升级命令", command);
+									});
+								},
+								children: manualCommandCopied ? "已复制" : "复制升级命令"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mcpConnectorUpdateButton mcpConnectorUpdateSecondary",
+								onClick: () => window.open(NPM_PACKAGE_URL, "_blank", "noopener,noreferrer"),
+								children: "查看 npm"
+							})
+						]
+					});
+				}
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
 					className: "mcpConnectorUpdateButton",
-					title: `npm 已发布 v${versionStatus?.latestVersion}`,
 					onClick: () => openDshPluginMarket(actions),
-					children: `查看 v${versionStatus?.latestVersion} 更新方式`
+					children: "查看更新方式"
 				});
 			};
 			const src = window.location.origin + "/mcp-connector/ui/";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "description": "Connect and manage MCP servers in DeepSeek Harness — a universal MCP connector and marketplace with OAuth 2.0 PKCE, API keys, stdio/HTTP, mcpServers JSON import, tools, and prompts. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",
@@ -20,11 +20,14 @@
     "docs/DESKTOP-E2E.md",
     "docs/MARKET-REGISTRATION.md",
     "docs/PLUGIN-UPDATE.md",
+    "docs/FIRST-CONTRIBUTION.md",
     "docs/STDIO-SUPPORT.md",
     "docs/USER-GUIDE.md",
+    "docs/screenshots",
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
+    "screenshots.json",
     "CONTRIBUTING.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -35,15 +38,20 @@
   ],
   "scripts": {
     "test": "node --test",
-    "lint": "node --check lib/index.js && node --check lib/web.js && node --check lib/client.js && node --check lib/version-status.js && node --check lib/schema.js && node --check lib/catalog.js && node --check lib/prompts.js && node --check lib/probe.js && node --check lib/mcp-validation.js && node --check lib/mcp-http.js && node --check lib/migration.js && node --check lib/stores.js && node --check lib/grant-journal.js && node --check lib/oauth.js && node --check lib/grant-lifecycle.js && node --check lib/callback-server.js && node --check lib/mcp-provision.js && node --check lib/util.js && node --check lib/constants.js && node --check lib/tools.js && node --check lib/connectors/oauth-connector.js && node --check lib/connectors/manual-connector.js && node --check lib/connectors/json-connector.js && node --check scripts/probe-connector.mjs && node --check scripts/build-registry.mjs && node --check scripts/ui-harness.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/check-readme-version.mjs && node --check scripts/sync-registry-stats.mjs",
+    "lint": "node --check lib/index.js && node --check lib/web.js && node --check lib/client.js && node --check lib/version-status.js && node --check lib/schema.js && node --check lib/catalog.js && node --check lib/prompts.js && node --check lib/probe.js && node --check lib/mcp-validation.js && node --check lib/mcp-http.js && node --check lib/migration.js && node --check lib/stores.js && node --check lib/grant-journal.js && node --check lib/oauth.js && node --check lib/grant-lifecycle.js && node --check lib/callback-server.js && node --check lib/mcp-provision.js && node --check lib/util.js && node --check lib/constants.js && node --check lib/tools.js && node --check lib/connectors/oauth-connector.js && node --check lib/connectors/manual-connector.js && node --check lib/connectors/json-connector.js && node --check scripts/probe-connector.mjs && node --check scripts/build-registry.mjs && node --check scripts/ui-harness.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/check-readme-version.mjs && node --check scripts/check-marketing-metadata.mjs && node --check scripts/check-storefront-screenshots.mjs && node --check scripts/sync-registry-stats.mjs",
     "registry:build": "node scripts/build-registry.mjs",
     "registry:validate": "node scripts/probe-connector.mjs catalog/catalog.json --validate-only",
     "dev:ui": "node scripts/ui-harness.mjs",
     "market:check": "node scripts/check-market-registration.mjs",
     "registry:stats:sync": "node scripts/sync-registry-stats.mjs",
     "docs:check": "node scripts/check-readme-version.mjs",
+    "marketing:check": "node scripts/check-marketing-metadata.mjs",
+    "marketing:check:github": "node scripts/check-marketing-metadata.mjs --live-github",
+    "marketing:check:npm": "node scripts/check-marketing-metadata.mjs --live-npm",
+    "marketing:check:live": "node scripts/check-marketing-metadata.mjs --live",
+    "storefront:check": "node scripts/check-storefront-screenshots.mjs",
     "verify-pack": "node scripts/verify-pack.mjs",
-    "check": "npm run lint && npm run docs:check && npm test && npm run verify-pack",
+    "check": "npm run lint && npm run docs:check && npm run marketing:check && npm run storefront:check && npm test && npm run verify-pack",
     "prepublishOnly": "npm run check"
   },
   "keywords": [
@@ -66,6 +74,7 @@
     "mcp-store",
     "remote-mcp",
     "streamable-http",
+    "stdio",
     "connector",
     "connection",
     "connection-manager",

package/screenshots.json

@@ -0,0 +1,6 @@
+[
+  "docs/screenshots/01-market-overview.jpg",
+  "docs/screenshots/02-connector-detail.jpg",
+  "docs/screenshots/03-tool-discovery.jpg",
+  "docs/screenshots/04-json-import.jpg"
+]

package/scripts/ui-harness.mjs

@@ -5,12 +5,25 @@ import { readFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { normalizeConnectorDescriptor } from '../lib/schema.js';
+import { auditDescriptor, auditRawDescriptor, mergeCatalog } from '../lib/catalog.js';
 
 const root = join(dirname(fileURLToPath(import.meta.url)), '..');
-const catalog = JSON.parse(await readFile(join(root, 'catalog/catalog.json'), 'utf8')).connectors
-  .filter((item) => item.published !== false)
-  .map(normalizeConnectorDescriptor);
-const connected = new Set(['qcc-company']);
+const packageJson = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
+
+async function loadCatalogFile(path) {
+  const document = JSON.parse(await readFile(path, 'utf8'));
+  const items = Array.isArray(document) ? document : document.connectors ?? [];
+  return items.map((item) => auditDescriptor(normalizeConnectorDescriptor(auditRawDescriptor(item))));
+}
+
+const catalogSources = [await loadCatalogFile(join(root, 'catalog/catalog.json'))];
+if (process.env.MCP_CONNECTOR_UI_CATALOG_PATH) {
+  catalogSources.push(await loadCatalogFile(process.env.MCP_CONNECTOR_UI_CATALOG_PATH));
+}
+const catalog = mergeCatalog(catalogSources).filter((item) => item.published !== false);
+
+// A fresh harness never claims a real authorization. Tests may connect to the mock API explicitly.
+const connected = new Set();
 const healthStates = new Map();
 const bundledAssets = new Map([
   ['qcc-logo.svg', 'image/svg+xml'],
@@ -24,8 +37,40 @@ function json(res, value, status = 200) {
   res.end(body);
 }
 
+function captureShell() {
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>MCP连接器 · 无凭据验收环境</title>
+<style>
+  * { box-sizing: border-box; }
+  html, body { width: 100%; height: 100%; margin: 0; }
+  body { display: flex; align-items: center; justify-content: center; background: #e5e7eb; font: 14px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", sans-serif; }
+  .capture-panel { width: min(800px, 90vw); height: min(800px, 85vh); display: flex; flex-direction: column; overflow: hidden; border-radius: 16px; background: #fff; box-shadow: 0 20px 60px rgba(0,0,0,.18); }
+  .capture-header { min-height: 64px; display: flex; align-items: center; gap: 10px; padding: 16px 24px; border-bottom: 1px solid #e5e7eb; color: #111827; }
+  .capture-title { font-size: 18px; font-weight: 650; }
+  .capture-version, .capture-state { padding: 2px 8px; border-radius: 999px; background: #f3f4f6; color: #6b7280; font-size: 12px; font-weight: 600; }
+  .capture-state { margin-left: auto; color: #047857; background: #ecfdf5; }
+  iframe { flex: 1; width: 100%; min-height: 0; border: 0; background: transparent; }
+</style>
+</head>
+<body>
+  <section class="capture-panel" aria-label="MCP连接器产品面板">
+    <header class="capture-header"><span aria-hidden="true">🧩</span><span class="capture-title">MCP连接器</span><span class="capture-version">v${packageJson.version}</span><span class="capture-state">无凭据 Mock</span></header>
+    <iframe src="/mcp-connector/ui/" title="MCP连接器"></iframe>
+  </section>
+</body>
+</html>`;
+}
+
 const server = createServer(async (req, res) => {
-  if (req.method === 'GET' && (req.url === '/' || req.url === '/mcp-connector/ui/')) {
+  if (req.method === 'GET' && req.url === '/') {
+    const body = Buffer.from(captureShell());
+    res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'content-length': body.byteLength }); res.end(body); return;
+  }
+  if (req.method === 'GET' && req.url === '/mcp-connector/ui/') {
     const body = await readFile(join(root, 'ui/index.html'));
     res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' }); res.end(body); return;
   }
@@ -52,12 +97,30 @@ const server = createServer(async (req, res) => {
       connectionLabel: healthStates.get(item.id) === 'healthy' ? '已连接' : connected.has(item.id) ? '已配置' : '未连接',
     })) } }); return;
   }
-  if (method === 'status') { json(res, { ok: true, detail: { items: [] } }); return; }
+  if (method === 'status') {
+    const items = catalog.filter((item) => connected.has(item.id)).flatMap((item) => item.servers.map((server) => ({
+      key: `${item.id}:${server.serverKey}`,
+      connectorId: item.id,
+      name: item.name,
+      serverName: server.serverName,
+      endpoint: server.url || server.command || '本地 Mock',
+      authMode: item.auth.mode === 'oauth2-pkce' ? 'oauth' : item.auth.mode,
+      enabled: true,
+      connectionState: healthStates.get(item.id) ?? 'configured',
+    })));
+    json(res, { ok: true, detail: { items } }); return;
+  }
   if (method === 'migrationPreview') { json(res, { ok: true, detail: { pendingCount: 0, items: [] } }); return; }
   if (method === 'toolsList') {
-    const tools = Array.from({ length: 125 }, (_, index) => ({ name: `tool_${String(index + 1).padStart(3, '0')}`, title: `工具 ${index + 1}`, description: `用于验证分批渲染与搜索的第 ${index + 1} 个工具。` }));
+    const connector = catalog.find((item) => item.id === params.connectorId);
+    const server = connector?.servers?.[0] ?? { serverKey: 'mock', serverName: 'mock-server' };
+    const tools = Array.from({ length: 125 }, (_, index) => ({
+      name: `mock_tool_${String(index + 1).padStart(3, '0')}`,
+      title: `Mock 工具 ${index + 1}`,
+      description: `本地无凭据 UI 验收数据：用于验证分批渲染与搜索的第 ${index + 1} 个工具。`,
+    }));
     healthStates.set(params.connectorId, 'healthy');
-    json(res, { ok: true, detail: { totalTools: tools.length, connectionState: 'healthy', servers: [{ serverKey: 'company', serverName: 'qcc-company', ok: true, tools }] } }); return;
+    json(res, { ok: true, detail: { totalTools: tools.length, connectionState: 'healthy', servers: [{ serverKey: server.serverKey, serverName: server.serverName, ok: true, tools }] } }); return;
   }
   if (method === 'healthCheck') {
     const ids = params.connectorId ? [params.connectorId] : [...connected];

package/ui/index.html

@@ -133,7 +133,7 @@
   .market-section-toggle { border: 0; background: transparent; color: var(--text-2); cursor: pointer; font: inherit; font-size: 12px; padding: 4px 0; }
   .market-section-toggle:hover { color: var(--accent); }
 
-  /* Grid - TraeWork 风格：3 列 */
+  /* Grid - 产品 800px 面板为两列；更宽容器可自适应增加列数 */
   .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 12px; }
 
   /* Card - TraeWork 风格：标题上移，描述 2 行 */
@@ -203,6 +203,13 @@
   .migration-banner { display: flex; align-items: center; gap: 12px; margin-bottom: 16px; padding: 12px 14px; border: 1px solid #fbbf24; background: var(--warn-bg); border-radius: 10px; color: var(--text-2); }
   .migration-banner .copy { flex: 1; min-width: 0; font-size: 12px; }
   .migration-banner strong { display: block; color: var(--text); font-size: 13px; }
+  .community-cta { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-top: 16px; padding: 10px 12px; border: 1px solid var(--line); background: var(--card); border-radius: 10px; color: var(--muted); font-size: 12px; }
+  .community-cta .copy { flex: 1; min-width: 0; }
+  .community-cta a { color: var(--accent); text-decoration: none; white-space: nowrap; }
+  .community-cta a:hover { text-decoration: underline; }
+  .community-cta-close { border: 0; background: transparent; color: var(--muted); cursor: pointer; font: inherit; font-size: 16px; line-height: 1; padding: 2px 4px; }
+  .community-cta-close:hover { color: var(--text); }
+  .community-cta-close:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 4px; }
 
   /* Detail Overlay */
   .detail-overlay {
@@ -514,6 +521,8 @@
   let promptRequestId = null;
   let promptRequestTimer = null;
   let initialHealthCheckStarted = false;
+  let communityCtaEligible = false;
+  let communityCtaDismissed = false;
 
   async function call(method, params, { timeoutMs: timeoutOverride } = {}) {
     const controller = new AbortController();
@@ -781,6 +790,21 @@
     node.setAttribute('aria-label', Number.isFinite(count) ? `${count} 个` : '');
   }
 
+  function communityCtaHtml() {
+    if (!communityCtaEligible || communityCtaDismissed) return '';
+    return `<aside class="community-cta" aria-label="MCP连接器社区入口"><span class="copy">连接顺利？如果 MCP连接器对你有帮助，欢迎支持或一起改进。</span><a href="https://github.com/duhu2000/dsh-mcp-connector/stargazers" target="_blank" rel="noopener noreferrer">Star</a><a href="https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md" target="_blank" rel="noopener noreferrer">提交连接器</a><a href="https://github.com/duhu2000/dsh-mcp-connector/blob/main/CONTRIBUTING.md" target="_blank" rel="noopener noreferrer">参与贡献</a><button class="community-cta-close" type="button" onclick="window.__mcp.dismissCommunityCta()" aria-label="关闭社区入口" title="本次不再显示">×</button></aside>`;
+  }
+
+  function markCommunityCtaEligible() {
+    if (!communityCtaDismissed) communityCtaEligible = true;
+  }
+
+  function dismissCommunityCta() {
+    communityCtaDismissed = true;
+    communityCtaEligible = false;
+    document.querySelector('.community-cta')?.remove();
+  }
+
   function marketSectionHtml(value, label, items) {
     if (!items.length) return '';
     const expanded = expandedMarketSections.has(value);
@@ -880,8 +904,9 @@
     const pendingMigration = migration.ok ? migration.detail?.pendingCount || 0 : 0;
     const migrationHtml = pendingMigration > 0 ? `<div class="migration-banner"><div class="copy"><strong>发现旧企查查 MCP 授权</strong>可安全复制 ${pendingMigration} 组授权到 MCP连接器；不会删除旧插件或原凭据。</div><button class="btn" type="button" onclick="window.__mcp.migrateLegacy()">迁移</button></div>` : '';
     if (!items.length) { main.innerHTML = `${migrationHtml}<div class="stats"><span class="count">可从旧企查查 OAuth 插件复制已有授权</span><button class="btn ghost" type="button" onclick="window.__mcp.scanLegacy()">检测旧插件</button></div><div class="empty">还没有连接任何 MCP · 到「市场」里连接一个吧</div>`; return; }
+    markCommunityCtaEligible();
     const filtered = items.filter(matchesSearch);
-    main.innerHTML = `${migrationHtml}<div class="stats"><span class="count">共 <strong>${filtered.length}</strong> 条连接${searchQuery ? ` · 搜索「${esc(searchQuery)}」` : ''} · 停用后工具立即下线，断开会撤销 OAuth 授权</span><button class="btn ghost" type="button" onclick="window.__mcp.scanLegacy()">检测旧插件</button></div><div class="rows">${filtered.map(rowHtml).join('')}</div>`;
+    main.innerHTML = `${migrationHtml}<div class="stats"><span class="count">共 <strong>${filtered.length}</strong> 条连接${searchQuery ? ` · 搜索「${esc(searchQuery)}」` : ''} · 停用后工具立即下线，断开会撤销 OAuth 授权</span><button class="btn ghost" type="button" onclick="window.__mcp.scanLegacy()">检测旧插件</button></div><div class="rows">${filtered.map(rowHtml).join('')}</div>${communityCtaHtml()}`;
   }
 
   function rowHtml(r) {
@@ -1066,10 +1091,12 @@
       const r = await call('connect', { connectorId }, { timeoutMs });
       showToast(r.message, r.ok);
       if (r.ok) {
+        markCommunityCtaEligible();
         await call('healthCheck', { connectorId });
         await refresh();
       }
     },
+    dismissCommunityCta() { dismissCommunityCta(); },
     toggle(key, enabled) {
       call('setEnabled', { key, enabled }).then((r) => showToast(r.message, r.ok));
     },
@@ -1126,6 +1153,7 @@
         const configuredFromDetail = detailConnector?.id === connectorId && $('#detail-overlay').classList.contains('active');
         closeModal();
         if (configuredFromDetail) closeDetail();
+        markCommunityCtaEligible();
         showToast(r.message, true); await refresh();
         return;
       }
@@ -1159,6 +1187,7 @@
       });
       setModalBusy(false);
       if (!r.ok) { showModalError(r.message); return; }
+      markCommunityCtaEligible();
       closeModal(); showToast(r.message, true); await refresh();
     },
     async submitImport() {
@@ -1175,6 +1204,7 @@
       const r = await call('importJson', { json });
       setModalBusy(false);
       if (!r.ok) { showModalError(r.message); return; }
+      markCommunityCtaEligible();
       closeModal(); showToast(r.message, true); view = 'installed'; syncTabs(); await refresh();
     },
     async submitUrl() {
@@ -1184,6 +1214,7 @@
       const r = await call('installFromUrl', { url });
       setModalBusy(false);
       if (!r.ok) { showModalError(r.message); return; }
+      markCommunityCtaEligible();
       closeModal(); showToast(r.message, true); await refresh();
     },
     async migrateLegacy() {
@@ -1348,6 +1379,7 @@
         const r = await call('connect', { connectorId: id }, { timeoutMs: 310_000 });
         showToast(r.message, r.ok);
         if (r.ok) {
+          markCommunityCtaEligible();
           await call('healthCheck', { connectorId: id });
           closeDetail();
           await refresh();
@@ -1367,7 +1399,7 @@
       }
       const r = await call('connect', { connectorId: id });
       showToast(r.message, r.ok);
-      if (r.ok) { closeDetail(); await refresh(); }
+      if (r.ok) { markCommunityCtaEligible(); closeDetail(); await refresh(); }
       return;
     }
     const prompt = detailPrompts[promptPage * PROMPT_PAGE_SIZE];