Give your DeepSeek Harness agent real hands: drive your logged-in browser and call 176 site adapters / 200+ commands as deterministic one-shot commands — with a write-approval gate.
dsh 内置的 web 工具是"检索"(web_search/web_fetch)。本插件给它补上"办事"的那一半:agent 可以操纵你自己日常使用的、带登录态的真实浏览器,并直接调用知乎/B站/微博/GitHub 等 176 个站点、200+ 结构化命令——不是匿名抓取,是你本人的视角和数据。
一句话:web_search 给所有人一样的匿名结果;site 给你的 agent 你账号视角的结构化数据——你的关注流、收藏夹、热榜、未读通知,再到替你发帖点赞(带审批)。
| 用户说 | 插件做什么 |
|---|---|
| "B站搜罗翔,总结播放量前 3 的视频" | site bilibili search 罗翔 → 结构化结果,无需逐页点击 |
| "知乎今天热榜前 10 给我摘要" | site zhihu hot → 一步拿到榜单 |
| "把这个转发到我的微博" | site weibo post …(登录态),先弹审批窗,你点了允许才发 |
| "看看我 GitHub 有哪些未读通知" | site github whoami 等登录态命令 |
| "打开公司后台,把这个审批单批了" | browser_open → browser_state → browser_click 通用原语,用你的登录态 |
| "帮我查 12306 明天北京→上海的余票" | site 12306 … |
| "同时拉知乎/微博/B站三站热榜" | site_batch 一条命令 fan-out,汇总各站结果 |
| "每天早上 9 点自动跑知乎热榜" | 面板建定时任务,持久化 + 真执行,重启不丢 |
以及:没适配器的网站,让模型当场造一个(browser_do analyze → init → verify,SKILL.md 内置创作循环)——越用越会浏览。
不是只有适配器才能用。模型对每个站有两张牌,先打第一张,失败自动换第二张:
- 固定命令(
site <站> <命令>):预编译的站点知识,省 token、结果可验证、有失败签名恢复表; - 任意网页原语(
browser_open/state/click/fill+ 内置只读脚本 article/links/jsonld + 25 步 Playwright recipe):适配器没覆盖的页面、临时性需求("我就看一眼这个页面"),用你的登录态自由组合。
动手前先让模型调 site_knowledge <站> 读知识卡:该站全部命令+已知坑(风控/登录/改版)+失败签名恢复表——不现场试错。知识卡可经面板导出为 markdown(~/.dsh/opencli-knowledge/),可分享、可进版本库。
- "browser agents re-learn every site on every session"——selectors/登录流/站点怪癖每次从头再来(browser-use#5841,10 评论)→ 176 站预置结构化命令就是成品答案:站点知识预编译,不重学。
- "想在当前打开的 Chrome 实例/profile 上做自动化"(browser-use#4709)→ 登录态原生:所有
site命令跑在用户已登录的 Chrome 里,不另起无头实例。 - "求结构化动作证据:动作到底改没改页面"(browser-use#5137,13 评论;同源:BrowserSkill#242 click 谎报成功)→ 执行真实性层:采集结果经确定性规则+亚秒决策模型两层判定,
exit 0但内容无效会被标"疑似静默失败",无人值守定时任务直接按失败重试。
| 模块 | 能力 |
|---|---|
| site 适配器 | 176 站 / 200+ 命令,蒸馏命令目录注入 systemPrompt(第一轮就选对命令);site_batch 多站并行 |
| browser 原语 | open/click/type/fill/scroll/state/screenshot/extract/wait/crawl 全套(泛爬带 maxPagesPerRun 限流) |
| 定时任务 | cron 表达式,持久化到 dsh.schedule 并真执行,重启不丢;面板管理 + 运行可见 |
| 录制回放 | 面板录制 site/browser_* 步骤序列,一键回放,步骤持久化 |
| 自动化模式 | read-only / standard / autonomous / unrestricted 四档,接入 tools/pre-execute 审批门 |
| 我的适配器 | 适配器禁用/启用管理,禁用即从 systemPrompt 目录自动收缩 |
| 登录态巡检 | 面板实时显示各站在线状态 |
| 失败诊断 | daemon 诊断/一键启动;resolveBin() 四级回退(本地依赖优先) |
| 限流与限域 | usagePolicy(延迟/并发/突发/冷却/页数上限)+ 429/5xx 自动退避;--authProfile 限域登录,跨域拒绝 |
| 四 tab 面板 | 总览 / 命令 / 自动化 / 安全与设置,状态机四态(检测中骨架屏/正常/依赖缺失一键修复/错误内嵌诊断) |
| 登录态桥 | 探测 daemon Chrome 的 CDP 端点,一键生成配置把 dsh 官方 Browser Use 接到你登录态的浏览器 |
| 拦截审计 | 审批门拦截记录(近 7 天计数 + 明细),写操作全程可追溯 |
| 定时可靠性 | 失败重试 ×3 + 通知事件 + 运行历史 |
| 站点品牌图标 | 48 站 simple-icons 官方标 + 品牌色,变体站点自动归并 |
| 中英双语 | 面板 EN / zh 一键切换 |
本插件不使用、也不需要 dsh 的内置浏览器。它经 OpenCLI 的 daemon + BrowserBridge 扩展,驱动你扩展装在哪个、就哪个浏览器的真实窗口(Chrome/Edge 均可)——登录态来自你日常浏览器里的真实会话,和你在地址栏手打网址完全同源。你在哪登录了知乎,agent 就能用你的知乎;巡检面板会告诉你哪些站在线。
如果你已装 OpenCLI/npm 版 opencli,agent 原则上能在 shell 里裸跑 opencli。本插件的增量:
| 只装 opencli(agent 走 shell) | + 本插件 | |
|---|---|---|
| 开局发现 | 模型得先跑 opencli list(数 MB 输出)才知道有什么 |
蒸馏命令目录已注入 systemPrompt,第一轮就选对命令 |
| 权限模型 | 需要 shell 权限;写操作(发帖/下单)裸奔无门 | 一等公民工具,参数校验 + write 审批门(工具层拦截,shell 拦不住) |
| 只读/受限会话 | 无 shell 就没戏 | 无需 shell,工具照用 |
| 定时采集 | 自己写 crontab + 脚本 + 通知 | 面板建定时任务,持久化 + 真执行 + 运行可见 |
| 管理 | 开 OpenCLIApp 或敲命令 | dsh 设置页:daemon 诊断/一键启动/命令集合浏览复制/登录态巡检/适配器启停/自动化模式 |
两不冲突:深度用法仍可用官方 opencli 技能,本插件负责工具化、安全与面板。
⚠️ 升级 dsh 到 0.2 前自查 profile 的cordis.patch.yml有无引用未安装的 bundle——0.2 对此静默退出。⚠️ 插件目录内跑npm install会静默把宿主的 opencli 链接替换为 registry 副本(上游 #2555)——请在本仓库外装依赖。 💡 版本管理器(vfox/nvm)切换 node 版本后插件会自动扫描各版本目录找回 opencli;也可用DSH_OPENCLI_BIN指定。
前置(二选一):
npm i -g @jackwener/opencli # 推荐:一条命令
opencli daemon restart # 启动守护进程
# 再装 BrowserBridge 扩展(Chrome Web Store / GitHub Releases),在浏览器里登录你的常用站点或安装 OpenCLIApp(托盘全家桶,自动保活/更新)。
然后:
dsh plugin add IKEASven69/dsh-opencli自定义二进制路径:设 DSH_OPENCLI_BIN(也可依赖插件自带的本地 @jackwener/opencli)。
Windows 注意:dsh 的 shell 在 Windows 走 PowerShell,
DSH_OPENCLI_BIN请指向.cmd结尾的 shim(如...\nodejs\opencli.cmd),无扩展名文件会被静默忽略。
零配置开箱即用;需要微调时有这几处:
| 配置 | 方式 | 默认 |
|---|---|---|
| opencli 二进制路径 | 环境变量 DSH_OPENCLI_BIN,或依赖插件自带的本地 @jackwener/opencli |
opencli(全局) |
| 写审批开关 | 面板「审批门」一键开关 | 开 |
| 自动化模式 | 面板四档:read-only / standard / autonomous / unrestricted | standard |
| 限流策略 | usagePolicy(minDelayMs 750 / maxConcurrency 2 / burst 3 / cooldown 30s / maxPagesPerRun 20) |
见左 |
| 限域登录 | authProfiles(allowedDomains / storageStatePath),配 site --authProfile 使用 |
无 |
示例:让 agent 只读不动手——面板切到 read-only,所有写命令直接拒绝,无需逐条审批。
- write 审批门(默认开):
site的写命令经 dsh 原生审批——弹窗点"允许"才执行;权限不明的命令按写处理(fail-closed);面板可一键开关。 - 自动化模式四档:read-only / standard / autonomous / unrestricted,接入
tools/pre-execute审批门。 - 命令白名单与参数校验;
browser_do仅放行只读/创作类子命令。 - 全部输出经截断与噪声剥离(update 横幅等),防上下文污染。
- 限流:并发/突发/冷却 + 429/502/503/504 自动退避;限域登录(
--authProfile)跨域拒绝。
| 层面 | 方式 | 结果 |
|---|---|---|
| 判定逻辑 | 单元测试 ×11 | ✅ |
| 审批分发链路 | cordis 真实 waterfall 集成测试 ×6 | ✅ |
| 高级功能 | schedule/replay/script/recipe/automation/rulepacks ×22 | ✅ |
| 真模型 E2E·读 | MiniMax-M3 会话调 site zhihu hot,真实热榜返回 |
✅ |
| 真模型 E2E·写拒绝 | site zhihu comment → ask → 无审批通道 fail-closed 拒绝 |
✅ |
| 真模型 E2E·浏览器原语 | browser_open→browser_state 往返结构化报告 |
✅ |
| 面板 | 真实浏览器全链路(审批门/巡检/命令集合/复制/i18n) | ✅ |
| 全权审查套件 | 19 项真机逐项验证(渲染/真执行/状态文件对账/RPC 真值),full-review.cjs 一键复测 |
✅ |
完整版本历史见 CHANGELOG.md 与 Releases。
- 不替代 OpenCLIApp/daemon/扩展——那是引擎与管家,本插件是 dsh 里的驾驶舱;
- 不替代 dsh 内置 web_search/web_fetch——内置管检索,本插件管办事;
- 无头服务器(没有任何真实浏览器的机器)不适用。
MIT License.