# dsh-image-gen: tạo và sửa ảnh ngay trong chat DeepSeek Harness — hướng dẫn cài đặt và dùng

> dsh-image-gen là plugin vẽ ảnh bằng AI chạy bên trong DeepSeek Harness (DSH). Bạn chỉ cần mô tả bằng lời để tạo ảnh, tạo cả loạt ảnh, sửa ảnh hoặc so sánh nhiều model. Cài bằng một lệnh pnpm, nhưng bạn cần có sẵn DSH và Node.js đúng phiên bản.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-24 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/dsh-image-gen-tao-sua-anh-trong-chat-deepseek-harness

dsh-image-gen là plugin tạo ảnh AI dành riêng cho DeepSeek Harness (gọi tắt là DSH). Nó cho phép bạn tạo ảnh, sửa ảnh và so sánh kết quả của nhiều model ngay trong khung chat, không phải mở thêm trang web nào khác.

Điểm khác của plugin này là nó dạy cho Agent biết cách vẽ. Bạn nói «cho bài viết này 4 ảnh minh họa, cùng phong cách phẳng, tỉ lệ 16:9» thì Agent tự chia thành 4 prompt rồi tạo lần lượt. Bạn khoanh một vùng trên ảnh rồi nói «đổi chỗ này thành cái rìu», Agent chỉ sửa đúng vùng đó. Ngoài chat còn có thư viện ảnh, bàn làm việc (Studio) để chỉnh thông số và kho hơn 500 prompt mẫu.

Người hợp nhất là chủ shop, nhân viên marketing hoặc người viết nội dung cần nhiều ảnh nhanh, và lập trình viên đã dùng DSH. Điểm đáng giá: nếu bạn đã có gói ChatGPT, Grok hoặc Google, bạn có thể đăng nhập để tạo ảnh mà không cần mua API key riêng. Repo hiện có khoảng 1388 sao và 116 fork, giấy phép Apache-2.0.

```repo
- repo | shanliuling/dsh-image-gen
- kind | Plugin
- desc | Plugin cho DeepSeek Harness: nói một câu là ra cả loạt ảnh, sửa ảnh theo vùng khoanh, kèm 500+ mẫu prompt, thư viện ảnh và hỗ trợ ComfyUI.
- stars | 1.4k
- lang | TypeScript
- license | Apache-2.0
```

## dsh-image-gen làm được gì

### Tạo cả loạt ảnh bằng một câu

Bạn nói số lượng và phong cách chung, Agent tự lên danh sách prompt rồi tạo từng ảnh. Mỗi lần tối đa 10 ảnh, và các ảnh nằm chung trong một câu trả lời. Nếu một ảnh lỗi thì các ảnh còn lại vẫn ra. Cuối cùng plugin báo «thành công X trên tổng Y» và nêu lý do ảnh nào thất bại. Cách này hợp với việc làm ảnh cho bài viết, ảnh cho bài đăng mạng xã hội hay loạt minh họa cùng chủ đề.

### Hiểu phác thảo và vùng khoanh trên canvas

Bạn vẽ nháp, đặt ảnh tham khảo hoặc khoanh một chỗ trên canvas vô hạn. Agent đọc được nội dung canvas và vùng bạn đang chọn, nên bạn không cần chụp màn hình hay tả vị trí. Có thể biến hình que thành nhân vật hoàn chỉnh, hoặc chỉ đổi đúng phần được khoanh.

### Giữ nhân vật nhất quán

Khi bạn yêu cầu «giữ nguyên nhân vật này», plugin cho model dùng lại đúng chủ thể trong ảnh tham chiếu, chỉ đổi bối cảnh, trang phục, tư thế hoặc phong cách. Nó không vẽ ra một người khác trông na ná.

### Ảnh GIF động và SVG

Với model hỗ trợ (README nhắc GPT Image 2.6), bạn nói «làm thành GIF» là có ảnh động lặp. Số khung dùng `frame_count` (2–16), thời gian mỗi khung dùng `frame_duration_ms` (20–2000 ms). Trong thẻ ảnh, bạn xem được GIF, chỉnh tốc độ và viết nhận xét theo từng khung để vẽ lại. Ngoài ra có thể yêu cầu xuất SVG (vector) với `output_format: "svg"`. Hai tính năng này chỉ dành cho OpenAI và các kênh trung gian tương thích OpenAI. SVG chỉ dùng cho tạo ảnh từ chữ, không dùng cho ảnh từ ảnh.

