SiYuan (یادداشت سی‌یوان) با QCode: آموزش تصویری ویندوز ۱۱، یک قدم یک تصویر

با ۱۳ قدم و ۱۳ تصویر، SiYuan نسخه v3.8.11 را در ویندوز ۱۱ نصب کنید، در «هوش مصنوعی» داخلی آن به QCode وصل شوید، gpt-6.2-sol را پیکربندی کنید و نوشتن با AI و گفت‌وگو با Agent را کامل کنید.

به‌روزرسانی 2026-11-23

به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←

در این صفحه

۱۳ قدم زیر را دنبال کنید تا SiYuan را در ویندوز ۱۱ نصب کنید و در «هوش مصنوعی» داخلی آن به QCode وصل شوید؛ بعد مستقیم در متن یادداشت با AI محتوا بنویسید و در نوار کناری با Agent چندمدلی گفت‌وگو کنید.

پاسخ کوتاه: در SiYuan v3.8.11 روی منوی اصلی بالا-چپ → «تنظیمات» (设置) → «هوش مصنوعی» (人工智能) → «+ افزودن ارائه‌دهنده» (+ 添加提供商) کلیک کنید، پیش‌فرض «OpenAI» را انتخاب کنید، «نشانی پایه API» (API 基础地址) را https://api.qcode.cc/openai/v1 بگذارید، «نوع API» (API 类型) را از Responses پیش‌فرض به Chat Completions تغییر دهید، کلید QCode که با cr_ شروع می‌شود را بچسبانید و gpt-6.2-sol را پیکربندی کنید تا «نوشتن با AI» (AI 编写) و «Agent» (智能体) داخلی قابل استفاده باشند.

مورد مقدار
محل پیکربندی تنظیمات → هوش مصنوعی → ارائه‌دهنده API → OpenAI
نشانی پایه API https://api.qcode.cc/openai/v1
نوع API Chat Completions
API Key cr_xxxxxxxx
مدل پیشنهادی پیش‌فرض gpt-6.2-sol

بررسی‌شده در 2026-11-22 · SiYuan v3.8.11 · ویندوز ۱۱

SiYuan (یادداشت سی‌یوان) نرم‌افزاری برای مدیریت دانش شخصی با اولویت محلی است که از ارجاع در سطح بلوک، پیوند دوطرفه و ویرایش درختی پشتیبانی می‌کند. نسخه فعلی «هوش مصنوعی» و «Agent» (智能体) را به‌صورت بومی و در نوار کناری دارد؛ استفاده محلی نه به نصب افزونه شخص ثالث نیاز دارد و نه به ورود با حساب SiYuan یا حساب OpenAI.

  • سیستم‌های مناسب: ویندوز ۱۰ / ۱۱ (۶۴ بیتی)
  • نسخه نرم‌افزار: SiYuan (یادداشت سی‌یوان) v3.8.11
  • تصویرها به‌روزرسانی شده در: 2026-11
  • زمان تقریبی: ۱۰ دقیقه
  • چیزهایی که لازم دارید: یک کلید API QCode که با cr_ شروع می‌شود
  • رایانه ویندوز ۱۰ / ۱۱ است (۶۴ بیتی؛ روی رایانه ARM64 باید بسته نصب win-arm64.exe را انتخاب کنید)
  • از قبل در QCode.cc ثبت‌نام کرده‌اید و کلید API که با cr_ شروع می‌شود را از داشبورد کپی کرده‌اید. هنوز حساب ندارید؟ ابتدا ثبت‌نام QCode کنید، در صفحه قیمت‌ها یک پلن انتخاب کنید و سپس در داشبورد کلید بسازید.
  • رایانه می‌تواند b3log.org (یا github.com / Microsoft Store) و همچنین api.qcode.cc را به‌درستی باز کند
  • روی دیسک محلی یک پوشه معمولی به‌عنوان فضای کاری آماده دارید (مثلاً C:\SiYuanWorkspace)؛ پوشه‌های درایو همگام‌سازی مانند OneDrive، iCloud یا 坚果云 را انتخاب نکنید
  • یادداشت‌های محلی و AI داخلی به ورود با حساب SiYuan نیاز ندارند؛ حدود ۱۰ دقیقه وقت بگذارید و قدم‌ها را دنبال کنید

دانلود و نصب

