# 项目文档

项目相关的设计与说明文档，分「系统方案」与「可运行工程」两类。

## 系统方案

- [mdView](mdView/README.md) — 文档站本身：快速开始、markdown 语法示例、部署与运维（nginx + njs 的实现说明）
- [风控系统](风控系统/README.md) — 信贷风控的 12 个子系统全景（数据接入、特征变量、名单、设备指纹与关系网络、模型、规则引擎、额度定价、贷中监控、贷后催收、人工审核、决策留痕、策略分析），每篇含竞品对比与系统间关系

## 可运行工程

从零实现并实际跑通的工程，文档随代码走。

### TTS Studio

免费、纯本地的文本转语音工坊，三种引擎 + 用自己的声音说话。零 API 费用、无云端上传，已在 Apple M1 / 8GB / macOS / Python 3.12 实测通过。

| 能力 | 说明 |
| --- | --- |
| 文本转语音 | 短文本即时合成，支持语速、音调 |
| 文档转语音 | Markdown / TXT / 网页链接 → 单个长音频 |
| 音色混合 | 两个 Kokoro 音色的风格向量加权插值 |
| 声音克隆 | 3-10 秒本人录音 → 合成任意文本，无需训练 |
| 音色库 | 保存、复用自定义音色配方 |

三种引擎各管一段：edge-tts 在线、音色最多（322 个，中文 14 个）；Kokoro-82M 本地 327MB，支持音色向量加权混合；CosyVoice2-0.5B 本地约 2GB，做零样本克隆。

设计上的硬约束是 8GB 统一内存：引擎空闲 5 分钟自动卸载、Kokoro 同时只留一个语言 pipeline、长文档流式写盘、CosyVoice 首次合成才建模型。

**怎么读**

1. **想用** → [使用说明](app_tts_studio/README.md)：界面导览、从零安装、克隆三步流程、文档清洗规则、常见问题与合规边界。
2. **想改** → [架构说明](app_tts_studio/architecture.md)：五层结构、引擎契约、registry 调度、流式写盘、新增引擎要动的六处。
3. **先看效果** → 使用说明里的六张实机截图：合成、结果、音色混合、文档转语音、我的声音、音色库。

站点整体结构见上级 [README](../README.md)；文档内容按「每日更新 / 学习笔记 / 项目文档 / 阅读记录 / model进阶」五类组织。