dsh-plugin-panel 0.0.0-stage → 0.1.0

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-plugin-panel
+      name: dsh-plugin-panel

package/docs/DETAIL.md

@@ -0,0 +1,7 @@
+Open Plugin manager in the right sidebar.
+
+Filter by Installed, Built-in, or All. Plugins with a right-sidebar page come first, then Settings, then the left menu. Plugins with no UI entry are last.
+
+Pin moves a plugin to the front. Open switches to that plugin's right-sidebar page when it has one. Select a card to read its introduction, package, version, source, and these notes.
+
+DSH does not record plugin call history.

package/docs/DETAIL.zh.md

@@ -0,0 +1,7 @@
+在右侧栏打开「插件管理」。
+
+可以按「用户安装」「系统内置」「全部」筛选。有右侧栏页面的插件排在前面，然后是设置页、左侧菜单，没有界面入口的放在最后。
+
+点「置顶」把插件放到最前，再点「取消置顶」恢复。有右侧栏页面的插件可以点「打开」，会切到那个页面。点卡片查看介绍、包名、版本、来源和这篇说明。
+
+系统没有插件调用记录。纯界面插件不会出现在工具列表里。

package/icon.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#1b2430"/>
+  <ellipse cx="24" cy="30" rx="12" ry="3.2" fill="#0b1016" opacity="0.45"/>
+  <g transform="rotate(-11 22 18)">
+    <rect x="8" y="9" width="28" height="18" rx="4" fill="#f6f1e7"/>
+    <rect x="12" y="14" width="12" height="2.4" rx="1.2" fill="#1b2430" opacity="0.72"/>
+    <rect x="12" y="18.4" width="18" height="1.6" rx="0.8" fill="#1b2430" opacity="0.28"/>
+  </g>
+  <rect x="26" y="30" width="30" height="20" rx="4.5" fill="#f7f3ea"/>
+  <rect x="31" y="36" width="13" height="2.6" rx="1.3" fill="#1b2430" opacity="0.75"/>
+  <rect x="31" y="41" width="19" height="1.7" rx="0.8" fill="#1b2430" opacity="0.28"/>
+  <circle cx="49" cy="40" r="2.3" fill="#2fbe86"/>
+</svg>

package/index.js

