npm - opc-agent - Versions diffs - 4.1.0 → 4.1.1 - Mend

opc-agent 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (245) hide show

package/.github/ISSUE_TEMPLATE/bug_report.md +20 -20
package/.github/ISSUE_TEMPLATE/feature_request.md +14 -14
package/.github/PULL_REQUEST_TEMPLATE.md +13 -13
package/CHANGELOG.md +48 -48
package/CONTRIBUTING.md +36 -36
package/README.zh-CN.md +497 -497
package/dist/channels/wechat.js +6 -6
package/dist/deploy/index.js +56 -56
package/dist/studio/server.js +30 -1
package/dist/studio-ui/index.html +230 -10
package/dist/ui/components.js +105 -105
package/examples/README.md +22 -22
package/examples/basic-agent.ts +90 -90
package/examples/brain-integration.ts +71 -71
package/examples/multi-channel.ts +74 -74
package/fix-sidebar.mjs +188 -188
package/install.ps1 +154 -154
package/install.sh +164 -164
package/package.json +1 -1
package/scripts/install.ps1 +31 -31
package/scripts/install.sh +40 -40
package/serve-studio.js +13 -13
package/serve-test.js +25 -25
package/src/channels/dingtalk.ts +46 -46
package/src/channels/email.ts +351 -351
package/src/channels/feishu.ts +349 -349
package/src/channels/googlechat.ts +42 -42
package/src/channels/imessage.ts +31 -31
package/src/channels/irc.ts +82 -82
package/src/channels/line.ts +32 -32
package/src/channels/matrix.ts +33 -33
package/src/channels/mattermost.ts +57 -57
package/src/channels/msteams.ts +32 -32
package/src/channels/nostr.ts +32 -32
package/src/channels/qq.ts +33 -33
package/src/channels/signal.ts +32 -32
package/src/channels/sms.ts +33 -33
package/src/channels/telegram.ts +616 -616
package/src/channels/twitch.ts +65 -65
package/src/channels/voice-call.ts +100 -100
package/src/channels/websocket.ts +399 -399
package/src/channels/wechat.ts +329 -329
package/src/channels/whatsapp.ts +32 -32
package/src/cli/chat.ts +99 -99
package/src/cli/setup.ts +314 -314
package/src/core/agent.ts +476 -476
package/src/core/api-server.ts +277 -277
package/src/core/audio.ts +98 -98
package/src/core/collaboration.ts +275 -275
package/src/core/context-discovery.ts +85 -85
package/src/core/context-refs.ts +140 -140
package/src/core/gateway.ts +106 -106
package/src/core/heartbeat.ts +51 -51
package/src/core/hooks.ts +105 -105
package/src/core/ide-bridge.ts +133 -133
package/src/core/node-network.ts +86 -86
package/src/core/profiles.ts +122 -122
package/src/core/scheduler.ts +187 -187
package/src/core/session-manager.ts +137 -137
package/src/core/subagent.ts +98 -98
package/src/core/vision.ts +180 -180
package/src/core/workflow-graph.ts +365 -365
package/src/daemon.ts +96 -96
package/src/deploy/index.ts +255 -255
package/src/doctor.ts +156 -156
package/src/eval/index.ts +211 -211
package/src/eval/suites/basic.json +16 -16
package/src/eval/suites/memory.json +12 -12
package/src/eval/suites/safety.json +14 -14
package/src/hub/brain-seed.ts +54 -54
package/src/hub/client.ts +60 -60
package/src/mcp/servers/calculator-mcp.ts +65 -65
package/src/mcp/servers/crypto-mcp.ts +73 -73
package/src/mcp/servers/database-mcp.ts +72 -72
package/src/mcp/servers/datetime-mcp.ts +69 -69
package/src/mcp/servers/filesystem.ts +66 -66
package/src/mcp/servers/github-mcp.ts +58 -58
package/src/mcp/servers/index.ts +63 -63
package/src/mcp/servers/json-mcp.ts +102 -102
package/src/mcp/servers/memory-mcp.ts +56 -56
package/src/mcp/servers/regex-mcp.ts +53 -53
package/src/mcp/servers/web-mcp.ts +49 -49
package/src/memory/context-compressor.ts +189 -189
package/src/memory/seed-loader.ts +212 -212
package/src/memory/user-profiler.ts +215 -215
package/src/plugins/content-filter.ts +23 -23
package/src/plugins/logger.ts +18 -18
package/src/plugins/rate-limiter.ts +38 -38
package/src/protocols/a2a/client.ts +132 -132
package/src/protocols/a2a/index.ts +8 -8
package/src/protocols/a2a/server.ts +333 -333
package/src/protocols/a2a/types.ts +88 -88
package/src/protocols/a2a/utils.ts +50 -50
package/src/protocols/agui/client.ts +83 -83
package/src/protocols/agui/index.ts +4 -4
package/src/protocols/agui/server.ts +218 -218
package/src/protocols/agui/types.ts +153 -153
package/src/protocols/index.ts +2 -2
package/src/protocols/mcp/agent-tools.ts +134 -134
package/src/protocols/mcp/index.ts +8 -8
package/src/protocols/mcp/server.ts +262 -262
package/src/protocols/mcp/types.ts +69 -69
package/src/providers/index.ts +632 -632
package/src/publish/index.ts +376 -376
package/src/scheduler/cron-engine.ts +191 -191
package/src/scheduler/index.ts +2 -2
package/src/schema/oad.ts +217 -217
package/src/security/approval.ts +131 -131
package/src/security/approvals.ts +143 -143
package/src/security/elevated.ts +105 -105
package/src/security/guardrails.ts +248 -248
package/src/security/index.ts +9 -9
package/src/security/keys.ts +87 -87
package/src/security/secrets.ts +129 -129
package/src/skills/builtin/index.ts +408 -408
package/src/skills/marketplace.ts +113 -113
package/src/skills/types.ts +42 -42
package/src/studio/server.ts +31 -1
package/src/studio/templates-data.ts +178 -178
package/src/studio-ui/index.html +230 -10
package/src/telemetry/index.ts +324 -324
package/src/tools/builtin/browser.ts +299 -299
package/src/tools/builtin/datetime.ts +41 -41
package/src/tools/builtin/file.ts +107 -107
package/src/tools/builtin/home-assistant.ts +116 -116
package/src/tools/builtin/rl-tools.ts +243 -243
package/src/tools/builtin/shell.ts +43 -43
package/src/tools/builtin/vision.ts +64 -64
package/src/tools/builtin/web-search.ts +126 -126
package/src/tools/builtin/web.ts +35 -35
package/src/tools/document-processor.ts +213 -213
package/src/tools/image-generator.ts +150 -150
package/src/tools/integrations/calendar.ts +73 -73
package/src/tools/integrations/code-exec.ts +39 -39
package/src/tools/integrations/csv-analyzer.ts +92 -92
package/src/tools/integrations/database.ts +44 -44
package/src/tools/integrations/email-send.ts +76 -76
package/src/tools/integrations/git-tool.ts +42 -42
package/src/tools/integrations/github-tool.ts +76 -76
package/src/tools/integrations/image-gen.ts +56 -56
package/src/tools/integrations/index.ts +92 -92
package/src/tools/integrations/jira.ts +83 -83
package/src/tools/integrations/notion.ts +71 -71
package/src/tools/integrations/npm-tool.ts +48 -48
package/src/tools/integrations/pdf-reader.ts +58 -58
package/src/tools/integrations/slack.ts +65 -65
package/src/tools/integrations/summarizer.ts +49 -49
package/src/tools/integrations/translator.ts +48 -48
package/src/tools/integrations/trello.ts +60 -60
package/src/tools/integrations/vector-search.ts +42 -42
package/src/tools/integrations/web-scraper.ts +47 -47
package/src/tools/integrations/web-search.ts +58 -58
package/src/tools/integrations/webhook.ts +38 -38
package/src/tools/mcp-client.ts +131 -131
package/src/tools/web-scraper.ts +179 -179
package/src/tools/web-search.ts +180 -180
package/src/ui/components.ts +127 -127
package/srv-out.txt +1 -1
package/templates/ecommerce-assistant/README.md +45 -45
package/templates/ecommerce-assistant/oad.yaml +47 -47
package/templates/tech-support/README.md +43 -43
package/templates/tech-support/oad.yaml +45 -45
package/test-agent/Dockerfile +9 -9
package/test-agent/README.md +50 -50
package/test-agent/agent.yaml +23 -23
package/test-agent/docker-compose.yml +11 -11
package/test-agent/oad.yaml +31 -31
package/test-agent/package-lock.json +1492 -1492
package/test-agent/package.json +17 -17
package/test-agent/src/index.ts +24 -24
package/test-agent/src/skills/echo.ts +15 -15
package/test-agent/tsconfig.json +24 -24
package/test-full.js +43 -43
package/test-sidebar.js +22 -22
package/test-studio3.js +75 -75
package/test-studio4.js +41 -41
package/tests/a2a-protocol.test.ts +285 -285
package/tests/agui-protocol.test.ts +246 -246
package/tests/api-server.test.ts +148 -148
package/tests/approvals.test.ts +89 -89
package/tests/audio.test.ts +40 -40
package/tests/brain-seed-extended.test.ts +490 -490
package/tests/brain-seed.test.ts +239 -239
package/tests/browser.test.ts +179 -179
package/tests/channels/discord.test.ts +79 -79
package/tests/channels/email.test.ts +148 -148
package/tests/channels/feishu.test.ts +123 -123
package/tests/channels/telegram.test.ts +129 -129
package/tests/channels/websocket.test.ts +53 -53
package/tests/channels/wechat.test.ts +170 -170
package/tests/channels-extra.test.ts +45 -45
package/tests/chat-cli.test.ts +160 -160
package/tests/cli.test.ts +46 -46
package/tests/context-compressor.test.ts +172 -172
package/tests/context-refs.test.ts +121 -121
package/tests/cron-engine.test.ts +101 -101
package/tests/daemon.test.ts +135 -135
package/tests/deepbrain-wire.test.ts +234 -234
package/tests/deploy-and-dag.test.ts +196 -196
package/tests/doctor.test.ts +38 -38
package/tests/document-processor.test.ts +69 -69
package/tests/e2e-nocode.test.ts +442 -442
package/tests/elevated.test.ts +69 -69
package/tests/eval.test.ts +173 -173
package/tests/gateway.test.ts +63 -63
package/tests/guardrails.test.ts +177 -177
package/tests/home-assistant.test.ts +40 -40
package/tests/hooks.test.ts +79 -79
package/tests/ide-bridge.test.ts +38 -38
package/tests/image-generator.test.ts +84 -84
package/tests/init-role.test.ts +124 -124
package/tests/integrations.test.ts +249 -249
package/tests/mcp-client.test.ts +92 -92
package/tests/mcp-server.test.ts +178 -178
package/tests/mcp-servers.test.ts +260 -260
package/tests/node-network.test.ts +74 -74
package/tests/plugin-a2a-enhanced.test.ts +230 -230
package/tests/profiles.test.ts +61 -61
package/tests/publish.test.ts +231 -231
package/tests/rl-tools.test.ts +93 -93
package/tests/sandbox-manager.test.ts +46 -46
package/tests/scheduler.test.ts +200 -200
package/tests/secrets.test.ts +107 -107
package/tests/security-enhanced.test.ts +233 -233
package/tests/settings-api.test.ts +148 -148
package/tests/setup.test.ts +73 -73
package/tests/subagent.test.ts +193 -193
package/tests/telegram-discord.test.ts +60 -60
package/tests/telemetry.test.ts +186 -186
package/tests/user-profiler.test.ts +169 -169
package/tests/v090-features.test.ts +254 -254
package/tests/vision.test.ts +61 -61
package/tests/voice-call.test.ts +47 -47
package/tests/voice-enhanced.test.ts +169 -169
package/tests/voice-interaction.test.ts +38 -38
package/tests/web-search.test.ts +155 -155
package/tests/workflow-graph.test.ts +279 -279
package/tutorial/customer-service-agent/README.md +612 -612
package/tutorial/customer-service-agent/SOUL.md +26 -26
package/tutorial/customer-service-agent/agent.yaml +63 -63
package/tutorial/customer-service-agent/package.json +19 -19
package/tutorial/customer-service-agent/src/index.ts +69 -69
package/tutorial/customer-service-agent/src/skills/faq.ts +27 -27
package/tutorial/customer-service-agent/src/skills/ticket.ts +22 -22
package/tutorial/customer-service-agent/tsconfig.json +14 -14

