Releases: Bullobis/kevrai-omni
Releases · Bullobis/kevrai-omni
Release list
Kevrai Omni v2.8.0 — 可插拔技能库 + 自动更新
Kevrai Omni v2.8.0 — 可插拔技能库 + 短剧编剧方法论移植
发布日期: 2026-09-12
版本: 2.8.0
代号: Skills
概述
v2.8.0 把 v2.7.0 扁平的 11 工具 Agent 升级为可插拔技能（Skill）系统：每个技能是一组工具 + 一段领域方法论（注入系统提示词），用户可在 Agent 面板的「🧩 技能库」里按需勾选添加 / 关闭，状态本地持久化；核心技能不可关闭。同时把专业短剧编剧方法论（双基调结构、情绪节拍库、导演/动画风格锚点、场景先登记后使用、四段产物）移植进短剧 Agent，并新增「写作工坊」「多模态提示词工坊」两个可选技能。工具总数由 11 扩展到 23（默认启用 16）。
新增功能
1. 可插拔技能系统（python/app/agent/skill.py）
- Skill：元数据（id/name/description/version/category/icon/required/default_enabled）+ 工具列表 + guidance 方法论。
- SkillManager：启用/禁用/切换/重置、active 工具物化、guidance 编译、工具→技能反查。
- 持久化：启停状态写入
agent/skills.json（原子写 .tmp 再 replace），与 SQLite 会话记忆解耦；损坏 / 含未知 id / 含必备技能时安全回退默认。 - 保护规则：
core必备技能禁关；技能 id 与工具名构造期校验，跨技能工具名重复直接报错，一个工具只属于一个技能。 - 向后兼容：
ALL_TOOLS（11）与build_default_registry()原样保留，旧测试与外部调用不受影响。
2. 六个内置技能（默认 16 工具，全开 23）
| 技能 id | 名称 | 默认 | 工具数 | 工具 |
|---|---|---|---|---|
core |
核心助手 | 必备·常开 | 3 | get_preferences / set_preference / generate_text |
model_catalog |
模型市场检索 | 开 | 5 | search_models / model_info / recommend_models / list_installed / list_categories |
local_system |
本机环境与下载 | 开 | 3 | check_hardware / list_engines / download_model |
drama_studio |
短剧创作工坊 | 开 | 5 | drama_storycraft / drama_brainstorm / drama_compose_script / drama_storyboard / drama_render_plan |
writing_studio |
写作工坊 | 关（按需添加） | 4 | writing_outline / writing_polish / writing_summary / writing_translate |
media_prompt_studio |
多模态提示词工坊 | 关（按需添加） | 3 | build_image_prompt / build_video_prompt / build_music_prompt |
3. 短剧编剧方法论移植（python/app/drama.py）
方法论移植自专业短剧创作流程，并改造为「LLM 提示词注入 + Python 规则钳制」，不引入对话式分批确认等宿主交互：
- 双剧作基调
STORY_MODES：micro_film微电影三幕式 /hook_drama短视频钩子驱动，各含章节结构比例与创作原则。 - 情绪节拍库
BEAT_LIBRARY（9 种：hook/conflict/escalate/break_ice/turn/payoff/climax/closure/transition），中英文自由文本归一到标准键。 - 风格锚点库：6 大真人导演流派组 + 5 种动画流派，要求风格字段具体到导演/流派，杜绝「电影感/高级质感」这类模糊词。
- 四段产物：剧情梗概 synopsis、人物小传（role/motivation/arc/key_prop）、场景登记清单 scene_registry、分场分镜（含 beat）。
- 场景先登记后使用：本地小模型未遵守时自动补登记并记录
registry_auto_added，不中断流水线。 - 数量/时长钳制沿用并扩展：单镜最长 8s、场景/角色/每场景镜头数上限。
4. 两个新工具包
- 写作工坊：大纲骨架、润色清单+文本统计、抽取式摘要（词频+位置加权）、翻译规范；离线确定性可用，
use_llm=true且已加载对话模型时附带本地模型成品。 - 多模态提示词工坊：为图像/视频/音乐编译提示词包，每个结果都含 positive 正向、negative 负面（内置负面词库）、theme_constraints 主题一致性约束，并做画幅白名单、时长/BPM 钳制——直接服务后续「提示词必须含负面词与主题约束」的视频生产要求。
5. Agent 集成与规则回退增强（python/app/agent/agent.py）
- 构造函数接入 SkillManager，
reload_skills()在技能切换后重建活动工具表。 - 系统提示词新增「已启用技能（领域方法论）」区块，只注入启用技能的 guidance。
- 规则回退（无 LLM）新增短剧 / 提示词 / 写作大纲三条确定性路由，并给原有硬件、搜索路由加工具启用守卫：技能关闭后不会尝试调用缺失工具。
6. HTTP / IPC / 前端
- 新增
GET /api/agent/skills、POST /api/agent/skills/{id}、POST /api/agent/skills/reset、GET /api/drama/storycraft；drama brainstorm/script 透传mode、style_anchor。 - preload / main 三层 IPC 全打通；Agent 面板新增可折叠「🧩 技能库」（开关、工具标签、必备/默认标记、恢复默认、切换后实时刷新工具数）。
- 短剧页新增基调单选（微电影/钩子驱动）、导演/动画风格锚点下拉；剧本展示剧情梗概、场景登记清单、人物动机/成长弧/关键道具与节拍标签；修复
_topic隐式全局。
测试与验证
- 新增
python/tests/test_v280_skills.py（54 个用例）：Skill/SkillManager 校验与持久化、内置技能计数、三个工具包、drama 方法论（罐装 LLM，不依赖真模型）、Agent+技能集成、HTTP API（含 400/404）。 - 全量
pytest：475 passed（v2.7.0 基线 421 + 新增 54），零回归。 scripts/smoke.sh全绿：catalog JSON/schema、密钥扫描、pip、全量 pytest、所有 JSnode --check、electron-builder 校验。- 极端测试：空/空白/超长输入、非法画幅/模式、负时长与越界 BPM 钳制、工具 handler 抛异常不炸注册表、损坏 skills.json、只留 core 技能的回退路径。
- 实机验证：真实
uvicorn起服走 HTTP 验证 skills/toggle/reset/storycraft/规则路由；三层 IPC 命名逐一交叉核对一致。
版本号
| 文件 | 2.7.0 → 2.8.0 |
|---|---|
python/app/__init__.py |
✅ |
package.json / package-lock.json |
✅ |
catalog/models.json / catalog/engines.json（顶层 version） |
✅ |
python/tests/test_v260_catalog.py（版本断言） |
✅ |
兼容性
- 完全向后兼容：旧的扁平注册表 API 保留；默认启用技能与 v2.7.0 行为一致（额外默认开启短剧工坊）。
- 新增本地状态文件
agent/skills.json，删除即恢复默认，不影响会话记忆。
Kevrai Omni v2.5.0 — 环境随选下载
Kevrai Omni v2.5.0 发布说明
发布日期：2026-09-03
新功能：软件内一键安装 Python 运行环境
安装包继续保持小巧——Python 与推理引擎一样随选下载：
- 启动时自动按顺序寻找 Python：
KEVRAI_PYTHON环境变量 → 软件托管的
用户数据目录/python-runtime→ 系统 Python（python/py/python3） - 完全没装 Python 的 Windows 机器：不再报错退出，而是进入「环境准备」页，
点「一键安装 Python 环境」自动完成：- 从国内镜像下载 Python 3.12.7 embeddable（约 11 MB；npmmirror → 华为云 → 官网三级回退）
- 解压到用户数据目录（不写注册表、不污染系统、无需管理员权限）
- 自动修补嵌入式 Python 的
._pth（启用 site-packages） - 引导安装 pip（腾讯源）
- 安装软件运行依赖（python/requirements.txt）
- 自动重启后端并进入主界面
- 有 Python 但缺依赖：后端启动日志检测到
ModuleNotFoundError时同样进入
引导页，一键补装依赖 - 全程进度条 + 日志可见；Linux/macOS 给出手动命令指引（自动化暂只覆盖 Windows）
其他
- sidecar 启动失败诊断增强：stderr 尾部采集，用于区分"缺 Python / 缺依赖 / 其他"
- 版本号：应用 2.5.0；README / INSTALL 同步更新
测试
- 全部 JS
node --check通过；pytest 323 项保持全绿；smoke 通过 - 许可证不变：CC BY-NC-SA 4.0（禁止商用）
Kevrai Omni v2.4.2 — 质量修复版
Windows 安装包（v2.4.2 新增）
- 文件：
Kevrai-Omni-Setup-2.4.2.exe（82.9 MB，NSIS 安装包） - 双击安装 → 自动创建桌面快捷方式 Kevrai Omni
- 安装包不含推理引擎与模型（按需下载，保持小巧）；需要系统已装 Python 3.10+（环境管理页会引导）
- SHA-256：
ab23578a2797d0b7dde41149cbd294911456bab2ee757045fea3aad1503cd973
Kevrai Omni v2.4.2 发布说明
发布日期：2026-09-02
关键修复（建议 v2.4.1 用户升级）
- 设置保存崩溃：
PUT /api/settings引用了 Downloader 上不存在的
max_concurrent属性，导致每次保存设置都 500 —— 已修复。 - HF Token 无法下发：
SettingsUpdate缺失hf_token字段，设置页填的
Token 同步不到后端，gated 模型（如 LTX-2.5）实际下载不到。已修复并补
HTTP 级回归测试（先复现、后修复）。 - converter 隐性崩溃：
sys_executable()使用sys.executable但模块未
导入sys，调用即 NameError。已修复。
优化与清理
- 按用户偏好移除内置负面提示词：LTX 生成的
negative_prompt默认值清空，
界面文本框不再预填（字段保留，高级用户可自行填写）。 - 死代码清理：未使用导入 20+ 处（catalog/converter/downloader/engines/env/
hardware/importer/ltx_runtime/main/mnn_runtime/runner）、xxhash 无效可选导入、
只读场景多余global、needs_update占位死代码。 - 弃用 API：
datetime.utcnow()→ timezone-aware；pydantic protected
namespace 警告全消（Settings/SettingsUpdate/LtxGenerateReq/MnnLoadReq/
DramaRenderPlanReq）。 - INSTALL.md 重写至 v2.4.2：清除停留在 v2.2.0 的"便携包"旧说法，改为
安装包 + 桌面快捷方式 + 引擎按需下载 + gated Token 指引。
测试
- 323 passed / 0 failed（新增 6 项 HTTP 级 v2.4.1 功能回归）
- 全部 JS
node --check通过；smoke.sh 通过 - 许可证不变：CC BY-NC-SA 4.0（禁止商用）
Kevrai Omni v2.4.1 — 修复优化版
⚠️ 本版存在两个已修复问题（设置保存崩溃、HF Token 未同步到下载器），请改用 v2.4.2。
Kevrai Omni v2.4.1 发布说明（修复优化版）
发布日期：2026-09-02
事实性修正（模型目录）
minimax-h3条目原指向不存在的MiniMaxAI/Hailuo-H3，现修正为 ComfyUI 官方重打包仓库
Comfy-Org/MiniMax-H3；官方权重条目minimax-h3-omni保留MiniMaxAI/MiniMax-H3，并补充 GitHub 源码源。minimax-h3-omni描述修正：本地开源的 H3-Base 最高输出 768p；2K 由未开源的
H3-Regenerate-2K 模块完成（官方 2026-08-07 Reddit AMA 承诺将开源，暂无日期），目前 2K 仅可走官方 API。minimax-2k-pending更新为最新进展时间线（7/31 发布 → 8/3 H3-Base 开源 → 8/7 承诺 2K 模块开源）。ltx-2.5条目修正：官方最低显存 16GB（原写 12GB）；许可修正为
LTX-2.x Community License（年收入 < 1000 万美元免费）；新增gated: true标记（HF 受控访问仓库）。qwen3.8-27b条目修正：明确为社区开发者 JonathanColetti 的无审查微调 + GGUF 量化版（非 Qwen 官方仓库），
repo指向真实下载源JonathanColetti/Qwen3.8-27B-Uncensored-GGUF。
新功能
- gated 下载支持：设置页新增 HuggingFace Token；gated 模型下载自动附加
Authorization: Bearer请求头（Token 不会回显到进度快照/日志）；未配置 Token 时
/api/download/start返回 422 + 中文指引。 - 引擎更新检测：
POST /api/engines/check-updates（GitHub releases 查询，6 小时缓存）、
POST /api/engines/update（一键更新）；GET /api/engines附带版本号与最新 tag。
新装引擎自动以当前最新 tag 作为基线，避免误报「有更新」。 - 首次启动新手引导：三步上手浮层（localStorage 记忆，不再重复打扰）。
修复
- LTX 生成面板：低于官方最低 16GB 显存的预设标注「实验」，选择时显示明确提示。
- 产品名统一为 Kevrai Omni（原 Kevrai Studio），覆盖安装包、快捷方式、窗口标题、文档。
兼容性
- 升级覆盖安装即可；桌面快捷方式随安装包自动创建/更新。
- 许可证不变：CC BY-NC-SA 4.0（禁止商用）。
Kevrai Studio v2.4.0
🚀 Kevrai Studio v2.4.0
✨ 新功能
- LTX-2.5 视频生成：新增 LTX-2.5 文生视频/图生视频运行时，支持 5 档显存预设（4GB–24GB+）、任务队列、进度回调、取消、VAE slicing/CPU offload，输出 MP4（libx264）
- 超级搜索引擎：全新后端搜索引擎，字段加权（名称/ID/标签/引擎/分类/仓库/描述）、精确/前缀/子串/子序列/编辑距离拼写纠错、CJK 中文 bigram 匹配、多 token 跨字段 AND、匹配高亮、分面聚合、5 种排序、最近搜索、"did you mean" 建议
- 前端搜索体验：180ms 防抖、分面筛选 chips、排序下拉、热门开关、最近搜索下拉、零结果建议、键盘导航（/ ↑↓ Enter Esc）、结果高亮
- LTX 生成面板：模式/预设/提示词/负向/宽高帧数/CFG/seed/参考图/格式/VAE offload 开关、进度条、任务列表、视频画廊
⚡ 优化
- GZip 压缩中间件，API 响应体积显著减小
- 搜索语料 LRU 缓存，毫秒级响应
/api/models增强排序与 repo 字段检索disk_info路径不存在时向上遍历祖先，修复 FileNotFoundError- Electron IPC 新增 8 个 search/ltx 代理 handler，preload 含入参校验
📦 目录数据
- 110 个模型全部补全 tags 与 modality
- 30 个引擎（新增 ltx-video 引擎，含 pip 包与多镜像源）
- LTX-2.5 条目增强（trending + 详细 modality/notes/files）
🧪 测试
- 303 项测试全部通过（含 34 项搜索、32 项 LTX 运行时、26 项 API 极端/安全用例：正则注入、XSS、空字节、超长输入、路径穿越等）
- 7 个 JS 文件
node --check语法检查通过 - 实机 sidecar 冒烟测试通过（搜索/LTX capabilities/参数校验）
📥 下载
- Windows x64 安装包：
Kevrai Studio-Setup-2.4.0.exe（~79 MB）
Kevrai-Omni v2.2.0
Kevrai-Omni v2.2.0
一站式 MiniMax H3 本地视频 / 图片生成工作站（Windows 11 玻璃拟态 UI）。
📦 下载
| 平台 | 文件 |
|---|---|
| Windows 11 | Kevrai-Omni-Setup-2.2.0.exe |
| Linux（Debian / Ubuntu，amd64） | Kevrai-Omni-2.2.0-amd64.deb |
| Linux（x86_64 便携版） | Kevrai-Omni-2.2.0-x86_64.AppImage |
| 源码 | kevrai-omni-2.2.0-source.tar.gz / kevrai-omni-2.2.0-source.zip |
校验和见同版本 SHA256SUMS.txt（Windows：Get-FileHash -Algorithm SHA256 文件名；Linux/macOS：sha256sum 文件名）。
下载与安装说明详见 README。
✨ 功能亮点
- 模型市场：19 个已核实模型（视频 / 图片 / LoRA / ComfyUI 专用），真实测速 + 智能选源 + 断点续传
- 多芯片适配：自动检测 NVIDIA CUDA / AMD ROCm / 华为昇腾 NPU / Intel XPU / DirectML，按后端+显存配出最优策略
- 视频生成：文生视频 / 首帧 / 尾帧 / 首尾帧 / 全模态参考 / 音频驱动 / 视频编辑（Retake）
- 图片生成：Z-Image-Turbo（通义官方 8 步出图）+ Qwen-Image-2512（中文文字渲染强）
- 体验：中英双语、无边框玻璃拟态 UI、作品库、12 套提示词模板、ComfyUI 工作流一键复制、DIY 自定义打包校验
⚖️ 协议
- 代码 CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享，禁止商用）；衍生作品须同协议发布
- MiniMax H3 权重：MiniMax H3 Community License（排除美国 / 欧盟 / 英国 / 韩国）
- 依赖：diffusers 生态 Apache-2.0；PySide6 LGPL；bitsandbytes MIT
本软件免费开源，仅供个人学习、创作与研究使用，严禁商用。
Kevrai-Omni v2.1.0（微调生态扩充）
v2.1.0
社区微调生态扩充（hf-mirror 全量扫描，2026-08-11）
- fal 写实人物风格 LoRA（fal.ai 官方，65MB）
- Tutu 8 步 NFE 加速 LoRA（音画同步加速约 2.5 倍）
- unsloth GGUF Q4_K（11.4GB 低显存路线）
- Kijai TAE 快速预览（9.8MB）
市场扩至 23 包（视频 11 / 图片 3 / LoRA 9），全部带热度数据与格式说明。
优化
生成页新增本机预期速度参考（基于社区实测数据）
测试全过：flake8 零警告 + 冒烟 + 八页面回归 + 筛选专项。
Kevrai-Omni v2.0.0（图片生成 + 双语）
Kevrai-Omni v2.0.0
品牌升级：MiniMax H3 Studio → Kevrai-Omni（仓库同步改名）
新增
- 🖼️ 图片生成：Z-Image-Turbo（通义官方 8 步快速出图）+ Qwen-Image-2512（官方旗舰，中文文字渲染强）；图片模型负向提示词有效
- 🌐 中英双语：跟随系统语言自动切换（中文→中文；其他一律英文），设置页可手动覆盖
- 🔍 市场筛选栏：全部 / 🎬视频 / 🖼️图片 / ⚡LoRA / 🔧ComfyUI 专用
- 🏪 模型市场扩充至 19 个精选模型（全部带社区热度数据与介绍）
验证
flake8 零警告 / 冒烟全过 / 八页面 GUI 回归 / 筛选与语言规则专项测试全过
打包方法：解压后双击「一键打包.bat」。
H3 Studio v1.11.0（LoRA 生态 + 内置教程）
v1.11.0
- LoRA 市场扩充至 6 个（全部带社区热度数据与格式适配说明）
- 移除负面提示词（H3 CFG 蒸馏不生效）
- 生成页 12 个快捷模板按钮（小白一键套用）
- 「帮助教程」页内置于软件：三步上手 + FAQ + 高级模式（ComfyUI 工作流入口）
- 首次启动引导；卡片热度徽章；智能选源下载
完整说明见 README.md；附件为完整源码包（含使用教程）。打包方法：解压后双击「一键打包.bat」。
v1.9.0 非商用开源版
v1.9.0
许可证变更：MIT → CC BY-NC-SA 4.0
本项目免费开源，供个人学习、创作与研究使用。严禁任何商业用途（包括出售、收费服务、商业产品内置、企业营利性使用）。衍生作品必须以相同协议发布。商用需联系创作者授权。
本版更新
- LICENSE / LICENSE.txt / README 全面更新为 CC BY-NC-SA 4.0
- 软件内「设置 → 关于」标注创作者、开源地址、许可协议
- 标题栏标注创作者