--- license: mit language: - vi - en tags: - deepseek-harness - dsh - portable - offline - windows - agent --- # DSH-AIO — DeepSeek Harness portable (Windows x64, offline) Bản đóng gói sẵn của [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh` 0.2.1-rc.5) chạy **không cần Internet, không cần quyền admin, không cài đặt gì**. Nén cả thư mục sang máy khác là dùng được. | | | |---|---| | **File** | `DSH-AIO-portable-win-x64.zip` (346 MB) | | **SHA256** | `f95e6206a60ce07e8cab9007a4843598dd07e616b2cfeef79f5b5757ba1d809a` | | **Yêu cầu** | Windows 10 22H2 / Windows 11 x64, Windows PowerShell 5.1 (có sẵn), trình duyệt bất kỳ | **Hướng dẫn kèm theo (cùng cấp với file zip):** - [`SKILLS_SETUP.md`](SKILLS_SETUP.md): 67 skill thiết kế UI đi kèm, cách bớt/thêm/kiểm tra skill. - [`PLUGINS_SETUP.md`](PLUGINS_SETUP.md): plugin đi kèm, bật/tắt, cách kiểm tra mạng và thêm plugin mới. ## Dùng 1. Giải nén vào **đường dẫn ngắn**, ví dụ `D:\dsh` (đường dẫn tương đối dài nhất ~175 ký tự; tổng không quá 259 ký tự nếu Windows chưa bật LongPaths). 2. Double-click **`Start-DeepseekHarness.cmd`**. Trình duyệt tự mở Web UI tại `http://127.0.0.1:3080`. Đóng cửa sổ console để dừng. 3. Lần đầu **không cần file cấu hình**: vào *Settings → Models → Add model provider → Custom model API*, nhập base URL, protocol, API key, model rồi chọn model ở khung chat. Muốn cấu hình sẵn (triển khai hàng loạt): copy `config\internal-api.env.sample` thành `config\internal-api.env`, điền `BASE_URL`, `API_KEY`, `MODEL_ID`, `API_PROTOCOL` (`openai-completions` | `openai-responses` | `anthropic-messages`), rồi chạy `Reset-Config.cmd`. Model OpenAI mới (ví dụ `gpt-6-*`) cần `openai-responses` để dùng function tools. **Mạng (mặc định):** launcher luôn xoá biến proxy kế thừa từ máy để mọi lời gọi đi thẳng tới API, và **bỏ qua kiểm tra chứng chỉ SSL** (hợp với gateway nội bộ dùng cert tự ký). Bật lại kiểm tra bằng `VERIFY_TLS=1` (kèm `NODE_EXTRA_CA_CERTS` nếu dùng CA nội bộ) trong `config\internal-api.env`. Mọi dữ liệu (cấu hình, session, workspace) nằm trong thư mục `data\` của gói, không ghi vào `%USERPROFILE%`. Telemetry của dsh bị tắt. ## Plugin và skill đi kèm (bản công khai) Đã đọc mã nguồn và kiểm tra: không gọi mạng ngoài khi chạy; bộ kiểm thử tự động xác nhận **0 kết nối TCP ngoài loopback**. | Plugin | Ghi chú | |---|---| | `dsh-better-sidebar` 0.28.2 | Sidebar: file tree, editor, terminal, Git, side chat | | `@akshaydev17/dsh-spotlight` 0.0.3 | Command palette (`Ctrl+K`); bản fork vì bản gốc import `schemastery` không scope nên không chạy với dsh | | `@nanmicoder/dsh-agent-teams` 0.1.28 | Multi-agent | | `dsh-browser-cdp` 1.7.5 | Điều khiển Chrome/Edge **có sẵn trên máy** qua CDP (không kèm trình duyệt); các công cụ mở rộng bật mặc định, xem `PLUGINS_SETUP.md` mục 4 | | `dsh-office-toolkit` 0.3.33 | Đọc/sửa Word, Excel, đọc PDF (không có PowerPoint) | Cài sẵn nhưng **tắt**: `dsh-office-tools` (có PowerPoint nhưng `excel_update` làm hỏng kiểu ô số), `@deepseek-ai/dsh-subagent-claude-code` (cần Claude Agent SDK). **Skill:** 67 skill thiết kế UI từ [bergside/awesome-design-skills](https://github.com/bergside/awesome-design-skills) (MIT) được nạp mặc định; mỗi request tốn thêm khoảng 2,4 nghìn token cho danh sách skill, nên nên bớt những skill không dùng (xem `SKILLS_SETUP.md`). **Không kèm trong bản công khai** (giấy phép): `dsh-deepseek-splash` (repo gốc không có LICENSE) và `@anthropic-ai/claude-agent-sdk` + `claude.exe` (bản quyền Anthropic, không được phát hành lại). **Đã loại:** `dsh-market`, `TencentDB-Agent-Memory` (cần mạng ngoài), `dsh-tui` (không tương thích rc.5). Không dùng được khi offline: plugin market / `dsh plugin`, tool `web_fetch` / `web_search`, MCP từ xa. Agent chạy lệnh qua PowerShell (không kèm bash/git). ## Bên trong gói `README.md` đầy đủ, `SECURITY-REVIEW.md` (rà soát bảo mật và chống rò rỉ), `docs\` (gồm `THEM-PLUGIN.md`), `scripts\verify-offline.ps1` (22 kiểm tra tự động), `scripts\verify-leak.ps1`, `scripts\build-portable.ps1` (dựng lại từ `package-lock.json`, cần Internet) và `scripts\pack.ps1`. ## Đã test / chưa test - Đã test: Windows 11; chạy offline (proxy chết, `PATH` tối thiểu); giải nén sang đường dẫn khác có dấu cách; chat thật qua Responses API (tạo/đọc file); plugin kích hoạt và tải được. - **Chưa test trên Windows 10 thật**; chưa test điều khiển trình duyệt thực tế bằng `dsh-browser-cdp`. ## An toàn DeepSeek Harness là phần mềm thử nghiệm (developer preview): agent có thể chạy lệnh và đọc/ghi file, và sandbox trên Windows chỉ giới hạn *ghi*. Đọc `SECURITY-REVIEW.md` trong gói và [SAFETY.md](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md) trước khi dùng; chỉ đặt API key thật trên máy tin cậy. ## Giấy phép Script, mẫu cấu hình và tài liệu hướng dẫn do repo này tự viết được phát hành theo giấy phép **MIT** (xem [`LICENSE`](LICENSE)). Các thành phần bên thứ ba trong gói (`node_modules\`, `runtime\node\`, DeepSeek Harness, plugin, skill…) **giữ nguyên giấy phép riêng** của từng thành phần (xem file `LICENSE` trong thư mục của chúng); giấy phép MIT ở đây không thay đổi điều đó.