qgraphflow 0.0.6

package/docs/clients.de.md

@@ -0,0 +1,83 @@
+# Installationsanleitung
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[Zurück zur README](readme/README.de.md)
+
+Qoder Desktop kann das Plugin aus dem Marketplace installieren, Claude Code direkt von GitHub (siehe die jeweiligen Abschnitte unten). In beiden Fällen entfällt Schritt 1. Für eine lokale Installation lade zuerst den QGraphFlow-Quellcode herunter und erstelle das Laufzeitpaket.
+
+Du benötigst Node.js 22 oder neuer und einen Client mit eingerichtetem Modellzugriff. Zum Bauen aus dem Quellcode werden außerdem Git, npm, `tar`, `zip` und `unzip` benötigt.
+
+## Schnellinstallation
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Installiert den Skill `q-flow` für Claude Code, Codex, Cursor und Qoder (getestet mit `skills` 1.7.0) und fragt, in welche Clients installiert werden soll. Für die Installation als Plugin den folgenden Schritten folgen.
+
+## 1. Für die lokale Installation herunterladen und bauen
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+Wenn der QGraphFlow-Quellcode bereits vorliegt, überspringe das Klonen und wechsle in dessen Stammverzeichnis. Passe den ZIP-Dateinamen an die Version in der `package.json` von QGraphFlow an. Verwende neue Ausgabe- und Entpackverzeichnisse, ohne vorhandene Dateien zu überschreiben. Git lädt nur bereits gepushten Code herunter, keine lokalen Änderungen ohne Commit.
+
+## 2. Im Client installieren
+
+Führe die folgenden Befehle im Stammverzeichnis des QGraphFlow-Quellcodes aus, nicht im Verzeichnis deines eigenen Anwendungsprojekts. Sie installieren das vollständige Laufzeitpaket aus dem dortigen Unterverzeichnis `dist/runtime`.
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+Hier registriert `marketplace add` nur eine lokale Installationsquelle; eine Veröffentlichung im öffentlichen Marktplatz ist nicht erforderlich. Siehe die [offizielle OpenAI-Dokumentation](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli).
+
+Starte eine neue Sitzung, gib `$` ein und wähle `qgraphflow:q-flow` aus (verwende den tatsächlich im Client angezeigten Namen).
+
+### Claude Code
+
+Direkt von GitHub installieren, ohne Schritt 1:
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Oder aus dem in Schritt 1 erstellten Laufzeitpaket:
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Starte eine neue Sitzung und gib `/q-flow` (oder den vollständigen Namen `/qgraphflow:q-flow`) ein.
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+Starte eine neue Sitzung und wähle `q-flow` aus.
+
+### Qoder Desktop
+
+**Empfohlen:** Öffne **Settings → Plugins → Marketplace**, suche nach **代码图谱可视化** oder **qgraphflow** und installiere das Plugin. Starte eine neue Sitzung und wähle `q-flow`. Ein ZIP-Download oder ein Build aus dem Quellcode ist nicht erforderlich.
+
+Für eine lokale Installation führe zuerst Schritt 1 aus. Öffne dann **Settings → Plugins → Custom → Import** und importiere das vollständige Verzeichnis `dist/runtime`. Lade den Client neu und wähle `q-flow`.
+
+### Cursor
+
+Kopiere den gesamten Inhalt von `dist/runtime`, einschließlich versteckter Dateien, nach `~/.cursor/plugins/local/qgraphflow/`. Sichere ein vorhandenes Verzeichnis zuerst; vermische keine alten und neuen Dateien.
+
+Prüfe, ob das Manifest unter `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json` liegt. Lade das Fenster neu und wähle unter Customize → Plugins / Skills den Skill `q-flow` aus.
+
+Diese lokale Methode wurde mit Cursor 3.19.13 getestet. Prüfe bei anderen Versionen, ob Plugin und Skill angezeigt werden.

