dsh-plugin 1.1.1 → 1.2.0

package/lib/types/services/loader.d.ts

@@ -1,7 +1,3 @@
-/**
- * 运行中 loader 的读取与停用：卸载成功后对匹配条目做 live-disable，
- * 使卸载立即生效（刷新页面不再加载已卸载的 client bundle，也无需重启）。
- */
 /**
  * 运行中 loader 的最小接口：卸载成功后即时移除条目用。
  * 对应官方 `ctx.loader`（cordis-plugin-loader 的 Loader 服务）的读取面与移除面。
@@ -31,6 +27,12 @@ export declare function dumpLoaderEntries(loader: LoaderHandle | undefined): Arr
     id: string;
     name?: string;
 }>;
+/**
+ * 判断某 npm 包名是否已加载进运行中 loader（宽匹配：条目名存在别名变体）。
+ * 官方 `ctx.loader.entries()` 遍历整棵树（reference.md §1.3），条目名 == 插件作者声明的名字。
+ * 安装完成但未重启时条目不在 loader → 返回 false，UI 据此标「待重启/未加载」。
+ */
+export declare function isEntryLoaded(loader: LoaderHandle | undefined, name: string): boolean;
 /**
  * 卸载成功后从运行中 loader 停用指定包的条目。做法：按 name 扫描
  * `loader.entries()`（含嵌套子树），对每个匹配条目
@@ -43,3 +45,11 @@ export declare function dumpLoaderEntries(loader: LoaderHandle | undefined): Arr
  * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
 export declare function removeLoadedEntry(loader: LoaderHandle, name: string): Promise<boolean>;
+/**
+ * 判断某已安装包是否是真正的 dsh 插件（宿主会加载 / 值得提示「待重启」）：
+ *  1) 包名已写进 profile 的 `dsh.profile.bundles`（宿主启动时按清单加载）；
+ *  2) 或包内 package.json 声明了 dsh 配置（`dsh.bundle` / `dsh.profile` 等）或 dsh 相关 keywords。
+ * 两者都满足不了（如 GitHub 官方示例仓库 octocat/Hello-World）说明它不是 dsh 插件，
+ * 装上也不会被宿主加载——UI 据此不再提示「待重启」，避免误导用户反复重启一个不会生效的东西。
+ */
+export declare function isDshPlugin(profile: string, name: string): boolean;

package/lib/types/services/log.d.ts

@@ -0,0 +1,49 @@
+export type LogCategory = 'install' | 'uninstall' | 'update' | 'diagnostics' | 'settings' | 'system';
+export type LogLevel = 'debug' | 'info' | 'success' | 'warn' | 'error';
+export interface LogEntry {
+    /** 毫秒时间戳 */
+    at: number;
+    level: LogLevel;
+    category: LogCategory;
+    /** 机器可读事件码，如 install.start / settings.update */
+    event: string;
+    /** 人类可读描述 */
+    message: string;
+}
+/** 日志保留上限：超过后在读取时裁剪为最近 MAX_LOG_LINES 条 */
+export declare const MAX_LOG_LINES = 2000;
+export interface ReadLogOptions {
+    /** 分页偏移（过滤后倒序） */
+    offset?: number;
+    limit?: number;
+    category?: LogCategory | 'all';
+    level?: LogLevel | 'all';
+    /** 关键词：大小写不敏感，匹配事件码或描述 */
+    query?: string;
+}
+export interface ReadLogResult {
+    /** 倒序（最新在前） */
+    entries: LogEntry[];
+    /** 过滤后的总条数（分页前） */
+    total: number;
+}
+/**
+ * 把用户填写的日志位置覆盖解析成实际文件路径：
+ * 以 .log 结尾视为文件本身，否则视为目录并在其中写 hub.log；相对路径按当前目录归一化。
+ */
+export declare function customLogFile(override: string): string;
+/**
+ * 真正默认的日志文件路径：`~/.dsh/profiles/<profile>/hub.log`（不受设置覆盖影响）。
+ * 弹窗「恢复默认」、目录选择器起点等需要「未自定义时的位置」都从这里取 ——
+ * 不同机器/平台（用户主目录不同）这个值都不同，必须动态计算而非写死。
+ */
+export declare function defaultLogFilePath(profile: string): string;
+/**
+ * 当前生效的日志文件路径：设置里填了 logPath 用自定义位置（目录或文件），
+ * 否则默认 `~/.dsh/profiles/<profile>/hub.log`。默认位置永远合法可用，无需用户干预。
+ */
+export declare function logFilePath(profile: string): string;
+/** 追加一条系统日志（JSONL 一行一条）。 */
+export declare function appendLog(profile: string, entry: LogEntry): void;
+/** 读取系统日志（按时间正序，最新在末尾），超上限就地裁剪；支持过滤与分页。 */
+export declare function readLog(profile: string, opts?: ReadLogOptions): ReadLogResult;

package/lib/types/services/probe.d.ts

