@agent-native/core 0.102.2 → 0.103.0

package/corpus/core/docs/content/locales/ar-SA/local-file-mode.mdx

@@ -1,523 +1,68 @@
 ---
-title: "وضع الملف المحلي"
-description: "قم بتشغيل تطبيقات الوكيل الأصلية باستخدام ملفات Markdown وMDX المحلية وملفات الريبو الأخرى كمصدر للحقيقة - بما في ذلك مستندات MDX ذات النمط Obsidian مع المكونات المخصصة."
+title: "مصادر المجلدات المحلية"
+description: "اربط مجلدات Markdown وMDX بمساحات Content المدعومة بقاعدة البيانات."
 ---
 
-# وضع الملف المحلي
+# مصادر المجلدات المحلية
 
-يتيح وضع الملف المحلي لتطبيق الوكيل الأصلي إرفاق UI العادي وسطح الإجراء
-مباشرة إلى الملفات الموجودة في الريبو أو مساحة العمل. لا يزال التطبيق يبدو وكأنه التطبيق المستضاف
-المنتج، لكن طرق عرض القائمة والمحرر وأدوات الوكيل الخاصة به تقرأ وتكتب الملفات المحلية
-بدلاً من سجلات التطبيقات المدعومة بـ SQL.
+يستخدم Content الآن نموذج بيانات واحدًا: تُحفظ كل صفحة في SQL، وتنتمي إلى
+**مساحة**، وتكون عنصرًا في قاعدة النظام **Files** لتلك المساحة. المجلد المحلي
+مصدر متصل بـ Files، وليس وضعًا آخر للتطبيق. لم يعد هناك مفتاح
+`AGENT_NATIVE_MODE`.
 
-التنفيذ الأول موجود في قالب المحتوى: الشريط الجانبي الأيسر هو
-يتم ملؤها من ملفات `.md` و`.mdx` المحلية، ويؤدي تحديد صفحة إلى فتح المعيار
-محرر المحتوى، ويحفظ الحفظ ويكتب مرة أخرى إلى الملف المحدد. نفس الملفات يمكن
-يتم تحريره أيضًا بواسطة Codex أو Claude أو وكيل الشريط الجانبي Agent-Native أو وكيل عادي
-محرر.
+لكل مستخدم مساحة شخصية، ولكل مؤسسة متاحة مساحة مؤسسة، ويحدد كتالوج
+**Workspaces** الشخصي المساحات التي تظهر. Files قاعدة Content عادية؛ يمكن
+لخصائصها وعوامل التصفية والترتيب والتجميع وطرق العرض المحفوظة أن تعرض الشريط
+الجانبي أيضًا.
 
-بالنسبة للمحتوى، هذا يجعل المنتج يبدو وكأنه سبج مفتوح المصدر لـ MDX:
-تظهر مستنداتك كملفات، بينما يضيف التطبيق محررًا مرئيًا، الوكيل actions،
-نسخ قابلة للمشاركة، ومكونات MDX تفاعلية غنية.
+## ربط مجلد
 
-استخدم وضع الملف المحلي عندما تريد سير عمل الريبو الأول:
+اختر مجلدًا عبر المتصفح أو Agent Native Desktop، ثم اربطه بمساحة موجودة أو
+أنشئ له مساحة خاصة. لا يخزن SQL سوى معرف الاتصال المعتم، والمسارات النسبية،
+والبصمات، وبيانات المصدر الوصفية؛ ولا يخزن المسار المطلق أو مقبض المتصفح أو نص
+الملف الخام.
 
-- مستودع المستندات باستخدام `docs/*.mdx`
-- مدونة تحتوي على `blog/*.mdx`
-- موارد مثل تحديد المواقع أو المراسلة أو ملاحظات الفريق في `resources/*.md`
-- قاعدة معرفية شخصية على طراز Obsidian مع محرر MDX الأكثر ثراءً
-- المستندات التي تحتاج إلى كتل MDX تفاعلية مخصصة تم إنشاؤها من كود React المحلي
-- عناصر التطبيق التي ينبغي أن يسهل على وكلاء البرمجة فحصها وتصحيحها
+السياسات هي `database_primary` و`source_primary` و`reviewed_bidirectional`.
+تحول المزامنة الملفات إلى صفحات SQL عادية. إذا تغير الملف وصفحته معًا، يُنشئ
+Content تغييرًا للمراجعة بدل الكتابة فوق أحدهما. يحافظ قطع الاتصال على الصفحات
+والملفات المحلية.
 
