drissionpage-dev

分类: 工具与效率 | 上传者: fqxue | 下载: 0 | 版本: v1.0（最新）

更新日志: Source: GitHub https://github.com/fqxue/drissionpage-skills

目录结构

当前层级: skills/drissionpage-dev/

📁 agents/
- 📄 openai.yaml 379 B
📁 references/
- 📁 docs_en/
  - 📁 demos/
    
    📄 douban_book_pics.md 1.5 KB
    
    📄 login_gitee.md 1.4 KB
    
    📄 maoyan_TOP100.md 2.3 KB
    
    📄 multithreading_with_tabs.md 3.2 KB
    
    📄 starbucks_pics.md 2.9 KB
  - 📁 features/
    
    📁 features_demos/
    
    📄 switch_mode.md 775 B
  - 📁 get_elements/
    
    📄 introduction.md 4.7 KB
    
    📄 not_found.md 2.9 KB
    
    📄 usage.md 31.1 KB
  - 📁 get_start/
    
    📁 examples/
    
    📄 control_browser.md 3.0 KB
    
    📄 data_packets.md 3.2 KB
    
    📄 switch_mode.md 4.0 KB
    
    📄 basic_concept.md 13.3 KB
    
    📄 before_start.md 3.7 KB
    
    📄 import.md 3.3 KB
  - 📄 usage_introduction.md 3.7 KB
- 📁 docs_zh/
  - 📁 SessionPage/
    
    📄 README.md 506 B
    
    📄 🛩️ 创建页面对象.md 3.4 KB
    
    📄 🛩️ 启动配置.md 10.9 KB
    
    📄 🛩️ 查找元素.md 11.5 KB
    
    📄 🛩️ 概述.md 1.4 KB
    
    📄 🛩️ 获取元素信息.md 6.6 KB
    
    📄 🛩️ 获取页面信息.md 3.7 KB
    
    📄 🛩️ 访问网页.md 6.6 KB
    
    📄 🛩️ 页面设置.md 6.7 KB
  - 📁 下载文件/
    
    📄 README.md 210 B
    
    📄 ⤵️ download方法.md 6.2 KB
    
    📄 ⤵️ 概述.md 1.7 KB
    
    📄 ⤵️ 浏览器下载.md 10.6 KB
  - 📁 入门指南/
    
    📄 README.md 514 B
    
    📄 ☀️ 基本概念.md 7.4 KB
    
    📄 ❓ 常见问题.md 3.5 KB
    
    📄 🌏 准备工作.md 3.0 KB
    
    📄 🌏 安装.md 572 B
    
    📄 🌏 导入.md 3.9 KB
    
    📄 🌏 设置语言 _ Set Language.md 406 B
    
    📄 🗺️ 收发数据包.md 3.0 KB
    
    📄 🗺️ 模式切换.md 3.1 KB
    
    📄 🗺️ 自动登录.md 2.8 KB
  - 📁 控制浏览器/
    
    📄 README.md 1.8 KB
    
    📄 🌐 连接 TgeBrowser 指纹浏览器.md 11.2 KB
    
    📄 🔦 在结果列表中筛选.md 17.3 KB
    
    📄 🔦 定位语法.md 11.7 KB
    
    📄 🔦 概述.md 2.8 KB
    
    📄 🔦 相对定位.md 16.5 KB
    
    📄 🔦 简化写法.md 2.2 KB
    
    📄 🔦 行为模式.md 4.0 KB
    
    📄 🔦 语法速查表.md 8.1 KB
    
    📄 🔦 页面或元素内查找.md 13.6 KB
    
    📄 🛰️ iframe 操作.md 5.0 KB
    
    📄 🛰️ Page 对象.md 2.3 KB
    
    📄 🛰️ 上传文件.md 3.7 KB
    
    📄 🛰️ 元素交互.md 24.6 KB
    
    📄 🛰️ 动作链.md 14.8 KB
    
    📄 🛰️ 截图和录像.md 6.0 KB
    
    📄 🛰️ 标签页管理.md 5.6 KB
    
    📄 🛰️ 概述.md 3.3 KB
    
    📄 🛰️ 模式切换.md 3.1 KB
    
    📄 🛰️ 浏览器启动设置.md 23.3 KB
    
    📄 🛰️ 浏览器对象.md 15.2 KB
    
    📄 🛰️ 监听网络数据.md 10.5 KB
    
    📄 🛰️ 等待.md 20.3 KB
    
    📄 🛰️ 获取元素信息.md 12.1 KB
    
    📄 🛰️ 获取控制台信息.md 2.7 KB
    
    📄 🛰️ 获取网页信息.md 7.7 KB
    
    📄 🛰️ 访问网页.md 7.4 KB
    
    📄 🛰️ 连接浏览器.md 13.4 KB
    
    📄 🛰️ 页面交互.md 24.9 KB
    
    📄 🥦 创建全新的浏览器.md 2.0 KB
    
    📄 🥦 无头模式.md 526 B
    
    📄 🥦 浏览器多开.md 1.7 KB
    
    📄 🥦 设置 cookies.md 2.7 KB
  - 📁 特性与示例/
    
    📄 README.md 527 B
    
    📄 ⭐ 下载文件.md 385 B
    
    📄 ⭐ 与 requests 对比.md 1.2 KB
    
    📄 ⭐ 与 selenium 对比.md 2.3 KB
    
    📄 ⭐ 模式切换.md 782 B
    
    📄 ⭐ 获取元素属性.md 700 B
    
    📄 💖 特性.md 4.4 KB
    
    📄 💥 3.2 功能介绍.md 11.7 KB
    
    📄 💥 4.0 功能介绍.md 26.1 KB
    
    📄 💥 4.1 功能介绍.md 4.5 KB
  - 📁 进阶使用/
    
    📄 README.md 533 B
    
    📄 ⚙️ 与其它项目对接.md 1.9 KB
    
    📄 ⚙️ 全局设置.md 3.7 KB
    
    📄 ⚙️ 命令行的使用.md 1.6 KB
    
    📄 ⚙️ 实用工具.md 3.3 KB
    
    📄 ⚙️ 异常的使用.md 2.0 KB
    
    📄 ⚙️ 打包程序.md 3.2 KB
    
    📄 ⚙️ 数据读取加速.md 3.2 KB
    
    📄 ⚙️ 配置文件的使用.md 4.5 KB
  - 📄 index.json 16.0 KB
  - 📄 README.md 699 B
