Skip to content

feat: 标准化 Agent 插件与 Skill，并完善 AGENTS.md 和 Windows 运行管理 - #117

Open
A-m-o-r-F-a-t-i wants to merge 10 commits into
uvwt:mainfrom
A-m-o-r-F-a-t-i:feat/heavy-plugins
Open

feat: 标准化 Agent 插件与 Skill，并完善 AGENTS.md 和 Windows 运行管理#117
A-m-o-r-F-a-t-i wants to merge 10 commits into
uvwt:mainfrom
A-m-o-r-F-a-t-i:feat/heavy-plugins

Conversation

@A-m-o-r-F-a-t-i

@A-m-o-r-F-a-t-i A-m-o-r-F-a-t-i commented Sep 15, 2026 •
edited
Loading

Copy link
Copy Markdown

背景

本 PR 将当前已完成并在 A-m-o-r-F-a-t-i/agentdock 1.0.1 中验证过的 AgentDock 改造统一提交到上游 main。重点是把 Skill、MCP、插件和项目规则整理成可移植的 Agent 标准结构，同时补齐 Heavy 渐进加载、图形化管理与 Windows 安装/恢复闭环。

主要改动

1. Agent 标准目录与可移植配置

  • 当前激活 Skill 使用与 Codex 对齐的可见目录结构，版本、回滚和宿主状态保存在隐藏管理目录；
  • 插件采用 Agent Plugins 1.0.0、Agent Skills 与 MCP 标准清单，根目录直接使用 plugin.json、mcp.json 和 skills/；
  • 符合上述规范的 Skill/MCP/插件内容无需先转换成 AgentDock 私有包格式；
  • 插件包内容与宿主开关、本机覆盖、凭据引用和持久数据分离；
  • 旧私有插件格式提供事务化迁移和失败恢复。

2. 标准插件与 Heavy 两层渐进加载

  • 普通插件直接暴露已启用成员；
  • Heavy 插件第一层仅暴露名称、描述和成员数量，调用 plugin_load 后第二层才展开 Skill/MCP 描述与工具索引；
  • Heavy 只通过标准 �xtensions.io.github.uvwt.agentdock.heavy 命名空间增加一个 AgentDock 扩展参数，不改变标准插件主体；
  • 插件成员不会在顶层 Skill/MCP 清单重复展示，减少大型专业插件的常驻上下文占用。

3. 插件、Skill、MCP 与运行参数管理面板

  • “功能与插件”页支持插件收起/展开、总开关、成员开关、Heavy 切换和删除；
  • Skill 与 MCP 可以独立启停，插件总开关不会破坏成员自己的开关状态；
  • 新增“运行配置”页，集中管理默认全局工作区、AGENTS.md 自动加载、额外指令文件、浏览器程序、可信代理 CIDR、命令环境变量引用、ACP 并发数和交互超时等原本需要修改配置文件的参数；
  • 控制面板并行加载插件、Skill、MCP 清单，慢服务不会阻塞已经取得的本地能力数据。

4. 全局与工作区 AGENTS.md 自动上下文

  • Core 自动发现用户目录 AGENTS.md 与当前工作区路径上的项目 AGENTS.md；
  • 按全局到项目顺序加载，并在 MCP 初始化 instructions 中提供启动快照；
  • �gentdock_context(workdir) 可以按请求选择工作区并重新读取最新规则，不修改命令默认工作目录；
  • 加入 Git/worktree 边界、文件类型/编码/大小限制、物理文件去重和路径安全检查。

5. Windows 安装、回滚与 Tunnel 稳定性

  • 修复真实覆盖安装中 Core 启动失败、旧锁残留、回滚状态失真和安装器失败恢复问题；
  • 安装/启动外层改用原生无控制台进程与 Task Scheduler COM，避免 PowerShell 黑窗；
  • 安装事务只有在目标版本健康检查通过后才提交，失败回滚恢复 generation、凭据和运行配置并重新验证旧版本健康；
  • Tunnel 生命周期支持启动阶段取消、重复启动识别、Core 重载中断恢复和运行阶段诊断；
  • 修复功能与插件页 POST 正文、Heavy 动作白名单及能力清单性能问题。

兼容性

  • 标准插件未知扩展命名空间可被其他客户端忽略；AgentDock 的 Heavy 行为不要求修改插件标准主体；
  • 现有 Skill 包操作语义、MCP transport 与凭据存储保持兼容；
  • 旧私有插件数据只在显式迁移/安装升级边界转换，普通 Core 启动不会静默改写用户目录；
  • �gentdock_context 仅增加可选能力，现有空参数调用继续有效。

验证

当前代码基线 9e0cb99 的 GitHub 检查已通过：

  • Windows Installer gate；
  • Windows PowerShell 5.1 Installer 验证；
  • Windows / macOS / Linux Go check；
  • Container check；
  • Native browser integration；
  • CodeQL Go analysis。

本次最后一个提交 9bd517 仅补充 docs/releases/v1.0.1.md 的上游差异说明，git diff --check 通过。完整 Windows x64 安装、覆盖升级、回滚、Tunnel 与产物哈希验收记录见 fork 的 AgentDock 1.0.1 Release。

