Regenerator 2000

कमोडोर 8-बिट मशीनों के लिए एक आधुनिक, इंटरैक्टिव 6502 डिस्सेम्बलर। Regenerator पर एक आधुनिक दृष्टिकोण।

• 🕹️ मैन्युअल विश्लेषण — एक तेज़, कीबोर्ड-केंद्रित TUI जो हाथों से अन्वेषण के लिए है: कोड नेविगेट करें, डेटा परिभाषित करें, सबरूटीन को लेबल करें, टिप्पणियाँ जोड़ें, और अपने डिस्सेम्बली को पुनरावृत्त रूप से परिष्कृत करें।
• 🤖 स्वचालित विश्लेषण — एक अंतर्निहित MCP सर्वर AI सहायकों को डिस्सेम्बलर को प्रोग्रामेटिक रूप से चलाने की अनुमति देता है। उद्देश्य-निर्मित कौशल के साथ जोड़ा गया, यह पूरे प्रोग्राम का विश्लेषण कर सकता है — ब्लॉक वर्गीकरण, रूटीन ट्रेसिंग, और प्रतीक नामकरण — न्यूनतम मानव हस्तक्षेप के साथ।

किसी एक वर्कफ़्लो का उपयोग करें, या उन्हें संयोजित करें: AI को पहला पास करने दें, फिर परिणामों को इंटरैक्टिव रूप से परिष्कृत करें।

Examples देखें कि क्या हासिल किया जा सकता है, जिसमें विभिन्न कमोडोर प्लेटफ़ॉर्म पर पूर्व-डिस्सेम्बल किए गए गेम शामिल हैं!

विशेषताएँ

Regenerator 2000 6502 डिस्सेम्बली में आधुनिक सुविधाएँ लाता है:

• डिस्सेम्बली: अनिर्दिष्ट ऑपकोड सहित पूर्ण 6502 समर्थन।
• हेक्स डंप:
  • डिस्सेम्बली के साथ साथ-साथ दृश्य।
  • सिंक्रनाइज़ या स्वतंत्र नेविगेशन।
  • अनशिफ्टेड या शिफ्टेड PETSCII और Screencode चारसेट।
• स्प्राइट्स:
  • डिस्सेम्बली के साथ साथ-साथ दृश्य।
  • मल्टीकलर या सिंगल कलर।
• बिटमैप:
  • डिस्सेम्बली के साथ साथ-साथ दृश्य।
  • हाई-रेज़ोल्यूशन (320x200) और मल्टीकलर (160x200)।
  • TUI में पूर्ण रिज़ॉल्यूशन के लिए क्वाड्रंट-ब्लॉक रेंडरिंग का उपयोग करता है।
• चारसेट:
  • डिस्सेम्बली के साथ साथ-साथ दृश्य।
  • मल्टीकलर या सिंगल कलर।
• ब्लॉक:
  • डिस्सेम्बली के साथ साथ-साथ दृश्य।
• डीबगर: लाइव डिस्सेम्बली, ब्रेकपॉइंट, रन/स्टेप (F2–F9) के लिए VICE से कनेक्ट करें; दाएँ पैन में डीबगर पैनल।
• मिनी मैप: विश्लेषण की जा रही फ़ाइल का मिनी मैप।
• सिस्टम: कमोडोर 8-बिट मशीनों का समर्थन करता है: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0, और 1541।
• आयात: निम्नलिखित फ़ाइल फ़ॉर्मेट लोड करें
  • PRG: PRG फ़ाइलें
  • CRT: बैंक चयन समर्थन के साथ कार्ट्रिज इमेज
  • D64: 35/40/42-ट्रैक डिस्क इमेज
  • D71: 70/80-ट्रैक दोहरी-तरफा डिस्क इमेज
  • D81: 80-ट्रैक डिस्क इमेज
  • T64: टेप इमेज
  • VSF: VICE सत्र फ़ाइलें
  • RAW / BIN: रॉ बाइनरी फ़ाइलें
  • DIS65: 6502bench प्रोजेक्ट फ़ाइलें
  • REGEN2000PROJ: Regenerator 2000 प्रोजेक्ट फ़ाइलें
