Skip to content
项目

YYHDBL/AgentCrew has 253 GitHub stars and 49 forks. GitHot measured 0 stars in 24 hours, -1 in 7 days, and -1 in 15 days. Last checked 2026-11-15 13:51 UTC. Last push 2026-10-12.

这些数字如何统计

可以做什么

  • Task workspace - Create conversations, attach files and folders, follow streamed responses, and queue or cancel instructions.
  • Controlled tools - Read and write files, run commands, and make HTTP requests within configured access rules; review operations that require approval.
  • Persistent memory - Maintain user and workspace knowledge, agent profiles, reusable skills, and searchable conversation context.
  • Recovery and inspection - Resume interrupted work and inspect recorded steps, tool results, approvals, and audit events in the Run Center.

实测星标增长

24小时
0
7天
-1
15天
-1
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Local-first desktop workspace for AI agents, with human approvals, persistent memory, scheduled tasks, and auditable execution.

效率工具

README.zh-CN.md

原文

AgentCrew 应用图标

AgentCrew

让 AI 员工在本地桌面持续处理任务,执行过程清楚可查。

macOS · Apple Silicon · Electron + Python

English · 简体中文

AgentCrew 将任务执行、人工审批、持久记忆和定时任务整合到一个桌面应用。你可以交办任务、添加文件与文件夹材料,查看实时回复、执行步骤、工具调用和结果。新的指令可以进入队列,中断的任务可以恢复,运行中心保留完整的执行记录供你检查。

工作区、聊天记录、记忆、模型凭据和审计记录保存在本机。模型请求发送到你配置的服务商,HTTP 与 MCP 连接器按照明确授予的权限访问外部服务。

功能

功能范围 具体能力
任务工作台 创建会话、添加文件与文件夹、查看流式回复、排队执行指令,以及取消任务。
工具与审批 按照访问规则读取与写入文件、执行命令、发起 HTTP 请求,并由用户审核需要审批的操作。
持久记忆 管理用户知识、工作区知识、员工身份、可复用技能,以及可检索的会话上下文。
恢复与运行记录 恢复中断任务,在运行中心查看步骤、工具结果、审批和审计事件。
定时任务 创建与管理重复执行的任务,审核模型提出的计划,并接收本地通知。
员工与权限管理 管理员工、工作区、角色、资源访问范围、连接器与审批规则。

从源码运行

桌面构建面向 Apple Silicon 架构的 macOS。开发环境需要 Python 3.12 及以上版本、uv、Node.js 22.12 及以上版本和 npm。请确保 uv 位于 PATH 中,Electron 会在开发模式下自动启动 Python 任务服务。

git clone https://github.com/YYHDBL/AgentCrew.git
cd AgentCrew

cd backend
uv sync --locked --python 3.12

cd ../desktop
npm ci
npm run dev

应用打开后,进入“模型连接”,配置主模型和辅助模型,保存配置并选择“验证连接”。主模型负责执行任务,辅助模型负责摘要与记忆处理。连接验证会向服务商发送少量真实请求。

当前模型目录中的 **DeepSeek V4.1 Flash(OpenCode Go)**具备经过核查的上下文窗口和固定版本的 tokenizer 资源,可以用于任务执行。为两个模型配置选择该目录项,填写服务商的 API 密钥。源码运行首次使用时会下载固定版本的 tokenizer 文件并核验哈希;任务执行需要通过上下文计数检查并能够访问模型服务。

选择工作区与员工,添加任务所需材料并发送指令。在执行过程中处理审批请求,完成后检查实际结果与运行记录。应用界面使用简体中文。

数据与运行条件

开发模式的数据目录为 backend/data/。安装应用使用 Electron 的用户数据目录,“桌面设置”页面可以显示确切位置并在 Finder 中打开。模型凭据保存在本机配置文件中,分享备份或诊断材料时请保护数据目录。

定时任务需要应用与电脑保持运行。关闭窗口时可以让应用驻留托盘;退出应用或关闭电脑会停止执行。应用重新启动后会登记期间错过的计划,这些计划不会自动补跑。

构建 macOS 安装包

安装依赖后,在仓库根目录执行:

backend/.venv/bin/python scripts/release/build_sidecar.py --arch arm64
cd desktop
npm run dist:mac

构建会携带 Python 任务服务、依赖、固定版本的模型计数资源和依赖许可文件。产物写入 desktop/release/,其中包括 AgentCrew-0.4.0-arm64.dmg。打包配置声明最低系统版本为 macOS 13。Developer ID 签名和公证需要相应的 Apple 凭据,上面的命令本身不保证产物已经签名或公证。

开发与贡献

安装接口生成工具的锁定依赖,然后检查接口契约与桌面构建:

cd desktop
npm ci --prefix tools/api-generator
npm run check:api
npm run build
node tests/m3-contract-types.mjs

后端检查与打包说明见开发指南。报告问题和提交修改前,可以阅读贡献指南。

目录 内容
backend/agentcrew_core/ Agent 执行、模型适配、工具、记忆策略与恢复逻辑。
backend/agentcrew_server/ 本地接口、持久化、运行服务、定时调度与权限管理。
desktop/ Electron 应用、React 界面、生成的接口类型与桌面测试。
docs/contracts/ 用于验证与代码生成的 HTTP 和事件契约。
scripts/ 验证脚本、数据准备工具和发布构建工具。