SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor · Cập nhật ngày 2026-11-21

Sửa lỗi cài DeepSeek Harness và chọn đúng version

DeepSeek Harness vẫn là prerelease: pin đúng version dsh, xóa cache npx và kiểm tra npm thực tế đang chạy để xử lý lỗi cài đặt và version.

DeepSeek Harness thực sự được cài như thế nào

Cài DeepSeek Harness chỉ bằng một lệnh: npx @deepseek-ai/dsh web. Không có installer và cũng không có service nào cần cấu hình. Phần lớn vấn đề mọi người gặp phải thực ra không liên quan đến cài đặt. Đó là việc xác định version: hôm nay npx chọn chạy build nào của @deepseek-ai/dsh và version Node.js của bạn có chạy được build đó hay không. Khi khởi động, mặc định nó bind vào localhost; --host và --port ghi đè các thiết lập listener, còn địa chỉ được in ra sẽ dùng --public-url nếu đã cấu hình. Binding mặc định và lý do Web UI chỉ phản hồi trên 127.0.0.1:3080 là vấn đề riêng, không thuộc các vấn đề trên trang này.

Hai thông tin chi phối toàn bộ phần dưới đây. Thứ nhất, mọi version của @deepseek-ai/dsh được publish lên npm tính đến 27 October 2026 đều là prerelease. Phần lớn là release candidate (-rc.N), và từ 30 August 2026 cũng có các alpha build (-alpha.N). Tag latest trỏ đến một release candidate. Tính đến 6 November 2026, đó là 0.2.2-rc.1. Thứ hai, README của project cho biết harness đang ở giai đoạn developer preview, được phát triển rất nhanh và sẽ có các thay đổi làm mất tính tương thích. Một flag hoạt động tuần trước có thể đã bị xóa trong tuần này. Hãy pin version trước khi xây dựng bất kỳ thứ gì dựa trên nó.

Trước hết là một số thuật ngữ. dsh là công cụ dòng lệnh của DeepSeek Harness. Node.js là JavaScript runtime mà công cụ này cần. npx là package runner đi kèm npm (node package manager), có chức năng fetch package theo nhu cầu thay vì cài vĩnh viễn. Nếu từ harness trong câu này chưa quen thuộc, agent harness là chương trình bao quanh model, quản lý vòng lặp, tools, quyền và trạng thái session. Vì vậy, một version number mà bạn không tự chọn vẫn có thể thay đổi cách agent hoạt động.

dsh cần phiên bản Node.js nào?

Vào ngày 10 October 2026, khi repository ở phiên bản 0.2.1-alpha.2, package.json tại root khai báo "engines": {"node": "^22.19.0 || >=24.0.0"}. Đây không còn là yêu cầu hiện tại. Kiểm tra vào ngày 27 October 2026, khi repository ở phiên bản 0.2.1-rc.3, package.json tại root khai báo "engines": {"node": ">=24.9.0"}, và mã nguồn riêng của CLI trong package.json hiện cũng khai báo như vậy. Ghi chú quyết định của dự án ngày 15 October 2026 cho biết các bản cài đặt Node 22 phải nâng cấp, đồng thời Node 24.0 cũng chưa đủ vì các entry point sử dụng import.meta.main, thành phần mà 24.0 chưa có. Vì vậy, cần Node 24.9.0 hoặc mới hơn. Node 20 và Node 22 không còn được hỗ trợ, cũng như mọi bản Node 24 trước 24.9.0. Khi kiểm tra vào ngày 27 October 2026, các release tag của 0.2.1-rc.2, sau đó là bản build mà latest trỏ tới, và 0.2.1-rc.3 vẫn dùng range cũ, nên mức tối thiểu mới được áp dụng sau các bản đó. Dù vậy, hãy chuẩn bị cho 24.9.0 vì đó là range hiện được dự án khai báo.

Trước tiên, hãy kiểm tra phiên bản đang có.

node -v
npm -v

