إعداد وقت التشغيل

يحفظ Anda حالته افتراضيًا في ~/.anda. الملف الرئيسي هو ~/.anda/config.yaml. إعداد MCP الاختياري يوجد في ~/.anda/mcp.json.

مزودو النماذج

يجب أن يحتوي المزود النشط على family و model و api_base. يمكن وضع api_key في الملف أو تمريره عبر متغير بيئة.

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY"
      labels: ["pro", "brain"]
      disabled: false

متغيرات البيئة المدعومة:

OPENAI_API_KEY
ANTHROPIC_API_KEY
GEMINI_API_KEY
GOOGLE_API_KEY
DEEPSEEK_API_KEY
MINIMAX_API_KEY
MIMO_API_KEY
MOONSHOT_API_KEY
KIMI_API_KEY
BIGMODEL_API_KEY
GLM_API_KEY

إعدادات رئيسية

الإعداد	الغرض
`addr`	عنوان gateway المحلي، افتراضيًا `127.0.0.1:8042`.
`sandbox`	إذا كان true يستخدم shell مجلد `~/.anda/sandbox`.
`https_proxy`	بروكسي للنماذج والقنوات.
`model`	مزودو الوكيل والذاكرة.
`transcription`	تحويل الصوت والمرفقات إلى نص.
`tts`	تشغيل الصوت.
`channels`	Telegram وWeChat وDiscord وLark/Feishu.

خوادم MCP

يمكن لـ Anda Bot الاتصال بخوادم MCP عبر عمليات stdio أو endpoints بنمط HTTP. ضع إعداد MCP قابلًا للنقل في ~/.anda/mcp.json ثم أعد تشغيل daemon. يقبل الملف mcpServers وservers كـ root key حتى يمكن لصق إعدادات من أدوات MCP أخرى بتغييرات قليلة.

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "$ANDA_WORKSPACE"]
    },
    "remote": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_REMOTE_TOKEN}"
      }
    }
  }
}

تظهر أدوات MCP البعيدة كأدوات Anda بأسماء مثل mcp_<server_id>_<remote_tool>. تدعم سلاسل الإعداد توسيع متغيرات البيئة $VAR و${VAR}. المتغيران ANDA_HOME وANDA_WORKSPACE مدمجان. في خوادم stdio يتم تشغيل command مباشرة دون shell؛ وإذا لم يتم ضبط cwd فسيستخدم أول workspace في Anda. إذا لم يضبط type فستستنتج Anda stdio من command أو http من url.

يمكن للوكيل أيضا إضافة خادم أثناء التشغيل باستخدام add_mcp_server. استخدم persist: false للـ daemon الحالي فقط، أو persist: true لحفظ الخادم في ~/.anda/mcp.json وإبقائه بعد إعادة التشغيل. تطابق حقول الخادم إدخالا واحدا في mcp.json: type وcommand وargs وenv وcwd وurl وheaders وenabled وinclude وexclude، إضافة إلى حقلي الأداة id وpersist.

المجلدات المحلية

~/.anda/
  config.yaml
  mcp.json
  channels/
  db/
  keys/
  logs/
  bundled-skills/
  sandbox/
  skills/
  skills-manifest.json
  skill-backups/
  skill-trash/
  workspace/

يحتوي db/ على الذاكرة والمحادثات وحالة القنوات و cron. يحتوي bundled-skills/ على المهارات التي تديرها إصدارات Anda، بينما يحتوي skills/ على المهارات الشخصية التي تنشئها أو تستنسخها أو تعدلها. يحتفظ skills-manifest.json بحالة التفعيل والتعطيل وإعادة التحميل المحلية، وتحتوي skill-backups/ وskill-trash/ على نسخ التحرير الاحتياطية والمهارات الشخصية المحذوفة. ويعد workspace/ مساحة العمل الافتراضية للملفات و shell.

الخصوصية

تبقى البيانات المحلية على جهازك، لكن مزودي النماذج قد يستقبلون prompts وملخصات وطلبات ذاكرة. اختر المزودين و endpoints والبروكسي حسب احتياجاتك.

تلميح

استخدم anda --home /path/to/.anda لعزل المشاريع أو الهويات أو الاختبارات.

مزودو النماذج​

إعدادات رئيسية​

خوادم MCP​

المجلدات المحلية​

الخصوصية​

مزودو النماذج

إعدادات رئيسية

خوادم MCP

المجلدات المحلية

الخصوصية