@@ -0,0 +1,30 @@
+export interface ProbeResult {
+    /** 是否可达（HTTP 状态码 100–399） */
+    ok: boolean;
+    /** 毫秒耗时；失败为 null */
+    ms: number | null;
+    /** HTTP 状态码；失败为 null */
+    status: number | null;
+}
+/**
+ * 操作系统级代理（macOS 系统网络设置 / Windows Internet 设置）。
+ * Node 内置 http(s) 不读系统代理，浏览器挂的代理 Node 看不见 —— 这里读出来
+ * 作为默认代理，保证「浏览器能开、安装/诊断就能通」。
+ * Linux 没有统一的系统代理入口，返回 null（交给环境变量 / 设置里的代理）。
+ */
+export declare function systemProxy(): string | null;
+/**
+ * 探测一个 HTTPS 目标：proxy 非空注入给 curl 子进程走代理，否则直连。
+ * 供系统诊断 /diagnostics 使用；目标 URL 非法返回不可达。
+ */
+export declare function probeUrl(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult>;
+/**
+ * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入）。
+ * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，
+ * 使「目录数据请求走设置里的代理」与 npm / git 安装通道口径一致。
+ * 失败（curl 不存在 / 连接失败 / 超时 / 非零退出）时 ok=false，全程不抛错。
+ */
+export declare function fetchViaCurl(url: string, proxy: string, timeoutMs: number): Promise<{
+    ok: boolean;
+    body: string;
+}>;

package/lib/types/services/{pending-restart.d.ts → profile/pending-restart.d.ts}

@@ -1,9 +1,15 @@
-/** 待重启列表的内存态管理（宿主进程一重启自然清空）。 */
-import type { PendingRestart } from './install-types.ts';
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 待重启列表的内存态管理（宿主进程一重启自然清空）。
+ */
+import type { PendingRestart } from '../install/install-types.ts';
 /**
  * 登记一条待重启记录（同一目标去重）。
  * - 卸载：目标刚装完未重启（已有待重启记录）→ 宿主从未加载过它，卸完磁盘已干净、
- *   loader 无残留，无需再提醒重启，直接移除该条；否则（此前已被宿主加载过）登记「卸载后待重启清理」。
+ *   loader 无残留，无需再提醒重启，直接移除该条；否则（已被宿主加载过）登记「卸载后待重启清理」。
  * - 安装：已有记录则刷新为安装语义（如卸载后未重启又重装），否则新登记。
  */
 export declare function addPendingRestart(target: string, kind: 'install' | 'uninstall'): void;

package/lib/types/services/{profile.d.ts → profile/profile.d.ts}

@@ -2,13 +2,17 @@
 export declare function readProfileArg(fallback?: string): string;
 /** Resolve a profile directory (`DSH_HOME` or `~/.dsh`). */
 export declare function profileDirectory(profile: string): string;
-/** Build a safe `github:<owner>/<repo>` target, or null when the repo is unsafe. */
+/** Build a safe explicit HTTPS Git target, or null when the repo is unsafe. */
 export declare function githubTarget(repo: string): string | null;
+export declare function installTargetOf(value: string): string;
+export declare function globalNpmPackagesOf(value: string): string[] | null;
+/** Extract an owner/repo identity from a catalog value or an installed Git spec. */
+export declare function githubRepoOf(value: string): string | null;
 /** Validate an npm package name (uninstall target grammar). */
 export declare function validPackageName(name: string): boolean;
 /**
  * The exact `allowBuilds` key pnpm printed in its
- * `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` hint. For `github:` installs pnpm
+ * `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` hint. For Git installs pnpm
  * matches against `name@<resolved fetch URL>` — the URL it actually fetches,
  * e.g. `https://codeload.github.com/<owner>/<repo>/tar.gz/<commit>` — not the
  * `git+ssh://`/branch spec. A bare name or a `git+` spec does not match, so

package/lib/types/services/{progress.d.ts → profile/progress.d.ts}

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Pure progress-estimation helpers shared by the install runner.
  *
  * The dsh CLI wraps pnpm, which refreshes its `Progress: …` line in place

package/lib/types/services/settings.d.ts

@@ -0,0 +1,24 @@
+export interface HubSettings {
+    /** 启动时检查目录插件更新，发现可更新时在通知中心提示（安装不自动进行） */
+    checkUpdatesOnStart: boolean;
+    /** npm 镜像源 registry 地址（空串 = 官方 https://registry.npmjs.org） */
+    npmRegistry: string;
+    /** HTTP(S) 代理地址，用于 npm / git / 目录请求（空串 = 直连） */
+    proxy: string;
+    /** 启用命令行安装 NPM 包（默认开；关掉后输入 npm 包名安装被拦截） */
+    enableNpmInstall: boolean;
+    /** 启用命令行安装 GitHub 源码（默认开；关掉后输入 GitHub 地址安装被拦截） */
+    enableGitInstall: boolean;
+    /** 启用命令行粘贴 dsh plugin 命令安装（默认开；关掉后命令输入被禁用） */
+    enableDshInstall: boolean;
+    /** 日志存放位置覆盖（空串 = 默认 ~/.dsh/profiles/<profile>/hub.log；可填目录或 .log 文件路径） */
+    logPath: string;
+}
+export declare const DEFAULT_SETTINGS: HubSettings;
+export declare function settingsFile(profile: string): string;
+/** 读取当前 profile 的设置；文件缺失/损坏时回退默认值（只读路径绝不抛错）。 */
+export declare function loadSettings(profile: string): HubSettings;
+/** 合并并持久化设置（部分更新），返回合并后的完整设置。 */
+export declare function saveSettings(profile: string, patch: Partial<HubSettings>): HubSettings;
+/** 重置为默认设置：删除设置文件，下次读取全部回退默认值（陈旧/白名单外键一并清除）。 */
+export declare function resetSettings(profile: string): HubSettings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 4000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：4000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",