Evergreen 是一个本地优先、AI 原生的桌面/移动微工具平台，所有功能都由插件提供。

每个插件都住在仓库的固定位置，平台启动时自动扫描、自动识别：

evg-base/plugins/<你的插件id>/
    └── module/
        └── manifest.json     ← 插件的「身份证」

平台扫到 module/manifest.json，就知道「有这个插件、它叫什么、长什么样、点开去哪里」。

两条创作路径

两条路径共享同一套「插件目录 + manifest 声明 + 数据中枢」机制，差别只在「界面由谁画」——数据、设置、AI 能力两条路都能用。

无论哪条路径，你的插件都是一个文件夹。Evergreen 采用「插件子目录模型」——一个插件目录可同时装多个子目录，互不冲突，平台按子目录自动发现。theme/、module/、data/、agent/、skin/ 对应五类插件形态（theme / module / data-source / agent / skin），config/ 与 skill/ 为辅助目录：

平台怎么发现你的插件

扫描规则来自 evg-base/lib/core/module/module_loader.dart：

• 只认 plugins/<id>/module/manifest.json 这个文件。
• manifest 里 "type" 必须是 "module"，否则被忽略。
• 解析失败只在日志里警告，不会让程序崩溃——写错了能安全重试。
• 未知字段一律静默忽略（容错设计，不是 bug）。

仓库副本在 d:\evg-workplace\ 时，你的插件最终落在 d:\evg-workplace\evg-base\plugins\my-tool\module\manifest.json。

Evergreen 有三种视图模式（左栏顶部视图图标 → 扇形菜单切换，已持久化记忆）：

AI 插件创作中心 = html-creator

html-creator 本身也是一个插件（template:"html"，路由 /html-creator），它是三栏 IDE：

• 左栏 · 数据中枢：浏览所有已注册数据源，把数据接进你的插件。
• 中栏 · 编辑器：写 HTML / CSS / JS（可拖拽分栏、窄屏自动变 Tab）。
• 右栏 · 实时预览：WebView 即时渲染，主题色自动注入。
• AI 面板：用自然语言让 AI 生成 / 改稿整个插件。
• 一键导出：把工程写到 plugins/<id>/module/，同时同步到内置资产目录 assets/plugins_bundle/。

你的插件界面就是一个普通网页，平台用内置 WebView 显示，并注入 platform.* 接口读数据、调 AI、读设置。

步骤一：写 manifest（关键字段 template:"html"）

{
  "schemaVersion": "2.0",
  "type": "module",          ← 必须
  "id": "my-first-tool",     ← 全局唯一，建议与文件夹同名
  "name": "我的数据面板",
  "template": "html",        ← 关键：告诉平台「用网页画我」
  "version": "1.0.0",
  "route": "/my-first-tool", ← 以 / 开头，全局唯一
  "nav": { "sidebar": { "section": "自定义", "order": 99 } }
}

这个文件放在 plugins/my-first-tool/module/manifest.json。

步骤二：写 index.html

在 module/ 里放 index.html。完整网页，任意前端写法：

<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><title>我的面板</title></head>
<body>
  <h1>你好，Evergreen</h1>
  <button onclick="loadData()">加载数据</button>
  <pre id="out"></pre>
  <script>
    async function loadData() {
      const d = await platform.data.get('my_source');
      document.getElementById('out').textContent = JSON.stringify(d, null, 2);
    }
  </script>
</body>
</html>

网页里可用的 platform 对象，统一兼容 Windows 与 Android，不用管底层差异。

读数据 platform.data

调 AI · 调接口 · 设置 · 存储 · 主题 · 事件

const reply = await platform.ai.chat('帮我总结这段数据');
// 可选风格：explanatory / learning / concise / socratic

const r = await platform.api.call('core', '/core/plugins');
// service 取值：agent / module / data / theme / config / core

const v = await platform.settings.get('someKey');
await platform.settings.set('someKey', 'newValue');

const colors = await platform.theme.getColors();

platform.emit('my-event', { value: 1 });
platform.on('my-event', (payload) => console.log(payload));

// 模块私有键值存储（storage.json），同时注册为数据源 <id>_storage
await platform.storage.set('pref', 'warm');
const pv = await platform.storage.get('pref');

// 运行本插件 manifest `process` 里声明的进程（.py / .exe，白名单 fail-closed）
const res = await platform.process.run('my-tool', { args: ['-u', 'alice'] });
// 常驻进程（scope:"long"）另有 start / write / stop / read / onOutput / onExit

不管路径一还是路径二，要展示真实数据，都来自数据中枢（DataOrchestrator）。两种方式：

• (a) 复用已有数据源：直接用别人/平台注册好的名字，如 platform.data.get('某名字')。
• (b) 自己注册一个新数据源：写 plugins/<id>/data/manifest.json + 一个后端程序。

