@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/local-file-mode.md

@@ -0,0 +1,433 @@
+---
+title: "स्थानीय फ़ाइल मोड"
+description: "सच्चाई के स्रोत के रूप में स्थानीय Markdown, MDX और अन्य रेपो फ़ाइलों के साथ एजेंट-मूल ऐप्स चलाएं - जिसमें कस्टम घटकों के साथ ओब्सीडियन-शैली MDX दस्तावेज़ शामिल हैं।"
+---
+
+# स्थानीय फ़ाइल मोड
+
+स्थानीय फ़ाइल मोड एक एजेंट-मूल ऐप को उसकी सामान्य UI और क्रिया सतह संलग्न करने देता है
+सीधे रेपो या कार्यक्षेत्र में फ़ाइलों तक। ऐप अभी भी होस्ट किया हुआ लगता है
+उत्पाद, लेकिन इसके सूची दृश्य, संपादक और एजेंट उपकरण स्थानीय फ़ाइलें पढ़ते और लिखते हैं
+SQL-समर्थित ऐप रिकॉर्ड के बजाय।
+
+पहला कार्यान्वयन सामग्री टेम्पलेट में है: बायां साइडबार है
+स्थानीय `.md` और `.mdx` फ़ाइलों से भरा हुआ, एक पृष्ठ का चयन करने से मानक खुल जाता है
+सामग्री संपादक, और बचत चयनित फ़ाइल पर वापस लिखता है। वही फ़ाइलें
+Codex, Claude कोड, Agent-Native साइडबार एजेंट या सामान्य द्वारा भी संपादित किया जा सकता है
+संपादक.
+
+सामग्री के लिए, यह उत्पाद को MDX के लिए ओपन-सोर्स ओब्सीडियन जैसा महसूस कराता है:
+आपके दस्तावेज़ फ़ाइलों के रूप में रहते हैं, जबकि ऐप एक विज़ुअल संपादक, एजेंट actions जोड़ता है,
+साझा करने योग्य प्रतियां, और समृद्ध इंटरैक्टिव MDX घटक।
+
+जब आप रेपो-प्रथम वर्कफ़्लो चाहते हैं तो स्थानीय फ़ाइल मोड का उपयोग करें:
+
+- `docs/*.mdx` के साथ एक डॉक्स रेपो
+- `blog/*.mdx` के साथ एक ब्लॉग
+- `resources/*.md` में पोजिशनिंग, मैसेजिंग या टीम नोट्स जैसे संसाधन
+- एक समृद्ध MDX संपादक के साथ एक व्यक्तिगत ओब्सीडियन-शैली ज्ञान का आधार
+- ऐसे दस्तावेज़ जिन्हें स्थानीय React कोड से उत्पन्न इंटरैक्टिव कस्टम MDX ब्लॉक की आवश्यकता होती है
+- ऐप कलाकृतियाँ जिनका निरीक्षण करना और पैच करना कोडिंग एजेंटों के लिए आसान होना चाहिए
+
+जब आप होस्टेड सहयोगी ऐप अनुभव चाहते हैं तो डेटाबेस मोड का उपयोग करें:
+बहु-उपयोगकर्ता साझाकरण, SQL-समर्थित अनुमतियाँ, टिप्पणियाँ, संस्करण इतिहास, और
+स्थानीय फ़ाइल सिस्टम पहुंच के बिना उत्पादन होस्टिंग।
+
+## मानसिक मॉडल
+
+सत्य के स्रोत के दो तरीके हैं:
+
+| मोड               | सत्य का स्रोत                                 | के लिए सर्वश्रेष्ठ                                                           |
+| ----------------- | --------------------------------------------- | ---------------------------------------------------------------------------- |
+| डेटाबेस मोड       | SQL पंक्तियाँ Drizzle तक                      | होस्टेड ऐप्स, सहयोग, साझाकरण, टिप्पणियाँ, संस्करण इतिहास                     |
+| स्थानीय फ़ाइल मोड | रेपो फ़ाइलें `agent-native.json` द्वारा घोषित | स्थानीय/डेवलप वर्कफ़्लो, Git समीक्षा, कोडिंग-एजेंट संपादन, फ़ाइल-मूल सामग्री |
+
+UI और एजेंट actions को दोनों मोड में एक ही आकार में रहना चाहिए। एक सामग्री
+संपादक अभी भी दस्तावेज़ों का संपादन करता है; अंतर यह है कि क्या वे दस्तावेज़ हल हो जाते हैं
+SQL पंक्तियों या स्थानीय फ़ाइलों तक।
+
+```an-diagram title="Same actions, two sources of truth" summary="The UI and agent call identical actions in both modes. The action layer decides whether each call resolves to SQL rows or repo files."
+{
+  "html": "<div class=\"diagram-mode\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Content UI</div><div class=\"diagram-node\">Agent + actions<br><small class=\"diagram-muted\">list/get/update-document</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-row resolve\"><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill accent\">Database mode</span><small class=\"diagram-muted\">SQL rows via Drizzle</small><small class=\"diagram-muted\">hosted · sharing · comments · history</small></div><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill ok\">Local File Mode</span><small class=\"diagram-muted\">repo files via agent-native.json</small><small class=\"diagram-muted\">Git review · coding-agent edits</small></div></div></div>",
+  "css": ".diagram-mode{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mode .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mode .diagram-arrow{font-size:22px;line-height:1}.diagram-mode .resolve{display:flex;gap:12px;flex-wrap:wrap}.diagram-mode .diagram-panel{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+}
+```
+
+## उदाहरण रेपो
+
+एक सामग्री कार्यक्षेत्र इतना छोटा हो सकता है:
+
+```an-file-tree title="A Content workspace repo"
+{
+  "entries": [
+    { "path": "agent-native.json", "note": "declares which folders are content roots and their kinds" },
+    { "path": "docs/", "note": "content root — shows in the sidebar as pages" },
+    { "path": "docs/getting-started.mdx" },
+    { "path": "docs/guides/custom-components.mdx" },
+    { "path": "blog/", "note": "content root" },
+    { "path": "blog/launch-post.mdx" },
+    { "path": "resources/", "note": "content root" },
+    { "path": "resources/messaging/positioning.md" },
+    { "path": "components/", "note": "NOT a content root — preview component library MDX can import" },
+    { "path": "components/FrameworkTabs.tsx" },
+    { "path": "components/Callout.tsx" },
+    { "path": "extensions/", "note": "NOT a content root — local extension library (sandboxed widgets)" },
+    { "path": "extensions/doc-status/extension.json" },
+    { "path": "extensions/doc-status/index.html" }
+  ]
+}
+```
+
+स्थानीय फ़ाइल मोड में, सामग्री साइडबार `docs/`, `blog/`, और
+`resources/` पेड़ पृष्ठों के रूप में। `docs/getting-started.mdx` का चयन करने से वह खुल जाता है
+मानक सामग्री संपादक में फ़ाइल; UI में संपादन करने पर वापस लिखता है
+`docs/getting-started.mdx`.
+
+`components/` एक सामग्री रूट नहीं है. यह एक पूर्वावलोकन घटक लाइब्रेरी है जो MDX
+फ़ाइलें आयात या संदर्भित कर सकती हैं। संपादक सरल स्थानीय MDX घटकों को प्रस्तुत कर सकता है
+संपूर्ण सामग्री ऐप को क्लोन या फोर्क करने की आवश्यकता के बिना।
+
+`extensions/` भी एक कंटेंट रूट नहीं है। यह एक स्थानीय विस्तार पुस्तकालय है:
+छोटे सैंडबॉक्स वाले विजेट जो अपने स्रोत के रहते हुए ऐप स्लॉट में रेंडर कर सकते हैं
+रेपो.
+
+## सामग्री को एक रेपो में स्थापित करें
+
+मौजूदा डॉक्स, ब्लॉग, या MDX कार्यक्षेत्र के लिए, सामग्री स्थानीय-फ़ाइलें स्थापित करें
+कौशल:
+
+```bash
+npx @agent-native/core@latest skills add content --mode local-files --scope project
+```
+
+यह `content` कौशल को रेपो के एजेंट कौशल फ़ोल्डर में कॉपी करता है और लिखता है
+या सामग्री डिफ़ॉल्ट के साथ `agent-native.json` को अपडेट करता है:
+
+- कार्यस्थान स्तर पर `mode: "local-files"`
+- `apps.content.mode: "local-files"`
+- `docs/`, `blog/`, `content/`, और `resources/` के लिए सामग्री जड़ें
+- स्थानीय MDX घटकों के लिए `components/`
+- स्थानीय एक्सटेंशन विजेट के लिए `extensions/`
+
+स्थापित कौशल कोडिंग एजेंटों को सामग्री actions का उपयोग करने के लिए कहता है
+(`list-documents`, `get-document`, `edit-document`, `update-document`,
+`share-local-file-document`, और घटक-फ़ाइल actions) जब एक स्थानीय सामग्री ऐप
+या Agent Native डेस्कटॉप ब्रिज उन्हें उजागर करता है। यदि कोई पुल नहीं चल रहा है, तो कौशल
+फ्रंटमैटर, आयात, JSX को संरक्षित करते हुए सुरक्षित प्रत्यक्ष रेपो संपादन पर वापस आ जाता है
+और अज्ञात MDX.
+
+## कॉन्फ़िगरेशन
+
+`agent-native.json` को रेपो या वर्कस्पेस रूट में जोड़ें:
+
+```json
+{
+  "version": 1,
+  "apps": {
+    "content": {
+      "mode": "local-files",
+      "roots": [
+        {
+          "name": "Docs",
+          "path": "docs",
+          "kind": "docs",
+          "extensions": [".md", ".mdx"]
+        },
+        {
+          "name": "Blog",
+          "path": "blog",
+          "kind": "blog",
+          "extensions": [".md", ".mdx"]
+        },
+        {
+          "name": "Resources",
+          "path": "resources",
+          "kind": "resources",
+          "extensions": [".md", ".mdx"]
+        }
+      ],
+      "components": "components",
+      "extensions": "extensions",
+      "hide": ["**/_*.md", "**/_*.mdx"]
+    }
+  }
+}
+```
+
+आप `AGENT_NATIVE_MODE=local-files` या
+`AGENT_NATIVE_DATA_MODE=local-files`; मेनिफेस्ट को प्राथमिकता दी जाती है क्योंकि यह
+फ़ोल्डर अनुबंध को रेपो में ही दस्तावेज़ित करता है।
+
+## सामग्री फ़ाइल स्वरूप
+
+सामग्री Markdown और MDX पढ़ती है। फ्रंटमैटर पेज मेटाडेटा रखता है, और बॉडी
+संपादन योग्य दस्तावेज़:
+
+```mdx
+---
+title: "Getting Started"
+icon: "sparkles"
+isFavorite: true
+updatedAt: "2026-06-12T20:00:00.000Z"
+---
+
+# Getting Started
+
+Use <FrameworkTabs value="react" /> to show framework-specific code.
+```
+
+उपस्थित होने पर शीर्षक `title` फ्रंटमैटर से आता है, अन्यथा
+फ़ाइल नाम. संपादक MDX स्रोत को सुरक्षित रखता है जिसे वह अभी तक दृश्य रूप से संपादित नहीं कर सकता है, इसलिए
+कोडिंग एजेंट और सामान्य टेक्स्ट संपादक सुरक्षित बच निकलते हैं।
+
+## कस्टम MDX घटक
+
+सामग्री कॉन्फ़िगर किए गए `components` फ़ोल्डर से स्थानीय घटकों का पूर्वावलोकन कर सकती है।
+यह दस्तावेज़-शैली MDX घटकों जैसे टैब, कॉलआउट, पैकेज के लिए है
+स्निपेट, या फ़्रेमवर्क-विशिष्ट कोड ब्लॉक स्थापित करें।
+
+उदाहरण के लिए, अपनी सामग्री के आगे एक इंटरैक्टिव घटक जोड़ें:
+
+```tsx
+// components/ImpactCounter.tsx
+import { useState } from "react";
+
+export function ImpactCounter({
+  label = "points",
+  accent = "blue",
+  featured = false,
+}: {
+  label?: string;
+  accent?: "blue" | "green" | "purple";
+  featured?: boolean;
+}) {
+  const [count, setCount] = useState(3);
+  const accentClass =
+    accent === "green"
+      ? "border-green-300 bg-green-50"
+      : accent === "purple"
+        ? "border-purple-300 bg-purple-50"
+        : "border-blue-300 bg-blue-50";
+
+  return (
+    <div className={`rounded-md border p-4 ${accentClass}`}>
+      <div className="text-sm text-muted-foreground">Launch impact</div>
+      <div className="mt-1 text-3xl font-semibold">
+        {count} {label}
+      </div>
+      {featured ? <div className="mt-1 text-sm">Featured metric</div> : null}
+      <button
+        type="button"
+        className="mt-3 rounded border px-3 py-1 text-sm"
+        onClick={() => setCount((value) => value + 1)}
+      >
+        Add point
+      </button>
+    </div>
+  );
+}
+
+export const ImpactCounterInputs = {
+  label: {
+    type: "string",
+    label: "Metric label",
+    default: "points",
+  },
+  accent: {
+    type: "select",
+    label: "Accent",
+    options: ["blue", "green", "purple"],
+    default: "blue",
+  },
+  featured: {
+    type: "boolean",
+    label: "Featured",
+    default: false,
+  },
+};
+```
+
+फिर इसे किसी भी स्थानीय MDX फ़ाइल से उपयोग करें:
+
+```mdx
+---
+title: "Launch Notes"
+---
+
+# Launch Notes
+
+<ImpactCounter label="wins" />
+```
+
+कंटेंट डेव सर्वर पास्कलकेस नाम के एक्सपोर्ट और पास्कलकेस डिफ़ॉल्ट का पता लगाता है
+`components/` के अंतर्गत `.tsx`, `.jsx`, `.ts`, और `.js` फ़ाइलों से निर्यात। वे
+घटक संपादक के अंदर प्रस्तुत होते हैं और नीचे स्लैश मेनू में दिखाई देते हैं
+**स्थानीय घटक**. स्लैश प्रविष्टि एक न्यूनतम टैग बनाती है जैसे
+`<ImpactCounter />`; आवश्यकता पड़ने पर MDX स्रोत में प्रॉप्स जोड़ें।
+
+घटक निष्पादन जानबूझकर एक स्थानीय-डेव/डेस्कटॉप ब्रिज क्षमता है, नहीं
+सादा होस्ट किया गया ब्राउज़र फ़ोल्डर एक्सेस। यदि आप `content.agent-native.com` खोलते हैं,
+**स्थानीय फ़ाइलें** चुनें, और Chrome में एक फ़ोल्डर चुनें, ऐप पढ़ और लिख सकता है
+ब्राउज़र फ़ाइल सिस्टम एक्सेस API के माध्यम से `.md` और `.mdx` फ़ाइलें, लेकिन
+क्रोम Vite को संकलित करने के लिए एक पूर्ण फ़ोल्डर पथ को उजागर नहीं करता है
+`components/*.tsx`. कस्टम React घटकों का पूर्वावलोकन और हॉट रीलोड करने के लिए, चलाएँ
+स्थानीय रूप से सामग्री या Agent Native डेस्कटॉप का उपयोग करें ताकि विश्वसनीय स्थानीय ब्रिज का उपयोग किया जा सके
+चुने गए कार्यक्षेत्र को स्थानीय सामग्री विकास सर्वर के साथ पंजीकृत करें। उस मोड में,
+मौजूदा घटक फ़ाइलों में संपादन Vite के माध्यम से हॉट रीलोड, और जोड़ना
+घटक फ़ाइलों को हटाने से घटक रजिस्ट्री और स्लैश मेनू पुनः लोड होता है।
+
+एजेंट उन पंजीकृत घटक फ़ाइलों के साथ भी काम कर सकते हैं। उपयोग करें
+`list-local-component-files` पंजीकृत कार्यक्षेत्र आईडी खोजने के लिए, फिर
+`.tsx`, `.jsx`, `.ts`, या बनाने या अपडेट करने के लिए `write-local-component-file`
+कार्यस्थान के `components/` फ़ोल्डर के अंतर्गत `.js` फ़ाइलें। MDX फ़ाइलें
+घटक उपयोग के लिए सत्य का स्रोत; घटक फ़ाइलें सामान्य रेपो
+स्रोत फ़ाइलों की Git के साथ समीक्षा की गई।
+
+यदि कोई घटक इनपुट मेटाडेटा निर्यात करता है, तो संपादक में घटक का चयन करें
+घटक के ऊपरी-दाएँ कोने में एक संपादन बटन दिखाता है। समर्थित इनपुट प्रकार
+`string`, `textarea`, `number`, `boolean`, और `select` हैं। फॉर्म लिखता है
+वापस MDX टैग में बदल जाता है, इसलिए स्थानीय फ़ाइलें सत्य का स्रोत बनी रहती हैं। द
+मेटाडेटा को `ComponentNameInputs`, `ComponentNameConfig.inputs`, के रूप में निर्यात किया जा सकता है
+`Component.inputs`, या `agentNative.inputs`.
+
+शाब्दिक प्रॉप्स के साथ सरल घटक टैग इनलाइन पूर्वावलोकन कर सकते हैं:
+
+```mdx
+<FrameworkTabs value="react" />
+
+<Callout type="warning">This setting affects production deploys.</Callout>
+```
+
+जटिल JSX अभिव्यक्तियाँ स्रोत में संरक्षित हैं। यदि संपादक सुरक्षित रूप से
+अभी तक एक घटक प्रोप का पूर्वावलोकन करें, यह इसके बजाय एक चेतावनी प्लेसहोल्डर दिखाता है
+चुपचाप डेटा छोड़ रहा है।
+
+## स्थानीय फ़ाइलें साझा करना
+
+स्थानीय फ़ाइलें सीधे साझा नहीं की जाती हैं क्योंकि अन्य उपयोगकर्ता पथ नहीं पढ़ सकते हैं
+आपकी मशीन। सामग्री टूलबार का शेयर बटन एक
+चयनित फ़ाइल की डेटाबेस-समर्थित प्रतिलिपि, उस प्रतिलिपि पर नेविगेट करती है, और खोलती है
+सामान्य शेयर पॉपओवर। मूल स्थानीय फ़ाइल स्थानीय फ़ाइलों के अंतर्गत रहती है; द
+डेटाबेस कॉपी स्थानीय फ़ाइल मोड में साझा प्रतियों के अंतर्गत दिखाई देती है और
+मानक दस्तावेज़ साझाकरण मॉडल।
+
+## स्थानीय एक्सटेंशन
+
+स्थानीय फ़ाइल मोड कॉन्फ़िगर किए गए से रेपो-समर्थित एक्सटेंशन भी लोड कर सकता है
+`extensions` फ़ोल्डर. प्रत्येक एक्सटेंशन एक `extension.json`
+मैनिफ़ेस्ट और एक HTML प्रविष्टि फ़ाइल:
+
+```text
+extensions/
+  doc-status/
+    extension.json
+    index.html
+```
+
+```json
+{
+  "id": "doc-status",
+  "name": "Doc Status",
+  "description": "Shows metadata for the selected Content file.",
+  "entry": "index.html",
+  "slots": ["content.sidebar.bottom"],
+  "permissions": {
+    "appActions": ["list-documents"],
+    "extensionData": true
+  }
+}
+```
+
+`index.html` वही अल्पाइन/Tailwind एक्सटेंशन बॉडी फॉर्मेट है जिसका उपयोग सामान्य लोग करते हैं
+डेटाबेस-समर्थित एक्सटेंशन। जब कंटेंट ऐप एक स्थानीय एक्सटेंशन देखता है तो
+`content.sidebar.bottom` घोषित करता है, यह उस एक्सटेंशन को नीचे प्रस्तुत करता है
+the Content sidebar. The host passes `window.slotContext` with the selected
+दस्तावेज़ आईडी, शीर्षक, स्रोत मेटाडेटा, और क्या सामग्री स्थानीय फ़ाइल मोड में है।
+
+स्थानीय एक्सटेंशन का पूर्वावलोकन ऐप द्वारा किया जाता है लेकिन फ़ाइलों के रूप में संपादित किया जाता है। एक्सटेंशन
+सूची उन्हें स्थानीय फ़ाइल बैज के साथ दिखाती है, और पूर्ण-पृष्ठ व्यूअर वापस इंगित करता है
+प्रविष्टि फ़ाइल. SQL-समर्थित एक्सटेंशन actions जैसे अपडेट, डिलीट, शेयर और
+इतिहास लागू नहीं होता; इसके लिए अपने संपादक, Codex, Claude कोड, या Git इतिहास का उपयोग करें
+स्रोत परिवर्तन।
+
+v1 के लिए, स्थानीय एक्सटेंशन जानबूझकर रूढ़िवादी हैं:
+
+- वे अपनी छोटी रनटाइम स्थिति के लिए `extensionData` का उपयोग कर सकते हैं
+- वे केवल `extension.json` में सूचीबद्ध `appAction`s को कॉल कर सकते हैं
+- कच्चे SQL सहायक और बाहरी `extensionFetch` अक्षम हैं
+- स्लॉट लक्ष्य `extension.json` में घोषित किए गए हैं, SQL के माध्यम से स्थापित नहीं किए गए हैं
+
+यह स्थानीय कार्यस्थानों को बिना किसी अनुमति के ओब्सीडियन जैसी प्लगइन सतह देता है
+मनमाना रेपो फ़ाइल डेटाबेस-समर्थित एक्सटेंशन की प्रत्येक क्षमता को प्राप्त करती है।
+
+## ऐप्स इसका उपयोग कैसे करते हैं
+
+स्थानीय फ़ाइल मोड को फ़्रेमवर्क के स्थानीय आर्टिफैक्ट सहायकों के माध्यम से कार्यान्वित किया जाता है।
+एक ऐप अपने स्वामित्व वाले आर्टिफैक्ट प्रकारों के लिए रूट घोषित करता है, फिर पढ़ता और लिखता है
+उसी क्रिया के माध्यम से इसकी सतह UI और एजेंट पहले से ही उपयोग करते हैं।
+
+सामग्री के लिए, इसका अर्थ है:
+
+- `list-documents` सूचीबद्ध `.md` और `.mdx` फ़ाइलें।
+- `get-document` एक चयनित स्थानीय फ़ाइल को पढ़ता है।
+- `update-document` चयनित स्थानीय फ़ाइल लिखता है।
+- `create-document` चयनित फ़ोल्डर में एक नई स्थानीय `.mdx` फ़ाइल बनाता है।
+- `delete-document` स्थानीय फ़ाइल को हटा देता है।
+- खोज कॉन्फ़िगर की गई स्थानीय फ़ाइलों पर चलती है।
+
+सामग्री UI से स्थानीय-फ़ाइल पृष्ठों को स्थानांतरित करना, नाम बदलना और पुन: व्यवस्थित करना
+अभी तक समर्थित है। उन कार्यों को कार्यक्षेत्र में या कोडिंग एजेंट के साथ करें; द
+सामग्री साइडबार परिणामी फ़ाइल ट्री को प्रतिबिंबित करेगा।
+
+यह एजेंट अनुबंध को सरल रखता है: एजेंट सामग्री actions का उपयोग जारी रख सकता है,
+और वे actions तय करते हैं कि लक्ष्य SQL-समर्थित है या फ़ाइल-समर्थित है।
+
+अन्य ऐप्स समय के साथ समान पैटर्न अपना सकते हैं। एक स्लाइड ऐप मैप कर सकता है
+`slides/*.mdx` को डेक पर, एक प्लान ऐप दस्तावेजों को प्लान करने के लिए `plans/*` को मैप कर सकता है, और एक
+डैशबोर्ड ऐप `dashboards/*.mdx` को डैशबोर्ड पर मैप कर सकता है। वे ऐप-विशिष्ट
+फ़ोल्डर समान स्थानीय आर्टिफैक्ट अनुबंध के शीर्ष पर स्तरित कन्वेंशन हैं।
+
+## स्थानीय फ़ाइलें बनाम निर्यात/आयात
+
+सामग्री में दो भिन्न फ़ाइल वर्कफ़्लो हैं:
+
+| वर्कफ़्लो                   | क्या होता है                                                                                                                    |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `/local-files` निर्यात/आयात | डेटाबेस मोड सत्य का स्रोत बना हुआ है। फ़ाइलें एक स्पष्ट सिंक सतह हैं जिन्हें आप निर्यात, संपादित, पूर्वावलोकन और आयात करते हैं। |
+| स्थानीय फ़ाइल मोड           | फ़ाइलें सत्य का स्रोत हैं। सामग्री साइडबार और संपादक सीधे स्थानीय फ़ाइलों पर काम करते हैं।                                      |
+
+जब आप होस्ट किए गए कार्यक्षेत्र के आसपास कभी-कभी फ़ाइल समीक्षा चाहते हैं तो निर्यात/आयात का उपयोग करें।
+स्थानीय फ़ाइल मोड का उपयोग करें जब रेपो स्वयं कार्यक्षेत्र हो।
+
+## इतिहास और सहयोग
+
+स्थानीय फ़ाइल मोड फ़ाइल-मूल इतिहास पर निर्भर करता है:
+
+- Git में महत्वपूर्ण परिवर्तन करें
+- समीक्षा के लिए पुल अनुरोधों का उपयोग करें
+- कोडिंग एजेंटों को उन्हीं फ़ाइलों को सीधे संपादित करने दें
+- परिवर्तनों को समझने के लिए सामान्य फ़ाइल अंतर का उपयोग करें
+
+डेटाबेस मोड होस्ट की गई सहयोग सुविधाओं जैसे
+साझाकरण, टिप्पणियाँ, SQL-समर्थित संस्करण इतिहास, और लाइव बहु-उपयोगकर्ता संपादन।
+
+प्रदाता सिंक को किसी भी मोड के शीर्ष पर स्तरित किया जा सकता है। उदाहरण के लिए, एक डॉक्स रेपो
+actions जोड़ें जो CMS से सामग्री को स्थानीय MDX फ़ाइलों में खींचता है या चयनित पुश करता है
+स्थानीय फ़ाइलें उस CMS पर वापस आती हैं।
+
+## उत्पादन सुरक्षा
+
+स्थानीय फ़ाइल मोड ऐप actions को कॉन्फ़िगर किए गए कार्यक्षेत्र तक सीधी लेखन पहुंच प्रदान करता है
+फ़ाइलें। यह स्थानीय विकास और विश्वसनीय एकल-किरायेदार फ़ाइल
+पुल, लेकिन यह डिफ़ॉल्ट उत्पादन सुरक्षा मॉडल नहीं है।
+
+जब `NODE_ENV=production`, फ्रेमवर्क `local-files` मोड को अस्वीकार कर देता है जब तक कि आप
+सेट:
+
+```bash
+AGENT_NATIVE_ALLOW_LOCAL_FILES_IN_PRODUCTION=true
+```
+
+इसे केवल विश्वसनीय एकल-किरायेदार परिनियोजन के लिए सेट करें जहां हर कोई इसका उपयोग कर सके
+ऐप को कॉन्फ़िगर की गई फ़ाइलों को पढ़ने और लिखने की अनुमति है। सामान्य होस्ट के लिए,
+बहु-उपयोगकर्ता ऐप्स, डेटाबेस मोड और SQL-समर्थित साझाकरण का उपयोग करें।