### Hơn 500 prompt mẫu, Agent tự tìm

Plugin có sẵn sổ tay phong cách vẽ tay (phong cách, bố cục, màu đơn sắc) cùng bộ mẫu awesome-gpt-image-2. Bạn nói «dùng phong cách #123» hay «làm kiểu infographic», Agent sẽ tìm mẫu trong kho rồi áp vào chủ đề của bạn. Bạn cũng có thể tự lướt, lọc, đánh dấu yêu thích trong giao diện. Ảnh mẫu được lưu cục bộ, và README nói việc xem, sao chép mẫu không tốn token hay lượt tạo ảnh.

### Studio, so sánh model và thư viện ảnh

Khi muốn tự chỉnh, mở **Thư viện → Studio** ở đầu cuộc trò chuyện. Bạn chọn Provider, model, tỉ lệ, chất lượng, watermark, tạo 1–4 ảnh ứng viên và chỉ lưu ảnh ưng ý. Bạn cũng có thể gọi nhiều model cùng lúc với cùng prompt để so sánh trên một canvas. Thư viện ảnh hỗ trợ tìm kiếm, lọc, yêu thích, tải về và quản lý hàng loạt, tách riêng theo từng workspace.

### ComfyUI chạy trên máy bạn

Nếu có ComfyUI cục bộ, bạn nhập nhiều workflow có tên và để Agent chọn theo tên. Workflow dùng các chỗ giữ chỗ như `{{prompt}}`, `{{seed}}`, `{{width}}`, `{{height}}`, và `{{image}}` cho ảnh tham chiếu. Lưu ý: ComfyUI chưa có trong Studio và chưa dùng được cho so sánh nhiều model.

## Cần chuẩn bị gì

- **DeepSeek Harness** bản ổn định. Plugin này không chạy độc lập.
- **Node.js** phiên bản `^22.19.0` hoặc `>= 24.0.0` (theo package.json và README).
- **pnpm**, vì các lệnh cài trong README đều dùng `pnpm dsh ...`.
- **Một nguồn tạo ảnh**, chọn một trong các cách sau:
  - API key của Provider bạn chọn: Google Gemini, OpenAI hoặc kênh tương thích OpenAI, ByteDance Seedream, Aliyun DashScope, xAI Grok Imagine, Zhipu GLM-Image.
  - Hoặc tài khoản ChatGPT, Grok hay Google đã đăng ký để đăng nhập, khỏi cần key.
  - Hoặc ComfyUI chạy trên máy, kèm file workflow ở định dạng API Format Workflow JSON. Phần cứng cụ thể (GPU) README không nói rõ.

README không nêu yêu cầu hệ điều hành riêng.

## Cài đặt từng bước

```steps
- Mở terminal đúng chỗ | Vào thư mục gốc của dự án DeepSeek Harness
- Thêm plugin | Chạy lệnh pnpm dsh plugin add
- Khởi động lại DSH | Để DSH nạp plugin mới
- Cấu hình Provider | Chọn nơi tạo ảnh, điền key hoặc đăng nhập
- Thử tạo ảnh | Gõ một câu mô tả trong chat
```

### Mở terminal ở thư mục dự án DSH

Bạn cần đứng ở thư mục gốc của dự án DeepSeek Harness đang dùng. Chỗ này người mới hay vấp: nếu mở terminal sai thư mục, lệnh sẽ không thấy dự án. Trên Windows, bạn có thể mở thư mục đó trong File Explorer rồi gõ PowerShell vào thanh địa chỉ.

### Thêm plugin

Chạy lệnh trong README:

```bash
pnpm dsh plugin --profile web add dsh-image-gen@latest
```

Lệnh này tải gói `dsh-image-gen` và gắn vào profile `web` của DSH. README còn gợi ý bạn có thể gửi nguyên câu «帮我安装生图插件，在终端执行：pnpm dsh plugin --profile web add dsh-image-gen@latest» cho Agent trong DSH để nó tự chạy.

Các cách cài khác trong README:

