From ac93ceeb3059757161bb628259285bfe4c60111f Mon Sep 17 00:00:00 2001 From: Willie Date: Wed, 18 Nov 2026 02:34:41 +0800 Subject: [PATCH] docs: announce 0.30.11 and translate the plugin Share section The Latest callout still named 0.30.10. Point it at Pi package sharing and the in-place Antigravity and Copilot hook edits, in every translated README. The ja, ko, zh-Hans and zh-Hant plugin guide and the dashboard page table never described Share. Add it with the Pi packages it now lists, using the dashboard's own label for the ask option. --- README-de.md | 2 +- README-es.md | 2 +- README-fr.md | 2 +- README-ja.md | 2 +- README-ko.md | 2 +- README-pt-BR.md | 2 +- README-zh-CN.md | 2 +- README-zh-TW.md | 2 +- README.md | 2 +- .../current/how-to/daily-tasks/sharing-plugins.md | 12 ++++++++++++ .../current/reference/commands/ui.md | 2 +- .../current/how-to/daily-tasks/sharing-plugins.md | 11 +++++++++++ .../current/reference/commands/ui.md | 2 +- .../current/how-to/daily-tasks/sharing-plugins.md | 11 +++++++++++ .../current/reference/commands/ui.md | 2 +- .../current/how-to/daily-tasks/sharing-plugins.md | 11 +++++++++++ .../current/reference/commands/ui.md | 2 +- 17 files changed, 58 insertions(+), 13 deletions(-) diff --git a/README-de.md b/README-de.md index 037aa5e2d..84ab35596 100644 --- a/README-de.md +++ b/README-de.md @@ -47,7 +47,7 @@