Đây là phần dễ gây nhầm lẫn. Tính đến ngày 27 October 2026, package @deepseek-ai/dsh đã publish vẫn không có field engines riêng trong bất kỳ phiên bản nào trong tổng số 38 phiên bản, cho đến 0.2.1-rc.4. Monorepo root có khai báo field này, nhưng file tại root đó không bao giờ được publish lên npm. Mã nguồn CLI trong package.json đã được bổ sung field này trong một commit ngày 15 October 2026, nhưng không có bản build nào được kiểm tra vào ngày 27 October chứa field đó. Vì vậy, các bản build này không cung cấp cho npm yêu cầu Node riêng của dsh để kiểm tra. Tính đến ngày 6 November 2026, package 0.2.2-rc.1 đã publish khai báo "engines": {"node": ">=24.9.0"}. npm chỉ xem engines là thông tin khuyến cáo nếu bạn không đặt engine-strict, nên với thiết lập mặc định, nhiều nhất bạn chỉ nhận được cảnh báo. Trên phiên bản Node không được hỗ trợ, quá trình cài đặt vẫn có vẻ thành công. Lỗi chỉ xuất hiện sau đó, khi mã được load chạm đến cú pháp hoặc API mà runtime của bạn không có. Không có một chuỗi lỗi ổn định duy nhất để tìm kiếm, vì dòng lỗi đầu tiên phụ thuộc vào module được load trước. Hãy đọc node -v thay vì chỉ đọc crash.

Nếu Node quá cũ, nvm (node version manager) là cách ít ảnh hưởng nhất để sửa trên VPS vì nó cài đặt trong home directory của bạn và không thay đổi Node của hệ thống.

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 lúc này phải in ra một phiên bản bắt đầu bằng v24.. Nếu shell vẫn báo phiên bản cũ, hãy chạy which node. Nếu đường dẫn nằm ngoài ~/.nvm, thường có 2 nguyên nhân. Một là shell function của nvm chưa được load; hãy mở một login shell mới rồi thử lại. Hai là một dòng trong shell profile thay đổi PATH sau các dòng source nvm và đưa một Node khác lên trước; hãy chuyển dòng đó lên trước các dòng nvm. Node 24 là dòng LTS (long term support) đang active vào ngày 10 October 2026 và chuyển sang maintenance vào ngày 20 October 2026. Bản mới nhất của nó tính đến ngày 29 October 2026 là 24.22.2, cao hơn nhiều so với mức tối thiểu 24.9.0. Node 26, cũng được range >=24.9.0 cho phép, chuyển sang active LTS vào ngày 28 October 2026 với phiên bản 26.13.0. Cả hai đều đáp ứng mức tối thiểu và đều đi kèm các phiên bản npm có bản sửa lỗi range-cache được đề cập bên dưới. Binary Node 26 chính thức cho Linux cũng yêu cầu libatomic; bản phân phối của bạn có thể cần cài riêng package này.

Vì sao npx chạy một phiên bản khác mỗi ngày?

npx @deepseek-ai/dsh web không chỉ rõ phiên bản. Nếu project trong thư mục hiện tại đã cài @deepseek-ai/dsh thì npx chạy bản sao đó. Nếu chưa, npx hỏi registry để lấy tag latest đang trỏ tới. Tag này thường xuyên thay đổi. 0.1.0-rc.8 được phát hành vào ngày 19 August 2026, hai ngày sau 0.1.0-rc.7. Đến ngày 10 October 2026, latest trỏ tới 0.2.0-rc.2, và đến ngày 27 October 2026 thì trỏ tới 0.2.1-rc.2. Mỗi lần tag thay đổi, command trong ghi chú của bạn lại chạy code khác mà không có prompt hay changelog nào hiển thị trước đó.

Bạn có thể kiểm tra từng thành phần đang thay đổi từ command line.

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

