# 2SOMEone — 完整文档 > Live Different. 2SOMEone 面向 B 站和抖音主播、粉丝与公会运营，提供直播数据、互动社区、树洞投稿、粉丝关系和跨端创作工具。 源站: https://2some.ren --- ## 二次元入侵 URL: https://2some.ren/docs/ai-draw 描述: AI 绘图功能，让你的虚拟形象融入各种创意场景 # 二次元入侵 二次元入侵是 2SOMEone 的 AI 绘图功能，让主播的虚拟形象突破次元壁，融入各种创意场景。粉丝可以使用主播开放的角色，生成独一无二的创意图片。 每成功生成一张图扣 ¥0.5，优先消耗赠送余额。生成失败不计费，余额不足时不会创建任务。 ## 功能特色 ### 角色预设系统 主播可以创建专属的角色，让 AI 记住你的形象： - 上传 1 张角色参考图片，AI 学习角色特征 - 选择一个内置风格模板，系统自动套用对应提示词 - 多个角色自由切换 - 没建角色也能用：只要设置了头像，系统会提供「默认角色（头像）」选项，零配置直接生成 - 粉丝可基于你开放的角色创作 新建角色时必须先选一个风格模板，系统会自动应用对应的提示词和描述： | 风格模板 | 效果 | |------|------| | 将二次元角色融入现实 | 把动漫角色自然融入真实世界场景 | | 创作表情包 | 制作有趣的表情包和梗图 | ### 智能图片生成 基于先进的 AI 模型生成图片： - **写实背景**：二次元角色融入真实背景 - **统一画风**：全图统一二次元风格 - 支持横屏、竖屏、方形三种画面比例 - 每次创作生成 1 张图片 - 实时显示生成进度 ### 场景模板库 内置丰富的场景模板，快速激发创作灵感。选择模板后会自动填入对应提示词，你可以在此基础上继续修改： **新年特辑** - 烟花倒计时、新年派对、写春联 - 年夜饭、红包拜年、烟花庆典 - 新年庙会、雪中迎新、许愿祈福 - 堆雪人、新年愿望等 **经典场景** - 雪山步道、咖啡厅、樱花树下 - 城市天台、海边日落、雨中漫步 - 图书馆、秋日银杏、星空露营 - 花田少女、地铁时光、古镇茶馆等 **抽象 Meme** - 极简抽象重绘：把任意输入图重绘为白底极简抽象 meme 海报，只保留构图骨架，删除所有文字、五官、纹理等细节 ## 使用方法 ### 主播：创建角色 1. 进入「控制台」→「绘图」，点击「管理角色」 2. 在角色管理页点击新建角色 3. 选择一个风格模板（将二次元角色融入现实 / 创作表情包） 4. 填写角色名称，描述可选 5. 上传 1 张角色参考图片 6. 保存后即可在创作时选择该角色 参考图片越清晰、角色特征越明显，生成效果越好。 ### 主播：开放粉丝创作页 默认情况下，你的粉丝创作页是关闭的。打开后粉丝才能访问，用你开放的角色创作图片。 1. 进入「控制台」→「绘图」 2. 打开顶部的「粉丝创作」开关 3. 开关打开后会出现「粉丝创作页」按钮，点击即可进入并分享给粉丝 粉丝创作页需主播先打开「粉丝创作」开关，粉丝才能访问。开关关闭时，粉丝打开该页面会提示页面不存在。 ### 粉丝：生成创意图片 1. 进入主播的粉丝创作页（需主播已打开「粉丝创作」开关） 2. 选择要使用的角色 3. 输入场景描述，或选择一个场景模板 4. 选择画风和画面比例 5. 点击开始创作，等待 AI 生成 ### 查看创作记录 提交创作后，绘图页会保留你的历史任务列表，可随时回看： | 状态 | 说明 | |------|------| | 待处理 | 任务已提交，排队等待生成 | | 生成中 | AI 正在创作，页面会自动刷新进度 | | 已完成 | 图片生成完毕，可查看与下载 | | 已失败 | 生成失败，会显示失败原因 | ### 参考图片 除了角色，还可以上传额外的参考图片，帮助 AI 更好理解创作意图： - 支持场景、姿势、风格参考 - 与角色和提示词共同决定最终效果 ## 画风选择 | 画风 | 效果 | 适用场景 | |------|------|---------| | 写实背景 | 二次元角色 + 真实背景 | 街拍、风景、日常 | | 统一画风 | 全图二次元风格 | 动漫场景、插画风格 | ## 画面比例 | 比例 | 说明 | 适用场景 | |------|------|---------| | 横屏 16:9 | 宽幅画面 | 壁纸、直播背景 | | 竖屏 9:16 | 竖幅画面 | 手机壁纸、社交媒体 | | 方形 1:1 | 正方形画面 | 头像、社交分享 | 比例是创作时的目标值，实际输出的精确分辨率由 AI 模型决定，可能与目标比例略有出入。 ## 产物管理 打开任意一次创作的详情页，可以对成品做这些操作： - **查看大图**：点击图片放大查看细节 - **下载图片**：把成品保存到本地 - **混图**：一键把这张图的提示词带到新创作，方便在满意的结果上继续微调 ## 公开画廊 全平台公开的 AI 创作汇总在 [画廊](/gallery)： - 以瀑布流展示所有公开作品，所有人都能浏览 - 点击图片可在线预览大图并下载 - 是发现灵感、寻找创作思路的主入口 ## 常见问题 ### 这个功能要花钱吗？ 每成功生成一张图扣 ¥0.5。扣费发生在图片生成完成之后，生成失败或被审核拒绝都不会扣费。扣费时优先消耗赠送余额，赠送余额用完才扣充值余额。发起创作前余额不足会直接提示，不会创建任务。 ### 生成需要多长时间？ 通常 30 秒到 2 分钟，取决于服务器负载。页面会实时显示生成进度。 ### 生成失败怎么办？ 可能原因： - 提示词包含敏感内容 - 参考图片不清晰 - 服务器繁忙 建议调整提示词后重试。失败任务会在详情页显示具体原因。 ### 一次能生成几张图？ 每次创作固定生成 1 张图片。想要更多结果，可重复创作或用「混图」在满意的提示词上继续生成。 ### 可以商用生成的图片吗？ 生成的图片版权归创作者所有，但请注意： - 不得用于违法用途 - 建议标注"AI 生成" - 商业使用请遵守平台规定 ### 如何提高生成质量？ 1. 使用清晰的角色参考图 2. 提示词描述具体、详细 3. 选择合适的画风和比例 4. 上传辅助参考图片 --- ## 浏览器扩展 URL: https://2some.ren/docs/browser-extension 描述: 2SOMEone 直播数据助手，后台自动同步 B 站与抖音直播间数据 # 浏览器扩展 2SOMEone 提供两款浏览器扩展，一款帮主播自动同步直播数据，一款帮公会经纪人发掘新主播。 两款扩展都只支持 **Chrome 与 Edge（Chromium 内核）桌面浏览器**。2SOMEone 桌面 App 内不支持浏览器扩展，请用浏览器访问。 - **2SOMEone 直播数据助手**：自动同步你绑定的 B 站 / 抖音直播间数据，喂给 2SOMEone 做数据分析（本页介绍）。 - **公会经纪人助手**：帮 B 站直播公会经纪人查询签约状态、发掘新主播，详见 [公会经纪人助手](/docs/guild-agent-extension)。 --- ## 2SOMEone 直播数据助手 这款扩展会在后台自动同步你绑定的 B 站 / 抖音直播间数据，让 2SOMEone 的礼物统计、舰长管理、场次回顾等功能拿到完整数据。装好挂在浏览器里即可，平时不用操心。 下载安装：[Edge 扩展商店](https://microsoftedge.microsoft.com/addons/detail/enlmadjdnigmcfaadfikepeffchgldlb) | [Chrome 扩展商店](https://chromewebstore.google.com/detail/2someone/oafkikkdinjdhiahfadkcjgephnbgapa) 仅支持 Chrome 与 Edge（Chromium 内核）桌面浏览器。安装后建议把扩展固定到浏览器常驻栏，并保持登录 B 站账号，让后台同步持续运行。 ### 主要功能 | 功能 | 说明 | |------|------| | 直播数据同步 | 后台自动同步 B 站直播数据：礼物流水、在舰舰长名单、直播场次、弹幕身份、房间信息；房间开播状态也是 [开播通知](/docs/live-tools/go-live-notify) 的数据来源 | | 抖音直播间同步 | 已绑定抖音直播间的主播，自动同步抖音直播间的开播状态、标题、封面、观看人数与主播基础信息 | | B 站多账号切换 | 管理多个 B 站账号，快速切换登录身份 | | 弹幕辅助登录 | 通过发送验证码弹幕，把你的 B 站账号与 2SOMEone 账号安全绑定 / 登录 | | 音乐歌单导出 | 把网易云音乐、QQ 音乐的歌单批量导出成 Excel（歌名 / 歌手 / 专辑），方便整理直播歌单 | ### 后台数据同步 扩展会在后台自动同步以下数据，无需手动操作： | 同步项 | 说明 | |------|------| | 礼物数据同步 | 同步礼物流水，包含舰长上舰记录 | | 在舰舰长同步 | 自动更新当前在舰舰长名单 | | 直播场次同步 | 补齐直播场次记录 | | 弹幕身份同步 | 同步弹幕身份信息 | 数据查看和管理都在 2SOMEone 后台，不在扩展里。你可以打开「**仪表盘 → 浏览器扩展**」查看每项同步服务的最近同步时间、运行日志，并管理 B 站多账号。 遇到数据延迟或缺失时，可在「仪表盘 → 浏览器扩展 → 数据同步」里点「刷新状态」查看最新情况，或点「强制同步」请求扩展后台立即重新执行一次对应服务。 强制同步只是发起任务，不代表瞬间完成。同步需要扩展读取直播间信息、拉取平台数据再上传处理，状态更新时间可能稍后才变化。如果扩展当前拿不到有效的直播间信息（如房间状态未就绪），部分同步会直接跳过。 ### 抖音直播间同步 绑定抖音直播间后，扩展会自动抓取并上报抖音直播间的开播状态、标题、封面、观看人数和主播基础信息，让数据分析覆盖抖音端，而不只是 B 站。 ### 弹幕辅助登录 这是把 B 站账号与 2SOMEone 账号绑定的安全方式： 1. 先在 2SOMEone 里绑定你的 B 站账号 2. 登录你的 B 站账号 3. 在扩展的「Bilibili 弹幕辅助登录」页面发起授权 4. 扩展会自动向指定直播间发送一条验证码弹幕完成校验，无需你手动操作 ### 音乐歌单导出 打开网易云音乐或 QQ 音乐的歌单页面，扩展可把歌单批量导出成 Excel，包含歌名、歌手、专辑等字段，方便整理直播选歌单。 --- ## 更多扩展 ### MultiPost 同步发布 同步发布功能已迁移至独立扩展 **MultiPost**，本扩展不再提供同步发布。MultiPost 是一款独立扩展，能帮你一次发布即同步推送内容到多个平台，无需重复操作。 访问 https://multipost.app 安装。 --- ## 常见问题排查 如果遇到扩展不好用的问题，可以按照以下步骤尝试解决： ### 1. 扩展没有开启 打开浏览器输入： - Chrome: `chrome://extensions/` - Edge: `edge://extensions/` 检查扩展是否处于开启状态，如关闭请重新打开。 ### 2. 浏览器版本过旧 在地址栏输入： - Chrome: `chrome://settings/help` - Edge: `edge://settings/help` 确认浏览器已更新到最新版本。 ### 3. 清理缓存后重启 打开浏览器设置 → 隐私和安全 → 清理浏览数据，勾选「缓存的图片和文件」，清理后完全退出浏览器，再重新打开。 ### 4. 重启或重装扩展 在扩展管理页面： - 先关闭再打开扩展 - 如果仍无效，点击「移除」→ 前往商店重新安装扩展 ### 5. 数据没有同步上来 1. 确认扩展处于开启状态，且已登录 B 站账号 2. 打开「仪表盘 → 浏览器扩展」查看同步状态与运行日志 3. 在「数据同步」里点「强制同步」重试一次 4. 如果还是不行，请通过下方渠道反馈 1. 打开扩展管理页 → 关闭再打开扩展 2. 如果还是不行 → 移除扩展 → 重新安装 → 重启浏览器 --- ## 问题反馈 为了更快帮您定位并解决问题，请在反馈时尽量提供以下信息： 1. **问题截图**（包括扩展界面或报错提示） 2. **报错信息**（如 Console 中的错误内容，或提示文字） 3. **复现步骤**（简单描述您是如何操作后出现该问题的） 4. 通过[社区频道](/community)反馈 --- ## 任务中心 URL: https://2some.ren/docs/checkin 描述: 完成任务、邀请好友、签到领钱，赚取平台余额与返佣 # 任务中心 任务中心是 2SOMEone 的「赚余额」入口。每天签到、发泡泡、运营粉丝群，完成绑定与推广任务，都能领到余额奖励。邀请好友注册、好友充值，你还能拿到可提现到支付宝的现金返佣。 ## 进入任务中心 1. 登录你的 2SOMEone 账号 2. 从右上角用户菜单或控制台首页进入「任务中心」 3. 查看可用任务并完成 ## 每日签到 - 每天可签到一次，每日 0:00（北京时间）刷新 - 签到奖励为 **¥0.5~¥5** 的随机金额（多数是小额，偶尔会抽到较大金额） - 签到点一下就直接到账，无需再点领取 - 错过的签到无法补签 ## 任务分类 任务中心按照重置规律分成三组，和页面上看到的一致： | 分组 | 重置规律 | 代表任务 | |------|----------|----------| | **每日任务** | 每天 0:00（北京时间）重置 | 每日签到、每日创建泡泡、每日泡泡互动、粉丝群今日人气 | | **周期任务** | 按周 / 按月重置，每个周期可领一次 | B 站签名推广（每月一次）、B 站动态推广（每月一次） | | **成就任务** | 一次性，完成后永久有效，进「已完成」折叠区 | 绑定账号、设置密码 / 头像、收集树洞、B 站万粉达人、开通粉丝群、加入官方群 | 部分任务有前置条件。例如要先完成「开通你的粉丝群」，才会解锁「粉丝群今日人气」的每日奖励。未满足前置条件的任务会置灰锁定。 ## 代表性任务与奖励 下面列出几个高价值任务，让你心里有数。完整任务清单和实时奖励金额以任务中心页面为准。 | 任务 | 奖励 | 说明 | |------|------|------| | B 站万粉达人 | ¥30 | 绑定的 B 站账号粉丝数达到 10000 | | 收集 10 条泡泡树洞 | ¥10 | 在泡泡树洞累计收集到 10 条投稿 | | 粉丝群今日人气 | ¥0.2 / ¥1 / ¥5 | 按当日活跃人数分档：≥3 人 ¥0.2、≥10 人 ¥1、≥50 人 ¥5（需先开通粉丝群） | | B 站签名推广 | ¥3 / 月 | 在 B 站个人签名加入 2some.ren / 2some.one / 2s1.at 链接 | | B 站动态推广 | ¥3 / 月 | 在 B 站发动态，分享收稿链接或介绍泡泡树洞 / 2SOMEone | | 收集第一条泡泡树洞 | ¥1 | 收到第一条投稿 | | 每日创建泡泡 | ¥1 | 当天发一条不少于 15 字并配图的原创泡泡 | | 每日泡泡互动 | ¥1 | 当天在泡泡广场回复或转发 5 条泡泡 | | 开通你的粉丝群 | ¥1 | 创建粉丝群并公开到个人主页，解锁每日人气奖励。建群时开播提醒默认已开，公开成粉丝群不会改这个开关，见 [开播通知](/docs/live-tools/go-live-notify) | | 加入官方用户群并打招呼 | ¥1 | 加入官方大群并在群里发条消息 | | 绑定 / 安全类任务 | 各 ¥1 | 绑定 B 站 / 抖音 / 邮箱 / 手机号、设置密码 / 头像 / 用户名等 | ## 领取奖励 - **每日签到**：点击签到按钮即直接到账，无需再点领取。 - **其他任务**：完成后（部分需先验证，进任务中心页面时会自动校验绑定、收稿、粉丝数等条件）在任务卡片点「领取奖励」按钮，奖励到账你的赠送余额。 任务奖励有效期为 **90 天**，请及时使用。过期后未使用的赠送余额将失效。 ## 邀请奖励 把邀请码或邀请链接发给好友，好友注册时填写邀请码，即可获得阶梯式奖励： | 条件 | 奖励 | |------|------| | 注册时填写邀请码 | 双方各得 ¥0.5 | | 被邀请人绑定 B 站 | 仅被邀请人 +¥1（此档邀请人不另得） | | 被邀请人 B 站粉丝 ≥ 1000 | 双方各得 +¥5 | | 被邀请人 B 站粉丝 ≥ 10000 | 双方各得 +¥10 | ### 充值返佣（可提现） 除了上面的注册阶梯奖励，被邀请人通过支付宝、Apple 内购、Stripe 或 Infini 完成**普通充值**，你都能拿到实付金额 **30%** 的返佣（单笔最高 ¥1000）。¥0.99 首充特惠不产生返佣，好友以后每次普通充值都算。 返佣进入独立的「返佣余额」，可以提现到支付宝： | 规则 | 数值 | |------|------| | 返佣比例 | 实付金额的 30% | | 单笔充值返佣上限 | ¥1000 | | 提现方式 | 支付宝 | | 单次最低提现 | ¥100 | | 单次最高提现 | ¥10000 | | 两次提现间隔 | 7 天 | 返佣余额与赠送余额是两套，互不相通。返佣余额可提现到支付宝；任务、签到、邀请所得的赠送余额只能用于平台内消费，不可提现。 邀请人只会看到完成注册、绑定 B 站、达到千粉 / 万粉的人数汇总，不会看到被邀请人的昵称、账号或充值明细。群聊邀请和公会邀请也不会自动附带个人邀请码。 ## 余额使用 平台余额分为几类，用途不同： | 余额类型 | 来源 | 用途 | |----------|------|------| | **赠送余额** | 任务、签到、邀请奖励 | 平台内付费功能消费，有 90 天有效期，消费时优先扣除，不可提现 | | **充值余额** | 自己充值 | 平台内付费功能消费，无有效期 | | **返佣余额** | 好友充值返佣 | 可提现到支付宝（另算，见上方充值返佣） | 新注册用户享有 **7 天免费试用期**，试用期内使用平台功能不扣除余额。试用期内完成任务领取的赠送余额会正常累积，试用期结束后可用于功能消费。 任务内容、奖励金额和规则可能随平台更新调整，最终解释权归开发团队所有。 --- ## 公会经纪人助手 URL: https://2some.ren/docs/guild-agent-extension 描述: 专为 B 站直播公会经纪人打造的星探工具 # 公会经纪人助手 本扩展致力于简化公会经纪人在 B 站直播发掘新人的繁复流程。 下载安装：[Edge 扩展商店（推荐）](https://microsoftedge.microsoft.com/addons/detail/moplnioedldjaeekibbiefinkfcfejma) | [Chrome 扩展商店](https://chromewebstore.google.com/detail/2someone-galaxy/nhkgbjnfchcnkopcmdelenoidkbbfldd) 本扩展仅支持 **Chrome 与 Edge（Chromium 内核）桌面浏览器**。请勿将账号出借给他人使用，并严格遵守[用户协议](/legal/terms)。违规使用所产生的任何后果，请用户自行承担。安装并使用扩展则表示您同意相关条款。 --- ## 开始之前 1. 请先安装扩展（见上方下载链接） 2. 请确保你当前登录的 B 站账号，在所属 B 站公会具有「经纪人」或更高权限 --- ## 功能介绍 ### 一、直播页快速查看签约状态 在直播首页和搜索直播页，主播卡片会自动附加签约状态标签，帮助快速定位未签约主播。 - 绿色标签为「已签约」 - 红色标签为「未签约」 在直播广场、搜索结果和视频列表的主播卡片上，还会出现查询按钮，点一下即可拉取该主播的详细信息（会消耗公会查询次数，见下文）。 **直播首页** https://live.bilibili.com/ 直播首页签约状态展示 **搜索直播页** https://search.bilibili.com/live 搜索直播页签约状态展示 ### 二、使用弹窗快速查看某主播的详细信息 在直播间或个人空间直接左键单击扩展图标即可弹出用户状态。在直播间页面和 B 站个人空间，扩展还会直接注入一个**悬浮窗**展示这些信息，不必每次点图标。 除了签约状态，这里还能看到更丰富的字段，帮你快速判断主播价值： | 信息 | 说明 | |------|------| | 签约状态 | 已签约 / 未签约 | | 繁星主播与星级 | 是否繁星主播及其星级 | | 新主播标记 | 是否新主播 | | 有效直播天数 | 该主播累计有效直播天数 | | 粉丝数 | 当前粉丝数 | | 主播等级 | B 站主播等级 | | 直播状态 | 直播中 / 未开播及在线人数 | | 官方认证 | 是否有官方认证 | | 信息有效期 | 当前信息的有效期提示 | 悬浮窗里还提供「空间」「私信」快捷入口，可一键跳转主播个人空间或发起私信。 **直播间示例** https://live.bilibili.com/1837653836 直播间弹窗查看签约状态 **个人空间示例** https://space.bilibili.com/490807223/ 个人空间弹窗查看签约状态 为方便使用该功能，可以将扩展固定到浏览器常驻栏。 侧边栏记录签约状态 ### 三、使用弹窗快速搜索签约状态 在弹窗的签约查询中可以快速查询 UID 和直播间号的签约状态。 签约查询 主动查询会消耗公会的查询次数配额，包括：在弹窗里输入 UID / 房间号查询，以及点击主播卡片上的查询按钮。命中缓存的展示不额外消耗。 ### 四、使用侧边栏记录签约状态 #### Chrome 浏览器 右键扩展后点击「打开侧边栏」 Chrome 打开侧边栏 #### Edge 浏览器 右键扩展后点击「在边栏中打开」 Edge 打开侧边栏 之后访问任意直播间或个人空间，侧边栏会自动查询用户的签约状态并记录。侧边栏顶部有「仅未签约」开关，一键过滤出未签约主播，方便集中跟进。每条记录还会显示私信状态与未读私信数，点一下即可跳转到对应私信会话。 侧边栏 你可以随时把记录导出成 Excel。导出文件字段非常丰富，方便后续筛选与跟进： | 字段 | 字段 | |------|------| | 主播名称 / UID / 房间号 | 签约状态 / 私信状态 | | 繁星等级 / 主播等级 | 粉丝数 / 直播天数 | | 直播分区 / 直播状态 / 直播标题 | 在线人数 / 开播时间 | | 粉丝牌 / 新主播 / 官方认证 | 最后更新 / 来源链接 | 目前这个功能列表最多有 100 条，超出后自动覆盖最早添加的用户。 ### 五、账号切换 左键单击扩展图标后可以查看到「B站账号切换」，点击添加账号即可新增一个账号，之后选择任意账号会自动切换到选择的账号。 ### 六、私信模板自动填充 打开 B 站私信页面时，发送按钮旁会出现「📝 模板」按钮，点开即可一键插入预设的私信模板，省去每次手打开场白。如果把某条模板设为默认模板，打开私信页时会自动填充，进一步提升星探冷接触效率。 模板在扩展的「设置 → 私信设置」里管理，可自行新增、编辑。 --- ## 订阅与签到 付费用户可以在弹窗顶部和设置页管理订阅： - **订阅状态与有效期**：弹窗顶部的订阅卡片会显示「使用中 / 已过期」状态与有效期日期。 - **每日签到**：付费用户可在弹窗里点「去签到」完成每日签到，已签到则显示「今日已签到」。 - **续费订阅**：在弹窗或设置页点「续费订阅」，会跳转到官网续费页 `/extension/bili-galaxy/subscription` 完成续费。 - **领取免费试用**：还没买的可以先试用，详见下方「免费试用」。 **订阅绑定单一设备。** 同一账号在另一台浏览器登录时，会触发会话冲突，当前设备的订阅功能会暂停。换设备使用时，在弹窗里点「切换到此设备」即可恢复。看到「账号已在其他设备登录」的提示不是 bug，点切换即可。 --- ## 免费试用 付费版可以先免费试用，降低决策门槛。在扩展的「设置 → 订阅信息」里点击「领取免费试用」即可开通。 每个公会最多 **3 个**试用名额。 --- ## 版本与价格 不同档位开放的功能不同，按月付 / 半年付分层。完整价格与购买入口见定价页 [/extension/bili-galaxy](/extension/bili-galaxy)。 | 版本 | 价格 | 主要功能 | |------|------|------| | 免费版 | ¥0 | 签约查询、账号切换、私信模板、基础星探工具 | | 月付版 | ¥499 / 月 / 席位 | 免费版全部功能 + 直播广场自动展示签约状态、直播间自动显示签约信息、更便利的自动化体验 | | 半年付版（主推） | ¥999 / 半年 / 席位 | 月付版全部功能 + 批量导出数据、多账号管理、团队协作支持 | | 公会团购 | ¥799 / 半年 / 席位 | 5 席起购，含半年付版全部功能 + 公会批量管理、优先技术支持 | 批量导出数据、多账号管理、团队协作支持属于半年付版及以上档位，月付版不含这些功能。 --- ## 更多扩展 ### MultiPost 同步发布 访问 https://multipost.app 扩展将帮助用户同步内容到多个平台，只需一次发布即可推送到多平台，无需重复操作。 --- ## 常见问题排查 如果您遇到扩展不好用的问题，可以按照以下步骤尝试解决： ### 1. 扩展没有开启 打开浏览器输入： - Chrome: `chrome://extensions/` - Edge: `edge://extensions/` 检查扩展是否处于开启状态，如关闭请重新打开。 ### 2. 浏览器版本过旧 在地址栏输入： - Chrome: `chrome://settings/help` - Edge: `edge://settings/help` 确认浏览器已更新到最新版本。 ### 3. 清理缓存后重启 打开浏览器设置 → 隐私和安全 → 清理浏览数据，勾选「缓存的图片和文件」，清理后完全退出浏览器，再重新打开。 ### 4. 重启或重装扩展 在扩展管理页面： - 先关闭再打开扩展 - 如果仍无效，点击「移除」→ 前往商店重新安装扩展 ### 5. 禁用可能冲突的扩展 临时关闭其他扩展（如广告拦截器、脚本管理器），再试一次。 ### 6. 查看报错信息（进阶） 在扩展管理页 → 开启「开发者模式」→ 找到该扩展 → 点击「背景页/Service Worker」→ 查看 Console 是否有错误提示。 1. 打开扩展管理页 → 关闭再打开扩展 2. 如果还是不行 → 移除扩展 → 重新安装 → 重启浏览器 --- ## 问题反馈 为了更快帮您定位并解决问题，请您在反馈时尽量提供以下信息： 1. **问题截图**（包括扩展界面或报错提示） 2. **报错信息**（如 Console 中的错误内容，或提示文字） 3. **复现步骤**（简单描述您是如何操作后出现该问题的，例如"打开扩展 → 点击登录 → 报错"） 4. 通过[社区频道](/community)反馈 如果您无法正常提供上述调试信息、报错详情或复现流程，请参考 https://2some.one/pricing#tech ，通过付费技术支持渠道获取一对一排查和解决服务。 --- ## 联系我们 公会经纪人助手交流 QQ 群：**781254109** --- ## 快速开始 URL: https://2some.ren/docs/ 描述: 快速了解 2SOMEone 平台及其核心功能 # 快速开始 欢迎来到 2SOMEone 官方文档！我们提供两个站点：大陆站 [2some.one](https://2some.one) 和国际站 [2some.ren](https://2some.ren)，数据互通，根据网络状况选择即可。 ## 2SOMEone 是什么？ **2SOMEone** 的品牌口号是 **Live Different**。我们服务主播、粉丝和公会运营，把直播数据、粉丝互动、内容创作、社群关系和变现工具放在同一个跨端产品里。 ## 核心功能 ### 泡泡树洞 匿名投稿平台，为粉丝互动带来全新体验： - 支持匿名/实名投稿 - AI 智能审核与情感分析 - 弹幕系统，打造沉浸式直播体验 - 稿件分类管理、AI 摘要生成 ### 礼兮 直播数据分析专家，深度洞察粉丝消费行为： - B 站礼物统计与大航海数据分析 - 舰长管理与在舰回顾 - 粉丝地址收集与管理 - 大航海消费统计报表 ### 僚机 弹幕机工具，实时掌控直播间动态： - 弹幕分析与实时监控 - SC 和礼物数据追踪 - 用户行为分析 - 舰长信息管理 详见 [创作直播工具](/docs/live-tools)。 ### 私信 / 群聊 沉淀私域、运营粉丝群的核心入口： - 一对一私信，可从对方个人空间直接发起 - 建立粉丝群，容量按群主等级分档（Level 0：50 人、Level 1：1000 人、Level 2：技术封顶 10000 人），每群最多 10 名管理员 - 群主开播后自动在自己当群主的群里发提醒（粉丝群最常用），详见 [开播通知](/docs/live-tools/go-live-notify) - 群聊邀请中心，方便拉新与统一管理 - 官方社群入口，第一时间获取平台动态 详见 [私信与群聊](/docs/chat)。 ### 机器人 Bot 用自动化账号发泡泡、在已安装的群里发消息，或登记 HTTPS 回调，在被斜杠命令点到时被平台叫醒。轮询群消息仍然可用；高频限额需要充值 VIP 1，并在升级后重新轮换运行密钥。 详见 [机器人 Bot](/docs/bots)。 ### AI 角色与剧情 从公开目录直接使用创作者上架的角色卡或酒馆卡开始会话；卡片仍归发布者，隐藏设定不会公开。前往 [角色与剧情](/roleplay)。旧版角色广场的历史边界仍见 [下线说明](/docs/characters)。 ### 个人小店 把流量直接变成收入： - 上架商品与服务，自定义小店设置 - 在个人空间对外展示，粉丝随时下单 - 后台接收并管理订单状态 详见 [账号与计费](/docs/billing)。 ### 直播日程 让粉丝随时掌握你的开播安排： - 用周编辑器维护每周直播日程 - 在个人空间对外展示 - 支持 ICS 日历订阅 - 同步 B 站直播预约 - 粉丝可订阅开播前提醒，以及开播时再提醒一次 详见 [直播日程](/docs/live-tools/schedule) 和 [开播通知](/docs/live-tools/go-live-notify)。 ### 互动测试 在直播间和观众实时玩起来： - MBTI 人格测试：极速版（28 题）、通用版（40 题）、标准版（93 题）三套题库 - SBTI 人格测试：30 题、15 维度、27 种人格类型 - 进入 OBS 直播后台与观众实时互动，或生成公开页分享给粉丝 详见 [创作直播工具](/docs/live-tools)。 ### 公会专区 公会管理一体化解决方案： - 公会专页与成员阵容对外展示 - 公会驾驶舱后台：成员管理、邀请管理、营收结算 - 星河 / 星探 CRM 工具 - 经纪人助手浏览器扩展：星探工具、签约查询、签约记录导出 详见 [俱乐部 / 公会](/docs/club)。 ### 创作工具 丰富的创作辅助工具： - AI 绘图工具 - 动态九图生成器 - V圈生涯、从夯到拉（Tier List） - 塔罗牌、答案之书 - 图片格式转换、图片缩放、图片裁剪、背景移除 ### 任务中心 完成平台任务，赚取余额奖励： - 每日签到、绑定任务、安全任务、成就任务、推广任务 - 任务奖励可用于平台内各项付费功能 - 邀请好友注册，双方阶梯式得奖励 详见 [任务中心](/docs/checkin)。 ### 浏览器扩展 提升工作效率的浏览器插件： - **2SOMEone 直播数据助手**：后台自动同步 B 站 / 抖音直播间数据、多账号切换、弹幕辅助登录 - **公会经纪人助手**：星探工具、签约查询 详见 [浏览器扩展](/docs/browser-extension)。 --- ## 如何阅读本文档 本文档按功能模块组织，您可以： 1. **新用户**：先阅读 [登录与注册](/docs/account/login-register) 了解如何创建账号 2. **按需查阅**：通过左侧导航栏找到您需要的功能说明 3. **开发者 / 进阶用户**：想用 API 或编写机器人，请看 [机器人 Bot](/docs/bots) 分组 4. **遇到问题**：查看各功能页面的「常见问题」部分 如有任何问题，请发送邮件至 support@leaper.one 联系客服团队。 --- ## 个人空间 URL: https://2some.ren/docs/profile 描述: 了解如何设置和使用你的个人空间 # 个人空间 个人空间是你在 2SOMEone 上的公开展示页面。访客通过它了解你、关注你、给你发私信、看你的日程和作品。 ## 访问个人空间 每位用户都有专属的个人空间： ``` https://2some.ren/[用户名] ``` 例如，用户名为 `harry` 的用户，个人空间地址为：`https://2some.ren/harry` ## 页面结构 个人空间分成两部分：上方是**头部资料区**，下方是**顶部标签栏**切换的子页。 ### 头部资料区 头部固定展示你的基本信息和互动入口，访客都能看到： | 内容 | 说明 | |------|------| | **头像和昵称** | 你的个人形象，开播时昵称旁会显示直播标记 | | **关注 / 粉丝数** | 显示你的关注数和粉丝数，点击可查看「关注中」和「粉丝」名单 | | **关注按钮** | 访客一键关注你 | | **发私信** | 访客点击后直接和你开启 1:1 私信对话 | | **B 站 / 抖音** | 昵称下方的社交按钮，点击弹出资料卡（显示 B 站粉丝数等），可跳转对方主页 | | **公告** | 你置顶的公告信息，可附带一个外链 | | **自定义链接** | 你配置的外部链接按钮 | | **粉丝群** | 你创建并公开的粉丝群，访客可一键加入并进入群聊 | | **AI 角色卡** | 展示你公开的可聊天 AI 角色（最多 3 个），访客点击即可和角色对话 | | **直播卡片** | 仅在你开播时显示，含封面、标题、观看人数、关注数、已播时长、分区，点击进入直播间 | 未开播时不显示直播卡片，只在头像 / 昵称旁出现一个直播标记。绑定 B 站后才会有直播状态。 ### 顶部标签栏 头部下方是一排标签，切换不同子页。**「泡泡」和「树洞」始终显示**，其余标签按你开启的功能动态出现： | 标签 | 内容 | 显示条件 | |------|------|---------| | **泡泡** | 你的个人空间主页，公开稿件展示 | 始终显示 | | **树洞** | 泡泡树洞公开稿件与投稿入口 | 始终显示 | | **歌单** | 你的点歌歌曲库 | 开启「歌单」入口后显示 | | **画廊** | 你的 2D3D 创作作品 | 开启「2D3D 创作」入口后显示 | | **小店** | 你的个人商品展示和售卖 | 开启小店入口后显示 | | **地址** | 粉丝收件地址提交入口 | 开启「收件地址」入口后显示 | | **大航海** | 你的大航海榜单（舰长 / 提督 / 总督） | 开启「大航海榜单」入口后显示 | | **日程** | 你的每周直播 / 活动日程表，粉丝可订阅提醒 | 开启「日程表」入口后显示 | B 站 / 抖音是头部资料区的按钮，不是顶部标签。顶部标签栏只放内容子页（泡泡、树洞、歌单等）。 ## 日程表 开启日程表后，你可以在「日程」子页发布每周直播和活动安排，时间会自动换算成访客的本地时区。 访客点击日程页的「订阅提醒」按钮即可订阅你的日程，订阅时可设置： | 选项 | 可选值 | |------|--------| | **提醒提前量** | 提前 15 / 30 / 60 分钟 | | **开播时也提醒** | 开 / 关 | 提醒会推送到访客的手机 App，避免错过你的直播。群聊粉丝群还有单独的开播卡片，不依赖这里的订阅，见 [开播通知](/docs/live-tools/go-live-notify)。 ## 大航海榜单 开启大航海榜单后，你的「大航海」子页会展示 B 站舰长、提督、总督排行榜，给高价值粉丝荣誉感。你可以在设置里选择隐藏粉丝身份，保护粉丝隐私。 ## 入口开关面板 在「控制台 → 个人空间设置 → 入口开关」里，统一管理各功能在个人空间是否显示入口。每项都有独立开关，关闭后对应标签 / 模块不再出现在个人空间： | 开关 | 控制内容 | |------|---------| | **泡泡树洞** | 个人空间的泡泡树洞入口 | | **歌单** | 歌单入口 | | **收件地址** | 收件地址提交入口 | | **2D3D 创作** | 画廊 / 2D3D 创作入口 | | **大航海榜单** | 大航海榜单入口 | | **Live2D 看板娘** | 个人空间的 Live2D 模型 | | **日程表** | 周日程表入口 | 小店入口开关**不在**这个面板里，需要到「控制台 → 小店设置」里单独控制。 ## 编辑个人空间 个人空间内容通过控制台的不同模块分别管理： | 内容 | 编辑位置 | 说明 | |------|---------|------| | 头像、昵称、用户名 | 控制台 → 账号设置 | 个人基本信息 | | 公告 | 控制台 → 个人空间设置 | 标题最多 100 字符，可附带一个外链 | | 自定义链接 | 控制台 → 个人空间设置 | 最多 50 个；名称最多 10 字符；链接须以 `http://` 或 `https://` 开头 | | 背景图 | 控制台 → 个人空间设置 | 推荐 1920x1080，最大 10MB；仅支持静态图片，横图最佳；上传后自动压缩并转换为 AVIF/WebP | | Live2D 看板娘 | 控制台 → 个人空间设置 | 管理个人空间的 Live2D 模型 | | 入口开关 | 控制台 → 个人空间设置 | 控制各功能在个人空间是否显示入口 | | 社交账号（B 站、抖音） | 控制台 → 账号设置 → 第三方账号绑定 | 绑定后自动在头部显示 | 在「个人空间设置」里编辑公告、链接、背景图时，修改会自动保存，不需要手动点保存按钮。 ## 相关功能 | 功能 | 说明 | |------|------| | [社交绑定](/docs/account/binding) | 绑定 B 站、抖音、支付宝、邮箱、手机号 | | [泡泡树洞](/docs/bubblebox) | 匿名投稿系统 | | [歌单](/docs/songlist) | 管理你的点歌歌曲库 | --- ## 歌单 URL: https://2some.ren/docs/songlist 描述: 管理可点播的歌曲库，粉丝一键点歌直达后台「点歌台」，弹幕点歌也自动入队 # 歌单 歌单是你公开给粉丝的曲库。粉丝在你的个人空间里看到你会唱的歌，点一下「点歌」就直接进你后台的待唱队列，想听的新歌还能「许愿」给你。 ## 功能概述 歌单帮你做四件事： - **管理曲库**：添加、导入、排序、置顶、导出你会唱的歌 - **方便点歌**：粉丝点「点歌」把请求直接发进你的后台队列，也能复制「点歌 歌名」弹幕或随机抽一首 - **实时接歌**：网页 / 手机点歌和直播弹幕「点歌 xxx」都汇进僚机弹幕页的「**点歌台**」，排队等你唱 - **收集许愿**：粉丝把想听但你还没列出的歌许愿给你，你在「许愿池」里集中处理 ## 访问歌单 ### 主播管理 进入控制台 → 个人空间 → **歌单管理**（页面地址 `/dashboard/songs`）。 页面顶部有两个标签： | 标签 | 用途 | |------|------| | **歌单** | 管理你公开的曲库 | | **许愿池** | 处理粉丝许愿的歌 | ### 粉丝查看 粉丝通过 `2some.ren/<你的用户名>/songs` 访问你的歌单。 歌单默认不公开。必须先在歌单管理页打开「个人空间入口」开关，分享的链接和二维码才能正常访问，否则粉丝打开会看到 404 页面。 开关位置：歌单管理页左上角的「个人空间入口」。也可以点「分享」气泡，里面会在未开启时提醒你并提供一键开启。 ## 添加歌曲 ### 单曲添加 1. 点右上角「添加」按钮 2. 填写歌曲信息： - **歌曲名**（必填） - **歌手**（必填） - 类型（可选，例如「流行」「J-POP」） - 语言（可选，例如「中文」「日语」） - 点歌门槛：大航海、礼物、SC 金额（均可选） - 直播切片 BV 号（可选） - 备注（可选） - 置顶（开关，开启后这首歌排在最前） 3. 点「添加」保存 门槛会显示在公开歌单里，方便你说明接受的大航海、礼物或 SC 点歌方式。可以同时设置多种方式；全部清空就是免费。网页和手机的「点歌」按钮不会收款或验证付款，直播间里实际收到的 SC 点歌和大航海身份点歌才会作为付费请求进入优先队列。 ### 新用户起步 第一次打开歌单管理页时，如果还没有歌曲，页面会直接引导你完成三步： 1. 从已有平台歌单或文件导入第一批歌曲 2. 检查歌名、歌手、语言、门槛和备注 3. 打开「个人空间入口」，再把歌单链接发给观众 ### 批量导入 歌曲多的话，点「导入」按钮，可以从这些来源导入： | 来源 | 填什么 | 说明 | |------|--------|------| | QQ 音乐歌单 | 歌单链接或纯数字 ID | 系统会尝试识别歌名、歌手、语言 | | 网易云歌单 | 歌单链接或纯数字 ID | 仅可导入有版权曲目 | | StarBot 歌单 | 歌单页链接、自定义域名或 B 站 UID | 会带回 SC 金额、大航海门槛和歌切 BV 号 | | Excel / CSV | `.xlsx`、`.xls` 或 `.csv` 文件 | 适合本地整理后的曲库 | Excel / CSV 的导入步骤： 1. 点「导入」按钮 2. 选择「Excel / CSV」 3. 先点「下载模板」，拿到带表头的示例文件 4. 按模板的六列填写：**歌曲名、歌手、类型、语言、SC金额、备注**（只有歌曲名和歌手必填，其余可留空） 5. 把文件拖到上传区，或点击选择文件 6. 进入**预览**：系统逐行校验，区分「有效」和「无效」行，无效行会标出原因 7. 点「下一步」进入**确认**：列出和现有歌曲重复的歌。重复项默认不更新，勾选后才覆盖文件里实际提供的字段；文件没有的门槛、礼物和歌切会保留 8. 点「确认导入」完成 单次最多导入 1000 首。重复判定看「歌名 + 歌手」的组合，所以同名不同歌手不会被误判为重复。 先确认歌单链接完整、歌单公开且里面有歌曲。QQ 音乐、网易云和 StarBot 的公开接口可能临时不可用；急用时下载模板，用 Excel / CSV 导入同一批歌曲。 ## 歌曲管理 ### 编辑歌曲 - **弹窗编辑**：点歌曲的编辑按钮，可改歌曲名、歌手、类型、语言、点歌门槛、歌切、备注和置顶；点「设为免费」可一次清空全部门槛 - **就地编辑**（桌面端）：双击表格里的单元格，直接改，回车保存、Esc 取消 ### 排序 - **置顶**：点歌曲的置顶按钮，置顶歌曲排在列表最前；再点一次取消置顶 - **拖拽排序**（桌面端）：点右上角「排序」进入拖拽模式，按住拖动调整顺序，调好后点「完成」 ### 批量操作 勾选多首歌后，顶部出现批量操作栏： - 批量置顶 / 批量取消置顶 - 批量删除 ### 删除歌曲 - 单曲删除：点歌曲的删除按钮 - 批量删除：勾选多首后点「删除」 ### 分享 点「分享」按钮或左上角的「分享」气泡，可以： - 复制歌单链接 `2some.ren/<你的用户名>/songs` - 生成二维码（挂直播间、放简介都行） - 在头像、用户名还没设好或入口没开启时，气泡会引导你先补齐，避免粉丝扫码后看到 404 ### 导出 点「导出」按钮，把全部歌曲的基础信息下载成 Excel 文件（文件名形如 `歌单_<用户名>_<日期>.xlsx`），包含歌曲名、歌手、类型、语言、SC 金额和备注。重新导入同一账号时，文件未包含的大航海、礼物和歌切配置会保留。 ## 搜索和筛选 ### 歌单管理页（主播自己） 顶部搜索框可按关键词匹配**歌名、歌手、类型、语言**，输入即时筛选。 ### 粉丝歌单页 - **标签筛选**：按「语言」「类型」标签筛选，网页和手机 App 都支持；类型标签由你歌单里填过的类型自动生成 - **关键词搜索**：粉丝端搜索框匹配**歌名、歌手、类型和语言** - 可叠加使用，点「清空筛选」一键还原 ## 重复检测 系统按「**歌名 + 歌手**」的组合判断是否重复（忽略大小写和多余空格）： - **单曲添加**：遇到重复会直接提示「已存在」并阻止添加 - **批量导入**：在确认步骤列出重复项，默认不更新；你可以勾选需要更新的歌曲。导入只覆盖来源实际提供的字段 ## 粉丝怎么点歌 粉丝在你的歌单页有这些互动方式： 1. **点「点歌」**：每首歌右侧的「点歌」按钮，点一下直接把这首歌发进你后台的「**点歌台**」排队，你在直播时实时看到——不用粉丝自己去发弹幕（电脑网页和手机 App 都支持） 2. **复制口令**：「点歌」旁边的复制按钮，把「点歌 歌名」复制到剪贴板，粉丝想自己到直播间发弹幕时用（电脑网页和手机 App 都支持） 3. **随机点歌**：点「随机」按钮，从你的曲库随机抽一首并复制好「点歌 歌名」弹幕，适合选择困难的观众（电脑网页和手机 App 都支持） 4. **许愿点歌**：把想听但你还没列出的歌许愿给你（见下文「许愿池」，目前仅电脑网页支持） 「点歌」是本场直播想现在听的歌，进你的「点歌台」队列，唱完即清；「许愿」是希望你长期学的新歌，进「许愿池」慢慢处理。两者互不干扰。 没登录的访客也能点歌（按设备和 IP 限流防刷）；登录的粉丝点歌时，你在点歌台能看到 TA 的昵称。点太频繁或队列满了会提示稍后再点。 ## 点歌台（直播实时接歌） 点歌台还在 Beta 阶段，欢迎试用并反馈。功能和交互后续可能调整。 点歌台是你在直播时接收点歌的地方，在**僚机弹幕页**（控制台 → 直播工具 → 僚机，页面地址 `/dashboard/danmuku`）里以一个面板模块出现。 老用户首次打开僚机会自动加上这个模块，新用户默认就有。没看到的话，点僚机页右上角的「选择模块」勾上「点歌台」。 ### 点歌从哪来 点歌台把三路来源汇成一个「待表演」队列： - **网页点歌**：粉丝在电脑歌单页点「点歌」 - **手机点歌**：粉丝在手机 App 歌单页点「点歌」 - **弹幕点歌**：观众在直播间发「**点歌 歌名**」或「**点播 歌名**」，自动识别入队（需要僚机正接着你的直播弹幕） 每条点歌带来源标记（网页 / 手机 / 弹幕）和点歌人昵称。普通请求按先来后到排队；直播间实际收到的 SC 点歌和大航海身份点歌会按付费档位优先。 ### 你能做什么 | 操作 | 说明 | |------|------| | **复制歌名** | 一键复制歌名，方便贴到 OBS 文稿或照着唱 | | **正在唱** | 标记当前在唱的这首，列表里高亮 | | **已唱** | 唱完标记，从待唱列表移走并计入「已唱」 | | **删除** | 误点或不想唱的直接删掉 | 面板每几秒自动刷新，粉丝点的歌很快就出现，不用手动刷新。 点歌台是**本场直播**的实时排队（唱完即清），在僚机弹幕页；许愿池是**长期**收集想让你学的新歌，在歌单管理页。一个管「现在唱什么」，一个管「以后学什么」。 ## 许愿池（许愿点歌） 许愿池是歌单页最核心的互动：粉丝把想听的歌提交进来，你在后台集中决定要不要唱、要不要加进公开歌单。 ### 粉丝怎么许愿 粉丝在**电脑网页**歌单页能看到许愿入口（手机 App 暂不支持许愿）： - 歌曲较多时，右下角有「**许愿点歌**」悬浮按钮 - 歌曲很少（不足 5 首）时，页面顶部出现「还想听更多歌？」引导卡片 - 歌单为空时，空状态里也有「许愿一首歌」按钮 点开后填写： | 字段 | 是否必填 | 说明 | |------|----------|------| | 歌曲名 | 必填 | 想听的歌名 | | 歌手 | 可选 | 帮你区分同名歌曲 | | 备注 | 可选 | 比如想听的版本、语种，或为什么想听 | | 匿名提交 | 默认开启 | 关掉后你能看到许愿人的昵称 | 弹窗里还有「**热门候选**」一键填充：系统会推荐其他主播歌单里高频出现、而你还没有的歌，粉丝点一下就填好歌名和歌手。 同一首歌被多人许愿时不会重复堆叠，而是合并成一条，并累加「许愿人数」。主播自己不能给自己的歌单许愿。 ### 主播怎么管理 切到歌单管理页的「**许愿池**」标签。每条许愿显示歌名、歌手、当前状态、许愿人数，以及每位许愿人的备注（匿名的显示「匿名观众」，实名的显示昵称）。 **筛选、排序、搜索**： - 按状态筛选：全部 / 待处理 / 待学 / 已加入 / 会唱 / 归档 / 拒绝 - 排序：最近许愿 / 许愿人数 / 最新创建 - 搜索歌曲、歌手或备注 **对每条许愿可以做的操作**（按当前状态显示）： | 操作 | 含义 | |------|------| | **加入歌单** | 直接把这首歌加进你的公开歌单（曲库里已有同名歌曲则关联，没有则自动新建一条），状态变「已加入」 | | **待学** | 标记为打算学，先放进待办 | | **会唱** | 标记为「会唱但隐藏」，自己心里有数但不公开展示 | | **归档** | 收起来不再处理 | | **拒绝** | 不打算唱 | | **重新处理** | 把已会唱 / 已归档 / 已拒绝的许愿放回待处理 | 收到新许愿时，你会收到一条站内通知，点开直接跳到许愿池。 ## 使用场景 - **直播点歌**：把歌单链接或二维码挂在直播间简介 / 挂件，粉丝扫码看歌单点「点歌」，你在僚机点歌台实时收歌、照着唱 - **弹幕接歌**：开着僚机接直播弹幕，观众发「点歌 歌名」也直接进点歌台，和网页点歌排同一队 - **OBS 上墙**：用浏览器源捕获歌单页，让观众实时看到可点曲目 - **收集需求**：开播前看一眼许愿池，挑高许愿人数的歌准备，把粉丝想听的变成你会唱的 ## 常见问题 ### 歌曲数量有限制吗？ 歌单总量没有上限。单次批量导入最多 1000 首，可以分多次导入。 ### 可以导出歌曲列表吗？ 可以。在歌单管理页点「导出」即可下载 Excel 文件，包含全部歌曲的基础信息、类型、语言、SC 金额和备注。 ### 粉丝点歌我在哪看？ 在僚机弹幕页（`/dashboard/danmuku`）的「点歌台」面板。网页点歌、手机点歌、弹幕「点歌 歌名」都汇到这里排队，每条带来源和点歌人，你可复制歌名、标记正在唱 / 已唱、删除。 ### 弹幕点歌要怎么开？ 不用单独开。只要僚机正接着你的直播弹幕，观众发「点歌 歌名」或「点播 歌名」就会自动进点歌台。识别只认开头是「点歌」「点播」的弹幕，「我想点歌呀」这类闲聊不会误入。 ### 点歌台和许愿池有什么不一样？ 点歌台是本场直播的实时排队，唱完即清，在僚机弹幕页；许愿池是长期收集想让你学的新歌，在歌单管理页。一个管现在唱什么，一个管以后学什么。 ### 粉丝可以直接把歌加进我的歌单吗？ 不能。粉丝只能「点歌」（进点歌台排队）或「许愿」（进许愿池）。是否加进公开曲库由你在许愿池点「加入歌单」决定。 ### 为什么粉丝打开我的歌单是 404？ 多半是「个人空间入口」开关没开。到歌单管理页打开它，或在「分享」气泡里一键开启即可。 --- ## 百科 Wiki 与命令行工具 URL: https://2some.ren/docs/wiki 描述: 使用 2s1 查询、编辑和治理 2SOMEone Wiki # 百科 Wiki 与命令行工具 2SOMEone Wiki 用来沉淀主播、团体和社区相关的公开资料。你可以直接浏览公开内容，也可以通过官方命令行工具 `2s1` 查询、编辑、认领和管理自己有权限的 Wiki。 ## 安装并查看能力 ```bash npm install -g @2someone/cli@latest # 查看当前版本支持的命令、权限和安全边界 2s1 --json wiki context ``` 公开读取不要求登录： ```bash 2s1 wiki list --query "名称" --subject person 2s1 wiki show 2s1 wiki ai-context 2s1 wiki revisions 2s1 wiki revision show ``` `ai-context` 返回适合交给 AI 编程助手使用的安全上下文。所有命令都支持全局 `--json`，方便脚本读取稳定的结构化结果。 ## 登录并管理 Wiki 写入操作使用你自己的账号密钥，不支持机器人运行密钥： ```bash 2s1 login 2s1 whoami 2s1 wiki mine ``` Level 1 及以上用户可以创建符合平台规则的 Wiki。有权限的用户可以修改标题、摘要和段落： ```bash 2s1 wiki create --subject person --ownership platform_user --title "名称" 2s1 wiki update --title "新标题" --summary "简介" 2s1 wiki section upsert \ --kind backstory --markdown "正文" --edit-summary "补充经历" ``` `section upsert` 的正文可以使用 `--markdown`，也可以通过 `--body-file` 传入 infobox 或 timeline 的 JSON；两者不能同时使用。 ## 使用 AI 生成草稿 AI 草稿只返回建议内容，不会自动覆盖 Wiki： ```bash # 为整篇 Wiki 生成草稿 2s1 --json wiki draft --instruction "整理结构并精简措辞" # 为指定段落生成草稿，并补充本地资料 2s1 --json wiki draft \ --kind backstory --material-file ./notes.md ``` ## 认领 Wiki 符合条件的个人或团体 Wiki 可以由权利人认领。提交者需要先在 2SOMEone 绑定对应的抖音或 B 站账号： ```bash 2s1 wiki claim --note "补充账号归属说明" 2s1 --json wiki claim-status ``` 认领审核由平台系统管理员处理，CLI 不提供批准或拒绝认领的命令。 ## 权利人治理 Wiki 所有者、共同所有者和编辑者可以按各自权限管理修订与段落： ```bash 2s1 wiki approve --yes 2s1 wiki protect --mode open --yes 2s1 wiki review-mode --mode pending --yes 2s1 wiki revert --yes 2s1 wiki role list 2s1 wiki role grant --kind wiki_editor --username <用户名> --yes 2s1 wiki role revoke --yes ``` Club Owner 或 Admin 只能管理当前归属于该 Club 的 Wiki。平台系统管理员是独立的全局角色，不能从 Club 身份推导。修订隐藏、Wiki 删除、段落删除和认领审核等平台管理操作不在 CLI 中开放。 会改变真实内容或权限的治理命令要求显式传入 `--yes`。执行前建议先运行 `2s1 wiki show `，根据返回的 `capabilities` 判断当前账号可以执行哪些操作。 --- ## 社交绑定 URL: https://2some.ren/docs/account/binding 描述: 绑定 B 站、抖音、Apple 等账号，并管理 Passkey # 社交绑定 绑定第三方账号可以验证你的身份，解锁更多功能，也能多一种登录方式。建议至少绑定 2 项以提高账号安全性。 ## 支持的平台 | 平台 | 验证方式 | 用途 | |------|---------|------| | B 站 | 发送弹幕验证码 | 身份验证、弹幕同步、头像同步、数据统计、[开播通知](/docs/live-tools/go-live-notify) | | Apple | 授权登录 | 用 Apple ID（Sign in with Apple）登录此账号 | | 抖音 | 授权登录 | 身份验证、数据同步、主页展示 | | 支付宝 | 账号绑定 | 收款结算 | | 邮箱 | 邮箱验证码 | 登录、安全访问、找回账号 | | 手机号 | 短信验证码 | 登录、安全访问、找回账号 | 此外，账号设置中还可以管理 **Passkey（通行密钥）**，用于免密登录，详见下方「Passkey」一节。 ## 绑定 B 站 ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「B 站账号」卡片 3. 输入你的 B 站 UID 4. 系统生成验证码 5. **先关注「海鱼Harry」的 B 站账号**（否则弹幕可能无法被识别） 6. 复制验证码，前往 [海鱼Harry的直播间](https://live.bilibili.com/12834880) 发送弹幕 7. 系统自动验证并完成绑定 ### 查找 B 站 UID 1. 登录 B 站网页版 2. 点击头像进入个人空间 3. 地址栏中 `space.bilibili.com/` 后面的数字就是你的 UID 验证码弹幕需要在绑定页面显示的时间内发送，过期需要重新获取。绑定后可在 B 站设置中一键刷新资料，同步最新头像、粉丝数等。 ## 绑定 Apple ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「Apple 账号」卡片 3. 跳转 Apple 授权页面，确认授权 4. 自动返回并完成绑定 绑定后，即可用 Sign in with Apple 登录此账号。 绑定 Apple 不会更改你的邮箱等现有信息，只是多一种登录方式。 ## 绑定抖音 ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「抖音账号」卡片 3. 跳转到抖音授权页面 4. 确认授权 5. 自动返回并完成绑定 绑定后，可以额外设置抖音主页地址和抖音号，将在个人空间展示跳转按钮，方便粉丝跳转到你的抖音。 ## 绑定支付宝 ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「支付宝」卡片 3. 输入**支付宝账号**和**真实姓名（收款人）** 支付宝账号和真实姓名用于收款结算，二者需与支付宝实名认证一致，否则结算可能失败。 ## 绑定邮箱 ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「邮箱」旁的编辑按钮 3. 输入邮箱地址 4. 获取邮箱验证码 5. 输入验证码完成绑定 已绑定邮箱后，可以直接「换绑邮箱」更换为新邮箱，无需先解绑。 ## 绑定手机号 ### 绑定流程 1. 进入「控制台」→「账号设置」 2. 点击「手机号」旁的编辑按钮 3. 输入手机号码 4. 获取短信验证码 5. 输入验证码完成绑定 已绑定手机号后，可以直接「换绑手机号」更换为新手机号，无需先解绑。 手机号信息仅用于账号安全验证，不会对外展示。 ## Passkey（通行密钥） Passkey 是免密、抗钓鱼的快捷登录方式，使用设备的指纹、面容或安全密钥验证身份。 ### 添加与管理 1. 进入「控制台」→「账号设置」 2. 找到「Passkey」一项，点击「添加 Passkey」 3. 按设备提示用指纹 / 面容 / 安全密钥完成注册 添加后，即可在登录页面点击「Passkey」按钮免密登录。同一处也可以删除不再使用的 Passkey。 添加 Passkey 需要设备支持（指纹、面容或硬件安全密钥）。删除某个 Passkey 后，将无法再用该设备进行 Passkey 登录。 ## 绑定的作用 ### 满足投稿权限 部分泡泡树洞文件夹设置了 Level 2 权限，需要绑定任意一项才能投稿。 详见 [权限系统](/docs/bubblebox/permissions)。 ### 身份展示 绑定后，你的 B 站、抖音信息可以在个人空间展示，方便粉丝找到你。 ### 弹幕同步 绑定 B 站后，可以使用直播弹幕同步功能。 在泡泡树洞展示稿件时，普通弹幕和醒目留言默认会先暂存；稿件转发到泡泡后，它们会自动进入该 Bubble 的讨论。可在收稿后台右上角「设置」中关闭「转发时同步直播弹幕」。 ### 收款结算 绑定支付宝后，可以用于平台内的收款结算。 ## 解除绑定 1. 进入「控制台」→「账号设置」 2. 点击对应平台的设置入口 3. 选择解除绑定 为确保账号至少保留一种登录方式，部分解绑有前置要求： - 解除**抖音**绑定需要先设置密码 - 解除**邮箱**绑定前需先设置密码或绑定手机号 - 解除**手机号**绑定前需先设置密码或绑定邮箱 解除绑定后，依赖该绑定的功能将无法使用，且需要重新验证才能再次绑定。 ## 常见问题 ### B 站弹幕验证失败？ 可能的原因： 1. 未关注「海鱼Harry」的 B 站账号（请先关注再发弹幕） 2. UID 输入错误 3. 验证码已过期 4. 弹幕发送的直播间不在监听范围（请前往 [海鱼Harry的直播间](https://live.bilibili.com/12834880) 发送） 5. 网络延迟，稍等片刻重试 ### 可以绑定多个平台吗？ 可以。B 站、Apple、抖音、支付宝、邮箱、手机号可以同时绑定，互不影响。建议至少绑定 2 项以提高账号安全性。 ### 绑定后可以更换账号吗？ 可以。邮箱、手机号可以直接「换绑」更换新账号，无需先解绑。其他平台先解除当前绑定，再绑定新账号即可（注意抖音解绑需要先设置密码）。 --- ## 登录与注册 URL: https://2some.ren/docs/account/login-register 描述: 了解 2SOMEone 平台的登录注册方式和注意事项 # 登录与注册 本文档介绍如何在 2SOMEone 平台上登录和注册账号。 ## 注册账号 ### 注册方式 目前支持以下注册方式： #### 邮箱注册（仅非大陆 IP） 非中国大陆 IP 用户可以使用邮箱注册： 1. 在登录页面输入你的邮箱地址 2. 点击「继续注册」，系统将发送验证码到你的邮箱 3. 输入 6 位数字验证码（可点「重新发送」） 4. 可选填写邀请码 5. （可选）展开「完善资料」，设置密码 6. 勾选用户协议后点击「免费注册」完成注册 中国大陆地区暂不提供邮箱注册，请使用手机号注册。 #### 手机号注册 国内用户也可以使用手机号注册： 1. 在登录页面输入你的手机号 2. 点击「继续注册」，系统将发送验证码到你的手机 3. 输入 6 位数字验证码（可点「重新发送」） 4. 可选填写邀请码 5. （可选）展开「完善资料」，设置密码 6. 勾选用户协议后点击「免费注册」完成注册 手机号注册仅支持中国大陆手机号 (+86)，海外手机号暂不支持直接注册。 注册表单默认只需验证码；用户名由系统自动生成（如 `user_abc12345`），注册后可在设置中修改。展开「完善资料」可额外设置密码： - **用户名**：自动生成，注册后可在设置中修改 - **昵称**：默认与用户名相同，可在设置中修改 - **密码**：不设置则只能用验证码登录，之后可在设置中补设 #### 抖音授权注册 你也可以使用抖音账号快速注册： 1. 在登录页面点击「抖音」 2. 在抖音授权页面完成授权 3. 授权成功后，补充填写用户名、昵称和密码 4. （可选）填写手机号并获取短信验证码绑定，绑定后即可用手机号登录 5. 点击「保存信息」完成注册 B 站 UID 目前仅支持登录已有账号，不支持直接注册。如需注册，请使用邮箱或手机号。 ### 注册信息要求 | 字段 | 是否必填 | 要求 | 说明 | |------|---------|------|------| | 用户名 | 自动生成 | 4-16 位，允许英文字母、数字、下划线，不能是纯数字，且不能以 `_bot` 结尾（该后缀为机器人账号保留） | 全局唯一，用于登录和个人空间 URL；注册后可修改 | | 昵称 | 自动 | 展示给其他用户看的名称 | 默认与用户名相同，可在设置中修改 | | 密码 | 可选 | 8 位以上，需包含英文字母和数字 | 不设置则只能用验证码登录；在「完善资料」中填写 | | 邀请码 | 可选 | 如有邀请码可填写 | 填写后双方可得奖励 | ### 新用户福利 - 新注册用户享有 **7 天免费试用期**，试用期内使用平台功能不扣除余额 - 同时获得 **¥1 注册赠送余额**（90 天有效），试用期结束后可用于功能消费 - 试用期内可正常完成[任务中心](/docs/checkin)任务（如每日签到），领取的余额会累积，试用期结束后使用 - 完成任务中心的各类任务，最高还可额外领取约 **¥52** 奖励，详见[任务中心](/docs/checkin) - 使用邀请码注册，双方各得 ¥0.5 奖励金；被邀请人绑定 B 站可获得更多阶梯奖励，详见[任务中心](/docs/checkin) --- ## 登录账号 ### 支持的登录凭证 你可以使用以下任意一种凭证登录： - **邮箱** - 注册时使用的邮箱地址 - **手机号** - 注册时使用或绑定的手机号码 - **用户名** - 注册时设置的用户名（仅支持密码登录） - **B 站 UID** - 绑定的 B 站用户 ID（仅支持弹幕验证码登录，且该 UID 需已在某账号上绑定过，否则提示「该 UID 未被绑定」） ### 验证方式 根据你的账号设置，可能支持以下验证方式： #### 密码登录 输入账号对应的密码即可登录。 #### 手机验证码登录 系统会发送 6 位数字验证码到你的手机，输入后即可登录。 #### 邮箱验证码登录 系统会发送 6 位数字验证码到你的邮箱，输入后即可登录。 #### B 站弹幕验证码登录 1. 系统生成验证码 2. **先关注「海鱼Harry」的 B 站账号**（否则弹幕可能无法被识别） 3. 复制验证码并发送到 [海鱼Harry的直播间](https://live.bilibili.com/12834880) 4. 系统确认后自动完成登录 如果你的账号支持多种验证方式，登录时可以在页面上切换选择。 ### 扫码登录 在电脑端，**登录页面**与**登录弹窗**均为左扫码、右表单的双栏布局： 1. 在电脑端打开登录页面，或触发需要登录的操作打开登录弹窗 2. 用 2SOMEone 手机 App 扫描左侧二维码 3. 在手机端确认后，电脑端自动完成登录 二维码约 90 秒后自动刷新，过期可点「刷新二维码」重新获取。手机确认即可完成登录，无需比对验证码。请勿截图分享二维码。窄屏设备上扫码列会隐藏，请使用表单或第三方方式登录。 ### 第三方登录 登录页面底部提供 Passkey、Apple、抖音、B 站 UID 四种快捷登录方式。 #### Passkey 登录 Passkey（通行密钥）是免密、抗钓鱼的快捷登录方式，使用设备的指纹、面容或安全密钥验证身份。 1. 先在[账号设置](/docs/account/binding)中添加 Passkey 2. 在登录页面点击「Passkey」 3. 用设备的指纹 / 面容 / 安全密钥完成验证即可登录 Passkey 登录需要先在账号设置里添加过 Passkey，且设备需支持 WebAuthn（指纹、面容或硬件安全密钥）。 #### Apple 登录（Sign in with Apple） 1. 在登录页面点击「Apple」 2. 跳转 Apple 授权页面完成授权 3. 授权后即可登录 如果你尚未用 Apple 登录过，将会创建新账号。若想用 Apple 登录已有账号，请先在账号设置中绑定 Apple，详见[社交绑定](/docs/account/binding)。 #### 抖音登录 点击「抖音」，完成抖音授权后即可登录。 使用抖音登录需要你的 2SOMEone 账号已绑定抖音。如果是首次使用抖音登录，将会创建新账号。 ### 多账号登录与切换 你可以同时登录多个账号：在已登录状态下进入登录页面添加新账号即可。退出时可选择只退出当前账号（自动切换到其他已登录账号）或退出全部账号，详见下方「退出登录」。 --- ## 退出登录 如需退出账号： 1. 访问 `/signout` 页面 2. 点击「退出登录」按钮确认（也可以按 `Enter` 键快速确认） 退出时支持两种方式： | 方式 | 行为 | |------|------| | 退出全部账号（默认） | 退出所有已登录账号，清除本地登录状态和缓存数据 | | 退出当前账号 | 仅退出当前账号，自动切换到其他已登录账号 | --- ## 常见问题 ### 收不到短信验证码？ 近期运营商维护，短信发送成功率较低。建议： - **中国大陆新用户**：请使用手机号注册 - **非大陆新用户**：请使用邮箱注册 - **老用户**：请使用手机号 + 密码登录 如需帮助，请发邮件至：**support@leaper.one** ### 为什么没有 B 站第三方登录？ B 站官方第三方登录要求授权不合理的数据权限，出于用户隐私保护考虑，我们选择不接入。 已有账号的用户可以通过以下方式登录： - 在登录页面输入 B 站 UID - 关注「海鱼Harry」后，通过发送弹幕验证码完成登录 ### 忘记密码怎么办？ 你可以使用以下方式登录： - 手机验证码登录 - 邮箱验证码登录 - B 站弹幕验证码登录 - Passkey 登录（如已添加） 登录后可在设置中重置密码。 ### 海外用户如何注册登录？ 海外用户推荐使用邮箱注册和邮箱验证码登录，避免短信接收问题。也可以使用 Passkey 或 Apple 登录。 --- ## 接口参考 URL: https://2some.ren/docs/bots/api 描述: 机器人开放接口：鉴权方式、能力端点与调用规则 机器人程序通过 HTTPS 调用平台开放接口。所有请求都发往 `https://2some.ren`，鉴权统一用请求头携带运行密钥： ``` x-api-key: sk_xxxxxxxx ``` ## 验证身份 启动时建议先做一次身份校验，确认密钥有效且确实是机器人密钥： ```bash curl https://2some.ren/api/v1/bots/me \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` 返回的 `user.accountType` 应为 `"bot"`，`user.id` 即机器人的 `botUserId`。 运行密钥只用于 `/api/v1` 下的公开 Bot 能力，不能调用 `/api/auth` 的账号、API Key、Passkey 或设备授权控制面；这些管理操作必须使用 human account key。 ## 能力与安装授权 能力先在 Bot 资料中声明，再由每次群聊安装显式授予；运行密钥 scopes 与当前 Bot capability、安装 grant 的交集才是最终权限。当前群聊能力如下： | Capability | 作用 | 是否附带其他能力 | |------|------|------| | `chat.send` | 发送、编辑或撤回机器人自己的消息；Thread 回复还需 `chat.read` | 不附带 `chat.read` 或 `chat.react` | | `chat.read` | 按安装隐私模式读取群聊与 Thread | 不附带发送或 reaction | | `chat.react` | 为机器人自己发送且当前安装仍可见的消息添加/取消自己的 reaction | 不附带发送或读取 | 权限不足、安装失效或消息超出隐私范围时，服务端仍是最终裁决者；不要把 Bot roster 的 `ConversationMember` 角色当作安装授权，也不要把 `chat.react` 当成可操作任意可见消息的权限。 ## 发布泡泡 需要 `bubble.create` 能力。 ```bash curl -X POST https://2some.ren/api/v1/bubbles \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"content": "你好，泡泡！详情 → https://example.com/article"}' ``` | 字段 | 必填 | 说明 | |------|------|------| | `content` | 是* | 纯文本内容，**不超过 500 个可见字符**；不能与 `richContent` 同时提交 | | `richContent` | 是* | 富文本字符串，可用 `` 内联已审核且可用的贴纸；原始字符串最长 2048 字符、可见内容最长 500 个字符、最多 9 张贴纸；不能与 `content` 同时提交 | | `visibility` | 否 | `public`（默认）/ `followers` / `unlisted` | | `attachmentIds` | 否 | 图片附件 id 数组，最多 9 张（附件必须由当前身份上传并已完成上传） | | `aiImageIds` | 否 | 当前身份拥有、审核通过、图片已就绪且当前身份有权分享的 AI 作品 id；服务端会复制为 Bubble 图片附件，和 `attachmentIds` 合计最多 9 张 | | `replyToBubbleId` | 否 | 回复某条泡泡（可见性会继承被回复的泡泡） | | `quoteBubbleId` | 否 | 引用某条泡泡 | | `quoteArticleId` | 否 | 引用某篇文章 | > *`content` 与 `richContent` 二选一（也可以都省略）；文本/富文本、`attachmentIds`、`aiImageIds`、`quoteBubbleId` 或 `quoteArticleId` 至少要有一个。`richContent` 可以只含合法贴纸；`replyToBubbleId` 只指定回复关系，不能单独作为内容。`quoteBubbleId` 和 `quoteArticleId` 不能同时提交。公开接口不接受 `quoteLetterId`；转发树洞稿件只能在稿件详情中操作。 `attachmentIds` 是接口支持的字段，但它要求先把图片上传拿到附件 id，而**上传接口 `/api/v1/media/upload-url` 目前只对真人会话开放，不接受机器人运行密钥**。`aiImageIds` 不需要再次上传，但只能使用当前身份拥有、审核通过且已就绪、并且仍有分享权限的 AI 作品；`richContent` 中的贴纸也必须是当前身份可用且已审核的贴纸。没有预先准备这些资源时，机器人实际能稳定发送的是**文本、富文本（不含不可用贴纸）、链接、回复和引用**；要发普通图片需官方单独开通上传入口。回复和引用对机器人是可用的，适合做「自动回复某话题」「转发引用外部内容并加点评」。 成功返回 `{ "success": true, "id": "" }`，泡泡地址为 `https://2some.ren/bubble/`。 - 内容会经过平台审核，违规内容发布失败 - `#词语` 会成为话题标签；`@用户名` 会**真实通知**对应用户——转发外部内容时建议把 `@` 替换为全角 `＠`，避免误打扰 - 机器人发布的 **public 原创泡泡会进入关注它的人的关注流**（并可能触发粉丝推送）。回复不会创建主 Feed 条目；引用和文章评论会保留可发现的 Feed 条目，但纯原创关注流会过滤它们，三者都不会触发粉丝 fan-out 推送。机器人高频发 public 原创泡泡会打扰粉丝，请控制节奏 - 写操作有频率限制，收到 `429` 时请退避重试 ## 读取自己的泡泡 需要 `bubble.read` 能力。机器人**只能读自己发布的**内容，常用于「判断哪些内容已经发过」的去重场景。 ```bash curl "https://2some.ren/api/v1/bubbles?authorId=&limit=50" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` | 参数 | 说明 | |------|------| | `authorId` | 必填，机器人自己的 `botUserId` | | `limit` | 每页条数，最大 50 | | `cursor` | 翻页游标，取上一页返回的 `nextCursor` | 返回 `{ "success": true, "items": [...], "nextCursor": "<游标>" }`；`nextCursor` 为 `null` 时表示没有更多数据。 ## 发现已安装的群聊 机器人运行密钥无需 `chat.read` 能力也可以查询自身当前可用的安装，用返回的 `conversationId` 调用群聊接口： ```bash curl "https://2some.ren/api/v1/bots/me/installations" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` 返回 `{ "success": true, "items": [...] }`，每项只包含以下低敏字段： | 字段 | 说明 | |------|------| | `installationId` | 该次安装的 id | | `conversationId` | 已安装群聊的 id | | `privacyMode` | `mention_only` / `commands_only` / `read_all` | | `updatedAt` | 安装最后更新时间（UTC ISO 8601） | 接口只返回机器人自己的 active 安装，并排除已归档群聊和成员关系已不存在的记录；不会返回群名、群成员、安装者或 disabled 安装。该端点仅接受机器人运行密钥，账号登录态和账号 API Key 均不可调用。 ## 向群聊发消息 需要 `chat.send` 能力，且机器人已被[安装到该群聊](/docs/bots/create#安装到群聊)。 ```bash curl -X POST "https://2some.ren/api/v1/chat/conversations//messages" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "今晚 8 点开播，记得来！"}' ``` `text` 始终按纯文本处理，也是默认和最兼容的写法。要显式发送受限 Markdown，请改传公开 input block；REST **没有**顶层 `parseMode` 字段（Bot SDK 的 `parseMode` 只是转换该 block 的 convenience）： ```bash curl -X POST "https://2some.ren/api/v1/chat/conversations//messages" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"blocks":[{"type":"rich_text_v1","source":"**重点**：见 [说明](https://example.com)"}]}' ``` 群聊消息不止能发纯文本，下面这些字段都可以带： | 字段 | 必填 | 说明 | |------|------|------| | `text` | 否* | 默认的纯文本内容，最长 8000 字，不解析 Markdown 或 HTML | | `attachmentIds` | 否 | 图片、视频或文件附件 id 数组，最多 9 个（需先上传，见下方提醒） | | `aiImageIds` | 否 | 当前身份拥有、审核通过、图片已就绪且当前身份有权分享的 AI 作品 id；服务端会复制为聊天图片附件，和 `attachmentIds` 合计最多 9 个 | | `voiceNoteId` | 否 | 语音消息 id（不能和 `attachmentIds` 或 `aiImageIds` 同时发） | | `parentMessageId` | 否 | 引用回复某条消息；Bot 同时需要 `chat.read`，避免用发送权限读取引用上下文 | | `threadRootId` | 否 | 回复某条 Thread 根消息的 id；Bot 同时需要 `chat.read`，且 root 必须满足安装隐私模式 | | `clientMessageId` | 否 | 客户端生成的 UUID；同一会话内重试同一条消息时必须复用，省略后不同请求之间不会去重 | | `blocks` | 否 | 结构化消息块：`text`、`mention`、`mention_all`、`rich_text_v1` 或 `sticker`；贴纸必须单独成条 | | `linkCard` | 否 | 仅用于正文、`text` block 中第一个可识别链接，或 `rich_text_v1` 中第一个安全 link node：`url` 必须与服务端规范化后的链接完全一致。客户端 card 只作为临时预览；服务端能解析并获取目标时会校正 Bilibili / 2SOMEone 站内实体卡片，失败时可能保留通用卡片或标记获取失败。不能单独作为消息内容 | | `asLiveTalk` | 否 | 请求将消息标记为当前活跃直播会话的消息；没有活跃会话时不生效，Bot runtime 不允许传 `true` | > *`text`、非空 `rich_text_v1`、`attachmentIds`、`aiImageIds`、`voiceNoteId` 或贴纸 block 至少要有一个；目前仅有 `text` block 不能单独通过 API 发送。`parentMessageId`、`threadRootId` 和 `linkCard` 不能单独作为内容。`voiceNoteId` 不能和任何 `attachmentIds` / `aiImageIds` 同发；两类图片/文件 id 合计最多 9 个。@提及、@所有人、贴纸通过 `blocks` 字段发送，其中 @所有人只有群主或管理员能用，贴纸必须单独成条。 如果同时传顶层 `text` 和 `blocks`，消息正文以 `blocks` 为准，顶层 `text` 不会再作为 fallback 写入；顶层 `text` 仍会经过 8000 字符的请求校验。要发送带格式的正文，只传 `rich_text_v1` block 最清楚。 ### 受限 Markdown 与兼容读取 公开写入形态严格限定为 `{ "type": "rich_text_v1", "source": string }`。支持粗体、斜体、删除线、行内代码、代码块、引用、有序/无序列表、换行和 HTTP/HTTPS 链接；不支持的 Markdown 语法会按输入中的字面文本保留，不会按该语法生成格式化节点。`javascript:`、`data:` 和自定义 scheme 不会成为链接，也会按字面文本保留。`@用户名` 不会从 Markdown 推断为通知对象，需要通知时仍应使用顶层 `mention` / `mention_all` block。 任意 HTML、CSS、JavaScript、DOM、iframe 或 WebView 正文都不受支持，也不会执行。服务端会从 `source` 生成 `{ plainText, nodes }` 和消息的纯文本 `text`；`plainText`、`nodes` 和 `text` 都是派生结果，客户端不得提交，也不要把顶层 `text` 当作 fallback（若同传，按上面的 `blocks` 优先规则处理）。带 `plainText`、`nodes` 或其他额外字段的 `rich_text_v1` input block 会被拒绝。 读取时，`x-chat-message-blocks` 是读取方声明的完整 capability 集合。当前已知类型为 `text`、`mention`、`mention_all`、`sticker`、`custom_emoji`、`rich_text_v1` 和 `unsupported`；只声明 `rich_text_v1` 不等于声明其它类型，未声明的 block 会按 legacy/unsupported 规则处理。只有显式声明 `rich_text_v1` 的消费者会获得完整 `{ type, source, plainText, nodes }` block，例如： ```bash curl "https://2some.ren/api/v1/chat/conversations//messages" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "x-chat-message-blocks: text,mention,mention_all,sticker,custom_emoji,rich_text_v1,unsupported" ``` 未带 capability（包括 Bot SDK 默认读取）的 legacy 消费者会按顶层顺序把每个富文本 block 降级为真实 `{ type: "text", content: plainText }`，相邻 Mention 仍保留；链接 fallback 会保留可访问 URL。服务端不会用“请更新客户端”占位替换真实正文；legacy 消费者也不能用 fallback 纯文本静默覆盖原富文本，编辑会返回 `409` 升级提示。 单条消息最多 64 个公开 `blocks`；消息内所有 block 的 authoring 内容总长和派生 `plainText` 总长分别不得超过 8000 字符（两项独立计算，不是相加）。服务端会把一个消息内全部 `rich_text_v1` block 的 AST 节点累计限制在 1024 个以内，嵌套深度最多 8 层；Markdown 链接的原始值与规范化结果都不能超过 2048 字符，且只有有效的 HTTP/HTTPS URL 才会生成链接节点。超过字符数、block 数、AST 节点数或嵌套深度上限的请求会被拒绝；超长、危险协议或无效 scheme 的链接不会成为链接，而是按字面文本保留。不会执行 HTML、CSS、JavaScript、iframe 或 WebView。 `attachmentIds` / `voiceNoteId` 需要先上传媒体拿到 id，而上传接口暂不对机器人运行密钥开放；`aiImageIds` 不需要再次上传，但只能使用当前 Bot 自己拥有、审核通过且已就绪、并且仍有分享权限的 AI 作品。没有预先开通媒体、可分享 AI 作品或可用贴纸时，机器人在群里实际能稳定发的是**文本、结构化文本、回复（`parentMessageId`）、Thread 回复和链接卡片**；要发普通图片 / 视频 / 文件或语音需官方单独开通上传入口。接口仍支持 `aiImageIds`、贴纸和其他结构化 block，能否使用取决于资源状态与权限。 ## 读取群聊与 Thread 需要 `chat.read` 能力，且机器人已安装到目标会话。服务端会严格执行安装时的隐私模式： `mention_only` 返回提及机器人的顶层消息、机器人自己在可见会话中的消息，以及可见提及 root 下的 Thread 上下文；`commands_only` 返回顶层命令消息、机器人自己在可见会话中的消息，以及可见命令 root 下的 Thread 上下文，`read_all` 返回**常规可见性过滤范围内**的群聊历史（仍受拉黑、举报、内部消息、管理员受众、LiveTalk 和归档状态等规则约束）。机器人自己发在已隐藏 Thread root 下的回复也不会绕过 root 隐私边界。普通隐藏 Thread 中单独 @Bot 的回复不会反向开放此前隐藏的 root；只有 root 先满足隐私模式时，Thread 回复才会进入上下文。Bot runtime 目前只支持已安装且未归档的 Group，不适用于私信、Channel 或客服会话。 ```bash curl "https://2some.ren/api/v1/chat/conversations//messages?after=100&limit=50&order=asc" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" curl "https://2some.ren/api/v1/chat/conversations//messages//thread?after=100&order=asc" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` 两条接口都支持正整数 `before` / `after` 游标；`limit` 最终限制为 1～200。非法游标会返回 `400`，不会静默回到默认页。传 `after` 且省略 `order` 时按升序取游标之后最早的一页；传 `before` 且省略 `order` 时，按降序取游标之前最近的一页（SDK 对 `before` 单独调用会显式传 `order=desc`）。显式 `order` 只决定从哪一端取这一页窗口，不改变响应排列：服务端返回的 `items` 始终按消息 id/时间升序排列。未传游标时，顶层消息接口返回最新窗口，Thread 接口返回按时间正序的回复。两条接口当前都返回 `{ "success": true, "items": [...] }`，不会返回 `nextCursor`；客户端应把本页最大消息 `id` 保存为下一次 `after`，直到返回空页。`before` 与 `after` 不建议同时传；需要组合条件时请显式指定 `order`。Thread 回复可用 `threadRootId` 继续发送，但同时要求 `chat.send` 与 `chat.read`；root 必须是同一会话中可见、未撤回的顶层消息，不能是 LiveTalk 消息。机器人只能编辑、撤回和 reaction 自己发送的消息：编辑 / 撤回使用 `chat.send`，reaction 使用独立的 `chat.react`；写接口只返回自身消息的最小 receipt，完整消息及引用上下文仍需 `chat.read` 后调用读取接口。 Bot 的消息响应会把 `threadReplyCount` 固定为 `0`、`threadLastReplyAt` 固定为 `null`。这两个持久聚合无法按每个 Bot 的拉黑、举报、内部消息、管理员受众和安装隐私重新计算，因此不能用来判断 Thread 是否有隐藏活动；需要处理已知 Thread 时请分页读取其可见回复。 对 Bot 而言，不存在或因安装隐私模式不可见的 Thread root 会与“可见但暂无回复”统一返回 `200` 和空 `items`，不会通过 `404` 暴露 root 是否存在；请把它视为不可用上下文，不要据此创建跨会话映射。 列表的 `items` 可能包含已撤回消息的 tombstone（例如历史页或 Bot 自己的消息）。这类项仍保留 `id`、发送者和时间等元数据，并以 `deletedAt`（以及可选的 `deletedReason`）标记撤回；`text` 为 `null`，`blocks`、`attachments`、`linkCards`、`reactions` 为空。不要把 `text === null` 当成网络缺失，请以 `deletedAt` 判断消息状态。 ### 单条消息与自己的消息操作 读取单条消息（需要 `chat.read`）： ```bash curl "https://2some.ren/api/v1/chat/messages/" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` 消息必须位于机器人已安装并获隐私模式允许的会话中；不存在或被隐私模式过滤的消息按 `404` 处理。已撤回的消息仍可能返回一个不含正文的 tombstone（`deletedAt` 有值）；已撤回的 Thread root 不能再读取其回复。编辑和撤回需要 `chat.send`；reaction 使用独立的 `chat.react`。这些写操作都只能操作机器人自己发送的消息： ```bash # 编辑（发送后 15 分钟内） curl -X PATCH "https://2some.ren/api/v1/chat/messages/" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" -H "Content-Type: application/json" \ -d '{"text":"更新后的内容"}' # 编辑为受限 Markdown（同样只提交 source） curl -X PATCH "https://2some.ren/api/v1/chat/messages/" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" -H "Content-Type: application/json" \ -d '{"blocks":[{"type":"rich_text_v1","source":"**更新后的内容**"}]}' # 撤回（发送后 2 分钟内） curl -X DELETE "https://2some.ren/api/v1/chat/messages/" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" # 添加 / 取消自己的 reaction（需要独立的 chat.react；不会授予 chat.send 或 chat.read） curl -X POST "https://2some.ren/api/v1/chat/messages//reactions" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" -H "Content-Type: application/json" \ -d '{"emojiCode":"👍"}' curl -X DELETE "https://2some.ren/api/v1/chat/messages//reactions?emojiCode=👍" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" ``` 编辑 / 撤回成功返回 `{ "success": true, "message": { "id", "conversationId", "clientMessageId", "createdAt", "editedAt", "deletedAt" } }` 的最小 receipt；reaction 成功只返回 `{ "success": true }`。`chat.react` 是独立 capability，不隐式授予 `chat.send` 或 `chat.read`；Bot 只能对自己发送的消息添加或取消自己的 reaction，不能操作其他发送者的消息。`after` 游标只覆盖新建消息，不能补回离线期间发生的编辑、撤回或 reaction 变更。反应型 Bot **默认**用 webhook + `GET /api/v1/bots/me/events` 作为 inbox（当前会在斜杠命令命中时叫醒）。需要监控会话里更多可见消息时，**继续用** `GET .../messages` / SDK `iterateChatMessagePages`（`chat.read`）；拉消息限额按主人当前 VIP，见下方 429。 ## 事件 inbox 与 Webhook 叫醒 操作步骤、验签与限额见 [Webhook 与轮询](/docs/bots/inbound)。下面是接口契约。 反应型机器人被斜杠命令点到时，平台会把一条 `interaction.created` 写入事件表，并在主人已登记 **active** HTTPS 回调时签名 POST 过去。Webhook 丢失后，用 runtime key 拉同一条事件： ```bash curl "https://2some.ren/api/v1/bots/me/events?limit=100" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "x-2someone-bot-runtime: 1" ``` 新轮换的 runtime key 自动带 `events.read`；这不是群安装授权。`wait` 非 0 会返回 400（当前 Route 不做 long poll）。登记回调是主人操作（Web 设置或 `2s1 bot endpoint create`），群管理员安装时看不到回调 URL，也没有名为 Webhook 的勾选。验证请求是签名 POST `{ type: "endpoint.verify", challenge }`，对端须 2xx 且回显同一个 `challenge`。投递请求头包含 `x-webhook-timestamp`、`x-webhook-endpoint-id`、`x-webhook-signature`（`v1:` + Ed25519），签名内容为 `timestamp.endpointId.body`。 ```bash # 主人登记 HTTPS 回调（human account key） curl -X POST "https://2some.ren/api/v1/bots//endpoint" \ -H "x-api-key: $TWOSOMEONE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com/bot/events","idempotencyKey":""}' # 查看当前回调与验签公钥 curl "https://2some.ren/api/v1/bots//endpoint" \ -H "x-api-key: $TWOSOMEONE_API_KEY" # 暂停出站（需带当前 configRevision；事件仍可 pull） curl -X PATCH "https://2some.ren/api/v1/bots//endpoint" \ -H "x-api-key: $TWOSOMEONE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"status":"paused","expectedConfigRevision":"","idempotencyKey":""}' ``` ## Thread 已读与关注状态 Bot 也可以用 `chat.read` 更新自己在**可见 Thread**上的已读水位或关注状态；这两个端点不需要 `chat.send`。它们只接受机器人已安装、未归档 Group 中满足安装隐私模式的顶层 Thread root。 ```bash # 把 Thread 已读位置推进到某条回复 curl -X POST "https://2some.ren/api/v1/chat/conversations//threads//read" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" -H "Content-Type: application/json" \ -d '{"upToMessageId":12345}' # 关注 / 取消关注一个 Thread curl -X POST "https://2some.ren/api/v1/chat/conversations//threads//follow" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" -H "Content-Type: application/json" \ -d '{"followed":true}' ``` `upToMessageId` 必须是正安全整数；服务端只会把水位向前推进到该 Thread 中实际可见的回复，不会因传入更大的 id 越过可见内容。已读成功返回 `{ "success": true, "updated": boolean, "lastReadMessageId": number | null }`；关注成功返回 `{ "success": true, "followed": boolean }`。对不存在或因 privacy mode 不可见的 root，Bot 两个端点都保持成功形态（已读返回 `updated: false`，关注回显请求值）且不写入状态，不要用响应判断 root 是否存在；真人会话对这类 root 返回 `404`。这些状态目前没有对应的 SDK 方法，需直接调用 REST。 当前关注字段还不是 tri-state：首次创建已读状态会按 `followed: true` 保存；即使随后写入 `false`，root 作者、被提及者或参与者仍可能因 Activity 的自动资格继续看到该 Thread。完整的“显式取消关注覆盖自动资格”尚未实现。 ### `clientMessageId` 幂等边界 同一会话内使用相同 `clientMessageId`、相同发送者和相同 `parentMessageId` / `threadRootId` 重试，会返回第一次写入的消息，不会重复创建。幂等校验**不会比较**正文、`blocks`、附件、语音或链接卡片等 payload；同一 UUID 和同一上下文即使改了内容，仍返回第一次结果。要发送新内容请换 UUID，或在允许的编辑窗口内修改原消息。重放仍会重新检查当前 Bot 安装状态和 Thread root 可见性；权限已撤销或 root 已失效时不会返回旧正文。若该 id 已被其他发送者使用，或同一发送者改用了不同的 parent / Thread 上下文，服务端会返回 `409`；此时应生成新的 UUID。省略 `clientMessageId` 的请求不会跨请求去重。 ## 常见错误 下表针对机器人 runtime 发布接口（发泡泡 / 发消息）： | 状态码 | 含义 | 处理建议 | |------|------|------| | `401` | 未提供、无效或已被轮换的密钥；部分鉴权入口也会把当前 capability / key scope 不足视为未授权 | 检查运行密钥和 capability；新增能力后按创建页说明轮换运行密钥 | | `403` | 身份有效，但会话成员关系、安装隐私模式或其他业务策略不允许该操作 | 检查安装状态、会话权限和消息规则；最终以响应的 `error` 字段为准 | | `400` | 参数错误（Bubble 文本超 500 字、Chat 文本超 8000 字、内容违规、附件超 9 张等） | 按返回的 `error` 字段修正 | | `409` | 同一会话内的 `clientMessageId` 已被其他发送者占用，或同一发送者改变了 parent / Thread 上下文 | 生成新的 UUID；不要重试当前 id | | `429` | `code: rate_limited`。可能是整把运行密钥限额（自助默认 **100 次/分钟**），也可能是 `GET .../messages` / Thread 的单独拉消息限额（默认 **5** 次/分钟，VIP 1 为 **30**，VIP 2 为 **60**，按主人当前 VIP 即时生效）。响应带 `Retry-After` 与 `X-RateLimit-*` | 读 `Retry-After` 后重试；反应型默认走 webhook / 事件 feed。拉消息分页每一页都计数，跨会话共用同一只桶 | 创建机器人（用账号密钥调管理接口）时，若用户名已被占用会返回 `409`。 ## 完整示例 一个最小可运行的 Node.js 机器人（Node 20+，零依赖）。保存为 `bot.mjs`，然后 `TWOSOMEONE_BOT_API_KEY=sk_xxx node bot.mjs` 运行： ```js // bot.mjs — 顶层 await 需要 ESM，文件后缀用 .mjs（或在 package.json 设 "type": "module"） const BASE = "https://2some.ren"; const KEY = process.env.TWOSOMEONE_BOT_API_KEY; async function api(path, init = {}) { const res = await fetch(`${BASE}${path}`, { ...init, headers: { "x-api-key": KEY, "Content-Type": "application/json", ...init.headers }, }); const body = await res.json(); if (!res.ok || body.success === false) throw new Error(body.error ?? `HTTP ${res.status}`); return body; } // 验证身份 const { user } = await api("/api/v1/bots/me"); if (user?.accountType !== "bot") throw new Error("不是机器人密钥"); // 发一条泡泡 const { id } = await api("/api/v1/bubbles", { method: "POST", body: JSON.stringify({ content: `大家好，我是 ${user.username} 🤖` }), }); console.log(`已发布：${BASE}/bubble/${id}`); ``` 更完整的实战范例（RSS 拉取、无状态去重、GitHub Actions 免服务器部署）见官方模板仓库 [leaperone/2someone-news-bot](https://github.com/leaperone/2someone-news-bot)。模板仓库的 README/SKILL 当前仍有旧的 `/api/auth/get-session` 身份调用，Fork 后请先改为 `GET /api/v1/bots/me` 并校验 `accountType === "bot"`，不能原样运行。 --- ## 创建与管理 URL: https://2some.ren/docs/bots/create 描述: 通过 Web 或 2s1 命令行工具创建机器人、管理密钥与状态 机器人的创建和管理可以在 Web 的「设置 → 自动化机器人」完成；如果你要在脚本或 AI 编程助手里批量操作，也可以使用官方命令行工具 `2s1`。 Web 路径会在创建成功后直接引导你生成运行密钥，并给出发布测试 Bubble 的命令。机器人的头像、昵称、简介也都在这里改——它是一个拥有独立资料页和账号身份的自动化账号（默认可见性为 `private`）。 ## 安装与登录 ```bash npm install -g @2someone/cli # 登录（会打开浏览器完成授权） 2s1 login # 确认登录状态 2s1 whoami ``` ## 创建机器人 ```bash 2s1 bot create --username my_bot --nickname "我的机器人" \ --description "这是一个示例机器人" \ --capability bubble.create --capability bubble.read ``` | 参数 | 必填 | 说明 | |------|------|------| | `--username` | 是 | 最终用户名 4-16 位字母 / 数字 / 下划线、不能纯数字，且必须以 `_bot` 结尾。CLI 会自动补 `_bot`（所以你写的前缀最多 12 位）；直接调 Web API 时必须自己带 `_bot` 后缀，否则返回 400 | | `--nickname` | 是 | 显示昵称 | | `--description` | 否 | 机器人简介，显示在它的个人空间 | | `--capability` | 否 | 能力，可重复传：`bubble.create` / `bubble.read` / `chat.send` / `chat.read` / `chat.react`；省略时默认是 `bubble.create` + `chat.send` | | `--visibility` | 否 | 可见性：`private`（默认）/ `unlisted` | | `--install-policy` | 否 | 群聊安装策略：`owner_only`（默认）/ `invite_required`；当前 `invite_required` 暂按机器人创建者/拥有者限制安装 | | `--default-privacy-mode` | 否 | 默认隐私模式：`mention_only`（默认，感知提及机器人、机器人自己的消息及满足条件的 Thread 上下文）/ `commands_only`（感知命令消息、机器人自己的消息及命令 Thread 上下文）。`read_all` 需官方开通 | 创建成功后会返回 `botUserId`，后续管理命令都用它来指定机器人。 Web「设置 → 自动化机器人」和直接调用 `POST /api/v1/bots` 时，省略 `capabilities` 也使用同一组默认能力：`bubble.create` + `chat.send`。Web 创建弹窗预选的也是这两项；CLI 示例若显式传入能力，则以你传入的列表为准（它是替换，不是追加）。 ## 两把密钥，别混用 机器人体系有两种密钥，**用途完全不同**： | | 账号密钥（human key） | 运行密钥（bot runtime key） | |------|------|------| | 是谁的身份 | 你自己 | 机器人 | | 怎么获得 | `2s1 login` 或 `2s1 apikey create` | `2s1 bot key rotate` | | 用来做什么 | 创建/修改/停用机器人 | 机器人程序调接口（发泡泡、发消息） | | 放在哪 | 你自己的电脑 | 机器人程序的运行环境（如 GitHub Actions secret） | 运行密钥（`sk_` 开头）**只在生成时显示一次**，请立即保存。不要把密钥写进代码或提交到 Git 仓库——放进环境变量或部署平台的 Secret 里。如果怀疑泄露，立刻轮换。 ## 管理运行密钥 ```bash # 列出当前密钥 2s1 bot key list # 轮换：生成新密钥，同时自动禁用旧密钥 2s1 bot key rotate --yes # 轮换并直接打印环境变量写法，方便复制进部署平台 2s1 bot key rotate --print-env --yes # 生成一把有有效期的临时密钥（如调试用，3600 秒后失效） 2s1 bot key rotate --expires-in 3600 --yes # 吊销指定密钥 2s1 bot key revoke --yes ``` 每个机器人同一时间只有一把启用的运行密钥——轮换即作废旧钥，记得同步更新部署环境里的 Secret。`--expires-in` 支持 3600 秒到 1 年；不带则密钥长期有效。新轮换的密钥自动带 `events.read`，用来拉 webhook 同一份事件 feed；这不是群安装授权。 自助轮换的运行密钥默认 **100 次/分钟**（整把 key）。`GET .../messages` 和 Thread 分页另有单独限额，按主人**当前** [充值 VIP](/pricing) 即时生效：默认 **5** 次/分钟，VIP 1 为 **30**，VIP 2 为 **60**。升级 VIP 不必再轮换密钥。自定义整把 key 限额仍需管理员。`read_all` 也不会因 VIP 解锁。详见 [Webhook 与轮询](/docs/bots/inbound)。 运行时的有效权限是「密钥 scopes」与「机器人当前 capability」的交集。删除 capability 会对后续请求立即失效，不需要轮换密钥；新增 capability 仍需 `bot key rotate` 生成包含新 scope 的运行密钥。已有安装会继续使用自己的隐私模式，不会因为机器人默认值改变而自动更新。 ## 管理机器人状态 ```bash 2s1 bot list # 列出我创建的机器人 2s1 bot show # 查看详情 2s1 bot update --nickname "新昵称" # 修改资料 2s1 bot pause # 暂停（接口调用会被拒绝） 2s1 bot resume # 恢复 2s1 bot disable --yes # 停用账号 ``` `2s1 bot update` 能改的不止昵称，下面这些字段都可以更新： | 参数 | 说明 | |------|------| | `--nickname` | 显示昵称 | | `--description` | 机器人简介 | | `--capability` | 替换能力（注意是替换不是追加），可重复传 | | `--visibility` | 可见性 | | `--install-policy` | 群聊安装策略 | | `--default-privacy-mode` | 默认隐私模式 | | `--status` | 状态（等价于 pause / resume / disable） | | `--clear-description` | 清空简介 | | `--clear-capabilities` | 清空全部能力 | 机器人头像目前在 Web「设置 → 自动化机器人」里上传——进入对应机器人即可换头像、改昵称和简介，让它更像一个独立账号。 ## 安装到群聊 机器人要在群聊里发消息或管理自己的 reaction，必须先被安装到那个群。当前安装会创建该群的 Bot 授权快照，因此安装操作必须由目标群主或管理员发起；Bot 的 `installPolicy` 还会叠加机器人所有者限制： ```bash 2s1 bot install --bot @my_bot --yes ``` `--bot` 既可以填 `@username`，也可以填 `botUserId`。如果直接调安装接口（`POST /api/v1/chat/conversations//bots`），至少传其中一个（通常只传一个）即可。安装者仍须是群成员且具备邀请权限；群已满时会返回 HTTP 400 和群已满提示。常见安装拒绝 `reason` 包括：`bot_not_found`（账号不存在；用 `botUserId` 指向非机器人账号时也会归入此项）、`not_a_bot`（按用户名查到的账号不是机器人）、`bot_inactive`（机器人已暂停/停用）、`bot_install_blocked`（安装策略不允许）、`bot_missing_chat_capability`（没有 `chat.send`、`chat.read` 或 `chat.react` 中任何一项）、`ai_character_group_not_supported`（AI 角色不能进群）。重复安装或非法参数会返回 400；群不存在、不是群聊或你不是成员会返回 404。`group_full` 是服务端内部错误码，当前安装接口不保证把它作为稳定 `reason` 返回。 `public` 只表示不再要求安装者是机器人创建者/拥有者，但不能绕过目标群的 owner/admin consent；`owner_only` 和当前尚未细分名单的 `invite_required` 还会要求安装者是机器人创建者/拥有者。无论哪种 Bot 安装策略，安装者都必须是目标群的 active 成员，并由目标群主或管理员发起授权；群的 `inviteRolePolicy` 不会把普通成员升级为 Bot grant approver。这两层策略彼此独立。安装成功时会把当时的 `defaultPrivacyMode` 复制到这次安装，之后修改机器人默认隐私模式不会改变既有安装；要应用新模式，请先在群成员管理中移除机器人，再重新安装。公开 API 目前没有单独的 Bot uninstall 或安装级隐私模式调整入口。 ## 登记 HTTPS 回调 反应型机器人被斜杠命令点到时，平台会向主人登记的公开 HTTPS 地址发送签名 POST。群安装界面没有 Webhook 勾选，地址只对主人可见。Mobile 暂无该设置，请用 Web 或 CLI： ```bash 2s1 bot endpoint create --url https://example.com/bot/events --yes 2s1 bot endpoint show 2s1 bot endpoint pause --yes ``` 对端必须先通过 `endpoint.verify` challenge（2xx 且回显同一个 `challenge`），回调才会变成 `active`。暂停后事件仍可用 runtime key 从 feed 补拉。步骤、验签和限额见 [Webhook 与轮询](/docs/bots/inbound)。 ## 测试机器人 CLI 内置了端到端测试命令，用运行密钥真实调用接口： ```bash # 读取机器人自己发过的泡泡（只读，安全） TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test bubble-read # 真实发布一条泡泡 TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test bubble-create --text "Hello, 泡泡!" --yes # 向群聊发一条真实消息 TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test chat-send --text "在呢" --yes # 按安装隐私模式读取群聊（轮询保底；拉消息限额按主人 VIP） TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test chat-read --limit 20 # 拉取 inbound 事件 feed（webhook 丢失时补拉） TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test events --limit 20 ``` 所有命令都支持 `--json` 输出，方便脚本和 AI 编程助手使用。 `2s1 --json bot context` 是专门写给 AI 编程助手（Claude Code / Codex）读的结构化能力清单：已实装的能力、自助创建限制、哪些命令需要 `--yes`、推荐的安全调用顺序。想让 AI 帮你写或改机器人程序时，先让它读这条命令的输出，它就能拿到准确的平台说明，不会瞎猜接口。 --- ## External AI Bot 授权 URL: https://2some.ren/docs/bots/external-ai-authorization 描述: 第三方 AI Bot 接收事件前，用户和群管理员需要确认的边界 External AI Bot 和 Hosted AI 角色不是一回事。Hosted AI 角色由 2SOMEone 托管模型与上下文；External AI Bot 则意味着第三方开发者会在授权范围内接收事件，并在自己的服务里处理。 现有自动化机器人可以发布 Bubble、读取自己发布过的 Bubble、向已安装群聊发送消息，并用 `chat.read` 在安装隐私模式允许的范围内轮询群聊和 Thread；获授独立的 `chat.react` 后，还可以管理自己发送消息上的 reaction。`chat.react` 不会扩大读取范围，也不能操作其他用户发送的消息。主人可以给**自己的**机器人登记平台签名的 HTTPS 回调，在斜杠命令命中时接收 `interaction.created`（见 [Webhook 与轮询](/docs/bots/inbound)）；这不是把群消息推给任意第三方模型流，群安装里也没有 Webhook 勾选。它不能读取 AI 角色私聊内容，也不会接入 `/chat` WebSocket 或第三方 webhook/WS 消息流；`mention.receive` 仍未开放给普通自助机器人。 ## 授权页必须展示什么 真正开放接收事件类能力时，授权页必须让用户或群管理员看清四件事： | 项目 | 必须说明 | |------|----------| | 开发者 | 开发者账号、机器人账号、来源说明和联系方式 | | 事件范围 | 会接收哪些事件，例如 @ 提及、指定群消息、指定会话消息 | | 数据外发 | 事件会发送到哪个第三方域名，离开 2SOMEone 后由谁负责 | | 撤销入口 | 在哪里移除安装、暂停机器人、轮换或吊销 runtime key | ## 什么不会自动外发 - 创建 AI 角色不会把用户私聊交给角色创作者。 - 安装一个只具备 `chat.send` 的机器人，不代表它能读取群消息；读取必须另授 `chat.read`，并受隐私模式过滤。 - 安装一个只具备 `chat.react` 的机器人，不代表它能发送或读取群消息；reaction 只作用于机器人自己发送且当前安装仍可见的消息。 - `bubble.read` 只允许读取机器人自己发布过的 Bubble，不是全站读取能力。 ## 撤销方式 群管理员可以在群聊设置里移除已安装机器人。机器人创建者可以在“设置 → 自动化机器人”里暂停机器人，或在密钥管理中轮换/吊销 runtime key。 公开授权页：[External AI Bot 授权说明](/bots/external-ai-authorization)；文档入口：[机器人文档](/docs/bots/external-ai-authorization) --- ## Webhook 与轮询 URL: https://2some.ren/docs/bots/inbound 描述: 用签名 HTTPS 回调接收斜杠命令，并用事件 feed 或 chat.read 轮询保底 反应型机器人的默认 inbox 是 **签名 HTTPS Webhook**，再用 `GET /api/v1/bots/me/events` 把漏掉的事件补回来。机器人**不会**接入 `/chat` WebSocket。 当前会推送的叫醒只有一种：群成员用 picker 发出结构化斜杠命令（消息带 `meta.botCommand`）时，平台写入一条 `interaction.created`，并在主人已登记 **active** 回调时签名 POST 过去。@ 提及、被回复的 webhook 面仍在收紧中，还没有对自助机器人开放。 这和机器人资料上的「来源类型 `webhook`」不是一回事。来源标记仍需官方开通；这里说的是主人给自己的机器人登记 HTTPS 回调，普通账号即可使用。 ## 什么时候用哪条路径 | 场景 | 用什么 | 需要什么 | |------|------|------| | 被斜杠命令点到时立刻醒来 | Webhook + 事件 feed | 主人登记 HTTPS 回调；runtime key 带 `events.read`（新轮换自动带上） | | Webhook 丢了、进程刚启动要对齐 | `GET /api/v1/bots/me/events` 或 `2s1 bot test events` | 同一把 runtime key | | 监控会话里更多可见消息 | `GET .../messages` / SDK `iterateChatMessagePages` / `2s1 bot test chat-read` | `chat.read` + 安装隐私模式；拉消息限额见下方 | 群管理员安装机器人时**看不到**回调 URL，也没有名为 Webhook 的勾选。地址只对机器人主人可见。Mobile 目前没有主人侧的回调设置界面，请用 Web「设置 → 自动化机器人」或 CLI。 ## 登记回调 先让你的服务监听一个**公开 HTTPS**地址，能接收 JSON POST。然后用账号密钥（不是机器人 runtime key）登记： ```bash # Web：设置 → 自动化机器人 → 对应机器人 → 回调地址 → 验证并保存 2s1 bot endpoint create --url https://example.com/bot/events --yes 2s1 bot endpoint show 2s1 bot endpoint pause --yes # 暂停出站；事件仍可 pull ``` 登记时平台会先发一条验证请求。对端必须在超时内返回 **2xx**，响应 JSON 里回显同一个 `challenge`： ```json { "type": "endpoint.verify", "challenge": "<平台生成的字符串>", "endpointId": "", "botUserId": "" } ``` 你的响应至少包含 `{ "challenge": "<原样回显>" }`。验证通过后状态变为 `active`，斜杠命令才会出站。URL 必须是 HTTPS、不能带用户名密码；内网和回环地址会被拒绝。 ## 收到事件之后 叫醒 POST 的 body 是事件信封本身，当前类型为 `interaction.created`，`data.interactionType` 为 `"command"`。请按原始字节验签，不要先 pretty-print 再算签名。 请求头： | 头 | 含义 | |------|------| | `x-webhook-timestamp` | Unix 毫秒时间戳 | | `x-webhook-endpoint-id` | 回调 id | | `x-webhook-endpoint-config-revision` | 回调配置 revision | | `x-webhook-key-id` | 验签公钥 id | | `x-webhook-signature` | `v1:` + Ed25519（base64url） | | `x-webhook-bot-id` | 机器人用户 id | | `x-webhook-id` | 本次投递 id | 签名内容是 `timestamp.endpointId.body`（三个字段用英文句点拼接，`body` 为原始 JSON 字符串）。公钥在 `2s1 bot endpoint show` 或 Web 回调对话框里，算法为 Ed25519。SDK 可直接调用 `verifyBotWebhookSignature`；默认允许约 5 分钟时钟偏差。 处理成功请返回 2xx。投递失败后请用事件 feed 补拉，不要假设平台会无限重试到你的进程醒来。 ## 用事件 feed 补拉 新轮换的 runtime key 自动带 `events.read`。这不是群安装授权，也不是 `chat.read`。 ```bash curl "https://2some.ren/api/v1/bots/me/events?limit=100" \ -H "x-api-key: $TWOSOMEONE_BOT_API_KEY" \ -H "x-2someone-bot-runtime: 1" TWOSOMEONE_BOT_API_KEY=sk_xxx 2s1 bot test events --limit 20 ``` `cursor` 是不透明字符串，只把上次响应里的 `nextCursor` 原样传回去。`wait` 非 0 会返回 400，当前不做 long poll。暂停回调后，这条 pull 路径仍然可用。 完整字段、curl 和 429 处理见[接口参考](/docs/bots/api#事件-inbox-与-webhook-叫醒)。 ## 轮询限额 `GET .../messages` 和 `GET .../messages/:messageId/thread` 轮询**仍然保留**。可见范围继续由 `chat.read` 和这次安装的隐私模式决定；充值 VIP **不会**把 `read_all` 开放给普通自助机器人。 这两条拉消息接口有**单独限额**，按机器人主人**当前**充值 VIP 即时生效（升级后不必轮换密钥）。同一把 runtime key 下，所有会话的分页请求共用一个桶，每一页都计数： | 主人身份 | 拉群消息 / Thread（每机器人每分钟） | |------|------| | 普通账号（VIP 0） | **5** | | [VIP 1](/pricing) | **30** | | [VIP 2](/pricing) | **60** | | 管理员 | **300** | 运行密钥本身仍是整把 key 的总限额：自助轮换默认 **100 次/分钟**（Webhook 档，发消息、事件 feed、webhook 相关调用共用）。管理员账号轮换时可盖更高的整把 key 限额；自定义 `rateLimitMax` 仍需管理员。已经发出的旧密钥如果曾盖过 5000，会保持到下次轮换。 触发拉消息限额时返回 `429`，`code: rate_limited`，并带 `Retry-After` / `X-RateLimit-*`。反应型机器人应默认走 webhook / 事件 feed；只有需要监控会话里更多内容时，才按 VIP 档控制 `chat.read` 频率。VIP 权益说明见[用户等级与充值 VIP](/docs/billing/membership)。 --- ## 快速开始 URL: https://2some.ren/docs/bots 描述: 了解 2SOMEone 机器人能做什么，10 分钟拥有你自己的机器人 机器人（Bot）是平台上的一类自动化账号：它有自己的用户名、昵称和头像，可以定时发布泡泡动态、在群聊里发消息，也可以登记 HTTPS 回调，在被斜杠命令点到时被平台叫醒。官方的 [@news_bot「资讯泡泡」](https://2some.ren/news_bot) 就是一个机器人——它按计划把科技圈新鲜事发布成泡泡。 你可以创建自己的机器人来扩展玩法：开播提醒、粉丝群播报、RSS 订阅转发、定时打卡提醒……任何「定时或自动发内容」的场景都适合交给机器人。 ## 机器人能做什么 | 能力 | 说明 | |------|------| | 发布泡泡 | 以机器人身份发布泡泡动态，支持纯文本、富文本贴纸、已准备的图片附件，以及回复 / 引用（受接口权限和资源状态限制） | | 读自己的泡泡 | 读取机器人自己发布过的内容（常用于去重判断） | | 群聊发消息 | 向已安装该机器人的群聊发送消息 | | 读取群聊与 Thread | 在 `chat.read` + 安装隐私模式允许的范围内读取消息和 Thread | | 被斜杠命令叫醒 | 主人登记 HTTPS 回调后，群成员用 picker 发送 `/name@bot` 时平台会签名 POST 一条 `interaction.created`；同一事件也可从事件 feed 补拉 | | 管理自己的 reaction | 用独立的 `chat.react` 为机器人自己发送的消息添加或取消 reaction | 机器人**不能**读取他人的泡泡；Chat 读取受 `chat.read`、Group 安装状态和 `mention_only` / `commands_only` / `read_all` 隐私模式共同限制。`chat.react` 是独立授权，不会隐式授予读取或发送；它目前只允许机器人操作自己发送的消息，不能替其他用户的消息添加或取消 reaction。Bot runtime 当前只支持已安装的 Group，不适用于私信、Channel 或客服会话。反应型 Bot **默认**用 **Webhook 叫醒 + `GET /api/v1/bots/me/events` 保底**（目前会在斜杠命令命中时推送；@ / 被回复的 webhook 面仍在收紧中），不接入 `/chat` WebSocket。需要监控会话里更多内容时，**轮询路径仍在**：用 runtime key 调 `GET .../messages`（需 `chat.read`，可见范围仍受安装隐私模式约束）。拉群消息按主人当前 VIP 单独限额（默认 5 次/分钟，VIP 1 为 30，VIP 2 为 60）；运行密钥仍按 Webhook 档签发（100 次/分钟）。群安装没有名为 Webhook 的权限开关；回调 URL 由机器人主人在设置或 CLI 登记。步骤与验签见 [Webhook 与轮询](/docs/bots/inbound)。涉及第三方接收事件的 External AI Bot 必须走单独的[授权说明](/docs/bots/external-ai-authorization)。 ## 最快路径：Fork 官方模板 官方资讯机器人是开源的，仓库本身就是模板，**不需要自己的服务器**。不过当前模板仓库的 README/SKILL 仍引用已经禁止 Bot runtime key 调用的旧身份接口 `/api/auth/get-session`，所以**不能直接按原样运行**；Fork 后先把身份预检改成 `GET /api/v1/bots/me`，并确认 `user.accountType === "bot"`，再启用 workflow。平台接口的当前契约以[接口参考](/docs/bots/api)为准。 ### 1. Fork 模板仓库 打开 [leaperone/2someone-news-bot](https://github.com/leaperone/2someone-news-bot)，点击右上角 Fork。 ### 2. 创建机器人账号并获取密钥 ```bash npm install -g @2someone/cli 2s1 login 2s1 bot create --username my_news --nickname "我的资讯姬" \ --capability bubble.create --capability bubble.read # 获取运行密钥（只显示一次，立即保存） 2s1 bot key rotate --yes ``` ### 3. 配置 Secret 并启用 在你 Fork 的仓库里进入 **Settings → Secrets and variables → Actions**，新建 secret `TWOSOMEONE_BOT_API_KEY`，填入上一步的 `sk_...` 密钥。然后到 **Actions** 标签页启用 workflow，手动运行一次 **Post news**（勾选 `dry_run` 可以先预览效果，不会真实发布）。 完成。当前运行频率以模板仓库 workflow 中的 `schedule` 配置为准，Fork 后请查看并按需修改（GitHub Actions 的 schedule 默认仍可能处于禁用状态，需在 Actions 页面启用）。想换内容来源，编辑仓库里的 `feeds.json` 即可——任何标准 RSS / Atom 源都可以。 模板里的 RSS 部分可以整体替换成任何数据源（天气、汇率、GitHub Releases……）。把仓库交给 AI 编程助手（如 Claude Code / Codex）改造效果最好——仓库里的 `SKILL.md` 就是写给它们看的平台说明书。 ## 从零自己写 机器人本质上就是「一个会调 HTTP 接口的程序」。核心是： 1. 在「设置 → 自动化机器人」或通过 [CLI 创建机器人账号](/docs/bots/create)，拿到运行密钥 2. 程序里带上 `x-api-key` 请求头调用[开放接口](/docs/bots/api) 3. 反应型机器人再登记 [HTTPS 回调](/docs/bots/inbound)，用 webhook + 事件 feed 接收斜杠命令；需要监控更多群消息时继续轮询 `chat.read` 4. 把程序跑在任何能联网的地方（GitHub Actions、服务器、甚至你自己的电脑） ## 数量与权限说明 普通账号最多创建 **3 个机器人**；管理员不受此自助创建上限限制。普通用户创建的机器人有以下限制（需要更高权限请联系官方）： | 项目 | 普通用户可用 | 说明 | |------|------|------| | 可见性 | `private` / `unlisted` | `public`（公开列出）暂需官方开通 | | 安装策略 | `owner_only` / `invite_required` | 公开安装暂需官方开通 | | 默认隐私模式 | `mention_only` / `commands_only` | 决定机器人在群里默认能感知多少消息；`read_all`（读全量会话）暂需官方开通 | | 来源类型 | `manual` | 资料上的 RSS / Webhook **来源标记**暂需官方开通；主人登记 HTTPS 回调（斜杠命令叫醒）是另一件事，见 [Webhook 与轮询](/docs/bots/inbound) | | 运行密钥限额 | Webhook 档 100 次/分钟 | 整把 key 的总限额；自定义限额仍需管理员 | | 拉群消息限额 | 默认 5 次/分钟 | `GET .../messages` 与 Thread 分页共用；VIP 1 为 30、VIP 2 为 60，按主人当前 VIP 即时生效 | 「默认隐私模式」是机器人在群聊里的默认感知范围：`mention_only` 感知提及机器人的消息、机器人自己的消息及满足条件的 Thread 上下文；`commands_only` 感知命令消息、机器人自己的消息及命令 Thread 上下文。隐藏 Thread 中单独 @Bot 不会让隐藏 root 变得可见。普通用户两者都能用，想读全量会话的 `read_all` 需要官方开通。创建和修改时都能用 `--default-privacy-mode` 指定。 --- ## 收货地址 URL: https://2some.ren/docs/billing/address 描述: 统一查看、编辑、删除你提交给主播的收货地址 # 收货地址 你给不同主播提交过的收货地址，可以在一个地方集中管理：查看、编辑、删除。 进入路径：控制台「设置」→「地址管理」。 进入地址管理前**需要先绑定 B 站**。没绑定会被引导去绑定页。 ## 这里管的是「我提交的地址」 这页是**粉丝 / 用户视角**：列出你作为收件人，提交给各位主播的地址。每条地址会显示「收件人 提交给 某主播 的地址」，以及电话和详细地址。 如果你是主播，想收集粉丝寄送周边的地址，那是另一个功能，见礼兮的 [地址管理](/docs/oh-gift/address)。这页只管你自己提交出去的地址。 ## 查看、编辑、删除 | 操作 | 怎么做 | |------|--------| | 查看 | 进入地址管理页，所有提交过的地址按主播分卡片显示 | | 编辑 | 点地址卡片上的「编辑」，会跳到对应主播的地址提交页修改 | | 删除 | 点地址卡片上的删除按钮 | 还没提交过任何地址时，页面会显示「暂无收集的地址」。 --- ## 余额与用量 URL: https://2some.ren/docs/billing/balance-usage 描述: 看懂付费余额与赠送余额的区别，查每一笔消费明细 # 余额与用量 这页讲两件事：账户余额由什么构成，以及怎么核对钱花在哪里。 ## 余额构成 进入「设置」→「余额」，顶部「账户余额」是合计金额，下面分两行写明构成： - **付费 ¥X.XX**：你充值的本金，无有效期。 - **赠送 ¥X.XX**：来自签到、任务、邀请奖励、充值赠送等，有有效期。 | 余额类型 | 来源 | 有效期 | 扣费顺序 | |----------|------|--------|----------| | 赠送余额 | 充值赠送 | 三年 | 优先扣 | | 赠送余额 | 任务 / 签到 / 邀请奖励 | 90 天 | 优先扣 | | 付费余额 | 充值本金 | 无 | 赠送扣完才扣 | 赠送余额按有效期统计。已过期的赠送余额不再计入「账户余额」，所以即使你没花钱，过期后总额也会下降。任务 / 邀请奖励有效期更短（90 天），请及时使用。 充值赠送与扣费顺序的完整说明见 [充值](/docs/billing/recharge) 与 [账号与计费总览](/docs/billing)。 ## 用量记录（消费明细） 想知道钱花在哪，看「设置」→「用量」。这页列出**最近 24 小时**的每一笔消费：日期时间、服务类型、消费金额。 常见的服务类型（页面会用中文显示）： | 服务类型 | 触发场景 | |----------|----------| | 下载投稿附件 | 取回粉丝在泡泡树洞投稿里的附件 | | 生成投稿总结 | 给泡泡树洞稿件生成 AI 摘要 | | 礼物分析 | 礼兮的礼物消费分析 | | 获取当前舰长 / 舰长历史 | 礼兮拉取大航海舰长数据 | | 导出大航海名单 | 把舰长 / 航海名单导出 | | 导出数据到 Excel | 导出地址等数据 | | 礼品金额筛选 / 消费金额统计 | 礼兮按金额筛选 / 统计用户 | | 生成感谢信 | 给舰长生成感谢文案 | | 泡泡树洞增值审核 | 泡泡稿件的 AI 增值审核 | | 短信通知 | 发送短信提醒 | | AI 角色回复 | 粉丝与你的 AI 角色卡对话 | 用量页只保留最近 24 小时的记录。要核对更早的消费，请在使用前留意页面提示的扣费金额。 各功能的单价以 [价格页](/pricing) 为准。其中 **Level 1 及以上的图片附件取回**和 **AI 增值审核**只扣赠送余额，赠送余额不足时按限免处理，不会动你的充值本金。Level 0 取回图片时按 ¥0.03 / MB 实际扣费，先扣赠送余额，再扣付费余额。 --- ## 桌面端 App URL: https://2some.ren/docs/billing/desktop 描述: 用桌面客户端登录 B 站、采集直播数据、查看运行状态 # 桌面端 App 桌面端是采集直播数据的关键一环。装好桌面客户端、登录你的 B 站账号后，它会在后台采集数据回传到平台，供礼兮、僚机等工具分析，也是 [开播通知](/docs/live-tools/go-live-notify) 能知道你开播了的数据来源之一。 下载地址在 [安装下载页](/install)（提供 macOS、Windows、Linux 版本）。装好后，控制台里有专门的「桌面端管理」页查看状态。 进入路径：控制台「桌面端管理」。 ## 连接状态 「桌面端管理」页右上角显示当前客户端的**连接状态**。如果还没装客户端或客户端没运行，页面会引导你先安装。装好并运行后，页面才会显示账号卡片和日志等内容。 ## 登录 B 站账号 在「B 站账号」卡片里登录 B 站，桌面端才能采集你直播间的数据： 1. 点登录入口，桌面端会弹出 B 站登录（支持扫码登录）。 2. 用 B 站手机 App 扫码确认。 3. 登录成功后，卡片会显示当前 B 站账号信息。 桌面端支持**多账号**：登录多个 B 站账号后，可以在卡片里切换当前生效的账号。 桌面端登录、扫码、多账号切换都依赖客户端本身在运行。如果状态显示未连接，先确认桌面 App 已经打开。 ## 运行日志 页面底部有「日志」区，展示桌面端的运行日志。采集异常或想确认客户端是否正常工作时，先看这里。 --- ## 账号与计费 URL: https://2some.ren/docs/billing 描述: 看懂账户余额怎么算、钱花在哪、返佣怎么提现 # 账号与计费 2SOMEone 的付费功能都用「账户余额」结算。这一节讲清楚余额由什么构成、扣费按什么顺序、充值有哪些档位、邀请返佣怎么提现。先看懂这页的总览，再按需翻具体页面。 进入路径：控制台「设置」→「余额」（也叫账户余额页）。 ## 三种余额，互不相通 你的账户里其实有三套独立的余额，来源和用途都不一样，千万别混为一谈。 | 余额类型 | 来源 | 用途 | 能否提现 | |----------|------|------|----------| | **付费余额** | 自己充值的本金 | 平台内所有付费功能 | 不可提现 | | **赠送余额** | 签到、任务、邀请奖励、充值赠送 | 平台内所有付费功能 | 不可提现 | | **返佣余额** | 好友充值给你的返佣 | 只能提现到支付宝 | 可提现 | 余额页顶部显示的「账户余额」是**付费余额 + 赠送余额**的合计（按当前有效的赠送余额计），返佣余额单独走「提现」页。 返佣余额和前两种是两个世界。返佣余额只能提现、不能用来买功能；签到 / 任务 / 邀请所得的赠送余额只能消费、不能提现。 ## 扣费顺序：先扣赠送 消费付费功能时，系统**优先扣赠送余额，扣完才动付费余额（充值本金）**。这样你充的钱能留得更久。 有两类功能比较特殊：**Level 1 及以上的图片附件取回**和**泡泡树洞 AI 增值审核**只会消耗赠送余额，赠送余额不够时剩余部分继续按限免处理，不会动充值本金。Level 0 取回图片时按 ¥0.03 / MB 实际扣费，先扣赠送余额，再扣付费余额。 ## 新用户有 7 天免费试用 新注册用户享有 **7 天免费试用期**，试用期内使用平台功能不扣余额。试用期里完成任务领到的赠送余额会正常累积，试用结束后才开始按上面的顺序扣费。详见 [任务中心](/docs/checkin)。 ## 按需深入 | 我想…… | 看这页 | |--------|--------| | 首充优惠、赠送档位、四种支付方式 | [充值](/docs/billing/recharge) | | 搞清余额构成、查每笔消费明细 | [余额与用量](/docs/billing/balance-usage) | | 把返佣提现到支付宝 | [返佣提现](/docs/billing/withdrawal) | | 解锁高级功能（按累计充值门槛） | [功能解锁](/docs/billing/membership) | | 找客服、提交工单 | [在线客服](/docs/billing/support) | | 用桌面端采集直播数据 | [桌面端 App](/docs/billing/desktop) | | 管理我提交给主播的收货地址 | [收货地址](/docs/billing/address) | 本节涉及的金额、档位与规则可能随平台更新调整，具体以页面实际显示为准，最终解释权归开发团队所有。 --- ## 用户等级与充值 VIP URL: https://2some.ren/docs/billing/membership 描述: 看懂 Level 成长等级、充值 VIP 和有效月充值算法 # 用户等级与充值 VIP 2SOMEone 把账号成长和充值权益分成两套独立等级： - **用户等级（Level 0–2）**：由资料完善和可信 Mobile 触达提升，不受充值影响。 - **充值 VIP（VIP 0–2）**：只由成功充值计算，不受资料状态影响。 ## 用户等级 | 等级 | 达成条件 | 主要权益 | |------|----------|----------| | Level 0 | 注册后的默认等级 | 基础功能 | | Level 1 | 完善头像、昵称、用户名，并绑定 B 站；或绑定抖音并填写主页链接 | Wiki、AI 工具、BubbleBox 成长权益、图片附件免费取回、千人群 | | Level 2 | 登录 Mobile App 并完成 native 设备注册 | Mobile 成长权益、万人群（界面显示无上限） | Level 2 沿用原来的独立触达档语义：可信 Mobile 触达可以直接达到 Level 2，不要求先完成 Level 1 的资料条件。 ## 充值 VIP 充值 VIP 使用「有效月充值」评定： ```text 有效月充值 = max(近 30 天成功充值总额, 过去 365 天成功充值总额 / 12) ``` | 等级 | 有效月充值 | 当前权益 | |------|------------|----------| | VIP 0 | 少于 ¥10 | 默认充值等级；机器人拉群消息 5 次/分钟 | | VIP 1 | 至少 ¥10 | 2025 高级分析；机器人拉群消息 30 次/分钟（按主人当前 VIP 即时生效，详见 [Webhook 与轮询](/docs/bots/inbound)） | | VIP 2 | 至少 ¥100 | 高阶充值权益；机器人拉群消息 60 次/分钟 | 单月大额充值会立即按近 30 天金额提升 VIP；充值滑出 30 天后，系统仍会用过去 365 天总额除以 12 计算月均，让持续支持的用户不会立刻掉到最低档。超出 365 天窗口的充值会自然移出统计。 只有**成功**状态的实际充值金额计入 VIP。赠送余额、返佣、任务奖励和消费余额都不计入。 ## 邀请绑定 B 站的额外奖励 邀请好友并引导对方绑定 B 站，还能拿额外的赠送余额。这部分属于邀请奖励，与用户等级和充值 VIP 都是独立的（注册阶梯奖励见 [任务中心](/docs/checkin)）： | 条件 | 奖励 | 归谁 | |------|------|------| | 被邀请人绑定 B 站 | ¥1 | 仅被邀请人 | | 被邀请人 B 站粉丝 ≥ 1000 | 各 ¥5 | 邀请人和被邀请人双方 | | 被邀请人 B 站粉丝 ≥ 10000 | 各 ¥10 | 邀请人和被邀请人双方 | 这三档奖励进的是**赠送余额**，有效期 90 天，只能用于平台内消费、不可提现。粉丝档奖励每个台阶各发一次，不会重复发放。 --- ## 充值 URL: https://2some.ren/docs/billing/recharge 描述: 首充优惠、充值档位、赠送规则与四种支付方式 # 充值 充值给账户增加余额，用来支付平台内的各项功能。普通网页充值会增加付费余额，达到档位还能获得赠送余额。 进入路径：控制台「设置」→「余额」，在充值区输入金额或点快捷档位。 ## 注册 7 天首充优惠 注册未满 **7×24 小时**、并且从未有过成功充值订单的账号，可以购买一次首充优惠： | 实付 | 到账 | 余额类型 | 有效期 | 支付渠道 | |------|------|----------|--------|----------| | ¥0.99 | ¥9.9 | 全部为赠送余额 | 90 天 | 仅支付宝 | - 注册满 7 天，或者任意渠道曾经成功充值后，侧边栏和余额页不再显示首充优惠；退款不会恢复首充资格。 - 首充优惠只支持支付宝。Stripe 国际支付、Infini 数字货币和 Apple 内购都不能购买这个套餐。 - 支付到账时会再次检查资格；如果已经超过 7 天或已有其他成功充值，本单只按实付 ¥0.99 增加付费余额，不再发放 ¥9.9 赠送余额。 - ¥9.9 全部进入赠送余额，不另外增加 ¥0.99 永久付费余额。 - 首充实付 ¥0.99 会进入充值记录和 VIP 统计，但不足以达到 VIP 1 的有效月充值 ¥10 门槛。 - 首充优惠不产生邀请返佣。 ## 普通充值档位与赠送 页面提供三个快捷档位，达到档位金额即享赠送： | 充值金额 | 赠送 | 实际到账 | 页面标注折扣 | |----------|------|----------|------| | ¥138 | ¥20 | ¥158 | 9 折 | | ¥365 | ¥185 | ¥550 | 7 折 | | ¥648 | ¥648 | ¥1296 | 5 折 | 赠送按「达到金额门槛」计算，不用刚好输入档位数字。例如充 ¥139 也能拿到 ¥20 赠送，充 ¥500 按 ¥365 档拿 ¥185 赠送。 赠送部分进入你的**赠送余额**，有效期三年，消费时优先使用（扣费顺序见 [账号与计费总览](/docs/billing)）。 - 普通充值最低金额为 **¥10**；¥0.99 首充优惠是单独套餐。 - 充值本金进入**付费余额**，无有效期。 ## 充值 VIP 怎么计算 充值 VIP 只统计成功订单的实际充值金额。系统取以下两者中较高的一个作为「有效月充值」： - 近 30 天成功充值总额 - 过去 365 天成功充值总额 ÷ 12 有效月充值达到 ¥10 为 VIP 1，达到 ¥100 为 VIP 2。赠送余额、任务奖励和返佣不计入。完整说明见[用户等级与充值 VIP](/docs/billing/membership)。 ## 四种支付方式 | 方式 | 适用场景 | 说明 | |------|----------|------| | **支付宝** | 网页 / 手机浏览器 | 创建订单后直接跳转支付宝完成支付 | | **国际支付** | 海外银行卡用户 | 走 Stripe，支持 Visa / Mastercard / Apple Pay，额外收手续费 | | **数字货币** | USDT / USDC 用户 | 走 Infini 托管收银台，按美元金额发起链上支付 | | **Apple 内购** | iPhone App 内 | 使用 App Store 消耗型商品，到账额度按商品配置发放 | ### 支付宝 点「支付宝充值」按钮，系统创建订单后跳转支付宝付款页，支付完成自动回到余额页。手机和电脑会自动适配对应的支付方式。 ### 国际支付（Stripe） 按钮文案是「国际支付 (+$0.30 手续费)」。它按固定汇率把人民币折算成美元收取： | 项目 | 数值 | |------|------| | 汇率 | 固定 1 美元 = 6.8 元 | | 手续费 | 每笔 $0.30 | | 最低充值 | ¥10 | | 支持卡组织 | Visa / Mastercard / Apple Pay | 举例：充值 ¥138，折合 $20.29，加 $0.30 手续费，实际扣 $20.59。点按钮时页面会显示本次的美元总额。 ### 数字货币（Infini） 按钮文案是「数字货币充值 (USDT / USDC)」。系统按固定汇率 **1 美元 = 6.8 元** 将人民币充值金额换算成美元，并向上保留两位小数；不额外收取 Stripe 的 `$0.30` 固定手续费。 - 普通充值最低 ¥10。 - 支持 USDT / USDC，具体可用网络以 Infini 收银台显示为准。 - 普通阶梯赠送规则与支付宝、Stripe 相同。 - ¥0.99 首充优惠不能使用 Infini 支付。 ### Apple 内购（iPhone App 内） 在 iOS App 里打开余额页时，网页支付入口会自动隐藏，改走 Apple 内购充值。这是 App Store 的规则要求。 - Apple 内购当前商品为：¥10 到账 ¥7、¥30 到账 ¥21、¥100 到账 ¥70。 - Apple 内购不使用网页端的 ¥138 / ¥365 / ¥648 阶梯赠送规则。 - ¥0.99 首充优惠不能使用 Apple 内购购买。 - 通过 Apple 内购充值的订单，在「充值记录」里的「方式」一栏会显示 **Apple 内购**。 同一个账户通过不同渠道获得的余额可以通用，但各渠道的售价、到账额度和赠送规则不同。iOS App 内只能使用 Apple 内购；网页和手机浏览器可以使用支付宝、Stripe 或 Infini。 ## 充值记录 余额页下方有「充值记录」，展示最近的充值订单：时间、金额、支付方式、状态。订单状态有四种： | 状态 | 含义 | |------|------| | 待支付 | 订单已创建，尚未完成付款 | | 成功 | 付款成功，余额已到账 | | 失败 | 付款未完成 | | 已退款 | 该笔已退款 | 充值成功且获得赠送余额的记录，金额旁会标出对应的赠送金额，包括 ¥0.99 首充优惠的 ¥9.9 赠送余额。 ## 邀请好友充值有返佣 把账户充值的人是你邀请来的，你能拿到对方普通充值的返佣，可提现到支付宝。¥0.99 首充优惠不产生返佣。返佣规则见 [返佣提现](/docs/billing/withdrawal)，邀请玩法见 [任务中心](/docs/checkin)。 --- ## 在线客服 URL: https://2some.ren/docs/billing/support 描述: 站内提交工单、附截图、多轮对话，比发邮件更快 # 在线客服 遇到问题，站内就能提交工单找客服。相比发邮件，工单能附截图、自动带上诊断信息、还能多轮对话跟进，处理更快。 官方社群是和其他主播交流、获取平台动态的地方（见 [官方社群](/docs/chat/official-community)）。**客服工单是你和官方一对一沟通问题的私密通道**，别人看不到。报障 / 账号问题请走工单。 ## 提交工单 1. 点开站内的客服气泡，进入客服面板。 2. 选「提交工单 / 反馈」，填写以下内容： | 字段 | 说明 | |------|------| | 标题 | 一句话概括问题（不超过 200 字） | | 分类 | Bug、建议、账号、其他 | | 优先级 | 低、普通、高、紧急 | | 描述 | 详细说明问题（不超过 2000 字） | | 截图 / 附件 | 可附截图和图片，帮助客服定位问题 | 3. 提交后系统会自动附上你所在页面的诊断信息，方便客服排查。 ## 跟进与评分 - 工单支持**多轮对话**：客服回复后，你可以继续在同一工单里补充。 - 工单**关闭后**可以给本次服务**评分**。 - 客服面板里也内置了常见问题入口，提交前可以先看看能不能自助解决。 ## 还可以发邮件 如果不方便用站内工单，也可以发邮件到 **support@leaper.one** 联系客服团队。 --- ## 返佣提现 URL: https://2some.ren/docs/billing/withdrawal 描述: 把邀请返佣提现到支付宝，含绑定、规则与反作弊 # 返佣提现 邀请好友充值能拿返佣，返佣余额可以提现到支付宝、秒级到账。这页讲清楚怎么绑账号、提现有哪些规则。 返佣怎么来的、邀请怎么玩，见 [任务中心](/docs/checkin)。 ## 返佣怎么算 被你邀请的好友通过支付宝、Apple 内购、Stripe 或 Infini 完成**普通充值**，你都能拿到实付金额 **30%** 的返佣，单笔最高 **¥1000**。¥0.99 首充特惠不产生返佣，好友以后每次普通充值都算。返佣进入独立的「返佣余额」，只能提现，不能用来买功能。 ## 第一步：绑定支付宝 提现前必须先绑定收款账号。进入「设置」→「支付账号绑定」，填写： 1. **支付宝账号**：你的支付宝登录邮箱或手机号。 2. **真实姓名**：必须与支付宝实名认证姓名完全一致。 真实姓名和支付宝实名不一致会导致**转账失败**。绑定的信息仅用于返佣提现。 ## 第二步：申请提现 进入「设置」→「提现」，输入金额，确认收款账号，点「确认提现」。转账成功后通常秒级到账。 ### 提现规则 | 规则 | 数值 | |------|------| | 单次最低提现 | ¥100 | | 单次最高提现 | ¥10,000 | | 两次提现间隔 | 7 天 | | 每月提现次数上限 | 10 次 | | 提现方式 | 支付宝 | 此外还有这些限制： - **注册未满 3 天不能提现。** - **有正在处理的提现时，不能再发起新的提现。** - 提现金额会从「可提现余额」实时扣减。 ## 反作弊 为防止刷返佣，系统会对异常行为拦截提现。出现下列情况会被判为可疑、提现被拒： - 账号注册未满 3 天。 - 好友充值后立即（不到 1 小时）就提现。 - 短期内（7 天）邀请人数异常偏多。 被拦截时页面会提示「检测到异常行为」，正常使用无需担心。 ## 转账失败怎么办 如果支付宝转账失败，**提现金额会自动退回**你的返佣余额，提现记录里会标记为失败。你可以在「提现记录」里对失败的那笔**重试**，无需重新填写。 进入路径：提现页点「查看提现记录」，或「设置」→「提现」→「提现记录」。 --- ## 如何收稿 URL: https://2some.ren/docs/bubblebox/collecting 描述: 主播如何设置投稿箱、用标签分类，以及管理收到的投稿 # 如何收稿 本文档介绍主播如何设置投稿箱、用标签给投稿分类，以及处理收到的投稿。 ## 进入控制台 1. 登录你的 2SOMEone 账号 2. 点击顶部导航栏的「控制台」 3. 在左侧菜单展开「泡泡树洞」，选择「收稿箱」 或直接访问：`https://2some.one/dashboard/bubblebox` 侧栏「泡泡树洞」下还有「已发送」，用来查看你向其他主播投出去的稿件（见 [投稿功能](/docs/bubblebox/submission)）。 ## 账号级设置 投稿权限、公开方式、AI 审核等都是**账号级的全局设置**，对你收到的所有投稿统一生效，不是按标签单独配置。 在收稿箱顶部点设置图标（齿轮）打开设置抽屉，可以调整： | 设置项 | 说明 | |--------|------| | 投稿权限 | 控制谁可以向你投稿（匿名 / 注册 / 绑定，即 Level 0/1/2） | | 新投稿公开方式 | 投稿人选择 / 仅私密 / 仅公开，决定投稿意愿（公开/私密），不直接进首页 | | 收到投稿立即转发到泡泡 | 审核通过且意愿为公开时，自动转发到泡泡并进入首页信息流（所有用户默认开启，Level 1 可关闭） | | AI 增值审核 | 是否在基础审核之上开启深度内容分析（见下方「AI 审核」） | | 显示互动区 | 在展示区显示点赞和评论 | | 转发时同步直播弹幕 | 默认暂存当前展示稿件收到的弹幕，转发到泡泡后自动加入讨论（默认开启） | | 个人空间入口 | 是否在个人主页展示泡泡树洞入口 | | 字体 / 字号 / 绿幕 / 加载背景 | 展示区显示样式（见 [浏览与展示](/docs/bubblebox/display)） | 权限等级的详细对比见 [权限系统](/docs/bubblebox/permissions)。 ## 标签管理 标签用来给投稿分类。投稿人可以在投稿时给内容打上你设好的标签，你也能在收稿箱里按标签筛选。 标签是**可选**的：投稿人不打标签也能正常投稿，标签为空的投稿一样会进收稿箱。 ### 新建标签 1. 点收稿箱顶部的筛选图标，打开标签弹层 2. 在弹层底部的「新标签」输入框里填名称 3. 按回车或点对勾即可创建 ### 标签设置 点某个标签旁的铅笔图标，可以编辑： | 设置项 | 说明 | |--------|------| | 名称 | 标签的显示名称，投稿人可见 | | 投稿时可选 | 关闭后，投稿人在投稿页看不到这个标签（已有投稿不受影响） | 标签没有单独的权限、接收开关或公开策略——这些都是上面的账号级设置。 ### 按标签筛选 在标签弹层里勾选一个或多个标签，收稿箱就只显示带这些标签的投稿。还可以在这里切换「最新在前 / 最早在前」的排序。 ## 分享投稿链接 ### 投稿链接格式 ``` https://2some.one/[你的用户名]/bubblebox ``` ### 邮件投稿 你还可以提供邮件投稿地址： ``` [你的用户名]@2some.one ``` 粉丝发送邮件即可投稿，附件会自动处理并进入你的收稿箱。这个邮箱无需额外配置；想确认链路是否接通，可以先给自己的专属邮箱发一封测试邮件。详见 [邮件投稿](/docs/bubblebox/email-submission)。 ## 从 B 站评论导入投稿 如果你绑定了 B 站账号，可以把自己 B 站动态下的评论批量导入成树洞投稿，丰富展示素材。 1. 在收稿箱右侧菜单点「从 B 站评论导入」 2. 选择一条你的 B 站动态 3. 在评论列表里勾选要导入的评论（支持全选） 4. 可选：把这批投稿投到某个标签 5. 可选：勾选「审核通过后公开」 6. 确认导入 导入后，这些 B 站评论会作为新投稿进入你的收稿箱，和普通投稿一样审核、展示。 此功能需要先绑定 B 站账号。未绑定时会提示你先去绑定。 ## 稿件管理 ### 界面布局 **桌面端**采用双栏布局： - **左侧**：稿件列表面板，按月份分组 - **右侧**：稿件详情展示区 **移动端**采用列表视图： - 卡片式稿件列表 - 点击稿件打开详情抽屉 - 支持下拉刷新和无限滚动 ### 查看稿件 在稿件列表中点击任意稿件，右侧会显示： - 投稿内容全文 - 附件（图片、音视频、文档） - 互动（点赞、回复等） - AI 分析结果（开启增值审核时） ### 稿件状态 稿件有以下几种状态： | 状态 | 说明 | |------|------| | 新稿件 | 未查看的投稿 | | 已读 | 已经查看过 | | 已归档 | 已归档的投稿 | | 不适宜 | 被审核标记为不适宜内容 | ### 归档稿件 归档功能帮助你整理已处理的投稿： 1. 点击稿件上的归档按钮 2. 稿件会从默认列表隐藏 3. 切换「显示已归档」可以查看 ### 公开 / 私密 「公开」和「转发到泡泡」是两件独立的事： | 动作 | 效果 | |------|------| | **公开到个人空间** | 稿件出现在你的树洞公开信列表；可在回信时点「回复并公开」，或在分享菜单里打开「公开这封信」 | | **转发到泡泡** | 创建一条引用该信的公开 Bubble，进入首页「为你推荐」信息流；在分享菜单里操作，或打开设置「收到投稿立即转发到泡泡」 | - **公开稿件**：显示在你的树洞主页，任何人可见；**不一定**进首页 - **私密稿件**：仅你在控制台可见 - **转发到泡泡**：可附一句公开点评（不超过 500 字）作为 Bubble 正文；投稿人会收到通知 你可以随时在分享菜单里取消转发到泡泡，或关闭个人空间公开。再次转发同一稿件会沿用原来的讨论区。 ## AI 审核 所有投稿都会经过审核，分两档： ### 基础审核（免费、自动） 每条投稿都会自动经过基础审核，覆盖： - 仇恨 / 骚扰 - 色情内容 - 暴力 / 自残 - 违法内容 - 恶意脚本 命中的内容会被标记为「不适宜」，不会公开、也无法互动。 ### AI 增值审核（可开关） 在设置抽屉里可以开启「AI 增值审核」，用大语言模型做更深的内容分析，额外提供： - 政治风险识别 - 法律法规审核 - AI 内容摘要 - 情感分析 - 关键词提取 - 建议回复 | 项目 | 说明 | |------|------| | 定价 | ¥0.01 / 次 | | 扣费 | 优先消耗赠送余额；赠送余额不足时本次继续限免，不扣充值余额 | | 开关 | 数据库默认开启，可在设置里随时关闭；关闭后仅保留基础审核 | 直播间同接人数较多（约 150 人以上）时建议开启增值审核，可有效减轻舆论风险、保障直播间安全。 ## 常见问题 ### 找不到某个投稿？ 检查以下设置： 1. 标签筛选是否选中了不含该投稿的标签（可点「清除」取消筛选） 2. 是否切到了「邮箱投稿」来源筛选 3. 是否开启了「显示已归档」 4. 尝试使用搜索功能 ### 投稿显示「不适宜」怎么办？ 审核可能会误判。你可以： 1. 点击查看投稿详情 2. 如果内容没有问题，手动取消标记 3. 将稿件设为公开 ### 如何分享投稿给观众？ 1. 设置稿件为「公开」 2. 复制稿件链接：`/[用户名]/bubblebox/post/[稿件ID]` 3. 分享给观众 --- ## 浏览与展示 URL: https://2some.ren/docs/bubblebox/display 描述: OBS 实时展示、绿幕抠图和显示设置 # 浏览与展示 本文档介绍如何在直播中展示投稿内容，以及各种显示设置选项。 ## 在直播中展示稿件 泡泡树洞通过 OBS 实时同步在直播画面里展示稿件。基本流程： 1. 在收稿箱列表里**点选某条稿件**，它就成为当前展示内容 2. OBS 浏览器源会实时同步显示这条稿件（见下方「OBS 实时展示」） 3. 在后台切换到另一条稿件，OBS 画面自动跟着更新 不需要单独的「投放」按钮——你在后台选中哪条，OBS 就展示哪条。 ## OBS 实时展示 这是直播读稿的核心功能：生成一条专属的 OBS 浏览器源链接，把后台展示区实时推到直播画面，干净专业，远比「窗口捕获整个后台」可控。 ### 设置步骤 1. 在收稿箱顶部点「OBS」按钮，打开「OBS 实时展示」弹窗 2. 点「一键创建」生成专属 API Key（用于验证身份，确保只有你能推送内容到你的画面） 3. 复制弹窗里的**专属链接** 4. 打开 OBS，添加一个「浏览器」源，把链接粘到 URL 栏，宽度建议 **1920**、高度 **1080** 5. 回到后台，正常切换稿件，OBS 画面就实时同步 ### 读稿进度同步 在后台展示区点击文字任意位置，即可标记阅读进度。OBS 画面会实时同步： - 已读部分自动变灰 - 当前阅读位置自动滚动到画面中央 非常适合边读边展示的直播场景。 请勿在 OBS 中裁剪此浏览器源，否则阅读进度滚动可能产生偏差、内容也可能显示不全。需要调整画面大小时，直接改浏览器源的宽度和高度。 ### 显示参数 在 OBS 弹窗里可以为这条链接单独设置（改完链接自动更新）： | 参数 | 说明 | |------|------| | 字体 | 12 种字体任选（见下方「字体选择」） | | 字号 | 20 / 25 / 30 / 35 / 40 / 50 / 60 px | | 对齐方式 | 左对齐 / 居中 / 右对齐 | | 文字颜色 | 自定义颜色，默认跟随主题 | | 绿幕模式 | 把背景变绿便于抠图（支持全屏绿幕） | ### 只展示图片附件 OBS 画面**仅展示稿件里的图片附件**。音频、视频、文档等不会在 OBS 中显示。需要展示这些文件时，可在后台下载附件后，用 OBS 的「媒体源」或「窗口捕获」单独展示。 ### 密钥管理 - 如怀疑链接里的 API Key 泄露，点「重新生成」即可撤销旧密钥、生成新链接（重新生成后要在 OBS 里更新链接） - 在「设置 → API Key」可查看、删除所有密钥 ## 显示设置 下面这些在收稿箱设置抽屉（齿轮图标）里调整，作用于后台展示区。 ### 字体选择 支持 12 种字体： | 字体名称 | 风格 | |---------|------| | 霞鹜文楷 | 楷书风格，优雅文艺 | | 霞鹜漫黑 | 手写马克笔黑体，活泼 | | 霞鹜新致宋 | 现代宋体，清秀 | | 得意黑 | 倾斜创意黑体，个性鲜明 | | 思源屏显臻宋 | 适配屏显的宋体，正式 | | 汇文明朝体 | 明朝体，典雅 | | 曉聲通秋茄 | 风格化书法字体 | | 黄令东齐伋体 | 仿古活字风格 | | 精品点阵体 | 像素点阵，复古 | | 拼音鼎楷 | 带拼音标注的楷体 | | Maple Mono | 等宽英文，代码风格 | | 系统默认 | 使用系统字体 | ### 字体大小 在设置抽屉用 `+` / `-` 按钮调整展示区文字大小。 ### 加载背景 提供 20 多种加载动画背景（宇航员、火箭升空、北极牛、交通灯等），在切换稿件时显示过渡效果。 ## OBS 绿幕模式 绿幕用于在 OBS 里把背景抠掉，只留文字浮在直播画面上。 ### 启用绿幕 在设置抽屉里打开「绿幕模式」开关： 1. 背景变为纯绿色（**#22ff39**） 2. 文字显示在绿色背景上 3. 方便在 OBS 中用色度键抠图 还可以打开「全屏绿幕」，让整个展示区域都变绿，便于完整捕获。 ### OBS 色度键配置 在 OBS 里给浏览器源加滤镜： 1. 右键源 → 滤镜 2. 添加「色度键」滤镜 3. 关键色选自定义颜色，填 **#22ff39** 4. 调整相似度和平滑度 ## 特效动画 ### Emoji 动效 展示稿件时可以启用 Emoji 动效，增加趣味性。 ### 撒花效果 特定场景下会触发撒花动画效果。 ## 弹幕面板 ### 开启弹幕 点收稿箱顶部的「弹幕」按钮开启弹幕面板。 ### 弹幕同步 弹幕监听依赖 **2SOMEone 浏览器扩展** + **绑定的 B 站直播间**： - 弹幕由扩展从你的直播间长连接里抓取，并非服务端自动抓取 - 系统默认暂存当前展示稿件收到的普通弹幕和醒目留言 - 稿件转发到泡泡后，暂存内容会自动成为回复，后续弹幕继续直接加入讨论 - 如需关闭，在页面右上角「设置」中关闭「转发时同步直播弹幕」 因为依赖浏览器扩展，弹幕功能需要在能装扩展的桌面浏览器里使用。 ### 弹幕显示 弹幕面板实时显示直播间弹幕内容、发送者昵称和发送时间，并会自动去重。 ## 公开稿件浏览 ### 树洞主页 每位主播的公开稿件可以在树洞主页浏览： ``` https://2some.one/[用户名]/bubblebox ``` 页面展示公开的投稿列表，点击卡片可以预览或查看详情。 ### 稿件详情页 每个公开投稿都有独立的详情页面： ``` https://2some.one/[用户名]/bubblebox/post/[稿件ID] ``` 详情页可以查看完整内容并参与互动（见 [参与互动](/docs/bubblebox/interactions)）。 ## 常见问题 ### OBS 抠图有残影怎么办？ 1. 检查绿幕是否为纯绿色（#22ff39） 2. 在 OBS 色度键里把相似度 / 平滑度调到合适 3. 确保浏览器页面没有其他元素遮挡 ### 字体加载很慢？ 中文字体文件较大，首次加载可能需要几秒钟。字体会被浏览器缓存，后续加载更快。 ### 弹幕同步不工作？ 按顺序检查： 1. 是否已安装 **2SOMEone 浏览器扩展** 2. 是否已绑定 B 站直播间 3. 直播间是否正在直播 4. 右上角「设置」里的「转发时同步直播弹幕」是否开启 --- ## 邮件投稿 URL: https://2some.ren/docs/bubblebox/email-submission 描述: 通过邮件向主播投稿 # 邮件投稿 除了网页投稿，泡泡树洞还支持通过邮件投稿。主播不需要额外配置，用户名就是专属投稿邮箱；观众发出邮件后，内容会进入主播的收稿箱。 ## 邮件地址 每位主播都有专属的投稿邮箱： ``` [用户名]@2some.one ``` 例如，用户名为 `harry` 的主播，投稿邮箱为： ``` harry@2some.one ``` 给自己的专属投稿邮箱发一封测试邮件。如果你在收稿箱看到这条稿件，就说明邮箱收稿已经接通。 ## 如何投稿 ### 基本投稿 1. 打开你的邮箱客户端 2. 收件人填写主播的投稿邮箱 3. 邮件正文填写投稿内容 4. 发送邮件 ### 带附件投稿 邮件投稿支持附件： 1. 在邮件中添加附件 2. 支持图片、音频、视频、文档 3. 附件会自动处理并保存 邮件主题（Subject）会被忽略，投稿内容以邮件正文为准。 ## 支持的附件格式 | 类型 | 格式 | |------|------| | 图片 | JPG、PNG、GIF、WebP、AVIF、HEIC | | 音频 | MP3、AAC、M4A、OGG、WebM | | 视频 | MP4、MOV、WebM | | 文档 | PDF、Word、Excel、PPT、RTF、EPUB、TXT、Markdown、CSV 等 | 附件大小为平台固定上限：单条投稿最多 9 个附件，图片单个不超过 30MB，音视频 / 文档单个不超过 200MB。 ## 投稿规则 ### 内容限制 - 与网页投稿相同，最多 10,000 字符 - 会经过 AI 内容审核 - 不适宜内容会被标记 ### 权限要求 邮件投稿默认使用 Level 0（匿名投稿）权限： - 无需登录账号 - 投稿人身份匿名 - 仅记录发件邮箱地址 邮件投稿自带发件人邮箱，服务端会按已验证邮件来源处理，不受网页投稿 Level 1 / Level 2 门槛影响。 ### 公开策略 邮件投稿创建后先进入审核；审核通过后是否公开，由主播在 Bubblebox 设置里的发布策略决定。如果需要在投稿时明确选择公开或私密，建议使用网页投稿。 ## 投稿确认 发送邮件后： 1. 系统会自动处理邮件内容 2. 创建投稿记录并送入主播收稿箱 3. 平台不额外发送确认回信 是否公开取决于主播的 Bubblebox 设置。如果主播策略允许公开，审核通过后可在公开投稿页面看到。 ## 适用场景 邮件投稿适合以下场景： - **移动端投稿**：手机上发邮件比打开网页更方便 - **长文投稿**：在邮件客户端编辑长文更舒适 - **附件投稿**：直接转发包含附件的邮件 - **定时投稿**：使用邮件定时发送功能 ## 注意事项 ### 邮箱验证 为防止滥用，系统可能会验证发件邮箱的有效性。 ### 垃圾邮件过滤 如果你的邮件被当作垃圾邮件，可能不会被正常接收。建议： - 使用正规邮箱服务商 - 避免在邮件中包含可疑链接 - 邮件内容不要过于简短 ### 回复邮件 平台不会自动回信。主播是否单独回复，取决于主播自己的处理方式。 ## 常见问题 ### 投稿后没有看到我的内容？ 可能的原因： 1. 稿件还未被主播设为公开 2. 内容被审核标记为不适宜 3. 邮件被系统过滤 ### 可以用企业邮箱投稿吗？ 可以。任何有效的邮箱地址都可以用于投稿。 ### 投稿后可以撤回吗？ 与网页投稿相同，匿名投稿一旦发送无法撤回。如需删除，请联系主播处理。 --- ## 快速开始 URL: https://2some.ren/docs/bubblebox 描述: 快速了解如何创建和使用泡泡树洞 # 快速开始 泡泡树洞是一个匿名投稿收集系统，让粉丝可以向主播投递消息，主播在控制台里管理、回复，并在直播中展示。 ## 开始收稿 1. [登录](/docs/account/login-register) 2SOMEone 账号 2. 进入「控制台」→「泡泡树洞」→「收稿箱」 3. 把投稿链接复制分享给粉丝 4. （可选）点设置图标调整投稿权限、公开方式等账号级设置 你的投稿链接格式为： ``` https://2some.one/[你的用户名]/bubblebox ``` 新用户注册后即可直接收稿，无需额外配置。投稿权限默认是「匿名」，任何人都能投。 ## 查看和管理投稿 收到投稿后，在「控制台」→「泡泡树洞」→「收稿箱」中查看： - **桌面端**：左侧列表选择稿件，右侧查看详情 - **移动端**：卡片列表，点击打开详情抽屉 支持的操作： - 归档已处理的投稿 - 设为公开 / 私密 - 在直播中展示（OBS 实时同步） - 查看互动和反应 ## 了解更多 ### 核心功能 | 功能 | 说明 | |------|------| | [投稿功能](/docs/bubblebox/submission) | 粉丝如何投稿、附件上传、匿名性说明 | | [如何收稿](/docs/bubblebox/collecting) | 标签管理、稿件管理、AI 审核、从 B 站评论导入 | | [浏览与展示](/docs/bubblebox/display) | OBS 实时展示、绿幕、字体设置、弹幕同步 | | [参与互动](/docs/bubblebox/interactions) | 回复、转发、点赞点踩、举报拉黑 | | [权限系统](/docs/bubblebox/permissions) | 三级投稿权限详解 | ### 更多功能 | 功能 | 说明 | |------|------| | [邮件投稿](/docs/bubblebox/email-submission) | 通过邮件投稿、附件处理 | | [通知与短信提醒](/docs/bubblebox/notifications) | 新投稿、投稿公开、投稿回复等提醒设置 | --- ## 参与互动 URL: https://2some.ren/docs/bubblebox/interactions 描述: 回复、转发、点赞点踩，以及举报拉黑 # 参与互动 公开的稿件可以像一条社区动态（Bubble）一样被互动：登录用户可以回复、转发、点赞点踩。 只有**已公开**的稿件才有互动区。还没公开的稿件会提示「此稿件尚未公开，公开后可与读者互动」。被标记为「不适宜」的稿件不会公开，也无法互动。 ## 回复 公开稿件的详情页有讨论区，登录用户可以发表回复： 1. 打开公开稿件的详情页 2. 在底部输入框填写回复内容 3. 点击发送 回复规则： - 需要登录账号 - 单条回复最多 **500 字** - 不允许发送空白内容 - 同一稿件可以发表多条回复 ## 转发 登录用户可以把公开稿件转发出去，分享给更多人看到。 ## 反应系统 ### 反应类型 稿件和回复都支持三种反应： | 反应 | 含义 | |------|------| | 点赞 | 表示喜欢、支持 | | 点踩 | 表示不喜欢 | | 疑问 | 表示疑惑、觉得抽象 | ### 反应规则 - **互斥关系**：点赞和点踩互斥，选其中一个会取消另一个 - **独立关系**：疑问与点赞 / 点踩独立，可以同时存在 - **可取消**：再次点击同一反应即可取消 例如： 1. 点击点赞 → 获得一个点赞 2. 点击点踩 → 点赞被取消，获得一个点踩 3. 点击疑问 → 同时有点踩和疑问 4. 再次点击疑问 → 疑问被取消 ### 反应对象 可以对以下内容反应： - **稿件**：对整条稿件表达态度 - **回复**：对单条回复表达态度 ### 洞主反应 洞主（收稿人 / 主播）对稿件的反应会有特殊标识，在详情页特别显示，表示主播本人喜欢这条稿件。 ## 弹幕同步 主播展示稿件时，系统会默认暂存这段时间收到的普通弹幕和醒目留言。稿件转发到泡泡后，这些内容会自动成为该 Bubble 的回复；转发后收到的新弹幕会继续直接加入讨论。 - 弹幕由 **2SOMEone 浏览器扩展**从绑定的 B 站直播间抓取 - 功能默认开启，不需要在弹幕面板手动打开 - 如需关闭，在收稿后台右上角「设置」中关闭「转发时同步直播弹幕」 - 弹幕会自动去重，避免重复记录 详细设置见 [浏览与展示](/docs/bubblebox/display) 的「弹幕面板」。 ## 举报与拉黑 为了保障安全，所有用户都可以对内容采取处置： | 操作 | 效果 | |------|------| | 举报稿件 / 回复 | 举报后，该内容对你自己隐藏；同时进入平台合规处理流程 | | 拉黑用户 | 双向生效，你和对方互相看不到对方的稿件 | 举报和拉黑入口在稿件 / 回复的操作菜单里。 ## 反应统计 每条稿件会显示汇总的反应统计（点赞、点踩、疑问、回复数）。详情页还会显示稿件和全部回复的反应总和，帮助了解整体互动热度。 ## 登录要求 | 操作 | 是否需要登录 | |------|-------------| | 查看公开稿件 | 否 | | 查看回复 | 否 | | 点赞 / 点踩 / 疑问 | 是 | | 发表回复 | 是 | | 转发 | 是 | ## 常见问题 ### 为什么我的反应没有显示？ 可能的原因： 1. 网络延迟，稍等片刻刷新页面 2. 稿件已被删除或设为私密 3. 需要登录账号才能反应 ### 我可以看到谁给我的稿件点赞吗？ 反应数量公开可见，但具体名单不对外展示。 ### 为什么有的稿件不能回复？ 只有已公开的稿件才有互动区。还没公开、或被标记为「不适宜」的稿件无法回复。 --- ## 通知与短信提醒 URL: https://2some.ren/docs/bubblebox/notifications 描述: BubbleBox 各类提醒的开关、短信策略与计费 # 通知与短信提醒 泡泡树洞会按你的设置走多个通道提醒你：移动端推送、桌面端推送、网页通知、站内消息，以及部分类目可选的**手机短信**。短信通道有独立的发送策略和计费规则，本文重点讲它。 ## 泡泡树洞通知类目 在「设置」→「通知」的「BubbleBox」分组下，目前已上线这些类目： | 类目 | 触发 | 通道 | |------|------|------| | **收到新投稿** | 你收到一条新投稿 | 推送 / 网页 / 站内信，可选短信（¥0.1/条）| | **重要收稿提醒** | 长时间未上线后又收到新投稿，提醒你回来处理 | 仅短信，**免费**，默认开启 | | **投稿公开** | 你投出的稿件被收稿人公开 | 推送 / 网页 / 站内信 | | **投稿回复** | 你投出的稿件收到回复 | 推送 / 网页 / 站内信 | 「收到新投稿」「重要收稿提醒」是给**收稿人**的；「投稿公开」「投稿回复」是给**投稿人**的。下面的短信策略与计费主要针对会发短信的两个类目。 ## 开启位置 1. 登录 2SOMEone 2. 进入「控制台」→「设置」→「通知」 3. 找到「BubbleBox」分组下的「**收到新投稿**」 4. 在「短信」列选择你想要的策略 要收到短信，账号必须**绑定有效的手机号**。短信接收方默认走当前账号的手机号，无法另填收件号码。 ## 短信策略 | 选项 | 含义 | |------|------| | **默认不通知** | 这一类消息完全不发短信（默认值）| | **每天前 3 篇** | 每个自然日（按你的时区）最多 3 条；超出当天的不再发 | | **全部通知** | 每条符合条件的新投稿都发送短信 | 「每天前 3 篇」适合既想第一时间被叫醒、又不想被刷屏的主播；「全部通知」适合稿件量本来就少、希望任何一条都不漏的场景。 ## 计费 | 项目 | 价格 | |------|------| | 短信发送 | **¥0.1 / 条** | 要点： - 按**实际发出**的短信条数扣费；被策略跳过（如当天前 3 条额度已满）的不扣费 - 余额不足时**自动跳过发送**，不会让短信失败也不会扣到负数 - 同一稿件 / 同一收稿人短时间内不会重复发，幂等去重由系统自动处理 - 短信单价由阿里云短信通道结算，固定 ¥0.1 / 条，不享受礼兮限免 ## 收不到短信？ 按顺序排查： 1. **手机号是否绑定且生效**：进入「设置」→「账号」→ 检查手机号是否绑定成功 2. **当前选了哪种策略**：在「设置」→「通知」→ BubbleBox 收到新投稿 → 短信，确认不是「默认不通知」 3. **当天额度是否用完**：选「每天前 3 篇」时，超过 3 条的就不发了 4. **余额是否不足**：余额低于 ¥0.1 时整条短信会被跳过 5. **运营商拦截**：极少数情况运营商会拦截，可尝试将「致唯网络」加入白名单 「重要收稿提醒」是独立的免费短信类目（默认开启），用于长时间未上线后召回你处理新投稿，如不需要可在通知设置里单独关闭。 ## 隐私 - 短信只包含「你收到一条新投稿」类的简短提示，不会把投稿正文写进短信 - 短信通道的发送记录写入 `NotificationDeliveryLog`，与稿件内容物理隔离 - 短信收件号码不会暴露给第三方，仅用于本次短信下发 --- ## 权限系统 URL: https://2some.ren/docs/bubblebox/permissions 描述: 泡泡树洞的投稿权限等级详解 # 权限系统 泡泡树洞采用分级权限系统，主播可以根据需要设置不同的投稿门槛，在保护隐私和防止滥用之间取得平衡。投稿权限是**账号级的全局设置**，对你收到的所有投稿统一生效。 ## 权限等级 ### Level 0：匿名投稿 最开放的投稿模式，任何人都可以投稿。 | 项目 | 说明 | |------|------| | 登录要求 | 无需登录 | | 身份记录 | 仅记录 IP 地址 | | 适用场景 | 完全匿名的意见收集、轻松互动 | **特点**： - 投稿人身份完全匿名 - 主播无法知道投稿者是谁 - 仅通过 IP 地址进行基本的防滥用 虽然不强制，但建议投稿者填写邮箱地址，以便主播在需要时联系你。邮箱信息仅主播可见。 --- ### Level 1：注册用户 需要登录 2SOMEone 账号才能投稿。 | 项目 | 说明 | |------|------| | 登录要求 | 需要登录账号 | | 身份记录 | 记录账号 ID | | 适用场景 | 需要一定信任度的互动 | **特点**： - 投稿关联账号，主播可以看到投稿者信息 - 可以追溯投稿历史 - 适合需要持续互动的场景 **如何满足要求**： 1. 访问 [注册页面](/docs/account/login-register) 2. 使用邮箱、手机号或抖音注册 3. 完成注册后登录即可投稿 --- ### Level 2：绑定用户 最严格的投稿模式，需要绑定第三方账号验证身份。 | 项目 | 说明 | |------|------| | 登录要求 | 需要登录账号 | | 绑定要求 | B 站、抖音、手机号任选其一 | | 适用场景 | 防止小号滥用、重要互动 | **特点**： - 确保投稿者有真实的社交身份 - 有效防止恶意投稿和刷屏 - 适合主播粉丝专属互动 **支持的绑定方式**： | 绑定方式 | 验证方法 | |---------|----------| | B 站 | 发送弹幕验证码验证 | | 抖音 | 授权登录验证 | | 手机号 | 短信验证码验证 | 只需完成**任意一项**绑定即可满足 Level 2 要求。 --- ## 权限验证流程 当用户访问投稿页面时，系统会自动检查权限： ``` 1. 获取收稿人设置的投稿权限等级 2. 检查用户当前状态 ├── 未登录 → 仅允许 Level 0 ├── 已登录无绑定 → 允许 Level 0、1 └── 已登录有绑定 → 允许 Level 0、1、2 3. 返回验证结果 ├── 通过 → 显示投稿表单 └── 不通过 → 显示缺失要求和引导 ``` ## 主播设置权限 ### 设置方法 1. 进入控制台 →「泡泡树洞」→「收稿箱」 2. 点顶部的设置图标打开设置抽屉 3. 在「投稿权限」里三选一：匿名（Level 0）/ 注册（Level 1）/ 绑定（Level 2） 4. 选择后立即生效，无需保存 任意主播都可以直接切换三个等级，**没有任何资质、充值或审核门槛**。 ## 权限对照表 | 功能 | Level 0 | Level 1 | Level 2 | |------|:-------:|:-------:|:-------:| | 匿名投稿 | ✅ | ❌ | ❌ | | 实名投稿 | ❌ | ✅ | ✅ | | 身份可追溯 | ❌ | ✅ | ✅ | | 第三方验证 | ❌ | ❌ | ✅ | | 防小号滥用 | ❌ | ❌ | ✅ | ## 选择建议 ### 何时使用 Level 0 - 想要收集完全匿名的反馈 - 希望降低投稿门槛，增加互动量 - 对投稿内容的敏感度要求不高 ### 何时使用 Level 1 - 希望知道投稿者是谁 - 需要建立持续的互动关系 - 想要追溯用户的投稿历史 ### 何时使用 Level 2 - 防止恶意用户使用小号骚扰 - 重要的粉丝专属活动 - 需要确保投稿者的真实身份 ## 常见问题 ### 我满足了权限要求但仍无法投稿？ 可能的原因： 1. **登录状态过期**：尝试重新登录 2. **绑定未完成**：检查账号设置中的绑定状态 3. **缓存问题**：刷新页面重试 ### Level 0 的匿名是真的匿名吗？ 是的。Level 0 不会记录你的账号信息，主播无法知道你是谁。但系统会记录 IP 地址用于防滥用（如封禁恶意 IP）。 ### 我的 B 站账号被封了，还能满足 Level 2 吗？ 可以。Level 2 只需要满足**任意一项**绑定： - B 站绑定 - 抖音绑定 - 手机号绑定 如果 B 站账号有问题，可以使用抖音或手机号验证。 ### 主播可以看到我的绑定信息吗？ 部分可见： - **B 站**：主播可以看到你的 B 站 UID - **抖音**：主播可以看到你的抖音昵称 - **手机号**：主播**不能**看到你的手机号 ### 为什么要设置权限门槛？ 权限系统的设计目的： 1. **保护主播**：防止恶意投稿、骚扰、刷屏 2. **提升质量**：有门槛的投稿通常更有价值 3. **平衡体验**：主播可以根据需要灵活选择 --- ## 投稿功能 URL: https://2some.ren/docs/bubblebox/submission 描述: 了解如何向主播的泡泡树洞投递匿名或实名消息 # 投稿功能 本文档介绍如何使用泡泡树洞的投稿功能，向你喜爱的主播发送匿名或实名消息。 ## 访问投稿页面 每位主播的泡泡树洞都有专属链接： ``` https://2some.one/[用户名]/bubblebox ``` 例如，访问用户名为 `harry` 的主播树洞：`https://2some.one/harry/bubblebox` ## 投稿流程 ### 1. 填写内容 在投稿表单中填写你想说的话： - **内容限制**：最多 10,000 字符，且不能是纯数字 - **附件支持**：可上传图片、音频、视频、文档（见下方「附件上传」） - **草稿保存**：内容会自动保存到本地，7 天内有效 如果你意外关闭了页面，下次打开时可以恢复之前的草稿。 不知道写什么？表单上方有一排灵感起手（如「我一直想问你：」「用三个词形容我」），点一下就把开头填进输入框，治空白页焦虑。 ### 2. （可选）打标签 主播可能设置了一些标签，用于给投稿分类，例如： - 日常交流 - 点歌 - 建议反馈 - 悄悄话 你可以勾选一个或多个合适的标签。**标签是可选的，不选也能正常投稿。** ### 3. 选择公开方式 如果主播允许投稿人选择，你可以决定这条投稿被审核通过后是公开还是私密。主播也可能把策略设为「仅私密」或「仅公开」，这时你看不到选择。 ### 4. 完成安全验证（仅未登录时） - **未登录匿名投稿**：提交时会自动完成一次安全验证（工作量证明式，无需手动输入验证码），防止机器刷量 - **已登录用户**：凭登录状态自动通过，无需任何验证 ### 5. 提交投稿 点击提交后： 1. 完成安全验证（未登录时自动进行） 2. 系统检查短时间内（约 5 分钟）是否有近似重复内容，避免误重发 3. 创建投稿记录 4. 后台进行内容审核 5. 投稿成功，等待主播查看 ## 附件上传 ### 数量与大小 附件大小是平台固定上限，与主播设置无关： | 项目 | 限制 | |------|------| | 单条投稿附件数 | 最多 9 个 | | 图片 | 单个不超过 30MB | | 音频 / 视频 / 文档 | 单个不超过 200MB | 未登录的匿名投稿**只能上传图片**。要上传音视频或文档，请先登录。 ### 支持的格式 | 类型 | 格式 | |------|------| | 图片 | JPG、PNG、GIF、WebP、AVIF、HEIC | | 音频 | MP3、AAC、M4A、OGG、WebM | | 视频 | MP4、MOV、WebM | | 文档 | PDF、Word、Excel、PPT、RTF、EPUB、TXT、Markdown、CSV 等 | 附件存储在安全的私有存储桶中，仅主播可以查看。 ## 匿名性说明 ### 实名 / 匿名开关 登录用户在投稿时可以自行选择**实名或匿名**（默认匿名）： - **匿名提交**：主播看不到你的身份，但你仍能收到投稿被公开 / 回复的通知 - **实名提交**：投稿关联你的账号，主播可以看到你的用户信息，有助于建立持续互动 投稿权限等级只决定「谁能投」（见 [权限系统](/docs/bubblebox/permissions)），不强制公开身份。 ### 完全匿名（未登录） - 不会记录你的账号信息 - 仅记录投稿人 IP（用于防滥用） - 主播无法知道你的身份 即使匿名投稿，也建议你填写邮箱地址，方便主播在必要时联系你。邮箱信息仅主播可见。 ## 投稿成功之后 投稿成功页上还可以： - 把主播的提问箱做成**分享卡片**，转发到群里或社交平台，拉更多人来匿名提问 - 生成一张「提问足迹」报告卡 - 关注这位收稿人、加入 TA 的粉丝群 如果投稿内容触及自伤 / 自我伤害等信号，投稿成功页会温和地附上一张心理求助资源卡片。这不会拦截你的投稿，只是想在需要时递上一份帮助。 ## 查看投稿状态 ### 在「已发送」里查看 登录用户可以在「控制台」→「泡泡树洞」→「已发送」里，查看自己向各位主播投出的稿件，以及是否被公开 / 回复。 ### 公开稿件 如果主播将你的投稿设为公开，你可以在主播的树洞主页看到： ``` https://2some.one/[用户名]/bubblebox ``` ### 稿件详情页 每个公开投稿都有独立的详情页面： ``` https://2some.one/[用户名]/bubblebox/post/[稿件ID] ``` 在详情页你可以查看完整内容，并参与互动（见 [参与互动](/docs/bubblebox/interactions)）。 ## 常见问题 ### 投稿失败怎么办？ 常见原因： 1. **安全验证失败**：点击按钮重试（未登录时才需要验证） 2. **内容重复**：短时间内投了近似重复的内容，会被拦截 3. **权限不足**：检查是否需要登录或绑定账号 4. **内容过长 / 纯数字**：控制在 10,000 字符以内，且不能只填数字 ### 可以删除已提交的投稿吗？ 匿名投稿一旦提交无法由投稿人删除。如有特殊需求，请联系主播处理。 ### 投稿会被审核吗？ 是的，所有投稿都会经过自动审核。不适宜的内容可能会被标记，主播可以选择是否显示。 --- ## 创作者数据（已下线） URL: https://2some.ren/docs/characters/analytics 描述: 旧 AI 角色创作者数据功能的下线说明 # 创作者数据（已下线） 旧 AI 角色创作者数据功能已经下线，原控制台数据入口不再可用。 本页以下内容为历史资料，不代表当前产品能力。 看板分三块：顶部汇总指标卡、中部逐角色表格、底部最近反馈。 ## 汇总指标 顶部指标卡汇总你全部角色的整体表现： | 指标 | 含义 | |------|------| | 已上线角色 | 机审通过数 / 全部设定稿数 | | 曝光 | 最近 30 天角色在列表里被看到的次数 | | 详情访问 | 最近 30 天公开详情页访问次数 | | 开聊数 | 用户与角色建立的私聊数 | | AI 回复数 | 正常 AI 回复定版后的累计条数 | | 扣费 Credit | 带角色标记的 AI 回复扣费总额 | | 平均 Credit / 回复 | 已归因扣费回复的平均扣费 | | 复聊率 | 近 30 天「跨天还回来发言」的会话占比 | | 平均 AI 回复 / 开聊 | 由开聊数和回复数计算 | | 收藏数 | 用户收藏总数 | | 反馈数 | 用户开聊后留下的评价数 | | 平均评分 | 按真实反馈聚合的平均星级 | ## 逐角色表格 中部表格按 AI 回复数排序，逐行对比每个角色。除了上面的指标，还会标出每个角色的**状态**（草稿 / 待复核 / 机审通过 / 未通过）和**可见性**（私有 / 仅链接 / 广场展示），以及该角色的「7 日热度」。点角色名可以直接跳到编辑页。 看板只展示已经有可信写入源的指标。还没有可信数据源的口径不会被伪造展示，会单独列在「待接入的数据口径」里。 ## 最近反馈 底部展示用户主动填写的**文字反馈**（带星级），帮你了解角色哪里好、哪里要改。只展示文字内容和评分，**不展示用户身份**。 --- ## 开聊与玩法（已下线） URL: https://2some.ren/docs/characters/chat 描述: 旧 AI 角色聊天功能的下线说明 # 开聊与玩法（已下线） 旧角色广场和 AI 角色聊天功能已经下线，不再提供开聊、收藏或评价入口。 本页以下内容为历史资料，不代表当前产品能力。 ## 开始聊天 角色详情页有几种开聊方式： 1. **直接开聊**：点「开始聊天」。如果角色有多个备用开场，会随机选一个开局。 2. **接一句**：从「接话示例」里选一句直接发送，角色会接着当前开场往下聊。 3. **自己开口**：在输入框里写第一句再发。 开聊后会进入一段一对一的私聊。角色会**先开口**（开场白是会话第一条消息），你接着聊就行。 首次使用 AI 角色需要先确认已满 18 岁并同意用户协议，详见 [使用须知](/docs/characters/compliance)。 ## 按条计费 和 AI 角色聊天，**每一条 AI 回复**都会按当前模型的价格消耗积分。角色详情页和聊天页都会显示当前模型的「每条回复价格」。价格为「免费」的模型不扣费。余额相关说明见 [账号与计费](/docs/billing)。 ## 收藏角色 喜欢的角色可以**收藏**，方便之后在广场「最近聊过」或个人收藏里快速回访。收藏数也会显示在角色详情页。 ## 评价角色 你可以给角色打 **1-5 星**并写一段文字评价（评论最多 **500 字**）。 评价需要你**已经和这个角色开始过聊天**才能提交。这样保证评分来自真实体验。你的评分和文字反馈会进入创作者的数据看板（不展示你的身份）。 ## 聊天中的玩法 进入和 AI 角色的私聊后，下面这些控制项都按**单段聊天**生效，互不影响别的会话。 ### 切换回复模型 同一个角色可以换不同的回复模型聊。每个模型有自己的名称、档位和**每条回复价格**，切换后按新模型计费。想要更强的效果，或者想省积分，都可以在这里调。 ### 我的设定（让角色按你的身份互动） 你可以在这段聊天里设置「**我的设定**」（最多 **1200 字**），告诉角色「我是谁」——你的身份、背景、和角色的关系。设好之后，角色会按你设定的身份和你互动。这个设定只对当前这段聊天生效。 ### 聊天记忆 聊得久了，系统会自动把前面的对话滚动总结成「**聊天记忆**」，帮角色记住关键信息。你可以： - **查看**当前的记忆摘要。 - **清除**记忆，让角色「忘记」之前的内容。清除后旧消息在聊天里仍然能往上翻看到，只是角色不再据此回应。 ### 重新开始 / 清空 想换个开局，有两种方式： | 方式 | 效果 | 能否恢复 | |------|------|----------| | 重新开始 | 历史消息保留可见，但角色不再记得它们；重发一条新开场 | 历史还在 | | 清空 | 彻底删除聊天记录后重开，重发一条新开场 | **不可恢复** | 两种都会让角色重新发一条开场（在开场白和备用开场里随机选）。 「清空」会永久删除这段聊天的消息记录，无法找回，操作前请想清楚。重新开始 / 清空都有频率限制（5 分钟内最多 10 次）。 ### 换个回答 对角色的某条回复不满意，可以点「**换个回答**」让它重新生成。还能指定方向： | 方向 | 效果 | |------|------| | 更温柔 | 语气更柔和 | | 更长 | 回复更长更展开 | | 更有剧情 | 更推进情节 | | 更像角色 | 更贴合人设 | 换个回答有频率限制（5 分钟内最多 20 次）。 --- ## 使用须知（已下线） URL: https://2some.ren/docs/characters/compliance 描述: 旧 AI 角色功能的历史合规说明 # 使用须知（已下线） 本页对应的旧 AI 角色聊天功能已经永久下线。以下内容仅保留为历史合规记录，不代表当前可用功能。 ## 历史合规规则 该功能运行期间曾要求用户确认以下事项： - 本功能由人工智能生成内容，**角色并非真人**。 - 平台托管的 AI 角色**不会把你的私聊交给第三方角色创作者**。 - 仅向成年人提供，点击确认即表示你**已年满 18 周岁**。 - 请勿沉迷，注意休息。 ## 历史内容说明 角色对话内容由人工智能生成，不代表角色原型或角色创作者本人。相关内容不应被当作医疗、法律、财务等专业意见。 ## 历史隐私规则 平台托管 AI 角色的一对一私聊不会被提供给第三方角色创作者。创作者过去只能看到聚合数据，以及用户主动留下的不含身份的文字评价。 ## 历史防沉迷规则 连续使用一段时间后，系统曾显示休息提醒。这项功能已随旧 AI 角色产品一同下线。 --- ## 创建角色（已下线） URL: https://2some.ren/docs/characters/create 描述: 旧 AI 角色创建功能的下线说明 # 创建角色（已下线） 旧 AI 角色创建、发布和角色广场功能已经下线，原控制台入口不再可用。 本页以下内容为历史资料，不代表当前产品能力。 编辑器左边是设定字段，右边实时预览角色的开场和接话示例。你有三种起步方式：从零写、套模板、或导入已有角色卡。 ## 三种起步方式 ### 一、AI 辅助生成（一句话 → 完整草稿） 最快的方式。在「AI 辅助生成」卡片里写一句角色想法（**至少 8 个字**，比如写清关系、场景或语气），AI 会自动生成一整套可编辑草稿：名称、一句话介绍、开场白、描述、性格、场景、系统提示词、示例对话、备用开场、接话示例、标签和语言。 生成出来的内容是**草稿**，可以随便改。 AI 辅助生成每天最多用 **20 次**。生成的角色必须是虚构或泛化身份，不能冒充真人、官方人员，也不能声称自己是医疗 / 法律 / 财务专业人士。 ### 二、套用快速模板 不想从零开始，可以从三套模板里选一个起步，再按自己的角色微调： | 模板 | 适合 | |------|------| | 陪伴倾听 | 日常聊天、情绪陪伴、长期关系 | | 剧情冒险 | 多轮角色扮演、探索、任务推进 | | 学习教练 | 陪用户拆任务、复盘、建立节奏 | ### 三、导入酒馆卡（TavernCardV2） 如果你已经有业界通用的酒馆角色卡，可以直接导入，不用重写： - **粘贴 JSON**：把 TavernCardV2 的 JSON 粘进去（内容需要包含 `data` 字段）。 - **选择 PNG**：上传内嵌角色元数据的酒馆卡 PNG，系统会读出里面的角色信息。 导入只更新角色的**文字设定和标签**，不会自动保存或发布，导入后请检查预览再保存。 ## 角色字段说明 一张角色卡分「基础信息」和「高级设定」。下面是各字段的作用： | 字段 | 作用 | |------|------| | 名称 | 聊天身份和广场标题都用这个名称 | | 一句话介绍 | 广场卡片和详情页第一眼看到，说明角色适合谁聊 | | 开场白 | 用户进聊天先看到的那句角色消息，要让用户知道怎么接话 | | 接话示例 | 写 3-5 条用户能直接发送的回复，覆盖情绪回应、行动选择、追问信息 | | 描述 | 角色背景、关系和长期行为，支撑多轮对话的一致性 | | 性格 | 约束角色的语气、价值观和反应方式 | | 场景 | 当前世界、地点和关系，让回复更贴合设定 | | 系统提示词 | 更强的行为约束，不直接展示给用户 | | 示例对话 | 给模型学习角色说话方式，建议写成 `{{user}}` 与 `{{char}}` 对话 | | 历史后指令 | 长聊之后仍要遵守的补充规则，适合写记忆和边界要求 | | 备用开场白 | 新会话可随机使用的其他开场，制造不同开局 | | 语言 | 影响广场筛选和用户对角色主要语言的预期 | | 标签 | 用于广场搜索、分类和创作者数据归因，建议 2-5 个 | 开场白、示例对话等字段里可以写 `{{char}}` 代表角色名，`{{user}}` 代表聊天的用户。展示和聊天时会自动替换成真实名字。 ## 发布检查清单 编辑器右侧有一份「发布检查」质量清单，实时给你打分，引导写出更适合发布的角色。共 7 项： 1. **角色身份清楚**：名称和一句话介绍能让用户一眼理解角色。 2. **开场能接住对话**：开场白里有场景或行动钩子。 3. **用户有接话入口**：至少 3 条接话示例。 4. **角色有稳定性格**：描述或性格设定足够支撑多轮对话。 5. **场景和边界明确**：场景或系统提示词能约束角色不出戏。 6. **有可学习的语气样本**：示例对话或备用开场提供角色说话方式。 7. **发现信息可用**：至少 2 个标签，并填写语言。 分数到「适合发布」最稳，到「可以试聊」也能先试。 ## 保存并试聊 填完后可以先**保存草稿**，然后点「试聊」直接和角色私聊——**不用先公开发布**。试聊用真实对话验证人设和开场是否到位，只有你自己能看到。 ## 发布与机审 确认角色没问题后发布。发布会走**自动内容机审**： - **机审通过**：角色获得可聊天身份，按你设置的可见性上线。 - **机审未通过**：发布会被拒绝，按提示调整内容后重新发布。 发布后如果你改了角色的设定内容（开场、描述、系统提示词等会影响生成的字段），状态会回到「待复核」，需要重新发布过机审。只改头像之类不影响内容的，不需要重新机审。 ### 可见性 发布时选角色的可见性： | 可见性 | 谁能看到 | |--------|----------| | 私有 | 只有你能看到和编辑 | | 不公开 | 有链接的人可以访问、开聊，不进广场 | | 公开 | 进入角色广场，所有人可发现 | ## 版本记录与恢复 每次创建、保存、发布、恢复都会自动留一个历史版本。点「版本记录」可以查看历史，并一键**恢复**到任意旧版本。 如果角色已经上线、而恢复的版本改动了影响生成的设定，恢复后会回到「待复核」，需要重新发布过机审。 --- ## AI 角色卡 / 分身（已下线） URL: https://2some.ren/docs/characters 描述: 公开角色广场、AI 角色聊天和创作者数据功能的下线说明 # AI 角色卡 / 分身（已下线） 公开角色广场、AI 角色聊天、收藏评价和创作者数据功能已经下线，旧入口不再提供访问。 本组文档仅保留产品下线记录，不代表当前可用能力。当前 Studio 中的私密角色设定与旧公开角色广场不是同一产品，也不会承接旧链接或历史数据。 --- ## 私信 URL: https://2some.ren/docs/chat/direct-messages 描述: 和粉丝、创作者一对一聊天 # 私信 私信是你和粉丝、其他创作者之间的一对一聊天。 ## 怎么发起私信 - **从对方个人空间**：进入对方的个人空间，点「发私信」，直接开聊。 - **从聊天列表**：打开「控制台」→「消息」，在已有会话里继续聊。 桌面端打开「消息」时，左侧是聊天列表，右侧是当前聊天。还没选会话时，右侧会提示「选择一个聊天开始，或进入对方个人空间发私信」。 ## 能发什么内容 一条私信可以包含下面这些内容： | 类型 | 说明 | |------|------| | 文字 | 单条最多 8000 字 | | 格式化文字 | 点击「打开高级编辑器」输入受支持的 Markdown 并使用格式按钮；发送后显示为安全富文本，详见[消息操作](/docs/chat/messaging-actions#格式化文字与-markdown) | | 图片 / 视频 / 文件 | 一条消息最多 9 个附件；图片单个不超过 10MB，视频或文件单个不超过 50MB | | 语音 | 录制语音消息，接收方可转成文字（见[消息操作](/docs/chat/messaging-actions)） | | 贴纸 | 贴纸需要单独发送，不能和文字、图片放在同一条 | | 链接卡片 | 粘贴链接会自动渲染成富卡片 | 语音消息不能和图片、视频或文件放在同一条里发送。贴纸也要单独成条。 Web 当前开放图片和白名单文件发送；Mobile 的主会话另外支持 MP4 / WebM / MOV 视频。不同端没有显示入口时，不代表服务端会接受任意文件类型。 ## 发不出消息？先看对方的私信设置 能不能给一个人发私信，取决于**对方**的「谁可以给你发私信」设置： | 对方的设置 | 你的体验 | |------------|----------| | 所有人 | 随时无限发 | | 陌生人可发一条申请 | 互相关注无限发；不是互关时，你只能先发**一条**，等对方回复后才能继续 | | 仅互相关注的人 | 只有互相关注才能发；不是互关的话，连第一条都发不出，已有的聊天也会暂停发送 | 如果你发消息时看到「对方未关注你，等对方回复后才能继续发消息」或「对方只接受互相关注的人发私信」，就是这个原因。互相关注后即可正常聊天。 被对方拉黑、或你拉黑了对方时，双方都无法私信。 详细规则和你自己的设置见[隐私与设置](/docs/chat/privacy-settings)。 平台托管 AI 角色使用独立的角色会话，不走本页 IM 私信权限。真人向普通 Bot 发起或继续 IM 私信时，Bot 作为对端会豁免互关 / 等待回复限制，但拉黑规则仍优先生效；这个豁免不反向赋予 Bot 主动私信真人的权限。公开 Bot runtime Chat API 当前只支持已安装的 Group，不能读取或发送私信。AI 角色聊天受平台合规开关控制，部分地区或时段可能暂时不可用。 --- ## 群成员与管理 URL: https://2some.ren/docs/chat/group-management 描述: 群角色权限、管理策略和群头像 # 群成员与管理 群越大越要管。这里讲群的角色、各项管理策略和群头像。设置入口在群聊页右上角的「群聊设置」。 ## 成员角色 群里有三种角色： | 角色 | 能做什么 | |------|----------| | 群主 | 全部权限：改群名、改入群策略、设申请问题、设/取消管理员、移出或禁止成员、转让群主、解散群聊 | | 管理员 | 协助管理：按策略邀请成员、审批申请、移出或禁止普通成员、置顶消息等。每群最多 10 位 | | 成员 | 按群的策略发言、回复、邀请 | 群主可以设置或取消管理员、把成员移出群、转让群主；管理员不能修改成员角色、转让群主或操作群主/其他管理员，只能按群策略邀请成员、审批申请、移出或禁止普通成员等。普通成员可以随时退出群聊。 转让群主后你会变回普通成员，新群主接管全部权限。解散群聊后，所有成员都不能继续聊天，也看不到新消息，操作不可恢复。 ## 管理策略 权限按服务端角色固定如下，不以页面是否显示控件为准： - **仅群主**：修改「谁可以邀请成员」；修改「谁可以加入群聊」及申请问题；设置群主页公开状态；设置/取消管理员；转让群主；解散群聊。 - **群主和管理员**：修改群名、群资料、谁可以发言、谁可以回复、谁可以看成员列表、Thread 策略、群头像和开播提醒；创建、查看和撤销命名邀请链接（不受「谁可以邀请成员」策略影响）；按该策略直接邀请成员或分享默认链接；审批入群申请、移出或禁止普通成员；管理置顶消息。 - **管理员不能**：修改 owner/admin 角色、转让群主、解散群聊，或操作群主及其他管理员。 | 策略 | 选项 | |------|------| | 谁可以邀请成员 | 所有成员 / 群主和管理员 / 仅群主 | | 谁可以加入群聊 | 直接加入 / 申请后加入 / 仅限邀请 | | 谁可以发言 | 所有成员 / 仅群主和管理员（适合公告、通知群） | | 谁可以在消息下回复 | 所有成员 / 仅群主和管理员 / 关闭回复 | | 谁可以看成员列表 | 显示所有成员 / 仅显示群主和管理员 | 设成「仅群主和管理员可以发言」后，普通成员发消息会被提示「仅群主和管理员可以发言」。 「申请后加入」最多可配置 3 个文本问题，每题可设为必填。系统会把当时的问题和答案一起保存，之后修改问题不会改变旧申请。 ## 移出与禁止加入 - **移出群聊**：只移除当前成员。对方之后仍可重新申请或接受邀请。 - **移出并禁止加入**：移除成员并加入禁止名单。对方不能通过个人空间、邀请链接或成员邀请再次加入。 - 群主和管理员可以在「禁止加入名单」里解除限制。 ## 群头像 群主和管理员可以给群上传自定义头像： - 支持 jpg / png / webp / avif / gif，单张不超过 **10MB**。 - Web 会把静态图裁成方形并缩至最大 512×512（小图不放大），再按设备编码为 WebP 或 AVIF；GIF、APNG 和动画 WebP 会保留原动画容器，不做静态裁剪。Mobile 会把静态图裁成方形并缩至最大 512×512，再编码为 WebP。 - 移除自定义头像后，群头像会自动用成员头像拼成。 ## 群里的免打扰与通知 每个群成员都能单独设自己的群通知方式，和全局通知设置分开： - **免打扰**：可选 1 小时 / 8 小时 / 24 小时 / 永久。 - **通知级别**：可选接收全部消息、仅在被 @ 时提醒、或不接收。 这样消息多的群可以静音，只在被点名时才被提醒。 --- ## 群聊与粉丝群 URL: https://2some.ren/docs/chat/groups 描述: 发起群聊、建立粉丝群、把开播提醒推给整群 # 群聊与粉丝群 群聊是你聚拢粉丝、和创作者协作的主场景。建群后你自动成为群主。 ## 发起群聊 1. 在「消息」页点「发起群聊」。 2. 第一步选成员：从可邀请列表里挑成员。Web 当前要求至少选 2 人；最多人数按群主的用户等级计算（见下表），并且每位成员是否能被直接邀请还要看对方的群聊邀请设置。 3. 第二步设置群名（可留空，之后再改）、决定是否设为粉丝群。 4. 点「发起群聊」，你自动成为群主。 群的人数上限： | 项目 | 上限 | |------|------| | 群成员（含群主） | Level 0：50 人；Level 1：1000 人；Level 2：无上限（技术封顶 10000 人） | | 管理员 | 10 人 | | 群名 | 15 字 | 能否直接邀请某个人，不只看是否互相关注：对方的群聊邀请设置为「所有人」时可以邀请；设为「仅互相关注」时必须双方互关；设为「不接收」时会被拒绝。任一方向存在拉黑关系也会被拒绝。上限按**群主的用户等级**计算，不是所有群统一 10000 人。 Web 普通建群界面当前要求至少选择 2 位成员，Mobile 普通建群至少选择 1 位成员；Mobile 的公开粉丝群入口支持 0 位成员。API `POST /api/v1/chat/conversations` 的 `memberUserIds` 可以为空，适合先建立群，再通过个人空间或邀请链接入群；这不代表 Web 普通建群界面也允许空成员。 群助手账号（机器人）不能在发起群聊时直接拉进来。要先把群建好，再到群聊设置里添加群助手。群主或管理员完成安装后，成员可以用斜杠命令 picker 点它；若机器人主人已登记 HTTPS 回调，平台会签名叫醒该机器人（见 [Webhook 与轮询](/docs/bots/inbound)）。安装界面没有 Webhook 勾选，回调地址只对机器人主人可见。 ## 粉丝群 粉丝群是专门为主播设计的群：它会**展示在你的个人空间**。展示位置和入群方式彼此独立，群主可以允许直接加入、要求审批，或只允许邀请加入。 ### 创建粉丝群 有两个入口： - **建群时直接公开**：发起群聊第二步打开「在个人空间展示（设为粉丝群）」。 - **从个人空间一键创建**：在你自己的个人空间「粉丝群」卡片点「创建粉丝群」，会立刻建好并公开到主页。默认群名是「你的昵称 + 的粉丝群」。 也可以把已有的群在群聊设置里打开「在个人空间展示（粉丝群）」，把它变成粉丝群。 ### 粉丝怎么加入 关注你的人在个人空间会看到「粉丝群」卡片。按钮会按群设置显示： - **直接加入**：先关注群主，随后立即进群（页面会在加入流程中完成关注）。 - **申请后加入**：回答最多 3 个申请问题，等待群主或管理员确认。 - **仅限邀请**：个人空间只展示群聊，必须拿到邀请链接才能加入。 粉丝群靠个人空间一键加入，适合长期挂在主页吸粉。如果你想在直播间、简介里贴一条链接拉人，用[群邀请链接](/docs/chat/invites)。两者可以同时用。 ## 开播提醒 把直播和粉丝群打通：**群主在 B 站开播时，系统自动在群里发一条提醒消息**，叫群成员来看播。完整说明见 [开播通知](/docs/live-tools/go-live-notify)。 - 入口在群聊设置里的「开播提醒」开关；新群默认开启。 - 群主和管理员可以开关。关掉只停这个群的自动提醒，不影响采集和其它群。 - 群主必须绑定有效的 B 站账号，并且电脑上的桌面端或浏览器扩展正在采集这个直播间。手机 App 不能代替采集端。 - 普通群只要你是群主也会发，不要求必须公开成粉丝群。 粉丝侧另有一条通道：在你的日程页「订阅提醒」并打开「开播时也提醒」。和群聊提醒互不影响，见 [开播通知](/docs/live-tools/go-live-notify#日程订阅开播提醒)。 --- ## 聊天 / 私信 / 群聊 URL: https://2some.ren/docs/chat 描述: 在 2SOMEone 里和粉丝、创作者私信、建群、运营粉丝群 # 聊天 / 私信 / 群聊 2SOMEone 自带一套完整的私信和群聊系统。你可以和粉丝一对一私信，也可以拉群、建粉丝群、把开播提醒推给整群人。聊天入口在「控制台」→「消息」（`/dashboard/chat`）。 ## 能做什么 - **一对一私信**：在对方个人空间点「发私信」，或从聊天列表发起会话。支持文字、格式化文字、图片、文件、语音、贴纸和链接卡片。 - **群聊**：按对方的邀请策略邀请成员。群容量按群主等级分档：Level 0 为 50 人、Level 1 为 1000 人、Level 2 技术封顶 10000 人；每群最多 10 名管理员。 - **粉丝群**：群主在个人空间展示粉丝群，并选择直接加入、申请审批或仅限邀请。 - **群邀请**：生成邀请链接、审批入群申请，都在「群聊邀请」中心统一管理。 - **消息能力**：回复、转发、置顶、表情回应、@提及、语音转文字、撤回；普通输入保持简洁，需要排版时可[打开高级编辑器](/docs/chat/messaging-actions#格式化文字与-markdown)输入受限 Markdown。 - **贴纸**：发送贴纸、用聊天图片制作贴纸、收藏与安装贴纸包。 - **隐私设置**：控制谁能给你发私信、谁能把你拉进群、在线状态可见性、已读回执。 - **官方社群**：一键加入官方公告、互助、创作者交流群。 ## 各页导航 | 页面 | 内容 | |------|------| | [私信](/docs/chat/direct-messages) | 一对一聊天入口、能发什么内容、发不出消息怎么办 | | [群聊与粉丝群](/docs/chat/groups) | 发起群聊、建粉丝群、开播提醒 | | [开播通知](/docs/live-tools/go-live-notify) | 开播后怎么通知粉丝群，以及日程订阅开播提醒 | | [群成员与管理](/docs/chat/group-management) | 角色权限、管理策略、群头像 | | [群邀请](/docs/chat/invites) | 邀请链接、入群申请、邀请中心 | | [消息操作](/docs/chat/messaging-actions) | 回复、转发、置顶、反应、语音、@提及、撤回 | | [贴纸](/docs/chat/stickers) | 发贴纸、制作贴纸、贴纸包 | | [隐私与设置](/docs/chat/privacy-settings) | 谁可私信、在线状态、已读回执、链接卡片 | | [官方社群](/docs/chat/official-community) | 官方公告群、互助群、创作者交流群 | 账号、支付、订单、隐私这类问题请提交客服工单，不要发到官方社群里。聊天系统不处理这类咨询。 --- ## 群邀请 URL: https://2some.ren/docs/chat/invites 描述: 邀请链接、入群申请和邀请中心 # 群邀请 想往群里拉人，除了在群设置里逐个邀请成员，还可以生成邀请链接对外分享。能否直接拉入某位成员仍受对方隐私设置、互关关系和拉黑状态影响；链接和入群申请都在「群聊邀请」中心统一管理。 ## 邀请链接 每个群都有一条默认分享链接，点群里的「分享」按钮就能取得或自动创建。默认链接会跟随群的入群方式：群设为「申请后加入」时，默认链接也需要审批。链接形如： ``` https://2some.ren/invite/<邀请码> ``` 把它贴到直播间、个人简介、其他社群里，别人点开后会按链接规则直接入群或提交入群申请。群聊填写了简介时，落地页和聊天富卡片会展示简介；普通分享文案按入口而异，Mobile 群设置的分享摘要当前使用成员数和审批状态，不保证带上群简介。系统不会展示成员身份或群消息预览。 除了默认链接，群主和管理员还能创建带参数的邀请链接： | 参数 | 说明 | |------|------| | 标签 | 给链接起个名字方便区分（最多 30 字），比如「直播间」「微信群」 | | 最大使用次数 | 限制这条链接最多能拉多少人（1～10000） | | 是否需要审批 | 开启后，通过这条链接进群要先经群主/管理员确认；关闭后可显式绕过群级审批 | 群里的「分享」按钮返回每群唯一的默认链接；谁能取得或分享这条链接由「谁可以邀请成员」策略控制：设为「仅群主」或「群主和管理员」时，普通成员点分享会被拦下。拿到有效链接的人不受这项分享者策略限制，仍需通过链接自身的撤销、过期、次数、封禁和群容量校验。默认链接的审批状态跟随群级入群策略：只有群设为「申请后加入」时才需要审批；「公开加入」和「仅限邀请」群拿到默认链接即可直接加入。带标签、次数和审批参数的命名链接属于邀请中心管理能力，当前仅群主和管理员可以创建、查看和撤销；命名链接的「是否需要审批」可以显式关闭，从而绕过群级审批设置。 ## 入群申请 别人通过链接申请入群后： - 如果链接**不需要审批**，对方直接进群。 - 如果链接**需要审批**，对方进入「待确认」状态，要等群主/管理员通过。申请时要回答群主配置的问题，也可以补充留言。 ## 群聊邀请中心 打开 `/dashboard/chat/invites`（聊天页也有「群聊邀请」入口），可以在一个页面里： 1. 看你管理的所有群、各群当前最多 3 条可用链接、已失效链接数量和待确认申请数（不提供完整失效链接历史）。 2. 一键复制当前展示的可用邀请链接。 3. 在右侧「待确认的入群申请」里查看申请答案和账号注册时间，再逐条**通过**、**拒绝**或**拒绝并禁止加入**。 4. 在具体群聊设置的「禁止加入」名单里查看和解除封禁；邀请中心不展示完整禁止名单。 普通拒绝后，对方需要等待 24 小时才能再次申请。「拒绝并禁止加入」会阻止对方通过个人空间、邀请链接或成员邀请加入，直到群主或管理员解除禁止。 ## 被别人拉群拉不进来？ 主动点开邀请链接申请入群，不受你的隐私设置限制。但**别人直接把你拉进群**会受你的「谁可以把你拉进群」设置控制，详见[隐私与设置](/docs/chat/privacy-settings)。 --- ## 消息操作 URL: https://2some.ren/docs/chat/messaging-actions 描述: 格式化文字、回复、转发、置顶、表情反应、语音、@提及、撤回 # 消息操作 在聊天里长按或右键一条消息，会弹出操作菜单。下面是每条消息能做的事。私信、群聊和 Thread 共用这些基础操作，但具体权限仍由会话类型、成员角色和消息状态决定。 ## 逐条消息能做什么 | 操作 | 说明 | |------|------| | 回复 | 引用这条消息回复 | | 查看回复 | 在这条**顶层消息**下展开/参与 Thread；Thread 回复不能再开子 Thread | | 复制 | 复制消息文字 | | 转发 | 把消息转发到别的聊天 | | 置顶 / 取消置顶 | 把重要消息固定在群顶部（需要权限） | | 编辑 | 只能编辑自己发的消息，发送后 **15 分钟内**可以修改，超过窗口后不能再改 | | 举报消息 | 对别人的消息举报 | | 撤回 | 见下方撤回规则 | ## 格式化文字与 Markdown 日常聊天不需要在发送时手动选择「纯文本 / Markdown」模式。普通输入框默认保持简洁，不直接展示格式工具栏；其中的内容始终按纯文本发送（包括看起来像 Markdown 的符号）。需要排版时，点输入区的放大按钮「打开高级编辑器」，在弹出的「高级编辑器」模态窗里输入 Markdown 并使用格式按钮；打开这个编辑器就是对当前消息使用富文本的明确选择。 Web 中的 Cmd/Ctrl+B、Cmd/Ctrl+I 等格式快捷键也属于明确的格式操作，会把当前草稿切换为富文本；不使用高级编辑器、格式按钮或快捷键时，普通输入始终按纯文本发送。 Web、iOS 和 Android 使用同一组受限语法： | 效果 | 写法 | |------|------| | 粗体 | `**重点**` | | 斜体 | `*强调*` | | 删除线 | `~~已删除~~` | | 行内代码 / 代码块 | 用反引号包围行内代码；用三个反引号包围多行代码 | | 引用 | 行首输入 `> ` | | 有序 / 无序列表 | 行首输入 `1. ` 或 `- ` | | 换行 | 在编辑器中插入换行 | | 链接 | `[说明](https://example.com)`；只支持 HTTP / HTTPS | ### Web、iOS、Android 的入口 三端的消息协议和渲染语义一致，但入口按平台的输入习惯分别适配： | 平台 | 普通状态 | 高级编辑器 | |------|----------|------------| | Web | 输入框只显示日常聊天所需控件 | 点击放大按钮「打开高级编辑器」，在「高级编辑器」模态窗内使用工具栏 | | iOS | 输入框只显示日常聊天所需控件 | 点击「打开高级编辑器」进入全屏编辑器；关闭后保留草稿和光标位置 | | Android | 输入框只显示日常聊天所需控件 | 点击「打开高级编辑器」进入全屏编辑器；关闭后保留草稿和光标位置 | 高级编辑器中的工具栏只负责插入 Markdown source，不会改变消息的兼容协议。iOS 与 Android 的系统通知仍显示服务端生成的纯文本预览，不显示 `**`、反引号等格式标记。 发送后，服务端会把 Markdown 规范化为安全的结构化消息，各端按同一语义渲染；编辑这类消息时会恢复原始 Markdown，方便继续修改。复制、搜索、会话预览和系统通知使用去掉格式标记的可读纯文本；不支持富文本的旧客户端也会收到真实的纯文本正文，而不是空消息或升级占位。Markdown 只负责消息正文的排版，不是通用卡片容器；附件、贴纸和链接卡片仍按各自的消息块单独处理。 上表之外的 Markdown 语法不会扩展成新的 UI 组件，会按输入中的字面文本保留。 在高级编辑器中，若想让 `**`、反引号等符号按字面显示，可以使用 Markdown 转义；普通输入框则始终按字面显示。机器人程序可改用纯文本 `text` 字段。 任意 HTML、CSS、JavaScript、`iframe` 或 WebView 内容都不会执行。HTML 标签只会作为可见文字处理；危险链接协议也不会变成可点击链接。 Bot 发送 `{ "text": "**重点**" }` 时，内容始终按纯文本处理，会原样显示星号。要渲染格式，REST 请求必须发送 `{ "blocks": [{ "type": "rich_text_v1", "source": "**重点**" }] }`；Bot SDK 可以用 `parseMode: "markdown"` 转换成这一协议。Markdown 里的 `@用户名` 不会自动触发提及通知，需要另传结构化 `mention` / `mention_all` block。完整契约见 [Bot 接口参考](/docs/bots/api#受限-markdown-与兼容读取)。 ## 表情反应 点开菜单顶部的快捷表情栏，可以给任意一条消息加表情反应。Web 当前固定提供 6 个常用表情：👍 ❤️ 😂 😮 😢 🙏；Mobile 还可以从扩展选择器中选择更多表情。 ## 撤回消息 | 谁 | 能撤回什么 | |----|------------| | 你自己 | 自己发出 **2 分钟内**的消息 | | 群主 | 群里成员（包括管理员）的消息 | | 管理员 | 群里普通成员的消息；不能撤回群主或其他管理员的消息 | 超过 2 分钟后自己就不能撤回了，会提示「发送超过 2 分钟，不能撤回」。消息被撤回后显示「此消息已撤回」。 私信没有群主 / 管理员代撤回权限；管理员规则只适用于群聊。 ## 语音消息与转文字 - 在输入区录制语音消息，发送时带波形。 - 收到语音后，在消息菜单点「转成文字」，把语音转成文字看。 - 转写完还能再点「再次转成文字」重新转一遍。 - 语音转文字要求当前账号达到 Level 1，且余额足够。转写成功后按条结算，当前为 **¥0.01 / 次**；失败不结算，同一用户对同一条语音的重复结算会去重。 ## @提及 在群里输入 `@` 会弹出成员选择器，可以 @某个人，对方会收到提及提醒。 - **@所有人**：只有群主和管理员能用。普通成员尝试 @所有人会被提示「只有群主或管理员可以 @所有人」。 - **「@我的」收件箱**：所有 @ 到你的消息会汇总到一个提及收件箱，方便集中查看，不怕在大群里被刷过去。 Thread 里的 @ 提及会按会话通知级别、静音和成员权限处理；不要把“输入了 @”理解成必然收到 Push。Thread 回复也不会把普通群聊时间线持续标红。当前 Activity API 会默认纳入尚无状态记录的 Thread；已有状态后，关注、root 作者、参与或被提及都可能让它继续出现。 ## Thread（线程） Thread 用一条顶层消息承载一段独立上下文。打开顶层消息的「查看回复」即可进入线程；回复会留在 Thread 中，不会混入群聊主时间线。你可以在 Thread 内继续回复、编辑自己的消息、撤回自己的消息，以及添加或取消表情反应。当前 Web/Mobile 界面不提供在 Thread 内再引用某条回复的操作；API 调用方可按接口契约传递引用关系。 每个 Thread 有独立的已读位置和关注状态。会话内搜索结果会标明所属 Thread，并可直接跳回对应回复；服务端已有 Thread Activity API，但当前 Web/Mobile 尚未提供独立的「线程动态」导航入口，入口和完整收件箱仍待补齐。消息通知是否送达还受会话通知级别、静音、系统推送权限和前台状态影响。 需要程序读取线程动态时，可用登录用户会话调用 `GET /api/v1/chat/threads/activity`，可选 `conversationId` 和 `limit`（1～100，默认 30）；该收件箱接口目前只接受真人登录态，不接受 Bot runtime key。程序或 Bot 若只需维护某个 Thread 的状态，可调用以下端点： | 操作 | 请求 | 权限与结果 | |------|------|------| | 标记 Thread 已读 | `POST /api/v1/chat/conversations//threads//read`，正文 `{"upToMessageId": <回复 id>}` | 登录用户或 Bot；Bot 需 `chat.read`，root 必须可见；返回 `updated` 与 `lastReadMessageId` | | 关注 / 取消关注 | `POST /api/v1/chat/conversations//threads//follow`，正文 `{"followed": true/false}` | 登录用户或 Bot；Bot 需 `chat.read`，root 必须可见；返回最终 `followed` | `upToMessageId` 只会推进到该 Thread 中实际可见的回复。对 Bot 来说，不存在或因安装 privacy mode 不可见的 root 会保持成功形态（已读不更新、关注回显请求值），不会暴露 root 是否存在；真人对失效或不可见 root 返回 `404`。首次创建已读状态会同时保存 `followed: true`。当前关注字段还不是 tri-state，显式 `false` 不会覆盖 root 作者、被提及者或参与者的 Activity 自动资格。这两个状态端点不会把 Thread 回复自动并入普通群聊未读，也不提供事件推送或离线 mutation catch-up。 ## 查看已读成员（群聊） 在群里，长按自己发送的**顶层普通消息**可以「查看已读成员」，看哪些成员读过这条。这个列表只对消息发送者本人开放，Thread 回复、系统消息和他人发送的消息没有群成员 read-by 列表；能否显示具体成员还受双方的已读回执设置影响，详见[隐私与设置](/docs/chat/privacy-settings)。 ## 链接卡片 聊天里粘贴链接会自动渲染成富卡片。不想看预览可以在聊天设置里关掉「显示链接卡片」——关掉后链接仍然保存，只是不展开成卡片。 --- ## 官方社群 URL: https://2some.ren/docs/chat/official-community 描述: 一键加入官方公告群和创作者交流群 # 官方社群 官方社群是你融入 2SOMEone 社区、第一时间拿到平台动态的入口。打开「控制台」→「消息」里的官方社群入口（`/dashboard/chat/official-community`）即可加入。 ## 有哪些群 | 群 | 内容 | 适合谁 | |----|------|--------| | 2SOMEone 中文群 | 公告、更新、功能反馈和用户互助 | 所有 2SOMEone 用户 | | 虚拟主播交流群 | 聊虚拟主播直播、内容运营、工具使用和创作协作 | 虚拟主播、运营和内容创作者 | 每个群会显示当前成员数和成员上限，以及入群须知。 ## 怎么加入 1. 打开官方社群页面。 2. 选你想加入的群，点「加入群聊」。 3. 正常情况下，加入后直接进群开聊；如果账号不符合官方社群资格、群已归档或已满，页面会提示暂时不能加入。已加入的群显示「打开群聊」。 ## 社群 vs 客服工单 官方社群是用来交流、互助、看动态的，**不是客服渠道**。 账号、支付、订单、绑定和隐私这类问题，请提交客服工单处理，不要发到社群里。社群成员和官方都不会在群里处理这些私密事务。 --- ## 隐私与设置 URL: https://2some.ren/docs/chat/privacy-settings 描述: 谁可私信、谁可拉群、在线状态、已读回执、链接卡片 # 隐私与设置 聊天相关的隐私开关都在「控制台」→「设置」→「聊天」（`/dashboard/settings/chat`）。这些设置直接影响别人能不能联系你、能看到你多少状态。 ## 谁可以给你发私信 控制谁能私信你。互相关注的人通常可以联系你，但任一方的拉黑规则始终优先。 | 选项 | 说明 | |------|------| | 所有人 | 任何用户都可以给你发私信 | | 陌生人可发一条申请 | 互相关注的人无限发；非互关的人只能先发一条，等你回复后才能继续 | | 仅互相关注的人 | 只有互相关注的人能给你发私信；非互关的人不能先发，已有的聊天也会暂停发送 | 这就是别人给你发私信时可能被挡住的原因。被拉黑双方都无法私信。 ## 谁可以把你拉进群 控制其他人能否**直接**把你加进新群聊。 | 选项 | 说明 | |------|------| | 所有人 | 任何用户都可以邀请你加入群聊 | | 仅互相关注 | 仅互相关注的用户可以邀请你加入群聊 | | 不接收 | 不接收新的群聊邀请 | 这项只管「别人直接把你拉进群」。你自己主动打开[邀请链接](/docs/chat/invites)申请入群，不受此设置限制。 ## 在线状态可见性 控制谁能看到你的「在线」和「最近活跃」状态（如「在线」「刚刚活跃」「X 分钟前活跃」）。 | 选项 | 说明 | |------|------| | 所有人 | 任何登录用户（包括陌生人）都能在你的个人主页、动态卡片等位置看到你的状态 | | 互关好友 | 仅互关好友可以看到 | | 仅我自己 | 其他人看不到你的在线和最近活跃状态 | 新用户默认对所有登录用户公开。改成「所有人」时会弹出二次确认——Instagram、TikTok 等平台都不提供这个选项，只在互关好友间显示在线状态。想和它们保持一致就选「互关好友」。 直播中属于公开直播状态，不受这项设置影响，始终会公开展示。 ## 已读回执 「发送已读回执」开关控制别人能否看到你读没读他的消息。 - **关闭后是双向的**：对方看不到你是否读过他的消息，**同时**你也看不到对方是否读过你的消息。 - 群里看「查看已读成员」也受此影响。 ## 链接预览 「显示链接卡片」开关控制聊天里的链接要不要展开成富卡片。 - 关闭后，链接仍会保存，只是不在页面上渲染成卡片。 - 这项对私信和群聊都生效。 --- ## 贴纸 URL: https://2some.ren/docs/chat/stickers 描述: 发贴纸、做贴纸、收藏与安装贴纸包 # 贴纸 聊天里可以发贴纸，也能把聊天图片、收到的贴纸甚至树洞稿件做成自己的贴纸。对创作者来说，这是把内容沉淀成专属表情的好玩法。 贴纸需要单独发送，不能和文字、图片或语音放在同一条消息里。 ## 贴纸面板 在输入区打开贴纸面板，会看到： - **收藏**：你保存到收藏的贴纸。 - **已安装贴纸包**：你装好的贴纸包。 - **群贴纸包**：当前群专属的贴纸包。 - **官方贴纸包**：平台官方贴纸包。 还可以搜索贴纸，系统也会给推荐。 ## 制作贴纸 把图片变成贴纸的入口在消息菜单里： | 来源 | 怎么做 | |------|--------| | 聊天里的图片 | 长按一条图片消息，点「制作贴纸」 | | 树洞稿件里的图片 | 从泡泡树洞的稿件图片做成贴纸 | | 收到的贴纸 | 长按一张贴纸，「保存贴纸」存进收藏 | ## 收藏与贴纸包 - **保存贴纸**：把喜欢的贴纸加进自己的收藏，随时再发。 - **添加到贴纸包**：把贴纸整理进自己的贴纸包。 - **查看贴纸包**：从一张贴纸跳到它所在的贴纸包。 - **安装贴纸包**：装上别人的贴纸包，之后在面板里直接用。 贴纸包分官方贴纸包和创作者贴纸包，可以在贴纸包发现页浏览。 ## 举报贴纸 看到不合适的贴纸，长按它点「举报贴纸」即可。公开传播的贴纸和贴纸包会经过平台审核，违规内容可能被限制或下架。 --- ## 公会驾驶舱 URL: https://2some.ren/docs/club/dashboard 描述: 后台首页的待办、关键指标与专页设置 # 公会驾驶舱 进入某个公会后台（`/dashboard-club/<公会>`），首页就是驾驶舱。它把需要你处理的事和关键数据汇到一屏，下方再挂全部管理入口。只有会长和管理员能看到驾驶舱，普通成员看不到。 ## 顶部公会信息 最上方一张卡片显示公会名称、Slug（`/slug`）和页面标题，方便确认你正在管理的是哪个公会。 ## 待办事项 待办面板聚合需要你处理的事项，**没有待办时显示「太棒了，没有待办」**。可能出现的待办： | 待办 | 触发条件 | 跳转去处 | |------|---------|---------| | 待回邀请 | 还在有效期内、未被响应的邀请 | 发出的邀请页 | | 席位告警 | 已买席位但未绑定 B 站公会（MCN），或席位计划即将 / 已过期 | 公会助手页 | 席位过期告警在到期前 7 天内开始提示。 ## 关键指标 指标卡片只在有意义时显示，避免噪音： | 指标 | 说明 | 隐藏规则 | |------|------|---------| | 本周新增成员 | 最近 7 天加入的成员数 | 小公会（成员 < 20）且本周新增为 0 时隐藏 | | 席位利用率 | 已分配席位 / 计划总席位的百分比 | 未购买席位时隐藏 | 席位利用率会按高低变色：≥80% 为绿色，≥50% 为黄色。 ## 全部功能入口 驾驶舱下方按分组列出全部管理入口，和左侧边栏一致： | 分组 | 入口 | 说明 | |------|------|------| | 设置 | 专页设置 | 自定义背景图、Logo、标题、简介、公告 | | 成员管理 | 成员列表 | 查看和管理公会成员，详见 [成员与营收](/docs/club/members-revenue) | | 成员管理 | 发出的邀请 | 管理已发送的邀请，详见 [邀请与加入](/docs/club/invitations) | | 工具 | 数据修复 | 帮成员重置异常的礼物数据 | | 工具 | 公会助手 | 绑定 B 站公会、管理 Galaxy 扩展席位，详见 [Galaxy 席位订阅](/docs/club/galaxy-seats) | ## 专页设置 「专页设置」决定公开专页 `/club/` 长什么样，会长和管理员都能改。分四块： ### 基本信息 | 字段 | 上限 | 说明 | |------|------|------| | 展示名称 | 50 字 | 必填，公会名称 | | 页面标题 | 100 字 | 显示在专页顶部的大标题，留空则用展示名称 | | 公会简介 | 200 字 | 简短介绍 | ### 背景图 推荐 1920×1080，原始文件最大 10MB，上传时自动压缩。 ### Logo 推荐正方形，原始文件最大 5MB，上传时自动压缩。展示端会自动裁切，非方形图也能用。 ### 公告 最多 500 字，显示在专页成员矩阵上方。留空则不显示公告区。 专页有约 5 分钟缓存。保存设置后，公开页可能需要稍等几分钟才显示最新内容。 ## 数据修复 成员的礼物数据出现统计异常、数据断层、记录不符、导出异常时，可以在「数据修复」里帮该成员重置数据。 1. 在下拉里选择要修复的成员（仅显示已绑定 B 站的成员）。 2. 系统预览将删除的记录数和时间范围（最近三个月）。 3. 点「重置数据」，在二次确认弹窗里**输入你的登录密码**确认。 重置会删除该成员 GiftRaw 表里最近三个月的 B 站礼物数据，**不可恢复**。重置后请让成员保持浏览器扩展或桌面端稳定运行、网络良好，等待若干小时重新同步。如果是 B 站本身尚未同步的新数据，等 1-2 天再重试。 --- ## Galaxy 席位订阅 URL: https://2some.ren/docs/club/galaxy-seats 描述: 公会统一为成员开通经纪人扩展权益：绑定 B 站公会、团购席位、分配与撤销 # Galaxy 席位订阅 公会可以统一为成员开通「公会经纪人助手」扩展的付费权益，成员不用各自掏钱订阅。会长先绑定 B 站公会，购买一批席位，再按 B 站 UID 把席位发给成员。成员在经纪人仪表盘会看到「公会席位生效中」。 整套功能在公会后台的「公会助手」页（`/dashboard-club/<公会>/galaxy`），会长和管理员可见。 ## 第一步：绑定 B 站公会（MCN） 席位要先有一个归属的 B 站公会才能生效。 1. 用经纪人助手扩展在 B 站公会中心登录你的公会账号。 2. 在「公会助手」页，系统自动从扩展读取你当前登录的 B 站公会信息（公会名、MCN ID），无需手动填 ID。 3. 确认后点「绑定当前公会」。 读不到信息时，可点「重新读取」，或点「打开公会中心」先在 B 站登录公会账号再试。 绑定 / 解绑是**会长专属**的组织级操作，管理员不能操作。一个 B 站公会 ID 全局只能被一个公会绑定；一个公会也只能绑一个 B 站公会。 ## 第二步：购买席位 绑定后即可购买席位计划。 1. 点「购买 / 续费席位」。 2. 填**席位数**：这是**目标总席位数**，支付成功后席位总数更新为这个数，不能低于「现有计划席位数」和「当前已分配数」的较大值（v1 暂不支持降配）。 3. 选套餐（见下方价格表）。弹窗会实时算出合计 = 套餐单价 × 席位数。 4. 点「去支付」，跳转支付宝完成付款。 支付成功后，席位总数更新为所选数量，有效期在现有基础上**顺延**所选套餐时长。 ### 套餐与价格 公会席位走「公会团购」套餐，也可选月付 / 半年付按席位购买： | 套餐 | 价格 | 起购席位 | 权益要点 | |------|------|---------|---------| | 月付版 | ¥499 / 月 / 席位 | 1 席 | 免费版全部功能 + 直播广场 / 直播间自动展示签约状态 | | 半年付版（主推） | ¥999 / 半年 / 席位 | 1 席 | 月付版全部 + 批量导出、多账号管理、团队协作 | | 公会团购 | ¥799 / 半年 / 席位 | **5 席起购** | 半年付版全部 + 公会批量管理、优先技术支持 | | 年付版 | ¥1599 / 年 / 席位 | — | 已售罄，暂不出售 | 完整套餐功能对比见 [公会经纪人助手](/docs/guild-agent-extension)。 ## 第三步：分配与撤销席位 席位按 **B 站 UID** 发放，可以发给还没注册 2SOMEone 的成员。 - **分配**：在「席位分配」里输入成员的 B 站 UID，点「分配席位」。已注册的成员会自动补上昵称和用户名。 - **撤销**：在分配列表里点对应成员的「撤销」并确认。撤销后该成员的扩展权益立即失效，腾出的席位可重新分配给别人。 席位计划过期后不能再分配新席位，需先续费。已分配满时也无法再加，需先撤销或买更多席位。 移除公会成员**不会**自动收回他的席位，请在「席位分配」里手动撤销。解绑 B 站公会会让**全部席位立即失效**（已购买的席位计划保留，重新绑定后可继续用）。 ## 成员侧：经纪人扩展仪表盘 成员在站内的「经纪人扩展仪表盘」（`/dashboard-galaxy`）管理自己的扩展账号与权益： - **账号与订阅**：查看公会 ID、BUID，以及当前是「订阅有效 / 席位有效 / 暂无订阅」。被公会分配了席位的成员会看到「公会席位生效中」卡片，显示有效期和提供席位的公会名。 - **每日签到**：连续签到每满 7 天，赠送 2 天订阅时长。今天签过则显示「今日已签到」。 - **新用户 30 天免费试用**：还没买过的新用户可领一次 30 天全功能试用。 - **限时活动**：有活动时可领取额外订阅时长（具体天数以活动为准）。 - **管理订阅**：跳转到订阅页续费或购买。 如果你的公会已在 2SOMEone 绑定但还没给你分配席位，仪表盘会提示你联系公会管理员分配；分配后即可使用，无需自己单独订阅。 --- ## 公会总览 URL: https://2some.ren/docs/club 描述: 创建公会、对外展示成员阵容、统一管理成员与营收 # 公会 / 俱乐部 公会功能帮你把签约主播聚成一支队伍：对外有一个可分享的公开专页，对内有一套驾驶舱后台，管理成员、邀请、营收和经纪人扩展席位。 本分组讲的是 2SOMEone 站内的「公会运营系统」。还有一个面向 B 站经纪人的浏览器扩展「公会经纪人助手」，那是装在浏览器里、在 B 站页面上用的星探工具，说明见 [公会经纪人助手](/docs/guild-agent-extension)。两者可以配合使用：公会团购的 Galaxy 席位就是把扩展权益统一发给成员，见 [Galaxy 席位订阅](/docs/club/galaxy-seats)。 ## 公会能做什么 | 能力 | 说明 | |------|------| | 公开专页 | 每个公会有一个 `/club/` 公开页，展示 Logo、标题、简介、公告和成员阵容，可投放到直播间和社群引流 | | 驾驶舱 | 后台首页汇总待办与关键指标，下挂全部管理入口，详见 [公会驾驶舱](/docs/club/dashboard) | | 成员管理 | 添加成员、调整专页展示顺序、编辑成员资料、查看每人的授权状态 | | 营收分析 | 对授权了流水查询的成员，批量查询收益 / 消费 / 礼物 / 大航海数据，支持导出 CSV，详见 [成员与营收](/docs/club/members-revenue) | | 邀请系统 | 生成带有效期的邀请链接，或定向邀请已注册用户，详见 [邀请与加入](/docs/club/invitations) | | Galaxy 席位 | 公会统一为成员开通经纪人扩展权益，详见 [Galaxy 席位订阅](/docs/club/galaxy-seats) | ## 创建公会 1. 登录 2SOMEone 账号，进入「控制台」→「公会」（路径 `/dashboard-club`）。 2. 没有公会时，页面会显示「创建首个公会」表单。 3. 填写以下字段后点「创建公会」： | 字段 | 是否必填 | 说明 | |------|---------|------| | Slug | 必填 | 公开访问路径，3-40 位小写字母、数字或连字符（如 `demo-club`），将拼成 `/club/` | | 展示名称 | 必填 | 公会名称 | | 页面标题 | 可选 | 显示在专页顶部的大标题，留空则用展示名称 | | 页面简介 | 可选 | 一句话描述公会 | 创建后，你（当前账号）自动成为公会**会长（owner）**。 公会所有者自动绑定创建时登录的账号。如需以其他账号当会长，请先切换登录身份再创建。 ## 进入公会后台 - 只创建了一个公会：进入 `/dashboard-club` 会自动跳到该公会的驾驶舱。 - 创建了多个公会：`/dashboard-club` 列出全部公会（含成员数），点任意一个进入。 - 后台左侧边栏分三组：**设置**（专页设置）、**管理**（成员管理、邀请管理）、**工具**（数据修复、公会助手）。 ## 公开专页 公开专页是公会对外的门户，访客无需登录即可访问。 - 顶部展示 Logo、标题、简介，下方是公告（如有）和成员卡片矩阵。 - 每张成员卡片显示头像、昵称、B 站粉丝数和签名，并提供四个直达入口：**主页**、**树洞**、**歌单**、**B站**空间。 - 只展示**勾选了「展示到公会专页」授权**的成员，最多 100 名，按你在成员管理里设置的顺序排列。 - 专页有约 5 分钟缓存，后台改动后稍等片刻刷新生效。 外观（背景图 / Logo / 标题 / 简介 / 公告）在「专页设置」里维护，详见 [公会驾驶舱](/docs/club/dashboard)。 ## 角色与权限 公会内有三种角色： | 角色 | 中文 | 能做什么 | |------|------|---------| | owner | 会长 | 全部权限：含绑定 / 解绑 B 站公会等组织级高危操作 | | admin | 管理员 | 管理成员、邀请、专页设置、营收查询、公会助手席位 | | member | 成员 | 仅管理自己的授权与加入状态，看不到驾驶舱 | 会长可在成员管理里把成员设为管理员或撤销管理员。成员侧的自助管理见 [邀请与加入](/docs/club/invitations) 的「我的公会」一节。 ## 找官方交流与帮助 公会运营遇到问题，可以到 [社区页](/community) 找官方交流渠道：站内官方社群、腾讯频道、抖音群、QQ 群都在那里。 2SOMEone 不在任何公开群、动态或视频评论区设客服。技术问题请用页面里的「提交调试信息 / 支持」入口走工单，不要在公开群里等回复。 --- ## 邀请与加入 URL: https://2some.ren/docs/club/invitations 描述: 邀请链接、定向邀请、加入流程，以及成员侧的自助管理 # 邀请与加入 把人拉进公会有两种方式：生成一条**邀请链接**广发，或者**定向邀请**某个已注册用户。本页讲两种方式、加入落地体验，以及成员侧怎么管理自己的公会。 ## 生成邀请链接 进入「发出的邀请」（`/dashboard-club/<公会>/invitations/sent`），在「邀请链接」卡片里： 1. 选有效期：**1 天 / 3 天 / 7 天**（默认 7 天）。 2. 点「生成链接」，得到形如 `https://2some.ren/club/join?token=...` 的链接。 3. 点复制按钮，把链接分享给想加入的人。 任何拿到有效链接的人，点开都能进入加入落地页。同一条链接在有效期内可以供多人加入，不是一次性链接。管理页会列出最近生成的链接；不想继续使用时，可以点停用，停用后立即不能再入会。 ## 定向邀请 如果对方已注册 2SOMEone，可以直接定向邀请： 1. 在「发出的邀请」页或成员管理的「新增成员」框里，搜索用户名、昵称或 BUID。 2. 选中目标用户，可附一句邀请留言（可选，最多 200 字）。 3. 点「发送邀请」。 对方会在「收到的邀请」里看到这条邀请并选择接受或拒绝。 ## 加入落地页 被邀请人点开邀请链接后，落地页（`/club/join`）会显示： - 公会名称、标题、成员数、公会主 - 邀请链接的剩余有效期 下方让被邀请人**勾选授权项**后再加入： | 授权 | 含义 | |------|------| | 展示到公会专页 | 允许公会在专页上展示你的信息（默认勾选） | | 授权公会查询我的流水记录 | 允许公会管理者查询和导出你的直播流水数据 | | 允许公会编辑我的资料 | 允许公会管理者编辑你的昵称、用户名和头像 | 勾选完点「加入公会」即可入会，加入后会跳到该公会的专页。未登录用户会在当前页完成登录或注册，原来的授权选择会保留，并自动继续加入。三项授权的详细含义见 [成员与营收](/docs/club/members-revenue)。 加入时怎么勾不是一锤子买卖。入会后可以随时在「我的公会」里修改或撤销任意授权。 ## 管理发出的邀请 「发出的邀请」页分别管理定向邀请和公开邀请链接。公开链接可复制、查看到期时间并主动停用；定向邀请每条带状态标签： | 状态 | 含义 | |------|------| | 待处理 | 还在有效期内、对方未响应 | | 已接受 | 对方已加入 | | 已拒绝 | 对方拒绝了邀请 | | 已过期 | 超过有效期未响应 | 待处理的邀请可以随时取消。驾驶舱的「待回邀请」待办，统计的就是还在有效期内未响应的邀请数。 ## 成员侧自助管理 普通成员在控制台有两个自助页面： ### 收到的邀请 `/dashboard/my/club-invitations` 列出收到的公会邀请，可逐条接受或拒绝。控制台公会入口会带未读角标提示有几条待处理邀请。 ### 我的公会 `/dashboard/my/clubs` 列出你加入的所有公会，每个公会可以： - **管理权限**：勾选 / 取消三项授权（展示、流水、编辑），随时改随时撤。 - **退出公会**：非会长成员可主动退出，退出后需重新被邀请才能再加入。 退出公会后，你之前的授权和在专页的展示会一并失效。想回来得让管理者重新邀请你。 --- ## 成员与营收 URL: https://2some.ren/docs/club/members-revenue 描述: 成员管理、隐私授权、流水营收分析、礼品筛选、在舰回顾与 CSV 导出 # 成员与营收 这一页讲公会的日常运营核心：怎么管成员，怎么看成员的直播流水和大航海数据。 ## 成员管理 进入「成员管理」（`/dashboard-club/<公会>/members`）可以查看全部成员、调整专页展示顺序、编辑成员资料。 ### 添加成员 公会内最多 **100 名成员**。在「新增成员」框里搜索用户名、昵称或 BUID，命中后点「邀请」，系统会向该用户发出公会邀请，对方接受后入会。（也可以用邀请链接拉人，见 [邀请与加入](/docs/club/invitations)。） ### 成员列表 列表按专页展示顺序排列，每行显示： - 昵称、角色标签（会长 / 管理员 / 成员）、用户名、BUID - 加入方式（直接添加 / 邀请加入 / 链接加入）和加入时间 - **授权**徽章：展示（专页）、流水、编辑，对应该成员勾选的三项授权 - 操作按钮：上移 / 下移（调整专页顺序）、移除成员 成员超过 5 人时，列表右上角出现筛选框，可按昵称 / 用户名 / BUID 快速过滤。 ### 角色管理 会长可以把普通成员设为管理员，或撤销管理员，回到普通成员。会长身份不可在此处转移。 ### 编辑成员资料 当成员勾选了「允许公会编辑我的资料」授权后，行内会出现编辑按钮，管理者可改该成员的： | 字段 | 规则 | |------|------| | 昵称 | 以中文或英文开头，2-20 位字符 | | 用户名 | 4-16 位字母数字下划线，不能是纯数字，需未被占用 | | 头像地址 | 有效的图片 URL | ### 复制专页链接 成员管理页顶部有公会专页链接卡片，一键复制 `/club/`，可直接发到直播间或社群。 ## 成员隐私授权（三项 consent） 成员加入公会时自主勾选授权范围，加入后可随时在「我的公会」修改或撤销。三项授权的含义： | 授权 | 含义 | |------|------| | 展示到公会专页 | 允许公会在公开专页上展示你的信息（头像、昵称、粉丝数、签名等） | | 授权公会查询我的流水记录 | 允许公会管理者查询和导出你的直播流水数据 | | 允许公会编辑我的资料 | 允许公会管理者编辑你的昵称、用户名和头像 | 这三项授权全部由成员本人勾选，管理者无法替成员打开。营收分析、礼品筛选、在舰回顾这些工具，**只对勾选了「授权流水查询」的成员生效**；没授权的成员不会出现在查询列表里。 ## 成员流水营收分析 进入「成员流水」可以批量查询已授权成员的直播数据。 ### 查询步骤 1. 勾选要查询的成员（默认全选已授权成员）。 2. 选日期范围：可用快捷按钮（上个月 / 近 3 个月 / 近半年 / 近一年），也可自定义，或选「不限」。 3. 点「查询」。 ### 概览与明细 查询结果先给五项总计：**总收益、总消费、总礼物数、直播场次、直播时长**；下方表格逐人列出同样维度。每位成员行尾有两个下钻入口（需该成员已绑定 BUID）： | 下钻 | 内容 | |------|------| | 粉丝送礼明细 | 该成员的送礼粉丝名单，可按金额门槛 ≥1 / ≥10 / ≥50 / ≥100 / ≥138 元筛选，分页查看，支持导出 | | 大航海数据 | 该成员的舰长 / 提督 / 总督购买记录，含金额合计，分页查看，支持导出 | ### 导出 CSV 总表、粉丝送礼明细、大航海数据都能导出 CSV，文件名带日期，可直接用 Excel 打开做后续筛选与结算。 ## 礼品筛选 「礼品筛选」用来按礼物单价门槛，跨成员筛出高价值送礼粉丝名单，适合做精准粉丝运营。 1. 选择成员（默认选中所有已绑定 BUID 的成员，可一键全选 / 取消全选）。 2. 在筛选弹窗里设日期范围和**礼物单价门槛**（快捷档：≥1 / ≥10 / ≥50 / ≥100 / ≥138 / ≥500 元，也可手输任意金额）。 3. 点「搜索」。 结果给四项统计（粉丝数、总消费、平均消费、最高消费），表格逐位粉丝列出消费金额、送礼次数、最后送礼时间、送给了哪些成员，支持分页和导出 CSV。 ## 在舰回顾与消费记录 「公会助手」相关菜单之外，公会后台还有两个大航海视角的查询页： | 页面 | 内容 | |------|------| | 在舰回顾 | 按指定日期查看成员当前在舰名单：总督 / 提督 / 舰长各档人数与总计，可下钻到逐位在舰用户（含陪伴天数、粉丝牌等级），支持按等级筛选和导出 CSV | | 消费记录 | 查看成员的大航海购买记录历史 | 大航海在舰名单每天自动抓取一次。某天没抓到就无法补录，请让成员保持浏览器扩展或桌面端稳定运行。数据有缺可用驾驶舱的「数据修复」重新抓取，见 [公会驾驶舱](/docs/club/dashboard)。 --- ## 弹幕与僚机 URL: https://2some.ren/docs/live-tools/danmaku 描述: 直播中控大屏、OBS 弹幕浮层、抖音弹幕接入 # 弹幕与僚机 围绕直播弹幕，2SOMEone 提供多套展示面：僚机中控台（第二屏信息密度大屏）、站内弹幕机（Dashboard 轻量悬浮窗）、OBS 弹幕浮层（叠到直播画面）、桌面弹幕浮窗（Electron 置顶窗口）、以及抖音弹幕接入。 ## 站内弹幕机 登录后在 Dashboard 桌面端（除僚机中控页外）右下角会出现「直播弹幕」悬浮入口，展开后可看实时弹幕列表与连接状态。 - 可在 **账号设置 → 偏好设置 → 站内直播弹幕机** 开关；默认开启，偏好只保存在当前设备。 - Bubble Box 页仍会把弹幕暂存到稿件、并在展示期计入分析；其它 Dashboard 页只提供通用观看能力。 - 与聊天浮层、支持按钮互斥展开；**不替代** Electron「桌面弹幕浮窗」或 OBS 浏览器源。 ## 僚机（弹幕机中控台） 僚机是开播时用的电脑端直播中控大屏，把直播间各种动态实时聚合到一个界面，让你不漏掉重要 SC、上舰和弹幕。 僚机目前处于 Beta 阶段，且仅限 PC 访问，移动设备上功能受限。 ### 中控模块 中控台聚合这些模块： - 弹幕列表 - 醒目留言（SC） - 礼物 + 大航海 - 热点话题摘要 - 用户互动（进场、关注等） - 投票面板 顶部有实时统计（每分钟事件数、总事件数、最近事件类型）和连接状态，断线时可手动重连。 ### 三套预设布局 按直播场景一键切换布局，也支持自定义拖拽（可锁定 / 编辑 / 重置），布局会本地保存： | 布局 | 适合场景 | |------|----------| | 直播中控 | 弹幕、热点、付费事件均衡展示 | | 付费优先 | 放大 SC、礼物和大航海，适合答谢场景 | | 投票活动 | 放大投票和弹幕，适合互动环节 | ## OBS 弹幕浮层 OBS 弹幕浮层把 B 站 / 抖音的弹幕、SC、礼物、上舰等实时叠到直播画面里，高度可定制，免费替代第三方弹幕姬。 ### 工作原理 ``` 桌面端采集 → WebSocket 推送 → OBS 浏览器源 ``` 需要先装 2SOMEone 桌面客户端，在桌面端登录平台账号并开启直播监听，再生成 OBS 链接添加为浏览器源。 ### 配置项 **连接设置** | 项 | 说明 | |----|------| | 弹幕源平台 | 全部 / Bilibili / 抖音 | | WebSocket 地址 | 桌面端 WS 服务地址，默认 `localhost:9697` | **事件类型开关**：弹幕、超级留言（SC）、礼物、舰长、进场、关注、点赞。 **显示元素开关**：头像、用户名、舰长徽章、粉丝勋章、表情。 **风格与外观** | 项 | 选项 / 范围 | |----|-------------| | 风格 | 默认（经典列表）/ 气泡（聊天气泡）/ 极简（简洁文字） | | 整体透明度 | 10%–100% | | 字体大小 | 12–48px | | 反向滚动 | 新弹幕显示在底部 | | 最大显示条数 | 自定义 | | 自动隐藏 | 多少秒后隐藏，0 表示不隐藏 | **SC / 礼物置顶**：开启置顶栏后可设最大置顶数量、礼物置顶最低价格（元）。 **礼物**：开启「礼物合并」后，连续相同礼物合并为一条显示。 **进阶** | 项 | 说明 | |----|------| | 礼物最低价格（元） | 低于此价格的礼物不显示 | | 显示免费礼物 | 如小心心、辣条等 | | 自定义 CSS | 输入 CSS 覆盖默认样式，预览可实时看效果 | | 显示连接状态 | 在浮层左上角显示 WS 连接状态 | | 调试模式 | 在控制台输出详细日志 | 配好后复制「OBS 链接」，在 OBS 里添加为「浏览器源」即可。建议宽度 400–600px，高度与画面等高。右侧有实时预览。 ## 抖音弹幕 抖音弹幕让你在 2SOMEone 接入抖音直播间的实时弹幕。 抖音弹幕需要 2SOMEone 桌面客户端支持。没有桌面端时页面会引导你去 下载桌面客户端。 使用步骤： 1. 在桌面客户端里打开抖音弹幕页 2. 输入抖音直播间 ID，点「启动」开始监听 3. 实时显示抖音弹幕，含粉丝团名 + 等级、用户名、内容、时间 页面顶部有连接状态指示：未连接 / 连接中 / 已连接 / 重连中 / 失败。连接失败时检查直播间 ID 是否正确、对方是否正在直播。接入后配合 [OBS 弹幕浮层](/docs/live-tools/danmaku#obs-弹幕浮层) 就能把抖音直播数据叠进画面。 --- ## 小工具与贴纸 URL: https://2some.ren/docs/live-tools/extras 描述: 动态九图生成器、工具箱小工具、聊天贴纸包 # 小工具与贴纸 这里收纳主播做物料、玩社区会用到的零散小工具，以及聊天里的贴纸包。 ## 动态九图生成器 把一张图自动切成 3×3 九宫格，适合发动态切图，不用再开外部工具。在「控制台」→「创作」相关入口或工具箱里进入。 用法： 1. 上传一张图，自动切成 3×3 共 9 格 2. 每一格可以再加一张附加图片 3. 设置导出参数：尺寸、格式（PNG / JPEG）、是否允许放大 4. 单张导出某一格，或打包成 ZIP 一次导出全部 默认导出尺寸为 262px。不勾「允许放大」时，导出尺寸不会超过原始格子尺寸，避免模糊。 ## 工具箱 `/tools` 是平台的免费工具箱，汇总了一批小工具，分两类： **小游戏** | 工具 | 做什么 | |------|--------| | 答案之书 | 困惑时获得简短而有智慧的回答 | | 塔罗牌 | 通过塔罗牌获得洞察和指引 | | SBTI 人格测试 | 30 题 · 15 维度 · 27 种人格，支持直播 OBS 绿幕模式 | | MBTI 人格测试 | 16 种人格 · 3 套题库（28 / 40 / 93 题） | 人格测试的直播玩法详见 [互动测试](/docs/live-tools/quiz)。 **实用工具** | 工具 | 做什么 | |------|--------| | V圈生涯 | 选喜欢的 VUP，生成个人 V圈喜好表图片 | | 从夯到拉 | 在线做 Tier List 层级排行榜，支持自定义层级、模板和拖拽排序 | | 动态九图生成器 | 见上方[动态九图生成器](/docs/live-tools/extras#动态九图生成器) | | AI 图片背景移除 | 隐私优先，支持 CPU & WebGPU，免费 | | 图片格式转换 | 多种图片格式互转，批量处理 | | 图片缩放 | 自定义尺寸和质量 | | 图片裁剪 | 自定义裁剪区域和尺寸 | ## 贴纸包 贴纸包是站内聊天用的表情包。你可以发现并安装别人的包，也能发布自己的包。 ### 发现与安装 `/stickers` 是公开发现页，可以按标题、标签、表情搜索贴纸包，把喜欢的包安装到聊天贴纸面板。贴纸包按来源分四类： | 来源 | 说明 | |------|------| | 官方 | 平台官方贴纸包 | | 系统 | 系统内置贴纸包 | | 群聊 | 群聊专属贴纸包 | | 创作者 | 创作者公开发布的贴纸包 | ### 管理与发布 在「控制台」→「设置」→「贴纸」里管理你的贴纸： - 管理收藏的贴纸和已安装的贴纸包 - 上传自制贴纸 - 创建并公开发布自己的贴纸包 创作者发布个人贴纸包，能在社区里扩大影响力，是创作者周边的延伸。 --- ## 开播通知 URL: https://2some.ren/docs/live-tools/go-live-notify 描述: 群主开播后自动通知粉丝群，以及粉丝订阅日程后收到的开播提醒 # 开播通知 开播通知让粉丝在你真正开播时被叫回来。平台里有两套互补的提醒，共用同一条「B 站直播间状态翻转」信号，但发给谁、怎么关，完全分开： | 通道 | 发给谁 | 出现在哪 | 谁控制发送 | 谁控制接收 | |------|--------|----------|------------|------------| | **群聊开播提醒** | 你当群主的群成员 | 群里一条「开播提醒」卡片，并可推送到手机 / 网页 | 群主或管理员在该群设置里开关 | 成员的「群聊开播提醒」通知主题，以及该群自己的通知级别 | | **日程开播提醒** | 订阅了你日程、并打开「开播时也提醒」的人 | 手机 / 网页推送和通知中心 | 粉丝在你的日程页订阅时勾选 | 粉丝的「开播提醒」通知主题 | 两套都可以同时开。关其中一个，不会关掉另一个。 开播通知只跟你绑定的 **B 站直播间**走。抖音开播不会进粉丝群，也不会触发日程的「开播时也提醒」。群里的「开始直播」（LiveTalk）是另一套群内分屏直播，也不会触发这里的开播通知。 ## 群聊 / 粉丝群开播提醒 群主在 B 站开播时，系统会在**你当群主、且开了「开播提醒」的群或频道**里发一条系统消息。卡片上写着直播标题，点进去会打开对应的 B 站直播间。 这条能力面向粉丝群，但并不限定必须公开到个人空间：只要你是群主、开关开着，普通群也会发。新群默认就是开的。 消息正文是「\{群主昵称\} 开播了，快来围观吧」。Web 和 App 会把它渲染成带「开播提醒」标记、可点进直播间的卡片。 ### 主播怎么打开 1. 打开这个群的「群聊设置」（Web 在群聊页右上角；App 在群资料 / 设置）。 2. 找到「开播提醒」开关。群主和管理员都能改。 3. 保持开启。关闭后，这个群不再自动发开播卡片，也不再给成员推送这一条；其它群不受影响。 建群或把群设成粉丝群时，界面不会单独再问一次「要不要开播提醒」——默认已开，需要关再进设置。 ### 要先具备什么 开关开着，不等于通知已经能发出去。三条都要齐： 1. **群主绑定了有效的 B 站账号**，见 [社交绑定](/docs/account/binding)。上报上来的直播间号必须和这条绑定记录一致。 2. **电脑上有采集端在跑**：2SOMEone [桌面端](/docs/billing/desktop) 或 Chrome / Edge [浏览器扩展](/docs/browser-extension)，并登录对应的 B 站账号。平台靠它们上报直播间状态，再向 B 站核对后才认定「开播了」。 3. **这个群的「开播提醒」保持开启**，群没有被解散。 手机 App **不能**代替桌面端或浏览器扩展去采集直播状态。只装 App、只开了开关，群里不会凭空出现开播卡片。 平台还会把「很久没更新状态」的直播间派给在线的桌面端 / 扩展去补采。主播自己挂着采集端最稳；完全没有采集端在跑时，状态可能停在过期快照上，开播通知就会漏。 ### 粉丝会怎样收到 群成员会同时看到两层： - **群里的卡片**：群记录里所有人都能看到，包括群主和后来加入的成员。 - **推送 / 网页通知**：只发给**当时已在群里**、且通知级别是「全部消息」的成员；**不会推给群主自己**。主题叫「群聊开播提醒」，支持移动推送、网页通知和应用内提醒，不含桌面端本地提醒。后加入的人仍能翻到这张卡片，但不会补收那场推送。 下面这些情况，群里可能还有卡片，但**不会响铃推送**： - 成员把这个群设成免打扰，或通知级别不是「全部消息」 - 成员在通知设置里关掉了「群聊开播提醒」 - 成员正处于勿扰时段 关掉「群聊开播提醒」主题，只是不再响铃；群聊消息和未读还在，日程订阅也不受影响。 ### 发送节奏 - 同一场直播（同一次开播会话）每个群最多发一条。 - 同一个群 **30 分钟内**不会再发第二条，避免断流重连刷屏。日程通道也按大约 30 分钟分桶，不会对同一批订阅者连打。 - 只在「未开播 → 开播」或识别到一场新的直播会话时发送；下播不会发对应消息。 ## 日程订阅开播提醒 粉丝在你的个人空间「日程」页点「订阅提醒」后，可以在每场安排开始前收到提醒，也可以额外打开「开播时也提醒」。详见 [直播日程](/docs/live-tools/schedule#粉丝订阅开播提醒)。 和群聊通道的差别： | | 群聊开播提醒 | 日程开播提醒 | |--|--------------|--------------| | 粉丝要不要先加入什么 | 必须已经在这个群里 | 必须订阅了你的日程 | | 主播要不要先排班 | 不用 | **当天要有一条真正的直播安排**（「休息 / 待定」不算） | | 个人空间要不要打开日程入口 | 不用 | 要，否则粉丝订不到 | | 默认 | 群开关默认开 | 订阅时「开播时也提醒」默认开 | 当天没有任何可开播的日程时，即使你真的在 B 站开了播，日程通道也不会发。群聊通道不受这天排班影响。 ## 用户现在怎么发现 ### 主播 当前没有单独的新手向导或任务来介绍开播通知。主播通常是在这些地方碰到它： | 入口 | 会看到什么 | |------|------------| | 群聊设置 →「开播提醒」 | 一行说明：「群主在 B 站开播时，自动在本群发送提醒消息」 | | 个人空间 →「创建粉丝群」 | 只解释粉丝群会公开到主页，**不提**开播提醒 | | 发起群聊 →「设为粉丝群」 | 同上 | | 任务中心「开通你的粉丝群」 | 只奖励公开粉丝群，**不提**开播提醒 | | 日程编辑器的新手引导 | 只讲排班和公开，**不提**群聊开播提醒 | | [群聊与粉丝群](/docs/chat/groups) | 文档里有一小节；完整说明就是本页 | 所以对很多主播来说，第一次「发现」是：自己开播后，粉丝群里突然出现一张开播卡片。如果没绑 B 站或没挂采集端，则什么都不会发生，界面也不会提示缺了哪一步。 ### 粉丝 | 入口 | 会看到什么 | |------|------------| | 已加入的粉丝群 | 主播开播后出现开播卡片，可点进 B 站直播间 | | 主播个人空间 → 日程 →「订阅提醒」 | 可选提前 15 / 30 / 60 分钟，以及「开播时也提醒」 | | 控制台 → 设置 → 通知 | 「群聊开播提醒」和「开播提醒」两个主题，可分别关 | | `/live` 正在直播页 | 登录后有「关注的人正在直播」，这是发现页，不是推送 | 粉丝没有「请打开开播提醒」的引导。没进群、没订阅日程的人，不会因为关注了你就自动收到开播推送。 ## 常见问题 **为什么开关是开的，群里却没消息？** 先核对本页「要先具备什么」三步：B 站绑定、桌面端或扩展在跑、这个群的开关开着。再确认上报的是你绑定的那个直播间，而不是另一个账号的房间。 **关开关会怎样？** 只停这个群的自动开播卡片和对应推送。采集、礼兮、日程、其它群都不受影响。 **粉丝把群静音了还能收到吗？** 群里的卡片还在。推送只发给通知级别为「全部消息」的成员。 **会不会重复刷？** 同一场直播每个群一条；同一群 30 分钟内不会再发。 **和「关注的人正在直播」是一回事吗？** 不是。`/live` 是公开发现页。开播通知是主动推到群里或推到已订阅日程的粉丝。 --- ## 工具总览 URL: https://2some.ren/docs/live-tools 描述: 直播日程、OBS 场景、弹幕浮层、僚机、小店、互动测试一站式直播创作工具箱 # 直播 / 创作工具 2SOMEone 把主播开播前后会用到的工具集中在一处：排播、画面、弹幕、互动、变现、物料都能在网页里搞定。下面按用途列出每个工具，点进去看详细用法。 ## 直播运营 | 工具 | 做什么 | 入口 | |------|--------|------| | **直播日程** | 用周编辑器排播，对外展示给粉丝，支持 B 站预约同步、开播提醒订阅、日历订阅 | [直播日程](/docs/live-tools/schedule) | | **开播通知** | 群主开播后自动通知粉丝群，粉丝也可订阅日程后的开播提醒 | [开播通知](/docs/live-tools/go-live-notify) | | **正在直播** | 公开页展示平台上正在直播的主播，登录后还能看「关注的人正在直播」 | [直播日程](/docs/live-tools/schedule#正在直播) | ## 直播画面 | 工具 | 做什么 | 入口 | |------|--------|------| | **OBS Studio** | 网页里画直播场景，拖组件、套模板，一键生成 OBS 浏览器源（Alpha 内测） | [OBS 场景编辑器](/docs/live-tools/obs-studio) | | **僚机** | 电脑端直播中控大屏，实时聚合弹幕、SC、礼物、上舰、投票（Beta） | [弹幕与僚机](/docs/live-tools/danmaku) | | **OBS 弹幕浮层** | 把 B 站 / 抖音弹幕高度可定制地叠到 OBS 画面 | [弹幕与僚机](/docs/live-tools/danmaku#obs-弹幕浮层) | | **抖音弹幕** | 接入抖音直播间实时弹幕（需桌面客户端） | [弹幕与僚机](/docs/live-tools/danmaku#抖音弹幕) | ## 变现与互动 | 工具 | 做什么 | 入口 | |------|--------|------| | **创作者小店** | 上架商品 / 服务、管理订单，给舰长和高消费粉丝设专属价 | [创作者小店](/docs/live-tools/store) | | **互动测试** | MBTI / SBTI 人格测试，自己在 OBS 直播展示台答题，观众在公开页同步玩 | [互动测试](/docs/live-tools/quiz) | ## 创作小工具 | 工具 | 做什么 | 入口 | |------|--------|------| | **动态九图生成器** | 一张图自动切 3×3 九宫格，适合发动态 | [小工具与贴纸](/docs/live-tools/extras) | | **工具箱** | 塔罗牌、答案之书、V圈生涯、从夯到拉、图片处理等 | [小工具与贴纸](/docs/live-tools/extras#工具箱) | | **贴纸包** | 发现并安装官方 / 创作者贴纸包，发布自己的贴纸包 | [小工具与贴纸](/docs/live-tools/extras#贴纸包) | AI 绘图是单独的工具，用法请看 [AI 绘图](/docs/ai-draw)，本分组不再重复。 OBS Studio 标注为 Alpha 内测、僚机标注为 Beta，功能仍在打磨中，正式直播前请先小范围验证。 --- ## OBS 场景编辑器 URL: https://2some.ren/docs/live-tools/obs-studio 描述: 网页里画直播场景，拖组件、套模板，一键生成 OBS 浏览器源 # OBS Studio 场景编辑器 OBS Studio 让你在网页里像拼图一样搭出专业的直播画面：开播前、直播中、休息、结束都能各做一套，然后一键生成 OBS 浏览器源地址贴进 OBS，省去第三方插件。 OBS Studio 目前处于 Alpha 内测开发阶段，请勿用于正式直播环节。欢迎通过页面右下角的反馈通道提交功能需求与建议。 ## 进入编辑器 在「控制台」侧边栏「直播」分组里点「OBS Studio (Alpha)」进入。画布默认 1920×1080，和直播分辨率一致。 首次进入会直接创建一张「直播中」画布，方便你马上开始布景。 ## 五个场景槽 顶部固定 5 个场景槽，对应直播的不同阶段。点一下没建过的槽会自动创建对应场景，双击标签可以重命名： | 场景槽 | 用途 | |--------|------| | 直播中 | 正式直播时的主画面 | | 开播前 | 等待开播的封面画面 | | 休息中 | 暂时离开时的占位画面 | | 结束 | 下播画面 | | 自定义 | 任意自定义场景 | ## 画布操作 编辑器是画布式的，组件可以拖拽、改尺寸、调图层。中间区域会自动把 16:9 画布居中 fit 显示，不提供整张画布的手动放大、缩小或平移。常用操作： | 操作 | 方式 | |------|------| | 网格 / 吸附 | 工具栏开关，对齐组件 | | 保存 | 点「保存」或 ⌘S / Ctrl+S | | 撤销 / 重做 | ⌘Z / ⌘⇧Z，或工具栏按钮 | | 复制组件 | ⌘D / Ctrl+D | | 全选 | ⌘A / Ctrl+A | | 删除组件 | Delete / Backspace（锁定的组件不会被删） | 组件库分成「添加组件」和「进阶组件」两层。前者放常用基础组件，后者收 `加班倒计时 / 礼物提醒 / 长图滚动` 这类更偏氛围和长时互动的挂件。详细配置看 [OBS 组件库](/docs/live-tools/obs-studio#组件库)。模板库用法看下方[模板库](/docs/live-tools/obs-studio#模板库)。 ## 组件库 从左侧把组件拖进画布，每种组件都有默认尺寸和可调参数： | 组件 | 用途 | 可调要点 | |------|------|----------| | 弹幕流 | 滚动展示弹幕 | 字号、最大条数、滚动方向、头像 / 舰长徽章 / 勋章、自动隐藏、按事件类型过滤 | | 醒目留言面板 | 展示 SC | 最大条数、保留时长、堆叠布局 | | 礼物提醒 | 收到礼物时弹提醒 | 最低价过滤、动画样式、展示时长、按金额分档配色 | | 上舰提醒 | 有人上舰时弹提醒 | 动画样式、展示时长 | | 文本 | 自定义文字 | 字体、字号、粗细、颜色、对齐、描边、阴影 | | 图片 | 静态图片 | 图片地址、填充方式 | | 倒计时 / 时钟 | 倒计时或时钟 | 模式、目标时间 / 时长、显示格式、字体样式、结束文案 | | 进度条 | 营收 / 目标进度 | 当前值、目标值、标题、百分比显示、颜色、高度 | | 视频 | 循环播放视频 | 视频地址、自动播放、循环、静音、填充方式 | | 网页 | 嵌入网页 | 网页地址、刷新间隔 | 弹幕流、醒目留言面板、礼物提醒、上舰提醒这几类是「直播数据组件」，需要本机弹幕桥接才能出数据，见下方 [OBS 输出](/docs/live-tools/obs-studio#obs-输出)。 ## 模板库 不想从零搭场景，可以套模板： - **保存为模板**：把当前场景存成模板，以后复用 - **浏览模板**：看自己的、公开的、系统内置的模板，公开模板带使用次数 - **收藏模板**：收藏喜欢的模板方便再找 - **应用模板到场景槽**：一键把模板套进某个场景槽 新手主播可以直接套公开 / 官方模板快速上手，老手把自己的模板沉淀下来反复用。 ## OBS 输出 点工具栏「OBS」打开输出弹窗，生成浏览器源地址： 1. 复制弹窗里的「浏览器源 URL」（形如 `/obs/scene/<场景 id>`） 2. 在 OBS 里添加「浏览器源」，粘贴这个地址 3. 如果用了直播数据组件，填「本机弹幕 WebSocket」地址（默认 `localhost:9697`），OBS 画面会从本机直播桥接读取实时弹幕 4. 可设「平台过滤」：全部平台 / Bilibili / 抖音 复制或预览 URL 前会先保存当前场景，确保 OBS 读到的是最新版本。WebSocket 只接受本机地址。 ## 开播检查 点工具栏「检查」做一次开播自检，逐项校验场景是否就绪，问题分三档： | 等级 | 含义 | |------|------| | 阻塞 | 必须解决，否则画面会出问题 | | 注意 | 建议处理，不一定阻断 | | 提示 | 仅供参考 | 常见检查项包括：是否有未保存改动、场景是否启用、资源地址是否填了、组件是否超出可见画布、弹幕桥接的 WebSocket 地址是否可用。每个问题旁多带一键修复动作，比如「恢复默认 WebSocket 地址」「把组件收进画布」「定位 / 显示组件」，降低上播翻车概率。 --- ## 互动测试 URL: https://2some.ren/docs/live-tools/quiz 描述: MBTI / SBTI 人格测试，自己在 OBS 答题、观众在公开页同步玩 # 互动测试 人格测试是一种低成本、高参与的直播玩法：你在 OBS 直播展示台上答题，观众在公开页同步玩并生成分享海报回流。平台提供 MBTI 和 SBTI 两套测试。 ## 两套测试 | 测试 | 题量 | 维度 / 人格 | |------|------|-------------| | MBTI 人格测试 | 三套题库：极速版 28 题 / 通用版 40 题 / 标准版 93 题 | 经典四维度，16 种人格 | | SBTI 人格测试 | 30 题 | 15 个维度，曼哈顿距离算法匹配 27 种人格 | MBTI 是经典的 Myers-Briggs 四维度测试，按时间松紧选不同题库；SBTI 基于五大模型扩展出 15 个维度。 ## 进入直播后台 在「控制台」→「互动测试」里，每个测试有两个入口： 1. **进入直播后台**：打开 OBS 直播展示台（ShowDesk），在直播画面里答题 2. **公开页**：在新标签打开公开测试页，分享给观众 直播展示台支持： - **字体大小调节**：根据画面大小放大 / 缩小题目和选项字号 - **绿幕模式**：把背景换成绿幕，方便在 OBS 里抠掉 - **全屏绿幕**：连卡片边框也变绿幕，抠图更干净 ## 公开页与分享海报 把公开页地址分享给观众，他们就能在自己的设备上同步做题。做完后可以生成结果分享海报，发到社群和动态回流。 MBTI / SBTI 的公开页也收录在平台 [工具箱](/docs/live-tools/extras#工具箱) 里，任何人无需登录都能玩。 开播时把直播展示台开绿幕抠进画面，自己边播边答题；同时把公开页地址甩进弹幕区，让观众一起测、一起出海报，互动就转起来了。 --- ## 直播日程 URL: https://2some.ren/docs/live-tools/schedule 描述: 用周编辑器排播，对外展示、同步 B 站预约、让粉丝订阅开播提醒 # 直播日程 直播日程让你把每周的开播安排公开给粉丝。你在控制台用周编辑器排班，粉丝在你的个人空间页看到按周展示的安排，时间会自动换算成他们的本地时区。这是拉动观众准时来看播的核心运营工具。 ## 进入日程编辑器 1. 登录后进入「控制台」→「日程管理」 2. 在周编辑器里按天添加直播事件 3. 编辑完点「保存」才会生效 4. 打开「个人空间入口」开关，把日程展示在你的主页 编辑后必须手动点「保存」，改动才会同步到个人空间，关掉页面不会自动保存。 ## 添加事件 每条事件可以设置类目、标题、开始时刻、时长和备注。一共 8 个类目： | 类目 | 说明 | |------|------| | 游戏 | 游戏直播 | | 歌回 | 唱歌专场 | | 杂谈 | 闲聊 / 杂谈 | | 联动 | 与其他主播联动 | | 会限 | 会员限定内容 | | 休息 | 当天休息（日级标记，不带时刻和时长） | | 待定 | 当天安排待定（日级标记，不带时刻和时长） | | 其他 | 其他类型 | 字段限制： | 字段 | 规则 | |------|------| | 标题 | 最多 50 字；「休息 / 待定」可留空，展示时用默认文案 | | 备注 | 最多 200 字 | | 时长 | 最长 1440 分钟（24 小时）；「休息 / 待定」不带时长 | | 每周事件数 | 单周最多 56 条 | ## 切周、复制和固定档期 - 用「上一周」「下一周」切换周，「本周」快速回到当前周。 - 单条日程可以复制到本周其他日期，复制后仍可单独修改。 - 「复制周」可以选择任意源周和目标周；`合并`保留目标周现有手工日程，`替换手工日程`只替换手工创建的内容。 - 「固定档期」可以把同一安排添加到连续多周。确认前会先预览涉及周数、新增数量和超限原因，执行时全成全败。 - B 站预约属于外部同步内容，不会被复制周或固定档期伪造，也不会被“替换手工日程”误删。 你在自己的时区里排「这周」，粉丝看到的时间会自动换算成他们的本地时区。跨周编辑、复制周时也按事件原本的时区重新计算，不会因夏令时直接平移而错位。 ## 在 Web 和 App 管理 Web 控制台与 2SOMEone App 使用同一份日程和写入冲突保护。两端都可以： - 切换周、增删改、复制单条日程并保存 - 复制任意周、设置连续多周固定档期 - 打开或关闭个人空间入口 - 开启 B 站预约同步 - 修改展示模板与素材 如果另一台设备已经改过同一周，保存时会提示加载最新版本，不会静默覆盖。 ## 展示模板与分享 「日程模板」提供 9 套 2SOMEone 原生模板：经典周表、柔光甜彩、主播周刊、拼贴手帐、播控台、宣传海报、七日季候、和纸留白和终端界面。 模板只改变展示，不会复制或改变日程事件。你可以配置标题、外观、强调色、信息密度、统计、类目摘要、背景图和角色图位置/缩放/效果。 公开日程页支持： - 保存当前周 PNG；支持文件分享的浏览器会直接分享图片，不支持时回退公开链接 - 分享带周次和可选单条日程锚点的公开链接 - 使用「分享指南」生成二维码、公开链接和宣发文案 - 在 App 中分享服务器生成的日程图片；设备不支持图片文件分享时回退链接 ## B 站直播预约同步 绑定 B 站账号后，可以让 B 站上建好的直播预约自动汇入这里的日程，省去重复录入。 1. 先到「控制台」→「设置」→「账号」绑定 B 站账号 2. 回到日程编辑器，打开「B站预约同步」开关 3. 同步进来的事件会带「B站预约」标记，开关旁会显示最近同步时间（如「最近同步 5 分钟前」） 没绑定 B 站账号时「B站预约同步」开关不可用，编辑器会提示去绑定。删除一条 B 站预约事件后，该预约不会再次自动同步进来。 ## 粉丝订阅开播提醒 粉丝在你的日程页可以「订阅提醒」，订阅后会在你开播前收到手机 App 推送。群聊里还有另一条「群主开播就通知整群」的通道，两者互不影响，见 [开播通知](/docs/live-tools/go-live-notify)。 - 提前量可选 **提前 15 分钟 / 30 分钟 / 60 分钟**（默认 30 分钟） - 可额外打开「开播时也提醒」 - iPhone 使用 APNs，Android 使用 FCM；Web Push 和站内通知继续按粉丝的通知设置投递 - 系统通知权限被关闭时，App 会提示粉丝前往系统设置恢复 这对主播是留存利器：粉丝订阅后能准点回流。订阅是按「订阅者 + 主播」幂等的，重复点不会重复订阅，你也能看到订阅人数。 ## 日历订阅（ICS / WebCal） 每位开启了日程展示的主播都有一个公开的日历订阅地址，格式为： ``` /api/schedule/<用户名>/ics ``` 公开页提供三种入口： 1. 下载 `.ics` 文件，一次性导入当前窗口内的安排 2. 复制 HTTPS 订阅地址，让日历 App 定期刷新 3. 打开 `webcal://`，交给系统日历 App 添加订阅 可选参数： | 参数 | 可选值 | 说明 | |------|--------|------| | `alarm` | `none`、`5`、`10`、`30`、`60`、`180`、`720`、`1440` | 不提醒，或提前对应分钟提醒 | | `includeCategory` | `true`、`false` | 是否把日程类型加入日历标题 | 生成的日历包含稳定事件 ID、开始/结束时间、全天休息/待定、备注、公开事件链接和更新时间。非法参数会返回 400，不接受 `tag=1` 等宽松别名。只有显式开启「个人空间入口」的主播才会输出日历，未开启时返回 404。 日程按主播保存的 IANA 编排时区归组；访客时区只改变显示时间，不会把事件重新分到另一日。默认周和日历窗口也按主播编排时区计算，旅行或临时更换设备不会静默改写它。 ## 正在直播 `/live` 是一个公开发现页，展示平台上正在直播的主播： - 按在线人气排序，实时显示开播状态和人气，最多展示 200 位主播 - 登录后还会多出「关注的人正在直播」一栏，第一时间知道你关注的人开播了 对观众这是「谁在播」的发现入口，对主播则是一个被看到的曝光位。 --- ## 创作者小店 URL: https://2some.ren/docs/live-tools/store 描述: 上架商品与服务、管理订单，给舰长和高消费粉丝设专属价 # 创作者小店 创作者小店让你直接在平台开店，卖周边、连麦、定制服务等。你可以给舰长和高消费粉丝设专属价，订单、联系方式、评价形成闭环，是创作者变现的核心工具。 ## 进入小店管理 在「控制台」→「小店管理」里管理商品、服务和订单。点右上角「查看订单」进入订单页。 ## 商品与服务 小店里有两种条目： | 类型 | 适合 | |------|------| | 商品（PRODUCT） | 实体或虚拟周边 | | 服务（SERVICE） | 连麦、定制、陪玩等服务 | ## 获取方案与分级定价 每件商品 / 服务可以配多套「获取方案」，给不同粉丝不同价格。每个方案有一个标签（如「普通购买」「舰长专属价」）和一种定价类型： | 定价类型 | 说明 | |----------|------| | 固定价格 | 一口价 | | 价格区间 | 最低价到最高价 | | 面议 | 价格私下谈 | | 免费 | 不收费 | 固定价 / 区间价还能填单位（如「次」「件」）。 ### 条件规则 每个方案可以加条件，限定谁能用这个价格。两类条件： | 条件 | 说明 | |------|------| | 大航海等级 | 最低需到 总督 / 提督 / 舰长 | | 消费金额 | 累计消费达到多少金瓜子（1000 金瓜子 = 1 元） | 每条条件还可以加日期区间（开始 / 结束日期，可选）。一个方案有多条条件时，可设「满足任一条件」或「满足全部条件」。不加条件则所有人可用。 给商品配两套方案：「普通购买 ¥50」不加条件；「舰长专属价 ¥30」加一条「大航海等级 ≥ 舰长」的条件。舰长粉丝就能看到并享受专属价。 ## 小店设置 在小店管理右侧的「小店设置」里： - **在主页显示小店入口**：开启后，访客可在你的个人空间看到小店按钮，进入你的公开店铺页 - **联系方式**：填微信 / QQ / 抖音 / 邮箱 / 手机等，有快捷模板。这条联系方式只有买家下单、被你接单后才能看到 联系方式是买家下单被接单后才可见的，不会公开展示，可以放心填私人联系方式。 ## 订单与评价 - 买家在你的公开店铺页下单，你在订单页接单、管理订单状态 - 接单后买家才能看到你填的联系方式，方便对接 - 交易完成后买卖双方可以互相评价 --- ## 地址管理 URL: https://2some.ren/docs/oh-gift/address 描述: 用三种方式收集粉丝收货地址，审核后批量导出 # 地址管理 地址管理模块帮助你收集粉丝的收货地址，方便寄送周边礼物。 进入路径：侧栏「礼兮」→「地址管理」。 首次使用请先打开页面右上角的「个人空间入口」开关，这样粉丝才能从你的个人空间提交地址。也可前往「个人空间设置」开启收件地址入口。 ## 收集地址（三种方式） 礼兮提供三种收集方式，是否需要审核各不相同： | 方式 | 是否审核 | 说明 | |------|---------|------| | 个人空间提交 | 无需审核 | 粉丝登录并绑定 B 站 UID 后，访问你的个人空间地址页提交，系统自动验证身份 | | 分享临时链接 | 需审核 | 生成临时链接发给粉丝，无需登录即可填写，提交后需你审核通过 | | 手动添加 | 无需审核 | 你自己在本页面直接录入地址 | ### 方式一：个人空间固定链接 开启「个人空间入口」开关后，地址页会有一个固定链接： ``` https://2some.ren/{你的用户名}/address ``` 粉丝登录并绑定 B 站后，从这个固定链接提交的地址会自动确认本人身份、免审核。这是最省事的长期收址方式，不用每次生成新链接。点页面顶部「分享链接」按钮即可复制固定链接。 ### 方式二：临时分享链接 点页面顶部「分享链接」按钮，在弹窗的「临时链接」区域： 1. 选择有效期：1 天 / 2 天 / 3 天 / 1 周（最长 7 天） 2. 点「生成链接」 3. 把链接发给粉丝，粉丝无需登录即可填写 临时链接提交的地址需要你**审核通过**后才能导出。 ### 方式三：手动添加 点页面顶部「新建地址」按钮，自己录入地址，免审核。 ### 粉丝填写字段 通过临时链接提交时，校验规则如下： | 字段 | 必填 | 说明 | |------|------|------| | 提交者 B 站 UID | ✓ | 用于关联粉丝身份 | | 收件人 | ✓ | 能认出本人即可 | | 手机号 | ✓ | 至少 11 位 | | 省 / 市 / 区 + 详细地址 | 至少填一项 | 省市区与详细地址至少要填其一 | 填地址时支持整段粘贴。把「浙江省杭州市西湖区文一西路969号」这样的整段文字粘进地址框，系统会自动识别拆成省 / 市 / 区 + 详细地址，识别不完整时会提示手动补全，大幅降低填写门槛。 ## 管理地址 ### 地址状态 地址分为两个状态： - **待审核**：临时链接提交、尚未确认的地址，集中在顶部「N 条待审核」入口 - **已通过**：审核通过、可参与导出的地址，显示在主列表 地址信息仅你可见。列表里手机号默认打码模糊显示，鼠标悬停才显示完整号码。系统安全存储，不会泄露给第三方。 ### 操作功能 主列表（已通过地址）每行操作： - **编辑**：修正地址信息中的错误 - **驳回**：把已通过的地址打回未审核状态 - **删除**：移除无效或重复的地址（不可恢复） 待审核地址在「N 条待审核」入口里逐条处理： - **通过**：审核通过，进入已通过列表 - **删除**：移除该条待审核地址 ## 批量导出 支持把地址批量导出，格式兼容常见快递平台。 ### 导出字段 ``` 收件人 | 联系电话 | 地址 | B站UID | 用户名 ``` 大航海名单也可在「在舰回顾 / 消费记录」页附带地址一起导出。 导出带地址只对**有效席位**（已登记且审核通过的地址）按 ¥0.1/条计费。例如 100 人上舰、50 人有有效地址，附带地址导出只收 ¥5。导出限免已于 2026 年 6 月 1 日结束。 ### 使用场景 - 导入快递系统生成面单 - 委托第三方发货 - 数据备份存档 ## 常见问题 ### 粉丝填写了错误地址怎么办？ 你可以在管理后台直接编辑地址信息，或让粉丝重新提交。 ### 如何确认地址是哪位粉丝提交的？ 每条地址记录都关联了粉丝的 B 站 UID，可以在列表中查看，点击可跳转其 B 站个人空间。 ### 临时链接过期了粉丝还能提交吗？ 不能。链接过期后页面会提示「链接已失效」，并引导粉丝去你的个人空间固定链接提交（需登录并绑定 B 站，且免审核）。 ### 地址信息会保存多久？ 地址信息会持久保存，直到你手动删除。 --- ## 年度分析 URL: https://2some.ren/docs/oh-gift/analyze 描述: 查看 2024 / 2025 直播数据年鉴 # 年度分析 年度分析模块提供全面的直播数据年鉴，帮助你了解收入结构和趋势。目前支持 **2024** 和 **2025** 两份年鉴，两者的开放方式不同。 ## 2024 年鉴（完全免费） 2024 直播数据年鉴全部内容免费、无需充值，直接打开即可查看，包含： - **年度收入汇总**：全年收入总结 - **日收入图表**：每日收入趋势 - **直播场次列表**：每场直播的详情 - **直播时长热力图**：全年每天的直播频率 - **直播场次趋势**：多维度场次指标趋势 - **分区占比分析**：各分区场次 / 时长 / 收入占比 - **礼物类型**：总督 / 提督 / 舰长等礼物占比 ## 2025 年鉴（自助解锁 + 数据授权） 打开 2025 年鉴需要两步： 1. **解锁权限**：达到充值 **VIP 1**，即有效月充值满 **¥10**，自动解锁（自助，无需联系客服）。未达门槛时页面会显示当前有效月充值与还差金额，点「解锁此功能」跳转余额充值页。 2. **同意数据授权**：首次进入需阅读并同意数据使用条款（数据分析授权、匿名聚合、数据保护承诺等），同意后才显示年鉴内容。 解锁是自助的：有效月充值达到 ¥10 即可。有效月充值取近 30 天成功充值总额与过去 365 天成功充值总额除以 12 的较高值。入口在年鉴页内点「解锁此功能 →」跳到余额充值页。 ### 基础模块（解锁后可见） - **年度收入汇总**：全年收入总结 - **日收入图表**：每日收入趋势 ### 高级模块（解锁后可见） 2025 年鉴的高级模块比 2024 更丰富，涵盖： - **SC 分析**：超级留言收入占比、数量趋势、平均价格 - **礼物收入结构**：总督 / 提督 / 舰长 / SC / 其他的收入占比 - **直播场次详情**：每场开播时间、时长、标题、分区、收入、人气、弹幕、新增关注与舰长 - **直播时长热力图**：GitHub 风格的全年直播频率 - **直播场次趋势**：收入、人气、互动、新增关注 / 舰长等趋势，按日 / 周 / 月切换 - **分区占比分析**：各分区场次 / 时长 / 收入占比 - **内容效率分析**：各分区营收效率（元/小时）与互动效率（弹幕/小时） - **互动漏斗分析**：进房 → 关注 / 点赞 / 分享的转化漏斗 - **观看时长分析**：平均在线人数、人均观看时长及其与收入的相关性 - **礼物类型趋势**：各类高价值礼物占比趋势 - **用户行为分析**：Top 送礼用户、用户价值分层、忠诚度 - **粉丝留存分析**：上一年付费用户的留存与收入贡献 - **时间模式分析**：黄金开播时段与最佳开播日 - **直播时长建议**：单场收益与时薪效率的平衡点 - **营收驱动力分析**：相关性分析找出影响收入的关键指标 - **综合效率指标**：收入 / 人气 / 互动 / 观看效率雷达图 - **收入集中度分析**：帕累托与基尼系数 - **增长趋势分析**：月度增长率与加速度 - **收入稳定性分析**：标准差、变异系数等波动指标 - **内容质量评分**：每场直播的综合质量评分 - **异常场次检测**：用 Z-score 识别表现异常的场次 ## 首页概览 礼兮首页会展示一组实时概览（非年鉴内容）：今日 / 近 7 天的消费人数、最近直播表现、大航海在舰概况等，帮你快速了解近况。 ## 常见问题 ### 为什么数据与 B 站后台不一致？ 可能原因： 1. 数据同步延迟 2. 浏览器扩展或桌面端未运行期间的数据缺失 3. 统计口径差异 ### 如何修复缺失的数据？ 前往「礼兮 → 工具 → 数据修复」（公测中）： 1. 进入数据修复页，点「重置数据」 2. 输入登录密码二次确认（操作不可逆，会删除最近三个月的礼物数据） 3. 重置后保持浏览器扩展或桌面端运行，等待数小时重新抓取 数据修复会删除最近三个月的礼物数据且不可恢复。如果重置后仍缺数据：可能是同步中（继续等待）或 B 站侧尚未同步（等 1-2 天后重试）。 --- ## 礼物统计 URL: https://2some.ren/docs/oh-gift/gift 描述: 筛选高价值粉丝，并用 AI 一键生成感谢信 # 礼物统计 礼物统计模块帮助你分析直播间的礼物收入，筛选高价值粉丝，并为他们一键生成感谢信。 礼兮提供两个互补的筛选工具，门槛口径不同： - **礼品金额筛选**：按「单笔礼物单价」找送过大额单礼的粉丝 - **消费金额统计**：按「累计消费总额」找高总额粉丝，并给出消费次数、平均单次等维度 ## 礼品金额筛选 按单笔礼物单价门槛筛选，找出送过大额单礼的粉丝。 ### 筛选条件 - **日期范围**：选择统计的时间段 - **礼物单价门槛**：只保留单笔单价 ≥ 门槛的礼物。预设档位：≥1 / 10 / 50 / 100 / 138 / 500 元（也可填不限或自定义） ### 显示字段 | 字段 | 说明 | |------|------| | 用户 | 头像 + 昵称 + UID | | 最后礼品日期 | 该用户最近一次送礼日期 | | 总瓜子 | 区间内累计瓜子（hamster）数量 | | 消费金额(≥门槛) | 金瓜子折算人民币（金瓜子 ÷ 1000 元） | | 银瓜子 | 累计银瓜子（silver）数量 | 「总瓜子」「银瓜子」列只在存在银瓜子数据时显示。消费金额由金瓜子按 1000 金瓜子 = ¥1 折算。 ## 消费金额统计 按用户累计消费总额门槛筛选，适合找出全程贡献最高的核心粉丝。 ### 筛选条件 - **日期范围**：选择统计的时间段 - **消费总额门槛**：只保留累计消费 ≥ 门槛的用户。预设档位：≥100 / 500 / 1000 / 2000 / 5000 / 10000 元 ### 显示字段 | 字段 | 说明 | |------|------| | 用户 | 头像 + 昵称 + UID | | 总消费金额 | 区间内累计消费（元） | | 消费次数 | 送礼笔数 | | 平均单次消费 | 总消费 ÷ 消费次数 | | 最高单次消费 | 单笔最大金额 | | 最后消费时间 | 最近一次消费日期 | 导出的 CSV 会在表头额外附上统计汇总：总消费金额、消费用户数、平均每用户消费、最高消费用户。 ## AI 一键生成感谢信 在两个筛选页里都可以勾选若干粉丝，调 AI 按每人的礼物明细生成个性化感谢信。 1. 在筛选结果里勾选要感谢的粉丝（表格支持多选） 2. 点底部「生成感谢信」打开侧栏 3. 系统先加载这些粉丝的礼物明细，AI 据此为每人逐封生成 4. 在侧栏里逐封**编辑**内容，或点「重新生成」整体重写 5. 单封「复制」或「复制全部」拿去发送 在桌面客户端里，生成后可直接「发送私信」或「全部发送」批量发 B 站私信，带发送进度、暂停 / 继续 / 停止控制。网页端则提供复制功能。 生成感谢信不参与限免活动，始终 ¥1/次（新用户 7 天试用期除外）。调用前账户需至少保留 ¥0.5 额度，否则会提示余额不足。AI 生成的文案不会涉及金额、礼物价格等敏感信息。 ## 礼物分类参考 礼兮用礼物 ID 识别礼物类型，常见映射： | 礼物 ID | 名称 | 说明 | |---------|------|------| | 10001 | 总督 | 大航海最高等级 | | 10002 | 提督 | 大航海中等等级 | | 10003 | 舰长 | 大航海基础等级 | | 12000 | 醒目留言 | Super Chat（SC） | 礼品金额筛选与消费金额统计会聚合区间内的全部礼物；只统计大航海购买记录的是「大航海管理 → 消费记录」。SC 等礼物结构占比在 [年度分析](/docs/oh-gift/analyze) 里有专门图表。 ## 计费说明 | 操作 | 单价 | 当前状态 | |------|------|------| | 礼品金额筛选 | ¥1 / 次 | 长期免费 | | 消费金额统计 | ¥1 / 次 | 长期免费 | | 导出筛选结果 | ¥0.1 / 条 | 按余额扣费 | | 生成感谢信 | ¥1 / 次 | 始终收费，需至少保留 ¥0.5 余额 | 新用户注册 7 天内全部计费功能免费。完整价格见 [/pricing](/pricing)。 大量数据查询可能需要较长时间，请耐心等待。 --- ## 快速开始 URL: https://2some.ren/docs/oh-gift 描述: 快速了解礼兮 Oh Gift 的核心功能 # 快速开始 礼兮 Oh Gift 是一个 All-in-one 粉丝维护工具，专为 B 站主播设计。帮助你管理大航海、统计礼物收入、收集粉丝地址、生成感谢信。 ## 开始使用 1. [登录](/docs/account/login-register) 2SOMEone 账号 2. 绑定你的 B 站账号 3. 安装浏览器扩展或桌面端，开始同步直播数据 4. 进入「控制台」→「礼兮」 礼兮需要通过浏览器扩展或桌面端实时同步 B 站直播数据。首次使用前请确保扩展已正确安装并登录。未绑定 B 站账号或暂无数据时，功能会提示你先完成绑定与同步。 ## 核心功能 | 功能 | 说明 | |------|------| | [大航海管理](/docs/oh-gift/voyage) | 在舰回顾查询、消费记录查询、附带地址导出 | | [礼物统计](/docs/oh-gift/gift) | 礼品金额筛选、消费金额统计、AI 感谢信、数据导出 | | [地址管理](/docs/oh-gift/address) | 三种方式收集粉丝地址、审核、批量导出 | | [年度分析](/docs/oh-gift/analyze) | 2024 / 2025 直播数据年鉴 | ## 数据来源 礼兮的数据通过以下方式获取： - **浏览器扩展 / 桌面端**：持续运行时上报直播间的礼物、弹幕、大航海、直播场次数据 - **B 站 API**：补充获取历史数据和用户信息 大航海在舰名单每天自动抓取一次，如果某天未能成功抓取，该日数据将无法补录。请保持浏览器扩展或桌面端稳定运行，确保长期同步。数据有缺时可用「数据修复」重新抓取。 ## 计费说明 礼兮的功能分两类计费，请按下表区分： - **查询类**（在舰回顾、消费记录、礼品金额筛选、消费金额统计）：当前长期免费。 - **导出类**（导出名单、导出带地址名单）：限时免费已于 **2026 年 6 月 1 日**结束，现按下表单价从余额扣费。 - **生成感谢信**：不参与限免活动，始终 ¥1/次。 如不想充值，可通过每日签到、邀请好友和任务系统持续获得余额。礼兮首页提供「做任务赚余额」「充值享赠送」入口。 ### 单价一览 | 功能 | 单价 | 当前状态 | |------|------|---------| | 在舰回顾查询 | ¥1 / 次 | 长期免费 | | 消费记录查询 | ¥1 / 次 | 长期免费 | | 礼品金额筛选 | ¥1 / 次 | 长期免费 | | 消费金额统计 | ¥1 / 次 | 长期免费 | | 导出名单（仅名单） | ¥0.1 / 条 | 按余额扣费 | | 导出带地址名单 | ¥0.1 / 有效地址条 | 按余额扣费，仅对能收件的地址计费 | | 生成感谢信 | ¥1 / 次 | 始终收费 | 新注册用户享有 7 天免费试用期，试用期内所有计费功能（含生成感谢信、导出）均免费。试用期与限免可叠加。完整定价表见 [/pricing](/pricing)。 --- ## 大航海管理 URL: https://2some.ren/docs/oh-gift/voyage 描述: 查询在舰名单和大航海消费记录，按需附带地址导出 # 大航海管理 大航海管理模块帮助你追踪和管理所有购买过大航海（总督 / 提督 / 舰长）的粉丝。 ## 在舰回顾 按日期查看某天的大航海在舰名单。 ### 查询方式 1. 在左上角的「选择日期」下拉里挑一天，系统会列出近两个月每天的在舰人数 2. 选中后自动拉取该日的在舰名单 3. 需要时点「导出」附带或不附带地址下载 大航海在舰名单每天自动抓取一次。如果某天未能成功抓取，该日数据将无法补录。请保持浏览器扩展或桌面端稳定运行。 ### 显示信息 表格只显示两列： | 字段 | 说明 | |------|------| | 更新时间 | 该条在舰记录的抓取时间 | | 用户 | 等级（总督 / 提督 / 舰长）+ 昵称，点击可跳转 B 站个人空间（UID） | ### 附带地址导出 在舰名单可以与地址信息关联导出： - 导出「仅名单」：含 UID、用户名、等级 - 导出「附带地址」：额外带上收件人、联系电话、地址，仅对**有效地址**（已审核、姓名 + 电话 + 地址齐全）计费 导出带地址时只对真正能收件的地址按 ¥0.1/有效地址条计费。例如 100 人上舰、50 人有有效地址，导出附带地址只收 ¥5；空地址不计费。 ## 消费记录 查看大航海的历史购买记录，只统计大航海礼物（总督 / 提督 / 舰长）。 ### 筛选条件 - **时间范围**：用日期范围选择器选定开始和结束日期，点「查询」拉取该区间的记录 ### 显示与导出字段 表格与导出包含以下字段： | 字段 | 说明 | |------|------| | 赠送时间 | 购买大航海的时间 | | 用户 | 等级 + 昵称 / UID | | 数量 | 购买数量 | | 消费额（元） | 该笔购买的人民币金额 | 导出「附带地址」时额外带上收件人、联系电话、地址。 查询类（在舰回顾、消费记录）当前长期免费；导出类的限免已于 2026 年 6 月 1 日结束，现按下表从余额扣费。账户余额可通过签到、邀请好友和任务系统补充。 ## 计费 | 操作 | 单价 | 当前状态 | |------|------|------| | 在舰回顾查询 | ¥1 / 次 | 长期免费 | | 消费记录查询 | ¥1 / 次 | 长期免费 | | 导出名单（仅名单） | ¥0.1 / 条 | 按余额扣费 | | 导出带地址名单 | ¥0.1 / 有效地址条 | 按余额扣费，仅对能收件的地址计费 | 新用户注册 7 天内全部计费功能免费。完整价格见 [/pricing](/pricing)。 ## 大航海等级 礼兮内部用等级名与礼物 ID 对应识别大航海购买： | 等级 | 名称 | 礼物 ID | |------|------|---------| | 1 | 总督 | 10001 | | 2 | 提督 | 10002 | | 3 | 舰长 | 10003 | 大航海的具体开通价格以 B 站官方为准，礼兮不在产品内固化金额。 ## 数据更新 - 大航海名单每天自动抓取一次，礼物 / 消费记录靠扩展或桌面端持续运行上报 - 页面顶部显示最新同步时间 - 如发现数据缺失或异常，前往「礼兮 → 工具 → 数据修复」重新抓取 --- ## 关注与信息流 URL: https://2some.ren/docs/social/follow-feed 描述: 关注 / 取消关注、粉丝与关注列表、首页「为你推荐 / 关注」双信息流 # 关注与信息流 首页就是 2SOMEone 的内容广场。打开主页（[2some.ren](https://2some.ren) / [2some.one](https://2some.one)）顶部有两个 tab：**为你推荐** 和 **关注**。建立关注关系，你的内容就能被更多人刷到，粉丝也能第一时间收到你的更新。 ## 首页双信息流 | 信息流 | 看到什么 | 谁能看 | |--------|----------|--------| | **为你推荐** | 全站公开动态，按发布时间从新到旧排列 | 未登录访客和登录用户都能看，是默认打开的那个 tab | | **关注** | 你关注的人发的动态 | 需要登录；未登录时这个 tab 会提示你先注册 / 登录 | 两个流都是无限滚动，往下翻自动加载更多。 - **为你推荐**是你的站外引流落地面：陌生人能在这里刷到你的公开泡泡，是涨粉的主要入口。 - **关注**流只在你关注了人之后才有内容。一个人都没关注时，会提示你「去探索关注」或「找人」。 登录后，首页顶部和右下角的加号都能发泡泡。公开泡泡会同时进「为你推荐」广场和你粉丝的「关注」流。 ## 关注与取消关注 在别人的个人主页或任意动态卡片上，点关注按钮即可关注 TA；再点一次取消关注。 - 关注是**单向**的，不需要对方同意。 - 你**不能关注自己**。 - 关注成功后，对方会收到一条「新增关注」通知（也可能收到推送，取决于对方的[通知设置](/docs/social/notifications)）。 ## 粉丝与关注列表 每个人的主页都能看到 **关注数** 和 **粉丝数**，点进去就是列表： | 列表 | 内容 | 路径 | |------|------|------| | TA 关注的人 | 这个人关注了哪些账号 | `/<用户名>/following` | | TA 的粉丝 | 哪些账号关注了这个人 | `/<用户名>/followers` | 列表里每个人旁边都有关注按钮，可以直接在列表里关注 / 取关。从别人的关注列表发现同好继续关注，是扩大社交圈的常见路径。 ## 互相关注 = 互关好友 当你和某人**互相关注**时，你们就成了「互关好友」。互关关系会影响一些隐私权限，比如： - 谁能给你发私信、谁能把你拉进群（见[聊天隐私设置](/docs/chat/privacy-settings)） - 你的在线状态对谁可见（见[信件与隐私 · 在线状态](/docs/social/letters-privacy#在线状态可见性)） ## 看不到某些内容？ 首页两个流都会自动帮你过滤掉： - 你拉黑的人、以及拉黑了你的人的动态 - 你举报过的内容（举报后立刻对你自己隐藏） 拉黑和举报的细节见[信件与隐私](/docs/social/letters-privacy)。 --- ## 社交互动 URL: https://2some.ren/docs/social 描述: 关注与粉丝、首页双信息流、通知中心、信件公开与隐私的总览 # 社交互动 社交互动是 2SOMEone 的「人和内容连起来」的那一层。你发的泡泡动态会进公开广场被陌生人刷到，关注你的粉丝第一时间看到你的更新，别人的关注、评论、@ 都会汇总进通知中心。这组文档讲清楚这些功能怎么用。 ## 包含哪些内容 | 页面 | 讲什么 | |------|--------| | [关注与信息流](/docs/social/follow-feed) | 关注 / 取消关注、粉丝与关注列表、首页「为你推荐 / 关注」双信息流 | | [通知中心](/docs/social/notifications) | 通知三分类、官方公告、完整的通知偏好设置（渠道开关、投递模式、内容预览、勿扰时段、短信） | | [信件与隐私](/docs/social/letters-privacy) | 把树洞信件公开成动态、拉黑管理、在线状态可见性、举报 | ## 几个关键概念 - **泡泡（动态）**：你在首页发的原创内容。公开的泡泡会进「为你推荐」广场，也会进你关注者的「关注」流。 - **关注关系**：单向关注。你关注谁，谁的新动态就进你的关注流；互相关注则成为「互关好友」，影响私信、在线状态等权限。 - **通知中心**：粉丝互动、新增关注、系统提醒的集中收件箱，和「通知设置」里的提醒方式是两回事——前者是「收件箱」，后者是「在哪台设备响铃」。 在线状态可见性、谁能私信你、谁能拉你进群这些开关在「聊天设置」里，详见[聊天 / 私信 / 群聊 · 隐私与设置](/docs/chat/privacy-settings)。本组文档只补充其中与社交互动直接相关的部分。 --- ## 信件与隐私 URL: https://2some.ren/docs/social/letters-privacy 描述: 把树洞信件公开成动态、拉黑管理、在线状态可见性、举报 # 信件与隐私 这一页讲社交互动里和隐私、可见性相关的功能：把收到的树洞信件公开回答、拉黑骚扰者、控制谁能看到你在线、以及举报内容。 ## 公开树洞信件 收到的树洞信件（letter）默认只有你自己能看正文。作为收件人，你可以一键把某封信**公开**成一条动态泡泡，让它进入公开广场被大家讨论——这是「收稿 → 公开回答」的关键一步，把优质私信变成内容素材。 ### 怎么公开 1. 在收到的信件里选择「公开」。 2. 可以附一段**公开评论**（你的回答 / 点评），最多 **500 字**，会经过内容审核。 3. 公开后会生成一条引用这封信的泡泡，进入信息流被陌生人刷到。 公开的限制和规则： | 规则 | 说明 | |------|------| | 谁能公开 | **只有收件人**能公开自己收到的信，别人不行 | | 被标记不适宜的内容 | 无法公开 | | 公开评论 | 选填，≤ 500 字，过审核才会发出 | | 公开后正文 | 信件正文这时才对所有人可见；没公开前外人只能看到收发双方的轮廓信息 | | 投稿者通知 | 公开后会通知投稿者「你的投稿被公开了」（匿名投稿不暴露身份） | ### 撤回公开 你可以随时**撤回**已公开的信，对应的公开泡泡会被收起、不再被别人看到。撤回后还能再次公开，恢复原来的讨论。 即使把匿名投稿公开，投稿者的身份也不会暴露；公开评论和正文走的是内容本身，不带投稿者信息。 ## 拉黑用户 被人骚扰时，可以拉黑对方。 - 在对方主页或动态上选择拉黑，即可加入你的拉黑名单。 - 「设置」里能查看和管理**拉黑列表**，随时取消拉黑。 - **不能拉黑自己**。 拉黑生效后，会从多个地方**双向隔离**你和对方： - 首页「为你推荐」和「关注」流互相看不到对方的动态。 - 转发动态也会被过滤（你、原作者、转发者之间任意一对拉黑，这条转发都不进你的关注流）。 - 在线状态互相不可见。 - 私信也无法互发（详见[聊天隐私设置](/docs/chat/privacy-settings)）。 ### 匿名场景下按投稿拉黑 匿名树洞场景下，你不知道对方是谁，但仍能屏蔽 TA。在某条匿名投稿上选择「拉黑投稿者」，系统会在后台找到投稿者并拉黑——**全程不向你暴露对方身份**。只有该投稿的收件人能这样操作。 ## 在线状态可见性 你可以控制谁能看到你的「在线」和「最近活跃」状态。这个开关在「设置」→「聊天」里（`/dashboard/settings/chat`）。 | 选项 | 谁能看到 | |------|----------| | 所有人 | 任何登录用户（含陌生人）都能在你的主页、动态卡片等位置看到 | | 互关好友 | 仅互相关注的好友能看到 | | 仅我自己 | 谁都看不到 | 要点： - 新用户默认对**所有登录用户公开**。 - 改成「所有人」时会弹**二次确认**——Instagram、TikTok 等平台都不提供这个选项，只在互关好友间显示在线。想和它们保持一致就选「互关好友」。 - 「在线」的判定是**最近 90 秒内有活跃**。 - 拉黑的人之间互相看不到在线状态。 直播中属于公开直播状态，不受这项设置影响，始终会公开展示。 完整的聊天隐私开关（私信权限、群邀请、已读回执）见[聊天 / 私信 / 群聊 · 隐私与设置](/docs/chat/privacy-settings)。 ## 举报内容 刷到违规内容可以举报。支持举报这些对象： - 动态（泡泡） - 投稿 - 信件 - 评论 - 文章 - 用户 举报后，**该内容会立刻从你自己的首页双流里消失**，不用等平台处理。你不能举报自己；同一对象重复举报会提示已举报过。 --- ## 通知中心 URL: https://2some.ren/docs/social/notifications 描述: 通知三分类、官方公告，以及渠道开关、投递模式、内容预览、勿扰、短信的完整设置 # 通知中心 通知中心帮你集中查看粉丝互动和系统提醒，不漏掉关注、评论、被引用这些关键反馈。它分两块：**通知收件箱**（看消息）和**通知设置**（控制在哪台设备响铃）。 ## 通知收件箱 进入控制台的「通知」页（`/dashboard/chat/notifications`）就能看到所有通知。 - 未读通知左侧有一个**红点**。 - 点开任意一条会自动标为已读，有链接的会跳到对应内容。 - 右上角「**全部已读**」一键清空所有未读。 - 列表底部「**加载更多**」翻看历史通知。 ### 三个分类 通知按内容归到三类： | 分类 | 包含 | |------|------| | **互动** | 回复、@ 提及、引用、转发、文章评论 | | **关注** | 有人新关注了你 | | **系统** | 点歌许愿、直播日程、群聊开播提醒、日程开播提醒、官方公告，以及其他系统提醒 | **树洞投稿**的提醒在树洞自己的入口管理，不进通知中心；**「关注的人发新动态」**也不进通知中心——这类提醒量大、容易刷屏，放在信息流里看更合适。它们仍可以通过推送提醒，开关在下面的通知设置里。 ## 官方公告 停服维护、隐私政策更新等平台级重要消息，会以**高亮卡片**置顶显示在通知列表顶部。 - 点击卡片可跳转到公告详情（如果带链接），并自动标为已读。 - 卡片右上角有个 **X**，可以单独**隐藏**看过的公告，让界面保持清爽。 - 点「全部已读」时，公告也会一并标记为已读。 ## 通知设置 通知设置在控制台「设置」→「通知」（`/dashboard/settings/notifications`），决定**每类提醒在哪台设备响、要不要响**。分成「全局」和「按主题」两层。 ### 全局设置 全局设置同时影响网页本地提醒和移动推送。 #### 内容预览 控制通知里展示多少消息内容，保护锁屏隐私。 | 选项 | 效果 | |------|------| | 完整内容 | 展示发送者和消息正文 | | 仅发件人 | 展示发送者，不展示正文 | | 通用 | 统一显示为「你收到一条新消息」 | 默认是**仅发件人**。 #### 勿扰时段 打开后，在你设定的时间段内**不发本地提醒、不发移动推送**。 - 需要同时填写**开始时间、结束时间、时区**，三者缺一不可，否则无法开启。 - 时区默认按你的设备自动识别，也可以从常用时区里手动选。 - 对作息不规律的主播尤其实用，夜里不会被吵醒。 ### 按主题设置 每一类提醒（「主题」）都能单独配置。下面是设置页里能看到的主题： | 分组 | 主题 | |------|------| | 聊天 | 私信通知、群组通知、**群聊开播提醒**、提及消息、入群申请 | | 树洞 | 收到新投稿、重要收稿提醒、投稿公开、投稿回复 | | 社交 | 新增关注、@ 提及、文章评论、新动态 | | 日程 | 日程提醒、开播提醒、B 站预约同步 | | 系统 | 官方公告 | 每个主题可以单独设置两样东西。 #### 提醒方式（投递模式） 决定这类消息优先发到哪类设备： | 选项 | 说明 | |------|------| | 所有已开启设备 | 移动端和桌面端都尽量提醒 | | 优先网页 / 桌面 | 当前在线时优先本地提醒，否则走移动推送 | | 仅移动端 | 只发移动推送 | | 仅网页 / 桌面 | 只显示网页 / 桌面本地提醒 | | 关闭 | 这类消息不发任何提醒 | #### 四个渠道开关 在投递模式之上，还能逐个开关具体入口（不同主题支持的渠道不同，不支持的不会显示）： - 移动推送 - 桌面端本地提醒 - 网页通知 - 应用内提醒 「日程提醒」「开播提醒」「群聊开播提醒」支持移动推送、网页通知和应用内提醒，不含桌面端本地提醒；「B 站预约同步」只支持应用内提醒。设置页只会显示该主题真正支持的开关。 「群聊开播提醒」和「开播提醒」不是同一件事：前者是你所在群的群主开播，后者是你订阅日程的主播实际开播。完整区别见 [开播通知](/docs/live-tools/go-live-notify)。 ## 短信提醒 部分树洞主题支持短信，离开 App 也能靠短信不漏掉重要投稿。短信在对应主题卡片里有单独的策略选择： | 策略 | 说明 | |------|------| | 默认不通知 | 这类消息不发短信 | | 每天前 3 篇 | 每天最多发前 3 条短信 | | 全部通知 | 每条符合条件的消息都发短信 | 涉及短信的主题有两个： | 主题 | 计费 | 默认 | |------|------|------| | 收到新投稿 | 每条约 **0.1 元** | 默认关闭，自己按需打开 | | 重要收稿提醒 | 由**平台承担费用**（免费） | 长时间未上线时由平台短信召回你回来处理 | 「收到新投稿」的短信按条计费（约 0.1 元 / 条），从你的余额扣除，默认是关闭的。要不要开、开多大量级，自己拿主意。 ---