Hooshyar (افزونه‌ی VS Code)

یک افزونه‌ی VS Code شبیه GitHub Copilot / Kilo Code که مستقیماً به provider سفارشی شما (POST /v1/messages, سازگار با Anthropic Messages API) وصل می‌شود.

Provider پیش‌فرض: https://wqai.morvism.ir/v1

قابلیت‌ها (v0.3.0)

• پنل چت با استریم زنده، markdown، کارت ابزار، sidebar تاریخچه
• @-mention: @src/foo.ts, @workspace, @selection + autocomplete
• Copy / Insert / Retry روی پاسخ assistant
• RTL خودکار برای متن فارسی
• Diff inline در بنر تأیید write
• حالت Agent: مدل خودش چند مرحله ابزار صدا می‌زند تا کار تمام شود
• Inline completions: پیشنهاد ghost-text در ادیتور (مثل Copilot)
• تاریخچه‌ی چت: تا ۵۰ session در globalState ذخیره می‌شود (Hooshyar: Chat History)
• مصرف توکن: نمایش در status bar چت
• ابزارها:
  • read_file, write_file, search_replace, list_files
  • list_codebase, search_codebase, update_tasks
  • run_command (پیش‌فرض غیرفعال)
• Rules پروژه: .cursorrules, .cursor/rules/*.md, .hooshyar/rules.md
• Context هوشمند: git diff، symbol outline فایل فعال
• Ripgrep search: search_codebase با rg (fallback به scan)
• Diff preview قبل از تأیید write
• Undo last write (Hooshyar: Undo Last Write)
• Test connection (Hooshyar: Test Connection)
• Multi-root workspace, رعایت .gitignore / .cursorignore, محدودیت اندازه فایل
• Retry/timeout, fallback non-streaming JSON, هدرهای auth قابل تنظیم
• Output channel «Hooshyar» برای لاگ

ساختار پروژه

hooshyar/
├── package.json
├── src/
│   ├── extension.ts           # فعال‌سازی + دستورات
│   ├── chatViewProvider.ts    # agent loop + webview
│   ├── apiClient.ts           # SSE + retry + non-stream fallback
│   ├── apiConfig.ts           # تنظیمات provider
│   ├── toolCallParser.ts      # parse متنی tool calls
│   ├── tools.ts               # پیاده‌سازی ابزارها
│   ├── workspaceUtils.ts      # مسیر، ignore، binary
│   ├── contextManager.ts      # trim history
│   ├── writeBackup.ts         # backup + undo
│   ├── diffPreview.ts         # diff + test connection
│   ├── inlineCompletionProvider.ts
│   └── logger.ts
├── media/                     # webview UI
└── test/                      # unit tests

راه‌اندازی

npm install
npm run compile    # یا npm run watch
npm test
npm run lint

در VS Code این پوشه را باز کنید و F5 بزنید (Extension Development Host).

تنظیمات

Ctrl+Shift+P → Hooshyar: Open Settings → Set API Key (در Secret Storage ذخیره می‌شود).

دستورات

Package (.vsix)

npm run package
code --install-extension hooshyar-0.3.0.vsix

نکات provider

1. استریم باید فرمت SSE استاندارد Anthropic را برگرداند؛ در غیر این صورت fallback JSON non-streaming فعال است.
2. برای gatewayهایی که native tools نمی‌فهمند، hooshyar.toolProtocol را روی text بگذارید.
3. هدرهای x-api-key و Authorization: Bearer به‌صورت پیش‌فرض ارسال می‌شوند؛ هدر اضافه با hooshyar.extraHeaders.

امنیت

• run_command با دسترسی کاربر VS Code اجرا می‌شود و whitelist دارد.
• write/search_replace قبل از اجرا (در صورت فعال بودن) diff + تأیید می‌خواهند.
• فایل‌های ignore و binary/super-large skip می‌شوند.

License

MIT — see LICENSE. Changes: CHANGELOG. #� �H�o�o�s�h�y�a�r�E�x�t�e�n�t�i�o�n� � �