Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Decuria · 三个臭皮匠

CI License: AGPL-3.0 Hermes Agent Plugin Python 3.9+ Website

简体中文 · English

三个臭皮匠,顶个诸葛亮。 让多个 AI 互相补位、彼此质疑——把「问一个模型」升级成「开一场专家圆桌」。

Decuria 是 Hermes Agent 的独立 Dashboard 插件。它把多模型圆桌协作、通道模型路由、Provider 管理、模型可见性控制收进一个面板,不改 Hermes 一行核心代码,装上即用。


模型越接越多,为什么反而更累?

当你接入的模型多起来,真正吃掉时间的往往不是「问 AI」,而是「管 AI」:

  • 配置分散:微信、飞书、Telegram 想各用一个模型,得反复翻 config.yaml,改一次、重启一次。
  • 凭据零散:Provider、Base URL、多个 API Key 散落各处,新增模型后还要手动核对哪个能用。
  • 列表臃肿:模型越堆越长,真正常用的那几个反而要翻半天才找得到。
  • 单模型盲区:再强的模型也有盲区、偏见和幻觉,可关键决策往往只听它一家之言。
  • 协作又慢又贵:想让几个模型交叉验证,只能手动复制问题、来回粘贴、人工汇总,费时又费 Token。
  • 代理难精细:有的 Provider 必须走代理、有的必须直连,全局代理一刀切根本不够用。

Decuria 把这些痛点收拢成四个页面:一次配置、清晰可见、按需协作、渠道直达。


四个页面,四类问题一次解决

1. 智囊团 · 让模型互相补位,而不是只听一个答案

智囊团圆桌

智囊团基于 Hermes Agent v0.18.2 原生的 Mixture-of-Agents(MoA)能力打造,把原本只能靠配置文件驱动的多模型协作,升级成一张拖拽即可编排、全程可视化的专家圆桌

把模型拖进「专家席」和「指挥席」,就组成一张圆桌:最多 8 位专家并行、各自独立作答,再由 1 位指挥模型综合共识、分歧与建议,最后交付一份结论。

你的问题
  ├─ 专家 A:摆事实、找证据
  ├─ 专家 B:挑风险、提反例
  ├─ 专家 C:给方案、谈落地
  └─ 更多专家(最多 8 位)
          ↓
      指挥模型综合裁决
          ↓
   最终结论 / 共识报告

在原生 MoA 之上,Decuria 补齐了一整套可视化与编排体验:

  • 拖拽式圆桌编排:谁上场、谁指挥、几位专家,拖一拖就定,无需手写配置文件。
  • 专家席 / 指挥席一目了然:圆桌布局直观呈现每个角色,一眼看懂这场会商是怎么组织的。
  • 单轮 / 多轮辩证:单轮各答一次、指挥汇总,省时省钱;多轮(2–5 轮)让专家看到上一轮观点继续质疑修正,还能开启「高共识提前结束」,收敛即停、不浪费调用。
  • 用量总览:每位专家与指挥各消耗了多少 Token 一目了然,成本心里有数。
  • 通讯端一键召集:在已授权的消息渠道用触发词直接开团,与 Dashboard 共享同一套圆桌与辩证设置。

2. 通道配置 · 每个入口,都用最合适的模型

通道配置

全局默认模型、各消息渠道、图片 / 视觉 / 视频候补模型,全在一页里配置。模型、Provider、Key 三级联动选择,批量保存,从此告别手改配置文件、逐条重启。

3. 模型管理 · 只让真正需要的模型进入视野

模型管理

模型按 Provider 分组,可搜索、可只看免费模型。新增 Provider 的模型默认全部关闭——你只开自己要用的;日后刷新发现的新模型同样默认关闭,列表永远清爽不淹没。

4. Provider 管理 · 兼容接口,也有完整的管理体验

Provider 管理

新增、编辑、启用 / 禁用任意 OpenAI 兼容 Provider,支持自定义 Base URL、同一 Provider 挂多个 API Key、以及按 Provider 单独开关代理。API Key 只回传不可逆预览,绝不下发明文。


安装