package/docs/clients.es.md

@@ -0,0 +1,83 @@
+# Guía de instalación
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[Volver al README](readme/README.es.md)
+
+Qoder Desktop permite instalar el complemento desde su Marketplace, y Claude Code directamente desde GitHub (consulta sus secciones más abajo). En ambos casos puedes omitir el paso 1. Para una instalación local, primero descarga el código fuente de QGraphFlow y genera el paquete de ejecución.
+
+Necesitas Node.js 22 o posterior y un cliente con acceso al modelo configurado. Para compilar desde el código fuente también necesitas Git, npm, `tar`, `zip` y `unzip`.
+
+## Instalación rápida
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Instala la habilidad `q-flow` en Claude Code, Codex, Cursor y Qoder (probado con `skills` 1.7.0) y pregunta en qué clientes instalar. Para instalar el complemento, sigue los pasos siguientes.
+
+## 1. Descargar y generar el paquete para la instalación local
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+Si ya tienes el código fuente de QGraphFlow, omite la clonación y entra en su directorio raíz. Ajusta el nombre del ZIP a la versión del `package.json` de QGraphFlow. Usa directorios nuevos para generar y extraer el paquete, sin sobrescribir archivos existentes. Git solo descarga el código enviado al repositorio, no los cambios locales sin commit.
+
+## 2. Instalar en el cliente
+
+Ejecuta los siguientes comandos desde la raíz del código fuente de QGraphFlow, no desde el directorio de tu propio proyecto. Instalan el paquete completo de la subcarpeta `dist/runtime`.
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+Aquí, `marketplace add` solo registra una fuente de instalación local; no requiere publicar el complemento en un marketplace público. Consulta la [documentación oficial de OpenAI](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli).
+
+Inicia una sesión nueva, escribe `$` y selecciona `qgraphflow:q-flow` (usa el nombre que muestre tu cliente).
+
+### Claude Code
+
+Instala directamente desde GitHub, sin el paso 1:
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+O bien, desde el paquete de ejecución generado en el paso 1:
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Inicia una sesión nueva y escribe `/q-flow` (o el nombre completo `/qgraphflow:q-flow`).
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+Inicia una sesión nueva y selecciona `q-flow`.
+
+### Qoder Desktop
+
+**Recomendado:** Abre **Settings → Plugins → Marketplace**, busca **代码图谱可视化** o **qgraphflow** e instala el complemento. Inicia una sesión nueva y selecciona `q-flow`. No necesitas descargar un ZIP ni compilar el código fuente.
+
+Para una instalación local, completa primero el paso 1. Después abre **Settings → Plugins → Custom → Import** e importa el directorio completo `dist/runtime`. Recarga el cliente y selecciona `q-flow`.
+
+### Cursor
+
+Copia todo el contenido de `dist/runtime`, incluidos los archivos ocultos, a `~/.cursor/plugins/local/qgraphflow/`. Si el directorio ya existe, haz una copia de seguridad antes; no mezcles archivos antiguos y nuevos.
+
+Comprueba que el manifiesto esté en `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`. Recarga la ventana y selecciona `q-flow` en Customize → Plugins / Skills.
+
+Este método local se probó en Cursor 3.19.13. En otras versiones, comprueba que aparezcan tanto el complemento como la habilidad.

package/docs/clients.ja.md