dist-tags cho biết hiện tại latest đang trỏ tới đâu. Vào ngày 10 October 2026, cả latest và next đều trỏ tới 0.2.0-rc.2. Tag thứ ba là alpha, trỏ tới 0.2.1-alpha.2 được publish vào ngày hôm trước. Đến ngày 27 October 2026, latest trỏ tới 0.2.1-rc.2, next trỏ tới 0.2.1-rc.4 được publish vào ngày hôm trước, còn alpha trỏ tới 0.2.1-alpha.5. Tính đến ngày 6 November 2026, latest trỏ tới 0.2.2-rc.1. Vào ngày 4 November 2026, next trỏ tới 0.2.1-rc.5, còn alpha trỏ tới 0.2.2-alpha.3. Tag latest vẫn chọn một prerelease. Danh sách versions đáng chú ý hơn vì có các khoảng trống. Vào ngày 10 October 2026, danh sách này có 31 phiên bản, từ 0.0.1-rc.1 đến 0.2.1-alpha.2. Đến ngày 27 October 2026, danh sách có 38 phiên bản, và tất cả vẫn là prerelease. Dòng 0.0.1 nhảy từ -rc.2 đến -rc.5. Dòng 0.1.0 nhảy từ -rc.3 đến -rc.6. Các bản alpha bắt đầu từ 0.1.2-alpha.2 và 0.1.3-alpha.2, còn 0.1.4 hoàn toàn không tồn tại. Danh sách đã publish bị thiếu một số số phiên bản. Các bản alpha và release candidate cũng nằm xen kẽ trong cùng một danh sách. Nếu đoán -rc.N tiếp theo trong deploy script, bạn sẽ thất bại. Hãy đọc danh sách thay vì tự tăng số phiên bản.

Vì sao npx vẫn chạy phiên bản cũ?

Đây là phản ánh ngược lại, và cả hai trường hợp đều có thể đúng, tùy vào package spec, bản cài đặt cục bộ và npm mà bạn đang chạy.

npx có thư mục package riêng, tách khỏi tarball cache, nằm trong thư mục có tên _npx bên trong npm cache. In đường dẫn này ra rồi kiểm tra thư mục đó.

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

npm 10.9.3 đã kiểm tra registry khi package name không có spec và package chưa được cài trong project. npm 11.2.0 thay đổi cách kiểm tra độ mới của cache đối với version range. Khi spec chỉ là tên package và package chưa được cài trong project hiện tại, npx lấy manifest bằng preferOnline: true và chỉ dùng lại bản cache trong _npx khi tarball đã resolve khớp với dữ liệu registry trả về. Tên package không kèm spec vẫn khớp với bất kỳ phiên bản nào mà project hiện tại đã cài, không cần kiểm tra registry. Với version range, npm 10.9.3 chấp nhận phiên bản phù hợp trong cache; npm 11.2.0 trở lên kiểm tra xem range có resolve thành phiên bản mới hơn hay không.

Hành vi bạn nhận được phụ thuộc vào npm thực tế đang chạy. Trừ khi bạn đã nâng cấp npm riêng bằng npm install -g npm, đó là npm được đóng gói cùng bản Node của bạn:

  • Node 20.20.2 đi kèm npm 10.8.2.
  • Node 22.19.0 đi kèm npm 10.9.3.
  • Node 22.23.4, bản phát hành 22 mới nhất tính đến ngày 27 October 2026, đi kèm npm 10.9.9.
  • Node 24.9.0, mức phiên bản tối thiểu hiện tại của harness, đi kèm npm 11.6.0.
  • Node 24.19.0 đi kèm npm 11.17.0.
  • Node 24.22.2, bản phát hành 24 mới nhất tính đến ngày 29 October 2026, đi kèm npm 11.19.1.
  • Node 26.13.0, bản phát hành 26 mới nhất tính đến ngày 29 October 2026, đi kèm npm 11.20.0.