仓库地址:https://github.com/seanyang1983/decuria

作为 pip 包

pip install decuria && hermes plugins enable decuria

两步合一:pip install 下载插件代码,hermes plugins enabledecuria 加入 config.yamlplugins.enabled 启用清单。Hermes 默认不自动加载第三方插件,启用后重启 Gateway 即生效。

或作为目录插件

# macOS / Linux
git clone https://github.com/seanyang1983/decuria.git ~/.hermes/plugins/decuria && hermes plugins enable decuria
# Windows PowerShell(PowerShell 5.1 不支持 &&,分两步)
git clone https://github.com/seanyang1983/decuria.git "$HOME\.hermes\plugins\decuria"
hermes plugins enable decuria

在 active profile 的 config.yaml 中启用:

plugins:
  enabled:
    - decuria

重启 Gateway,需要时启动 Dashboard:

hermes gateway restart
hermes dashboard

打开 Dashboard,在侧栏进入「三个臭皮匠」。完整步骤见 使用指南

5 分钟上手

  1. Provider 管理确认 Provider 与凭据。
  2. 模型管理刷新目录,只开启准备使用的模型。
  3. 通道配置设置全局、各渠道与多模态候补模型。
  4. 智囊团拖入专家与指挥,选择单轮或多轮。
  5. 在 Dashboard 提问,或从已授权的消息渠道直接召集。

在通讯端召集智囊团

已通过 Hermes allowlist / pairing 授权的渠道用户,可直接在消息里用触发词召集智囊团(英文不区分大小写):

智囊团 · 智囊 · MoA · 专家团 · 专家圆桌 · 混合智能 · mixture of agents

智囊团 请从产品、技术、商业三个角度评估这个方案
MoA 帮我比较 A 和 B 的风险、收益与实施成本
专家圆桌 为这次发布做一次反方审查
智囊团[方案名] 分析这个问题

通讯端与 Dashboard 共享同一套圆桌模型与辩证设置;同时最多执行 2 个渠道任务,重复请求会收到忙碌提示。多轮辩证会显著增加调用量,请按任务价值使用。

安全与隐私

  • API Key 不外泄:普通响应只返回不可逆预览,明文仅在已认证的编辑操作中回填,且禁止缓存。
  • 外部请求受控:校验 URL、目标地址与每一次重定向,认证请求禁止跨来源重定向;JSON、图片、视频与 Base64 解码均有体积上限。
  • 写入安全:配置与状态采用锁、临时文件、fsync 与原子替换。
  • 授权与隔离:渠道触发复用 Hermes 的 allowlist / pairing,不对未授权用户开放;运行时数据按 profile 隔离在 <HERMES_HOME>/data/decuria/,不污染插件源码目录。

若任何 Key 曾出现在日志、截图或提交历史中,请立即在服务商后台轮换。安全报告流程见 SECURITY.md

开发与验证

python -m py_compile state_paths.py security_utils.py __init__.py moa_core.py moa_trigger.py media_tools.py dashboard/plugin_api.py
python -m unittest discover -s tests -v
node --check dashboard/dist/index.js

前端为无需构建的 Preact IIFE;后端修改后需重启 Dashboard / Gateway。插件 API 挂载在 /api/plugins/decuria

License

Decuria 采用 GNU AGPL-3.0 许可发布。Copyright © 2026 Decuria Team。

  • 个人、学习、研究,以及愿意同样开源的项目:可自由使用、修改、分发。但只要你修改了 Decuria 并通过网络对外提供服务(包括私有部署给他人使用),就必须向这些使用者公开你修改版的完整源码(AGPL 第 13 条)。
  • 闭源或商业集成:若你不愿公开自己的源码(例如把 Decuria 集成进闭源产品或商业服务),请联系作者获取商业授权(双授权)。

第三方资产(内置的 Preact、Provider 图标等)保留其各自原始许可证,详见 THIRD_PARTY_NOTICES.md。品牌名称与商标归各自权利人所有。

About

三个臭皮匠 · 多模型智囊团 Dashboard 插件 · Mixture of Agents for Hermes Agent

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages