告别多开终端找窗口！Craft Agents 把多 Agent 状态看板、自动 MCP 与远程运行装进桌面

在日常开发与 AI 编码实战中，像 Claude Code、Codex 这样的命令行 Agent 展现了极强的主动执行能力。然而，随着深度使用，纯 CLI 模式的边界与局限也愈发明显：当需要同时并发处理跨模块重构、需求调研和测试用例编写时，桌面会迅速被三四个终端黑框填满。每次切回任务，都必须滑动滚屏翻找历史上下文；如果遇上查文档、看图片或轻量编辑，反复打开独立窗口不仅打断心流，而且极易误操作中断长耗时任务。

为了打破这种“终端窗口碎片化”的痛点，笔记与协作工具 craft.do 团队开源了一款专为开发者打造的轻量桌面端工作台——Craft Agents（开源协议为宽松的 Apache-2.0）。它并非简单地在 CLI 外层套一层 Electron 壳，而是从多会话任务管理、免配置外部接入、细粒度执行权限、以及远程服务化架构四个维度重新解构了 AI 智能体的交互范式。

一、核心痛点：为什么纯终端 Agent 难以胜任多任务并行？

在探索图形化方案之前，我们需要厘清纯 CLI Agent 在中大型工程协同中的三大核心瓶颈：

1. 会话即丢失的状态盲区：终端会话本质是线性的流式输出，缺乏结构化的“状态生命周期”。当一个涉及数百个文件重构的任务在后台运行几十秒甚至几分钟时，开发者很难一眼看清它处于代码扫描、工具调用还是等待用户确认的状态。

2. MCP 与外部服务配置繁杂：为了让 Agent 读取 GitHub PR、查询 Linear Issue 或连接本地数据库，开发者常常需要手动维护复杂的 mcp_config.json，处理环境变量、绝对路径与启动参数，调试链路过长。

3. 安全审批非黑即白：命令行交互通常只有“单步确认（按 Y 继续）”或“全局放开危险模式（Skip all confirms）”。面对大量只读分析场景，逐次确认效率低下；而盲目授权又面临破坏本地工作区的安全隐患。

二、多会话状态看板：把聊天框升级为任务管理器

与常见的单栏 AI 聊天软件完全不同，Craft Agents 的首屏交互围绕 多会话 Inbox 展开。它将每一次 Agent 调度抽象为一个独立的任务卡片，并赋予明确的状态生命周期：

1. 任务四态流转机制

在 Craft Agents 内部，所有的工作流均遵循标准的工程看板流转： - Todo（待处理）：将突发的灵感、Bug 排查或重构需求先丢入队列，预置上下文与目标仓库，避免打断当前进行中的工作。 - In Progress（运行中）：任务在后台由 Agent 独立推进，提供实时执行日志与阶段进度指示条，主界面不被阻塞，支持随开随走。 - Needs Review（待复核）：当 Agent 产生代码 Diff、文档修改或关键决策时，自动挂起并提示开发者进行单点核验与 Diff 审查。 - Done（已完成）：确认无误后归档至历史记录，本地支持按项目、标签及时间跨度全文检索。

所有历史会话均保存在本地磁盘 ~/.craft-agent/ 目录中，支持自定义标星、归档与跨会话上下文检索，彻底告别了“关闭终端即丢失心智记录”的问题。

三、免配置外部服务：Agent 级自动协议嗅探与 MCP 挂载

在传统工具中，接入 Linear、GitHub 或 Notion 等服务需要查阅文档并手写 JSON 映射。而在 Craft Agents 中，挂载外部能力转变为一种声明式语言交互。

当你对 Agent 下达指令：

“帮我把项目中的 Linear 挂载进来，随时查需求。”

Agent 会在后台自动拉取对应的 MCP Server 规范，完成 Endpoint 校验与 Credentials 登记。对于已有成熟 claude_desktop_config.json 或 mcp_config.json 的开发者，直接复制 JSON 片段粘贴到输入框，系统即可无感导入并完成服务热加载，整个过程无需重启桌面程序。

四、三档权限阶梯与本地零信任隔离架构

为了兼顾开发效率与操作安全性，Craft Agents 设计了三档清晰的权限控制层级，并在界面中支持通过 Shift + Tab 快捷键瞬间切换：

1. 权限模式深度解析

1. Explore（只读探索模式）：Agent 仅获得文件读取、语法树分析、上下文检索及网络查询权限，所有的文件写入、命令执行和系统修改系统调用均被底层拦截。该模式最适合初读大型开源代码库、排查堆栈链路或查阅接口规范。

2. Ask to Edit（交互确认模式 - 默认）：Agent 在读取文件和分析时全速自主运行；当需要执行写文件、执行 Shell 脚本或发起破坏性操作时，会在右侧工作台弹出结构化审批面板，标明修改影响范围，由开发者逐项确认。

3. Auto（全自动自治模式）：适用于高信任度的封闭任务（例如执行完整的单元测试补全、批量生成 Markdown 结构等），跳过所有中间确认环节，最大化吞吐效率。

2. 本地 AES-256 加密与数据防泄漏

在数据隐私与合规方面，Craft Agents 遵循“数据主权归属本地”的原则： - 所有模型 API Key、OAuth Token 及外部系统凭据均采用 AES-256-GCM 对称加密保存在本机操作系统目录； - 界面无任何隐式遥测回传与云端同步，代码逻辑与提问上下文直接从本地建立客户端连接至模型提供商（如 Anthropic、OpenAI 或本地 Ollama 服务）。

五、工程架构实战：从远程服务端部署到自包含 CLI

Craft Agents 底层采用现代全栈架构：运行时依托高性能的 Bun，桌面 UI 基于 Electron + React + shadcn/ui + Tailwind CSS v4 打造，整体资源占用与冷启动性能显著优于传统重量级 IDE。

1. 跨机协同：将 Server 端部署到高性能远程主机

当本地轻薄本算力有限或代码运行在云端 Linux 开发机时，可利用内置的 Server 模式进行“前后端分离部署”：

# 在远程 Linux 开发机上生成高强度 32 字节 Hex 凭证并启动服务
CRAFT_SERVER_TOKEN=$(openssl rand -hex 32) bun run packages/server/src/index.ts

随后在桌面客户端的网络设置中填入远程 IP 与 Token，即可无缝将其作为“薄客户端”操作远端工程环境，任务即使切断网络也会在远程服务端常驻执行。

2. 自动化集成：自包含无头模式 craft-cli

对于更偏爱终端流水线的开发者，项目提供了伴生 CLI 工具，支持一键无头执行并直接返回结构化结果：

# 无头模式单次执行任务，执行完毕自动释放资源
craft-cli run "检查 packages/client/src/ 目录中的 TypeScript 类型定义并输出修复建议"

六、总结与选型建议

在 AI 研发工具高速演进的当下，Craft Agents 给开发者提供了一种在“纯 CLI 黑框”与“庞大 IDE 插件”之间的优雅平衡点：

• 如果你需要同时跟进 3 个以上的开发分支与调研任务：它的多会话看板能够大幅降低多任务切换的认知负荷；
• 如果你希望低门槛集成多款 MCP 工具但畏惧复杂配置：它的声明式自动接入与热生效机制几乎能省去全部配置烦恼；
• 如果你重视代码隐私与数据资产安全：完全开源的 Apache-2.0 协议与纯本地 AES 加密设计，能够为企业和个人提供扎实的安全底线。

对于正在寻找兼顾直观可视化与强大自治力工作流的工程师而言，这款工具值得纳入日常研发工具箱深度一试。