@czj-git/dsh-plugin-hub 0.1.0 → 0.2.0

package/README.en.md

@@ -1,14 +1,23 @@
 # DSH Plugin Hub plugin
 
-English | [中文](README.md)
+English | [中文](https://github.com/czj-git/dsh-plugin-hub/blob/main/README.md)
 
-Connects the public, read-only [DSH Plugin Hub](https://dshpluginhub.dev) search API to DeepSeek Harness. Agents can discover published and verified plugins, inspect rankings, and receive install commands, compatibility data, community metrics, and source links.
+Find plugins without leaving DeepSeek Harness: browse the marketplace and rankings in **Settings → Plugin Hub**, or ask your Agent to search directly in a conversation.
+
+The plugin connects to the public, read-only [DSH Plugin Hub](https://dshpluginhub.dev) search API for published and verified community plugins, install commands, compatibility data, community metrics, and source links. The Settings page and conversation tools coexist; opening the marketplace website is not required to search.
+
+[Install](#install-and-run) · [Browse in Settings](#plugin-hub-in-settings) · [Search in a conversation](#search-in-a-conversation) · [Tool inputs](#tool-inputs) · [Response fields](#tool-output) · [Configuration](#configuration)
 
 ## Capabilities
 
-- `dsh_plugin_search`: search by task, feature, plugin name, repository, or author.
-- `dsh_plugin_rankings`: list daily growth, Top Stars, newly listed, or recently active plugins.
-- Filter localized results by category, runtime type, installation source, ordering, and page.
+| Entry point | How to use it | What you get |
+|---|---|---|
+| Settings · Plugin marketplace | Browse by keyword, category, and page | Cards with owner, description, verification, Stars, views, source, language, and a copyable install command. |
+| Settings · Rankings | Choose Daily growth, Top Stars, Newly listed, or Recently active | Ranked plugins with the selected metric and category filtering. |
+| Conversation · `dsh_plugin_search` | Describe a feature or name a plugin, repository, or author | Search results, install commands, and source links. |
+| Conversation · `dsh_plugin_rankings` | Ask your Agent for a specific ranking | Ranked results, install commands, and source links. |
+
+- Read Chinese or English descriptions; the conversation search tool also supports category, runtime type, installation source, ordering, and page filters.
 - Return concise actionable text in Native mode and the complete structured result in Code Mode.
 - Validate every public API response field and expose pagination, data freshness, and anonymous quota metadata.
 - Honor Harness cancellation, configurable timeouts, 429 retry information, and stable error categories.
@@ -17,6 +26,8 @@ The plugin only calls the public `GET /api/v1/plugins/search` endpoint. It requi
 
 ## Install and run
 
+Requires an installed DeepSeek Harness and Node.js `^22.19.0 || >=24.0.0`. The Settings page requires Web-profile client extension support; it does not appear in an environment without the Web client. Plugin searches need no additional API key; conversation use still requires a working model configured in Harness.
+
 Install the npm package into the Web profile:
 
 ```sh
@@ -30,6 +41,80 @@ dsh --profile web --dump-config
 dsh --profile web
 ```
 
+Open **Settings → Plugin Hub**, or try a [conversation prompt](#search-in-a-conversation) below. If Harness is already running, restart it after installing or updating the plugin, then refresh the page.
+
+## Plugin Hub in Settings
+
+After the Web profile starts, open Harness Settings and select **Plugin Hub** in the left sidebar. The page uses the native Settings layout and Harness theme variables, follows the active Chinese or English locale, and never embeds an external page. Switching languages refetches the marketplace and rankings in the active locale and updates descriptions, detail links, and date formatting without a page reload; unfinished requests for the previous locale are cancelled.
+
+### Plugin marketplace
+
+![Harness Settings marketplace with search, all categories, and plugin cards](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/settings-marketplace-en.png)
+
+*Dark mode · Settings → Plugin Hub, with search, category filters, and plugin cards. Click the screenshot to view the original.*
+
+- Published and verified plugins default to GitHub Stars ordering; entering a keyword switches to relevance ordering.
+- Nine marketplace categories and pagination are available. Category filters wrap so every option stays visible. The compact two-column desktop grid becomes one column in a narrow window.
+- Each card shows the plugin name, owner, description, verification, category, Stars, views, package source, and primary language.
+- **Copy command** writes the public `dsh plugin --profile ... add ...` command to the clipboard. The page does not bypass Harness permissions or mutate a profile directly.
+- The plugin name and detail arrow open its public DSH Plugin Hub detail page in the browser.
+
+### Rankings
+
+![Harness Settings in dark mode showing Newly listed, category filtering, and listing dates](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/settings-rankings-en.png)
+
+*Newly listed orders plugins by their first listing time. Daily growth, Top stars, and Recently active are also available.*
+
+- **Daily growth** uses GitHub Star change between the latest two successful metric snapshots and shows “Pending” without a baseline.
+- **Top Stars** orders by total GitHub Stars.
+- **Newly listed** orders by first listing time in DSH Plugin Hub.
+- **Recently active** orders by the latest GitHub push time.
+- A compact single-column list retains rank, avatar, owner, description, category, verification, and the selected ranking metric, with category filtering and pagination.
+
+The catalog keeps changing. Counts, positions, and metrics in screenshots reflect capture time, not a fixed catalog size.
+
+## Search in a conversation
+
+The Settings page is not the only entry point. When the plugin is enabled, the Agent can still call `dsh_plugin_search` and `dsh_plugin_rankings` without opening Settings or asking you to write JSON. Send any one of these prompts in a Harness conversation:
+
+Find a feature:
+
+```text
+Use DSH Plugin Hub to search for memory plugins. Return up to 5 results, explain their purpose in English, and include install commands and detail links. Do not install anything.
+```
+
+Browse a ranking:
+
+```text
+Use DSH Plugin Hub to show the top 10 plugins by GitHub Stars. Describe them in English and include detail links.
+```
+
+Discover new plugins:
+
+```text
+Use DSH Plugin Hub to show the 5 most recently listed plugins. Explain their purpose and provide install commands.
+```
+
+![Harness conversation in dark mode showing a dsh_plugin_rankings call and Top Stars results](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/chat-rankings-en.png)
+
+*Conversation example: the Agent calls `dsh_plugin_rankings` and presents Top Stars with descriptions, install commands, and source links.*
+
+The model decides whether to call a tool and how to compose its answer. If it does not call one, explicitly ask: “Call `dsh_plugin_search` with `memory` as the query and `en` as the locale.” Search uses keyword matching; if no results appear, try a shorter Chinese or English keyword or remove a filter.
+
+Returned install commands are text, not profile changes. Installing a plugin requires a separate request and remains subject to Harness permissions and approvals. Native mode's compact result omits some compatibility and timestamp fields; use Code Mode to read the [complete structured result](#tool-output) when you need those details.
+
+## How it works
+
+```mermaid
+flowchart TD
+    settings["Settings: marketplace / rankings"] --> proxy["Host same-origin search route"]
+    chat["Conversation: search / ranking tools"] --> client["Shared PluginHubClient"]
+    proxy --> client
+    client --> api["DSH Plugin Hub public read-only search API"]
+```
+
+The browser does not call the cross-origin public API directly. The plugin Host registers a read-only same-origin `/api/dsh-plugin-hub/search` route, validates query parameters again, and applies the same complete response validation used by the Agent tools. The route accepts only `GET` and `OPTIONS`; it exposes no user data and provides no installation or other write operation. Both entry points share the API client and response validation.
+
 ## Configuration
 
 The bundle supplies these defaults:
@@ -74,7 +159,7 @@ Example input:
 
 ```json
 {
-  "query": "help a text-only agent understand screenshots",
+  "query": "vision",
   "locale": "en",
   "category": "multimodal-creative",
   "type": "hybrid",
@@ -201,6 +286,8 @@ Both tools return the same structured value. Code Mode can consume every field.
 
 ### Complete structured output example
 
+This is a field-reference example. Plugin names, metrics, and dates are illustrative, not current catalog data; do not treat the example package name as a real installation target.
+
 ```json
 {
   "items": [

package/README.md

@@ -1,14 +1,23 @@
 # DSH Plugin Hub 插件
 
-[English](README.en.md) | 中文
+[English](https://github.com/czj-git/dsh-plugin-hub/blob/main/README.en.md) | 中文
 
-把 [DSH Plugin Hub](https://dshpluginhub.dev) 的公开、只读搜索 API 接入 DeepSeek Harness。Agent 可以在对话中搜索已发布且通过验证的插件，查看排行榜，并取得安装命令、兼容性、社区指标和来源链接。
+在 DeepSeek Harness 里找插件：既可以打开「设置 → 插件中心」浏览市场和排行榜，也可以直接在对话中让 Agent 搜索。
+
+本插件连接 [DSH Plugin Hub](https://dshpluginhub.dev) 的公开、只读搜索 API，提供已发布且通过验证的社区插件信息、安装命令、兼容性、社区指标和来源链接。设置页面和对话工具同时保留，不需要打开市场网页才能搜索。
+
+[安装](#安装与启动) · [设置内浏览](#settings-插件中心) · [对话搜索](#在对话中搜索插件) · [工具输入](#工具输入) · [返回字段](#工具输出) · [配置](#配置)
 
 ## 能做什么
 
-- `dsh_plugin_search`：按任务、功能、插件名、仓库或作者搜索插件。
-- `dsh_plugin_rankings`：查询日增长、Star 总榜、最新上架和最近活跃榜单。
-- 支持中文和英文描述，以及分类、运行形态、安装来源、排序和分页筛选。
+| 入口 | 用法 | 可以看到什么 |
+|---|---|---|
+| 设置 · 插件市场 | 按关键词、分类和分页浏览 | 插件卡片、作者、简介、验证状态、Stars、浏览量、来源、主要语言与可复制的安装命令。 |
+| 设置 · 排行榜 | 切换日增长、Star 总榜、最新上架或最近活跃 | 带排名和对应指标的插件列表，支持分类筛选。 |
+| 对话 · `dsh_plugin_search` | 告诉 Agent 想找的功能、插件名、仓库或作者 | 搜索结果、安装命令和来源链接。 |
+| 对话 · `dsh_plugin_rankings` | 让 Agent 查询指定榜单 | 排行结果、安装命令和来源链接。 |
+
+- 支持中文和英文描述；对话搜索工具还可按分类、运行形态、安装来源、排序和分页筛选。
 - Native 模式向模型返回紧凑、便于后续操作的文本；Code Mode 返回完整结构化结果。
 - 校验公网 API 的每个返回字段，并暴露分页、数据更新时间和匿名限流信息。
 - 支持 Harness 取消信号、可配置超时、429 重试信息和稳定的错误分类。
@@ -17,6 +26,8 @@
 
 ## 安装与启动
 
+需要已安装的 DeepSeek Harness，以及 Node.js `^22.19.0 || >=24.0.0`。设置页需要 Web profile 的客户端扩展支持；在不提供 Web 客户端的环境中，设置页不会出现。插件检索无需额外 API Key；在对话中使用仍需要 Harness 已配置可用的模型。
+
 从 npm 安装到 Web profile：
 
 ```sh
@@ -30,6 +41,80 @@ dsh --profile web --dump-config
 dsh --profile web
 ```
 
+启动后可以打开「设置 → 插件中心」，也可以直接使用下面的[对话示例](#在对话中搜索插件)。如果已经运行 Harness，安装或更新插件后重新启动，再刷新页面。
+
+## Settings 插件中心
+
+启动 Web profile 后，打开 Harness 的「设置」，左侧会出现「插件中心」。这个页面采用 Harness 原生 Settings 布局和主题变量，随 Harness 的中英文语言切换，不会嵌入外部网页。切换语言后，市场和排行榜会按当前语言重新查询，简介、详情链接及日期格式同步更新，无需刷新页面；旧语言的未完成请求会被取消。
+
+### 插件市场
+
+![Harness 设置中的插件市场：搜索、完整分类和插件卡片](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/settings-marketplace-zh.png)
+
+*深色模式 · 设置 → 插件中心：搜索、分类筛选与插件卡片。点击截图可查看原图。*
+
+- 默认按 GitHub Stars 展示已发布且通过验证的插件；输入关键词后切换为相关性排序。
+- 支持九个市场分类和分页；分类标签自动换行、完整展示，桌面端使用两列紧凑卡片，窄窗口自动改为单列。
+- 每张卡片展示插件名、作者、简介、验证状态、分类、Stars、浏览量、安装来源和主要语言。
+- 「复制安装命令」只把该插件公开的 `dsh plugin --profile ... add ...` 命令写入剪贴板；页面不会绕过 Harness 权限或直接修改 profile。
+- 插件名和详情箭头会在浏览器中打开 DSH Plugin Hub 的公开详情页。
+
+### 排行榜
+
+![Harness 设置中的深色排行榜：最新上架、分类筛选和收录日期](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/settings-rankings-zh.png)
+
+*最新上架榜按市场首次收录时间排序；也可以切换日增长、Star 总榜和最近活跃。*
+
+- `日增长`：最近两个成功指标快照之间的 GitHub Star 变化；缺少基线时显示“待生成”。
+- `Star 总榜`：按 GitHub Stars 总数排序。
+- `最新上架`：按 DSH Plugin Hub 首次收录时间排序。
+- `最近活跃`：按 GitHub 最近推送时间排序。
+- 排行榜采用单列信息行，保留排名、头像、作者、简介、分类、验证状态和当前榜单指标，并支持分类筛选和分页。
+
+插件目录持续更新，截图中的数量、排名和指标仅代表拍摄时的状态，不是固定的收录数量。
+
+## 在对话中搜索插件
+
+设置页面不是唯一入口。插件启用后，Agent 仍可调用 `dsh_plugin_search` 和 `dsh_plugin_rankings`；不必先打开设置，也不需要手写 JSON。下面任选一句发送到 Harness 对话中：
+
+搜索具体功能：
+
+```text
+用 DSH Plugin Hub 搜索 memory 相关插件，选出最多 5 个，用中文说明用途，并给出安装命令和详情链接。不要执行安装。
+```
+
+查询排行榜：
+
+```text
+用 DSH Plugin Hub 查看 Star 最多的前 10 个插件，用中文介绍，并附上详情链接。
+```
+
+发现新插件：
+
+```text
+用 DSH Plugin Hub 查看最近新上架的 5 个插件，说明用途，并给出安装命令。
+```
+
+![Harness 深色对话中的 Memory 插件搜索结果，包含用途、安装命令和详情链接](https://raw.githubusercontent.com/czj-git/dsh-plugin-hub/main/docs/screenshots/chat-search-zh.png)
+
+*对话搜索示例：让 Agent 查找 memory 相关插件，并整理用途、安装命令和详情链接。*
+
+模型负责决定是否调用工具和如何组织回答。若没有触发，可以明确说「请调用 `dsh_plugin_search`，用 `memory` 作为关键词，`locale` 设为 `zh`」。搜索基于关键词匹配；没有结果时，可以换一个更短的中英文关键词或减少筛选条件。
+
+工具返回的安装命令只是文本，不会直接修改 profile。执行安装仍需另行请求，并遵循 Harness 的权限与审批策略。Native 模式的紧凑结果不展示所有兼容性和时间字段；需要这些细节时，可使用 Code Mode 读取[完整结构化结果](#工具输出)。
+
+## 工作方式
+
+```mermaid
+flowchart TD
+    settings["设置：插件市场 / 排行榜"] --> proxy["Host 同源搜索路由"]
+    chat["对话：搜索 / 排行工具"] --> client["共享 PluginHubClient"]
+    proxy --> client
+    client --> api["DSH Plugin Hub 公网只读搜索 API"]
+```
+
+浏览器不会直接请求跨域公网 API。插件的 Host 端注册只读同源路由 `/api/dsh-plugin-hub/search`，在转发前重新校验查询参数，再使用与 Agent 工具相同的完整响应校验。该路由只支持 `GET` 和 `OPTIONS`，不暴露用户数据，也不提供安装或其他写接口。两个入口共用 API 客户端和返回字段校验。
+
 ## 配置
 
 Bundle 默认配置：
@@ -74,7 +159,7 @@ Bundle 默认配置：
 
 ```json
 {
-  "query": "让纯文本 Agent 看懂截图",
+  "query": "vision",
   "locale": "zh",
   "category": "multimodal-creative",
   "type": "hybrid",
@@ -201,6 +286,8 @@ Bundle 默认配置：
 
 ### 完整结构化输出示例
 
+以下为字段说明示例，插件名、指标和时间均为示例值，不代表当前目录；不要将示例包名作为真实安装目标。
+
 ```json
 {
   "items": [

package/dist/api.d.ts

@@ -1,201 +1,7 @@
-import { z } from 'zod';
-/** Locales supported by the public DSH Plugin Hub API. */
-export declare const pluginHubLocales: readonly ["zh", "en"];
-/** Public plugin categories exposed by DSH Plugin Hub. */
-export declare const pluginHubCategories: readonly ["agent-workflow", "coding-tools", "models-data", "ui-experience", "integrations", "security-governance", "multimodal-creative", "observability-cost", "other"];
-/** Plugin runtime shapes supported by the public API. */
-export declare const pluginHubTypes: readonly ["host", "client", "hybrid"];
-/** Install sources supported by the public API. */
-export declare const pluginHubSources: readonly ["npm", "github"];
-/** Ordering modes supported by the public API. */
-export declare const pluginHubSorts: readonly ["relevance", "growth", "stars", "newest", "active"];
-export type PluginHubLocale = (typeof pluginHubLocales)[number];
-export type PluginHubCategory = (typeof pluginHubCategories)[number];
-export type PluginHubType = (typeof pluginHubTypes)[number];
-export type PluginHubSource = (typeof pluginHubSources)[number];
-export type PluginHubSort = (typeof pluginHubSorts)[number];
-declare const pluginSchema: z.ZodObject<{
-    id: z.ZodString;
-    slug: z.ZodString;
-    name: z.ZodString;
-    owner: z.ZodString;
-    repo: z.ZodString;
-    description: z.ZodString;
-    type: z.ZodEnum<{
-        host: "host";
-        client: "client";
-        hybrid: "hybrid";
-    }>;
-    category: z.ZodEnum<{
-        "agent-workflow": "agent-workflow";
-        "coding-tools": "coding-tools";
-        "models-data": "models-data";
-        "ui-experience": "ui-experience";
-        integrations: "integrations";
-        "security-governance": "security-governance";
-        "multimodal-creative": "multimodal-creative";
-        "observability-cost": "observability-cost";
-        other: "other";
-    }>;
-    topics: z.ZodArray<z.ZodString>;
-    language: z.ZodString;
-    license: z.ZodString;
-    package: z.ZodObject<{
-        name: z.ZodString;
-        version: z.ZodString;
-        source: z.ZodEnum<{
-            npm: "npm";
-            github: "github";
-        }>;
-        sourceSpec: z.ZodString;
-        installCommand: z.ZodString;
-        profile: z.ZodString;
-    }, z.core.$strip>;
-    compatibility: z.ZodObject<{
-        harnessVersion: z.ZodString;
-        verificationLevel: z.ZodEnum<{
-            "static-checked": "static-checked";
-            "runtime-verified": "runtime-verified";
-        }>;
-        smokeStatus: z.ZodEnum<{
-            "static-passed": "static-passed";
-            passed: "passed";
-            "manual-step-required": "manual-step-required";
-            failed: "failed";
-            "not-run": "not-run";
-        }>;
-        validatedAt: z.ZodString;
-    }, z.core.$strip>;
-    metrics: z.ZodObject<{
-        stars: z.ZodNumber;
-        starsDelta1d: z.ZodNullable<z.ZodNumber>;
-        forks: z.ZodNumber;
-        openIssues: z.ZodNumber;
-        views: z.ZodNumber;
-    }, z.core.$strip>;
-    timestamps: z.ZodObject<{
-        listedAt: z.ZodString;
-        lastPushedAt: z.ZodString;
-        sourceUpdatedAt: z.ZodString;
-    }, z.core.$strip>;
-    links: z.ZodObject<{
-        detail: z.ZodURL;
-        repository: z.ZodURL;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-declare const responseSchema: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        slug: z.ZodString;
-        name: z.ZodString;
-        owner: z.ZodString;
-        repo: z.ZodString;
-        description: z.ZodString;
-        type: z.ZodEnum<{
-            host: "host";
-            client: "client";
-            hybrid: "hybrid";
-        }>;
-        category: z.ZodEnum<{
-            "agent-workflow": "agent-workflow";
-            "coding-tools": "coding-tools";
-            "models-data": "models-data";
-            "ui-experience": "ui-experience";
-            integrations: "integrations";
-            "security-governance": "security-governance";
-            "multimodal-creative": "multimodal-creative";
-            "observability-cost": "observability-cost";
-            other: "other";
-        }>;
-        topics: z.ZodArray<z.ZodString>;
-        language: z.ZodString;
-        license: z.ZodString;
-        package: z.ZodObject<{
-            name: z.ZodString;
-            version: z.ZodString;
-            source: z.ZodEnum<{
-                npm: "npm";
-                github: "github";
-            }>;
-            sourceSpec: z.ZodString;
-            installCommand: z.ZodString;
-            profile: z.ZodString;
-        }, z.core.$strip>;
-        compatibility: z.ZodObject<{
-            harnessVersion: z.ZodString;
-            verificationLevel: z.ZodEnum<{
-                "static-checked": "static-checked";
-                "runtime-verified": "runtime-verified";
-            }>;
-            smokeStatus: z.ZodEnum<{
-                "static-passed": "static-passed";
-                passed: "passed";
-                "manual-step-required": "manual-step-required";
-                failed: "failed";
-                "not-run": "not-run";
-            }>;
-            validatedAt: z.ZodString;
-        }, z.core.$strip>;
-        metrics: z.ZodObject<{
-            stars: z.ZodNumber;
-            starsDelta1d: z.ZodNullable<z.ZodNumber>;
-            forks: z.ZodNumber;
-            openIssues: z.ZodNumber;
-            views: z.ZodNumber;
-        }, z.core.$strip>;
-        timestamps: z.ZodObject<{
-            listedAt: z.ZodString;
-            lastPushedAt: z.ZodString;
-            sourceUpdatedAt: z.ZodString;
-        }, z.core.$strip>;
-        links: z.ZodObject<{
-            detail: z.ZodURL;
-            repository: z.ZodURL;
-        }, z.core.$strip>;
-    }, z.core.$strip>>;
-    pagination: z.ZodObject<{
-        page: z.ZodNumber;
-        perPage: z.ZodNumber;
-        total: z.ZodNumber;
-        totalPages: z.ZodNumber;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        apiVersion: z.ZodLiteral<"v1">;
-        locale: z.ZodEnum<{
-            zh: "zh";
-            en: "en";
-        }>;
-        query: z.ZodString;
-        sort: z.ZodEnum<{
-            relevance: "relevance";
-            growth: "growth";
-            stars: "stars";
-            newest: "newest";
-            active: "active";
-        }>;
-        dataUpdatedAt: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export type PluginHubPlugin = z.infer<typeof pluginSchema>;
-export interface PluginHubRateLimit {
-    limit: number | null;
-    remaining: number | null;
-    reset: string | null;
-    retryAfterSeconds: number | null;
-}
-export interface PluginHubSearchResult extends z.infer<typeof responseSchema> {
-    rateLimit: PluginHubRateLimit;
-}
-export interface PluginHubSearchInput {
-    query?: string;
-    locale?: PluginHubLocale;
-    category?: PluginHubCategory;
-    type?: PluginHubType;
-    source?: PluginHubSource;
-    sort?: PluginHubSort;
-    page?: number;
-    perPage?: number;
-}
+import { type PluginHubSearchInput } from './shared.js';
+import { type PluginHubSearchResult } from './schemas.js';
+export * from './shared.js';
+export type { PluginHubPlugin, PluginHubRateLimit, PluginHubSearchResult } from './schemas.js';
 export interface PluginHubClientOptions {
     baseUrl: string;
     timeoutMs: number;
@@ -242,5 +48,4 @@ export declare class PluginHubClient {
      */
     search(input: PluginHubSearchInput, signal: AbortSignal): Promise<PluginHubSearchResult>;
 }
-export {};
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAA;AAErB,cAAc,aAAa,CAAA;AAC3B,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAE9F,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,yEAAyE;AACzE,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QACpC,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACjC,KAAK,CAAC,EAAE,OAAO,CAAA;KAChB;CAQF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7D;AA+BD,yEAAyE;AACzE,qBAAa,eAAe;;IAK1B;;;OAGG;gBACS,OAAO,EAAE,sBAAsB;IAM3C;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAkE/F"}

package/dist/api.js

@@ -1,91 +1,6 @@
-import { z } from 'zod';
-/** Locales supported by the public DSH Plugin Hub API. */
-export const pluginHubLocales = ['zh', 'en'];
-/** Public plugin categories exposed by DSH Plugin Hub. */
-export const pluginHubCategories = [
-    'agent-workflow',
-    'coding-tools',
-    'models-data',
-    'ui-experience',
-    'integrations',
-    'security-governance',
-    'multimodal-creative',
-    'observability-cost',
-    'other',
-];
-/** Plugin runtime shapes supported by the public API. */
-export const pluginHubTypes = ['host', 'client', 'hybrid'];
-/** Install sources supported by the public API. */
-export const pluginHubSources = ['npm', 'github'];
-/** Ordering modes supported by the public API. */
-export const pluginHubSorts = ['relevance', 'growth', 'stars', 'newest', 'active'];
-const nullableInteger = z.number().int().nullable();
-const pluginSchema = z.object({
-    id: z.string(),
-    slug: z.string(),
-    name: z.string(),
-    owner: z.string(),
-    repo: z.string(),
-    description: z.string(),
-    type: z.enum(pluginHubTypes),
-    category: z.enum(pluginHubCategories),
-    topics: z.array(z.string()),
-    language: z.string(),
-    license: z.string(),
-    package: z.object({
-        name: z.string(),
-        version: z.string(),
-        source: z.enum(pluginHubSources),
-        sourceSpec: z.string(),
-        installCommand: z.string(),
-        profile: z.string(),
-    }),
-    compatibility: z.object({
-        harnessVersion: z.string(),
-        verificationLevel: z.enum(['static-checked', 'runtime-verified']),
-        smokeStatus: z.enum(['static-passed', 'passed', 'manual-step-required', 'failed', 'not-run']),
-        validatedAt: z.string(),
-    }),
-    metrics: z.object({
-        stars: z.number().int(),
-        starsDelta1d: nullableInteger,
-        forks: z.number().int(),
-        openIssues: z.number().int(),
-        views: z.number().int(),
-    }),
-    timestamps: z.object({
-        listedAt: z.string(),
-        lastPushedAt: z.string(),
-        sourceUpdatedAt: z.string(),
-    }),
-    links: z.object({
-        detail: z.url(),
-        repository: z.url(),
-    }),
-});
-const responseSchema = z.object({
-    items: z.array(pluginSchema),
-    pagination: z.object({
-        page: z.number().int(),
-        perPage: z.number().int(),
-        total: z.number().int(),
-        totalPages: z.number().int(),
-    }),
-    meta: z.object({
-        apiVersion: z.literal('v1'),
-        locale: z.enum(pluginHubLocales),
-        query: z.string(),
-        sort: z.enum(pluginHubSorts),
-        dataUpdatedAt: z.string(),
-    }),
-});
-const errorSchema = z.object({
-    error: z.object({
-        code: z.string(),
-        message: z.string(),
-        fields: z.record(z.string(), z.string()).optional(),
-    }),
-});
+import { pluginHubCategories, pluginHubLocales, pluginHubSorts, pluginHubSources, pluginHubTypes, } from './shared.js';
+import { pluginHubErrorSchema, pluginHubResponseSchema, } from './schemas.js';
+export * from './shared.js';
 /** An HTTP or response-validation failure returned by DSH Plugin Hub. */
 export class PluginHubApiError extends Error {
     code;
@@ -217,7 +132,7 @@ export class PluginHubClient {
             });
         }
         if (!response.ok) {
-            const parsed = errorSchema.safeParse(payload);
+            const parsed = pluginHubErrorSchema.safeParse(payload);
             const code = parsed.success ? parsed.data.error.code : `HTTP_${response.status}`;
             const detail = parsed.success ? parsed.data.error.message : `HTTP ${response.status}`;
             throw new PluginHubApiError(`DSH Plugin Hub request failed: ${detail}`, {
@@ -229,7 +144,7 @@ export class PluginHubClient {
                 retryAfterSeconds: rateLimit.retryAfterSeconds,
             });
         }
-        const parsed = responseSchema.safeParse(payload);
+        const parsed = pluginHubResponseSchema.safeParse(payload);
         if (!parsed.success) {
             throw new PluginHubApiError('DSH Plugin Hub returned an unsupported response.', {
                 code: 'INVALID_RESPONSE',

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/client/PluginHubSettings.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { LocaleRuntime } from '@deepseek-ai/dsh-client-locale/client';
+import type { PluginHubSearchResult } from '../schemas.js';
+import { type PluginHubSearchInput } from '../shared.js';
+/** Registration-owned data functions and deployment facts. */
+export interface PluginHubSettingsInjected {
+    /** The slot renderer caches this source and binds a reactive useLocale hook. */
+    hooks: {
+        locale: Pick<LocaleRuntime, 'getSnapshot' | 'subscribe'>;
+    };
+    websiteUrl: string;
+    search: (input: PluginHubSearchInput, signal: AbortSignal) => Promise<PluginHubSearchResult>;
+}
+/** Full props assembled by the Settings slot renderer. */
+export type PluginHubSettingsProps = PropsRuntime<'settings.section'> & PropsLocale<'dsh.pluginHub'> & InjectFace<PluginHubSettingsInjected>;
+/** Independent Settings page containing marketplace and rankings tabs. */
+export declare function PluginHubSettings({ useLocale, websiteUrl, search, t }: PluginHubSettingsProps): ReactNode;
+//# sourceMappingURL=PluginHubSettings.d.ts.map

package/dist/client/PluginHubSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHubSettings.d.ts","sourceRoot":"","sources":["../../src/client/PluginHubSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,cAAc,CAAA;AAOrB,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACxC,gFAAgF;IAChF,KAAK,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,WAAW,CAAC,CAAA;KAAE,CAAA;IACnE,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;CAC7F;AAED,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAChC,YAAY,CAAC,kBAAkB,CAAC,GAC9B,WAAW,CAAC,eAAe,CAAC,GAC5B,UAAU,CAAC,yBAAyB,CAAC,CAAA;AA6OzC,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAsJzG"}