SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

رفع خطاهای نصب و نسخه DeepSeek Harness

نسخه‌های DeepSeek Harness هنوز prerelease هستند. نسخه دقیق dsh را pin کنید، cache مربوط به npx را پاک کنید و بررسی کنید واقعاً کدام npm اجرا می‌شود.

نصب DeepSeek Harness در واقع چیست

نصب DeepSeek Harness فقط یک فرمان است: npx @deepseek-ai/dsh web. نصب‌کننده‌ای وجود ندارد و سرویسی برای پیکربندی وجود ندارد. بیشتر مشکلاتی که کاربران با آن مواجه می‌شوند، اصلاً به نصب مربوط نیستند. مسئله، تعیین نسخه است: npx امروز تصمیم گرفته است کدام build از @deepseek-ai/dsh را اجرا کند و آیا نسخه Node.js شما می‌تواند آن را اجرا کند یا نه. پس از شروع اجرا، اتصال پیش‌فرض روی localhost است؛ --host و --port تنظیمات listener را تغییر می‌دهند و آدرس چاپ‌شده، در صورت پیکربندی، از --public-url استفاده می‌کند. اتصال پیش‌فرض و دلیل پاسخ‌دادن Web UI فقط روی 127.0.0.1:3080، مسئله‌ای جدا از موارد این صفحه است.

دو واقعیت، مبنای همه مطالب زیر هستند. نخست، تمام نسخه‌های @deepseek-ai/dsh که تا 27 October 2026 در npm منتشر شده‌اند، prerelease بوده‌اند. بیشتر آن‌ها release candidate هستند (-rc.N) و از 30 August 2026، alpha buildها (-alpha.N) نیز منتشر شده‌اند. تگ latest به یک release candidate اشاره می‌کند. در 6 November 2026، این نسخه 0.2.2-rc.1 است. دوم، README پروژه می‌گوید harness در وضعیت developer preview قرار دارد، به‌سرعت تغییر می‌کند و تغییراتی خواهد داشت که سازگاری را می‌شکنند. ممکن است flagای که هفته گذشته کار می‌کرد، این هفته حذف شده باشد. پیش از آن‌که چیزی بر پایه آن بسازید، یک نسخه را pin کنید.

ابتدا چند اصطلاح. dsh ابزار خط فرمان DeepSeek Harness است. Node.js محیط اجرای JavaScript است که این ابزار به آن نیاز دارد. npx، package runner همراه npm (node package manager) است و یک package را در زمان نیاز دریافت می‌کند، نه این‌که آن را به‌صورت دائمی نصب کند. اگر واژه harness در این جمله برایتان ناآشناست، agent harness برنامه‌ای است که پیرامون model اجرا می‌شود و loop، ابزارها، مجوزها و وضعیت session را در اختیار دارد؛ به همین دلیل، شماره نسخه‌ای که شما انتخاب نکرده‌اید می‌تواند نحوه رفتار agent شما را تغییر دهد.

dsh به کدام نسخه از Node.js نیاز دارد؟

در 10 اکتبر 2026، زمانی که مخزن روی نسخه 0.2.1-alpha.2 بود، فایل ریشهٔ package.json مقدار "engines": {"node": "^22.19.0 || >=24.0.0"} را اعلام می‌کرد. این دیگر نیازمندی فعلی نیست. در 27 اکتبر 2026، زمانی که مخزن روی نسخه 0.2.1-rc.3 بود، فایل ریشهٔ package.json مقدار "engines": {"node": ">=24.9.0"} را اعلام می‌کرد و کد منبع خود CLI، یعنی package.json، نیز اکنون همین مقدار را اعلام می‌کند. یک یادداشت تصمیم پروژه با تاریخ 15 اکتبر 2026 می‌گوید نصب‌های Node 22 باید ارتقا پیدا کنند و Node 24.0 نیز کافی نیست، زیرا entry pointها به import.meta.main متکی هستند و این قابلیت در 24.0 وجود ندارد. بنابراین نسخهٔ موردنیاز Node 24.9.0 یا جدیدتر است. Node 20 و Node 22 قابل استفاده نیستند و هیچ نسخه‌ای از Node 24 پیش از 24.9.0 نیز قابل استفاده نیست. هنگام بررسی در 27 اکتبر 2026، تگ‌های انتشار مربوط به 0.2.1-rc.2، سپس buildای که latest به آن اشاره می‌کرد، و 0.2.1-rc.3 همچنان بازهٔ قدیمی را داشتند؛ بنابراین حداقل نسخهٔ جدید پس از آن‌ها اعمال شده است. با این حال، برای 24.9.0 برنامه‌ریزی کنید، زیرا این همان بازه‌ای است که پروژه اکنون اعلام می‌کند.