SiYuan در ویندوز دو راه نصب دارد: بسته نصب مستقل رسمی و Microsoft Store. کانال‌های رسمی این‌ها هستند:

  • صفحه دانلود رسمی: b3log.org/siyuan/download.html (دو ورودی مستقیم «بسته نصب x86_64» و «Microsoft Store» دارد)
  • Microsoft Store: صفحه SiYuan در Microsoft Store (استفاده از نسخه دسکتاپ توصیه رسمی است و به‌روزرسانی یک‌کلیکی دارد)
  • GitHub Releases: siyuan-note/siyuan Releases (روی رایانه ۶۴ بیتی siyuan-3.8.11-win.exe و روی رایانه ARM64 siyuan-3.8.11-win-arm64.exe را بگیرید؛ شماره نسخه در نام فایل با به‌روزرسانی‌ها تغییر می‌کند؛ بسته‌های .apk، .dmg یا linux را دانلود نکنید)

سرعت دانلود در منطقه‌های مختلف کمی متفاوت است؛ ابتدا منطقه خود را انتخاب کنید:

  • ترجیحاً از Microsoft Store نصب کنید؛ به‌روزرسانی‌های بعدی راحت‌ترین راه است.
  • اگر نصب‌کننده آفلاین می‌خواهید، از GitHub Releases یا صفحه دانلود رسمی فایل siyuan-3.8.11-win.exe را بگیرید (روی رایانه ARM64 siyuan-3.8.11-win-arm64.exe).
  • ترجیحاً صفحه دانلود رسمی b3log.org/siyuan/download.html را باز کنید و مستقیم روی «بسته نصب x86_64» بزنید تا siyuan-3.8.11-win.exe دانلود شود (حدود ۲۳۰ مگابایت، اتصال مستقیم سریع است).
  • می‌توانید در Microsoft Store داخلی ویندوز عبارت SiYuan را جست‌وجو و نصب کنید تا بعداً با یک کلیک ارتقا دهید.
  • بسته نصب امضای دیجیتال معتبر دارد و پیش‌فرض «فقط برای من نصب شود» است؛ در حالت عادی پنجره دسترسی مدیر لازم نمی‌شود.

همراه تصویرها: ویندوز، یک قدم یک تصویر

۱۳ قدم زیر، هر قدم فقط یک کار است؛ شماره‌های نارنجی روی تصویرها و شماره‌های ①②③ در متن یک‌به‌یک با هم می‌خوانند.

دانلود بسته نصب SiYuan

با مرورگر صفحه دانلود رسمی b3log.org/siyuan/download.html را باز کنید. روی دکمه آبی «بسته نصب x86_64 (برای ارتقا باید دوباره دانلود شود)» که ① در وسط صفحه به آن اشاره می‌کند کلیک کنید تا نصب‌کننده ویندوز ۶۴ بیتی دانلود شود (اگر به‌روزرسانی خودکار می‌خواهید، می‌توانید «Microsoft Store (با ارتقای یک‌کلیکی)» در سمت راست را بزنید).

صفحه دانلود رسمی SiYuan باز است؛ روی «بسته نصب x86_64» کلیک کنید تا نصب‌کننده ویندوز x64 (v3.8.11) دانلود شود

اگر درست پیش بروید این را می‌بینید: مرورگر دانلود siyuan-3.8.11-win.exe (حدود ۲۳۰ مگابایت) را شروع می‌کند و پس از پایان آن را در پوشه «下载» (دانلودها) پیدا می‌کنید.

اجرای جادوگر نصب و کامل کردن نصب

روی siyuan-3.8.11-win.exe که تازه دانلود کرده‌اید دوبار کلیک کنید تا جادوگر نصب اجرا شود. ابتدا در صفحه مجوز «我同意 (I)» (موافقم) را بزنید، سپس در صفحه گزینه‌های نصب همان پیش‌فرض «فقط برای من نصب شود» را نگه دارید (دسترسی مدیر لازم نیست) و «下一步 (N) >» (بعدی) را بزنید. در صفحه «انتخاب محل نصب» مطمئن شوید مسیر پوشه مقصد در ① درست است و روی «安装 (I)» (نصب) که ② در پایین-راست به آن اشاره می‌کند کلیک کنید؛ پس از پایان تیک «运行 SiYuan (R)» (اجرای SiYuan) را نگه دارید و «完成 (F)» (پایان) را بزنید.

صفحه «انتخاب محل نصب» در جادوگر نصب SiYuan؛ مسیر پیش‌فرض نصب برای کاربر را تأیید کنید و «نصب» را بزنید

اگر درست پیش بروید این را می‌بینید: نوار پیشرفت نصب کامل می‌شود و «در حال کامل کردن جادوگر نصب SiYuan» ظاهر می‌شود؛ پس از زدن «پایان» SiYuan خودکار اجرا می‌شود.

گیر کرده‌اید؟ هشدار امنیتی می‌آید یا می‌خواهید محل نصب را عوض کنید

