LingTongAsk 环境配置指南

更新日期: 2026-04-03

📋 快速开始

1. 创建配置文件

# 在项目根目录执行
cp .env.lingtongask.example .env

2. 填写配置信息

打开 .env 文件，根据实际情况填写以下信息：

🔧 必填配置

AI API (用于内容生成)

# 选择一个 AI 服务商
ANTHROPIC_API_KEY=sk-ant-xxx        # Claude API
# 或
OPENAI_API_KEY=sk-openai-xxx        # ChatGPT API

获取方式: - Anthropic: https://console.anthropic.com/ - OpenAI: https://platform.openai.com/

TTS 语音合成

# 选择 TTS 引擎
TTS_ENGINE=edge                    # 推荐：免费可用

可用选项: - edge: EdgeTTS (免费，开箱即用) - azure: Azure TTS (需要密钥) - doubao: 豆包 TTS (需要密钥)

B站配置

方式一：使用 Access Token (推荐初期)

BILIBILI_ACCESS_TOKEN=your_token

获取方式: 1. 登录 B站 2. 打开浏览器开发者工具 (F12) 3. 在 Network 中找到请求，查看 Cookie 中的 bili_jct 或类似字段 4. 或使用开放平台申请的 token

方式二：使用 OAuth (用于自动化)

BILIBILI_CLIENT_ID=your_client_id
BILIBILI_CLIENT_SECRET=your_client_secret

微信公众号配置

WECHAT_MP_APP_ID=wxxxxxxxx
WECHAT_MP_APP_SECRET=xxxxxxxxxx

获取方式: 1. 登录 https://mp.weixin.qq.com/ 2. 进入「开发」→「基本配置」 3. 获取 AppID 和 AppSecret

📂 可选配置

其他平台 (Phase 2)

喜马拉雅、抖音、小红书等，根据需要配置

输出目录

OUTPUT_DIR=./episodes          # 内容目录
AUDIO_DIR=./episodes/audio     # 音频目录
VIDEO_DIR=./episodes/video     # 视频目录

日志配置

LOG_LEVEL=INFO                 # 日志级别: DEBUG/INFO/WARNING/ERROR
LOG_FILE=./logs/lingtongask.log

⚠️ 安全提醒

不要提交 .env 文件到 Git

# .gitignore 应该包含
.env
*.key
*_SECRET
*_TOKEN

妥善保管密钥
API 密钥等同密码
不要分享给他人
定期更换
使用不同环境的密钥
开发环境使用测试密钥
生产环境使用正式密钥

🔍 配置验证

验证脚本

import os
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()

# 验证必需配置
required_vars = [
    "ANTHROPIC_API_KEY",
]

missing = [var for var in required_vars if not os.getenv(var)]

if missing:
    print(f"❌ 缺少配置: {', '.join(missing)}")
else:
    print("✅ 配置完整")

📝 配置模板示例

最小化配置

# 只配置必需项
ANTHROPIC_API_KEY=sk-ant-xxx
TTS_ENGINE=edge

完整配置

# AI API
ANTHROPIC_API_KEY=sk-ant-xxx

# TTS
TTS_ENGINE=edge

# B站
BILIBILI_ACCESS_TOKEN=xxx

# 微信公众号
WECHAT_MP_APP_ID=wxxxx
WECHAT_MP_APP_SECRET=xxx

# 输出目录
OUTPUT_DIR=./episodes
AUDIO_DIR=./episodes/audio
VIDEO_DIR=./episodes/video

# 日志
LOG_LEVEL=INFO
LOG_FILE=./logs/lingtongask.log

🔄 配置更新

更新 Access Token

# 编辑 .env 文件
BILIBILI_ACCESS_TOKEN=new_token

# 重启应用或重新加载配置

轮换密钥

建议每3-6个月轮换一次 API 密钥。

🆘 常见问题

Q: 配置不生效？ A: 检查 .env 文件是否在项目根目录，确保没有拼写错误。

Q: 如何测试配置是否正确？ A: 运行 python tests/test_publish.py --bilibili auth 进行测试。

Q: 可以不配置某些平台吗？ A: 可以，未配置的平台会被跳过。

维护: 灵通更新: 按需更新