الإعداد
الإعداد
يمكنك ضبط Bob Shell ليتناسب مع تفضيلات سير عملك.
مواقع ملفات الإعدادات
يحفظ Bob Shell الإعدادات في موقعين:
| النطاق | الملف |
|---|---|
| المستخدم (جميع مساحات العمل) | ~/.bob/settings/settings.json |
| المشروع (مساحة العمل الحالية) | <workspace>/.bob/ |
تتجاوز أعلام CLI دائمًا قيم الملفات للجلسة الحالية. يمكنك أيضًا تغيير الإعدادات بشكل تفاعلي عبر أمر /settings داخل bob chat.
مخطط الإعدادات
{
"session": {
"maxTurns": 50,
"defaultMode": "agent",
"mcp": true,
"subagents": true
},
"logging": {
"logLevel": "warn"
},
"tasks": {
"retentionDays": 30
},
"telemetry": {
"enabled": true
}
}| الإعداد | النوع | الافتراضي | الوصف |
|---|---|---|---|
session.maxTurns | number | 50 | الحد الأقصى لدورات الوكيل لكل جلسة (0 = غير محدود) |
session.defaultMode | string | "agent" | الوضع الافتراضي عند بدء جلسة |
session.mcp | boolean | true | تفعيل خوادم Model Context Protocol (MCP) بشكل افتراضي |
session.subagents | boolean | true | تفعيل إنتاج subagents بشكل افتراضي |
logging.logLevel | string | "warn" | مستوى تفصيل السجلات (error وwarn وinfo وdebug وtrace) |
tasks.retentionDays | number | 30 | عدد الأيام للاحتفاظ بسجل مهام الجلسة |
telemetry.enabled | boolean | true | ما إذا كانت بيانات الاستخدام ترسل. التعطيل يمنع جمع بيانات الاستخدام. |
telemetry.excludePayload | boolean | — | مستخدمو IBM: استبعاد محتوى المحادثة من بيانات القياس عن بُعد. يُفعَّل فقط للمشاريع الحساسة المعتمدة. |
تحذير:
اضبط tasks.retentionDays على 0 فقط في Bob Shell 2.0.1 أو أحدث. ضبط هذه القيمة على 0 في الإصدارات السابقة قد يحذف المهام غير المثبتة وسجلها.
يُخزَّن رموز المصادقة (OAuth) بشكل منفصل في ~/.bob/settings/auth-secrets.json.
ملفات السياق
توفر ملفات السياق (مثل AGENTS.md) تعليمات لنموذج الذكاء الاصطناعي. تُحمَّل هذه الملفات بشكل هرمي:
- السياق العام:
~/.bob/AGENTS.md(ينطبق على جميع المشاريع) - سياق المشروع:
AGENTS.mdفي جذر المشروع والمجلدات الأم - السياق المحلي:
AGENTS.mdفي المجلدات الفرعية (للتعليمات الخاصة بالمكونات)
مثال على ملف السياق
# Project: My TypeScript Library
## General instructions
- Follow existing coding style
- Add JSDoc comments to all functions
- Prefer functional programming patterns
- Target TypeScript 5.0 and Node.js 20+
## Coding style
- Use 2 spaces for indentation
- Interface names should be prefixed with `I`
- Private class members should be prefixed with `_`
- Use strict equality (`===` and `!==`)إحصاءات الاستخدام
يجمع Bob Shell إحصاءات استخدام مجهولة لتحسين المنتج. يشمل ذلك:
- أنماط استخدام الأدوات (الأسماء والنجاح/الفشل والمدة)
- مقاييس طلبات API (النموذج والمدة والنجاح)
- معلومات تكوين الجلسة
لا يُجمَع أي معلومات شخصية أو محتوى موجّه أو محتوى ملفات.
لإلغاء الاشتراك، عيّن telemetry.enabled إلى false في ملف إعداداتك:
{
"telemetry": {
"enabled": false
}
}ما رأيك في هذا الموضوع؟