# DSH 大肥魚

Nguồn: https://docs.aicentos.com/vi/clients/dsh

Language: vi

> Kết nối mô hình aicentos vào DeepSeek Harness (DSH), nuôi chú cá tự lướt Bilibili và Douyin, rồi đưa nó vào nhóm QQ

DSH (DeepSeek Harness) là framework Agent mã nguồn mở của DeepSeek. Bản desktop DSH Desktop đóng gói runtime, plugin và phiên làm việc vào một bộ cài duy nhất. « 大肥魚 » (cá béo) là plugin do cộng đồng phát triển tên `dsh-bili-whale`: một chú cá AI tự thức dậy theo nhịp sinh hoạt, lướt Bilibili, thực sự hiểu video, viết hai cuốn nhật ký và tag bạn vào những video đáng xem.

Trang này gồm bốn phần: nối DSH với aicentos, nuôi chú cá Bilibili, chuyển sang bản Douyin, và cuối cùng đưa nó vào tin nhắn riêng cùng nhóm QQ bằng plugin chính thức. Các plugin lần lượt do cộng đồng và Tencent duy trì, không liên kết với Bilibili, Douyin hay DeepSeek.

## Chuẩn bị

| Hạng mục           | Yêu cầu  | Ghi chú                                                                                            |
| ------------------ | -------- | -------------------------------------------------------------------------------------------------- |
| DSH Desktop        | Bắt buộc | Tải bộ cài macOS / Windows từ trang chính thức; đã kèm runtime                                     |
| Node.js            | 18+      | Chỉ cần khi khởi động DSH bằng dòng lệnh; bộ công cụ plugin là `.mjs`, cần node thật               |
| ffmpeg             | Tùy chọn | Chỉ dùng cho việc trích khung hình; không có vẫn hiểu video qua phụ đề, danmaku, bình luận nổi bật |
| Tài khoản Bilibili | Một      | Tài khoản chú cá dùng, đăng nhập để lấy cookie; nên dùng tài khoản phụ                             |
| API Key aicentos   | Một      | Nên tạo Key riêng (đặt tên `dsh`) để theo dõi mức dùng theo dự án                                  |

* Bảng điều khiển: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền vào ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)

## Cấu hình cần điền

| Trường       | Giá trị                                                      |
| ------------ | ------------------------------------------------------------ |
| Provider ID  | `aicentos`                                                   |
| Display name | `aicentos`                                                   |
| Base URL     | `https://aicentos.com/v1`                                    |
| API protocol | `openai-completions`                                         |
| API Key      | Key đã tạo trong bảng điều khiển                             |
| Model        | Tên mô hình trong «Quảng trường mô hình» của bảng điều khiển |

## Các bước thiết lập

### Cài DSH Desktop

