by 详细分析 ▾
运行时依赖
版本
Initial release of lightcone-session for manual, step-by-step cloud computer control. - Provides a workflow for creating, controlling, and closing cloud browser/desktop sessions. - Supports granular actions: click, type, hotkey, navigate, screenshot, extract HTML, and more. - Designed for complex, multi-step tasks like logins and interactive automation. - Includes examples and tips for precise, repeatable workflows. - User-invocable with environment variable requirements documented.
安装命令 点击复制
技能文档
Three tools for manual step-by-step control of a cloud computer. Use when you need precise multi-step interaction with a website or desktop application.
For simple "go do this" tasks, prefer lightcone-browse (the /lightcone-browse command) instead.
Tools
| Tool | Purpose |
|---|---|
lightcone_session_create | Create a cloud computer (browser or desktop) |
lightcone_session_action | Send actions (click, type, scroll, screenshot, etc.) |
lightcone_session_close | Shut down the computer |
Workflow Pattern
1. lightcone_session_create → get session ID + initial screenshot
- lightcone_session_action → navigate, click, type, screenshot (repeat)
- lightcone_session_close → shut down
lightcone_session_create
| Parameter | Required | Description |
|---|---|---|
url | No | URL to navigate to immediately |
kind | No | "browser" (default) or "desktop" |
lc-a1b2c3d4) + screenshot of initial state.lightcone_session_action
| Parameter | Required | Description |
|---|---|---|
sessionId | Yes | Session ID from create |
action | Yes | One of the actions below |
url | For navigate | Target URL |
x, y | For click/scroll | Pixel coordinates |
text | For type | Text to enter |
keys | For hotkey | Comma-separated keys, e.g. "Control,c" |
dx, dy | For scroll | Scroll deltas |
seconds | For wait | Duration in seconds |
command | For debug | Shell command to run |
Actions
| Action | Returns | Use for |
|---|---|---|
screenshot | Screenshot | See current state |
navigate | Screenshot | Go to a URL |
click | Screenshot | Click at (x, y) |
doubleClick | Screenshot | Double-click at (x, y) |
rightClick | Screenshot | Right-click for context menu |
type | Screenshot | Enter text at cursor |
hotkey | Screenshot | Keyboard shortcut (e.g., Enter, Tab, Control+a) |
scroll | Screenshot | Scroll at position |
html | Page HTML | Extract page source |
wait | Screenshot | Pause before next action |
debug | Command output | Run shell command in the computer |
示例: 登录 和 extract data
Step 1: Create a cloud computer at the login page
lightcone_session_create { url: "https://app.example.com/login" }Step 2: Type username (click the email field first)
lightcone_session_action { sessionId: "lc-...", action: "click", x: 640, y: 300 }
lightcone_session_action { sessionId: "lc-...", action: "type", text: "user@example.com" }
Step 3: Type password
lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Tab" }
lightcone_session_action { sessionId: "lc-...", action: "type", text: "password123" }
Step 4: Submit
lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Return" }
lightcone_session_action { sessionId: "lc-...", action: "wait", seconds: 3 }
Step 5: Screenshot to verify login succeeded
lightcone_session_action { sessionId: "lc-...", action: "screenshot" }
Step 6: Extract page content
lightcone_session_action { sessionId: "lc-...", action: "html" }
Step 7: Shut down
lightcone_session_close { sessionId: "lc-..." }
Tips
- Always take screenshot 之后 导航 到 see current state 之前 clicking
- 使用 coordinates 从 screenshot 到 target clicks accurately
- Wait 2-3 seconds 之后 导航 或 表单 submission 对于 pages 到 加载
- 使用
htmlaction 到 extract structured data 从 page - Always 关闭 sessions 当...时 已完成 到 free resources
免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制