پیش از هر کار دیگری، نسخهٔ موجود را بررسی کنید.

node -v
npm -v

این بخش معمولاً باعث شگفتی می‌شود. در 27 اکتبر 2026، package منتشرشدهٔ @deepseek-ai/dsh همچنان در هیچ‌یک از 38 نسخهٔ خود تا 0.2.1-rc.4، فیلد engines را نداشت. ریشهٔ monorepo این فیلد را اعلام می‌کند، اما آن فایل ریشه هرگز در npm منتشر نمی‌شود. کد منبع CLI، یعنی package.json، در commitای با تاریخ 15 اکتبر 2026 این فیلد را دریافت کرد، اما هیچ‌یک از buildهای منتشرشده‌ای که در 27 اکتبر بررسی شدند آن را نداشتند. بنابراین آن buildها هیچ نیازمندی اختصاصی dsh برای نسخهٔ Node در اختیار npm نمی‌گذاشتند. در 6 نوامبر 2026، package منتشرشدهٔ 0.2.2-rc.1 مقدار "engines": {"node": ">=24.9.0"} را اعلام می‌کند. npm مقدار engines را تا زمانی که engine-strict را تنظیم نکنید، صرفاً به‌صورت advisory در نظر می‌گیرد؛ بنابراین با تنظیم پیش‌فرض، در بهترین حالت باید منتظر یک هشدار باشید. روی Node پشتیبانی‌نشده، نصب ظاهراً موفق می‌شود و خطا بعداً رخ می‌دهد؛ زمانی که کد بارگذاری‌شده به syntax یا APIای دسترسی پیدا می‌کند که runtime شما ندارد. برای جست‌وجوی خطا، یک رشتهٔ ثابت و قابل اتکا وجود ندارد، زیرا خطی که ابتدا شکست می‌خورد به ماژولی بستگی دارد که زودتر بارگذاری می‌شود. به‌جای جست‌وجوی crash، node -v را بخوانید.

اگر Node شما قدیمی است، nvm (node version manager) در یک VPS کم‌ریسک‌ترین راه‌حل است، زیرا در دایرکتوری home شما نصب می‌شود و Node سیستمی را بدون تغییر باقی می‌گذارد.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
exec $SHELL -l
nvm install 24
nvm use 24
node -v

اکنون node -v باید نسخه‌ای را چاپ کند که با v24. آغاز می‌شود. اگر shell همچنان نسخهٔ قدیمی را گزارش می‌کند، which node را اجرا کنید. قرار داشتن مسیر خارج از ~/.nvm معمولاً دو علت دارد. یا function مربوط به nvm در shell بارگذاری نشده است؛ در این صورت یک login shell جدید باز کنید و دوباره امتحان کنید. یا خطی در profile مربوط به shell شما، پس از خط‌هایی که nvm را source می‌کنند، مقدار PATH را تغییر می‌دهد و Node دیگری را در ابتدای آن قرار می‌دهد؛ در این صورت آن خط را به بالای خط‌های nvm منتقل کنید. در 10 اکتبر 2026، Node 24 خط active LTS (long term support) بود و در 20 اکتبر 2026 وارد maintenance شد. جدیدترین release آن در 29 اکتبر 2026 نسخهٔ 24.22.2 است که به‌مراتب بالاتر از حداقل نسخهٔ 24.9.0 قرار دارد. Node 26 که بازهٔ >=24.9.0 نیز آن را مجاز می‌داند، در 28 اکتبر 2026 با نسخهٔ 26.13.0 وارد active LTS شد. هرکدام از این دو نسخه حداقل نیازمندی را برآورده می‌کنند و هر دو نسخه‌های npm را همراه با اصلاح range-cache که در ادامه توضیح داده می‌شود، ارائه می‌کنند. باینری‌های رسمی Node 26 برای Linux به libatomic نیز نیاز دارند و ممکن است لازم باشد این کتابخانه را جداگانه در توزیع خود نصب کنید.

چرا npx هر روز نسخه متفاوتی اجرا می‌کند؟

