memory و sessions

تفاوت session و memory را بشناسید؛ گفتگوهای قبلی را ادامه دهید و نکات ماندگار را در MEMORY.md و USER.md نگه دارید.

Akvan اطلاعات را به دو شکل نگه می‌دارد: sessions متن گفتگو را در SQLite ذخیره می‌کنند و memory نکات کوتاه و ماندگار را برای استفاده در گفتگوهای بعدی نگه می‌دارد.

ادامهٔ یک session

در محیط گفتگو، sessions اخیر را ببینید:

text

/sessions

سپس با واردکردن شمارهٔ موردنظر، همان session را ادامه دهید:

text

/resume 1

شمارهٔ /resume فقط به فهرست صفحهٔ فعلی /sessions اشاره می‌کند. همچنین می‌توانید با id prefix یا عنوان session هم resume کنید.

داده‌های sessions در ~/.akvan/state.db ذخیره می‌شوند و tool session_search می‌تواند با FTS5 در گفتگوهای قدیمی جست‌وجو کند.

memory ماندگار

فایل	محتوا
`~/.akvan/memories/MEMORY.md`	نکات مربوط به محیط، پروژه و تجربه‌های قبلی
`~/.akvan/memories/USER.md`	ترجیح‌ها و شیوهٔ تعامل کاربر

Akvan در شروع هر session یک snapshot از محتوای این فایل‌ها را به prompt اضافه می‌کند. تغییرات memory در طول session فوراً روی دیسک نوشته می‌شوند، اما در prompt زندهٔ همان session فقط بعد از /reload یا شروع session بعدی دیده می‌شوند.

مرور پس‌زمینه

به‌صورت پیش‌فرض، Akvan پس از هر چند نوبت اطلاعات را در پس‌زمینه مرور می‌کند و ممکن است نکات ماندگار را مستقیم در memory ذخیره کند. بعد از چند tool iteration هم ممکن است skills agent-created را بسازد یا تغییر دهد.

برای غیرفعال کردن این رفتار، مقدارهای زیر را در config مربوط به پروژه یا ~/.akvan/config.yaml قرار دهید:

yaml

memory:
  nudge_interval: 0

skills:
  creation_nudge_interval: 0

memory و skills بارگذاری‌شده در sessions بعدی، دستورالعمل‌های قابل اعتماد محسوب می‌شوند؛ محتوای آن‌ها را مانند code review کنید، مخصوصاً اگر از toolهای وب یا محتوای ناشناس استفاده کرده‌اید.

گزارش مشکل مستندات