Vì vậy, toàn bộ dòng Node 22 đều đi kèm npm cũ hơn 11.2.0. Harness hỗ trợ Node 22 đến giữa October 2026 và hiện không còn hỗ trợ nữa, nhưng server từng chạy dsh trước thời điểm đó có thể vẫn đang dùng Node 22. npm 10.9.3 đi kèm Node 22.19.0 đã kiểm tra lại npx @deepseek-ai/dsh web với registry khi package chưa được cài trong project, nên chỉ một entry _npx cũ không đủ để giải thích việc chạy release candidate cũ. Mọi bản Node mà harness hiện chấp nhận, từ 24.9.0 trở lên, đều đi kèm npm 11.6.0 hoặc mới hơn, cũng bao gồm bản sửa lỗi cache của range. Tuy nhiên, bản cài đặt trong project vẫn có thể được ưu tiên. Hãy yêu cầu tool tự báo phiên bản:

npx @deepseek-ai/dsh --version

Xóa npx cache

Trên npm 11.2.0 trở lên, có các subcommand riêng cho việc này.

npm cache npx ls
npm cache npx rm --force

Nếu không có --force, npm sẽ từ chối xóa toàn bộ và in ra Please use --force to remove entire npx cache. Khi muốn xóa một entry theo key thay vì xóa tất cả, trước hết hãy dùng npm cache npx ls.

Trên npm 10, các subcommand đó không tồn tại, nên bạn phải tự xóa thư mục.

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

npm cache clean --force không giúp giải quyết vấn đề này. Lệnh đó xóa _cacache, tức tarball store, nhưng giữ nguyên _npx. Việc tách riêng này chính là lý do npm bổ sung các subcommand npm cache npx sau đó. Xóa _npx cũng không làm mất dữ liệu vĩnh viễn: thư mục này chỉ chứa các package đã tải xuống, còn trạng thái harness nằm riêng trong $DSH_HOME, bao gồm profiles/<name>, sessions, storages và .credentials.yaml, và không bị ảnh hưởng.

Cách pin chính xác một release candidate?

Ghi đầy đủ chuỗi phiên bản, bao gồm phần -rc.N.

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

Các ví dụ trên trang này dùng 0.1.0-rc.7. Thay bằng build mà bạn đã thực sự kiểm thử. Vào ngày 27 October 2026, tag latest trỏ đến 0.2.1-rc.2.

--yes chấp nhận xác nhận cài package của npx mà không cần prompt tương tác.

Phiên bản chính xác sẽ pin package dsh, nhưng không bảo đảm có thể khởi động offline. npx dùng chuỗi spec bạn nhập để xác định thư mục cache và có thể dùng lại phiên bản chính xác đã được cài trong đó. Tuy nhiên, nếu không có bản cài cục bộ khớp, bước kiểm tra local tree trước đó sẽ fetch manifest bằng preferOnline: true trước khi kiểm tra _npx. Nếu project cục bộ đã cài phiên bản chính xác khớp, npx sẽ không cần tra cứu manifest. Chạy tên package đơn độc bên ngoài một project cũng cài dsh sẽ kích hoạt tra cứu manifest, kể cả trên npm 10.9.3.

Cài global cũng pin theo cách tương tự và cho phép bạn dùng lệnh ngắn.

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

Không tìm thấy phiên bản khớp cho @deepseek-ai/dsh@^0.1.0

Tính đến ngày 27 October 2026, range caret hoặc tilde thông thường không khớp với package này. npm install -g @deepseek-ai/dsh@^0.1.0 trả về error code ETARGET cùng dòng No matching version found for @deepseek-ai/dsh@^0.1.0. Registry vẫn hoạt động bình thường. Đây là quy tắc semver: một version range không khớp với phiên bản prerelease, trừ khi một comparator trong chính range đó ghi rõ prerelease có cùng số major, minor và patch. Tất cả build được publish của package này tính đến ngày 27 October 2026 đều là prerelease, entweder -rc.N hoặc -alpha.N, còn ^0.1.0 không ghi prerelease nào nên không khớp với bản nào. Hãy ghi phiên bản chính xác.

