From 63affe976e2cdbf7b41a9c8191acff18f11d110e Mon Sep 17 00:00:00 2001 From: Willie Date: Thu, 1 Oct 2026 11:08:37 +0800 Subject: [PATCH] feat(website): promote the desktop app as the primary entry point Make the desktop app visible in the homepage, navigation, and README before CLI installation. Add localized installation guides and promotion copy across all five documentation languages, with Homebrew as the recommended macOS path. --- README-ja.md | 34 +++++-- README-ko.md | 34 +++++-- README-zh-CN.md | 34 +++++-- README-zh-TW.md | 34 +++++-- README.md | 34 +++++-- website/docs/getting-started/desktop-app.md | 45 +++++++++ website/docusaurus.config.ts | 11 ++- website/i18n/ja/code.json | 38 ++++++++ .../current/getting-started/desktop-app.md | 45 +++++++++ .../current/reference/commands/ui.md | 16 ++-- .../ja/docusaurus-theme-classic/navbar.json | 4 + website/i18n/ko/code.json | 38 ++++++++ .../current/getting-started/desktop-app.md | 45 +++++++++ .../current/reference/commands/ui.md | 4 +- .../ko/docusaurus-theme-classic/navbar.json | 4 + website/i18n/zh-Hans/code.json | 38 ++++++++ .../current/getting-started/desktop-app.md | 45 +++++++++ .../current/reference/commands/ui.md | 16 ++-- .../docusaurus-theme-classic/navbar.json | 4 + website/i18n/zh-Hant/code.json | 36 +++++++ .../current/getting-started/desktop-app.md | 45 +++++++++ .../current/reference/commands/ui.md | 16 ++-- .../docusaurus-theme-classic/navbar.json | 4 + website/sidebars.ts | 1 + website/src/css/custom.css | 15 +++ website/src/pages/index.module.css | 81 ++++++---------- website/src/pages/index.tsx | 95 ++++++++----------- 27 files changed, 642 insertions(+), 174 deletions(-) create mode 100644 website/docs/getting-started/desktop-app.md create mode 100644 website/i18n/ja/code.json create mode 100644 website/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md create mode 100644 website/i18n/ko/code.json create mode 100644 website/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md create mode 100644 website/i18n/zh-Hans/code.json create mode 100644 website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md create mode 100644 website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md diff --git a/README-ja.md b/README-ja.md index 2cfe6d99c..efb43811f 100644 --- a/README-ja.md +++ b/README-ja.md @@ -26,21 +26,17 @@

- AI CLI の skills、agents、rules、commands などを、ひとつのソースで管理。コマンドひとつですべてのツールに同期でき、個人から組織全体まで使えます。
+ AI CLI の skills、agents、rules、commands などを、ひとつのソースで管理。デスクトップアプリで操作するか、コマンドひとつですべてのツールに同期でき、個人から組織全体まで使えます。
Codex、Claude Code、OpenClaw、OpenCode など 60 以上のツールに対応。

-

- skillshare demo -

-

公式サイト • インストール • クイックスタート • 主な機能 • スクリーンショット • - デスクトップアプリ • + デスクトップアプリ • ドキュメント

@@ -105,6 +101,10 @@ skillshare はこの問題を解決します。 ## CLI と UI のプレビュー +

+ skillshare demo +

+ | Skill の詳細 | セキュリティ監査 | |---|---| | Skill の詳細 | セキュリティ監査 | @@ -115,7 +115,25 @@ skillshare はこの問題を解決します。 ## インストール -### macOS / Linux +> [!TIP] +> **デスクトップで skillshare を管理。** macOS(Apple Silicon)、Windows、Linux 向けの [Skillshare App をダウンロード](https://github.com/runkids/skillshare-app/releases/latest)。初回起動では CLI のインストールまたは既存の CLI の選択、AI ツールの選択、初回の同期を案内します。[インストールガイド](https://skillshare.runkids.cc/ja/docs/getting-started/desktop-app)。 + + + +### デスクトップアプリ — 画面で設定・管理 + +[Skillshare App](https://github.com/runkids/skillshare-app) はスキル、エージェント、MCP、hooks をデスクトップのウィンドウで管理できます。アプリをインストールして開き、初回起動の案内に沿って設定してください。 + +macOS(Apple Silicon)では Homebrew を使用: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +**Windows/Linux、または macOS に手動でインストールする場合:**[最新版のアプリインストーラーをダウンロード](https://github.com/runkids/skillshare-app/releases/latest)。各プラットフォームの詳細は[デスクトップアプリのガイド](https://skillshare.runkids.cc/ja/docs/getting-started/desktop-app)をご覧ください。 + +### CLI:macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh @@ -129,7 +147,7 @@ curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` -### Homebrew +### CLI:Homebrew ```bash brew install skillshare diff --git a/README-ko.md b/README-ko.md index 45dae5537..ff0a9487f 100644 --- a/README-ko.md +++ b/README-ko.md @@ -26,21 +26,17 @@

- AI CLI의 skills, agents, rules, commands 등을 하나의 소스로 관리하세요. 명령 하나로 모든 도구에 동기화되며, 개인부터 조직 전체까지 쓸 수 있습니다.
+ AI CLI의 skills, agents, rules, commands 등을 하나의 소스로 관리하세요. 데스크톱 앱으로 관리하거나 명령 하나로 모든 도구에 동기화할 수 있으며, 개인부터 조직 전체까지 사용할 수 있습니다.
Codex, Claude Code, OpenClaw, OpenCode 등 60개 이상의 도구를 지원합니다.

-

- skillshare demo -

-

공식 사이트 • 설치 • 빠른 시작 • 주요 기능 • 스크린샷 • - 데스크톱 앱 • + 데스크톱 앱 • 문서

@@ -105,6 +101,10 @@ skillshare가 이 문제를 해결합니다. ## CLI와 UI 미리보기 +

+ skillshare demo +

+ | Skill 상세 정보 | 보안 감사 | |---|---| | Skill 상세 정보 | 보안 감사 | @@ -115,7 +115,25 @@ skillshare가 이 문제를 해결합니다. ## 설치 -### macOS / Linux +> [!TIP] +> **데스크톱에서 skillshare를 관리하세요.** macOS(Apple Silicon), Windows, Linux용 [Skillshare App 다운로드](https://github.com/runkids/skillshare-app/releases/latest). 첫 실행에서 CLI 설치 또는 기존 CLI 선택, AI 도구 선택, 첫 동기화를 안내합니다. [설치 가이드](https://skillshare.runkids.cc/ko/docs/getting-started/desktop-app). + + + +### 데스크톱 앱 — 화면으로 설정하고 관리 + +[Skillshare App](https://github.com/runkids/skillshare-app)에서 스킬, 에이전트, MCP, hooks를 데스크톱 창으로 관리할 수 있습니다. 앱을 설치하고 연 다음 첫 실행 안내에 따라 설정하세요. + +macOS(Apple Silicon)에서는 Homebrew 사용: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +**Windows/Linux 또는 macOS 수동 설치:** [최신 앱 설치 파일 다운로드](https://github.com/runkids/skillshare-app/releases/latest). 플랫폼별 자세한 내용은 [데스크톱 앱 가이드](https://skillshare.runkids.cc/ko/docs/getting-started/desktop-app)를 참고하세요. + +### CLI: macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh @@ -129,7 +147,7 @@ curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` -### Homebrew +### CLI: Homebrew ```bash brew install skillshare diff --git a/README-zh-CN.md b/README-zh-CN.md index 338dea680..12c9b7d6f 100644 --- a/README-zh-CN.md +++ b/README-zh-CN.md @@ -26,21 +26,17 @@