data/manifest.json 长什么样

{
  "type": "data-source",
  "id": "my-first-tool",
  "name": "我的数据源",
  "script": "fetch.py",          ← 适配壳（模型 A：CLI 一次性脚本，推荐）
  "runtime": "python",
  "dataTypes": [
    {
      "name": "my_source",        ← 全局唯一，platform.data.get('my_source') 用它
      "typeArg": "my_source",     ← 传给适配壳的 --type 值
      "category": "自定义",
      "displayName": "我的数据",
      "ttl": "5m",
      "persistentKey": "my_source_cache"
    }
  ]
}

放在 plugins/my-first-tool/data/manifest.json，适配壳（fetch.py / scraper.py，纯标准库优先）放同目录。

数据源的 HTTP 常驻后端（模型 B · legacy）要满足的契约（模块 process 常驻进程同样适用）；数据源推荐主路径是上页的模型 A 适配壳（fetch.py / scraper.py），无需常驻服务：

1. 监听 127.0.0.1 上的某个端口。
2. 启动后往标准输出打印一行 PORT:12345（必须 flush）。
3. 提供 GET /health → 返回 200 OK。
4. 提供数据端点（就是 endpoint 写的路径），返回 200 OK + JSON。
5. 收到终止信号后干净退出。

最小可用的 Python 后端（零第三方依赖）

from http.server import BaseHTTPRequestHandler, HTTPServer
import json

class H(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path == '/health':
            self.send_response(200); self.end_headers()
            self.wfile.write(b'{"status":"ok"}')
        elif self.path == '/api/data':
            body = json.dumps({"items": [1, 2, 3]}).encode()
            self.send_response(200)
            self.send_header('Content-Type', 'application/json')
            self.end_headers()
            self.wfile.write(body)
        else:
            self.send_response(404); self.end_headers()

srv = HTTPServer(("127.0.0.1", 0), H)
port = srv.server_address[1]
print(f"PORT:{port}", flush=True)   ← 端口上报，平台靠它发现你
srv.serve_forever()

这条路径用 Dart/JSON「声明」界面。核心认知：

平台内置的模板渲染器

清单见 evg-base/lib/renderer/templates/templates_index.json：

复用 v4：写 0 行 Dart 就能有数据面板

用 pages 声明页面 + 布局 + 组件，全是 JSON：

{
  "schemaVersion": "2.0", "type": "module",
  "id": "my-data-panel", "name": "我的数据面板",
  "icon": "storage", "route": "/my-data-panel",
  "nav": { "sidebar": { "section": "base系统", "order": 20 } },
  "pages": [
    { "id": "main", "label": "📊 我的面板", "default": true,
      "layout": { "type": "grid", "preset": { "columns": 1, "gap": 0 },
        "slots": { "dashboard": { "component": {
          "type": "data-dashboard",
          "config": { "dataSource": { "endpoint": "orch://my_source" } }
        } } } } }
  ]
}

• 没写 template → 默认 v4 → 走 pages 调度。
• component.type 是组件名（35+ 种：chat、data-table、chart、form、calendar…）。
• endpoint:"orch://<数据源名>" 把数据灌进组件。

除了 pages 纯声明，Dart 插件还能给不同层级挂独立的进程（.py 推荐 / .exe legacy）跑业务逻辑：

每个进程声明入口（.py + runtime:"python"，或 .exe + runtime:"native"）和 protocol（"http"：首行 PORT: + /health；"stdio"：标准流通信）。

常驻进程契约（http 协议 · PORT 发现）

1. 启动 HTTP 服务，监听 127.0.0.1 随机端口。
2. stdout 首行打印 PORT:<端口>（flush=True），平台捕获后知道端口。
3. 之后全部 HTTP + JSON 通信，支持 GET/POST。
4. 组件可见时启动、隐藏时终止，平台统一管理生命周期。

平台启动 6 个微服务，每个绑定 127.0.0.1 随机端口，并把端口写进文件。你的进程（.py / .exe）读这些文件就能发现所有上游服务——不需要 consul / etcd / 环境变量：

模块级进程（.py / .exe）常充当聚合代理：读这些端口文件发现上游服务，转发/聚合数据请求，成为整个模块的 API 中枢。

模块生命周期：register → seal

manifest.json → ModuleDescriptor.fromJson() → registry.register()
→ scanAndLoadModules() 启动所有声明的 .py / .exe 进程
→ discoverCapabilities() → registry.setCapabilities()
→ registry.seal()          ← 锁定后只读，写入抛 StateError
→ ModuleHttpServer 启动（仅在 seal 后）

seal 时会校验依赖：任何模块声明了不存在的依赖 id，启动即失败（而非运行时静默异常）。

平台内置了上架协议规范和五类示例插件（theme / module / data-source / agent / skin），可作为起手模板：

分层红线（复述项目约定）