# dsh-image-gen: vẽ 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 AI dành cho DeepSeek Harness (DSH). Bạn nói bằng tiếng thường trong khung chat, Agent sẽ tạo ảnh, sửa ảnh, làm cả loạt ảnh hoặc GIF. Cài bằng một dòng lệnh, nhưng bạn cần có sẵn DeepSeek Harness và Node.js đủ phiên bản.

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

`dsh-image-gen` là plugin tạo và chỉnh sửa ảnh AI cho DeepSeek Harness (gọi tắt là DSH). Cài xong, bạn không cần mở trang web vẽ ảnh nào khác. Bạn gõ yêu cầu ngay trong khung chat, Agent của DSH sẽ tự gọi mô hình vẽ ảnh và trả ảnh về cho bạn.

Plugin này hợp với người làm nội dung, chủ shop cần ảnh minh hoạ, nhân viên văn phòng làm slide, và lập trình viên đã dùng DSH. Điểm đáng giá nhất là Agent "biết vẽ" thật sự. Nó làm được một loạt ảnh từ một câu nhắc, đọc được nét vẽ và vùng bạn khoanh trên canvas, và tự tìm mẫu prompt trong thư viện hơn 500 mẫu.

Repo hiện có khoảng 1.415 sao và 121 fork, viết bằng TypeScript, giấy phép Apache-2.0 và vẫn được cập nhật trong vài tháng gần đây. Tài liệu gốc viết bằng tiếng Trung và có bản tiếng Anh. Bài này tóm lại những phần bạn cần để cài và dùng.

