灵通问道使用说明书

每天10分钟，以气学为核心，贯通传统文化、道家智慧与现代养生实践

快速开始

安装

# 安装 LingFlow 核心框架
pip install -e /home/ai/LingFlow

# 安装 lingtongask
cd /home/ai/lingtongask
pip install -e .

配置

# 复制环境变量模板
cp .env.example .env

# 编辑配置文件
nano .env

必填配置：

# LingFlow API
ANTHROPIC_API_KEY=your-api-key-here

# 知识库路径（可选）
LINGFLOW_KB_PATH=/path/to/qigong/knowledge

生成你的第一期节目

# 最简单的方式 - 生成脚本
lingtongask generate "智能气功的呼吸法门"

# 完整流程 - 脚本+音频+PPT+视频
lingtongask generate "混元窍的奥秘" -s -p -v

完整工作流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  生成题目    │ -> │  生成脚本    │ -> │  合成音频    │ -> │  多平台发布  │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                                      │
       v                                      v
┌─────────────┐                        ┌─────────────┐
│  生成PPT     │                        │  生成视频    │
└─────────────┘                        └─────────────┘

第一步：生成题目

# 生成5个关于呼吸法门的题目
lingtongask generate-topics "关于呼吸法门" -n 5

# 交互式生成
lingtongask generate-topics -i

输出示例：

1. 智能气功的呼吸法门入门
   关键词: 呼吸, 混元窍, 意念
   时长: 10分钟 | 难度: beginner

2. 呼吸与意念的配合之道
   关键词: 呼吸, 意念, 练习
   时长: 10分钟 | 难度: intermediate

第二步：生成脚本

# 标准格式（10分钟）
lingtongask generate "智能气功的呼吸法门"

# 自定义时长
lingtongask generate "混元窍的奥秘" --duration 15

# 自定义主播名称
lingtongask generate "形神庄入门" --male-name "老师" --female-name "学员"

生成文件： - episodes/drafts/EP001_script.txt - 可读脚本 - episodes/drafts/EP001_data.json - 结构化数据

第三步：合成音频

# 使用 Mock TTS（测试）
lingtongask synthesize ./episodes/drafts/EP001_script.txt

# 使用 Edge TTS（免费，推荐）
lingtongask synthesize ./episodes/drafts/EP001_script.txt --voice edge

# 使用 OpenAI TTS（需要 API key）
lingtongask synthesize ./episodes/drafts/EP001_script.txt --voice openai

第四步：生成 PPT

# 生成30页 PPT（10分钟标准）
lingtongask generate-ppt ./episodes/drafts/EP001_data.json -p 30

第五步：合成视频

# PPT + 音频 = 视频
lingtongask compose-video EP001

第六步：多平台发布

# 发布到所有已配置平台
lingtongask multi-publish EP001 -p all

# 发布到指定平台
lingtongask multi-publish EP001 -p bilibili,douyin

# 延迟2小时发布
lingtongask multi-publish EP001 -p all --delay 2h

# 定时发布
lingtongask multi-publish EP001 -p all --schedule "2026-04-03 09:00"

命令参考

generate-topics - 生成题目

lingtongask generate-topics [OPTIONS] PROMPT

选项:
  -c, --category TEXT      指定分类
  -d, --difficulty TEXT    难度级别
  -n, --count INT          生成题目数量 [default: 5]
  -o, --output PATH        输出文件 [default: ./topics.json]
  -i, --interactive        交互式生成

generate - 生成脚本

lingtongask generate [OPTIONS] TOPIC

选项:
  --duration INT           时长(分钟) [default: 10]
  --wpm INT                语速(字/分钟) [default: 200]
  --male-name TEXT         男主播名字 [default: 灵通子]
  --female-name TEXT       女主播名字 [default: 慧心子]
  --tone TEXT              语调 [default: friendly]
  -s, --synthesize         生成后立即合成音频
  -p, --ppt                生成后立即生成PPT
  -v, --video              生成后立即合成视频
  --voice TEXT             TTS引擎 [default: mock]
  --ppt-pages INT          PPT页数 [default: 30]

synthesize - 合成音频

lingtongask synthesize [OPTIONS] SCRIPT_FILE

选项:
  --voice TEXT             TTS引擎 [mock, openai, edge]

generate-ppt - 生成PPT

lingtongask generate-ppt [OPTIONS] EPISODE_DATA

选项:
  -p, --pages INT          PPT页数 [default: 30]
  -o, --output PATH        输出文件路径

compose-video - 合成视频

lingtongask compose-video [OPTIONS] EPISODE_ID

