@chatcode/cco-market 1.45.1

package/src/skill-market/tui.ts

@@ -0,0 +1,157 @@
+import type React from 'react'
+import type { Context } from '@deepseek-ai/cordis'
+import type { SkillMarketRuntime } from './runtime.ts'
+import type { SkillInstallLocation, SkillMarketItem } from './types.ts'
+
+interface SceneProps {
+  readonly React: typeof React
+  readonly ui: {
+    readonly Box: React.ComponentType<Record<string, unknown>>
+    readonly Text: React.ComponentType<Record<string, unknown>>
+    useInput(handler: (input: string, key: { upArrow?: boolean; downArrow?: boolean; leftArrow?: boolean; rightArrow?: boolean; return?: boolean; escape?: boolean; backspace?: boolean }) => void): void
+  }
+  readonly channel: { readonly cwd: string }
+  close(): void
+}
+
+interface TuiSkillMarketContext extends Context {
+  readonly commands: {
+    register(definition: {
+      readonly name: string
+      readonly description: string
+      readonly recordInput: boolean
+      readonly handler: (invocation: { readonly rawInput: string }) => Promise<{ kind: 'success' } | { kind: 'error'; text: string }>
+    }): () => void
+  }
+  readonly tuiScenes: {
+    register(descriptor: { readonly id: string; readonly title: string; readonly component: React.ComponentType<SceneProps> }, identity?: Context): () => void
+    open(id: string): boolean
+  }
+}
+
+/** Register `/skill-market` and its full-screen terminal scene together. */
+export function installSkillMarketTui(ctx: Context, runtime: SkillMarketRuntime): void {
+  ctx.inject(['commands', 'tuiScenes'], (scopedContext: Context) => {
+    const scoped = scopedContext as TuiSkillMarketContext
+    scoped.effect(() => {
+      const scene = createSkillMarketScene(runtime)
+      const disposeScene = scoped.tuiScenes.register({ id: 'skill-market', title: '技能市场', component: scene }, scoped)
+      const disposeCommand = scoped.commands.register({
+        name: 'skill-market',
+        description: '浏览并安装技能市场中的技能',
+        recordInput: false,
+        handler: async ({ rawInput }) => {
+          if (rawInput.trim().length > 0) return { kind: 'error', text: '用法：/skill-market' }
+          if (!scoped.tuiScenes.open('skill-market')) return { kind: 'error', text: '技能市场界面当前不可用' }
+          return { kind: 'success' }
+        },
+      })
+      return () => {
+        disposeCommand()
+        disposeScene()
+      }
+    }, 'dsh-market: skill market terminal scene')
+  })
+}
+
+function createSkillMarketScene(runtime: SkillMarketRuntime): React.ComponentType<SceneProps> {
+  return function SkillMarketScene({ React: HostReact, ui, channel, close }: SceneProps) {
+    const { Box, Text } = ui
+    const [items, setItems] = HostReact.useState<readonly SkillMarketItem[]>([])
+    const [query, setQuery] = HostReact.useState('')
+    const [selected, setSelected] = HostReact.useState(0)
+    const [page, setPage] = HostReact.useState(1)
+    const [total, setTotal] = HostReact.useState(0)
+    const [installedNames, setInstalledNames] = HostReact.useState<ReadonlySet<string>>(() => new Set())
+    const [loading, setLoading] = HostReact.useState(true)
+    const [error, setError] = HostReact.useState<string | undefined>()
+    const [location, setLocation] = HostReact.useState<SkillInstallLocation | undefined>()
+    const [installing, setInstalling] = HostReact.useState(false)
+    const [notice, setNotice] = HostReact.useState<string | undefined>()
+
+    const loadPage = HostReact.useCallback(async (nextPage: number, search: string) => {
+      setLoading(true)
+      setError(undefined)
+      try {
+        const [result, installed] = await Promise.all([
+          runtime.api.list({ page: nextPage, pageSize: 10, search: search || undefined, sort: 'latest' }),
+          runtime.installer.installed(channel.cwd),
+        ])
+        setItems(result.items)
+        setTotal(result.total)
+        setInstalledNames(new Set(installed.map(entry => entry.name)))
+        setSelected(0)
+      } catch (cause) {
+        setError(cause instanceof Error ? cause.message : String(cause))
+      } finally {
+        setLoading(false)
+      }
+    }, [channel.cwd])
+
+    HostReact.useEffect(() => {
+      const timer = setTimeout(() => { void loadPage(page, query) }, 250)
+      return () => clearTimeout(timer)
+    }, [loadPage, page, query])
+
+    ui.useInput((input, key) => {
+      if (installing) return
+      if (key.escape) {
+        if (location !== undefined) setLocation(undefined)
+        else close()
+        return
+      }
+      const item = items[selected]
+      if (location !== undefined) {
+        if ((input === 'p' || input === 'u') && item !== undefined) {
+          const chosen: SkillInstallLocation = input === 'p' ? 'project' : 'user'
+          setInstalling(true)
+          setNotice(undefined)
+          void runtime.installer.install({ id: item.id, name: item.name, version: item.version, location: chosen, cwd: channel.cwd })
+            .then(result => {
+              setInstalledNames(current => new Set(current).add(item.name))
+              setNotice(`已安装到 ${result.installPath}`)
+            })
+            .catch(cause => setError(cause instanceof Error ? cause.message : String(cause)))
+            .finally(() => { setInstalling(false); setLocation(undefined) })
+        }
+        return
+      }
+      if (key.upArrow) setSelected(index => Math.max(0, index - 1))
+      else if (key.downArrow) setSelected(index => Math.min(items.length - 1, index + 1))
+      else if (key.leftArrow && page > 1) setPage(value => value - 1)
+      else if (key.rightArrow && page * 10 < total) setPage(value => value + 1)
+      else if (key.return && item !== undefined) setLocation('project')
+      else if (key.backspace) { setPage(1); setQuery(value => value.slice(0, -1)) }
+      else if (input.length === 1 && !/[\u0000-\u001f\u007f]/u.test(input)) { setPage(1); setQuery(value => value + input) }
+    })
+
+    const h = HostReact.createElement
+    const item = items[selected]
+    const pages = Math.max(1, Math.ceil(total / 10))
+    return h(Box, { flexDirection: 'column', paddingX: 1, paddingY: 1 },
+      h(Text, { bold: true, color: 'cyan' }, '技能市场'),
+      h(Text, { dimColor: true }, `搜索：${query || '（直接输入关键词）'}  第 ${page}/${pages} 页，共 ${total} 个技能`),
+      h(Text, { dimColor: true }, '↑↓ 选择 · ←→ 翻页 · Enter 安装 · Esc 返回'),
+      h(Box, { marginTop: 1, flexDirection: 'column' },
+        loading ? h(Text, { color: 'yellow' }, '正在加载…') : null,
+        error ? h(Text, { color: 'red' }, `错误：${error}`) : null,
+        !loading && error === undefined && items.length === 0 ? h(Text, { dimColor: true }, '没有找到技能') : null,
+        ...items.map((entry, index) => h(Text, {
+          key: String(entry.id),
+          bold: index === selected,
+          color: index === selected ? 'cyan' : undefined,
+        }, `${index === selected ? '▸' : ' '} ${entry.name}  ${entry.version ? `v${entry.version}` : ''}${installedNames.has(entry.name) ? '  [已安装]' : ''}`)),
+      ),
+      item === undefined ? null : h(Box, { marginTop: 1, flexDirection: 'column' },
+        h(Text, { bold: true }, `${item.name}${item.author || item.creatorName ? ` · ${item.author || item.creatorName}` : ''}`),
+        h(Text, { dimColor: true }, item.description || '暂无简介'),
+      ),
+      location === undefined ? null : h(Box, { marginTop: 1, flexDirection: 'column' },
+        h(Text, { color: 'yellow' }, `安装 ${item?.name ?? ''}`),
+        h(Text, null, '按 P 安装到当前项目 .chatcode-cli/skills，按 U 安装到个人 CHATCODE_CLI_HOME/skills，Esc 取消'),
+      ),
+      installing ? h(Text, { color: 'yellow' }, '正在下载并验证技能包…') : null,
+      notice ? h(Text, { color: 'green' }, notice) : null,
+    )
+  }
+}

