
次世代のLLMによるJavaScript識別子復元。
名前の品質は、自動化された未校正のJev評価によってのみ好まれた名前の比率を示しています。アニメーション付きチャート → · 正確なカウント、手法、制限事項 →
ブラウザでFlowNameを試す → — JavaScript、APIキー、モデルを入力するだけ。インストールは不要です。
CLI: npx --yes --package=flowname@latest flowname input.js(先にGEMINI_API_KEYを設定してください)。
FlowNameは、難読化されたJavaScript向けの次世代セマンティック識別子復元ツールです。ASTベースの静的解析を用いて論理的に関連する変数を予算内のLLMリクエストにグループ化することで、FlowNameは素朴なテキストウィンドウ方式でよく見られるコンテキスト喪失によるハルシネーションを排除します。
CigarとGrobPaintにおける主要なシンボルベースツール(Humanify)との2つの直接ベンチマークを通じて、FlowNameは以下の平均相対結果を達成しました:
GrobPaintの1,786個の匿名化されたバインディングに関する2回目の比較では、FlowNameは1,786回に対して408回のAPI呼び出しを使用し、総トークン数は29.36%少なくなりました。元のソースを認識するJevでは、274回に対して512回の排他的な選好が得られました。
ベンチマークの概要と2つの検索可能な名前レポートを見る。 Jevの判定は自動化されており、未校正です。Humanifyのプロンプトには一部のバインディングで対象の綴りが含まれておらず、衝突を避けるためのサフィックスが適用後の名前スコアに影響する可能性があります。コンテキストの分割と制限事項については概要を参照してください。
環境変数またはカレントディレクトリの.envファイルにGEMINI_API_KEY(またはFLOWNAME_API_KEY)を設定し、以下を実行してください:
npx --yes --package=flowname@latest flowname input.js
別の OpenAI 互換エンドポイントを使用する場合、または環境変数を省略する場合は、すべてをフラグとして渡します:
npx --yes --package=flowname@latest flowname input.js --base-url https://api.openai.com/v1 --model MODEL --api-key YOUR_API_KEY
フラグが優先され、次に環境変数、最後に .env の順になります。これらが一致しない場合、CLI は警告を表示します。フラグとして渡されたキーは、シェル履歴やプロセス一覧に表示される可能性があります。
何かを消費する前にコストを確認するか、大きなファイルの一部を先に試してください:
flowname input.js --dry-run # planned API calls and prompt bytes; no key needed
flowname input.js --sample-requests 3 # send only the first 3 planned requests
flowname - -o - < input.js > output.js # standard input to standard output
CLI は復元されたコードを新しい flowname-output-TIMESTAMP-ID/output.js ディレクトリに書き出します。--report を追加すると、各リクエストと提案された名前をライブ HTML レポートで確認できます。デフォルトの Gemini モデルではフラグは不要です。Node.js 22.8+ が必要です。
ブラウザで使用するには、playground を開き、JavaScript を貼り付け、自身の API キーを入力して復元を開始してください。リクエストはブラウザから選択したプロバイダーへ直接送信されます。Stop で実行を中断できます。
FlowName は識別子に名前を付けるものであり、バンドルを展開したり構造的な難読化を解除したりするものではありません。サポートされている難読化パターンには webcrack を、サポートされているバンドルには Wakaru を使用し、その結果得られた JavaScript を FlowName に渡してください。FlowName は字句バインディングを解決し、軽量な関係と同一スコープのフォールバックを用いてターゲットをグループ化し、リクエストごとに複数の名前を LLM に問い合わせます。グループ化の仕組みを参照。
npm install flowname
import { readFile } from 'node:fs/promises';
import { recoverNames, createProvider } from 'flowname';
const sourceCode = await readFile('./input.js', 'utf8');
const provider = createProvider({
provider: 'gemini',
model: 'gemini-3.5-flash-lite',
apiKey: process.env.GEMINI_API_KEY,
});
const result = await recoverNames(sourceCode, { provider });
console.log(result.code);
オプション、CLIレポート、完全なライブラリの例については、使用ガイドを参照してください。ドキュメント索引では、アプローチ、アーキテクチャ、制限事項、先行研究、およびHumanifyとの比較を扱っています。