npx @deepseek-ai/dsh web هیچ نسخه‌ای را مشخص نمی‌کند. مگر این‌که پروژه در پوشه فعلی شما از قبل @deepseek-ai/dsh را نصب کرده باشد؛ در این صورت npx همان نسخه را اجرا می‌کند. در غیر این صورت، npx از registry می‌پرسد که tag مربوط به latest اکنون به کدام نسخه اشاره می‌کند. این tag مرتب تغییر می‌کند. 0.1.0-rc.8 در 19 August 2026 منتشر شد؛ یعنی دو روز پس از 0.1.0-rc.7. در 10 October 2026، latest به 0.2.0-rc.2 اشاره می‌کرد و در 27 October 2026 به 0.2.1-rc.2. هر بار که این tag تغییر می‌کند، دستوری که در یادداشت‌های شما قرار دارد، بدون نمایش هیچ هشداری و بدون آن‌که changelogی در برابر شما باشد، کد متفاوتی را اجرا می‌کند.

می‌توانید تمام اجزای متغیر را از خط فرمان بررسی کنید.

npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --json

dist-tags نشان می‌دهد latest اکنون به کجا اشاره می‌کند. در 10 October 2026، هر دو latest و next به 0.2.0-rc.2 اشاره می‌کردند و tag سومی به نام alpha به 0.2.1-alpha.2 اشاره می‌کرد که روز قبل منتشر شده بود. در 27 October 2026، latest به 0.2.1-rc.2، next به 0.2.1-rc.4 که روز قبل منتشر شده بود، و alpha به 0.2.1-alpha.5 اشاره می‌کردند. در 6 November 2026، latest به 0.2.2-rc.1 اشاره می‌کند. در 4 November 2026، next به 0.2.1-rc.5 و alpha به 0.2.2-alpha.3 اشاره می‌کردند. tag مربوط به latest همچنان یک prerelease را انتخاب می‌کند. فهرست versions جالب‌تر است، چون در آن چندین مورد وجود ندارد. در 10 October 2026، این فهرست 31 نسخه داشت؛ از 0.0.1-rc.1 تا 0.2.1-alpha.2. در 27 October 2026، تعداد نسخه‌ها به 38 رسید و همه آن‌ها همچنان prerelease بودند. خط 0.0.1 از -rc.2 به -rc.5 می‌پرد و خط 0.1.0 از -rc.3 به -rc.6. buildهای alpha از 0.1.2-alpha.2 و 0.1.3-alpha.2 آغاز می‌شوند و هیچ 0.1.4 وجود ندارد. برخی شماره‌ها در فهرست منتشرشده وجود ندارند و buildهای alpha و release candidateها در همان فهرست کنار هم آمده‌اند. حدس‌زدن -rc.N بعدی در یک deploy script شکست می‌خورد؛ بنابراین به‌جای شمردن نسخه‌ها به سمت بالا، خود فهرست را بخوانید.

چرا npx همچنان نسخه‌ای قدیمی را اجرا می‌کند؟

این شکایت کاملاً برعکس است و هر دو حالت می‌توانند درست باشند؛ نتیجه به مشخصات package، نصب محلی و نسخه npm مورد استفاده بستگی دارد.

npx پوشهٔ package مخصوص خود را جدا از tarball cache نگه می‌دارد. این پوشه با نام _npx درون npm cache قرار دارد. مسیر آن را چاپ کنید و محتویاتش را بررسی کنید.

npm config get cache
ls "$(npm config get cache)/_npx"

npm 10.9.3 در خارج از نصب project، برای یک نام سادهٔ package از قبل registry را بررسی می‌کند. npm 11.2.0 بررسی تازگی cache برای version range را تغییر داد. وقتی spec یک نام ساده باشد و package در project فعلی نصب نشده باشد، npx manifest را با preferOnline: true دریافت می‌کند و فقط زمانی نسخهٔ cache‌شده در _npx را دوباره استفاده می‌کند که tarball resolve‌شده با مقداری که registry برگردانده است مطابقت داشته باشد. یک نام ساده همچنان با هر نسخه‌ای که project فعلی نصب کرده است مطابقت دارد و در این حالت registry بررسی نمی‌شود. برای version range، npm 10.9.3 یک نسخهٔ cache‌شدهٔ منطبق را می‌پذیرد؛ اما npm 11.2.0 و نسخه‌های جدیدتر بررسی می‌کنند که آیا این range به نسخه‌ای جدیدتر resolve می‌شود یا نه.

