dsh-reach
Plugin chỉ-đọc đa nền tảng cho DeepSeek Harness: tìm kiếm web, đọc GitHub, V2EX,
YouTube và Bilibili ngay trong tiến trình DSH — không cần cài CLI Python bên ngoài.
Lấy cảm hứng và port hành vi từ Agent Reach
(MIT, tác giả Panniantong). Plugin này độc lập: nó không gọi agent-reach, không
đọc ~/.agent-reach, và không cần Python.
Vì sao có plugin này
Agent Reach là một CLI Python rất tốt nhưng phải cài ngoài (uv + nhiều binary
theo kênh) và agent phải gọi qua shell. dsh-reach đưa đúng những kênh ổn định
nhất vào trong DSH dưới dạng công cụ gốc, nên không cần shell, không cần
subprocess cho phần lớn kênh, và kết quả đi thẳng vào hội thoại.
Bốn công cụ
| Công cụ | Việc nó làm |
|---|---|
reach_search |
Tìm trên một kênh: web, github, v2ex, youtube, bilibili |
reach_read |
Đọc một URL; tự chọn kênh theo tên miền, hoặc ép bằng tham số channel |
reach_run |
Gọi một hành động bất kỳ của một kênh (hot, node, user, subtitle, …) |
reach_channels |
Liệt kê kênh đang bật, hành động và tham số của từng kênh |
Kênh và hành động
| Kênh | Hành động | Cần gì |
|---|---|---|
web |
search, read |
Không. Exa MCP công khai + Jina Reader |
github |
search, read |
Không. gh nếu có, không thì GitHub REST (60 lượt/giờ) |
v2ex |
hot, node, read, user |
Không. API công khai |
youtube |
search, read, subtitle |
yt-dlp trên PATH |
bilibili |
search, read, hot, subtitle |
Không. API công khai |
xueqiu |
quote, search |
Không. Giá cổ phiếu A/HK/US |
linkedin |
jobs, read |
Không. jobs-guest API công khai |
reddit |
subreddit, search, read |
Không. RSS công khai (rate limit chặt) |
twitter |
profile, read |
Không. Syndication công khai; profile tự lùi sang curl khi bị chặn TLS fingerprint |
Cần token GitHub để nâng hạn mức lên 5000 lượt/giờ: đặt biến môi trường
GITHUB_TOKEN (hoặc đổi githubTokenEnv trong config). Token chỉ được đọc từ
môi trường — không ghi vào file cấu hình.
Chỉ đọc
Đây là ràng buộc thiết kế, không phải tính năng tùy chọn:
- Không đăng bài, bình luận, thích, theo dõi, nhắn tin.
- Không đăng nhập thay người dùng, không hỏi mật khẩu, không lưu cookie.
- Mọi
fetchđi qua một client duy nhất có giới hạn kích thước, timeout, và
chặn đích không công khai (localhost, IP nội bộ, metadata cloud), kể cả sau
khi chuyển hướng.
Định dạng kết quả
Mọi lần gọi trả về một phong bì thống nhất:
{
"schema_version": 1,
"ok": true,
"channel": "v2ex",
"action": "hot",
"backend": "v2ex-api",
"items": [
{
"title": "…",
"url": "https://www.v2ex.com/t/…",
"author": "…",
"published_at": "2026-11-05T02:00:08Z",
"text": "…",
"raw": {}
}
],
"meta": { "elapsed_ms": 214, "attempts": [] },
"error": null
}
Khi lỗi:
{
"ok": false,
"items": [],
"error": { "code": "RATE_LIMITED", "message": "…", "hint": "…" }
}
Mã lỗi: NEED_SETUP, NEED_LOGIN, UPSTREAM_BROKEN, TIMEOUT,
RATE_LIMITED, PLATFORM_BLOCKED, NOT_FOUND, BAD_INPUT, BUSY.
Một hành động có thể có nhiều backend; bộ điều phối thử theo thứ tự và dừng khi
gặp mã không thể cứu bằng cách đổi backend.
Cấu hình
Dòng patch trong cordis.patch.yml:
- insert:
- id: reach
name: 'dsh-reach'
config:
timeoutMs: 30000
maxResponseBytes: 5242880
githubTokenEnv: GITHUB_TOKEN
channels:
- web
- github
- v2ex
- youtube
- bilibili
Bỏ một kênh khỏi channels để không đăng ký nó. Kênh bị tắt vẫn trả lỗi
NEED_SETUP nếu bị gọi nhầm.
textBudget (mặc định 1500) cắt văn bản hiển thị cho mỗi kết quả để tiết kiệm
context; nội dung đầy đủ vẫn nằm trong raw của phong bì.
Cài đặt
Plugin này cài qua Plugin Manager của DSH như mọi bundle khác:
plugin_manager({ action: 'install_bundle', target: '/data/dsh-022/reach-plugin' })
Kênh không hỗ trợ
xiaohongshu, facebook, instagram, boss, xiaoyuzhou không có trong
plugin. Chúng bị chặn thật với HTTP ẩn danh, hoặc cần cookie/token tài khoản.
Bằng chứng chi tiết từng endpoint, gồm cả những hướng đã thử mà không được, nằm
ở UNSUPPORTED.md.
Giấy phép
MIT. Hành vi và giao diện kết quả port từ Agent Reach (MIT,
Copyright (c) 2025 Agent Eyes). Xem THIRD_PARTY.md.