Quy tắc này áp dụng theo cả hai chiều. Một range thông thường sẽ không tự chuyển sang release candidate mới, nhưng range có ghi prerelease thì có thể. ^0.1.0-rc.7 có nghĩa là >=0.1.0-rc.7 <0.2.0-0, nên nó chấp nhận 0.1.0-rc.8 và cũng chấp nhận 0.1.0 bản final, trong khi 0.1.1-rc.1 vẫn không được chấp nhận vì các số phiên bản khác nhau. Đây là trạng thái pin một phần, nằm giữa phiên bản chính xác và tag thay đổi theo thời gian; nó có thể làm thay đổi thứ được chạy mà bạn không thay đổi gì. Nếu muốn chạy đúng build đã kiểm thử và không chạy bản nào khác, hãy ghi phiên bản chính xác.

Tôi nên dùng npx hay cài dsh ở phạm vi global?

Hãy dùng npx để xem thử lần đầu, vì package được giữ trong một thư mục cache mà bạn đã biết cách xóa. Hãy cài global với phiên bản được pin cho mọi thứ phải tiếp tục hoạt động sau khi reboot, chẳng hạn như coding agent bạn để chạy liên tục trên VPS.

Hai cách này có thể cho kết quả khác nhau trên máy đã dùng cả hai, vì vậy hãy so sánh chúng.

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

which dsh không tìm thấy gì ngay sau khi cài global thành công gần như luôn có nghĩa là thư mục bin global của npm không có trong PATH của bạn. Chạy npm prefix -g để in thư mục root; các binary nằm trong thư mục bin bên dưới thư mục đó.

Một lưu ý về bảo mật. npx fetch và thực thi code từ registry mỗi khi nó resolve một thứ mới. Trên server, đây là một rủi ro thực tế chứ không chỉ là rủi ro trên lý thuyết. Pin phiên bản là một phần của giải pháp. Phần còn lại nằm trong cách các cuộc tấn công supply chain của npm xâm nhập server.

Ý nghĩa của developer preview đối với khả năng tái lập

0.1.0-rc.6 được phát hành vào ngày 13 tháng 8 năm 2026 và 0.1.0-rc.7 vào ngày 17 tháng 8 năm 2026. Hai bản cách nhau 4 ngày. Tốc độ này không chậm lại: 24 phiên bản khác được phát hành từ ngày 19 tháng 8 đến ngày 9 tháng 10 năm 2026, gồm 0.2.0-rc.1 vào ngày 28 tháng 9 và 0.2.0-rc.2 vào ngày hôm sau. Sau đó có thêm 7 phiên bản từ ngày 14 đến ngày 26 tháng 10 năm 2026, lên đến 0.2.1-rc.4. Với tốc độ đó, hướng dẫn được viết từ một tháng trước có thể mô tả một command line không còn tồn tại, và trang này cũng vậy. Hãy ghi ngày cho mọi thông tin về phiên bản, kể cả trong ghi chú của bạn.

Hai thói quen giúp bạn làm việc ổn định với preview. Ghim chính xác phiên bản trong mọi command và script để khi rebuild server, bạn chọn đúng bản phát hành dsh. Chỉ như vậy vẫn chưa đủ để tái lập các dependency: package 0.2.2-rc.1 được phát hành với các range như js-yaml: ^4.3.2 và commander: ^15.0.0, đồng thời không kèm npm shrinkwrap. Để cài dependency có thể lặp lại, hãy giữ dsh trong một project cục bộ, commit package-lock.json và rebuild bằng npm ci. Sau đó, hãy đọc output của help từ build đã ghim thay vì từ bất kỳ hướng dẫn nào.

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