رفتاری که دریافت می‌کنید، به نسخهٔ npmای بستگی دارد که واقعاً اجرا می‌کنید. مگر آن‌که npm را جداگانه با npm install -g npm ارتقا داده باشید، این همان نسخه‌ای است که release مربوط به Node همراه خود ارائه می‌کند:

  • Node 20.20.2 همراه با npm 10.8.2 ارائه می‌شود.
  • Node 22.19.0 همراه با npm 10.9.3 ارائه می‌شود.
  • Node 22.23.4 که تا 27 October 2026 جدیدترین release از شاخهٔ 22 است، همراه با npm 10.9.9 ارائه می‌شود.
  • Node 24.9.0 که حداقل نسخهٔ فعلی harness است، همراه با npm 11.6.0 ارائه می‌شود.
  • Node 24.19.0 همراه با npm 11.17.0 ارائه می‌شود.
  • Node 24.22.2 که تا 29 October 2026 جدیدترین release از شاخهٔ 24 است، همراه با npm 11.19.1 ارائه می‌شود.
  • Node 26.13.0 که تا 29 October 2026 جدیدترین release از شاخهٔ 26 است، همراه با npm 11.20.0 ارائه می‌شود.

بنابراین کل شاخهٔ Node 22 همراه با نسخه‌ای از npm ارائه می‌شود که قدیمی‌تر از 11.2.0 است. harness تا اواسط October 2026 از Node 22 پشتیبانی می‌کرد و اکنون دیگر این کار را نمی‌کند؛ اما سروری که پیش از آن زمان dsh را اجرا کرده باشد، ممکن است همچنان از آن استفاده کند. npm 10.9.3 همراه با Node 22.19.0، خارج از نصب project، یک npx @deepseek-ai/dsh web ساده را دوباره در برابر registry بررسی می‌کند؛ بنابراین وجود یک ورودی قدیمی _npx به‌تنهایی نسخهٔ قدیمی release candidate را توضیح نمی‌دهد. تمام releaseهای Node که harness اکنون می‌پذیرد، از 24.9.0 به بعد، همراه با npm 11.6.0 یا نسخه‌های جدیدتر ارائه می‌شوند و اصلاح مربوط به range cache را نیز شامل می‌شوند. بااین‌حال، نصب project همچنان می‌تواند اولویت داشته باشد. از tool بپرسید چه چیزی را اجرا می‌کند:

npx @deepseek-ai/dsh --version

پاک‌کردن cache مربوط به npx

در npm 11.2.0 و نسخه‌های جدیدتر، subcommandهای اختصاصی برای این کار وجود دارد.

npm cache npx ls
npm cache npx rm --force

بدون --force، npm از پاک‌کردن همهٔ موارد خودداری می‌کند و Please use --force to remove entire npx cache را چاپ می‌کند. وقتی می‌خواهید به‌جای همهٔ موارد، فقط یک ورودی را بر اساس key حذف کنید، ابتدا از npm cache npx ls استفاده کنید.

در npm 10 این subcommandها وجود ندارند؛ بنابراین پوشه را خودتان حذف کنید.

rm -rf "$(npm config get cache)/_npx"

npm cache clean --force در اینجا کمکی نمی‌کند. این دستور _cacache، یعنی tarball store، را پاک می‌کند و _npx را دست‌نخورده باقی می‌گذارد. همین جداسازی دلیل آن است که npm بعداً subcommandهای npm cache npx را اضافه کرد. پاک‌کردن _npx نیز چیزی دائمی را از بین نمی‌برد: این پوشه packageهای دانلودشده را نگه می‌دارد، درحالی‌که وضعیت harness به‌طور جداگانه در $DSH_HOME قرار دارد و شامل profiles/<name>، sessions، storages و .credentials.yaml است؛ این موارد دست‌نخورده باقی می‌مانند.

چگونه یک release candidate دقیق را pin کنم؟

رشتهٔ کامل version را، شامل بخش -rc.N، مشخص کنید.

npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web

مثال‌های این صفحه از 0.1.0-rc.7 استفاده می‌کنند. buildی را که واقعاً آزمایش کرده‌اید جایگزین کنید. در 27 October 2026، tagِ latest به 0.2.1-rc.2 اشاره می‌کرد.

