chenxin
a39cec5287
- C++ 新增四模块（modules.cpp，19 个导出符号全部 hj_*）： 小周天 hj_stream：流会话（sequence/delta_index 单调）与 content.block.delta envelope 确定性编码（重放字节一致） 烛照 hj_policy：URL 协议白名单（拒 file/javascript/data）、路径授权根与 .. 段拒绝、幂等键非空≤128、四维决策表（autonomy×risk→allow/ask/deny，非法输入 deny fail-closed） 洛书 hj_plan：预算核算（达限/负数拒绝） 河图 hj_recall：确定性重排（词频×稳定排序，canonical JSON 输出；非法输入 PARSE_FAILED） - doctest 22 用例 20135 断言全绿（含每模块 golden 与确定性双跑） - Go 绑定（cgo 自包含编译引擎源码）：Engine RAII/TransformMarkdown/ValidateURL/ValidatePath/Decide/CheckBudget/RecallRerank；go test 3 用例通过（transform/rerank golden 与 C++ 字节一致） - Rust 绑定（bindgen 生成 + 安全包装）：Engine RAII（Drop 释放）、Error 枚举映射全部 HjStatus、Send/Sync（HjEngine 线程安全）；cargo test 3 用例通过（同 golden） - 三端（C++/Go/Rust）与 Python golden 一致：同一 markdown 输入在四端输出字节相同（跨端一致性首次全语言验证）
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 范围与发布门。