qgraphflow 0.0.6 → 0.0.7

package/docs/clients.ja.md

@@ -4,9 +4,9 @@
 
 [README に戻る](readme/README.ja.md)
 
-Qoder Desktop ではマーケットプレイスから、Claude Code では GitHub から直接インストールできます（下記の各項を参照）。どちらも手順 1 は不要です。ローカルインストールの場合は、先に QGraphFlow のソースコードをダウンロードして実行用パッケージを作成してください。
+Qoder Desktop ではマーケットプレイスからインストールでき、手順 1 は不要です（下記の該当項を参照）。その他のクライアントでは、npmjs.com から取得したプラグインパッケージをインストールします。
 
-Node.js 22 以降と、モデルへのアクセスを設定済みのクライアントが必要です。ソースからビルドする場合は、Git、npm、`tar`、`zip`、`unzip` も必要です。
+Node.js 22 以降（npm を含む）と、モデルへのアクセスを設定済みのクライアントが必要です。
 
 ## クイックインストール
 
@@ -16,25 +16,25 @@ npx skills add supermax92/qgraphflow
 
 Claude Code、Codex、Cursor、Qoder にスキル `q-flow` を導入します（`skills` 1.7.0 で実測済み）。導入先のクライアントを尋ねられます。プラグインとして導入する場合は、次の手順に従ってください。
 
-## 1. ローカルインストール用のダウンロードとパッケージ作成
+## 1. npm からプラグインをダウンロード
 
 ```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
+mkdir qgraphflow-install
+cd qgraphflow-install
+npm install qgraphflow --ignore-scripts
+cd node_modules/qgraphflow
 ```
 