> [!NOTE] -> **Neueste Version**: v0.30.10 — Den Codex-Hooks vertrauen, die skillshare schreibt: `skillshare hooks sync --trust -g` listet die neuen oder geänderten Hooks mit ihren Befehlen auf und trägt nach deiner Bestätigung das Vertrauen in Codex ein, sodass Codex sie nicht mehr überspringt. `--yes` überspringt die Rückfrage für Skripte, und die Hooks-Seite im Dashboard bietet dieselbe Aktion. [hooks-Referenz →](https://skillshare.runkids.cc/docs/reference/commands/hooks) · [Alle Releases →](https://github.com/runkids/skillshare/releases) +> **Neueste Version**: v0.30.11 — Pi-Pakete aus dem Dashboard teilen: **Teilen** auf der Plugins-Seite listet jetzt nach deinen Plugins auch die npm-Pakete auf, die Pi installiert hat, und kopiert einen Befehl, der alle hinzufügt, etwa `skillshare plugin add npm: --target pi -g --no-tui`. Der Dialog **Hooks in Zielen** kann außerdem Antigravity- und Copilot-Hooks bearbeiten oder entfernen, ohne sie zu importieren. [Plugins-Anleitung →](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) · [Alle Releases →](https://github.com/runkids/skillshare/releases) ## Warum skillshare diff --git a/README-es.md b/README-es.md index 3a659f0ca..18be4e3b8 100644 --- a/README-es.md +++ b/README-es.md @@ -47,7 +47,7 @@

> [!NOTE] -> **Última versión**: v0.30.10 — Confía en los hooks de Codex que escribe skillshare: `skillshare hooks sync --trust -g` lista los hooks nuevos o modificados con sus comandos y registra la confianza de Codex cuando confirmas, para que Codex deje de omitirlos. `--yes` omite la pregunta en scripts, y la página Hooks del dashboard ofrece la misma acción. [Referencia de hooks →](https://skillshare.runkids.cc/docs/reference/commands/hooks) · [Todas las versiones →](https://github.com/runkids/skillshare/releases) +> **Última versión**: v0.30.11 — Comparte tus paquetes de Pi desde el dashboard: **Compartir** en la página Plugins ahora lista, después de tus plugins, los paquetes npm que instaló Pi y copia un comando que los añade todos, como `skillshare plugin add npm: --target pi -g --no-tui`. El diálogo **Hooks en los destinos** también puede editar o eliminar hooks de Antigravity y Copilot sin importarlos. [Guía de plugins →](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) · [Todas las versiones →](https://github.com/runkids/skillshare/releases) ## Por qué skillshare diff --git a/README-fr.md b/README-fr.md index 0950a3a8a..24cc6a70b 100644 --- a/README-fr.md +++ b/README-fr.md @@ -47,7 +47,7 @@

> [!NOTE] -> **Dernière version** : v0.30.10 — Faites confiance aux hooks Codex écrits par skillshare : `skillshare hooks sync --trust -g` liste les hooks nouveaux ou modifiés avec leurs commandes et enregistre la confiance de Codex après votre confirmation, pour que Codex cesse de les ignorer. `--yes` saute la question pour les scripts, et la page Hooks du tableau de bord propose la même action. [Référence des hooks →](https://skillshare.runkids.cc/docs/reference/commands/hooks) · [Toutes les versions →](https://github.com/runkids/skillshare/releases) +> **Dernière version** : v0.30.11 — Partagez vos paquets Pi depuis le tableau de bord : **Partager** sur la page Plugins liste désormais, après vos plugins, les paquets npm installés par Pi et copie une commande qui les ajoute tous, par exemple `skillshare plugin add npm: --target pi -g --no-tui`. La boîte de dialogue **Hooks dans les cibles** peut aussi modifier ou supprimer les hooks Antigravity et Copilot sans les importer. [Guide des plugins →](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) · [Toutes les versions →](https://github.com/runkids/skillshare/releases) ## Pourquoi skillshare diff --git a/README-ja.md b/README-ja.md index 2821d91bb..6224b76b9 100644 --- a/README-ja.md +++ b/README-ja.md @@ -47,7 +47,7 @@

> [!NOTE] -> **最新バージョン**:v0.30.10 — skillshare が書き込んだ Codex のフックを信頼できます。`skillshare hooks sync --trust -g` は新規または変更されたフックをコマンド付きで一覧表示し、確認後に Codex の信頼を記録するので、Codex がフックをスキップしなくなります。スクリプト向けに `--yes` で確認を省略でき、ダッシュボードの Hooks ページにも同じ操作があります。 [hooks リファレンス →](https://skillshare.runkids.cc/ja/docs/reference/commands/hooks) · [変更履歴 →](https://skillshare.runkids.cc/changelog) +> **最新バージョン**:v0.30.11 — ダッシュボードから Pi パッケージを共有できます。Plugins ページの「共有」は、プラグインに続けて Pi が npm からインストールしたパッケージも一覧表示し、`skillshare plugin add npm: --target pi -g --no-tui` のようにすべてを追加するコマンドを 1 つコピーします。「ターゲット内の hook」ダイアログでは、Antigravity と Copilot の hook もインポートせずに編集・削除できます。 [プラグインガイド →](https://skillshare.runkids.cc/ja/docs/how-to/daily-tasks/sharing-plugins) · [変更履歴 →](https://skillshare.runkids.cc/changelog) ## skillshare を使う理由 diff --git a/README-ko.md b/README-ko.md index 22c291f81..4e3fd830f 100644 --- a/README-ko.md +++ b/README-ko.md @@ -47,7 +47,7 @@

> [!NOTE] -> **최신 버전**: v0.30.10 — skillshare가 기록한 Codex hook을 신뢰하세요. `skillshare hooks sync --trust -g`는 새로 추가되거나 변경된 hook을 command와 함께 나열하고, 확인하면 Codex의 신뢰를 기록하므로 Codex가 더 이상 건너뛰지 않습니다. 스크립트에서는 `--yes`로 질문을 건너뛸 수 있고, 대시보드의 Hooks 페이지에도 같은 동작이 있습니다. [hooks 레퍼런스 →](https://skillshare.runkids.cc/ko/docs/reference/commands/hooks) · [변경 기록 →](https://skillshare.runkids.cc/changelog) +> **최신 버전**: v0.30.11 — 대시보드에서 Pi 패키지를 공유하세요. Plugins 페이지의 「공유」는 이제 플러그인 다음에 Pi가 npm에서 설치한 패키지도 나열하고, `skillshare plugin add npm: --target pi -g --no-tui`처럼 모두 추가하는 명령 하나를 복사합니다. 「대상에 있는 hook」 대화상자는 Antigravity와 Copilot hook도 가져오지 않고 편집하거나 제거할 수 있습니다. [플러그인 가이드 →](https://skillshare.runkids.cc/ko/docs/how-to/daily-tasks/sharing-plugins) · [변경 기록 →](https://skillshare.runkids.cc/changelog) ## skillshare를 쓰는 이유 diff --git a/README-pt-BR.md b/README-pt-BR.md index 5073cabff..1f39706b2 100644 --- a/README-pt-BR.md +++ b/README-pt-BR.md @@ -47,7 +47,7 @@

> [!NOTE] -> **Versão mais recente**: v0.30.10 — Confie nos hooks do Codex que o skillshare grava: `skillshare hooks sync --trust -g` lista os hooks novos ou alterados com seus comandos e registra a confiança do Codex depois que você confirma, para que o Codex pare de ignorá-los. `--yes` pula a pergunta em scripts, e a página Hooks do dashboard tem a mesma ação. [Referência de hooks →](https://skillshare.runkids.cc/docs/reference/commands/hooks) · [Todas as versões →](https://github.com/runkids/skillshare/releases) +> **Versão mais recente**: v0.30.11 — Compartilhe seus pacotes do Pi pelo dashboard: **Compartilhar** na página Plugins agora lista, depois dos seus plugins, os pacotes npm que o Pi instalou e copia um comando que adiciona todos, como `skillshare plugin add npm: --target pi -g --no-tui`. O diálogo **Hooks nos destinos** também pode editar ou remover hooks do Antigravity e do Copilot sem importá-los. [Guia de plugins →](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) · [Todas as versões →](https://github.com/runkids/skillshare/releases) ## Por que skillshare diff --git a/README-zh-CN.md b/README-zh-CN.md index 19469daa5..f9f6dcf65 100644 --- a/README-zh-CN.md +++ b/README-zh-CN.md @@ -47,7 +47,7 @@

> [!NOTE] -> **最新版本**:v0.30.10 — 信任 skillshare 写入的 Codex hooks:`skillshare hooks sync --trust -g` 会列出新增或变更的 hooks 及其命令,在你确认后记录 Codex 的信任,Codex 就不会再跳过它们。脚本可用 `--yes` 跳过询问,dashboard 的 Hooks 页面也有相同的操作。 [hooks 参考 →](https://skillshare.runkids.cc/zh-Hans/docs/reference/commands/hooks) · [更新记录 →](https://skillshare.runkids.cc/changelog) +> **最新版本**:v0.30.11 — 从 dashboard 分享你的 Pi 包:Plugins 页面的「分享」现在会在 plugin 之后列出 Pi 从 npm 安装的包,并复制一条把它们全部加入的命令,例如 `skillshare plugin add npm: --target pi -g --no-tui`。「目标里的 hook」对话框也能直接修改或移除 Antigravity 和 Copilot 的 hook,不需要先导入。 [plugin 指南 →](https://skillshare.runkids.cc/zh-Hans/docs/how-to/daily-tasks/sharing-plugins) · [更新记录 →](https://skillshare.runkids.cc/changelog) ## 为什么用 skillshare diff --git a/README-zh-TW.md b/README-zh-TW.md index 43224d5ca..23ad3a1fe 100644 --- a/README-zh-TW.md +++ b/README-zh-TW.md @@ -47,7 +47,7 @@

> [!NOTE] -> **最新版本**:v0.30.10 — 信任 skillshare 寫入的 Codex hooks:`skillshare hooks sync --trust -g` 會列出新增或變更的 hooks 及其指令,在你確認後記錄 Codex 的信任,Codex 就不會再略過它們。腳本可用 `--yes` 略過詢問,dashboard 的 Hooks 頁面也有相同的操作。 [hooks 參考 →](https://skillshare.runkids.cc/zh-Hant/docs/reference/commands/hooks) · [更新紀錄 →](https://skillshare.runkids.cc/changelog) +> **最新版本**:v0.30.11 — 從 dashboard 分享你的 Pi 套件:Plugins 頁面的「分享」現在會在 plugin 之後列出 Pi 從 npm 安裝的套件,並複製一行把它們全部加入的指令,例如 `skillshare plugin add npm: --target pi -g --no-tui`。「目標裡的 hook」對話框也能直接修改或移除 Antigravity 和 Copilot 的 hook,不需要先匯入。 [plugin 指南 →](https://skillshare.runkids.cc/zh-Hant/docs/how-to/daily-tasks/sharing-plugins) · [更新紀錄 →](https://skillshare.runkids.cc/changelog) ## 為什麼用 skillshare diff --git a/README.md b/README.md index 8ebb4d92e..c4dc46570 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,7 @@

> [!NOTE] -> **Latest**: v0.30.10 — Trust the Codex hooks skillshare writes: `skillshare hooks sync --trust -g` lists the new or changed hooks with their commands and records Codex's trust once you confirm, so Codex stops skipping them. `--yes` skips the question for scripts, and the dashboard's Hooks page has the same action. [hooks reference →](https://skillshare.runkids.cc/docs/reference/commands/hooks) · [All releases →](https://github.com/runkids/skillshare/releases) +> **Latest**: v0.30.11 — Share your Pi packages from the dashboard: **Share** on the Plugins page now lists the npm packages Pi installed, after your plugins, and copies one command that adds them all, such as `skillshare plugin add npm: --target pi -g --no-tui`. The **Hooks in targets** dialog can also edit or remove Antigravity and Copilot hooks without importing them. [Plugins guide →](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) · [All releases →](https://github.com/runkids/skillshare/releases) ## Why skillshare diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 30f646ddd..b1e7704ce 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -98,6 +98,18 @@ skillshare sync plugins --no-tui Markdown をレンダリングした状態で読み取り専用表示するものです。インポートされたプラグインには ローカルコピーがないため、この項目はありません。 +ページヘッダーまたはプラグインのメニューにある **Share** は、HTTPS の Git Source から追加したプラグインを +一覧表示します。複数にチェックを入れると、それらを順に追加するコマンドを 1 つコピーできます。各 add には `-g` が付くため、 +プロジェクト内で実行してもグローバル設定に追加されます。既定では `--no-tui` も付き、確認なしで Skillshare に追加します。 +実行した人は、その後 Plugins ページで Agent にチェックを入れてインストールします。「項目ごとにインストール先を確認する」に +チェックを入れると `--no-tui` が外れ、追加のたびに Agent の選択画面が開きます。ローカルディレクトリから追加したプラグインは、 +そのパスが自分のマシンにしかないため一覧に出ません。 + +同じダイアログには、プラグインに続けて Pi が npm からインストールした Pi パッケージも並びます。npm パッケージは Pi 自身が +ダウンロードするため、コマンドは target を指定します。`skillshare plugin add npm: --target pi -g --no-tui` は +そのまま Pi にインストールします。「項目ごとにインストール先を確認する」にチェックを入れると `--target pi` が外れ、 +どの Pi target を使うかを確認します。Git やローカルパスから入れた Pi パッケージは一覧に出ません。 + プラグインは通常の skills や MCP の Sync とは別物です。バンドルされたコンポーネントが、独立した skillshare の Source にコピーされることはありません。 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 813dced95..d94684800 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 @@ -96,7 +96,7 @@ skillshare ui start --clear-cache | **Skills** / **Agents** | インストール済みの項目、**Updates** タブ、**Trash** タブ。Skills にはさらに、Target のコンテキストに Skill が追加するトークン数を見積もる **Analyze** タブがある。**Install** は GitHub を検索するか、URL やパスからインストールする。メニューには作成ウィザードを開く **New skill** と **Link folder** もある。config にまだインストールされていないエントリがあるときは、**Updates** タブとインストールダイアログに **Install all** が表示され、引数なしの [`install`](/docs/reference/commands/install) と同じように動く。チェックのあと、ソース repo から削除された Skill が **Prune** と **Prune all** 付きで表示され、ゴミ箱に移せる。**Link folder** は [`link`](/docs/reference/commands/link) と同様にフォルダを Skill の source にリンクする。パス、任意のリンク名、`follow_source_links` が無効の間はそれを有効にするチェックボックスを受け付け、拒否されたフォルダにはコマンドと同じ理由を表示する。リンクしたフォルダはリンクアイコンとリンク先フォルダ付きの独立したグループとして表示される。その行のアイコンボタン(ホバーするとリンクアイコンがリンク解除アイコンに変わる)は確認後、[`unlink`](/docs/reference/commands/unlink) と同様にリンクを解除する。フォルダ自体には触れず、リンクは **Trash** タブから復元できる。リンクしたフォルダ内の Skill は個別にアンインストールでき、そのフォルダから trash へ移動される。リンクしたフォルダには **Update repo** と **Uninstall repo** はない。一覧とカードビューは **Folder**(tracked repo、`frontend/react` のようなフォルダ、または **Root**)でフィルタでき、**Folder** でグループ化もできる。Root が先頭で、残りのフォルダは名前の A→Z 順。リストビューでは、別のスキルのフォルダ内にあるスキルはそのスキルの下に表示されます。パッケージ名の後ろにある件数ボタンで、そのスキルが下に開き、淡いツリー線でパッケージとつながります(パッケージは最初は折りたたまれています)。さらに深いパッケージはもう一段インデントされます。検索中は一致を含むパッケージが開き、`1 / 3` のような件数を表示し、名前の一致部分を強調します。検索中に閉じたパッケージは検索が変わると再び開き、それ以前に開いていたパッケージはそのまま残ります。ページ送りは最上位の行だけを数えます。各行には frontmatter の `description` が 1 行で表示され、行にキーボードフォーカスがあるときは全文が表示されます。**グループと並び順** → **表示** → **説明** で非表示にできます。**すべて展開** / **すべて折りたたむ** はパッケージも開閉し、選択バーは選択中で表示されていない項目の数を示します。詳細ページを開くのは名前のクリックだけです。パッケージをアンインストールすると、そのフォルダ内のスキルも trash に移動され、確認ダイアログにその数が表示されます。**tree** ビューは左に source のフォルダ、右に詳細を表示する。フォルダや Skill をクリックして選択し、Cmd/Ctrl クリックで選択に追加、Shift クリックで範囲選択、Skill をダブルクリックで開く。右側では、選択したものすべてを 1 つのスイッチで有効・無効にし(`.skillignore.local` の `!` ルールが有効のまま保つ項目は、理由とともに失敗として報告されます)、targets を設定し(tracked repo とそのサブフォルダも含む)、各 Skill を個別のスイッチ付きで一覧する。tracked repo では **Update repo** と **Uninstall repo** も使える。`disable-model-invocation: true` を持つ Skill は、一覧・タイル・詳細ページで **manual only** タグが付く。これは [`list`](/docs/reference/commands/list) で `m` キーが切り替えるのと同じ状態。リモートの既定ブランチ以外から入れた skill(`install --branch`)は、一覧、タイル、**Updates** タブにそのブランチがタグで表示される。リモートソースから入れた skill の詳細ページ(tracked repo は除く。こちらは **Git Sync** でブランチを切り替える)では、**Branch** にソースのブランチが並ぶ。ホストを問わず、どの Git リモート(HTTPS でも SSH でも)でも使える。ブランチを選ぶと確認のうえ、update と同じセキュリティ監査とローカル変更チェックを通してそのブランチから再インストールする。そのブランチにこの skill がなければ、現在のインストールはそのまま残る。プロジェクトでは、切り替えに成功するとそのブランチが `.skillshare/config.yaml` にも記録され、チームメイトもそのブランチからインストールする。Skill エディタでは、**Add field** が各フロントマターフィールドの説明を表示する。**Sync skills** / **Sync agents** はプレビューしてから、その種類だけをすべての Target に sync する。update、アンインストール、collect の後に表示される **Sync Now** からも同じダイアログが開く。ファイルブラウザーは、たどられた source リンク自体が Skill のルートである場合も、そのリンクを通して `SKILL.md` と添付ファイルを一覧表示します。 | | **Extras** | **フォルダー**: Skill と一緒に sync される rules、commands、その他のフォルダ。**Edit target** で Target のフォルダ、ファイル名、モード、flatten、[ファイルフィルター](./extras.md#choosing-files)をプレビューしながら変更できる。**Edit extra** で Extra の名前を変えたり、別のソースフォルダを指定したりできる。**AGENTS.md**: global モードでは共有 `AGENTS.md` と、それを使う Target。Project では Project の `./AGENTS.md` と、各 Target がそれを読み込めるか。[1 つの AGENTS.md をツール間で共有する](../../how-to/daily-tasks/sharing-instructions.md)を参照 **Memory**: [メモリ共有ガイド](../../how-to/daily-tasks/sharing-memory.md)(英語スクリーンショット)。ノートの検索、プレビュー、編集、削除、INDEX リンク、競合時の下書き保持、Backup Files の履歴と復元、**Connect to agents** → **Review changes** → **Apply changes**。設定状態は読み取り済みを示しません | | **MCP** | サーバーごとに 1 行表示され、sync 先の Agent がチップとして並び、行のカウントボタンでそれらのトグルを開く。**サーバーを追加** は URL、コマンド、貼り付けたスニペット、またはファイルを受け付ける。**target からインポート** はインストール済みの Agent が既に持っているものを読み込む。各サーバーのメニューには **各 Agent に書き込まれる設定を表示** があり、source とすべての Agent のファイルを一覧表示し、選んだものを未保存の編集を含めて表示する。コンフリクトでは **その Agent からインポート** か **ソースで上書き** を選べる。サーバーのダイアログの **ツール** セクションでは [ツールポリシー](./mcp.md#tool-policy) を設定する。保存済みかどうかに関係なくダイアログの現在の設定でサーバーを一度起動し、ツールをチェックできる一覧にする **ツールを読み込む**、`*` パターン用の **除外ルール** の行がある。ポリシーの一部を適用しない選択中の Agent がそれぞれ表示され、ポリシーを設定すると行にタグが付く。Pi サーバーでは、ダイアログに [Pi の内蔵 MCP](./mcp.md#pi) の設定もあり、ツールの公開方法とその他の Pi 設定を扱い、後者は [`piOptions`](./mcp.md#pi-options) を JSON で受け付ける。説明は情報アイコンのツールチップに表示される。**デフォルト** は `mcp.targets` を編集する。Sync ボックスの **Sync MCP** は保留中の変更を一覧表示し、MCP の設定ファイルだけを書き込み、それぞれのバックアップを保存する。その下では [**チェック**](./mcp.md#check-servers-before-an-agent-starts-them) がサーバーをチェックし、**バックアップと復元** でそれらのバックアップをプレビューして復元できる。 | -| **Plugins** | Plugin ごとに 1 行表示され、その Agent がトグルとして並ぶ。行を展開すると、そのソースが対応する他の Agent も一覧され、いずれかにチェックを入れるとインストールのプレビューが表示される。行のメニューから sync、update、削除ができ、Skillshare がレビューしたローカルコピーを読み取り専用で閲覧する **View files** も開ける。[Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) を参照 | +| **Plugins** | Plugin ごとに 1 行表示され、その Agent がトグルとして並ぶ。行を展開すると、そのソースが対応する他の Agent も一覧され、いずれかにチェックを入れるとインストールのプレビューが表示される。行のメニューから sync、update、削除ができ、Skillshare がレビューしたローカルコピーを読み取り専用で閲覧する **View files** も開ける。**Share** は、チェックした plugin を HTTPS ソースから追加し、チェックした npm の Pi パッケージを Pi にインストールさせるコマンドを 1 つコピーする。[Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) を参照 | | **Targets** | ステータス付きの Target 一覧。**ターゲットを追加** では **別のアカウント** も選べます。すでに使っている Agent の 2 つ目の config フォルダで、書き込み先のプレビューが付きます。各 Target のページで include/exclude フィルタを編集し、ローカルのみの Skill を Source に collect し戻せる。フィルタのプレビュー上部の検索ボックスで行を名前で絞り込み、一致した部分を強調表示できる。変わるのは表示だけで、フィルタ自体は変わらない。Project のページと Extras の **Edit target** ダイアログも同じプレビューと検索を使う。**Syncing** 列には各 Target が受け取るものがリンクとして並ぶ。**Skills**、**Agents**、**MCP**、**Hooks** とその数、Pi の **Extensions**、そして共有 `AGENTS.md` が接続済みの Target の指示ファイルで、クリックすると Target ページの該当タブが開く。MCP 設定ファイルを持つ Target には **MCP** タブがあり、サーバーごとに 1 行で選ぶ。クリックするとすぐ保存され、**Sync all targets** ですべての Target の MCP ファイルに書き込まれる。各 Target には、そのファイル名のタブ(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md** など)もあり、読み込み順を表示し、ファイルを編集し、`AGENTS.md` に変換できる | | **Projects** | global mode のみ。global config が sync する project フォルダーで、`config.yaml` の [`projects`](/docs/reference/targets/configuration#projects)、このマシンだけに保存された project(**このマシン** と表示)、[`mcp.projects`](./mcp.md#projects-in-the-dashboard) から一覧される。同じ project はターミナルから [`skillshare project`](./project.md) でも管理できる。**プロジェクトを追加** はフォルダー、その target、sync する内容を指定し、ダイアログ下部の **保存先** で **このマシンのみ** を選ばない限り `config.yaml` に保存する([`projects_storage`](/docs/reference/targets/configuration#projects-storage) が `machine-local` のときはこちらが既定)。編集は project が保存されている場所に保存される。保存済みの project を移すには `skillshare project localize` または `share` を使う。このマシンが上書きしている project を削除すると、このマシンのコピーだけを削除するか、`config.yaml` 側も削除するかを確認する。各 project には **Skills** と **Agents** タブがあり、フィルター、プレビュー、書き込まれるフォルダーを表示する。**MCP** タブでは、そのフォルダー内で global サーバーをオフにしたり、その project 独自のサーバーを追加したりでき、それらのサーバー用の **チェック** もある。**Sync project** はプレビューしてから、その project の skills、agents、MCP だけを sync する。すでに project フォルダーを指している Target は変換できる | | **Audit** | Skill と Agent のセキュリティスキャン。重大度別の検出結果を表示。[たどる source link](/docs/reference/targets/configuration#follow_source_links) を読み取れなかった場合は、Skills / Agents タブの横に **スキャン未完了** と表示され、部分的なスキャンが完全なスキャンと誤認されないようになる。このときスキャン後は問題なしではなく警告を表示し、ダッシュボードの **Needs attention** にも表示される。**Rules** タブでは、カテゴリごとにすべてのルールを閲覧できる: ルールをオフにする、重大度を変更する、カテゴリ全体に重大度を適用する、スキャンプロファイル(`default`、`strict`、`permissive`)を選ぶ、カスタム `audit-rules.yaml` のエディタを開く、のいずれかができる | diff --git a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index cd0ede997..00d2bf816 100644 --- a/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/ko/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -100,6 +100,17 @@ skillshare sync plugins --no-tui 읽기 전용 검토된 로컬 복사본입니다. Import된 플러그인은 로컬 복사본이 없으므로 이 항목도 없습니다. +페이지 헤더나 플러그인 메뉴의 **Share**는 HTTPS Git Source에서 추가한 플러그인을 나열합니다. 여러 개를 선택하면 +순서대로 모두 추가하는 명령 하나를 복사할 수 있습니다. 모든 add에 `-g`가 붙으므로 프로젝트 안에서 실행해도 전역 설정에 +추가됩니다. 기본으로 `--no-tui`도 붙어 묻지 않고 Skillshare에 추가하며, 실행한 사람은 그 뒤 Plugins 페이지에서 Agent를 +선택해 설치합니다. 「항목마다 설치할 위치 묻기」를 선택하면 `--no-tui`가 빠지고 추가할 때마다 Agent 선택 화면이 열립니다. +로컬 디렉터리에서 추가한 플러그인은 그 경로가 내 기기에만 있으므로 나열되지 않습니다. + +같은 대화상자는 플러그인 다음에 Pi가 npm에서 설치한 Pi 패키지도 나열합니다. npm 패키지는 Pi가 직접 내려받으므로 +명령이 target을 지정합니다. `skillshare plugin add npm: --target pi -g --no-tui`는 바로 Pi에 설치합니다. +「항목마다 설치할 위치 묻기」를 선택하면 `--target pi`가 빠지고 어떤 Pi target을 쓸지 묻습니다. Git이나 로컬 경로에서 +설치한 Pi 패키지는 나열되지 않습니다. + 플러그인은 일반 Skill 및 MCP 동기화와는 별개입니다. 이들의 번들 구성 요소는 독립적인 Skillshare Source에도 복사되지 않습니다. 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 6093bfddf..4863d55f8 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 @@ -96,7 +96,7 @@ skillshare ui start --clear-cache | **Skills** / **Agents** | 설치된 항목, **Updates** 탭, **Trash** 탭. Skills에는 각 skill이 target의 context에 추가하는 토큰 수를 추정하는 **Analyze** 탭도 있습니다. **Install**은 GitHub를 검색하거나 URL 또는 경로에서 설치합니다. 메뉴에는 생성 마법사를 여는 **New skill**과 **Link folder**도 있습니다. config에 아직 설치되지 않은 항목이 있으면 **Updates** 탭과 설치 대화 상자에 **Install all**이 표시되며, 인자 없는 [`install`](/docs/reference/commands/install)과 같이 동작합니다. 확인을 실행한 후에는 소스 repo에서 삭제된 skill이 **Prune**, **Prune all**과 함께 표시되어 휴지통으로 옮길 수 있습니다. **Link folder**는 [`link`](/docs/reference/commands/link)처럼 폴더를 skills source에 링크합니다. 경로, 선택적인 링크 이름, 그리고 `follow_source_links`가 꺼져 있는 동안에는 이를 켜는 체크박스를 받으며, 거부된 폴더에는 명령과 같은 이유를 표시합니다. 링크된 폴더는 링크 아이콘과 가리키는 폴더가 표시된 별도 그룹으로 나열됩니다. 그 행의 아이콘 버튼(마우스를 올리면 링크 아이콘이 링크 해제 아이콘으로 바뀜)은 확인을 거친 뒤 [`unlink`](/docs/reference/commands/unlink)처럼 링크를 해제합니다. 폴더 자체는 건드리지 않으며 링크는 **Trash** 탭에서 복원할 수 있습니다. 링크된 폴더 안의 skill은 개별로 제거할 수 있으며, 그 폴더에서 trash로 옮겨집니다. 링크된 폴더에는 **Update repo**와 **Uninstall repo**가 없습니다. 목록과 카드 보기는 **Folder**(tracked repo, `frontend/react` 같은 폴더, 또는 **Root**)로 필터링하고 **Folder**로 그룹화할 수 있으며, Root가 먼저 오고 나머지 폴더는 이름 A→Z 순입니다. 목록 보기에서는 다른 skill의 폴더 안에 있는 skill이 그 skill 아래에 표시됩니다. 패키지 이름 뒤의 개수 버튼을 누르면 그 skill들이 아래에 열리고 옅은 트리 선으로 패키지와 이어지며(패키지는 처음에 접혀 있음), 더 깊은 패키지는 한 단계 더 들여쓰기됩니다. 검색하면 일치 항목이 있는 패키지가 열리고 `1 / 3` 같은 개수를 보여 주며, 이름에서 일치하는 부분을 강조합니다. 검색 중에 닫은 패키지는 검색이 바뀌면 다시 열리고, 그 전에 열어 둔 패키지는 그대로 유지됩니다. 페이지 나눔은 최상위 행만 셉니다. 각 행에는 frontmatter의 `description`이 한 줄로 표시되고, 행에 키보드 포커스가 있으면 전체가 표시됩니다. **그룹 및 정렬** → **표시** → **설명**으로 숨길 수 있습니다. **모두 펼치기** / **모두 접기**는 패키지도 열고 닫으며, 선택 바는 선택했지만 보이지 않는 항목 수를 알려 줍니다. 상세 페이지는 이름을 클릭할 때만 열립니다. 패키지를 제거하면 그 폴더 안의 skill도 trash로 옮겨지며, 확인 창에 그 개수가 표시됩니다. **tree** 보기는 왼쪽에 source 폴더를, 오른쪽에 상세 정보를 보여 줍니다. 폴더나 skill을 클릭해 선택하고, Cmd/Ctrl 클릭으로 선택에 추가하고, Shift 클릭으로 범위를 선택하며, skill을 더블클릭하면 열립니다. 오른쪽에서는 선택한 모든 항목을 스위치 하나로 켜거나 끄고(`.skillignore.local`의 `!` 규칙이 켜 둔 채로 유지하는 항목은 이유와 함께 실패로 보고됩니다), targets를 설정하며(tracked repo와 그 하위 폴더 포함), 각 skill을 개별 스위치와 함께 나열합니다. tracked repo에는 **Update repo**와 **Uninstall repo**도 있습니다. `disable-model-invocation: true`가 설정된 skill은 목록, 타일, 상세 페이지에 **manual only** 태그가 표시되며, 이는 [`list`](/docs/reference/commands/list)에서 `m`으로 전환하는 것과 같은 상태입니다. 원격 기본 브랜치가 아닌 브랜치에서 설치한 skill(`install --branch`)은 목록, 타일, **Updates** 탭에 그 브랜치가 태그로 표시됩니다. 원격 소스에서 설치한 skill의 상세 페이지에서는(tracked repo 제외, tracked repo는 **Git Sync**에서 브랜치를 바꿉니다) **Branch**에 소스의 브랜치가 나열됩니다. 호스트와 관계없이 모든 Git 원격(HTTPS 또는 SSH)에서 사용할 수 있습니다. 브랜치를 고르면 확인을 거친 뒤 update와 같은 보안 감사와 로컬 변경 검사를 거쳐 그 브랜치에서 다시 설치합니다. 그 브랜치에 해당 skill이 없으면 현재 설치가 그대로 유지됩니다. 프로젝트에서는 전환에 성공하면 그 브랜치가 `.skillshare/config.yaml`에도 기록되어 팀원도 그 브랜치에서 설치합니다. skill 편집기에서 **Add field**는 각 frontmatter 필드가 하는 역할을 설명합니다. **Sync skills** / **Sync agents**는 미리 본 뒤 해당 종류만 모든 target에 동기화합니다. 업데이트, 제거 또는 collect 후에는 **Sync Now**에서 같은 대화상자가 열립니다. 파일 브라우저는 연결된 source 링크 자체가 skill의 루트인 경우에도 링크를 통해 `SKILL.md`와 첨부 파일을 나열합니다. | | **Extras** | **폴더**: skill과 함께 동기화되는 rules, commands, 기타 폴더. **Edit target**으로 target의 폴더, 파일 이름, 모드, flatten 설정, [파일 필터](./extras.md#choosing-files)를 미리 보며 바꿀 수 있고, **Edit extra**로 extra 이름을 바꾸거나 다른 소스 폴더를 가리키게 할 수 있습니다. **AGENTS.md**: global 모드에서는 공유 `AGENTS.md`와 그것을 쓰는 target, 프로젝트에서는 프로젝트의 `./AGENTS.md`와 각 target이 그것을 읽는지 여부. [여러 도구에서 하나의 AGENTS.md 공유하기](../../how-to/daily-tasks/sharing-instructions.md)를 참고하세요 **Memory**: [메모리 공유 가이드](../../how-to/daily-tasks/sharing-memory.md)(영어 스크린샷). 노트 검색, 미리 보기, 편집, 삭제, INDEX 링크, 충돌 시 초안 보존, Backup Files 기록과 복원, **Connect to agents** → **Review changes** → **Apply changes**. 설정 상태는 읽기를 증명하지 않습니다 | | **MCP** | 서버당 한 행이며, 동기화 대상인 Agent가 chip으로 표시되며, 행의 카운트 버튼을 누르면 해당 토글이 열립니다. **서버 추가**는 URL, command, 붙여넣은 snippet 또는 파일을 받습니다. **target에서 가져오기**는 설치된 Agent가 이미 가지고 있는 것을 읽어옵니다. 각 서버의 메뉴에는 **각 Agent에 기록될 설정 보기**가 있어 source와 모든 Agent의 파일을 나열하고, 선택한 파일을 저장되지 않은 편집을 포함해 보여줍니다. 충돌 시 **해당 Agent에서 가져오기** 또는 **원본으로 덮어쓰기**를 제공합니다. 서버 대화상자의 **도구** 섹션은 [도구 정책](./mcp.md#tool-policy)을 설정합니다: 저장 여부와 관계없이 대화상자의 현재 설정으로 서버를 한 번 시작해 도구를 선택할 수 있는 목록으로 보여 주는 **도구 불러오기**, `*` 패턴용 **제외 규칙** 행이 있습니다. 이 섹션은 정책 일부를 적용하지 않는 선택된 Agent를 각각 나열하며, 정책이 설정되면 행에 태그가 표시됩니다. Pi 서버의 경우, 대화상자에는 [Pi 내장 MCP](./mcp.md#pi) 설정도 있습니다: 도구 노출 방식과 기타 Pi 설정이며, 이 설정은 [`piOptions`](./mcp.md#pi-options)를 JSON으로 받고 도움말은 정보 툴팁에 있습니다. **기본값**은 `mcp.targets`를 편집합니다. Sync 박스의 **Sync MCP**는 대기 중인 변경 사항을 나열하고 MCP 설정 파일만 작성하며, 각 파일의 백업을 남깁니다. 그 아래에서 [**검사**](./mcp.md#check-servers-before-an-agent-starts-them)는 서버를 검사하고, **백업 및 복원**는 그 백업을 미리 보고 복원합니다. | -| **Plugins** | plugin당 한 행이며, 해당 Agent가 토글로 표시됩니다. 행을 펼치면 소스가 지원하는 다른 Agent도 나열되며, 하나를 선택하면 설치를 미리 봅니다. 행 메뉴는 sync, update, remove를 수행하거나, Skillshare가 검토한 로컬 사본을 읽기 전용으로 탐색하는 **View files**를 엽니다. [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) 참고 | +| **Plugins** | plugin당 한 행이며, 해당 Agent가 토글로 표시됩니다. 행을 펼치면 소스가 지원하는 다른 Agent도 나열되며, 하나를 선택하면 설치를 미리 봅니다. 행 메뉴는 sync, update, remove를 수행하거나, Skillshare가 검토한 로컬 사본을 읽기 전용으로 탐색하는 **View files**를 엽니다. **Share**는 선택한 plugin을 HTTPS 소스에서 추가하고 선택한 npm Pi 패키지를 Pi가 설치하게 하는 명령 하나를 복사합니다. [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) 참고 | | **Targets** | 상태가 표시된 target 목록. **대상 추가**는 **다른 계정**도 받습니다. 이미 사용 중인 Agent의 두 번째 config 폴더이며, 어디에 기록되는지 미리보기로 보여줍니다. 각 target의 페이지에서 include/exclude 필터를 편집하고 로컬 전용 skill을 source로 다시 수집합니다. 필터 미리보기 위의 검색 상자로 행을 이름으로 좁히고 일치하는 부분을 강조합니다. 보이는 행만 바뀌고 필터는 바뀌지 않습니다. 프로젝트 페이지와 Extras의 **Edit target** 대화상자도 같은 미리보기와 검색을 씁니다. **Syncing** 열에는 각 target이 받는 것이 링크로 표시됩니다. **Skills**, **Agents**, **MCP**, **Hooks**와 그 수, Pi의 **Extensions**, 그리고 공유 `AGENTS.md`가 연결된 target의 지침 파일이며, 클릭하면 target 페이지의 해당 탭이 열립니다. MCP 설정 파일이 있는 target에는 **MCP** 탭이 있어 서버마다 한 행으로 고릅니다. 클릭하면 바로 저장되고 **Sync all targets**가 모든 target의 MCP 파일에 기록합니다. 각 target에는 지침 파일 이름을 딴 탭(**CLAUDE.md**, **GEMINI.md**, **AGENTS.md**, ...)도 있어, 읽는 순서를 보여 주고 파일을 편집하며 `AGENTS.md`로 변환합니다 | | **프로젝트** | Global mode 전용. global 설정이 동기화하는 프로젝트 폴더이며, `config.yaml`의 [`projects`](/docs/reference/targets/configuration#projects), 이 기기에만 보관한 프로젝트(**이 기기**으로 표시), [`mcp.projects`](./mcp.md#projects-in-the-dashboard)에서 옵니다. 같은 프로젝트는 터미널에서 [`skillshare project`](./project.md)로도 관리할 수 있습니다. **프로젝트 추가**는 폴더, 그 target, 동기화할 항목을 받고, 대화 상자 아래쪽 **저장 위치**에서 **이 기기에만**을 고르지 않으면 `config.yaml`에 저장합니다([`projects_storage`](/docs/reference/targets/configuration#projects-storage)가 `machine-local`이면 이것이 기본값입니다). 편집은 프로젝트가 저장된 곳에 저장됩니다. 저장된 프로젝트를 옮기려면 `skillshare project localize` 또는 `share`를 사용하세요. 이 기기가 재정의한 프로젝트를 제거하면 이 기기의 사본만 제거할지 `config.yaml`의 항목도 함께 제거할지 묻습니다. 각 프로젝트에는 필터, 미리보기, 기록될 폴더를 보여주는 **Skills**와 **Agents** 탭, 그리고 해당 폴더에서 global 서버를 끄거나 프로젝트 자체 서버를 부여하며 그 서버를 위한 **검사**가 있는 **MCP** 탭이 있습니다. **Sync project**는 미리 본 뒤 해당 프로젝트의 skill, agent, MCP만 동기화합니다. 이미 프로젝트 폴더를 가리키는 Target은 변환할 수 있습니다 | | **Audit** | skill과 agent에 대한 보안 스캔이며, 심각도별로 findings를 표시합니다. [따라가는 source link](/docs/reference/targets/configuration#follow_source_links)를 읽지 못하면 Skills / Agents 탭 옆에 **스캔 미완료**가 표시되어 부분 스캔이 전체 스캔으로 오인되지 않습니다. 이때 스캔 후에는 문제 없음 대신 경고를 표시하고, 대시보드의 **Needs attention**에도 표시됩니다. **Rules** 탭에서는 카테고리별로 모든 rule을 탐색할 수 있습니다: rule을 끄거나, 심각도를 변경하거나, 카테고리 전체에 심각도를 적용하거나, 스캔 profile(`default`, `strict`, `permissive`)을 선택하거나, 사용자 지정 `audit-rules.yaml` 편집기를 엽니다 | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index 14f230f93..cf56e0ce1 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -97,6 +97,17 @@ skillshare sync plugins --no-tui 为只读,并以渲染后的 Markdown 呈现。被 import 的 plugin 没有本地副本,因此 也没有此选项。 +页面标题栏或 plugin 菜单中的 **Share** 会列出从 HTTPS Git Source 添加的 plugin。勾选几个后, +复制一条命令即可按顺序把它们全部加入。每个 add 都带 `-g`,所以即使在项目里运行,也会加入全局配置。 +命令默认还带 `--no-tui`,加入时不会询问;运行的人之后再到 Plugins 页面勾选 Agent 安装。 +勾选「每个项目都询问要安装到哪里」会去掉 `--no-tui`,每次加入都会打开 Agent 选择界面。 +来自本地目录的 plugin 不会列出,因为那个路径只存在于你的机器上。 + +同一个对话框还会在 plugin 之后列出 Pi 从 npm 安装的 Pi 包。npm 包由 Pi 自己下载,所以命令会指定 target: +`skillshare plugin add npm: --target pi -g --no-tui` 会直接装进 Pi。 +勾选「每个项目都询问要安装到哪里」时,命令不带 `--target pi`,改为询问要用哪些 Pi target。 +来自 Git 或本地路径的 Pi 包不会列出。 + Plugin 与一般的 Skill 及 MCP 同步是彼此独立的。它们所打包的 组件不会同时被复制进独立的 Skillshare Source 中。 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 e2ff48df8..2d1df3f12 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 @@ -96,7 +96,7 @@ skillshare ui start --clear-cache | **Skills** / **Agents** | 已安装的项目、**Updates** 标签页,以及 **Trash** 标签页。Skills 还有一个 **Analyze** 标签页,估算每个 skill 为某个 target 的上下文增加了多少 token。**Install** 可从 GitHub 搜索,或从 URL 或路径安装。菜单里还有打开创建向导的 **New skill** 和 **Link folder**。config 中有尚未安装的条目时,**Updates** 标签页和安装对话框会提供 **Install all**,效果同不带参数的 [`install`](/docs/reference/commands/install)。执行检查后,已从来源 repo 删除的 skills 会列出并提供 **Prune** 和 **Prune all**,把它们移到回收站。**Link folder** 与 [`link`](/docs/reference/commands/link) 一样把文件夹链接到 skills Source:填写路径、可选的链接名,`follow_source_links` 关闭时还有一个开启它的复选框;被拒绝的文件夹会显示与命令相同的原因。链接的文件夹会以独立分组列出,带有链接图标和它指向的文件夹;该行的图标按钮(悬停时链接图标变为取消链接图标)会先确认,再像 [`unlink`](/docs/reference/commands/unlink) 一样取消链接:文件夹本身不受影响,链接可以从 **Trash** 标签页恢复。链接文件夹里的 skill 仍可单独卸载,它会从该文件夹移到 trash;链接的文件夹没有 **Update repo** 和 **Uninstall repo**。列表和卡片视图可以按 **Folder**(tracked repo、`frontend/react` 这类文件夹,或 **Root**)过滤,也可以按 **Folder** 分组,Root 排在最前,其余文件夹按名称 A→Z 排序。列表视图中,位于另一个 skill 文件夹里的 skill 会列在那个 skill 下方:点 package 名称后面的数量按钮,会在下方展开它的 skill,并用淡淡的树状线连到 package(package 默认折叠),更深的 package 再往内缩进。搜索时会展开含有匹配项的 package,显示 `1 / 3` 这样的数量,并标出名称里匹配的文字;搜索中收起的 package 在搜索改变后会重新展开,搜索前展开的 package 保持不变。分页只计算顶层的行。每一行以一行显示 frontmatter 里的 `description`,该行获得键盘焦点时显示全文;可在 **分组与排序** → **显示** → **描述** 隐藏。**全部展开** / **全部折叠**也会展开和折叠 package,选择栏会显示已选但未显示的项目数。只有点名称才会打开详情页。卸载 package 时,它文件夹里的 skill 也会一起移到 trash,确认对话框会显示数量。**tree** 视图左侧显示 source 文件夹,右侧显示详情:点击文件夹或 skill 进行选择,Cmd/Ctrl 点击加入选择,Shift 点击选择范围,双击 skill 打开它。右侧可以用一个开关启用或停用所有选中的项目(被 `.skillignore.local` 的 `!` 规则保持启用的项目会报告为失败并附上原因)、设置它们的 targets(包括 tracked repo 及其子文件夹),并列出每个 skill 各自的开关;tracked repo 还提供 **Update repo** 和 **Uninstall repo**。带有 `disable-model-invocation: true` 的 skill 会在列表、卡片和详情页上带有 **manual only** 标签,这与 [`list`](/docs/reference/commands/list) 用 `m` 切换的状态相同。从远程默认分支以外的分支安装的 skill(`install --branch`)会在列表、卡片和 **Updates** 标签页上以标签显示该分支。从远程来源安装的 skill(tracked repo 除外,它在 **Git Sync** 切换分支)在详情页的 **Branch** 中列出来源的分支,适用于任何主机上的 Git 远程(HTTPS 或 SSH)。选择分支后会先确认,再经过与 update 相同的安全审计和本地修改检查,从该分支重新安装。如果该分支没有这个 skill,会保留当前的安装。在项目中,切换成功后也会把分支记录到 `.skillshare/config.yaml`,让团队成员从该分支安装。在 skill 编辑器中,**Add field** 会描述每个 frontmatter 字段的作用。**Sync skills** / **Sync agents** 会先预览,然后只将该类型 sync 到每个 target;在更新、卸载或 collect 之后,点击 **Sync Now** 也会打开同一个对话框。文件浏览器会通过被跟随的 source 链接列出 `SKILL.md` 和附件,包括链接本身就是 skill 根目录的情况。 | | **Extras** | **文件夹**:与 skills 一起同步的 rules、commands 和其他目录。**Edit target** 可修改 Target 的文件夹、文件名、模式、flatten 设置和[文件过滤](./extras.md#choosing-files),并实时预览;**Edit extra** 可重命名 extra,或改为指向另一个来源文件夹。**AGENTS.md**:在 global mode 下是共享 `AGENTS.md` 以及哪些 target 在使用它们;在项目中是项目的 `./AGENTS.md` 以及每个 target 是否会读取它。参见[让多个工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) **Memory**: [记忆共享教程](../../how-to/daily-tasks/sharing-memory.md)(英文截图)。搜索、预览、编辑、删除笔记、INDEX 链接、冲突时保留草稿、Backup Files 历史与恢复,以及 **Connect to agents** → **Review changes** → **Apply changes**;配置状态不代表已读取 | | **MCP** | 每个 server 一行,并以 chip 显示它同步到的 Agents;行上的计数按钮会打开它们的开关。**添加服务器** 接受 URL、命令、粘贴的片段或文件;**从目标导入** 会读取某个已安装 Agent 现有的配置。每个 server 的菜单都有 **查看各 Agent 会写入的配置**,会列出来源和每个 Agent 的文件,并显示你选中的那一个,包括尚未保存的编辑。冲突会提供 **从该 Agent 导入** 或 **使用来源覆盖**。server 对话框的 **工具** 区块用于设置[工具策略](./mcp.md#tool-policy):**加载工具**,它会用对话框当前的设置(无论是否已保存)启动 server 一次并列出工具供勾选;用于 `*` 通配符的 **排除规则** 行;该区块会列出每个未应用部分策略的所选 Agent,设置了策略时该行会显示一个标签。对于 Pi server,对话框还提供 [Pi 内置 MCP](./mcp.md#pi) 的设置:工具暴露方式和其他 Pi 设置,后者以 JSON 形式填写 [`piOptions`](./mcp.md#pi-options),说明位于信息提示中。**默认值** 用于编辑 `mcp.targets`。Sync 框中的 **Sync MCP** 会列出待写入的更改,并只写入 MCP 配置文件,同时为每个文件保留一份备份;其下方的 [**检查**](./mcp.md#check-servers-before-an-agent-starts-them) 用于检查 server,**备份与还原** 用于预览并恢复这些备份。 | -| **Plugins** | 每个 plugin 一行,以及它的 Agents 开关。展开一行还会列出该来源支持的其他 Agents;勾选一个会预览安装效果。行菜单可以同步、更新、移除,或打开 **View files**,即 Skillshare 审阅过的本地副本的只读浏览器。参见 [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) | +| **Plugins** | 每个 plugin 一行,以及它的 Agents 开关。展开一行还会列出该来源支持的其他 Agents;勾选一个会预览安装效果。行菜单可以同步、更新、移除,或打开 **View files**,即 Skillshare 审阅过的本地副本的只读浏览器。**Share** 会复制一条命令,从 HTTPS 来源添加勾选的 plugin,并让 Pi 安装勾选的 npm Pi 包。 参见 [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) | | **Targets** | 带状态的 Target 列表。**添加目标** 还提供 **另一个账号**:你已在使用的某个 Agent 的第二个配置文件夹,并会预览它的写入位置。每个 Target 的页面可编辑 include/exclude filter,并把本地专属的 skills 收集回 Source。filter 预览上方的搜索框可按名称筛选行,并标出匹配的文字;它只改变显示的行,不改变 filter。项目页面和 Extras 的 **Edit target** 对话框也使用同一个预览和搜索。**同步内容** 列以链接列出每个 target 拿到的内容:**Skills**、**Agents**、**MCP**、**Hooks** 及数量、Pi 的 **Extensions**,以及连接了共享 `AGENTS.md` 的 target 指令文件;点击即打开 target 页面的对应标签页。有 MCP 配置文件的 Target 会多一个 **MCP** 标签页,每个 server 一行;点一下就会保存,**Sync all targets** 会写入所有 Target 的 MCP 配置文件。每个 Target 还有一个以其指示文件命名的标签页(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md** 等),显示读取顺序、编辑该文件,并可将其转换为 `AGENTS.md` | | **Projects** | 仅限 global mode。global 配置会 sync 进的项目文件夹,来自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只保存在本机的项目(标记为 **此机器**)和 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同样的项目也可以在终端中通过 [`skillshare project`](./project.md) 管理。**添加项目** 需要填写文件夹、它的 Target 和要 sync 的内容,除非在对话框底部的 **保存到** 选择 **只存在这台机器**,否则会保存到 `config.yaml`(当 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 为 `machine-local` 时默认选择只存在这台机器)。编辑会保存在项目所在的位置。要移动已保存的项目,请使用 `skillshare project localize` 或 `share`。移除一个被本机覆盖的项目时,会询问是只移除本机的副本,还是连 `config.yaml` 中的一并移除。每个项目都有带 filter 的 **Skills** 和 **Agents** 标签页,可以预览并查看会写入的文件夹,还有一个 **MCP** 标签页,用于在该文件夹中关闭 global server 或为它添加自己的 server,并提供 **检查** 来检查这些 server。**Sync project** 会先预览,然后只 sync 该项目的 skills、agents 和 MCP。已经指向某个项目文件夹的 Target 可以被转换 | | **Audit** | 对 skills 和 agents 的安全扫描,按严重程度列出 findings。[跟随的 source 链接](/docs/reference/targets/configuration#follow_source_links)无法读取时,Skills / Agents 标签页旁会标出 **扫描不完整**,以免把部分扫描误认为完整扫描;此时扫描完成后会显示警告而不是全部正常,dashboard 的 **Needs attention** 中也会列出。**Rules** 标签页按类别浏览每一条规则:可以关闭某一条、更改其严重程度、把某个严重程度应用到整个类别、选择扫描 profile(`default`、`strict`、`permissive`),或打开自定义 `audit-rules.yaml` 的编辑器 | diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md index b95acf5fb..1dfba2a7f 100644 --- a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md +++ b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/how-to/daily-tasks/sharing-plugins.md @@ -83,6 +83,17 @@ skillshare sync plugins --no-tui plugin 的選單中有 **View files**:即已審閱過的來源本機副本,唯讀,並以 Markdown 格式呈現。 匯入的 plugin 沒有本機副本,因此也沒有這個項目。 +頁面標題列或 plugin 選單中的 **Share** 會列出從 HTTPS Git Source 加入的 plugin。勾選幾個後, +複製一行指令即可依序把它們全部加入。每個 add 都帶 `-g`,所以即使在專案裡執行,也會加到全域設定。 +指令預設還帶 `--no-tui`,加入時不會詢問;執行的人之後再到 Plugins 頁面勾選 Agent 安裝。 +勾選「每個項目都詢問要裝到哪裡」會拿掉 `--no-tui`,每次加入都會開啟 Agent 選擇畫面。 +來自本機目錄的 plugin 不會列出,因為那個路徑只存在你的機器上。 + +同一個對話框還會在 plugin 之後列出 Pi 從 npm 安裝的 Pi 套件。npm 套件由 Pi 自己下載,所以指令會指定 target: +`skillshare plugin add npm: --target pi -g --no-tui` 會直接裝進 Pi。 +勾選「每個項目都詢問要裝到哪裡」時,指令不帶 `--target pi`,改為詢問要用哪些 Pi target。 +來自 Git 或本機路徑的 Pi 套件不會列出。 + plugin 與一般的 Skill 及 MCP 同步是分開的。它們所包含的元件不會同時複製到獨立的 Skillshare Source 中。 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 f5fc049ce..5e11076c6 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 @@ -96,7 +96,7 @@ skillshare ui start --clear-cache | **Skills** / **Agents** | 已安裝的項目、**Updates** 分頁與 **Trash** 分頁。Skills 還有一個 **Analyze** 分頁,用來估算每個 skill 為 target 的 context 增加多少 tokens。**Install** 可搜尋 GitHub,或從 URL 或路徑安裝。選單裡也有開啟建立精靈的 **New skill** 和 **Link folder**。config 裡有尚未安裝的項目時,**Updates** 分頁和安裝對話框會提供 **Install all**,效果同不帶參數的 [`install`](/docs/reference/commands/install)。執行檢查後,已從來源 repo 刪除的 skills 會列出並提供 **Prune** 與 **Prune all**,把它們移到垃圾桶。**Link folder** 與 [`link`](/docs/reference/commands/link) 一樣把資料夾連結進 skills source:填入路徑、選填的連結名稱,`follow_source_links` 關閉時另有一個開啟它的核取方塊;被拒絕的資料夾會顯示與指令相同的原因。連結的資料夾會以獨立群組列出,帶有連結圖示與它指向的資料夾;該列的圖示按鈕(hover 時連結圖示會變成取消連結圖示)會先確認,再像 [`unlink`](/docs/reference/commands/unlink) 一樣取消連結:資料夾本身不受影響,連結可從 **Trash** 分頁還原。連結資料夾裡的 skill 仍可單獨解除安裝,它會從該資料夾移到 trash;連結的資料夾沒有 **Update repo** 與 **Uninstall repo**。列表與卡片檢視可依 **Folder**(tracked repo、`frontend/react` 這類資料夾,或 **Root**)篩選,也能依 **Folder** 分組,Root 排最前,其餘資料夾依名稱 A→Z 排序。列表檢視中,位在另一個 skill 資料夾裡的 skill 會列在那個 skill 底下:點 package 名稱後面的數量按鈕,會在下方展開它的 skill,並用淡淡的樹狀線連到 package(package 預設收合),更深的 package 再往內縮排。搜尋時會展開含有符合項目的 package,顯示 `1 / 3` 這樣的數量,並標出名稱裡符合的文字;搜尋中收合的 package 在搜尋改變後會重新展開,搜尋前展開的 package 維持不變。分頁只計算最上層的列。每一列以一行顯示 frontmatter 裡的 `description`,該列取得鍵盤焦點時顯示全文;可在 **分組與排序** → **顯示** → **描述** 隱藏。**全部展開** / **全部收合**也會展開和收合 package,選取列會顯示已選取但沒有顯示的項目數。只有點名稱才會開啟詳細頁面。解除安裝 package 時,它資料夾裡的 skill 也會一起移到 trash,確認對話框會顯示數量。**tree** 檢視左邊顯示 source 資料夾,右邊顯示詳細資訊:點資料夾或 skill 來選取,Cmd/Ctrl 點擊加入選取,Shift 點擊選取範圍,雙擊 skill 開啟它。右邊可用一個開關啟用或停用所有選取的項目(被 `.skillignore.local` 的 `!` 規則保持啟用的項目會回報為失敗並附上原因)、設定它們的 targets(包括 tracked repo 與其子資料夾),並列出每個 skill 各自的開關;tracked repo 另外提供 **Update repo** 與 **Uninstall repo**。帶有 `disable-model-invocation: true` 的 skill 會在列表、其磚塊(tile)與詳細頁面上帶有 **manual only** 標籤,這與 [`list`](/docs/reference/commands/list) 中用 `m` 切換的狀態相同。從遠端預設分支以外的分支安裝的 skill(`install --branch`)會在列表、卡片和 **Updates** 分頁上以標籤顯示該分支。從遠端來源安裝的 skill(tracked repo 除外,它在 **Git Sync** 切換分支)在詳細頁面的 **Branch** 中列出來源的分支,適用於任何主機上的 Git 遠端(HTTPS 或 SSH)。選擇分支後會先確認,再經過與 update 相同的安全稽核和本機修改檢查,從該分支重新安裝。如果該分支沒有這個 skill,會保留目前的安裝。在專案中,切換成功後也會把分支記錄到 `.skillshare/config.yaml`,讓團隊成員從該分支安裝。在 skill 編輯器中,**Add field** 說明每個 frontmatter 欄位的作用。**Sync skills** / **Sync agents** 會先預覽,再只把該類型同步到所有 targets;更新、解除安裝或 collect 之後,從 **Sync Now** 也會開啟同一個對話框。檔案瀏覽器會透過被跟隨的 source 連結列出 `SKILL.md` 與附件,包含連結本身就是 skill 根目錄的情況。 | | **Extras** | **目錄**:與 skills 一同同步的 rules、commands 及其他資料夾。**Edit target** 可修改 target 的資料夾、檔名、模式、flatten 設定與[檔案篩選](./extras.md#choosing-files),並即時預覽;**Edit extra** 可重新命名 extra,或改指向另一個來源資料夾。**AGENTS.md**:在 global mode 中是共用 `AGENTS.md` 與使用它們的 targets;在專案中則是專案的 `./AGENTS.md`,以及每個 target 是否讀得到它。詳見[讓多個工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) **Memory**: [記憶共用教學](../../how-to/daily-tasks/sharing-memory.md)(英文截圖)。搜尋、預覽、編輯、刪除筆記、INDEX 連結、衝突時保留草稿、Backup Files 歷史與還原,以及 **Connect to agents** → **Review changes** → **Apply changes**;設定狀態不代表已讀取 | | **MCP** | 每個 server 一列,並以 chips 顯示它同步至哪些 Agents;列上的計數按鈕會開啟它們的切換開關。**新增伺服器** 接受 URL、指令、貼上的片段或檔案;**從目標匯入** 讀取已安裝 Agent 目前的設定。每個 server 的選單都有 **檢視各 Agent 會寫入的設定**,會列出來源與每個 Agent 的檔案,並顯示你選取的那一個(含尚未儲存的編輯內容)。衝突時提供 **從該 Agent 匯入** 或 **以來源覆寫**。server 對話框的 **工具** 區塊用來設定[工具政策](./mcp.md#tool-policy):**載入工具**,它會用對話框目前的設定(不論是否已儲存)啟動 server 一次並列出工具供勾選;用於 `*` 萬用字元的 **排除規則** 列;區塊會列出每個不套用部分政策的已選 Agent,設定政策後該列也會顯示標籤。對於 Pi server,對話框另有 [Pi 內建 MCP](./mcp.md#pi) 的設定:工具曝光模式與其他 Pi 設定,後者以 JSON 填入 [`piOptions`](./mcp.md#pi-options),說明則放在資訊提示中。**預設值** 用來編輯 `mcp.targets`。Sync 框中的 **Sync MCP** 會列出待寫入的變更,只寫入 MCP 設定檔,並為每個檔案保留備份;它下方的 [**檢查**](./mcp.md#check-servers-before-an-agent-starts-them) 會檢查 servers,**備份與還原** 則可預覽並還原這些備份。 | -| **Plugins** | 每個 plugin 一列,並以其 Agents 作為切換開關。展開一列還會列出來源支援的其他 Agents;勾選其中之一即可預覽安裝內容。列選單可以同步、更新、移除,或開啟 **View files**,也就是唯讀瀏覽 Skillshare 已檢視過的本機副本。參見 [跨工具管理 plugins](/docs/how-to/daily-tasks/sharing-plugins) | +| **Plugins** | 每個 plugin 一列,並以其 Agents 作為切換開關。展開一列還會列出來源支援的其他 Agents;勾選其中之一即可預覽安裝內容。列選單可以同步、更新、移除,或開啟 **View files**,也就是唯讀瀏覽 Skillshare 已檢視過的本機副本。**Share** 會複製一行指令,從 HTTPS 來源加入勾選的 plugin,並讓 Pi 安裝勾選的 npm Pi 套件。 參見 [跨工具管理 plugins](/docs/how-to/daily-tasks/sharing-plugins) | | **Targets** | 附帶狀態的 target 列表。**新增目標** 也接受 **另一個帳號**:你已在使用的某個 Agent 的第二個 config 資料夾,並會預覽它寫入的位置。每個 target 的頁面可編輯 include/exclude 篩選條件,並將僅存於本機的 skills 收集回 source。篩選預覽上方的搜尋框可依名稱縮小列表,並標出符合的文字;它只改變顯示的列,不會改變篩選條件。專案頁面與 Extras 的 **Edit target** 對話框也使用同一個預覽與搜尋。**同步內容** 欄以連結列出每個 target 拿到的東西:**Skills**、**Agents**、**MCP**、**Hooks** 與數量、Pi 的 **Extensions**,以及接上共用 `AGENTS.md` 的 target 指示檔;點哪個就開 target 頁的那個分頁。有 MCP 設定檔的 target 會多一個 **MCP** 分頁,每個 server 一列;點一下就會儲存,**Sync all targets** 會寫入所有 target 的 MCP 設定檔。每個 target 還有一個以它所讀檔案命名的分頁(**CLAUDE.md**、**GEMINI.md**、**AGENTS.md**……),會顯示讀取順序、編輯該檔案,並能將它轉換成 `AGENTS.md` | | **Projects** | 僅限 global mode。global config 會同步進去的 project 資料夾,來自 `config.yaml` 中的 [`projects`](/docs/reference/targets/configuration#projects)、只儲存在本機的專案(標示為 **此機器**)與 [`mcp.projects`](./mcp.md#projects-in-the-dashboard)。同樣的專案也可以在終端機中透過 [`skillshare project`](./project.md) 管理。**新增專案** 會要求填入資料夾、它的 targets 與要同步的內容,除非在對話框底部的 **儲存到** 選擇 **只存在這台機器**,否則會儲存到 `config.yaml`(當 [`projects_storage`](/docs/reference/targets/configuration#projects-storage) 為 `machine-local` 時預設選擇只存在這台機器)。編輯會儲存在專案所在的位置。要移動已儲存的專案,請使用 `skillshare project localize` 或 `share`。移除一個被本機覆寫的專案時,會詢問是只移除本機的副本,還是連 `config.yaml` 中的一併移除。每個 project 都有 **Skills** 與 **Agents** 分頁,附帶篩選條件、預覽畫面與會被寫入的資料夾,還有一個 **MCP** 分頁可在該資料夾中關閉 global servers 或給它專屬的 servers,並有 **檢查** 可檢查這些 servers。**Sync project** 會先預覽,再只同步該 project 的 skills、agents 與 MCP。已經指向某個 project 資料夾的 target 可以被轉換 | | **Audit** | 對 skills 與 agents 進行安全掃描,依嚴重程度列出發現項目。[跟進的 source 連結](/docs/reference/targets/configuration#follow_source_links)無法讀取時,Skills / Agents 分頁旁會標出 **掃描不完整**,以免把部分掃描誤認為完整掃描;此時掃描完成後會顯示警告而不是一切正常,dashboard 的 **Needs attention** 中也會列出。**Rules** 分頁可依分類瀏覽每一項規則:關閉某項、變更其嚴重程度、對整個分類套用嚴重程度、選擇掃描設定檔(`default`、`strict`、`permissive`),或開啟編輯器自訂 `audit-rules.yaml` |