dsh-plugin 1.6.5 → 1.6.7

package/lib/http/catalog.js

@@ -0,0 +1,132 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Catalog proxy routes: server-side caching of the directory/stats payloads
+ * and profile-level installed-package reads shared with the install/task modules.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { githubRepoOf } from '../services/install/install.js';
+import { loadSettings } from '../services/settings.js';
+import { fetchViaCurl, systemProxy } from '../services/probe.js';
+import { CATALOG_CACHE_TTL_MS, requireMethod, sendJson } from './shared.js';
+function catalogCacheFile(profile, key) {
+    return join(profileDirectory(profile), 'cache', `catalog-${key}.json`);
+}
+/** 读缓存：文件存在、JSON 合法、未超过 maxAgeMs → 返回原始响应字符串；否则 null（视为 miss）。
+ *  maxAgeMs 传 Infinity 即「任意年龄的缓存」，供实时拉取失败时兜底使用。 */
+function readCatalogCache(file, maxAgeMs) {
+    try {
+        const entry = JSON.parse(readFileSync(file, 'utf8'));
+        if (entry && typeof entry.at === 'number' && typeof entry.body === 'string'
+            && Date.now() - entry.at < maxAgeMs) {
+            return entry.body;
+        }
+    }
+    catch {
+        // 文件缺失 / 解析失败 / 字段不完整 → miss，重新拉取覆盖写盘
+    }
+    return null;
+}
+/** 写缓存：目录不存在则创建；写失败静默忽略（缓存只是加速，不影响功能）。 */
+function writeCatalogCache(file, body) {
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, JSON.stringify({ at: Date.now(), body }));
+    }
+    catch {
+        // 磁盘只读/无权限等极端情况：忽略，继续走直连
+    }
+}
+export function profileDirectory(profile) {
+    return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile);
+}
+/** Read non-official dependencies installed into one profile. */
+export function readInstalled(profile) {
+    try {
+        const manifest = JSON.parse(readFileSync(join(profileDirectory(profile), 'package.json'), 'utf8'));
+        return Object.fromEntries(Object.entries(manifest.dependencies ?? {}).filter(([name]) => !name.startsWith('@deepseek-ai/')));
+    }
+    catch {
+        return {};
+    }
+}
+/** 读已装依赖实际落在磁盘上的仓库身份（`owner/repo`）：解析 node_modules/<name>/package.json
+ *  的 repository 字段。已装 spec 可能是纯版本号（丢了仓库身份），但真实包元数据仍指向来源仓库，
+ *  据此可区分「同名依赖其实是同一仓库的残留（应转 update）」还是「跨仓库包名冲突（应报错）」。
+ *  读不到 / 解析不出返回 null（交给调用方按冲突处理）。 */
+export function installedRepoOf(profile, name) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(profileDirectory(profile), 'node_modules', name, 'package.json'), 'utf8'));
+        const repo = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url;
+        return repo ? githubRepoOf(repo) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function registerCatalogRoutes(webServer, profile) {
+    return [
+        {
+            kind: 'exact',
+            path: '/dsh-plugin-hub/catalog',
+            handler: async (request, response) => {
+                if (!requireMethod(request, response, 'GET'))
+                    return;
+                // 目录/统计数据服务端代理：浏览器不直连 dsh-plugin.org，统一经此路由
+                // 转发（curl 子进程注入代理 env），与 npm / git 安装通道走同一代理口径，
+                // 「npm / git / 目录数据请求统一走该代理」的设置文案因此真实生效。
+                const url = new URL(request.url ?? '/', 'http://localhost');
+                const settings = loadSettings(profile);
+                // 代理优先级与安装/诊断一致：设置里的代理 → 系统代理 → 环境变量 → 直连
+                const proxy = settings.proxy !== ''
+                    ? settings.proxy
+                    : (systemProxy() ?? process.env.HTTPS_PROXY ?? process.env.https_proxy ?? '');
+                const isStats = url.searchParams.get('stats') === '1';
+                const lang = url.searchParams.get('lang') === 'en' ? 'en' : 'zh';
+                const target = isStats
+                    ? 'https://api.dsh-plugin.org/stats.json'
+                    : `https://api.dsh-plugin.org/plugins.${lang}.json`;
+                // 1 小时本地缓存：命中直接返回（跨重启生效，插件市场秒开），未命中才走 curl 拉远程
+                const cacheFile = catalogCacheFile(profile, isStats ? 'stats' : `plugins-${lang}`);
+                const cached = readCatalogCache(cacheFile, CATALOG_CACHE_TTL_MS);
+                if (cached !== null) {
+                    try {
+                        sendJson(response, 200, JSON.parse(cached));
+                        return;
+                    }
+                    catch {
+                        // 缓存正文损坏：忽略，走重新拉取并覆盖写盘
+                    }
+                }
+                const r = await fetchViaCurl(target, proxy, 20000);
+                if (!r.ok || r.body === '') {
+                    // 实时拉取失败：退回任意年龄的本地缓存（上次成功数据），
+                    // 避免证书吊销受阻 / 网络抖动时整个插件市场打不开 —— 数据可能过期，但好过空白。
+                    const stale = readCatalogCache(cacheFile, Number.POSITIVE_INFINITY);
+                    if (stale !== null) {
+                        try {
+                            sendJson(response, 200, JSON.parse(stale));
+                            return;
+                        }
+                        catch {
+                            // 兜底缓存也损坏：落到下面的 502
+                        }
+                    }
+                    sendJson(response, 502, { error: 'catalog fetch failed' });
+                    return;
+                }
+                try {
+                    sendJson(response, 200, JSON.parse(r.body));
+                    writeCatalogCache(cacheFile, r.body);
+                }
+                catch {
+                    sendJson(response, 502, { error: 'catalog fetch returned invalid JSON' });
+                }
+            },
+        },
+    ];
+}