--yes تأیید نصب package توسط npx را بدون prompt تعاملی انجام می‌دهد.

یک version دقیق، packageِ dsh را pin می‌کند، اما شروع آفلاین را تضمین نمی‌کند. npx مسیر cache خود را بر اساس spec رشته‌ای که وارد کرده‌اید تعیین می‌کند و می‌تواند version دقیقِ از قبل نصب‌شده در همان مسیر را دوباره استفاده کند. بااین‌حال، اگر installation محلی منطبقی وجود نداشته باشد، بررسی local tree که پیش‌تر انجام می‌شود، manifest را با preferOnline: true دریافت می‌کند و سپس _npx را بررسی می‌کند. نصب version دقیق و منطبق در پروژهٔ محلی، از این lookup برای manifest جلوگیری می‌کند. اجرای نام ساده در خارج از پروژه‌ای که dsh را نصب می‌کند نیز lookup برای manifest را فعال می‌کند؛ این رفتار در npm 10.9.3 هم وجود دارد.

نصب global نیز به همین روش pin می‌شود و یک command کوتاه در اختیار شما می‌گذارد.

npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version

هیچ version منطبقی برای @deepseek-ai/dsh@^0.1.0 پیدا نشد

در 27 October 2026، یک range ساده از نوع caret یا tilde برای این package با خطا مواجه شد. npm install -g @deepseek-ai/dsh@^0.1.0 با error codeِ ETARGET و این خط پاسخ داد: No matching version found for @deepseek-ai/dsh@^0.1.0. رجیستری سالم است. این رفتار یک قاعدهٔ semver است: یک version range با version prerelease منطبق نمی‌شود، مگر آن‌که یکی از comparatorهای خود range، یک prerelease را با همان اعداد major، minor و patch نام‌گذاری کند. همهٔ buildهای منتشرشدهٔ این package تا 27 October 2026، prerelease بودند و یکی از این دو شکل را داشتند: -rc.N یا -alpha.N؛ اما ^0.1.0 هیچ prereleaseای را نام نبرده بود و بنابراین با هیچ‌چیز منطبق نمی‌شد. version دقیق را بنویسید.

این قاعده از هر دو طرف اثر می‌گذارد. یک range ساده هرگز به release candidate جدید منتقل نمی‌شود، اما rangeای که یک prerelease را نام می‌برد، می‌تواند چنین تغییری کند. ^0.1.0-rc.7 به معنی >=0.1.0-rc.7 <0.2.0-0 است؛ بنابراین 0.1.0-rc.8 را می‌پذیرد و یک 0.1.0 نهایی را نیز می‌پذیرفت، اما 0.1.1-rc.1 را کنار می‌گذارد، چون اعداد آن متفاوت‌اند. این وضعیت، بین یک version دقیق و یک tag متغیر، نوعی pin ناقص است و بدون آن‌که شما چیزی تغییر دهید، چیزی را که اجرا می‌شود تغییر می‌دهد. اگر build آزمایش‌شدهٔ خود و هیچ چیز دیگری را می‌خواهید، version دقیق را بنویسید.

آیا باید از npx استفاده کنم یا dsh را به‌صورت سراسری (globally) نصب کنم؟

برای بررسی اولیه از npx استفاده کنید، زیرا بسته در یک دایرکتوری کش باقی می‌ماند که اکنون می‌دانید چگونه آن را پاک کنید. برای هر چیزی که باید پس از reboot همچنان کار کند، مانند یک عامل برنامه‌نویسی که روی یک VPS اجرا می‌کنید، از نصب سراسری با نسخه ثابت (pinned) استفاده کنید.

این دو روش ممکن است روی سیستمی که از هر دو استفاده کرده‌اید با هم تداخل داشته باشند، بنابراین آن‌ها را با هم مقایسه کنید.

which dsh
dsh --version
npx @deepseek-ai/dsh --version

which dsh پیدا نکردن چیزی بلافاصله پس از یک نصب سراسری موفق، تقریباً همیشه به این معنی است که دایرکتوری bin سراسری npm در PATH شما وجود ندارد. دستور npm prefix -g را اجرا کنید تا ریشه (root) را چاپ کند؛ فایل‌های اجرایی در پوشه bin در زیر آن قرار دارند.

