From a2b3fa179292f9ba696ad8899abe0d671042cdf7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=81=AB=E7=81=AB?= Date: Wed, 14 Oct 2026 05:08:35 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E7=99=BE=E6=99=BA?= =?UTF-8?q?=E7=A0=94=E7=A9=B6=E6=9D=90=E6=96=99=E6=88=90=E6=92=AD=E7=9A=84?= =?UTF-8?q?=E4=B8=AD=E8=8B=B1=E6=8C=87=E5=8D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 说明用户核实研究材料后通过现有文本上传制作节目，并同步导航与首期指南链接。 --- docs/.vitepress/config.mts | 4 +++ docs/en/guide/baizhi-research-to-podcast.md | 39 +++++++++++++++++++++ docs/en/guide/first-episode.md | 1 + docs/guide/baizhi-research-to-podcast.md | 39 +++++++++++++++++++++ docs/guide/first-episode.md | 1 + 5 files changed, 84 insertions(+) create mode 100644 docs/en/guide/baizhi-research-to-podcast.md create mode 100644 docs/guide/baizhi-research-to-podcast.md diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 1a73657..920ed63 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -20,6 +20,7 @@ function navZh(): DefaultTheme.NavItem[] { { text: '配置与环境变量', link: '/guide/configuration' }, { text: '部署', link: '/guide/deployment' }, { text: 'MCP 接入', link: '/guide/mcp' }, + { text: '百智研究材料成播', link: '/guide/baizhi-research-to-podcast' }, { text: '常见问题', link: '/guide/faq' }, ], }, @@ -69,6 +70,7 @@ function navEn(): DefaultTheme.NavItem[] { { text: 'Configuration', link: '/en/guide/configuration' }, { text: 'Deployment', link: '/en/guide/deployment' }, { text: 'MCP', link: '/en/guide/mcp' }, + { text: 'Baizhi research to podcast', link: '/en/guide/baizhi-research-to-podcast' }, { text: 'FAQ', link: '/en/guide/faq' }, ], }, @@ -121,6 +123,7 @@ function sidebarZh(): DefaultTheme.Sidebar { { text: '制作流水线', link: '/guide/pipeline' }, { text: '定时订阅', link: '/guide/schedule' }, { text: 'MCP 接入', link: '/guide/mcp' }, + { text: '百智研究材料成播', link: '/guide/baizhi-research-to-podcast' }, ], }, { @@ -217,6 +220,7 @@ function sidebarEn(): DefaultTheme.Sidebar { { text: 'Pipeline', link: '/en/guide/pipeline' }, { text: 'Schedules', link: '/en/guide/schedule' }, { text: 'MCP', link: '/en/guide/mcp' }, + { text: 'Baizhi research to podcast', link: '/en/guide/baizhi-research-to-podcast' }, ], }, { diff --git a/docs/en/guide/baizhi-research-to-podcast.md b/docs/en/guide/baizhi-research-to-podcast.md new file mode 100644 index 0000000..93ccea4 --- /dev/null +++ b/docs/en/guide/baizhi-research-to-podcast.md @@ -0,0 +1,39 @@ +--- +description: Review research returned through Baizhi MCP, prepare a text file, and make a private BokeBox episode. +--- + +# Make a private podcast from Baizhi research + +To turn material you have researched into a commute episode, use your existing [BaizhiCloud Agent Toolkit](https://baizhi.cloud/landing/agent-toolkit) MCP connection to research a topic, review and select the material yourself, then import your prepared script into BokeBox. + +You perform the source review and text handoff. This workflow is for users who already have a Baizhi MCP connection and have configured BokeBox using [Getting started](./getting-started.md). + +## 1. Research and check the material + +Use the Baizhi MCP connection in your existing AI client to research the topic. Inspect the actual returned content and available sources, open the original sources to check whether they support the claims, and check their dates and scope. + +Turn the verified material you have permission to use into a coherent script. Remove claims you cannot confirm, or clearly mark their uncertainty. Keep the source links and review dates in your own research records so you can revisit them. + +## 2. Save a text file + +Save the selected script as a **UTF-8 `.txt` file**, for example `baizhi-research-notes.txt`. The body must contain at least 20 characters; include a clear topic, key points, and enough context. + +Include only the content you intend to turn into an episode. Keep API keys, MCP tokens, and client configuration in their respective configuration locations. + +## 3. Import into BokeBox + +Follow [First episode](./first-episode.md) to check **Settings → AI services** and the script and voice models, persona, voice, and other production settings. Baizhi queries and BokeBox's configured model services each have their own terms and billing. + +**Selecting or dropping a file uploads it and creates a production job immediately.** Finish reviewing the script and settings first, then open **Local file** in the new-episode screen and select the `.txt` file. + +BokeBox treats the text as a script, skips ASR, and proceeds with script and audio production. Open the job details when it finishes, listen to the episode, and check the generated content. Model rewrites still need your review. + +If the upload reports that the text is too short, expand the script. If production fails later, use the job error and [FAQ](./faq.md) to check the configuration. + +## Related + +- [BaizhiCloud Agent Toolkit](https://baizhi.cloud/landing/agent-toolkit) +- [BokeBox project](https://github.com/vastsa/BokeBox) · [LGPL-3.0-only license](https://github.com/vastsa/BokeBox/blob/main/LICENSE) +- [First episode](./first-episode.md) + +This guide is contributed as part of community integration and promotion work for BaizhiCloud Agent Toolkit, under BokeBox's LGPL-3.0-only license. diff --git a/docs/en/guide/first-episode.md b/docs/en/guide/first-episode.md index e20c304..b526c5e 100644 --- a/docs/en/guide/first-episode.md +++ b/docs/en/guide/first-episode.md @@ -59,6 +59,7 @@ Details: [Pipeline](./pipeline.md). - [Schedules](./schedule.md) — RSS / charts on a timer - [MCP](./mcp.md) — create shows from Cursor +- [Baizhi research to podcast](./baizhi-research-to-podcast.md) — review the material, prepare text, and make a private episode - [Plugins](../plugins/) — more sources & voices ## Common snags diff --git a/docs/guide/baizhi-research-to-podcast.md b/docs/guide/baizhi-research-to-podcast.md new file mode 100644 index 0000000..e5cfc0e --- /dev/null +++ b/docs/guide/baizhi-research-to-podcast.md @@ -0,0 +1,39 @@ +--- +description: 核实百智 MCP 返回的研究材料，整理为文本，再用 BokeBox 制作私人播客。 +--- + +# 用百智研究材料制作私人播客 + +想把已经查过的资料整理成一集通勤节目，可以在已有的 [百智云 Agent Toolkit](https://baizhi.cloud/landing/agent-toolkit) MCP 连接中检索主题，自行核实和选取材料，再把整理好的文稿导入 BokeBox。 + +这条流程由你完成资料审核和文本交接。适合已有百智 MCP 连接，并已按 [快速开始](./getting-started.md) 配好 BokeBox 的用户。 + +## 1. 检索并核实材料 + +在你已有的 AI 客户端中使用百智 MCP 连接检索主题。查看实际返回的内容和可用来源，打开原始来源核实其是否支持相关说法，并检查日期和适用范围。 + +把已核实、你有权使用的部分整理成连贯文稿。对于不能确认的说法，先从文稿中移除或明确标注不确定性；把来源链接和核实日期保留在自己的资料记录中，方便回查。 + +## 2. 保存为文本 + +将选好的文稿保存为 **UTF-8 编码的 `.txt` 文件**，例如 `baizhi-research-notes.txt`。正文至少 20 个字符，最好包含清晰的主题、要点和上下文。 + +文件里只放准备制作成节目的内容。API Key、MCP Token 和客户端配置应留在各自的配置位置。 + +## 3. 导入 BokeBox + +先按 [做完第一期节目](./first-episode.md) 检查 **设置 → AI 服务**，确认口播和语音模型，以及人设、音色等制作设置。百智查询和 BokeBox 配置的模型服务各自适用其条款与计费。 + +**选择或拖入文件就会上传并创建制作任务**，因此请先完成文稿审核和设置，再打开新建节目的 **本地文件** 入口，选择该 `.txt` 文件。 + +BokeBox 将文本作为文稿处理，跳过 ASR，进入口播稿、语音等制作流程。完成后查看任务详情，试听并核对生成的节目；模型改写后的内容仍需你检查。 + +如果上传提示正文过短，请补充文稿；如果后续制作失败，按任务错误信息和 [常见问题](./faq.md) 检查配置。 + +## 相关 + +- [百智云 Agent Toolkit](https://baizhi.cloud/landing/agent-toolkit) +- [BokeBox 项目](https://github.com/vastsa/BokeBox) · [LGPL-3.0-only 许可证](https://github.com/vastsa/BokeBox/blob/main/LICENSE) +- [做完第一期节目](./first-episode.md) + +本指南作为百智云 Agent Toolkit 的社区接入与推广内容贡献，按 BokeBox 的 LGPL-3.0-only 协议提供。 diff --git a/docs/guide/first-episode.md b/docs/guide/first-episode.md index e4d007e..23be26b 100644 --- a/docs/guide/first-episode.md +++ b/docs/guide/first-episode.md @@ -61,6 +61,7 @@ description: 从零完成 BokeBox 第一期私人播客。 - [定时订阅](./schedule.md)：RSS / 榜单自动进匣 - [MCP 接入](./mcp.md)：用 Cursor 一句话创建节目 +- [百智研究材料成播](./baizhi-research-to-podcast.md)：核实材料、整理文本后制作私人节目 - [插件体系](../plugins/)：扩展内容源与音色 ## 常见卡点