منصوبے کے بارے میں

zotio ایک کمانڈ-لائن ٹول اور MCP سرور ہے جسے Zotero حوالہ جاتی لائبریریوں کے لیے اعتماد اور خودکاری کی پرت کے طور پر پیش کیا گیا ہے۔ یہ ان صارفین کے لیے ہے جنہیں ڈیسک ٹاپ GUI کے بجائے بڑے پیمانے پر لائبریری پر کام کرنا ہوتا ہے: گمشدہ PDFs تلاش کرنا، جمع کرانے سے پہلے ڈپلیکیٹ citation keys پکڑنا، annotations برآمد کرنا، notes vault ہم آہنگ کرنا، یا AI agents کو محدود context فراہم کرنا۔ Architecture اور ڈیٹا تک رسائی پڑھائی مقامی ہے: zotio localhost پر چل رہے Zotero ڈیسک ٹاپ API اور ایک synced SQLite mirror سے بات کرتا ہے، جس کے لیے کوئی API key درکار نہیں اور یہ synced copy پر آف لائن کام کرتا ہے۔ تحریروں کو ارادے کے مطابق تقسیم کیا گیا ہے۔ attachments کے ساتھ نیا item بنانا مقامی ڈیسک ٹاپ connector کو ترجیح دیتا ہے (وہی چینل جو براؤزر کے "Save to Zotero" بٹن میں استعمال ہوتا ہے)، جبکہ field edits، deletes، enrichment، tag operations، moves، اور collection create/update Zotero Web API کی طرف جاتے ہیں اور ان کے لیے configured key درکار ہے۔ connector path کو ترجیح قرار دیا گیا ہے، ضمانت نہیں: خودکار routing اسے صرف ذاتی لائبریری کے لیے استعمال کرتا ہے جب ڈیسک ٹاپ چل رہا ہو، ورنہ Web API پر واپس چلا جاتا ہے، اور group libraries ہمیشہ cloud پر جاتی ہیں۔ enrichment اور import کے لیے حوالہ دی گئی بیرونی خدمات میں CrossRef، OpenAlex، Semantic Scholar، Unpaywall، اور OpenCitations شامل ہیں۔ ایک doctor کمانڈ connectivity، cache freshness، اور write-back کی دستیابی کی رپورٹ دیتا ہے۔ تحریر کی حفاظت تمام write کمانڈز ایک ہی mutation envelope استعمال کرتی ہیں۔ Preview ڈیفالٹ ہے؛ --yes لاگو کرتا ہے اور --dry-run ہمیشہ جیتتا ہے۔ Agent mode JSON اور non-interactive ڈیفالٹس مقرر کرتا ہے مگر writes خودکار طور پر لاگو نہیں کرتا۔ Gates اثر کے دائرے کو محدود کرتے ہیں: --max-changes کی ڈیفالٹ 500 ہے (agent mode میں 50)، اور ناقابلِ واپسی operations جیسے merge، permanent delete، اور empty-trash کے لیے واضح --allow-destructive flag درکار ہے۔ لاگو کی گئی writes مقامی mirror میں replay ہوتی ہیں تاکہ اگلی پڑھائی دوبارہ sync کے بغیر تبدیلی دیکھ سکے۔ ہر لاگو run ایک append-only journal میں درج ہوتا ہے، اور journal undo قابلِ واپسی operations (tag renames، collection membership، creates) کو پلٹ دیتا ہے جبکہ merges، deletions، اور field overwrites سے انکار کرتا ہے۔ لائبریری ہیلتھ اور CI نمایاں library health کمانڈ موجودہ checks (citekey conflicts، duplicates، missing metadata، tag drift، broken attachments) کو ایک درجہ بند، finding-typed رپورٹ میں ترکیب کرتی ہے۔ ایک --for flag preset منتخب کرتا ہے: quick، citation، systematic-review، vault، یا all۔ Findings میں recommended_action شامل ہوتا ہے جو اس کمانڈ کا نام بتاتا ہے جو انہیں ٹھیک کرتی ہے۔ یہ کمانڈ CI gating کو --fail-on کے ساتھ سپورٹ کرتی ہے، معیار پورا نہ ہونے پر 11 کے ساتھ exit کرتی ہے، اور --require-fresh کے ساتھ stale mirror پر 12 کے ساتھ exit کرتی ہے۔ جن checks کو ڈیسک ٹاپ ایپ درکار ہوتی ہے وہ خاموشی سے غائب ہونے کے بجائے حل کے ساتھ بلند skips بن جاتی ہیں، اور gate-relevant skip 9 کے ساتھ exit کرتا ہے۔ ایک --badge آپشن shields.io endpoint JSON artifact بناتا ہے۔ ایک ساتھی GitHub Action install، sync، gate، اور baseline diffing کو پیک کرتا ہے۔ دیگر صلاحیتیں Retraction checking DOIs کو Crossref کے Retraction Watch ڈیٹا کے خلاف جانچتی ہے، جس میں retractions، expressions of concern، اور corrections شامل ہیں۔ Collection gap analysis ان کثرت سے حوالہ دی گئی papers کی درجہ بندی کرتی ہے جو لائبریری میں موجود نہیں۔ Bibliography checking LaTeX یا pandoc citations کو parse کرتی ہے اور unknown یا ambiguous keys کو flag کرتی ہے۔ Tag auditing case اور variant duplicates کو ready-to-run merge کمانڈز کے ساتھ گروپ کرتی ہے۔ Library statistics، item audits، duplicate detection، اور citekey conflict detection شامل ہیں۔ پڑھائی اور ترکیب کی خصوصیات میں LLM handoff کے لیے bounded summarize bundles (zotio خود کسی model کو کال نہیں کرتا)، annotation export اور search، reading-list lifecycle، note templates، deep links، اور shareable SVG cards کے ساتھ year-in-review شامل ہیں۔ Enrichment بیرونی providers سے گمشدہ DOIs، abstracts، اور citation fields بھرتی ہے اور open-access PDFs منسلک کرتی ہے، Extra field میں provenance درج کرتی ہے۔ Preprint checking arXiv records کو published journal DOIs میں upgrade کرتی ہے۔ Export کے اختیارات میں CSL-JSON، BibTeX، BibLaTeX، RIS، اور content lockfile کے ساتھ resumable JSONL snapshot شامل ہیں۔ Sync، watch، اور tail mirror کو تازہ رکھتے ہیں، اور schema drift Zotero upgrades کے بعد تبدیلیاں detect کرتا ہے۔ Import اور vault workflows Bulk import scan، resolve، اور apply مراحل سے گزرتی ہے جس میں editable JSON manifest انسانی جائزے کا checkpoint ہوتا ہے۔ Vault sync Obsidian یا Logseq vault کو Zotero کے ساتھ دونوں سمتوں میں ہم آہنگ رکھتی ہے، ایک managed region اور ایک user prose region استعمال کرتے ہوئے، fast-forward-only write-back اور خاموش merges کے بجائے قابلِ جائزہ conflict artifacts کے ساتھ۔ Agent انضمام ایک --agent flag JSON، compact، non-interactive output فراہم کرتا ہے۔ ایک capabilities کمانڈ کمانڈز کی registry ظاہر کرتی ہے جس میں operation، data sources، write target، destructiveness، اور preconditions کے tags ہوتے ہیں۔ ایک agent-context کمانڈ CLI کو بیان کرتی ہے، ایک which کمانڈ natural-language queries کو کمانڈز میں حل کرتی ہے، اور envelopes اور exit codes مستحکم contracts کے طور پر دستاویزی ہیں۔ CLI کے ساتھ ایک MCP server binary بھی تقسیم کیا جاتا ہے۔ تقسیم Installation macOS اور Linux پر Homebrew کے ذریعے، deb، rpm، اور apk کے لیے GitHub release packages، اور Windows پر WinGet یا Scoop کے ذریعے دستیاب ہے۔ CLI، ایک agent skill، اور MCP server آزادانہ طور پر install کیے جا سکتے ہیں۔ پروجیکٹ MIT licensed ہے اور Go میں لکھا گیا ہے۔