یک نکته امنیتی: npx هر زمان که چیز جدیدی را resolve می‌کند، کد را از registry دریافت و اجرا می‌کند که در یک سرور، یک آسیب‌پذیری واقعی است، نه صرفاً تئوری. ثابت کردن نسخه (Pinning) بخشی از پاسخ است. بخش دیگر در چگونگی نفوذ حملات زنجیره تأمین npm به سرور نهفته است.

معنای developer preview برای بازتولیدپذیری

0.1.0-rc.6 در 13 August 2026 و 0.1.0-rc.7 در 17 August 2026 منتشر شد. این دو انتشار فقط 4 روز فاصله داشتند. این سرعت از آن زمان کاهش نیافته است: بین 19 August و 9 October 2026، 24 نسخهٔ دیگر منتشر شد که 0.2.0-rc.1 در 28 September و 0.2.0-rc.2 در روز بعد از آن را نیز شامل می‌شود؛ سپس بین 14 و 26 October 2026، 7 نسخهٔ دیگر منتشر شد و این روند تا 0.2.1-rc.4 ادامه یافت. با چنین سرعتی، دستورالعملی که یک ماه پیش نوشته شده است ممکن است خط فرمانی را توصیف کند که دیگر وجود ندارد؛ این صفحه نیز از این قاعده مستثنا نیست. تاریخ هر ادعای مربوط به نسخه را، از جمله در یادداشت‌های شخصی خود، ثبت کنید.

دو عادت، کار با preview را قابل‌کنترل می‌کند. نسخهٔ دقیق را در هر command و هر script ثابت کنید تا بازسازی سرور همان release مربوط به dsh را انتخاب کند. این کار به‌تنهایی dependencyهای آن را بازتولید نمی‌کند: پکیج منتشرشدهٔ 0.2.2-rc.1 از rangeهایی مانند js-yaml: ^4.3.2 و commander: ^15.0.0 استفاده می‌کند و بدون npm shrinkwrap منتشر می‌شود. برای نصب تکرارپذیر dependencyها، dsh را در یک پروژهٔ محلی نگه دارید، package-lock.json را commit کنید و با npm ci بازسازی را انجام دهید. سپس خروجی help را از همان build ثابت بخوانید، نه از یک راهنما.

npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-config

نیمهٔ دوم بازتولیدپذیری به profile مربوط است. dsh --profile <name> profile ذخیره‌شده در $DSH_HOME/profiles/<name> را راه‌اندازی می‌کند و profileهای web و headless در نخستین استفاده، بر اساس templateهای همراه package ساخته می‌شوند. patch مربوط به profile می‌تواند تنظیمات model و endpoint را نگه دارد، اما API keyهای ذخیره‌شده در $DSH_HOME/.credentials.yaml قرار دارند و settings فقط reference مربوط به credentialها را نگه می‌دارند؛ بنابراین ثابت‌کردن version و داشتن configuration عملیاتی، دو کار جداگانه هستند که باید به‌درستی انجام شوند. patchهای سطح home و command line می‌توانند settings مربوط به profile را override کنند. bundleهای داخلی از dsh نصب‌شده‌ای resolve می‌شوند که در حال اجرا است؛ بنابراین تغییر version ثابت‌شده، این bundleها را نیز تغییر می‌دهد. pluginهای خارج از درخت نصب رفتار متفاوتی دارند. آن‌ها در directory مربوط به profile قرار می‌گیرند و dsh plugin --profile <name> add <package> آرگومان‌های آن‌ها را برای نصب به pnpm ارسال می‌کند. بنابراین pnpm باید در PATH شما وجود داشته باشد؛ dsh نیز در صورت نبودن آن، این موضوع را به‌صراحت اعلام می‌کند. هر pluginای که اضافه می‌کنید با همان permissionهایی اجرا می‌شود که agent شما دارد؛ بنابراین پیش از نصب، بررسی کنید plugin به چه بخش‌هایی می‌تواند دسترسی داشته باشد. package.json خود profile این pluginها را اعلام می‌کند؛ pnpm-lock.yaml آن را حفظ کنید و برای بازتولید versionهای dependency آن‌ها نیز از pnpm install --frozen-lockfile استفاده کنید.

