feat(ui): add extensions management to Config page

Add an "Extensions" tab to the Config page for managing transform
extensions in the active mode (global or project):

- GET /api/extensions lists installed extensions with their manifest
  descriptions, merged with the built-in catalog so users can see what
  is available to download.
- POST /api/extensions/install downloads a whitelisted built-in
  extension into the active mode's extensions directory.
- POST /api/extensions/open opens that directory in the user's editor,
  mirroring the skill "open in editor" affordance.

ExtensionSpec now carries the manifest description so the list can
surface it. The UI shows installed extensions with a built-in badge,
available built-ins with a Download button, and an Open-directory
action. Strings are translated across all 11 locales.
This commit is contained in:
Willie
2026-05-30 19:23:12 +08:00
parent f6c9b98562
commit f6eca1fc7d
19 changed files with 546 additions and 17 deletions
+30
View File
@@ -0,0 +1,30 @@
package install
import (
"fmt"
"path/filepath"
"slices"
)
// BuiltinExtensions lists the transform extensions bundled in the skillshare
// repo under extensions/. The dashboard offers these for one-click install so
// users don't have to copy the reference scripts by hand.
var BuiltinExtensions = []string{"md2codex", "md2gemini"}
// IsBuiltinExtension reports whether name is a known bundled extension. It
// doubles as a whitelist guard against path traversal in download requests.
func IsBuiltinExtension(name string) bool {
return slices.Contains(BuiltinExtensions, name)
}
// InstallBuiltinExtension downloads the bundled extension `name` from the
// skillshare repo (extensions/<name>) into destRoot/<name>. destRoot is the
// target extensions directory for the current mode (global or project).
func InstallBuiltinExtension(name, destRoot string) error {
if !IsBuiltinExtension(name) {
return fmt.Errorf("unknown built-in extension: %q", name)
}
dest := filepath.Join(destRoot, name)
_, err := downloadGitHubDirWithAPIBase("runkids", "skillshare", "extensions/"+name, dest, "https://api.github.com", nil, nil)
return err
}
@@ -0,0 +1,24 @@
package install
import "testing"
func TestIsBuiltinExtension(t *testing.T) {
for _, name := range BuiltinExtensions {
if !IsBuiltinExtension(name) {
t.Errorf("%q should be a built-in extension", name)
}
}
for _, bad := range []string{"", "../evil", "md2codex/..", "unknown"} {
if IsBuiltinExtension(bad) {
t.Errorf("%q must not be reported as built-in", bad)
}
}
}
// InstallBuiltinExtension must reject unknown/traversal names before any
// network access, so the whitelist guards the download path.
func TestInstallBuiltinExtension_RejectsUnknown(t *testing.T) {
if err := InstallBuiltinExtension("../../etc", t.TempDir()); err == nil {
t.Fatal("expected error for unknown/traversal extension name")
}
}
+134
View File
@@ -0,0 +1,134 @@
package server
import (
"encoding/json"
"fmt"
"net/http"
"os"
"os/exec"
"path/filepath"
"strings"
"time"
"skillshare/internal/install"
syncpkg "skillshare/internal/sync"
)
// extensionInfo is the JSON shape for one extension in the management list.
type extensionInfo struct {
Name string `json:"name"`
Description string `json:"description,omitempty"`
Builtin bool `json:"builtin"`
Installed bool `json:"installed"`
}
// extensionsDir returns the transform-extensions directory for the current
// mode (~/.config/skillshare/extensions globally, .skillshare/extensions in
// project mode).
func (s *Server) extensionsDir() string {
return filepath.Join(filepath.Dir(s.configPath()), "extensions")
}
// handleExtensionsList — GET /api/extensions
// Lists installed extensions (with descriptions) merged with the built-in
// catalog, so the UI can show what's installed and what's available to install.
func (s *Server) handleExtensionsList(w http.ResponseWriter, r *http.Request) {
dir := s.extensionsDir()
names, err := syncpkg.ListExtensions(dir)
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
return
}
infos := make([]extensionInfo, 0, len(names))
seen := make(map[string]bool, len(names))
for _, name := range names {
info := extensionInfo{Name: name, Builtin: install.IsBuiltinExtension(name), Installed: true}
if spec, derr := syncpkg.LoadExtensionSpec(filepath.Join(dir, name), name); derr == nil {
info.Description = spec.Description
}
infos = append(infos, info)
seen[name] = true
}
// Append built-ins that aren't installed yet (available to download).
for _, name := range install.BuiltinExtensions {
if !seen[name] {
infos = append(infos, extensionInfo{Name: name, Builtin: true, Installed: false})
}
}
writeJSON(w, map[string]any{"extensions": infos})
}
// handleExtensionsInstall — POST /api/extensions/install {"name": "md2codex"}
// Downloads a built-in extension into the current mode's extensions directory.
func (s *Server) handleExtensionsInstall(w http.ResponseWriter, r *http.Request) {
start := time.Now()
var body struct {
Name string `json:"name"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
writeError(w, http.StatusBadRequest, "invalid JSON body")
return
}
if !install.IsBuiltinExtension(body.Name) {
writeError(w, http.StatusBadRequest, "unknown built-in extension: "+body.Name)
return
}
dir := s.extensionsDir()
if err := install.InstallBuiltinExtension(body.Name, dir); err != nil {
writeError(w, http.StatusInternalServerError, "failed to install extension: "+err.Error())
return
}
s.writeOpsLog("extensions-install", "ok", start, map[string]any{
"name": body.Name,
"scope": "ui",
}, "")
writeJSON(w, map[string]any{"success": true, "name": body.Name})
}
// handleExtensionsOpen — POST /api/extensions/open
// Opens the current mode's extensions directory in the user's editor, mirroring
// the skill "open in editor" affordance.
func (s *Server) handleExtensionsOpen(w http.ResponseWriter, r *http.Request) {
start := time.Now()
if os.Getenv("SKILLSHARE_HEADLESS") == "1" {
writeError(w, http.StatusConflict, "refusing to launch editor: SKILLSHARE_HEADLESS=1")
return
}
var req openInEditorRequest
if r.Body != nil {
_ = json.NewDecoder(r.Body).Decode(&req)
}
dir := s.extensionsDir()
if err := os.MkdirAll(dir, 0755); err != nil {
writeError(w, http.StatusInternalServerError, "failed to create extensions dir: "+err.Error())
return
}
editor, picked, err := pickEditor(strings.TrimSpace(req.Editor))
if err != nil {
writeError(w, http.StatusConflict, "no editor available: "+err.Error())
return
}
cmd := exec.Command(editor.bin, append(editor.args, dir)...) //nolint:gosec // editor choice is explicit
cmd.Stdin, cmd.Stdout, cmd.Stderr = nil, nil, nil
if err := cmd.Start(); err != nil {
writeError(w, http.StatusInternalServerError, fmt.Sprintf("failed to launch %s: %s", editor.bin, err))
return
}
go func() { _ = cmd.Wait() }()
s.writeOpsLog("extensions-open", "ok", start, map[string]any{
"editor": picked,
"path": dir,
"scope": "ui",
}, "")
writeJSON(w, openInEditorResponse{Editor: picked, Path: dir, PID: cmd.Process.Pid})
}
@@ -0,0 +1,94 @@
package server
import (
"encoding/json"
"net/http"
"net/http/httptest"
"os"
"path/filepath"
"strings"
"testing"
"skillshare/internal/config"
)
// writeExtensionWithDescription creates a directory-form extension carrying a
// description, so the management list can surface it.
func writeExtensionWithDescription(t *testing.T, dir, name, description string) {
t.Helper()
extDir := filepath.Join(dir, name)
if err := os.MkdirAll(extDir, 0755); err != nil {
t.Fatal(err)
}
manifest := "run: [\"cat\"]\noutput_ext: toml\ndescription: " + description + "\n"
if err := os.WriteFile(filepath.Join(extDir, "extension.yaml"), []byte(manifest), 0644); err != nil {
t.Fatal(err)
}
}
// TestHandleExtensionsList verifies GET /api/extensions merges installed
// extensions (with descriptions and a builtin flag) with the built-in catalog
// entries that are not yet installed.
func TestHandleExtensionsList(t *testing.T) {
s, _ := newTestServerWithExtras(t, nil, "")
extRoot := filepath.Join(filepath.Dir(config.ConfigPath()), "extensions")
// One installed built-in (md2codex) and one installed local extension.
writeExtensionWithDescription(t, extRoot, "md2codex", "Markdown to Codex")
writeExtensionWithDescription(t, extRoot, "my-local", "Local transform")
req := httptest.NewRequest(http.MethodGet, "/api/extensions", nil)
rr := httptest.NewRecorder()
s.handler.ServeHTTP(rr, req)
if rr.Code != http.StatusOK {
t.Fatalf("expected 200, got %d: %s", rr.Code, rr.Body.String())
}
var resp struct {
Extensions []extensionInfo `json:"extensions"`
}
if err := json.Unmarshal(rr.Body.Bytes(), &resp); err != nil {
t.Fatalf("parse: %v", err)
}
byName := make(map[string]extensionInfo, len(resp.Extensions))
for _, e := range resp.Extensions {
byName[e.Name] = e
}
// Installed built-in: installed + builtin + description.
if got, ok := byName["md2codex"]; !ok {
t.Error("md2codex missing from list")
} else if !got.Installed || !got.Builtin || got.Description != "Markdown to Codex" {
t.Errorf("md2codex = %+v, want installed builtin with description", got)
}
// Installed local extension: installed, NOT builtin.
if got, ok := byName["my-local"]; !ok {
t.Error("my-local missing from list")
} else if !got.Installed || got.Builtin {
t.Errorf("my-local = %+v, want installed non-builtin", got)
}
// Built-in not installed yet (md2gemini): available to download.
if got, ok := byName["md2gemini"]; !ok {
t.Error("md2gemini missing from list (should appear as available built-in)")
} else if got.Installed || !got.Builtin {
t.Errorf("md2gemini = %+v, want builtin and not installed", got)
}
}
// TestHandleExtensionsInstall_RejectsUnknown verifies the install endpoint
// only accepts whitelisted built-in extension names.
func TestHandleExtensionsInstall_RejectsUnknown(t *testing.T) {
s, _ := newTestServerWithExtras(t, nil, "")
req := httptest.NewRequest(http.MethodPost, "/api/extensions/install",
strings.NewReader(`{"name":"../etc/passwd"}`))
rr := httptest.NewRecorder()
s.handler.ServeHTTP(rr, req)
if rr.Code != http.StatusBadRequest {
t.Fatalf("expected 400 for unknown extension, got %d: %s", rr.Code, rr.Body.String())
}
}
+5
View File
@@ -459,6 +459,11 @@ func (s *Server) registerRoutes() {
s.mux.HandleFunc("PATCH /api/extras/{name}/mode", s.handleExtrasMode)
s.mux.HandleFunc("DELETE /api/extras/{name}", s.handleExtrasDelete)
// Extensions (transform extensions management)
s.mux.HandleFunc("GET /api/extensions", s.handleExtensionsList)
s.mux.HandleFunc("POST /api/extensions/install", s.handleExtensionsInstall)
s.mux.HandleFunc("POST /api/extensions/open", s.handleExtensionsOpen)
// Git
s.mux.HandleFunc("GET /api/git/status", s.handleGitStatus)
s.mux.HandleFunc("POST /api/git/root", s.handleSetGitRoot)
+12 -10
View File
@@ -14,11 +14,12 @@ import (
// ExtensionSpec describes a resolved transform extension applied to a target.
type ExtensionSpec struct {
Run []string // explicit argv, e.g. ["python", "convert.py"]
OutputExt string // output extension without dot, e.g. "toml"; empty = keep source ext
Dir string // working directory for the subprocess
Name string // display / oplog name
Source string // resolved exec path (file or dir), for trust pinning
Run []string // explicit argv, e.g. ["python", "convert.py"]
OutputExt string // output extension without dot, e.g. "toml"; empty = keep source ext
Dir string // working directory for the subprocess
Name string // display / oplog name
Source string // resolved exec path (file or dir), for trust pinning
Description string // human-readable description from extension.yaml (dir form only)
}
// extensionManifest mirrors the on-disk extension.yaml shape.
@@ -49,11 +50,12 @@ func LoadExtensionSpec(execPath, name string) (*ExtensionSpec, error) {
return nil, fmt.Errorf("extension %q: extension.yaml is missing 'run'", name)
}
return &ExtensionSpec{
Run: m.Run,
OutputExt: strings.TrimPrefix(m.OutputExt, "."),
Dir: execPath,
Name: name,
Source: execPath,
Run: m.Run,
OutputExt: strings.TrimPrefix(m.OutputExt, "."),
Dir: execPath,
Name: name,
Source: execPath,
Description: m.Description,
}, nil
}
// Single-file executable: exec directly (shebang on Unix); keep source extension.
+19
View File
@@ -158,6 +158,13 @@ export interface Extra {
targets: ExtraTarget[];
}
export interface ExtensionInfo {
name: string;
description?: string;
builtin: boolean;
installed: boolean;
}
export interface ExtraDiffItem {
action: string; // "create" | "update" | "prune"
file: string;
@@ -527,6 +534,18 @@ export const api = {
deleteExtra: (name: string) =>
apiFetch<{ success: boolean }>(`/extras/${encodeURIComponent(name)}`, { method: 'DELETE' }),
listExtraExtensions: () => apiFetch<{ extensions: string[] }>('/extras/extensions'),
// Extensions management (Config page)
listExtensions: () => apiFetch<{ extensions: ExtensionInfo[] }>('/extensions'),
installExtension: (name: string) =>
apiFetch<{ success: boolean; name: string }>('/extensions/install', {
method: 'POST',
body: JSON.stringify({ name }),
}),
openExtensionsDir: (editor?: string) =>
apiFetch<{ editor: string; path: string; pid: number }>('/extensions/open', {
method: 'POST',
body: JSON.stringify(editor ? { editor } : {}),
}),
// extension: undefined = leave unchanged; '' = clear; name = set (forces copy mode)
setExtraMode: (name: string, target: string, mode: string, flatten?: boolean, extension?: string) =>
apiFetch<{ success: boolean }>(`/extras/${encodeURIComponent(name)}/mode`, {
+9
View File
@@ -284,6 +284,15 @@
"config.save": "Speichern",
"config.saving": "Wird gespeichert...",
"config.skillignore.savedSuccess": ".skillignore erfolgreich gespeichert.",
"config.extensions.openDir": "Verzeichnis öffnen",
"config.extensions.description": "Transform-Extensions konvertieren Quelldateien beim Synchronisieren in ein Zielformat (z. B. Markdown-Agents in Codex-TOML). Installiere eine und wähle sie dann an einem Extras-Ziel aus.",
"config.extensions.loading": "Wird geladen…",
"config.extensions.installedHeading": "Installiert",
"config.extensions.none": "Noch keine Extensions installiert.",
"config.extensions.available": "Verfügbare integrierte Extensions",
"config.extensions.download": "Herunterladen",
"config.extensions.toast.installed": "{name} installiert",
"config.extensions.toast.opened": "In {editor} geöffnet",
"config.subtitle.global": "Deine skillshare-Konfiguration bearbeiten",
"config.subtitle.project": "Deine Projektkonfiguration bearbeiten",
"config.title": "Konfiguration",
+9
View File
@@ -184,6 +184,15 @@
"config.save": "Save",
"config.saving": "Saving...",
"config.skillignore.savedSuccess": ".skillignore saved successfully.",
"config.extensions.openDir": "Open directory",
"config.extensions.description": "Transform extensions convert source files to a target format during sync (e.g. markdown agents to Codex TOML). Install one, then select it on an Extras target.",
"config.extensions.loading": "Loading…",
"config.extensions.installedHeading": "Installed",
"config.extensions.none": "No extensions installed yet.",
"config.extensions.available": "Available built-ins",
"config.extensions.download": "Download",
"config.extensions.toast.installed": "Installed {name}",
"config.extensions.toast.opened": "Opened in {editor}",
"config.subtitle.global": "Edit your skillshare configuration",
"config.subtitle.project": "Edit your project configuration",
"config.title": "Config",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "Guardar",
"config.saving": "Guardando...",
"config.skillignore.savedSuccess": ".skillignore guardado correctamente.",
"config.extensions.openDir": "Abrir directorio",
"config.extensions.description": "Las extensions de transformación convierten los archivos de origen a un formato de destino durante la sincronización (p. ej., agents de markdown a TOML de Codex). Instala una y luego selecciónala en un destino de Extras.",
"config.extensions.loading": "Cargando…",
"config.extensions.installedHeading": "Instaladas",
"config.extensions.none": "Aún no hay extensions instaladas.",
"config.extensions.available": "Extensions integradas disponibles",
"config.extensions.download": "Descargar",
"config.extensions.toast.installed": "{name} instalada",
"config.extensions.toast.opened": "Abierto en {editor}",
"config.subtitle.global": "Edita tu configuración de skillshare",
"config.subtitle.project": "Edita la configuración de tu proyecto",
"config.title": "Configuración",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "ذخیره",
"config.saving": "در حال ذخیره...",
"config.skillignore.savedSuccess": "فایل .skillignore با موفقیت ذخیره شد.",
"config.extensions.openDir": "باز کردن پوشه",
"config.extensions.description": "Transform extension‌ها هنگام همگام‌سازی فایل‌های مبدأ را به قالب مقصد تبدیل می‌کنند (مثلاً markdown agents به Codex TOML). یکی را نصب کنید و سپس آن را روی یک مقصد Extras انتخاب کنید.",
"config.extensions.loading": "در حال بارگذاری…",
"config.extensions.installedHeading": "نصب‌شده",
"config.extensions.none": "هنوز هیچ extension نصب نشده است.",
"config.extensions.available": "extension‌های داخلی موجود",
"config.extensions.download": "دانلود",
"config.extensions.toast.installed": "{name} نصب شد",
"config.extensions.toast.opened": "در {editor} باز شد",
"config.subtitle.global": "پیکربندی skillshare خود را ویرایش کنید",
"config.subtitle.project": "پیکربندی پروژه خود را ویرایش کنید",
"config.title": "پیکربندی",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "Enregistrer",
"config.saving": "Enregistrement...",
"config.skillignore.savedSuccess": ".skillignore enregistré avec succès.",
"config.extensions.openDir": "Ouvrir le répertoire",
"config.extensions.description": "Les extensions de transformation convertissent les fichiers source vers un format cible lors de la synchronisation (par ex. des agents markdown en TOML Codex). Installez-en une, puis sélectionnez-la sur une cible Extras.",
"config.extensions.loading": "Chargement…",
"config.extensions.installedHeading": "Installées",
"config.extensions.none": "Aucune extension installée pour l'instant.",
"config.extensions.available": "Extensions intégrées disponibles",
"config.extensions.download": "Télécharger",
"config.extensions.toast.installed": "{name} installée",
"config.extensions.toast.opened": "Ouvert dans {editor}",
"config.subtitle.global": "Modifier votre configuration skillshare",
"config.subtitle.project": "Modifier la configuration de votre projet",
"config.title": "Configuration",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "Simpan",
"config.saving": "Menyimpan...",
"config.skillignore.savedSuccess": ".skillignore berhasil disimpan.",
"config.extensions.openDir": "Buka direktori",
"config.extensions.description": "Transform extension mengonversi file sumber ke format target saat sinkronisasi (mis. markdown agents ke Codex TOML). Pasang satu, lalu pilih pada target Extras.",
"config.extensions.loading": "Memuat…",
"config.extensions.installedHeading": "Terpasang",
"config.extensions.none": "Belum ada extension yang terpasang.",
"config.extensions.available": "Extension bawaan yang tersedia",
"config.extensions.download": "Unduh",
"config.extensions.toast.installed": "{name} terpasang",
"config.extensions.toast.opened": "Dibuka di {editor}",
"config.subtitle.global": "Edit konfigurasi skillshare Anda",
"config.subtitle.project": "Edit konfigurasi proyek Anda",
"config.title": "Konfigurasi",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "保存",
"config.saving": "保存中...",
"config.skillignore.savedSuccess": ".skillignore を保存しました。",
"config.extensions.openDir": "ディレクトリを開く",
"config.extensions.description": "Transform extension は同期時にソースファイルをターゲット形式に変換します(例:markdown agents を Codex TOML へ)。インストール後、Extras のターゲットで選択できます。",
"config.extensions.loading": "読み込み中…",
"config.extensions.installedHeading": "インストール済み",
"config.extensions.none": "extension はまだインストールされていません。",
"config.extensions.available": "利用可能な組み込み extension",
"config.extensions.download": "ダウンロード",
"config.extensions.toast.installed": "{name} をインストールしました",
"config.extensions.toast.opened": "{editor} で開きました",
"config.subtitle.global": "skillshare の設定を編集します",
"config.subtitle.project": "プロジェクトの設定を編集します",
"config.title": "設定",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "저장",
"config.saving": "저장 중...",
"config.skillignore.savedSuccess": ".skillignore가 성공적으로 저장되었습니다.",
"config.extensions.openDir": "디렉터리 열기",
"config.extensions.description": "Transform extension은 동기화 시 소스 파일을 대상 형식으로 변환합니다(예: markdown agents를 Codex TOML로). 설치한 후 Extras 대상에서 선택할 수 있습니다.",
"config.extensions.loading": "불러오는 중…",
"config.extensions.installedHeading": "설치됨",
"config.extensions.none": "아직 설치된 extension이 없습니다.",
"config.extensions.available": "사용 가능한 기본 제공 extension",
"config.extensions.download": "다운로드",
"config.extensions.toast.installed": "{name} 설치 완료",
"config.extensions.toast.opened": "{editor}에서 열었습니다",
"config.subtitle.global": "skillshare 설정 편집",
"config.subtitle.project": "프로젝트 설정 편집",
"config.title": "설정",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "Salvar",
"config.saving": "Salvando...",
"config.skillignore.savedSuccess": ".skillignore salvo com sucesso.",
"config.extensions.openDir": "Abrir diretório",
"config.extensions.description": "As extensions de transformação convertem os arquivos de origem para um formato de destino durante a sincronização (por exemplo, agents de markdown para TOML do Codex). Instale uma e selecione-a em um destino de Extras.",
"config.extensions.loading": "Carregando…",
"config.extensions.installedHeading": "Instaladas",
"config.extensions.none": "Nenhuma extension instalada ainda.",
"config.extensions.available": "Extensions integradas disponíveis",
"config.extensions.download": "Baixar",
"config.extensions.toast.installed": "{name} instalada",
"config.extensions.toast.opened": "Aberto no {editor}",
"config.subtitle.global": "Editar sua configuração do skillshare",
"config.subtitle.project": "Editar a configuração do seu projeto",
"config.title": "Configuração",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "保存",
"config.saving": "保存中...",
"config.skillignore.savedSuccess": ".skillignore 保存成功。",
"config.extensions.openDir": "打开目录",
"config.extensions.description": "Transform extension 会在同步时把源文件转换成目标格式(例如把 markdown agents 转成 Codex TOML)。安装后即可在 Extras 目标上选用。",
"config.extensions.loading": "加载中…",
"config.extensions.installedHeading": "已安装",
"config.extensions.none": "尚未安装任何 extension。",
"config.extensions.available": "可用的内置 extension",
"config.extensions.download": "下载",
"config.extensions.toast.installed": "已安装 {name}",
"config.extensions.toast.opened": "已在 {editor} 中打开",
"config.subtitle.global": "编辑你的 skillshare 配置",
"config.subtitle.project": "编辑你的项目配置",
"config.title": "配置",
+9
View File
@@ -284,6 +284,15 @@
"config.save": "儲存",
"config.saving": "儲存中…",
"config.skillignore.savedSuccess": ".skillignore 已成功儲存。",
"config.extensions.openDir": "開啟目錄",
"config.extensions.description": "Transform extension 會在同步時把來源檔案轉換成目標格式(例如把 markdown agents 轉成 Codex TOML)。安裝後即可在 Extras 目標上選用。",
"config.extensions.loading": "載入中…",
"config.extensions.installedHeading": "已安裝",
"config.extensions.none": "尚未安裝任何 extension。",
"config.extensions.available": "可用的內建 extension",
"config.extensions.download": "下載",
"config.extensions.toast.installed": "已安裝 {name}",
"config.extensions.toast.opened": "已在 {editor} 中開啟",
"config.subtitle.global": "編輯你的 skillshare 設定",
"config.subtitle.project": "編輯你的專案設定",
"config.title": "設定檔",
+129 -7
View File
@@ -1,5 +1,5 @@
import { useState, useEffect, useMemo, useRef, useCallback } from 'react';
import { Save, FileCode, Settings, EyeOff, RefreshCw, PanelRightOpen } from 'lucide-react';
import { Save, FileCode, Settings, EyeOff, RefreshCw, PanelRightOpen, Puzzle, FolderOpen, Download } from 'lucide-react';
import { useT } from '../i18n';
import CodeMirror from '@uiw/react-codemirror';
import { yaml } from '@codemirror/lang-yaml';
@@ -26,7 +26,7 @@ import { useAppContext } from '../context/AppContext';
import { handTheme } from '../lib/codemirror-theme';
import SyncPreviewModal from '../components/SyncPreviewModal';
type ConfigTab = 'config' | 'skillignore' | 'agentignore';
type ConfigTab = 'config' | 'skillignore' | 'agentignore' | 'extensions';
export default function ConfigPage() {
const t = useT();
@@ -236,9 +236,9 @@ export default function ConfigPage() {
};
// --- active tab dirty/saving state ---
const activeDirty = tab === 'config' ? dirty : tab === 'skillignore' ? ignoreDirty : agentIgnoreDirty;
const activeSaving = tab === 'config' ? saving : tab === 'skillignore' ? ignoreSaving : agentIgnoreSaving;
const handleSave = tab === 'config' ? handleConfigSave : tab === 'skillignore' ? handleIgnoreSave : handleAgentIgnoreSave;
const activeDirty = tab === 'config' ? dirty : tab === 'skillignore' ? ignoreDirty : tab === 'agentignore' ? agentIgnoreDirty : false;
const activeSaving = tab === 'config' ? saving : tab === 'skillignore' ? ignoreSaving : tab === 'agentignore' ? agentIgnoreSaving : false;
const handleSave = tab === 'config' ? handleConfigSave : tab === 'skillignore' ? handleIgnoreSave : tab === 'agentignore' ? handleAgentIgnoreSave : () => {};
saveRef.current = handleSave;
// --- panel toggle + Cmd+B ---
@@ -290,8 +290,8 @@ export default function ConfigPage() {
};
// --- loading / error for active tab ---
const isPending = tab === 'config' ? configPending : tab === 'skillignore' ? ignorePending : agentIgnorePending;
const error = tab === 'config' ? configError : tab === 'skillignore' ? ignoreError : agentIgnoreError;
const isPending = tab === 'config' ? configPending : tab === 'skillignore' ? ignorePending : tab === 'agentignore' ? agentIgnorePending : false;
const error = tab === 'config' ? configError : tab === 'skillignore' ? ignoreError : tab === 'agentignore' ? agentIgnoreError : null;
if (isPending) return <PageSkeleton />;
if (error) {
@@ -342,6 +342,7 @@ export default function ConfigPage() {
{ value: 'config' as ConfigTab, label: 'config.yaml' },
{ value: 'skillignore' as ConfigTab, label: '.skillignore' },
{ value: 'agentignore' as ConfigTab, label: '.agentignore' },
{ value: 'extensions' as ConfigTab, label: 'Extensions' },
]}
/>
</div>
@@ -524,6 +525,8 @@ export default function ConfigPage() {
</div>
)}
{tab === 'extensions' && <ExtensionsSection isProjectMode={isProjectMode} />}
<SyncPreviewModal
open={showSyncPreview}
onClose={() => setShowSyncPreview(false)}
@@ -629,3 +632,122 @@ function IgnoreTab({
</div>
);
}
// ─── ExtensionsSection ──────────────────────────────────────────────────────
// Manage transform extensions for the current mode: list installed ones,
// download bundled built-ins, and open the extensions directory in an editor.
function ExtensionsSection({ isProjectMode }: { isProjectMode: boolean }) {
const t = useT();
const { toast } = useToast();
const queryClient = useQueryClient();
const [installing, setInstalling] = useState<string | null>(null);
const [opening, setOpening] = useState(false);
const { data, isPending } = useQuery({
queryKey: ['extensions'],
queryFn: () => api.listExtensions(),
staleTime: staleTimes.extras,
});
const extensions = data?.extensions ?? [];
const installed = extensions.filter((e) => e.installed);
const available = extensions.filter((e) => !e.installed);
const dirLabel = isProjectMode ? '.skillshare/extensions' : '~/.config/skillshare/extensions';
const handleInstall = async (name: string) => {
setInstalling(name);
try {
await api.installExtension(name);
toast(t('config.extensions.toast.installed', { name }, `Installed ${name}`), 'success');
queryClient.invalidateQueries({ queryKey: ['extensions'] });
queryClient.invalidateQueries({ queryKey: ['extras', 'extensions'] });
} catch (err: any) {
toast(err.message, 'error');
} finally {
setInstalling(null);
}
};
const handleOpenDir = async () => {
setOpening(true);
try {
const res = await api.openExtensionsDir();
toast(t('config.extensions.toast.opened', { editor: res.editor }, `Opened in ${res.editor}`), 'success');
} catch (err: any) {
toast(err.message, 'error');
} finally {
setOpening(false);
}
};
return (
<Card>
<div className="flex items-center justify-between gap-4 mb-3">
<div className="flex items-center gap-2 min-w-0">
<Puzzle size={16} strokeWidth={2.5} className="text-blue shrink-0" />
<span className="font-bold text-pencil">Extensions</span>
<span className="text-xs text-pencil-light font-mono truncate">({dirLabel})</span>
</div>
<Button variant="secondary" size="sm" onClick={handleOpenDir} loading={opening}>
<FolderOpen size={14} strokeWidth={2.5} />
{t('config.extensions.openDir', {}, 'Open directory')}
</Button>
</div>
<p className="text-sm text-pencil-light mb-4">
{t('config.extensions.description', {}, 'Transform extensions convert source files to a target format during sync (e.g. markdown agents to Codex TOML). Install one, then select it on an Extras target.')}
</p>
{isPending ? (
<p className="text-sm text-pencil-light italic">{t('config.extensions.loading', {}, 'Loading...')}</p>
) : (
<div className="space-y-4">
<div>
<div className="text-xs text-pencil-light uppercase tracking-wider mb-2">
{t('config.extensions.installedHeading', {}, 'Installed')} ({installed.length})
</div>
{installed.length > 0 ? (
<div className="space-y-1.5">
{installed.map((e) => (
<div key={e.name} className="flex items-center gap-2">
<span className="font-mono text-sm text-pencil">{e.name}</span>
{e.builtin && (
<span className="text-[10px] uppercase tracking-wider text-blue border border-blue/40 rounded px-1 py-0.5">built-in</span>
)}
{e.description && <span className="text-sm text-pencil-light truncate">— {e.description}</span>}
</div>
))}
</div>
) : (
<p className="text-sm text-pencil-light italic">{t('config.extensions.none', {}, 'No extensions installed yet.')}</p>
)}
</div>
{available.length > 0 && (
<div>
<div className="text-xs text-pencil-light uppercase tracking-wider mb-2">
{t('config.extensions.available', {}, 'Available built-ins')}
</div>
<div className="space-y-1.5">
{available.map((e) => (
<div key={e.name} className="flex items-center gap-3">
<span className="font-mono text-sm text-pencil">{e.name}</span>
<span className="flex-1" />
<Button
variant="secondary"
size="sm"
onClick={() => handleInstall(e.name)}
loading={installing === e.name}
>
<Download size={14} strokeWidth={2.5} />
{t('config.extensions.download', {}, 'Download')}
</Button>
</div>
))}
</div>
</div>
)}
</div>
)}
</Card>
);
}