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

Cấu hình dsh: API key, model và endpoint ở đâu?

Biết dsh lưu config Linux ở đâu, cách nối DeepSeek API key hoặc endpoint Ollama local, và chính xác dữ liệu nào rời khỏi máy bạn trong từng mode.

Nơi dsh lưu trữ cấu hình

dsh (DeepSeek Harness) lưu trữ dữ liệu harness tại $DSH_HOME, mặc định là ~/.dsh, và đọc cấu hình agent dùng chung từ một root riêng biệt, $DSH_AGENTS_HOME, mặc định là ~/.agents. Mọi thiết lập bạn thực hiện trên Web UI đều được ghi lại tại đó dưới dạng các file văn bản thuần. Hãy sao chép thư mục home của harness cùng với mọi hướng dẫn và kỹ năng toàn cục từ root của agent dùng chung khi bạn di chuyển cấu hình sang máy chủ khác.

Bốn đường dẫn chứa các thiết lập, secret và log phiên làm việc chính của harness.

  • ~/.dsh/profiles/<profile>/cordis.patch.yml chứa các thiết lập mà Web UI ghi lại cho profile đó, bao gồm các route của provider và model của bạn. dsh web chạy profile web, vì vậy file này là ~/.dsh/profiles/web/cordis.patch.yml.
  • ~/.dsh/.credentials.yaml chứa các secret. Các thiết lập chỉ giữ tham chiếu đến credential, vì vậy giá trị khóa thực tế nằm trong một file riêng.
  • ~/.dsh/profiles/ chứa các profile đã đặt tên, và ~/.dsh/sessions/ chứa các log phiên làm việc đã lưu.
  • ~/.dsh/cordis.patch.yml là lớp patch của riêng bạn. Nó được áp dụng đè lên cấu hình mặc định cho mọi profile và có quyền ưu tiên cao hơn file profile, vì vậy một chỉnh sửa trên Web UI mà lớp này ghi đè sẽ bị từ chối thay vì được lưu lại.

Root của agent dùng chung nằm ngoài $DSH_HOME vì các công cụ agent khác cũng chia sẻ nó. dsh đọc các hướng dẫn toàn cục của người dùng từ ~/.agents/AGENTS.md và quét ~/.agents/skills/ để tìm các kỹ năng; hãy đặt DSH_AGENTS_HOME để di chuyển root đó.

Các bản build trước đây lưu trữ các thiết lập này trong ~/.dsh/settings.yaml. Các bản build hiện tại import file đó một lần vào profile đang hoạt động và đổi tên nó thành settings.yaml.imported, vì vậy một hướng dẫn cũ yêu cầu bạn chỉnh sửa settings.yaml hiện đang trỏ đến một file mà dsh không còn đọc nữa.

DeepSeek phát hành harness dưới dạng bản developer preview theo giấy phép MIT, và file README nêu rõ sẽ có những thay đổi làm mất tính tương thích. Tên trường và đường dẫn trong hướng dẫn này khớp với tài liệu repository hiện tại, được kiểm tra vào ngày 5 tháng 11 năm 2026. Hãy đối chiếu chúng với tài liệu của phiên bản bạn đã cài đặt trước khi sao chép cấu hình từ bất kỳ hướng dẫn nào, bao gồm cả hướng dẫn này, vì bản preview thường đổi tên các thành phần giữa các lần release.

Mức tối thiểu cần thiết để khởi chạy lần đầu

dsh yêu cầu Node.js 24.9 hoặc mới hơn. Tính đến ngày 5 tháng 11 năm 2026, file package.json của nó khai báo >=24.9.0, vì vậy phiên bản 22 không được hỗ trợ. Node 24.0 đến 24.8 cũng không đủ. Hãy kiểm tra phiên bản trước, vì sự không tương thích về phiên bản sẽ gây lỗi khi khởi động và thông báo lỗi trông giống như một gói cài đặt bị hỏng.