اگر ابزارهای Python را در محیط‌های ایزوله روی سرور نگه داشته باشید، این جداسازی برایتان آشناست: خود ابزار و مواردی که به آن اضافه می‌کنید، در محل‌های جداگانه ثابت می‌شوند. پس از راه‌اندازی harness، پرسش بعدی معمولاً به‌جای versionها به شبکه مربوط است؛ در این مرحله، دسترسی به Web UI مربوط به dsh روی یک VPS راه دور و راهنمای مفصل‌تر در نصب DeepSeek Harness روی یک VPS ادامهٔ کار را پوشش می‌دهند.

خطاهای آرگومانی که واقعاً مشاهده خواهید کرد

این خطاها از parser داخلی CLI ایجاد می‌شوند و هرکدام مشکل دقیق را مشخص می‌کنند. متن پیام‌ها در buildهای مختلف تا حد زیادی ثابت مانده است، اما کاملاً یکسان نیست؛ بنابراین پیام‌های زیر در 6 October 2026 در برابر 0.2.0-rc.2 بررسی شده‌اند.

error: --profile <name> is required

npx @deepseek-ai/dsh را بدون subcommand و بدون profile اجرا کرده‌اید. دستور بدون آرگومان profile را راه‌اندازی می‌کند، بنابراین به نام نیاز دارد. dsh web بدون --profile کار می‌کند، زیرا parser نخستین واژهٔ بدون آرگومان را به‌عنوان نام profile می‌خواند و در نتیجه profile ارائه‌شدهٔ web را برای شما راه‌اندازی می‌کند.

error: --patch needs a path

--patch بدون هیچ مقداری پس از آن ارسال شده است. این flag را می‌توان چندبار تکرار کرد و هر بار باید یک مسیر فایل دریافت کند.

error: --dump-config and --dump-default-config are mutually exclusive

یکی را انتخاب کنید. در 0.2.0-rc.2، یعنی buildی که latest در 6 October 2026 به آن اشاره می‌کرد، پیام یک flag سوم را نیز نام می‌برد و به‌شکل error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive نمایش داده می‌شود، زیرا --dump-config-schema، که JSON Schema مربوط به ورودی‌های profile و patchها را چاپ می‌کند، به دو گزینهٔ دیگر اضافه شده است. --dump-default-config لایه‌های bundle ارائه‌شده را چاپ می‌کند و هیچ --patchای را نمی‌پذیرد. --dump-config configuration ترکیبی یک profile را چاپ می‌کند. هر سه گزینه از راه‌اندازی harness جلوگیری می‌کنند، اما schema collection ماژول‌های plugin را import می‌کند و ممکن است getterها و lazy builderها را اجرا کند؛ بنابراین فقط pluginهای مورداعتماد را بررسی کنید و در scriptها یک timeout خارجی اعمال کنید.

error: plugin needs pnpm arguments to forward (e.g. add <package>)

به dsh plugin --profile <name> هیچ مقداری برای انتقال داده نشده است. این subcommand در صورت نبودن profile آن را initialize می‌کند و سپس باقی خط فرمان را به pnpm می‌سپارد؛ بنابراین به آرگومان‌هایی مانند add @scope/dsh-plugin-example نیاز دارد.

FAQ

DeepSeek Harness به کدام نسخه از Node.js نیاز دارد؟

Node.js 24.9.0 یا جدیدتر. در 27 October 2026، با repository در نسخه 0.2.1-rc.3، فایل root آن package.json مقدار >=24.9.0 را اعلام می‌کند. در 10 October 2026 مقدار اعلام‌شده ^22.19.0 || >=24.0.0 بود، اما یک یادداشت تصمیم پروژه با تاریخ 15 October 2026 پشتیبانی از Node 22 را حذف کرد و حداقل نسخه را به بالاتر از 24.0 افزایش داد. Node 20 و Node 22 کار نمی‌کنند و هیچ نسخه‌ای از Node 24 که قدیمی‌تر از 24.9.0 باشد نیز قابل استفاده نیست. در 27 October 2026، هیچ build منتشرشده‌ای از npm فیلد engines مربوط به خود را نداشت؛ بنابراین npm نمی‌توانست بر اساس نیازمندی Node مربوط به dsh هشدار دهد یا اجرا را مسدود کند و runtime ناسازگار بعدتر با خطا مواجه می‌شد. بسته منتشرشده 0.2.2-rc.1 که در 6 November 2026 بررسی شد، اکنون در engines.node مقدار >=24.9.0 را اعلام می‌کند؛ npm به‌صورت پیش‌فرض هشدار می‌دهد و وقتی engine-strict فعال باشد، runtime ناسازگار را نمی‌پذیرد. ابتدا node -v را بررسی کنید. هر نسخه Node که حداقل نسخه لازم را داشته باشد، npm 11 یا جدیدتر را همراه خود دارد؛ این نسخه شامل اصلاح range-cache در npx است که در npm 11.2.0 معرفی شد.