- 📄 architecture.md 3.2 KB
- 📄 bundled-materials.md 3.2 KB
- 📄 chrome-devtools-mcp.md 3.0 KB
- 📄 docs-map.md 4.1 KB
📄 SKILL.md 5.5 KB

SKILL.md

---
name: drissionpage-dev
description: >-
  针对 DrissionPage 仓库进行源码阅读、功能修改、调试、示例编写、文档对照和兼容性修复。
  Trigger: tasks mention DrissionPage, ChromiumPage, SessionPage, WebPage,
  ChromiumOptions, SessionOptions, locator 语法, dp CLI, dp_configs.ini,
  docs_en, docs_zh, `.pyi` 类型声明，或要求基于仓库源码/文档实现新功能、
  修复行为、核对 API、补文档示例。
---

# DrissionPage Dev

## 参考优先级

编写代码时，按以下优先级查阅参考资料：

1. **示例 / Demo 优先**：先查 `references/docs_en/demos/` 和 `references/docs_en/get_start/examples/`，复用已验证的写法和调用链。
2. **中文文档其次**：示例不足时，查阅 `references/docs_zh/`（入门指南、控制浏览器、SessionPage、下载文件、进阶使用、特性与示例）获取详细说明和参数语义。
3. **英文文档补充**：中文文档未覆盖或需要对照时，再查 `references/docs_en/` 的其余文件。

## 快速流程

1. 先判断改动落点，再读取最小必要文件。
- 页面对象与模式切换：读 `references/architecture.md`，再看 `DrissionPage/_pages/`。
- 元素定位与解析：看 `DrissionPage/_functions/locator.py`、`DrissionPage/_elements/`，必要时对照 `references/docs_zh/控制浏览器/` 和 `references/docs_en/get_elements/`。
- 浏览器启动、配置和 CLI：看 `DrissionPage/_configs/`、`DrissionPage/_functions/tools.py`、`DrissionPage/_functions/cli.py`。
- 对外行为和示例：优先读取 skill 内已复制的示例和 `references/docs_zh/`，再用 `references/docs_en/` 补充，不要依赖 skill 外部文档路径。

