FunASR 产品部署中心Deployment Hub设计将官网打造为可验证的私有化语音部署入口【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR本设计文档定义 FunASR 官网www.funasr.com的产品化改造方案从项目与教程页面集合升级为面向生产部署的产品入口帮助开发者、平台工程师和技术负责人在不翻阅 GitHub 仓库的情况下回答四个问题——选哪个运行时、最短可验证命令是什么、上线前还要补什么、精确的发布资产与证据在哪里。文章以设计规格为骨架结合仓库中已落地的静态构建、部署注册表与校验实现说明该方案如何从文档走向可运行的代码。1. 改造动机从有流量到能转化部署设计文档给出的现状证据指出官网在 2026-07-26 报告了 5,527 次页面浏览与 2,182 个独立访客其中首页 1,485 次而quickstart.html仅 82 次、models.html仅 76 次。这说明站点已有分发能力但从落地页到部署成功的路径很弱。同时内容表面是碎片化的首页提到工业部署但没有提供部署决策流程存在独立的llama-cpp.html但 vLLM、WebSocket、OpenAI API、容器、ONNX、Triton 与运维内容没有形成连贯的产品家族GitHub 的web-pagesVue 源码与手工维护的线上静态 HTML 已经分叉线上tracker.js向/stats/log上报但 Nginx 没有对应路由导致github_clicks始终为零转化无法度量Nginx 直接从可变的dist目录提供服务部署与回滚不具备原子性配置的 TLS 协议列表仍包含 TLS 1.0 与 1.1。仓库内部其实已经沉淀了很强的素材部署矩阵、模型选型指南、带健康检查与模型列表的 OpenAI 兼容 API、Docker Compose 与 Kubernetes 示例、生产 WebSocket 指引、vLLM 基准与并发说明、ONNX/C 与 Triton 运行时以及九个跨平台 llama.cpp/GGUF 发布资产。问题不在于缺少内容而在于缺少一个把内容组织成部署决策的产品结构。2. 范围界定第一版做什么、明确不做什么2.1 第一版包含的内容围绕部署选型重新设计中英文首页新增双语/deploy/产品中心与七个部署详情页引入统一的部署数据模型状态、硬件、模型、命令、证据、限制与发布链接统一生成页与存量页的主导航同时保留功德榜/Donors作为导航末项保留现有博客、演示、语音资产与高价值的已收录 URL将公开站点语料导入源码控制排除备份、访问统计、日志与生成产物保证发布可以不读取生产主机上的可变文件即可重建保留/llama-cpp.html与/en/llama-cpp.html作为永久兼容入口并通过 canonical 链接指向新的部署页为 GitHub、文档、发布与部署等固定 CTA 增加保护隐私的第一方转化度量用版本化发布 原子current符号链接替换可变就地部署加固 Nginx仅 TLS 1.2/1.3、安全响应头、缓存策略与确定性重定向。2.2 第一版明确排除重写全部既有博客文章在www.funasr.com托管公开推理 API在没有仓库证据的情况下宣称某个运行时生产就绪在网站改造中给 FunASR 服务端内置认证、限流或 Prometheus 指标——站点会明确说明哪些控制是原生的、哪些属于 API 网关将全站迁移到 Astro 或其他完整内容框架。设计文档特别强调一个边界站点的职责是如实说明运行时原生能力与网关/基础设施责任的分界而不是替服务端添加不属于它的功能。这一原则也体现在部署详情页的安全边界章节中。3. 产品定位第一屏即可私有化部署的语音智能基础设施首个视口直接用产品名作为标题FunASR支撑文案中文可私有化部署的语音智能基础设施。覆盖 GPU 高吞吐、实时流式服务、OpenAI 兼容 API以及 CPU 与边缘独立运行。英文Private-deployment speech infrastructure for high-throughput GPU inference, real-time streaming, OpenAI-compatible APIs, and standalone CPU or edge use.主 CTA 是选择部署方案/Choose a deployment次级动作是5 分钟验证/Verify in five minutes。GitHub 保留在页头可见位置但不替代部署工作流——这是定位上的一次关键转换GitHub 从入口降级为来源。上图即设计中要求的自定义部署拓扑位图落地资产见 web-pages/product-site/assets/images/直观呈现从 GPU 服务器到 CPU/边缘客户端的部署光谱供首页 hero 区域叠加使用。4. 信息架构8 项主导航与 9 条新路由主导航顺序固定为Product / 产品Deploy / 部署Models / 模型Benchmarks / 性能Ecosystem / 生态Blog / 博客Docs / 文档Donors / 功德榜语言切换与 GitHub 动作作为独立的页头控件存在。这一导航清单在实现中对应 web-pages/product-site/data/navigation.json每项同时携带中英文标签与中英文 href成为同一份导航清单喂给所有新页面与存量页规范化器的单一事实来源。新增路由如下中文路由英文路由用途/deploy//en/deploy/工作负载与硬件部署选择器/deploy/vllm.html/en/deploy/vllm.htmlFun-ASR-Nano GPU 批量与高吞吐推理/deploy/llama-cpp.html/en/deploy/llama-cpp.htmlCPU、桌面与边缘 GGUF 运行时/deploy/openai-api.html/en/deploy/openai-api.htmlOpenAI 兼容私有转写 API/deploy/realtime.html/en/deploy/realtime.htmlWebSocket 实时字幕与流式 ASR/deploy/containers.html/en/deploy/containers.htmlDocker Compose 与 Kubernetes 服务部署/deploy/cpu-runtime.html/en/deploy/cpu-runtime.htmlONNX/C 高并发 CPU 部署/deploy/production.html/en/deploy/production.html安全、就绪、容量、可观测性与上线检查清单/benchmarks.html/en/benchmarks.html可复现基准证据与方法论既有quickstart.html、models.html、ecosystem.html、/blog/与功德榜路由保持稳定。5. 页面设计可扫描的产品表面5.1 首页运营型产品界面而非营销拼贴全宽品牌 hero一张自定义部署拓扑位图 可审查的真实终端/API 输出以 HTML 分层呈现而非烘焙进图片紧凑的部署选择器分段控件选择工作负载与硬件推荐一条路径并解释原因事实证明条Apache-2.0、支持的操作系统家族、OpenAI 兼容端点、验证日期与基准证据按工作负载、硬件、接口与成熟度组织的部署矩阵真实 API 契约示例/health、/v1/models、/v1/audio/transcriptions生产就绪条区分原生能力与网关/基础设施责任已验证运行时下载与生态采纳末尾的部署与 GitHub CTA。设计约束还要求下一区块在常见桌面与移动视口高度下保持可见避免用户首屏只能看到 hero 而看不到任何决策内容。上图是浏览器测试产出的首页桌面端截屏见 web-pages/product-site/tests/browser/screenshots/可看到从工作负载开始无 JavaScript 也能完成选择的矩阵区与终端命令区即设计文档 6.1 节所述结构的实际渲染效果。5.2 部署选择器确定性的输入与输出输入工作负载文件批量、实时流、私有 API 或边缘应用硬件NVIDIA GPU、通用 CPU、桌面/边缘 GPU 或 Kubernetes 集群优先级吞吐、延迟、可移植性或兼容性。输出推荐运行时支持的模型家族匹配原因主要限制指向详情页的直接链接。选择器是确定性的编码在部署注册表中不向服务器发送数据且在无 JavaScript 时通过其下方的完整矩阵兜底工作。5.3 部署详情页统一模板每个部署页使用相同的可扫描结构状态、最近验证日期、测试的 FunASR 版本与证据链接适合/不适合指引支持的模型、硬件、操作系统与接口可直接复制的安装与启动命令带预期输出的健康检查或 smoke test 命令架构与请求流容量规划变量与基准方法安全与网络边界运维就绪、日志、模型缓存、优雅重启与回滚已知限制与故障排查发布资产、深入文档、issue 模板与 GitHub 动作。5.4 基准页无条件的性能数字一律不出现设计文档立下硬性规则每个指标必须附带模型、运行时、硬件、数据集或音频时长、批量/并发设置、是否排除下载与预热、来源链接与验证日期页面区分批量 RTFx 与实时流式容量并明确警告不要把一个流量画像当作普适的并发承诺。6. 部署选择器的实现加权评分与稳定平局选择器并非前端硬编码而是由 web-pages/product-site/selector.py 提供确定性的推荐评分。核心逻辑如下三类输入各自限定在受控取值集合内SUPPORTED_VALUES非法取值直接抛ValueError匹配权重工作负载 4 分、硬件 3 分、优先级 2 分MATCH_WEIGHTS对每个selectable的注册表条目按三类输入是否命中累加得分得分相同负数取最小时以selector_rank作为稳定平局键再以条目id兜底保证同一输入永远得到同一推荐最终结果附上双语selection_reason与primary_limitation即为什么匹配与主要限制。从源码结构看recommend()的输出被build.py的_selector_payload()打包进页面上下文含权重、条目路由、排名、双语名称/原因/限制前端仅负责呈现不参与决策。这与设计文档选择器确定性、可无 JS 兜底的要求一一对应。7. 内容与证据模型双语部署注册表设计的单一事实来源是仓库中的双语部署注册表 web-pages/product-site/data/deployments.json。每个条目包含稳定 id 与中英文路由中英文名称、摘要、适合/不适合与限制成熟度production-verified生产验证、community-verified社区验证或experimental实验支持的模型、硬件、操作系统与接口安装、启动、健康检查与 smoke test 命令测试的 FunASR/运行时版本与验证日期带完整条件的基准记录发布资产与文档证据运维与安全责任。以注册表中的llama-cpp条目为例它声明成熟度为production-verified测试环境为runtime-llamacpp-v0.2.6llama.cppc8d43b10验证日期 2026-08-30并列出 Linux/macOS/Windows 共九个预编译资产CPU、AVX2、Vulkan、CUDA、Blackwell sm_120每个资产均带 sha256 校验和。注册表的校验由 web-pages/product-site/registry.py 实施规则与设计文档第 8 节逐条对应production-verified条目必须具备tested.verified、tested.funasr、tested.runtime、commands.smoke见PRODUCTION_FIELDS缺一即报错每个证据 URL 必须为 https_is_https_url中英文翻译字段集合必须完全一致TRANSLATION_FIELDS与translation fields must match检查下载资产的 sha256 必须是 64 位小写十六进制基准记录必须补齐BENCHMARK_FIELDS全部 11 个字段model、runtime、hardware、workload、audio、settings、timing_scope、result、qualification、source、verified这正是无条件的性能数字一律不出现的数据层保障。任何生产验证条目缺失验证日期、证据链接、测试版本、smoke test 或明确限制构建即失败。URL 与模型别名会被验证中英文条目结构必须一致。8. 静态构建架构无运行时依赖的纯静态产物设计文档规划的目录结构web-pages/product-site/ assets/ content/ data/deployments.json legacy/ templates/ build.py validate.py requirements-site.txt tests/该结构已在仓库中完整落地且构建逻辑集中在 web-pages/product-site/build.py。关键实现细节构建环境Python 3.11使用固定的 Jinja2 与 Beautiful Soup 构建依赖输出零运行时依赖的静态 HTML/CSS/JS、sitemap、重定向与部署清单存量页快照legacy/目录是已追踪的公开路由、内容与演示资产快照构建时从快照复制绝不读取可变的生产目录导航规范化对每个含nav.nav的存量 HTML调用 web-pages/product-site/legacy.py 的normalize_document()替换导航壳、注入 canonical/hreflang 元数据_metadata_markup并删除已废弃的/stats/tracker.js引用与 Google Fonts 依赖_remove_metadata_links、_remove_excluded_runtime_dependencies该规范化是幂等的且保留文章正文资产指纹_copy_hashed_assets()对全部资产计算 sha256 并以name.digest12.ext重命名HTML 不缓存、不可变资产长期缓存路由渲染route_path()将/deploy/vllm.html一类路由映射为对应输出文件_write_sitemap()从每个页面的 canonical 链接反推 sitemap保证 sitemap 与真实产物一致清单产物构建末尾写出deployment-manifest.json记录全部页面路由与资产哈希作为后续部署校验的对照基准暂存即完成所有产物先在临时暂存目录tempfile.mkdtemp(prefix.funasr-product-build-)生成完毕最后才stage.replace(output_dir)一次性替换与完整产物先于任何线上变更存在的要求一致。部署详情页的渲染模板 web-pages/product-site/templates/deploy-detail.html 也验证了设计的可扫描结构页面通过data-section属性标记 fit、commands、smoke-test、operations、security、limitations、evidence 等章节命令块带复制按钮与data-copy-target下载资产表逐行带data-fieldsha256状态徽章按成熟度分级渲染status-{{ entry.maturity }}。9. 部署与回滚原子切换的current符号链接设计规定部署目标为/root/FunASR/web-pages/releases/UTC timestamp/校验通过后原子切换/root/FunASR/web-pages/current - releases/UTC timestampNginx 只服务current。完整步骤在隔离的 worktree 中构建校验生成的 HTML、链接、sitemap、语言对与资产哈希上传到新发布目录对暂存目录执行 live-root 检查备份 Nginx 配置nginx -t通过后才 reload原子切换符号链接执行公网 HTTPS 与浏览器 smoke test任一步骤失败则切回上一发布。部署过程中没有任何命令会修改或删除更早的发布版本。配套的发布操作文档见 docs/operations/funasr-com-site-release.md其中说明了备份、原子切换与回滚的完整流程。Nginx 与度量改造只服务原子current目录仅允许 TLS 1.2 与 1.3增加与本地资产及既有视频嵌入兼容的内容安全策略增加Permissions-Policy保留 HSTS、frame、content-type 与 referrer 头HTML 不缓存版本化资产长期不可变缓存为 GitHub、文档、发布与部署 CTA 增加固定 302 路由/go/github、/go/releases等见 web-pages/product-site/build.py 中_page_context注入的github_url/releases_url这些路由不是开放重定向固定重定向路由写入专用转化访问日志。设计明确移除失效的信标端点转化上报由第一方访问日志推导不存音频、表单输入、Cookie 或持久访客标识报告包含页面浏览、部署详情页浏览与固定外链动作。10. 失败处理与验证体系10.1 失败处理策略构建错误、证据缺失、双语结构非法、链接断裂或 sitemap 不一致会中止部署存量页导航规范化在副本上执行解析不到预期结构即中止部署选择器始终有无 JavaScript 矩阵兜底未知路由返回双语 404附带部署、文档与首页链接已收录路由保持可用或使用带 canonical 与 hreflang 元数据的永久重定向Nginx 检查或公网 smoke test 失败时上一发布保持生效。10.2 验证构建、浏览器与线上三层构建与内容层对应 web-pages/product-site/tests/ 下的 pytest 套件与 web-pages/product-site/validate.py注册表校验、路由生成、选择器决策与导航规范化的单元测试全部中英文路由对的生成产物测试每个生成页与存量页的 HTML 解析与内部链接检查sitemap、canonical、hreflang、robots、结构化数据与重定向检查精确的模型别名、包版本、发布资产与文档链接检查每个基准与 production-verified 状态的证据检查。validate.py的实现细节值得注意它会检查部署详情页/deploy/与/en/deploy/下的二级/三级路由是否齐备REQUIRED_DEPLOYMENT_SECTIONSfit、commands、smoke-test、security、limitations、operations、evidence与data-fieldverified-date并逐页校验内部链接、hreflang 对等页、JSON-LD 合法性与资产哈希一致性最后核对 sitemap 路由集合与产物完全相等。浏览器层Playwright 在 390x844、768x1024、1440x900、1920x1080 四种视口运行覆盖首页、部署索引、全部详情模板、移动导航、选择器状态与双语页面的截图检查无横向溢出、控件重叠、隐藏标题或文本裁剪检查键盘导航、可见焦点、语义地标、对比度、alt 文本与 reduced-motion 行为验证 hero 资产加载且首屏露出下一区块复制按钮、语言链接、选择器推荐、旧 llama.cpp 路由与固定外链重定向均可用。浏览器测试源码位于 web-pages/product-site/tests/browser/其中 playwright.config.ts 定义了测试矩阵与自持 HTTP 服务器拒绝复用被占用的端口。线上层所有 canonical 路由与资产返回 HTTPS 200缓存与安全头正确TLS 1.0/1.1 被拒绝TLS 1.2/1.3 被接受公网 sitemap 路由与生成清单相等转化日志记录固定外链动作既有博客与演示契约保持绿色。11. 上线顺序与成功标准11.1 分步上线添加生成器、注册表、校验与测试构建双语首页与部署索引构建七个部署页与基准页规范化存量导航并保留旧路由添加版本化部署、Nginx 加固与转化日志运行完整本地与暂存浏览器验证原子部署、公网验证并监控首个 24 小时。11.2 成功标准第一版发布仅在以下条件全部满足时才算完成全部规划的双语路由公开且通过生成清单访客能在两次交互内获得有依据的部署推荐每个生产声明都有精确的仓库或发布证据vLLM 与 llama.cpp/GGUF 各有一条完整的生产向页面旧的高价值 URL 与全部博客/演示契约保持有效部署是原子的且回滚被证明可行GitHub、文档、发布与部署 CTA 转化可度量桌面与移动浏览器检查通过无重叠或溢出线上站点通过安全头、TLS、sitemap 与链接验证。12. 仓库内的关联证据链本文所述设计均有仓库内实现与文档支撑可按以下路径继续深入设计规格原文docs/superpowers/specs/2026-07-26-funasr-product-deployment-hub-design.md产品站源码与内容归属说明web-pages/product-site/README.md部署注册表内容与证据模型的事实来源web-pages/product-site/data/deployments.json构建、校验、选择器与存量页规范化build.py、validate.py、selector.py、legacy.py、registry.py部署详情页模板可扫描结构落地点web-pages/product-site/templates/deploy-detail.html部署矩阵与模型选型部署中心的内容底座docs/deployment_matrix.md、docs/model_selection.mdvLLM 与 llama.cpp 路径的官方验证记录docs/vllm_guide.md、docs/vllm_official_native_validation.md、runtime/llama.cpp/README.md、runtime/llama.cpp/BENCHMARKS.mdOpenAI 兼容 API 与安全指南examples/openai_api/README.md、examples/openai_api/OPENAPI.md、examples/openai_api/SECURITY.md容器、CPU 与 Triton 运行时examples/openai_api/kubernetes/、runtime/onnxruntime/readme.md、runtime/triton_gpu/README.md实时 WebSocket 协议与基准方法runtime/python/websocket/README.md、runtime/docs/websocket_protocol.md、docs/benchmark/realtime_ws_benchmark.md、docs/benchmark/rtf_reproducibility.md这套设计规格 → 注册表 → 确定性选择器 → 静态构建 → 原子发布 → 多层验证的闭环把官网从一个信息展示层变成了 FunASR 私有化部署的可操作入口访客先做选择、再跑最小验证、随后获得证据与限制最终按清单上线——每一步都以仓库内可复查的事实为依据而不是营销话术。【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/13 2:15:24 · 阅读 1.2k FunASR 产品部署中心（Deployment Hub）设计：将官网打造为可验证的私有化语音部署入口
FunASR 产品部署中心Deployment Hub设计将官网打造为可验证的私有化语音部署入口【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR本设计文档定义 FunASR 官网www.funasr.com的产品化改造方案从项目与教程页面集合升级为面向生产部署的产品入口帮助开发者、平台工程师和技术负责人在不翻阅 GitHub 仓库的情况下回答四个问题——选哪个运行时、最短可验证命令是什么、上线前还要补什么、精确的发布资产与证据在哪里。文章以设计规格为骨架结合仓库中已落地的静态构建、部署注册表与校验实现说明该方案如何从文档走向可运行的代码。1. 改造动机从有流量到能转化部署设计文档给出的现状证据指出官网在 2026-07-26 报告了 5,527 次页面浏览与 2,182 个独立访客其中首页 1,485 次而quickstart.html仅 82 次、models.html仅 76 次。这说明站点已有分发能力但从落地页到部署成功的路径很弱。同时内容表面是碎片化的首页提到工业部署但没有提供部署决策流程存在独立的llama-cpp.html但 vLLM、WebSocket、OpenAI API、容器、ONNX、Triton 与运维内容没有形成连贯的产品家族GitHub 的web-pagesVue 源码与手工维护的线上静态 HTML 已经分叉线上tracker.js向/stats/log上报但 Nginx 没有对应路由导致github_clicks始终为零转化无法度量Nginx 直接从可变的dist目录提供服务部署与回滚不具备原子性配置的 TLS 协议列表仍包含 TLS 1.0 与 1.1。仓库内部其实已经沉淀了很强的素材部署矩阵、模型选型指南、带健康检查与模型列表的 OpenAI 兼容 API、Docker Compose 与 Kubernetes 示例、生产 WebSocket 指引、vLLM 基准与并发说明、ONNX/C 与 Triton 运行时以及九个跨平台 llama.cpp/GGUF 发布资产。问题不在于缺少内容而在于缺少一个把内容组织成部署决策的产品结构。2. 范围界定第一版做什么、明确不做什么2.1 第一版包含的内容围绕部署选型重新设计中英文首页新增双语/deploy/产品中心与七个部署详情页引入统一的部署数据模型状态、硬件、模型、命令、证据、限制与发布链接统一生成页与存量页的主导航同时保留功德榜/Donors作为导航末项保留现有博客、演示、语音资产与高价值的已收录 URL将公开站点语料导入源码控制排除备份、访问统计、日志与生成产物保证发布可以不读取生产主机上的可变文件即可重建保留/llama-cpp.html与/en/llama-cpp.html作为永久兼容入口并通过 canonical 链接指向新的部署页为 GitHub、文档、发布与部署等固定 CTA 增加保护隐私的第一方转化度量用版本化发布 原子current符号链接替换可变就地部署加固 Nginx仅 TLS 1.2/1.3、安全响应头、缓存策略与确定性重定向。2.2 第一版明确排除重写全部既有博客文章在www.funasr.com托管公开推理 API在没有仓库证据的情况下宣称某个运行时生产就绪在网站改造中给 FunASR 服务端内置认证、限流或 Prometheus 指标——站点会明确说明哪些控制是原生的、哪些属于 API 网关将全站迁移到 Astro 或其他完整内容框架。设计文档特别强调一个边界站点的职责是如实说明运行时原生能力与网关/基础设施责任的分界而不是替服务端添加不属于它的功能。这一原则也体现在部署详情页的安全边界章节中。3. 产品定位第一屏即可私有化部署的语音智能基础设施首个视口直接用产品名作为标题FunASR支撑文案中文可私有化部署的语音智能基础设施。覆盖 GPU 高吞吐、实时流式服务、OpenAI 兼容 API以及 CPU 与边缘独立运行。英文Private-deployment speech infrastructure for high-throughput GPU inference, real-time streaming, OpenAI-compatible APIs, and standalone CPU or edge use.主 CTA 是选择部署方案/Choose a deployment次级动作是5 分钟验证/Verify in five minutes。GitHub 保留在页头可见位置但不替代部署工作流——这是定位上的一次关键转换GitHub 从入口降级为来源。上图即设计中要求的自定义部署拓扑位图落地资产见 web-pages/product-site/assets/images/直观呈现从 GPU 服务器到 CPU/边缘客户端的部署光谱供首页 hero 区域叠加使用。4. 信息架构8 项主导航与 9 条新路由主导航顺序固定为Product / 产品Deploy / 部署Models / 模型Benchmarks / 性能Ecosystem / 生态Blog / 博客Docs / 文档Donors / 功德榜语言切换与 GitHub 动作作为独立的页头控件存在。这一导航清单在实现中对应 web-pages/product-site/data/navigation.json每项同时携带中英文标签与中英文 href成为同一份导航清单喂给所有新页面与存量页规范化器的单一事实来源。新增路由如下中文路由英文路由用途/deploy//en/deploy/工作负载与硬件部署选择器/deploy/vllm.html/en/deploy/vllm.htmlFun-ASR-Nano GPU 批量与高吞吐推理/deploy/llama-cpp.html/en/deploy/llama-cpp.htmlCPU、桌面与边缘 GGUF 运行时/deploy/openai-api.html/en/deploy/openai-api.htmlOpenAI 兼容私有转写 API/deploy/realtime.html/en/deploy/realtime.htmlWebSocket 实时字幕与流式 ASR/deploy/containers.html/en/deploy/containers.htmlDocker Compose 与 Kubernetes 服务部署/deploy/cpu-runtime.html/en/deploy/cpu-runtime.htmlONNX/C 高并发 CPU 部署/deploy/production.html/en/deploy/production.html安全、就绪、容量、可观测性与上线检查清单/benchmarks.html/en/benchmarks.html可复现基准证据与方法论既有quickstart.html、models.html、ecosystem.html、/blog/与功德榜路由保持稳定。5. 页面设计可扫描的产品表面5.1 首页运营型产品界面而非营销拼贴全宽品牌 hero一张自定义部署拓扑位图 可审查的真实终端/API 输出以 HTML 分层呈现而非烘焙进图片紧凑的部署选择器分段控件选择工作负载与硬件推荐一条路径并解释原因事实证明条Apache-2.0、支持的操作系统家族、OpenAI 兼容端点、验证日期与基准证据按工作负载、硬件、接口与成熟度组织的部署矩阵真实 API 契约示例/health、/v1/models、/v1/audio/transcriptions生产就绪条区分原生能力与网关/基础设施责任已验证运行时下载与生态采纳末尾的部署与 GitHub CTA。设计约束还要求下一区块在常见桌面与移动视口高度下保持可见避免用户首屏只能看到 hero 而看不到任何决策内容。上图是浏览器测试产出的首页桌面端截屏见 web-pages/product-site/tests/browser/screenshots/可看到从工作负载开始无 JavaScript 也能完成选择的矩阵区与终端命令区即设计文档 6.1 节所述结构的实际渲染效果。5.2 部署选择器确定性的输入与输出输入工作负载文件批量、实时流、私有 API 或边缘应用硬件NVIDIA GPU、通用 CPU、桌面/边缘 GPU 或 Kubernetes 集群优先级吞吐、延迟、可移植性或兼容性。输出推荐运行时支持的模型家族匹配原因主要限制指向详情页的直接链接。选择器是确定性的编码在部署注册表中不向服务器发送数据且在无 JavaScript 时通过其下方的完整矩阵兜底工作。5.3 部署详情页统一模板每个部署页使用相同的可扫描结构状态、最近验证日期、测试的 FunASR 版本与证据链接适合/不适合指引支持的模型、硬件、操作系统与接口可直接复制的安装与启动命令带预期输出的健康检查或 smoke test 命令架构与请求流容量规划变量与基准方法安全与网络边界运维就绪、日志、模型缓存、优雅重启与回滚已知限制与故障排查发布资产、深入文档、issue 模板与 GitHub 动作。5.4 基准页无条件的性能数字一律不出现设计文档立下硬性规则每个指标必须附带模型、运行时、硬件、数据集或音频时长、批量/并发设置、是否排除下载与预热、来源链接与验证日期页面区分批量 RTFx 与实时流式容量并明确警告不要把一个流量画像当作普适的并发承诺。6. 部署选择器的实现加权评分与稳定平局选择器并非前端硬编码而是由 web-pages/product-site/selector.py 提供确定性的推荐评分。核心逻辑如下三类输入各自限定在受控取值集合内SUPPORTED_VALUES非法取值直接抛ValueError匹配权重工作负载 4 分、硬件 3 分、优先级 2 分MATCH_WEIGHTS对每个selectable的注册表条目按三类输入是否命中累加得分得分相同负数取最小时以selector_rank作为稳定平局键再以条目id兜底保证同一输入永远得到同一推荐最终结果附上双语selection_reason与primary_limitation即为什么匹配与主要限制。从源码结构看recommend()的输出被build.py的_selector_payload()打包进页面上下文含权重、条目路由、排名、双语名称/原因/限制前端仅负责呈现不参与决策。这与设计文档选择器确定性、可无 JS 兜底的要求一一对应。7. 内容与证据模型双语部署注册表设计的单一事实来源是仓库中的双语部署注册表 web-pages/product-site/data/deployments.json。每个条目包含稳定 id 与中英文路由中英文名称、摘要、适合/不适合与限制成熟度production-verified生产验证、community-verified社区验证或experimental实验支持的模型、硬件、操作系统与接口安装、启动、健康检查与 smoke test 命令测试的 FunASR/运行时版本与验证日期带完整条件的基准记录发布资产与文档证据运维与安全责任。以注册表中的llama-cpp条目为例它声明成熟度为production-verified测试环境为runtime-llamacpp-v0.2.6llama.cppc8d43b10验证日期 2026-08-30并列出 Linux/macOS/Windows 共九个预编译资产CPU、AVX2、Vulkan、CUDA、Blackwell sm_120每个资产均带 sha256 校验和。注册表的校验由 web-pages/product-site/registry.py 实施规则与设计文档第 8 节逐条对应production-verified条目必须具备tested.verified、tested.funasr、tested.runtime、commands.smoke见PRODUCTION_FIELDS缺一即报错每个证据 URL 必须为 https_is_https_url中英文翻译字段集合必须完全一致TRANSLATION_FIELDS与translation fields must match检查下载资产的 sha256 必须是 64 位小写十六进制基准记录必须补齐BENCHMARK_FIELDS全部 11 个字段model、runtime、hardware、workload、audio、settings、timing_scope、result、qualification、source、verified这正是无条件的性能数字一律不出现的数据层保障。任何生产验证条目缺失验证日期、证据链接、测试版本、smoke test 或明确限制构建即失败。URL 与模型别名会被验证中英文条目结构必须一致。8. 静态构建架构无运行时依赖的纯静态产物设计文档规划的目录结构web-pages/product-site/ assets/ content/ data/deployments.json legacy/ templates/ build.py validate.py requirements-site.txt tests/该结构已在仓库中完整落地且构建逻辑集中在 web-pages/product-site/build.py。关键实现细节构建环境Python 3.11使用固定的 Jinja2 与 Beautiful Soup 构建依赖输出零运行时依赖的静态 HTML/CSS/JS、sitemap、重定向与部署清单存量页快照legacy/目录是已追踪的公开路由、内容与演示资产快照构建时从快照复制绝不读取可变的生产目录导航规范化对每个含nav.nav的存量 HTML调用 web-pages/product-site/legacy.py 的normalize_document()替换导航壳、注入 canonical/hreflang 元数据_metadata_markup并删除已废弃的/stats/tracker.js引用与 Google Fonts 依赖_remove_metadata_links、_remove_excluded_runtime_dependencies该规范化是幂等的且保留文章正文资产指纹_copy_hashed_assets()对全部资产计算 sha256 并以name.digest12.ext重命名HTML 不缓存、不可变资产长期缓存路由渲染route_path()将/deploy/vllm.html一类路由映射为对应输出文件_write_sitemap()从每个页面的 canonical 链接反推 sitemap保证 sitemap 与真实产物一致清单产物构建末尾写出deployment-manifest.json记录全部页面路由与资产哈希作为后续部署校验的对照基准暂存即完成所有产物先在临时暂存目录tempfile.mkdtemp(prefix.funasr-product-build-)生成完毕最后才stage.replace(output_dir)一次性替换与完整产物先于任何线上变更存在的要求一致。部署详情页的渲染模板 web-pages/product-site/templates/deploy-detail.html 也验证了设计的可扫描结构页面通过data-section属性标记 fit、commands、smoke-test、operations、security、limitations、evidence 等章节命令块带复制按钮与data-copy-target下载资产表逐行带data-fieldsha256状态徽章按成熟度分级渲染status-{{ entry.maturity }}。9. 部署与回滚原子切换的current符号链接设计规定部署目标为/root/FunASR/web-pages/releases/UTC timestamp/校验通过后原子切换/root/FunASR/web-pages/current - releases/UTC timestampNginx 只服务current。完整步骤在隔离的 worktree 中构建校验生成的 HTML、链接、sitemap、语言对与资产哈希上传到新发布目录对暂存目录执行 live-root 检查备份 Nginx 配置nginx -t通过后才 reload原子切换符号链接执行公网 HTTPS 与浏览器 smoke test任一步骤失败则切回上一发布。部署过程中没有任何命令会修改或删除更早的发布版本。配套的发布操作文档见 docs/operations/funasr-com-site-release.md其中说明了备份、原子切换与回滚的完整流程。Nginx 与度量改造只服务原子current目录仅允许 TLS 1.2 与 1.3增加与本地资产及既有视频嵌入兼容的内容安全策略增加Permissions-Policy保留 HSTS、frame、content-type 与 referrer 头HTML 不缓存版本化资产长期不可变缓存为 GitHub、文档、发布与部署 CTA 增加固定 302 路由/go/github、/go/releases等见 web-pages/product-site/build.py 中_page_context注入的github_url/releases_url这些路由不是开放重定向固定重定向路由写入专用转化访问日志。设计明确移除失效的信标端点转化上报由第一方访问日志推导不存音频、表单输入、Cookie 或持久访客标识报告包含页面浏览、部署详情页浏览与固定外链动作。10. 失败处理与验证体系10.1 失败处理策略构建错误、证据缺失、双语结构非法、链接断裂或 sitemap 不一致会中止部署存量页导航规范化在副本上执行解析不到预期结构即中止部署选择器始终有无 JavaScript 矩阵兜底未知路由返回双语 404附带部署、文档与首页链接已收录路由保持可用或使用带 canonical 与 hreflang 元数据的永久重定向Nginx 检查或公网 smoke test 失败时上一发布保持生效。10.2 验证构建、浏览器与线上三层构建与内容层对应 web-pages/product-site/tests/ 下的 pytest 套件与 web-pages/product-site/validate.py注册表校验、路由生成、选择器决策与导航规范化的单元测试全部中英文路由对的生成产物测试每个生成页与存量页的 HTML 解析与内部链接检查sitemap、canonical、hreflang、robots、结构化数据与重定向检查精确的模型别名、包版本、发布资产与文档链接检查每个基准与 production-verified 状态的证据检查。validate.py的实现细节值得注意它会检查部署详情页/deploy/与/en/deploy/下的二级/三级路由是否齐备REQUIRED_DEPLOYMENT_SECTIONSfit、commands、smoke-test、security、limitations、operations、evidence与data-fieldverified-date并逐页校验内部链接、hreflang 对等页、JSON-LD 合法性与资产哈希一致性最后核对 sitemap 路由集合与产物完全相等。浏览器层Playwright 在 390x844、768x1024、1440x900、1920x1080 四种视口运行覆盖首页、部署索引、全部详情模板、移动导航、选择器状态与双语页面的截图检查无横向溢出、控件重叠、隐藏标题或文本裁剪检查键盘导航、可见焦点、语义地标、对比度、alt 文本与 reduced-motion 行为验证 hero 资产加载且首屏露出下一区块复制按钮、语言链接、选择器推荐、旧 llama.cpp 路由与固定外链重定向均可用。浏览器测试源码位于 web-pages/product-site/tests/browser/其中 playwright.config.ts 定义了测试矩阵与自持 HTTP 服务器拒绝复用被占用的端口。线上层所有 canonical 路由与资产返回 HTTPS 200缓存与安全头正确TLS 1.0/1.1 被拒绝TLS 1.2/1.3 被接受公网 sitemap 路由与生成清单相等转化日志记录固定外链动作既有博客与演示契约保持绿色。11. 上线顺序与成功标准11.1 分步上线添加生成器、注册表、校验与测试构建双语首页与部署索引构建七个部署页与基准页规范化存量导航并保留旧路由添加版本化部署、Nginx 加固与转化日志运行完整本地与暂存浏览器验证原子部署、公网验证并监控首个 24 小时。11.2 成功标准第一版发布仅在以下条件全部满足时才算完成全部规划的双语路由公开且通过生成清单访客能在两次交互内获得有依据的部署推荐每个生产声明都有精确的仓库或发布证据vLLM 与 llama.cpp/GGUF 各有一条完整的生产向页面旧的高价值 URL 与全部博客/演示契约保持有效部署是原子的且回滚被证明可行GitHub、文档、发布与部署 CTA 转化可度量桌面与移动浏览器检查通过无重叠或溢出线上站点通过安全头、TLS、sitemap 与链接验证。12. 仓库内的关联证据链本文所述设计均有仓库内实现与文档支撑可按以下路径继续深入设计规格原文docs/superpowers/specs/2026-07-26-funasr-product-deployment-hub-design.md产品站源码与内容归属说明web-pages/product-site/README.md部署注册表内容与证据模型的事实来源web-pages/product-site/data/deployments.json构建、校验、选择器与存量页规范化build.py、validate.py、selector.py、legacy.py、registry.py部署详情页模板可扫描结构落地点web-pages/product-site/templates/deploy-detail.html部署矩阵与模型选型部署中心的内容底座docs/deployment_matrix.md、docs/model_selection.mdvLLM 与 llama.cpp 路径的官方验证记录docs/vllm_guide.md、docs/vllm_official_native_validation.md、runtime/llama.cpp/README.md、runtime/llama.cpp/BENCHMARKS.mdOpenAI 兼容 API 与安全指南examples/openai_api/README.md、examples/openai_api/OPENAPI.md、examples/openai_api/SECURITY.md容器、CPU 与 Triton 运行时examples/openai_api/kubernetes/、runtime/onnxruntime/readme.md、runtime/triton_gpu/README.md实时 WebSocket 协议与基准方法runtime/python/websocket/README.md、runtime/docs/websocket_protocol.md、docs/benchmark/realtime_ws_benchmark.md、docs/benchmark/rtf_reproducibility.md这套设计规格 → 注册表 → 确定性选择器 → 静态构建 → 原子发布 → 多层验证的闭环把官网从一个信息展示层变成了 FunASR 私有化部署的可操作入口访客先做选择、再跑最小验证、随后获得证据与限制最终按清单上线——每一步都以仓库内可复查的事实为依据而不是营销话术。【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考