-استخدم وضع قاعدة البيانات عندما تريد تجربة التطبيق التعاوني المستضاف:
-مشاركة متعددة المستخدمين، والأذونات المدعومة SQL، والتعليقات، وسجل الإصدارات، و
-استضافة الإنتاج دون الوصول إلى نظام الملفات المحلي.
-
-## النموذج العقلي
-
-هناك وضعان لمصدر الحقيقة:
-
-| الوضع              | مصدر الحقيقة                                    | الأفضل لـ                                                                          |
-| ------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------- |
-| وضع قاعدة البيانات | صفوف SQL حتى Drizzle                            | التطبيقات المستضافة والتعاون والمشاركة والتعليقات وسجل الإصدارات                   |
-| وضع الملف المحلي   | ملفات الريبو المعلنة بواسطة `agent-native.json` | سير العمل المحلي/المطور، ومراجعة Git، وتعديلات وكيل الترميز، والمحتوى الأصلي للملف |
-
-يجب أن يظل UI والوكيل actions بنفس الشكل في كلا الوضعين. المحتوى
-لا يزال المحرر يقوم بتحرير المستندات؛ والفرق هو ما إذا كانت هذه المستندات قد تم حلها
-إلى صفوف SQL أو الملفات المحلية.
-
-<Diagram id="doc-block-1wre3w3" title={"نفس الأفعال، مصدران للحقيقة"} summary={"تستدعي واجهة المستخدم والوكيل إجراءات متطابقة في كلا الوضعين. تقرر طبقة الإجراء ما إذا كان كل استدعاء سيحل إلى صفوف SQL أو ملفات الريبو."}>
-
-```html
-<div class="diagram-mode">
-  <div class="diagram-col entry">
-    <div class="diagram-node">واجهة المحتوى</div>
-    <div class="diagram-node">
-      الوكيل + الإجراءات<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">وضع قاعدة البيانات</span
-      ><small class="diagram-muted">SQL rows via Drizzle</small
-      ><small class="diagram-muted">مستضاف · مشاركة · تعليقات · سجل</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 · تعديلات وكيل الترميز</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;
-}
-```
-
-</Diagram>
-
-## مثال الريبو
-
-يمكن أن تكون مساحة عمل المحتوى صغيرة مثل هذا:
-
-<FileTree
-  id="doc-block-4tvbz2"
-  title={"repo لـ Content workspace"}
-  entries={[
-    {
-      path: "agent-native.json",
-      note: "يعلن أي folders هي content roots وأنواعها",
-    },
-    {
-      path: "docs/",
-      note: "content root: يظهر في الشريط الجانبي كصفحات",
-    },
-    {
-      path: "docs/getting-started.mdx",
-    },
-    {
-      path: "docs/guides/custom-components.mdx",
-    },
-    {
-      path: "blog/",
-      note: "جذر محتوى",
-    },
-    {
-      path: "blog/launch-post.mdx",
-    },
-    {
-      path: "resources/",
-      note: "جذر محتوى",
-    },
-    {
-      path: "resources/messaging/positioning.md",
-    },
-    {
-      path: "components/",
-      note: "ليس content root: مكتبة مكونات preview يمكن لـ MDX استيرادها",
-    },
-    {
-      path: "components/FrameworkTabs.tsx",
-    },
-    {
-      path: "components/Callout.tsx",
-    },
-    {
-      path: "extensions/",
-      note: "ليس content root: مكتبة extensions محلية (widgets داخل sandbox)",
-    },
-    {
-      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
+npx @agent-native/core@latest content .
 ```
 
-يؤدي هذا إلى نسخ مهارة `content` إلى مجلدات مهارات وكيل الريبو والكتابة
-أو يقوم بتحديث `agent-native.json` باستخدام الإعدادات الافتراضية للمحتوى:
-
-- `mode: "local-files"` على مستوى مساحة العمل
-- `apps.content.mode: "local-files"`
-- جذور المحتوى لـ `docs/` و`blog/` و`content/` و`resources/`
-- `components/` لمكونات MDX المحلية
-- `extensions/` لعناصر واجهة المستخدم المحلية
-
-تخبر المهارة المثبتة وكلاء البرمجة باستخدام المحتوى actions
-(`list-documents`, `get-document`, `edit-document`, `update-document`,
-`share-local-file-document`، وملف المكون actions) عند تطبيق محتوى محلي
-أو جسر سطح المكتب Agent Native يعرضهم. إذا لم يتم تشغيل أي جسر، فستتم المهارة
-يعود إلى تعديلات الريبو المباشرة الآمنة مع الحفاظ على المادة الأمامية، والواردات، JSX،
-وMDX غير معروف.
-
-## التكوين
+يشغل الأمر تطبيق Content العادي المدعوم بقاعدة البيانات، ويسجل المجلد كمصدر،
+ويفتح شاشة الاتصال. ولا يضبط متغير بيئة خاصًا بالوضع.
 
-أضف `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"]
+          "extensions": [".md", ".mdx"],
+          "source": {
+            "type": "local-folder",
+            "connectionId": "local-folder:<opaque-id>",
+            "truthPolicy": "source_primary"
+          }
         }
       ],
       "components": "components",
-      "extensions": "extensions",
-      "hide": ["**/_*.md", "**/_*.mdx"]
+      "extensions": "extensions"
     }
   }
 }
 ```
 
-يمكنك أيضًا تمكين الملفات المحلية باستخدام `AGENT_NATIVE_MODE=local-files` أو
-`AGENT_NATIVE_DATA_MODE=local-files`; the manifest is preferred because it
-يوثق عقد المجلد في الريبو نفسه.
-
-## تنسيق ملف المحتوى
-
-يقرأ المحتوى Markdown وMDX. يحتفظ Frontmatter بالبيانات التعريفية للصفحة، والنص الأساسي هو
-المستند القابل للتحرير:
-
-```mdx
----
-title: "البدء"
-icon: "sparkles"
-isFavorite: true
-updatedAt: "2026-06-12T20:00:00.000Z"
----
-
-# البدء
-
-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: "إطلاق الملاحظات"
----
-
-# إطلاق الملاحظات
-
-<ImpactCounter label="wins" />
-```
-
-يكتشف خادم تطوير المحتوى PascalCase المسمى الصادرات وPascalCase الافتراضي
-يتم التصدير من ملفات `.tsx` و`.jsx` و`.ts` و`.js` ضمن `components/`. تلك
-يتم عرض المكونات داخل المحرر وتظهر في قائمة الشرطة المائلة ضمن
-**المكونات المحلية**. يؤدي إدراج شرطة مائلة إلى إنشاء علامة صغيرة مثل
-`<ImpactCounter />`؛ أضف الدعائم في مصدر MDX عند الحاجة.
-
-تنفيذ المكون هو عن قصد إمكانية جسر محلي/سطح المكتب، وليس
-الوصول العادي إلى مجلد المتصفح المستضاف. إذا قمت بفتح `content.agent-native.com`،
-اختر **الملفات المحلية**، واختر مجلدًا في Chrome، حيث يمكن للتطبيق القراءة والكتابة
-الملفات `.md` و`.mdx` من خلال الوصول إلى نظام الملفات في المتصفح API، ولكن
-لا يعرض Chrome مسارًا مطلقًا للمجلد لتجميعه Vite
-`components/*.tsx`. لمعاينة مكونات React المخصصة وإعادة تحميلها بسرعة، قم بتشغيل
-المحتوى محليًا أو استخدم Agent Native Desktop حتى يتمكن الجسر المحلي الموثوق به من
-قم بتسجيل مساحة العمل المختارة باستخدام خادم تطوير المحتوى المحلي. في هذا الوضع،
-عمليات التحرير على ملفات المكونات الموجودة، إعادة التحميل السريع من خلال Vite، وإضافة أو
-تؤدي إزالة ملفات المكونات إلى إعادة تحميل سجل المكونات وقائمة الشرطة المائلة.
-
-يمكن للوكلاء أيضًا العمل مع ملفات المكونات المسجلة. استخدم
-`list-local-component-files` للعثور على معرف مساحة العمل المسجلة، ثم
-`write-local-component-file` لإنشاء أو تحديث `.tsx` أو `.jsx` أو `.ts` أو
-ملفات `.js` ضمن المجلد `components/` الخاص بمساحة العمل. تظل ملفات MDX هي
-مصدر الحقيقة لاستخدام المكونات؛ تظل ملفات المكونات مستودعًا عاديًا
-تمت مراجعة الملفات المصدر باستخدام Git.
-
-إذا قام أحد المكونات بتصدير بيانات التعريف المدخلة، فحدد المكون في المحرر
-يُظهر زر التحرير في الزاوية العلوية اليمنى للمكون. أنواع الإدخال المدعومة
-هي `string`، و`textarea`، و`number`، و`boolean`، و`select`. يكتب النموذج
-مرة أخرى إلى علامة MDX، بحيث تظل الملفات المحلية هي مصدر الحقيقة. ال
-يمكن تصدير البيانات الوصفية بتنسيق `ComponentNameInputs`، `ComponentNameConfig.inputs`،
-`Component.inputs`، أو `agentNative.inputs`.
-
-يمكن معاينة علامات المكونات البسيطة ذات الدعائم الحرفية في السطر:
-
-```mdx
-<FrameworkTabs value="react" />
-
-<Callout tone="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` هو نفس تنسيق هيكل امتداد Alpine/Tailwind المستخدم في المعتاد
-الامتدادات المدعومة بقاعدة البيانات. عندما يرى تطبيق المحتوى امتدادًا محليًا
-يُعلن عن `content.sidebar.bottom`، ويعرض هذا الامتداد في الجزء السفلي من
-الشريط الجانبي للمحتوى. يمرر المضيف `window.slotContext` مع
-معرف المستند، والعنوان، وبيانات تعريف المصدر، وما إذا كان المحتوى في وضع الملف المحلي.
-
-يقوم التطبيق بمعاينة الإضافات المحلية ولكن يتم تحريرها كملفات. الامتدادات
-هذه الملفات بشارة ملف محلي، ويشير عارض الصفحة الكاملة إلى
-ملف الإدخال. الامتداد المدعوم SQL actions مثل التحديث والحذف والمشاركة و
-لا ينطبق التاريخ؛ استخدم المحرر الخاص بك، Codex، رمز Claude، أو سجل Git لـ
-تغييرات المصدر.
-
-بالنسبة للإصدار 1، تكون الامتدادات المحلية متحفظة عمدًا:
-
-- يمكنهم استخدام `extensionData` لحالة وقت التشغيل الصغيرة الخاصة بهم
-- يمكنهم الاتصال فقط بـ `appAction` المدرجة في `extension.json`
-- تم تعطيل مساعدات SQL الأولية و`extensionFetch` الخارجية
-- تم الإعلان عن أهداف الفتحات في `extension.json`، ولم يتم تثبيتها من خلال SQL
-
-يمنح هذا مساحات العمل المحلية سطحًا إضافيًا شبيهًا بسطح Obsidian دون السماح
-يرث ملف الريبو التعسفي كل إمكانات الامتداد المدعوم بقاعدة البيانات.
-
-## كيفية استخدام التطبيقات لها
-
-يتم تنفيذ وضع الملف المحلي من خلال أدوات المساعدة المحلية لإطار العمل.
-يعلن التطبيق عن جذور أنواع العناصر التي يمتلكها، ثم يقرأها ويكتبها
-من خلال نفس سطح الإجراء الذي يستخدمه 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.
+للترحيل، احذف `mode: "local-files"` و`AGENT_NATIVE_MODE=local-files`، واحتفظ
+بالجذور، وأضف `source`. تحافظ معرفات frontmatter على هوية الصفحة عند إعادة
+التسمية أو النقل. وتستمر المكونات والامتدادات المحلية عبر الجسر المحلي الموثوق.

package/corpus/core/docs/content/locales/ar-SA/template-content.mdx

@@ -93,9 +93,8 @@ description: "Obsidian مفتوح المصدر لـ MDX: قم بتحرير مل
 - **تنظيم الصفحات في شجرة** — تداخل بشكل لا نهائي، اسحب لإعادة ترتيب الصفحات المفضلة التي تستخدمها كثيرًا.
 - **البحث في كل شيء** من خلال البحث في النص الكامل عبر العناوين والمحتوى.
 - **تحرير ملفات Markdown/MDX المحلية مثل Obsidian.** استخدم طريقة العرض `/local-files`
-  لتصدير مساحة العمل الخاصة بك إلى الملفات، قم بتحريرها باستخدام أدواتك الخاصة، ثم قم بالمعاينة
-  التغييرات، ثم قم باستيرادها مرة أخرى. في وضع الملف المحلي، تتم كتابة المحتوى مباشرة إلى
-  الملف `.md` أو `.mdx` المحدد.
+  لربط مجلد بـ Files وتحريره بأدواتك ومزامنة التغييرات ومراجعة التعارضات
+  داخل تطبيق SQL.
 - **إنشاء كتل مخصصة تفاعلية غنية.** تسجيل مكونات React المحلية،
   أدخلها كـ MDX، واسمح للوكيل بإنشاء أو تحديث ملفات المكونات لـ
   مستنداتك.
@@ -138,32 +137,19 @@ description: "Obsidian مفتوح المصدر لـ MDX: قم بتحرير مل
 التعليقات والأذونات والتعاون المباشر؛ المجلد المحلي صريح
 سطح المزامنة.
 
-يمكن أيضًا تشغيل المحتوى في **وضع الملف المحلي**، حيث تكون الملفات هي مصدر
-الحقيقة بدلاً من مستندات SQL. أضف `agent-native.json` إلى الريبو، اضبط
-`mode: "local-files"`، وقم بتكوين الجذور مثل `docs/`، `blog/`،
-`content/` و`resources/`. يقوم محرر المحتوى القياسي بعد ذلك بملء
-الشريط الجانبي الأيسر من ملفات `.md`/`.mdx` المحلية ويكتب التعديلات مرة أخرى إلى
-الملف المحدد من خلال المستند العادي actions. استخدم هذا لمستندات الريبو الأولى،
-المدونات أو مكتبات الموارد أو المحتوى الشخصي بنمط Obsidian الذي يعمل بنظام MDX
-المكونات؛ قم بالتبديل مرة أخرى إلى وضع قاعدة البيانات عندما تريد التعاون المستضاف و
-المشاركة المدعومة بـ SQL. راجع [Local File Mode](/docs/local-file-mode) لمعرفة
-تخطيط الريبو المستقل، التكوين، مكونات MDX المخصصة، المحلية
-أدوات `extensions/` ودليل سلامة الإنتاج.
+تستخدم المجلدات المحلية الآن نموذج SQL نفسه الذي تستخدمه كل الصفحات. تنتمي كل
+صفحة إلى مساحة وقاعدة Files الخاصة بها؛ والمجلد هو محول مصدر لهذه القاعدة. راجع
+[مصادر المجلدات المحلية](/docs/local-file-mode) للسياسات والتعارضات ومكونات MDX
+والترحيل من الوضع القديم.
 
-لتثبيت مهارة ملفات المحتوى المحلية في الريبو الحالي:
+لفتح Content في مستودع موجود:
 
 ```bash
-npx @agent-native/core@latest skills add content --mode local-files --scope project
+npx @agent-native/core@latest content .
 ```
 
-يقوم المثبت بنسخ مهارة `content` لوكيل الترميز الخاص بك ويقوم بكتابة أو
-تحديثات `agent-native.json` بجذور المحتوى لـ `docs/`، و`blog/`، و`content/`،
-و `resources/`. عندما يكون تطبيق المحتوى المحلي، أو Agent Native Desktop، أو موثوقًا به
-الجسر المحلي قيد التشغيل، ويجب على الوكلاء استخدام المحتوى actions مثل
-`list-documents`، و`get-document`، و`edit-document`، و`update-document`، و
-يكتب `share-local-file-document` بدلاً من نظام الملفات الخام. بدون ذلك المحلي
-الجسر، لا تزال المهارة المثبتة تمنح الوكيل عقد تحرير الريبو لـ
-تعديلات Markdown/MDX الآمنة.
+يشغل CLI تطبيق Content العادي المدعوم بقاعدة البيانات، ويسجل مصدر المجلد، ويفتح
+الاتصال من دون ضبط متغير بيئة خاص بالوضع.
 
 ## للمطورين