@@ -0,0 +1,371 @@
+import { createRequire } from 'node:module'
+import { spawn } from 'node:child_process'
+import { readFileSync, readdirSync, statSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const CHANNEL = '/dsh-plugins-ui-rpc'
+const MAX_SOURCE_BYTES = 1_200_000
+const MAX_FILES = 40
+const MAX_DOC_CHARS = 2400
+const MAX_COUNT_BATCH = 40
+const moduleTools = new Map()
+
+export function apply(ctx) {
+  ctx.inject(['connection', 'webServer', 'tools', 'pluginManager'], (scoped) => {
+    const tools = scoped.tools
+    const pluginManager = scoped.pluginManager
+    scoped.effect(() => registerDetailRpc(scoped, { tools, pluginManager }), 'plugin-canvas: detail rpc')
+  })
+}
+
+function registerDetailRpc(ctx, services) {
+  return ctx.webServer.register({
+    kind: 'prefix',
+    path: CHANNEL,
+    handler: async (req, res) => {
+      const rejection = ctx.connection.requestRejection(req)
+      if (rejection !== undefined) {
+        res.statusCode = rejection
+        res.end()
+        return
+      }
+      if (req.method !== 'POST') {
+        res.statusCode = 404
+        res.end('not found')
+        return
+      }
+      const mediaType = String(req.headers['content-type'] ?? '').split(';', 1)[0].trim().toLowerCase()
+      if (mediaType !== 'application/json') {
+        res.statusCode = 415
+        res.end('content type must be application/json')
+        return
+      }
+      let body
+      try {
+        body = await readJson(req)
+      } catch (error) {
+        res.statusCode = 400
+        res.end(error instanceof Error ? error.message : 'invalid body')
+        return
+      }
+      const record = body && typeof body === 'object' ? body : {}
+      const rpcId = typeof record.rpcId === 'string' ? record.rpcId : ''
+      const method = typeof record.method === 'string' ? record.method : ''
+      if (!rpcId || !method) {
+        res.statusCode = 400
+        res.end('invalid client-request envelope')
+        return
+      }
+      let result
+      try {
+        if (method === 'detail') result = { ok: true, value: await readDetail(services, record.payload) }
+        else if (method === 'counts') result = { ok: true, value: countTools(services, record.payload) }
+        else if (method === 'facts') result = { ok: true, value: readFacts(record.payload) }
+        else if (method === 'reveal') result = { ok: true, value: revealPackage(record.payload) }
+        else throw new Error('Unknown detail method.')
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        result = { ok: false, error: { code: 'plugin-canvas/detail', message: message.slice(0, 500), details: {} } }
+      }
+      res.statusCode = 200
+      res.setHeader('content-type', 'application/json; charset=utf-8')
+      res.setHeader('cache-control', 'no-store')
+      res.end(JSON.stringify({ type: 'server-response', rpcId, result }))
+    },
+  })
+}
+
+async function readDetail(services, payload) {
+  const input = payload && typeof payload === 'object' ? payload : {}
+  const moduleName = typeof input.moduleName === 'string' ? input.moduleName : ''
+  const entryId = typeof input.entryId === 'string' ? input.entryId : ''
+  const language = typeof input.language === 'string' ? input.language : 'zh'
+  const tools = toolsForModule(listTools(services.tools), moduleName)
+  const located = locatePackage(moduleName)
+  const manifest = located ? readManifest(located.root) : null
+  const bundle = await findBundle(services.pluginManager, moduleName, entryId, manifest && manifest.name)
+  const document = await readDocument(services.pluginManager, bundle && bundle.name, language)
+  return {
+    summary: manifest && manifest.summary ? manifest.summary : '',
+    packageDescription: manifest && manifest.description ? manifest.description : '',
+    bundleName: bundle && bundle.name ? bundle.name : '',
+    version: bundle && bundle.version ? bundle.version : (manifest && manifest.version) || '',
+    source: bundle && bundle.source ? bundle.source : '',
+    official: bundle ? bundle.official === true : false,
+    document,
+    tools,
+    toolNote: tools.length ? '' : '没有在这个插件的代码里对上已注册、会交给 AI 的工具。',
+  }
+}
+
+function revealPackage(payload) {
+  const input = payload && typeof payload === 'object' ? payload : {}
+  const moduleName = typeof input.moduleName === 'string' ? input.moduleName : ''
+  const source = typeof input.source === 'string' ? input.source : ''
+  const located = locatePackage(moduleName)
+  const dir = (located && located.root) || directoryFromSource(source)
+  if (!dir) throw new Error('找不到这个插件的目录。')
+  const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open'
+  const child = spawn(command, [dir], { detached: true, stdio: 'ignore' })
+  child.on('error', () => {})
+  child.unref()
+  return { path: dir }
+}
+
+function directoryFromSource(source) {
+  const raw = String(source || '')
+  const at = raw.lastIndexOf('@')
+  const text = (at >= 0 ? raw.slice(at + 1) : raw).replace(/^link:/, '')
+  if (!text || text.startsWith('http')) return ''
+  try {
+    const file = text.startsWith('file:') ? fileURLToPath(text) : text
+    if (!file.startsWith('/')) return ''
+    const stat = statSync(file)
+    const dir = stat.isDirectory() ? file : path.dirname(file)
+    return packageRoot(dir)
+  } catch {
+    return ''
+  }
+}
+
+function readFacts(payload) {
+  const input = payload && typeof payload === 'object' ? payload : {}
+  const moduleName = typeof input.moduleName === 'string' ? input.moduleName : ''
+  const source = typeof input.source === 'string' ? input.source : ''
+  const located = locatePackage(moduleName)
+  const root = (located && located.root) || directoryFromSource(source)
+  const manifest = root ? readManifest(root) : null
+  const document = root ? readLocalDocument(root) : ''
+  if (!manifest && !document) return { manifest: null, document: '' }
+  return {
+    document,
+    manifest: manifest && {
+      name: manifest.name,
+      version: manifest.version,
+      description: manifest.description,
+      summary: manifest.summary,
+      license: manifest.license,
+      homepage: manifest.homepage,
+      repository: manifest.repository,
+      keywords: manifest.keywords,
+      engines: manifest.engines,
+      clientPlatform: manifest.clientPlatform,
+      clientInject: manifest.clientInject,
+    },
+  }
+}
+
+function countTools(services, payload) {
+  const input = payload && typeof payload === 'object' ? payload : {}
+  const plugins = Array.isArray(input.plugins) ? input.plugins.slice(0, MAX_COUNT_BATCH) : []
+  const all = listTools(services.tools)
+  const counts = {}
+  for (const plugin of plugins) {
+    if (!plugin || typeof plugin.entryId !== 'string' || !plugin.entryId) continue
+    const moduleName = typeof plugin.moduleName === 'string' ? plugin.moduleName : ''
+    counts[plugin.entryId] = toolsForModule(all, moduleName).length
+  }
+  return { counts }
+}
+
+function toolsForModule(allTools, moduleName) {
+  const key = moduleName || ''
+  if (moduleTools.has(key)) return moduleTools.get(key)
+  const located = locatePackage(key)
+  const source = located ? readPackageSource(located.root, located.entryFile) : ''
+  const manifest = located ? readManifest(located.root) : null
+  const tools = ownedTools(allTools, source, manifest && manifest.name)
+  moduleTools.set(key, tools)
+  return tools
+}
+
+function listTools(tools) {
+  if (!tools || typeof tools.definitions !== 'function') return []
+  const definitions = tools.definitions()
+  if (!Array.isArray(definitions)) return []
+  return definitions.map((tool) => ({
+    name: typeof tool.name === 'string' ? tool.name : '',
+    description: typeof tool.description === 'string' ? tool.description : '',
+    parameters: summarizeParams(tool.parameters),
+  })).filter((tool) => tool.name)
+}
+
+function summarizeParams(parameters) {
+  if (!parameters || typeof parameters !== 'object') return []
+  const props = parameters.properties && typeof parameters.properties === 'object'
+    ? parameters.properties
+    : null
+  if (!props) return []
+  return Object.entries(props).slice(0, 16).map(([name, schema]) => ({
+    name,
+    type: schema && typeof schema.type === 'string' ? schema.type : '',
+    description: schema && typeof schema.description === 'string' ? schema.description : '',
+  }))
+}
+
+function ownedTools(tools, source, packageName) {
+  if (!source) return []
+  const prefix = packagePrefix(packageName)
+  return tools.filter((tool) => {
+    if (source.includes(`'${tool.name}'`) || source.includes(`"${tool.name}"`) || source.includes(`\`${tool.name}\``)) return true
+    return prefix && (tool.name === prefix || tool.name.startsWith(`${prefix}_`) || tool.name.startsWith(`${prefix}-`))
+  })
+}
+
+function packagePrefix(name) {
+  if (!name) return ''
+  const bare = name.startsWith('@') ? name.slice(name.indexOf('/') + 1) : name
+  return bare.replace(/^dsh-/, '').replace(/[^a-z0-9]+/gi, '_').replace(/^_|_$/g, '').toLowerCase()
+}
+
+async function findBundle(pluginManager, moduleName, entryId, packageName) {
+  if (!pluginManager || typeof pluginManager.listBundles !== 'function') return null
+  const bundles = await pluginManager.listBundles()
+  if (!Array.isArray(bundles)) return null
+  return bundles.find((bundle) => {
+    if (packageName && bundle.name === packageName) return true
+    if (moduleName && bundle.name === moduleName) return true
+    const rows = Array.isArray(bundle.rows) ? bundle.rows : []
+    return rows.some((row) => row.moduleName === moduleName || (entryId && row.entryId === entryId))
+  }) || null
+}
+
+async function readDocument(pluginManager, name, language) {
+  if (!name || !pluginManager || typeof pluginManager.readBundleDetail !== 'function') return ''
+  try {
+    const detail = await pluginManager.readBundleDetail(name, language)
+    if (!detail || detail.status !== 'found' || typeof detail.markdown !== 'string') return ''
+    return detail.markdown.replace(/^---[\s\S]*?---\s*/, '').trim().slice(0, MAX_DOC_CHARS)
+  } catch {
+    return ''
+  }
+}
+
+function locatePackage(moduleName) {
+  if (!moduleName) return null
+  if (moduleName.startsWith('file:')) {
+    const entryFile = fileURLToPath(moduleName)
+    return { entryFile, root: packageRoot(path.dirname(entryFile)) }
+  }
+  const profile = process.env.DSH_PROFILE_DIR || path.join(process.env.HOME || '', '.dsh/profiles/desktop')
+  try {
+    const req = createRequire(path.join(profile, 'package.json'))
+    const resolved = req.resolve(moduleName)
+    return { entryFile: resolved, root: packageRoot(path.dirname(resolved)) }
+  } catch {
+    try {
+      const direct = path.join(profile, 'node_modules', moduleName)
+      if (statSync(path.join(direct, 'package.json')).isFile()) return { entryFile: '', root: direct }
+    } catch { /* not installed under that folder name */ }
+    return null
+  }
+}
+
+function packageRoot(start) {
+  let dir = start
+  for (let i = 0; i < 8; i += 1) {
+    try {
+      if (statSync(path.join(dir, 'package.json')).isFile()) return dir
+    } catch { /* keep walking */ }
+    const parent = path.dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  return start
+}
+
+function readManifest(root) {
+  try {
+    const manifest = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8'))
+    const hub = manifest.dsh && manifest.dsh.hub
+    const client = manifest.dsh && manifest.dsh.client
+    return {
+      name: typeof manifest.name === 'string' ? manifest.name : '',
+      version: typeof manifest.version === 'string' ? manifest.version : '',
+      description: typeof manifest.description === 'string' ? manifest.description : '',
+      summary: hub && typeof hub.summary === 'string' ? hub.summary : '',
+      license: typeof manifest.license === 'string' ? manifest.license : '',
+      homepage: typeof manifest.homepage === 'string' ? manifest.homepage : '',
+      repository: repositoryOf(manifest.repository),
+      keywords: Array.isArray(manifest.keywords) ? manifest.keywords.filter((item) => typeof item === 'string').slice(0, 12) : [],
+      engines: manifest.engines && typeof manifest.engines.dsh === 'string' ? manifest.engines.dsh : '',
+      clientPlatform: client && typeof client.platform === 'string' ? client.platform : '',
+      clientInject: client && Array.isArray(client.inject) ? client.inject.filter((item) => typeof item === 'string').slice(0, 12) : [],
+    }
+  } catch {
+    return null
+  }
+}
+
+function readLocalDocument(root) {
+  const names = ['docs/DETAIL.zh.md', 'docs/DETAIL.md', 'README.md', 'README.zh.md']
+  for (const name of names) {
+    try {
+      const text = readFileSync(path.join(root, name), 'utf8').replace(/^---[\s\S]*?---\s*/, '').trim()
+      if (text) return text.slice(0, 8000)
+    } catch { /* try the next name */ }
+  }
+  return ''
+}
+
+function repositoryOf(value) {
+  if (typeof value === 'string') return value
+  if (value && typeof value.url === 'string') return value.url
+  return ''
+}
+
+function readPackageSource(root, entryFile) {
+  const files = []
+  if (entryFile) files.push(entryFile)
+  collectJs(root, files, 0)
+  let text = ''
+  const seen = new Set()
+  for (const file of files) {
+    if (seen.has(file) || text.length >= MAX_SOURCE_BYTES) continue
+    seen.add(file)
+    try {
+      const chunk = readFileSync(file, 'utf8')
+      text += `\n${chunk.slice(0, 180_000)}`
+    } catch { /* unreadable file is skipped */ }
+  }
+  return text
+}
+
+function collectJs(dir, files, depth) {
+  if (depth > 3 || files.length >= MAX_FILES) return
+  let entries
+  try { entries = readdirSync(dir, { withFileTypes: true }) } catch { return }
+  for (const entry of entries) {
+    if (files.length >= MAX_FILES) return
+    if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) collectJs(full, files, depth + 1)
+    else if (/\.(js|mjs|cjs|ts)$/.test(entry.name)) files.push(full)
+  }
+}
+
+function readJson(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    let size = 0
+    req.on('data', (chunk) => {
+      size += chunk.length
+      if (size > 64_000) {
+        reject(new Error('Request body is too large.'))
+        req.destroy()
+        return
+      }
+      chunks.push(chunk)
+    })
+    req.on('end', () => {
+      const text = Buffer.concat(chunks).toString('utf8').trim()
+      if (!text) {
+        resolve({})
+        return
+      }
+      try { resolve(JSON.parse(text)) } catch { reject(new Error('Request body is not valid JSON.')) }
+    })
+    req.on('error', reject)
+  })
+}

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Plugin manager",
+    "description": "Browse and open plugins in the right sidebar.",
+    "detail": "docs/DETAIL.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "插件管理",
+    "description": "在右侧栏查看并打开插件。",
+    "detail": "docs/DETAIL.zh.md"
+  }
+}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "dsh-plugin-panel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Plugin manager for the DeepSeek Harness right sidebar: list installed plugins, see where each one lives, pin favourites, and open a plugin folder in Finder.",
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "catalog.js",
+    "catalog.test.mjs",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "docs",
+    "icon.svg",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "engines": {
+    "dsh": ">=0.2.2-rc.1"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "plugin-manager",
+    "sidebar",
+    "插件管理"
+  ],
+  "author": {
+    "name": "jqlong17",
+    "url": "https://github.com/jqlong17"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jqlong17/dsh-plugins-ui.git"
+  },
+  "homepage": "https://github.com/jqlong17/dsh-plugins-ui#readme",
+  "bugs": {
+    "url": "https://github.com/jqlong17/dsh-plugins-ui/issues"
+  }
+}