dsh-m 0.1.0 → 0.2.0

package/lib/core/installed.js

@@ -2,7 +2,7 @@
  * 已装插件识别（DESIGN.md §3）：profile 的 package.json 是唯一事实源，
  * 不引入额外状态文件。移植自 skillhub installed-plugins.ts（去 README 暂缓）。
  */
-import { readFile } from 'node:fs/promises';
+import { open, readFile } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 import { isSafePluginTarget, removeDshPlugin } from './dsh-cli.js';
 import { webProfileDir } from './env.js';
@@ -27,19 +27,37 @@ export function parseSpecSource(spec) {
         return 'npm';
     return 'unknown';
 }
-/** 解析依赖的包目录：普通依赖限制在 profile node_modules 内；link:/file: 仅接受绝对路径。 */
+/**
+ * 解析依赖的包目录：
+ * - `link:` 是活的开发目录符号链接，解析真实目标（已装页展示本地路径有价值）；
+ * - 其余（npm / github / file-tarball / file-dir）pnpm 都会把内容物化到 node_modules/<pkg>，
+ *   统一从那里读。skillhub 同款语义——file: 特判回 tarball 路径是错的（读不到 package.json）。
+ */
 export function resolvePluginDir(profileDir, pkg, spec) {
     if (!isSafePkgName(pkg))
         return null;
     const source = parseSpecSource(spec);
-    if (source === 'link' || source === 'file') {
-        const target = String(spec).slice(spec.indexOf(':') + 1).trim();
+    if (source === 'link') {
+        const target = String(spec).slice('link:'.length).trim();
         if (!target.startsWith('/') || target.includes('\0'))
             return null;
         return resolve(target);
     }
     return join(resolve(profileDir), 'node_modules', pkg);
 }
+/** 从 repository 字段（字符串或 {url}，git+/ssh/https 形态）提取 github owner/repo。 */
+export function githubRepoFromRepository(raw) {
+    let url = '';
+    if (typeof raw === 'string')
+        url = raw;
+    else if (raw && typeof raw === 'object') {
+        const u = raw.url;
+        if (typeof u === 'string')
+            url = u;
+    }
+    const m = /github\.com[/:]([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?$/i.exec(url.trim());
+    return m ? `${m[1]}/${m[2]}` : null;
+}
 export async function readPkgJson(dir) {
     try {
         const raw = JSON.parse(await readFile(join(dir, 'package.json'), 'utf8'));
@@ -72,6 +90,7 @@ function sanitizePkgJson(raw, fallbackName) {
         description: typeof raw.description === 'string' ? raw.description.trim().slice(0, 500) : '',
         homepage: typeof raw.homepage === 'string' && /^https?:\/\//i.test(raw.homepage) ? raw.homepage.slice(0, 300) : '',
         path: '',
+        githubRepo: githubRepoFromRepository(raw.repository),
     };
 }
 /** 枚举 web profile 已安装插件（只读）。 */
@@ -99,6 +118,7 @@ export async function listInstalledPlugins(profileDir = webProfileDir()) {
             source: parseSpecSource(spec),
             dsh: true,
             path: dir,
+            githubRepo: githubRepoFromRepository(raw.repository),
         });
     }
     return { items, others, profileDir: root };
@@ -119,3 +139,48 @@ export async function removeInstalledPlugin(pkg, profileDir = webProfileDir(), d
     await removeDshPlugin(key, deps);
     return { pkg: key };
 }
+// ---------- README 预览（借鉴 skillhub，64KB 截断） ----------
+const README_MAX_BYTES = 64 * 1024;
+const README_FILES = ['README.md', 'README.markdown', 'README'];
+/** 限量读取文本文件：只读前 limit 字节，超限标记 truncated。 */
+async function readTextLimited(path, limit) {
+    let fh;
+    try {
+        fh = await open(path, 'r');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buf = Buffer.alloc(limit + 1);
+        const { bytesRead } = await fh.read(buf, 0, buf.length, 0);
+        return {
+            text: buf.subarray(0, Math.min(bytesRead, limit)).toString('utf8'),
+            truncated: bytesRead > limit,
+        };
+    }
+    finally {
+        await fh.close().catch(() => undefined);
+    }
+}
+/** 读取单个已安装插件的 README（UTF-8，≤64KB，超限截断）。pkg 必须来自 profile 依赖。 */
+export async function readInstalledPluginReadme(pkg, profileDir = webProfileDir()) {
+    const key = String(pkg || '').trim();
+    if (!isSafePkgName(key))
+        throw new Error(`无效插件包名: ${pkg}`);
+    const root = resolve(profileDir);
+    const deps = await readProfileDeps(root);
+    if (!(key in deps))
+        throw new Error(`web profile 未安装该插件: ${key}`);
+    const dir = resolvePluginDir(root, key, deps[key]);
+    if (!dir)
+        throw new Error(`无法解析插件目录: ${key}`);
+    const raw = await readPkgJson(dir);
+    const name = raw && typeof raw.name === 'string' && raw.name.trim() ? raw.name.trim() : key;
+    for (const file of README_FILES) {
+        const text = await readTextLimited(join(dir, file), README_MAX_BYTES);
+        if (text)
+            return { pkg: key, name, readme: text.text, truncated: text.truncated };
+    }
+    return { pkg: key, name, readme: '', truncated: false };
+}