@@ -0,0 +1,83 @@
+# インストールガイド
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[README に戻る](readme/README.ja.md)
+
+Qoder Desktop ではマーケットプレイスから、Claude Code では GitHub から直接インストールできます（下記の各項を参照）。どちらも手順 1 は不要です。ローカルインストールの場合は、先に QGraphFlow のソースコードをダウンロードして実行用パッケージを作成してください。
+
+Node.js 22 以降と、モデルへのアクセスを設定済みのクライアントが必要です。ソースからビルドする場合は、Git、npm、`tar`、`zip`、`unzip` も必要です。
+
+## クイックインストール
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Claude Code、Codex、Cursor、Qoder にスキル `q-flow` を導入します（`skills` 1.7.0 で実測済み）。導入先のクライアントを尋ねられます。プラグインとして導入する場合は、次の手順に従ってください。
+
+## 1. ローカルインストール用のダウンロードとパッケージ作成
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+QGraphFlow のソースコードが手元にある場合はクローンを省略し、そのルートディレクトリに移動してください。ZIP 名は QGraphFlow の `package.json` のバージョンに合わせます。出力先と展開先には新しいディレクトリを使い、既存ファイルを上書きしないでください。Git で取得できるのはプッシュ済みのコードのみで、未コミットのローカル変更は含まれません。
+
+## 2. クライアントにインストール
+
+以下のコマンドは、自分の業務プロジェクトではなく、QGraphFlow のソースコードのルートディレクトリで実行します。その配下の `dist/runtime` にある完全な実行用パッケージをインストールします。
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+ここでの `marketplace add` はローカルのインストール元を登録するだけで、公開マーケットプレイスへの掲載は不要です。[OpenAI 公式ドキュメント](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli)を参照してください。
+
+新しいセッションを開始し、`$` を入力して `qgraphflow:q-flow` を選択します（クライアントに実際に表示される名前を使用してください）。
+
+### Claude Code
+
+手順 1 を省略して GitHub から直接インストールします：
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+または、手順 1 で作成した実行用パッケージを使います：
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+新しいセッションを開始し、`/q-flow`（または完全名 `/qgraphflow:q-flow`）を入力します。
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+新しいセッションを開始し、`q-flow` を選択します。
+
+### Qoder Desktop
+
+**推奨：** **Settings → Plugins → Marketplace** を開き、**代码图谱可视化** または **qgraphflow** を検索してインストールします。新しいセッションを開始し、`q-flow` を選択します。ZIP のダウンロードやソースのビルドは不要です。
+
+ローカルインストールの場合は手順 1 を完了し、**Settings → Plugins → Custom → Import** を開いて、`dist/runtime` ディレクトリ全体をインポートします。再読み込み後、`q-flow` を選択します。
+
+### Cursor
+
+`dist/runtime` の内容を隠しファイルも含めてすべて `~/.cursor/plugins/local/qgraphflow/` にコピーします。既存のディレクトリがある場合は先にバックアップし、新旧のファイルを混在させないでください。
+
+マニフェストが `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json` にあることを確認します。ウィンドウを再読み込みし、Customize → Plugins / Skills で `q-flow` を選択します。
+
+このローカル方式は Cursor 3.19.13 で検証済みです。他のバージョンでは、プラグインとスキルが表示されることを確認してください。

package/docs/clients.md

