feat(plugin): MCP 服务器管理页 + 按 server 独立启停与状态快照
design/09 §5.2.1 / §5.6.1：补上「看不见连没连上 / 暴露了哪些工具 / 为什么挂了」的洞。
- runtimeconfig：PluginConfig 新增 `enabled`（*bool，缺省＝启用 ⇒ 既有 plugins.json
向后兼容）；新增 RedactPluginSecrets（整把凭据 + 任意 ≥6 字符片段一并抹除）。
- mcp：新增 status.go 的只读状态读面（ToolSummaries：工具名 + 截断描述，取自能力
注册表本身，因此与模型可见的工具集合同源）。
- plugin 管理器：
· Install/Restore 尊重 enabled（停用＝落盘不连接，重启后仍是停用，且一次都不连）；
· SetEnabled 落盘 enabled（停用先落盘再下线；启用失败时 enabled 保持 false）；
· 新增 Reconnect（对已停用者拒绝，不替用户启用）；
· 新增 Statuses（三态：connected 缺席＝未知，工具数/明细/时间只在知道时给出，
lastError 在记录那一刻即脱敏截断）；
· 内置「MCP 服务器」页声明 + 7 个已声明动作（list/install/reconnect/enable/
disable/uninstall/transports），走既有通用动作端点（owner-admin + 审计）；
· 护栏：热装插件的生命周期不改动内置提供者（mcp）的目录条目。
- gateway：已安装列表与 install 响应加 enabled，install 支持 config.enabled。
This commit is contained in:
AskaEth committed
1 parent
4ed5925296
commit
9654ce8861
14 files changed
+1969
-115
No files matched your search
@@ -61,6 +61,10 @@ type Manager struct {
|
||||
|
||||
mu sync.Mutex
|
||||
servers map[string]*server
|
||||
// observed 是每台 server 最近一次被观察到的运行期事实（成功连上的时刻、最近一次失败
|
||||
// 的文本与时刻）。它与 servers（活没活）是两个不同的事实：一台连不上的 server 不在
|
||||
// servers 里，但它的失败记录必须留着 —— 否则「为什么挂了」在快照里就是一个空。
|
||||
observed map[string]observed
|
||||
// panelKeys 记住每个已安装插件**当时用过的**面板目录键（插件名 → 目录键）。
|
||||
// 它是 memo 而不是第二份真源：目录键由 PanelPluginID 从 cfg 推出，这里只把
|
||||
// 结果留下，好让 Uninstall 在活 server 已不在时仍能精确清掉该插件的面板。
|
||||
@@ -80,6 +84,7 @@ func NewManager(reg *registry.Registry, path string, log *slog.Logger) *Manager
|
||||
path: path,
|
||||
log: log,
|
||||
servers: make(map[string]*server),
|
||||
observed: make(map[string]observed),
|
||||
panelKeys: make(map[string]string),
|
||||
}
|
||||
}
|
||||
@@ -116,6 +121,11 @@ func (m *Manager) Install(ctx context.Context, cfg runtimeconfig.PluginConfig) (
|
||||
// install is Install with the persist step optional (Restore reuses it without
|
||||
// rewriting the file it just read). changeReason labels the panel change pushed
|
||||
// when the plugin becomes live (install vs enable).
|
||||
//
|
||||
// It respects cfg.Enabled: a config that says enabled=false is **persisted but not
|
||||
// connected** (no live server, no tools), which is how "installed but switched off"
|
||||
// survives a restart. Restore goes through this same path, so startup honours the
|
||||
// flag too.
|
||||
func (m *Manager) install(ctx context.Context, cfg runtimeconfig.PluginConfig, persist bool, changeReason string) (Installed, error) {
|
||||
cfg = cfg.Normalize()
|
||||
if err := cfg.Validate(); err != nil {
|
||||
@@ -129,8 +139,13 @@ func (m *Manager) install(ctx context.Context, cfg runtimeconfig.PluginConfig, p
|
||||
if prev != nil {
|
||||
m.stop(ctx, prev)
|
||||
}
|
||||
if !cfg.IsEnabled() {
|
||||
return m.installDisabled(cfg, persist, prev)
|
||||
}
|
||||
srv, err := m.start(ctx, cfg)
|
||||
if err != nil {
|
||||
// 失败也要留痕：状态快照要能说出「为什么挂了」，而不是把失败悄悄丢进日志。
|
||||
m.noteFailure(cfg, err)
|
||||
m.restore(prev)
|
||||
return Installed{}, err
|
||||
}
|
||||
@@ -142,11 +157,30 @@ func (m *Manager) install(ctx context.Context, cfg runtimeconfig.PluginConfig, p
|
||||
}
|
||||
}
|
||||
m.put(srv)
|
||||
m.noteSeen(cfg)
|
||||
m.log.Info("plugin installed", "name", cfg.Name, "kind", cfg.Kind, "transport", cfg.Transport, "tools", srv.toolCount)
|
||||
m.markInstalled(cfg, changeReason)
|
||||
return Installed{Config: cfg, Live: true, ToolCount: srv.toolCount}, nil
|
||||
}
|
||||
|
||||
// installDisabled 走「已安装但停用」这条路：只落配置，不连接、不发现、不注册任何工具，
|
||||
// 并把面板入口隐藏（`when:{enabled:true}` 的入口不出现）。
|
||||
//
|
||||
// 调用前 prev（同名活 server）已经被停掉：配置现在说的是「停用」，让旧 server 继续挂着
|
||||
// 就成了两份互相矛盾的事实。落盘失败时把 prev 恢复回来（回滚到「启用且活着」那个状态）。
|
||||
func (m *Manager) installDisabled(cfg runtimeconfig.PluginConfig, persist bool, prev *server) (Installed, error) {
|
||||
if persist {
|
||||
if err := m.persistUpsert(cfg); err != nil {
|
||||
m.restore(prev)
|
||||
return Installed{}, err
|
||||
}
|
||||
}
|
||||
m.noteDisabled(cfg)
|
||||
m.markDisabled(cfg)
|
||||
m.log.Info("plugin installed disabled", "name", cfg.Name, "kind", cfg.Kind, "transport", cfg.Transport)
|
||||
return Installed{Config: cfg}, nil
|
||||
}
|
||||
|
||||
// Uninstall removes the plugin matching name: it unregisters the live server's
|
||||
// tools and closes it, then deletes the persisted config. It reports whether
|
||||
// anything matched, so the caller can fall back to a plain capability removal.
|
||||
@@ -166,6 +200,7 @@ func (m *Manager) Uninstall(ctx context.Context, name string) (bool, error) {
|
||||
panelName = srv.cfg.Name
|
||||
}
|
||||
m.forgetPanels(panelName)
|
||||
m.forgetObserved(panelName)
|
||||
m.log.Info("plugin uninstalled", "name", name)
|
||||
}
|
||||
return removed, nil
|
||||
@@ -231,114 +266,6 @@ func (m *Manager) Close(ctx context.Context) {
|
||||
}
|
||||
}
|
||||
|
||||
// SetEnabled 启用或停用一个已安装插件。
|
||||
//
|
||||
// 语义（§5.2.1 生命周期一栏）：停用会关闭活的 server（其工具随之下线）并隐藏它的
|
||||
// 管理面板入口（`when: {enabled:true}` 的入口不再出现），**配置保留在 plugins.json**
|
||||
// —— 因此重启后它仍然「已安装」，只是要不要连着由这次调用决定；启用则重新连接并
|
||||
// 让入口回来。两条路都会推一次 `panels_changed`。
|
||||
//
|
||||
// ⚠️ 已知缺口（本片如实登记）：启用状态本身**目前不持久化**（PluginConfig 没有该
|
||||
// 字段，给 plugins.json 加字段属 runtimeconfig 面，不在本片文件范围内），因此
|
||||
// **重启后停用态丢失、按已安装恢复为启用**。需要跨重启保持就寝语义时，先给
|
||||
// plugins.json 加 `enabled` 字段（并让 Restore 读它）。
|
||||
//
|
||||
// 找不到该插件（既不在活 server 里也不在 plugins.json 里）时返回 ErrPluginNotFound。
|
||||
func (m *Manager) SetEnabled(ctx context.Context, name string, on bool) error {
|
||||
name = strings.TrimSpace(name)
|
||||
if name == "" {
|
||||
return fmt.Errorf("%w: empty name", ErrPluginNotFound)
|
||||
}
|
||||
if !on {
|
||||
return m.disable(ctx, name)
|
||||
}
|
||||
return m.enable(ctx, name)
|
||||
}
|
||||
|
||||
// ErrPluginNotFound 报告 SetEnabled 指定的插件既没活着也不在 plugins.json 里。
|
||||
var ErrPluginNotFound = errors.New("plugin: not found")
|
||||
|
||||
// disable 停用一个插件：摘掉活的 server，保留配置，并隐藏面板入口。
|
||||
//
|
||||
// 它刻意**不**动 plugins.json：「停用」不是「卸载」，卸载才是删配置
|
||||
// （design/09 §5.2.1 把 install/uninstall 与 enable/disable 并列，说明两者不同）。
|
||||
func (m *Manager) disable(ctx context.Context, name string) error {
|
||||
srv := m.takeAny(name)
|
||||
_, persisted := m.persistedConfig(name)
|
||||
if srv == nil && !persisted {
|
||||
return fmt.Errorf("%w: %s", ErrPluginNotFound, name)
|
||||
}
|
||||
if srv != nil {
|
||||
m.stop(ctx, srv)
|
||||
}
|
||||
m.setPanelsEnabled(name, false)
|
||||
m.log.Info("plugin disabled", "name", name)
|
||||
return nil
|
||||
}
|
||||
|
||||
// enable 重新启用一个已安装插件：按 plugins.json 里的配置重新连接。
|
||||
// 已经活着的插件是幂等空操作（面板集合没变 ⇒ 不推帧）。
|
||||
func (m *Manager) enable(ctx context.Context, name string) error {
|
||||
if m.liveServer(name) != nil {
|
||||
return nil
|
||||
}
|
||||
cfg, ok := m.persistedConfig(name)
|
||||
if !ok {
|
||||
return fmt.Errorf("%w: %s", ErrPluginNotFound, name)
|
||||
}
|
||||
if _, err := m.install(ctx, cfg, false, PanelChangeEnabled); err != nil {
|
||||
return err
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// liveServer 返回活着的 server（按名字或 id 匹配，无则 nil）。
|
||||
func (m *Manager) liveServer(name string) *server {
|
||||
m.mu.Lock()
|
||||
defer m.mu.Unlock()
|
||||
if srv := m.servers[name]; srv != nil {
|
||||
return srv
|
||||
}
|
||||
for _, srv := range m.servers {
|
||||
if srv.cfg.ID != "" && srv.cfg.ID == name {
|
||||
return srv
|
||||
}
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// takeAny 按名字或 id 摘掉活着的 server（take 只认精确的名字键）。
|
||||
func (m *Manager) takeAny(name string) *server {
|
||||
if srv := m.take(name); srv != nil {
|
||||
return srv
|
||||
}
|
||||
m.mu.Lock()
|
||||
defer m.mu.Unlock()
|
||||
for key, srv := range m.servers {
|
||||
if srv.cfg.ID != "" && srv.cfg.ID == name {
|
||||
delete(m.servers, key)
|
||||
return srv
|
||||
}
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// persistedConfig 按名（或 id）在 plugins.json 里找一条配置。文件读不出来时按
|
||||
// 「没有这条」处理并记日志：停用/启用不该因为一个坏文件而变成 500。
|
||||
func (m *Manager) persistedConfig(name string) (runtimeconfig.PluginConfig, bool) {
|
||||
cfgs, err := runtimeconfig.LoadPlugins(m.path)
|
||||
if err != nil {
|
||||
m.log.Warn("plugins.json load failed", "path", m.path, "error", err)
|
||||
return runtimeconfig.PluginConfig{}, false
|
||||
}
|
||||
for _, cfg := range cfgs {
|
||||
if cfg.Name == name || (cfg.ID != "" && cfg.ID == name) {
|
||||
return cfg, true
|
||||
}
|
||||
}
|
||||
return runtimeconfig.PluginConfig{}, false
|
||||
}
|
||||
|
||||
// start connects cfg, registers its tools and surfaces its KindMCP capability.
|
||||
// On a registration failure it cleans up and returns the error.
|
||||
func (m *Manager) start(ctx context.Context, cfg runtimeconfig.PluginConfig) (*server, error) {
|
||||
@@ -389,6 +316,8 @@ func (m *Manager) restore(prev *server) {
|
||||
return
|
||||
}
|
||||
m.put(srv)
|
||||
// 回滚成功也是一次成功连接：快照的 lastSeenAt 不该停留在这之前的时刻。
|
||||
m.noteSeen(prev.cfg)
|
||||
}
|
||||
|
||||
// take removes and returns the live server named name, or nil.
|
||||
|
||||
Reference in new issue
Block a user