بسته نصب رسمی SiYuan امضای دیجیتال معتبر دارد و معمولاً جلوی آن گرفته نمی‌شود. اگر ویندوز «Windows 已保护你的电脑» (ویندوز از رایانه شما محافظت کرد) را نشان داد، «更多信息» (اطلاعات بیشتر) و بعد «仍要运行» (باز هم اجرا کن) را بزنید. بهتر است مسیر نصب همان پوشه محلی پیش‌فرض بماند؛ آن را داخل درایوهای همگام‌سازی مثل OneDrive نصب نکنید.

نخستین اجرا و انتخاب فضای کاری محلی

در نخستین اجرا SiYuan یک صفحه تمام‌صفحه راهنمای فضای کاری نشان می‌دهد. روی دکمه «انتخاب» (选择) سمت راست «فضای کاری» (工作空间) که ① به آن اشاره می‌کند کلیک کنید، در پنجره ویندوزی «انتخاب پوشه» (选择文件夹) یک پوشه کاملاً محلی انتخاب کنید (مثلاً C:\SiYuanWorkspace را بسازید و انتخاب کنید)، سپس در پنجره هشدار درباره درایو همگام‌سازی «تأیید» (确定) را بزنید تا مقداردهی اولیه انجام شود و به رابط اصلی بروید.

در نخستین اجرا SiYuan صفحه راهنمای فضای کاری را نشان می‌دهد؛ روی «انتخاب» سمت راست «فضای کاری» بزنید و یک پوشه محلی تعیین کنید

اگر درست پیش بروید این را می‌بینید: پس از مقداردهی اولیه به رابط اصلی SiYuan می‌رسید؛ درخت اسناد در سمت چپ و نام فضای کاری انتخاب‌شده در بالا-چپ نوار عنوان دیده می‌شود. اگر بار اول پرسش فایروال، یادآوری استثنا در Defender در بالا-راست یا پنجره شناور «به SiYuan خوش آمدید» در پایین-راست آمد، آن را ببندید یا «نادیده گرفتن» (忽略) را بزنید و ادامه دهید.

گیر کرده‌اید؟ چرا فضای کاری را نباید در OneDrive یا 坚果云 بگذارم؟

SiYuan در فضای کاری به‌طور پرتکرار پایگاه‌داده و ایندکس محلی را می‌خواند و می‌نویسد؛ گذاشتن آن در درایوهای همگام‌سازی شخص ثالث مثل OneDrive، iCloud یا 坚果云 به‌راحتی باعث تضاد قفل فایل و خرابی داده می‌شود. حتماً یک پوشه معمولی روی دیسک محلی انتخاب کنید. برای تغییر زبان رابط می‌توانید همین حالا در «زبان ظاهر» (外观语言) در همین صفحه راهنما عوض کنید، یا بعداً از «تنظیمات → ظاهر → رابط → زبان» (设置 → 外观 → 界面 → 语言) تنظیم کنید.

باز کردن پنجره «تنظیمات»

پس از ورود به رابط اصلی، روی منوی اصلی بالا-چپ نوار عنوان که ① به آن اشاره می‌کند (نام فضای کاری فعلی را نشان می‌دهد) کلیک کنید و در منوی بازشده روی «تنظیمات» (设置) که ② به آن اشاره می‌کند بزنید (کلید میان‌بر Alt+P؛ می‌توانید مستقیم هم Alt+P را روی صفحه‌کلید بزنید). SiYuan پیکربندی AI را به‌صورت بومی دارد و لازم نیست از بازار افزونه‌ها افزونه OpenAI شخص ثالث نصب کنید.

در رابط اصلی SiYuan روی منوی اصلی بالا-چپ بزنید و در منوی بازشده «تنظیمات» (Alt+P) را انتخاب کنید

اگر درست پیش بروید این را می‌بینید: پنجره «تنظیمات» در وسط صفحه باز می‌شود و در سمت چپ یک ستون کامل از دسته‌های تنظیمات دیده می‌شود.

رفتن به صفحه تنظیمات «هوش مصنوعی»

در فهرست دسته‌های سمت چپ پنجره «تنظیمات»، «هوش مصنوعی» (人工智能) را که ① به آن اشاره می‌کند پیدا کنید و روی آن بزنید.

در فهرست دسته‌های سمت چپ پنجره تنظیمات روی «هوش مصنوعی» بزنید

اگر درست پیش بروید این را می‌بینید: سمت راست به صفحه تنظیمات «هوش مصنوعی» تغییر می‌کند و در بالای آن بخش «ارائه‌دهنده API» (API 提供商) ظاهر می‌شود.

کلیک روی «+ افزودن ارائه‌دهنده»