Nửa còn lại của khả năng tái lập là profile. dsh --profile <name> khởi động profile được lưu tại $DSH_HOME/profiles/<name>, còn các profile web và headless tự tạo từ template đi kèm trong lần sử dụng đầu tiên. Profile patch có thể chứa cài đặt model và endpoint, nhưng API key đã lưu nằm trong $DSH_HOME/.credentials.yaml, còn các setting giữ lại tham chiếu đến credential. Vì vậy, phiên bản đã ghim và cấu hình hoạt động được là hai phần riêng biệt cần thiết lập đúng. Patch ở cấp home và trên command line có thể ghi đè setting của profile. Các bundle tích hợp được resolve từ bản dsh đang chạy, nên thay đổi phiên bản đã ghim cũng thay đổi các bundle đó. Plugin ngoài tree hoạt động khác. Chúng nằm trong thư mục profile và dsh plugin --profile <name> add <package> chuyển tiếp các argument của chúng cho pnpm để cài đặt. Vì vậy, pnpm phải có trong PATH, và dsh sẽ thông báo rõ khi không tìm thấy. Mỗi plugin được thêm vào chạy với cùng quyền như agent của bạn, vì vậy bạn nên kiểm tra plugin có thể truy cập những gì trước khi cài đặt. package.json của profile khai báo các plugin đó; hãy giữ nguyên pnpm-lock.yaml và dùng pnpm install --frozen-lockfile để tái lập cả phiên bản dependency của chúng.

Sự tách biệt này sẽ quen thuộc nếu bạn từng đặt các công cụ Python trong môi trường cô lập trên server: tool và những thành phần bạn thêm vào được ghim ở các vị trí khác nhau. Khi harness khởi động, câu hỏi tiếp theo thường liên quan đến networking hơn là phiên bản. Đây là phần truy cập Web UI của dsh trên VPS từ xa và bài hướng dẫn chi tiết hơn cài đặt DeepSeek Harness trên VPS sẽ tiếp tục.

Các lỗi đối số bạn sẽ thực sự gặp

Các lỗi này đến từ parser của CLI và mỗi lỗi nêu rõ vấn đề cụ thể. Cách diễn đạt hầu như không thay đổi giữa các bản build, nhưng không hoàn toàn giống nhau, nên các thông báo dưới đây đã được đối chiếu với 0.2.0-rc.2 vào ngày 6 October 2026.

error: --profile <name> is required

Bạn đã chạy npx @deepseek-ai/dsh mà không có subcommand và profile. Lệnh không có đối số sẽ khởi động một profile, nên cần có tên profile. dsh web hoạt động mà không cần --profile vì parser đọc từ đầu tiên không có flag làm tên profile, rồi khởi động profile web được cung cấp sẵn.

error: --patch needs a path

Bạn đã truyền --patch nhưng không có gì theo sau. Flag này có thể lặp lại, và mỗi lần xuất hiện nhận một đường dẫn file.

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

Chỉ chọn một. Trong 0.2.0-rc.2, bản build mà latest trỏ đến vào ngày 6 October 2026, thông báo này nêu thêm một flag thứ ba và có nội dung error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive, vì --dump-config-schema, flag in JSON Schema cho các mục profile và patch, đã được thêm vào cùng hai flag kia. --dump-default-config in các lớp bundle được cung cấp sẵn và không nhận --patch. --dump-config in cấu hình đã hợp nhất của một profile. Cả ba đều không khởi động harness, nhưng việc thu thập schema sẽ import các module plugin và có thể gọi getter cũng như lazy builder; chỉ kiểm tra các plugin đáng tin cậy và đặt timeout bên ngoài trong script.

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

Bạn đã chạy dsh plugin --profile <name> nhưng không truyền đối số nào để chuyển tiếp. Subcommand này khởi tạo profile nếu profile chưa tồn tại, sau đó chuyển phần còn lại của command line cho pnpm, nên cần các đối số như add @scope/dsh-plugin-example.

Câu hỏi thường gặp (FAQ)

DeepSeek Harness cần phiên bản Node.js nào?