```bash
# Nếu đã cài dsh thành lệnh toàn hệ thống:
dsh plugin --profile web add dsh-image-gen@latest

# Cài trực tiếp từ GitHub (mã mới nhất):
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git

# Clone về máy để chỉnh sửa:
git clone https://github.com/shanliuling/dsh-image-gen.git
pnpm dsh plugin --profile web add ./dsh-image-gen
```

### Khởi động lại DSH

Sau khi cài, tắt hẳn rồi mở lại DSH (đúng profile bạn vừa thêm plugin). Bước này hay bị quên, và nó là lý do chính khiến bạn không thấy menu cấu hình.

### Cấu hình Provider

Trong DSH, bấm biểu tượng **Plugin** ở thanh bên trái, vào mục **Đã cài đặt**, chọn **dsh-image-gen**. Bạn sẽ thấy biểu mẫu «Tạo ảnh». README ghi rõ DSH bản 0.1.5 trở về trước không có bảng plugin, nên mục này nằm ở «Settings → Plugin → Cấu hình plugin → Tạo ảnh».

Ở đây bạn làm theo thứ tự:

1. Chọn Provider mặc định.
2. Điền API key của chính bạn, chỉnh model và Endpoint/Base URL nếu cần.
3. Bấm **Test kết nối** để kiểm tra, hoặc **Kéo danh sách model** để lấy toàn bộ model tạo ảnh của hãng đó.
4. Nếu dùng tài khoản ChatGPT/Grok/Google, mở dòng Provider đăng ký tương ứng, bấm **Đăng nhập** và cấp quyền trong trình duyệt.
5. Nếu dùng ComfyUI, điền địa chỉ mà DSH truy cập được và nhập file API Format Workflow JSON.

```note
API key là thông tin nhạy cảm. README nói key được lưu qua dịch vụ Credentials của DSH và trang cài đặt không hiện lại key. Dù vậy, đừng dán key vào chat hay đính kèm khi báo lỗi trên GitHub. Hãy để ý chi phí: mỗi ảnh tạo ra có thể bị tính phí theo nhà cung cấp bạn chọn.
```

### Thử tạo ảnh

Trong khung chat, gõ ví dụ:

```text
画一张雨夜霓虹街头的赛博朋克猫咪，电影感光线，16:9。
```

Bạn có thể viết bằng tiếng Việt, ý chính là mô tả chủ thể, phong cách và tỉ lệ khung hình.

## Kiểm tra đã chạy được chưa

Có ba dấu hiệu để biết cài thành công:

- Plugin `dsh-image-gen` xuất hiện trong bảng Plugin, mục Đã cài đặt (hoặc trong mục cấu hình cũ nếu DSH là bản 0.1.5 trở về trước).
- Nút **Test kết nối** báo kết nối được với Provider bạn chọn.
- Bạn gõ một câu mô tả và ảnh hiện ra trong khung chat.

Nếu không thấy plugin, README hướng dẫn kiểm tra cấu hình:

```bash
dsh --profile web --dump-config
```

Nếu đầu ra không có `dsh-image-gen`, hãy chạy lại lệnh cài rồi khởi động lại DSH.

## Dùng vào việc thật

### Chủ shop làm ảnh minh họa cho bài viết

Bạn bán đồ cắm trại và cần 5 ảnh cho một bài đăng. Trong chat, bạn gõ gần giống ví dụ của README:

```text
Giúp mình làm 5 ảnh cho bài《Danh sách đồ cắm trại cuối tuần》: lều, bếp, túi ngủ, đèn, đồ ăn vặt, cùng phong cách vẽ tay Nhật, tỉ lệ 3:4.
```

Agent chia thành 5 prompt rồi tạo lần lượt. Kết quả là cả 5 ảnh trong một câu trả lời, và nếu một ảnh lỗi thì các ảnh khác không bị ảnh hưởng. Số lượng tối đa mỗi lần là 10, vượt quá thì plugin nhắc Agent chia thành nhiều lượt.

> Một câu nói, cả một loạt ảnh cùng phong cách — bạn chỉ việc chọn ảnh vừa ý.
>
> — Ông T

### Nhân viên marketing sửa riêng một chi tiết

Bạn có ảnh nhân vật cầm kiếm và muốn đổi thành cái rìu mà giữ nguyên mọi thứ khác. Dùng canvas để khoanh vùng cây kiếm, rồi nhắn:

