تفاصيل تطبيق سطح المكتب
📚 تنقل السلسلة: المقال السابق 06 · تشغيل المهمة الأولى رافقك لتوجيه أولى التوجيهات ومشاهدة مخرجات وتعديلات Codex بالفعل. هذا المقال يتعمق في المدخل الأساسي للأداة — تطبيق سطح المكتب، لشرح واجهته، الميزات المدعومة، الإعدادات الأساسية والروابط السريعة. المقال التالي 08 · دليل استخدام سطر الأوامر CLI سيعود للطرفية لتأكيد ميزات المسار الثاني.
قامت OpenAI بتقسيم Codex إلى أربعة مداخل، ولكن الزر الكبير للتحميل على الصفحة الرئيسية، والملف الفرعي app في مستندات التكوين، وعروض التقديم كلها تدور حول منتج أساسي موحد — تطبيق سطح المكتب. فليس CLI ولا نسخة الويب، بل هذه النافذة المستقلة هي النواة.
وهذا ليس كلامًا مرسلاً. قمت بإحصاء الصفحات الفرعية تحت مجلد app في الوثائق الرسمية: features و commands و settings 和 review و worktrees 和 automations 和 browser 和 computer-use 和 local-environments 和 chrome-extension... أكثر من عشر صفحات مخصصة بالكامل لتطبيق سطح المكتب، وحجم وثائق CLI لا يعادل نصفها. ويتضح لك فورًا التركيز الكامل للشركة.
ولكن المثير للاستغراب هو أن الكثيرين يعتقدون للوهلة الأولى «تطبيق سطح المكتب؟ أليس هذا مجرد نسخة مبسطة لمن لا يجيد استخدام سطر الأوامر؟ سأعتمد على CLI مباشرة». وبكل صراحة، هذا الاعتقاد خاطئ تمامًا عند الحديث عن Codex — فتطبيق سطح المكتب لـ Codex ليس نسخة مجردة من CLI، بل هو يجمع بين العمليات المتوازية، عزل مساحات العمل بـ Worktree، مراجعة الفروق الرسومية، المتصفح المدمج، ومهام الأتمتة بالكامل في واجهة واحدة، ليمثل الواجهة الأكثر شمولاً وقدرة.
وسيرافقك هذا المقال في جولة شاملة داخل التطبيق: توضيح مهام النوافذ والأقسام، كيفية تشغيل المهام المتوازية دون تعارض، طريقة مراجعة التعديلات البرمجية، وأهم الاختصارات السريعة للحفظ.
بعد قراءة هذا المقال，你会拿到：
- رسم توضيحي لأقسام واجهة تطبيق سطح المكتب لتحديد مهام العمود الأيسر، صندوق المحادثة في المنتصف، واللوحة اليمنى بلمحة.
- الفروق الدقيقة بين أوضاع التشغيل الثلاثة (Local / Worktree / Cloud) وكيفية اختيار الأنسب للمهمة.
- كيفية استخدام لوحة المراجعة الرسومية — مراجعة الأسطر سطرًا بسطر، قبول أو التراجع عن كتل التعديل، وتسجيل ورفع طلبات PR بالكامل من الواجهة.
- التعرف على الميزات الحصرية للتطبيق مثل الطرفية المدمجة، أزرار الإجراءات السريعة (Actions)، ومهام الأتمتة (Automations).
- جدول مقارنة لأهم الاختصارات والأوامر المائلة، ومسار عمل مبسط لتطبيقه بنفسك.
⚠️ الاختصارات الرسمية والتهيئة: تركز مستندات الاختصارات الرسمية حاليًا على نظام macOS فقط؛ وبالنسبة لاختصارات نظام Windows، فيرجى مراجعتها من قائمة الإعدادات Settings > Keyboard Shortcuts للتعرف على الأزرار المقابلة، وسننبه لذلك بالتفصيل أدناه.
01 أولاً: ما هو الموقع والهدف لتطبيق سطح المكتب
يصعب على الكثيرين فهم دور التطبيق عند تشغيله للمرة الأولى لوجود العديد من النوافذ والأزرار والقوائم. لا تتسرع في استخدامها، واستوعب أولاً الهدف العام للتطبيق، لتدرك فائدة كل قسم لاحقًا.
الخلاصة أولاً: تطبيق سطح المكتب لـ Codex هو «منصة عمل برمجية صُممت للعمليات المتوازية». وتعرفه الوثائق الرسمية بأنه "a focused desktop experience for working on Codex threads in parallel" — بيئة عمل مخصصة لإدارة خيوط (threads) مهام Codex المتعددة معًا. ويمثل الخيط (thread) جلسة محادثة مستقلة، والتوجيه الذي أرسلته في المقال 06 هو مثال لخيط مستقل.
تشبيه: صالة عمل مفتوحة تضم عدة مكاتب. (ويمثل «المكتب» هنا كل جلسة عمل مستقلة لـ Codex). يشبه CLI العمل بمفردك على مكتب واحد وتلتزم بإنجاز المهام واحدة تلو الأخرى؛ بينما يشبه تطبيق سطح المكتب دور مدير الفريق الذي يشرف على صالة عمل تضم عدة مكاتب، ويجلس على كل مكتب وكيل Codex ينجز مهمة مختلفة — أحدهم يحل مشكلة برمجية، والآخر يكتب اختبارات، وفي الزاوية وكيل يعمل على مهام معقدة طويلة المدى — وتقف في المنتصف لتشرف بلمحة على تقدم عمل كل منهم وتدخل عند الحاجة. «متابعة تقدم عدة مهام معًا والتبدل之间 بسلاسة» هو جوهر تطبيق سطح المكتب。
ويقوم التطبيق بتشغيل نفس أداة Codex المستخدمة في CLI وإضافات IDE، ويتشارك معها في نفس قواعد ملف AGENTS.md (كتيب إرشادات المشروع المشروح في المقال 02)، ونفس إعدادات MCP، والمهارات (Skills) — وتؤكد الوثائق الرسمية على هذا التشارك التقني. لذا فهو ليس أداة مختلفة، بل هو نفس وكيل Codex مع واجهة بصرية تدعم تنظيم العمليات المتوازية بسلاسة.
بعض السيناريوهات الواقعية التي تبرع فيها واجهة التطبيق:
- توفر عدة مهام بسيطة غير مترابطة，想同时铺开跑，又怕它们改同一份文件打架。
- البدء بمشروع تطوير واجهات (frontend) جديد，想边让 Codex 改、边用内置浏览器看页面效果。
- الرغبة في الحصول على تقرير صباحي يومي，让它定时自动生成。
هذه الحالات يصعب إنجازها بـ CLI أو تتطلب تهيئة برمجية معقدة، بينما يوفرها تطبيق سطح المكتب مباشرة.
💡 الخلاصة في جملة واحدة: تطبيق سطح المكتب ليس نسخة مبسطة من CLI، بل هو واجهة بصرية صممت لدعم العمليات المتوازية والمراجعة البصرية لوكيل Codex، ويمثل المدخل الرئيسي المفضل للشركة。
02 التثبيت: نظاما التشغيل المدعومان، وتنبيه لمستخدمي Linux
نوضح النقطة الهامة أولاً: لا تتوفر نسخة لسطح المكتب لنظام Linux حاليًا。
ويرجع السبب لعدم إطلاق النسخة الرسمية بعد — ويمكن لمستخدمي Linux التسجيل في قائمة الانتظار للمتابعة، والالتزام باستخدام CLI حاليًا (سنشرحه بالتفصيل في المقال القادم). لذا سنقتصر أدناه على نظامي macOS و Windows.
شرحنا خطوات التثبيت بالتفصيل في المقال 03، ونلخص هنا الجوانب المتعلقة بالتطبيق:
| نظام التشغيل | كيفية جلب الحزمة | تنبيهات هامة |
|---|---|---|
| macOS (Apple Silicon) | حمل الحزمة الافتراضية المخصصة مباشرة | تأكد من ملاءمة إصدار المعالج لتفادي فشل التثبيت |
| macOS (معالجات Intel) | اختر نسخة Intel build من صفحة التحميل | تجنب تنزيل نسخة Apple Silicon لجهازك |
| Windows | يتوفر التطبيق عبر Microsoft Store؛ ويمكن التثبيت بـ winget install Codex -s msstore | راجع إعدادات البيئة المعزولة في المقال 03 |
| Linux | غير متاح حاليًا، قائمة الانتظار | استخدم CLI مؤقتًا |
بعد فتح التطبيق وتثبيته، هناك شرط أساسي يغفله المبتدئون في تسجيل الدخول:
تسجيل الدخول بحساب ChatGPT يضمن جاهزية جميع الميزات؛ بينما يفرض التسجيل بمفتاح API key قيودًا على بعض الوظائف。وتنص الوثائق الرسمية على ذلك قائلة: "some functionality might not be available". وتتغير قائمة الميزات المقيدة حسب التحديثات، ويرجى مراجعة صفحة الأسعار المحدثة للتأكيد — وتذكر قاعدة: لتفعيل واستخدام كامل قدرات تطبيق سطح المكتب، سجل الدخول بحساب اشتراك ChatGPT。这也呼应第 04 篇讲的：Codex 跟着 ChatGPT 套餐走，Plus / Pro / Business / Edu / Enterprise 都含 Codex 用量。
واجهت هذه المشكلة بنفسي في مارس 2026 عند تثبيت التطبيق للمرة الأولى: اخترت كتابة مفتاح API key لتبسيط الأمر، فتعطلت الميزات المرتبطة بالعمليات السحابية وظهرت باللون الرمادي، وظننت في البداية وجود خلل برمجية في الإصدار، وقضيت دقائق في البحث قبل إدراك السبب. وبمجرد الخروج وإعادة تسجيل الدخول بحساب ChatGPT، تفعلت الميزات فورًا。ويسرني توضيح ذلك لتفادي هدر وقتك.
💡 الخلاصة في جملة واحدة: يتوفر تطبيق سطح المكتب لنظامي Mac و Windows فقط، ومستخدمو Mac يجب عليهم التحقق من نوع المعالج (Intel / Apple Silicon)；ويفضل تسجيل الدخول بحساب ChatGPT لتفادي قيود الميزات المرافقة لمفتاح API key.
03 أقسام الواجهة: العمود الأيسر، صندوق المحادثة، واللوحة اليمنى
تنقسم واجهة تطبيق سطح المكتب لثلاثة أقسام رئيسية: العمود الأيسر للتنقل والتبديل، القسم الأوسط للمحادثات وإدخال التوجيهات，اللوحة اليمنى لمراجعة النتائج。وفهم أدوار هذه الأقسام يزيل الغموض عن الواجهة تمامًا.
يوضح المخطط التالي الأقسام الثلاثة لسهولة الفهم:
يوضح المخطط مسار العمل: تبدأ باختيار المشروع والجلسة من العمود الأيسر ← توجه التعليمات للوكيل في القسم الأوسط ← وتراجع المخرجات في اللوحة اليمنى，工作流是从左到右流动的。下面逐块拆。
العمود الأيسر (قائمة التنقل وإدارة الجلسات)
يضم العمود الأيسر خيارات الإدارة العامة للتطبيق (قد تختلف المسميات قليلاً حسب التحديثات):
- جلسة جديدة (New Thread)：لبدء مهمة مستقلة جديدة. وهو الزر الأكثر استخدامًا.
- البحث (Search)：للبحث في المحادثات السابقة وسجلات المشاريع. ويعمل كبحث شامل للمشاريع الكبيرة.
- الإضافات (Plugins)：لربط الميزات الخارجية لـ Codex، مثل المتصفح أو GitHub。
- الأتمتة (Automations)：让 Codex 定时自动跑任务（第 05 节细说）。
- المشاريع (Projects)：قائمة بمجلدات ومستودعات الأكواد المرتبطة، وتتيح التبديل السريع بينها.
- المحادثات العامة (Chats)：جلسات حوارية عامة غير مرتبطة بمشاريع محددة، وتناسب عمليات البحث والدراسة.
وهناك خلط شائع للمبتدئين يجب توضيحه: المشروع (Project) يختلف تمامًا عن المحادثة العامة (Chat)。
- المشروع يربط مجلدًا أو مستودعًا محددًا على جهازك، ويملك Codex صلاحية قراءة وتعديل ملفاته وتشغيل الأوامر داخله — لامتلاكه الصلاحية الرسمية للعمل في مساحة العمل. بينما المحادثات العامة لا ترتبط بمشاريعك محددة، وتُخزن في مجلد افتراضي مستقل للنظام (الافتراضي
~/.codex/threads），适合研究、规划、调插件这类不需要碰你代码仓库的事——就像门口问路的访客，聊得欢但进不了车间。 - سيناريوهات استخدام كل منهما:
- لتوجيه Codex لتعديل دالة تسجيل الدخول في ملفات مشروعك
~/code/my-app← استخدم خيار المشروع. - للبحث عن كيفية عمل مفاهيم لغة Rust ← استخدم المحادثات العامة دون الحاجة لربط مشروع.
- لتوجيه Codex لتعديل دالة تسجيل الدخول في ملفات مشروعك
ثانياً: القسم الأوسط (صندوق المحادثة وتوجيه التعليمات)
中间区这一大块主工作区是核心：上半是 Codex 的对话流（它读了啥、改了啥、跑了啥命令一路滚下来），底部是输入框。输入框这一排藏着几个关键开关，发指令前先扫一眼：
- أوضاع التشغيل：(Local / Worktree / Cloud) لتحديد بيئة معالجة المهمة (القسم 04).
- النموذج المستخدم：切当前用哪个模型，会话中途也能换。
- سیاسات الموافقة：就是第 02 篇讲的审批策略，控制 Codex 动手前问不问你。
اللوحة اليمنى (مراجعة النتائج)
右边面板默认可能收着，点右上角那个面板图标能把它展开。它是「结果展示区」，最常用的三样：
- لوحة مراجعة الفروق (Diff)：لمراجعة الأسطر البرمجية التي عدلها Codex (القسم 03).
- الطرفية المدمجة：طرفية تشترك مع Codex في نفس بيئة العمل ومساحة السياق (القسم 05).
- المعاينة (Preview)：لعرض صفحات الويب، المستندات، الصور، والمصادر (Sources).
يوضح الرسم أقسام الواجهة الستة بالتفصيل — شريط الحالة العلوي (يضم المشروع والوضع والنموذج والإجراءات Actions)، قائمة المشاريع والجلسات اليسرى، صندوق المحادثة الأوسط，右上 Diff 审查面板、右下内置终端、底部状态栏（分支 / token 用量 / 连接状态 ），底部那行箭头点的就是「左挑去哪 → 中间下指令 → 右边看结果」这条主线。这是示意图，真实界面以官方 / 真机为准——官方布局在持续微调，区域位置和名称可能和你本机略有出入，对上「每块管什么」即可。
توضح الصورة الواجهة الفعلية للتطبيق لتأكيد فهمها:
💡 الخلاصة في جملة واحدة: تنقسم الواجهة لثلاثة أقسام رئيسية — العمود الأيسر للتنقل والتبديل، القسم الأوسط لصندوق المحادثات، واللوحة اليمنى لمراجعة النتائج؛ وتذكر دائمًا أن خيار المشروع مخصص للتعديل الفعلي للملفات، والمحادثات العامة مخصصة للبحث والدراسة فقط.
04 三种运行模式：Local / Worktree / Cloud 怎么选
يتعين عليك اختيار وضع التشغيل من شريط صندوق الإدخال قبل إرسال الرسالة الأولى. ويعد هذا الخيار الأهم لتهيئة مسار العمل — فتحديده بشكل خاطئ قد يسبب تداخل التعديلات مع الفرع الرئيسي للمستودع، أو رندرة وتعديل ملفات في مسارات بعيدة تعجز عن مراجعتها. وتوفر الأداة ثلاثة أوضاع للتشغيل:
| وضع التشغيل | أين يتم التنفيذ | أين تقع التعديلات | متى يُستخدم |
|---|---|---|---|
| المحلي (Local) | محليًا على جهازك | تعديل مجلد المشروع الرئيسي مباشرة | للتطوير اليومي والرغبة في مراجعة النتائج فورًا |
| 副本 عزل (Worktree) | محليًا في مجلد Git worktree مستقل | داخل مجلد تجريبي副本، دون لمس المجلد الرئيسي | لتجربة أفكار جديدة أو تشغيل عدة مهام متوازية لتفادي التعارض |
| السحابي (Cloud) | سحابيًا في بيئة معزولة لـ OpenAI | داخل بيئة معزولة سحابية، وتعود المخرجات كطلبات PR أو تقارير | للمهام المعقدة طويلة المدى لتفادي استهلاك موارد جهازك |
تنص الوثائق الرسمية على توضيح هام: يعمل كلاً من وضعي Local و Worktree محليًا على جهازك，只有 Cloud 是远程的。别被「Worktree 听着很高级」吓到，它本质还是在你本机干活，只是换了个隔离的文件夹。
ونركز هنا على وضع Worktree لكونه الأساس لتنظيم العمليات المتوازية دون تعارض.
تشبيه: نسخ مخطط البناء لعدة نسخ لتعديل كل منها على حدة. عند رغبتك ورغبة وكلاء Codex في تعديل نفس المشروع (نفس المخطط)، فإن تجميع التعديلات في وضع Local يؤدي لتداخل وتلف الأكواد حتمًا. ويقوم وضع Worktree بـ — إنشاء نسخة مستقلة بالكامل من المخطط لكل مهمة مستقلة (بالاعتماد على ميزة git worktree في الخلفية)，各画各的，谁也别想动到别人那张；等某张画好了，再决定要不要并回原件。在合并之前，一个线程 of the change 绝不会污染另一个。
ذكرت مشكلة تداخل الصلاحيات سابقًا في المقال 02، وأوضح هنا درسًا عمليًا مفيدًا يرتبط بـ Worktree: قمت في إحدى المرات بتشغيل جلستين بالتوازي بوضع Local لتعديل نفس المستودع، إحداهما لتعديل طبقة البيانات والأخرى لتعديل التوجيه (routing)، فقام كلاهما بتعديل نفس ملف الإعدادات، وأدى حفظ تعديل الجلسة الثانية لتلف تعديلات الجلسة الأولى، واضطررت لقضاء وقت طويل لمراجعة git diff وفهم الخلل. ومنذ ذلك الحين، أعتمد على وضع Worktree دائمًا عند تشغيل عمليات متوازية لنفس المشروع، لتفادي تعارض الملفات تمامًا.
حقائق هامة تنص عليها الوثائق حول وضع Worktree لتفادي المشاكل:
- يتطلب استخدام وضع Worktree خضوع المشروع لإدارة Git——底层就是
git worktree，没 Git 玩不转。项目不是 Git 仓库，审阅面板会提示你先建一个。 - يرث مجلد Worktree الملفات المسجلة في Git فقط——
.gitignore里的东西（比如.env、node_modules）不会跟着进去。所以新 worktree 里常常缺依赖，得靠「设置脚本」补上（第 05 节讲 Local Environments 时细说）。 - موقع الحفظ：Codex 把 worktree 建在
$CODEX_HOME/worktrees下（CODEX_HOME默认~/.codex），而且默认处于 "detached HEAD" 状态，不会污染你的分支。 - التنقل (Handoff)：想把一个线程在 Local 和 Worktree 之间挪，用线程头部的 Hand off，Codex 自己处理底层 Git 操作。比如在 worktree 后台跑完，想拿回主目录用熟悉的 IDE 看，就 Handoff 到 Local。
- Automatically clean up：官方默认只保留最近 15 个 Codex 托管的 worktree，旧的会自动删（删前存快照，能恢复）。这个上限和自动删除能在设置里改。
💡 الخلاصة في جملة واحدة: يعدل وضع Local المجلد الرئيسي مباشرة، ويصمم وضع Worktree نسخة معزولة لكل مهمة (لتفادي تعارض المهام المتوازية)، ويقوم وضع Cloud بالمعالجة سحابيًا；想在同一项目里并行又不打架，闭眼选 Worktree——但记牢它只继承 Git 里的文件。
05 ميزات حصرية لتطبيق سطح المكتب تفوق CLI
تتميز واجهة تطبيق سطح المكتب بتقديم ميزات بصرية تسهل العمل وتفوق قدرات CLI الجافة. ونفصل هذه الميزات الحصرية في التالي:
لوحة المراجعة البصرية (مراجعة التعديلات بلمحة)
这是图形界面相对纯终端最直观的提升。CLI 里 Codex 改完代码，diff 是一片绿加红的文本流；桌面 App 把它变成了能点、能逐行批注、能按块接受或回滚的审阅面板（Review pane）。
类比：从「读邮件全文」升级到「在文档里改批注」。 CLI 看 diff 像收到一封纯文本邮件，你只能从头读到尾、想反馈得另起一段打字描述「第几行那个变量名改一下」；审阅面板像在 Word / 飞书文档里开了批注模式——你直接戳在那一行上写意见，精确太多。
القدرات الأساسية للوحة المراجعة (حسب الوثائق الرسمية):
- عرض التعديلات غير المسجلة افتراضيًا：它反映的是你整个 Git 仓库的状态，不只是 Codex 改的——你自己手改的、其它未提交的，都会显示。
- تحديد نطاق المراجعة：除了「未提交」，还能切到 All branch changes（跟基线分支比）和 Last turn changes（只看 Codex 最近这一轮改了啥）。本地还能在 Unstaged / Staged（未暂存 / 已暂存）之间切。
- كتابة الملاحظات سطرًا بسطر：把鼠标悬到 diff 某一行，点一旁冒出来的 + 按钮，写下反馈提交。批完再给线程发一句话（比如「按内联批注改，范围保持最小」），Codex 就照着改。
- الاعتماد أو التراجع حسب الرغبة：整份 diff、单个文件、单个 hunk（代码块）三种粒度，都能 stage（暂存）、unstage 或 revert（丢弃）。看中哪块留哪块，不想要的一键回滚。
审完还能直接发出去：本地和 worktree 的任务，看完 diff 满意了，直接在 App 里 commit、push、建 Pull Request，不用切终端。
提醒：审阅面板只对 Git 仓库里的项目生效。不是 Git 仓库的话，它会先提示你建一个。要在 App 里处理 GitHub 上的 PR 评论，机器上得装好并登录 GitHub CLI（
gh） ——跑一句gh auth login授权，否则 PR 上下文可能加载不出来。
خلال تجربتي العملية، تعد ميزة كتابة الملاحظات سطرًا بسطر الأكثر إفادة وتوفيرًا للوقت. سابقًا في CLI، كنت أضطر لكتابة توجيهات معقدة مثل «في دالة معالجة المهلة الفلانية، وفي السطر الثلاثين تقريبًا، يرجى تعديل الرقم الثابت...»، وغالبًا ما يسيء فهم الموضع؛ أما الآن فأكتفي بالضغط على السطر مباشرة وتوضيح التعديل المطلوب ليقوم بتنفيذه بدقة.
ثانياً: الطرفية المدمجة (بيئة عمل مشتركة مع Codex)
每个线程都自带一个内置终端（integrated terminal），作用域就是当前项目或 worktree。点右上角的终端图标，或按 macOS 的 Cmd + J 打开。
它最妙的一点：这个终端开在线程的工作目录里，跟 Codex 共享同一个环境。你在里头跑 git status 或 npm test，看到的就是 Codex 正在改的那份文件，不会出现「它改了但我终端里是旧的」这种错位。更进一步——Codex 能读这个终端的输出，所以它能瞄一眼你跑的开发服务器状态、回头看一眼刚才那次构建为啥挂了。
一个容易踩的快捷键坑（官方专门写了）：
Cmd + K在桌面 App 里是打开命令菜单，不是清空终端。想清终端用Ctrl + L。
أزرار الإجراءات Actions (تشغيل الأوامر بضغطة زر)
老敲同一串命令（npm run dev 、跑测试、格式化）？桌面 App 让你把它存成 Action（操作），变成窗口顶部一个一键按钮。
تشبيه: الإجراءات السريعة. 每次重新搜店、选菜、下单太烦，存个「再来一单」点一下就行。Actions 就是给项目常用命令存的「再来一单」——点一下，它在内置终端里跑起来。
Actions 配在哪？跟 Worktree 的「设置脚本」一起，都属于 Local Environments（本地环境），配置存在项目根目录的 .codex 文件夹里，能提交进 Git 全队共享。设置脚本是「新建 worktree 时自动跑」的（专治上一节说的「worktree 缺依赖」），Actions 是「你手动点着跑」的，两者搭配，worktree 一建好依赖就齐、常用命令一键就到。
رابعاً: الأتمتة Automations (جدولة تشغيل المهام)
Automations（自动化） 让 Codex 按时间表自动跑任务——定时、每天、每周都行。
أمثلة عملية تنص عليها الوثائق لاستخدام الأتمتة:
- التقرير اليومي للمستودع：分析最近提交，生成一份「昨天改了啥」的摘要。
- متابعة وحل المشاكل التقنية：定期检查 telemetry 里的报错，试着自动修。
- أتمتة جلسات العمل (thread automation)：让某个线程定时「醒来」继续长期任务，保留上下文——适合需要反复回到同一个对话往下推的活。
لضمان عمل مهام الأتمتة بشكل سليم، يجب الحفاظ على تشغيل التطبيق محليًا وجاهزية مجلد المشروع على القرص.
قمت في إحدى المرات بجدولة تقرير يومي يقوم بتلخيص التعديلات بالأمس للغة العربية، فاستمر العمل بنجاح لأسابيع دون تدخل مني، وهذه التجربة تبرز قوة تطبيق سطح المكتب وميزاته الحصرية.
💡 الخلاصة في جملة واحدة: لوحة المراجعة البصرية (كتابة الملاحظات سطرًا بسطر وإدارة PR)، الطرفية المشتركة البيئة، أزرار الإجراءات السريعة، وجدولة مهام الأتمتة — تمثل الميزات الأربع الحصرية لتطبيق سطح المكتب والتي تفوق قدرات CLI الجافة.
06 الاختصارات والأوامر المائلة: دليل سريع لأهم الأزرار
يضم التطبيق العديد من الاختصارات السريعة، ولا داعي لحفظها بالكامل. وتذكر أولاً:
تركز مستندات الاختصارات الرسمية على نظام macOS فقط. ولمستخدمي نظام Windows، يرجى مراجعة وتعديل الاختصارات من قائمة الإعدادات Settings > Keyboard Shortcuts للتعرف على الأزرار المقابلة لنظامك وتفادي الخلط.
إليك قائمة بأهم اختصارات نظام macOS الأكثر فائدة واستخدامًا (حسب مستندات الأوامر الرسمية):
| الاختصار (على macOS) | الوظيفة والإجراء | الأهمية |
|---|---|---|
Cmd + Shift + P 或 Cmd + K | فتح قائمة الأوامر العامة | للوصول لجميع الخيارات والبحث عن الأوامر وتفعيلها |
Cmd + N 或 Cmd + Shift + O | بدء جلسة عمل جديدة (New Thread) | لبدء المهام المتوازية، وهو الأكثر استخدامًا |
Cmd + J | فتح وإغلاق الطرفية المدمجة | لتشغيل وفحص الأوامر محليًا |
Cmd + B | فتح وإغلاق العمود الأيسر | لتوسيع مساحة المحادثة عند الحاجة |
Cmd + Option + B | فتح وإغلاق لوحة المراجعة (Diff) | لمراجعة التعديلات البرمجية للملفات |
Cmd + G | البحث في المحادثات السابقة | للبحث الشامل عن تفاصيل الجلسات القديمة |
Cmd + F | 在当前线程里查找 | 注意：只搜当前线程，不跨线程 |
Cmd + , | 打开设置 | 改外观、Git、MCP 全在这 |
Ctrl + L | 清空终端 | 别误用 Cmd + K（那是命令菜单） |
Ctrl + M | 语音输入 | 按住说话，转成文字 |
وبالنسبة لـ الأوامر المائلة (slash commands)، اكتب / داخل صندوق الإدخال لتعرض لك قائمة الأوامر السريعة المتاحة للتحكم في الجلسة دون مغادرتها:
| الأمر المائل | الوظيفة والإجراء |
|---|---|
/status | عرض معرف الجلسة، حجم استهلاك السياق، والحصص المتبقية |
/review | تفعيل وضع مراجعة الأكواد ومقارنة التعديلات غير المسجلة مع الفرع الرئيسي |
/plan | فتح أو إغلاق وضع التخطيط لتصميم خطوات العمل |
/goal | تحديد هدف عام ملتزم للوكيل لإنجازه (يوصى بتهيئة الخطة بـ /plan أولاً) |
/mcp | التحقق من حالة خوادم MCP المرتبطة |
/feedback | إرسال الملاحظات والتقارير للشركة |
💡 الخلاصة في جملة واحدة: احفظ الاختصارين
Cmd + K(لقائمة الأوامر العامة) وCmd + N(لجلسة جديدة) كبداية؛ واستخدم الأمرين المائلين/statusلمتابعة الاستهلاك و/reviewلتفعيل المراجعة؛ وتحقق من اختصارات Windows من لوحة الإعدادات الخاصة بجهازك.
07 تمرين عملي: تشغيل وإدارة المهام المتوازية في التطبيق
سنقوم الآن بتطبيق عملي مخصص لتطبيق سطح المكتب — تشغيل جلستين بالتوازي، عزل مساحات العمل بوضع Worktree، ومراجعة التعديلات في لوحة المراجعة البصرية:
المتطلبات المسبقة: تثبيت تطبيق سطح المكتب وتوثيق الحساب بـ حساب ChatGPT (وفقًا للمقال 03). واختر مجلد مشروع تجريبي يخضع لإدارة Git (لوضع Worktree ولوحة المراجعة).
第一步：加项目、选 Worktree 模式
点左导航的新建线程 / 加项目，选一个 Git 仓库文件夹。在底部输入框下方，模式选 Worktree（不是 Local）。
✅ 自验：能看到模式切到了 Worktree、底下让你选一个起始分支（基于 main 或当前分支都行）。若提示「需要 Git 仓库」 → 你选的文件夹没初始化 Git，先 git init 或换个仓库。
第二步：发第一条指令
输入框里下个具体的小任务，比如：
ابحث عن تعليق يضم عبارة TODO في ملفات المشروع، وقم ببرمجة وتطبيق المهمة المطلوبة فيه或者：
أضف قسمًا يوضح «خطوات تشغيل المشروع محليًا» في ملف README الخاص بالمشروع按回车发送。预期：Codex 基于你选的分支建一个 Git worktree，在那份隔离副本里开干——你的主工作目录这会儿一动不动。
第三步：再开一个并行线程
不想等第一个跑完，左边栏再点一次新建线程，同样选 Worktree 模式，下另一个不相干的任务，比如：
قم بحذف جميع أسطر طباعة سجلات console.log التجريبية من ملفات المشروع✅ 预期结果：左边栏现在列着两个线程，各自在独立的 worktree 里跑，互不干扰。这就是桌面 App 的命根子——两个任务同改一个项目，却谁也污染不了谁。你可以来回点着切，看各自进度。
第四步：用审阅面板看改动
挑一个跑完的线程，打开右边的 Diff 审阅面板（macOS Cmd + Option + B ，Windows 看本机键位）。你会看到改了哪些文件、具体改在哪几行。
试试这几个动作自验：
- 悬到某一行 → 点
+：弹出批注框，写句反馈（比如「这里加个注释」），提交后给线程发一句「按内联批注改」，看 Codex 是否照改。 - 按 hunk 暂存 / 回滚：看中的块 stage，不想要的块 revert。
✅ 预期结果：你点暂存 / 提交之前，Codex 的改动都还在 worktree 副本里待审——满意了再 commit / push，不满意逐块回滚。这种「改完先摆给你审、你点头才落地」的节奏，正是桌面 App 让人放心的地方。
第五步（可选）：把线程交接回 Local
某个 worktree 线程改得满意、想拿回主目录用熟悉的 IDE 接着弄，点线程头部的 Hand off 交接到 Local，Codex 自己处理底层 Git 操作。
✅ 预期：线程和代码一起挪进了 Local，你能在常用 IDE 里打开继续。注意：.gitignore 里的文件不会跟着交接过去（Handoff 走的是 Git 操作）。
بإتمام ذلك، تكون قد طبقت مسار العمل الرئيسي بتميز: «العمليات المتوازية ← عزل العمل بـ Worktree ← المراجعة البصرية لـ diff ← والنقل للمجلد الرئيسي للتصدير»。这套是 CLI 给不了的体验，第一次同时看着两个 Codex 在两份副本里干活、却互不打架，那种「这才是工作台」的实感挺明显的。
💡 الخلاصة في جملة واحدة: افتح جلسة Worktree متوازية ← انتظر الانتهاء ← تفحص التعديلات في لوحة المراجعة ← اعتمد الحفظ عند الرضا؛ وممارسة هذا التمرين يرسخ مسار تطبيق سطح المكتب في ذهنك.
08 ملخص
لخص هذا المقال تفاصيل ميزات وإدارة تطبيق سطح المكتب لـ Codex:
- الهدف العام: منصة عمل برمجية صممت لدعم العمليات المتوازية والمراجعة البصرية لوكيل Codex، ويتشارك مع CLI وإضافات IDE في نفس القواعد والمهارات.
- التثبيت: يتوفر لنظامي Mac و Windows فقط، ويوصى بتسجيل الدخول بحساب ChatGPT لتفادي قيود الميزات المرافقة لمفتاح API key.
- أقسام الواجهة: العمود الأيسر لإدارة الجلسات والتنقل، القسم الأوسط للمحادثات وإدخال التوجيهات، واللوحة اليمنى لمراجعة النتائج. وتذكر الفارق بين خيار المشروع للملفات المحلية، والمحادثات العامة للبحث والدراسة.
- أوضاع التشغيل: المحلي (Local) للتعديل المباشر، المعزول (Worktree) للعمليات المتوازية وتفادي التعارض، والسحابي (Cloud) للمهام طويلة المدى.
- الميزات الحصرية: لوحة المراجعة البصرية (مراجعة الأسطر سطرًا بسطر وإدارة PR)، الطرفية المشتركة البيئة، أزرار الإجراءات السريعة، وجدولة مهام الأتمتة.
- الاختصارات والأوامر المائلة: احفظ الاختصارات الأساسية مثل
Cmd + KوCmd + Nوأمر/statusلمتابعة الاستهلاك، وتحقق من اختصارات Windows من الإعدادات.
يجب أن تكون قادرًا الآن على: تشغيل تطبيق سطح المكتب بثقة، إدارة عدة مهام متوازية وعزلها بوضع Worktree لتفادي التعارض، ومراجعة التعديلات البرمجية بدقة في لوحة المراجعة البصرية وتأكيد حفظها أو التراجع عنها.
المقال التالي 08 · دليل استخدام سطر الأوامر CLI — مع تميز تطبيق سطح المكتب، هل تظل هناك حاجة لتعلم CLI؟ نعم، وبدرجة كبيرة: فعند الحاجة لكتابة برمجيات الأتمتة، إدارة الخوادم البعيدة، أو إدراج الوكيل في مسارات CI/CD، يعجز تطبيق سطح المكتب عن إنجازها، ويظل CLI هو الحل النموذجي. سيوضح المقال القادم تشغيل أمر codex في الطرفية، واجهته التفاعلية، وتطبيقه في السيناريوهات الصامتة المؤتمتة بالتفصيل لتجمع مهارات استخدام المسارين معًا.