A4api

a4api

**四端 AI 编程工具管理台**：为 **Claude Code、Codex、dsh（DeepSeek Harness）与 ZCode（智谱 Agentic 开发环境）** 提供统一的**技能管理（Skill）**、**MCP 管理**与 **API 服务商切换**。所有操作通过可视化界面完成，无需手动编辑配置文件。

能力	说明
技能管理	四端全局/项目级 skill 自动发现、聚合标注、跨端迁移、回收站恢复，一键把项目 skill 补齐到所有缺失的端
MCP 管理	四端 MCP server 自动发现与一键安装、跨端迁移（按传输能力矩阵校验）、快照回收站、自动/自定义功能介绍，密钥全程脱敏/加密
API 切换	四端不同服务商、模型、API Key 一键切换，配置自动备份、原子写入，密钥 DPAPI 加密存储

---

技能管理

四个工具均使用同一套技能格式（`/SKILL.md` 目录 + frontmatter `name`/`description`），因此 a4api 可以把它们当作一种资源统一管理。

发现与聚合

• 自动扫描四端全局与项目级技能目录，以 frontmatter name 为唯一标识做聚合标注：同名技能跨端存在时自动标记「已在 N 端存在」。
• 项目根目录列表可配置（默认扫描 C:\ProgramMine），只收录含至少一个 skill 的项目。
• Codex 全局的保留目录（.system/ 等点开头目录）自动跳过，不视为用户技能。

跨端迁移与「一键适配四端」

• 任意一端的 skill 可迁移到任意目标端（全局或任意项目），迁移为非破坏复制：源端永久保留。
• 目标端已存在同名技能（frontmatter name 或目录名任一命中）时，旧版自动移入回收站而非静默覆盖。
• 「一键适配四端」：一键把项目内全部 skill 按其缺失的端一次补齐，先弹计划清单再执行，带进度条并临时锁定页面，防止中途误操作。
• 每次迁移写入迁移日志（时间、Skill、源、目标、结果），全程可追溯。

回收站

• 删除的 skill 移入回收站，30 天内可恢复原位或彻底删除；恢复时原位置被占用会明确报错，绝不覆盖。
• 过期条目在下次访问回收站时惰性清理，并在返回结果中提示本次清理数量。

四端技能目录

工具	全局（用户级）	项目级
Claude Code	~/.claude/skills/	<项目>/.claude/skills/
Codex	~/.codex/skills/	<项目>/.codex/skills/
dsh	~/.dsh/skills/（$DSH_HOME 可覆盖）	<项目>/.dsh/skills/
ZCode	~/.zcode/skills/	<项目>/.zcode/skills/

ZCode 官方还识别跨工具兼容目录 `~/.agents/skills` 与 `<项目>/.agents/skills`；a4api 统一托管到 `.zcode` 前缀，与其它端保持一致。迁移到 ZCode 的 skill 会被 ZCode 客户端真实读取。

---

MCP 管理

四端的 MCP server 都写在各自的配置文件里，a4api 把它们归一为统一视图（`name` / `transport` / `command` / `args` / `env` / `url` / `headers`）管理。

发现与聚合

• 自动发现四端全局与项目级 MCP server，同名 server 跨端聚合标注（「已在 N 端存在」）。
• 详情中 env / headers 一律脱敏（只回显键名），API 永不回传明文密钥。
• 每张卡片显示该 server 的功能介绍：自动识别常用 server（内置简介库 + npx 包实时查询 npm registry，均有缓存与失败兜底），也支持点「介绍」手工维护说明（本地持久化、跨端共享、留空即清除）。
• 项目级自动识别：Claude Code .mcp.json、Codex .codex/config.toml、ZCode .zcode/config.json。

安装 MCP 服务