```text
Đổi cây kiếm tôi khoanh thành một chiếc rìu, giữ nguyên phần còn lại.
```

Agent xác nhận vật được khoanh rồi chỉ sửa chỗ đó. Mỗi bước đều nằm lại trên canvas nên bạn có thể quay về bản trước và đi tiếp từ đó. Nếu muốn nhân vật không đổi mặt khi đổi bối cảnh, bạn nói: «Giữ nguyên nhân vật, cho vào cảnh tuyết».

### Chọn model nào đẹp nhất cho cùng một prompt

Bạn đã cấu hình hai Provider và muốn xem cái nào hợp thương hiệu hơn. Dùng Studio, hoặc nhờ ngay trong chat: «Cùng một prompt, GPT và Gemini mỗi bên một ảnh để so sánh». Plugin gọi các model cùng lúc và đặt kết quả cạnh nhau trên một canvas. Bạn chọn ảnh ưng ý rồi lưu hàng loạt vào thư viện. Lưu ý: so sánh chỉ dùng được với Provider đám mây và các model đã cấu hình sẵn.

### Lập trình viên làm ảnh động hoặc dùng ComfyUI riêng

Với người có GPU và ComfyUI, bạn nhập workflow có tên (ví dụ một workflow cho ảnh sản phẩm), đặt `{{prompt}}` vào node chữ rồi nhờ Agent: «Dùng workflow này tạo 4 biến thể». Còn nếu cần ảnh động, hãy chọn Provider OpenAI hoặc kênh tương thích hỗ trợ GIF và nói: «Làm nhân vật này thành GIF vẫy tay, 8 khung». Kết quả là ảnh GIF phát ngay trong thẻ, bạn chỉnh tốc độ và có thể viết nhận xét theo từng khung để vẽ lại.

## Lỗi hay gặp và cách xử lý

### Không thấy mục «Tạo ảnh»

Vị trí menu phụ thuộc vào phiên bản DSH (như đã nói ở trên). Hãy tắt hẳn profile DSH rồi mở lại, sau đó chạy `dsh --profile web --dump-config` và kiểm tra có `dsh-image-gen` hay không. Nếu không có, chạy lại lệnh cài. Khi báo lỗi, hãy kèm phiên bản DSH, phiên bản plugin và log, nhưng không đính kèm API key.

### Lệnh cài báo lỗi hoặc không chạy

Kiểm tra phiên bản Node theo yêu cầu (`^22.19.0` hoặc `>= 24.0.0`), kiểm tra đã cài pnpm, và chắc chắn bạn đang đứng trong thư mục dự án DSH. Tôi không có thông tin chi tiết hơn về các thông báo lỗi cụ thể, nên hãy xem phần CONTRIBUTING.md hoặc mục Issues của repo.

### Test kết nối không thành công

Thường do key sai, thiếu quyền, hoặc địa chỉ Endpoint/Base URL không đúng. Hãy dán lại key, kiểm tra model và địa chỉ. Với Gemini qua trạm trung gian chỉ hỗ trợ generateContent, README hướng dẫn đổi «giao thức yêu cầu» sang «原生 generateContent» (tương ứng `googleNative: true`) và điền địa chỉ gốc API của trạm, ví dụ `https://your-relay.example/v1beta`.

### Yêu cầu GIF hoặc sửa ảnh không chạy

GIF chỉ dùng với OpenAI chính hãng và kênh tương thích, cần model và trạm trung gian hỗ trợ. Kênh đăng ký ChatGPT hiện chưa hỗ trợ GIF. Zhipu GLM-Image không có ảnh-sang-ảnh, và Grok Imagine chỉ hỗ trợ sửa ảnh ở mức hạn chế. Hãy đổi sang Provider có dấu ✅ trong bảng hỗ trợ của README.

### ComfyUI không xuất hiện trong Studio

Đây là giới hạn hiện tại, không phải lỗi cài đặt. Studio và so sánh nhiều model mới chỉ có cho Provider đám mây. ComfyUI vẫn dùng được trong chat để tạo ảnh, sửa ảnh và tạo hàng loạt.

## Có nên dùng không

