मैन्युअल Chrome एक्सटेंशन परिदृश्य
रिकॉर्डिंग Admin कैप्चर जॉब Desktop → Web Extension है। आंतरिक परिवेश WebExtension; मेटाडेटा/सार्वजनिक MCP web-extension है। एजेंट चुना स्टोर एक्सटेंशन डाउनलोड करके अस्थायी Chromium प्रोफ़ाइल में उसे/Reconstruct कैप्चर एक्सटेंशन खोलता है। ऑपरेटर नेविगेट करता है; स्क्रीन/देखे संक्रमण reconstruct.scene.v1 में बचते हैं।
जॉब बनाएँ/चलाएँ
- Admin → Jobs → Create में Desktop → Web Extension चुनें। केवल एक्सटेंशन चाहिए तो Web हटाएँ। मोबाइल Web, iOS, Android रहते हैं।
- Environment Settings → Web Extension में स्टोर लिंक डालें। स्थानीय एक्सटेंशन डायरेक्टरी/व्यक्तिगत ब्राउज़र प्रोफ़ाइल स्वीकार नहीं।
- जॉब कतार में दें। Desktop / Web Extension को सौंपा सक्षम Capture Agent लेता है। Web/Extension worker एक-दूसरे की जॉब नहीं लेते।
- एजेंट Google अपडेट से हस्ताक्षरित CRX3 लेकर ID/प्रकाशक हस्ताक्षर जाँचने के बाद निजी डायरेक्टरी में खोलता है। Unpacked लोड में स्टोर ID रहता है।
browserExtensionमें सत्यापित ID, स्थानीय नाम, पैकेज संस्करण, SHA-256 हैं; कैटलॉग नाम पैकेज से है। पथ, फ़ाइल संख्या, खोला आकार पहले जाँचे जाते हैं। - Chromium एक्सटेंशन onboarding खोलता है, अन्यथा घोषित options/action popup। UI प्रवेश बिना एक्सटेंशन विफल होता है।
- ब्राउज़र एक्सटेंशन मेन्यू में Reconstruct Agent Browser Bridge खोलें। Popup में सक्रिय जॉब ID/स्क्रीन संख्या है। हर स्क्रीन पर Capture screen लें। वहीं Pause, Resume, Finish recording हैं।
अलग recorder CLI/अतिरिक्त MCP नहीं चलाना है। नियंत्रण सक्रिय जॉब/निजी स्थानीय टोकन से जुड़े हैं; फ़ील्ड मान, मनमाने लेबल, URL नहीं लेते। Admin → Jobs → job → Live browser से देख/नियंत्रित करें; इनपुट केवल ऑपरेटर प्रतीक्षा में मान्य। अन्य एक्सटेंशन/जॉब अस्वीकृत। नया टैब खोले तो पहले सक्रिय करें; बदलने से पहले पहचान जाँचते हैं। पासवर्ड, वॉलेट बनाना, सहमति, पंजीकरण मैन्युअल हैं।
साइन इन जॉब और स्वतः खोज
Onboarding वाले एक्सटेंशन, जैसे MetaMask वॉलेट, अर्ध-स्वतः रिकॉर्ड कर सकते हैं। Environment Settings → Web Extension में Sign-in को Operator registers या Operator signs in रखें।
- जॉब ऑपरेटर की प्रतीक्षा करता है। Admin → Jobs → job → Live browser या उसी ब्राउज़र में onboarding करें। Capture screen से बचाएँ; पासवर्ड/रिकवरी वाक्य स्क्रीन कभी नहीं बचती।
- कंसोल में Finish sign-in, Admin में Continue, या popup में Finish sign-in and explore लें।
- फिर Reconstruct popup, options, side panel और नेविगेशन से जुड़े मार्ग देखता है, हर मार्ग एक स्क्रीन। भेजने, हस्ताक्षर, पुष्टि, रहस्य दिखाने, निर्यात, लॉक, हटाने, बनाने वाले नियंत्रण कभी नहीं दबाता।
- एक्सटेंशन लॉक हो तो Signed out में रुकता है, ऑपरेटर खोलकर Finish sign-in दोबारा लेता है। मार्ग समाप्त/पृष्ठ सीमा पर रिकॉर्डिंग बंद होकर समीक्षा को अपलोड होती है।
Web जॉब में समान Sign-in है: लॉगिन स्क्रीन stage, logout लिंक छोड़ना, सत्र समाप्त पर विराम। CAPTCHA, SMS, शर्त सहमति ऑपरेटर करता है। backend/docs/operator-sign-in.md देखें।
एजेंट सेटअप
backend/agent-browser-extensions में yarn nx run chrome:build से मेल खाता adapter बनाएँ। Node.js 24+, Python 3, एक्सटेंशन समर्थित Chromium चाहिए। मौजूदा Capture Agent को ignored स्थानीय सेटिंग/परिवेश से सेट करें:
{
"Agent": {
"Id": "extension-worker",
"ApiUrl": "https://internal-admin-api.example",
"ChromiumPath": "/Applications/Chromium.app/Contents/MacOS/Chromium",
"ExtensionDir": "/checkout/backend/agent-browser-extensions/chrome"
},
"WebExtension": {
"RecorderDirectory": "/checkout/backend/tools/manual-recorder",
"NodePath": "node",
"PythonPath": "python3"
}
}
मौजूदा ApiTokens:Agent निजी कॉन्फ़िगरेशन से दें। Kestrel Web listener loopback होना चाहिए। extension serve से binary चलाकर Admin में Desktop / Web Extension सौंपें। हर mode अपना listener/lock रखता है; एक endpoint पर दो worker न चलाएँ। दूरस्थ worker को managed isolated ब्राउज़र host और स्पष्ट WebExtension:ManagedBrowserIsolated चाहिए; एक्सटेंशन अपना नेटवर्क/background कोड चलाते हैं। फ़्लैग isolation बनाता नहीं। मौजूदा Agent:AllowHttpApi loopback विकास API पर लागू है।
Worker claim, heartbeat, रद्द करना, upload retry संभालता है। Node child निजी pipe लेता है, debug TCP नहीं। अंत में ब्राउज़र बंद/अस्थायी प्रोफ़ाइल हटती है। खाली test wallet लें; परिदृश्य क्रेडेंशियल/उपयोगी wallet नहीं बचाता।
सीक्रेट और चित्र समीक्षा
पासवर्ड, रिकवरी, कुंजी, कोड से पहले रोकें, संवेदनशील स्क्रीन छोड़कर चालू करें। संरक्षित टेक्स्ट fail-closed होकर अवलोकन कमी देता है। Editable/children चित्र से पहले mask, मान Scene में नहीं पढ़ते। सुरक्षा अवस्था, mask, navigation, दस्तावेज़ बदलने पर पहले/बाद की जाँच कैप्चर अस्वीकारती है।
Canvas/अपारदर्शी pixel निजी समीक्षा मीडिया में दिखते हैं; DOM रहस्य अनुपस्थिति सिद्ध नहीं करता। निरीक्षण/masking एक isolated-world evaluation में समकालिक हैं; screenshot के लिए JavaScript चालू रहता है ताकि native canvas बने।
Finish recording स्वतः पैक/अपलोड करके अप्रकाशित कैप्चर बनाता है। हर checkpoint अपना पृष्ठ, Scene, चित्र रखता है; index पाठ कॉपी बिना संदर्भ देता है। Admin Hide personal data में हर चित्र देखें, संवेदनशील भाग blur/असुरक्षित हटाएँ, फिर प्रकाशित करें। Redaction ढका Scene टेक्स्ट, accessible नाम, दोहराए मान, media भी मिटाता है। अलग मूल media की अलग समीक्षा चाहिए। नियंत्रण प्रकाशित/कच्चे चित्र नहीं लौटा सकते।
MCP से पुनर्निर्माण
समीक्षा/प्रकाशन बाद सामान्य Capture MCP में संस्करण मिलता है। get_scenario_scene वर्तमान पृष्ठ डेटा/Admin redaction से बने फ़्रेम, प्रोफ़ाइल, संक्रमण देता है। स्वीकृत चित्र सामान्य प्रकाशित टूल से लें। हर आवश्यक स्क्रीन/प्रोफ़ाइल के विरुद्ध जाँचें; टूल सफलता अकेले दृश्य सटीकता नहीं।
साक्ष्य और सीमाएँ
Checkpoint स्थिर अवलोकन हैं। Navigation, menu, modal, reveal बाद और हर viewport में लें। लगातार अवलोकन changed/unchanged मापते हैं, स्वतः click नहीं सिद्ध। विराम/ब्लॉक स्पष्ट कमियाँ हैं। हर click चुपके नहीं रिकॉर्ड होता, पंजीकरण replay, native OS permission, स्थिर से animation अनुमान नहीं। रहस्य चरण मैन्युअल/अप्रकाशित हैं। पृष्ठ सीमा checkpoint बाँधती है (स्वतः चयन 200); Scene बजट 100,000 नोड/जॉब। समय/तत्व सीमा भी है।
अनुरोध उपलब्धता
Admin → Requests → Job defaults → Request submissions में अनुमत प्रकार/परिवेश दें। डिफ़ॉल्ट Desktop/Web, Desktop/Web Extension, Mobile/Web। Allow new requests सभी नए भेजना बंद/खोलता है; बंद रहते चयन सहेजता है। पुराने अनुरोध/प्रकाशित कैप्चर उपलब्ध हैं। वही स्थायी नीति API/प्रमाणित MCP, पुराने फ़ॉर्म पर भी है। बंद होने पर विकल्प में प्लेटफ़ॉर्म नहीं। कैटलॉग केवल उत्पाद के कैप्चर परिवेश दिखाता; अनुरोध उपलब्धता प्रकाशित साक्ष्य नहीं छिपाती।