DeepSeek Harness چیست؟
DeepSeek Harness (dsh) یک چارچوب متنباز (MIT) برای ساخت و اجرای عاملهای هوش مصنوعی است که توسط DeepSeek AI منتشر شده و اکنون با بیش از ۱۹۰ هزار ستاره در GitHub، یکی از پرطرفدارترین پروژههای این حوزه شده است. شعار اصلی آن "همه چیز یک پلاگین است" است — هر قابلیتی از عامل (مدل، ابزار، مهارت، نشست، محیط امن، ذخیرهسازی، حلقه، زمانبندی و رابط کاربری) بهصورت یک پلاگین مستقل ارائه میشود.
Agent = Model + Harness
در معماری DeepSeek Harness، مدل روح عامل است و Harness (سیستم بستهبندی) بدن آن. مدل میفهمد و تولید میکند؛ Harness به عامل کمک میکند محیطش را بشناسد، ابزارها را به کار ببرد و در دنیای واقعی کار کند. این جداسازی معنا دارد: وقتی مدل را عوض میکنید، فقط «مغز» را جایگزین میکنید و وقتی ابزارها را تغییر میدهید، فقط «بدن» را.
هستۀ Cordis
هستۀ فنی DSH بر پایۀ Cordis ساخته شده — یک معماری پلاگینمحور که خدمات (Service)، رویدادهای تایپشده و اثرات برگشتپذیر (Reversible Effects) را در یک زمینۀ مشترک مدیریت میکند. هر بخش محصول یک پلاگین است: آداپتور مدل، مخزن ابزارها، گزارش نشست، و حتی خود حلقۀ عامل. نکتۀ کلیدی: هیچ هستۀ ممتازی برای وصلهکردن وجود ندارد — شما با نصب یک پلاگین در کنار بقیه، محصول را گسترش میدهید و وقتی پلاگین را حذف میکنید، اثرات آن هم برگشت داده میشود.
چهار حالت اجرا
DeepSeek Harness چهار حالت اجرا دارد:
| حالت | توضیح |
|---|---|
| Standard | ابزارهای کامل: ویرایش فایل، shell، جستجو، مهارتها، برنامهریزی، اهداف، عاملهای فرعی و گردشکارها |
| Code | همه ابزارهای Standard بهعلاوه SDK که به مدل اجازه میدهد چندین عملیات را در یک برنامۀ TypeScript واحد ترکیب کند |
| Minimal | فقط دو ابزار: bash پایدار و ویرایشگر فایل — مناسب benchmark |
| Creator | برای ساخت پیش تنظیمات سفارشی: ابزارهای Standard بهعلاوه بازرسی runtime، آزمایش پلاگینها در حافظه و راهنمای نوشتن preset |
هر اجرا قابل پیگیری است
هرچه مدل میبیند در یک گزارش نشست فقط-افزایشی (Append-Only Session Log) ثبت میشود: پرامپتهای سیستم، استدلال، فراخوانی ابزارها و نتایج، زمانبندی عاملهای فرعی و هر تزریق زمینه. در نمای Trajectory میتوانید این رکوردها را بر اساس منبع بررسی کنید. از سرگیری (Resume)، انشعاب (Fork)، جستجو و بازپخش همگی روی همین جریان رویداد عمل میکنند.
شروع سریع
نصب و اجرا با یک دستور:
node --version # 18 یا بالاتر
npx @deepseek-ai/dsh webرابط وب روی http://127.0.0.1:3080 اجرا میشود. در تنظیمات، یک کلید API (مثلاً DeepSeek) وارد کنید، یک پوشه کاری (Workspace) انتخاب کنید و شروع کنید.
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh webمدلهای پشتیبانیشده
DSH از طریق آداپتورهای OpenAI-compatible از مدلهای مختلف پشتیبانی میکند: DeepSeek (V3، R1، V4)، Claude، GPT و مدلهای محلی از طریق Ollama و سایر سرویسدهندگان سازگار. تنظیم مدل در رابط وب انجام میشود و نیازی به ریاستارت سرور نیست.
اکوسیستم پلاگینها
اکنون بیش از ۱۱,۰۰۰ پلاگین با برچسب dsh-plugin در GitHub وجود دارد. از جمله پلاگینهای شاخص:
- Open Design — تبدیل عامل کدنویسی به موتور طراحی (پروتوتایپ، لندینگ، داشبورد، ارائه)
- ruflo — هماهنگی عاملهای چندگانه (Swarm) با حافظه تطبیقی و یادگیری خودکار
- DeepSeek-Reasonix — عامل کدنویسی با بهینهسازی prefix-cache
- MemOS / EverOS — حافظه خودتکامل برای عاملها (.cross-app, cross-session)
- dsh-desktop — راهحل دسکتاپ مدرن برای اکوسیستم DSH
- Voyager — ابزار بهبود Gemini، Claude و ChatGPT + مدیریت پرامپت
پروفایلها و باندلها
یک نمونۀ اجرایی DSH از لایههای مرتبشده ساخته میشود: باندل (Bundle) قالبی برای پیکربندی و کد Cordis است و پروفایل (Profile) ترکیب نامداری از باندلهاست. باندل dsh-base لایۀ اولیه هر پروفایل است (آداپتور مدل، ابزارها، پایداری، sandbox، سیاست تأیید). dsh-web-app برنامۀ مرورگر را اضافه میکند و dsh-headless اجرای بدون سرور یکباره را. برای دیدن درخت پیکربندی واقعی ماشین:
dsh --profile web --dump-configنقاط اتصال (Extension Points)
رفتار جدید از طریق نقاط اتصال مستند به سیستم اضافه میشود. مثالهای رایج:
| هدف | مکانیزم |
|---|---|
| افزودن ارائهدهندۀ مدل | register adapter on ctx.llm |
| افزودن ابزار جدید | register on ctx.tools |
| اجرا در محیط امن | use ctx.sandbox backend |
| تزریق زمینه به مدل | agent.inject() |
| کار پسزمینه | register on ctx.jobs |
مقایسه با رقبا
DeepSeek Harness در فضای ابزارهای عامل کدنویسی قرار میگیرد. مقایسۀ کلی:
| ویژگی | DeepSeek Harness | Claude Code | OpenCode | Cursor |
|---|---|---|---|---|
| Open-source | MIT | متنباز (Anthropic) | MIT | تجاري |
| معماری پلاگین | بله — همه چیز پلاگین | محدود | Skills | محدود |
| قابلیت ردیابی | گزارش کامل فقط-افزایشی | گزارش ساده | گزارش | محدود |
| حالتهای اجرا | ۴ حالت | ۱ حالت | ۱ حالت | ۱ حالت |
| مدلهای پشتیبانی | هر مدل OpenAI-compatible | فقط Claude | هر مدل | چند مدل |
| تعداد پلاگینها | ۱۱,۰۰۰+ | — | — | — |
| UI | وب + دسکتاپ | ترمینال | ترمینال | دسکتاپ |
ملاحظات
- DeepSeek Harness هنوز در مرحلۀ پیشنمایش توسعهدهنده است و ممکن است تغییرات شکستدهنده داشته باشد
- برای اجرای کامل به Node.js 18+ نیاز دارد
- رابط وب روی پورت 3080 اجرا میشود
- هزینۀ اصلی، هزینۀ API مدل انتخابی شماست
جمعبندی
DeepSeek Harness یک رویکرد متفاوت و جسورانه به ساخت عاملهای هوش مصنوعی ارائه میدهد: همه چیز پلاگین است، هر اجرا قابل پیگیری است و توسعهدهندگان میتوانند هر قابلیتی را بدون تغییر کد هسته جایگزین یا گسترش دهند. اگر به دنبال یک چارچوب انعطافپذیر و متنباز برای ساخت عاملهای هوشمند هستید، ارزش امتحان کردن را دارد.