Agent 工具 · 本机 Web 应用
AgentDeck
面向同时使用多个 Agent 客户端的开发者,在本地界面中整理 Skills、插件与 MCP 配置。先看清资源属于哪个客户端、在哪个范围生效,再为支持的单项配置预览改动、确认应用并保留恢复记录。
- 用途
- 本地资源目录与配置管理
- 应用结构
- Vue + Fastify
- 数据存储
- SQLite
使用场景
多个 Agent 的配置,放在一个目录里看清
同一种资源可能出现在不同客户端、用户目录或项目配置中;操作前需要先确认它的归属与范围。AgentDeck 将部分 Codex、ZCode、Claude Code 与 DeepSeek Harness 配置整理成统一资源目录,保留来源与识别信息。遇到同名资源或不确定的启用状态时,可以先检查关联配置,再决定是否修改。
配置变更流程
一次单项配置调整,如何完成
以支持启停的单项配置为例:从发现、核对到预览应用,每一步都围绕明确的目标配置展开。找到配置
发现客户端或登记实例与项目,扫描后进入资源目录。
核对归属
查看来源、作用范围与所属 Agent,确认该单项是否支持变更。
预览改动
针对支持的启停操作生成计划,先查看将修改的内容。
确认应用
确认后应用计划,保存操作记录与恢复所需的备份。
按需恢复
从操作记录创建恢复计划,再次预览和确认;外部改动可能导致冲突。
这是依据实现整理的流程示例。资源被扫描到后,界面仍会区分可操作与只读状态;只有明确支持的单项才进入变更流程。修改后的客户端加载状态,需要在对应客户端中确认。
资源目录
让配置归属和状态一目了然
资源根据类型、来源、作用范围和所属 Agent 整理;图中是依据公开实现绘制的示意,不是产品截图。Skills
按来源、作用范围与所属 Agent 查看已识别资源。
插件
显示客户端、来源及可识别的配置状态。
MCP 配置
查看配置归属;只有已验证支持的单项配置可申请变更。
项目级或未经验证的资源保持只读。具体能力以客户端、配置格式与识别结果为准。
关键设计与实现
将发现、变更与恢复分开处理
不同客户端的配置格式和可写范围不同,统一目录之下仍保留各自的识别与修改规则。适配器负责识别差异
各客户端适配器发现和扫描配置,目录层统一呈现资源类型、来源、范围与归属。识别到配置后,是否可写仍按来源和支持规则判断。
变更引擎先生成计划
预览与写入分开执行;应用时检查配置是否发生变化,操作记录关联备份。恢复同样生成计划,遇到外部改动时通过冲突检查阻止覆盖。
本机服务承载界面与记录
Vue 提供资源浏览和操作界面,Fastify 提供本机 API,SQLite 保存目录与操作数据。服务只监听回环地址;AgentDeck 不负责启动资源进程。
支持范围
识别能力决定可操作边界
配置管理以客户端、来源与识别结果为依据,区分支持的单项变更和只读资源。已验证支持的单项配置
可查看变更计划,确认后应用;操作记录可以用于生成恢复计划。
项目级或未验证资源
保持只读展示,不把“识别到”理解为“可以安全修改”。
运行中的 Agent 资源
AgentDeck 不启动 Skill、插件或 MCP 服务,也不代表客户端已经加载了某项修改。
仓库记录的 Codex 原生验收覆盖隔离配置根中的独立用户级 STDIO MCP 配置读写与恢复。各客户端其他可写范围和版本要求以仓库支持表为准;这一记录不代表所有配置格式都已完成原生验收。
安装与源码
从隔离演示数据了解工作流程
仓库提供本机启动方式和隔离演示数据,可先查看资源目录与变更流程,再了解各客户端的支持范围。安装、开发运行与构建步骤见公开 README。操作计划与备份保存在本机应用数据目录,可能包含原始配置内容,应保存在可信的本机位置。源码按适配器、目录服务、变更引擎和存储分层,便于查看每一类配置的处理方式。