前言¶
在 DSH 里做社区情报或日常值守时，百度贴吧往往只能人工打开若干吧、翻列表再摘要点。官方没有面向个人开发者的稳定读帖 API，脚本直连桌面页又容易撞上验证。维护者 Nekomeow114 的 dsh-tieba-dive 以 DSH 插件形式接入：用模型可调的工具读帖、落日报、签到，回帖与楼中楼默认关闭并带频率与内容限制；需要时在 DeepSeek 谷时窗口用 headless 跑定时任务。下面介绍它的定位、能力与上手步骤。
这是什么¶
dsh-tieba-dive 是面向百度贴吧的 DeepSeek Harness 工作流插件（npm 包名同仓库名）。它走贴吧手机版页面做逆向解析，不是官方 API；读帖、图片、签到、可选回帖都在 $DSH_HOME/tieba-duty/ 下留痕。插件在 DSH Web 设置页「刷贴吧」中配置，模型通过一组 tieba_* 工具执行一轮「读 → 摘要 → 可选互动」。
仓库说明中明确：贴吧改版可能导致失效，频繁请求可能触发风控；账号风险与发布内容由使用者自行承担。插件以当前 dsh 进程权限运行，安装前宜自行查看 GitHub 源码 与 MIT 许可证。
核心功能¶
读帖与日报¶
- 多吧阅读：按吧列帖、读楼层正文，附带帖内图片链接。
- 日报：把当日吧内讨论与值得点开的帖写成 markdown，保存在本地
reports/。 - 去重：已读帖在
dedupeDays（默认 7 天）内不再推荐。
签到与关注¶
- 签到：每天一次；未关注的吧可在
autoFollow开启时先关注再签到。 - 可选范围：
signAllFollowed可覆盖账号关注的全部吧，不限于配置列表。
回帖与楼中楼（默认关闭）¶
回帖支持接话、共鸣、玩梗、答疑等模式，受四道限制：每轮（replyPerRound）、每天（replyPerDay）、间隔（replyGapSec）、内容与规则（字数 4~400、无链接、同一帖一天只回一次、toneGate 拦截客服腔等）。
楼中楼默认关（allowSubReply）；开启后只允许回复自己评论下的子回复，并自动带上「回复 #(reply, 头像, 昵称) :」格式。
风格库、人设与日记¶
读帖时可将真实高赞回复入库（每吧最多 40 条，过滤水楼/广告/重复）；回帖前按话题检索 2~4 条作口气参考，只学口气、不照抄、不改人设。高赞数优先来自 app 端 protobuf 热门接口的 agree_num，失败时退回手机版楼中楼数。
人设分核心层（代码常量）与可改的声音层；改前会存版本快照可回滚。日记分公开与私人两份，各有开关。另有图片库：模型只见 ID、描述与标签，不含本地路径。
定时、风控与自检¶
开启「峰谷自动刷」后，在谷时窗口用 headless 子进程执行 prompts/duty.md 中的一轮任务；两次自动轮至少间隔 6 小时。撞到验证码会熔断暂停请求（breakerMin 可配）。设置页可一键自检 curl、凭证、吧名、目录与 headless。
只读 MCP¶
仓库自带零依赖 MCP stdio server（mcp-server.mjs），故意不包含回帖/发帖/签到，供支持 MCP 的客户端只读拉取贴吧数据。启动示例：
DSH_HOME=/root/.dsh node mcp-server.mjs
暴露工具包括 tieba_settings、tieba_list、tieba_thread、tieba_sub_replies、tieba_style_refs、tieba_report_read、tieba_whoami 等。
跨插件文件契约¶
与其它插件不互相 import，仅共享 $DSH_HOME/shared/ 下的能力清单与事件流（如 tieba.round.start）；装了 dsh-memory 时可在集成 API 中探测，未装则跳过。
安装与启用¶
环境要求：Node 22+、curl（Linux/macOS 自带，Windows 10+ 自带）；DSH 引擎版本需满足包内声明的 dsh >= 0.1.7-rc.1（当前 npm 版本 1.31.3）。
官方安装命令如下：
dsh plugin --profile web add dsh-tieba-dive # npm
dsh plugin --profile web add github:Nekomeow114/dsh-tieba-dive # 或从仓库
安装后重启一次 dsh，进入 设置 → 刷贴吧。若要用定时峰谷功能，还需在 headless profile 安装同一插件：
dsh plugin --profile headless add dsh-tieba-dive
Windows 上 npm 的 dsh 为 .cmd 启动器时，插件会通过 cmd.exe 调起并把长 prompt 写入文件，避免引号与换行被命令行拆坏——属 README 中的实现说明，一般用户只需按上面命令安装即可。
典型用法¶
1. 登录与吧列表¶
- 在设置页「① 账号」粘贴 BDUSS，保存并测试，直到显示「登录态有效」。获取方式：浏览器登录贴吧 → F12 → Application → Cookies →
https://tieba.baidu.com→ 复制BDUSS的 Value。 - 「吧名」一行一个；也可点「读取已关注的吧」一键填入（会替换框内内容）。
2. 先只采集¶
点击「刷一轮贴吧」，先确认读到的标题与正文符合预期。常用默认包括每轮读 readPerRound 5 帖、请求间隔 requestGapMs 1200 毫秒（最低 300）。
3. 模型侧工具¶
一轮任务中模型可调用例如：
| 工具 | 说明 |
|---|---|
tieba_whoami |
登录态检查 |
tieba_list |
吧内帖子列表 |
tieba_thread |
楼层正文与图片 |
tieba_sign |
签到 |
tieba_report_write / tieba_report_read |
日报写入与读取 |
tieba_reply |
回帖（需 confirm: true，且 autoReply 已开） |
完整列表见仓库 README「工具」一节。
配置持久化在 $DSH_HOME/tieba-duty/config.json（权限 600），亦可通过 /api/tieba-duty/config 读写。
适用场景与注意¶
适合：需要在 DSH 对话或定时任务里汇总若干贴吧动态、写本地日报、顺手每日签到，并可选地在严格限额下让模型回帖或维护自己楼层下的楼中楼；希望用风格库贴近某个吧的真实语气，而不是手写大量 prompt。
不适合或需谨慎：不能接受逆向解析与风控风险的生产账号；需要高频发帖、删楼中楼（插件未实现删楼）；期望官方 API 级稳定性。
网络层因 TLS 指纹差异，插件用 curl 子进程发请求，cookie 经 jar 文件传递。请求串行、间隔可配，验证码触发熔断。卸载插件不会删除 tieba-duty 下已有 cookie、日报与日记。
社区目录页：SkillHub · dsh-tieba-dive（独立站点，与 DeepSeek / 幻方无官方从属关系）。源码与 issue：github.com/Nekomeow114/dsh-tieba-dive。
结尾¶
dsh-tieba-dive 把「列帖、读楼、写日报、签到」收进 DSH 工具链，回帖与自动化默认保守，并支持峰谷定时与只读 MCP。按 README 贴 BDUSS、填吧名、先跑一轮采集，再按需打开回帖或定时，是在不夸大能力前提下最常见的落地路径。
