intelligencesupport

网站

接入网站的 GitHub 仓库,排好简报队列,网站编辑便会逐篇调研、撰写、翻译,再通过 Pull Request 把每个页面发布上线。

适用对象
管理员与编辑
应用位置
/web/web/[id]
更新日期

观看视频

让网站模块为你的网站撰写并发布文章

网站模块负责发布你名下各个网站的页面。每个网站对应构建它的那个 GitHub 仓库。你给它排一份简报队列,AI 智能体 网站编辑 就会把每份简报从调研一路推进到网站上的正式页面。所有页面都经由 Pull Request 进入网站,而且只有网站自身的检查全部通过,Pull Request 才会合并。

本文写给负责运营网站的管理员和编辑。网站模块只对组织开放:在左侧菜单的创作板块点 网站 即可进入。

事先要准备什么

两样东西。一是你的角色要有 网站 这项权限(见谁能做什么);二是你要有自己的 GitHub 连接。

这个连接在我的连接页面的 您的网站仓库 卡片里,也可以直接在网站页面完成,经由 BearingBridge 的 GitHub 应用分两步接入:

  1. 在仓库中安装 GitHub 应用:在 GitHub 上选择你的个人或组织账号,授权访问你要发布的网站仓库。
  2. 授权并连接你的 GitHub 账号:点击 连接 GitHub,确认授权后回到网站页面,你的仓库列表就准备好了。

你的 GitHub 账号必须对该仓库有写权限,因为发布就是写入。

添加网站

  1. 点页面横幅里的 添加网站。
  2. 在 仓库 下,从你的 GitHub 连接能访问的仓库里选一个。找不到想要的仓库?点 在 GitHub 上为应用授权其他仓库,在那边加上,再回来。
  3. 填写网站的 名称。网站地址 可填可不填,品牌 也一样:保留 整个组织,网站就不归属任何品牌。
  4. 点 添加此网站。

网站工作台随即打开,包含四个标签页:队列与测试运行、AI 编辑计划、仓库文件与 AI 工作台 和 网站设置。如果仓库里已经有发布计划文件或简报文件夹,队列会立即导入。

设置从仓库里读出来

应用会读取仓库,给出一套建议设置。它会按编辑类仓库常见的文件名去找:CLAUDE.md 或 AGENTS.md、语气指南、规格说明、操作手册、事实台账、CSV 格式的发布计划、简报文件夹,以及每种语言各自的文件夹和翻译简报。请在 网站设置 标签页下逐项核对,改掉不对的地方,再点 保存设置。仓库有变动后,从仓库重新读取 会重新读一遍各个路径,你写的指令和各个开关保持不动。

部分字段作用
顶部名称、网站地址、发布身份、分支、默认 AI 模型、每次定时运行简报数、全站附加背景说明由谁提交,Pull Request 合并进哪个分支,撰写与 AI 工具默认使用的模型,以及传给每一步的常驻背景要求。
开关启用中、18 轮精修、自动发布、检查通过后自动合并定时运行是否处理这个网站,草稿是否走完整套 18 轮精修,草稿在审阅时是否需要人工批准,以及 Pull Request 是否自动合并。
网站规则与文件路径规则文件、事实台账、发布计划文件、简报文件夹、页面文件夹、草稿文件夹、头图文件夹各类文件放在哪里。点击任意文件标签,即可在 仓库文件与 AI 工作台 中打开或新建该文件。头图文件夹 留空,就没有头图这一步。
语言页面撰写语言、语言代码、其他语言先是源语言,再是每种附加语言各占一行:代码、名称、文件夹和翻译简报。
运行指令与 Git 命名撰写运行、发布运行、头图统一风格、分支前缀、提交说明、同时通知一次撰写或发布除了页面本身还要改动哪些地方,头图的视觉风格(每项均配有 根据仓库用 AI 起草 按钮),以及分支、提交和通知邮件的设置。

网站的规则留在它自己的仓库里,不放在应用中。你可以在 仓库文件与 AI 工作台 标签页中查看、编辑、新建或用 AI 更新每一个文件,并直接提交到网站分支。

发布身份 指定由哪位成员的 GitHub 连接来提交并发起 Pull Request。列表里只有已经连接 GitHub 的成员。提交记录署的是这位成员的名字,谁发布了什么,在 GitHub 上一目了然。

填充队列

队列里一个页面对应一份简报。在网站页面上有三种填充队列的方法。

导入队列 读取 发布计划文件,也就是一份带 brief_id 列的 CSV。网站没有发布计划文件时,就改读它的 简报文件夹,一个文件一份 Markdown 简报。导入完成后,应用会告诉你新增了几份简报、更新了几份。

撰写简报 会在 队列与测试运行 标签页打开一张表单:工作标题、页面对应的主搜索词、页面的 地址、排期日期 以及 内容简报 正文。点击 用 AI 生成或完善简报,即可让 AI 根据网站的语气与规则为你起草或润色简报。

