开源 · MIT License · 支持语音对话

With the Power of Thunder,
Command Your Digital World

⚡ ZuesHammer 宙斯之锤 - 融合三大开源AI智能体精华的超级AI助手。
语音对话 · 智能记忆 · 安全可控

$ curl -fsSL https://raw.githubusercontent.com/pengrambo3-tech/zueshammer/main/install.sh | bash

Linux / macOS / Termux · 无需手动安装依赖 · 一键完成

🎙️ 语音优先

🧠 智能记忆

🔐 安全可控

🚀 一键安装

一条命令完成从依赖安装到智能体配置

复制并执行安装命令

bash

curl -fsSL https://raw.githubusercontent.com/pengrambo3-tech/zueshammer/main/install.sh | bash

自动完成：Python 环境 → 虚拟环境 → 依赖安装 → 配置创建

选择交互模式（安装时可选）

⭐ 推荐

🎤 语音对话

通过麦克风语音输入，AI语音合成输出，最自然的交互方式

🌐 UI界面

Web浏览器界面，文字对话 + 可视化展示

💻 终端对话

命令行界面，适合服务器环境

选择权限级别（安装时可选）

🔒 安全模式

所有危险命令需手动审批

新手推荐

⭐ 推荐

🛡️ 半开放模式

低风险操作自动执行，高风险操作需审批

日常使用

🔓 全开放模式

无任何限制，所有命令直接执行

⚠️ 受信任环境

开始使用

bash

# 语音对话（推荐）
zues-voice

# UI界面
zues-ui
# 然后访问 http://localhost:9119

# 终端对话
zues-cli

高级安装选项

bash

# 自动安装（使用推荐设置）
curl -fsSL https://raw.githubusercontent.com/pengrambo3-tech/zueshammer/main/install.sh | bash -s -- --auto

# 完整配置安装
curl -fsSL https://raw.githubusercontent.com/pengrambo3-tech/zueshammer/main/install.sh | bash -s -- \
  --accept-terms \
  --api-key YOUR_API_KEY \
  --permission semi_open \
  --mode voice

参数	说明	可选值
`--auto`	完全自动安装，使用默认值	-
`--api-key`	ChinaWhAPI Key	你的 Key
`--permission`	权限级别	safe / semi_open / full
`--mode`	启动模式	voice / ui / cli

🎙️ 三种交互模式

根据场景选择最适合您的交互方式

🎤

语音对话

⭐ 推荐

✓ 麦克风语音输入
✓ AI 语音合成输出
✓ 唤醒词 "Zues"
✓ 中英文双语支持
✓ 最自然的交互

zues-voice

🌐

UI界面

Web界面

✓ 浏览器访问
✓ 文字对话
✓ 可视化展示
✓ 历史记录
✓ 多端同步

zues-ui
访问 http://localhost:9119

💻

终端对话

命令行

✓ 快速响应
✓ 日志完整
✓ 适合服务器
✓ 资源��用低
✓ 远程操作

zues-cli

🔐 权限控制

三重安全级别，自由选择

🔒

安全模式

locked

✓ 所有危险命令需手动审批
✓ 沙盒保护，完全控制
✓ 审计日志完整
✓ 截图确认

适用：新手、正式环境、敏感操作

⭐ 推荐

🛡️

半开放模式

semi_open

✓ 低风险操作自动执行
✓ 高风险操作需审批
✓ 智能风险评估
✓ 可配置白名单

适用：日常使用、开发调试 ⭐

🔓

全开放模式

full_unleashed

⚠️ 无任何限制
⚠️ 所有命令直接执行
⚠️ 无确认提示
⚠️ 无审计日志

⚠️ 仅限受信任环境

运行时切换权限

bash

# 查看当前权限
zues --status

# 切换权限
zues --permission safe        # 安全模式
zues --permission semi_open   # 半开放模式
zues --permission full        # 全开放模式

📖 快速使用

# 启动智能体
zues                    # 使用默认设置启动
zues --voice-first     # 语音优先模式启动

# 基本对话
你好                    # 打招呼
帮助                    # 显示帮助
状态                    # 显示系统状态
模式                    # 显示当前权限模式
静默                    # 开启静默模式（不主动语音播报）
取消静默                # 关闭静默模式（启用语音播报）
退出                    # 退出程序

# 语音唤醒
说 "Zues" 或 "宙斯" 唤醒智能体

# 语音命令
"帮我查一下天气"       # 查询信息
"搜索一下这个"          # 搜索互联网
"打开浏览器"            # 执行操作

# 结束对话
说 "退出" 或 "再见" 结束程序

# 完全卸载
# 1. 停止所有进程
pkill -f zues

# 2. 删除安装目录
rm -rf ~/.zueshammer

# 3. 删除快捷命令
rm -f ~/.local/bin/zues
rm -f ~/.local/bin/zues-voice
rm -f ~/.local/bin/zues-ui
rm -f ~/.local/bin/zues-cli

# 4. 编辑 ~/.zshrc 或 ~/.bashrc，删除 PATH 相关行

❓ 常见问题

Q: 需要 API Key 吗？

A: 是的，ZuesHammer 需要 ChinaWhAPI Key 来运行 AI 功能。请访问 chinawhapi.com 获取。

Q: 支持哪些操作系统？

A: Linux、macOS、Android (Termux)、Windows (WSL)。

Q: 语音功能怎么使用？

A: 使用 zues-voice 启动，然后说 "Zues" 唤醒，直接说话即可。

Q: 如何更新？

A: 运行 zues --update 或重新执行安装脚本。

Q: 如何获取帮助？

A: GitHub Issues · GitHub 仓库

With the Power of Thunder, Command Your Digital World

🚀 一键安装

复制并执行安装命令

选择交互模式（安装时可选）

🎤 语音对话

🌐 UI界面

💻 终端对话

选择权限级别（安装时可选）

🔒 安全模式

🛡️ 半开放模式

🔓 全开放模式

开始使用

高级安装选项

🎙️ 三种交互模式

语音对话

UI界面

终端对话

🔐 权限控制

安全模式

半开放模式

全开放模式

运行时切换权限

📖 快速使用

❓ 常见问题

Q: 需要 API Key 吗？

Q: 支持哪些操作系统？

Q: 语音功能怎么使用？

Q: 如何更新？

Q: 如何获取帮助？

With the Power of Thunder,
Command Your Digital World