android-midscene-automation 0.2.4 → 1.1.1

package/artemis-main/apps/showcase_ui/src/app/components/nav-switcher/nav-switcher.component.scss

@@ -0,0 +1,115 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.floating-nav-switcher {
+  position: fixed;
+  top: 12px;
+  left: 24px;
+  z-index: 1100;
+  height: 36px;
+  box-sizing: border-box;
+  display: inline-flex;
+  align-items: center;
+  background: rgba(255, 255, 255, 0.72);
+  backdrop-filter: blur(16px) saturate(180%);
+  -webkit-backdrop-filter: blur(16px) saturate(180%);
+  border: 1px solid rgba(226, 232, 240, 0.85);
+  border-radius: 18px;
+  padding: 3px;
+  gap: 3px;
+  box-shadow: 0 2px 8px -1px rgba(15, 23, 42, 0.06), 0 1px 2px rgba(0, 0, 0, 0.02), inset 0 1px 1px rgba(255, 255, 255, 0.9);
+  user-select: none;
+  font-family: 'Google Sans', 'Google Sans Text', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  transition: background 0.25s cubic-bezier(0.4, 0, 0.2, 1),
+              box-shadow 0.25s cubic-bezier(0.4, 0, 0.2, 1),
+              border-color 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+
+  &:hover {
+    background: rgba(255, 255, 255, 0.85);
+    box-shadow: 0 4px 14px -2px rgba(15, 23, 42, 0.1), 0 2px 4px rgba(0, 0, 0, 0.03), inset 0 1px 1px rgba(255, 255, 255, 1);
+    border-color: rgba(203, 213, 225, 0.9);
+  }
+
+  .nav-tab-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 6px;
+    height: 30px;
+    padding: 0 14px;
+    box-sizing: border-box;
+    border-radius: 15px;
+    font-size: 13px;
+    font-weight: 600;
+    color: #475569;
+    text-decoration: none;
+    cursor: pointer;
+    line-height: 1;
+    transition: background 0.2s cubic-bezier(0.4, 0, 0.2, 1),
+                color 0.2s cubic-bezier(0.4, 0, 0.2, 1),
+                box-shadow 0.2s cubic-bezier(0.4, 0, 0.2, 1),
+                transform 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    outline: none;
+    white-space: nowrap;
+
+    .tab-icon {
+      font-size: 16px;
+      width: 16px;
+      height: 16px;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      color: #64748b;
+      transition: color 0.15s ease, transform 0.15s ease;
+    }
+
+    .tab-label {
+      color: #475569;
+      transition: color 0.15s ease;
+    }
+
+    &:hover:not(.active) {
+      background: rgba(255, 255, 255, 0.7);
+      color: #0f172a;
+
+      .tab-icon {
+        color: #1a73e8;
+      }
+      .tab-label {
+        color: #0f172a;
+      }
+    }
+
+    &.active {
+      background: rgba(26, 115, 232, 0.95) !important;
+      backdrop-filter: blur(12px);
+      -webkit-backdrop-filter: blur(12px);
+      color: #ffffff !important;
+      font-weight: 700;
+      box-shadow: 0 2px 8px rgba(26, 115, 232, 0.35), inset 0 1px 1px rgba(255, 255, 255, 0.35);
+
+      .tab-icon,
+      .tab-label,
+      span {
+        color: #ffffff !important;
+      }
+    }
+
+    &:active {
+      transform: scale(0.97);
+    }
+  }
+}

package/artemis-main/apps/showcase_ui/src/app/components/nav-switcher/nav-switcher.component.ts

@@ -0,0 +1,52 @@
+import { TranslatePipe } from '../../core/i18n/translate.pipe';
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Component, ChangeDetectionStrategy } from '@angular/core';
+
+import { RouterLink, RouterLinkActive } from '@angular/router';
+
+@Component({
+  selector: 'app-nav-switcher',
+  standalone: true,
+  imports: [TranslatePipe, RouterLink, RouterLinkActive],
+  template: `
+    <nav class="floating-nav-switcher" [attr.aria-label]="'Main Navigation' | t">
+      <a 
+        routerLink="/" 
+        routerLinkActive="active" 
+        [routerLinkActiveOptions]="{exact: true}"
+        class="nav-tab-btn"
+        [title]="'Return to Home Launcher to start a new task' | t"
+      >
+        <span class="material-symbols-outlined tab-icon">add_task</span>
+        <span class="tab-label">{{ 'New / Home' | t }}</span>
+      </a>
+      <a 
+        routerLink="/workspace" 
+        routerLinkActive="active" 
+        class="nav-tab-btn"
+        [title]="'Open Workspace' | t"
+      >
+        <span class="material-symbols-outlined tab-icon">space_dashboard</span>
+        <span class="tab-label">{{ 'Workspace' | t }}</span>
+      </a>
+    </nav>
+  `,
+  changeDetection: ChangeDetectionStrategy.Eager,
+  styleUrls: ['./nav-switcher.component.scss']
+})
+export class NavSwitcherComponent {}