- AI CLI 的 skills、agents、rules、commands 等资源,只需要一份来源。一条命令同步到所有工具,从个人到整个组织都适用。
+ AI CLI 的 skills、agents、rules、commands 等资源共用单一来源。通过桌面 App 管理,或用一个命令同步到所有工具,从个人使用到整个组织。
支持 Codex、Claude Code、OpenClaw、OpenCode 等 60 多种工具。

-

- skillshare demo -

-

官方网站 • 安装 • 快速开始 • 功能亮点 • 界面截图 • - 桌面应用 • + 桌面应用 • 文档

@@ -105,6 +101,10 @@ skillshare 解决这个问题: ## CLI 与界面预览 +

+ skillshare demo +

+ | Skill 详情 | 安全审计 | |---|---| | Skill 详情 | 安全审计 | @@ -115,7 +115,25 @@ skillshare 解决这个问题: ## 安装 -### macOS / Linux +> [!TIP] +> **通过桌面 App 管理 skillshare。** [下载 Skillshare App](https://github.com/runkids/skillshare-app/releases/latest),支持 macOS(Apple Silicon)、Windows 和 Linux。首次启动会引导你安装或选择 CLI、选择 AI 工具,并完成第一次同步。[安装指南](https://skillshare.runkids.cc/zh-Hans/docs/getting-started/desktop-app)。 + + + +### 桌面 App — 图形化设置与日常管理 + +[Skillshare App](https://github.com/runkids/skillshare-app) 将技能、代理、MCP 和 hooks 整合在桌面窗口中。安装并打开 App,再按照首次启动的引导完成设置。 + +macOS(Apple Silicon),使用 Homebrew: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +**Windows/Linux,或手动安装 macOS 版本:**[下载最新 App 安装包](https://github.com/runkids/skillshare-app/releases/latest)。各平台的详细说明请参阅[桌面 App 安装指南](https://skillshare.runkids.cc/zh-Hans/docs/getting-started/desktop-app)。 + +### CLI:macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh @@ -129,7 +147,7 @@ curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` -### Homebrew +### CLI:Homebrew ```bash brew install skillshare diff --git a/README-zh-TW.md b/README-zh-TW.md index 0b3aa0fad..783c45332 100644 --- a/README-zh-TW.md +++ b/README-zh-TW.md @@ -26,21 +26,17 @@

- AI CLI 的 skills、agents、rules、commands 等資源,只需要一份來源。一個指令同步到所有工具,個人到整個組織都適用。
+ AI CLI 的 skills、agents、rules、commands 等資源共用單一來源。用桌面 App 管理,或用一個指令同步到所有工具,從個人使用到整個組織。
支援 Codex、Claude Code、OpenClaw、OpenCode 等 60 多種工具。

-

- skillshare demo -

-

官方網站 • 安裝 • 快速開始 • 功能重點 • 畫面截圖 • - 桌面 App • + 桌面 App • 文件

@@ -105,6 +101,10 @@ skillshare 解決這個問題: ## CLI 與介面預覽 +

+ skillshare demo +

+ | Skill 詳細資訊 | 安全稽核 | |---|---| | Skill 詳細資訊 | 安全稽核 | @@ -115,7 +115,25 @@ skillshare 解決這個問題: ## 安裝 -### macOS / Linux +> [!TIP] +> **用桌面 App 管理 skillshare。** [下載 Skillshare App](https://github.com/runkids/skillshare-app/releases/latest),支援 macOS(Apple Silicon)、Windows 與 Linux。首次啟動會引導你安裝或選取 CLI、選擇 AI 工具,並完成第一次同步。[安裝指南](https://skillshare.runkids.cc/zh-Hant/docs/getting-started/desktop-app)。 + + + +### 桌面 App — 圖形化設定與日常管理 + +[Skillshare App](https://github.com/runkids/skillshare-app) 把技能、代理、MCP 與 hooks 整合在桌面視窗中。安裝並開啟 App,再依首次啟動的引導完成設定。 + +macOS(Apple Silicon),使用 Homebrew: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +**Windows/Linux,或手動安裝 macOS 版本:**[下載最新 App 安裝包](https://github.com/runkids/skillshare-app/releases/latest)。各平台的詳細說明請見[桌面 App 安裝指南](https://skillshare.runkids.cc/zh-Hant/docs/getting-started/desktop-app)。 + +### CLI:macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh @@ -129,7 +147,7 @@ curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` -### Homebrew +### CLI:Homebrew ```bash brew install skillshare diff --git a/README.md b/README.md index 4e1c8de79..c5225dd42 100644 --- a/README.md +++ b/README.md @@ -27,21 +27,17 @@

- One source of truth for AI CLI skills, agents, rules, commands & more. Sync everywhere with one command — from personal to organization-wide.
+ One source of truth for AI CLI skills, agents, rules, commands & more. Manage them in the desktop app, or sync everywhere with one command — from personal to organization-wide.
Codex, Claude Code, OpenClaw, OpenCode & 60+ more.

-

- skillshare demo -

-

Website • Install • Quick Start • Highlights • Screenshots • - Desktop App • + Desktop App • Docs

@@ -106,6 +102,10 @@ skillshare fixes this: ## CLI and UI Preview +

+ skillshare demo +