Node.js 24.9.0 trở lên. Khi kiểm tra ngày 27 October 2026, với repository ở phiên bản 0.2.1-rc.3, file root package.json khai báo >=24.9.0. Ngày 10 October 2026, file này khai báo ^22.19.0 || >=24.0.0, nhưng một ghi chú quyết định của dự án ngày 15 October 2026 đã bỏ Node 22 và nâng phiên bản tối thiểu lên trên 24.0. Node 20 và Node 22 sẽ không chạy được. Các bản Node 24 cũ hơn 24.9.0 cũng không chạy được. Tính đến 27 October 2026, không có bản build npm nào đã publish có trường engines riêng. Vì vậy npm không thể cảnh báo hoặc chặn dựa trên yêu cầu Node của dsh, và runtime không được hỗ trợ chỉ fail ở bước sau. Gói 0.2.2-rc.1 đã publish được kiểm tra ngày 6 November 2026 hiện khai báo >=24.9.0 trong engines.node; npm mặc định sẽ cảnh báo và từ chối runtime không tương thích khi bật engine-strict. Trước tiên hãy kiểm tra node -v. Mọi bản Node đáp ứng phiên bản tối thiểu này đều đi kèm npm 11 trở lên, bao gồm bản sửa lỗi range-cache của npx được giới thiệu trong npm 11.2.0.

Làm cách nào để buộc npx dùng dsh mới nhất thay vì bản trong cache?

npm 10.9.3 và các bản npm hiện tại đã kiểm tra lại registry khi nhận một tên package không kèm phiên bản, trừ khi thư mục hiện tại là một project đã cài dsh; khi đó npx chạy bản local. Dùng npx @deepseek-ai/dsh@latest --version để yêu cầu rõ tag latest của registry. npm 11.2.0 đã thay đổi cách kiểm tra độ mới cho version range, không thay đổi cách xử lý tên package không kèm phiên bản. Xóa npx cache bằng npm cache npx rm --force trên npm 11.2.0 trở lên, hoặc xóa thư mục bằng rm -rf "$(npm config get cache)/_npx" trên npm 10. Sau đó xác nhận bằng npx @deepseek-ai/dsh --version. Lưu ý rằng npm cache clean --force xóa một thư mục khác nên không khắc phục được vấn đề này.

Tại sao cài @deepseek-ai/dsh@^0.1.0 lại fail?

Tính đến 27 October 2026, npm trả về mã lỗi ETARGET cùng dòng No matching version found for @deepseek-ai/dsh@^0.1.0. Mọi bản build đã publish tại thời điểm kiểm tra đều là prerelease, chẳng hạn 0.2.0-rc.2 hoặc 0.2.1-alpha.2. Một semver range không khớp với phiên bản prerelease, trừ khi chính range đó chỉ rõ một prerelease có cùng số major, minor và patch. Hãy cài chính xác chuỗi phiên bản, bao gồm cả suffix. Chạy npm view @deepseek-ai/dsh versions --json để xem những phiên bản hiện có, vì chuỗi phiên bản này có các khoảng trống.

Nên cài dsh global hay chạy qua npx?

npx phù hợp để dùng thử, vì package được giữ trong thư mục cache; harness cũng tạo state profile persistent. Một bản cài global được pin, chẳng hạn npm install -g @deepseek-ai/dsh@0.1.0-rc.7, phù hợp với mọi thứ cần hoạt động ổn định, vì phiên bản chỉ thay đổi khi bạn tự thay đổi. Nếu không tìm thấy command dsh sau khi cài global, thư mục global bin của npm chưa có trong PATH. npm prefix -g sẽ in ra root mà thư mục đó nằm bên dưới.

DeepSeek Harness đã đủ ổn định để dùng làm nền tảng xây dựng chưa?

Chưa, theo chính mô tả của dự án. README cho biết project đang ở developer preview, vẫn được phát triển nhanh và sẽ có các thay đổi làm mất tương thích. Các release candidate 0.1.0-rc.6 và 0.1.0-rc.7 được publish cách nhau 4 ngày trong August 2026; 0.2.0-rc.1 và 0.2.0-rc.2 cách nhau 1 ngày trong September 2026; còn 0.2.1-rc.1 và 0.2.1-rc.2 được publish trong cùng một ngày của October 2026. Supported Node range cũng thay đổi trong October 2026. Hãy pin một phiên bản cụ thể và đọc --help từ build đã pin đó, thay vì đọc từ một guide bất kỳ. Ghi ngày vào các ghi chú của bạn để biết chúng đã cũ đến mức nào.

Bài viết này có hữu ích không?