OpenTalking Persona Package实战一个.otpersona文件交付开箱即用的数字人Agent【免费下载链接】opentalkingOpenTalking: An industrial-grade open-source AI digital human framework that supports real-time conversation, private deployment, and pluggable models.项目地址: https://gitcode.com/gh_mirrors/op/opentalkingOpenTalking 是一个工业级开源 AI 数字人框架支持实时对话、私有化部署和可插拔模型。其中Persona Package角色交付包解决了数字人项目落地中最繁琐的一环把形象、音色、提示词、知识库、记忆策略和运行预设打包成单个.otpersona文件接收方导入后即可用persona_id一键创建开箱即用的数字人 Agent 会话——无需重新配置任何环境参数。一个 .otpersona 文件里装了什么.otpersona本质是一个 zip 包根目录至少包含persona.json清单文件。以仓库自带的中文售前客服示例为例结构如下customer-support-zh.otpersona ├── persona.json # 角色清单必选 ├── prompts/ # 提示词 │ ├── system.md │ └── style.md └── knowledge/ # 知识库文档 └── docs/ └── opentalking-product.md可选目录还有avatar/、voice/、memory/和eval/当前版本会保留这些目录但主要启用提示词、知识库和会话预设三项能力。persona.json角色配置的核心清单清单文件定义了数字人的全部交付参数示例见 examples/personas/customer-support-zh/persona.json配置块作用示例值id/name角色唯一标识与展示名customer-support-zh/ 中文售前客服avatar数字人形象与合成模型singermockvoice音色提供方与音色 IDEdge 的zh-CN-XiaoxiaoNeuralagent提示词路径、记忆与知识库开关启用 memory 与 knowledgeruntimeSTT/TTS 提供方与首选后端sensevoiceedgesafety形象/音色授权与内容标注authorized_avatar: true清单的完整字段定义位于 opentalking/persona/schema.py其中safety字段确保企业交付时形象与音色的使用是明确授权的。隐私设计亮点导入包时knowledge/docs/下的文档会自动创建为新的本地知识库而真实用户的长期记忆不会被导出交付包只带走能力不带走数据。这一行为由 opentalking/persona/package.py 中的知识库导入逻辑保证。三步上手打包 → 校验 → 导入OpenTalking CLI 内置了完整的 Persona 工具链实现位于 apps/cli/persona.py第 1 步从样板目录打包opentalking persona pack examples/personas/customer-support-zh --out customer-support-zh.otpersona第 2 步校验包完整性opentalking persona validate customer-support-zh.otpersona第 3 步导入本地系统opentalking persona import customer-support-zh.otpersona导入成功后角色记录会写入本地 Persona 存储见 opentalking/persona/store.py随时可以通过GET /personas列出所有已安装角色。导入后如何用persona_id 创建会话这是 Persona Package 最开箱即用的一环创建会话时直接传persona_id所有默认值自动生效{ persona_id: customer-support-zh, user_id: client_demo }系统会从清单中读取形象、模型、TTS 音色、STT 提供方、系统提示词、记忆开关和知识库 ID 作为会话默认值转换逻辑见 opentalking/persona/session.py。同时支持按需覆盖显式传入avatar_id、model、tts_provider、stt_provider、tts_voice、llm_system_prompt、knowledge_base_ids和memory_enabled会覆盖 Persona 默认值——一个角色包可以支撑多个变体会话。完整 API导入、导出与校验除 CLI 外API 层提供了对等的交付接口apps/api/routes/personas.pyPOST /personas/import上传.otpersona文件单包上限 200MBPOST /personas/validate仅校验不安装适合 CI 流水线GET /personas/{persona_id}/export一键导出已安装角色DELETE /personas/{persona_id}删除本地角色记录反向操作同样简单——把已调好的角色导出交付给其他环境opentalking persona export customer-support-zh --out customer-support-zh.otpersona内置的安全校验机制.otpersona包在解包前会经过严格的防御检查opentalking/persona/package.py✅ 必须包含persona.json清单✅ 拒绝绝对路径与..路径穿越杜绝 zip 解压攻击✅ 单包总大小不超过 200MB✅id必须为字母/数字开头的安全标识符这意味着你可以放心地接收合作方发来的角色包导入过程不会污染本地文件系统。总结场景推荐做法企业私有化部署先用mock链路验证话术再切真实合成后端跨环境交付export→ 传输.otpersona→import批量角色管理通过 API 集成到运维平台内容合规开启safety.content_label_required一个文件 一个完整的数字人 Agent。这就是 OpenTalking Persona Package 的价值让数字人的调教成果像安装一个 App 一样简单。更多细节请查阅官方文档 docs/zh/usage/persona-package.md以及会话创建 API docs/zh/api-reference/sessions.md。【免费下载链接】opentalkingOpenTalking: An industrial-grade open-source AI digital human framework that supports real-time conversation, private deployment, and pluggable models.项目地址: https://gitcode.com/gh_mirrors/op/opentalking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考