Mở [https://www.dshdesktop.com/](https://www.dshdesktop.com/) , chọn bộ cài theo hệ điều hành (Windows, macOS chip M, macOS Intel) rồi nhấp đúp để cài. Lần khởi động đầu, làm theo hướng dẫn: cấu hình mô hình → tạo phiên, trò chuyện bình thường là xong.

### Kết nối aicentos trong DSH

Nên cấu hình qua giao diện:

1. Mở **Settings → Models**, bấm **Add a custom provider**.
2. Điền Provider ID, Display name, Base URL, API protocol, API Key theo bảng trên.
3. Trong **Model catalog** bấm **Fetch available models**, chọn các mô hình cần dùng; nếu không tải được thì nhập ID mô hình thủ công.
4. Bấm **Save**, quay lại khung trò chuyện và chọn mô hình ở ô chọn phía trên.

Cũng có thể sửa trực tiếp `~/.dsh/settings.yaml`:

```yaml
agent-default-model:
  provider: aicentos
  model: 你的模型名

llm-pi-ai:
  providers:
    aicentos:
      api: openai-completions
      baseURL: https://aicentos.com/v1
      apiKeyEnv: AICENTOS_API_KEY
      models:
        - id: 你的模型名
```

Sau đó đặt biến môi trường rồi khởi động:

```bash
export AICENTOS_API_KEY="sk-你的-API-Key"
```

API Key được lưu cục bộ trong `$DSH_HOME/.credentials.yaml`; giao diện không bao giờ hiển thị dạng văn bản thuần.

### Cài plugin chú cá

Không cần clone thủ công, chỉ cần gửi một dòng trong khung trò chuyện DSH:

```bash
帮我安装这个插件，插件地址：https://github.com/Alterssss/dsh-bili-whale
```

Cài xong hãy tải lại trang DSH, mở **Cài đặt → Nuôi cá** (养鱼) ở thanh bên trái để thấy trang cấu hình plugin. Nếu không thấy mục «Nuôi cá», hãy thoát hoàn toàn DSH rồi mở lại: plugin được lắp khi khởi động, không khởi động lại thì coi như chưa cài.

### Cấp toàn quyền cho phiên

Đây là bước dễ bỏ sót nhất. Phiên của cô ấy nằm trong **Không gian làm việc → Chưa phân nhóm** ở thanh bên trái (không mở thư mục đó thì không thấy). Mở phiên, chuyển quyền sang **Toàn quyền truy cập** (`danger-full-access`), nếu không sau khi thức dậy cô ấy không chạy được lệnh, không đăng được bình luận, không viết được nhật ký.

### Đăng nhập tài khoản Bilibili

Trong **Cài đặt → Nuôi cá → Đăng nhập Bilibili**, bấm **Đăng nhập bằng mã QR** rồi xác nhận bằng app Bilibili trên điện thoại. Mã QR có hiệu lực khoảng 3 phút; hủy hoặc hết hạn đều không thay thế trạng thái đăng nhập cũ.

Cũng có thể dán cookie thủ công: đăng nhập trên trình duyệt bằng tài khoản của chú cá, nhấn F12, chọn **Application → Cookies → `https://www.bilibili.com`**, sao chép `SESSDATA`, `bili_jct`, `buvid3`, dán lần lượt rồi bấm **Ghi thông tin xác thực**.

Đừng lấy cookie bằng `document.cookie`. `SESSDATA` là HttpOnly nên script không đọc được; làm theo cách đó sẽ chỉ nhận được cookie thiếu thành phần và bị kẹt ở bước kiểm tra.

### Kiểm tra phụ thuộc

Bấm **Kiểm tra phụ thuộc** trên trang cài đặt. Nó thực sự gửi một yêu cầu tới Bilibili để xác minh trạng thái đăng nhập, rồi kiểm tra từng mục cookie, ffmpeg, Node, thư mục dữ liệu, nhịp sinh hoạt. Phải xanh toàn bộ («tất cả khả dụng ✓») mới đạt.

Nếu báo thiếu ffmpeg, không cần tự tìm hướng dẫn: hãy gửi «cài ffmpeg trên máy này» trong khung trò chuyện DSH để nó tự xử lý, cài xong chạy lại kiểm tra.

Sửa xong nhất định phải bấm **Lưu**. Ô nhập chỉ thay đổi cục bộ, bấm lưu mới ghi xuống đĩa; trang cũng nhắc «có thay đổi chưa lưu = chưa có hiệu lực». Lưu là có hiệu lực ngay; chỉ khi thay mã nguồn hoặc phiên bản plugin mới cần khởi động lại DSH.

### Thiết lập nhân vật và nhịp sinh hoạt

* **Cô ấy là ai**: tên nhân vật, cách gọi bạn, cách cô ấy tự xưng.
* **Nhân vật của cô ấy**: nội dung ghi vào `~/.bili-ai/persona.md`, viết xong bấm **Tiêm nhân vật** (giới hạn 20000 ký tự, khi tiêm chỉ lấy 3000 ký tự đầu, đính kèm mỗi lần đánh thức và lắng nghe).
* **Bạn (chủ nhân)**: điền `mid` của bạn, cả tag và tin nhắn riêng đều dựa vào đó.
* **Cách chia sẻ**: tag bạn ở phần bình luận, hoặc tin nhắn riêng Bilibili.
* **Khung giờ sinh hoạt**: mặc định 20:00–24:00, thức dậy ở một thời điểm ngẫu nhiên trong khung, không phải đúng giờ tròn.

Plugin không có sẵn nhân vật nào, mặc định là trợ lý trung tính: không gọi bạn là «chủ nhân», không làm nũng. Muốn cô ấy thành «大肥魚», hãy viết rõ thân phận và xuất xứ, giọng điệu, điều cô ấy quan tâm và những việc tuyệt đối không làm.

## Kiểm tra

Trước hết chạy tự kiểm tra bằng dòng lệnh, nó kiểm tra một lượt cấu hình, thông tin xác thực, trạng thái đăng nhập, thư mục dữ liệu và phụ thuộc:

```bash
node ~/.dsh/plugins/dsh-bili-whale/tools/bili.mjs selftest
```

Trên Windows thay đường dẫn bằng `%USERPROFILE%\.dsh\plugins\dsh-bili-whale\tools\bili.mjs`:

```powershell
node "$env:USERPROFILE\.dsh\plugins\dsh-bili-whale\tools\bili.mjs" selftest
```

Từng mục được đánh dấu và dòng cuối «全部通过 ✓ 可以用了» là đã sẵn sàng. Các lệnh thường dùng:

```bash
node ~/.dsh/plugins/dsh-bili-whale/tools/bili.mjs deps           # kiểm tra phụ thuộc
node ~/.dsh/plugins/dsh-bili-whale/tools/bili.mjs dm --status    # hạn mức tin nhắn riêng + theo dõi lẫn nhau
node ~/.dsh/plugins/dsh-bili-whale/tools/bili.mjs traffic status # giá trị bảo vệ yêu cầu
```

Muốn xem cô ấy chạy ngay một vòng: đổi khung giờ sinh hoạt thành một khoảng hai phút tính từ bây giờ, lưu lại rồi chờ cô ấy thức (kiểm tra → chọn chủ đề → hiểu nội dung → viết hai cuốn nhật ký → gửi cho bạn). Cũng có thể yêu cầu trực tiếp trong khung trò chuyện để cô ấy thức và lướt Bilibili một lần.

Cuối cùng mở trang mức sử dụng trong bảng điều khiển aicentos để xác nhận yêu cầu được ghi vào Key bạn đã tạo cho DSH.

## Kết nối Douyin

Bản Douyin là một dự án khác với cùng ý tưởng: `dsh-douyin-scroll`. Nó không xem hình ảnh, chỉ đọc mô tả, thẻ, tác giả, thời lượng, chỉ số tương tác và bình luận nổi bật, chọn vài video mỗi ngày và viết báo cáo Markdown.

### Cài đặt

```bash
git clone https://github.com/NEWJO123/dsh-douyin-scroll.git
cd dsh-douyin-scroll
node selfcheck.mjs
```

Khi kiểm tra sơ bộ đều đạt, cài vào profile `web` rồi khởi động lại DSH một lần:

```bash
dsh plugin --profile web add "link:$PWD"
```

Sau khi khởi động lại, mở **Cài đặt → Lướt Douyin** (刷抖音).

### Cấu hình lần đầu

1. Bấm **Cài phụ thuộc chính**: nó tạo venv riêng và cài `curl_cffi`, `httpx` (khoảng 30 giây, xem tiến trình trong `install.log`).
2. Đăng nhập: chạy `node tools/qr-login.mjs start` để quét mã, hoặc dán cookie từ phiên Douyin đã đăng nhập trong trình duyệt vào trang cài đặt.
3. Điền «lướt gì»: từ khóa, danh mục, tác giả chỉ định, số video mỗi ngày, số ứng viên mỗi vòng, rồi bấm **Chạy một vòng ngay**.

Cookie lưu trên máy tại `$DSH_HOME/douyin-duty/douyin_cookie.txt`, không vào log và không tải lên máy chủ nào.

### Khả năng và giới hạn

| Hạng mục        | Chi tiết                                                                                                                   |
| --------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Căn cứ đánh giá | Mô tả, thẻ, tác giả, thời lượng, tỷ lệ tương tác, bình luận nổi bật; không xem hình, không nhận dạng giọng nói             |
| Nguồn ứng viên  | Luồng đề xuất chỉ đọc và bảng xu hướng; web Douyin không có API tìm kiếm dùng được, từ khóa chỉ để chú thích trong báo cáo |
| Báo cáo         | Ghi vào `out/<ngày>.md`; tùy chọn thông báo Windows hoặc webhook                                                           |
| Gửi             | Tin nhắn riêng, thẻ chia sẻ, bình luận mặc định đều tắt và đều cần `confirm`                                               |
| Nhóm chat       | Quan sát của tác giả là «trong nhóm có thể không gửi được»; tài khoản khác có thể khác                                     |

URL dạng văn bản thuần không mở được trong Douyin, chỉ thẻ chia sẻ mới bấm được. Gửi tin nhắn, thẻ, bình luận cần cài Chrome (chỉ tìm `chrome.exe`, không dùng Edge); lấy ứng viên và viết báo cáo thì không cần. Bình luận thường xuyên sẽ bị kiểm soát tần suất, và độ chính xác thấp hơn bản Bilibili: không có phụ đề nên chỉ đọc được phản ứng của khán giả.

## Kết nối nhóm QQ

QQ Bot có plugin chính thức `@tencent-connect/dsh-qqbot`, cài vào profile `qqbot` riêng; sau khi quét mã liên kết, nó trò chuyện được trong tin nhắn riêng và nhóm QQ.

```bash
npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
npx @deepseek-ai/dsh --profile qqbot
```

Lần khởi động đầu, quét mã QR theo hướng dẫn, không cần nhập khóa thủ công. Sau khi liên kết:

* **Tách phiên**: mỗi cuộc trò chuyện riêng và mỗi nhóm có ngữ cảnh riêng, không lẫn nhau, và tự khôi phục sau khi khởi động lại.
* **Đổi mô hình trong chat**: đổi trực tiếp trong cuộc trò chuyện, ngữ cảnh cũ vẫn giữ nguyên, không phải bắt đầu lại.
* **Chế độ yên tĩnh**: đặt thành chỉ trả lời khi được @ để không làm phiền nhóm.

Mô hình được cấu hình trong profile `qqbot`: mở **Settings → Models → Add a custom provider** ở đó và điền aicentos theo bảng phía trên. Nếu muốn quản lý nhiều kênh IM một chỗ, tham khảo bundle cộng đồng `dsh-im` — một bundle cho mười kênh, hỗ trợ nhiều bot và trả lời dạng streaming.

Hội thoại trong nhóm được đọc vào ngữ cảnh và gửi cho mô hình, nên đừng để nó xử lý tài khoản hay khóa trong nhóm; thông tin liên kết lưu trong profile cục bộ, đừng đồng bộ cả thư mục profile lên kho công khai.

## Thú cưng trên desktop và dọn bình luận

Hai plugin tùy chọn, là dự án khác với chú cá:

| Mục đích                                | Dự án                                                                                  | Cách cài                                                                                                                              |
| --------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Chú cá động trên desktop                | [https://github.com/QCYTSN/dsh-dafeiyu](https://github.com/QCYTSN/dsh-dafeiyu)         | Cũng gửi URL cho DSH để nó cài; một cửa sổ gốc trong suốt xuất hiện, kéo được, đổi hoạt ảnh theo trạng thái tác vụ                    |
| Ẩn tài khoản nghi là AI trong bình luận | [https://github.com/liyupi/dafeiyu-cleaner](https://github.com/liyupi/dafeiyu-cleaner) | Tiện ích trình duyệt: tải zip trong Releases, giải nén, mở `chrome://extensions`, bật chế độ nhà phát triển, tải tiện ích đã giải nén |

Tiện ích dọn dẹp chỉ ẩn bình luận trong trình duyệt của bạn, không xóa bình luận của ai, không tự báo cáo, tài khoản bị đánh giá sai có thể khôi phục. Tỷ lệ nhận diện theo bộ quy tắc ngoại tuyến khoảng 85%, con số đo trong một mục bình luận và có thể không đúng ở cộng đồng khác.

## Lưu ý

* **Đừng bật bình luận tự động vội.** Mặc định đang tắt; khi bật, mỗi vòng chỉ đăng 1 bình luận, tối đa 20, mỗi video chỉ một lần. Dù vậy, việc đăng tràn lan vẫn thành «thảm họa cá» với người khác. Nên bắt đầu bằng tin nhắn riêng Bilibili gửi cho chính mình.
* **Kênh tin nhắn riêng cần hai tài khoản.** Chọn tin nhắn riêng Bilibili cần hai tài khoản khác nhau và theo dõi lẫn nhau (`relation.attribute === 6`). Chỉ có một tài khoản thì xem video, viết nhật ký, tạo báo cáo vẫn dùng được, còn tin nhắn riêng thì không.
* **Dùng tài khoản phụ để cấp quyền.** Plugin nói bằng chính tài khoản của bạn, đừng đưa cookie tài khoản chính cho plugin bên thứ ba và đừng mua tài khoản không rõ nguồn gốc.
* **Gặp kiểm soát rủi ro là dừng ngay.** Khi gặp 412 / 429, captcha hay giới hạn tần suất, plugin tạm dừng 5–30 phút và báo lại; đừng thử lại liên tục, endpoint có chữ ký cũng không bảo đảm vượt qua giới hạn của nền tảng.
* **Chọn mô hình rẻ.** Mỗi ngày cô ấy lọc 5 video, đọc sâu 2–3 video và viết hai cuốn nhật ký, một vòng là nhiều yêu cầu. Nên chọn trong aicentos mô hình có đơn giá thấp, ngữ cảnh đủ dùng (xem [mô hình được hỗ trợ](https://docs.aicentos.com/vi/billing/models-list)) và tạo Key riêng cho DSH để tính chi phí.
* **Chế độ không giao diện không chạy được.** Plugin phải chạy trên DSH có giao diện web, nếu không sẽ dừng ở `pending (waiting for services: sessionController, webServer, connection)`.
* Plugin là bản công khai của một công cụ cá nhân, không liên kết với Bilibili hay DeepSeek; bạn dùng chính tài khoản của mình và tự chịu trách nhiệm, hãy tuân thủ quy định cộng đồng của nền tảng.

## Liên kết liên quan

* [Kho plugin dsh-bili-whale](https://github.com/Alterssss/dsh-bili-whale)
* [Kho plugin dsh-douyin-scroll](https://github.com/NEWJO123/dsh-douyin-scroll)
* [Tài liệu chính thức QQ Bot](https://bot.qq.com/wiki/agent-qqbot/)
* [Trang chính thức DSH Desktop](https://www.dshdesktop.com/)
* [Mã nguồn DSH Desktop](https://github.com/dataelement/dsh-desktop)
* [Lịch sử thay đổi plugin](https://github.com/Alterssss/dsh-bili-whale/blob/main/CHANGELOG.md)
* [Mô hình aicentos hỗ trợ](https://docs.aicentos.com/vi/billing/models-list)