agentworkshop 0.3.0 → 0.4.1

package/README.md

@@ -11,8 +11,9 @@
 [![TypeScript 5.7](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
 [![Node ≥ 23.4](https://img.shields.io/badge/Node.js-%E2%89%A5%2023.4-3C873A?logo=nodedotjs&logoColor=white)](https://nodejs.org)
 [![SQLite node:sqlite](https://img.shields.io/badge/SQLite-node:sqlite-003B57?logo=sqlite&logoColor=white)](https://nodejs.org/api/sqlite.html)
+[![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm_NC_1.0-8A2BE2?logo=openaccess&logoColor=white)](./LICENSE)
 
-**[中文文档 →](./README-zh.md)**
+**[中文文档 →](./README-zh.md)** · **[Online Docs →](https://kingdol666.github.io/AgentWorkShop/)**
 
 *A configuration-driven platform where **AI agent teams** and an **industrial digital twin** share one runtime — agents query real telemetry, issue supervisory setpoints through human-approved write control, and every event streams live to a 3D twin.*
 
@@ -403,13 +404,19 @@ node scripts/_dbg-full-feature-e2e.mjs    # full-feature live E2E (server must b
 | Edge deployment shape: standalone edge-agent + central broker | Planned |
 | Alarm outbound delivery (email/webhook) + ack workflow | Planned |
 | CI pipeline (typecheck + lint + e2e) | Planned |
-| License file | Pending |
+| License: PolyForm Noncommercial 1.0.0 (source-available, non-commercial) | Shipped |
 
 ## License
 
 AgentWorkShop is an independent project and is **not an official product of Anthropic** or any LLM vendor. It integrates with agent harnesses (e.g. `omp`) through their public interfaces.
 
-**License is TBD** — the license file will be added before the `v1.0` release.
+**AgentWorkShop is source-available software, licensed under the [PolyForm Noncommercial 1.0.0](./LICENSE).**
+
+- ✅ **Permitted** — personal study, research, hobby projects, teaching, and use by noncommercial organizations (charities, education, public research, government).
+- ❌ **Not permitted without prior written permission** — any **commercial use**: selling, paid services, integrating into commercial products, or production use serving a business. Commercial licenses are available from the copyright holder.
+- 📌 When you redistribute the software, you must pass through the `Required Notice` line and these terms.
+
+For commercial licensing, contact: [GitHub @kingdol666](https://github.com/kingdol666) · kingdol6080@gmail.com
 
 <div align="center">
 

package/app/components/AppSidebar.vue

@@ -22,6 +22,7 @@ const menuItems = computed<MenuItem[]>(() => [
   { key: '/logs', icon: 'i-tabler-list-details', label: t('menu.logs'), motion: 'im-pop' },
   { key: '/users', icon: 'i-tabler-users-group', label: t('menu.users'), motion: 'im-pop' },
   { key: '/monitor', icon: 'i-tabler-cpu', label: t('menu.monitor'), motion: 'im-pulse' },
+  { key: '/plugins', icon: 'i-tabler-puzzle', label: t('menu.plugins'), motion: 'im-pop' },
   { key: '/settings', icon: 'i-tabler-settings', label: t('menu.settings'), motion: 'im-rotate' },
 ])
 

package/app/pages/plugins/index.vue

@@ -0,0 +1,258 @@
+<script setup lang="ts">
+/**
+ * 插件管理 —— 查看配置根 plugins/ 下全部插件(双作用域)、详情、启停开关。
+ * 启停写 plugins-state.json,服务端 fs.watch 热重载(≈1s),浏览器侧 loader
+ * 经 WS plugins.reloaded 事件 + 轮询双通道热注入/卸载客户端增强。
+ */
+import { computed, onMounted, ref } from 'vue'
+import { message } from 'ant-design-vue'
+import { useUserStore } from '~/stores/workshop/user'
+
+const { t } = useI18n()
+const userStore = useUserStore()
+
+interface PluginRoute { method: string, path: string }
+interface PluginInfo {
+  name: string
+  version: string
+  description: string
+  scope: 'project' | 'user'
+  enabled: boolean
+  hasClient: boolean
+  routes: PluginRoute[]
+  error?: string | null
+}
+
+const plugins = ref<PluginInfo[]>([])
+const failures = ref<Array<{ source: string, error: string }>>([])
+const loading = ref(false)
+const busyName = ref('')
+const drawerOpen = ref(false)
+const current = ref<PluginInfo | null>(null)
+
+/** 平台 API 鉴权:Bearer token(与全局 $http 拦截器同源) */
+function authHeaders(): Record<string, string> {
+  const token = (userStore as { token?: string }).token
+  return token ? { authorization: `Bearer ${token}` } : {}
+}
+
+async function load() {
+  loading.value = true
+  try {
+    const d = await $fetch<{ plugins: PluginInfo[], failures: Array<{ source: string, error: string }> }>('/api/workshop/plugins', { headers: authHeaders() })
+    plugins.value = d.plugins ?? []
+    failures.value = d.failures ?? []
+  }
+  catch {
+    message.error(t('plugins.enableFail'))
+  }
+  finally {
+    loading.value = false
+  }
+}
+
+async function toggle(p: PluginInfo) {
+  busyName.value = p.name
+  try {
+    const d = await $fetch<{ enabled: boolean }>(`/api/workshop/plugins/${p.name}/${p.enabled ? 'disable' : 'enable'}`, { method: 'POST', headers: authHeaders() })
+    p.enabled = d.enabled
+    message.success(`${p.name} · ${d.enabled ? t('plugins.enabled') : t('plugins.disabled')}`)
+    setTimeout(load, 800) // 热重载完成后刷新路由/客户端状态
+  }
+  catch (err) {
+    message.error(`${t('plugins.enableFail')}: ${(err as Error)?.message ?? ''}`)
+  }
+  finally {
+    busyName.value = ''
+  }
+}
+
+const enabledCount = computed(() => plugins.value.filter(p => p.enabled).length)
+const clientCount = computed(() => plugins.value.filter(p => p.hasClient).length)
+
+function scopeLabel(scope: string) {
+  return scope === 'project' ? t('plugins.scopeProject') : t('plugins.scopeUser')
+}
+
+function openDetail(p: PluginInfo) {
+  current.value = p
+  drawerOpen.value = true
+}
+
+onMounted(load)
+</script>
+
+<template>
+  <div class="plugins-page">
+    <header class="pg-head">
+      <div>
+        <h1 class="pg-title">
+          {{ $t('plugins.title') }}
+        </h1>
+        <p class="pg-sub">
+          {{ $t('plugins.subtitle') }}
+        </p>
+      </div>
+      <div class="pg-stats">
+        <span class="stat">{{ $t('plugins.enabled') }} <b>{{ enabledCount }}</b></span>
+        <span class="stat">{{ $t('plugins.hasClient') }} <b>{{ clientCount }}</b></span>
+        <span class="stat">{{ $t('plugins.routes') }} <b>{{ plugins.reduce((s, p) => s + p.routes.length, 0) }}</b></span>
+        <a-button
+          size="small"
+          :loading="loading"
+          @click="load"
+        >
+          {{ $t('plugins.refresh') }}
+        </a-button>
+      </div>
+    </header>
+
+    <a-alert
+      v-if="failures.length"
+      type="error"
+      show-icon
+      class="pg-failures"
+      :message="$t('plugins.loadFailures', { n: failures.length })"
+    >
+      <template #description>
+        <div
+          v-for="f in failures"
+          :key="f.source"
+          class="fail-line"
+        >
+          {{ f.source }} — {{ f.error }}
+        </div>
+      </template>
+    </a-alert>
+
+    <div
+      v-if="!plugins.length && !loading"
+      class="pg-empty"
+    >
+      {{ $t('plugins.empty') }}
+    </div>
+
+    <div class="pg-grid">
+      <article
+        v-for="p in plugins"
+        :key="`${p.scope}:${p.name}`"
+        class="pg-card"
+        :class="{ 'is-off': !p.enabled }"
+        @click="openDetail(p)"
+      >
+        <div class="card-head">
+          <span class="card-name">{{ p.name }}</span>
+          <span class="card-ver">{{ p.version }}</span>
+          <a-switch
+            :checked="p.enabled"
+            :loading="busyName === p.name"
+            size="small"
+            @click.stop
+            @change="toggle(p)"
+          />
+        </div>
+        <p class="card-desc">
+          {{ p.description || '—' }}
+        </p>
+        <div class="card-tags">
+          <span
+            class="tag"
+            :class="p.scope"
+          >{{ scopeLabel(p.scope) }}</span>
+          <span
+            class="tag"
+            :class="p.enabled ? 'on' : 'off'"
+          >{{ p.enabled ? $t('plugins.enabled') : $t('plugins.disabled') }}</span>
+          <span
+            v-if="p.hasClient"
+            class="tag client"
+          >{{ $t('plugins.hasClient') }}</span>
+        </div>
+        <div
+          v-if="p.routes.length"
+          class="card-routes"
+        >
+          <code
+            v-for="r in p.routes"
+            :key="r.method + r.path"
+          >{{ r.method }} {{ r.path }}</code>
+        </div>
+      </article>
+    </div>
+
+    <a-drawer
+      v-model:open="drawerOpen"
+      :title="current?.name"
+      width="460"
+    >
+      <template v-if="current">
+        <dl class="detail">
+          <dt>version</dt><dd>{{ current.version }}</dd>
+          <dt>scope</dt><dd>{{ scopeLabel(current.scope) }}</dd>
+          <dt>enabled</dt><dd>{{ current.enabled }}</dd>
+          <dt>client</dt><dd>{{ current.hasClient ? '✓' : '—' }}</dd>
+          <dt v-if="current.error">
+            error
+          </dt>
+          <dd
+            v-if="current.error"
+            style="color:#ff6b6b"
+          >
+            {{ current.error }}
+          </dd>
+        </dl>
+        <h4>{{ $t('plugins.routes') }}</h4>
+        <code
+          v-for="r in current.routes"
+          :key="r.method + r.path"
+          class="detail-route"
+        >
+          {{ r.method }} /api/plugins/{{ current.name }}{{ r.path }}
+        </code>
+        <p
+          v-if="!current.routes.length"
+          class="dim"
+        >
+          —
+        </p>
+      </template>
+    </a-drawer>
+  </div>
+</template>
+
+<style scoped lang="css">
+.plugins-page { max-width: 1080px; margin: 0 auto; padding: 24px 20px 48px; }
+.pg-head { display: flex; align-items: flex-end; justify-content: space-between; gap: 16px; margin-bottom: 18px; }
+.pg-title { margin: 0; font-size: 22px; font-weight: 700; letter-spacing: .5px; }
+.pg-sub { margin: 4px 0 0; opacity: .6; font-size: 12px; }
+.pg-stats { display: flex; align-items: center; gap: 14px; font-size: 12px; opacity: .85; }
+.pg-stats b { font-size: 15px; }
+.pg-failures { margin-bottom: 16px; }
+.fail-line { font-family: ui-monospace, monospace; font-size: 11px; }
+.pg-empty { padding: 48px 0; text-align: center; opacity: .55; }
+.pg-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 14px; }
+.pg-card { position: relative; padding: 14px 16px; border: 1px solid var(--aw-border, rgba(128, 152, 199, .25));
+  border-radius: 12px; background: var(--aw-card, rgba(255, 255, 255, .04)); cursor: pointer;
+  transition: border-color .2s, transform .2s; }
+.pg-card:hover { border-color: var(--aw-accent, #35e0a0); transform: translateY(-1px); }
+.pg-card.is-off { opacity: .55; }
+.card-head { display: flex; align-items: center; gap: 10px; }
+.card-name { font-weight: 700; font-size: 15px; }
+.card-ver { color: inherit; opacity: .5; font-family: ui-monospace, monospace; font-size: 11px; }
+.card-head .a-switch { margin-left: auto; }
+.card-desc { margin: 8px 0; font-size: 12px; opacity: .75; min-height: 18px; }
+.card-tags { display: flex; gap: 6px; flex-wrap: wrap; margin-bottom: 8px; }
+.tag { padding: 2px 8px; border-radius: 999px; font-size: 10px; border: 1px solid rgba(128, 152, 199, .3); }
+.tag.project { border-color: rgba(53, 224, 160, .5); color: #35e0a0; }
+.tag.user { border-color: rgba(65, 200, 244, .5); color: #41c8f4; }
+.tag.on { border-color: rgba(53, 224, 160, .5); color: #35e0a0; }
+.tag.off { border-color: rgba(255, 107, 107, .4); color: #ff6b6b; }
+.tag.client { border-color: rgba(181, 140, 255, .5); color: #b58cff; }
+.card-routes { display: flex; flex-direction: column; gap: 2px; }
+.card-routes code { font-size: 10px; opacity: .65; }
+.detail dt { margin-top: 10px; font-size: 11px; opacity: .5; }
+.detail dd { margin: 2px 0 0; font-family: ui-monospace, monospace; font-size: 12px; }
+.detail-route { display: block; font-size: 11px; opacity: .8; margin-bottom: 4px; }
+h4 { margin: 16px 0 6px; }
+.dim { opacity: .45; }
+</style>

package/app/plugins/aw-plugins.client.ts

@@ -1,79 +1,119 @@
 /**
- * aw 插件客户端装载器 —— 前端增强入口。
- * - 启动期拉取 /api/plugins/manifest → 对含 client 的插件动态 import 脚本
- * - 每个插件获得独立 ctx(sdk/client.mjs):事件订阅/Hooks/DOM 助手/私有挂载点
- * - 事件桥:useTownBus(AEP 信封,与 WS 同源) → ctx.hooks(event:<type> / '*')
+ * aw 插件客户端装载器 —— 前端增强入口(支持热注入/热卸载)。
+ * - 启动期拉取 /api/plugins/manifest → 对启用且含 client 的插件动态 import 装载
+ * - 热通道双保险:WS `plugins.reloaded` 事件(TownBus 桥) + 15s 轮询 diff
+ *   → 新启用插件即时注入;停用插件即时 dispose 卸载
  * - 错误隔离:单插件装载失败仅告警,不影响应用与其他插件
  * 插件契约见 docs/plugins.md;信任模型与 aw commands 相同(仅装可信代码)。
  */
-import { createClientContext } from '@/sdk/client.mjs'
+import { createClientContext, type ClientContext } from '@/sdk/client.mjs'
 import type { TownBus } from '~/composables/workshop/useTownBus'
 
+interface ManifestEntry { name: string, enabled?: boolean, hasClient?: boolean }
+
 export default defineNuxtPlugin(async (nuxtApp) => {
   if (!import.meta.client) return
 
-  const loaded: Array<{ name: string, ctx: ReturnType<typeof createClientContext> }> = []
+  /** name → ctx(已装载客户端插件) */
+  const loaded = new Map<string, ClientContext>()
+  let bus: TownBus | null = null
+  try {
+    bus = useTownBus()
+  }
+  catch {
+    bus = null // WS 总线不可用(离线)时插件仍可装载,只是无实时事件流
+  }
 
-  const bridgeFactory = (bus: TownBus | null) => (fn: (type: string, payload: unknown) => void) => {
+  function bridgeFactory(fn: (type: string, payload: unknown) => void) {
     if (!bus) return () => {}
     return bus.subscribe((e) => {
       try {
         fn(e.type, e.payload)
       }
       catch (err) {
-        console.warn(`[aw-plugins] 事件分发异常:`, err)
+        console.warn('[aw-plugins] 事件分发异常:', err)
       }
     })
   }
 
-  try {
-    const res = await fetch('/api/plugins/manifest', { headers: { accept: 'application/json' } })
-    if (!res.ok) return
-    const body = await res.json().catch(() => null) as { plugins?: Array<{ name: string, hasClient?: boolean }> } | null
-    const plugins = (body?.plugins ?? []).filter(p => p.hasClient)
-    if (!plugins.length) return
-
-    let bus: TownBus | null = null
+  async function loadOne(name: string): Promise<boolean> {
     try {
-      bus = useTownBus()
+      const mod = await import(/* @vite-ignore */ `/api/plugins/client/${encodeURIComponent(name)}`)
+      const setup = (mod as { setup?: unknown }).setup ?? (mod as { default?: { setup?: unknown } }).default?.setup
+      if (typeof setup !== 'function') {
+        console.warn(`[aw-plugins] ${name} 客户端入口缺少 setup(ctx)`)
+        return false
+      }
+      const ctx = createClientContext({ name, eventBridge: bridgeFactory(bus) })
+      await (setup as (ctx: unknown) => void | Promise<void>)(ctx)
+      void ctx.hooks.emit('client:init', { name })
+      loaded.set(name, ctx)
+      console.info(`[aw-plugins] ✔ 客户端插件已注入: ${name}`)
+      return true
     }
-    catch {
-      bus = null // WS 总线不可用(离线)时插件仍可装载,只是无事件流
+    catch (err) {
+      console.warn(`[aw-plugins] 客户端插件装载失败 ${name}:`, err)
+      return false
     }
+  }
 
-    for (const p of plugins) {
-      try {
-        const mod = await import(/* @vite-ignore */ `/api/plugins/client/${encodeURIComponent(p.name)}`)
-        const setup = (mod as { setup?: unknown }).setup ?? (mod as { default?: { setup?: unknown } }).default?.setup
-        if (typeof setup !== 'function') {
-          console.warn(`[aw-plugins] ${p.name} 客户端入口缺少 setup(ctx)`)
-          continue
-        }
-        const ctx = createClientContext({
-          name: p.name,
-          eventBridge: bridgeFactory(bus),
-        })
-        await (setup as (ctx: unknown) => void | Promise<void>)(ctx)
-        void ctx.hooks.emit('client:init', { name: p.name })
-        loaded.push({ name: p.name, ctx })
-        console.info(`[aw-plugins] ✔ 客户端插件已装载: ${p.name}`)
+  function unloadOne(name: string) {
+    const ctx = loaded.get(name)
+    if (!ctx) return
+    ctx.dispose()
+    loaded.delete(name)
+    console.info(`[aw-plugins] 客户端插件已卸载: ${name}`)
+  }
+
+  /** 全量同步:启用的新插件注入;停用/移除的插件卸载 */
+  async function syncPlugins(): Promise<void> {
+    try {
+      const res = await fetch('/api/plugins/manifest', { headers: { accept: 'application/json' } })
+      if (!res.ok) return
+      const body = await res.json().catch(() => null) as { plugins?: ManifestEntry[] } | null
+      const list = body?.plugins ?? []
+      for (const p of list) {
+        if (p.enabled !== false && p.hasClient && !loaded.has(p.name))
+          await loadOne(p.name)
       }
-      catch (err) {
-        console.warn(`[aw-plugins] 客户端插件装载失败 ${p.name}:`, err)
+      for (const name of [...loaded.keys()]) {
+        const p = list.find(x => x.name === name)
+        if (!p || p.enabled === false || !p.hasClient)
+          unloadOne(name)
       }
     }
+    catch { /* 网络不可达:保留现状,下轮再试 */ }
+  }
 
-    // 页面切换广播(page:change)
-    if (loaded.length) {
-      nuxtApp.hooks.hook('page:finish', () => {
-        const route = useRoute()
-        for (const { ctx } of loaded) {
-          void ctx.hooks.emit('page:change', { path: route.path })
+  // 首次装载
+  await syncPlugins()
+
+  // 页面切换广播(已装载插件均可感知;防御性隔离——单插件异常不影响路由)
+  if (loaded.size) {
+    nuxtApp.hooks.hook('page:finish', () => {
+      let path = ''
+      try {
+        path = useRoute().path ?? ''
+      }
+      catch { /* 路由上下文不可用时静默 */ }
+      for (const { ctx } of loaded.values()) {
+        try {
+          ctx?.hooks?.emit('page:change', { path })
         }
-      })
-    }
+        catch { /* 单插件广播失败不阻断 */ }
+      }
+    })
   }
-  catch {
-    // 网络不可达/服务未就绪:静默(插件是增强层,绝不阻断应用)
+
+  // 热通道 1:WS plugins.reloaded(服务端热重载后广播)
+  if (bus) {
+    bus.subscribe((e) => {
+      if (e.type === 'plugins.reloaded')
+        void syncPlugins()
+    })
   }
+  // 热通道 2:轮询兜底(无 WS 场景)
+  setInterval(() => {
+    void syncPlugins()
+  }, 15_000)
 })

package/cli/commands/plugin.mjs

@@ -7,7 +7,7 @@
 // 插件契约:入口 index.mjs 导出 { name, version?, description?,
 //   setup(ctx)?, client?: './client.mjs', routes?: [...] } —— 零导入依赖。
 // ============================================================
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { color } from '../core/logger.mjs'
 import { CliError } from '../core/errors.mjs'
@@ -16,8 +16,8 @@ export const meta = {
   name: 'plugin',
   aliases: ['plugins', 'plug'],
   group: '扩展',
-  summary: '插件管理:查看已装插件 / 脚手架新插件',
-  usage: 'aw plugin <list|create> [name] [--project|--global] [--force]',
+  summary: '插件管理:查看/启停(热重载)/脚手架',
+  usage: 'aw plugin <list|create|enable|disable> [name] [--project|--global] [--force]',
   description: [
     '插件 = 配置根 plugins/<name>/ 下的 node 项目:入口 index.mjs 导出',
     '{ name, setup(ctx) } 即自动装载(服务端钩子/API 路由),client.mjs 可选(浏览器增强)。',
@@ -106,7 +106,54 @@ export async function run(argv, ctx) {
   if (sub === 'create' || sub === 'new' || sub === 'add')
     return create(ctx, positionals[1], flags)
 
-  throw new CliError('USAGE', '用法: aw plugin <list|create> [name] [--project|--global]')
+  if (sub === 'enable' || sub === 'disable')
+    return setEnabled(ctx, sub === 'enable', positionals[1])
+
+  throw new CliError('USAGE', '用法: aw plugin <list|create|enable|disable> [name]')
+}
+
+// ---- 启停状态机(单一事实源:<home>/plugins-state.json;服务 fs.watch 热重载) ----
+function stateFile(ctx) {
+  return join(ctx.home, 'plugins-state.json')
+}
+
+function readState(ctx) {
+  try {
+    const j = JSON.parse(readFileSync(stateFile(ctx), 'utf8'))
+    return new Set(Array.isArray(j.disabled) ? j.disabled : [])
+  }
+  catch {
+    return new Set()
+  }
+}
+
+function writeState(ctx, disabledSet) {
+  const p = stateFile(ctx)
+  const tmp = `${p}.${process.pid}.tmp`
+  writeFileSync(tmp, `${JSON.stringify({ version: 1, updatedAt: new Date().toISOString(), disabled: [...disabledSet] }, null, 2)}\n`, 'utf8')
+  renameSync(tmp, p)
+}
+
+function setEnabled(ctx, enabled, name) {
+  if (!name) throw new CliError('USAGE', `用法: aw plugin ${enabled ? 'enable' : 'disable'} <name>`)
+  const dir = findPluginDir(ctx, name)
+  if (!dir) throw new CliError('NOT_FOUND', `未找到插件 "${name}"(aw plugin list 查看)`)
+
+  const disabled = readState(ctx)
+  if (enabled) disabled.delete(name)
+  else disabled.add(name)
+  writeState(ctx, disabled)
+
+  console.log(`${color.green('✔')} 插件 ${color.bold(name)} 已${enabled ? '启用' : '停用'}${color.dim(`(${dir})`)}`)
+  console.log(`  › 运行中的服务会在 1s 内自动热重载;网页「插件管理」页状态同步`)
+  return 0
+}
+
+function findPluginDir(ctx, name) {
+  for (const { dir } of scopes(ctx)) {
+    if (dir && existsSync(join(dir, name, 'index.mjs'))) return join(dir, name)
+  }
+  return null
 }
 
 function scopes(ctx) {
@@ -118,8 +165,9 @@ function scopes(ctx) {
 
 function list(ctx) {
   console.log('')
-  console.log(`${color.bold('AgentWorkShop 插件')}  ${color.dim('— 配置根 plugins/ 目录,重启自动装载')}`)
+  console.log(`${color.bold('AgentWorkShop 插件')}  ${color.dim('— 配置根 plugins/ 目录,自动装载;aw plugin enable/disable 启停')}`)
   let total = 0
+  const disabled = readState(ctx)
   for (const { dir, label } of scopes(ctx)) {
     console.log('')
     console.log(color.bold(`  ${label} ${color.dim(dir)}`))
@@ -135,11 +183,13 @@ function list(ctx) {
     for (const name of dirs) {
       total++
       const hasClient = existsSync(join(dir, name, 'client.mjs'))
-      console.log(`    ${color.green('●')} ${color.cyan(name.padEnd(24))}${hasClient ? `${color.dim(' +client')}` : ''}`)
+      const off = disabled.has(name)
+      const stateText = off ? color.yellow('已停用') : color.green('已启用')
+      console.log(`    ${off ? color.yellow('○') : color.green('●')} ${color.cyan(name.padEnd(24))}${stateText}${hasClient ? color.dim(' +client') : ''}`)
     }
   }
   console.log('')
-  console.log(color.dim(`共 ${total} 个 · 契约: index.mjs 导出 { name, setup(ctx) } · 文档: docs/plugins.md`))
+  console.log(color.dim(`共 ${total} 个 · 启停: aw plugin enable|disable <name>(运行中服务热重载) · 文档: docs/plugins.md`))
   console.log('')
   return 0
 }