AI 编辑计划 提供独立标签页,你可以选择 AI 模型、计划文章篇数,并输入主题重点或背景说明。点击 用 AI 起草完整编辑计划,即可一次性生成包含工作标题、目标搜索词、页面地址和完整 Markdown 简报的多篇排期方案。你可以在预览卡片中直接修改,然后点击 提交计划到仓库并加入队列,把所有简报文件和排期表行写入 GitHub 并同步进队列。

队列有三个筛选项(待发布、已发布 和 全部)以及搜索框。简报按排期日期先后处理,日期相同再看在队列中的位置。

简报要走哪些步骤

在队列中点选任意简报,右侧就会展开它的控制面板。启动前,你可以选择 本篇简报使用的 AI 模型,并填写 本篇简报的附加背景与指令。随后点击 在此简报上测试(停在审阅),运行一次安全测试并在 审阅 环节暂停,方便你在发起任何 Pull Request 前先检查文稿;或者点击 立即启动(或顶部横幅里的 启动下一份简报)。此后各个步骤每五分钟自动推进一次,也可以点 运行下一步 马上推进。

步骤做什么
调研智能体读取网站规则,查找一手来源。
草稿在草稿文件夹里写出页面。
18 轮精修草稿依次经过 18 轮编辑,最后一轮把 SEO 标题、描述和摘要写进页面。队列里会显示进度,比如 7/19。
来源复核每个来源再核对一遍。无法在来源处证实的事实,一律删去。
审阅草稿等待批准,或者自行往下走(见下文)。
头图生成头图及其替代文字。只有网站设了头图文件夹才有这一步。
发布准备页面移入页面文件夹,智能体接好页面的链接、头图,以及网站指令点名的相关页面。
翻译每种附加语言各做三轮母语级重写。
检查项应用自带的检查:不得留有 TODO、TBD 之类的待办标记,正文里不得出现长破折号或短破折号,每个页面都要有头部元数据,每种译文都要齐全且地址和字段与原文一致,不得有空文件。检查不过,智能体会修正原因后重试,最多两次。
Pull Request把所有文件合成一次提交,放在单独的分支上,再向网站分支发起 Pull Request。
网站检查仓库自己的检查在 Pull Request 上运行。
已发布Pull Request 合并,网站从它的分支部署上线。

同一个网站同一时间只撰写一份简报、只发布一份简报,两次发布绝不会同时改动同一批文件。已有简报正在撰写时,点 启动下一份简报 会提示没有可以启动的简报。

审阅

审阅 这一步怎么走,取决于 自动发布 开关。开着的话,来源复核过的草稿会自行进入发布。关着的话,草稿要等有修改权限的人来处理:点 批准并发布,它才往下走。

草稿若被网站规则拦下,会显示 暂缓 并附上原因。智能体下一次定时运行时会再试一次。

音频版与对谈

网站设置 中有两个开关,为每个新页面配上声音:

  • 音频版:用网站所属品牌的声音(品牌的 品牌声音套件)朗读已发布的页面。如果页面所用的语言与套件不同,则由该语言的同性别母语声音朗读。
  • 双人对谈:两位主持人用两到三分钟讨论这个页面,内容只取自页面本身。

只要打开其中一个,简报在翻译之后会多走一步:音频版。MP3 文件保存在设置中的 音频文件夹,按页面命名(<page>.mp3 和 <page>-discussion.mp3),与题图的做法完全一致。留空时,文件夹为 public/audio,即 Astro、Next.js 和 Vite 网站直接对外提供的文件夹。页面及其每个译本的 frontmatter 会加上 audio 和 discussion 字段,供自带播放器的模板使用;标题下方还会加上一个简单的 HTML 播放器,任何 Markdown 网站都能直接显示,播放器上的文字使用页面的语言。所有内容与页面放在同一个拉取请求中。

已发布的页面可以从其简报生成音频版:在队列中打开简报,点击 生成音频版。系统会按网站已打开的开关生成内容(两个开关都关闭时只生成音频版),通过单独的拉取请求提交 MP3 文件和播放器;整个过程中页面始终保持已发布状态,发布日期不变。录制费用与网站编辑的其他工作一样计费,并计入该简报的费用。

通过 Pull Request 发布

走到 Pull Request 这一步之前,仓库里什么都不会变。在此之前,运行写出的每个文件都保存在应用里,可以在简报的 文件 标签页逐个打开。

到了这一步,应用把这份简报的所有文件合成一次提交,放到一个新分支上。分支名由 分支前缀 加页面地址组成,不改设置的话就是 bb/ 加上地址。随后向网站分支发起 Pull Request,并在其中列出全部文件。网站有发布计划文件的,这份简报对应的那一行也在同一次提交里更新。

接下来运行仓库自己的检查。检查通过,且 检查通过后自动合并 开着,Pull Request 就自动合并,分支随之删除。开关关着,Pull Request 会留在 GitHub 上等人合并,合并之后简报才显示 已发布。

