# dsh-tieba-dive 中文文档

规范地址：https://npmcn.com/package/dsh-tieba-dive/

版本：1\.34\.0
npm 元数据更新时间：2026-11-03T12:15:40.525Z
中文译文更新时间：2026-11-03T13:24:01.105Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/dsh-tieba-dive
原文对照：https://npmcn.com/package/dsh-tieba-dive/?lang=original
项目主页：https://github.com/Nekomeow114/dsh-tieba-dive#readme
源码仓库：https://github.com/Nekomeow114/dsh-tieba-dive

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：354 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/schemastery \*
- 首次发布：2026-10-27T13:19:16.635Z
- 最新版本发布：2026-11-03T12:15:40.276Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

DSH 插件 · 刷贴吧：读帖挑重点、写日报、自动签到；学习每个吧的语风（风格库），回帖与楼中楼可选（默认关）。支持人设、日记、峰谷定时，另带只读 MCP stdio server（未逐客户端实测）。

## 安装

```sh
npm install dsh-tieba-dive
```

也可以使用：`pnpm add dsh-tieba-dive`、`yarn add dsh-tieba-dive`、`bun add dsh-tieba-dive`

## README

# dsh-tieba-dive

> 百度贴吧的 DSH 插件：自动读帖、生成日报、每日签到；回帖可选，并带频率与内容限制。