**Điểm mạnh:** Bạn tạo ảnh ngay trong chat mà không phải chuyển công cụ. Tạo cả loạt ảnh, sửa theo vùng khoanh, giữ nhân vật nhất quán, GIF, kho prompt và thư viện ảnh là bộ tính năng khá đầy đủ. Plugin hỗ trợ nhiều nhà cung cấp, cho phép đăng nhập bằng gói đăng ký có sẵn, và có ComfyUI nếu bạn muốn chạy cục bộ. Giấy phép Apache-2.0 và repo vẫn được cập nhật trong 3 tháng gần đây.

**Giới hạn:**

- Bạn phải dùng DeepSeek Harness. Plugin không thay thế được công cụ tạo ảnh độc lập.
- Mỗi lượt hàng loạt tối đa 10 ảnh.
- Prompt và ảnh tham chiếu được gửi tới Provider bạn chọn, nên hãy cân nhắc với ảnh có thông tin nhạy cảm và tuân thủ điều khoản của nhà cung cấp.
- README nêu rõ việc tải ảnh từ upstream hiện chưa có đầy đủ cơ chế hạn chế SSRF; hai tùy chọn tăng cường `strictImageDownloads` và `requireHostAdmission` đều mặc định tắt.
- Tài liệu và giao diện chủ yếu bằng tiếng Trung và tiếng Anh. Studio và so sánh model chưa hỗ trợ ComfyUI.

**Khi nên chọn cách khác:** nếu bạn không dùng DSH, hay chỉ cần vài ảnh lẻ thì dùng thẳng công cụ tạo ảnh của nhà cung cấp sẽ đơn giản hơn. Còn nếu thường xuyên cần ảnh cho bài viết, mạng xã hội hoặc sản phẩm và đã ở trong DSH, plugin này đáng thử.

## Câu hỏi thường gặp

### dsh-image-gen có miễn phí không?

Plugin mở mã nguồn theo giấy phép Apache-2.0. Nhưng việc tạo ảnh có thể tốn phí theo nhà cung cấp bạn chọn (API key hoặc gói đăng ký). README không có bảng giá, nên bạn cần xem điều khoản từng nhà cung cấp.

### Tôi có cần GPU không?

Không cần nếu dùng Provider đám mây như Gemini, OpenAI, Seedream. Chỉ khi chạy ComfyUI trên máy bạn mới cần sức mạnh GPU tại máy đó, nhưng README không nêu cấu hình cụ thể.

### Có dùng được mà không mua API key không?

Có. README nói nếu bạn đã có gói ChatGPT, Grok hoặc Google, bạn có thể bấm Đăng nhập ở dòng Provider đăng ký tương ứng và cấp quyền trong trình duyệt để tạo ảnh, không cần key riêng.

### Plugin chạy được trên Windows không?

README không nêu yêu cầu hệ điều hành riêng. Yêu cầu được ghi là DeepSeek Harness bản ổn định và Node.js ^22.19.0 hoặc >= 24.0.0, cùng pnpm để chạy lệnh cài.

### Dữ liệu và ảnh của tôi có an toàn không?

README ghi API key và token đăng nhập được lưu qua dịch vụ Credentials của DSH và không hiện lại key trên trang cài đặt. Tuy nhiên prompt và ảnh tham chiếu vẫn được gửi tới Provider bạn chọn, và việc tải ảnh từ upstream chưa có cơ chế chặn SSRF đầy đủ. Dùng ComfyUI cục bộ thì yêu cầu chỉ gửi đến địa chỉ bạn tự cấu hình.

### Một lần tạo được tối đa bao nhiêu ảnh?

Chế độ hàng loạt trong chat tối đa 10 ảnh mỗi lần gọi. Nếu bạn yêu cầu nhiều hơn, plugin sẽ nhắc Agent chia thành nhiều lượt. Studio tạo 1–4 ảnh ứng viên mỗi lần.

### Khác gì so với tự dùng ComfyUI hay công cụ tạo ảnh trên web?

dsh-image-gen đưa việc tạo ảnh vào trong chat của DSH, nên Agent có thể lên kế hoạch cả loạt ảnh, đọc canvas và áp prompt mẫu. Nó cũng gom nhiều Provider và cả ComfyUI vào một chỗ. README không so sánh trực tiếp với công cụ khác.
