chenxin 99a7789432 ✨ feat: Sandbox Runtime——isolated 插件子进程隔离执行(WP-06/07 收口)
- 迁移 17:plugin_execution(五态、退出码、时长、stdout 摘要、错误留痕)
- 沙箱执行器:独立子进程(代码经 stdin JSON 安全传输,不进命令行)、CPU rlimit + RLIMIT_AS(平台不支持时尽力而为并注明)、墙钟超时强杀、输出限额;runner 仅暴露 input/output 作用域
- 执行端点:isolated_process 形态、已安装且启用后可执行;**未启用沙箱一律 503 fail-closed**(HUNJING_SANDBOX_ENABLED 显式开启,审计记录拒绝原因)——AGENTS 第 6 节"无符合策略的 Sandbox 时拒绝执行"落地
- 每次执行落 plugin_execution + 审计(状态/时长);进程级隔离的边界如实注明(网络/文件系统最小化在 Linux 容器档交付)
- 测试 96 项全绿(+2):echo 真实执行回填、死循环 5s 超时强杀、异常 failed 含 stderr、无沙箱 503
2026-09-12 13:38:41 +08:00

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 范围与发布门。

S
Description
No description provided
Readme
62 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 44.7%
TypeScript 29.9%
HTML 16.7%
Rust 4%
CSS 2.6%
Other 2.1%