node -v
npx @deepseek-ai/dsh web

npx tải gói từ npm registry và khởi động Web UI trên http://127.0.0.1:3080. Nó bind vào địa chỉ loopback, nghĩa là cổng này không thể truy cập từ máy khác ngay cả khi firewall của bạn cho phép. Trên VPS, hãy forward nó qua SSH thay vì mở cổng 3080 ra Internet. Nếu URL được in ra gây khó hiểu, tại sao dsh khởi động trên địa chỉ đó sẽ giải thích những gì mà việc bind vào loopback bảo vệ và những gì nó không bảo vệ.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

Mở http://127.0.0.1:3080 trên laptop của bạn, sau đó vào Settings và Models. Thẻ DeepSeek có một trường API key. Dán key từ platform.deepseek.com vào và lưu lại. Route của model sẽ khả dụng ngay lập tức mà không cần khởi động lại, vì server đang chạy sẽ lưu trữ credential và phân giải tham chiếu trực tiếp. Truy cập dsh Web UI trên server từ xa đề cập đến tunnel và trường hợp reverse proxy, còn cài đặt DeepSeek Harness trên VPS đề cập đến việc chuẩn bị server mà hướng dẫn này giả định.

Sau khi lưu, hãy xem những gì ứng dụng đã tạo ra.

ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yaml

Bạn sẽ thấy .credentials.yaml và profiles/, với các cài đặt của Web UI nằm trong profiles/web/cordis.patch.yml. Thư mục home do bản build cũ tạo ra cũng có thể chứa settings.yaml.imported. Nếu stat in ra một mode khác 600, hãy chạy chmod 600 ~/.dsh/.credentials.yaml. File credential có quyền đọc cho group sẽ làm lộ key của bạn cho các tài khoản trong group đó; file có quyền đọc cho tất cả mọi người (world-readable) sẽ làm lộ nó cho mọi tài khoản khác trên máy.

Đối với lần chạy đầu tiên không cần trình duyệt, một lệnh là đủ.

npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"

Cấu hình headless chạy một session duy nhất và in ra câu trả lời cuối cùng.

Biến môi trường hoặc file cấu hình

dsh có thể phân giải một key từ thông tin xác thực đã lưu hoặc các phương án dự phòng từ biến môi trường.

Nhà cung cấp catalog (DeepSeek, Anthropic, OpenAI và các nhà cung cấp khác trong danh sách tích hợp sẵn) nhận key qua trang Models hoặc dùng biến môi trường dự phòng được hỗ trợ khi không có thông tin xác thực đã lưu cung cấp key đó. Giá trị được đưa vào ~/.dsh/.credentials.yaml, còn settings của bạn chỉ giữ tham chiếu đến giá trị này. Web UI không hiển thị lại key sau khi bạn lưu.

Nhà cung cấp tùy chỉnh có thể khai báo một tham chiếu đến credential bằng apiKeyEnv. Tham chiếu này cũng hỗ trợ các phương án dự phòng từ biến môi trường. Đây là cấu trúc được tài liệu đưa ra cho một mục trong profile patch như ~/.dsh/profiles/web/cordis.patch.yml.

- id: llm-pi-ai
  config:
    providers:
      my-gateway:
        apiKeyEnv: GATEWAY_API_KEY
        api: openai-completions
        baseURL: https://gateway.example/v1
        models:
          - id: legacy-chat
          - id: vision-preview
            input: [text, image]

Trước tiên, thêm một nhà cung cấp qua Web UI, sau đó mở cordis.patch.yml của profile và sao chép cấu trúc mà ứng dụng đã ghi. Trong giai đoạn developer preview, phần nesting có khả năng thay đổi nhiều nhất. File mà ứng dụng vừa ghi luôn là bản hiện tại.