[![test](https://github.com/Nekomeow114/dsh-tieba-dive/actions/workflows/test.yml/badge.svg)](https://github.com/Nekomeow114/dsh-tieba-dive/actions/workflows/test.yml) [![release](https://img.shields.io/github/v/release/Nekomeow114/dsh-tieba-dive)](https://github.com/Nekomeow114/dsh-tieba-dive/releases) [![license](https://img.shields.io/github/license/Nekomeow114/dsh-tieba-dive)](https://npmcn.com/package/dsh-tieba-dive/LICENSE)

⚠️ 走的是贴吧手机版页面（逆向解析），不是官方 API。贴吧改版可能失效，频繁请求可能触发风控； 账号风险与发布内容由使用者自行承担。

* * *

## 功能

-   **多吧阅读**：按吧列帖、读楼层正文，附带帖子内图片
-   **日报**：把这吧今天在聊什么、哪条值得点开写成 markdown，存在本地
-   **签到**：未关注的吧先关注再签到，每天一次
-   **回帖（默认关闭）**：接话 / 共鸣 / 玩梗 / 答疑，受每轮、每天、间隔、内容四道限制
-   **楼中楼（默认关闭）**：读某层下的子回复；只回**自己评论下**的，每轮 / 每天限额， 自动带「回复 #(reply, 头像, 昵称) :」提及，真正挂到对方名下
-   **风格库（学习）**：读帖时把真实高赞回复入库；回帖前按话题检索 2~4 条当参考， **只学口气、不照抄、不改人设**。每吧最多 40 条，过滤水楼/广告/重复
-   **高赞来源**：app 端 protobuf 热门接口拿真实 `agree_num`；失败退回手机版楼中楼数
-   **人设**：可手写或导入文件；语气样本、语气词、句式可改；版本快照可回滚/导出
-   **日记**：公开（给使用者看）与私人（写感受，不写变更明细）两份，各有开关
-   **图片库**：上传表情包/配图，模型只拿到 ID + 描述 + 标签，不含本地路径
-   **定时与后台**：峰谷排班；模型轮为独立子进程，关掉设置页也会跑完
-   **风控熔断**：撞到验证码后暂停，期间不发请求
-   **自检**：一键检查 curl / 凭证 / 吧名 / 目录 / headless

## 它怎么学一个吧

```
读帖 → 高赞回复（真实赞数）→ 过滤 → 风格库（每吧 ≤40 条）
回帖 → 按话题检索 2~4 条 → 当 few-shot 参考 → 生成
```

默认不改变人设；旧版「泡满 3 次微调旋钮」已改为显式开关 `allowSoak`，**默认关闭**。

## 检查 profile / 工具

```bash
node scripts/check-profiles.mjs
# 或 npm run check:profiles
```

逐个 profile 检查：依赖有没有装、bundle 有没有登记、包名是否一致、工具是否齐全； 空 profile（如 `default`）会跳过。缺什么会直接给出 `dsh plugin --profile ... add ...` 命令。

## MCP（可被支持 MCP 的客户端调用）

仓库自带一个**零依赖、只读**的 MCP stdio server：`mcp-server.mjs`。

> 实测范围：MCP 协议冒烟测试（initialize / tools/list / tools/call）与真实贴吧数据调用。 **Codex、AstrBot、Claude Desktop 未逐客户端实测**，下面的配置只是通用示例。

```bash
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
```

故意**不包含**回帖/发帖/签到——MCP 侧只读，避免别的客户端拿账号乱发。

测试不需要安装任何 MCP 客户端：

```bash
npm run test:mcp
```

它会自己起 server，走 `initialize → tools/list → tools/call`，四项全 PASS 就说明协议通了。 也可以 `npx @modelcontextprotocol/inspector node mcp-server.mjs` 用网页点。

MCP 客户端配置示例（命令 + 环境变量，未逐客户端实测）：

```json
{
  "mcpServers": {
    "tieba": {
      "command": "node",
      "args": ["/绝对路径/dsh-tieba-dive/mcp-server.mjs"],
      "env": { "DSH_HOME": "/root/.dsh" }
    }
  }
}
```

## 安装

```bash
dsh plugin --profile web add dsh-tieba-dive                    # npm
dsh plugin --profile web add github:Nekomeow114/dsh-tieba-dive # 或从仓库
```

安装后重启一次 dsh，进入 **设置 → 刷贴吧**。

**环境要求**：Node 22+、`curl`（Linux / macOS 自带，Windows 10+ 自带）。

Windows 说明：npm 安装的 `dsh` 是 `.cmd` 启动器，插件会通过 `cmd.exe` 调起， 并把这一轮的 prompt 落成文件、命令行只传一句「读取该文件」——避免长文本里的引号和换行被 cmd 拆坏。定时功能另需在 headless profile 中安装本插件：

```bash
dsh plugin --profile headless add dsh-tieba-dive
```

## 设置页结构

```
账号与刷帖    账号 / 每一轮（吧列表、关键词、读几贴）
人设与表达    人设 / 图片库
行为与规则    回帖规则 / 自动化
学习与日记    学习 / 日记
```

手机上默认只展开账号组，其余折叠；版本与导出收在学习卡的折叠块里。

## 快速开始

1.  **贴 BDUSS**：设置页「① 账号」→ 保存并测试 → 显示「登录态有效」即可
2.  **填吧名**：一行一个；也可以点「读取已关注的吧」一键填入（会替换框内内容）
3.  **刷一轮**：点击「刷一轮贴吧」，先只采集，确认读到的内容符合预期

BDUSS 获取方式：电脑浏览器登录贴吧 → `F12` → Application → Cookies → `https://tieba.baidu.com` → 复制 `BDUSS` 的 Value（带不带前缀均可）。也可使用 Kiwi + Cookie-Editor 扩展。

## 设置项

| 项 | 默认 | 说明 |
| --- | --- | --- |
| `bars` | 空 | 要刷的吧，一行一个，必须自行填写 |
| `keywords` | 空 | 刷帖关键词：标题命中的帖子排在前面（不过滤） |
| `readPerRound` | 5 | 每轮读取帖子数 |
| `requestGapMs` | 1200 | 请求间隔（毫秒，最低 300） |
| `dedupeDays` | 7 | 已读帖子在该天数内不再推荐 |
| `autoSign` | 关 | 每天 `signHour` 点后自动签到 |
| `autoFollow` | 开 | 签到时未关注的吧自动关注 |
| `signAllFollowed` | 关 | 签到覆盖账号关注的所有吧（不只配置里的） |
| `autoReply` | 关 | 允许回帖 |
| `replyPerRound` / `replyPerDay` | 1 / 3 | 每轮 / 全天回帖上限 |
| `replyGapSec` | 30 | 两条回复的最小间隔 |
| `answerQuestions` | 开 | 允许在回帖中解答疑问 |
| `allowSubReply` | 关 | 允许回复自己评论下的楼中楼 |
| `allowChatRun` | 关 | 允许模型在聊天/QQ 里触发一轮 |
| `subReplyPerRound` / `subReplyPerDay` | 1 / 3 | 楼中楼每轮 / 每天上限 |
| `toneGate` | 开 | 拦截客服腔（首先 / 其次 / 希望对你有帮助 等） |
| `mention` | 空 | 回帖时 @ 的昵称 |
| `peakValley` | 关 | 峰谷自动刷总开关 |
| `noon` / `night` | 开 / 开 | 中午谷、晚上谷子开关 |
| `breakerEnabled` | 开 | 风险熔断开关（触发条件：百度安全验证） |
| `breakerMin` | 30 | 熔断时长（分钟） |
| `personaText` / `personaFile` | 空 | 人设文本 / 人设文件（文件优先） |
| `styleSamples` | 空 | 语气样本，供回帖参考 |
| `evolvePersona` | 关 | 学习总开关：读帖时建立风格库（不改人设） |
| `allowSoak` | 关 | 旧「泡满 3 次微调人设」，显式开关 |
| `diaryEnabled` / `diaryPrivate` | 开 / 开 | 日记总开关 / 私人日记开关 |

配置保存在 `$DSH_HOME/tieba-duty/config.json`（600），通过 `/api/tieba-duty/config` 读写。

## 回帖限制

回帖默认关闭。回帖优先走 **App protobuf 通道**（`/c/c/post/add?cmd=309731`），失败自动退回网页表单。开启后同时受到以下限制：

1.  `autoReply` 必须开启；
2.  `toneGate`：命中客服腔词表会被退回改写；
3.  每轮不超过 `replyPerRound` 条，全天不超过 `replyPerDay` 条；
4.  两条之间至少间隔 `replyGapSec` 秒，同一帖子一天只回一次；
5.  正文 4~400 字，不支持链接。

另支持可选 `@`：正文末尾追加 `@昵称` （贴吧的 @ 用于提醒他人，格式需带空格）。

## 楼中楼

楼中楼是楼层下的子回复。插件支持：

-   **读**：`tieba_sub_replies({tid, pid})`；`pid` 是楼层 id（长数字），只知道楼层号时传 `floor`； `tieba_thread` 现在会返回 `floorIds`（楼层号 → id）和带 id 的 `hotFloors`；
-   **回**：`tieba_reply_sub({kw, tid, pid, subId, content, confirm: true})`。

限制：

1.  `allowSubReply` 默认关闭；
2.  **只允许回自己评论下的楼中楼**：会先核对该楼层作者是不是当前账号；
3.  每轮 ≤ `subReplyPerRound`，每天 ≤ `subReplyPerDay`（默认 1 / 3）；
4.  不能回自己；正文 4~300 字；
5.  自动在正文前加 `回复 #(reply, 对方头像, 对方昵称) :`，所以正文里不用再写「回复某某」。

**删楼中楼未实现**：贴吧没有给普通用户开放的删除接口，删错了只能在 App 里手动删。

## 工具

供模型调用：

| 工具 | 说明 |
| --- | --- |
| `tieba_whoami` | 登录态检查 |
| `tieba_list` | 列出吧内帖子（id / 标题 / 回复数 / 是否读过） |
| `tieba_thread` | 读取楼层正文与图片链接 |
| `tieba_sign` | 签到（未关注会先关注） |
| `tieba_reply` | 回帖（需 `confirm: true`，受上述限制） |
| `tieba_sub_replies` | 读某一层下的楼中楼（只读） |
| `tieba_reply_sub` | 回自己评论下的楼中楼（需 `confirm: true`，默认关） |
| `tieba_run_round` | 聊天里启动一轮（需 `confirm: true` + `allowChatRun`） |
| `tieba_run_status` | 查本轮是否在跑、今天回了几条、日志路径 |
| `tieba_style_refs` | 从风格库检索该吧高赞回复当参考 |
| `tieba_follow` | 关注一个吧 |
| `tieba_followed` | 列出账号关注的所有吧 |
| `tieba_settings` | 读取当前配置 |
| `tieba_persona` | 读取人设与语气样本 |
| `tieba_report_write` / `tieba_report_read` / `tieba_reports` | 日报写入 / 读取 / 列表 |
| `tieba_diary_write` / `tieba_diary_read` | 日记写入 / 读取（私人需显式确认） |
| `tieba_my_replies` | 本地记录：最近回复过哪些帖子 |
| `tieba_selfcheck` | 环境自检 |
| `tieba_evolve_propose` | 提 1~3 句语气样本（不直接改人设） |

## 定时运行

设置页开启「峰谷自动刷」后，到达谷时窗口会启动一轮：

```bash
dsh --profile headless "<prompts/duty.md>"
```

-   每个谷时窗口每天执行一次；两次自动轮之间至少间隔 6 小时；
-   headless 子进程内不会再次启动调度器，避免递归触发；
-   20 分钟超时，输出写入 `$DSH_HOME/tieba-duty/logs/run-YYYY-MM-DD.log`。

## 跨插件（文件契约）

插件之间**不 import 对方代码**，只共享 `$DSH_HOME/shared/`：

```
shared/
├─ plugins/<name>.json   能力报到：provides / consumes / version
└─ events/<date>.jsonl   事件流：tieba.round.start / end、tieba.reply
```

-   启动时写自己的清单（`provides: tieba.read / tieba.reply / tieba.digest / tieba.events`）；
-   每轮开始/结束、每成功回一帖，追加一行事件；
-   装了 `dsh-memory` 时，`consumes` 会带上 `memory`，`/api/tieba-duty/integrations` 能查到；
-   对方没装 → 文件不存在，跳过，不报错；
-   **兼容逻辑只写在刷贴吧自己里**：扫共享目录、探测能力，不修改、也不依赖其他插件的代码；
-   探测结果会以一小段「这一轮可用的外部能力」拼进 prompt（没有就不占字数），设置页也会显示「已连接：…」。

## 数据目录

```
$DSH_HOME/tieba-duty/
├─ cookie.txt     # BDUSS（600）
├─ jar.txt        # curl cookie jar（600）
├─ config.json    # 配置（600）
├─ state.json     # 当日计数 / 签到记录 / 已读去重 / 熔断状态
├─ audit.jsonl    # 回帖留痕（内容 / 意图 / 结果）
├─ reports/       # 日报与原始采集数据
├─ diary/         # public.md / private.md
└─ logs/          # 定时运行日志
```

卸载插件不会删除这些文件。

## 实现说明

**通道选择**（实测结果）：

| 通道 | 结果 |
| --- | --- |
| `/f?kw=` + 桌面 UA | 302 / 403（安全验证） |
| `/f?kw=` + 手机 UA | 200，但仅「贴吧小程序」空壳 |
| `/p/<id>` | 403 |
| `/mo/q/m?kw=` | 200，可解析帖子列表 |
| `/mo/q/m?kz=<id>` | 200，可解析楼层正文 |
| `/sign/add` | 签到可用（需 `tbs`） |
| `/f/commit/post/add` | 回帖可用（需 `fid` + `tbs`） |
| `/c/f/pb/floor?cmd=302002` | 楼中楼读取（protobuf，`pid` 楼层） |
| `/c/c/post/add?cmd=309731` | 楼中楼回复（protobuf，`quote_id` + `sub_post_id` + `reply_uid`） |

因此仅使用手机版页面，解析器依赖页面结构；单测内置真实页面 fixture 以便回归。

**TLS 指纹**：同一凭证与请求头，`curl` 返回 `is_login:1`，Node `fetch`（undici）返回 `is_login:0`。 网络层因此使用 `curl` 子进程，cookie 仅通过 jar 文件传递，不出现在命令行参数中。

**频率控制**：请求串行、间隔可配、`tbs` 与 `fid` 有缓存；撞到验证码即触发熔断，期间不重试。

## 人设与学习

```
核心层   名字 / 自称 / 对使用者的称呼 / 底线     代码常量，改不了
声音层   语气样本、语气词、句式、句长、标点      可手改
风格库   每个吧的真实高赞回复 + 统计画像        读帖时自动入库，回帖时检索
```

-   设置页不再用滑条调性格；「像哪个吧」由**风格库**决定，不是调刻度；
-   每次改声音层前存完整快照（`persona-versions/vNNNN.json`），版本号 +1，可回滚；
-   旧「泡满 3 次微调人设」保留为 `allowSoak`，**默认关闭**。

## 语风导出

「学习」卡右上角的「⬇ 导出语风」会下载一个 JSON：

```json
{
  "format": "dsh-tieba-style",
  "version": 1,
  "bars": [
    { "kw": "deepseek", "stats": { "avgLen": 32, "top": ["..." ] },
      "samples": [{ "text": "...", "likes": 59 }],
      "prompt": "你在「deepseek」吧待过一阵，那里的人这么说话……" }
  ]
}
```

-   每个吧一段 `prompt`，可直接粘进 QQ 机器人/其他 agent 的人设；
-   样本是公开高赞回复，**不含用户名、头像、路径**；
-   提示词明确写了「只学口气，不照抄」。

## 人设导出

「学习」卡底部的「版本与导出」折叠块里，可导出当前或任意历史版本：

-   **文本**：核心层 + 旋钮 + 语气层 + 版本号 + 导出时间，可直接粘回 B1；
-   **JSON**：`{ format, schema, version, traits, voice, exportedAt }`，用于备份；
-   已脱敏：含路径/链接/凭证字样的样本会被剔除，不含吧友原话与用户名；图片库不随人设导出。

## 保险机制

| 机制 | 行为 |
| --- | --- |
| 漂移评分 | 与 v1 快照比，0~1；≥0.3 提醒，≥0.5 日记里标红 |
| 暂停 / 恢复 | D1 一键；暂停只停演化，日记与回帖照常 |
| 被删联动 | 最近 7 天被删 ≥3 条 → 自动暂停，并写私人日记 |
| 版本快照 | 每次改动前存完整快照，可回滚 |
| 单步限制 | 旋钮 ±1、样本 1~3 条 |

## 风格库怎么工作

1.  读帖时拉真实高赞回复（app 端 protobuf 热门接口，带 `agree_num`）；
2.  过滤水楼 / 广告 / 重复，按赞数保留每吧最多 40 条；
3.  回帖前用 `tieba_style_refs({kw, topic})` 检索 2~4 条相近的当 few-shot；
4.  只学句长、标点、口气——**不复制原句、不照搬梗、不改人设**。

失败回退：高赞接口不可用时，用手机版页面的楼中楼数量当互动信号，`likesKnown: false` 标明。

## 安全边界

-   **出站内容过滤**：回复里出现本机路径（`/root`、`~/.dsh`、`C:\`）、链接、`BDUSS`/`token` 字样 会被直接拒绝，改成不带这些的说法才能发；
-   **本地接口只接受同源**：带其他 `Origin` 的请求一律 403（挡本机恶意页面）；
-   BDUSS 只存本地 `cookie.txt`（600），不回显、不写日志、不进仓库；
-   回帖默认关闭，开启后仍有每轮/每天/间隔/同帖四道闸；
-   已知风险：模型仍可能被帖子内容诱导，**自动回帖用的是账号本人身份**——建议用小号。

## 已知限制

-   贴吧改版会导致解析失效（单测会先失败）；
-   无法读取消息通知；楼中楼仅支持自己楼层、默认关闭，删除需手动；
-   不支持修改头像 / 昵称等账号资料；
-   未实现吧内搜索；
-   桌面版 DSH 的 peer 依赖问题由 `lib/toolkit.mjs` 兜底。

## 开发

```bash
npm test        # smoke（解析器）+ gates（纯函数）+ apply（挂载）三套，全部离线
```

结构：

```
index.js          # 主机半端：工具、HTTP、调度
client.js         # 浏览器半端：设置页
lib/tieba.js      # 抓取与解析
lib/config.mjs    # 配置默认值与归一化
lib/state.mjs     # 运行状态
lib/cooldown.mjs  # 风控熔断
lib/runner.mjs    # headless 子进程
lib/toolkit.mjs   # defineTool 兜底
prompts/duty.md   # 一轮的执行说明（可修改）
test/             # 单测与真实页面 fixture
```

添加 fixture 前必须清理凭证：贴吧页面包含「退出登录」链接，其中带有 `sid=<BDUSS>`。 提交前执行：

```bash
grep -c "<BDUSS 前 20 位>" test/fixtures/*.html   # 结果必须为 0
```

## 免责声明

非官方接口，可能随时失效或触发风控。使用即表示理解并承担账号风险，以及所发布内容带来的责任。

## License

MIT

## 常见问题

### dsh-tieba-dive 是什么？

DSH 插件 · 刷贴吧：读帖挑重点、写日报、自动签到；学习每个吧的语风（风格库），回帖与楼中楼可选（默认关）。支持人设、日记、峰谷定时，另带只读 MCP stdio server（未逐客户端实测）。

### 如何安装 dsh-tieba-dive？

在项目目录运行 npm install dsh-tieba-dive，或使用 pnpm add / yarn add / bun add。

### dsh-tieba-dive 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dsh-tieba-dive 是否存在。

### dsh-tieba-dive 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### dsh-tieba-dive 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### dsh-tieba-dive 可以商用吗？

dsh-tieba-dive 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### dsh-tieba-dive 还在维护吗？

最新版本 1\.34\.0 发布于 2026/11/03（今天）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。