@seemseam/ccb 8.0.11 → 8.0.13

package/VERSION

@@ -1 +1 @@
-8.0.11
+8.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "8.0.11",
+  "version": "8.0.13",
   "description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, Kimi, MiMo, Qwen, Cursor, Copilot, Crush, Kiro, Pi, Z.ai, OpenCode, Antigravity, and Droid.",
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",
@@ -43,8 +43,8 @@
     "bin/ctx-transfer.js",
     "bin/ccb-npm-install.js",
     "bin/ccb-npm-runner.js",
-    "README.md",
-    "README_zh.md",
+    "README*.md",
+    "readme_*.md",
     "LICENSE",
     "VERSION"
   ],

package/readme_ar.md

@@ -0,0 +1,312 @@
+<div align="center" dir="rtl">
+
+# CCB - وصل تطبيق الهاتف!
+
+**مصمم لتعاون متعدد الوكلاء بطريقة لامركزية**  
+**مساحة عمل TUI مرئية وقابلة للتحكم لعدة وكلاء**
+
+<p>
+  <img src="https://img.shields.io/badge/version-8.0.12-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
+  <img src="https://img.shields.io/badge/providers-15%20CLI%20families-0B7285.svg" alt="providers">
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
+  <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
+  <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
+  <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
+  <img src="https://img.shields.io/badge/Qwen-6A5CFF?style=flat-square" alt="Qwen">
+  <img src="https://img.shields.io/badge/Cursor-111111?style=flat-square" alt="Cursor">
+  <img src="https://img.shields.io/badge/Copilot-111111?style=flat-square&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
+  <img src="https://img.shields.io/badge/Crush-FF5A5F?style=flat-square" alt="Crush">
+  <img src="https://img.shields.io/badge/Kiro-6D5EF6?style=flat-square" alt="Kiro">
+  <img src="https://img.shields.io/badge/Pi-111111?style=flat-square" alt="Pi">
+  <img src="https://img.shields.io/badge/Z.ai-111111?style=flat-square" alt="Z.ai">
+  <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
+  <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
+  <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
+</p>
+
+[中文](README.md) | [English](readme_en.md) | [日本語](readme_ja.md) | [Français](readme_fr.md) | [Deutsch](readme_de.md) | **العربية** | [Español](readme_es.md) | [Português](readme_pt.md) | [한국어](readme_ko.md) | [Русский](readme_ru.md)
+
+[البدء السريع](#quick-start) · [Mobile App](#mobile-app) · [وضع Rich](#rich-mode) · [إعداد الوكلاء](#configure-agents) · [دليل المستخدم](docs/manuals/user-guide/) · [دليل المطور](docs/manuals/developer-guide/)
+
+<p align="center">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="مساحة عمل CLI مرئية متعددة الوكلاء في CCB" width="960">
+</p>
+
+</div>
+
+<a id="supported-clis"></a>
+
+## واجهات CLI المدعومة
+
+يمكنك مزج واجهات CLI مختلفة لكل agent داخل `.ccb/ccb.config`. تعتمد الإتاحة الفعلية على تثبيت CLI محليا وعلى صلاحيات الحساب.
+
+| CLI family | Provider id |
+| :--- | :--- |
+| Codex | `codex` |
+| Claude | `claude` |
+| Gemini | `gemini` |
+| Kimi | `kimi` |
+| MiMo | `mimo` |
+| Qwen | `qwen` |
+| Cursor | `cursor` |
+| GitHub Copilot CLI | `copilot` |
+| Crush | `crush` |
+| Kiro CLI | `kiro` |
+| Pi | `pi` |
+| Z.ai CLI | `zai` |
+| OpenCode | `opencode` |
+| Antigravity | `agy` |
+| Droid | `droid` |
+
+<a id="why-ccb"></a>
+
+## لماذا CCB؟
+
+- اتصال مستقر بين الوكلاء لرسوم تعاون معقدة مثل `A -> B -> C` و `A,B -> C` و `A -> B,C`.
+- كل agent هو طرفية أصلية كاملة مع تحكم مرئي في التخطيط وإمكانية تدخل مباشر.
+- يحافظ daemon الخلفي على حالة المشروع حتى عند إغلاق واجهة المقدمة.
+- قدرة Hub: تشغيل عدة CLI providers بالتوازي من أمر واحد.
+- متحكم هاتف بعيد: تحكم صوتي عبر providers، ونقل ملفات، ووصول إلى طرفية بعيدة.
+
+<a id="how-to-install"></a>
+
+## طريقة التثبيت
+
+ثبّت أو حدّث باستخدام npm:
+
+```bash
+npm install -g @seemseam/ccb
+```
+
+بعد تثبيت CCB استخدم updater المدمج:
+
+```bash
+ccb update
+```
+
+<details>
+<summary><b>حزم GitHub release وخيار التثبيت من المصدر</b></summary>
+
+إذا كان npm غير مناسب في بيئتك، نزّل الحزمة المناسبة من [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases)، ثم فك الضغط وثبّت:
+
+```bash
+tar -xzf ccb-*.tar.gz
+cd ccb-*
+./install.sh install
+```
+
+التثبيت من المصدر مخصص للتطوير أو كحل مؤقت فقط:
+
+```bash
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
+./install.sh install
+```
+
+يربط التثبيت من المصدر أوامر `ccb` / `ask` العالمية بالـ checkout الحالي. يفضّل المستخدمون العاديون حزمة npm.
+
+</details>
+
+<a id="quick-start"></a>
+
+## البدء السريع
+
+### 1. التشغيل
+
+نفّذ الأمر من مجلد العمل:
+
+```bash
+ccb
+```
+
+إذا أخبرك التشغيل أنه لا يمكن إنشاء `.ccb` تلقائيا أو أن مرساة المشروع مفقودة، أنشئ `.ccb` يدويا:
+
+```bash
+mkdir -p .ccb
+```
+
+<a id="configure-agents"></a>
+
+### 2. إنشاء إعداد المشروع
+
+أنشئ `.ccb/ccb.config` في جذر المشروع. تستخدم طوبولوجيا v2 `[windows]` الموصى بها الرمزين `,` و `;` للتحكم في التكديس العمودي والتقسيم الأفقي داخل كل window؛ لذلك يشبه `A,B;C,D` تخطيط أربع panes.
+
+```toml
+version = 2
+
+[windows]
+main = "main:codex"
+work = "worker1:codex(worktree), worker2:claude(worktree)"
+review = "reviewer:claude, qa:gemini"
+
+[ui.sidebar]
+mode = "every_window"
+width = "15%"
+bottom_height = 20
+agents_height = "50%"
+comms_height = "15%"
+tips_height = "35%"
+comms_limit = 3
+```
+
+تحقق من الإعداد ثم ابدأ مساحة العمل:
+
+```bash
+ccb config validate
+ccb
+```
+
+### 3. التعاون
+
+يمكنك الكتابة مباشرة في أي agent pane، أو جعل الوكلاء يتعاونون:
+
+```text
+/ask reviewer review the latest parser changes and list blocking issues.
+```
+
+يمكن للوكلاء أيضا استدعاء `/ask` أثناء تنسيق workflow للتفويض والتسليم. استخدم ذاكرة agent أو ملف الذاكرة المشتركة للمشروع `.ccb/ccb_memory.md` للتنسيق المستمر.
+
+<a id="mobile-app"></a>
+
+## التحكم البعيد من الهاتف (Android)
+
+الطريقة الموصى بها للتحكم في CCB من الهاتف يمكنها الاتصال بكل مشاريع CCB، والتحكم بكل agent، وقبول الإدخال الصوتي، ونقل الملفات.
+
+```bash
+ccb update mobile
+```
+
+يرشدك هذا الأمر خلال التثبيت والإعداد.
+
+<p align="center">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="محادثة agent في CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="تحكم terminal في CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="نقل ملفات CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="اقتران واتصال CCB Mobile" width="180">
+</p>
+
+<details>
+<summary><b>تفاصيل Mobile App وحدود الأمان والمصدر</b></summary>
+
+يتضمن CCB 8.0.12 مصدر Flutter الخاص بـ CCB Mobile داخل [`mobile/`](mobile/) وينشر Android APK عبر GitHub Releases:
+
+- [تنزيل CCB Mobile v8.0.12 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.12/ccb-mobile-v8.0.12.apk)
+- مصدر التطبيق: [`mobile/app`](mobile/app)
+- مصدر gateway الخادم: [`lib/mobile_gateway`](lib/mobile_gateway)
+
+تطبيق الهاتف هو متحكم بعيد لمشاريع CCB حقيقية تعمل على خادم. يمكنه اكتشاف المشاريع المركبة من server-wide mobile gateway، والتبديل بين windows و agents، وعرض سياق محادثة agent، وإرسال النص عبر pane-native input، وفتح terminal view، ورفع/تنزيل الصور والمستندات عبر gateway موثق.
+
+حدود الأمان:
+
+- يربط CCB gateway على loopback فقط، مثل `127.0.0.1:8787`.
+- يستخدم الوصول البعيد Tailscale Serve وليس Tailscale Funnel.
+- لا يخزن CCB كلمات مرور Tailscale أو OAuth tokens أو admin API tokens، ولا يغير tailnet ACLs/grants تلقائيا.
+- يحصل الهاتف فقط على scopes المصرح بها في pairing profile، مثل view و content و terminal و file upload و file download.
+
+</details>
+
+<a id="rich-mode"></a>
+
+## طرفية وسائط Rich
+
+تصفح شجرة الملفات، وافتح الملفات، وحرر المستندات، واعرض الوسائط داخل الطرفية.
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="منضدة CCB rich media مع معاينة Yazi داخل WezTerm" width="860">
+</p>
+
+```bash
+ccb update rich
+```
+
+بعد تفعيل rich mode، يفتح `ccb` العادي rich WezTerm launcher تلقائيا ما لم يكن يعمل بالفعل داخل جلسة rich WezTerm مدارة بواسطة CCB. شغّل `ccb uninstall rich` للعودة إلى تشغيل الطرفية العادي.
+
+<a id="agent-roles"></a>
+
+## Agent Roles Spec وكتالوج الأدوار
+
+يدعم CCB [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)، وهي مواصفة host-neutral لتغليف agents متخصصة. يمكنها جمع skills والذاكرة واعتمادات الأدوات في Role Packs قابلة للتثبيت والتركيب والإزالة. يعمل ذلك المستودع أيضا ككتالوج أدوار عام.
+
+| Role | الغرض |
+| :--- | :--- |
+| `agentroles.ccb_self` | صيانة CCB الذاتية، مساعدة الإعداد، تشخيص runtime، الاسترداد المحمي، وتنسيق workflow. |
+| `agentroles.archi` | مراجعة المعمارية، فحص الحدود، تحليل الترابط، مخاطر القابلية للصيانة، ونصائح gate لاحقة. |
+| `agentroles.frontend_engineer` | تصميم وتنفيذ frontend، design systems، إمكانية الوصول، browser QA، وتفويض AGY المراجع. |
+| `agentroles.mobile_app_engineer` | تصميم وتنفيذ mobile لـ iOS و Android و React Native و Expo و Flutter و SwiftUI و Jetpack Compose وغيرها. |
+| `agentroles.mother` | إنشاء الأدوار، تدقيق role source، أبحاث الأدوار، تصميم blueprint، وفحوص توافق Agent Roles. |
+| `agentroles.su_ccb` | عمليات SU-CCB workflow لتحليل المتطلبات، التخطيط، dispatch، review gates، الأرشفة، والاسترداد. |
+
+<a id="config-memory"></a>
+
+## الإعداد والذاكرة المشتركة
+
+إذا لم تكن متأكدا من كيفية تجميع windows، أو عدد workers المطلوب، أو أي agents يجب أن تستخدم worktrees، أو أي agents تحتاج نماذج أو API routes منفصلة، فاسأل `ccb_self` في مساحة العمل الحالية. إنه self-agent مدمج في CCB: يفهم أوامر CCB وسلطة الإعداد و roles و windows وحدود reload ومسارات الاسترداد الشائعة، ويمكنه استخدام skill الخاص `ccb-config` لتصميم إعداد معك. تتضمن المشاريع الفارغة `ccb_self`؛ ويمكن للإعدادات المخصصة القائمة إضافته عبر `ccb roles add agentroles.ccb_self:codex`.
+
+`.ccb/ccb_memory.md` هو مستند الذاكرة المشتركة على مستوى المشروع. استخدمه لقواعد تعاون الفريق، وقيود المشروع، والسياق طويل العمر، واتفاقيات تسليم agents. المعلومات المستقرة عبر agents يجب أن توضع هناك بدلا من نسخها في عدة ملفات ذاكرة خاصة بالـ providers.
+
+<a id="contact"></a>
+
+## التواصل
+
+- Email: `bfly123@126.com`
+- [Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
+- WeChat: `seemseam-com`
+
+<p align="center">
+  <img src="assets/weixin.jpg" alt="مجموعة WeChat" width="240">
+</p>
+
+<a id="community"></a>
+
+## المجتمع والشكر
+
+شكرا لـ [مجتمع Linux.do](https://linux.do) على الاختبار والتغذية الراجعة والنقاش.
+
+شكرا لـ [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) على أفكار sidebar والإلهام.
+
+<a id="release-notes"></a>
+
+## ملاحظات الإصدار
+
+<details open>
+<summary><b>v8.0.12</b> - قابلية نقل Release CI وتعريب README متعدد اللغات</summary>
+
+- اختبارات mobile host registry تضع الآن Unix sockets المؤقتة تحت مسار قصير `/tmp/ccb-sock-*` لتجنب فشل `AF_UNIX path too long` في macOS CI.
+- أصبحت `ccb update mobile` وروابط README و package metadata و mobile release manifest تشير إلى APK الإصدار 8.0.12.
+- أصبح README الصيني هو README الرئيسي على GitHub؛ وانتقل الإنجليزي إلى `readme_en.md`، وأضيفت نسخ اليابانية والفرنسية والألمانية والعربية والإسبانية والبرتغالية والكورية والروسية بنفس بنية الأقسام.
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - إصدار CCB Mobile Monorepo</summary>
+
+- دخل مصدر Flutter لـ CCB Mobile رسميا إلى هذا المستودع، مع نشر Android APK عبر GitHub Releases.
+- أضيف اكتشاف مشاريع mobile على مستوى الخادم، و pairing، و authenticated gateway routes، و pane-native message input، و conversation context rendering، و terminal access، ورفع/تنزيل الصور والمستندات.
+- أصبح `ccb update mobile` مدخل Tailscale Tailnet onboarding موحدا مع إبقاء gateway على loopback-only، دون Funnel، ودون تخزين tokens أو تعديل ACLs/grants تلقائيا.
+
+</details>
+
+<details>
+<summary><b>v7.7.0</b> - تقوية إصدار Runtime Accelerator</summary>
+
+- تتضمن release artifacts الآن Rust `ccb-runtime-accelerator` الاختياري؛ ولم تعد agents Codex المثبتة ترجع بصمت إلى Python hot path عندما يكون sidecar متوقعا.
+- عندما يجعل مسار المشروع Unix socket path طويلا جدا، ينتقل accelerator socket تلقائيا إلى per-user runtime socket root قصير.
+- تم تقوية callback repair و Codex binding cache invalidation، مع أدلة مسجلة لـ regression و long-idle Codex soak و Claude callback و mixed-provider integration.
+
+</details>
+
+<details>
+<summary><b>v7.6.19</b> - سياسة الانتظار الافتراضية لـ ask طويل المدة</summary>
+
+- تستمر استدعاءات `ask` الطويلة العادية في انتظار نتائج provider/completion الحقيقية بدلا من الانتهاء كـ `incomplete/heartbeat_timeout` بسبب تشخيص heartbeat فقط.
+- أصبحت no-terminal timeouts pane-backed في Codex و Claude و Gemini opt-in صريحة افتراضيا، مع بقاء سياسات reliability timeout الصريحة متاحة.
+- أكد smoke لاختبار source-runtime ask لمدة 32 دقيقة أن المهمة يمكن أن تبقى running لأكثر من 30 دقيقة ثم تكتمل بـ `result_message` دون دليل `heartbeat_timeout` أو `incomplete`.
+
+</details>
+
+راجع التاريخ الكامل في [CHANGELOG.md](CHANGELOG.md).

package/readme_de.md

@@ -0,0 +1,312 @@
+<div align="center">
+
+# CCB - Die Mobile App ist da!
+
+**Entwickelt fuer dezentrale Multi-Agent-Kollaboration**  
+**Ein sichtbarer und steuerbarer Multi-Agent-TUI-Arbeitsbereich**
+
+<p>
+  <img src="https://img.shields.io/badge/version-8.0.12-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
+  <img src="https://img.shields.io/badge/providers-15%20CLI%20families-0B7285.svg" alt="providers">
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
+  <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
+  <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
+  <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
+  <img src="https://img.shields.io/badge/Qwen-6A5CFF?style=flat-square" alt="Qwen">
+  <img src="https://img.shields.io/badge/Cursor-111111?style=flat-square" alt="Cursor">
+  <img src="https://img.shields.io/badge/Copilot-111111?style=flat-square&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
+  <img src="https://img.shields.io/badge/Crush-FF5A5F?style=flat-square" alt="Crush">
+  <img src="https://img.shields.io/badge/Kiro-6D5EF6?style=flat-square" alt="Kiro">
+  <img src="https://img.shields.io/badge/Pi-111111?style=flat-square" alt="Pi">
+  <img src="https://img.shields.io/badge/Z.ai-111111?style=flat-square" alt="Z.ai">
+  <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
+  <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
+  <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
+</p>
+
+[中文](README.md) | [English](readme_en.md) | [日本語](readme_ja.md) | [Français](readme_fr.md) | **Deutsch** | [العربية](readme_ar.md) | [Español](readme_es.md) | [Português](readme_pt.md) | [한국어](readme_ko.md) | [Русский](readme_ru.md)
+
+[Schnellstart](#quick-start) · [Mobile App](#mobile-app) · [Rich-Modus](#rich-mode) · [Agents konfigurieren](#configure-agents) · [Benutzerhandbuch](docs/manuals/user-guide/) · [Entwicklerhandbuch](docs/manuals/developer-guide/)
+
+<p align="center">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="Sichtbarer Multi-Agent-CLI-Arbeitsbereich von CCB" width="960">
+</p>
+
+</div>
+
+<a id="supported-clis"></a>
+
+## Unterstuetzte CLIs
+
+In `.ccb/ccb.config` koennen Sie pro Agent unterschiedliche CLIs mischen. Die tatsaechliche Verfuegbarkeit haengt von der lokalen CLI-Installation und den Kontoberechtigungen ab.
+
+| CLI family | Provider id |
+| :--- | :--- |
+| Codex | `codex` |
+| Claude | `claude` |
+| Gemini | `gemini` |
+| Kimi | `kimi` |
+| MiMo | `mimo` |
+| Qwen | `qwen` |
+| Cursor | `cursor` |
+| GitHub Copilot CLI | `copilot` |
+| Crush | `crush` |
+| Kiro CLI | `kiro` |
+| Pi | `pi` |
+| Z.ai CLI | `zai` |
+| OpenCode | `opencode` |
+| Antigravity | `agy` |
+| Droid | `droid` |
+
+<a id="why-ccb"></a>
+
+## Warum CCB?
+
+- Stabile Kommunikation zwischen Agents fuer komplexe Kollaborationsgraphen wie `A -> B -> C`, `A,B -> C` und `A -> B,C`.
+- Jeder Agent ist ein vollstaendiges natives Terminal mit sichtbarer Layoutsteuerung und direkter Uebernahme.
+- Der Hintergrund-daemon haelt den Projektstatus auch dann am Leben, wenn die Vordergrund-UI geschlossen wird.
+- Hub-Faehigkeit: mehrere CLI providers parallel mit einem einzigen Befehl ausfuehren.
+- Mobile Fernsteuerung: provider-uebergreifende Sprachsteuerung, Dateiuebertragung und Remote-Terminal-Zugriff.
+
+<a id="how-to-install"></a>
+
+## Installation
+
+Installieren oder aktualisieren Sie mit npm:
+
+```bash
+npm install -g @seemseam/ccb
+```
+
+Nach der Installation verwenden Sie den CCB updater:
+
+```bash
+ccb update
+```
+
+<details>
+<summary><b>GitHub-release-Pakete und Source-Install als Fallback</b></summary>
+
+Wenn npm in Ihrer Umgebung unpraktisch ist, laden Sie das passende Paket von [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) herunter, entpacken es und installieren es:
+
+```bash
+tar -xzf ccb-*.tar.gz
+cd ccb-*
+./install.sh install
+```
+
+Die Installation aus dem Quellcode ist nur fuer Entwicklung oder temporaere Fallbacks gedacht:
+
+```bash
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
+./install.sh install
+```
+
+Eine Source-Installation verlinkt die globalen Befehle `ccb` / `ask` zurueck auf den Checkout. Normale Benutzer sollten das npm-Paket bevorzugen.
+
+</details>
+
+<a id="quick-start"></a>
+
+## Schnellstart
+
+### 1. Starten
+
+Fuehren Sie dies in Ihrem Arbeitsverzeichnis aus:
+
+```bash
+ccb
+```
+
+Wenn der Start meldet, dass `.ccb` nicht automatisch erstellt werden kann oder der Projektanker fehlt, erstellen Sie `.ccb` manuell:
+
+```bash
+mkdir -p .ccb
+```
+
+<a id="configure-agents"></a>
+
+### 2. Projektkonfiguration erstellen
+
+Erstellen Sie `.ccb/ccb.config` im Projektwurzelverzeichnis. Die empfohlene v2-Topologie `[windows]` verwendet `,` und `;`, um vertikale Stapelung und horizontale Splits innerhalb jedes Windows zu steuern; `A,B;C,D` entspricht etwa einem Vier-Pane-Layout.
+
+```toml
+version = 2
+
+[windows]
+main = "main:codex"
+work = "worker1:codex(worktree), worker2:claude(worktree)"
+review = "reviewer:claude, qa:gemini"
+
+[ui.sidebar]
+mode = "every_window"
+width = "15%"
+bottom_height = 20
+agents_height = "50%"
+comms_height = "15%"
+tips_height = "35%"
+comms_limit = 3
+```
+
+Validieren Sie die Konfiguration und starten Sie den Arbeitsbereich:
+
+```bash
+ccb config validate
+ccb
+```
+
+### 3. Zusammenarbeiten
+
+Sie koennen direkt in ein beliebiges Agent-pane schreiben oder Agents zusammenarbeiten lassen:
+
+```text
+/ask reviewer review the latest parser changes and list blocking issues.
+```
+
+Agents koennen waehrend der Workflow-Orchestrierung auch `/ask` aufrufen, um Arbeit zu delegieren und zu uebergeben. Nutzen Sie Agent-memory oder die projektweite gemeinsame Memory-Datei `.ccb/ccb_memory.md` fuer dauerhafte Koordination.
+
+<a id="mobile-app"></a>
+
+## Mobile Fernsteuerung (Android)
+
+Die empfohlene Steuerung von CCB per Smartphone kann sich mit allen CCB-Projekten verbinden, jeden Agent steuern, Spracheingabe annehmen und Dateien uebertragen.
+
+```bash
+ccb update mobile
+```
+
+Dieser Befehl fuehrt durch Installation und Konfiguration.
+
+<p align="center">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="CCB Mobile Agent-Chat" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="CCB Mobile Terminalsteuerung" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="CCB Mobile Dateiuebertragung" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="CCB Mobile Pairing und Verbindung" width="180">
+</p>
+
+<details>
+<summary><b>Mobile-App-Details, Sicherheitsgrenze und Source</b></summary>
+
+CCB 8.0.12 enthaelt den Flutter-Quellcode von CCB Mobile in [`mobile/`](mobile/) und veroeffentlicht das Android APK ueber GitHub Releases:
+
+- [CCB Mobile v8.0.12 APK herunterladen](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.12/ccb-mobile-v8.0.12.apk)
+- App-Source: [`mobile/app`](mobile/app)
+- Server-gateway-Source: [`lib/mobile_gateway`](lib/mobile_gateway)
+
+Die Smartphone-App ist eine Fernsteuerung fuer echte CCB-Projekte auf einem Server. Sie kann gemountete Projekte ueber das server-wide mobile gateway finden, windows und agents wechseln, Agent-Konversationen rendern, Text ueber pane-native input senden, eine Terminalansicht oeffnen und Bilder sowie Dokumente ueber das authentifizierte gateway hoch- und herunterladen.
+
+Sicherheitsgrenze:
+
+- Das CCB gateway bindet nur an loopback, zum Beispiel `127.0.0.1:8787`.
+- Remote-Zugriff nutzt Tailscale Serve, nicht Tailscale Funnel.
+- CCB speichert keine Tailscale-Passwoerter, OAuth tokens oder admin API tokens und aendert tailnet ACLs/grants nicht automatisch.
+- Das Smartphone erhaelt nur die vom pairing profile erlaubten scopes, etwa view, content, terminal, file upload und file download.
+
+</details>
+
+<a id="rich-mode"></a>
+
+## Rich-Medienterminal
+
+Dateibaeume durchsuchen, Dateien oeffnen, Dokumente bearbeiten und Medien im Terminal anzeigen.
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB Rich-Medien-Workbench mit Yazi-Vorschau in WezTerm" width="860">
+</p>
+
+```bash
+ccb update rich
+```
+
+Nach Aktivierung des Rich-Modus oeffnet normales `ccb` automatisch den rich WezTerm launcher, sofern es nicht bereits in einer CCB-managed rich WezTerm session laeuft. Mit `ccb uninstall rich` kehren Sie zum normalen Terminalstart zurueck.
+
+<a id="agent-roles"></a>
+
+## Agent Roles Spec und Rollenkatalog
+
+CCB unterstuetzt [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), eine host-neutrale Spezifikation zum Verpacken spezialisierter Agents. Skills, Memory und Tool-Abhaengigkeiten koennen in installierbare, mountbare und entfernbare Role Packs gebuendelt werden. Dieses Repository dient auch als oeffentlicher Rollenkatalog.
+
+| Role | Zweck |
+| :--- | :--- |
+| `agentroles.ccb_self` | CCB-Selbstwartung, Konfigurationshilfe, Laufzeitdiagnose, geschuetzte Wiederherstellung und Workflow-Orchestrierung. |
+| `agentroles.archi` | Architekturreview, Grenzpruefung, Kopplungsanalyse, Wartbarkeitsrisiken und Gate-Empfehlungen. |
+| `agentroles.frontend_engineer` | Frontend-Design und Implementierung, Designsysteme, Barrierefreiheit, Browser-QA und gepruefte AGY-Delegation. |
+| `agentroles.mobile_app_engineer` | Mobile-Design und Implementierung fuer iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose und mehr. |
+| `agentroles.mother` | Rollenerstellung, Role-source-Audit, Rollenrecherche, Blueprint-Design und Agent-Roles-Spec-Compliance. |
+| `agentroles.su_ccb` | SU-CCB-Workflowbetrieb fuer Anforderungsanalyse, Planung, Dispatch, Review-Gates, Archivierung und Wiederherstellung. |
+
+<a id="config-memory"></a>
+
+## Konfiguration und gemeinsame Memory
+
+Wenn Sie nicht sicher sind, wie windows gruppiert werden sollen, wie viele worker noetig sind, welche Agents worktrees verwenden sollten oder welche Agents eigene Modelle oder API-Routen brauchen, fragen Sie `ccb_self` im aktuellen Arbeitsbereich. Das ist der eingebaute self-agent von CCB: Er versteht CCB-Befehle, Konfigurationsautoritaet, roles, windows, reload-Grenzen und gaengige Wiederherstellungspfade und kann mit seinem privaten `ccb-config` skill gemeinsam mit Ihnen eine Konfiguration entwerfen. Leere Projekte enthalten `ccb_self`; bestehende Custom-Konfigurationen koennen ihn mit `ccb roles add agentroles.ccb_self:codex` hinzufuegen.
+
+`.ccb/ccb_memory.md` ist das projektweite gemeinsame Memory-Dokument. Nutzen Sie es fuer Teamregeln, Projektbeschraenkungen, langlebigen Kontext und Uebergabekonventionen zwischen Agents. Stabile agent-uebergreifende Informationen gehoeren dorthin, statt in mehrere provider-private Memory-Dateien kopiert zu werden.
+
+<a id="contact"></a>
+
+## Kontakt
+
+- Email: `bfly123@126.com`
+- [Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
+- WeChat: `seemseam-com`
+
+<p align="center">
+  <img src="assets/weixin.jpg" alt="WeChat-Gruppe" width="240">
+</p>
+
+<a id="community"></a>
+
+## Community und Danksagung
+
+Danke an die [Linux.do community](https://linux.do) fuer Tests, Feedback und Diskussionen.
+
+Danke an [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) fuer Sidebar-Ideen und Inspiration.
+
+<a id="release-notes"></a>
+
+## Release Notes
+
+<details open>
+<summary><b>v8.0.12</b> - Release-CI-Portabilitaet und README-Lokalisierung</summary>
+
+- Mobile-host-registry-Tests legen temporaere Unix sockets jetzt unter einem kurzen `/tmp/ccb-sock-*` Pfad ab und vermeiden dadurch `AF_UNIX path too long` Fehler in macOS CI.
+- `ccb update mobile`, README-Links, package metadata und das mobile release manifest zeigen jetzt auf das 8.0.12 APK.
+- Das chinesische README ist jetzt das GitHub-Haupt-README; Englisch wurde nach `readme_en.md` verschoben, und Japanisch, Franzoesisch, Deutsch, Arabisch, Spanisch, Portugiesisch, Koreanisch und Russisch wurden mit derselben Abschnittsstruktur ergaenzt.
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - CCB Mobile Monorepo Release</summary>
+
+- Der Flutter-Source von CCB Mobile wurde offiziell in dieses Repository aufgenommen, mit Android APKs ueber GitHub Releases.
+- Hinzu kamen server-wide mobile project discovery, pairing, authentifizierte gateway routes, pane-native message input, conversation context rendering, terminal access sowie Upload/Download von Bildern und Dokumenten.
+- `ccb update mobile` wurde zum einheitlichen Tailscale-Tailnet-onboarding entrypoint, waehrend das gateway loopback-only bleibt, Funnel nicht nutzt, keine tokens speichert und ACLs/grants nicht automatisch aendert.
+
+</details>
+
+<details>
+<summary><b>v7.7.0</b> - Runtime Accelerator Release-Hardening</summary>
+
+- Release artifacts enthalten jetzt den optionalen Rust `ccb-runtime-accelerator`; installierte Codex agents fallen nicht mehr still auf den Python hot path zurueck, wenn der sidecar erwartet wird.
+- Wenn ein Projektpfad den Unix-socket-Pfad zu lang macht, wechselt der accelerator socket automatisch zu einer kurzen per-user runtime socket root.
+- Callback repair und Codex binding cache invalidation wurden gehaertet, mit aufgezeichneten Regression-, long-idle Codex soak-, Claude callback- und mixed-provider integration-Nachweisen.
+
+</details>
+
+<details>
+<summary><b>v7.6.19</b> - Standard-Wartepolitik fuer lange ask-Aufrufe</summary>
+
+- Normale lang laufende `ask`-Aufrufe warten weiter auf echte provider/completion-Ergebnisse, statt nur wegen heartbeat-Diagnosen als `incomplete/heartbeat_timeout` zu enden.
+- Codex-, Claude- und Gemini-pane-backed no-terminal timeouts sind nun standardmaessig explizit opt-in; explizite reliability timeout policies bleiben verfuegbar.
+- Ein 32-minuetiger source-runtime ask smoke bestaetigte, dass eine Aufgabe ueber 30 Minuten running bleiben und danach mit `result_message` abschliessen kann, ohne `heartbeat_timeout` oder `incomplete`.
+
+</details>
+
+Die vollstaendige Historie steht in [CHANGELOG.md](CHANGELOG.md).