docs: elevate banner tagline to Autonomous Assistant Platform and update renders
This commit is contained in:
1 parent
46e1e8b935
commit
1899c68bb8
7 files changed
+33
-8
No files matched your search
@@ -1,5 +1,5 @@
|
|||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="./docs/assets/artemis-banner.png?v=3" alt="ARTEMIS Banner" width="100%" />
|
<img src="./docs/assets/artemis-banner.png?v=4" alt="ARTEMIS Banner" width="100%" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
@@ -146,7 +146,19 @@ artemis mcp --generate-config all
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. Prompt Your Phone in the IDE Chat
|
### 3. Mount Behavioral Rules for AI Agents (Highly Recommended)
|
||||||
|
|
||||||
|
To ensure your AI coding assistant acts with the rigor of a senior mobile test engineer and never hallucinates UI interactions, we provide a dedicated testing mindset rules file at [`mcp_server/rules.md`](./mcp_server/rules.md) (covering **Active Exploration before coding**, **Flash vs. Pro routing strategy**, **Latency & Timing compensation**, and the **"Dynamic-First, Coordinate-Fallback" locator pattern**).
|
||||||
|
|
||||||
|
You can mount or copy [`mcp_server/rules.md`](./mcp_server/rules.md) into your AI IDE's rule configuration:
|
||||||
|
* **Antigravity**: Add the contents of `rules.md` to your Workspace Rules, Global Rules settings, or agent instructions.
|
||||||
|
* **Claude Code**: Copy or include the contents of `rules.md` in your project's `CLAUDE.md` file.
|
||||||
|
* **Cursor**: Copy the contents into `.cursorrules` or create a rule file at `.cursor/rules/artemis.mdc`.
|
||||||
|
* **Windsurf / OpenClaw**: Add the rules to your workspace rules or global system prompts.
|
||||||
|
|
||||||
|
> 💡 For more details on the testing mindset and MCP architecture, see the [MCP Server README](./mcp_server/README.md).
|
||||||
|
|
||||||
|
### 4. Prompt Your Phone in the IDE Chat
|
||||||
In Antigravity or Claude Code, simply prompt:
|
In Antigravity or Claude Code, simply prompt:
|
||||||
> 💬 *"Build the latest changes into an APK, install it on the connected device, open the login screen with a test account, verify if there are any unexpected popups after login, and return screenshots of the final page."*
|
> 💬 *"Build the latest changes into an APK, install it on the connected device, open the login screen with a test account, verify if there are any unexpected popups after login, and return screenshots of the final page."*
|
||||||
|
|
||||||
|
|||||||
+14
-2
@@ -1,5 +1,5 @@
|
|||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="./docs/assets/artemis-banner-cn.png?v=3" alt="ARTEMIS Banner" width="100%" />
|
<img src="./docs/assets/artemis-banner-cn.png?v=4" alt="ARTEMIS Banner" width="100%" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
@@ -148,7 +148,19 @@ artemis mcp --generate-config all
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. 在 IDE 中体验真机协同
|
### 3. 挂载智能体行为规范 Rules(强烈推荐)
|
||||||
|
|
||||||
|
为使 AI 编程助手具备资深移动端测试工程师的严谨思维,避免凭空臆测 UI 交互,我们提供了专属的测试思维行为规范文件 [`mcp_server/rules.md`](./mcp_server/rules.md)(涵盖**可运行代码原则与真机探索**、**Flash 与 Pro 任务路由策略**、**延迟与时间补偿机制**以及**“动态优先、坐标兜底”定位模式**)。
|
||||||
|
|
||||||
|
你可以将 [`mcp_server/rules.md`](./mcp_server/rules.md) 挂载或复制到你的 AI IDE 规则配置中:
|
||||||
|
* **Antigravity**:将 `rules.md` 内容添加至工作区规则(Workspace Rules)或全局规则设置中。
|
||||||
|
* **Claude Code**:将 `rules.md` 内容复制或引入至项目根目录的 `CLAUDE.md` 文件中。
|
||||||
|
* **Cursor**:将内容复制到 `.cursorrules` 文件或在 `.cursor/rules/artemis.mdc` 中创建新规则。
|
||||||
|
* **Windsurf / OpenClaw**:将内容添加到工作区规则或全局 System Prompt 中。
|
||||||
|
|
||||||
|
> 💡 更多规范设计细节与 MCP 架构说明,请参阅 [MCP Server 文档](./mcp_server/README.md)。
|
||||||
|
|
||||||
|
### 4. 在 IDE 中体验真机协同
|
||||||
在 Antigravity / Claude Code 对话框中直接输入:
|
在 Antigravity / Claude Code 对话框中直接输入:
|
||||||
> 💬 *"请帮我把刚刚修改的代码编译成 APK 并安装到手机上,打开登录页面输入测试账号,验证登录后是否有异常弹窗,并把最终页面截图回传。"*
|
> 💬 *"请帮我把刚刚修改的代码编译成 APK 并安装到手机上,打开登录页面输入测试账号,验证登录后是否有异常弹窗,并把最终页面截图回传。"*
|
||||||
|
|
||||||
|
|||||||
Binary file not shown.
|
Before Width: | Height: | Size: 205 KiB After Width: | Height: | Size: 211 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 204 KiB After Width: | Height: | Size: 207 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 204 KiB After Width: | Height: | Size: 207 KiB |
@@ -842,7 +842,7 @@ def create_banner_html(lang="en"):
|
|||||||
"""
|
"""
|
||||||
if lang == "cn":
|
if lang == "cn":
|
||||||
replacements = {
|
replacements = {
|
||||||
"__TAGLINE__": "用 <span>自主 AI</span> 测试任意安卓手机",
|
"__TAGLINE__": "用 <span>Autonomous Assistant Platform</span> 测试任意安卓手机",
|
||||||
"__PROMPT_LABEL__": "目标 / 提示词",
|
"__PROMPT_LABEL__": "目标 / 提示词",
|
||||||
"__PROMPT_STATUS__": "设备实机运行中",
|
"__PROMPT_STATUS__": "设备实机运行中",
|
||||||
"__PROMPT_TEXT__": "连接蓝牙耳机播放歌曲,并持续采集 CPU 性能指标",
|
"__PROMPT_TEXT__": "连接蓝牙耳机播放歌曲,并持续采集 CPU 性能指标",
|
||||||
@@ -868,7 +868,7 @@ def create_banner_html(lang="en"):
|
|||||||
}
|
}
|
||||||
else:
|
else:
|
||||||
replacements = {
|
replacements = {
|
||||||
"__TAGLINE__": "Test Any Android Phone with <span>Autonomous AI</span>",
|
"__TAGLINE__": "Test Any Android Phone with <span>Autonomous Assistant Platform</span>",
|
||||||
"__PROMPT_LABEL__": "Goal / Prompt",
|
"__PROMPT_LABEL__": "Goal / Prompt",
|
||||||
"__PROMPT_STATUS__": "RUNNING ON DEVICE",
|
"__PROMPT_STATUS__": "RUNNING ON DEVICE",
|
||||||
"__PROMPT_TEXT__": "Connect to Bluetooth earbuds, play a song, and capture CPU usage metrics",
|
"__PROMPT_TEXT__": "Connect to Bluetooth earbuds, play a song, and capture CPU usage metrics",
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# 🔌 Universal MCP Server for ARTEMIS
|
# 🔌 Universal MCP Server for ARTEMIS
|
||||||
|
|
||||||
This directory contains the universal **Model Context Protocol (MCP)** server for **ARTEMIS**, enabling seamless mobile device automation inside AI IDEs and agents like **Cursor**, **Claude Code**, **OpenClaw**, **Windsurf**, and **Jetski**.
|
This directory contains the universal **Model Context Protocol (MCP)** server for **ARTEMIS**, enabling seamless mobile device automation inside AI IDEs and agents like **Antigravity**, **Cursor**, **Claude Code**, **OpenClaw**, and **Windsurf**.
|
||||||
|
|
||||||
## 🏗️ Architecture
|
## 🏗️ Architecture
|
||||||
|
|
||||||
@@ -32,7 +32,7 @@ mcp_server/
|
|||||||
|
|
||||||
## 🧠 AI Agent Behavioral Rules (`rules.md`)
|
## 🧠 AI Agent Behavioral Rules (`rules.md`)
|
||||||
|
|
||||||
When connecting ARTEMIS to AI coding assistants like **Claude Code**, **Cursor**, or **Windsurf**, providing the assistant with domain-specific testing discipline is critical for generating reliable test code.
|
When connecting ARTEMIS to AI coding assistants like **Antigravity**, **Claude Code**, **Cursor**, or **Windsurf**, providing the assistant with domain-specific testing discipline is critical for generating reliable test code.
|
||||||
|
|
||||||
The included [`rules.md`](./rules.md) file contains the **Mobile Testing Mindset (ARTEMIS Integration)** guideline. It teaches the AI agent how to properly collaborate with ARTEMIS:
|
The included [`rules.md`](./rules.md) file contains the **Mobile Testing Mindset (ARTEMIS Integration)** guideline. It teaches the AI agent how to properly collaborate with ARTEMIS:
|
||||||
|
|
||||||
@@ -42,6 +42,7 @@ The included [`rules.md`](./rules.md) file contains the **Mobile Testing Mindset
|
|||||||
4. **"Dynamic-First, Coordinate-Fallback" Locator Pattern**: Teaches the AI to prioritize dynamic UI locators (Resource IDs, OCR text, semantics) for layout resilience, while implementing absolute coordinate fallbacks for maximum execution reliability.
|
4. **"Dynamic-First, Coordinate-Fallback" Locator Pattern**: Teaches the AI to prioritize dynamic UI locators (Resource IDs, OCR text, semantics) for layout resilience, while implementing absolute coordinate fallbacks for maximum execution reliability.
|
||||||
|
|
||||||
### How to Apply `rules.md` in Your IDE
|
### How to Apply `rules.md` in Your IDE
|
||||||
|
* **Antigravity**: Add or copy the contents of `rules.md` into your Workspace Rules, Global Rules settings, or agent instructions.
|
||||||
* **Claude Code**: Copy or include the contents of `rules.md` in your project's `CLAUDE.md` file (or reference it directly in your instructions).
|
* **Claude Code**: Copy or include the contents of `rules.md` in your project's `CLAUDE.md` file (or reference it directly in your instructions).
|
||||||
* **Cursor**: Copy the contents of `rules.md` into your `.cursorrules` or create a new rule file in `.cursor/rules/artemis.mdc`.
|
* **Cursor**: Copy the contents of `rules.md` into your `.cursorrules` or create a new rule file in `.cursor/rules/artemis.mdc`.
|
||||||
* **Windsurf / OpenClaw**: Add the rules to your global/workspace rules or agent system prompts so the assistant always follows verified mobile testing principles.
|
* **Windsurf / OpenClaw**: Add the rules to your global/workspace rules or agent system prompts so the assistant always follows verified mobile testing principles.
|
||||||
|
|||||||
Reference in new issue
Block a user