package/lib/http/diagnostics.js

@@ -0,0 +1,201 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Diagnostics routes: streaming connectivity self-check, proxy verification,
+ * and the host environment snapshot shared with the task module's /env route.
+ */
+import { readFileSync } from 'node:fs';
+import { homedir, release } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { loadSettings } from '../services/settings.js';
+import { gitLsRemote, probeUrl, systemProxy } from '../services/probe.js';
+import { appendLog } from '../services/log.js';
+import { readJsonBody, requireTrustedPost, sendJson } from './shared.js';
+/** 宿主 dsh CLI 版本：优先直接跑 `dsh --version`（与 pnpm/npm/git 同款同步探测，1500ms 超时兜底，
+ *  绝不挂起）；拿不到再退回从入口 `process.argv[1]` 向上找 package.json（dsh 不在 PATH 时兜底）。 */
+function hostDshVersion() {
+    const viaCli = toolVersion('dsh', ['--version']);
+    if (viaCli)
+        return viaCli;
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return null;
+    let dir = dirname(resolve(entry));
+    for (let depth = 0; depth < 4; depth++) {
+        try {
+            const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+            const name = manifest.name ?? '';
+            if (typeof manifest.version === 'string' && (name === 'dsh' || name.includes('dsh') || name.includes('harness'))) {
+                return manifest.version;
+            }
+        }
+        catch {
+            /* not a package root — keep walking up */
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/** 探测命令行工具的版本号（pnpm --version / npm --version / git --version）：
+ *  未安装 / 不在 PATH / 超时一律返回 null —— issue 环境快照如实写 unknown，绝不挂起。
+ *  （同步探测仅用于启动期/请求期的低频率 /env 快照，安装通道不经过这里。） */
+function toolVersion(cmd, args) {
+    try {
+        const r = spawnSync(cmd, args, { timeout: 1500, encoding: 'utf8' });
+        if (r.error || r.status !== 0)
+            return null;
+        const v = (r.stdout ?? '').trim().split(/\r?\n/)[0];
+        return v || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 宿主环境快照：提交 bug 时随 issue 附上，便于作者复现（前端 /env 端点返回）。 */
+export function hostEnv(profile) {
+    return {
+        dshVersion: hostDshVersion(),
+        nodeVersion: process.version,
+        pnpmVersion: toolVersion('pnpm', ['--version']),
+        npmVersion: toolVersion('npm', ['--version']),
+        gitVersion: toolVersion('git', ['--version']),
+        platform: process.platform,
+        arch: process.arch,
+        release: release(),
+        profile,
+        dshHome: process.env.DSH_HOME ?? join(homedir(), '.dsh'),
+    };
+}
+export function registerDiagnosticsRoutes(webServer, profile) {
+    return [
+        {
+            kind: 'exact',
+            path: '/dsh-plugin-hub/diagnostics',
+            handler: async (request, response) => {
+                if (!requireTrustedPost(request, response))
+                    return;
+                // 连通性自检：npm registry（镜像/官方）/ GitHub API / 目录站点，逐路探测并测速。
+                // 与安装通道一一对应 —— npm 反查与 npm 安装走 registry、git 源走 github、目录数据走 dsh-plugin.org。
+                // 流式（NDJSON）逐条上报：每个探测先发命令行，完成后发结果行，客户端以黑窗口终端实时展示。
+                // 可选 body { key }：只重测指定通道（页面列表「重测」单项时用），缺省全量串行探测。
+                let onlyKey = '';
+                try {
+                    const body = await readJsonBody(request);
+                    if (body !== null && typeof body === 'object' && typeof body.key === 'string') {
+                        onlyKey = body.key;
+                    }
+                }
+                catch {
+                    // 空 body / 非 JSON：视为全量探测
+                }
+                const settings = loadSettings(profile);
+                // npm 通道：设置里配置了镜像源就探测该镜像（安装通道吃同一个 registry）；
+                // 未配置（空串）时探测官方源作为「跟随本机 npm 配置」的基础连通性参考。
+                const registry = settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org';
+                // 连通性自检直接打安装通道真实访问的轻量资源：npm 源拉包元数据、git 通道探
+                // 仓库主页、目录站探 badge 小文件，避免拉取目录全量 JSON。
+                // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
+                const allChecks = [
+                    { key: 'npm', url: `${registry}/dsh-plugin`, display: settings.npmRegistry !== '' ? registry : '', cmd: `npm view dsh-plugin version --registry ${registry}` },
+                    // GitHub 行用真实 git 克隆握手（git ls-remote）打 dshplugin/hello-dsh 小仓库：
+                    // 「网页能打开」和「git 能克隆」是两码事，握手成功才算通道通；小仓库秒级完成，不打 17MB 的 dsh-plugin-hub。
+                    { key: 'github', url: 'https://github.com/dshplugin/hello-dsh', display: 'github.com', cmd: 'git ls-remote https://github.com/dshplugin/hello-dsh', git: true },
+                    { key: 'catalog', url: 'https://api.dsh-plugin.org/stats.json', display: '', cmd: 'curl -s https://api.dsh-plugin.org/stats.json' },
+                ];
+                // 配置了 HTTP 代理：追加一行代理诊断 —— 用该代理打 github.com（安装通道真实访问的地址），
+                // 验证「代理能不能把请求带出去」。与安装同口径：curl 子进程注入该代理 env。
+                // 设置里未配置代理时不显示该行（跟随系统代理/直连，无「代理本身」可验证）。
+                if (settings.proxy !== '') {
+                    allChecks.push({ key: 'proxy', url: 'https://github.com', display: settings.proxy, cmd: `curl -s -o /dev/null -x ${settings.proxy} https://github.com`, proxy: settings.proxy });
+                }
+                const checks = onlyKey !== '' ? allChecks.filter((c) => c.key === onlyKey) : allChecks;
+                response.writeHead(200, {
+                    'content-type': 'application/x-ndjson; charset=utf-8',
+                    'cache-control': 'no-store',
+                });
+                const send = (line) => { response.write(`${JSON.stringify(line)}\n`); };
+                // 探测走代理的优先级：设置里的代理 → 系统代理（macOS scutil / Windows 注册表）→ 环境变量 HTTPS_PROXY → 直连。
+                // 与安装通道一致（npm/git 靠 HTTP_PROXY 环境变量走代理），且自动跟随系统代理 ——
+                // 浏览器挂着代理能开、诊断就能测通，不用用户手动把代理填进设置。
+                // proxy 行例外：它验证的正是「设置里配的那个代理」，必须显式用它（而非 effectiveProxy）去探测。
+                const effectiveProxy = settings.proxy !== ''
+                    ? settings.proxy
+                    : (systemProxy() ?? process.env.HTTPS_PROXY ?? process.env.https_proxy ?? '');
+                const probe = (url, proxy) => probeUrl(url, proxy ?? effectiveProxy, 6000);
+                // 逐路串行：一条命令一条结果地推送给终端，保持「程序在跑」的真实感
+                const results = [];
+                for (const c of checks) {
+                    send({ type: 'probe', key: c.key, cmd: c.cmd, display: c.display });
+                    // git 行走真实克隆握手（gitLsRemote），其余走 curl 探测，两路都带超时兜底
+                    const r = c.git
+                        ? await gitLsRemote(c.url, c.proxy ?? effectiveProxy, 6000)
+                        : await probe(c.url, c.proxy);
+                    results.push({ key: c.key, ok: r.ok });
+                    // git 行的 status 是退出码，客户端 git 行只显示 OK / 不可达，不显示成 HTTP 码。
+                    // reason 透出失败细分原因（如 Windows 证书吊销受阻），客户端据此给对症提示而非笼统「不可达」。
+                    send({
+                        type: r.ok ? 'ok' : 'fail',
+                        key: c.key,
+                        display: c.display,
+                        ms: r.ms,
+                        status: c.git ? null : r.status,
+                        reason: r.ok ? null : (r.reason ?? null),
+                    });
+                }
+                send({ type: 'end', at: Date.now() });
+                response.end();
+                // 系统日志：诊断汇总（全部通过 / 存在不可达）
+                const failed = results.filter((r) => !r.ok);
+                appendLog(profile, {
+                    at: Date.now(),
+                    level: failed.length === 0 ? 'success' : 'error',
+                    category: 'diagnostics',
+                    event: 'diagnostics.done',
+                    message: failed.length === 0
+                        ? `连通性检测通过（${results.length} 个通道）`
+                        : `连通性检测：${failed.length}/${results.length} 个通道不可达`,
+                });
+            },
+        },
+        {
+            kind: 'exact',
+            path: '/dsh-plugin-hub/proxy-check',
+            handler: async (request, response) => {
+                if (!requireTrustedPost(request, response))
+                    return;
+                // 代理连通性校验：用待测代理打 dshplugin/hello-dsh 真实仓库页（权威可达目标），
+                // 供设置页输入代理时实时反馈「这个地址通不通」。不通过也允许保存 ——
+                // 用户可能是先填地址后开代理，因此这里只报告探测结果、不拦截保存。
+                let proxy = '';
+                let target = 'https://github.com/dshplugin/hello-dsh';
+                try {
+                    const body = await readJsonBody(request);
+                    if (body !== null && typeof body === 'object') {
+                        const b = body;
+                        if (typeof b.proxy === 'string')
+                            proxy = b.proxy.trim();
+                        if (typeof b.target === 'string' && b.target.trim() !== '')
+                            target = b.target.trim();
+                    }
+                }
+                catch {
+                    // 空 body / 非 JSON：按默认目标探测
+                }
+                if (proxy === '') {
+                    sendJson(response, 200, { ok: false, ms: null, status: null, target, reason: 'empty' });
+                    return;
+                }
+                // 探测走该代理本身（不是 effectiveProxy）：验证的就是用户填的这个地址。
+                // reason 带上失败细分原因（如证书吊销受阻），设置页才能提示「不是代理地址的问题」。
+                const r = await probeUrl(target, proxy, 6000);
+                sendJson(response, 200, { ok: r.ok, ms: r.ms, status: r.status, target, reason: r.reason ?? null });
+            },
+        },
+    ];
+}