chenxin
9ef2568c3b
- 迁移 14：plugin（kind 四形态、撤架三态）、plugin_version（Manifest JSONB + 规范化内容哈希签名、(plugin,version) 唯一）、plugin_installation（enabled + granted_permissions、(domain,plugin) 唯一） - Registry：发布版本（Manifest 必须声明 permissions，签名=canonical 哈希）；撤架阻断新调用与新安装，历史审计保留（验证：撤架后 invoked 审计仍在） - 三态分离（购买≠安装≠启用≠授权）：安装默认 disabled+零授权；启用必须显式授予权限子集（越界 422）；调用门逐级校验（未装/未启/撤架各 403） - 升级：Manifest 新增权限必须重新确认（未确认 422 且明示新增项）；确认后升级成功 - 调用：按 Manifest response_template 真实执行（声明式确定性回填）；remote/isolated 形态明示 501 随沙箱交付（WP-14），不静默降级；审计含版本哈希（快照语义） - 权限标识统一 group:item 格式 - 测试 86 项全绿（+4）：三态流、越界、升级确认、撤架阻断与历史保留
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 范围与发布门。