检查失败时,智能体会读取失败原因,修正后重新推送。最多尝试两次,之后简报停止。仓库如果根本没有设检查,十分钟后就凭应用自带的检查合并。检查运行超过 90 分钟仍未结束,简报同样会停止。

页面上线后,系统会给网站的发布人、启动这份简报的人,以及 同时通知 里填写的地址发一封邮件,写明网站、页面、简报、Pull Request、语言,以及这份简报的花费。每个人收到的都是自己语言的版本。

简报停下来意味着什么

网站编辑从不留下悬而未决的事项。无法证实的事实,要么查到出处,要么删去,绝不标记成以后再说。某一步收不了尾,简报就停在 已停止,原因显示在详情顶部,这份简报的任何内容都不会发布。

常见原因有:修了两次检查仍然不过,Pull Request 未经合并就被关闭,网站没有指定发布身份,或者发布人的 GitHub 连接已经断开。一时的故障,比如某次模型调用超时,会在下一次运行时重试,连续三次失败才会停下。

排除原因后,点 重新处理,简报会从停下的那一步重新开始。

注意: 组织的支出上限用满时,简报不会停止,而是暂停,等额度有了空间再继续。

跟进一份简报

点队列里的某份简报,详情会在旁边展开:上方是步骤,当前步骤高亮显示,下面是相关信息和可用操作。

  • 日志:每一步的时间,以及智能体做了什么、发现了什么。
  • 版本:每一轮之后的文本,从初稿到每一轮翻译都在。点开任意一版即可阅读。
  • 文件:这次运行写出的每个文件,删掉的也列在其中。点开可以阅读文件,或查看图片。
  • 简报与 AI:简报本身的 Markdown 文件,可以在这里查看、编辑或用 AI 润色,并直接提交到仓库。

详情里还有指向 Pull Request 的链接,比如 Pull Request #42,并显示这份简报到目前为止的 成本。

其他操作视简报所处的阶段而定。跳过 把简报暂时搁置,返回队列 再把它放回去。移除 把它从队列中删掉。正在发布的简报,在 Pull Request 结束之前既不能跳过,也不能移除。

网站编辑智能体

手动启动简报完全可行。想让网站按计划持续发布,就从智能体目录添加 网站编辑。和所有标准智能体一样,没人添加它就什么也不做。它的目录编号是 MK13,默认每 24 小时运行一次。

每次定时运行,都会为每个启用中的网站启动下一份简报。网站开了自动发布的,它还会放行在审阅环节等待的草稿;没开的,它会在发现里列出仍待批准的草稿。在网站设置里取消勾选 启用中,智能体的运行就不再处理这个网站。

对于每份简报,网站编辑优先使用你为该简报选定的 本篇简报使用的 AI 模型,其次是网站的 默认 AI 模型,再次是智能体上选定的模型,最后是你的组织在 AI 模型页面为 网站 设定的模型(再没有则用 Claude Opus)。头图则由单独的图像模型生成。

用到哪些技能

精修和翻译的各轮操作遵循四项标准技能,它们位于技能目录的 网站发布 分组,作用范围是 网站:

技能规定了什么
新闻编辑规范(美式英语)每一轮编辑的规矩:美国报纸的行文、美式拼写、不用长破折号、不编造事实。
母语级翻译规范每个译文页面读起来都像母语记者亲笔所写,标点符合该语言习惯,SEO 字段一并重写。
需清除的 AI 痕迹让文字显得出自机器的各种套路,由精修和翻译各轮负责清除。
头图规范头图应有的样子,以及各语言的替代文字。

在你的组织把某项技能加入自己的技能并改写之前,它们都按原样生效。发布人自己的版本优先于组织的版本。网站自己的规则文件在更严格的地方,始终优先。详见技能。

费用

一份简报运行期间的每一次模型调用、每一次网页搜索、每一张图片,都记在这份简报名下。队列每一行显示累计金额,详情里在 成本 下显示:这是向你收取的价格,已含全部费用。发布邮件里也会再列一次。

这些运行都计入你的组织,不论简报是谁启动的,在用量日志里显示为 网站 · 页面调研、撰写与发布。简报运行期间,进度也会显示在活动里。添加网站、导入队列、撰写简报都不收费。

移除网站或简报

设置底部的 移除此网站 会把网站和它的队列从应用中移除。简报上的 移除 则把这份简报移出队列。两者都不会动仓库:页面、简报和发布计划都原样保留。网站有页面正在发布时,不能移除。

在我的连接里断开 GitHub,所有借你的连接发布的网站都会停下,直到有人重新连接,并被指定为 发布身份。

谁能做什么

网站模块在权限格子里有自己的一行。详见角色与权限。

权限允许做什么
查看打开网站页面、各个网站及其队列。
新建添加网站、撰写简报或启动简报。
修改导入队列、更改网站设置、运行下一步,以及批准、重新处理或跳过简报。
删除移除网站或简报,仓库里的任何内容都不会删除。

网站模块仅供组织成员使用。