dotagents
One dot. Every agent.
Download · Discord · Docs
______________________________________________________________________
DotAgents为您提供了一个由人工智能专家组成的团队,每个专家都有知识、技能和工具,由您的声音控制。建立在 .agents 开放标准,因此您的技能适用于Claude Code、Cursor、Codex和采用该协议的每个工具。
预览
什么是DotAgents?
DotAgents有三件事:
1.应用程序 --语音优先的AI代理接口。保持说话,释放行动。你的代理人代表你倾听、思考和执行工具。
2.The .agents 协议 --代理技能、知识笔记和命令的开放标准。一次性定义你的技能 .agents/,它们可以跨Claude Code、Cursor、OpenCode和任何采用该协议的工具工作。
3.代理技能 --您的代理可以学习的可重用功能。技能是可移植的、可共享的和可组合的,而不是锁定在任何单一的工具或供应商中。
关键概念
| 概念 | 描述 |
|---|---|
| 技能 | 中定义的可移植代理功能 .agents/skills/。跨工具工作。 |
| 知识笔记 | 持久代理上下文存储在 .agents/knowledge/。代理在会话中保留基于笔记的上下文。 |
| 代理配置文件 | 具有独特技能和工具的专业人工智能代理。将任务委派给正确的代理。 |
| 语音接口 | 保持录制,30多种语言,自动将结果插入任何应用程序。语音是主要的接口。 |
| MCP工具 | 用于工具执行、OAuth 2.1身份验证和实时进度的模型上下文协议集成。 |
| acpx代表团 | 多代理协调。代理通过以下方式将子任务委托给其他代理 acpx 跑步者。 |
这 .agents 协议
这 .agents/ directory是跨工具工作的代理配置的开放标准:
.agents/
├── agents/ # Agent profile definitions
├── skills/ # Reusable agent capabilities
├── knowledge/ # Persistent note context across sessions
├── commands/ # Custom agent commands
├── tasks/ # Reusable task definitions
├── dotagents-settings.json # DotAgents settings overlay
├── mcp.json # MCP server definitions
└── models.json # Provider/model presets您为DotAgents定义的技能可以在Claude Code、Cursor、Codex和任何采用该协议的工具中使用。协议第一,产品第二。
快速开始
下载
安装在一条线上:
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bashWindows PowerShell:
irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex手动下载:
- macOS最新版本 —
.dmg构建 - Windows最新版本 —
.exe安装程序 - Linux最新版本 —
.AppImage和.deb人工制品
平台支持:macOS、Windows和Linux桌面版本从同一发布渠道发布。一些操作系统级权限和集成因平台而异。
用法
录音:
- 保持
Ctrl(macOS/Linux)或Ctrl+/(Windows)开始录制 - 发布 停止录制和转录
- 文本会自动插入到活动应用程序中
代理模式:
- 保持
Ctrl+Alt开始录制代理模式 - 发布
Ctrl+Alt使用所选代理进行处理 - 观察代理使用技能、工具和委派的实时进度
- 结果会自动插入或显示
文本输入:
Ctrl+T(macOS/Linux)或Ctrl+Shift+T(Windows)用于直接打字
特性
| 类别 | 功能 |
|---|---|
| 语音 | 按住录制,30多种语言,Fn切换模式,自动插入任何应用程序 |
| 文本转语音 | 通过OpenAI、Groq和Gemini自动播放50多个AI声音 |
| 多Agent | 代理简介、基于技能的委托、持久的知识、, acpx-支持协调 |
| MCP工具 | 工具执行、OAuth 2.1身份验证、实时进度、对话上下文 |
| 远程服务器 | 可选本地API,用于移动配对、兼容OpenAI的客户端、运营商仪表板和隧道 |
| 可观测性 | 浪伏 LLM跟踪、令牌使用和调试的集成 |
| 平台 | macOS/Windows/Linux,速率限制处理,多提供商AI |
| 用户体验 | 暗/亮主题、可调整大小的面板、终止开关、对话历史记录 |
配置
AI提供商 --在设置中配置:
- OpenAI、Groq或Google Gemini API密钥
- 按供应商选择型号
- 自定义基本URL(可选)
MCP服务器 --在中添加工具 mcpServers JSON格式:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
}
}
}键盘快捷键:
| 快捷方式 | 操作 |
|---|---|
等等 Ctrl / Ctrl+/ (Win) | 录音 |
Fn | 打开/关闭听写 |
等等 Ctrl+Alt | 代理模式(macOS) |
Ctrl+T / Ctrl+Shift+T (Win) | 文本输入 |
Ctrl+Shift+Escape | 关闭开关 |
发展
git clone https://github.com/aj47/dotagents-mono.git && cd dotagents-mono
nvm use
pnpm install && pnpm --filter @dotagents/desktop build-rs && pnpm dev看 Developpent.md 对于贡献者入口点,或直接跳到规范文档:
对于Docusaurus文档站点,运行:
pnpm --filter docs-site start建筑
dotagents-mono/
├── apps/
│ ├── desktop/ # Electron app (voice, agents, MCP)
│ └── mobile/ # React Native mobile app
├── packages/
│ ├── core/ # Cross-app runtime/config primitives
│ ├── shared/ # Shared utilities, types, and constants
│ └── mcp-whatsapp/# WhatsApp MCP server
├── docs-site/ # Docusaurus docs and primary website
└── .agents/ # The open standard — skills, knowledge notes, commands贡献
我们欢迎捐款。分叉仓库,创建一个功能分支,并打开一个Pull Request。
Discord 的中文翻译是“不和谐”或“纷争”。 | 文档
许可证
该项目根据 AGPL-3.0许可证.
致谢
______________________________________________________________________
DotAgents社区精心制作
