افزونههای AI در Logseq را به هر مدل کاتالوگ سیمکشی کنید.
Updated 2026-07-30
داستان AI در Logseq در افزونههای community زندگی میکند، و افزونههای مفید همان سه تنظیم را افشا میکنند: یک endpoint یا base URL، یک API key، و یک نام مدل. endpoint را روی https://api.apisrouter.com/v1 تنظیم کنید و هر id کاتالوگی، Claude، GPT، DeepSeek، GLM، به مدل پشت دستورات اسلش graph شما تبدیل میشود.
پاسخ سریع: سه تنظیم در پیکربندی افزونه.
یک افزونه AI را از marketplace در Logseq نصب کنید، تنظیمات آن را باز کنید، و سهتایی استاندارد را پر کنید: فیلد endpoint یا base URL با https://api.apisrouter.com/v1، فیلد API key با کلید APIsRouter خود، و فیلد مدل با یک id دقیق کاتالوگ مثل claude-haiku-4-5-20251001. دو مثال ملموس از اکوسیستم. افزونه دیرینه gpt3-openai (briansunter/logseq-plugin-gpt3-openai) یک تنظیم chatCompletionEndpoint را افشا میکند، پیشفرض به host مربوط به OpenAI، بهعلاوه یک تنظیم مدل متن-آزاد، پس هر دو تمیز به یک gateway ریدایرکت میشوند. افزونه جدیدتر logseq-copilot از ابتدا برای API های سازگار با OpenAI ساخته شده، با تنظیمات API Endpoint، API Key، و Model و یک فیلد مدل حساس-به-حروف. نام فیلدها به ازای هر افزونه فرق دارد؛ الگو نه.
API / Chat Completion Endpoint:
https://api.apisrouter.com/v1
API Key: sk-YOUR-APISROUTER-KEY
Model: claude-haiku-4-5-20251001
(case-sensitive, free text)چطور افزونههای Logseq از endpoint استفاده میکنند.
Logseq outliner متنباز برای یادداشتهای شبکهای است، و افزونههای AI آن بهعنوان دستورات اسلش و اقدامات block به ادیتور قلاب میشوند: این block را خلاصه کن، اینجا نوشتن را ادامه بده، از انتخاب پاسخ بده، یک outline از یک صفحه تولید کن. هر اقدام یک درخواست chat-completions است که block های مرتبط را بهعنوان context حمل میکند، فرستادهشده به هر endpoint ای که تنظیمات افزونه اعلام میکند. یک یادداشت صادقانه درباره اکوسیستم، چون کوچکتر از اکوسیستم Obsidian است: افزونههای AI در Logseq پروژههای community با نگهداری ناهموارند. افزونه gpt3-openai تثبیتشدهترین است اما دورههای ساکت بین release ها دیده، logseq-copilot سبکتر اما هدفمند برای endpoint های سازگار با OpenAI ساخته شده. فعالیت اخیر یک افزونه را قبل از تکیه روزانه بر آن چک کنید، و انتظار داشته باشید پنل تنظیمات آن را بخوانید نه یک wizard راهاندازی صیقلی. سمت gateway نیمه پایدار این جفتشدن است. چون endpoint گویش استاندارد chat-completions را صحبت میکند و هر id کاتالوگی را از طریق یک کلید سرویس میدهد، یک افزونه یکبار پیکربندیشده میتواند با ویرایش یک فیلد تنظیمات بین یک id از Claude و یک id از DeepSeek سوییچ کند، بدون نصب دوباره، بدون حساب جدید.
انتخاب مدلها برای یک workflow outliner.
مصرف AI در outliner burstوار است نه ثابت: هیچچیز برای یک ساعت، سپس یک رشته از دستورات اسلش در حین نوشتن. صورتحساب پیشپرداخت هر-token با آن شکل بهتر از هر اشتراکی تناسب دارد، و نمای هر-مدل کنسول نشان میدهد ریتم واقعی شما روی هر id چقدر هزینه دارد.
- claude-haiku-4-5-20251001 بهعنوان راننده روزمره: خلاصههای block، بازنویسیهای سریع، و پاسخهای grounded در یک صفحه context.
- claude-sonnet-4-6 برای سنتز سنگینتر، پیشنویس بخشهای بلند از یک outline، یا هر چیزی که منتشر خواهید کرد.
- gpt-5.4-mini بهعنوان انتخاب حجمی خانواده GPT اگر prompt های شما بر رفتار OpenAI شکل گرفته باشند.
- deepseek-v4-flash برای pass های انبوه، مثل خلاصهسازی هر صفحه journal در یک ماه، با نرخ کف.
- glm-5 ارزش تست برای graph های دوزبانه را دارد، بهخصوص یادداشتهای مخلوط چینی-انگلیسی.
پرداخت بر اساس مصرف · پایینتر از قیمت رسمی
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| مدل | قیمت رسمی | قیمت ما |
|---|---|---|
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
| GPT-5.4 mini | $0.75 / $4.50 per M | $0.60 / $3.60 per M |
| GLM-5.1 | $0.86 / $3.43 per M | $0.90 / $3.40 per M |
حالتهای شکست مختص افزونههای Logseq.
تقسیم کار هنگام دیباگ: curl endpoint، کلید، و id را در دو دستور اثبات میکند، و همهچیز دیگر پیکربندی یا سازگاری افزونه است. آن ترتیب بیشترین زمان را در اکوسیستمی از افزونهها که لایه ابزار قسمت متحرک است صرفهجویی میکند.
- دستور بیصدا هیچ کاری نمیکند: تنظیمات افزونه را باز کنید و تأیید کنید فیلد endpoint واقعاً ذخیره شده؛ برخی افزونهها بعد از تغییرات تنظیمات نیاز به خاموش-روشنکردن افزونه دارند.
- خطاهای مدل با پیام not-found: فیلد مدل در حداقل یک افزونه محبوب حساس-به-حروف است، و id ها باید دقیقاً با فهرست کاتالوگ مطابقت داشته باشند. از /v1/models کپی کنید، نه از حافظه.
- فیلد endpoint عمق مسیر متفاوتی انتظار دارد: بیشتر افزونهها base ای که به /v1 ختم میشود میخواهند و خودشان مسیرها را اضافه میکنند؛ اگر یکی مسیر کامل میخواهد، /v1/chat/completions را صریح بدهید و توجه کنید افزونه شما کدام سبک را استفاده میکند.
- ۴۰۱: فیلد کلید whitespace یا یک کلید قدیمی نگه میدارد. فهرست مدلها را با همان کلید بیرون از Logseq curl کنید تا تأیید شود.
- افزونه بعد از یک بهروزرسانی Logseq خراب: افزونههای community گاهی از release های اپ عقب میمانند. قبل از فرض تغییر endpoint، issue های repository افزونه را چک کنید؛ چک curl نیمه gateway را در چند ثانیه اثبات میکند.
چه کسانی Logseq را از طریق یک gateway مسیردهی میکنند.
- روزنگارهنویسان روزانه که خلاصهها و بازنویسیها را روی graph خود با یک id volume-tier اجرا میکنند.
- نویسندگانی که از outline پیشنویس میکنند و یک id flagship را برای گذرگاههایی که اهمیت دارند در دسترس میخواهند.
- یادداشتبرداران دوزبانه که id های GLM و DeepSeek را در برابر Claude روی block های مخلوط-زبان تست میکنند.
- کاربران حریمخصوصی-محور که Logseq را برای فایلهای محلی انتخاب کردند و میخواهند ترافیک AI خود پشت یک کلید قابلممیزی تجمیع شود.
- افرادی که از قبل ادیتورها یا ترمینالها را از طریق یک gateway مسیردهی میکنند و میخواهند یادداشتها روی همان موجودی و usage log باشند.
endpoint را تأیید کنید، سپس یک block را تست کنید.
چک دو-دستوری را با id دقیق مدلی که پیکربندی کردهاید اجرا کنید، سپس یک دستور اسلش را روی یک block کوچک trigger کنید. اگر curl موفق شود و افزونه شکست بخورد، مسئله تنظیمات یا نسخه افزونه است، و repository آن جای درست نگاهکردن است. وقتی دستورات جاری شوند، کنسول APIsRouter مدل، token، و هزینه را به ازای هر درخواست ثبت میکند. workload های یادداشت در مقایسه با agent های کدنویسی سبکاند، پس بیشتر کاربران Logseq متوجه میشوند کنسول عمدتاً تأیید میکند صورتحساب کوچک است؛ ارزش دانستن آن از داده بهجای امیدواربودن است.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-haiku-4-5-20251001",
"messages":[{"role":"user","content":"Summarize: spaced repetition beats cramming."}]}'پرسشهای پرتکرار
کدام افزونههای AI در Logseq از یک endpoint سفارشی سازگار با OpenAI پشتیبانی میکنند؟
افزونه تثبیتشده gpt3-openai یک تنظیم chatCompletionEndpoint و یک نام مدل متن-آزاد را افشا میکند، و logseq-copilot حول تنظیمات قابلپیکربندی API Endpoint، API Key، و Model ساخته شده. افزونههای دیگر متفاوتاند؛ قبل از تکیه بر یکی، فیلد endpoint در تنظیمات را چک کنید.
آیا افزونههای Logseq میتوانند از مدلهای Claude استفاده کنند؟
بله، از طریق هر افزونه با یک تنظیم endpoint: آن را به https://api.apisrouter.com/v1 اشاره دهید و مدل را روی claude-haiku-4-5-20251001 یا claude-sonnet-4-6 تنظیم کنید. gateway id های Claude را روی گویش سازگار با OpenAI که افزونهها صحبت میکنند سرویس میدهد.
چرا فیلد مدل id من را رد میکند؟
فیلدهای مدل در این افزونهها متن-آزادند و حداقل یک افزونه محبوب آنها را حساس-به-حروف در نظر میگیرد، پس id باید دقیقاً با کاتالوگ مطابقت داشته باشد. آن را از فهرست /v1/models با کلید خود کپی کنید بهجای تایپ از حافظه.
آیا افزونههای AI در Logseq بهاندازه کافی نگهداری میشوند که بشود روی آنها تکیه کرد؟
ناهموار، و منصفانه است بگوییم اکوسیستم کوچکتر از Obsidian است. قبل از اینکه یک افزونه را بخشی از workflow روزانه کنید، release های اخیر و issue های باز آن را چک کنید. سمت endpoint chat completions استاندارد است، پس عوضکردن افزونهها بعداً کلید یا راهاندازی مدل شما را تغییر نمیدهد.
مصرف AI در یک اپ یادداشت واقعاً چقدر هزینه دارد؟
برای بیشتر کاربران، کم: مصرف دستور-اسلش burstوار است و هر درخواست کوچک است. روی یک id volume-tier مثل deepseek-v4-flash یا claude-haiku-4-5-20251001، یک ماه یادداشتبرداری فعال معمولاً در قلمرو خردهپول میماند؛ کنسول عدد دقیق شما به ازای هر مدل را نشان میدهد.
آیا برای این افزونهها به یک حساب OpenAI نیاز دارم؟
خیر. افزونهها به یک کلید و یک endpoint نیاز دارند، نه یک رابطه vendor. یک کلید APIsRouter بدون کارت رایگان شروع میشود، از طریق ایمیل میرسد، و هر id کاتالوگی را از طریق همان یک endpoint ای که پیکربندی میکنید سرویس میدهد.