dsh-tieba-dive

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

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

功能

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

它怎么学一个吧

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

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

MCP（Codex / Claude Desktop / AstrBot）

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

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 侧只读，避免别的客户端拿账号乱发。

测试不用装 Codex：

npm run test:mcp

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

AstrBot / Codex 的 MCP 配置（命令 + 环境变量）：

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

安装

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 中安装本插件：

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

设置页结构

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

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

快速开始

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

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`	关	允许回复自己评论下的楼中楼
`subReplyPerRound` / `subReplyPerDay`	1 / 3	楼中楼每轮 / 每天上限
`toneGate`	开	拦截客服腔（首先 / 其次 / 希望对你有帮助等）
`mention`	空	回帖时 @ 的昵称
`peakValley`	关	峰谷自动刷总开关
`noon` / `night`	开 / 开	中午谷、晚上谷子开关
`breakerMin`	30	撞到验证码后的熔断时长（0 表示不熔断）
`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），失败自动退回网页表单。开启后同时受到以下限制：

autoReply 必须开启；
toneGate：命中客服腔词表会被退回改写；
每轮不超过 replyPerRound 条，全天不超过 replyPerDay 条；
两条之间至少间隔 replyGapSec 秒，同一帖子一天只回一次；
正文 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})。

限制：

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

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

工具

供模型调用：

工具	说明
`tieba_whoami`	登录态检查
`tieba_list`	列出吧内帖子（id / 标题 / 回复数 / 是否读过）
`tieba_thread`	读取楼层正文与图片链接
`tieba_sign`	签到（未关注会先关注）
`tieba_reply`	回帖（需 `confirm: true`，受上述限制）
`tieba_sub_replies`	读某一层下的楼中楼（只读）
`tieba_reply_sub`	回自己评论下的楼中楼（需 `confirm: true`，默认关）
`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 句语气样本（不直接改人设）

定时运行

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

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：

{
  "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 条

风格库怎么工作

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

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

安全边界

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

已知限制

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

开发

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>。提交前执行：

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

免责声明

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

License

MIT

dsh-tieba-dive

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

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

功能

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

它怎么学一个吧

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

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

MCP（Codex / Claude Desktop / AstrBot）

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

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 侧只读，避免别的客户端拿账号乱发。

测试不用装 Codex：

npm run test:mcp

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

AstrBot / Codex 的 MCP 配置（命令 + 环境变量）：

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

安装

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+ 自带）。

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

设置页结构

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

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

快速开始

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

设置项

项	默认	说明
`bars`	空	要刷的吧，一行一个，必须自行填写
`keywords`	空	刷帖关键词：标题命中的帖子排在前面（不过滤）
`readPerRound`	5	每轮读取帖子数
`requestGapMs`	1200	请求间隔（毫秒，最低 300）
`dedupeDays`	7	已读帖子在该天数内不再推荐
`autoSign`	关	每天 `signHour` 点后自动签到
`autoFollow`	开	签到时未关注的吧自动关注
`signAllFollowed`	关	签到覆盖账号关注的所有吧（不只配置里的）
`autoReply`	关	允许回帖
`replyPerRound` / `replyPerDay`	1 / 3	每轮 / 全天回帖上限
`replyGapSec`	30	两条回复的最小间隔
`answerQuestions`	开	允许在回帖中解答疑问
`allowSubReply`	关	允许回复自己评论下的楼中楼
`subReplyPerRound` / `subReplyPerDay`	1 / 3	楼中楼每轮 / 每天上限
`toneGate`	开	拦截客服腔（首先 / 其次 / 希望对你有帮助等）
`mention`	空	回帖时 @ 的昵称
`peakValley`	关	峰谷自动刷总开关
`noon` / `night`	开 / 开	中午谷、晚上谷子开关
`breakerMin`	30	撞到验证码后的熔断时长（0 表示不熔断）
`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），失败自动退回网页表单。开启后同时受到以下限制：

autoReply 必须开启；
toneGate：命中客服腔词表会被退回改写；
每轮不超过 replyPerRound 条，全天不超过 replyPerDay 条；
两条之间至少间隔 replyGapSec 秒，同一帖子一天只回一次；
正文 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})。

限制：

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

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

工具

供模型调用：

工具	说明
`tieba_whoami`	登录态检查
`tieba_list`	列出吧内帖子（id / 标题 / 回复数 / 是否读过）
`tieba_thread`	读取楼层正文与图片链接
`tieba_sign`	签到（未关注会先关注）
`tieba_reply`	回帖（需 `confirm: true`，受上述限制）
`tieba_sub_replies`	读某一层下的楼中楼（只读）
`tieba_reply_sub`	回自己评论下的楼中楼（需 `confirm: true`，默认关）
`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 句语气样本（不直接改人设）

定时运行

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

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 以便回归。

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

人设与学习

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

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

语风导出

「学习」卡右上角的「⬇ 导出语风」会下载一个 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 条

风格库怎么工作

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

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

安全边界

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

已知限制

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

开发

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>。提交前执行：

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

免责声明

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

License

MIT

Nekomeow114/dsh-tieba-dive

dsh-tieba-dive

功能

它怎么学一个吧

MCP（Codex / Claude Desktop / AstrBot）

安装

设置页结构

快速开始

设置项

回帖限制

楼中楼

工具

定时运行

跨插件（文件契约）

数据目录

实现说明

人设与学习

语风导出

人设导出

保险机制

风格库怎么工作

安全边界

已知限制

开发

免责声明

License

Community comments

Nekomeow114/dsh-tieba-dive

dsh-tieba-dive

功能

它怎么学一个吧

MCP（Codex / Claude Desktop / AstrBot）

安装

设置页结构

快速开始

设置项

回帖限制

楼中楼

工具

定时运行

跨插件（文件契约）

数据目录

实现说明

人设与学习

语风导出

人设导出

保险机制

风格库怎么工作

安全边界

已知限制

开发

免责声明

License

Community comments