From 9b603d90ba54dfc14a742b562cddeb902a17b2fb Mon Sep 17 00:00:00 2001 From: Simon <10131203+gaomeng1900@users.noreply.github.com> Date: Sat, 14 Feb 2026 16:23:34 +0800 Subject: [PATCH] docs: update limitations page --- .../docs/introduction/limitations/page.tsx | 280 ++++++++---------- 1 file changed, 121 insertions(+), 159 deletions(-) diff --git a/packages/website/src/pages/docs/introduction/limitations/page.tsx b/packages/website/src/pages/docs/introduction/limitations/page.tsx index 665091d..ac6ebf2 100644 --- a/packages/website/src/pages/docs/introduction/limitations/page.tsx +++ b/packages/website/src/pages/docs/introduction/limitations/page.tsx @@ -1,3 +1,5 @@ +import { Link } from 'wouter' + import { useLanguage } from '@/i18n/context' export default function LimitationsPage() { @@ -11,184 +13,144 @@ export default function LimitationsPage() {

{isZh - ? '了解 page-agent 当前的功能边界和技术限制' - : "Understand page-agent's current capabilities and technical constraints"} + ? 'Page Agent 基于 DOM 理解网页并执行操作。这决定了它的能力边界。' + : 'Page Agent understands web pages via DOM and performs actions accordingly. This defines its capability boundary.'}

+ {/* PageAgent.js vs PageAgentExt */}

- {isZh ? '页面支持限制' : 'Page Support Limitations'} + {isZh ? 'PageAgent.js vs PageAgentExt' : 'PageAgent.js vs PageAgentExt'}

-
-

- {isZh ? '单页应用限制' : 'Single Page Application Limits'} -

- +

+ {isZh + ? 'PageAgent.js 是核心库，运行在页面内。PageAgentExt 是可选的浏览器扩展，提供额外的浏览器级控制能力。' + : 'PageAgent.js is the core library running inside a page. PageAgentExt is an optional browser extension that adds browser-level control.'} +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + +
PageAgent.js + PageAgentExt{' '} + + {isZh ? '了解更多' : 'learn more'} + +
+ {isZh ? '接入方式' : 'Integration'} + + {isZh ? '网站开发者主动集成' : 'Site developer integrates the library'} + + {isZh ? '用户安装浏览器扩展' : 'User installs a browser extension'} +
+ {isZh ? '可操作范围' : 'Scope'} + + {isZh ? '当前页面（为 SPA 设计）' : 'Current page (designed for SPAs)'} + + {isZh ? '任意网页、多标签页' : 'Any web page, multi-tab'} +
+ {isZh ? '额外能力' : 'Extra capabilities'} + — + {isZh ? '新建/切换/关闭标签页' : 'Open / switch / close tabs'} +
+ {/* Interaction Limitations */}

- {isZh ? '交互行为限制' : 'Interaction Limitations'} + {isZh ? '交互能力' : 'Interaction Capabilities'}

-

{isZh ? '支持的操作' : 'Supported Operations'}

-
-
-
- ✅ - {isZh ? '点击操作' : 'Click'} -
-
- ✅ - {isZh ? '文本输入' : 'Text input'} -
-
- ✅ - {isZh ? '页面滚动' : 'Scroll'} -
-
- ✅ - {isZh ? '表单提交' : 'Form submit'} -
-
-
-
- ✅ - {isZh ? '选择操作' : 'Select'} -
-
- ✅ - {isZh ? '焦点切换' : 'Focus'} -
-
-
- -

{isZh ? '不支持的操作' : 'Unsupported Operations'}

-
-
-
- ❌ - {isZh ? '鼠标悬停（hover）' : 'Mouse hover'} -
-
- ❌ - {isZh ? '拖拽操作' : 'Drag & drop'} -
-
- ❌ - {isZh ? '右键菜单' : 'Right-click menu'} -
-
-
-
- ❌ - {isZh ? '图形绘制' : 'Drawing'} -
-
- ❌ - {isZh ? '键盘快捷键' : 'Keyboard shortcuts'} -
-
- ❌ - {isZh ? '基于点击区域或鼠标位置的控制' : 'Position-based control'} -
-
-
-
- -

- {isZh ? '网页理解限制' : 'Understanding Limitations'} -

-
-

- {isZh ? '无视觉能力' : 'No Visual Recognition'} -

-

- {isZh - ? 'page-agent 基于 DOM 结构进行理解和操作，没有视觉识别能力，无法理解以下内容：' - : 'page-agent operates based on DOM structure with no visual recognition. Cannot understand:'} -

-
    -
  • - {isZh - ? '• 图片内容：无法识别图片中的文字、图标或视觉元素' - : '• Image content: Cannot recognize text, icons, or visual elements in images'} -
    • -
  • - {isZh - ? '• Canvas 画布：无法理解 Canvas 中绘制的图形和内容' - : '• Canvas: Cannot understand graphics drawn on Canvas'} -
    • -
  • - {isZh - ? '• WebGL 3D 内容：无法操作 3D 场景中的元素' - : '• WebGL 3D: Cannot operate elements in 3D scenes'} -
    • -
  • - {isZh - ? '• SVG 图形：无法理解 SVG 中的视觉内容和路径' - : '• SVG graphics: Cannot understand visual content and paths in SVG'} -
    • -
-
- -

- {isZh ? '被操作网站要求' : 'Website Requirements'} -

-
-
+
-

- {isZh ? '语义化和易用性' : 'Semantic & Usability'} +

+ {isZh ? '支持' : 'Supported'}

-

- {isZh - ? '所有操作都基于 DOM 元素的语义化标签和属性。如果页面结构不够语义化，或者没有任何 accessibility 特性，可能影响 AI 的理解准确性。' - : 'All operations rely on semantic tags and attributes. Poor semantic structure or lack of accessibility features may affect AI understanding accuracy.'} -

+
    + {[ + isZh ? '点击、文本输入、选择' : 'Click, text input, select', + isZh ? '页面滚动（垂直 / 水平）' : 'Scroll (vertical / horizontal)', + isZh ? '表单提交、焦点切换' : 'Form submit, focus', + isZh ? '执行 JavaScript（可选）' : 'Execute JavaScript (opt-in)', + ].map((text) => ( +
  • + ✓ + {text} +
    • + ))} +
-

{isZh ? 'UI/UX' : 'UI/UX'}

-

- {isZh - ? '反常识的交互规则、基于视觉的操作提示、复杂的鼠标交互、快速出现快速消失的元素等，都会影响 AI 的理解和操作。' - : 'Counter-intuitive interaction rules, visual-only operation hints, complex mouse interactions, or rapidly appearing/disappearing elements can affect AI understanding and operation.'} -

-
-
-

{isZh ? '环境要求' : 'Environment'}

-

modern browser

+

+ {isZh ? '不支持' : 'Not supported'} +

+
    + {[ + isZh ? '悬停、拖拽、右键菜单' : 'Hover, drag & drop, right-click', + isZh ? '键盘快捷键' : 'Keyboard shortcuts', + isZh ? '坐标定位操作' : 'Position-based control', + isZh ? '绘图操作' : 'Drawing', + ].map((text) => ( +
  • + ✗ + {text} +
    • + ))} +
-

{isZh ? '未来规划' : 'Future Plans'}

-
-

- {isZh ? '即将支持' : 'Coming Soon'} -

-
    -
  • {isZh ? '• 多页面接力操作能力' : '• Multi-page relay capabilities'}
    • -
  • {isZh ? '• 更丰富的鼠标交互支持' : '• Richer mouse interaction support'}
    • -
  • {isZh ? '• 基础的视觉理解能力' : '• Basic visual understanding'}
    • -
  • {isZh ? '• 更智能的错误恢复机制' : '• Smarter error recovery'}
    • -
+ {/* Understanding Limitations */} +

{isZh ? '理解能力' : 'Understanding'}

+
+

+ {isZh + ? 'Page Agent 不使用多模态模型，不截图，没有视觉能力。仅通过 DOM 结构理解页面。' + : 'Page Agent does not use multimodal models, does not take screenshots, and has no visual capability. It reads pages through DOM structure only.'} +

+

+ {isZh + ? '图片、Canvas、WebGL、SVG 等视觉内容无法被识别。页面的语义化程度和可访问性直接影响 AI 的理解准确性。' + : 'Images, Canvas, WebGL, SVG and other visual content cannot be recognized. Page semantic quality and accessibility directly affect AI accuracy.'} +

+
+ + {/* Website Quality */} +

+ {isZh ? '网页质量影响' : 'Page Quality Matters'} +

+
+

+ {isZh + ? '反常识的交互逻辑、纯视觉的操作提示、快速出现消失的元素等都会降低自动化成功率。语义化的 HTML 和良好的可访问性会显著提升效果。' + : 'Counter-intuitive interactions, visual-only cues, and rapidly appearing/disappearing elements reduce automation success. Semantic HTML and good accessibility significantly improve results.'} +