package/artemis-main/apps/showcase_ui/src/app/core/data/smart-tasks.data.ts

@@ -0,0 +1,334 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export interface AppReference {
+  name: string;
+  icon: string;
+  pkg?: string;
+  category?: string;
+}
+
+export type SuggestionCategory =
+  | 'all'
+  | 'flash'
+  | 'pro'
+  | 'cross_app'
+  | 'monitor';
+
+export interface SmartSuggestion {
+  id: string;
+  title: string;
+  description: string;
+  goal: string;
+  profile: 'flash' | 'pro';
+  category: 'flash' | 'pro' | 'cross_app' | 'monitor';
+  tag: string;
+  apps: AppReference[];
+  requiredPackages?: string[];
+  matchMode?: 'any' | 'all';
+  priority?: number;
+}
+
+/**
+ * Recognized Android App Package Registry
+ */
+export const APP_REGISTRY: Record<string, AppReference> = {
+  // Google Suite & System
+  'com.google.android.apps.maps': { name: 'Maps', icon: 'explore', pkg: 'com.google.android.apps.maps', category: 'navigation' },
+  'com.google.android.gm': { name: 'Gmail', icon: 'mail', pkg: 'com.google.android.gm', category: 'productivity' },
+  'com.android.chrome': { name: 'Chrome', icon: 'public', pkg: 'com.android.chrome', category: 'browser' },
+  'com.google.android.youtube': { name: 'YouTube', icon: 'smart_display', pkg: 'com.google.android.youtube', category: 'entertainment' },
+  'com.android.settings': { name: 'Settings', icon: 'settings', pkg: 'com.android.settings', category: 'system' },
+  'com.google.android.deskclock': { name: 'Clock', icon: 'timer', pkg: 'com.google.android.deskclock', category: 'utility' },
+  'com.android.deskclock': { name: 'Clock', icon: 'timer', pkg: 'com.android.deskclock', category: 'utility' },
+  'com.google.android.calculator': { name: 'Calculator', icon: 'calculate', pkg: 'com.google.android.calculator', category: 'utility' },
+  'com.android.calculator2': { name: 'Calculator', icon: 'calculate', pkg: 'com.android.calculator2', category: 'utility' },
+  'com.google.android.apps.photos': { name: 'Photos', icon: 'photo_library', pkg: 'com.google.android.apps.photos', category: 'media' },
+  'com.google.android.calendar': { name: 'Calendar', icon: 'calendar_month', pkg: 'com.google.android.calendar', category: 'productivity' },
+  'com.google.android.keep': { name: 'Keep Notes', icon: 'note_alt', pkg: 'com.google.android.keep', category: 'productivity' },
+  'com.android.vending': { name: 'Play Store', icon: 'storefront', pkg: 'com.android.vending', category: 'tools' },
+  'com.google.android.apps.messaging': { name: 'Messages', icon: 'chat', pkg: 'com.google.android.apps.messaging', category: 'communication' },
+
+  // Popular Ecosystem Apps
+  'com.tencent.mm': { name: 'WeChat', icon: 'forum', pkg: 'com.tencent.mm', category: 'social' },
+  'com.xingin.xhs': { name: 'Xiaohongshu', icon: 'auto_stories', pkg: 'com.xingin.xhs', category: 'social' },
+  'com.sankuai.meituan': { name: 'Meituan', icon: 'restaurant', pkg: 'com.sankuai.meituan', category: 'lifestyle' },
+  'com.dianping.v1': { name: 'Dianping', icon: 'star', pkg: 'com.dianping.v1', category: 'lifestyle' },
+  'tv.danmaku.bili': { name: 'Bilibili', icon: 'video_library', pkg: 'tv.danmaku.bili', category: 'entertainment' },
+  'com.eg.android.AlipayGphone': { name: 'Alipay', icon: 'account_balance_wallet', pkg: 'com.eg.android.AlipayGphone', category: 'finance' },
+  'com.netease.cloudmusic': { name: 'NetEase Music', icon: 'headphones', pkg: 'com.netease.cloudmusic', category: 'entertainment' },
+  'com.spotify.music': { name: 'Spotify', icon: 'music_note', pkg: 'com.spotify.music', category: 'entertainment' }
+};
+
+/**
+ * Curated, clean task preset library (1~2 representative tasks per common app)
+ */
+export const SMART_TASK_LIBRARY: SmartSuggestion[] = [
+  // 1. Google Maps
+  {
+    id: 'maps_coffee',
+    title: 'Find Specialty Coffee',
+    description: 'Search nearby top-rated cafes in Google Maps',
+    goal: 'Open Google Maps, search for top-rated specialty coffee shops nearby, and view the top result details.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Maps',
+    apps: [{ name: 'Maps', icon: 'explore', pkg: 'com.google.android.apps.maps' }],
+    requiredPackages: ['com.google.android.apps.maps'],
+    priority: 95
+  },
+  {
+    id: 'pro_commute_share',
+    title: 'Commute ETA & Message Draft',
+    description: 'Check transit time on Maps and draft arrival ETA in Messages',
+    goal: 'Open Google Maps to check commute time to the International Airport, calculate arrival time, then open Messages and draft an ETA text message.',
+    profile: 'pro',
+    category: 'cross_app',
+    tag: 'Maps + Messages',
+    apps: [
+      { name: 'Maps', icon: 'explore', pkg: 'com.google.android.apps.maps' },
+      { name: 'Messages', icon: 'chat', pkg: 'com.google.android.apps.messaging' }
+    ],
+    requiredPackages: ['com.google.android.apps.maps', 'com.google.android.apps.messaging'],
+    matchMode: 'all',
+    priority: 92
+  },
+
+  // 2. Gmail
+  {
+    id: 'gmail_receipts',
+    title: 'Search Order Receipts',
+    description: 'Find recent flight or delivery confirmation emails in Gmail',
+    goal: 'Open Gmail and search for recent flight or package delivery confirmation emails.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Gmail',
+    apps: [{ name: 'Gmail', icon: 'mail', pkg: 'com.google.android.gm' }],
+    requiredPackages: ['com.google.android.gm'],
+    priority: 90
+  },
+  {
+    id: 'pro_email_to_calendar',
+    title: 'Email Itinerary to Calendar',
+    description: 'Extract flight or event dates from Gmail and schedule in Calendar',
+    goal: 'Open Gmail to find the latest event invitation or itinerary, extract dates and location, then open Google Calendar and create a corresponding calendar event.',
+    profile: 'pro',
+    category: 'cross_app',
+    tag: 'Gmail + Calendar',
+    apps: [
+      { name: 'Gmail', icon: 'mail', pkg: 'com.google.android.gm' },
+      { name: 'Calendar', icon: 'calendar_month', pkg: 'com.google.android.calendar' }
+    ],
+    requiredPackages: ['com.google.android.gm'],
+    priority: 94
+  },
+
+  // 3. Chrome
+  {
+    id: 'chrome_research',
+    title: 'Search AI News Breakthroughs',
+    description: 'Search latest multimodal AI developments in Chrome browser',
+    goal: 'Open Chrome browser and search for latest breakthroughs in multimodal mobile AI agents.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Chrome',
+    apps: [{ name: 'Chrome', icon: 'public', pkg: 'com.android.chrome' }],
+    requiredPackages: ['com.android.chrome'],
+    priority: 88
+  },
+  {
+    id: 'pro_research_keep',
+    title: 'Product Research & Notes Note',
+    description: 'Compare top 3 headphones on Chrome and record comparison in Keep',
+    goal: 'Open Chrome, research top 3 noise-cancelling headphones comparing price and battery life, then write a structured comparison summary note in Keep Notes.',
+    profile: 'pro',
+    category: 'pro',
+    tag: 'Chrome + Keep',
+    apps: [
+      { name: 'Chrome', icon: 'public', pkg: 'com.android.chrome' },
+      { name: 'Keep Notes', icon: 'note_alt', pkg: 'com.google.android.keep' }
+    ],
+    requiredPackages: ['com.android.chrome'],
+    priority: 91
+  },
+
+  // 4. YouTube
+  {
+    id: 'youtube_lofi',
+    title: 'Play Lo-Fi Music Radio',
+    description: 'Search and play a Lo-Fi hip hop live stream on YouTube',
+    goal: 'Open YouTube, search for "Lofi hip hop beats relaxing radio" and tap on the live stream.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'YouTube',
+    apps: [{ name: 'YouTube', icon: 'smart_display', pkg: 'com.google.android.youtube' }],
+    requiredPackages: ['com.google.android.youtube'],
+    priority: 85
+  },
+
+  // 5. Settings
+  {
+    id: 'settings_display_wifi',
+    title: 'Dark Mode & Wi-Fi Check',
+    description: 'Toggle dark theme and verify network connection in Settings',
+    goal: 'Open Settings app, navigate to Display settings, ensure Dark theme is enabled, and check Wi-Fi connection status.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Settings',
+    apps: [{ name: 'Settings', icon: 'settings', pkg: 'com.android.settings' }],
+    requiredPackages: ['com.android.settings'],
+    priority: 87
+  },
+  {
+    id: 'pro_settings_qa',
+    title: 'Subsystem Health & Crash Probe',
+    description: 'Traverse Settings submenus to verify screens and check for crash dialogs',
+    goal: 'Explore Settings submenus (Network, Connected devices, Apps, Battery, Storage), verify each screen loads properly without ANR or crash dialogs, and summarize results.',
+    profile: 'pro',
+    category: 'monitor',
+    tag: 'Settings QA',
+    apps: [{ name: 'Settings', icon: 'settings', pkg: 'com.android.settings' }],
+    requiredPackages: ['com.android.settings'],
+    priority: 93
+  },
+
+  // 6. Clock
+  {
+    id: 'clock_timer',
+    title: '25-Min Pomodoro Timer',
+    description: 'Start a 25-minute focus countdown timer in Clock app',
+    goal: 'Open Clock app, switch to Timer tab, set 25 minutes and start the countdown timer.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Clock',
+    apps: [{ name: 'Clock', icon: 'timer', pkg: 'com.google.android.deskclock' }],
+    requiredPackages: ['com.google.android.deskclock', 'com.android.deskclock'],
+    priority: 86
+  },
+
+  // 7. Calculator
+  {
+    id: 'calc_gratuity',
+    title: 'Split Bill & Calculate Tip',
+    description: 'Calculate 18% gratuity on $186.40 for 3 people in Calculator',
+    goal: 'Open Calculator and calculate 18% tip on a bill of $186.40, then divide by 3 people.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Calculator',
+    apps: [{ name: 'Calculator', icon: 'calculate', pkg: 'com.google.android.calculator' }],
+    requiredPackages: ['com.google.android.calculator', 'com.android.calculator2'],
+    priority: 84
+  },
+
+  // 8. Photos
+  {
+    id: 'photos_inspect',
+    title: 'Inspect Recent Screenshot',
+    description: 'Open Google Photos and review the latest screenshot taken',
+    goal: 'Open Google Photos and view the most recent screenshot in the screenshots album.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Photos',
+    apps: [{ name: 'Photos', icon: 'photo_library', pkg: 'com.google.android.apps.photos' }],
+    requiredPackages: ['com.google.android.apps.photos'],
+    priority: 82
+  },
+
+  // 9. WeChat
+  {
+    id: 'wechat_browse',
+    title: 'Check WeChat Messages',
+    description: 'Open WeChat and view top recent chat conversations',
+    goal: 'Open WeChat and view the top recent chat messages.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'WeChat',
+    apps: [{ name: 'WeChat', icon: 'forum', pkg: 'com.tencent.mm' }],
+    requiredPackages: ['com.tencent.mm'],
+    priority: 89
+  },
+  {
+    id: 'pro_wechat_to_calendar',
+    title: 'WeChat Notice to Calendar',
+    description: 'Extract meeting notice from WeChat chat and add to Calendar',
+    goal: 'Open WeChat, locate the latest meeting announcement or event message in the top chat, extract the time and topic, then open Calendar and schedule an event.',
+    profile: 'pro',
+    category: 'cross_app',
+    tag: 'WeChat + Calendar',
+    apps: [
+      { name: 'WeChat', icon: 'forum', pkg: 'com.tencent.mm' },
+      { name: 'Calendar', icon: 'calendar_month', pkg: 'com.google.android.calendar' }
+    ],
+    requiredPackages: ['com.tencent.mm'],
+    priority: 93
+  },
+
+  // 10. Xiaohongshu
+  {
+    id: 'xhs_coffee_guide',
+    title: 'RED Cafe Guide Search',
+    description: 'Search trending specialty cafe reviews on Xiaohongshu',
+    goal: 'Open Xiaohongshu, search for top-rated specialty coffee shops, and view the top post.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Xiaohongshu',
+    apps: [{ name: 'Xiaohongshu', icon: 'auto_stories', pkg: 'com.xingin.xhs' }],
+    requiredPackages: ['com.xingin.xhs'],
+    priority: 87
+  },
+
+  // 11. Meituan / Dianping
+  {
+    id: 'meituan_ramen_search',
+    title: 'Meituan Food Search',
+    description: 'Search top-rated Ramen nearby on Meituan or Dianping',
+    goal: 'Open Meituan or Dianping, search for top-rated Ramen nearby, and view top restaurant rating.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Meituan',
+    apps: [{ name: 'Meituan', icon: 'restaurant', pkg: 'com.sankuai.meituan' }],
+    requiredPackages: ['com.sankuai.meituan', 'com.dianping.v1'],
+    priority: 86
+  },
+
+  // 12. Bilibili
+  {
+    id: 'bilibili_stream',
+    title: 'Bilibili Tech Video',
+    description: 'Search and play an AI Agent tutorial video on Bilibili',
+    goal: 'Open Bilibili, search for "AI Agent Architecture", and play the top matching video.',
+    profile: 'flash',
+    category: 'flash',
+    tag: 'Bilibili',
+    apps: [{ name: 'Bilibili', icon: 'video_library', pkg: 'tv.danmaku.bili' }],
+    requiredPackages: ['tv.danmaku.bili'],
+    priority: 85
+  },
+
+  // 13. Play Store
+  {
+    id: 'pro_playstore_review',
+    title: 'Play Store App Review Study',
+    description: 'Compare top task management apps and ratings on Google Play',
+    goal: 'Open Google Play Store, search for top rated task management apps, compare ratings and latest user reviews of the top 2 candidates, and record recommendations.',
+    profile: 'pro',
+    category: 'pro',
+    tag: 'Play Store',
+    apps: [{ name: 'Play Store', icon: 'storefront', pkg: 'com.android.vending' }],
+    requiredPackages: ['com.android.vending'],
+    priority: 88
+  }
+];