چگونه npx را مجبور کنم به‌جای نسخه cache‌شده از جدیدترین dsh استفاده کند؟

npm 10.9.3 و نسخه فعلی npm برای یک نام سادهٔ بسته، registry را دوباره بررسی می‌کنند؛ مگر آن‌که دایرکتوری فعلی یک پروژه باشد و dsh در آن نصب شده باشد. در این حالت، npx همان نسخه local را اجرا می‌کند. برای درخواست صریح tag latest از registry، از npx @deepseek-ai/dsh@latest --version استفاده کنید. npm 11.2.0 بررسی تازگی را برای version rangeها تغییر داد، نه برای نام‌های ساده. در npm 11.2.0 و نسخه‌های جدیدتر، cache مربوط به npx را با npm cache npx rm --force پاک کنید؛ در npm 10، پوشه را با rm -rf "$(npm config get cache)/_npx" حذف کنید. سپس با npx @deepseek-ai/dsh --version نتیجه را تأیید کنید. توجه کنید که npm cache clean --force دایرکتوری متفاوتی را پاک می‌کند و این مشکل را برطرف نمی‌کند.

چرا نصب @deepseek-ai/dsh@^0.1.0 با خطا مواجه می‌شود؟

در 27 October 2026، npm کد خطای ETARGET را همراه با خط No matching version found for @deepseek-ai/dsh@^0.1.0. برگرداند. در آن بررسی، همه buildهای منتشرشده prerelease بودند؛ مانند 0.2.0-rc.2 یا 0.2.1-alpha.2. یک semver range با نسخه‌های prerelease منطبق نمی‌شود، مگر آن‌که خود range یک prerelease با همان شماره‌های major، minor و patch را مشخص کند. رشتهٔ نسخهٔ دقیق را، از جمله suffix، نصب کنید. برای دیدن نسخه‌های موجود، npm view @deepseek-ai/dsh versions --json را اجرا کنید؛ زیرا این دنباله دارای فاصله است.

آیا باید dsh را به‌صورت global نصب کنم یا آن را از طریق npx اجرا کنم؟

npx برای بررسی اولیه مناسب است، زیرا بسته در دایرکتوری cache خود باقی می‌ماند؛ harness نیز state پایدار profile را ایجاد می‌کند. یک نصب global با نسخهٔ ثابت، مانند npm install -g @deepseek-ai/dsh@0.1.0-rc.7، برای هر چیزی که باید به‌طور پایدار کار کند مناسب‌تر است، زیرا نسخه فقط زمانی تغییر می‌کند که خودتان آن را تغییر دهید. اگر پس از نصب global، command مربوط به dsh پیدا نشد، دایرکتوری global bin مربوط به npm در PATH شما وجود ندارد و npm prefix -g ریشه‌ای را چاپ می‌کند که این دایرکتوری زیر آن قرار دارد.

آیا DeepSeek Harness برای ساخت محصول بر پایهٔ آن به‌اندازهٔ کافی پایدار است؟

هنوز نه؛ این نتیجه از توضیح خود پروژه به دست می‌آید. README اعلام می‌کند که پروژه در مرحلهٔ developer preview است، با سرعت زیادی تغییر می‌کند و تغییرات ناسازگار با نسخه‌های قبلی خواهد داشت. release candidateهای 0.1.0-rc.6 و 0.1.0-rc.7 در August 2026 با فاصلهٔ 4 روز منتشر شدند؛ 0.2.0-rc.1 و 0.2.0-rc.2 در September 2026 با فاصلهٔ 1 روز منتشر شدند؛ و 0.2.1-rc.1 و 0.2.1-rc.2 نیز در همان روز در October 2026 منتشر شدند. محدودهٔ Node پشتیبانی‌شده نیز در October 2026 تغییر کرد. یک نسخهٔ دقیق را pin کنید و --help را از همان build ثابت بخوانید، نه از هر راهنما. یادداشت‌های خود را تاریخ‌گذاری کنید تا بتوانید میزان قدیمی‌شدن آن‌ها را تشخیص دهید.

آیا این مقاله مفید بود؟