```repo
- repo | shanliuling/dsh-image-gen
- kind | Plugin
- desc | Plugin cho DeepSeek Harness: tạo, sửa, so sánh ảnh AI ngay trong khung chat, có 500+ prompt mẫu, GIF, 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 từ một câu.** Bạn nói số lượng và phong cách chung, ví dụ "5 ảnh minh hoạ, cùng phong cách vẽ tay". Agent tự chia thành từng prompt và tạo lần lượt. Mỗi lần gọi tối đa 10 ảnh. Nếu một ảnh lỗi, các ảnh còn lại vẫn ra bình thường. Cuối cùng Agent báo "thành công X trên tổng Y" kèm lý do của ảnh lỗi.

**Canvas hiểu được nét vẽ.** Bạn vẽ phác thảo, đặt ảnh tham khảo hoặc khoanh vùng cần sửa trên canvas. Agent nhìn thấy nội dung canvas và vùng bạn đang chọn, nên bạn khỏi chụp màn hình hay mô tả vị trí. Ví dụ: khoanh thanh kiếm rồi nói "đổi thành cái rìu", chỉ chỗ khoanh bị thay.

**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 bảo mô hình dùng đúng chủ thể trong ảnh tham chiếu. Chỉ bối cảnh, trang phục, tư thế hoặc phong cách được đổi. Nhờ vậy bạn không nhận về một người "na ná".

**Tạo ảnh GIF.** Với mô hình hỗ trợ động như GPT Image 2.6, bạn nói "làm thành GIF" là có ảnh động lặp. Bạn chỉnh được số khung (`frame_count`, từ 2 đến 16) và thời gian mỗi khung (`frame_duration_ms`, từ 20 đến 2000 ms). Thẻ ảnh trong chat phát được GIF, đổi tốc độ và viết nhận xét theo từng khung để sửa. Chỉ kênh OpenAI và kênh tương thích OpenAI hỗ trợ tính năng này.

**Xuất SVG.** Với kênh OpenAI chính thức hoặc kênh tương thích, bạn có thể yêu cầu kết quả vector khi tạo ảnh từ chữ. Ảnh vector phóng to không vỡ. Chế độ sửa ảnh (đưa ảnh vào để sửa) chưa hỗ trợ SVG.

**Hơn 500 prompt mẫu.** Plugin có sẵn cẩm nang phong cách vẽ tay và bộ ví dụ awesome-gpt-image-2. Bạn nói "dùng phong cách số 123" hoặc "làm dạng infographic", Agent sẽ tìm mẫu rồi áp vào chủ đề của bạn. Việc duyệt và sao chép mẫu không tốn token hay hạn mức tạo ảnh.

**Studio, so sánh mô hình, thư viện ảnh.** Nếu thích tự chỉnh thông số, bạn mở mục Thư viện, rồi vào Studio. Ở đó bạn chọn mô hình, tỉ lệ, chất lượng, và tạo 1–4 ảnh ứng viên rồi chỉ lưu ảnh ưng ý. Bạn cũng có thể chạy cùng một prompt trên nhiều mô hình để so sánh trên một canvas. Thư viện có tìm kiếm, lọc, yêu thích, tải về và quản lý hàng loạt.

**Hỗ trợ ComfyUI trên máy bạn.** Bạn nhập nhiều workflow có tên riêng, rồi nhờ Agent chọn theo tên để tạo ảnh từ chữ, từ ảnh hoặc tạo hàng loạt. Lưu ý: ComfyUI chưa có trong Studio và phần so sánh mô hình.

**Nhiều nhà cung cấp.** Gemini, OpenAI và kênh tương thích OpenAI, Seedream, DashScope (Qwen Image), Grok Imagine, GLM-Image và ComfyUI. Nếu bạn đã có gói ChatGPT, Grok hoặc Google, bạn có thể đăng nhập bằng tài khoản mà không cần API Key.

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

Theo tư liệu, bạn cần:

- **DeepSeek Harness bản ổn định.** Plugin này chạy bên trong DSH, không chạy riêng lẻ.
- **Node.js `^22.19.0` hoặc `>= 24.0.0`.** Đây là yêu cầu trong `package.json`.
- **Công cụ `pnpm`.** Lệnh cài trong README dùng `pnpm`. README không hướng dẫn cài pnpm, nên bạn tự cài theo trang chủ của pnpm nếu máy chưa có.
- **Một đường truy cập dịch vụ vẽ ảnh.** Hoặc API Key của nhà cung cấp bạn chọn, hoặc tài khoản ChatGPT, Grok, Google để đăng nhập. Nếu dùng ComfyUI thì cần địa chỉ ComfyUI mà DSH truy cập được.
- **Hệ điều hành và phần cứng.** Tư liệu không nêu yêu cầu riêng. Nếu chỉ gọi dịch vụ đám mây thì không có yêu cầu GPU nào được ghi. Chỉ khi dùng ComfyUI cục bộ thì bạn cần sức mạnh GPU của máy chạy ComfyUI.

```note
API Key là chìa khoá tính tiền của bạn. Chỉ nhập vào form cấu hình của plugin, không dán vào chat, không gửi lên Issue. Mỗi lần tạo ảnh qua API Key có thể tốn phí theo bảng giá của nhà cung cấp. Mức phí cụ thể tư liệu không nêu, bạn xem trên trang của nhà cung cấp.
```

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

```steps
- Mở terminal | Vào thư mục gốc của dự án DeepSeek Harness
- Chạy lệnh cài | Thêm plugin dsh-image-gen vào profile web
- Khởi động lại DSH | Để DSH nạp plugin mới
- Cấu hình nhà cung cấp | Chọn Provider, nhập Key hoặc đăng nhập tài khoản
- Thử tạo ảnh | Gõ một câu mô tả ngay trong chat
```

### Mở terminal đúng chỗ

Lệnh cài phải chạy trong thư mục gốc của dự án DeepSeek Harness của bạn. Đây là chỗ người mới hay vấp: chạy sai thư mục thì lệnh `pnpm dsh` không tìm thấy gì. Trên Windows, bạn mở PowerShell hoặc terminal trong thư mục đó. Trên macOS hoặc Linux, bạn mở Terminal rồi `cd` vào thư mục đó.

### Chạy lệnh cài plugin

Đây là lệnh chính trong README:

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

Lệnh này gọi `dsh` thông qua `pnpm`, thêm plugin `dsh-image-gen` bản mới nhất vào profile `web`. README còn gợi ý bạn có thể gửi cho Agent trong DSH câu sau để nó tự chạy lệnh:

```text
帮我安装生图插件，在终端执行：pnpm dsh plugin --profile web add dsh-image-gen@latest
```

Nếu bạn đã cài `dsh` thành lệnh toàn cục, README cho phép bỏ `pnpm`:

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

Bạn cũng có thể cài thẳng từ GitHub để lấy mã mới nhất:

```bash
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
```

Hoặc tải mã nguồn về máy rồi cài từ thư mục cục bộ, hợp khi bạn muốn đọc hoặc sửa mã:

```bash
git clone https://github.com/shanliuling/dsh-image-gen.git
pnpm dsh plugin --profile web add ./dsh-image-gen
```

Lưu ý: lệnh thứ hai phải chạy ở thư mục chứa thư mục `dsh-image-gen` vừa clone, chứ không phải bên trong nó.

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

Sau khi cài, hãy khởi động lại DSH. README nói rõ bước này trước khi mở cấu hình. Nếu plugin chưa hiện, hãy thoát hẳn profile đang chạy rồi mở lại.

### Cấu hình nhà cung cấp

Trong DSH, bấm biểu tượng **Plugin** ở thanh bên trái, vào mục **Đã cài đặt**, rồi bấm **dsh-image-gen**. Bạn sẽ thấy form "Image generation" (图像生成). Làm như sau:

- Chọn Provider mặc định.
- Nhập API Key của chính bạn, rồi chỉnh mô hình, Endpoint hoặc Base URL nếu cần.
- Bấm **Test connection** (测试连接) để kiểm tra Key. Bấm **Fetch models** (拉取模型) để lấy danh sách mô hình vẽ ảnh của nhà cung cấp, đỡ phải tra tài liệu.
- Nếu dùng tài khoản ChatGPT, Grok hoặc Google, bạn không điền Key. Mở dòng Provider đăng nhập tương ứng, bấm **Login** (登录) rồi cấp quyền trên trình duyệt.
- Nếu dùng ComfyUI, điền địa chỉ ComfyUI mà DSH truy cập được và nhập workflow ở định dạng **API Format Workflow JSON**.

Nếu DSH của bạn là bản 0.1.5 trở về trước thì chưa có bảng Plugin. Khi đó bạn vào **Settings → Plugins → Plugin config → Image generation** (設置 → 插件 → 插件配置 → 图像生成).

### Nâng cấp sau này

Để lên bản mới, bạn chạy lại đúng lệnh cài ở trên rồi khởi động lại profile DSH.

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

Có ba cách kiểm tra, theo thứ tự dễ đến kỹ:

1. Mở bảng Plugin trong DSH. Nếu thấy **dsh-image-gen** trong mục "Đã cài đặt" là plugin đã được nạp.
2. Trong form cấu hình, bấm **Test connection**. Nếu báo kết nối được thì Key hoặc đăng nhập đã đúng.
3. Gõ thử trong chat:

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

Bạn cũng có thể viết bằng tiếng Việt, ví dụ "vẽ chú mèo cyberpunk trên phố đêm mưa, ánh sáng điện ảnh, tỉ lệ 16:9". Ảnh xuất hiện trong khung chat là đã chạy.

Nếu không thấy mục cấu hình, README hướng dẫn kiểm tra cấu hình bằng lệnh sau:

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

Nếu kết quả không có `dsh-image-gen`, bạn chạy lại lệnh cài.

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

### Chủ shop cần bộ ảnh cho bài đăng

Bạn bán đồ cắm trại và muốn viết bài về "danh sách đồ đi cắm trại cuối tuần". Thay vì tìm từng ảnh, bạn gõ trong chat (ví dụ lấy từ README):

```text
给我的小红书笔记《周末露营清单》配 5 张图：帐篷、炉具、睡袋、照明、零食，统一日系手绘风，3:4。
```

Bạn có thể viết bằng tiếng Việt với nội dung tương tự: số ảnh, chủ đề từng ảnh, phong cách chung, tỉ lệ khung. Agent chia thành năm prompt, tạo lần lượt và gửi cả bộ trong một tin nhắn. Ảnh nào lỗi sẽ được báo riêng để bạn yêu cầu làm lại.

> Một câu nói đủ số lượng, phong cách và tỉ lệ là đã có cả bộ ảnh, không cần xin từng tấm.
>
> — Ông T

### Nhân viên văn phòng cần chỉnh một chi tiết

Bạn đã có ảnh nhân vật cho slide và chỉ muốn thêm kính râm. Bạn tải ảnh lên chat và gõ:

```text
保持角色与构图不变，给猫咪戴上一副黑色墨镜。
```

Kết quả là ảnh mới giữ nhân vật và bố cục, chỉ thêm chi tiết bạn nhờ. Muốn sửa tiếp, bạn nói thêm một câu. Plugin cho bạn chuyển qua lại giữa các phiên bản của cùng một ảnh.

### Người làm thiết kế cần phác thảo thành ảnh hoàn chỉnh

Bạn mở canvas, vẽ vội hình người que cầm kiếm rồi chọn nó. Sau đó bạn nói "vẽ thành nhân vật hoạt hình". Agent đọc phần bạn chọn và tạo ảnh theo tư thế, bố cục của nét vẽ. Nếu muốn đổi riêng thanh kiếm, bạn khoanh nó bằng bút và nói "đổi thành cái rìu". Chỉ vùng khoanh bị thay.

### Lập trình viên so sánh mô hình hoặc dùng ComfyUI

Bạn đang cân nhắc nên dùng mô hình nào. Bạn mở Studio, nhập một prompt rồi chạy cùng lúc trên nhiều mô hình để so sánh trên một canvas, và chỉ lưu ảnh ưng ý. Mô hình được gọi là các mô hình bạn đã cấu hình cho từng Provider. Nếu bạn có ComfyUI cục bộ, bạn nhập workflow có placeholder `{{prompt}}`, `{{seed}}`, `{{width}}`, `{{height}}` rồi nhờ Agent "dùng workflow tên X" ngay trong chat. Với ảnh gốc, bạn đặt `{{image}}` trong node LoadImage.

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

### Không thấy plugin hoặc mục cấu hình

Nguyên nhân thường là chưa khởi động lại DSH, hoặc bạn đang dùng bản DSH cũ có vị trí cấu hình khác. Hãy thoát hẳn profile rồi mở lại, kiểm tra cả hai vị trí cấu hình nói ở trên, rồi chạy `dsh --profile web --dump-config`. Nếu không có `dsh-image-gen` thì chạy lại lệnh cài.

### Lệnh `pnpm` hoặc `dsh` không nhận

Nếu terminal báo không tìm thấy `pnpm`, bạn chưa cài pnpm. Nếu `pnpm dsh` báo lỗi, rất có thể bạn chưa đứng trong thư mục gốc của dự án DeepSeek Harness. Hãy `cd` đúng thư mục rồi chạy lại. Kiểm tra thêm bản Node.js phải thuộc `^22.19.0` hoặc từ 24.0.0 trở lên.

### Test connection thất bại

Kiểm tra lại API Key (có thừa khoảng trắng không), Endpoint hoặc Base URL, và tên mô hình. Bạn có thể bấm "Fetch models" để lấy đúng tên mô hình. Nếu dùng kênh trung gian, hãy chắc chắn nó hỗ trợ đúng loại yêu cầu bạn cần. Chẳng hạn, tạo GIF và sửa ảnh bằng GIF cần trung gian hỗ trợ.

### Một số ảnh trong cả loạt bị lỗi

Đây là hành vi có chủ ý. Mỗi ảnh tạo độc lập, nên ảnh lỗi không làm hỏng các ảnh còn lại. Bạn nhìn danh sách lý do lỗi mà Agent báo rồi yêu cầu làm lại ảnh đó. Nếu bạn xin trên 10 ảnh, Agent sẽ được nhắc chia thành nhiều lần gọi.

### Không thấy ComfyUI trong Studio

Đây không phải lỗi. README ghi rõ ComfyUI hiện chưa có trong Studio và phần so sánh mô hình. Bạn dùng ComfyUI qua chat với Agent.

### Tải ảnh qua proxy bị chặn khi bật chế độ siết bảo mật

Plugin có hai tuỳ chọn tăng bảo mật, mặc định tắt: `strictImageDownloads` và `requireHostAdmission`. README cảnh báo rằng nếu bạn dùng proxy TUN hoặc bộ phân giải DNS riêng của doanh nghiệp, việc bật các tuỳ chọn này có thể gây lỗi vì chúng giả định đường ra mạng là kết nối trực tiếp. Nếu gặp tình huống này, hãy tắt tuỳ chọn đó.

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

**Điểm mạnh.** Bạn làm mọi thứ ngay trong chat: tạo, sửa, làm hàng loạt, GIF. Plugin có sẵn thư viện hơn 500 prompt mẫu, canvas đọc được nét vẽ, thư viện ảnh và so sánh mô hình. Nó hỗ trợ nhiều nhà cung cấp. Bạn dùng được cả tài khoản đăng ký sẵn mà không cần Key, và cả ComfyUI cục bộ. Mã nguồn mở theo Apache-2.0.

**Giới hạn.** Plugin chỉ chạy trong DeepSeek Harness, nên nếu bạn không dùng DSH thì không dùng được. Tài liệu chủ yếu bằng tiếng Trung và tiếng Anh. Một số tính năng bị giới hạn theo nhà cung cấp: GIF chỉ có ở OpenAI và kênh tương thích, GLM-Image không sửa ảnh, ComfyUI chưa vào Studio. Về dữ liệu, prompt và ảnh tham chiếu được gửi đến nhà cung cấp bạn chọn, nên bạn cần đọc điều khoản của họ. README cũng nói thẳng là chưa có cơ chế giới hạn SSRF đầy đủ khi tải ảnh từ bên thứ ba.

**Khi nên chọn cách khác.** Nếu bạn chỉ cần vài ảnh và không dùng DSH, một trang vẽ ảnh AI thông thường sẽ nhanh hơn. Nếu bạn cần kiểm soát từng node chi tiết, hãy dùng thẳng ComfyUI. Còn nếu bạn đã dùng DSH hằng ngày và muốn ảnh xuất hiện ngay trong luồng làm việc, plugin này đáng thử.

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

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

Bản thân plugin là mã nguồn mở theo giấy phép Apache-2.0. Tuy nhiên khi gọi dịch vụ vẽ ảnh bằng API Key thì chi phí do nhà cung cấp tính. Tư liệu không nêu giá cụ thể, bạn xem trang giá của nhà cung cấp bạn chọn.

### Có cần GPU không?

Tư liệu không ghi yêu cầu GPU cho plugin. Khi dùng các nhà cung cấp đám mây thì ảnh được tạo ở phía họ. Chỉ khi bạn dùng ComfyUI cục bộ thì cần máy có sức mạnh GPU để chạy ComfyUI.

### Không có API Key thì dùng được không?

Có thể, nếu bạn có gói ChatGPT, Grok hoặc Google. README nói bạn mở dòng Provider đăng nhập tương ứng, bấm Login và cấp quyền trên trình duyệt. Mã thông báo đăng nhập được lưu trong dịch vụ Credentials của DSH và tách riêng khỏi API Key.

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

Tư liệu không nêu hạn chế về hệ điều hành. Yêu cầu được ghi là DeepSeek Harness bản ổn định và Node.js `^22.19.0` hoặc từ 24.0.0 trở lên. Bạn cũng cần pnpm để chạy lệnh cài.

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

API 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ạng chữ rõ. Prompt và ảnh tham chiếu mà bạn dùng sẽ được gửi đến nhà cung cấp bạn chọn, nên cần đọc điều khoản của họ. Với ComfyUI, yêu cầu gửi tới địa chỉ do bạn cấu hình.

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

Ở chế độ chat, mỗi lần gọi tối đa 10 ảnh. Nếu bạn xin nhiều hơn, plugin nhắc Agent chia thành nhiều lần. Trong Studio, một lần ra 1–4 ảnh ứng viên cùng một prompt để bạn chọn.

### Khác gì so với dùng ComfyUI hoặc một trang vẽ ảnh AI thông thường?

dsh-image-gen cho Agent trong DeepSeek Harness tự vẽ, sửa và làm cả loạt ảnh ngay trong chat, kèm thư viện prompt và thư viện ảnh. Nó cũng có thể gọi ComfyUI của bạn qua chat. Tư liệu không so sánh trực tiếp với công cụ cụ thể nào khác.