@@ -0,0 +1,83 @@
+# Installation guide
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[Back to README](../README.md)
+
+Qoder Desktop can install the plugin from its marketplace, and Claude Code can install directly from GitHub (see their sections below). Both can skip step 1. For local installation, download the QGraphFlow source and build the runtime package first.
+
+You need Node.js 22 or later and a client with model access configured. Building from source also requires Git, npm, `tar`, `zip` and `unzip`.
+
+## Quick install
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Installs the skill as `q-flow` for Claude Code, Codex, Cursor and Qoder (tested with `skills` 1.7.0); it asks which clients to install to. To install the plugin instead, follow the steps below.
+
+## 1. Download and build for local installation
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+If you already have the QGraphFlow source, skip cloning and enter its root directory. Match the ZIP filename to the version in QGraphFlow's `package.json`. Use new build and extraction directories; do not overwrite existing files. Git downloads contain only pushed code, not uncommitted local changes.
+
+## 2. Install in your client
+
+Run the commands below from the QGraphFlow source root, not your application's project directory. They install the complete runtime package in that directory's `dist/runtime` folder.
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+Here, `marketplace add` only registers a local installation source; no public marketplace listing is required. See the [official OpenAI documentation](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli).
+
+Start a new session, type `$`, and select `qgraphflow:q-flow` (use the name actually shown by your client).
+
+### Claude Code
+
+Install directly from GitHub without step 1:
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Or, from the runtime package built in step 1:
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Start a new session and enter `/q-flow` (or the fully qualified `/qgraphflow:q-flow`).
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+Start a new session and select `q-flow`.
+
+### Qoder Desktop
+
+**Recommended:** Open **Settings → Plugins → Marketplace**, search for **代码图谱可视化** or **qgraphflow**, and install the plugin. Start a new session and select `q-flow`. No ZIP download or source build is required.
+
+For local installation, complete step 1, then open **Settings → Plugins → Custom → Import** and import the complete `dist/runtime` directory. Reload, then select `q-flow`.
+
+### Cursor
+
+Copy everything inside `dist/runtime`, including hidden files, to `~/.cursor/plugins/local/qgraphflow/`. Back up any existing directory first; do not mix old and new files.
+
+Confirm the manifest is at `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`. Reload the window, then select `q-flow` under Customize → Plugins / Skills.
+
+This local method was tested with Cursor 3.19.13. On other versions, confirm that both the plugin and skill appear.

package/docs/clients.pt.md

@@ -0,0 +1,83 @@
+# Guia de instalação
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[Voltar ao README](readme/README.pt.md)
+
+O Qoder Desktop pode instalar o plugin pelo Marketplace, e o Claude Code diretamente do GitHub (veja as respectivas seções abaixo). Nos dois casos, você pode pular a etapa 1. Para uma instalação local, primeiro baixe o código-fonte do QGraphFlow e gere o pacote de execução.
+
+Você precisa de Node.js 22 ou posterior e de um cliente com acesso ao modelo configurado. Para compilar a partir do código-fonte, também precisa de Git, npm, `tar`, `zip` e `unzip`.
+
+## Instalação rápida
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Instala a habilidade `q-flow` no Claude Code, Codex, Cursor e Qoder (testado com `skills` 1.7.0) e pergunta em quais clientes instalar. Para instalar o plugin, siga as etapas abaixo.
+
+## 1. Baixar e gerar o pacote para instalação local
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+Se já tiver o código-fonte do QGraphFlow, pule a clonagem e entre no diretório raiz dele. Ajuste o nome do ZIP à versão no `package.json` do QGraphFlow. Use novos diretórios para gerar e extrair o pacote, sem sobrescrever arquivos existentes. O Git baixa apenas o código enviado ao repositório, não as alterações locais sem commit.
+
+## 2. Instalar no cliente
+
+Execute os comandos abaixo na raiz do código-fonte do QGraphFlow, não no diretório do seu próprio projeto. Eles instalam o pacote completo da subpasta `dist/runtime`.
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+Aqui, `marketplace add` apenas registra uma fonte de instalação local; não exige publicação em um marketplace público. Consulte a [documentação oficial da OpenAI](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli).
+
+Inicie uma nova sessão, digite `$` e selecione `qgraphflow:q-flow` (use o nome exibido pelo seu cliente).
+
+### Claude Code
+
+Instale diretamente do GitHub, sem o passo 1:
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Ou a partir do pacote de execução gerado no passo 1:
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Inicie uma nova sessão e digite `/q-flow` (ou o nome completo `/qgraphflow:q-flow`).
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+Inicie uma nova sessão e selecione `q-flow`.
+
+### Qoder Desktop
+
+**Recomendado:** Abra **Settings → Plugins → Marketplace**, pesquise **代码图谱可视化** ou **qgraphflow** e instale o plugin. Inicie uma nova sessão e selecione `q-flow`. Não é necessário baixar um ZIP nem compilar o código-fonte.
+
+Para uma instalação local, conclua primeiro a etapa 1. Depois, abra **Settings → Plugins → Custom → Import** e importe o diretório completo `dist/runtime`. Recarregue o cliente e selecione `q-flow`.
+
+### Cursor
+
+Copie todo o conteúdo de `dist/runtime`, incluindo arquivos ocultos, para `~/.cursor/plugins/local/qgraphflow/`. Se o diretório já existir, faça um backup antes; não misture arquivos antigos e novos.
+
+Confirme que o manifesto está em `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`. Recarregue a janela e selecione `q-flow` em Customize → Plugins / Skills.
+
+Esse método local foi testado no Cursor 3.19.13. Em outras versões, confirme que o plugin e a habilidade aparecem.