مطمئن شوید در سمت چپ دسته «هوش مصنوعی» در ① انتخاب شده است، سپس روی دکمه «+ افزودن ارائه‌دهنده» (+ 添加提供商) که ② در بالا-راست بخش «ارائه‌دهنده API» به آن اشاره می‌کند کلیک کنید.

در بخش «هوش مصنوعی → ارائه‌دهنده API» در بالا-راست روی «+ افزودن ارائه‌دهنده» بزنید

اگر درست پیش بروید این را می‌بینید: سمت راست به فهرست کارت‌های پیش‌فرض «ارائه‌دهنده API» تغییر می‌کند و عنوان بالای آن «ارائه‌دهندگان رسمی» (官方服务商) است.

انتخاب کارت پیش‌فرض «OpenAI»

در فهرست دوستونی کارت‌های «ارائه‌دهندگان رسمی»، روی کارت «OpenAI» که ① در بالا-چپ به آن اشاره می‌کند کلیک کنید. دقت کنید همان «OpenAI» را انتخاب کنید که در سمت چپ آن https://api.openai.com/v1 نوشته شده، و اشتباهی روی «ChatGPT (حساب ChatGPT)» که در سمت راست است و ورود با حساب می‌خواهد نزنید.

در فهرست کارت‌های پیش‌فرض «ارائه‌دهنده API» کارت «OpenAI» در بالا-چپ را انتخاب کنید

اگر درست پیش بروید این را می‌بینید: رابط به فرم جزئیات «افزودن ارائه‌دهنده» می‌رود و به‌ترتیب «نام نمایشی سفارشی» (自定义显示名称)، «نشانی پایه API» (API 基础地址)، «نوع API» (API 类型)، «زمان انتظار» (超时时间) و «API Key» را فهرست می‌کند.

پر کردن نشانی QCode، نوع API و کلید

ابتدا «نام نمایشی سفارشی» در بالاترین قسمت را از OpenAI به QCode تغییر دهید (برای شناسایی راحت‌تر)، سپس سه پارامتر کلیدی را به ترتیب شماره‌های تصویر پر کنید:

  • ① «نشانی پایه API»: محتوای پیش‌فرض را پاک کنید و https://api.qcode.cc/openai/v1 را بگذارید (در پایان /chat/completions یا اسلش اضافه ننویسید)؛
  • ② «نوع API»: فهرست کشویی را باز کنید و حتماً Responses پیش‌فرض را به Chat Completions تغییر دهید؛
  • ③ «API Key»: کلیدی که با cr_ شروع می‌شود و در داشبورد QCode کپی کرده‌اید بچسبانید (مثلاً cr_xxxxxxxx؛ می‌توانید با آیکون چشم کوچک سمت راست بررسی کنید که فاصله اضافی کپی نشده باشد).

«زمان انتظار» را همان پیش‌فرض 120 بگذارید؛ لازم نیست تغییر کند.

نام نمایشی سفارشی QCode، نشانی پایه API برابر https://api.qcode.cc/openai/v1، تغییر «نوع API» به Chat Completions و وارد کردن API Key QCode

اگر درست پیش بروید این را می‌بینید: «نشانی پایه API» مقدار https://api.qcode.cc/openai/v1 را نشان می‌دهد، «نوع API» روی Chat Completions است و کادر «API Key» با نقطه‌های پوشانده پر شده است.

به کلید API نیاز دارید؟

اگر هنوز حساب QCode ندارید، ابتدا ثبت‌نام QCode کنید. اگر می‌خواهید به‌ازای مصرف پرداخت کنید، ابتدا یک بسته پرداخت به‌ازای مصرف بخرید و سپس در داشبورد کلید بسازید. آن رشته کامل را که با cr_ شروع می‌شود کپی کنید و در کادر «API Key» بالا بچسبانید. می‌توانید با کارت اعتباری / نقدی (Visa / Mastercard)، یا Apple Pay / Google Pay، یا رمزارز پرداخت کنید — به روش‌های پرداخت مراجعه کنید.

به‌روزرسانی مدل‌های موجود، آزمایش اتصال و ذخیره

لازم نیست از این پنجره بیرون بروید؛ به بخش «تنظیمات مدل» (模型设置) پایین اسکرول کنید:

  • روی «به‌روزرسانی مدل‌های موجود» (刷新可用模型) که ① به آن اشاره می‌کند کلیک کنید تا SiYuan فهرست مدل‌های قابل استفاده را از QCode بگیرد و خودکار یک ردیف پیکربندی مدل اضافه کند؛
  • در کادر «مدل را وارد یا انتخاب کنید» (请输入或选择模型) که ② به آن اشاره می‌کند مدل پیشنهادی gpt-6.2-sol را بنویسید (اگر می‌خواهید یک مدل سبک چینی هم اضافه کنید، کنار آن «+ افزودن مدل» (+ 添加模型) را بزنید و در ردیف تازه deepseek-v4.1-flash را وارد کنید)؛
  • روی «آزمایش اتصال» (测试连接) سمت راست ردیف مدل بزنید؛ وقتی پیام «اتصال موفق بود» (连接成功) در بالا-راست ظاهر شد، برای ذخیره پیکربندی روی «تأیید» (确定) که ③ در پایین-راست به آن اشاره می‌کند کلیک کنید.