-QGraphFlow のソースコードが手元にある場合はクローンを省略し、そのルートディレクトリに移動してください。ZIP 名は QGraphFlow の `package.json` のバージョンに合わせます。出力先と展開先には新しいディレクトリを使い、既存ファイルを上書きしないでください。Git で取得できるのはプッシュ済みのコードのみで、未コミットのローカル変更は含まれません。
+ディレクトリは業務プロジェクトの外に作成します。アカウント、ログイン、トークンは不要です。これでプラグインのルートディレクトリに移動できました。npm でダウンロードしてもクライアントへのインストールは自動では行われないため、手順 2 に進んでください。未リリースのコードをインストールする場合は、[ソースからのビルド手順](https://github.com/supermax92/qgraphflow/blob/main/docs/distribution.md#prepare-locally)を参照してください。
 
 ## 2. クライアントにインストール
 
-以下のコマンドは、自分の業務プロジェクトではなく、QGraphFlow のソースコードのルートディレクトリで実行します。その配下の `dist/runtime` にある完全な実行用パッケージをインストールします。
+以下のコマンドは、自分の業務プロジェクトではなく、手順 1 で移動したプラグインのルートディレクトリ（`qgraphflow-install/node_modules/qgraphflow`）で実行します。
 
 ### Codex App / CLI
 
 ```bash
-codex plugin marketplace add ./dist/runtime
+codex plugin marketplace add .
 codex plugin add qgraphflow@supermax92
 ```
 
@@ -44,17 +44,8 @@ codex plugin add qgraphflow@supermax92
 
 ### 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 marketplace add ./
 claude plugin install qgraphflow@supermax92 --scope user
 ```
 
@@ -63,20 +54,20 @@ claude plugin install qgraphflow@supermax92 --scope user
 ### Qoder CLI
 
 ```bash
-qodercli plugins install ./dist/runtime
+qodercli plugins install .
 ```
 
 新しいセッションを開始し、`q-flow` を選択します。
 
 ### Qoder Desktop
 
-**推奨：** **Settings → Plugins → Marketplace** を開き、**代码图谱可视化** または **qgraphflow** を検索してインストールします。新しいセッションを開始し、`q-flow` を選択します。ZIP のダウンロードやソースのビルドは不要です。
+**推奨：** **Settings → Plugins → Marketplace** を開き、**QGraphFlow** または **代码图谱可视化** を検索してインストールします。新しいセッションを開始し、`q-flow` を選択します。
 
-ローカルインストールの場合は手順 1 を完了し、**Settings → Plugins → Custom → Import** を開いて、`dist/runtime` ディレクトリ全体をインポートします。再読み込み後、`q-flow` を選択します。
+ローカルインストールの場合は手順 1 を完了し、**Settings → Plugins → Custom → Import** を開いて、プラグインのルートディレクトリ全体をインポートします。再読み込み後、`q-flow` を選択します。
 
 ### Cursor
 
-`dist/runtime` の内容を隠しファイルも含めてすべて `~/.cursor/plugins/local/qgraphflow/` にコピーします。既存のディレクトリがある場合は先にバックアップし、新旧のファイルを混在させないでください。
+プラグインのルートディレクトリの内容を隠しファイルも含めてすべて `~/.cursor/plugins/local/qgraphflow/` にコピーします。既存のディレクトリがある場合は先にバックアップし、新旧のファイルを混在させないでください。
 
 マニフェストが `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json` にあることを確認します。ウィンドウを再読み込みし、Customize → Plugins / Skills で `q-flow` を選択します。
 

package/docs/clients.md

@@ -4,9 +4,9 @@
 
 [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.
+Qoder Desktop can install the plugin from its marketplace and skip step 1 (see its section below). The other clients install the plugin package from npmjs.com.
 
-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`.
+You need Node.js 22 or later (with npm) and a client with model access configured.
 
 ## Quick install
 
@@ -16,25 +16,25 @@ 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
+## 1. Download the plugin from npm
 
 ```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
+mkdir qgraphflow-install
+cd qgraphflow-install
+npm install qgraphflow --ignore-scripts
+cd node_modules/qgraphflow
 ```
 
-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.
+Create the directory outside your application project; no account, login or token is needed. You are now in the plugin root. Downloading through npm does not install the plugin in your client; continue with step 2. To install code that is not yet released, see the [source build instructions](https://github.com/supermax92/qgraphflow/blob/main/docs/distribution.md#prepare-locally).
 
 ## 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.
+Run the commands below from the plugin root entered in step 1 (`qgraphflow-install/node_modules/qgraphflow`), not your application's project directory.
 
 ### Codex App / CLI
 
 ```bash
-codex plugin marketplace add ./dist/runtime
+codex plugin marketplace add .
 codex plugin add qgraphflow@supermax92
 ```
 
@@ -44,17 +44,8 @@ Start a new session, type `$`, and select `qgraphflow:q-flow` (use the name actu
 
 ### 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 marketplace add ./
 claude plugin install qgraphflow@supermax92 --scope user
 ```
 
@@ -63,20 +54,20 @@ Start a new session and enter `/q-flow` (or the fully qualified `/qgraphflow:q-f
 ### Qoder CLI
 
 ```bash
-qodercli plugins install ./dist/runtime
+qodercli plugins install .
 ```
 
 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.
+**Recommended:** Open **Settings → Plugins → Marketplace**, search for **QGraphFlow** or **代码图谱可视化**, and install the plugin. Start a new session and select `q-flow`.
 
-For local installation, complete step 1, then open **Settings → Plugins → Custom → Import** and import the complete `dist/runtime` directory. Reload, then select `q-flow`.
+For local installation, complete step 1, then open **Settings → Plugins → Custom → Import** and import the complete plugin root 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.
+Copy everything inside the plugin root, 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.
 

package/docs/clients.pt.md

@@ -4,9 +4,9 @@
 
 [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.
+O Qoder Desktop pode instalar o plugin pelo Marketplace e pular a etapa 1 (veja a seção correspondente abaixo). Os demais clientes instalam o pacote do plugin obtido no npmjs.com.
 
-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`.
+Você precisa de Node.js 22 ou posterior (com npm) e de um cliente com acesso ao modelo configurado.
 
 ## Instalação rápida
 
@@ -16,25 +16,25 @@ 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
+## 1. Baixar o plugin pelo npm
 
 ```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
+mkdir qgraphflow-install
+cd qgraphflow-install
+npm install qgraphflow --ignore-scripts
+cd node_modules/qgraphflow
 ```
 
-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.
+Crie o diretório fora do projeto da sua aplicação; não é preciso conta, login nem token. Agora você está na raiz do plugin. Baixar pelo npm não instala o plugin no cliente; continue na etapa 2. Para instalar código ainda não lançado, consulte as [instruções de compilação a partir do código-fonte](https://github.com/supermax92/qgraphflow/blob/main/docs/distribution.md#prepare-locally).
 
 ## 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`.
+Execute os comandos abaixo na raiz do plugin aberta na etapa 1 (`qgraphflow-install/node_modules/qgraphflow`), não no diretório do seu próprio projeto.
 
 ### Codex App / CLI
 
 ```bash
-codex plugin marketplace add ./dist/runtime
+codex plugin marketplace add .
 codex plugin add qgraphflow@supermax92
 ```
 
@@ -44,17 +44,8 @@ Inicie uma nova sessão, digite `$` e selecione `qgraphflow:q-flow` (use o nome
 
 ### 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 marketplace add ./
 claude plugin install qgraphflow@supermax92 --scope user
 ```
 
@@ -63,20 +54,20 @@ Inicie uma nova sessão e digite `/q-flow` (ou o nome completo `/qgraphflow:q-fl
 ### Qoder CLI
 
 ```bash
-qodercli plugins install ./dist/runtime
+qodercli plugins install .
 ```
 
 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.
+**Recomendado:** Abra **Settings → Plugins → Marketplace**, pesquise **QGraphFlow** ou **代码图谱可视化** e instale o plugin. Inicie uma nova sessão e selecione `q-flow`.
 
-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`.
+Para uma instalação local, conclua primeiro a etapa 1. Depois, abra **Settings → Plugins → Custom → Import** e importe o diretório raiz completo do plugin. 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.
+Copie todo o conteúdo da raiz do plugin, 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.
 

package/docs/clients.ru.md

@@ -4,9 +4,9 @@
 
 [Вернуться к README](readme/README.ru.md)
 
-В Qoder Desktop плагин можно установить из Marketplace, а в Claude Code — напрямую с GitHub (см. соответствующие разделы ниже). В обоих случаях шаг 1 можно пропустить. Для локальной установки сначала скачайте исходный код QGraphFlow и соберите пакет для установки.
+В Qoder Desktop плагин можно установить из Marketplace и пропустить шаг 1 (см. соответствующий раздел ниже). Остальные клиенты устанавливают пакет плагина с npmjs.com.
 
-Нужны Node.js 22 или новее и клиент с настроенным доступом к модели. Для сборки из исходников также нужны Git, npm, `tar`, `zip` и `unzip`.
+Нужны Node.js 22 или новее (с npm) и клиент с настроенным доступом к модели.
 
 ## Быстрая установка
 
@@ -16,25 +16,25 @@ npx skills add supermax92/qgraphflow
 
 Устанавливает навык `q-flow` для Claude Code, Codex, Cursor и Qoder (проверено с `skills` 1.7.0) и спрашивает, в какие клиенты устанавливать. Чтобы установить плагин, выполните шаги ниже.
 
-## 1. Скачать и собрать для локальной установки
+## 1. Скачать плагин из npm
 
 ```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
+mkdir qgraphflow-install
+cd qgraphflow-install
+npm install qgraphflow --ignore-scripts
+cd node_modules/qgraphflow
 ```
 
-Если исходный код QGraphFlow уже скачан, пропустите клонирование и перейдите в его корневой каталог. Имя ZIP должно соответствовать версии в `package.json` проекта QGraphFlow. Используйте новые каталоги для сборки и распаковки, не перезаписывая старые файлы. Git скачивает только отправленный в репозиторий код, без незакоммиченных локальных изменений.
+Создайте каталог вне своего рабочего проекта; учётная запись, вход и токен не нужны. Теперь вы в корневом каталоге плагина. Загрузка через npm не устанавливает плагин в клиент — перейдите к шагу 2. Чтобы установить ещё не выпущенный код, см. [инструкции по сборке из исходников](https://github.com/supermax92/qgraphflow/blob/main/docs/distribution.md#prepare-locally).
 
 ## 2. Установить в клиент
 
-Выполняйте команды ниже из корневого каталога исходного кода QGraphFlow, а не из каталога вашего приложения. Они устанавливают полный пакет из вложенного каталога `dist/runtime`.
+Выполняйте команды ниже из корневого каталога плагина, в который вы перешли на шаге 1 (`qgraphflow-install/node_modules/qgraphflow`), а не из каталога вашего приложения.
 
 ### Codex App / CLI
 
 ```bash
-codex plugin marketplace add ./dist/runtime
+codex plugin marketplace add .
 codex plugin add qgraphflow@supermax92
 ```
 
@@ -44,17 +44,8 @@ codex plugin add qgraphflow@supermax92
 
 ### 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 marketplace add ./
 claude plugin install qgraphflow@supermax92 --scope user
 ```
 
@@ -63,20 +54,20 @@ claude plugin install qgraphflow@supermax92 --scope user
 ### Qoder CLI
 
 ```bash
-qodercli plugins install ./dist/runtime
+qodercli plugins install .
 ```
 
 Начните новый сеанс и выберите `q-flow`.
 
 ### Qoder Desktop
 
-**Рекомендуется:** Откройте **Settings → Plugins → Marketplace**, найдите **代码图谱可视化** или **qgraphflow** и установите плагин. Начните новый сеанс и выберите `q-flow`. Скачивать ZIP или собирать исходный код не требуется.
+**Рекомендуется:** Откройте **Settings → Plugins → Marketplace**, найдите **QGraphFlow** или **代码图谱可视化** и установите плагин. Начните новый сеанс и выберите `q-flow`.
 
-Для локальной установки выполните шаг 1, затем откройте **Settings → Plugins → Custom → Import** и импортируйте весь каталог `dist/runtime`. Перезагрузите клиент и выберите `q-flow`.
+Для локальной установки выполните шаг 1, затем откройте **Settings → Plugins → Custom → Import** и импортируйте весь корневой каталог плагина. Перезагрузите клиент и выберите `q-flow`.
 
 ### Cursor
 
-Скопируйте всё содержимое `dist/runtime`, включая скрытые файлы, в `~/.cursor/plugins/local/qgraphflow/`. Если каталог уже существует, сначала сделайте резервную копию; не смешивайте старые и новые файлы.
+Скопируйте всё содержимое корневого каталога плагина, включая скрытые файлы, в `~/.cursor/plugins/local/qgraphflow/`. Если каталог уже существует, сначала сделайте резервную копию; не смешивайте старые и новые файлы.
 
 Убедитесь, что манифест находится по адресу `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`. Перезагрузите окно и выберите `q-flow` в Customize → Plugins / Skills.
 

package/docs/clients.zh-CN.md

@@ -4,9 +4,9 @@
 
 [返回 README](readme/README.zh-CN.md)
 
-Qoder Desktop 可从插件商城安装，Claude Code 可直接从 GitHub 安装（见下方对应小节），两者均可跳过第 1 步。采用本地安装时，先下载 QGraphFlow 源码并构建运行包。
+Qoder Desktop 可从插件商城安装，跳过第 1 步（见下方对应小节）。其他客户端安装从 npmjs.com 下载的插件包。
 
-准备 Node.js 22 及以上版本，以及已配置好模型访问的客户端。从源码构建还需 Git、npm、`tar`、`zip` 和 `unzip`。
+准备 Node.js 22 及以上版本（含 npm），以及已配置好模型访问的客户端。
 
 ## 快速安装
 
@@ -16,25 +16,25 @@ npx skills add supermax92/qgraphflow
 
 为 Claude Code、Codex、Cursor 和 Qoder 安装技能 `q-flow`（已用 `skills` 1.7.0 实测），命令会询问装到哪些客户端。如需以插件方式安装，按以下步骤操作。
 
-## 1. 下载并构建（用于本地安装）
+## 1. 从 npm 下载插件
 
 ```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
+mkdir qgraphflow-install
+cd qgraphflow-install
+npm install qgraphflow --ignore-scripts
+cd node_modules/qgraphflow
 ```
 
-已有 QGraphFlow 源码可跳过克隆，并进入其根目录。ZIP 文件名以 QGraphFlow 的 `package.json` 版本为准；使用新的输出和解压目录，不覆盖旧文件。Git 下载只包含已推送的代码，不包含尚未提交的本地修改。
+在业务项目之外创建该目录，无需账号、登录或令牌。此时已进入插件根目录。npm 下载不会自动完成客户端安装，请继续第 2 步。如需安装尚未发布的代码，参见[源码构建说明](https://github.com/supermax92/qgraphflow/blob/main/docs/distribution.md#prepare-locally)。
 
 ## 2. 选择客户端安装
 
-以下命令均在 QGraphFlow 源码根目录执行，不是你的业务项目目录。安装的是该目录下 `dist/runtime` 中的完整运行包。
+以下命令均在第 1 步进入的插件根目录（`qgraphflow-install/node_modules/qgraphflow`）执行，不是你的业务项目目录。
 
 ### Codex App / CLI
 
 ```bash
-codex plugin marketplace add ./dist/runtime
+codex plugin marketplace add .
 codex plugin add qgraphflow@supermax92
 ```
 
@@ -44,17 +44,8 @@ codex plugin add qgraphflow@supermax92
 
 ### 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 marketplace add ./
 claude plugin install qgraphflow@supermax92 --scope user
 ```
 
@@ -63,20 +54,20 @@ claude plugin install qgraphflow@supermax92 --scope user
 ### Qoder CLI
 
 ```bash
-qodercli plugins install ./dist/runtime
+qodercli plugins install .
 ```
 
 新建会话，选择 `q-flow`。
 
 ### Qoder Desktop
 
-**推荐：**打开 **Settings → Plugins → Marketplace**，搜索 **代码图谱可视化** 或 **qgraphflow**，安装插件。新建会话，选择 `q-flow`。无需下载 ZIP 或构建源码。
+**推荐：**打开 **Settings → Plugins → Marketplace**，搜索 **QGraphFlow** 或 **代码图谱可视化**，安装插件。新建会话，选择 `q-flow`。
 
-如需本地安装，先完成第 1 步，再打开 **Settings → Plugins → Custom → Import**，导入完整的 `dist/runtime` 目录；重新加载后选择 `q-flow`。
+如需本地安装，先完成第 1 步，再打开 **Settings → Plugins → Custom → Import**，导入完整的插件根目录；重新加载后选择 `q-flow`。
 
 ### Cursor
 
-将 `dist/runtime` 内的全部内容（含隐藏文件）复制到 `~/.cursor/plugins/local/qgraphflow/`。已有目录先备份，勿混合新旧文件。
+将插件根目录内的全部内容（含隐藏文件）复制到 `~/.cursor/plugins/local/qgraphflow/`。已有目录先备份，勿混合新旧文件。
 
 确认清单位于 `~/.cursor/plugins/local/qgraphflow/.cursor-plugin/plugin.json`，重新加载窗口，在 Customize → Plugins / Skills 中选择 `q-flow`。