apiKeyEnv được phân giải thông qua credential store: file đã lưu được ưu tiên trước, tiếp theo là môi trường khi khởi chạy, .env của thư mục gọi lệnh, rồi đến $DSH_HOME/.env. Một key chỉ được export trong session tương tác sẽ không hiển thị với systemd unit. Vì vậy, nếu không có nguồn credential khác, cùng một cấu hình hoạt động khi bạn gõ dsh web thủ công sẽ trả về MISSING_CREDENTIAL khi chạy dưới service. Hãy cấp cho unit một file riêng.

[Service]
EnvironmentFile=/etc/dsh/dsh.env

Giữ file đó ở mode 600 và đặt owner là user mà service chạy dưới user đó.

Chọn model và ID không thể đổi tên

Mọi provider đã cấu hình đều xuất hiện trong trình chọn model. Việc chọn một model cũng đặt nó làm mặc định cho các phiên làm việc mới. Các phiên đã gửi request sẽ giữ lại model được ghi nhận trong đó, vì vậy việc chuyển đổi không ghi đè lên cuộc hội thoại cũ.

Provider ID là vĩnh viễn. Các request, phiên đã lưu, model mặc định và tham chiếu thông tin xác thực đều trỏ đến ID này, do đó không có nút đổi tên. Thay đổi ID đồng nghĩa với việc tạo một provider mới và xóa provider cũ. Hãy chọn một cái tên bạn có thể sử dụng lâu dài: local-ollama thay vì test2.

Các model tùy chỉnh không có khả năng xử lý hình ảnh kế thừa sẽ chỉ là văn bản trừ khi bạn khai báo khác. Thêm input: [text, image] vào mục nhập model để khai báo hỗ trợ hình ảnh, hoặc đặt defaultInput ở cấp độ route làm phương án dự phòng cho các model mà catalog không mô tả. Trên route riêng của DeepSeek, một model không khai báo phương thức (modalities) sẽ được tính là chỉ hỗ trợ văn bản, vì vậy hãy chọn một mục nhập catalog có khả năng xử lý hình ảnh (mặc định là deepseek-flash) trước khi bạn đính kèm hình ảnh. Một hình ảnh gửi đến model không khai báo hỗ trợ hình ảnh sẽ bị từ chối trước khi bất kỳ dữ liệu nào được gửi đi.

Cấu hình dsh trỏ đến endpoint cục bộ để code vẫn chạy trên máy

Ollama cung cấp API tương thích với OpenAI tại http://127.0.0.1:11434/v1. dsh có thể gọi mọi base URL tương thích với OpenAI thông qua custom provider, nên hai thành phần kết nối trực tiếp với nhau. Trước tiên, hãy thiết lập model server: tự host LLM bằng Ollama trên VPS hướng dẫn cách cài đặt và pull model.

Hãy xác nhận endpoint trả lời trước khi cấu hình dsh.

ollama list
curl -s http://127.0.0.1:11434/v1/models

ollama list in ra tag chính xác của mọi model bạn đã pull. Hãy sao chép chuỗi đó. curl trả về cùng các model dưới dạng JSON. Danh sách rỗng nghĩa là Ollama đang chạy nhưng chưa có model nào được pull. Connection refused nghĩa là Ollama chưa chạy hoặc không listen trên 11434.

Chọn model chạy được trên máy này. Ollama server đã đăng nhập cũng cung cấp cloud model qua cùng địa chỉ cục bộ. Một cloud tag như gemma4:cloud sẽ chạy trên server của Ollama, nên prompt của bạn rời khỏi máy dù dsh chỉ giao tiếp với 127.0.0.1.

Bây giờ thêm provider vào profile patch. Với cấu hình này, hãy cung cấp một giá trị API key không rỗng; Ollama server cục bộ sẽ bỏ qua giá trị đó.

- id: llm-pi-ai
  config:
    providers:
      local-ollama:
        apiKeyEnv: OLLAMA_API_KEY
        api: openai-completions
        baseURL: http://127.0.0.1:11434/v1
        models:
          - id: <the exact tag printed by ollama list>