روی «به‌روزرسانی مدل‌های موجود» بزنید تا فهرست بیاید، gpt-6.2-sol و deepseek-v4.1-flash را پیکربندی و اتصال را آزمایش کنید و سپس «تأیید» را بزنید

اگر درست پیش بروید این را می‌بینید: پس از زدن «آزمایش اتصال» در بالا-راست پیام «اتصال موفق بود» می‌آید و پس از «تأیید» به صفحه تنظیمات «هوش مصنوعی» برمی‌گردید.

گیر کرده‌اید؟ «به‌روزرسانی مدل‌های موجود» شکست می‌خورد یا «آزمایش اتصال» خطا می‌دهد

سه چیز را به ترتیب بررسی کنید: ۱) آیا «نوع API» به Chat Completions تغییر کرده است (پیش‌فرض Responses شکست می‌خورد)؛ ۲) آیا «نشانی پایه API» دقیقاً https://api.qcode.cc/openai/v1 است؛ ۳) آیا در ابتدا یا انتهای کلید فاصله یا گیومه اضافه شده است. اگر گرفتن فهرست مدل‌ها موقتاً شکست خورد، می‌توانید مستقیم «+ افزودن مدل» را بزنید و gpt-6.2-sol را دستی وارد کنید و بعد «آزمایش اتصال» را بزنید.

بررسی کلید فعال‌سازی ارائه‌دهنده و مدل پیش‌فرض

پس از ذخیره و برگشت به صفحه تنظیمات «هوش مصنوعی»، سه وضعیت را بررسی کنید:

  • کلید «فعال‌سازی» (启用) سمت راست کارت QCode در ① روشن باشد و زیر کارت https://api.qcode.cc/openai/v1 و تعداد مدل‌های پیکربندی‌شده دیده شود؛
  • «ویرایشگر → مدل پیش‌فرض» (编辑器 → 默认模型) در ② روی gpt-6.2-sol باشد؛
  • «Agent → مدل پیش‌فرض» (智能体 → 默认模型) در ③ هم روی gpt-6.2-sol باشد.

اگر مدل پیش‌فرض خالی است یا می‌خواهید مدل دیگری از مدل‌های اضافه‌شده را بگذارید، مستقیم فهرست کشویی را باز کنید و عوض کنید. پس از بررسی، با کلید Esc پنجره تنظیمات را ببندید.

پس از ذخیره به صفحه تنظیمات «هوش مصنوعی» برگردید و مطمئن شوید کلید QCode فعال است و مدل پیش‌فرض «ویرایشگر» و «Agent» هر دو gpt-6.2-sol است

اگر درست پیش بروید این را می‌بینید: کلید کارت QCode روشن است و مدل پیش‌فرض در «ویرایشگر» و «Agent» هر دو gpt-6.2-sol را نشان می‌دهند.

تولید متن با «نوشتن با AI» در ویرایشگر

به هر یادداشتی برگردید، در یک خط خالی با صفحه‌کلید / را بزنید تا منوی فرمان اسلش باز شود و «نوشتن با AI» (AI 编写) را انتخاب کنید. در کادر بازشده خواسته خود را بنویسید (مثلاً بخواهید یک موضوع را در دو جمله خلاصه کند) و «تأیید» (确定) را بزنید. چند ثانیه بعد کارت پیش‌نمایش داخل یادداشت ظاهر می‌شود: ① نشان می‌دهد نتیجه همین حالا با gpt-6.2-sol تولید شده و با کلیک روی «در همین جای اصلی درج شود» (在原位置插入) که ② در پایین-راست به آن اشاره می‌کند محتوا مستقیم در نوشته درج می‌شود.

در یادداشت / را بزنید و «نوشتن با AI» را انتخاب کنید؛ پس از تولید محتوا با gpt-6.2-sol روی «در همین جای اصلی درج شود» بزنید تا در سند نوشته شود

اگر درست پیش بروید این را می‌بینید: کارت پیش‌نمایش محتوای کامل را نشان می‌دهد و با زدن «در همین جای اصلی درج شود» محتوا بی‌درنگ در پاراگراف فعلی نوشته می‌شود.