• बाइनरी अनपैकर: संपीड़ित C64 प्रोग्रामों को स्वचालित रूप से डीकंप्रेस करने के लिए एक साइकिल-सटीक 6502 बैकग्राउंड सैंडबॉक्स का अनुकरण करें।
• .asm या HTML में निर्यात करें। समर्थित असेंबलर:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• प्रोजेक्ट प्रबंधन: अपने कार्य को सहेजें और लोड करें
• विश्लेषण: कोड और डेटा क्षेत्रों की पहचान करने के लिए ऑटो-विश्लेषण।
• संपादन:
  • लेबल: स्थानीय और वैश्विक लेबल जोड़ें, संपादित करें और हटाएँ।
  • एनम: मैजिक नंबरों को अर्थपूर्ण नामों से बदलने के लिए तीन-स्तरीय मूल्य-से-नाम मैपिंग (सिस्टम, वैश्विक, प्रोजेक्ट-विशिष्ट) परिभाषित करें और लागू करें।

आवश्यकताएँ

अनुशंसित टर्मिनल

सर्वोत्तम अनुभव सुनिश्चित करने के लिए, विशेष रूप से कीबोर्ड शॉर्टकट और रेंडरिंग के संबंध में, हम एक आधुनिक टर्मिनल का उपयोग करने की सलाह देते हैं।

स्थापना

Crates.io से

cargo install regenerator2000

स्रोत से

git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .

AI एजेंटों के साथ त्वरित आरंभ

AI एजेंट (जैसे Antigravity या Claude Code) का उपयोग करके बाइनरी का विश्लेषण जल्दी से शुरू करने के लिए, आप regenerator2000-template रिपॉजिटरी का उपयोग कर सकते हैं। यह सभी आवश्यक कौशल और एजेंट अनुमतियों के साथ पूर्व-कॉन्फ़िगर किया गया है ताकि आप तुरंत बाइनरी का विश्लेषण और रिवर्स-इंजीनियरिंग शुरू कर सकें।

उपयोग

एक वैकल्पिक फ़ाइल लोड करने के साथ एप्लिकेशन प्रारंभ करें:

regenerator2000 [OPTIONS] [path/to/file.prg]

CLI विकल्प

• --help: सहायता संदेश प्रिंट करें
• --version: संस्करण जानकारी प्रिंट करें
• --import_lbl <PATH>: निर्दिष्ट फ़ाइल से VICE लेबल आयात करें
• --export_lbl <PATH>: निर्दिष्ट फ़ाइल में लेबल निर्यात करें (विश्लेषण/आयात के बाद)
• --export_asm <PATH>: निर्दिष्ट फ़ाइल में असेंबली निर्यात करें (विश्लेषण/आयात के बाद)
• --export_html <PATH>: निर्दिष्ट फ़ाइल में HTML निर्यात करें (विश्लेषण/आयात के बाद)
• --assembler <NAME>: निर्यात के लिए असेंबलर फ़ॉर्मेट को ओवरराइड करें। मान्य मान: 64tass, acme, ca65, kick
• --headless: हेडलेस मोड में चलाएँ (कोई TUI नहीं), बैच प्रोसेसिंग के लिए उपयोगी
• --verify: सभी असेंबलरों के लिए निर्यात राउंडट्रिप (निर्यात → असेंबल → डिफ) सत्यापित करें। को निहित करता है

समर्थित फ़ाइल फ़ॉर्मेट: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw, और .regen2000proj।

कीबोर्ड शॉर्टकट

सभी कीबोर्ड शॉर्टकट यहाँ दस्तावेज़ित हैं: keyboard_shortcuts

समर्थन और दस्तावेज़ीकरण

• दस्तावेज़ीकरण
• Examples: डिस्सेम्बल किए गए कमोडोर गेम और सॉफ्टवेयर का प्रदर्शन, जो दर्शाता है कि विभिन्न समर्थित प्लेटफ़ॉर्म पर Regenerator 2000 के साथ क्या हासिल किया जा सकता है।
• Discord पर समर्थन (#regenerator2000 चैनल में शामिल हों, "Misc Projects" के अंतर्गत)

योगदान

योगदान का स्वागत है! कृपया बेझिझक Pull Request सबमिट करें।

आभार

• Regenerator: विंडोज के लिए मूल 6502 डिस्सेम्बलर।
• unp64: iAN CooG द्वारा C64 बाइनरी अनपैकर, जिस पर अनपैकर मॉड्यूल आधारित है।
• 64tass, ACME, Kick Assembler, ca65 : समर्थित असेंबलर।

लाइसेंस

दोहरा लाइसेंस: MIT और Apache 2