chenxin
7c57d27494
- 迁移 18：avatar_model（live2d/vrm/gltf、validated/rejected、校验报告、来源许可、当前命令指针）+ avatar_command（十类命令检查约束、(avatar,sequence) 唯一、undone 标记） - GLB/glTF 解析器（纯 Python）：GLB magic/版本/chunk 结构校验、JSON 场景图引用一致性（scene→node→mesh→material 逐层索引越界检测）、VRM 0.x/1.0 扩展检测与 meta 提取 - 资源上限（恶意模型文件防线）：文件 200MB、节点 10 万、网格 1 万、纹理 2 千、材质 5 千、动画 1 千——超限入库 rejected 并保留报告 - Cubism model3.json 校验：Version/FileReferences 必需、moc3 引用、纹理列表、表情/动作/HitArea 计数 - 上传 MIME 白名单扩展 model/ 与 application/json - 命令历史：十类命令（param_map/expression/physics/motion/material/texture/bone/attachment/lighting/camera）追加（sequence 单调）、撤销（标记 undone 非破坏）、rejected 模型不接受编辑（422 前置校验） - 测试 111 项全绿（+9）：合法 GLB/VRM 检测/损坏文件/引用越界/超限/Cubism 正反例/命令历史与撤销幂等/rejected 拒编
Hunjing
Hunjing 是面向个人用户与创作者的长期 AI 角色、Agent 与创作社区平台。它支持角色连续身份、分支对话、可治理记忆、多 Agent、插件、语音、多语言、多模态、Live2D、3D、跨端感知、社区协作和真实交易。
当前仓库处于设计阶段，尚无可运行实现。文档描述完整 1.0 目标，不代表功能已经完成。
1.0 范围
Hunjing 1.0 是一次整体交付，必须同时包含：
- 角色创建、导入、版本、谱系、记忆、关系和可携导出；
- 多模态分支对话、实时语音、图像和多语言；
- Live2D 以及 VRM/glTF 3D 导入、编辑、运行和导出；
- 角色 Agent、任务 Agent、协调 Agent和受控多 Agent 并行；
- Web、Tauri 桌面端、Tauri iOS/Android 与文件/相机/麦克风/屏幕/位置感知；
- 双轨插件生态、开发 SDK、注册、审核、安装、升级、回滚和插件市场；
- 完整社区、角色社区、多人协作空间、搜索、推荐和内容治理；
- 商品、订单、真实支付、退款、平台分成、创作者结算、对账和争议处理；
- 模型/工具调用的 token、Prompt Cache、成本、时延、错误、重试和受保护诊断；
- 官方部署与完整自托管闭环。
所有工作包可以内部并行，但全部 TODO 和发布门完成前不得称为正式 1.0。
架构原则
- 可扩展能力皆插件；认证、授权、数据隔离、审批、审计、交易账、事务和隔离执行内核不可插件化。
- 声明式/远程插件默认受限运行；部署者明确信任的本地代码插件进入独立进程或容器。
- 性能与安全敏感的确定性核心（内容规范化、流式、策略校验、端侧离线检索）以 C++ 灵台引擎实现：可经稳定 C ABI 进程内嵌入 Python/Rust/Go 宿主，也可作为部署内部的 gRPC 独立服务运行；引擎无权威状态，数据事实源仍在数据库。
- 每个 Run 持久化 Turn、模型 attempt、工具调用、token、缓存、费用和错误。
- 详细诊断必须同时持有登录态和短期、限范围的诊断授权。
- 技术按能力、规模与安全需要采用，不以堆满技术栈作为完成标准。
- 产品界面使用“中国古代神话/道家文化名 · 直白解释”的双层语言；稳定 API、数据库、事件和日志使用中性英文工程标识。
- Native Message、社区内容和 Agent 输出使用统一类型化 ContentBlock，支持 Markdown、代码、数学公式、Mermaid、图片、视频、音频、文件、工具状态和产物的安全分级实时渲染。
2.0 已确认范围
- Blender 级完整 3D 建模器；
- 基于开源建模项目完善网格、雕刻、拓扑、绑定和专业动画工具；
- LLM 直接、可验证地修改完整 3D 几何与绑定；
- IoT、机器人和物理动作控制。
文档入口
从 docs/README.md 开始，完整范围见 完整 1.0 范围与发布门。