Development
Plugin
aihelms
企业级 AI 资源纳管平台，提供统一 AI网关、Token调度能力，纳管 OpenAI、Azure、Claude、DeepSeek 等主流模型，并支持 MCP 工具与 Skill 的集中注册分发。具备内外双轨定价、成本归因、统一身份认证、安全审计与效能报表，帮助企业精准控制成本、量化 ROI，高效治理 AI 资产。
Plugin Signal62/100Solid
maintained97
capable29
documented50
adopted63
Stats
933
Stars
93
Forks
Active
Maintenance
Python
Language
GPL-3.0
License
6d ago
Last commit
3mo ago
Created
Repo: beizhu-1209/AIHelms
What's inside
Commands
3/code-reviewPerform a comprehensive review of code changes, checking quality, security, performance, and convention compliance./devStandard flow to start the AIHelms local development environment./testComplete test execution flow including backend and frontend tests, lint checks, and coverage reports.
README
1
核心价值 · 功能展示 · 快速开始 · 部署文档 · 使用手册
这是什么
AIHelms 是面向企业的 AI 资源纳管平台。帮助企业管理 AI 资产、控制 AI 成本、衡量 AI 价值的管理工具。
- 决策层 - 平台全程记录用量、核算成本、生成报表，让看得见 AI 的投入产出比
- 管理员 - 通过后台统一接入模型、分配身份、设定预算
- 员工 - 通过用户端获取 AI 身份，接入任意客户端使用
核心价值
成本可见可控
企业使用 AI 最大的焦虑是"钱花了但不知道花在哪"。AIHelms 建立了完整的成本体系：
- 内外双轨定价 — 外部成本（供应商实际收费）和内部结算价（企业对部门的计费）分开核算。企业可以按成本价透传，也可以加价内部结算
- 多维预算管控 — 按人、按部门、按项目、按模型设预算，支持软限制（预警）和硬限制（超支停用）
- 实时成本归因 — 每一次调用都能追溯到具体的人、部门、项目、模型，精确到 token 级别
统一身份统一入口
- 每位员工一个 AI 身份（API Key），一个入口访问所有 AI 资源
- AI员工（进行中）
量化 AI 价值
- 覆盖率 — 部门覆盖率、人员激活率、模型使用分布
- 活跃度 — 日均调用量、人均 token 消耗、使用趋势曲线
- 成本效能 — 部门成本排名、模型性价比、预算消耗进度、内外成本差异
- 效能报告 — 周/月自动生成，支持按部门、项目、模型多维下钻
安全审计
- 敏感信息识别
- 高风险 prompt 拦截
- 管理员操作追踪
资源集中管理
- 模型纳管 — 多供应商统一接入，同模型多部署负载均衡，OpenAI/Anthropic 双格式兼容
- Skill & MCP — 企业内部 AI 工具统一注册、审批、分发
- 权限精细化 — 谁能用什么模型、用多少额度、什么时候过期，全部可配置
更新日志
最近版本汇总自 GitHub Releases，完整变更请以发布页为准。
| 版本 | 发布时间 | 一句话更新 |
|---|---|---|
0.1.20 | 2026-08-04 | 解决日志同步问题；修复时间显示；更新模型广场接入信息 |
0.1.19 | 2026-07-23 | 更新Hy3、Grok支持；改造静态资源托管；更新部分API批量功能；更新模型管理底座Litellm到1.93版本 |
0.1.18 | 2026-07-22 | 成本明细部门/项目新增 Token 列并支持行内穿透查看下属人员；效能总览、成本、预算及看板新增 Token 用量统计与人员 Top10 榜单 |
0.1.17 | 2026-07-17 | 统一 AI 效能部门/项目筛选并修复成本明细；日志及管理页增加模糊搜索，完善人员与 Key 联动；用户端接入说明补充 Workbuddy。 |
0.1.16 | 2026-07-14 | 新增企业版许可证管理和平台品牌自定义能力。 |
0.1.15 | 2026-07-13 | 修复部分bug。 |
0.1.14 | 2026-07-07 | AI Policies 增加大模型审查。 |
0.1.13 | 2026-07-03 | 新增 AI Policies 安全审查：一键扫描 Skill，自动识别恶意指令、数据外传、权限过大等风险并生成报告。 |
0.1.12 | 2026-07-01 | 资源申请支持批量审批；Skill / MCP 新增作者信息，用户端显示使用量。 |
0.1.11 | 2026-06-29 | 优化日志修复codex /goal 等长Agent日志错配问题。 |
0.1.9 | 2026-06-27 | 新增小米 MiMo 模型接入和模型 Logo 选择；AI 身份限流更完善（总量 + 按模型限速）。 |
0.1.8 | 2026-06-23 | 支持 vLLM 的 Anthropic 格式接入。 |
0.1.7 | 2026-06-23 | 修复成本计算和日志统计的若干问题，账目更准。 |
0.1.6 | 2026-06-16 | 完善模型连通性测试。 |
0.1.5 | 2026-06-10 | 升级管理员看板与成本、效能、预算分析体验。 |
0.1.4 | 2026-06-04 | 修复若干问题，合入社区贡献。 |
主要功能
管理后台
面向 IT 管理员和 AI 负责人，覆盖资源管理全流程。
| Dashboard — 今日调用、成本、待办一览 | 模型纳管 — 供应商接入、多部署、连通性测试 |
| AI 身份 — Key 签发、预算分配、生命周期 | AI效能 — 成本分析、覆盖率、效能报告 |
| 模块 | 能力 |
|---|---|
| 模型纳管 | 供应商管理、凭证管理、模型注册、多部署负载均衡、路由策略、连通性测试 |
| AI 身份 | 部门/项目/人员管理、Key 签发、预算额度、速率限制、模型白名单 |
| AI 市场 | Skill 发布上架、MCP Server 注册发现、资源申请审批 |
| AI 效能 | 成本分析（内/外）、落地覆盖率、预算管控、效能报告 |
| 安全 | 管理员审计日志、操作追踪 |
| 智能体中心 | 智能体创建、配置、生命周期管理 |
用户端 AI Hub
面向全体员工，简洁直观，获取 AI 身份后即可使用。
- 查看 AI 身份，一键复制 Key 和接入点
- 浏览模型广场，按场景选择模型 ID
- 浏览 AI 市场，申请 Skill / MCP 使用权限
- 查看本月用量和预算消耗
快速开始
环境要求
- Docker 20.10+ & Docker Compose v2+
- 4 核 8G 内存（最低）
部署
git clone https://github.com/beizhu-1209/AIHelms.git
cd AIHelms
cp .env.example .env
# 编辑 .env 填入密钥
docker compose up -d
访问
| 地址 | 说明 |
|---|---|
http://your-host | 用户端 |
http://your-host/admin | 管理后台 |
http://your-host/api/docs | API 文档 |
默认管理员：admin / 密码见 .env 中 SUPER_ADMIN_PASSWORD
三步上手
1. 管理后台 → 供应商管理 → 添加凭证
2. 管理后台 → 模型管理 → 新建模型 → 关联凭证 → 发布
3. 用户端 → 我的 AI 身份 → 复制 Key 和 Endpoint → 配置到客户端
技术栈
| 层级 | 技术 |
|---|---|
| 后端 | Python 3.11+, FastAPI, Gunicorn, Celery |
| 前端 | Vue 3.4+, TypeScript, Vite 5+, TailwindCSS |
| 数据库 | PostgreSQL 16+ |
| 缓存 | Redis 7+ |
| 部署 | Docker Compose, Nginx |
| 变量 | 说明 |
|---|---|
POSTGRES_PASSWORD | 数据库密码 |
SECRET_KEY | JWT 签名密钥 |
SUPER_ADMIN_PASSWORD | 超级管理员初始密码 |
WEB_PORT | Web 对外端口 |
完整列表见 .env.example
./dev/setup # 首次设置
./dev/start-docker-compose # 启动中间件
./dev/start-api # 启动后端（热重载）
./dev/start-web # 启动前端（HMR）
详见 开发与发布流程
RoadMap
AI 实验室
| 功能 | 一句话总结 |
|---|---|
| 报告 | 汇总 AI 效能、成本、预算等分析结果，形成面向管理汇报的报告视图。 |
| AI 健康 | 集中查看 MCP 上游、模型部署、Docker 环境和效能数据更新状态。 |
| 敏感信息识别 | 识别 AI 交互内容中的敏感信息，支撑后续告警、审计和处置。 |
| A2A | 规划智能体之间的协作、调用关系和任务联动能力。 |
| 上下文缓存 | 缓存高频上下文和会话材料，减少重复输入并降低调用成本。 |
| 策略管理 | 高风险识别，包括电子围栏、prompt 注入等。 |
| 文件处理 | 对上传文件进行解析、切分、索引和预处理，供后续 AI 能力调用。 |
Contributing
- Fork 本仓库
- 创建分支：
git checkout -b feature/xxx - 提交代码到dev分支：
git commit -m "feat: 功能描述" - 推送并创建 Pull Request
详细开发规范见 开发与发布流程
交流反馈
-
微信交流群：扫码加入
-
商业合作：联系邮件
-
Issue 反馈：GitHub Issues
License
本项目采用 GPL-3.0 开源协议，底座应用 LiteLLM 社区版（MIT License）。
如果您所在组织的政策不允许使用 GPL-3.0 许可的软件，或您希望规避 GPL-3.0 的开源义务，请发送邮件至 联系邮件 咨询商业授权。
File tree
553beizhu-1209/AIHelmsView on GitHub
.claude/
commands/
code-review.md
dev.md
test.md
rules/
AIhelms-rules.md
core-rules.md
project-rules.md
settings.json
skills/
frontend-design
.dockerignore
.env.example
.gitignore
apps/
__init__.py
api/
__init__.py
API_MESSAGES.md
v1/
__init__.py
access_test.py
agents.py
ai_keys.py
ai_policies.py
api_keys.py
audit_logs.py
auth.py
branding.py
business_scenarios.py
credentials.py
dashboard.py
departments.py
docs.py
efficiency.py
export_tasks.py
key_scenarios.py
license.py
mcp.py
models.py
projects.py
providers.py
resource_applications.py
roles.py
router.py
skills.py
usage_logs.py
users.py
celery_app.py
CLAUDE.md
core/
__init__.py
api_key_utils.py
audit.py
config.py
crypto.py
database.py
deps.py
exception_handlers.py
license_pubkeys/
key-2026.pem
logging.py
migrate.py
security.py
time_utils.py
exceptions.py
gunicorn_conf.py
main.py
models/
__init__.py
auth.py
db.py
department.py
project.py
role.py
user.py
pyproject.toml
repositories/
agent_repo.py
ai_key_model_limit_repo.py
ai_key_repo.py
ai_policies_repo.py
api_key_repo.py
audit_log_repo.py
branding_repo.py
business_scenario_repo.py
credential_repo.py
dashboard_repo.py
department_repo.py
efficiency_budget_repo.py
efficiency_cost_repo.py
efficiency_health_repo.py
efficiency_repo.py
efficiency_report_repo.py
efficiency_scope_filter.py
efficiency_scope_metrics_repo.py
export_task_repo.py
key_scenario_repo.py
license_repo.py
mcp_repo.py
model_repo.py
project_repo.py
provider_repo.py
resource_application_repo.py
skill_repo.py
usage_log_repo.py
user_repo.py
services/
__init__.py
access_test_error_mapper.py
access_test_precheck.py
access_test_service.py
agent_service.py
ai_key_service.py
ai_policies_denoise.py
ai_policies_llm.py
ai_policies_report.py
ai_policies_scanner_client.py
ai_policies_service.py
api_key_service.py
audit_log_service.py
auth_service.py
branding_service.py
business_scenario_service.py
credential_service.py
dashboard_service.py
department_service.py
docs_service.py
efficiency_adoption_service.py
efficiency_budget_service.py
efficiency_cost_service.py
efficiency_health_service.py
efficiency_report_service.py
efficiency_service.py
export_task_builders.py
export_task_service.py
icon_url.py
key_scenario_service.py
license_service.py
litellm_client.py
litellm_credential_payload.py
mcp_service.py
model_service.py
project_service.py
provider_service.py
resource_application_service.py
role_service.py
skill_service.py
usage_log_service.py
user_service.py
tasks/
__init__.py
ai_policies_tasks.py
audit_log_tasks.py
efficiency_tasks.py
export_task_tasks.py
llm_log_tasks.py
mcp_tasks.py
tests/
__init__.py
test_access_test_error_mapper.py
test_access_test_precheck.py
test_ai_key_rate_limits.py
test_ai_policies_service.py
test_branding_service.py
test_cost_detail_scope_users.py
test_efficiency_scope_filters.py
test_icon_url.py
test_license_service.py
test_litellm_credential_payload.py
test_llm_log_cost.py
test_llm_log_sync_cursor.py
test_provider_prefix_routing.py
test_resource_application_batch.py
test_usage_log_filters.py
test_user_top10.py
CLAUDE.md
dev/
migrate
setup
start-api
start-docker-compose
start-web
docker/
docker-compose.middleware.yaml
docker-compose.yml
db/
init.sql
migrations/
001_efficiency_runtime_columns.sql
002_create_export_tasks.sql
003_resource_applications_runtime_columns.sql
004_cost_summary_cache_columns.sql
005_add_ai_key_rate_limits.sql
006_add_xiaomi_mimo_prefix_map.sql
007_add_model_logo.sql
008_add_litellm_spendlogs_cursor_index.sql
009_add_author_and_mcp_call_count.sql
010_create_ai_policies.sql
011_license_branding.sql
012_add_branding_square_logo.sql
013_add_resource_icon_urls.sql
014_add_tencent_xai_prefix.sql
015_widen_llm_call_log_request_id.sql
016_add_sync_state_last_request_id.sql
litellm/
litellm.yaml
nginx/
default.conf.template
dev.default.conf.template
docker-entrypoint.sh
nginx.conf.template
proxy.conf.template
skillspector/
Dockerfile
server.py
supervisor/
start.sh
supervisord.conf
Dockerfile
docs/
dashboard.png
datacenter.png
id.png
INTERNAL.md
model.png
struct.png
web.png
wechat.jpg
LICENSE
README.en.md
README.md
THIRD_PARTY_NOTICES.md
ui/
CLAUDE.md
package-lock.json
package.json
packages/
admin/
env.d.ts
index.html
package.json
postcss.config.js
public/
favicon.ico
static
src/
App.vue
assets/
providers/
anthropic.svg
azure.svg
bedrock.svg
custom.svg
dashscope.png
deepseek.svg
google.svg
lmstudio.svg
minimax.svg
moonshot.svg
ollama.svg
openai_compatible.svg
openai.svg
sglang.png
vertex_ai.svg
vllm.png
volcengine.png
xiaomi_mimo.png
zhipu.svg
components/
AccessTestDialog.vue
ConfirmDialog.vue
ExportTaskNotice.vue
HeaderBar.vue
IconPicker.vue
Pagination.vue
ProviderIcon.vue
ScopePickerDialog.vue
scopePickerTypes.ts
SearchableSelect.vue
Sidebar.vue
TooltipIcon.vue
layouts/
AdminLayout.vue
main.ts
router/
index.ts
style.css
views/
agents/
AgentDetail.vue
AgentList.vue
ai-keys/
AiKeyDetail.vue
AiKeyManage.vue
BatchResourceDialog.vue
BudgetCell.vue
KeyFormDialog.vue
KeyResourceBudget.vue
RateLimitCell.vue
ScenarioTab.vue
ai-policies/
AiPoliciesLabView.vue
AiPoliciesView.vue
AuditReportView.vue
api-keys/
ApiKeyManage.vue
audit/
AuditLogManage.vue
ExportTasksManage.vue
business-scenarios/
BusinessScenarioManage.vue
dashboard/
components/
DashboardUserTop10.vue
DashboardView.vue
departments/
DepartmentManage.vue
efficiency/
adoptionTypes.ts
AdoptionView.vue
BudgetView.vue
components/
AdoptionResourceSections.vue
AgentQuadrant.vue
BudgetProgress.vue
CompositionDonut.vue
CostCharts.vue
CostDetailSection.vue
GlassCard.vue
HeatmapTable.vue
KpiCard.vue
ParetoChart.vue
PresetTabs.vue
SuggestionCard.vue
TrendChart.vue
UserTop10Panel.vue
costTypes.ts
CostView.vue
EfficiencyLayout.vue
HealthView.vue
OverviewView.vue
ReportsView.vue
useScopeFilter.ts
utils.ts
Login.vue
logs/
components/
LogDrawer.vue
LogsManage.vue
tabs/
AgentLogsTab.vue
LlmLogsTab.vue
McpLogsTab.vue
SkillLogsTab.vue
mcp/
McpManage.vue
McpServerForm.vue
McpToolPanel.vue
models/
ModelManage.vue
projects/
ProjectManage.vue
providers/
ProviderManage.vue
resource-approval/
ResourceApprovalManage.vue
roles/
RoleList.vue
skills/
SkillDetail.vue
SkillList.vue
system/
BrandingView.vue
LicenseView.vue
users/
UserForm.vue
UserList.vue
tailwind.config.js
tests/
useScopeFilter.test.ts
tsconfig.json
vite.config.ts
shared/
package.json
src/
api/
accessTest.ts
agent.ts
ai-key.ts
aiPolicies.ts
apiKey.ts
auditLog.ts
auth.ts
branding.ts
businessScenario.ts
credential.ts
dashboard.ts
department.ts
... 240 moreFAQ
aihelms is a Claude Code plugin with hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is aihelms?
- 企业级 AI 资源纳管平台，提供统一 AI网关、Token调度能力，纳管 OpenAI、Azure、Claude、DeepSeek 等主流模型，并支持 MCP 工具与 Skill 的集中注册分发。具备内外双轨定价、成本归因、统一身份认证、安全审计与效能报表，帮助企业精准控制成本、量化 ROI，高效治理 AI 资产。
- How do I install aihelms?
- Run these in Claude Code: . Then prompt normally.
- Does aihelms auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is aihelms free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.