package/tests/e2e-nocode.test.ts CHANGED Viewed

@@ -1,442 +1,442 @@
-/**
- * e2e-nocode.test.ts
- * 小白视角端到端测试 / End-to-end tests from a non-coder's perspective
- *
- * 模拟一个完全不懂代码的人使用 OPC Studio 的每一步操作。
- * Simulates every step a non-technical user would take in OPC Studio.
- *
- * All network calls (Ollama, external APIs) are mocked — no real infra needed.
- */
-import { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from 'vitest';
-import { StudioServer } from '../src/studio/server';
-import * as http from 'http';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-// --------------- helpers ---------------
-const PORT = 19876;
-const FIXTURE_DIR = path.join(__dirname, '__e2e_nocode_fixture__');
-const STATIC_DIR = path.join(FIXTURE_DIR, 'studio-ui');
-/** Minimal HTTP fetch that works without node-fetch */
-function fetch(
-  urlPath: string,
-  method = 'GET',
-  body?: string | object,
-): Promise<{ status: number; headers: any; body: string; json: () => any }> {
-  const bodyStr = body ? (typeof body === 'string' ? body : JSON.stringify(body)) : undefined;
-  return new Promise((resolve, reject) => {
-    const req = http.request(
-      { hostname: '127.0.0.1', port: PORT, path: `/api/${urlPath}`, method, headers: body ? { 'Content-Type': 'application/json' } : {} },
-      (res) => {
-        let data = '';
-        res.on('data', (c) => (data += c));
-        res.on('end', () =>
-          resolve({
-            status: res.statusCode!,
-            headers: res.headers,
-            body: data,
-            json: () => JSON.parse(data),
-          }),
-        );
-      },
-    );
-    req.on('error', reject);
-    if (bodyStr) req.write(bodyStr);
-    req.end();
-  });
-}
-/** Fetch raw path (not prefixed with /api/) */
-function fetchRaw(urlPath: string): Promise<{ status: number; body: string }> {
-  return new Promise((resolve, reject) => {
-    http.get({ hostname: '127.0.0.1', port: PORT, path: urlPath }, (res) => {
-      let data = '';
-      res.on('data', (c) => (data += c));
-      res.on('end', () => resolve({ status: res.statusCode!, body: data }));
-    }).on('error', reject);
-  });
-}
-// --------------- setup / teardown ---------------
-let server: StudioServer;
-beforeAll(async () => {
-  fs.mkdirSync(STATIC_DIR, { recursive: true });
-  fs.writeFileSync(path.join(STATIC_DIR, 'index.html'), '<html><body>OPC Studio Dashboard</body></html>');
-  fs.writeFileSync(
-    path.join(FIXTURE_DIR, 'package.json'),
-    JSON.stringify({ name: 'test-nocode', version: '1.0.0', description: 'E2E fixture' }),
-  );
-  server = new StudioServer({ port: PORT, agentDir: FIXTURE_DIR, staticDir: STATIC_DIR });
-  await server.start();
-  await new Promise((r) => setTimeout(r, 300));
-});
-afterAll(async () => {
-  await server.stop();
-  fs.rmSync(FIXTURE_DIR, { recursive: true, force: true });
-});
-// --------------- 场景 1：首次打开 / First Open ---------------
-describe('场景1: 首次打开 / First Open', () => {
-  it('GET / 应该返回 Dashboard 页面 / should serve the dashboard page', async () => {
-    const res = await fetchRaw('/');
-    expect(res.status).toBe(200);
-    expect(res.body).toContain('OPC Studio');
-  });
-  it('没有 Agent 时可以获取列表 / can fetch agent list when none created', async () => {
-    const res = await fetch('agents');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    expect(Array.isArray(data) || typeof data === 'object').toBe(true);
-  });
-});
-// --------------- 场景 2：浏览模板市场 / Browse Template Market ---------------
-describe('场景2: 浏览模板市场 / Template Market', () => {
-  it('GET /api/templates 返回 100+ 模板 / returns 100+ templates', async () => {
-    const res = await fetch('templates');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    expect(Array.isArray(data.templates || data)).toBe(true);
-    const list = data.templates || data;
-    expect(list.length).toBeGreaterThanOrEqual(100);
-  });
-  it('按行业筛选（technology）/ filter by industry', async () => {
-    const res = await fetch('templates?industry=technology');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    const list = data.templates || data;
-    expect(list.length).toBeGreaterThan(0);
-    list.forEach((t: any) => expect(t.industry).toBe('technology'));
-  });
-  it('搜索关键词 / search by keyword', async () => {
-    const res = await fetch('templates?search=support');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    const list = data.templates || data;
-    expect(list.length).toBeGreaterThan(0);
-  });
-  it('每个模板有必要字段 / each template has required fields', async () => {
-    const res = await fetch('templates');
-    const data = res.json();
-    const list = data.templates || data;
-    const sample = list[0];
-    expect(sample).toHaveProperty('name');
-    expect(sample).toHaveProperty('description');
-    expect(sample).toHaveProperty('industry');
-    expect(sample).toHaveProperty('icon');
-  });
-});
-// --------------- 场景 3：3 步创建 Agent / 3-Step Agent Creation ---------------
-describe('场景3: 3步创建Agent / 3-Step Agent Creation', () => {
-  let createdId: string;
-  it('Step1: 选模板创建 Agent / create agent with template', async () => {
-    const res = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'My First Agent' });
-    expect([200, 201]).toContain(res.status);
-    const data = res.json();
-    expect(data.id).toBeTruthy();
-    createdId = data.id;
-  });
-  it('Step2: 验证有默认值 / agent has defaults', async () => {
-    expect(createdId).toBeTruthy();
-    const res = await fetch(`agents/${createdId}`);
-    expect([200, 201]).toContain(res.status);
-    const data = res.json();
-    expect(data.id || data.name).toBeTruthy();
-  });
-  it('Step3: Agent 数据已持久化 / agent data persisted', async () => {
-    expect(createdId).toBeTruthy();
-    const res = await fetch(`agents/${createdId}`);
-    expect([200, 201]).toContain(res.status);
-  });
-  it('创建后在列表中可见 / appears in agent list after creation', async () => {
-    const res = await fetch('agents');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    const list = Array.isArray(data) ? data : (data.agents || []);
-    expect(list.some((a: any) => a.id === createdId)).toBe(true);
-  });
-  // cleanup
-  afterAll(async () => {
-    if (createdId) {
-      await fetch(`agents/${createdId}`, 'DELETE');
-    }
-  });
-});
-// --------------- 场景 4：模型配置 / Model Configuration ---------------
-describe('场景4: 模型配置 / Model Configuration', () => {
-  it('GET /api/settings/models 返回当前配置 / returns current model config', async () => {
-    const res = await fetch('settings/models');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    // Should have default values
-    expect(data.chatModel || data.mode).toBeTruthy();
-  });
-  it('GET /api/settings/models/local 检测本地 Ollama / detect local Ollama', async () => {
-    const res = await fetch('settings/models/local');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    // Response should indicate Ollama running state and model list
-    expect(data).toHaveProperty('running');
-    expect(data).toHaveProperty('models');
-  });
-  it('默认值正确 / correct defaults: qwen2.5:7b + nomic-embed-text', async () => {
-    const res = await fetch('settings/models');
-    const data = res.json();
-    expect(data.chatModel).toBe('qwen2.5:7b');
-    expect(data.embeddingModel).toBe('nomic-embed-text');
-  });
-  it('PUT /api/settings/models 保存配置 / saves model config', async () => {
-    const res = await fetch('settings/models', 'PUT', {
-      mode: 'local',
-      provider: 'ollama',
-      chatModel: 'llama3:8b',
-      embeddingModel: 'nomic-embed-text',
-    });
-    expect(res.status).toBe(200);
-    // Read back
-    const res2 = await fetch('settings/models');
-    const data = res2.json();
-    expect(data.chatModel).toBe('llama3:8b');
-    // Restore default
-    await fetch('settings/models', 'PUT', {
-      mode: 'local',
-      provider: 'ollama',
-      chatModel: 'qwen2.5:7b',
-      embeddingModel: 'nomic-embed-text',
-    });
-  });
-  it('POST /api/settings/models/test 测试连接 / test model connection', async () => {
-    const res = await fetch('settings/models/test', 'POST', {
-      provider: 'ollama',
-      chatModel: 'qwen2.5:7b',
-    });
-    expect(res.status).toBe(200);
-    const data = res.json();
-    // Should return success or error, not crash
-    expect(data).toHaveProperty('success');
-  });
-});
-// --------------- 场景 5：渠道配置 / Channel Configuration ---------------
-describe('场景5: 渠道配置 / Channel Configuration', () => {
-  it('GET /api/settings/channels 返回渠道列表 / returns channel list', async () => {
-    const res = await fetch('settings/channels');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    // Channels endpoint returns data (may be empty if none configured)
-    expect(data).toBeTruthy();
-  });
-  it('每个渠道有状态标识 / each channel has status', async () => {
-    const res = await fetch('settings/channels');
-    const data = res.json();
-    const list = Array.isArray(data) ? data : (data.channels || []);
-    if (list.length > 0) {
-      const ch = list[0];
-      expect(ch.name || ch.id || ch.type).toBeTruthy();
-    }
-  });
-  it('PUT /api/settings/channels/:name 保存渠道配置 / save channel config', async () => {
-    const res = await fetch('settings/channels/telegram', 'PUT', {
-      token: 'test-token-12345',
-      enabled: true,
-    });
-    expect(res.status).toBe(200);
-  });
-});
-// --------------- 场景 6：对话 / Chat ---------------
-describe('场景6: 对话 / Chat', () => {
-  let agentId: string;
-  beforeAll(async () => {
-    const res = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'Chat Test Agent' });
-    agentId = res.json().id;
-  });
-  afterAll(async () => {
-    if (agentId) await fetch(`agents/${agentId}`, 'DELETE');
-  });
-  it('POST /api/agents/:id/chat 返回响应 / returns chat response', async () => {
-    const res = await fetch(`agents/${agentId}/chat`, 'POST', { message: 'Hello!' });
-    // SSE or JSON response — should not be 404/500
-    expect([200, 201]).toContain(res.status);
-  });
-  it('空消息应该报错 / empty message should error', async () => {
-    const res = await fetch(`agents/${agentId}/chat`, 'POST', { message: '' });
-    // Server may reject or accept — at minimum should not crash (5xx)
-    expect(res.status).toBeLessThan(500);
-  });
-  it('Agent 不存在应该 404 / non-existent agent returns 404', async () => {
-    const res = await fetch('agents/nonexistent-id-12345/chat', 'POST', { message: 'hi' });
-    expect(res.status).toBe(404);
-  });
-});
-// --------------- 场景 7：运行状态 / Runtime Status ---------------
-describe('场景7: 运行状态 / Runtime Status', () => {
-  it('GET /api/settings/status 返回运行信息 / returns status info', async () => {
-    const res = await fetch('settings/status');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    expect(data).toBeTruthy();
-    // Should contain uptime or memory info
-    expect(data.uptime !== undefined || data.memory !== undefined || data.modules !== undefined).toBe(true);
-  });
-});
-// --------------- 场景 8：用量统计 / Usage Stats ---------------
-describe('场景8: 用量统计 / Usage Stats', () => {
-  it('GET /api/settings/usage 返回用量数据 / returns usage data', async () => {
-    const res = await fetch('settings/usage');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    expect(data).toBeTruthy();
-  });
-});
-// --------------- 场景 9：记忆管理入口 / Memory Management ---------------
-describe('场景9: 记忆管理入口 / Memory Management Entry', () => {
-  it('settings/status 包含 DeepBrain 模块信息 / status includes DeepBrain module', async () => {
-    const res = await fetch('settings/status');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    // DeepBrain should be listed in modules
-    if (data.modules) {
-      const brain = data.modules.find((m: any) => m.name === 'DeepBrain' || m.path === 'brain');
-      expect(brain).toBeTruthy();
-    }
-  });
-});
-// --------------- 场景 10：角色编辑入口 / Role Editor Entry ---------------
-describe('场景10: 角色编辑入口 / Role Editor Entry', () => {
-  it('settings/status 包含 Workstation 模块信息 / status includes Workstation module', async () => {
-    const res = await fetch('settings/status');
-    expect(res.status).toBe(200);
-    const data = res.json();
-    if (data.modules) {
-      const ws = data.modules.find((m: any) => m.name === 'Workstation' || m.path === 'workstation');
-      expect(ws).toBeTruthy();
-    }
-  });
-});
-// --------------- 场景 11：完整流程 / Full E2E Flow ---------------
-describe('场景11: 完整端到端流程 / Full E2E Flow', () => {
-  let agentId: string;
-  it('完整操作链 / full operation chain', async () => {
-    // 1. 浏览模板
-    const templates = await fetch('templates');
-    expect(templates.status).toBe(200);
-    // 2. 创建 Agent
-    const create = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'E2E Flow Agent' });
-    expect([200, 201]).toContain(create.status);
-    agentId = create.json().id;
-    // 3. 查看 Dashboard（agent list）
-    const list = await fetch('agents');
-    expect(list.status).toBe(200);
-    const agents = list.json();
-    const agentList = Array.isArray(agents) ? agents : (agents.agents || []);
-    expect(agentList.some((a: any) => a.id === agentId)).toBe(true);
-    // 4. 查看模型配置
-    const models = await fetch('settings/models');
-    expect(models.status).toBe(200);
-    // 5. 查看渠道
-    const channels = await fetch('settings/channels');
-    expect(channels.status).toBe(200);
-    // 6. 查看状态
-    const status = await fetch('settings/status');
-    expect(status.status).toBe(200);
-    // 7. 查看用量
-    const usage = await fetch('settings/usage');
-    expect(usage.status).toBe(200);
-    // Cleanup
-    await fetch(`agents/${agentId}`, 'DELETE');
-  });
-});
-// --------------- 场景 12：错误处理 / Error Handling ---------------
-describe('场景12: 错误处理（小白友好）/ User-Friendly Error Handling', () => {
-  it('无效 Agent ID 返回友好错误 / invalid agent ID returns friendly error', async () => {
-    const res = await fetch('agents/this-does-not-exist');
-    expect(res.status).toBe(404);
-    const data = res.json();
-    // Should have a message, not a raw stack trace
-    expect(data.error || data.message).toBeTruthy();
-    expect(res.body).not.toContain('Error:');
-    expect(res.body).not.toContain('at Object.');
-  });
-  it('缺少必填字段仍能处理 / missing fields handled gracefully', async () => {
-    const res = await fetch('agents', 'POST', {});
-    // Server should handle it (may create with defaults or reject)
-    expect(res.status).toBeLessThan(500);
-  });
-  it('模型测试失败返回友好提示 / model test failure gives friendly message', async () => {
-    const res = await fetch('settings/models/test', 'POST', {
-      provider: 'ollama',
-      chatModel: 'nonexistent-model',
-      baseUrl: 'http://localhost:99999',
-    });
-    // Server may return 200 with success:false or 500 — either way should have info
-    const data = res.json();
-    if (res.status === 200 && !data.success) {
-      expect(data.error || data.message).toBeTruthy();
-    }
-    // If 500, the error should still be parseable JSON (not raw stack)
-    if (res.status >= 500) {
-      expect(data.error || data.message).toBeTruthy();
-    }
-  });
-});
+/**
+ * e2e-nocode.test.ts
+ * 小白视角端到端测试 / End-to-end tests from a non-coder's perspective
+ *
+ * 模拟一个完全不懂代码的人使用 OPC Studio 的每一步操作。
+ * Simulates every step a non-technical user would take in OPC Studio.
+ *
+ * All network calls (Ollama, external APIs) are mocked — no real infra needed.
+ */
+import { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from 'vitest';
+import { StudioServer } from '../src/studio/server';
+import * as http from 'http';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// --------------- helpers ---------------
+const PORT = 19876;
+const FIXTURE_DIR = path.join(__dirname, '__e2e_nocode_fixture__');
+const STATIC_DIR = path.join(FIXTURE_DIR, 'studio-ui');
+/** Minimal HTTP fetch that works without node-fetch */
+function fetch(
+  urlPath: string,
+  method = 'GET',
+  body?: string | object,
+): Promise<{ status: number; headers: any; body: string; json: () => any }> {
+  const bodyStr = body ? (typeof body === 'string' ? body : JSON.stringify(body)) : undefined;
+  return new Promise((resolve, reject) => {
+    const req = http.request(
+      { hostname: '127.0.0.1', port: PORT, path: `/api/${urlPath}`, method, headers: body ? { 'Content-Type': 'application/json' } : {} },
+      (res) => {
+        let data = '';
+        res.on('data', (c) => (data += c));
+        res.on('end', () =>
+          resolve({
+            status: res.statusCode!,
+            headers: res.headers,
+            body: data,
+            json: () => JSON.parse(data),
+          }),
+        );
+      },
+    );
+    req.on('error', reject);
+    if (bodyStr) req.write(bodyStr);
+    req.end();
+  });
+}
+/** Fetch raw path (not prefixed with /api/) */
+function fetchRaw(urlPath: string): Promise<{ status: number; body: string }> {
+  return new Promise((resolve, reject) => {
+    http.get({ hostname: '127.0.0.1', port: PORT, path: urlPath }, (res) => {
+      let data = '';
+      res.on('data', (c) => (data += c));
+      res.on('end', () => resolve({ status: res.statusCode!, body: data }));
+    }).on('error', reject);
+  });
+}
+// --------------- setup / teardown ---------------
+let server: StudioServer;
+beforeAll(async () => {
+  fs.mkdirSync(STATIC_DIR, { recursive: true });
+  fs.writeFileSync(path.join(STATIC_DIR, 'index.html'), '<html><body>OPC Studio Dashboard</body></html>');
+  fs.writeFileSync(
+    path.join(FIXTURE_DIR, 'package.json'),
+    JSON.stringify({ name: 'test-nocode', version: '1.0.0', description: 'E2E fixture' }),
+  );
+  server = new StudioServer({ port: PORT, agentDir: FIXTURE_DIR, staticDir: STATIC_DIR });
+  await server.start();
+  await new Promise((r) => setTimeout(r, 300));
+});
+afterAll(async () => {
+  await server.stop();
+  fs.rmSync(FIXTURE_DIR, { recursive: true, force: true });
+});
+// --------------- 场景 1：首次打开 / First Open ---------------
+describe('场景1: 首次打开 / First Open', () => {
+  it('GET / 应该返回 Dashboard 页面 / should serve the dashboard page', async () => {
+    const res = await fetchRaw('/');
+    expect(res.status).toBe(200);
+    expect(res.body).toContain('OPC Studio');
+  });
+  it('没有 Agent 时可以获取列表 / can fetch agent list when none created', async () => {
+    const res = await fetch('agents');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    expect(Array.isArray(data) || typeof data === 'object').toBe(true);
+  });
+});
+// --------------- 场景 2：浏览模板市场 / Browse Template Market ---------------
+describe('场景2: 浏览模板市场 / Template Market', () => {
+  it('GET /api/templates 返回 100+ 模板 / returns 100+ templates', async () => {
+    const res = await fetch('templates');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    expect(Array.isArray(data.templates || data)).toBe(true);
+    const list = data.templates || data;
+    expect(list.length).toBeGreaterThanOrEqual(100);
+  });
+  it('按行业筛选（technology）/ filter by industry', async () => {
+    const res = await fetch('templates?industry=technology');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    const list = data.templates || data;
+    expect(list.length).toBeGreaterThan(0);
+    list.forEach((t: any) => expect(t.industry).toBe('technology'));
+  });
+  it('搜索关键词 / search by keyword', async () => {
+    const res = await fetch('templates?search=support');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    const list = data.templates || data;
+    expect(list.length).toBeGreaterThan(0);
+  });
+  it('每个模板有必要字段 / each template has required fields', async () => {
+    const res = await fetch('templates');
+    const data = res.json();
+    const list = data.templates || data;
+    const sample = list[0];
+    expect(sample).toHaveProperty('name');
+    expect(sample).toHaveProperty('description');
+    expect(sample).toHaveProperty('industry');
+    expect(sample).toHaveProperty('icon');
+  });
+});
+// --------------- 场景 3：3 步创建 Agent / 3-Step Agent Creation ---------------
+describe('场景3: 3步创建Agent / 3-Step Agent Creation', () => {
+  let createdId: string;
+  it('Step1: 选模板创建 Agent / create agent with template', async () => {
+    const res = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'My First Agent' });
+    expect([200, 201]).toContain(res.status);
+    const data = res.json();
+    expect(data.id).toBeTruthy();
+    createdId = data.id;
+  });
+  it('Step2: 验证有默认值 / agent has defaults', async () => {
+    expect(createdId).toBeTruthy();
+    const res = await fetch(`agents/${createdId}`);
+    expect([200, 201]).toContain(res.status);
+    const data = res.json();
+    expect(data.id || data.name).toBeTruthy();
+  });
+  it('Step3: Agent 数据已持久化 / agent data persisted', async () => {
+    expect(createdId).toBeTruthy();
+    const res = await fetch(`agents/${createdId}`);
+    expect([200, 201]).toContain(res.status);
+  });
+  it('创建后在列表中可见 / appears in agent list after creation', async () => {
+    const res = await fetch('agents');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    const list = Array.isArray(data) ? data : (data.agents || []);
+    expect(list.some((a: any) => a.id === createdId)).toBe(true);
+  });
+  // cleanup
+  afterAll(async () => {
+    if (createdId) {
+      await fetch(`agents/${createdId}`, 'DELETE');
+    }
+  });
+});
+// --------------- 场景 4：模型配置 / Model Configuration ---------------
+describe('场景4: 模型配置 / Model Configuration', () => {
+  it('GET /api/settings/models 返回当前配置 / returns current model config', async () => {
+    const res = await fetch('settings/models');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    // Should have default values
+    expect(data.chatModel || data.mode).toBeTruthy();
+  });
+  it('GET /api/settings/models/local 检测本地 Ollama / detect local Ollama', async () => {
+    const res = await fetch('settings/models/local');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    // Response should indicate Ollama running state and model list
+    expect(data).toHaveProperty('running');
+    expect(data).toHaveProperty('models');
+  });
+  it('默认值正确 / correct defaults: qwen2.5:7b + nomic-embed-text', async () => {
+    const res = await fetch('settings/models');
+    const data = res.json();
+    expect(data.chatModel).toBe('qwen2.5:7b');
+    expect(data.embeddingModel).toBe('nomic-embed-text');
+  });
+  it('PUT /api/settings/models 保存配置 / saves model config', async () => {
+    const res = await fetch('settings/models', 'PUT', {
+      mode: 'local',
+      provider: 'ollama',
+      chatModel: 'llama3:8b',
+      embeddingModel: 'nomic-embed-text',
+    });
+    expect(res.status).toBe(200);
+    // Read back
+    const res2 = await fetch('settings/models');
+    const data = res2.json();
+    expect(data.chatModel).toBe('llama3:8b');
+    // Restore default
+    await fetch('settings/models', 'PUT', {
+      mode: 'local',
+      provider: 'ollama',
+      chatModel: 'qwen2.5:7b',
+      embeddingModel: 'nomic-embed-text',
+    });
+  });
+  it('POST /api/settings/models/test 测试连接 / test model connection', async () => {
+    const res = await fetch('settings/models/test', 'POST', {
+      provider: 'ollama',
+      chatModel: 'qwen2.5:7b',
+    });
+    expect(res.status).toBe(200);
+    const data = res.json();
+    // Should return success or error, not crash
+    expect(data).toHaveProperty('success');
+  });
+});
+// --------------- 场景 5：渠道配置 / Channel Configuration ---------------
+describe('场景5: 渠道配置 / Channel Configuration', () => {
+  it('GET /api/settings/channels 返回渠道列表 / returns channel list', async () => {
+    const res = await fetch('settings/channels');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    // Channels endpoint returns data (may be empty if none configured)
+    expect(data).toBeTruthy();
+  });
+  it('每个渠道有状态标识 / each channel has status', async () => {
+    const res = await fetch('settings/channels');
+    const data = res.json();
+    const list = Array.isArray(data) ? data : (data.channels || []);
+    if (list.length > 0) {
+      const ch = list[0];
+      expect(ch.name || ch.id || ch.type).toBeTruthy();
+    }
+  });
+  it('PUT /api/settings/channels/:name 保存渠道配置 / save channel config', async () => {
+    const res = await fetch('settings/channels/telegram', 'PUT', {
+      token: 'test-token-12345',
+      enabled: true,
+    });
+    expect(res.status).toBe(200);
+  });
+});
+// --------------- 场景 6：对话 / Chat ---------------
+describe('场景6: 对话 / Chat', () => {
+  let agentId: string;
+  beforeAll(async () => {
+    const res = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'Chat Test Agent' });
+    agentId = res.json().id;
+  });
+  afterAll(async () => {
+    if (agentId) await fetch(`agents/${agentId}`, 'DELETE');
+  });
+  it('POST /api/agents/:id/chat 返回响应 / returns chat response', async () => {
+    const res = await fetch(`agents/${agentId}/chat`, 'POST', { message: 'Hello!' });
+    // SSE or JSON response — should not be 404/500
+    expect([200, 201]).toContain(res.status);
+  });
+  it('空消息应该报错 / empty message should error', async () => {
+    const res = await fetch(`agents/${agentId}/chat`, 'POST', { message: '' });
+    // Server may reject or accept — at minimum should not crash (5xx)
+    expect(res.status).toBeLessThan(500);
+  });
+  it('Agent 不存在应该 404 / non-existent agent returns 404', async () => {
+    const res = await fetch('agents/nonexistent-id-12345/chat', 'POST', { message: 'hi' });
+    expect(res.status).toBe(404);
+  });
+});
+// --------------- 场景 7：运行状态 / Runtime Status ---------------
+describe('场景7: 运行状态 / Runtime Status', () => {
+  it('GET /api/settings/status 返回运行信息 / returns status info', async () => {
+    const res = await fetch('settings/status');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    expect(data).toBeTruthy();
+    // Should contain uptime or memory info
+    expect(data.uptime !== undefined || data.memory !== undefined || data.modules !== undefined).toBe(true);
+  });
+});
+// --------------- 场景 8：用量统计 / Usage Stats ---------------
+describe('场景8: 用量统计 / Usage Stats', () => {
+  it('GET /api/settings/usage 返回用量数据 / returns usage data', async () => {
+    const res = await fetch('settings/usage');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    expect(data).toBeTruthy();
+  });
+});
+// --------------- 场景 9：记忆管理入口 / Memory Management ---------------
+describe('场景9: 记忆管理入口 / Memory Management Entry', () => {
+  it('settings/status 包含 DeepBrain 模块信息 / status includes DeepBrain module', async () => {
+    const res = await fetch('settings/status');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    // DeepBrain should be listed in modules
+    if (data.modules) {
+      const brain = data.modules.find((m: any) => m.name === 'DeepBrain' || m.path === 'brain');
+      expect(brain).toBeTruthy();
+    }
+  });
+});
+// --------------- 场景 10：角色编辑入口 / Role Editor Entry ---------------
+describe('场景10: 角色编辑入口 / Role Editor Entry', () => {
+  it('settings/status 包含 Workstation 模块信息 / status includes Workstation module', async () => {
+    const res = await fetch('settings/status');
+    expect(res.status).toBe(200);
+    const data = res.json();
+    if (data.modules) {
+      const ws = data.modules.find((m: any) => m.name === 'Workstation' || m.path === 'workstation');
+      expect(ws).toBeTruthy();
+    }
+  });
+});
+// --------------- 场景 11：完整流程 / Full E2E Flow ---------------
+describe('场景11: 完整端到端流程 / Full E2E Flow', () => {
+  let agentId: string;
+  it('完整操作链 / full operation chain', async () => {
+    // 1. 浏览模板
+    const templates = await fetch('templates');
+    expect(templates.status).toBe(200);
+    // 2. 创建 Agent
+    const create = await fetch('agents', 'POST', { template_id: 'tech-support', name: 'E2E Flow Agent' });
+    expect([200, 201]).toContain(create.status);
+    agentId = create.json().id;
+    // 3. 查看 Dashboard（agent list）
+    const list = await fetch('agents');
+    expect(list.status).toBe(200);
+    const agents = list.json();
+    const agentList = Array.isArray(agents) ? agents : (agents.agents || []);
+    expect(agentList.some((a: any) => a.id === agentId)).toBe(true);
+    // 4. 查看模型配置
+    const models = await fetch('settings/models');
+    expect(models.status).toBe(200);
+    // 5. 查看渠道
+    const channels = await fetch('settings/channels');
+    expect(channels.status).toBe(200);
+    // 6. 查看状态
+    const status = await fetch('settings/status');
+    expect(status.status).toBe(200);
+    // 7. 查看用量
+    const usage = await fetch('settings/usage');
+    expect(usage.status).toBe(200);
+    // Cleanup
+    await fetch(`agents/${agentId}`, 'DELETE');
+  });
+});
+// --------------- 场景 12：错误处理 / Error Handling ---------------
+describe('场景12: 错误处理（小白友好）/ User-Friendly Error Handling', () => {
+  it('无效 Agent ID 返回友好错误 / invalid agent ID returns friendly error', async () => {
+    const res = await fetch('agents/this-does-not-exist');
+    expect(res.status).toBe(404);
+    const data = res.json();
+    // Should have a message, not a raw stack trace
+    expect(data.error || data.message).toBeTruthy();
+    expect(res.body).not.toContain('Error:');
+    expect(res.body).not.toContain('at Object.');
+  });
+  it('缺少必填字段仍能处理 / missing fields handled gracefully', async () => {
+    const res = await fetch('agents', 'POST', {});
+    // Server should handle it (may create with defaults or reject)
+    expect(res.status).toBeLessThan(500);
+  });
+  it('模型测试失败返回友好提示 / model test failure gives friendly message', async () => {
+    const res = await fetch('settings/models/test', 'POST', {
+      provider: 'ollama',
+      chatModel: 'nonexistent-model',
+      baseUrl: 'http://localhost:99999',
+    });
+    // Server may return 200 with success:false or 500 — either way should have info
+    const data = res.json();
+    if (res.status === 200 && !data.success) {
+      expect(data.error || data.message).toBeTruthy();
+    }
+    // If 500, the error should still be parseable JSON (not raw stack)
+    if (res.status >= 500) {
+      expect(data.error || data.message).toBeTruthy();
+    }
+  });
+});