تفسیرگر یک ویژگی [[معرفی Obsidian Web Clipper|Web Clipper]] است که به شما امکان میدهد با استفاده از زبان طبیعی با صفحات وب تعامل کنید. تفسیرگر به شما کمک میکند دادههایی را که میخواهید در Obsidian ذخیره کنید، ضبط و ویرایش نمایید. برای نمونه:
- استخراج قطعات متنی خاص.
- خلاصهسازی یا توضیح اطلاعات.
- تبدیل متن از یک قالب به قالب دیگر.
- ترجمه متن به زبان دیگر.
تفسیرگر از مدلهای زبانی برای پردازش اطلاعات یک صفحه وب استفاده میکند و نتایج را با استفاده از [[متغیرها]] که میتوانید به [[Obsidian Web Clipper/الگوها|الگوهای Web Clipper]] خود اضافه کنید، برمیگرداند.
<div style="padding:62.29% 0 0 0;position:relative;"><div class="interface" style="height:100%;left:0;position:absolute;top:0;width:100%;"><iframe src="https://fast.wistia.net/embed/iframe/8j5qu8twj1?web_component=true&seo=false" title="2026-04-22 Video" allow="autoplay; fullscreen" allowtransparency="true" frameborder="0" scrolling="no" class="wistia_embed" name="wistia_embed" width="100%" height="100%"></iframe></div></div>
## نمونههایی از دستورات
دستورات از [[متغیرها|سینتکس متغیر]] `{{"دستور شما"}}` استفاده میکنند. میتوانید از این سینتکس با هر پرسوجوی زبان طبیعی استفاده کنید، مثلاً:
- `{{"a summary of the page"}}` برای استخراج خلاصهای از صفحه.
- `{{"a three bullet point summary, translated to French"}}` برای استخراج نقاط کلیدی صفحه و ترجمه آنها به فرانسوی.
- `{{"un resumé de la page en trois points"}}` برای استخراج سه نقطه کلیدی با دستوری به زبان فرانسوی.
خروجی دستورات شما میتواند با استفاده از [[پالایهها]] بیشتر دستکاری شود. پالایهها پس از دریافت پاسخ از مدل پردازش میشوند. برای نمونه: `{{"a summary of the page"|blockquote}}` پاسخ را به نقلقول بلوکی تبدیل میکند.
## شروع کار
تفسیرگر تقریباً با هر ارائهدهنده مدل زبانی کار میکند، از جمله گزینههایی که بهصورت خصوصی روی دستگاه شما اجرا میشوند. برای راهاندازی تفسیرگر:
1. به بخش **تفسیرگر** در تنظیمات Web Clipper بروید.
2. **فعالسازی مفسر** را روشن کنید.
3. ارائهدهنده و مدل خود را پیکربندی کنید، بخش [[تفسیر صفحات وب#مدلها|مدلها]] را در زیر ببینید.
4. [[متغیرها|متغیرهای دستور]] را به [[Obsidian Web Clipper/الگوها|الگوها]]ی خود اضافه کنید.
5. اگر الگوی شما شامل متغیرهای دستور باشد، بخش تفسیرگر هنگام [[برش صفحات وب|برش یک صفحه]] نمایش داده میشود. روی **تفسیر** کلیک کنید تا متغیرهای دستور پردازش شوند.
## نحوه کار
وقتی تفسیرگر فعال باشد *و* الگوی شما شامل [[متغیرها#متغیرهای دستور|متغیرهای دستور]] باشد، بخش جدید تفسیرگر در پنجره افزونه، بالای دکمه **به ابسیدین اضافه کنید** نمایش داده میشود. این بخش به شما امکان میدهد یک مدل انتخاب کنید و تفسیرگر را برای صفحه فعلی اجرا نمایید.
وقتی روی **تفسیر** کلیک میکنید، تفسیرگر زمینه صفحه را به همراه *تمام* دستورات الگوی شما در یک درخواست به مدل انتخابشده ارسال میکند. بسته به ارائهدهنده مدلی که انتخاب میکنید، این میتواند یک فراخوانی خارجی یا محلی روی دستگاه شما باشد. مدل دستورات شما را با توجه به زمینه صفحه ارزیابی میکند و پاسخها را برمیگرداند. سپس تفسیرگر متغیرهای دستور را با دادههای پاسخ جایگزین میکند.
کل فرآیند بسته به مدلی که استفاده میکنید و حجم دادهای که پردازش مینمایید، میتواند از چند میلیثانیه تا بیش از ۳۰ ثانیه طول بکشد.
## زمینه
اصطلاح *زمینه* به دادههای صفحهای اشاره دارد که تفسیرگر برای پردازش دستورات از آن استفاده میکند. هرچه زمینه کوچکتر باشد، تفسیرگر سریعتر اجرا میشود.
بهطور پیشفرض، تفسیرگر از کل HTML صفحه بهعنوان زمینه استفاده میکند، اما این میتواند دستورات را کندتر و پرهزینهتر از حد لازم کند.
میتوانید زمینه پیشفرض را در **تنظیمات پیشرفته** تفسیرگر بازنویسی کنید و زمینه را به ازای هر [[Obsidian Web Clipper/الگوها|الگو]] تعریف نمایید.
برای تعریف زمینهای هدفمندتر، از [[متغیرها#متغیرهای انتخابگر|متغیرهای انتخابگر]] (یا انواع دیگر متغیرها) برای تفسیر بخشی از صفحه استفاده کنید. برای نمونه، میتوانید از متغیر انتخابگر زیر در زمینه تفسیرگر الگوی خود استفاده کنید:
```
{{selectorHtml:#main}}
```
این فقط تفسیرگر را روی عنصر `#main` یک صفحه وب اجرا میکند، اگر وجود داشته باشد. [[پالایهها#پردازش HTML|پالایههای پردازش HTML]] مانند `remove_html`، `strip_tags` و `strip_attr` میتوانند برای کاهش بیشتر طول زمینه و افزایش سرعت پردازش مفید باشند.
## مدلها
> [!warning] حریم خصوصی
> با استفاده از ارائهدهنده مدل شخص ثالث، شما با شرایط و سیاست حریم خصوصی آنها موافقت میکنید. درخواستهای تفسیرگر مستقیماً به ارائهدهندهای که انتخاب میکنید ارسال میشوند. Obsidian هیچ دادهای درباره درخواستهای شما جمعآوری یا ذخیره نمیکند.
### ارائهدهندگان پیش تنظیم شده
تفسیرگر شامل چندین ارائهدهنده پیش تنظیم شده است. برای استفاده از این ارائهدهندگان به یک کلید API نیاز دارید که میتوانید با ورود به حساب ارائهدهنده خود دریافت کنید. همچنین باید تصمیم بگیرید از کدام مدل(ها) استفاده کنید.
| ارائهدهنده | کلید API | مدلها |
| ------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Anthropic | [کلید API](https://console.anthropic.com/settings/keys) | [مدلها](https://docs.anthropic.com/en/docs/about-claude/models) |
| Azure OpenAI | [کلید API](https://oai.azure.com/portal/) | [مدلها](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models) |
| DeepSeek | [کلید API](https://platform.deepseek.com/api_keys) | [مدلها](https://api-docs.deepseek.com/quick_start/pricing) |
| Google Gemini | [کلید API](https://aistudio.google.com/apikey) | [مدلها](https://ai.google.dev/gemini-api/docs/models/gemini) |
| Hugging Face | [کلید API](https://huggingface.co/settings/tokens) | [مدلها](https://huggingface.co/models?pipeline_tag=text-generation&sort=trending) |
| Meta | [کلید API](https://llama.developer.meta.com) | [مدلها](https://llama.developer.meta.com/docs/models) |
| Ollama | ندارد | [مدلها](https://ollama.com/search) |
| OpenAI | [کلید API](https://platform.openai.com/api-keys) | [مدلها](https://platform.openai.com/docs/models) |
| OpenRouter | [کلید API](https://openrouter.ai/settings/keys) | [مدلها](https://openrouter.ai/models) |
| Perplexity | [کلید API](https://www.perplexity.ai/settings/api) | [مدلها](https://docs.perplexity.ai/guides/model-cards) |
| xAI Grok | [کلید API](https://console.x.ai/team/default/api-keys) | [مدلها](https://docs.x.ai/docs/models) |
### انتخاب مدل
بهطور کلی توصیه میکنیم از مدلهای کوچک با Web Clipper استفاده کنید زیرا سریعتر هستند و برای این کار عملکرد نسبتاً دقیقی دارند. نمونههایی از مدلهای کوچکتر شامل **Claude Haiku از Anthropic**، **Google Gemini Flash**، **Llama** با پارامترهای 3B یا 8B، یا سری مدلهای **Mini از OpenAI** هستند.
### ارائهدهندگان و مدلهای سفارشی
برای افزودن ارائهدهنده و/یا مدل سفارشی به **[[تنظیمات]]** Web Clipper → **تفسیرگر** بروید:
- **افزودن ارائه دهنده** برای پیکربندی ارائهدهندگان پیش تنظیم شده و سفارشی.
- **افزودن مدل** برای پیکربندی مدلهای پیش تنظیم شده و سفارشی.
هنگام افزودن ارائهدهنده سفارشی، توصیه میکنیم از نقطه پایانی chat completions آنها برای **URL پایه** استفاده کنید — معمولاً با `/chat/completions` تمام میشود.
### مدلهای محلی
تفسیرگر میتواند از مدلهای محلی استفاده کند که حریم خصوصی بیشتر و سازگاری آفلاین را ارائه میدهند. چندین گزینه برای اجرای مدلهای محلی وجود دارد. یکی از آسانترینها برای پیکربندی، Ollama است.
#### Ollama
[Ollama](https://ollama.com/) به شما امکان میدهد مدلهای زبانی را بهصورت محلی و خصوصی روی دستگاه خود اجرا کنید.
پس از بارگیری و نصب Ollama، با استفاده از **افزودن ارائه دهنده** در تنظیمات تفسیرگر، Ollama را اضافه کنید. Ollama به کلید API نیاز ندارد. سپس از [فهرست مدلها](https://ollama.com/search) یک مدل انتخاب کنید. برای نمونه اگر میخواهید از [Llama 3.2](https://ollama.com/library/llama3.2) استفاده کنید، روی **افزودن مدل** کلیک کنید، سپس:
- **ارائهدهنده:** Ollama
- **نام نمایشی:** Llama 3.2، این مقدار قابل سفارشیسازی است.
- **شناسه مدل:** `llama3.2`، این باید دقیقاً با شناسه مدل از Ollama مطابقت داشته باشد.
**راهاندازی سرور Ollama**
برای اجازه دادن به یک افزونه مرورگر برای تعامل با Ollama، باید هنگام اجرای سرور [به آن دستور صریح بدهید](https://github.com/ollama/ollama/issues/2308)، در غیر این صورت خطای `403` خواهید دید.
اپلیکیشن Ollama را ببندید و دستور زیر را در ترمینال خود اجرا کنید. اگر از Chrome یا Firefox استفاده نمیکنید، پروتکل را به پروتکل افزونه مرورگر خود تغییر دهید.
```
OLLAMA_ORIGINS=moz-extension://*,chrome-extension://*,safari-web-extension://* ollama serve
```
سپس مدل خود را با Ollama به روش معمول اجرا کنید، مثلاً:
```
ollama run llama3.2
```
**طول زمینه**
پنجره زمینه Ollama بهطور پیشفرض ۲۰۴۸ توکن است. این حداکثر تعداد توکنها برای پیام و پاسخ است. هنگام برش یک صفحه وب طولانی میتوانید بهراحتی از این حد فراتر بروید. Ollama بدون هشدار با شکست مواجه شده و نتایج نامربوط برمیگرداند. برخی گزینهها:
- پارامتر `num_ctx` Ollama را افزایش دهید. توجه داشته باشید که زمینه طولانیتر به حافظه بیشتری نیاز دارد.
- از فیلد [[#زمینه]] در الگوی خود برای ارائه بخش هدفمندتری از صفحه استفاده کنید، یا زمینه را با استفاده از [[پالایهها|پالایه]] کوتاه کنید، مثلاً `{{content|slice:0,1000}}`.