From 0580bd79bde4c890f564b09ec6c815d2dc4a6ee5 Mon Sep 17 00:00:00 2001 From: Willie Date: Mon, 9 Nov 2026 18:08:25 +0800 Subject: [PATCH] feat(ui): add a refresh button to the Hubs page (#814) The Hubs page keeps a hub's skill list for two minutes and does not refetch on window focus. The server reads the index fresh on every request (git hubs are re-cloned), so after someone pushes an updated skillshare-hub.json the only way to see it was to wait or reload the whole page. A refresh icon button next to the filter refetches the list on demand. It spins and is disabled while loading; the current list stays on screen, and a failed fetch shows the existing error note above it. Your own (draft) Hubs are local and do not get the button. --- ui/src/components/hub/HubView.tsx | 15 ++++++++++++++- ui/src/i18n/locales/de.json | 1 + ui/src/i18n/locales/en.json | 1 + ui/src/i18n/locales/es.json | 1 + ui/src/i18n/locales/fa.json | 1 + ui/src/i18n/locales/fr.json | 1 + ui/src/i18n/locales/id.json | 1 + ui/src/i18n/locales/ja.json | 1 + ui/src/i18n/locales/ko.json | 1 + ui/src/i18n/locales/pt-BR.json | 1 + ui/src/i18n/locales/zh-CN.json | 1 + ui/src/i18n/locales/zh-TW.json | 1 + website/docs/reference/commands/ui.md | 2 +- .../current/reference/commands/ui.md | 2 +- .../current/reference/commands/ui.md | 2 +- .../current/reference/commands/ui.md | 2 +- .../current/reference/commands/ui.md | 2 +- 17 files changed, 30 insertions(+), 6 deletions(-) diff --git a/ui/src/components/hub/HubView.tsx b/ui/src/components/hub/HubView.tsx index 8de7fe222..1852cd454 100644 --- a/ui/src/components/hub/HubView.tsx +++ b/ui/src/components/hub/HubView.tsx @@ -1,7 +1,7 @@ import { useEffect, useMemo, useRef, useState } from 'react'; import type { ReactNode } from 'react'; import { useQuery, useQueryClient } from '@tanstack/react-query'; -import { Search, Tag } from 'lucide-react'; +import { RefreshCw, Search, Tag } from 'lucide-react'; import { api } from '../../api/client'; import type { SearchResult } from '../../api/client'; import { hubDrafts } from '../../api/hubDrafts'; @@ -114,6 +114,19 @@ export default function HubView({ title, draftId, url, actions }: Props) { setFilter(e.target.value)} placeholder={t('hubs.browse.filter')} aria-label={t('hubs.browse.filter')} /> + {/* The hosted list is cached for two minutes; this fetches it again now. */} + {!draftId && ( + + )} {actions} diff --git a/ui/src/i18n/locales/de.json b/ui/src/i18n/locales/de.json index 7d540c5f7..65081f94b 100644 --- a/ui/src/i18n/locales/de.json +++ b/ui/src/i18n/locales/de.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Bearbeiten", "hubs.view.share": "Teilen", "hubs.view.more": "Weitere Aktionen", + "hubs.view.refresh": "Aktualisieren", "hubs.view.version": "Version", "hubs.view.delete": "Hub löschen", "hubs.view.deleteHint": "Diesen Hub endgültig löschen? Installierte Skills und gehostete Dateien bleiben unberührt.", diff --git a/ui/src/i18n/locales/en.json b/ui/src/i18n/locales/en.json index 774fb6705..2f63f8234 100644 --- a/ui/src/i18n/locales/en.json +++ b/ui/src/i18n/locales/en.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Edit", "hubs.view.share": "Share", "hubs.view.more": "More actions", + "hubs.view.refresh": "Refresh", "hubs.view.version": "Version", "hubs.view.delete": "Delete Hub", "hubs.view.deleteHint": "Delete this Hub permanently? Installed skills and hosted files are not affected.", diff --git a/ui/src/i18n/locales/es.json b/ui/src/i18n/locales/es.json index fc61b71ae..7e76823d9 100644 --- a/ui/src/i18n/locales/es.json +++ b/ui/src/i18n/locales/es.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Editar", "hubs.view.share": "Compartir", "hubs.view.more": "Más acciones", + "hubs.view.refresh": "Actualizar", "hubs.view.version": "Versión", "hubs.view.delete": "Eliminar Hub", "hubs.view.deleteHint": "¿Eliminar este Hub para siempre? Los skills instalados y los archivos alojados no se ven afectados.", diff --git a/ui/src/i18n/locales/fa.json b/ui/src/i18n/locales/fa.json index 7e3d55716..a11956952 100644 --- a/ui/src/i18n/locales/fa.json +++ b/ui/src/i18n/locales/fa.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "ویرایش", "hubs.view.share": "هم‌رسانی", "hubs.view.more": "کارهای بیشتر", + "hubs.view.refresh": "تازه‌سازی", "hubs.view.version": "نسخه", "hubs.view.delete": "حذف Hub", "hubs.view.deleteHint": "این Hub برای همیشه حذف شود؟ skills نصب‌شده و فایل‌های میزبانی‌شده تغییری نمی‌کنند.", diff --git a/ui/src/i18n/locales/fr.json b/ui/src/i18n/locales/fr.json index 1b66de913..01a453815 100644 --- a/ui/src/i18n/locales/fr.json +++ b/ui/src/i18n/locales/fr.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Modifier", "hubs.view.share": "Partager", "hubs.view.more": "Plus d'actions", + "hubs.view.refresh": "Actualiser", "hubs.view.version": "Version", "hubs.view.delete": "Supprimer le Hub", "hubs.view.deleteHint": "Supprimer définitivement ce Hub ? Les skills installés et les fichiers hébergés ne sont pas touchés.", diff --git a/ui/src/i18n/locales/id.json b/ui/src/i18n/locales/id.json index 19cd0961d..580bd5c77 100644 --- a/ui/src/i18n/locales/id.json +++ b/ui/src/i18n/locales/id.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Edit", "hubs.view.share": "Bagikan", "hubs.view.more": "Tindakan lain", + "hubs.view.refresh": "Segarkan", "hubs.view.version": "Versi", "hubs.view.delete": "Hapus Hub", "hubs.view.deleteHint": "Hapus Hub ini secara permanen? Skills yang terpasang dan file yang di-host tidak terpengaruh.", diff --git a/ui/src/i18n/locales/ja.json b/ui/src/i18n/locales/ja.json index 435e690f1..ebb1d1e1e 100644 --- a/ui/src/i18n/locales/ja.json +++ b/ui/src/i18n/locales/ja.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "編集", "hubs.view.share": "共有", "hubs.view.more": "その他の操作", + "hubs.view.refresh": "更新", "hubs.view.version": "バージョン", "hubs.view.delete": "Hub を削除", "hubs.view.deleteHint": "この Hub を完全に削除しますか?インストール済みの skills や公開先のファイルには影響しません。", diff --git a/ui/src/i18n/locales/ko.json b/ui/src/i18n/locales/ko.json index 840d36b44..d3ef1f779 100644 --- a/ui/src/i18n/locales/ko.json +++ b/ui/src/i18n/locales/ko.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "편집", "hubs.view.share": "공유", "hubs.view.more": "더 보기", + "hubs.view.refresh": "새로고침", "hubs.view.version": "버전", "hubs.view.delete": "Hub 삭제", "hubs.view.deleteHint": "이 Hub를 영구히 삭제할까요? 설치된 skills와 호스팅된 파일은 영향을 받지 않습니다.", diff --git a/ui/src/i18n/locales/pt-BR.json b/ui/src/i18n/locales/pt-BR.json index 6abb460b1..beecc4837 100644 --- a/ui/src/i18n/locales/pt-BR.json +++ b/ui/src/i18n/locales/pt-BR.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "Editar", "hubs.view.share": "Compartilhar", "hubs.view.more": "Mais ações", + "hubs.view.refresh": "Atualizar", "hubs.view.version": "Versão", "hubs.view.delete": "Excluir Hub", "hubs.view.deleteHint": "Excluir este Hub permanentemente? Skills instalados e arquivos hospedados não são afetados.", diff --git a/ui/src/i18n/locales/zh-CN.json b/ui/src/i18n/locales/zh-CN.json index bae60d2f4..10ea91695 100644 --- a/ui/src/i18n/locales/zh-CN.json +++ b/ui/src/i18n/locales/zh-CN.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "编辑", "hubs.view.share": "分享", "hubs.view.more": "更多操作", + "hubs.view.refresh": "刷新", "hubs.view.version": "版本", "hubs.view.delete": "删除 Hub", "hubs.view.deleteHint": "要永久删除这个 Hub 吗?已安装的 skills 和放在别处的文件不受影响。", diff --git a/ui/src/i18n/locales/zh-TW.json b/ui/src/i18n/locales/zh-TW.json index bd0bdf431..42d126ddc 100644 --- a/ui/src/i18n/locales/zh-TW.json +++ b/ui/src/i18n/locales/zh-TW.json @@ -2366,6 +2366,7 @@ "hubs.view.edit": "編輯", "hubs.view.share": "分享", "hubs.view.more": "更多動作", + "hubs.view.refresh": "重新整理", "hubs.view.version": "版本", "hubs.view.delete": "刪除 Hub", "hubs.view.deleteHint": "要永久刪除這個 Hub 嗎?已安裝的 skills 和放在別處的檔案不受影響。", diff --git a/website/docs/reference/commands/ui.md b/website/docs/reference/commands/ui.md index 5b3537249..79f414bbe 100644 --- a/website/docs/reference/commands/ui.md +++ b/website/docs/reference/commands/ui.md @@ -90,7 +90,7 @@ Some pages show a count in the sidebar when they need attention. The counts refr | **Dashboard** | Counts for skills, agents, extras, MCP servers, hooks, plugins, and targets, plus items that need attention. Uninstalling a tracked repo with uncommitted changes, or whose git status can't be read, explains why and asks again before moving it to the trash as it is, like `uninstall --force` | | **Sync** | Preview every change per target before writing. Choose which parts to include (Skills, Agents, Extras, MCP). Files edited inside a target are kept unless **Force** is on. Items that exist only in a target can be collected back to source from here. Each sync backs up target folders first. When a target fails, the others still sync: the page lists each failed target with its part (Skills, Agents, Extras or Config), a plain-language explanation when the cause is a common one (a symlink that points elsewhere, permission denied, a read-only file system, a missing file or folder, invalid target settings) and the error, above the other warnings, offers **Turn on Force** for a skills symlink that points elsewhere, and marks the target in the change list. Even when every target fails, the page lists them the same way. The **Last sync** card names the targets that failed in the latest sync. Targets that get the same changes share one card that lists the skills by folder. **Discard all** moves skills that no target has received yet to the trash, after a confirmation. When a target's `include` filter matches no skill, a notice says the target gets no skills, and **Edit filter** opens the place where that filter is set; Git Sync shows the same notice after a pull | | **Git Sync** | Commit and push the source repo, push commits that aren't on the remote yet, and pull. Opening the page fetches from the remote, so **Pull** shows how many commits the remote has. When both computers have new commits, **Pull and merge** preserves both histories before you push. With uncommitted changes and remote updates, **Commit and pull** saves your changes first. Pull syncs what the repo scope holds (`skills`, `agents`, `extras`, or `root`), like [`pull`](/docs/reference/commands/pull). **Sync both ways** commits local changes, pulls and merges, syncs targets, then pushes, like [`push --pull`](/docs/reference/commands/push#push-and-pull-together); a conflict stops it before pushing. Conflicting files open a version comparison; choose the local or remote version of each whole file (or keep all local or all remote at once), then **Apply choices and pull**. Cancel leaves your files unchanged. When a first pull can't merge with the remote, it offers a force pull that replaces local files with the remote branch | -| **Hubs** | Reached from the Skills page. Lists the built-in hub, saved hubs, and your own Hubs (**Mine**); pick one to filter its skills and install them. **Add or create a Hub** adds an existing hub, creates a new Hub, or imports a `skillshare-hub.json`. Your own Hubs are changed with **Edit**; **Share** downloads the index and builds the `hub add` command. See [`hub`](/docs/reference/commands/hub) | +| **Hubs** | Reached from the Skills page. Lists the built-in hub, saved hubs, and your own Hubs (**Mine**); pick one to filter its skills and install them. **Add or create a Hub** adds an existing hub, creates a new Hub, or imports a `skillshare-hub.json`. Your own Hubs are changed with **Edit**; **Share** downloads the index and builds the `hub add` command. **Refresh** reloads a saved or built-in hub's list now instead of waiting for the two-minute cache. See [`hub`](/docs/reference/commands/hub) | | **Skills** / **Agents** | Installed items, the **Updates** tab, and the **Trash** tab. Skills also have an **Analyze** tab that estimates how many tokens each skill adds to a target's context. **Install** searches GitHub or installs from a URL or path; its menu also holds **New skill**, which opens the creation wizard, and **Link folder**. When the config lists entries that are not installed, the **Updates** tab and the install dialog offer **Install all**, like a bare [`install`](/docs/reference/commands/install). After a check, skills deleted from their source repo are listed with **Prune** and **Prune all**, which move them to the trash. **Link folder** links a folder into the skills source like [`link`](/docs/reference/commands/link): it takes a path, an optional link name and, while `follow_source_links` is off, a checkbox that turns it on, and a refused folder shows the same reason as the command. A linked folder is listed as its own group with the link icon and the folder it points at; the icon button on its row (the link icon turns into an unlink icon on hover) asks for confirmation and then unlinks it like [`unlink`](/docs/reference/commands/unlink): the folder is not touched and the link can be restored from the **Trash** tab. A skill inside a linked folder can still be uninstalled on its own, which moves it out of that folder to the trash; linked folders have no **Update repo** or **Uninstall repo**. The list and card views can filter by **Folder** (a tracked repo, a folder such as `frontend/react`, or **Root**) and group by **Folder**, with the root first and folders A→Z. In the list view, a skill inside another skill's folder is listed under that skill: the count button after the package's name opens its skills below it, joined to the package by a faint tree line (packages start collapsed), and deeper packages are indented further. A search opens the packages that hold a match, shows counts such as `1 / 3`, and marks the matched text in names; packages you close during a search open again when the search changes, and the packages you opened before stay as they were. Paging counts only top-level rows. Each row shows the `description` from the skill's frontmatter on one line, in full while the row has keyboard focus; **Group and sort** → **Show** → **Descriptions** hides them. **Expand all** / **Collapse all** also opens and closes packages, and the selection bar says how many selected items are not shown. Only a name opens the detail page. Uninstalling a package also moves the skills inside its folder to the trash, and the confirmation says how many. The **tree** view shows the source folders on the left and details on the right: click a folder or skill to select it, Cmd/Ctrl-click to add to the selection, Shift-click for a range, and double-click a skill to open it. The right side turns everything selected on or off with one switch (an item that a `!` rule in `.skillignore.local` keeps on is reported as failed, with the reason), sets its targets (tracked repos and their subfolders included), and lists each skill with its own switch; a tracked repo also offers **Update repo** and **Uninstall repo**. A skill with `disable-model-invocation: true` carries a **manual only** tag in the list, on its tile and on its detail page, the same state [`list`](/docs/reference/commands/list) toggles with `m`. A skill installed from a branch other than the remote default (`install --branch`) shows that branch as a tag in the list, on its tile and on the **Updates** tab. On the detail page of a skill installed from a remote source (not a tracked repo, which changes branch on **Git Sync**), **Branch** lists the source's branches, for any Git remote (HTTPS or SSH, on any host). Picking one asks for confirmation, then reinstalls the skill from that branch with the same security audit and local-changes check as an update. If that branch has no such skill, the install stays as it was. In a project, a successful switch also records the branch in `.skillshare/config.yaml`, so teammates install from it. In the skill editor, **Add field** describes what each frontmatter field does. **Sync skills** / **Sync agents** previews, then syncs only that kind to every target; the same dialog opens from **Sync Now** after an update, an uninstall or a collect. The file browser lists `SKILL.md` and attachments through followed source links, including when the link itself is the skill root. | | **Extras** | **Folders & files**: rules, commands, and other files synced alongside skills. **Edit target** changes a target's folder, file name, mode, flatten setting and [file filters](./extras.md#choosing-files) with a preview; **Edit extra** renames an extra or points it at another source folder. **AGENTS.md**: in global mode, shared `AGENTS.md` files and which targets use them; in a project, the project's `./AGENTS.md` and whether each target reads it. See [Share one AGENTS.md across your tools](../../how-to/daily-tasks/sharing-instructions.md). **Memory**: browse, search, preview, edit, and delete shared Markdown notes; add INDEX links, preserve drafts on conflicts, open Backup Files history, and connect agents through reviewed instruction-file changes. Configured status does not prove a read. See the [Memory walkthrough](../../how-to/daily-tasks/sharing-memory.md) | | **MCP** | One row per server, with the Agents it syncs to as chips; the count button on the row opens their toggles. **Add server** takes a URL, a command, a pasted snippet or a file; **Import from a target** reads what an installed Agent already has. Each server's menu has **View what each Agent gets**, which lists the source and every Agent's file and shows the one you pick, including unsaved edits. Conflicts offer **Import from** the Agent or **Replace with source**. The server dialog's **Tools** section sets the [tool policy](./mcp.md#tool-policy): **Load tools**, which starts the server once with the dialog's settings, saved or not, and lists its tools to tick; an **Exclude rules** row for `*` patterns; it lists each selected Agent that does not apply part of the policy, and the row shows a tag when a policy is set. For a Pi server, the dialog also has [Pi's built-in MCP](./mcp.md#pi) settings: tool exposure and other Pi settings, which take [`piOptions`](./mcp.md#pi-options) as JSON, with their help in info tooltips. **Defaults** edits `mcp.targets`. **Sync MCP**, in the Sync box, lists the pending changes and writes only the MCP config files, keeping a backup of each; below it, [**Check**](./mcp.md#check-servers-before-an-agent-starts-them) checks the servers and **Backups and restore** previews and restores those backups. | 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 c2c4b1ba5..270e16ee4 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 @@ -90,7 +90,7 @@ skillshare ui start --clear-cache | **Dashboard** | Skill、Agent、Extras、MCP サーバー、Hook、Plugin、Target の件数、および対応が必要な項目。コミットされていない変更がある、または git ステータスを読み取れない tracked repo をアンインストールすると、理由を示して再確認し、repo をそのままゴミ箱へ移動します(`uninstall --force` と同じ) | | **Sync** | 書き込む前に、Target ごとにすべての変更をプレビュー。含める項目を選択(Skills、Agents、Extras、MCP)。Target 内で編集されたファイルは、**Force** がオンでない限り保持される。Target にのみ存在する項目は、ここから Source に collect し戻せる。各 sync は最初に Target フォルダをバックアップする。Target が失敗しても他の Target は sync される。失敗した Target は、その部分(Skills、Agents、Extras、Config)とエラーとともに他の警告より上に一覧表示され、よくある原因(別の場所を指す symlink、権限不足、読み取り専用のファイルシステム、存在しないファイルやフォルダー、無効な Target 設定)にはわかりやすい説明も付き、別の場所を指す Skills の symlink には **Force をオンにする** が表示され、変更一覧でもその Target に印が付く。すべての Target が失敗した場合も、同じように一覧表示される。**前回の同期** カードには、直近の sync で失敗した Target が表示される。同じ変更を受け取る Target は 1 枚のカードにまとめられ、Skill がフォルダごとに並ぶ。**Discard all** は確認のあと、まだどの Target にも届いていない Skill をゴミ箱に移す。Target の `include` フィルターがどの Skill にも一致しないときは、その Target に Skill が届かないことを知らせる通知が表示され、**Edit filter** でそのフィルターを設定している場所を開ける。Git Sync でも pull のあとに同じ通知が表示される | | **Git Sync** | Source リポジトリのコミットとプッシュ、remote にまだないコミットのプッシュ、プルを実行。ページを開くと remote から fetch するため、**Pull** には remote にあるコミット数が表示される。プルはリポジトリのスコープ(`skills`、`agents`、`extras`、または `root`)が保持するものを sync する。詳細は [`pull`](/docs/reference/commands/pull) を参照。**Sync both ways** はローカルの変更をコミットし、プルしてマージし、target を sync してからプッシュする([`push --pull`](/docs/reference/commands/push#push-and-pull-together) と同じ)。コンフリクトが発生した場合はプッシュ前に停止する。remote に新しいコミットがあるためにプッシュが拒否された場合、エラーに **Pull** が表示される。最初のプルが remote とマージできない場合、remote ブランチでローカルファイルを置き換える force pull を提案する | -| **Hubs** | スキル ページから移動。内蔵の hub、保存済みの hub、自分の Hub(**自分の**)を一覧表示し、選ぶとその Skill を絞り込んでインストールできる。**Hub を追加・作成** は既存の hub の追加、新しい Hub の作成、`skillshare-hub.json` の読み込みを行う。自分の Hub は **編集** で変更し、**共有** でインデックスをダウンロードして `hub add` コマンドを作る。[`hub`](/docs/reference/commands/hub) を参照 | +| **Hubs** | スキル ページから移動。内蔵の hub、保存済みの hub、自分の Hub(**自分の**)を一覧表示し、選ぶとその Skill を絞り込んでインストールできる。**Hub を追加・作成** は既存の hub の追加、新しい Hub の作成、`skillshare-hub.json` の読み込みを行う。自分の Hub は **編集** で変更し、**共有** でインデックスをダウンロードして `hub add` コマンドを作る。保存済みと内蔵の hub は **更新** で、2 分間のキャッシュを待たずに一覧を読み直す。[`hub`](/docs/reference/commands/hub) を参照 | | **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) がサーバーをチェックし、**バックアップと復元** でそれらのバックアップをプレビューして復元できる。 | 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 aaaf5c9f9..b9d32f541 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 @@ -90,7 +90,7 @@ skillshare ui start --clear-cache | **Dashboard** | skill, agent, extras, MCP 서버, hook, plugin, target의 개수와 주의가 필요한 항목. 커밋되지 않은 변경 사항이 있거나 git 상태를 읽을 수 없는 tracked repo를 제거하면 이유를 알려 주고 다시 확인한 뒤 repo를 그대로 휴지통으로 옮깁니다(`uninstall --force`와 같음) | | **Sync** | target별로 기록 전에 모든 변경 사항을 미리 봅니다. 포함할 부분(Skills, Agents, Extras, MCP)을 선택합니다. target 내부에서 편집된 파일은 **Force**가 켜져 있지 않은 한 유지됩니다. target에만 존재하는 항목은 여기서 source로 다시 수집할 수 있습니다. 각 sync는 먼저 target 폴더를 백업합니다. target이 실패해도 다른 target은 sync됩니다. 실패한 target은 해당 부분(Skills, Agents, Extras, Config)과 오류와 함께 다른 경고보다 위에 표시되고, 흔한 원인(다른 곳을 가리키는 symlink, 권한 거부, 읽기 전용 파일 시스템, 없는 파일이나 폴더, 잘못된 target 설정)에는 쉬운 설명도 붙으며, 다른 곳을 가리키는 Skills symlink에는 **Force 켜기**가 제공되며, 변경 목록에서도 해당 target이 표시됩니다. 모든 target이 실패해도 같은 방식으로 표시됩니다. **마지막 동기화** 카드에는 가장 최근 sync에서 실패한 target이 표시됩니다. 같은 변경을 받는 target들은 한 카드로 묶이고 skill이 폴더별로 나열됩니다. **Discard all**은 확인 후, 아직 어떤 target에도 전달되지 않은 skill을 휴지통으로 옮깁니다. target의 `include` 필터가 어떤 skill과도 일치하지 않으면 그 target이 skill을 하나도 받지 못한다는 알림이 표시되고, **Edit filter**로 그 필터를 설정하는 곳을 열 수 있습니다. Git Sync도 pull 후에 같은 알림을 표시합니다 | | **Git Sync** | source repo를 commit하고 push하며, 아직 remote에 없는 커밋을 push하고, pull합니다. 페이지를 열면 remote에서 fetch하므로 **Pull** 버튼에 remote에 있는 커밋 수가 표시됩니다. Pull은 [`pull`](/docs/reference/commands/pull)과 마찬가지로 repo scope가 담고 있는 것(`skills`, `agents`, `extras`, 또는 `root`)을 동기화합니다. **Sync both ways**는 로컬 변경 사항을 commit하고, pull해 병합하고, target을 동기화한 뒤 push합니다([`push --pull`](/docs/reference/commands/push#push-and-pull-together)과 같음). 충돌이 발생하면 push하기 전에 멈춥니다. remote에 더 새로운 커밋이 있어 push가 거부되면 오류 알림에서 **Pull**을 제공합니다. 첫 pull이 remote와 병합할 수 없을 때는 로컬 파일을 remote 브랜치로 교체하는 force pull을 제공합니다 | -| **Hubs** | Skills 페이지에서 접근합니다. 내장 hub, 저장된 hub, 내 Hub(**내 Hub**)를 나열하며, 하나를 선택해 Skill을 필터링하고 설치합니다. **Hub 추가 또는 만들기**는 기존 hub 추가, 새 Hub 만들기, `skillshare-hub.json` 가져오기를 합니다. 내 Hub는 **편집**으로 변경하고 **공유**로 인덱스를 다운로드하고 `hub add` 명령을 만듭니다. [`hub`](/docs/reference/commands/hub) 참고 | +| **Hubs** | Skills 페이지에서 접근합니다. 내장 hub, 저장된 hub, 내 Hub(**내 Hub**)를 나열하며, 하나를 선택해 Skill을 필터링하고 설치합니다. **Hub 추가 또는 만들기**는 기존 hub 추가, 새 Hub 만들기, `skillshare-hub.json` 가져오기를 합니다. 내 Hub는 **편집**으로 변경하고 **공유**로 인덱스를 다운로드하고 `hub add` 명령을 만듭니다. 저장된 hub와 내장 hub는 **새로고침**으로 2분 캐시를 기다리지 않고 목록을 다시 불러옵니다. [`hub`](/docs/reference/commands/hub) 참고 | | **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)는 서버를 검사하고, **백업 및 복원**는 그 백업을 미리 보고 복원합니다. | 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 16586a39c..585164f53 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 @@ -90,7 +90,7 @@ skillshare ui start --clear-cache | **Dashboard** | skills、agents、extras、MCP servers、hooks、plugins 和 targets 的计数,以及需要关注的项目。卸载有未提交更改、或读不到 git 状态的 tracked repo 时,会说明原因并再次确认,然后把 repo 原样移入回收站,等同 `uninstall --force` | | **Sync** | 在写入之前,按 Target 预览每一处变更。选择要包含的部分(Skills、Agents、Extras、MCP)。在 Target 内部编辑过的文件会被保留,除非开启了 **Force**。只存在于某个 Target 中的项目可以从这里收集回 Source。每次 sync 会先备份 Target 目录。某个 Target 失败时,其他 Target 仍会 sync:页面会在其他警告上方列出每个失败的 Target 及其部分(Skills、Agents、Extras 或 Config)和错误,常见原因(symlink 指向别处、权限不足、只读文件系统、文件或文件夹不存在、Target 设置无效)还会附上一句易懂的说明;若 Skills 的 symlink 指向别处,会提供 **开启 Force**;变更列表中也会标出该 Target。即使所有 Target 都失败,也会以同样方式列出。**上次同步** 卡片会列出最近一次 sync 中失败的 Target。收到相同变更的 Target 会合并成一张卡片,按文件夹列出 skills。**Discard all** 会在确认后,把还没有任何 Target 收到的 skills 移到回收站。当某个 Target 的 `include` 过滤条件没有匹配任何 skill 时,会显示提示说明该 Target 收不到任何 skill,**Edit filter** 会打开设置该过滤条件的地方;Git Sync 在 pull 之后也会显示同样的提示 | | **Git Sync** | 提交并推送 source 仓库,推送尚未上 remote 的提交,并拉取。打开页面时会先从 remote fetch,所以 **Pull** 会显示 remote 有多少个新提交。Pull 会同步该仓库 scope 所涵盖的内容(`skills`、`agents`、`extras` 或 `root`),与 [`pull`](/docs/reference/commands/pull) 相同。**Sync both ways** 会提交本地更改、拉取并合并、同步 targets,然后推送,与 [`push --pull`](/docs/reference/commands/push#push-and-pull-together) 相同;遇到冲突时会在推送前停止。当 remote 因为有更新的提交而拒绝 push 时,错误提示会提供 **Pull**。当首次 pull 无法与 remote 合并时,它会提供一个强制 pull 选项,用 remote 分支替换本地文件 | -| **Hubs** | 从 Skill 页面进入。列出内置 hub、已保存的 hubs 与你自己的 Hub(**我的**);选择一个即可过滤并安装其中的 skills。**添加或创建 Hub** 可添加已有的 hub、创建新的 Hub,或导入 `skillshare-hub.json`。自己的 Hub 通过 **编辑** 修改;**分享** 会下载索引并生成 `hub add` 命令。参见 [`hub`](/docs/reference/commands/hub) | +| **Hubs** | 从 Skill 页面进入。列出内置 hub、已保存的 hubs 与你自己的 Hub(**我的**);选择一个即可过滤并安装其中的 skills。**添加或创建 Hub** 可添加已有的 hub、创建新的 Hub,或导入 `skillshare-hub.json`。自己的 Hub 通过 **编辑** 修改;**分享** 会下载索引并生成 `hub add` 命令。已保存与内置的 hub 可点 **刷新**,不必等两分钟缓存过期就重新读取列表。参见 [`hub`](/docs/reference/commands/hub) | | **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,**备份与还原** 用于预览并恢复这些备份。 | 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 742090b8d..d1fe4a8d2 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 @@ -90,7 +90,7 @@ skillshare ui start --clear-cache | **Dashboard** | Skills、agents、extras、MCP servers、hooks、plugins 與 targets 的數量,以及需要注意的項目。解除安裝有未提交變更、或讀不到 git 狀態的 tracked repo 時,會說明原因並再次確認,然後把 repo 原樣移到垃圾桶,等同 `uninstall --force` | | **Sync** | 在寫入前預覽每個 target 的每項變更。選擇要包含的部分(Skills、Agents、Extras、MCP)。在 target 內編輯過的檔案,除非開啟 **Force**,否則會保留。只存在於 target 中的項目可以從這裡收集回 source。每次同步都會先備份 target 資料夾。某個 target 失敗時,其他 target 仍會同步:頁面會在其他警告上方列出每個失敗的 target,以及它的部分(Skills、Agents、Extras 或 Config)和錯誤,常見原因(symlink 指向別處、權限不足、唯讀檔案系統、檔案或資料夾不存在、target 設定無效)還會附上一句易懂的說明;若 Skills 的 symlink 指向別處,會提供 **開啟 Force**;變更清單中也會標出該 target。即使所有 target 都失敗,也會以同樣方式列出。**上次同步** 卡片會列出最近一次同步中失敗的 target。收到相同變更的 targets 會合併成一張卡片,依資料夾列出 skills。**Discard all** 會在確認後,把還沒有任何 target 收到的 skills 移到垃圾桶。當某個 target 的 `include` 篩選條件沒有符合任何 skill 時,會顯示提示說明這個 target 收不到任何 skill,**Edit filter** 會開啟設定該篩選條件的地方;Git Sync 在 pull 之後也會顯示同樣的提示 | | **Git Sync** | Commit 並 push source repo、push 尚未在 remote 上的 commits,以及 pull。開啟頁面時會先從 remote fetch,所以 **Pull** 按鈕會顯示 remote 有幾個新的 commits。Pull 會同步 repo scope 所涵蓋的內容(`skills`、`agents`、`extras` 或 `root`),如同 [`pull`](/docs/reference/commands/pull)。**Sync both ways** 會 commit 本機變更、pull 並合併、sync targets,然後 push,如同 [`push --pull`](/docs/reference/commands/push#push-and-pull-together);遇到衝突時會在 push 前停止。當 remote 因為有較新的 commits 而拒絕 push 時,錯誤訊息會提供 **Pull**。當第一次 pull 無法與 remote 合併時,會提供強制 pull 以本機檔案取代 remote 分支 | -| **Hubs** | 從 Skills 頁面進入。列出內建 hub、已儲存的 hubs 與你自己的 Hub(**我的**);選擇一個即可篩選並安裝其中的 skills。**加入或建立 Hub** 可加入現有的 hub、建立新的 Hub,或匯入 `skillshare-hub.json`。自己的 Hub 以 **編輯** 修改;**分享** 會下載索引並產生 `hub add` 指令。參見 [`hub`](/docs/reference/commands/hub) | +| **Hubs** | 從 Skills 頁面進入。列出內建 hub、已儲存的 hubs 與你自己的 Hub(**我的**);選擇一個即可篩選並安裝其中的 skills。**加入或建立 Hub** 可加入現有的 hub、建立新的 Hub,或匯入 `skillshare-hub.json`。自己的 Hub 以 **編輯** 修改;**分享** 會下載索引並產生 `hub add` 指令。已儲存與內建的 hub 可按 **重新整理**,不必等兩分鐘快取過期就重新讀取清單。參見 [`hub`](/docs/reference/commands/hub) | | **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,**備份與還原** 則可預覽並還原這些備份。 |