2. 以源码为准，用 `references/docs_zh/` 和 `references/docs_en/` 核对公开行为、参数语义和示例。

3. 公开 API 一旦变化，同步检查这些位置。
- 对应模块的 `.pyi`
- `DrissionPage/__init__.py` 和 `DrissionPage/__init__.pyi`
- 受影响的 `references/docs_zh/` 和 `references/docs_en/` 示例或说明

4. 如果用户没有特别指定参考来源，优先从 `references/docs_en/demos/` 和 `references/docs_en/get_start/examples/` 提取代码结构、对象选型和调用顺序；其次从 `references/docs_zh/` 获取详细用法和参数说明；再落到源码实现核对细节。

5. 保持改动局部化，优先延续现有分层和命名，不随意重排内部 `_` 模块职责。

## 仓库内规则

- 优先使用中文编写新增注释、说明性示例注释和打印日志；只有当周围文件明确采用英文且保持一致更重要时，才跟随英文。
- 保持 4 空格缩进、UTF-8 源文件、`PascalCase` 类名、`snake_case` 方法名。
- 不要把 `ChromiumPage`、`SessionPage`、`WebPage` 的职责混淆：
  `ChromiumPage` 只负责浏览器控制；
  `SessionPage` 只负责请求/解析；
  `WebPage` 负责 d/s 双模式与 cookie 同步。
- 生成示例代码时，默认先复用 demos 中已经验证过的写法，再按当前任务收缩或扩展，不要无依据自创新调用链。
- 处理配置或安装问题时，优先参考 `setup.py`、`requirements.txt` 和实际代码；仓库内的 `pyproject.toml` 可能只是本地工作区配置，不要直接把它当成发布事实。
- 需要与 `chrome-devtools-mcp` 协作时，优先复用 DrissionPage 的 CDP 能力（`references/docs_zh/控制浏览器/🛰️ 页面交互.md` 中 `cdp()` 方法），并说明当前步骤由 DrissionPage 还是 MCP 执行，避免职责混淆。
- 默认采用“三段式协作”：① DrissionPage 复现并最小化自动化步骤 → ② MCP 做 DevTools 诊断（Network/Performance/Console）→ ③ 回到 DrissionPage 落地修复与回归验证。
- 协作交接时至少包含：目标 URL、最小复现步骤、关键定位信息（selector/请求名）、期望与实际差异、错误文本；减少在 DrissionPage 与 MCP 之间重复试错。

## 验证方式

- 本仓库当前没有现成测试套件，优先做针对性 smoke test，而不是假设存在完整 CI。
- 常用验证命令：

```bash
python -m pip install -e .
python -m build
python -c "from DrissionPage import ChromiumPage, SessionPage, WebPage; print(WebPage)"
dp --configs-to-here
```

- 涉及浏览器行为时，补一个最小可复现场景，明确浏览器路径、端口、配置文件或本地环境前提。
- 如果源码行为与 `references/docs_zh/` 或 `references/docs_en/` 中的副本不一致，优先指出差异；若仓库内原始文档也存在，再决定是否同步修正文档。

## 参考文件

- `references/architecture.md`
  用于快速了解包结构、三大 Page 对象关系、配置/CLI 入口、以及改 API 时的联动点。
- `references/docs-map.md`
  用于把任务快速映射到已复制进 skill 的文档副本，并给出常见改动的执行顺序。
- `references/bundled-materials.md`
  列出已复制到 skill 内的资料清单，便于脱离仓库单独上传时核对。
- `references/chrome-devtools-mcp.md`
  Chrome DevTools MCP 与 DrissionPage 的协作与接入说明，含最小接入清单。
- `references/docs_en/`
  保存从当前仓库复制进来的英文文档资料。默认优先查 `demos/`，其次查 `get_start/`、`get_elements/` 和 `features/features_demos/`。
- `references/docs_zh/`
  保存从 DrissionPage 中文站点整理的完整中文文档。包含入门指南、控制浏览器、SessionPage、下载文件、进阶使用、特性与示例六大板块。优先级高于 `docs_en/`（示例除外）。

登录后下载/点赞/收藏 ❤ 2 | ★ 0

drissionpage-dev

目录结构

SKILL.md

举报内容

提示