package/docs/clients.ru.md

@@ -0,0 +1,83 @@
+# Руководство по установке
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[Вернуться к README](readme/README.ru.md)
+
+В Qoder Desktop плагин можно установить из Marketplace, а в Claude Code — напрямую с GitHub (см. соответствующие разделы ниже). В обоих случаях шаг 1 можно пропустить. Для локальной установки сначала скачайте исходный код QGraphFlow и соберите пакет для установки.
+
+Нужны Node.js 22 или новее и клиент с настроенным доступом к модели. Для сборки из исходников также нужны Git, npm, `tar`, `zip` и `unzip`.
+
+## Быстрая установка
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+Устанавливает навык `q-flow` для Claude Code, Codex, Cursor и Qoder (проверено с `skills` 1.7.0) и спрашивает, в какие клиенты устанавливать. Чтобы установить плагин, выполните шаги ниже.
+
+## 1. Скачать и собрать для локальной установки
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+Если исходный код QGraphFlow уже скачан, пропустите клонирование и перейдите в его корневой каталог. Имя ZIP должно соответствовать версии в `package.json` проекта QGraphFlow. Используйте новые каталоги для сборки и распаковки, не перезаписывая старые файлы. Git скачивает только отправленный в репозиторий код, без незакоммиченных локальных изменений.
+
+## 2. Установить в клиент
+
+Выполняйте команды ниже из корневого каталога исходного кода QGraphFlow, а не из каталога вашего приложения. Они устанавливают полный пакет из вложенного каталога `dist/runtime`.
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+Здесь `marketplace add` только регистрирует локальный источник установки; публикация в маркетплейсе не требуется. См. [официальную документацию OpenAI](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli).
+
+Начните новый сеанс, введите `$` и выберите `qgraphflow:q-flow` (используйте имя, которое показывает ваш клиент).
+
+### Claude Code
+
+Установите напрямую с GitHub, пропустив шаг 1:
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Или из пакета, собранного на шаге 1:
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+Начните новый сеанс и введите `/q-flow` (или полное имя `/qgraphflow:q-flow`).
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+Начните новый сеанс и выберите `q-flow`.
+
+### Qoder Desktop
+
+**Рекомендуется:** Откройте **Settings → Plugins → Marketplace**, найдите **代码图谱可视化** или **qgraphflow** и установите плагин. Начните новый сеанс и выберите `q-flow`. Скачивать ZIP или собирать исходный код не требуется.
+
+Для локальной установки выполните шаг 1, затем откройте **Settings → Plugins → Custom → Import** и импортируйте весь каталог `dist/runtime`. Перезагрузите клиент и выберите `q-flow`.
+
+### Cursor
+
+Скопируйте всё содержимое `dist/runtime`, включая скрытые файлы, в `~/.cursor/plugins/local/qgraphflow/`. Если каталог уже существует, сначала сделайте резервную копию; не смешивайте старые и новые файлы.
+
+Убедитесь, что манифест находится по адресу `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`. Перезагрузите окно и выберите `q-flow` в Customize → Plugins / Skills.
+
+Этот способ локальной установки проверялся в Cursor 3.19.13. В других версиях убедитесь, что плагин и навык отображаются.

