chenxin
42513d13c6
- 产品层：产品宪章与永久禁域、产品定义、完整 1.0 范围与发布门、道家文化语言体系、指标与反指标 - 研究层：参考项目研究（deepseek-harness、pi、MemOS、模型网关）、灵台原生引擎研究（业界原生引擎架构理念与道家文化出处） - 架构层：系统、Agent 运行时（周天体系）、插件系统、灵台引擎（C++ 双形态）、媒体与设备、社区协作市场、前端富内容渲染、数据、记忆与知识 - 契约层：协议与稳定标识、API 总体约定、Native API、兼容网关、实时与 Webhook、内部端口、统一 ContentBlock 与流式（含分支对话交互态）、灵台 C ABI 与 gRPC Service、API 表面、HTTP 与事件、运行观测 - 决策：ADR-001 至 ADR-023（模块化单体、每 attempt 持久化、候选记忆、OAuth 2.1、灵台引擎、双形态部署、大周天演化、宪章、三界作用域、私箧与保全态、叩心、周天统一等） - 交付：WP-01 至 WP-15 实施 TODO 与设计阶段交接文档 - 工程：AGENTS.md 工程规则（含 C++/灵台规范）、CLAUDE.md 引用、.gitignore
3.0 KiB
3.0 KiB
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 范围与发布门。