123wwwa/flownameاستعادة معرّفات JavaScript من الجيل التالي باستخدام LLMs.
جرّب FlowName في متصفحك ← — أدخل JavaScript ومفتاح API والطراز؛ لا حاجة إلى تثبيت.
CLI: npx --yes --package=flowname@latest flowname input.js (عيّن GEMINI_API_KEY أولاً).
FlowName هو أداة استعادة المعرّفات الدلالية من الجيل التالي لـ JavaScript المُعتَّم. باستخدام التحليل الساكن القائم على AST لتجميع المتغيرات المرتبطة منطقياً في طلبات LLM محدودة الميزانية، يزيل FlowName هلوسات فقدان السياق الشائعة في أساليب نافذة النص الساذجة.
في اختبار مرجعي مباشر مقابل أداة رائدة قائمة على الرموز (Humanify) على نطاق مُعتَّم يحتوي على 411 ارتباطاً، حقق FlowName:
استكشف جميع مقارنات الأسماء الـ 411 في تقرير HTML. مقارنة 155 مقابل 37 هي حكم Jev آلي غير معاير؛ لا يمكن لهذا التشغيل لبرنامج واحد أن يثبت ميزة عامة في جودة التسمية. راجع ملاحظات الاختبار المرجعي.
عيّن (أو ) في بيئتك، ثم شغّل:
GEMINI_API_KEYFLOWNAME_API_KEYnpx --yes --package=flowname@latest flowname input.js
يكتب CLI الكود المُستعاد إلى دليل جديد flowname-output-TIMESTAMP-ID/output.js. أضف --report لمشاهدة كل طلب والاسم المقترح في تقرير HTML مباشر. لا حاجة إلى أي أعلام لطراز Gemini الافتراضي؛ لا يحمّل CLI ملف .env تلقائياً. يتطلب Node.js 22.8+.
للمتصفح، افتح ساحة التجربة، والصق JavaScript، وقدّم مفتاح API الخاص بك وابدأ الاستعادة. تنتقل الطلبات مباشرة من متصفحك إلى المزوّد المحدد؛ إيقاف يقطع التشغيل.
يسمّي FlowName المعرّفات؛ وهو لا يفكّ الحزم أو يلغي التعتيم البنيوي. استخدم webcrack لأنماط التعتيم المدعومة أو Wakaru للحزم المدعومة، ثم مرّر JavaScript الناتج إلى 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.
مرخّص بموجب MIT. راجع ملاحظات الإصدار.