گیر کرده‌اید؟ با زدن / منو باز نمی‌شود یا «نوشتن با AI» کار نمی‌کند

منوی اسلش باید با صفحه‌کلید و در حالت ورودی انگلیسی با زدن مستقیم / باز شود؛ کپی و چسباندن / منو را باز نمی‌کند. اگر در منو «نوشتن با AI» پیدا نمی‌شود یا پیام می‌دهد مدل پیکربندی نشده است، به «تنظیمات → هوش مصنوعی» برگردید و مطمئن شوید کلید فعال‌سازی QCode روشن است و «ویرایشگر → مدل پیش‌فرض» خالی نیست.

گفت‌وگو در «Agent» سمت راست و تغییر مدل

روی آیکون «Agent» (智能体) که ① در بالاترین قسمت نوار کناری سمت راست پنجره به آن اشاره می‌کند کلیک کنید تا پنل گفت‌وگوی کناری باز شود. در کادر پایین یک پیام آزمایشی بنویسید و ارسال را بزنید (یا Ctrl+Enter)؛ کمی بعد پاسخ درست را در ② می‌بینید. اگر قبلاً چند مدل اضافه کرده‌اید، روی دکمه نام مدل که ③ در پایین-راست کادر ورودی به آن اشاره می‌کند کلیک کنید (مثلاً از gpt-6.2-sol به deepseek-v4.1-flash بروید) تا بدون بیرون رفتن از گفت‌وگو، هر وقت خواستید مدل را عوض کنید و پرسش را ادامه دهید (در تصویر پس از تغییر، فرمان آزمایشی فرستاده شد و بی‌درنگ PONG آمد).

روی آیکون «Agent» در نوار کناری سمت راست بزنید و گفت‌وگو کنید؛ مدل را در پایین-راست کادر ورودی به deepseek-v4.1-flash عوض کنید تا پاسخ PONG بیاید

اگر درست پیش بروید این را می‌بینید: پنل «Agent» سمت راست پاسخ را درست برمی‌گرداند و با زدن دکمه مدل در پایین-راست می‌توانید راحت به مدل‌های اضافه‌شده دیگر سوییچ کنید و پاسخ بگیرید.

دیدن شماره نسخه در «تنظیمات → درباره» (اختیاری)

اگر بعداً برای رفع اشکال یا بررسی جای قابلیت‌ها لازم شد نسخه را بدانید، منوی اصلی بالا-چپ → «تنظیمات» (یا Alt+P) را باز کنید و در سمت چپ روی پایین‌ترین مورد «درباره» (关于) بزنید تا شماره نسخه فعلی SiYuan در ① دیده شود (در تصویر: 当前版本 v3.8.11 یعنی نسخه فعلی v3.8.11). پس از بستن و باز کردن دوباره SiYuan، ارائه‌دهنده QCode و مدل پیش‌فرضی که تنظیم کرده‌اید کامل باقی می‌مانند.

به «تنظیمات → درباره» بروید و نسخه نصب‌شده فعلی SiYuan را ببینید (در تصویر نسخه فعلی v3.8.11 است)

اگر درست پیش بروید این را می‌بینید: صفحه «درباره» شماره نسخه فعلی را واضح نشان می‌دهد؛ پس از راه‌اندازی دوباره SiYuan و برگشت به «تنظیمات → هوش مصنوعی»، پیکربندی QCode هنوز در فهرست است.

بررسی موفقیت

اگر این چهار مورد درست باشد، یعنی SiYuan کامل به QCode وصل شده است:

  • در «تنظیمات → هوش مصنوعی» کلید کارت QCode روشن است و https://api.qcode.cc/openai/v1 و تعداد مدل‌های اضافه‌شده را نشان می‌دهد؛
  • «ویرایشگر → مدل پیش‌فرض» و «Agent → مدل پیش‌فرض» هر دو روی gpt-6.2-sol هستند (یا مدل قابل استفاده دیگری که لازم دارید)؛
  • با زدن / → «نوشتن با AI» در متن یادداشت محتوا تولید و درج می‌شود، و «Agent» سمت راست درست پاسخ می‌دهد و می‌توان مدل را عوض کرد؛
  • پس از بستن و راه‌اندازی دوباره SiYuan، ارائه‌دهنده QCode و پیکربندی مدل پیش‌فرض باقی می‌مانند.

تمام شد

SiYuan را در ویندوز ۱۱ نصب کرده‌اید و به QCode وصل کرده‌اید. از این به بعد هر وقت یادداشت می‌نویسید می‌توانید / را بزنید و «نوشتن با AI» را صدا بزنید، یا در پنل «Agent» سمت راست مستقیم گفت‌وگو کنید و مدل را عوض کنید. از اینجا می‌توانید:

خطاهای رایج

متن خطا علت چه کار کنید
Invalid API key کلید خالی، بریده‌شده، دارای فاصله یا گیومه در ابتدا و انتها، یا کلیدی منقضی وارد شده است به داشبورد QCode برگردید و کلید cr_ را کامل دوباره کپی کنید، کادر «API Key» را خالی کنید و دوباره بچسبانید، سپس با «آزمایش اتصال» بررسی کنید
Invalid URL (POST /v1/chat/completions/chat/completions) /chat/completions داخل «نشانی پایه API» نوشته شده و SiYuan خودش مسیر گفت‌وگو را اضافه می‌کند، پس مسیر تکرار می‌شود؛ یا «نوع API» روی Responses پیش‌فرض مانده است «نشانی پایه API» را به https://api.qcode.cc/openai/v1 برگردانید (بدون /chat/completions و بدون اسلش پایانی) و «نوع API» را به Chat Completions تغییر دهید
请确认没有将工作空间设置在第三方同步盘路径下,否则会造成数据损坏……是否继续? تأیید امنیتی که هنگام انتخاب نخستین پوشه فضای کاری می‌آید تا اشتباهی OneDrive، iCloud یا 坚果云 انتخاب نشود پس از مطمئن شدن که پوشه انتخابی یک پوشه معمولی محلی است (مثل C:\SiYuanWorkspace) «تأیید» (确定) را بزنید؛ اگر اشتباهی درایو همگام‌سازی انتخاب شد، به پوشه محلی برگردید
Microsoft Defender 可能会误杀内核、误删数据和严重降低运行性能,建议将思源安装路径和工作空间路径添加到排除列表 یادآوری سیستمی که نخستین بار در بالا-راست رابط اصلی ظاهر می‌شود «نادیده گرفتن» (忽略) را بزنید و پیکربندی QCode را ادامه دهید؛ به اتصال کاری ندارد. اگر بعداً آنتی‌ویروس هسته را بلاک کرد، آن وقت مسیر نصب و فضای کاری را به فهرست استثناها اضافه کنید
是否要允许公共网络和专用网络访问此应用؟ پرسش فایروال Windows Security که نخستین بار هنگام اجرای هسته محلی می‌آید همین‌طور لغو کنید یا پنجره را ببندید؛ روی اجرای هسته محلی و درخواست‌های خروجی به API QCode اثری ندارد

سوالات متداول

پس از انقضای کلید چه کنم؟

دو حالت دارد:

  • کلید پلن شخصی پس از انقضا تمدید نمی‌شود؛ فقط می‌توانید دوباره پلن بگیرید و کلید تازه بسازید.
  • کلید بسته پرداخت به‌ازای مصرف پس از انقضا با خرید یک بسته دیگر خودبه‌خود برمی‌گردد و همان کلید است.

اگر کلید را عوض کردید، «تنظیمات → هوش مصنوعی» را باز کنید، کارت QCode را باز کنید و کلید cr_ تازه را در «API Key» بگذارید و «تأیید» را برای ذخیره بزنید.

آیا باید افزونه OpenAI شخص ثالث نصب کنم یا با حساب SiYuan وارد شوم؟

هیچ‌کدام لازم نیست. SiYuan v3.8.11 «تنظیمات → هوش مصنوعی → ارائه‌دهنده API» و «Agent» در نوار کناری را به‌صورت بومی دارد؛ فضای کاری محلی و AI داخلی بدون ورود کار می‌کنند، نه لازم است از بازار افزونه‌ها افزونه قدیمی OpenAI نصب کنید و نه به حساب رسمی OpenAI نیاز دارید.

چرا باید «نوع API» را از Responses به Chat Completions تغییر دهم؟

«نوع API» پیش‌فرض «OpenAI» در SiYuan همان Responses است، اما نقطه پایانی سازگار با OpenAI در QCode از پروتکل استاندارد Chat Completions استفاده می‌کند. اگر عوض نکنید، هم آزمایش اتصال و هم درخواست‌های گفت‌وگو شکست می‌خورند؛ پس از تغییر به Chat Completions گرفتن فهرست مدل‌ها و گفت‌وگو درست کار می‌کند.

چطور زبان رابط SiYuan را عوض کنم؟

در صفحه راهنمای فضای کاری در نخستین اجرا می‌توانید مستقیم در «زبان ظاهر» (外观语言) انتخاب کنید؛ پس از ورود به رابط اصلی، «تنظیمات → ظاهر → رابط → زبان» (设置 → 外观 → 界面 → 语言) را باز کنید تا هر وقت خواستید بین چینی ساده‌شده و زبان‌های دیگر جابه‌جا شوید.