package/src/skill-market/types.ts

@@ -0,0 +1,80 @@
+/** Sort orders accepted by the public skill catalog. */
+export type SkillSort = 'latest' | 'downloads' | 'name'
+
+/** Supported installation scopes. */
+export type SkillInstallLocation = 'project' | 'user'
+
+/** One skill returned by the public catalog. */
+export interface SkillMarketItem {
+  readonly id: number
+  readonly name: string
+  readonly description: string
+  readonly category: string
+  readonly status: string
+  readonly downloads: number
+  readonly views: number
+  readonly readme: string
+  readonly version: string
+  readonly author: string
+  readonly creatorName: string
+  readonly tags: string
+  readonly createTime: string
+  readonly updateTime: string
+  readonly visibility: string
+}
+
+/** Catalog list filters. */
+export interface SkillListQuery {
+  readonly search?: string
+  readonly category?: string
+  readonly sort?: SkillSort
+  readonly tag?: string
+  readonly page?: number
+  readonly pageSize?: number
+}
+
+/** One page returned by the public catalog. */
+export interface SkillListResult {
+  readonly items: readonly SkillMarketItem[]
+  readonly total: number
+  readonly page: number
+  readonly pageSize: number
+}
+
+/** Marketplace ownership metadata stored beside an installed skill. */
+export interface SkillMarketMeta {
+  readonly id: number
+  readonly name: string
+  readonly version?: string
+}
+
+/** A skill installed in one of the roots visible to the current session. */
+export interface InstalledSkill {
+  readonly name: string
+  readonly location: SkillInstallLocation
+  readonly path: string
+  readonly marketId?: number
+  readonly version?: string
+}
+
+/** Successful installation result returned to Web and terminal callers. */
+export interface SkillInstallResult {
+  readonly skillName: string
+  readonly installPath: string
+  readonly location: SkillInstallLocation
+  readonly updated: boolean
+}
+
+/** Resolved runtime configuration for the skill marketplace. */
+export interface ResolvedSkillMarketConfig {
+  readonly baseUrl: string
+  readonly requestTimeoutMs: number
+  readonly downloadTimeoutMs: number
+  readonly defaultPageSize: number
+  readonly maxDownloadBytes: number
+  readonly maxArchiveEntries: number
+  readonly maxUncompressedBytes: number
+}
+
+/** Operator overrides accepted below the plugin's `skillMarket` key. */
+export type SkillMarketConfig = Partial<ResolvedSkillMarketConfig>

