يستطيع Notiamo تشغيل وكيل ذكاء اصطناعي على التعليقات والمهام المفتوحة في مشروع. يجري الوكيل التغييرات، ويوافق عليها شخص من فريقك. قد يعمل التشغيل على خوادم Notiamo أو على حاسوب تملكه. هذه الصفحة عن الطريقة الثانية: المشغّل، وهو برنامج صغير تثبّته على جهازك. وهو موجّه لفريق الوكالة.
ما هو المشغّل
ينتظر المشغّل تشغيلات الوكيل التي تضعها مؤسستك في الطابور داخل Notiamo. وفي كل تشغيل يستنسخ المستودع (أو يتصل بموقع WordPress)، ويبدأ Claude Code بتعليمات ذلك التشغيل، ويرسل إلى Notiamo ما يفعله الوكيل، ويبلّغ عند الانتهاء.
- لا يحمل أي بيانات اعتماد لـ Claude. يشغّل برنامج
claudeالموجود أصلًا على الجهاز. وتستخدم جلسات المشغّل مجلد إعدادات خاصًا بها، فتبقى منفصلة عن جلساتك. أما تسجيل الدخول نفسه فيخص Claude Code ويحتفظ به Claude Code. - ليس تسجيل دخول إلى Claude داخل Notiamo. لا يرى Notiamo حسابك في Claude ولا يستخدمه أبدًا. المشغّل يشغّل Claude Code الخاص بك فقط، على جهازك، لعملك أنت.
ثبّته
تحتاج إلى:
- Node.js 22 أو أحدث؛
- Claude Code الإصدار 2.1.314 أو أحدث؛
- git 2.31 أو أحدث؛
- على Linux وWSL2:
bubblewrapوsocat(على Debian أو Ubuntu:sudo apt install bubblewrap socat). على macOS لا حاجة إلى تثبيت شيء آخر.
ثم:
- في Notiamo، افتح الإعدادات › تشغيلات الوكيل. في بطاقة المشغّلات، اضغط مشغّل جديد وأعطه اسمًا. انسخ الرمز. يظهر مرة واحدة فقط.
- على الجهاز، نفّذ:
npx @notiamo/runner init
- الصق الرمز. يتحقق
initمن أن Claude Code يعمل، ويشغّل تسجيل دخول Claude Code الخاص بالمشغّل، ثم يثبّت الخدمة ويبدأها. - في المشروع، اضبط أين يعمل الوكيل على جهازك الخاص.
عندما ينتهي init يكون المشغّل قد بدأ العمل. ويبدأ من جديد تلقائيًا بعد تسجيل الدخول أو إعادة التشغيل.
الأوامر
| الأمر | ما يفعله |
|---|---|
npx @notiamo/runner init |
يُعدّ المشغّل: الرمز، وتسجيل دخول Claude Code، وتثبيت الخدمة وبدؤها. |
npx @notiamo/runner@latest update |
ينقل المشغّل إلى أحدث إصدار. يبقى الرمز والاسم وتسجيل الدخول. |
npx @notiamo/runner status |
يبيّن هل الخدمة مثبّتة وتعمل، ويعرض آخر سطر في السجل. |
npx @notiamo/runner logs |
يعرض آخر 50 سطرًا من السجل. |
npx @notiamo/runner stop |
يوقف الخدمة حتى تسجيل الدخول أو الإقلاع التالي. |
npx @notiamo/runner uninstall |
يزيل الخدمة. ويبقى مجلد المشغّل. |
npx @notiamo/runner env <projectId> |
ينشئ أو يعرض ملف env الذي يعطيه هذا الجهاز لتشغيلات مشروع واحد. |
npx @notiamo/runner start |
يعمل في المقدمة. الخدمة هي التي تشغّل هذا الأمر؛ ونادرًا ما تحتاج إليه. |
الخدمة هي وكيل launchd باسم com.notiamo.runner على macOS، ومهمة مجدولة (Scheduled Task) باسم “Notiamo runner” على Windows، ووحدة مستخدم systemd باسم notiamo-runner على Linux.
مشغّلان على جهاز واحد
الأمر npx @notiamo/runner init --profile staging يُعدّ مشغّلًا ثانيًا منفصلًا. له مجلده الخاص (~/.notiamo-runner/profiles/staging) وخدمته الخاصة. أضف --profile staging إلى كل أمر لهذا المشغّل. يتكوّن اسم الملف الشخصي من حروف وأرقام وشرطات، بطول من 1 إلى 32 محرفًا.
ما يستطيع الوكيل لمسه وما لا يستطيع
يحصل كل تشغيل على ملف إعدادات Claude Code خاص به. وثلاثة أمور تبقي الوكيل في حدوده.
أدوات الملفات تبقى داخل مجلد التشغيل. أدوات Claude الخاصة بالملفات (القراءة والتعديل والكتابة والبحث) ترفض أي شيء خارج مجلد التشغيل. وأي استدعاء يطلب إذنًا يُرفض، لأنه لا أحد هناك ليجيب.
أوامر الصدفة تعمل في صندوق عزل نظام التشغيل. على macOS (Seatbelt) وعلى Linux أو WSL2 (bubblewrap وsocat)، يُحصَر كل أمر ينفّذه الوكيل في الصدفة. وإذا تعذّر بدء صندوق العزل، لا يبدأ التشغيل.
لا تصل أي بيانات اعتماد من الجهاز إلى الوكيل. يحصل Claude Code على قائمة قصيرة فقط من متغيرات البيئة (PATH وHOME وUSER وLOGNAME وSHELL وLANG وLC_ALL وLC_CTYPE وTERM وTMPDIR وTZ وXDG_* وإعدادات الوكيل الوسيط والشهادات) إضافةً إلى متغيرات التشغيل نفسه. ولا يحصل أبدًا على SSH_AUTH_SOCK أو GH_TOKEN أو GITHUB_TOKEN أو NPM_TOKEN أو AWS_* أو ANTHROPIC_*. ولا يرى git الخاص بالوكيل أي إعدادات git عامة أو خاصة بالنظام.
ما يسمح به صندوق عزل الصدفة وما يمنعه:
- القراءة الممنوعة: مجلدات المشاريع الأخرى (بما فيها التشغيلات الأخرى في الوقت نفسه)، وملفات المشغّل نفسه، وملفات ومجلدات بيانات الاعتماد لديك (مفاتيح SSH، وتسجيلات الدخول إلى السحابة، وتسجيلات الدخول إلى سجلات الحزم، وبيانات اعتماد git).
- الكتابة المسموحة: فقط في مجلد التشغيل وفي مجلد ذاكرة الحزم الخاص بالمشروع المجاور له. أما
.git/hooksو.git/configالخاصان بالتشغيل فللقراءة فقط. - الشبكة المسموحة: GitHub وnpm وNotiamo وموقع WordPress (في تشغيل WordPress) والمضيفون الذين تضيفهم تحت مضيفون إضافيون يمكن للوكيل الوصول إليهم في بطاقة المشغّلات. وكل ما عدا ذلك مرفوض.
لا يدفع الوكيل التغييرات أبدًا ولا يحمل بيانات اعتماد. المشغّل نفسه هو الذي يدفع فرع التشغيل بعد انتهاء عمل الوكيل.
عندما ينتهي التشغيل، يوقف المشغّل كل عملية تركها الوكيل خلفه، مثل خادم التطوير.
سلسلة المفاتيح (keychain) على macOS
على macOS لا يغلق صندوق العزل سلسلة المفاتيح بالكامل. لذلك لا تُبقِ أي تسجيل دخول إلى GitHub في سلسلة مفاتيح المستخدم الذي يشغّل المشغّل (ينبّه init عندما يجد واحدًا). والإعداد الأكثر أمانًا هو مستخدم macOS مخصص له سلسلة مفاتيحه الخاصة.
Windows
نظام Windows العادي ليس فيه صندوق عزل للصدفة. عندها قد يجعل نصٌّ في تعليق التشغيلَ ينفّذ أي أمر باسمك. شغّل المشغّل داخل WSL2. على Windows العادي لا يبدأ المشغّل إلا إذا أضفت "allowUnsandboxed": true إلى ملف config.json الخاص به؛ افعل ذلك فقط على جهاز لا يحتوي على أي شيء آخر.
عدة تشغيلات في وقت واحد
في بطاقة المشغّلات تضبط عمليات التشغيل المتزامنة: من 1 إلى 3. يستهلك كل تشغيل من خطة Claude الخاصة بك، فاجعل العدد في حدود ما تتسع له الخطة. ولا يعمل مشروع واحد مرتين في الوقت نفسه: التشغيل الثاني على المشروع نفسه ينتظر الأول.
لكل تشغيل متزامن مجلد خانة خاص به. ولا يستطيع صندوق عزل أي تشغيل قراءة الخانات الأخرى.
مشغّل لعميل واحد
عند إنشاء مشغّل، يمكنك حصره في مساحة عمل واحدة تحت يعمل من أجل. عندها لا يأخذ إلا تشغيلات ذلك العميل. ولإعداده على حاسوب العميل: ثبّت Claude Code هناك، ونفّذ npx @notiamo/runner init، والصق رمز المشغّل. تسجيل الدخول إلى Claude على ذلك الحاسوب هو الذي يدفع تكلفة التشغيلات، فسجّل الدخول بالحساب الذي ينبغي أن يدفع.
أوامر التجهيز والاختبار
النسخة النظيفة المستنسخة لا تحتوي حزمًا مثبّتة. أخبر الوكيل كيف يثبّتها وكيف يختبر. افتح إعدادات الوكيل في المشروع واملأ أمر التجهيز وأمر الاختبار، في سطر واحد لكل منهما.
- ينفّذ الوكيل أمر التجهيز مرة واحدة، قبل أول تغيير يجريه. مثال:
pnpm install --frozen-lockfile. - ينفّذ الوكيل أمر الاختبار قبل كل حفظ (commit). والتغيير الذي يفشل فيه إما يُصلَح وإما يُتراجع عنه. مثال:
pnpm typecheck && pnpm lint. - ينفّذ الوكيل الأمرين بنفسه، في صندوق العزل نفسه الذي تعمل فيه أوامره الأخرى. ويجب أن يكون سجل الحزم ضمن المضيفين المسموحين. GitHub و
registry.npmjs.orgموجودان افتراضيًا. أضف أي سجل آخر (PyPI أو crates.io أو سجل خاص) تحت مضيفون إضافيون يمكن للوكيل الوصول إليهم في بطاقة المشغّلات. - لكل مشروع مجلد ذاكرة للحزم بجوار نسخته المستنسخة. تحتفظ فيه npm وpnpm وYarn وCorepack وBun وpip وuv وComposer بذاكرتها المؤقتة، لأن صندوق العزل يغلق الأماكن المعتادة في مجلدك الرئيسي. يبقى المجلد بين تشغيلات المشروع ويزول مع النسخة المستنسخة. وهو غير موجود في Windows العادي.
- اجعل أمر الاختبار خفيفًا. الاختبار الذي يحتاج إلى Docker لا يمكن تشغيله. والاختبار الذي يحتاج إلى قاعدة بيانات لا يعمل إلا إذا أشار ملف env الخاص بالمشروع إلى قاعدة بيانات تُبقيها قيد التشغيل (انظر أدناه).
يحفظ الوكيل التغييرات باسم “Notiamo agent”، بسطر بسيط واحد لكل بند. ويوقف المشغّل سطر “Co-Authored-By” وسطر “Generated with” اللذين يضيفهما Claude Code، فلا يظهر في المستودع أي مشارك من الذكاء الاصطناعي.
بيئة لمشاريعك الخاصة
يحصل التشغيل على مشروع GitHub على نسخة نظيفة ولا شيء غيرها. أما في مشروع برمجي يخصك، فقد تحتاج الاختبارات أيضًا إلى قاعدة بيانات، ومخزن ملفات، وملتقط بريد، وملف .env. وجهاز المشغّل يعطيها لتشغيلات مشروع واحد عبر ملف عادي:
npx @notiamo/runner env <projectId>
<projectId> هو الجزء الأخير من عنوان صفحة المشروع في Notiamo. ينشئ الأمر الملف ~/.notiamo-runner/env/<projectId>.env، ويكون مقروءًا لك وحدك، ثم يطبع مساره. ضع في كل سطر KEY=VALUE واحدًا. يحصل التشغيل التالي لذلك المشروع على المتغيرات في صدفته، ويُخبَر الوكيل بأسمائها، لا بقيمها أبدًا. احذف الملف لسحبها. لا يغادر الملف الجهاز أبدًا: Notiamo لا يعرف أنه موجود.
ومع وجود الملف، قد تصل صدفة التشغيل أيضًا إلى الخدمات على 127.0.0.1 في macOS: قاعدة Postgres لديك، ومخزن ملفات، وخادم تطوير. أنت تُبقيها قيد التشغيل؛ والوكيل لا يستطيع تشغيلها، ويبقى Docker بعيدًا عن متناوله. أما على Linux فلصندوق العزل شبكته الخاصة، فليس 127.0.0.1 هناك هو عنوان الجهاز: اربط الخدمات بعنوان شبكة الجهاز وأضف ذلك المضيف تحت مضيفون إضافيون يمكن للوكيل الوصول إليهم.
القواعد:
- قيم التطوير والاختبار فقط. ينفّذ الوكيل أوامر في الصدفة ويستطيع قراءة كل متغير. لا تضع مفتاح إنتاج أبدًا، ولا كلمة مرور تستخدمها في مكان آخر.
- يتم تجاهل
PATHوHOMEومتغيرات الوكيل الوسيط والشهادات وNODE_OPTIONSوNODE_TLS_REJECT_UNAUTHORIZEDوNOTIAMO_*وGIT_*وCLAUDE_*وANTHROPIC_*، ويذكر السجل ذلك. يمكن للملف أن يغيّر ما تراه أوامر الوكيل، لا طريقة اتصال Claude Code بـ Anthropic وNotiamo. - القيم التي طولها 6 محارف أو أكثر تُخفى بالشكل
[secret]في السجل الذي يتلقاه Notiamo. أما القيم القصيرة (1وtrue) فلا. - أبقِ عمليات التشغيل المتزامنة عند 1 عندما تتشارك مشاريع المشغّل قاعدة بيانات عبر ملف env. فتشغيلان في الوقت نفسه سيجريان اختباريهما على قاعدة البيانات نفسها.
مواقع WordPress
يوجد الاتصال في بطاقة الوصول إلى الموقع في المشروع: كلمة مرور تطبيق، واختياريًا SSH أو FTP. يحفظ المشغّل مفتاح خادم SSH عند أول اتصال، ويرفض أي خادم يعرض مفتاحًا آخر لاحقًا. ويسير التشغيل هكذا:
- نسخة احتياطية قبل العمل. مع SSH يصدّر المشغّل قاعدة البيانات ويرفعها إلى Notiamo مضغوطة، بحد أقصى 200 ميغابايت. يحتفظ بها Notiamo لمدة 30 يومًا. ومع FTP أو واجهة API فقط لا توجد نسخة احتياطية.
- يعمل الوكيل ضمن قائمة السماح أدناه.
- فحص الموقع بعد العمل. يفتح المشغّل الموقع ويتحقق من أنه ما زال يستجيب.
- استعادة عند الفشل. إذا فشل الفحص، يستعيد المشغّل قاعدة البيانات.
ما يجوز للوكيل تشغيله بـ wp-cli، لكل مجموعة (تُضبط في المشروع):
- المحتوى:
post *وterm *وmenu *وmedia importوoption getوoption update. - قاعدة البيانات:
search-replace(النص القديم والنص الجديد فقط؛ ولا يمسّ جداول المستخدمين أو الخيارات أبدًا) وcache flushوrewrite flushوtransient delete. - الإضافات والقوالب:
pluginوthemeمعlistوactivateوdeactivateوupdate. - المعلومات:
core versionوsite listوdb size. - الملفات: لا أمر wp-cli؛ يستخدم الوكيل أدوات الملفات الخاصة به. وهي تكتب الأنماط والسكربتات وملفات أخرى لا ينفّذها الخادم.
- ملفات PHP (معطّلة افتراضيًا): يمكن لأدوات الملفات أن تكتب PHP أيضًا. ملف PHP هو كود يعمل على خادمك، وتشغيل WordPress ليس فيه خطوة موافقة: يصبح التغيير فعّالًا فورًا. فعّلها فقط لموقع تثق فيه بكل من يستطيع كتابة تعليق.
- أبدًا، إلا إذا اخترت “السماح بكل شيء”:
evalوeval-fileوshellوuser *وdb query|import|reset|drop|exportوplugin installوtheme installوcore update|download.
ما الذي يُخزَّن وأين
كل شيء موجود في ~/.notiamo-runner.
| المسار | ما يحتويه |
|---|---|
config.json |
عنوان Notiamo، واسم المشغّل، ورمز المشغّل. مقروء لك وحدك. |
claude/ |
مجلد إعدادات Claude Code الخاص بالمشغّل: تسجيل دخوله وجلساته. |
projects/ |
النسخ العاملة من مشاريعك، مجلد لكل مشروع في كل خانة. المشروع الذي لا يُستخدم طوال عدد الأيام المضبوط في بطاقة المشغّلات يُزال؛ ويستنسخه التشغيل التالي من جديد. |
git/ |
النسخ الخاصة بالمشغّل من مستودعاتك. لا يستطيع الوكيل قراءة هذا المجلد ولا الكتابة فيه. |
env/ |
ملفات env التي أنشأتها، ملف لكل مشروع. |
runs/ |
إعدادات Claude Code لكل تشغيل جارٍ. لا أسرار فيها. تُحذف عند انتهاء التشغيل. |
runner.log |
ما فعله المشغّل، بلا أسرار. |
state.json |
معرّفات التشغيلات الجارية. بعد إعادة التشغيل يُبلَّغ Notiamo بأن كلًّا منها فشل. |
أسرار التشغيل (كلمات مرور WordPress ورموز التشغيل نفسه) تأتي من Notiamo مع التشغيل وتبقى في الذاكرة فقط. ويحصل عليها الوكيل كمتغيرات بيئة، ولا تُكتب في ملف أبدًا. وما يطبعه الوكيل يُنظَّف منها قبل رفع السجل.
لا يستخدم المشغّل أبدًا بيانات اعتماد git الخاصة بالجهاز. يحصل كل تشغيل من Notiamo على رمز GitHub يعمل ساعة واحدة ولمستودع التشغيل وحده. يبقيه المشغّل في الذاكرة ويستخدمه في الجلب والدفع الخاصين به. ويفتح Notiamo طلب السحب (pull request) ويدمجه.
أوقف مشغّلًا
في بطاقة المشغّلات، اضغط تعطيل لإيقاف مشغّل مؤقتًا، أو حذف لإزالته. ويتوقف رمز المشغّل المحذوف عن العمل فورًا.