dsh-plugin-marketplace 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scorp1o117
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# dsh-plugin-marketplace
+
+A **plugin marketplace** inside the DeepSeek Harness Web UI: browse
+[github.com/topics/dsh-plugin](https://github.com/topics/dsh-plugin) right
+from the settings page — no terminal needed.
+
+- **Search** the topic by keyword, **sort** by stars or last update
+- **Plugin cards** with description, stars, language, and update date
+- **Detail panel**: GitHub README summary, install command, repo/npm links
+- Powered by the public GitHub search API (CORS-enabled, no key needed;
+  unauthenticated rate limit 60 req/h)
+- Zero client dependencies (React only), no build step — hand-written
+  ModuleLoader bundle
+
+## Install
+
+In `$DSH_HOME/profiles/web/cordis.patch.yml`:
+
+```yaml
+- insert:
+    - id: plugin-marketplace
+      name: 'dsh-plugin-marketplace'
+```
+
+Then restart `dsh web` (new client plugins require a process restart to be
+scanned into the browser roster) and open **Settings → Plugin Marketplace**.
+
+## How it works
+
+| Layer | File | Role |
+|---|---|---|
+| host shell | `index.js` | empty apply — makes the package a loader entry |
+| browser half | `client.js` | registers the `settings.section` "marketplace" tab; fetches GitHub search API; renders cards + detail |
+| manifest | `package.json` | `dsh.client: { platform: "web" }` + `exports["./client"]` — discovered by `dsh-client-modules` |
+
+The browser half needs no `dsh.client.inject` packages: it only uses `react`
+(provided by the web runtime) and the `slots` / `locale` client services.
+
+## Notes
+
+- The GitHub search API returns at most 1000 results; the topic currently has
+  280+ repos, so paging covers everything.
+- READMEs are fetched per plugin on demand and truncated to ~1200 chars.
+- If you see "rate-limited", wait an hour or run the web through a proxy that
+  adds a GitHub token.
+
+## License
+
+MIT

package/client.js

@@ -0,0 +1,264 @@
+/**
+ * dsh-plugin-marketplace — browser half.
+ *
+ * A marketplace section inside the Web UI settings page: browses
+ * github.com/topics/dsh-plugin through the public GitHub search API
+ * (CORS-enabled), with keyword search, star/update sorting, paging, and a
+ * per-plugin detail panel (README summary + install instructions).
+ *
+ * Hand-written ModuleLoader bundle — no build step required.
+ */
+window.__ModuleLoader__.load({
+  id: "dsh-plugin-marketplace",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    var react = require("react");
+    var h = react.createElement;
+
+    // ── CSS (theme tokens) ────────────────────────────────────────────────
+    var CSS = ".__mp_grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:10px;padding:0;margin:0;list-style:none}" +
+      ".__mp_card{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:12px 14px;display:flex;flex-direction:column;gap:6px;background:var(--dsw-alias-bg-layer-2);cursor:pointer;text-align:left;font:inherit;color:inherit}" +
+      ".__mp_card:hover{border-color:var(--dsw-alias-brand-primary)}" +
+      ".__mp_cardHead{display:flex;align-items:center;gap:8px;min-width:0}" +
+      ".__mp_name{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}" +
+      ".__mp_star{flex:none;font-size:12px;color:var(--dsw-alias-label-secondary)}" +
+      ".__mp_desc{font-size:12px;line-height:1.5;color:var(--dsw-alias-label-secondary);display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}" +
+      ".__mp_meta{display:flex;gap:10px;font-size:11px;color:var(--dsw-alias-label-tertiary)}" +
+      ".__mp_toolbar{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-bottom:10px}" +
+      ".__mp_input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:32px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:13px;min-width:200px;flex:1}" +
+      ".__mp_select{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:32px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 8px;font-size:13px}" +
+      ".__mp_more{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);border-radius:8px;padding:6px 14px;font:inherit;font-size:13px;cursor:pointer;margin-top:12px}" +
+      ".__mp_more:hover:not(:disabled){border-color:var(--dsw-alias-brand-primary)}" +
+      ".__mp_more:disabled{opacity:.5;cursor:default}" +
+      ".__mp_status{font-size:12px;color:var(--dsw-alias-label-tertiary);margin:8px 0 0}" +
+      ".__mp_detail{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:14px;margin-top:10px;background:var(--dsw-alias-bg-layer-2);display:flex;flex-direction:column;gap:8px;width:100%;box-sizing:border-box}" +
+      ".__mp_detailTitle{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary)}" +
+      ".__mp_readme{font-size:12px;line-height:1.6;color:var(--dsw-alias-label-secondary);white-space:pre-wrap;word-break:break-word;max-height:260px;overflow:auto;width:100%;box-sizing:border-box;min-width:0}" +
+      ".__mp_code{display:block;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:6px;padding:8px 10px;font-family:ui-monospace,Consolas,monospace;font-size:12px;color:var(--dsw-alias-label-primary);white-space:pre-wrap;word-break:break-all;width:100%;box-sizing:border-box;min-width:0}" +
+      ".__mp_link{color:var(--dsw-alias-brand-primary);font-size:12px;text-decoration:none}" +
+      ".__mp_error{color:var(--dsw-alias-label-error);font-size:12px;margin:8px 0 0}";
+    var tagId = "dsh-plugin-marketplace/main.css";
+    if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+      var tag = document.createElement("style");
+      tag.dataset.plugin = "dsh-plugin-marketplace";
+      tag.dataset.pluginCss = tagId;
+      tag.textContent = CSS;
+      document.head.appendChild(tag);
+    }
+
+    // ── locale ────────────────────────────────────────────────────────────
+    var NS = "marketplace";
+    var inject = ["slots", "locale"];
+    var zh = {
+      nav: "插件市场",
+      search: "搜索插件（关键词或留空浏览全部）…",
+      sortStars: "按 Star 排序",
+      sortUpdated: "按更新时间排序",
+      loadMore: "加载更多",
+      loading: "加载中…",
+      error: "加载失败，请稍后重试",
+      empty: "没有找到插件",
+      install: "安装方式",
+      installHint: "在 profile 目录执行 pnpm 安装，然后在 cordis.patch.yml 挂载：",
+      readme: "README 摘要",
+      readmeEmpty: "（该仓库没有 README）",
+      openRepo: "打开 GitHub 仓库 ↗",
+      openNpm: "在 npm 搜索同名包 ↗",
+      updated: "更新",
+      total: "共 {count} 个插件",
+      ghError: "GitHub API 请求失败（未认证限流 60 次/小时），请稍后再试"
+    };
+    var en = {
+      nav: "Plugin Marketplace",
+      search: "Search plugins (keyword, or empty to browse all)…",
+      sortStars: "Sort by stars",
+      sortUpdated: "Sort by updated",
+      loadMore: "Load more",
+      loading: "Loading…",
+      error: "Failed to load, try again later",
+      empty: "No plugins found",
+      install: "Install",
+      installHint: "Run pnpm in your profile dir, then mount in cordis.patch.yml:",
+      readme: "README summary",
+      readmeEmpty: "(no README in this repo)",
+      openRepo: "Open GitHub repo ↗",
+      openNpm: "Search npm ↗",
+      updated: "Updated",
+      total: "{count} plugins",
+      ghError: "GitHub API rate-limited (60/hr unauthenticated), try again later"
+    };
+
+    // ── GitHub API ────────────────────────────────────────────────────────
+    var BASE = "https://api.github.com/search/repositories";
+    var cache = new Map(); // queryKey -> {items, incomplete}
+    function queryKey(q, sort, page) { return q + "|" + sort + "|" + page; }
+    function fmtTime(iso) {
+      try { return new Date(iso).toISOString().slice(0, 10); } catch { return ""; }
+    }
+    async function fetchPage(q, sort, page) {
+      var key = queryKey(q, sort, page);
+      var hit = cache.get(key);
+      if (hit) return hit;
+      var params = new URLSearchParams({
+        q: "topic:dsh-plugin" + (q ? " " + q : ""),
+        sort: sort,
+        order: "desc",
+        per_page: "20",
+        page: String(page)
+      });
+      var res = await fetch(BASE + "?" + params.toString(), { headers: { Accept: "application/vnd.github+json" } });
+      if (!res.ok) throw new Error("HTTP " + res.status);
+      var data = await res.json();
+      var items = (data.items || []).map(function (r) {
+        return {
+          fullName: r.full_name,
+          desc: r.description || "",
+          stars: r.stargazers_count || 0,
+          updated: r.updated_at || "",
+          lang: r.language || "",
+          htmlUrl: r.html_url
+        };
+      });
+      var out = { items: items, total: data.total_count || 0 };
+      cache.set(key, out);
+      return out;
+    }
+    async function fetchReadme(fullName) {
+      var url = "https://api.github.com/repos/" + fullName + "/readme";
+      var res = await fetch(url, { headers: { Accept: "application/vnd.github+json" } });
+      if (!res.ok) throw new Error("no readme");
+      var data = await res.json();
+      var bin = atob(data.content.replace(/\s+/g, ""));
+      var bytes = new Uint8Array(bin.length);
+      for (var i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+      return new TextDecoder("utf-8").decode(bytes);
+    }
+
+    // ── components ────────────────────────────────────────────────────────
+    function PluginCard(props) {
+      return h("li", null,
+        h("button", { type: "button", className: "__mp_card", onClick: props.onOpen },
+          h("div", { className: "__mp_cardHead" },
+            h("span", { className: "__mp_name", title: props.plugin.fullName }, props.plugin.fullName),
+            h("span", { className: "__mp_star" }, "★ " + props.plugin.stars)
+          ),
+          props.plugin.desc ? h("div", { className: "__mp_desc" }, props.plugin.desc) : null,
+          h("div", { className: "__mp_meta" },
+            props.plugin.lang ? h("span", null, props.plugin.lang) : null,
+            h("span", null, props.t("updated") + " " + fmtTime(props.plugin.updated))
+          )
+        )
+      );
+    }
+
+    function DetailPanel(props) {
+      var p = props.plugin;
+      var installName = p.fullName.split("/")[1];
+      return h("div", { className: "__mp_detail" },
+        h("div", { className: "__mp_detailTitle" }, p.fullName),
+        h("div", { className: "__mp_meta" },
+          h("span", null, "★ " + p.stars),
+          h("span", null, props.t("updated") + " " + fmtTime(p.updated)),
+          props.lang ? h("span", null, p.lang) : null
+        ),
+        h("div", null,
+          h("a", { className: "__mp_link", href: p.htmlUrl, target: "_blank", rel: "noreferrer" }, props.t("openRepo")),
+          "  ·  ",
+          h("a", { className: "__mp_link", href: "https://www.npmjs.com/search?q=" + encodeURIComponent(installName), target: "_blank", rel: "noreferrer" }, props.t("openNpm"))
+        ),
+        h("div", { className: "__mp_detailTitle" }, props.t("install")),
+        h("div", { className: "__mp_readme" }, props.t("installHint")),
+        h("code", { className: "__mp_code" },
+          "dsh plugin --profile web add " + installName + "\n" +
+          "# then in $DSH_HOME/profiles/web/cordis.patch.yml:\n" +
+          "- insert:\n    - id: " + installName + "\n      name: '" + installName + "'"
+        ),
+        h("div", { className: "__mp_detailTitle" }, props.t("readme")),
+        h("div", { className: "__mp_readme" },
+          props.readmeLoading ? props.t("loading")
+            : props.readmeError ? props.t("readmeEmpty")
+            : (props.readme || "")
+        )
+      );
+    }
+
+    function MarketplaceSection(props) {
+      var t = props.t;
+      var state = react.useState({ q: "", sort: "stars", page: 1, items: [], loading: false, error: null, total: 0, open: null, readme: null, readmeLoading: false, readmeError: false });
+      var s = state[0], set = state[1];
+      var load = react.useCallback(function (q, sort, page, append) {
+        set(function (prev) { return Object.assign({}, prev, { loading: true, error: null }); });
+        fetchPage(q, sort, page).then(function (out) {
+          set(function (prev) {
+            var items = append ? prev.items.concat(out.items) : out.items;
+            return Object.assign({}, prev, { items: items, total: out.total, loading: false, page: page, q: q, sort: sort });
+          });
+        }).catch(function () {
+          set(function (prev) { return Object.assign({}, prev, { loading: false, error: t("ghError") }); });
+        });
+      }, [t]);
+      react.useEffect(function () {
+        load("", "stars", 1, false);
+      }, [load]);
+      var openDetail = react.useCallback(function (plugin) {
+        if (s.open && s.open.fullName === plugin.fullName) { set(function (prev) { return Object.assign({}, prev, { open: null }); }); return; }
+        set(function (prev) { return Object.assign({}, prev, { open: plugin, readme: null, readmeError: false, readmeLoading: true }); });
+        fetchReadme(plugin.fullName).then(function (text) {
+          set(function (prev) {
+            if (!prev.open || prev.open.fullName !== plugin.fullName) return prev;
+            return Object.assign({}, prev, { readme: text.slice(0, 1200), readmeLoading: false });
+          });
+        }).catch(function () {
+          set(function (prev) {
+            if (!prev.open || prev.open.fullName !== plugin.fullName) return prev;
+            return Object.assign({}, prev, { readmeLoading: false, readmeError: true });
+          });
+        });
+      }, [s.open]);
+      var submit = function (e) {
+        e.preventDefault();
+        load(s.q, s.sort, 1, false);
+      };
+      var more = function () { load(s.q, s.sort, s.page + 1, true); };
+      return h("div", null,
+        h("form", { className: "__mp_toolbar", onSubmit: submit },
+          h("input", { className: "__mp_input", type: "search", value: s.q, placeholder: t("search"), onChange: function (e) { set(function (prev) { return Object.assign({}, prev, { q: e.target.value }); }); } }),
+          h("select", { className: "__mp_select", value: s.sort, onChange: function (e) { load(s.q, e.target.value, 1, false); } },
+            h("option", { value: "stars" }, t("sortStars")),
+            h("option", { value: "updated" }, t("sortUpdated"))
+          )
+        ),
+        s.total > 0 ? h("p", { className: "__mp_status" }, t("total").replace("{count}", String(s.total))) : null,
+        h("ul", { className: "__mp_grid" },
+          s.items.map(function (p) { return h(PluginCard, { key: p.fullName, plugin: p, t: t, onOpen: function () { openDetail(p); } }); })
+        ),
+        s.loading ? h("p", { className: "__mp_status" }, t("loading")) : null,
+        s.error ? h("p", { className: "__mp_error" }, s.error) : null,
+        s.items.length === 0 && !s.loading && !s.error ? h("p", { className: "__mp_status" }, t("empty")) : null,
+        s.items.length > 0 ? h("button", { type: "button", className: "__mp_more", onClick: more, disabled: s.loading }, t("loadMore")) : null,
+        s.open ? h(DetailPanel, { plugin: s.open, t: t, readme: s.readme, readmeLoading: s.readmeLoading, readmeError: s.readmeError, lang: s.open.lang }) : null
+      );
+    }
+
+    // ── plugin ────────────────────────────────────────────────────────────
+    function apply(ctx) {
+      var t = ctx.locale.bind(NS);
+      ctx.effect(function () { return ctx.locale.register(NS, { zh: zh, en: en }); }, "dsh-plugin-marketplace: dictionaries");
+      ctx.slots.inject("settings.section", function () {
+        return ctx.slots.register({
+          name: "settings.section",
+          id: "marketplace",
+          order: 20,
+          label: function () { return t("nav"); },
+          locale: NS
+        }, MarketplaceSection);
+      });
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  }
+});

package/index.js

@@ -0,0 +1,11 @@
+/**
+ * dsh-plugin-marketplace — node half.
+ *
+ * The empty apply exists so the plugin appears in the host Loader; the
+ * browser half owns the marketplace section through exports["./client"],
+ * discovered from the package.json `dsh.client` declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+
+export { apply };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "dsh-plugin-marketplace",
+  "version": "0.1.0",
+  "description": "Plugin marketplace for DeepSeek Harness Web UI: browse github.com/topics/dsh-plugin right inside the settings page — search, sort by stars, and view install instructions.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web"
+    }
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "marketplace",
+    "web-ui"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Scorp1o117/dsh-plugin-marketplace.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Scorp1o117/dsh-plugin-marketplace/issues"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  }
+}