AI 应用服务文档库 · 执行总纲（AppDocs）
定位：本文件是 F:\EricLiu\AppDocs\ 的执行总纲与总入口，覆盖服务器集中管理（单机/集群/高可用）、AI 能力服务化（TTS / ASR / SOE 口语评测 / NLP / 图像生成 / OCR）、.NET 应用生态，以及教育与文化方向（英语学习 / 古诗词古籍 / 古典艺术生成 / 青少年编程）共 13 个技术领域的主流开源技术与项目。
姊妹库：F:\EricLiu\Docs\README.md（运维基础设施总纲）。两库共用同一套机制——五段式实验报告、七步实验循环、时间盒、资源预算（宿主机 60% 上限）、复用闭环、落盘硬约束（一切产物只存 F:\EricLiu\ 下）——规则以 Docs 总纲为准，本总纲不重复展开。
版本：v1.1 创建：2026-11-11 最近核对：2026-11-11（全部分册已对照官网/GitHub 更新版本基线）
1. 本库范围与文档索引
| 目录 |
主题 |
优先级 |
核心开源项目 |
Roadmap/ |
应用服务实践路线图 |
必读 |
阶段 A-H 实验清单（见第 3 节） |
Reusable/ |
应用侧复用资产库 |
必读 |
同 Docs\Reusable 机制（状态/版本/命中/受控标签） |
WebPanel/ |
服务器集中管理 Web |
★★★ |
1Panel、Cockpit、Portainer、Semaphore |
DotNet/ |
.NET 开发框架与生态 |
★★★ |
ABP、nopCommerce、Orchard Core、M.E.AI/Semantic Kernel、ONNX Runtime、Sdcb.PaddleOCR/SimdPaddleOCR、Whisper.net |
TTS/ |
语音合成 |
★★★ |
GPT-SoVITS、CosyVoice、Piper、F5-TTS、Kokoro、MeloTTS、Speech-AI-Forge（聚合）、IndexTTS |
ASR/ |
语音识别 |
★★★ |
faster-whisper、FunASR(Paraformer)、SenseVoice、whisper.cpp、whisper-asr-webservice、sherpa-onnx |
SOE/ |
口语发音评测 |
★★☆ |
OpenPronounce、GOP 算法（Kaldi / wav2vec2）+ speechocean762；商用对比（讯飞 ISE / 腾讯云 SOE） |
NLP/ |
自然语言处理与 LLM 服务化（中/英文分列） |
★★★ |
中文：jieba、HanLP；英文：spaCy、NLTK、Stanza；Ollama、Xinference；Dify、RAGFlow；new-api、Open WebUI |
ImageGen/ |
图像生成 |
★★☆ |
ComfyUI（主力）；SDXL / SD3.5 / FLUX 模型生态 |
OCR/ |
文字识别 |
★★★ |
PaddleOCR、RapidOCR、Sdcb.SimdPaddleOCR（.NET）；文档解析：MinerU、Docling、Surya |
HA/ |
高可用与负载均衡 |
★★★ |
Keepalived、HAProxy、LVS；MySQL、PostgreSQL(Patroni)、Redis/Valkey/Dragonfly |
ClassicalCN/ |
古诗词/古籍 AI 处理与阅读学习 |
★★☆ |
chinese-poetry 语料库、殆知阁、CTEXT、gelv-poetry 格律、GuwenBERT、OpenCC |
ArtGen/ |
古典艺术绘画 / AI 生成图片 |
★★☆ |
ComfyUI + 国风 LoRA 生态（工笔/水墨）、ControlNet、IP-Adapter、WikiArt |
EnglishLearn/ |
英语内容处理 + 自适应教学 |
★★☆ |
spaCy(en)、NLTK、textstat、ECDICT、LanguageTool、Anki、Moodle、DeepTutor |
YouthCoding/ |
青少年编程学习平台 |
★★☆ |
Scratch、TurboWarp、Blockly、Hedy、JupyterLite、code-server、MakeCode |
每份分册均含：选型对比表（适用范围）→ 限制与回避清单 → 推荐结论（首选/选配/回避 + 理由）；推荐基准 = 维护活跃度 + 许可证 + 纯 CPU 可行性 + 与实验目标匹配度。
留痕与发布：实验每步骤后即时更新记录；阶段完结后 git push 到 Gitee ops-lab 并重新发布 docs.nopcloud.com——按 Docs 总纲 §3 规则 8 执行，两库同规。
领域联动关系（实验时可跨分册组合）：
语音链路 TTS → ASR → SOE ← 核心链路，毕业作品"跟读评测"；同时服务 EnglishLearn 口语评测
教育文化 EnglishLearn / ClassicalCN / ArtGen / YouthCoding
← 共享底座：NLP(Ollama/Dify) + ImageGen(ComfyUI) + WebPanel(Nginx 网关)
进程内替代 DotNet(Sdcb.SimdPaddleOCR / Whisper.net) ←→ OCR / ASR ← .NET 集成时免去 Python HTTP 中转
基础设施依赖 全部阶段依赖 Docs 主线的 Docker/K8s/HA/Nginx 能力（见 §3 阶段标注）
2. 实验环境与资源约束（关键差异点）
- 宿主机无独立 GPU（2×Xeon Gold 6138，纯 CPU）：
- CPU 友好可跑：Piper（TTS）、faster-whisper int8（ASR）、PaddleOCR/RapidOCR（OCR）、jieba/HanLP（NLP）、小模型 LLM（Ollama qwen 0.5B-4B 量化）
- CPU 极慢需 patience 或换云 GPU：GPT-SoVITS / CosyVoice / F5-TTS 推理、ComfyUI/SDXL 出图（分钟级/张）
- 各分册均已标注资源需求；涉及 GPU 的实验在路线图中标记
[GPU-可选]，默认按 CPU 路径或云 API 替代
- 资源预算：沿用 Docs\Roadmap §2.6——所有 VM 合计 ≤150GB 内存 / 48 vCPU / VM 磁盘合计 ≤500GB（放 F 盘）；AI 服务优先以 Docker 容器跑在 VM 内，不再额外开新 VM 除非实验需要。
- 模型与数据集下载：下载前必须先确认体积（分册已标注意量级）并确认磁盘余量；大文件下载用后台任务，不阻塞会话。
- 落盘：模型权重、数据集等大文件放
F:\EricLiu\AppDocs\<技术>\labs\models\ 或 F:\EricLiu\Envs\，禁止写 C 盘用户目录。
3. 学习路线总览（详细实验清单见 Roadmap/README.md）
阶段 A 服务器集中管理：1Panel/Cockpit 纳管单机 → Portainer 纳管容器 → 多机纳管
阶段 B 语音链路：TTS（Piper 起步 → GPT-SoVITS）→ ASR（faster-whisper/FunASR）→ SOE 评测
阶段 C NLP 与 LLM 服务化：分词/NLP 工具链 → Ollama 本地 LLM → Dify/RAG 知识库
阶段 D 图像生成：ComfyUI [CPU 慢速或云 GPU]
阶段 E OCR：PaddleOCR/RapidOCR 文档识别服务
阶段 F 高可用与集群：Keepalived+HAProxy 双机 → 服务健康检查 → 故障切换演练
阶段 G 全链路整合：统一 Nginx 网关 + K8s 部署 TTS/ASR + 监控告警
阶段 H 教育与文化应用（选修）：EnglishLearn 自适应学习 → ClassicalCN 古诗词 RAG
→ ArtGen 国风生成 [CPU 慢速] → YouthCoding 青少年编程学习站
4. AI 阅读顺序
| 场景 |
阅读顺序 |
| 做应用实验 |
Docs 总纲（机制规则）→ 本总纲 → Roadmap（当前阶段）→ 对应技术分册 |
| 选型调研 |
对应分册第 1 节"选型对比表"（含许可证/资源需求/推荐场景） |
| 排障 |
Docs\Reusable 与 AppDocs\Reusable 两个 INDEX 都查 → 分册排障节 |
| 沉淀资产 |
统一入 AppDocs\Reusable\（应用侧标签见其 README 词表） |
| 新建/更新文档 |
Docs 总纲 §5 入库规则 → Docs 总纲 §6（AppDocs 九段结构）→ 相邻分册（保持格式） |
| 复盘/查经验 |
对应 labs*\README.md（实验报告）→ EXPERIENCE.md → AppDocs\Reusable\ |
| 跨库实验（应用实验用到基础设施） |
本总纲 §2 资源约束 → Docs 对应分册（Docker/K8s/HA/Nginx） |
5. 入库规则
| 产出 |
位置 |
| 新应用技术分册 |
AppDocs\<技术>\README.md（结构按 Docs 总纲 §6 的 AppDocs 九段：版本基线 + 选型对比 + 限制回避 + 推荐结论 + 安装 + 命令 + 模板 + 排障 + 守则）；登记本总纲 §1 索引 |
| 实验报告 |
AppDocs\<技术>\labs\E{A-H}XX-名称\（五段式，模板见 Docs\Roadmap §2.2） |
| 经验条目 |
AppDocs\<技术>\labs\EXPERIENCE.md（表格追加，标明对应资产；坑 ≥2 次的条目进错题本） |
| 复用资产 |
AppDocs\Reusable\（登记 INDEX.md，标签用应用侧词表） |
| 模型/数据集 |
AppDocs\<技术>\labs\models\（不入 git，.gitignore 排除，git 细则见 Docs\DocOps §4） |
| 路线图变更 |
AppDocs\Roadmap\README.md（勾选 checkbox、更新继续点） |
| 临时文件 |
F:\EricLiu\tmp\（实验收尾清理） |
6. 更新记录
| 日期 |
变更 |
| 2026-11-11 |
建库：总纲、Roadmap、Reusable、8 份技术分册（均经官网核对版本基线） |
| 2026-11-11 |
新增 DotNet 分册（ABP/nopCommerce/Orchard Core/M.E.AI/Sdcb 系列）；TTS/ASR/OCR/NLP 补入整合型项目（Speech-AI-Forge、whisper.cpp、new-api、Open WebUI 等）及用/不用结论；9 册统一补齐"推荐结论 + 适用范围 + 限制"，回避项均附事实依据（停更/CVE/许可证/CPU 不可行） |
| 2026-11-11 |
文档库管理策略定案（见 Docs\DocOps）：Markdown+Git 事实源 + MkDocs Material 浏览层，随阶段 A/G 用 1Panel 部署 Gitea 与浏览站 |
| 2026-11-11 |
大扩容：HA 加 PostgreSQL(Patroni)/Valkey/Dragonfly；NLP 按中文/英文分列；TTS/ASR/OCR 扩充选型（Kokoro、MeloTTS、SenseVoice、MinerU、Docling 等）；新增 4 领域分册 ClassicalCN / ArtGen / EnglishLearn / YouthCoding；Roadmap 增阶段 H |
| 2026-11-11 |
v1.1：定位行更新为 13 领域；§1 补领域联动关系；§2 补磁盘红线与模型下载守则；§4 补三个阅读场景；§5 补经验/路线图/临时文件三行并引用九段结构；文档管理参考库清单见 Docs\DocOps §6 |