+ | Skill Detail | Security Audit | |---|---| | CLI sync output | CLI install with security audit | @@ -116,7 +116,25 @@ skillshare fixes this: ## Installation -### macOS / Linux +> [!TIP] +> **Use skillshare from your desktop.** [Get Skillshare App](https://github.com/runkids/skillshare-app/releases/latest) for macOS (Apple Silicon), Windows and Linux. First launch helps you install or locate the CLI, choose your AI tools and run your first sync. [Installation guide](https://skillshare.runkids.cc/docs/getting-started/desktop-app). + + + +### Desktop App — visual setup and daily management + +[Skillshare App](https://github.com/runkids/skillshare-app) puts skills, agents, MCP and hooks in a desktop window. Install the app, open it, and follow first-launch setup. + +macOS (Apple Silicon), with Homebrew: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +**Windows / Linux, or a manual macOS install:** [Download the latest app installers](https://github.com/runkids/skillshare-app/releases/latest). See the [Desktop App guide](https://skillshare.runkids.cc/docs/getting-started/desktop-app) for platform details. + +### CLI: macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh @@ -130,7 +148,7 @@ The script installs to `~/.local/bin` by default, so normal installs and updates irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` -### Homebrew +### CLI: Homebrew ```bash brew install skillshare diff --git a/website/docs/getting-started/desktop-app.md b/website/docs/getting-started/desktop-app.md new file mode 100644 index 000000000..08a0ef063 --- /dev/null +++ b/website/docs/getting-started/desktop-app.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# Desktop App + +Manage skills, agents, MCP and hooks in a desktop window with **[Skillshare App](https://github.com/runkids/skillshare-app)**. It brings the skillshare dashboard to macOS, Windows and Linux, with guided first-time setup. + +**[Download Skillshare App →](https://github.com/runkids/skillshare-app/releases/latest)** + +## Install on macOS + +For Apple Silicon Macs, Homebrew is the recommended installation method: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +Open **skillshare** from Applications after installation. A `.dmg` is also available from the [latest release](https://github.com/runkids/skillshare-app/releases/latest). + +## Install on Windows or Linux + +Choose your installer from the [latest app release](https://github.com/runkids/skillshare-app/releases/latest): + +| Platform | Installer | +|---|---| +| Windows (x64) | `.exe` or `.msi` | +| Linux (x64) | `.deb`, `.AppImage` or `.rpm` | + +Install the package for your system, then open Skillshare App. + +## First launch + +The app runs on the skillshare CLI. Its setup guides you through: + +1. Installing the CLI, or selecting a binary you already have. +2. Choosing the AI tools you want to sync to. +3. Running your first sync, then opening the dashboard. + +From the dashboard, browse and install skills, preview changes before syncing, and manage agents, MCP and hooks. The desktop app and [`skillshare ui`](../reference/commands/ui.md) use the same dashboard. + +## Prefer the terminal? + +The CLI remains available for terminal workflows and automation. Start with the [CLI first-sync guide](./first-sync.md), or look up a command in the [quick reference](./quick-reference.md). diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts index 154962aa8..9f9983f2d 100644 --- a/website/docusaurus.config.ts +++ b/website/docusaurus.config.ts @@ -5,7 +5,7 @@ import llmsTxtPlugin from './plugins/llms-txt'; const config: Config = { title: 'skillshare', - tagline: 'One source of truth for AI CLI skills. Sync everywhere with one command.', + tagline: 'Manage AI skills in the desktop app or CLI. One source, synced to every tool.', favicon: 'img/favicon.png', future: { @@ -174,6 +174,11 @@ const config: Config = { src: 'img/logo.png', }, items: [ + { + to: '/docs/getting-started/desktop-app', + label: 'Desktop App', + position: 'left', + }, { type: 'docSidebar', sidebarId: 'docsSidebar', @@ -193,16 +198,19 @@ const config: Config = { { to: '/features', label: 'Feature map', + className: 'navbar-secondary', position: 'left', }, { to: '/blog', label: 'Blog', + className: 'navbar-secondary', position: 'left', }, { to: '/changelog', label: 'Changelog', + className: 'navbar-secondary', position: 'left', }, { @@ -212,6 +220,7 @@ const config: Config = { { href: 'https://github.com/runkids/skillshare', label: 'GitHub', + className: 'navbar-secondary', position: 'right', }, ], diff --git a/website/i18n/ja/code.json b/website/i18n/ja/code.json new file mode 100644 index 000000000..4ce0e9a08 --- /dev/null +++ b/website/i18n/ja/code.json @@ -0,0 +1,38 @@ +{ + "home.desktop.get": { + "message": "デスクトップアプリを入手", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliGuide": { + "message": "CLI クイックスタート", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.platforms": { + "message": "macOS(Apple Silicon)· Windows · Linux", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.title": { + "message": "デスクトップアプリから始めよう。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.summary": { + "message": "デスクトップのウィンドウでスキル、エージェント、MCP、hooks を管理。初回起動では CLI の設定、AI ツールの選択、初回の同期を案内します。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.homebrew": { + "message": "macOS では Homebrew でインストール:", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.download": { + "message": "インストーラーをダウンロード", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.installGuide": { + "message": "インストールガイド", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliAlternative": { + "message": "ターミナルを使いたい場合は CLI をインストール。", + "description": "Desktop app promotion on the homepage" + } +} diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md new file mode 100644 index 000000000..d9f4084ae --- /dev/null +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# デスクトップアプリ + +**[Skillshare App](https://github.com/runkids/skillshare-app)** で、スキル、エージェント、MCP、hooks をデスクトップのウィンドウから管理できます。macOS、Windows、Linux で skillshare ダッシュボードを使え、初回の設定も案内します。 + +**[Skillshare App をダウンロード →](https://github.com/runkids/skillshare-app/releases/latest)** + +## macOS にインストール + +Apple Silicon Mac では Homebrew でのインストールをおすすめします: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +インストール後、「アプリケーション」から **skillshare** を開いてください。[最新リリース](https://github.com/runkids/skillshare-app/releases/latest)の `.dmg` を使って手動でインストールすることもできます。 + +## Windows または Linux にインストール + +[アプリの最新リリース](https://github.com/runkids/skillshare-app/releases/latest)からインストーラーを選んでください: + +| プラットフォーム | インストーラー | +|---|---| +| Windows(x64) | `.exe` または `.msi` | +| Linux(x64) | `.deb`、`.AppImage`、`.rpm` | + +システムに合ったパッケージをインストールし、Skillshare App を開きます。 + +## 初回起動 + +アプリは skillshare CLI を使って動作します。初回の設定で次の手順を案内します: + +1. CLI をインストールするか、インストール済みの実行ファイルを選択します。 +2. 同期する AI ツールを選びます。 +3. 初回の同期を実行し、ダッシュボードを開きます。 + +ダッシュボードからスキルを探してインストールし、同期前に変更を確認し、エージェント、MCP、hooks を管理できます。デスクトップアプリと [`skillshare ui`](../reference/commands/ui.md) は同じダッシュボードを使用します。 + +## ターミナルを使いたい場合 + +CLI はターミナルでの操作や自動化にも引き続き使えます。[CLI の初回同期ガイド](./first-sync.md)から始めるか、[クイックリファレンス](./quick-reference.md)でコマンドを調べてください。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/ui.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/ui.md index 6bea049ad..7738f0015 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/ui.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/ui.md @@ -99,7 +99,7 @@ skillshare ui start --clear-cache | **Audit** | Skill と Agent のセキュリティスキャン。重大度別の検出結果を表示。**Rules** タブでは、カテゴリごとにすべてのルールを閲覧できる: ルールをオフにする、重大度を変更する、カテゴリ全体に重大度を適用する、スキャンプロファイル(`default`、`strict`、`permissive`)を選ぶ、カスタム `audit-rules.yaml` のエディタを開く、のいずれかができる | | **Settings** | タブ分け: **General**(Source パス、sync モード、外観)、**Backup**(Target フォルダのスナップショット、`AGENTS.md` などのファイルの以前のバージョン、MCP 設定のバックアップ。[`backup`](./backup.md#dashboard) を参照)、**Log**(操作履歴)、**Health**([`doctor`](/docs/reference/commands/doctor) と同じチェック)、**Extensions**(sync 時のファイル変換)、**Files**(`config.yaml`、`.skillignore`、`.agentignore` の直接編集) | -変更一覧の横の **Discard changes** は、確認後に選択した Git scope の追跡中のファイルと index を最後の commit に戻し、未追跡のファイルとフォルダーを削除します。無視されたファイル、ネストした Git repositories、root scope の `config.yaml` は保持されます。commit の変更や push は行わず、この操作は元に戻せません。**Dry run** はファイルを変更せずプレビューします。最初の commit が必要です。 +変更一覧の横の **変更を破棄** は、確認後に選択した Git スコープ内の追跡中のファイルとステージング領域を最後のコミットに戻し、未追跡のファイルとフォルダーを削除します。Git に無視されたファイル、入れ子になった Git リポジトリ、`root` スコープの `config.yaml` は保持されます。コミット履歴の変更やリモートへのプッシュは行わず、この操作は元に戻せません。**ドライラン** はファイルを変更せずプレビューします。変更を破棄するには、リポジトリに最初のコミットが必要です。 **Updates** タブでは、プログレスバーに更新の進行状況が表示され、更新中の行が示されます。ブロックされた更新や失敗した更新は別のセクションに表示されます。 @@ -136,12 +136,12 @@ Project mode(`-p`)で実行すると、ダッシュボードは以下のよ ## UI プレビュー
- Install flow - Dashboard overview - Skills browser - Skill detail view - Sync controls - GitHub search view + インストールの流れ + ダッシュボードの概要 + スキル一覧 + スキルの詳細画面 + 同期操作 + GitHub の検索画面 プロジェクトフォルダーを一覧表示する Projects ページ
@@ -162,7 +162,7 @@ Web ダッシュボードは `/api/` に REST API を公開しています。す | DELETE | `/api/targets/{name}` | Target を削除 | | POST | `/api/sync` | sync を実行(`dryRun`、`force`、`kind`、`project` に対応。`project` は宣言済みの project ルートで、sync をその project の Target に限定する)。`dryRun` が指定されていない限り、まず Target をバックアップする | | POST | `/api/git/commit` | Source リポジトリからプッシュせずにローカル git commit を作成 | -| POST | `/api/git/discard` | 設定された Git scope の未 commit の変更を破棄(global mode のみ、最初の commit が必要)。`dryRun` に対応。無視されたファイル、ネストした Git repositories、root scope の `config.yaml` を保持 | +| POST | `/api/git/discard` | 設定された Git スコープ内の未コミットの変更を破棄(グローバルモードのみ。リポジトリに最初のコミットが必要)。`dryRun` に対応。Git に無視されたファイル、入れ子になった Git リポジトリ、`root` スコープの `config.yaml` を保持 | | GET | `/api/git/status` | まだプッシュされていないコミット(`ahead`)と、最後の fetch 時点でまだプルしていない upstream のコミット(`behind`)を含む、Source リポジトリの状態。fetch は行わない | | POST | `/api/push` | 変更をコミットしてからプッシュ。初回プッシュ時は upstream を設定する。remote にこのリポジトリにないコミットがある場合、`409` とエラーコード `push_rejected` で失敗する。プルしてから再度プッシュする | | POST | `/api/pull` | プルしてから、リポジトリのスコープが保持するものを sync する。分岐した履歴はマージされる。`.metadata.json` の競合は自動で解決され、それ以外の競合ではマージを取り消して失敗する。最初のプルがマージできない場合、エラーコード `merge_failed` で失敗する。`force: true` で再試行すると、remote ブランチでローカルファイルを置き換える | diff --git a/website/i18n/ja/docusaurus-theme-classic/navbar.json b/website/i18n/ja/docusaurus-theme-classic/navbar.json index 0eef96fdb..671c13e07 100644 --- a/website/i18n/ja/docusaurus-theme-classic/navbar.json +++ b/website/i18n/ja/docusaurus-theme-classic/navbar.json @@ -34,5 +34,9 @@ "item.label.GitHub": { "message": "GitHub", "description": "Navbar item with label GitHub" + }, + "item.label.Desktop App": { + "message": "デスクトップアプリ", + "description": "Navbar item with label Desktop App" } } diff --git a/website/i18n/ko/code.json b/website/i18n/ko/code.json new file mode 100644 index 000000000..d84088868 --- /dev/null +++ b/website/i18n/ko/code.json @@ -0,0 +1,38 @@ +{ + "home.desktop.get": { + "message": "데스크톱 앱 받기", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliGuide": { + "message": "CLI 빠른 시작", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.platforms": { + "message": "macOS(Apple Silicon) · Windows · Linux", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.title": { + "message": "데스크톱 앱으로 시작하세요.", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.summary": { + "message": "데스크톱 창에서 스킬, 에이전트, MCP, hooks를 관리하세요. 첫 실행에서 CLI 설정, AI 도구 선택, 첫 동기화를 안내합니다.", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.homebrew": { + "message": "macOS에서 Homebrew로 설치:", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.download": { + "message": "설치 파일 다운로드", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.installGuide": { + "message": "설치 가이드", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliAlternative": { + "message": "터미널이 더 편하다면 CLI를 설치하세요.", + "description": "Desktop app promotion on the homepage" + } +} diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md new file mode 100644 index 000000000..011742a40 --- /dev/null +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# 데스크톱 앱 + +**[Skillshare App](https://github.com/runkids/skillshare-app)**으로 스킬, 에이전트, MCP, hooks를 데스크톱 창에서 관리하세요. macOS, Windows, Linux에서 skillshare 대시보드를 사용할 수 있으며, 첫 사용을 위한 설정 안내도 제공합니다. + +**[Skillshare App 다운로드 →](https://github.com/runkids/skillshare-app/releases/latest)** + +## macOS에 설치 + +Apple Silicon Mac에서는 Homebrew 설치를 권장합니다: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +설치 후 응용 프로그램에서 **skillshare**를 여세요. [최신 릴리스](https://github.com/runkids/skillshare-app/releases/latest)의 `.dmg`로 직접 설치할 수도 있습니다. + +## Windows 또는 Linux에 설치 + +[최신 앱 릴리스](https://github.com/runkids/skillshare-app/releases/latest)에서 설치 파일을 선택하세요: + +| 플랫폼 | 설치 파일 | +|---|---| +| Windows(x64) | `.exe` 또는 `.msi` | +| Linux(x64) | `.deb`, `.AppImage` 또는 `.rpm` | + +시스템에 맞는 패키지를 설치한 다음 Skillshare App을 여세요. + +## 첫 실행 + +앱은 skillshare CLI를 사용해 작동합니다. 첫 설정에서 다음 과정을 안내합니다: + +1. CLI를 설치하거나 기존 실행 파일을 선택합니다. +2. 동기화할 AI 도구를 선택합니다. +3. 첫 동기화를 실행한 다음 대시보드를 엽니다. + +대시보드에서 스킬을 찾아 설치하고, 동기화 전에 변경 사항을 미리 보고, 에이전트, MCP, hooks를 관리할 수 있습니다. 데스크톱 앱과 [`skillshare ui`](../reference/commands/ui.md)는 같은 대시보드를 사용합니다. + +## 터미널이 더 편하다면 + +CLI는 터미널 작업과 자동화에도 계속 사용할 수 있습니다. [CLI 첫 동기화 가이드](./first-sync.md)로 시작하거나 [빠른 참조](./quick-reference.md)에서 명령을 찾아보세요. diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/ui.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/ui.md index 9c9d60076..95399fa49 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/ui.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/ui.md @@ -99,7 +99,7 @@ skillshare ui start --clear-cache | **Audit** | skill과 agent에 대한 보안 스캔이며, 심각도별로 findings를 표시합니다. **Rules** 탭에서는 카테고리별로 모든 rule을 탐색할 수 있습니다: rule을 끄거나, 심각도를 변경하거나, 카테고리 전체에 심각도를 적용하거나, 스캔 profile(`default`, `strict`, `permissive`)을 선택하거나, 사용자 지정 `audit-rules.yaml` 편집기를 엽니다 | | **Settings** | 탭으로 구성: **General**(source 경로, sync mode, 외관), **Backup**(대상 폴더 스냅샷, `AGENTS.md` 같은 파일의 이전 버전, MCP 설정 백업. [`backup`](./backup.md#dashboard) 참고), **Log**(작업 이력), **Health**([`doctor`](/docs/reference/commands/doctor)와 동일한 검사), **Extensions**(sync 시점의 파일 변환), **Files**(`config.yaml`, `.skillignore`, `.agentignore`를 위한 직접 편집기) | -변경 목록 옆의 **Discard changes**는 확인 후 선택한 Git scope의 추적 중인 파일과 index를 마지막 commit으로 복원하고 추적되지 않은 파일과 폴더를 삭제합니다. 무시된 파일, 중첩 Git repositories 및 root scope의 `config.yaml`은 유지됩니다. commit을 변경하거나 push하지 않으며, 이 작업은 되돌릴 수 없습니다. **Dry run**은 파일을 변경하지 않고 미리 봅니다. 첫 번째 commit이 필요합니다. +변경 목록 옆의 **변경 사항 버리기**는 확인 후 선택한 Git 범위 내의 추적 중인 파일과 스테이징 영역을 마지막 커밋으로 복원하고 추적되지 않은 파일과 폴더를 삭제합니다. Git에서 무시한 파일, 중첩된 Git 저장소 및 `root` 범위의 `config.yaml`은 유지됩니다. 커밋 기록을 변경하거나 원격 저장소로 푸시하지 않으며, 이 작업은 되돌릴 수 없습니다. **시험 실행**은 파일을 변경하지 않고 미리 봅니다. 변경 사항을 버리려면 저장소에 첫 번째 커밋이 있어야 합니다. **Updates** 탭의 진행률 표시줄은 업데이트 진행 상황을 보여 주며 업데이트 중인 행도 표시됩니다. 차단되거나 실패한 업데이트는 별도 섹션에 표시됩니다. @@ -162,7 +162,7 @@ project mode(`-p`)로 실행할 때 대시보드는 다음과 같이 달라집 | DELETE | `/api/targets/{name}` | target 제거 | | POST | `/api/sync` | sync 실행(`dryRun`, `force`, `kind`, 그리고 sync를 해당 프로젝트의 target으로 제한하는 선언된 프로젝트 루트인 `project` 지원). `dryRun`이 설정되지 않은 한 먼저 target을 백업합니다 | | POST | `/api/git/commit` | push 없이 source repo에서 로컬 git commit 생성 | -| POST | `/api/git/discard` | 설정된 Git scope의 commit되지 않은 변경 사항을 버립니다(global mode 전용, 첫 번째 commit 필요). `dryRun`을 지원합니다. 무시된 파일, 중첩 Git repositories 및 root scope의 `config.yaml`을 유지합니다 | +| POST | `/api/git/discard` | 설정된 Git 범위 내의 커밋되지 않은 변경 사항을 버립니다(전역 모드 전용, 저장소에 첫 번째 커밋 필요). `dryRun`을 지원합니다. Git에서 무시한 파일, 중첩된 Git 저장소 및 `root` 범위의 `config.yaml`을 유지합니다 | | GET | `/api/git/status` | 아직 push되지 않은 커밋(`ahead`)과 마지막 fetch 기준으로 아직 pull하지 않은 upstream 커밋(`behind`)을 포함한 source repo 상태. fetch는 하지 않습니다 | | POST | `/api/push` | 변경 사항을 commit한 후 push합니다. 첫 push 시 upstream을 설정합니다. remote에 이 repo에 없는 커밋이 있으면 `409`와 오류 코드 `push_rejected`로 실패합니다. pull한 후 다시 push하세요 | | POST | `/api/pull` | pull한 후 repo scope가 담고 있는 것을 sync합니다. 갈라진 히스토리는 병합되며, `.metadata.json` 충돌은 자동으로 해결되고, 그 외의 충돌은 병합을 되돌린 채 실패합니다. 첫 pull이 병합에 실패하면 오류 코드 `merge_failed`로 실패합니다. 로컬 파일을 remote 브랜치로 교체하려면 `force: true`로 재시도하세요 | diff --git a/website/i18n/ko/docusaurus-theme-classic/navbar.json b/website/i18n/ko/docusaurus-theme-classic/navbar.json index f8a5fec1d..1c559c759 100644 --- a/website/i18n/ko/docusaurus-theme-classic/navbar.json +++ b/website/i18n/ko/docusaurus-theme-classic/navbar.json @@ -34,5 +34,9 @@ "item.label.GitHub": { "message": "GitHub", "description": "Navbar item with label GitHub" + }, + "item.label.Desktop App": { + "message": "데스크톱 앱", + "description": "Navbar item with label Desktop App" } } diff --git a/website/i18n/zh-Hans/code.json b/website/i18n/zh-Hans/code.json new file mode 100644 index 000000000..fbc6710bf --- /dev/null +++ b/website/i18n/zh-Hans/code.json @@ -0,0 +1,38 @@ +{ + "home.desktop.get": { + "message": "下载桌面 App", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliGuide": { + "message": "CLI 快速入门", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.platforms": { + "message": "macOS(Apple Silicon)· Windows · Linux", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.title": { + "message": "从桌面 App 开始。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.summary": { + "message": "在桌面窗口中管理技能、代理、MCP 和 hooks。首次启动会帮助你设置 CLI、选择 AI 工具,并完成第一次同步。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.homebrew": { + "message": "在 macOS 通过 Homebrew 安装:", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.download": { + "message": "下载安装包", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.installGuide": { + "message": "安装指南", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliAlternative": { + "message": "偏好终端?安装 CLI。", + "description": "Desktop app promotion on the homepage" + } +} diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md new file mode 100644 index 000000000..bbb43a129 --- /dev/null +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# 桌面 App + +通过 **[Skillshare App](https://github.com/runkids/skillshare-app)**,在桌面窗口中管理技能、代理、MCP 和 hooks。它将 skillshare 仪表板带到 macOS、Windows 和 Linux,并提供首次使用的设置引导。 + +**[下载 Skillshare App →](https://github.com/runkids/skillshare-app/releases/latest)** + +## 在 macOS 安装 + +Apple Silicon Mac 建议通过 Homebrew 安装: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +安装后,从“应用程序”打开 **skillshare**。也可以从[最新版本](https://github.com/runkids/skillshare-app/releases/latest)下载 `.dmg` 手动安装。 + +## 在 Windows 或 Linux 安装 + +从[最新 App 版本](https://github.com/runkids/skillshare-app/releases/latest)选择安装包: + +| 平台 | 安装包 | +|---|---| +| Windows(x64) | `.exe` 或 `.msi` | +| Linux(x64) | `.deb`、`.AppImage` 或 `.rpm` | + +安装适合系统的软件包,再打开 Skillshare App。 + +## 首次启动 + +App 使用 skillshare CLI 运行。首次设置会引导你: + +1. 安装 CLI,或选择已安装的可执行文件。 +2. 选择要同步的 AI 工具。 +3. 执行第一次同步,再打开仪表板。 + +你可以在仪表板浏览和安装技能、在同步前预览更改,并管理代理、MCP 和 hooks。桌面 App 与 [`skillshare ui`](../reference/commands/ui.md) 使用相同的仪表板。 + +## 偏好终端? + +CLI 仍可用于终端操作和自动化。请从 [CLI 首次同步指南](./first-sync.md)开始,或通过[快速参考](./quick-reference.md)查询命令。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/ui.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/ui.md index c2a89d31c..993e00cb9 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/ui.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/ui.md @@ -99,7 +99,7 @@ skillshare ui start --clear-cache | **Audit** | 对 skills 和 agents 的安全扫描,按严重程度列出 findings。**Rules** 标签页按类别浏览每一条规则:可以关闭某一条、更改其严重程度、把某个严重程度应用到整个类别、选择扫描 profile(`default`、`strict`、`permissive`),或打开自定义 `audit-rules.yaml` 的编辑器 | | **Settings** | 带标签页:**General**(source 路径、sync 模式、外观)、**Backup**(target 文件夹快照、`AGENTS.md` 等文件的早期版本,以及 MCP 配置备份;参见 [`backup`](./backup.md#dashboard))、**Log**(操作历史)、**Health**(与 [`doctor`](/docs/reference/commands/doctor) 相同的检查)、**Extensions**(同步时的文件转换)、**Files**(`config.yaml`、`.skillignore` 和 `.agentignore` 的直接编辑器) | -更改列表旁的 **Discard changes** 会在确认后,将所选 Git scope 的所有已跟踪文件和 index 恢复至最后一次 commit,并删除未跟踪的文件和文件夹。忽略的文件、嵌套 Git repositories 和 root scope 的 `config.yaml` 会保留。此操作不会更改 commits 或 push,且无法撤销。**Dry run** 只会预览,不会更改文件。必须先有第一个 commit。 +更改列表旁的 **放弃更改** 会在确认后,将所选 Git 范围内所有已跟踪的文件和暂存区恢复至最后一次提交,并删除未跟踪的文件和文件夹。被 Git 忽略的文件、嵌套 Git 仓库,以及 `root` 范围的 `config.yaml` 都会保留。此操作不会更改提交记录,也不会推送到远程仓库,且无法撤销。**试运行** 只会预览,不会更改文件。仓库必须已有第一次提交,才能放弃更改。 在 **Updates** 标签页中,进度条会显示更新进度,正在更新的行也会标记出来。被阻止或失败的更新会显示在单独的区域。 @@ -136,12 +136,12 @@ Dashboard 支持两种视觉风格和三种颜色模式,可通过侧边栏的 ## UI 预览
- Install flow - Dashboard overview - Skills browser - Skill detail view - Sync controls - GitHub search view + 安装流程 + 仪表板概览 + 技能浏览页面 + 技能详细信息页面 + 同步控件 + GitHub 搜索界面 列出项目文件夹的 Projects 页面
@@ -162,7 +162,7 @@ web dashboard 在 `/api/` 下暴露一个 REST API。所有端点都返回 JSON | DELETE | `/api/targets/{name}` | 移除一个 target | | POST | `/api/sync` | 运行 sync(支持 `dryRun`、`force`、`kind`,以及 `project`:一个已声明的项目根目录,用于将 sync 限定在该项目的 targets)。除非设置了 `dryRun`,否则会先备份 targets | | POST | `/api/git/commit` | 从 source 仓库创建一个本地 git commit,但不推送 | -| POST | `/api/git/discard` | 放弃配置 Git scope 的未 commit 更改(仅 global mode,必须先有第一个 commit)。支持 `dryRun`,保留忽略的文件、嵌套 Git repositories 和 root scope 的 `config.yaml` | +| POST | `/api/git/discard` | 放弃配置的 Git 范围内尚未提交的更改(仅限全局模式,仓库必须已有第一次提交)。支持 `dryRun`;保留被 Git 忽略的文件、嵌套 Git 仓库,以及 `root` 范围的 `config.yaml` | | GET | `/api/git/status` | source 仓库状态,包括尚未推送的提交(`ahead`),以及截至上次 fetch 尚未拉取的 upstream 提交(`behind`)。不会执行 fetch | | POST | `/api/push` | 提交任何变更,然后推送。首次推送时会设置 upstream。当 remote 有本仓库没有的提交时,会以 `409` 和错误码 `push_rejected` 失败;先 pull,再重新 push | | POST | `/api/pull` | 拉取,然后同步该仓库 scope 所涵盖的内容。分歧的历史会被合并;`.metadata.json` 的冲突会自动解决,其他冲突会失败并撤销合并。当首次 pull 无法合并时,会以错误码 `merge_failed` 失败;用 `force: true` 重试可用 remote 分支替换本地文件 | diff --git a/website/i18n/zh-Hans/docusaurus-theme-classic/navbar.json b/website/i18n/zh-Hans/docusaurus-theme-classic/navbar.json index f7aeafd5c..ddfe49353 100644 --- a/website/i18n/zh-Hans/docusaurus-theme-classic/navbar.json +++ b/website/i18n/zh-Hans/docusaurus-theme-classic/navbar.json @@ -34,5 +34,9 @@ "item.label.GitHub": { "message": "GitHub", "description": "Navbar item with label GitHub" + }, + "item.label.Desktop App": { + "message": "桌面 App", + "description": "Navbar item with label Desktop App" } } diff --git a/website/i18n/zh-Hant/code.json b/website/i18n/zh-Hant/code.json index be2ec73ce..f071cfc43 100644 --- a/website/i18n/zh-Hant/code.json +++ b/website/i18n/zh-Hant/code.json @@ -2,5 +2,41 @@ "theme.common.skipToMainContent": { "message": "跳至主要內容", "description": "The skip to content label used for accessibility" + }, + "home.desktop.get": { + "message": "下載桌面 App", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliGuide": { + "message": "CLI 快速入門", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.platforms": { + "message": "macOS(Apple Silicon)· Windows · Linux", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.title": { + "message": "從桌面 App 開始。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.summary": { + "message": "在桌面視窗中管理技能、代理、MCP 與 hooks。首次啟動會協助你設定 CLI、選擇 AI 工具,並完成第一次同步。", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.homebrew": { + "message": "在 macOS 透過 Homebrew 安裝:", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.download": { + "message": "下載安裝包", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.installGuide": { + "message": "安裝指南", + "description": "Desktop app promotion on the homepage" + }, + "home.desktop.cliAlternative": { + "message": "偏好終端機?安裝 CLI。", + "description": "Desktop app promotion on the homepage" } } diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md new file mode 100644 index 000000000..0755091bd --- /dev/null +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/desktop-app.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# 桌面 App + +用 **[Skillshare App](https://github.com/runkids/skillshare-app)**,在桌面視窗中管理技能、代理、MCP 與 hooks。它把 skillshare 儀表板帶到 macOS、Windows 與 Linux,並提供首次使用的設定引導。 + +**[下載 Skillshare App →](https://github.com/runkids/skillshare-app/releases/latest)** + +## 在 macOS 安裝 + +Apple Silicon Mac 建議透過 Homebrew 安裝: + +```bash +brew tap runkids/tap +brew install --cask skillshare-app +``` + +安裝後,從「應用程式」開啟 **skillshare**。也可以從[最新版本](https://github.com/runkids/skillshare-app/releases/latest)下載 `.dmg` 手動安裝。 + +## 在 Windows 或 Linux 安裝 + +從[最新 App 版本](https://github.com/runkids/skillshare-app/releases/latest)選擇安裝包: + +| 平台 | 安裝包 | +|---|---| +| Windows(x64) | `.exe` 或 `.msi` | +| Linux(x64) | `.deb`、`.AppImage` 或 `.rpm` | + +安裝適合系統的套件,再開啟 Skillshare App。 + +## 首次啟動 + +App 使用 skillshare CLI 運作。首次設定會引導你: + +1. 安裝 CLI,或選取已安裝的執行檔。 +2. 選擇要同步的 AI 工具。 +3. 執行第一次同步,再開啟儀表板。 + +你可以在儀表板瀏覽與安裝技能、在同步前預覽變更,並管理代理、MCP 與 hooks。桌面 App 與 [`skillshare ui`](../reference/commands/ui.md) 使用相同的儀表板。 + +## 偏好終端機? + +CLI 仍可用於終端機操作與自動化。請從 [CLI 首次同步指南](./first-sync.md)開始,或用[快速參考](./quick-reference.md)查詢指令。 diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/ui.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/ui.md index a72a8b9ad..092708f58 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/ui.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/commands/ui.md @@ -99,7 +99,7 @@ skillshare ui start --clear-cache | **Audit** | 對 skills 與 agents 進行安全掃描,依嚴重程度列出發現項目。**Rules** 分頁可依分類瀏覽每一項規則:關閉某項、變更其嚴重程度、對整個分類套用嚴重程度、選擇掃描設定檔(`default`、`strict`、`permissive`),或開啟編輯器自訂 `audit-rules.yaml` | | **Settings** | 分頁式:**General**(source 路徑、同步模式、外觀)、**Backup**(target 資料夾快照、`AGENTS.md` 這類檔案的較早版本,以及 MCP 設定備份;參見 [`backup`](./backup.md#dashboard))、**Log**(操作歷史)、**Health**(與 [`doctor`](/docs/reference/commands/doctor) 相同的檢查)、**Extensions**(同步時的檔案轉換)、**Files**(直接編輯 `config.yaml`、`.skillignore` 與 `.agentignore`) | -變更清單旁的 **Discard changes** 會在確認後,將所選 Git scope 的所有已追蹤檔案與 index 還原至最後一次 commit,並刪除未追蹤的檔案與資料夾。忽略的檔案、巢狀 Git repositories 與 root scope 的 `config.yaml` 會保留。此操作不會變更 commits 或 push,且無法復原。**Dry run** 只會預覽,不會變更檔案。必須先有第一個 commit。 +變更清單旁的 **捨棄變更** 會在確認後,將所選 Git 範圍內所有已追蹤的檔案與暫存區還原至最後一次提交,並刪除未追蹤的檔案與資料夾。被 Git 忽略的檔案、巢狀 Git 儲存庫,以及 `root` 範圍的 `config.yaml` 都會保留。此操作不會更動提交紀錄,也不會推送至遠端,且無法復原。**試跑** 只會預覽,不會變更檔案。儲存庫必須已有第一次提交,才能捨棄變更。 在 **Updates** 分頁中,進度列會顯示更新進度,正在更新的列也會標示出來。被阻擋或失敗的更新會顯示在獨立區塊。 @@ -136,12 +136,12 @@ Dashboard 支援兩種視覺風格與三種色彩模式,可透過側邊欄的 ## UI 預覽
- Install flow - Dashboard overview - Skills browser - Skill detail view - Sync controls - GitHub search view + 安裝流程 + 儀表板總覽 + 技能瀏覽頁面 + 技能詳細資訊頁面 + 同步控制項 + GitHub 搜尋畫面 列出專案資料夾的 Projects 頁面
@@ -162,7 +162,7 @@ Web dashboard 在 `/api/` 上提供 REST API。所有端點皆回傳 JSON。 | DELETE | `/api/targets/{name}` | 移除一個 target | | POST | `/api/sync` | 執行同步(支援 `dryRun`、`force`、`kind`,以及 `project`:一個已宣告的 project 根目錄,會把同步範圍限定在該 project 的 targets)。除非設定 `dryRun`,否則會先備份 targets | | POST | `/api/git/commit` | 從 source repo 建立本機 git commit,但不 push | -| POST | `/api/git/discard` | 捨棄設定 Git scope 的未 commit 變更(僅 global mode,必須先有第一個 commit)。支援 `dryRun`,保留忽略的檔案、巢狀 Git repositories 與 root scope 的 `config.yaml` | +| POST | `/api/git/discard` | 捨棄設定的 Git 範圍內尚未提交的變更(僅限全域模式,儲存庫必須已有第一次提交)。支援 `dryRun`;保留被 Git 忽略的檔案、巢狀 Git 儲存庫,以及 `root` 範圍的 `config.yaml` | | GET | `/api/git/status` | Source repo 狀態,包含尚未 push 的 commits(`ahead`),以及截至上次 fetch 尚未 pull 的 upstream commits(`behind`)。不會執行 fetch | | POST | `/api/push` | Commit 所有變更後再 push。首次 push 時會設定 upstream。當 remote 有這個 repo 沒有的 commits 時,會以 `409` 與錯誤代碼 `push_rejected` 失敗;先 pull 再 push 即可 | | POST | `/api/pull` | Pull 之後同步 repo scope 所涵蓋的內容。已分歧的歷史會被合併;`.metadata.json` 的衝突會自動解決,其他衝突則會失敗並復原 merge。當第一次 pull 無法合併時,會以錯誤代碼 `merge_failed` 失敗;帶 `force: true` 重試可以本機檔案取代 remote 分支 | diff --git a/website/i18n/zh-Hant/docusaurus-theme-classic/navbar.json b/website/i18n/zh-Hant/docusaurus-theme-classic/navbar.json index 737121ad0..4c0908c2d 100644 --- a/website/i18n/zh-Hant/docusaurus-theme-classic/navbar.json +++ b/website/i18n/zh-Hant/docusaurus-theme-classic/navbar.json @@ -34,5 +34,9 @@ "item.label.GitHub": { "message": "GitHub", "description": "Navbar item with label GitHub" + }, + "item.label.Desktop App": { + "message": "桌面 App", + "description": "Navbar item with label Desktop App" } } diff --git a/website/sidebars.ts b/website/sidebars.ts index ef978fd89..9afb5c974 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -9,6 +9,7 @@ const sidebars: SidebarsConfig = { collapsed: false, items: [ 'getting-started/index', + 'getting-started/desktop-app', 'getting-started/first-sync', 'getting-started/from-existing-skills', 'getting-started/quick-reference', diff --git a/website/src/css/custom.css b/website/src/css/custom.css index ca6a077eb..cf1678e63 100644 --- a/website/src/css/custom.css +++ b/website/src/css/custom.css @@ -192,6 +192,21 @@ h1, h2, h3, h4, h5, h6 { padding: 0.5rem 0.75rem; } +@media (min-width: 997px) and (max-width: 1399px) { + .navbar .navbar-secondary { + display: none; + } + + .navbar__brand { + flex-shrink: 0; + } + + .navbar__items .navbar__link { + padding: 0.5rem; + white-space: nowrap; + } +} + /* ======================================== MOBILE SIDEBAR — full screen ======================================== */ diff --git a/website/src/pages/index.module.css b/website/src/pages/index.module.css index f3b6ee711..6ecd211de 100644 --- a/website/src/pages/index.module.css +++ b/website/src/pages/index.module.css @@ -60,6 +60,37 @@ flex-wrap: wrap; } +.heroActions { + margin-top: 1.25rem; +} + +.heroActions a { + display: inline-flex; + align-items: center; + gap: 0.5rem; +} + +.desktopPlatforms { + margin: 0.75rem 0; + color: var(--color-pencil-light); + font-size: 0.875rem; +} + +.desktopCommand { + margin-bottom: 1.5rem; +} + +.installCommand.desktopCommand code { + white-space: pre-wrap; + overflow-wrap: anywhere; + line-height: 1.8; +} + +.cliAlternative { + margin: 1rem 0 0; + font-size: 0.875rem; +} + .onlyWide { display: block; } @@ -645,50 +676,6 @@ padding-top: 6px; } -.installSection { - margin-bottom: 1.5rem; -} - -.installTabs { - display: flex; - gap: 0.5rem; - margin-bottom: 0.75rem; - flex-wrap: wrap; -} - -.installTab { - display: flex; - align-items: center; - gap: 0.4rem; - padding: 0.5rem 1rem; - background: transparent; - border: 2px dashed var(--color-muted-dark); - border-radius: var(--radius-wobbly-sm); - color: var(--muted-text); - font-size: 0.8rem; - font-weight: 500; - cursor: pointer; - transition: all 0.15s ease; -} - -.installTab:hover { - background: var(--color-paper-warm); - border-color: var(--color-pencil); - color: var(--color-pencil); -} - -.installTabActive { - background: var(--color-postit); - border: 2px solid var(--color-pencil); - color: var(--color-pencil); - font-weight: 600; -} - -:global([data-theme='dark']) .installTabActive { - background: rgba(232, 168, 76, 0.18); - border-color: var(--color-blue); -} - .installCommand { display: flex; align-items: center; @@ -721,12 +708,6 @@ min-width: 0; } -.prompt { - color: #2e8b57; - margin-right: 0.5rem; - font-weight: 600; -} - .copyButton { flex-shrink: 0; width: 44px; diff --git a/website/src/pages/index.tsx b/website/src/pages/index.tsx index 0e46d10c3..33be8c29e 100644 --- a/website/src/pages/index.tsx +++ b/website/src/pages/index.tsx @@ -4,7 +4,8 @@ import Link from '@docusaurus/Link'; import useDocusaurusContext from '@docusaurus/useDocusaurusContext'; import Layout from '@theme/Layout'; import Heading from '@theme/Heading'; -import {Copy, Check, Apple, Terminal, ShieldCheck} from 'lucide-react'; +import Translate from '@docusaurus/Translate'; +import {Copy, Check, Monitor, ShieldCheck} from 'lucide-react'; import {COMMAND_COUNT, FEATURE_GROUPS, TARGET_COUNT} from '../data/featureMap'; import styles from './index.module.css'; @@ -209,25 +210,7 @@ function SyncTerminal({pinned}: {pinned: Tool[]}) { // Install // --------------------------------------------------------------------------- -type InstallMethod = 'curl' | 'powershell' | 'homebrew'; - -const INSTALL_COMMANDS: Record = { - curl: { - command: 'curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh', - label: 'macOS / Linux', - icon: , - }, - powershell: { - command: 'irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex', - label: 'Windows', - icon: PS, - }, - homebrew: { - command: 'brew install skillshare', - label: 'Homebrew', - icon: , - }, -}; +const DESKTOP_INSTALL = 'brew tap runkids/tap\nbrew install --cask skillshare-app'; function CopyButton({text}: {text: string}) { const [copied, setCopied] = useState(false); @@ -243,33 +226,6 @@ function CopyButton({text}: {text: string}) { ); } -function InstallTabs() { - const [method, setMethod] = useState('curl'); - const current = INSTALL_COMMANDS[method]; - return ( -
-
- {(Object.keys(INSTALL_COMMANDS) as InstallMethod[]).map((key) => ( - - ))} -
-
- - $ {current.command} - - -
-
- ); -} - // --------------------------------------------------------------------------- // Sections // --------------------------------------------------------------------------- @@ -288,6 +244,18 @@ function HeroSection() { skillshare keeps your skills in one place and symlinks them into Claude Code, Cursor, Codex and{' '} {TARGET_COUNT - 3} more. Pin the tools you use. Watch the strings.

+
+ +
+

+ macOS (Apple Silicon) · Windows · Linux +

click a tool to pin
or unpin it ↓
@@ -302,19 +270,32 @@ function HeroSection() {
- Install once. Run one command. + + Start with the desktop app. +

- Single Go binary, no runtime. init finds the tools on this machine and pins them for you. + Manage skills, agents, MCP and hooks in one desktop window. First launch helps you set up the CLI, choose your AI tools and run your first sync.

- +

+ Install on macOS with Homebrew: +

+
+ {DESKTOP_INSTALL} + +
- - Get Started + + Download installers - - Find a feature + + Installation guide
+

+ + Prefer the terminal? Install the CLI. + +

@@ -485,8 +466,8 @@ function CtaSection() {

Free, MIT licensed. Uninstall leaves every tool exactly as it was.

- - Read the 5-minute guide + + Get Desktop App Star on GitHub @@ -501,7 +482,7 @@ function CtaSection() { export default function Home(): ReactNode { const {siteConfig} = useDocusaurusContext(); return ( - +