# 配置、提及与第三方模型 ## 自定义 @ 在「互动」开启「评论时添加 @ 提及」,再选择帖子作者、自定义用户或不提及。自定义默认需要同时填写昵称和数字用户 ID;昵称支持 `昵称` 和 `@昵称`,保存时统一去掉前缀。昵称和 ID 必须属于同一账号,插件不会按昵称自动搜索或确认身份。此设置影响帖子评论;评论回复仍通过平台 `reply_id/root_id` 指向来信。 0.10.2 根据用户提供的官方 App 选择用户后的评论标记生成提及:`@示例用户`。作者模式从帖子作者数据读取 ID 与昵称;自定义模式使用 `mentionUserId` 与 `mentionName`。链接由宿主生成并放入 `text` 表单字段,昵称进行 HTML 转义,模型仍不能生成 HTML 或 @。 旧版只填昵称的配置仍能读取,历史保留;默认自定义 @ 缺少 ID 时会记录明确错误并停止该条评论发送。0.10.7 新增 `mentionPlainTextFallback`(布尔值,默认 `false`),对应「缺少 ID 时允许纯文本 @」开关:显式开启后,没有 ID 时生成普通 `@昵称 正文`;这不绑定用户,不能保证通知对方。有 ID 时仍生成上述链接,不会降级。此选项不影响作者模式、不提及模式或评论回复;升级不会自动开启,也不会重新发送已处理的旧评论。 补齐 ID 并保存后对后续发送生效。当前已验证标记与样本一致、提交编码保留原文;该样本是已显示评论中的标记,并非创建请求抓包,平台是否接受此标记并触发通知仍需真实账号联调。评论创建接口的 Workshop v15 `_rnd` 签名自 0.10.5 已内置,评论和回复共用;无需运行旧脚本重复修改插件文件。 ## 第三方 API 「高级 → 模型来源」选择第三方 API,填写兼容 Chat Completions 的 Base URL、模型名和 API Key。例如 Base URL 为 `https://api.example.com/v1` 时,调用 `/v1/chat/completions`;完整端点也支持。远程地址使用 HTTPS,本机 localhost / 127.0.0.1 / ::1 可用 HTTP。只支持非流式文本输出,不提供工具或发送小黑盒 Cookie。 两种模型来源共用相同提示词与结果校验。帖子评论使用「通用人设与兴趣」,回复使用「回复人格」,空白回复人格沿用通用人格。人格放入 system 消息,帖子和评论作为不可信的 user 数据传入。模型只决定 send / skip 与正文;提及、额度、去重、冷却和平台发送均由宿主控制。提示词约束不能保证任意第三方模型完全遵守人格,需根据实际输出调整模型和设定。 API Key 保存在服务器配置文件,状态接口不返回密钥;表单留空保留已有密钥,显式点击清除可删除。第三方请求禁止跟随重定向,不自动重试;错误记录只保留本地错误说明及 HTTP 状态,不记录上游响应正文。 ## 编辑配置文件 独立配置位于 `$DSH_HOME/heybox/config.json`,默认 `~/.dsh/heybox/config.json`,首次从旧 automation.json 自动迁移。文件权限 0600。密钥仅保存在该文件;浏览历史与发送记录仍位于 `automation.json`,不会写入 B 站目录。 可在「高级 → 配置文件」打开 JSON 快照,修改后点击「保存配置文件」。快照不包含已有 apiKey;省略该字段会保留密钥,`"apiKey": ""` 会清除。此操作会同步表单并覆盖尚未保存的表单修改。也可直接编辑服务器文件,建议停止当前任务后用临时文件加 rename 的方式原子替换;设置在下次调度读取,已计算的下一次运行时间仍沿用,界面保存设置会重新计算。 示例为增量配置,可通过编辑器提交: ```json { "mentionAuthor": true, "mentionTarget": "custom", "mentionName": "示例用户", "mentionUserId": "12345678", "generationProvider": "external", "apiBaseUrl": "https://api.example.com/v1", "apiModel": "your-model", "persona": "喜欢游戏,简洁友好,有具体内容再评论。", "replyPersona": "先回应对方的问题,保持耐心,不编造经历。" } ``` 直接替换整个服务器文件时应在现有完整配置上修改,保留所需开关及密钥;文件缺失字段会使用默认值。未知字段、非法类型和无效地址会被拒绝,损坏配置会停止调度,修复后重启宿主。不要把带密钥的配置提交到 Git 或发给他人。 ## 自定义调度(0.10.1) 「运行时段」提供不限时段、峰谷、峰底快捷方案,点击只更新表单,保存后生效。所有时间均可继续修改,时区可自定义。峰底预设为每天 00:00–06:00 的示例,请按模型供应商实际时段调整。 工作日、周末、节假日分别使用 valleyWindows、weekendWindows、holidayWindows,每类最多 10 段。界面用时间选择器编辑,无需计算分钟。配置文件仍使用分钟数组,例如 [[1350,315]] 表示 22:30–次日 05:15,[[0,1440]] 表示全天,[] 表示当天不运行。每个本地日期先判断日历类型,再应用该类型的时段;例如周五跨午夜时段的凌晨部分按周五规则判断,周六凌晨按周末规则判断。节假日优先,周末补班使用工作日规则。关闭时段限制会保留所有时间段。已有配置不会被自动替换成新预设。 界面将执行频率与允许运行时段分别说明:浏览页的「调度检查间隔」从本轮结束或跳过后计时,保存设置会重新计时;运行时段页决定到点能否开始。概览分别显示浏览与回复的下次检查时间,其中「下次浏览检查」,这个时间不保证开始刷帖,时间按浏览器本地时区显示,时段判定按配置的调度时区。时段外跳过后等待下一次检查,时段开启不会额外触发;较短时段可能被较长间隔错过。手动「立即执行一轮」也受时段限制。已开始的浏览可能在窗口外继续,评论在生成前后及发送前检查时段;回复仅在 replyFollowSchedule 开启时检查时段。 ## 独立回复检查(0.10.4) 「互动 → 回复来信」可独立开启自动回复,不依赖定时浏览开关。开启后通常在下一次宿主调度检查(5 秒内)开始检查,随后从检查完成时起等待 `replyIntervalSeconds` 秒。默认 180 秒,可配置 30–86400 秒。更短间隔会增加平台请求量,尚未通过真实账号验证其长期稳定性。 - `autoReply`:回复任务开关,默认关闭。 - `replyIntervalSeconds`:回复检查间隔;界面修改该值会重新计算下次检查时间。 - `replyFollowSchedule`:默认关闭,即全天检查;开启后遵守浏览页所用的运行时段规则。关闭全局时段限制时仍为全天。 - `repliesPerRound`:每轮最多处理的来信数(1–10),模型决定跳过也占一个名额;实际发送另外受 `dailyReplies` 限制。 消息获取参考 WenfuRainbow/heybox 的轮询方式,使用 `/bbs/app/user/message?list_type=0`,不是服务端推送。优先使用明确的未读标记;明确已读的消息跳过。没有可识别已读状态时,只处理时间晚于本账号启用基线的消息,缺少有效时间则跳过。未读标记可能包含旧未读消息,所以首次开启仍可能处理旧未读来信。每轮最多查 100 条消息,大量积压不保证全部覆盖。 回复前仍核对帖子、父评论和账号关系,使用回复人格(留空沿用通用人格),模型可决定跳过。处理结果和基线按账号持久化;0.10.6 起候选来信先入队,未处理完和可重试的失败留到下轮,详见下节。重启保留基线、队列和去重记录,关闭后重新开启会更新新发现的无已读标记消息的时间基线,不删除已有队列。 浏览和回复有独立的到期时间,但共用执行锁与发送冷却,按到期先后串行执行。当前浏览、模型生成及发送冷却都会延迟回复;这不是实时推送或固定延迟承诺。「立即执行一轮」仍用于浏览。「停止全部任务」同时关闭浏览、回复和发帖三项开关,并取消尚未提交的生成与发送。 消息获取失败或登录、验证、限流等检查错误按检查间隔的 2、4、8、16、32 倍延长等待,成功后恢复正常间隔。单条生成或普通明确拒绝在尝试上限内保留到下一正常检查,不阻塞其他来信。登录失效或要求人机验证时暂停回复检查,概览展示原因;完成验证并重新登录、更新凭据后恢复。也可处理问题后关闭自动回复、保存,再开启保存。暂停与错误不会删除队列、浏览历史或已发送记录。 升级后原有 autoReply 开关会保留,默认改为全天独立检查;需要保持原运行时段限制的用户请开启 replyFollowSchedule。新增调度状态仅写入小黑盒自己的 automation.json,不操作 B 站插件文件。 ## 评论发送诊断(0.10.5) 「评论记录」中的失败记录新增平台响应:HTTP 状态、业务状态(例如 failed)和消息(例如“缺失参数”)。最近动态同步显示上述原因。文本会过滤当前账号凭据、配置密钥及常见凭据字段,并限制长度,不保存整份平台响应。旧记录缺失的原因无法补回。 评论与回复统一使用新版网页评论创建参数(web_version=3.0)和逐请求生成的 _rnd 签名。附加签名使用公开网页协议常量,不是个人 API Key;它不会替代 Cookie,也不会发送给第三方。此修改仅针对评论创建接口,不推断其他写接口也使用相同规则。 升级保持发送记录、额度和去重;旧版未入队的 rejected / unknown 记录不会自动重试。0.10.6 起新入队回复的 rejected 会重试,帖子评论仍保持原有去重。网络异常或非成功 HTTP 状态仍可能无法确定是否写入,不自动重发;HTTP 200 且业务状态明确失败则记录 rejected。 ## 失败与积压回复队列(0.10.6) 每轮先将最近 100 条消息中符合条件的来信写入当前账号的 `automation.json` → `accounts` → `replyQueue`,再按 `repliesPerRound` 分批处理。例如收到 10 条、每轮处理 5 条,其余 5 条会在下轮继续,不要求来信仍未读或仍在消息列表中。重启和关闭开关都保留未达尝试上限的队列;重新开启后继续。只有发现后的来信才受此保护,首次读取前已被新消息挤出最近 100 条范围的来信仍可能遗漏。 - 尚未处理、模型生成失败、暂时查不全评论关系、读取评论暂时失败、平台明确拒绝发送:保留队列,下一次允许的回复检查继续;优先处理尚未尝试或最久未尝试的来信,避免单条失败阻塞后续。 - 已发送或已受理:移出队列并保留去重;模型主动跳过、确认不是对自己的回复等不符合条件的来信也结束处理。 - 网络超时等发送结果未知:保留为「待确认」,不自动重发。请先到平台核对,当前没有自动核验或强制重发入口,避免重复评论。 - 每次实际发送尝试均计入每日额度,包括平台拒绝和未知结果;生成失败不扣发送额度。额度用尽时保留队列,按调度时区到次日后继续。登录失效或人机验证仍需处理后恢复,队列不能绕过平台限制。 在「概览」查看待处理 / 待确认数量,在「评论记录 → 待回复队列」查看来信 ID、帖子链接、尝试次数及最近失败原因,最多展示前 50 条。状态随界面每 5 秒刷新;原因经过凭据过滤。队列按账号隔离,仍仅写入小黑盒自己的数据目录,不操作 B 站历史。升级不会将旧版未入队的拒绝记录批量补发。 0.10.8 起,楼中楼查找每轮最多 5 页,未查完的游标保存在队列条目的 `scanCursor` 中,下轮继续,重启也保留。此前每轮从头查前 5 页,会漏掉更深的来信。查到底、分页无进展或找到目标时清除游标;未找到的来信在尝试上限内留在队列,后续重新查找。帖子首页之外的根评论、删除或不可见的评论仍可能无法核对完整关系,此时不会贸然发送。 ## 单条来信尝试上限(0.13.2) `replyMaxAttempts` 默认 `5`,范围 `1–100` 的整数。在「互动 → 回复来信」设置「单条来信最多尝试次数」并保存,1 表示只处理一次、失败后不再重试,5 表示首次加最多 4 次重试。上限按来信计算,不影响其他新来信。 一次尝试包含查找并核对评论关系、生成回复及发送。帖子不可查看、暂未找到完整关系、生成失败、平台明确拒绝均不能无限重试。次数在本次处理的网络读取 / 模型调用前持久化;已开始后取消或进程中断仍占一次,未开始的等待、每日额度不足、关闭回复不增加次数。消息列表轮询失败不增加每条来信的次数。 次数达到上限而未完成时,从待回复队列移除,并在账号 `actions[reply:来信ID]` 中保存 `status: exhausted`、`attempts / retryLimit / error` 及已存在的正文和平台诊断。「评论记录」显示停止状态、次数和最近原因,概览显示停止总数。消息仍未读也不会重新入队;重启、开关切换或提高上限均不会恢复终态。降低上限会终止已达到新上限的待处理项。 升级保留旧尝试次数,超过上限的旧队列直接终止,不从零重新计数,也不再访问这些帖子的详情。未知发送结果是独立的待确认状态,即使次数已到上限也保留,不能误判为可重试或普通失败。成功、平台受理及模型主动跳过均按原逻辑结束。 ## 黑话词库(0.13.0,释义方式自 0.13.1 扩展) 「黑话」Tab 使用「提取候选 → 解析释义 / 联网检索 → 编辑 / 确认 → 回复参考」流程。黑话包括游戏缩写、拼音缩写、梗、抽象话、反话和社区特殊指代。只提取原文实际出现且需要语境才能理解的词,不要求提取阶段知道含义,不收录人名、占位、普通功能词和系统报错。 - `slangLearning` 默认 `false`:开启「自动从帖子和评论学习」并保存后,浏览新帖时分析原帖与前 20 条已读评论,回复前分析原帖、父评论及来信。每个新语境额外调用一次当前模型,产出候选;只浏览也能提取,不会因此发送评论。 - `slangEnabled` 默认 `true`:「发帖与回复时参考黑话词库」统一控制评论、回复和发帖。评论与回复参考当前账号匹配的已确认词条,并核对适用语境。未确认词只提示存在未知用语,不提供猜测含义;关键含义不明时提示模型跳过。两项开关通过底部「保存设置」生效。 - 每账号保留最近 10 份读取语境,用于「从帖子里找新黑话」,即使没有开启自动提取也可手动触发。已有旧版浏览档案只有标题,无法恢复全文,不自动重读。最近 200 个相同语境去重,失败提取不缓存。 `slangSessionTerms` 默认 20,范围 1–100,在黑话 Tab 的「一个对话最多解释几个词」设置并保存。DSH 解析释义 / 联网研究按账号复用专用对话,最多处理 N 次单词解析,第 N+1 次新建;这是每个对话的容量,不是一次批量任务的词数限制;重复解析同一词也计数。跨批次及重启保留计数,降低上限在下次解析时生效。模型返回格式错误、调用失败、进程中断或切换研究方式都保留当前会话编号,下次继续;每次真正进入解释的词语尝试(含失败)计数,写锁冲突等未进入解释的情况不计数,搜索失败尚未调用模型时不计数。首次启动失败且会话尚不存在时,以原编号创建;会话损坏、占用或读取失败时不偷偷换新。候选提取保持独立;第三方直连接口无 DSH 对话,仍逐词独立请求。复用时历史草稿不能作为新词的证据,每轮仍禁止模型工具、验证本轮输出,必须人工确认。 `slangResearchMode` 默认 `context`,在「怎么解释这些词」选择并保存: - `context`(当前模型解析):直接使用高级设置所选的 DSH / 第三方模型,依据原文证据与已有知识生成含义、适用语境和自评置信度。每词一次模型调用,不请求搜索服务、不要求官方搜索 Key;记录标记 `mode: context`,界面显示「模型解析,未联网」。不接受模型编造的引用,结果保持候选,不能当作联网核实。 - `web`(联网检索核对):先调用 DSH 配置的搜索提供方,再由所选模型整理来源。搜索与生成是独立配置;普通第三方 Chat Completions 接口不自动具有搜索能力。DSH 默认搜索提供方需要自己的搜索凭据(默认引用 DEEPSEEK_API_KEY),或另行配置受支持的搜索接口。选择该模式后不会在搜索失败时偷偷降级为未联网解析。 「联网研究」由宿主调用 DSH 的 `web.search({ query, maxResults: 6 }, signal)`,需要 DSH 安装并配置可用的搜索提供方。只发送候选词、帖子标题与用途搜索词,不发送 Cookie。随后将原文证据和最多 6 个检索结果的标题 / 摘要交给当前配置的 DSH 或兼容 Chat Completions 模型,不声称已阅读来源全文。每词一次搜索、一次模型调用,搜索上限 30 秒;一次可解释全部勾选的待确认词(词库最多 500 个),串行执行,可通过「停止全部任务」取消。 联网研究结果只作草稿;返回的引用必须属于实际检索结果,否则拒绝保存释义。搜索服务不可用、无来源、模型额度用尽、错误输出、停止或换号均不自动确认;失败原因在词条展示,任务进度随设置页状态刷新。自 0.13.1 起,记录 `stage / code`:缺少搜索凭据显示 WEB_PROVIDER_CREDENTIAL_MISSING 并提示配置搜索或切换当前模型解析;无搜索结果、超时、释义生成失败和引用不符分别提示,不保存上游原始诊断。未配置搜索提供方时不会退回无来源的模型猜测。联网研究操作不依赖浏览开关,但与其他任务共用执行锁;宿主重启不会自动恢复未完成研究,可手动重试。 分类为「候选词 / 已确认 / 已拒绝」,支持按词语、释义、适用语境与原文搜索,分页显示。可批量研究候选、确认已有含义的条目、拒绝与删除;批量确认跳过无含义、无语境或已拒绝的条目并显示数量。单条编辑保存会直接确认;手动添加也会确认。人工修改不被自动提取覆盖;拒绝防止后续提取重新启用,删除后在新语境可能再次出现。多义词可手动写明不同语境用法。任务期间请先停止再编辑。 发帖正文生成会按发帖主题、实际选中的分区与话题,对已确认词条的词语、释义及适用语境作文本匹配,最多提供 20 条相关释义;主题无需直接写出黑话本身。由模型再判断语境,合适时在标题或正文少量自然使用,不匹配时采用普通表达,不强行玩梗。时间规划与 AI 选区不注入词库;每次正文生成或重试读取当前账号的最新确认状态,开关关闭时不提供词库。不会额外调用搜索或学习模型。 自 0.13.9 起,词库和释义对话计数写入 `$DSH_HOME/heybox/slang.json`,最近语境仍写入 `automation.json` 对应账号的 `slang.contexts`。首次启动自动迁移旧词库、释义证据和对话编号 / 已用词数。重启保留、账号隔离,最多 500 条。词语 / 释义 / 语境上限分别为 40 / 400 / 160 字符;每词保留最近 3 份原文证据、来源帖子及 `sourceId`,研究另存检索来源。此机制积累可纠正的词库,不训练模型;模型自评置信度不能替代人工确认,也不保证每次理解梗或反讽都正确。 `GET /heybox/slang` 返回当前账号词库和任务进度;`POST /heybox/slang` 接受 `save / confirm / disable / enable / delete / extract / research` 操作及当前 `accountId`。批量操作提供 `ids`,解释最多 500 条,按已保存的 `slangResearchMode` 执行;其余批量最多 500 条。接口拒绝跨站、非 JSON、过期账号和运行期间编辑;提取和研究返回 202 并在后台执行。模型仍在工具禁用保护内运行。 自 0.13.6 起,「解释我勾选的词」处理所有勾选的待确认词,不再限制 20 个;「全选本页」可选择当前页全部词。「让 AI 解释全部待处理词」处理当前账号所有尚未解释完成的候选。已认可和不使用的词不会被重新解释。任务逐词执行并显示总数与进度,对话按 `slangSessionTerms` 单独分组:选 100 个词、每个对话上限 50 时,正常成功的任务使用 2 个对话。 DSH 自定义处理器通过停用原 `headless-runner`、插入独立处理器加载。旧版在补丁中修改 `name` 的方式会被 DSH 跳过;升级后废弃旧版未核实的会话编号。每次生成必须返回指定会话已保存的回执,否则报错,不再把普通独立会话误认成复用成功。 网页打开黑话专用对话时,后台直接借用宿主内同一个 Agent,避免独立进程争用会话写锁。用户在该对话中处理其他消息时,黑话任务等待空闲;等待超时或无法进入时暂停批次,词语保持待处理且不消耗计数。工具禁用只作用于本轮解释,其他对话照常工作。 黑话提取与解释使用独立后台任务、状态文件和执行锁,不占用浏览 / 回复 / 发帖的执行锁。自动找词也在后台排队,最多等待最近 10 份语境,不让回复等待提取完成;已认可释义可供正在运行的刷帖任务读取。论坛任务之间仍串行,保留发送冷却和去重。两条任务共用模型服务时,仍受服务的并发限制和额度影响。 「只停止黑话任务」取消本轮提取 / 解释并清空等待提取的队列,不关闭自动学习开关,之后新浏览的语境仍可自动找词。停止浏览或回复不会取消黑话任务。「停止全部任务」、退出宿主或切换账号会同时取消两边。黑话批次使用启动时的设置,执行期间保存的新设置用于下一批;停止不删除词库或对话计数,重新解释时继续复用未满的对话。两类后台任务仍由同一个 DSH 宿主管理,未新增系统常驻服务。 ## 每日额度(0.10.9) `dailyComments` 与 `dailyReplies` 分别设置每日评论和回复额度,范围为 0–9999 的整数,默认各为 10,0 表示没有发送额度。升级保留已有值,不会自动提高发送量。每次发送尝试均占额度,包括平台拒绝或结果未知;生成失败不扣额度。按配置时区跨日重新统计,冷却、运行时段和平台限制仍然生效。 ## 独立人格定时发帖(0.11.0) 「发帖」Tab 配置文字新帖,默认关闭。搜索选择目标分区及话题标签(0.11.1),填写独立发帖人格和写作主题,再选择单次、每天或每周时间;保存时绑定当前账号。单次日期和周期时间按 `timeZone` 解释,与浏览调度共用时区;不受浏览峰谷时段限制。每周使用 1–7 表示周一至周日。DSH 宿主必须在线,关闭浏览器不会停止任务。 发帖使用高级设置中的 DSH / 第三方 Chat Completions 模型、超时和命令配置,但人格只取 `postingPersona`,不会回退到通用人格或回复人格。`postingPrompt` 是每次生成的主题与要求。模型返回 send / skip、标题(1–30 字)和正文(1–10000 字,含排版标记),宿主校验后发布;模型不能调用工具。正文排版可选纯文本或 AI 自动排版;可选从梗鲸图库自动配图,不支持本地选图、通用搜图或视频。 | 配置 | 默认值 | 说明 | | --- | --- | --- | | postingEnabled | false | 发帖开关;通过设置页开启时绑定账号 | | postingImages | false | 发帖时从梗鲸自动匹配最多 1 张静态图片,没有合适的或配图失败就只发文字;只影响新任务 | | postingAvoidTitleCard | false | 「避免生成标题卡片」:使用文章形式避开图文卡片模式;纯文本保持原样,正常配图保留。只影响新任务 | | postingFormat | plain | plain 纯文本 / rich AI 自动排版,以文章发布;只影响新建任务 | | postingPersona | 内置独立发帖人格 | 最多 20000 字符,支持完整多行角色卡;开启时不能为空 | | postingPrompt | 游戏话题讨论 | 最多 4000 字,开启时不能为空 | | postingCommunities | [] | 最多 2 个分区,格式 `{ "id": "社区数字 ID", "name": "分区名称" }`;按 ID 去重 | | postingHashtags | [] | 最多 5 个话题,格式 `{ "name": "标签名称", "isActivity": false }`;名称去重,活动话题最多 1 个 | | postingTopicId | 空字符串 | 兼容旧版手填社区 ID;与 postingCommunities 二选一,开启时必须有目标分区 | | postingTimingMode | fixed | fixed 固定时间 / prompt 提示词时间规划 | | postingTimingPrompt | 每天 10–22 点选一个不固定时间 | 最多 2000 字;prompt 开启时不能为空 | | postingDailyLimit | 1 | prompt 模式每日任务上限,1–10 | | postingMinGapMinutes | 60 | prompt 模式最短间隔,10–1440 分钟 | | postingSchedule | daily | once / daily / weekly | | postingTime | 20:00 | 周期任务的 HH:mm 时间 | | postingAt | 空字符串 | 单次任务的 YYYY-MM-DDTHH:mm 日期时间 | | postingWeekdays | [1,2,3,4,5,6,7] | weekly 生效,至少选择一天 | 在「发帖分区与话题」输入名称后点击查询,分别点击分区或话题添加,点击已选项移除,再保存。留空查询合并编辑器推荐、已关注、近期热门及可用分类中的分区,不再只显示编辑器的少量推荐;这不是平台全部分区,其他分区可继续按名称搜索。需要先登录小黑盒。选择分区时自动清空旧版 ID;清空全部分区且未填写旧 ID 时,不能开启发帖。盒友杂谈分区只能单独选择,不能与其他分区组合。话题可不选,清空后发布不带话题标签。分区决定发布位置,话题标签用于分类,`postingPrompt` 决定写什么,三者分别配置。平台仍可能因权限、失效话题或活动要求拒绝发布。 配置文件示例(保存后按既有方式开启计划): ```json { "postingCommunities": [{ "id": "7214", "name": "示例分区,请以平台搜索结果为准" }], "postingHashtags": [{ "name": "示例话题,请以平台搜索结果为准", "isActivity": false }], "postingTopicId": "" } ``` 查询使用官方编辑器的 `/bbs/app/api/post_editor/topic_selection/index` 与 `/search`;宿主通过只读 `GET /heybox/posting-selections?q=关键词` 返回精简结果。社区提交为 `topic_ids`(逗号分隔 ID),话题提交为 `hashtags`(名称 JSON 数组)。手动模式下,模型只能生成标题和正文,不能改变发布目标。 发帖和浏览 / 回复串行执行,共用发送冷却;已在运行的任务可能延迟发布。宿主约每 5 秒检查,到期后生成内容。首次配置周期任务从未来一个时间点开始,不立即补发。超过计划时刻 10 分钟才轮到处理的任务标记 missed,不批量补发;单次任务结束后不重复执行。夏令时不存在的周期时间跳过,重复时刻只执行第一次;不存在的单次时间拒绝保存。 发帖状态保存在 `automation.json` 的账号独立 posting.jobs 中;人格、写作主题和选择设置在任务首次处理时固定;手动模式同时固定分区及话题,AI 模式在候选选择成功后固定发布目标;旧任务沿用原社区 ID。生成失败每分钟最多重试一次,最多尝试 3 次;重启保留未发送任务。保存过发送意图后,网络错误、缺少帖子 ID 或进程退出均视为待确认,不自动重发。平台明确拒绝则记为 rejected,本时间槽不重试。模型 skip 结束本次任务。自 0.13.10 起,跳过时在记录中展示模型提供的具体原因;没有有效原因时显示「模型未说明具体原因」,不会因此自动重试。 accepted 表示平台成功响应且返回帖子 ID;verified 表示进一步读取到相同 ID、标题和正文,都不保证其他账号可见或已经通过审核。每个时间槽只提交一次。切换账号不会把原账号计划交给新账号执行;如需绑定新账号,在该账号下重新保存开启发帖。停止全部任务会关闭发帖并取消尚未发送的生成;已经提交的请求无法撤回。 修改配置文件后仍需通过设置页开启以绑定账号;任务记录不含 Cookie 或 API Key。此版本没有真实账号公开发布验收,接口签名和实际社区权限需另行联调;不得把模拟测试视为公开发布已验证。 ## 提示词时间规划(0.12.0) 推荐使用“每日模型规划 + 宿主定时执行”:模型根据时间提示词输出当天时间数组,宿主保存计划并在到期时唤醒模型生成正文。相比每隔几分钟问模型要不要发帖,这种方式调用更少、时间可查看、重启可恢复,且宿主能校验上限和间隔。插件不向模型开放任意任务工具,不依赖模型在后台等待。 在「发帖」选择「提示词规划时间」,填写时间提示词,设置每日上限、最短间隔,选择分区和话题,设置独立人格及内容主题,然后开启并保存。示例: ```json { "postingTimingMode": "prompt", "postingTimingPrompt": "每天发 1–2 条,安排在 12:00–14:00 或 19:00–22:00,每天的时间不固定,周日不发。今天剩余时间不合适就不发。", "postingDailyLimit": 2, "postingMinGapMinutes": 120 } ``` 两类提示词各司其职:`postingTimingPrompt` 决定何时发,`postingPrompt` 决定写什么;正文继续使用 `postingPersona`,分区 / 话题继续由宿主配置。规划与正文均使用高级设置选择的 DSH 或第三方 API,模型只输出 JSON,工具仍禁止。每天首次开启 / 登录后首次检查,以及宿主恢复后首次检查,会规划当天剩余时间;正常跨天后规划新一天。输入包含当前日期、时区、最早可用时间、当天既有任务、最多 7 次历史计划,以便安排变化的时刻。模型可以返回空数组,表示今天不发,不会因空计划反复请求。 宿主约每 5 秒检查一次本地计划,不调用模型。正常一天调用一次规划,再为每个到期帖子调用一次正文生成;失败重试会增加调用。宿主不在线时无法执行。未开始的昨日计划不会补发;当天超过计划 10 分钟的任务记为错过。生成或冷却期间跨天则不提交昨日帖子。 宿主强制校验:仅接受当天、至少一分钟以后的有效 HH:mm 时间,数量不能超过当天剩余名额,时间不可重复或过密;发送前另按实际发送时刻遵守最短间隔和共用冷却。规划失败或非法输出,至少 5 分钟后重试,最多 3 次,连续中断也计入次数;当日失败后不自动回退固定时间或重新规划。发送结果未知仍不自动重发。 每日上限指当天发帖任务数量,模型 skip、错过、生成失败、平台拒绝或发送待确认均占名额,避免不断补充产生额外任务。已有固定时间任务也计入切换到 prompt 时的当天预算。降低上限会跳过超出部分;增大间隔可能使计划延迟,延迟超过 10 分钟则错过。提示词里的“周日不发”“只在午休”等自然语言条件由模型理解,不能视为宿主已实现对应的硬性时段规则;需要严格固定时间可选原固定模式。模型选择有变化的时间,不承诺数学随机分布。 计划按账号和“时区 + 当地日期”存入 `automation.json` 的 posting.plans,最多保留 30 次;设置页展示最近 14 次。正常重启、关闭再开启、修改提示词不会重新抽取当天计划;新提示词用于下一天。每日上限和实际发送间隔即时约束剩余任务。修改时区会按新时区日期规划,切换回同一账号 / 时区 / 日期复用原计划。原固定时间配置保留,仅在 fixed 模式生效。发帖仍不受浏览峰谷时段限制,且与浏览 / 回复共用执行锁,因此到期执行可能延迟。 当前通过模拟时间和接口测试,尚无真实账号公开发布验收。公开发布权限、审核结果仍由平台决定。 ## 回复自己帖子的评论(0.12.1) 入口:「互动 → 回复来信」。同时开启「自动回复评论」和「自动回复自己帖子的评论」,保存后使用现有消息检查间隔运行。不要求打开定时发帖或定时浏览;也适用于当前账号在 App 手动发布的帖子。仅根据消息接口发现来信,不定期扫描所有历史帖子。保持原消息新鲜度规则:明确未读可包含旧消息,没有可靠读状态时要求启用后的时间戳。 | 配置 | 默认值 | 说明 | | --- | --- | --- | | replyOwnPosts | false | 允许回复自己帖子下其他用户直接发表的顶层评论;需 autoReply=true | | ownPostReplyPersona | reply | reply 使用回复人格(留空回退通用);posting 沿用发帖人格 | | ownPostReplyLimit | 5 | 每篇自己帖子累计最多自动回复条数,0–1000;0 表示不回复自己帖子 | 自 0.13.12 起,「自己的每篇帖子最多回复多少条」默认 5 条,顶层评论和后续直接追问共用每帖额度,不限制其他人的帖子。以当前账号的插件发送记录累计,已有回复计入,跨天和重启不重置;平台内手动发送的回复不计入。已发送、已受理及发送结果未知均占名额;模型跳过、生成失败和平台明确拒绝不占这个额度(每日发送尝试额度仍按原规则计算)。 达到上限后停止处理该帖新来信,在评论记录显示「本帖回复已达上限」。已确认属于自己帖子且达到上限的排队项会移出队列,不继续生成或请求评论详情;发送结果未知的原任务仍保留待确认。调低设置会检查现有队列;调高设置只允许处理尚未被终止的来信,不自动恢复已经停止的旧来信。开启顶层评论回复仍需 replyOwnPosts;即使关闭该开关,自己帖子的后续直接回复也受此累计上限约束。 宿主读取帖子详情核实作者,并确认来信评论 / 根评论关系。顶层评论以自己的评论 ID 作为 root_id,回复目标为对方该条评论 ID。消息缺少 root_comment_id 或返回 0 时,先从详情确定根评论;不会凭通知猜测归属。较旧顶层评论按帖子评论列表分页查找,每轮最多多查 5 页并保存进度。缺失作者、评论或父子关系时保留到下轮;自己发表的评论和已确认不是在回复自己的其他用户对话不回复。 选择 posting 时,优先使用该帖对应的 accepted / verified 发帖任务中的人格快照;记录已清理或属于手动帖子时,使用当前 postingPersona,并要求该人格非空。对自己帖子的顶层评论及后续明确回复自己的评论都使用该选择。其他帖子里回复自己的评论仍使用 replyPersona,留空回退 persona。DSH 与第三方 API 走相同人格注入;模型仍可选择 skip。 共用 repliesPerRound、dailyReplies、replyMaxAttempts、发送冷却、运行时段选择和按账号的 replyQueue / actions 去重。超出本轮数量或每日额度保留;生成失败、平台明确拒绝在单条尝试上限内重试,达到后停止;发送结果未知不重发。关闭 replyOwnPosts 后,已发现的自己帖子顶层评论保留为等待开启,已识别的等待项不会继续占每轮处理名额;其他直接回复自己的评论继续按 autoReply 处理。关闭 autoReply 停止整个回复检查,进行中的生成结果不再发送。 「评论记录」区分“回复自己帖子的评论”并显示人格来源。不保证每条都能回复:仍受消息接口可见范围、删除评论、账号权限、平台限制、模型 skip 和发送结果未知影响。旧版本已经永久标记 skipped 的来信不会自动重置,避免误恢复曾明确忽略的消息。本次仅通过模拟测试,未发送真实账号回复。 ## AI 自动选择分区与话题(0.12.2) 入口:「发帖 → 发帖分区与话题 → 分区与话题选择方式 → AI 自动选择」。不必预先手选分区,仍需填写独立发帖人格、发帖主题并配置发布时间、登录账号和模型。 - **AI 候选搜索词**:选填,最多 100 字。留空合并编辑器推荐、已关注、近期热门及可用分类分区;填写例如“单机游戏”,则使用该关键词的官方搜索结果。该词由用户设置,模型不会自行扩展搜索或遍历全部社区。 - **AI 分区与话题选择偏好**:选填,最多 2000 字,例如“优先讨论游戏设计,避免无关活动话题”。模型结合偏好、发帖主题和独立发帖人格选择目标。 - 每次到期先查询平台候选,模型选择 1–2 个分区、0–5 个话题,活动话题最多 1 个,再按选中目标生成正文。只允许候选中的 ID 和名称,不能编造。候选不代表账号一定有发帖权限。 - 推荐 / 搜索结果为空或模型判断没有合适分区时,本次跳过。查询失败或选择结果无效时按现有任务策略重试,最多 3 次,不回退手动目标或其他分区。 - 本模式保留手动选择供切回使用,但不参与新任务发布。模式、搜索词、偏好、主题与人格在任务首次处理时保存;目标选择成功后固定,生成正文失败或重启不会重新选择。修改设置对已开始任务不生效。 - 「发帖记录」显示 AI 选择标记与最终分区、话题。发送结果未知仍不自动重发。默认保持手动模式,升级不会自动切换或开启发帖。 ```json { "postingSelectionMode": "ai", "postingSelectionQuery": "单机游戏", "postingSelectionPrompt": "优先游戏设计讨论,话题仅选与内容相关的普通话题" } ``` DSH 与第三方 API 均使用高级设置中的模型,选择阶段与正文生成阶段均注入独立发帖人格。相较手动模式,每次首次选区增加候选查询和一次模型请求(留空搜索词时会同时读取推荐及社区列表);模型接收候选名称与分区 ID,不接收 Cookie / API 密钥。该能力可与固定时间或提示词规划时间组合使用。真实账号发帖权限、平台接受及公开可见性仍需验收。 ### 手动浏览与发帖 底部「立即浏览一轮」仅执行浏览和已开启的评论流程,不触发发帖。「立即发帖」在登录、保存设置并开启定时发帖后可用,不要求开启浏览;点击直接按当前发帖人格、主题、分区 / AI 选择及已确认黑话生成并发布一条,结果自动显示在发帖 Tab。 手动任务不重排、不消耗原计划的时间点;计入当天任务数,受 `postingDailyLimit` 和 `postingMinGapMinutes` 限制,两项设置在固定时间和提示词模式下均可见。提示词调度的后续任务会把手动任务计入每日上限;固定时间计划保持既有按时间执行语义。距离上次发帖不足最短间隔、当天名额已满或已有待处理发帖时,明确提示原因,不创建额外任务。 接口 `POST /heybox/automation` 的 `action: "post-now"` 必须提供当前 `accountId` 与 8–100 位字母、数字、下划线或短横线的 `requestId`。同一账号已记录的请求不会重复发布;生成失败沿用原任务重试,最多三次,等待超过十分钟记为错过。平台明确拒绝或结果未知均不自动重发,保留记录供核对。停止任务、切换账号和执行锁保护同样适用。 ### 发帖创作与时间语境(0.13.10) 生成正文时允许虚构角色口吻、明显夸张的玩笑和抽象吐槽;人设和示例只作为风格参考,不被视为真实经历。宽泛主题可以写观点、假设或比喻,不因没有亲身经历直接跳过;需要未提供的事实素材时仍可跳过并解释原因。宿主同时提供当前当地时间和时区,要求涉及此刻、早晚的表达与之相符。模型生成仍需结合实际输出核对,提示词不保证每次都生成合适内容。 ### AI 自动排版 在「发帖 → 独立发帖人格 → 正文排版」选择「AI 自动排版(文章)」并保存。定时发帖和立即发帖共用此选项。短帖自然分段、适当加粗重点,长帖按需要使用一二级小标题、有序或无序列表、引用;不会强制每篇使用全部格式。引用不能编造来源。人格继续控制口吻和篇幅;主题明确要求纯文本时生成普通段落。 DSH 和第三方模型均返回 JSON,正文只允许约定的 Markdown 子集;宿主将其转换为转义后的 HTML 内容块,以 `link_tag=11` 文章格式提交。仅支持 `**加粗**`、`# / ## 小标题`、`> 引用`、`- 列表`、`1. 列表`,不嵌套列表;不执行模型 HTML、不加载链接或图片。摘要及字数从去掉格式标记后的正文计算。纯文本仍以 `link_tag=27` 图文文字块发布。 「避免生成标题卡片」开启时,纯文本也使用文章形式(`link_tag=11`),文字转义后保留换行,不把 `**文字**` 等内容当成 Markdown 排版。AI 自动排版本来就使用文章形式,开启此项不会重复处理。此项通过选择发布形式避开平台图文卡片,不是删除梗图,也不是向平台发送未经证实的“禁止生成封面”参数;平台列表与分享页的最终展示由平台决定。关闭时恢复原来的发布形式,并不强制生成标题图片。新任务保存开关快照,旧任务、已发布帖子与重试不随配置变化。 发帖任务保存创建时的排版选项,重启和重试不改变,旧任务继续纯文本。发帖记录显示本地排版预览,平台最终样式以实际帖子为准。读取核验同时检查标题及 HTML,若平台重写 HTML 或丢失格式,只标记「已受理,尚未核验一致」,不会重复发帖。 ### 发帖自动配图(梗鲸) 在「发帖 → 独立发帖人格」开启「发帖时自动配一张合适的图」。定时和手动发帖均适用,每帖最多 1 张,放在正文末尾。无合适候选、模型跳过、下载 / 处理 / 上传失败时只发文字;发帖记录显示配图、来源页、目录署名、匹配理由或未配图原因。纯文本图文帖和自动排版文章均支持。 先生成正文,再从 [梗鲸公开目录](https://aigengtu.com/gallery-index.json)按文字相关性筛选最多 20 张,让当前 DSH / 第三方模型根据标题、台词、使用场景选 1 张或跳过。目录内容作为不可信素材;模型只能返回候选编号,不能提供任意图片地址。此步骤基于目录描述,不是视觉模型看图或图像审核。排除明显不适宜的台词和动图,避免最近 30 个已受理 / 已核验 / 结果未知的带图任务重复使用同一编号;没有合适的替代图就不配。 目录在内存中缓存最多 6 小时,不下载整站图片;只下载选中的 1 张,最多 8 MiB。`sharp` 是可选依赖,验证并解码 PNG / JPEG / WebP 静态图片,限制 1600 万像素,等比缩至不超过 2048×2048 并转换为 PNG;依赖不可用时配图失败回退文字,其他功能继续运行。公共下载不携带平台 Cookie,限制域名和重定向;小黑盒上传凭据仅用于指定 COS 存储桶,不持久保存或交给模型。图片经上传回调后才写入发帖内容,不把第三方图床链接当作小黑盒图片。 任务保存配图开关、正文及选图结果。上传前记录意图;上传中断后不盲目重传,恢复任务只发文字。已经上传的图片随正文快照恢复,发布结果未知时不重发帖子。配图流程设置 120 秒超时,正在进行的平台请求仍受自身请求超时约束;配图仍属于发帖任务,与浏览 / 回复共用执行锁和冷却;黑话解释保持独立运行。