آیا می‌توانم هم‌زمان در SiYuan از مدل‌های Claude استفاده کنم؟

بله، اما مدل Claude را در نقطه پایانی سازگار با OpenAI نگذارید. نقطه پایانی سازگار با OpenAI در QCode مدل Claude را نمی‌پذیرد؛ باید یک ارائه‌دهنده جداگانه اضافه کنید، «نوع API» را Anthropic Messages و «نشانی پایه API» را https://api.qcode.cc/api بگذارید و همان کلید cr_ و claude-opus-5-5 را وارد کنید (جزئیات در پیکربندی پیشرفته پایین).

مرور سریع اتصال

مورد توضیح
محل پیکربندی منوی اصلی بالا-چپ نوار عنوان → «تنظیمات» (Alt+P) → «هوش مصنوعی» → «ارائه‌دهنده API»
نقطه پایانی سازگار با OpenAI (GPT / مدل‌های چینی) https://api.qcode.cc/openai/v1 (نوع API: Chat Completions)
نقطه پایانی Anthropic (Claude) https://api.qcode.cc/api (نوع API: Anthropic Messages)
قالب API Key cr_xxxxxxxx (همان یک کلید QCode در هر دو پروتکل کار می‌کند)
محل تنظیم مدل پیش‌فرض «تنظیمات → هوش مصنوعی» زیر «ویرایشگر → مدل پیش‌فرض» و «Agent → مدل پیش‌فرض»
ورودی‌های رسمی صفحه دانلود رسمی · مخزن GitHub

پیکربندی پیشرفته: استفاده از مدل‌های Claude و نقاط اتصال دیگر

پیکربندی جداگانه Claude (نقطه پایانی Anthropic)

اگر می‌خواهید در SiYuan مدل‌های سری Claude را صدا بزنید، به «تنظیمات → هوش مصنوعی → ارائه‌دهنده API» برگردید و یک‌بار دیگر «+ افزودن ارائه‌دهنده» را بزنید و پارامترهای زیر را پر کنید:

فیلد مقدار
نام نمایشی سفارشی QCode Claude (قابل تغییر)
نشانی پایه API https://api.qcode.cc/api
نوع API Anthropic Messages
API Key cr_xxxxxxxx (همان کلید QCode)
مدل پیشنهادی claude-opus-5-5 (گزینه سبک: claude-haiku-5-5)

نقاط اتصال دیگر (اختیاری)

اگر اتصال کند است یا زمان انتظار تمام می‌شود، می‌توانید دامنه در «نشانی پایه API» را به نقطه اتصالی نزدیک‌تر تغییر دهید؛ توان هر سه نقطه اتصال کاملاً یکسان است و همان کلید در همه کار می‌کند:

گره سازگار با OpenAI (GPT / مدل‌های چینی) Anthropic (Claude)
جهانی (پیش‌فرض) https://api.qcode.cc/openai/v1 https://api.qcode.cc/api
آسیا (برای سرزمین اصلی چین) https://asia.qcode.cc/openai/v1 https://asia.qcode.cc/api
آمریکای شمالی / اروپا https://us.qcode.cc/openai/v1 https://us.qcode.cc/api

مدل‌های پیشنهادی

نام مدل نوع API و نقطه پایانی متناظر سناریوی مناسب
gpt-6.2-sol Chat Completions · https://api.qcode.cc/openai/v1 پیشنهاد اصلی و پیش‌فرض OpenAI؛ متعادل برای نوشتن، خلاصه‌سازی و گفت‌وگو با Agent
gpt-6.2-astra Chat Completions · https://api.qcode.cc/openai/v1 گزینه سطح بالاتر OpenAI؛ مناسب تحلیل عمیق و سازمان‌دهی متن‌های بلند و پیچیده
claude-opus-5-5 Anthropic Messages · https://api.qcode.cc/api پیشنهاد اصلی و پیش‌فرض Anthropic / Claude؛ ویرایش متن‌های بلند و ساختاردهی
claude-haiku-5-5 Anthropic Messages · https://api.qcode.cc/api گزینه سبک Anthropic / Claude؛ پاسخ سریع
deepseek-v4.1-flash Chat Completions · https://api.qcode.cc/openai/v1 گزینه سبک چینی؛ مناسب پرسش‌وپاسخ سریع و مرتب‌سازی روزمره یادداشت‌ها

شناسه مدل‌های چینی بیشتر در اتصال مدل‌های چینی آمده است؛ جدول کامل پروتکل‌ها و مسیرها در نقاط پایانی و قالب API است.

مستندات مرتبط

با QCode شروع کنید

یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models

سازمانی ←