@A-m-o-r-F-a-t-i
feat(context): auto-load global and workspace AGENTS.md
bf5c786 
Make operator and project guidance available through MCP initialization and
agentdock_context without requiring separate file reads, ACP, or Recall.

Discover the explicit global instructions file or the default AGENTS.md,
then load workspace guidance from the applicable root to the selected
directory. Return ordered content with provenance, hashes, and explicit
load/skip/error states. Read fresh files on each context request.

Add an optional request-local workdir selector without changing command
working directories or sharing workspace selection across clients. Keep
empty-argument calls compatible and preserve the private Nexus context
shape through the existing rules field.

Bound discovery and content sizes, validate UTF-8, reject automatically
discovered symlinks and non-regular files, and deduplicate physical files.
Preserve explicit instructions-file behavior and provide an autoload
opt-out through AGENTDOCK_AGENTS_AUTOLOAD.

Cover discovery, refresh, scope boundaries, Windows path casing, file
validation, concurrent workspace isolation, schema compatibility, and MCP
initialization/live-context delivery with regression tests. Document the
loading contract, configuration, and startup-snapshot limitations.
@A-m-o-r-F-a-t-i
feat(plugin): 增加重插件与分层能力加载
44d7b29 
- 用逻辑插件封装同领域 Skill 与动态 MCP，保留现有注册表兼容性
- 在 agentdock_context 中仅公开插件摘要，并由 plugin_load 延迟展开成员与 MCP 工具
- 为插件、Skill 和 MCP 增加独立开关及有效可用性校验
- 在 Windows 控制面板增加能力管理页、分组展示和中英文界面
- 补充 Runtime API、持久化、协议契约、集成测试与使用文档
@A-m-o-r-F-a-t-i
feat(plugin): 改为自包含重插件并迁移 Codex 风格目录
847c079 
- 插件目录直接携带 Skill、MCP 定义、实现文件与状态，不再使用中心 plugins.json 或 cache 层
- Skill 安装改为 Codex 风格可见目录并保留版本、回滚与事务语义
- Windows 管理面板支持安装/更新目录或 ZIP 插件及插件成员开关
- 增加离线迁移脚本、真实目录副本验证、Runtime API 路由、测试和使用文档
@A-m-o-r-F-a-t-i
fix(migration): 归档停用 MCP 的环境配置
5d860af 
- 将仅归档的旧 MCP 环境文件移入 migration-archive/mcp-env
- 在迁移报告中记录已归档环境文件
- 补充真实迁移测试，确认活动 env/mcp 不再残留旧配置
@A-m-o-r-F-a-t-i
feat: 标准化插件并完善 AgentDock 安装与配置面板
e26a662 
采用 Agent Plugins 1.0.0 根清单与标准 Skill/MCP，宿主独立保存开关、Heavy 覆盖值及凭据引用，保留事务式旧格式迁移。普通插件直接披露成员，Heavy 插件按需展开。

修复 Skill 自举被残余运行参数阻断的问题，新增运行配置页、插件折叠与 Heavy 开关。Windows 安装增加目录选择和旧安装位置保护，统一使用 AgentDock 名称，移除 GUI 插件包安装/更新按钮及对应功能，保留 Core 更新。

补充插件解析、迁移回滚、运行参数、Windows 安装与 GUI 契约回归，以及独立 Schema/Codex 插件兼容性测试。
@A-m-o-r-F-a-t-i
fix(windows): 修复覆盖升级与回滚启动，发布 0.8.4
2b30d3e 
修正 Windows COM VARIANT ABI，安装期间使用已校验载荷核心桥接当前用户会话，并以子进程回执确认启动。完善试运行托盘入口及提权核心的活跃安装事务校验，保留失败回滚保护。

补充真实历史版本升级、同版覆盖、故障回滚、旧环境残留、UTF-8 和临时任务清理回归。统一正式版本及本分支更新入口，附详细中文发布说明。
@A-m-o-r-F-a-t-i
release: 将正式发布版本调整为 1.0.0
6a25a48 
统一核心和 Windows 控制面板版本，更新中文发布说明。升级回归增加可指定目标版本，保留 0.8.3 与旧 0.8.4 插件版作为实际升级来源。
@A-m-o-r-F-a-t-i
fix(windows): recover upgrades and remove console windows in 1.0.1
c2a1fde 
使用原生 GUI 启动代理替换交互式 PowerShell 计划任务，补齐事务握手、严格版本健康检查、旧 generation 自动恢复与失败诊断。

修复死进程插件锁、Tunnel 停止与 Core 重载竞态；并行按需加载插件清单，修复 Skill/Plugin/Heavy HTTP 开关。加入真实 Inno 覆盖安装、故障注入回滚、窗口观察、WPF 和性能回归。
@A-m-o-r-F-a-t-i
test: fix cross-platform release verification and script inventory
9e0cb99
@A-m-o-r-F-a-t-i
docs(release): expand 1.0.1 upstream feature notes
09bd517
@A-m-o-r-F-a-t-i A-m-o-r-F-a-t-i changed the title feat: 增加重插件分层加载、能力开关与 AGENTS.md 自动上下文 feat: 标准化 Agent 插件与 Skill，并完善 AGENTS.md 和 Windows 运行管理 Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@A-m-o-r-F-a-t-i