Export biến ở nơi tiến trình dsh có thể đọc được.

sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.env

Hầu hết các lần thử đều chỉ gặp một trong ba lỗi sau. MISSING_CREDENTIAL nghĩa là reference được apiKeyEnv chỉ đến không trả về giá trị nào. Vì vậy, hãy kiểm tra credentials đã lưu và môi trường khi khởi chạy, không chỉ kiểm tra terminal. UNKNOWN_MODEL nghĩa là id không khớp với model đã cấu hình. Hãy so sánh nó với ollama list từng ký tự một, bao gồm cả tag sau dấu hai chấm. Lỗi 401 khi lấy danh sách model xuất phát từ quá trình discovery model, vốn gọi GET /models trên base URL của bạn. Các endpoint không cung cấp path đó cần được nhập model thủ công.

Một lỗi khác thường gặp là base URL. Nếu bỏ /v1 khỏi URL, request sẽ đến các path mà Ollama không cung cấp. Khi đó request trả về 404 và model không chạy. Suffix này là một phần của giao diện tương thích với OpenAI, không phải phần trang trí.

Nếu Ollama chạy trên máy khác, địa chỉ của máy đó sẽ trở thành base URL. Khi đó prompt sẽ đi qua network dưới dạng cleartext bằng plain HTTP. Hãy chạy Ollama trên cùng host, hoặc đặt nó phía sau TLS (transport layer security) và authentication: bảo vệ endpoint Ollama đang public.

Dữ liệu rời khỏi máy trong từng chế độ

Với một DeepSeek key và endpoint mặc định, các yêu cầu model được gửi đến API của DeepSeek. Yêu cầu đó chứa prompt của bạn, nội dung các file mà agent đã đọc để trả lời, kết quả của các lệnh đã chạy và bất kỳ kết quả công cụ nào mà nó chọn đưa vào. Source code của bạn nằm trong payload đó bất cứ khi nào agent mở một file. Đây là cách một hosted model hoạt động, và đó là lý do bạn cần cân nhắc thư mục mà mình khởi chạy agent.

Các bản release hiện tại mặc định đính kèm một hậu tố chưa được chấp nhận của event log phiên làm việc vào các yêu cầu thông qua native DeepSeek adapter, bao gồm cả các gateway đã cấu hình, dưới dạng một trường dsh_session_log riêng biệt. Model không bao giờ thấy nội dung này, nhưng đích đến của yêu cầu sẽ nhận được nó. Hãy tắt nó trong Settings, General ("Upload Session Log when using the official model API"), hoặc đặt enabled: false trên plugin session-log-deepseek. Các thiết lập telemetry bên dưới không kiểm soát việc upload này.

Các profile được cung cấp sẵn cũng gửi tên và phiên bản của các plugin đang hoạt động thông qua native DeepSeek adapter trong một trường dsh_plugin_packages riêng biệt. Hãy đặt enabled: false trên plugin-package-inventory-deepseek để dừng việc này.

Với một nhà cung cấp catalog khác hoặc một company gateway, payload tương tự sẽ được gửi đến nhà cung cấp đó thay vì DeepSeek. Base URL cho bạn biết chính xác nơi dữ liệu được gửi đến.

