切换项目AgentDeck
本页目录:项目概览

Agent 工具 · 本机 Web 应用

面向同时使用多个 Agent 客户端的开发者,在本地界面中整理 Skills、插件与 MCP 配置。先看清资源属于哪个客户端、在哪个范围生效,再为支持的单项配置预览改动、确认应用并保留恢复记录。

用途
本地资源目录与配置管理
应用结构
Vue + Fastify
数据存储
SQLite

使用场景

多个 Agent 的配置,放在一个目录里看清

同一种资源可能出现在不同客户端、用户目录或项目配置中;操作前需要先确认它的归属与范围。

AgentDeck 将部分 Codex、ZCode、Claude Code 与 DeepSeek Harness 配置整理成统一资源目录,保留来源与识别信息。遇到同名资源或不确定的启用状态时,可以先检查关联配置,再决定是否修改。

配置变更流程

一次单项配置调整,如何完成

以支持启停的单项配置为例:从发现、核对到预览应用,每一步都围绕明确的目标配置展开。
  1. 找到配置

    发现客户端或登记实例与项目,扫描后进入资源目录。

  2. 核对归属

    查看来源、作用范围与所属 Agent,确认该单项是否支持变更。

  3. 预览改动

    针对支持的启停操作生成计划,先查看将修改的内容。

  4. 确认应用

    确认后应用计划,保存操作记录与恢复所需的备份。

  5. 按需恢复

    从操作记录创建恢复计划,再次预览和确认;外部改动可能导致冲突。

这是依据实现整理的流程示例。资源被扫描到后,界面仍会区分可操作与只读状态;只有明确支持的单项才进入变更流程。修改后的客户端加载状态,需要在对应客户端中确认。

资源目录

让配置归属和状态一目了然

资源根据类型、来源、作用范围和所属 Agent 整理;图中是依据公开实现绘制的示意,不是产品截图。
资源类型目录信息变更能力

Skills

按来源、作用范围与所属 Agent 查看已识别资源。

部分单项支持

插件

显示客户端、来源及可识别的配置状态。

依来源判断

MCP 配置

查看配置归属;只有已验证支持的单项配置可申请变更。

部分单项支持

项目级或未经验证的资源保持只读。具体能力以客户端、配置格式与识别结果为准。

关键设计与实现

将发现、变更与恢复分开处理

不同客户端的配置格式和可写范围不同,统一目录之下仍保留各自的识别与修改规则。

适配器负责识别差异

各客户端适配器发现和扫描配置,目录层统一呈现资源类型、来源、范围与归属。识别到配置后,是否可写仍按来源和支持规则判断。

变更引擎先生成计划

预览与写入分开执行;应用时检查配置是否发生变化,操作记录关联备份。恢复同样生成计划,遇到外部改动时通过冲突检查阻止覆盖。

本机服务承载界面与记录

Vue 提供资源浏览和操作界面,Fastify 提供本机 API,SQLite 保存目录与操作数据。服务只监听回环地址;AgentDeck 不负责启动资源进程。

支持范围

识别能力决定可操作边界

配置管理以客户端、来源与识别结果为依据,区分支持的单项变更和只读资源。

已验证支持的单项配置

可查看变更计划,确认后应用;操作记录可以用于生成恢复计划。

项目级或未验证资源

保持只读展示,不把“识别到”理解为“可以安全修改”。

运行中的 Agent 资源

AgentDeck 不启动 Skill、插件或 MCP 服务,也不代表客户端已经加载了某项修改。

仓库记录的 Codex 原生验收覆盖隔离配置根中的独立用户级 STDIO MCP 配置读写与恢复。各客户端其他可写范围和版本要求以仓库支持表为准;这一记录不代表所有配置格式都已完成原生验收。

安装与源码

从隔离演示数据了解工作流程

仓库提供本机启动方式和隔离演示数据,可先查看资源目录与变更流程,再了解各客户端的支持范围。

安装、开发运行与构建步骤见公开 README。操作计划与备份保存在本机应用数据目录,可能包含原始配置内容,应保存在可信的本机位置。源码按适配器、目录服务、变更引擎和存储分层,便于查看每一类配置的处理方式。