package/artemis-main/apps/showcase_ui/src/app/core/i18n/language.service.spec.ts

@@ -0,0 +1,55 @@
+import { DOCUMENT } from '@angular/common';
+import { TestBed } from '@angular/core/testing';
+import { LanguageService, LANGUAGE_STORAGE_KEY } from './language.service';
+import { TranslatePipe } from './translate.pipe';
+
+describe('UI language', () => {
+  let storage: Map<string, string>;
+  let documentStub: { documentElement: { lang: string }; defaultView: { localStorage: { getItem: jasmine.Spy; setItem: jasmine.Spy } } };
+
+  beforeEach(() => {
+    storage = new Map();
+    documentStub = {
+      documentElement: { lang: '' },
+      defaultView: { localStorage: {
+        getItem: jasmine.createSpy().and.callFake((key: string) => storage.get(key) ?? null),
+        setItem: jasmine.createSpy().and.callFake((key: string, value: string) => storage.set(key, value))
+      } }
+    };
+    TestBed.configureTestingModule({ providers: [{ provide: DOCUMENT, useValue: documentStub }] });
+  });
+
+  it('defaults to Chinese and switches an existing pipe without changing input text', () => {
+    const service = TestBed.inject(LanguageService);
+    const pipe = TestBed.runInInjectionContext(() => new TranslatePipe());
+    expect(pipe.transform('Recommended Tasks')).toBe('推荐任务');
+    service.setLanguage('en');
+    expect(pipe.transform('Recommended Tasks')).toBe('Recommended Tasks');
+    expect(documentStub.documentElement.lang).toBe('en');
+    expect(storage.get(LANGUAGE_STORAGE_KEY)).toBe('en');
+  });
+
+  it('restores the saved English preference', () => {
+    storage.set(LANGUAGE_STORAGE_KEY, 'en');
+    expect(TestBed.inject(LanguageService).language()).toBe('en');
+  });
+
+  it('works when storage access is blocked', () => {
+    documentStub.defaultView.localStorage.getItem.and.throwError('blocked');
+    documentStub.defaultView.localStorage.setItem.and.throwError('blocked');
+    const service = TestBed.inject(LanguageService);
+    expect(service.language()).toBe('zh');
+    expect(() => service.setLanguage('en')).not.toThrow();
+    expect(service.translate('Workspace')).toBe('Workspace');
+  });
+
+  it('preserves unknown text, identifiers and English whitespace', () => {
+    const service = TestBed.inject(LanguageService);
+    expect(service.translate('855ef847 / gemini-3.8-flash')).toBe('855ef847 / gemini-3.8-flash');
+    expect(service.translate('Custom server error: foo')).toBe('Custom server error: foo');
+    expect(service.translate('Python 3.12.14 Ready')).toBe('Python 3.12.14 已就绪');
+    expect(service.translate(' Workspace ')).toBe(' 工作区 ');
+    service.setLanguage('en');
+    expect(service.translate(' Workspace ')).toBe(' Workspace ');
+  });
+});