Với một local endpoint, yêu cầu model được gửi đến 127.0.0.1:11434, nhưng địa chỉ loopback không đảm bảo dữ liệu chỉ nằm trên máy. Tài liệu của Ollama nêu rõ: "Để sử dụng các cloud model thông qua server này, hãy đăng nhập vào Ollama," vì vậy một cloud model được chọn thông qua cùng local server đó sẽ gửi prompt và code của bạn đến cloud của Ollama. Chỉ khi bản thân model chạy cục bộ thì yêu cầu model mới nằm lại trên máy. Tuy nhiên, vẫn có ba thứ đi qua mạng. npx tải package từ npm registry. Bất kỳ công cụ nào agent chạy đều có thể tự truy cập internet, bao gồm cả các server MCP (model context protocol) mà bạn đã kết nối, nội dung này được đề cập chi tiết tại chạy các MCP server trên một VPS. Một plugin cũng thuộc cùng danh mục đó, vì việc cài đặt một plugin đồng nghĩa với việc chạy code của tác giả khác với quyền hạn của agent, nên bạn cần kiểm tra những gì một plugin có thể truy cập trước khi cài đặt. Và telemetry, thứ mà các bản release hiện tại cho phép xuất sang DeepSeek bất cứ khi nào bạn gửi phản hồi, áp dụng cho cả local model lẫn hosted model.

Telemetry mặc định chỉ giới hạn ở phản hồi. DSH_TELEMETRY_MODE chọn chế độ, và trong cấu hình cơ sở mặc định hiện tại, giá trị không được thiết lập hoặc để trống sẽ mặc định là FEEDBACK_ONLY. Ở chế độ đó, các hoạt động thông thường không kích hoạt việc thu thập telemetry. Khi bạn gửi phản hồi bằng văn bản, tạo hoặc chỉnh sửa đánh giá, chỉnh sửa ghi chú, hoặc rút lại phản hồi, dsh cho phép xuất phần tiền tố của session-log chưa được gửi đến exporter, thông qua sự kiện phản hồi đó và bao gồm cả ngữ cảnh kế thừa, đến https://dsh-otel-collector.deepseeksvc.com/v1/logs. Việc gửi dữ liệu không đảm bảo thành công: một sự kiện quá lớn sẽ bị từ chối mà không bị cắt bớt, và các tiền tố lớn có thể vẫn còn gửi dang dở khi thoát CLI. Các batch đã được ủy quyền có thể tiếp tục gửi mà không cần tương tác hoặc gọi model thêm. README của telemetry nêu rằng điều này áp dụng "cho tất cả người dùng và nhà cung cấp", vì vậy việc chạy model cục bộ không tắt được tính năng này. DISABLED không xây dựng bất kỳ transport OpenTelemetry (OTel) nào. FULL không còn được chấp nhận: bất kỳ giá trị nào khác ngoài hai giá trị trên sẽ bị từ chối với unsupported mode. Một lần xuất phản hồi có thể chứa văn bản tin nhắn, đối số và kết quả công cụ, cũng như các đường dẫn workspace, vì vậy hãy coi việc gửi phản hồi là hành động cho phép gửi tiền tố phiên làm việc đó đến DeepSeek.

Để dừng triệt để mà không phụ thuộc vào việc thiết lập đúng chuỗi chế độ, hãy đặt DSH_TELEMETRY_DISABLED=1. Bất kỳ giá trị nào khác rỗng đều là hành động từ chối có thẩm quyền, bao gồm cả 0 và false, và nó được đọc trước khi quá trình chạy bắt đầu, vì vậy code dự án không thể bật lại nó giữa phiên làm việc. Địa chỉ collector mặc định là dsh-otel-collector.deepseeksvc.com; DSH_TELEMETRY_OTLP_URL sẽ ghi đè địa chỉ này.

Hãy xác minh thay vì tin tưởng vào thiết lập. Khi một tác vụ đang chạy, hãy liệt kê các kết nối outbound mà tiến trình đang giữ.

sudo ss -tnp | grep -i node

