Tracecast 是一个从本地长篇材料生成可追踪播客脚本的工具。它把来源切片、内容规划、材料取舍、 正文生成和审计分开记录，让用户可以从最终脚本回查材料来源、处理记录和模型调用。
一次成功 Run 会生成可继续编辑的播客脚本，并在 runs/<run-id>/ 中保留下列本地记录：
assembly/script.md：最终播客脚本；validation/audit_report.jsonl：跨阶段审计结果；llm/call_records.jsonl与llm/raw/：调用账本及原始请求/响应；- 生成过程的结构化记录，供 Console 展示材料取舍和处理路径。
这些记录可能包含原始材料片段和模型响应。分享或备份前，请检查内容。
Tracecast 适合已经准备好本地材料，并希望检查材料来源、编辑取舍和模型调用的工作流。它以已经落地 的本地文本为输入；网页内容或 PDF 获取与 TTS 由外部工具处理。审计结果独立保存，不会静默改写正文。
随附 Console 仅用于本地检查和调试，不作为网络部署的产品前端。它的监听与鉴权边界见 隐私、成本与安全。
需要 Python 3.12 或更高版本。Tracecast 从源码安装。主路径直接调用虚拟环境中的 Python，不要求 激活虚拟环境。
PowerShell：
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install ".[console]"
.\.venv\Scripts\python.exe -m tracecast --helpBash/zsh：
python3 -m venv .venv
./.venv/bin/python -m pip install '.[console]'
./.venv/bin/python -m tracecast --help只使用 CLI 时，把安装参数 .[console] 改为 .。激活虚拟环境只是可选便利；后续示例继续显式使用
该环境的 Python，以保证安装和运行来自同一解释器。
在第一次连接 provider 前，请先阅读隐私、成本与安全。
PowerShell：
.\.venv\Scripts\python.exe -m tracecast consoleBash/zsh：
./.venv/bin/python -m tracecast console打开 http://127.0.0.1:8765/，然后按页面引导执行以下操作：
- 配置 provider gateway、API key 和模型名。
- 导入本地文本，确认编码、source profile、来源语言和输出语言，然后创建项目。
- 选择与输出语言完全一致的 Host，确认估算，再启动完整 Run。
- Run 完成后，在结果页查看脚本。
Console 默认监听 127.0.0.1:8765。它没有用户认证；不要把监听地址改成局域网或公网地址。
先从样例创建本地配置，再把 gateway URL、模型和 .env 中的 key 占位符改成实际值。
PowerShell：
Copy-Item configs/runtime.example.json configs/runtime.json
Copy-Item configs/source_profile_templates.example.json configs/source_profile_templates.json
Copy-Item .env.example .env
.\.venv\Scripts\python.exe -m tracecast run --project example --host example_host_zh `
--max-sources 1 --limit-source-chars 2000Bash/zsh：
cp configs/runtime.example.json configs/runtime.json
cp configs/source_profile_templates.example.json configs/source_profile_templates.json
cp .env.example .env
./.venv/bin/python -m tracecast run --project example --host example_host_zh \
--max-sources 1 --limit-source-chars 2000成功时 CLI 会输出 run_id、artifact 目录、chunk 数和审计项数量。示例限制来源数量和字符数，
便于先验证连接，但仍会产生多次 provider 调用和费用。
配置样例和 projects/example/ 只包含占位内容。提交或分享自己的项目、Host 或 Run 前，请检查其中
的原始材料、偏好文本、模型请求和模型响应是否允许公开。
Tracecast 使用 Apache License 2.0。