package/artemis-main/apps/showcase_ui/src/app/core/i18n/language.service.ts

@@ -0,0 +1,61 @@
+import { DOCUMENT } from '@angular/common';
+import { inject, Injectable, signal } from '@angular/core';
+import { ZH_CN } from './zh-cn';
+
+export type UiLanguage = 'zh' | 'en';
+export const LANGUAGE_STORAGE_KEY = 'artemis.ui.language';
+
+/** UI copy only: task text, model output and device identifiers stay untouched. */
+@Injectable({ providedIn: 'root' })
+export class LanguageService {
+  private readonly document = inject(DOCUMENT);
+  private readonly current = signal<UiLanguage>(this.readPreference());
+  readonly language = this.current.asReadonly();
+
+  constructor() {
+    this.updateDocument();
+  }
+
+  setLanguage(language: UiLanguage): void {
+    this.current.set(language);
+    this.updateDocument();
+    try {
+      this.document.defaultView?.localStorage.setItem(LANGUAGE_STORAGE_KEY, language);
+    } catch {
+      // The switch still works if the browser disallows persistent storage.
+    }
+  }
+
+  translate(value: string | null | undefined): string {
+    if (!value) return '';
+    if (this.language() === 'en') return value;
+    const key = value.replace(/\s+/g, ' ').trim();
+    const translated = ZH_CN[key];
+    if (translated === undefined) {
+      // Known diagnostic templates preserve variable identifiers verbatim.
+      return value
+        .replace(/^Python ([\d.]+) Ready$/, 'Python $1 已就绪')
+        .replace(/^Python ([\d.]+) Unsupported$/, 'Python $1 不受支持')
+        .replace(/^(\d+) failed$/, '$1 项失败')
+        .replace(/^Stop current task: /, '停止当前任务：')
+        .replace(/^Stop current task \((.+)\)$/, '停止当前任务（$1）')
+        .replace(/^ADB connected to (.+), but the Android lock screen is active\. Unlock the device and enter the home screen before running a task\.$/,
+          'ADB 已连接到 $1，但设备处于锁屏状态。请解锁并进入主屏幕后再运行任务。')
+        .replace(/^ADB connected to (.+), but Android lock-screen state could not be verified\. Keep the device unlocked on the home screen and check again\.$/,
+          'ADB 已连接到 $1，但无法确认锁屏状态。请保持设备解锁并停留在主屏幕，然后再次检查。');
+    }
+    return value.match(/^\s*/)?.[0] + translated + value.match(/\s*$/)?.[0];
+  }
+
+  private readPreference(): UiLanguage {
+    try {
+      return this.document.defaultView?.localStorage.getItem(LANGUAGE_STORAGE_KEY) === 'en' ? 'en' : 'zh';
+    } catch {
+      return 'zh';
+    }
+  }
+
+  private updateDocument(): void {
+    this.document.documentElement.lang = this.language() === 'zh' ? 'zh-CN' : 'en';
+  }
+}

package/artemis-main/apps/showcase_ui/src/app/core/i18n/translate.pipe.ts

@@ -0,0 +1,11 @@
+import { inject, Pipe, PipeTransform } from '@angular/core';
+import { LanguageService } from './language.service';
+
+@Pipe({ name: 't', standalone: true, pure: false })
+export class TranslatePipe implements PipeTransform {
+  private readonly language = inject(LanguageService);
+
+  transform(value: string | null | undefined): string {
+    return this.language.translate(value);
+  }
+}