Với một model chạy cục bộ, lưu lượng model sử dụng cổng loopback 11434, nhưng các kết nối công cộng vẫn có thể xuất phát từ các công cụ mà không cần gửi phản hồi. Các profile được cung cấp sẵn bao gồm web search và fetch, và preset quyền mặc định không giới hạn truy cập mạng. Hãy xác định từng đích đến công cộng trước khi quy kết nó cho telemetry; chỉ dựa vào thời gian là không đủ để khẳng định một kết nối là xuất phản hồi. Snapshot này cũng có thể bỏ lỡ các kết nối tồn tại trong thời gian ngắn. Kiểm tra này chỉ bao gồm tiến trình dsh: lưu lượng của một cloud model rời đi từ Ollama server, vì vậy hãy xác nhận model id không phải là một cloud tag. Bất kỳ thứ gì khác đều cần được xác định trước khi bạn tiếp tục. Những gì một coding agent gửi về nhà thực hiện kiểm tra tương tự đối với các harness khác và giải thích cách đọc kết quả.

Nơi không nên lưu secret

  • Shell history. export DEEPSEEK_API_KEY=sk-... được ghi rõ dạng plaintext vào ~/.bash_history và vẫn nằm ở đó rất lâu sau khi bạn rotate key. Thêm một khoảng trắng trước command khi đã bật HISTCONTROL=ignorespace, hoặc bỏ qua shell và ghi thẳng giá trị vào một file có mode 600.
  • Dotfile đã commit. Key trong ~/.bashrc hoặc ~/.zshrc chỉ cần git add là có thể xuất hiện trong một public repository nếu bạn lưu dotfile trong git. Chạy git grep -I -n 'sk-' trong repository đó trước khi push.
  • File patch của profile. Dùng apiKeyEnv cho custom provider để cordis.patch.yml chỉ chứa tên biến thay vì secret. Config file thường bị dán vào issue report và support chat. Credentials file thì không.
  • Output của env và ảnh chụp terminal. Bất kỳ lệnh nào in toàn bộ environment cũng sẽ in cả key.
  • Backup. ~/.dsh đáng được backup, nhưng .credentials.yaml bên trong nó là một secret đang hoạt động. Loại file đó khỏi archive hoặc mã hóa archive.

Các quy tắc này không chỉ áp dụng cho dsh. không lưu secret trong file env của Compose cũng đề cập cùng vấn đề ở phía container trên cùng server đó.

Làm việc với bản preview của nhà phát triển

Cố định version đã kiểm thử, vì bản preview có thể thay đổi config key trong một bản patch release và provider của bạn sẽ không load được. Nếu bản cài đặt đã pin vẫn từ chối khởi động, hoặc npx liên tục cung cấp cho bạn một build không được yêu cầu, các lỗi cài đặt và version do bản preview tạo ra sẽ hướng dẫn xử lý npx cache và npm đi kèm với Node của bạn. Đưa thư mục home cordis.patch.yml và các file patch trong profiles/ vào version control, đồng thời loại trừ file credentials, để bạn thấy những gì đã thay đổi sau khi upgrade.

Hai flag hữu ích khi profile không hoạt động đúng. --dump-default-config in ra cấu hình mặc định đã ghép mà không boot, còn --dump-config in ra cấu hình đã ghép cho profile của bạn theo cùng cách. So sánh hai cấu hình này cho biết patch layer thực sự đã thay đổi gì, nhanh hơn so với đọc từng layer bằng tay.

dsh --profile web --dump-config

Khi có lỗi sau khi upgrade, hãy chạy lệnh đó trước. Một key đã được chuyển giữa các release sẽ xuất hiện dưới dạng branch bị thiếu trong bản dump, và cách sửa chỉ là chỉnh một dòng thay vì cài đặt lại.

FAQ

dsh lưu API key DeepSeek của tôi ở đâu?

Tại $DSH_HOME/.credentials.yaml, mặc định là ~/.dsh/.credentials.yaml trừ khi bạn tự thiết lập DSH_HOME. Trang Models ghi key vào đó, và các cài đặt của bạn chỉ giữ một tham chiếu đến nó, vì vậy thông tin bí mật chỉ nằm trong một file duy nhất. Kiểm tra quyền truy cập bằng stat -c '%a %n' ~/.dsh/.credentials.yaml và đặt thành 600 nếu quyền đang lỏng lẻo hơn. Một provider tùy chỉnh có thể tránh hoàn toàn việc dùng file này bằng cách đặt tên cho một biến môi trường với apiKeyEnv.