package/src/skill-market/web-routes.ts

@@ -0,0 +1,132 @@
+import type { IncomingMessage, ServerResponse } from 'node:http'
+import { readJsonBody, sameOrigin, sendJson } from '../http.ts'
+import type { WebServerService } from '../routes.ts'
+import type { SkillMarketRuntime } from './runtime.ts'
+import type { SkillInstallLocation, SkillListQuery, SkillSort } from './types.ts'
+
+interface SessionLike {
+  readonly header: { readonly cwd?: string }
+}
+
+interface SkillMarketWebHost {
+  readonly webServer: WebServerService
+  readonly sessions: { get(id: string): SessionLike | undefined }
+  readonly logger?: { warn(message: string): void }
+}
+
+/** Mount local-session skill catalog and installation routes. */
+export function mountSkillMarketRoutes(host: SkillMarketWebHost, runtime: SkillMarketRuntime): () => void {
+  const routes = [
+    host.webServer.register({ kind: 'exact', path: '/dsh-market/skills', handler: async (request, response) => {
+      if (request.method !== 'GET') return methodNotAllowed(response, 'GET')
+      try {
+        const url = requestUrl(request)
+        const query: SkillListQuery = {
+          search: optionalParam(url, 'search'),
+          category: optionalParam(url, 'category'),
+          tag: optionalParam(url, 'tag'),
+          sort: sortParam(url),
+          page: integerParam(url, 'page'),
+          pageSize: integerParam(url, 'pageSize'),
+        }
+        sendJson(response, 200, await runtime.api.list(query))
+      } catch (error) {
+        sendRouteError(host, response, error)
+      }
+    } }),
+    host.webServer.register({ kind: 'exact', path: '/dsh-market/skills/installed', handler: async (request, response) => {
+      if (request.method !== 'GET') return methodNotAllowed(response, 'GET')
+      try {
+        const cwd = sessionCwd(host, requestUrl(request).searchParams.get('sessionId'))
+        sendJson(response, 200, { items: await runtime.installer.installed(cwd) })
+      } catch (error) {
+        sendRouteError(host, response, error)
+      }
+    } }),
+    host.webServer.register({ kind: 'exact', path: '/dsh-market/skills/install', handler: async (request, response) => {
+      if (request.method !== 'POST') return methodNotAllowed(response, 'POST')
+      if (!sameOrigin(request)) {
+        sendJson(response, 403, { error: 'origin rejected' })
+        return
+      }
+      try {
+        const body = installBody(await readJsonBody(request))
+        const cwd = sessionCwd(host, body.sessionId)
+        const result = await runtime.installer.install({ ...body, cwd })
+        sendJson(response, 200, result)
+      } catch (error) {
+        sendRouteError(host, response, error)
+      }
+    } }),
+  ]
+  return () => {
+    for (const dispose of routes.reverse()) dispose()
+  }
+}
+
+function requestUrl(request: IncomingMessage): URL {
+  return new URL(request.url ?? '/', `http://${request.headers.host ?? 'localhost'}`)
+}
+
+function sessionCwd(host: SkillMarketWebHost, sessionId: string | null): string {
+  if (sessionId === null || sessionId.trim().length === 0) throw new Error('请选择一个本地会话后再安装技能')
+  const session = host.sessions.get(sessionId)
+  if (session === undefined) throw new Error('会话不存在或已结束')
+  const cwd = session.header.cwd
+  if (cwd === undefined) throw new Error('该会话没有本地工作目录')
+  return cwd
+}
+
+function installBody(value: unknown): {
+  id: number
+  name: string
+  version?: string
+  location: SkillInstallLocation
+  sessionId: string
+} {
+  if (typeof value !== 'object' || value === null) throw new Error('安装请求必须是 JSON 对象')
+  const body = value as Record<string, unknown>
+  if (!Number.isSafeInteger(body.id) || (body.id as number) <= 0) throw new Error('安装请求缺少有效的技能 id')
+  if (typeof body.name !== 'string' || body.name.length === 0) throw new Error('安装请求缺少技能名称')
+  if (body.location !== 'project' && body.location !== 'user') throw new Error('安装位置必须是 project 或 user')
+  if (typeof body.sessionId !== 'string' || body.sessionId.length === 0) throw new Error('安装请求缺少 sessionId')
+  if (body.version !== undefined && typeof body.version !== 'string') throw new Error('技能版本必须是字符串')
+  return {
+    id: body.id as number,
+    name: body.name,
+    location: body.location,
+    sessionId: body.sessionId,
+    version: body.version as string | undefined,
+  }
+}
+
+function optionalParam(url: URL, name: string): string | undefined {
+  const value = url.searchParams.get(name)?.trim()
+  return value ? value : undefined
+}
+
+function integerParam(url: URL, name: string): number | undefined {
+  const value = url.searchParams.get(name)
+  if (value === null) return undefined
+  const number = Number(value)
+  if (!Number.isSafeInteger(number) || number <= 0) throw new Error(`${name} 必须是正整数`)
+  return number
+}
+
+function sortParam(url: URL): SkillSort | undefined {
+  const value = optionalParam(url, 'sort')
+  if (value === undefined) return undefined
+  if (value !== 'latest' && value !== 'downloads' && value !== 'name') throw new Error('sort 参数无效')
+  return value
+}
+
+function methodNotAllowed(response: ServerResponse, allowed: string): void {
+  response.setHeader('allow', allowed)
+  sendJson(response, 405, { error: 'method not allowed' })
+}
+
+function sendRouteError(host: SkillMarketWebHost, response: ServerResponse, error: unknown): void {
+  const message = error instanceof Error ? error.message : String(error)
+  host.logger?.warn(`[ChatCode CLI Market] skill market request failed: ${message}`)
+  sendJson(response, 400, { error: message })
+}