package/docs/clients.zh-CN.md

@@ -0,0 +1,83 @@
+# 安装指南
+
+[English](clients.md) · [中文](clients.zh-CN.md) · [Русский](clients.ru.md) · [Português](clients.pt.md) · [日本語](clients.ja.md) · [Deutsch](clients.de.md) · [Español](clients.es.md)
+
+[返回 README](readme/README.zh-CN.md)
+
+Qoder Desktop 可从插件商城安装，Claude Code 可直接从 GitHub 安装（见下方对应小节），两者均可跳过第 1 步。采用本地安装时，先下载 QGraphFlow 源码并构建运行包。
+
+准备 Node.js 22 及以上版本，以及已配置好模型访问的客户端。从源码构建还需 Git、npm、`tar`、`zip` 和 `unzip`。
+
+## 快速安装
+
+```bash
+npx skills add supermax92/qgraphflow
+```
+
+为 Claude Code、Codex、Cursor 和 Qoder 安装技能 `q-flow`（已用 `skills` 1.7.0 实测），命令会询问装到哪些客户端。如需以插件方式安装，按以下步骤操作。
+
+## 1. 下载并构建（用于本地安装）
+
+```bash
+git clone https://github.com/supermax92/qgraphflow.git
+cd qgraphflow
+npm run package
+unzip -q dist/qgraphflow-0.0.6.zip -d dist/runtime
+```
+
+已有 QGraphFlow 源码可跳过克隆，并进入其根目录。ZIP 文件名以 QGraphFlow 的 `package.json` 版本为准；使用新的输出和解压目录，不覆盖旧文件。Git 下载只包含已推送的代码，不包含尚未提交的本地修改。
+
+## 2. 选择客户端安装
+
+以下命令均在 QGraphFlow 源码根目录执行，不是你的业务项目目录。安装的是该目录下 `dist/runtime` 中的完整运行包。
+
+### Codex App / CLI
+
+```bash
+codex plugin marketplace add ./dist/runtime
+codex plugin add qgraphflow@supermax92
+```
+
+这里的 `marketplace add` 只注册本地安装源，不要求公开市场上架。参见 [OpenAI 官方文档](https://developers.openai.com/plugins/build/plugins#add-a-marketplace-from-the-cli)。
+
+新建会话，输入 `$`，选择 `qgraphflow:q-flow`（以客户端实际显示的名称为准）。
+
+### Claude Code
+
+直接从 GitHub 安装，无需执行第 1 步：
+
+```bash
+claude plugin marketplace add supermax92/qgraphflow
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+或使用第 1 步构建的运行包：
+
+```bash
+claude plugin marketplace add ./dist/runtime
+claude plugin install qgraphflow@supermax92 --scope user
+```
+
+新建会话，输入 `/q-flow`（或完整名称 `/qgraphflow:q-flow`）。
+
+### Qoder CLI
+
+```bash
+qodercli plugins install ./dist/runtime
+```
+
+新建会话，选择 `q-flow`。
+
+### Qoder Desktop
+
+**推荐：**打开 **Settings → Plugins → Marketplace**，搜索 **代码图谱可视化** 或 **qgraphflow**，安装插件。新建会话，选择 `q-flow`。无需下载 ZIP 或构建源码。
+
+如需本地安装，先完成第 1 步，再打开 **Settings → Plugins → Custom → Import**，导入完整的 `dist/runtime` 目录；重新加载后选择 `q-flow`。
+
+### Cursor
+
+将 `dist/runtime` 内的全部内容（含隐藏文件）复制到 `~/.cursor/plugins/local/qgraphflow/`。已有目录先备份，勿混合新旧文件。
+
+确认清单位于 `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`，重新加载窗口，在 Customize → Plugins / Skills 中选择 `q-flow`。
+
+此本地方式曾在 Cursor 3.19.13 验证；其他版本请确认插件和技能已显示。