选项:
  --ppt PATH               PPT文件路径
  --audio PATH             音频文件路径
  -o, --output PATH        输出视频路径
  --width INT              视频宽度 [default: 1920]
  --height INT             视频高度 [default: 1080]

multi-publish - 多平台发布

lingtongask multi-publish [OPTIONS] EPISODE_ID

选项:
  -p, --platforms TEXT     平台列表(逗号分隔)
  --all-platforms          发布到所有已配置平台
  --schedule TEXT          定时发布 (YYYY-MM-DD HH:MM)
  --delay TEXT             延迟发布 (如: 30m, 2h, 1d)
  --config PATH            平台配置文件

支持平台: - wechat_video - 微信视频号 - bilibili - 哔哩哔哩 - ximalaya - 喜马拉雅 - xiaoyuzhou - 小宇宙 - douyin - 抖音 - kuaishou - 快手 - xiaohongshu - 小红书

list-platforms - 列出平台

lingtongask list-platforms

显示所有支持的平台及其配置状态。

list-episodes - 列出节目

lingtongask list-episodes

显示所有已生成的节目及其文件状态。

optimize - 运行自优化

lingtongask optimize [OPTIONS]

选项:
  -t, --target CHOICE      优化目标 [all, script, tts, ppt, video, publish]
  -r, --report PATH        保存报告到文件

quality - 质量检查

lingtongask quality [OPTIONS] EPISODE_ID

选项:
  -o, --output PATH        保存报告到文件

常见问题

Q: 生成的脚本字数不对？

A: 检查 --duration 和 --wpm 参数。默认是10分钟×200字/分钟=2000字。

Q: 音频合成失败？

A: 1. 检查 TTS 引擎是否正确安装 2. Mock 模式不需要额外依赖 3. Edge TTS 需要安装 edge-tts 4. OpenAI TTS 需要 API key

Q: 如何批量生成？

A: 使用脚本循环：

#!/bin/bash
topics=("呼吸法门" "混元窍" "形神庄" "五元庄")

for topic in "${topics[@]}"; do
    lingtongask generate "$topic" -s -p -v
done

Q: 视频合成太慢？

A: 视频合成依赖于 PPT 页数和音频长度。建议： - 减少 PPT 页数 - 降低视频分辨率 - 使用更快的编码器

Q: 如何自定义主播风格？

A: 编辑 ScriptConfig 或使用 CLI 参数：

lingtongask generate "主题" \
  --male-name "老师" \
  --female-name "学员" \
  --tone "专业"

配置说明

环境变量 (.env)

# LingFlow 核心
ANTHROPIC_API_KEY=sk-ant-xxx
LINGFLOW_LOG_LEVEL=INFO

# 知识库
LINGFLOW_KB_PATH=/path/to/knowledge

# TTS
TTS_ENGINE=edge

# 发布平台
WECHAT_APP_ID=xxx
BILIBILI_ACCESS_TOKEN=xxx
XIMALAYA_APP_ID=xxx
DOUYIN_APP_ID=xxx

节目标准配置

参数	标准值	说明
单集时长	10分钟	灵通问道标准
语速	200字/分钟	舒适收听
总字数	~2000字	10分钟×200
PPT页数	30页	适配10分钟
主播	灵通子/慧心子	专业风格

节目文件说明

生成文件结构

episodes/drafts/
├── EP001_script.txt        # 可读脚本（带说话人标签）
├── EP001_data.json         # 结构化数据
├── EP001.mp3               # 音频文件
├── EP001.pptx              # PPT文件
├── EP001.mp4               # 视频文件
└── EP001_publish_result.json # 发布结果

脚本格式

# 智能气功的呼吸法门

## 节目信息
- ID: EP001
- 描述: 关于呼吸法门的深度对话
- 男主播: 灵通子
- 女主播: 慧心子
- 总字数: 2000
- 预估时长: 10分钟

## 脚本内容

### 👨 灵通子
大家好，欢迎收听灵通问道。我是灵通子。

### 👩 慧心子
我是慧心子。每天10分钟，以气学为核心，聊聊气功那些事儿。

...

高级用法

自定义对话结构

编辑 src/generator/script.py 中的 _create_dialogue_structure 方法。

添加新的 TTS 引擎

继承 TTSProvider 类，实现 synthesize 和 get_voices 方法。

扩展发布平台

在 PlatformType 中添加新平台
实现对应的发布器
配置平台凭证

获取帮助

# 查看所有命令
lingtongask --help

# 查看特定命令帮助
lingtongask generate --help
lingtongask multi-publish --help

版本信息

lingtongask --version
# 输出: lingtongask 0.1.0

最后更新: 2026-04-03

灵通问道 使用说明书

目录