Làm thế nào để dsh dùng model cục bộ thay vì DeepSeek API?

Thêm một provider tùy chỉnh với base URL là endpoint tương thích OpenAI cục bộ của bạn. Với Ollama, đó là http://127.0.0.1:11434/v1, cùng với api: openai-completions và tên model id được sao chép chính xác từ ollama list. Cung cấp một giá trị API key không trống cho cấu hình này; server Ollama cục bộ sẽ bỏ qua nó. Xác nhận endpoint phản hồi bằng curl -s http://127.0.0.1:11434/v1/models trước khi bạn chỉnh sửa bất kỳ cấu hình dsh nào, vì một endpoint chết và một cấu hình sai sẽ tạo ra các lỗi tương tự nhau.

Theo mặc định, dsh có gửi code của tôi đi đâu không?

Với model được host, có. Prompt và nội dung các file mà agent đã đọc nằm trong yêu cầu API gửi đến nhà cung cấp đó, và các yêu cầu thông qua adapter DeepSeek gốc, bao gồm cả các gateway đã cấu hình, cũng mang theo hậu tố session-log theo mặc định cho đến khi bạn tắt tính năng upload đó trong Settings, General. Với model mà Ollama chạy cục bộ, yêu cầu đó đi đến loopback và nằm lại trên máy, nhưng một model đám mây như gemma4:cloud sẽ chuyển nó đến đám mây của Ollama thông qua cùng địa chỉ loopback đó. Các công cụ tìm kiếm và fetch web tích hợp sẵn, các công cụ khác và plugin có thể liên hệ với các dịch vụ công cộng độc lập với phản hồi. Telemetry là một luồng dữ liệu riêng biệt: trong các bản phát hành hiện tại, DSH_TELEMETRY_MODE sẽ phân giải thành FEEDBACK_ONLY khi chưa được thiết lập, vì vậy phản hồi sẽ cho phép xuất tiền tố session-log thông qua sự kiện đó, bao gồm cả ngữ cảnh kế thừa, cho mọi provider, kể cả các model cục bộ. Việc gửi dữ liệu không được đảm bảo, và các bản upload được ủy quyền có thể tiếp tục sau khi tương tác phản hồi kết thúc. Đặt thành DISABLED để không dùng exporter, hoặc đặt DSH_TELEMETRY_DISABLED=1 cho tùy chọn opt-out được đọc trước khi quá trình bắt đầu.

Tại sao dsh báo MISSING_CREDENTIAL khi biến của tôi đã được thiết lập?

Vì tham chiếu được đặt tên bởi apiKeyEnv phải phân giải được trong các nguồn credential của dsh. Các credential đã lưu có độ ưu tiên cao hơn môi trường khởi chạy, tiếp theo là .env và $DSH_HOME/.env của thư mục gọi. Một biến được export trong shell của bạn không truyền được đến một systemd service, phiên làm việc của người dùng khác, hoặc một tiến trình đã bắt đầu trước khi bạn export nó. Hãy đặt giá trị vào một EnvironmentFile với quyền 600 cho unit đó, hoặc export nó trong cùng shell khởi chạy dsh. Xác nhận những gì tiến trình đang chạy thực sự nắm giữ bằng sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ.

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

Node.js 24.9 hoặc mới hơn, theo package.json của repository tính đến ngày 5 tháng 11 năm 2026. Dòng 22 không còn được hỗ trợ, và Node 24.0 đến 24.8 cũng không đủ. Chạy node -v trước bất kỳ thao tác nào khác, vì lỗi khởi động từ một runtime không được hỗ trợ trông giống như một bản cài đặt bị hỏng và khiến người dùng cài đặt lại gói thay vì cài đặt lại runtime.

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