## っと型副词

| 单词  | 假名  | 解释           | 单词  | 假名  | 解释                   |
| --- | --- | ------------ | --- | --- | -------------------- |
| きっと | きっと | 一定；必然；肯定     | さっき | さっき | 刚才；方才                |
| ざっと | ざっと | 大致；粗略；快速地    | すっと | すっと | 轻快地；顺利地；笔直地          |
| ずっと | ずっと | 一直；始终；更加（比较） | そっと | そっと | 悄悄地；轻轻地；不惊动地         |
| たった | たった | 仅仅；只；不过      | どっと | どっと | 大量涌出；突然一起发出声音；<br>病情突然恶化 |
| もっと | もっと | 更加；进一步       | やっと | やっと | 终于；好不容易；勉强           |



## ABAB形副词

| 单词     | 假名     | 解释             | 单词     | 假名     | 解释             |
| ------ | ------ | -------------- | ------ | ------ | -------------- |
| あちこち   | あちこち   | 到处；各处；这边那边     | いきいき   | いきいき   | 生气勃勃；活泼；栩栩如生   |
| いちいち   | いちいち   | 一个个；逐一；每次都     | いよいよ   | いよいよ   | 终于；越来越；更加；关键时刻 |
| いらいら   | いらいら   | 焦躁；烦躁；坐立不安     | うろうろ   | うろうろ   | 徘徊；转来转去；不知所措   |
| おのおの   | おのおの   | 各自；每个人         | かたがた   | かたがた   | 顺便；兼做某事        |
| しばしば   | しばしば   | 经常；屡次；再三       | じょじょに  | じょじょに  | 逐渐；慢慢地         |
| すきずき   | すきずき   | 各有所好；个人喜好不同    | せいぜい   | せいぜい   | 至多；充其量；尽最大努力   |
| ぞくぞく   | ぞくぞく   | 接连不断；陆续；激动；发冷  | それぞれ   | それぞれ   | 各自；分别；每个       |
| そろそろ   | そろそろ   | 差不多该……；渐渐；慢慢   | たびたび   | たびたび   | 屡次；多次；再三       |
| たまたま   | たまたま   | 偶然；碰巧          | だんだん   | だんだん   | 渐渐；逐渐          |
| ちかぢか   | ちかぢか   | 最近；不久；近期       | つぎつぎに  | つぎつぎに  | 一个接一个；接连不断     |
| でこぼこ   | でこぼこ   | 凹凸不平；不均衡       | てんてん   | てんてん   | 点点分布；散落；辗转     |
| とうとう   | とうとう   | 终于；最终；到头来      | ときどき   | ときどき   | 有时；偶尔          |
| どんどん   | どんどん   | 连续不断；迅速进展；不断增强 | なかなか   | なかなか   | 相当；很；不容易（接否定）  |
| にこにこ   | にこにこ   | 笑眯眯地；开心微笑      | のろのろ   | のろのろ   | 慢吞吞；迟缓         |
| はきはき   | はきはき   | 干脆利落；爽快；表达清楚   | ぴかぴか   | ぴかぴか   | 闪闪发光；崭新；光亮     |
| ひろびろ   | ひろびろ   | 宽广；辽阔；开阔       | ぶつぶつ   | ぶつぶつ   | 嘟囔；抱怨；小颗粒状     |
| ふわふわ   | ふわふわ   | 轻飘飘；柔软；松软      | べつべつ   | べつべつ   | 分开；各自不同        |
| まあまあ   | まあまあ   | 还算；马马虎虎；好了好了   | まごまご   | まごまご   | 手忙脚乱；不知所措      |
| ますます   | ますます   | 越来越；更加         | めいめい   | めいめい   | 各自；每个人         |
| もともと   | もともと   | 原本；本来          | ゆうゆう   | ゆうゆう   | 悠闲自在；轻松；绰绰有余   |
| じゅんじゅん | じゅんじゅん | 按顺序；依次         | しょうしょう | しょうしょう | 稍许；一点          |
| ちゃくちゃく | ちゃくちゃく | 稳步地；顺利地        | ところどころ | ところどころ | 到处；各处；这里那里     |
| めちゃくちゃ | めちゃくちゃ | 乱七八糟；一塌糊涂      |        |        |                |


## ～り型副词

| 单词    | 假名    | 解释                       | 单词     | 假名     | 解释             |
| ----- | ----- | ------------------------ | ------ | ------ | -------------- |
| あまり   | あまり   | 不太……；不怎么……（接否定）；非常（少见用法） | あんまり   | あんまり   | あまり的口语形式       |
| いきなり  | いきなり  | 突然；冷不防                   | うっかり   | うっかり   | 不小心；疏忽；稀里糊涂    |
| がっかり  | がっかり  | 失望；灰心；精疲力竭               | ぎっしり   | ぎっしり   | 挤满；装得满满的       |
| ぐっすり  | ぐっすり  | 熟睡；酣睡                    | こっそり   | こっそり   | 悄悄地；偷偷地        |
| さっぱり  | さっぱり  | 完全不……（接否定）；清爽；痛快         | しっかり   | しっかり   | 牢固地；充分地；认真地    |
| すっかり  | すっかり  | 完全；全部；彻底                 | すっきり   | すっきり   | 舒畅；清爽；通畅       |
| そっくり  | そっくり  | 完全一样；一模一样；全部             | たっぷり   | たっぷり   | 足够；充分；大量       |
| にっこり  | にっこり  | 微笑；莞尔一笑                  | のんびり   | のんびり   | 悠闲；轻松自在        |
| はっきり  | はっきり  | 清楚；明确；直截了当               | ばったり   | ばったり   | 突然倒下；突然中断；偶然相遇 |
| びっくり  | びっくり  | 吃惊；惊讶                    | ぴたり    | ぴたり    | 突然停止；紧紧贴住      |
| ぴったり  | ぴったり  | 恰好；合适；完全一致；紧密贴合          | ぼんやり   | ぼんやり   | 模糊；发呆；无所事事     |
| めっきり  | めっきり  | 明显地；显著地                  | やはり    | やはり    | 仍然；果然；还是       |
| やっぱり  | やっぱり  | やはり的口语形式；果然；还是           | ゆっくり   | ゆっくり   | 慢慢地；充分地；悠闲地    |
| おもいきり | おもいきり | 尽情地；狠狠地；下定决心地            | おもいっきり | おもいっきり | おもいきり的口语写法     |
| つまり   | つまり   | 总之；也就是说；归根结底             | ずらり    | ずらり    | 排成一长排；整齐排列     |

## 一～型副词

| 单词   | 假名        | 解释           | 单词  | 假名    | 解释         |
| ---- | --------- | ------------ | --- | ----- | ---------- |
| 一応   | いちおう      | 大致；暂且；姑且；首先  | 一時  | いちじ   | 一时；暂时；某个时候 |
| 一段と  | いちだんと     | 更加；越发；进一步    | 一度に | いちどに  | 一下子；同时；一次性 |
| 一番   | いちばん      | 最；第一；最……；试试看 | 一部  | いちぶ   | 一部分；部分地    |
| 一種   | いっしゅ      | 一种；某种；稍微（有点） | 一瞬  | いっしゅん | 一瞬间；刹那     |
| 一層   | いっそう      | 更加；越发；进一步    | 一体  | いったい  | 到底；究竟；总的来说 |
| 一斉に  | いっせいに     | 一齐；同时；统一地    | 一般に | いっぱんに | 一般来说；普遍地   |
| 一定   | いってい      | 一定程度；固定；规定   | 一方  | いっぽう  | 另一方面；同时；一直 |
| 一生懸命 | いっしょうけんめい | 拼命地；努力地；竭尽全力 | 万一  | まんいち  | 万一；假如发生意外  |
| 再三   | さいさん      | 屡次；再三；多次     | 第一に | だいいちに | 首先；第一      |

## ～に型副词

| 单词    | 假名    | 解释                    | 单词    | 假名    | 解释               |
| ----- | ----- | --------------------- | ----- | ----- | ---------------- |
| いまに   | いまに   | **不久；早晚；总有一天**        | おもに   | おもに   | **主要；大部分；多半**    |
| げんに   | げんに   | **实际上；确实；现实中**        | さきに   | さきに   | **以前；不久前；提前**    |
| さらに   | さらに   | **更加；进一步；再**；（否定）一点也不 | じかに   | じかに   | **直接地；亲自地**      |
| じつに   | じつに   | **实在；的确；非常**          | すぐに   | すぐに   | **马上；立即；很近**     |
| すでに   | すでに   | **已经；早就**             | たまに   | たまに   | **偶尔；有时**        |
| たんに   | たんに   | **只是；仅仅**             | つねに   | つねに   | **经常；平时；总是**     |
| とくに   | とくに   | **特别；尤其**             | ともに   | ともに   | **一起；共同；同时**     |
| べつに   | べつに   | **另外；特别（接否定：并不）**     | まさに   | まさに   | **正是；确实；完全就是**   |
| わりに   | わりに   | **比较；相对而言；出乎意料地**     | いちどに  | いちどに  | **一次；同时**        |
| おおいに  | おおいに  | **大大地；非常；很**          | かわりに  | かわりに  | **代替；作为补偿；但是**   |
| きゅうに  | きゅうに  | **突然；忽然**             | しきりに  | しきりに  | **频繁地；不断地；强烈地**  |
| しだいに  | しだいに  | **逐渐；渐渐地**            | たしかに  | たしかに  | **确实；的确**        |
| ただちに  | ただちに  | **立即；马上**             | とっくに  | とっくに  | **早已；很久以前就**     |
| とたんに  | とたんに  | **刚一……就……；突然**        | にわかに  | にわかに  | **突然；骤然；马上**     |
| はじめに  | はじめに  | **首先；最初**             | めったに  | めったに  | **很少；几乎不（后接否定）** |
| やたらに  | やたらに  | **随便地；胡乱地；过分地**       | あんなに  | あんなに  | **那么；那样地**       |
| こんなに  | こんなに  | **这么；这样地**            | そんなに  | そんなに  | **那么；那样地**       |
| どんなに  | どんなに  | **多么；无论怎样**           | あきらかに | あきらかに | **明显地；清楚地**      |
| おたがいに | おたがいに | **互相；彼此**             | ひじょうに | ひじょうに | **非常；极其**        |
| ひっしに  | ひっしに  | **拼命地；死命地**           | ひとりでに | ひとりでに | **自动地；自然而然地**    |
| まっさきに | まっさきに | **最先；首先**             | ようするに | ようするに | **总之；简而言之**      |
| わりあいに | わりあいに | **比较；意外地**            |       |       |                  |

## 其他副词

| 单词  | 假名  | 解释                 | 单词  | 假名  | 解释                 |
| --- | --- | ------------------ | --- | --- | ------------------ |
| いわば | いわば | **可以说；所谓；换句话说**    | うんと | うんと | **很多；非常；用力地**      |
| およそ | およそ | **大约；大体**；（否定）完全不  | さすが | さすが | **不愧是；果然；到底还是**    |
| じつは | じつは | **实际上；说实话**        | すべて | すべて | **全部；一切**          |
| せめて | せめて | **至少；最低限度**        | たしか | たしか | **确实；记得大概**        |
| たぶん | たぶん | **大概；恐怕；也许**       | どうか | どうか | **请；务必；设法**        |
| どうせ | どうせ | **反正；无论如何**        | どうも | どうも | **总觉得；似乎；怎么也（否定）** |
| どこか | どこか | **某处；某种程度；总觉得**    | ふだん | ふだん | **平时；平常**          |
| ふつう | ふつう | **一般；通常；普通地**      | ほんの | ほんの | **仅仅；一点点**         |
| まさか | まさか | **万万没想到；难道（后接否定）** | まるで | まるで | **宛如；简直；完全（否定）**   |
| むしろ | むしろ | **反而；倒不如；宁可**      | もしも | もしも | **如果；万一**          |
| やがて | やがて | **不久；过一会儿；最终**     | よけい | よけい | **更加；格外；多余**       |
| わざと | わざと | **故意地；有意地**        | わりと | わりと | **比较；相对来说**        |
|     |     |                    |     |     |                    |

日语N2常用副词总结

# Dify 代码节点调试复盘文档
本文档记录了在 Dify 工作流中配置代码节点（Python）从零到可用的完整历程，包含遇到的问题、原因分析及解决方案，以供后期复盘查看。




## 一、背景
在工作流中，需要将 HTTP 节点返回的考勤 JSON 数据，经过清洗、统计后，生成一份简洁的考勤报告。最初使用 LLM 节点直接处理原始 JSON，存在以下问题：

- 处理速度慢（内部模型耗时 ~30s）
- Token 消耗大（8.6K tokens）
- 输出不稳定，内容冗长

为解决上述问题，引入代码节点进行数据预处理，再将结果传给 LLM 节点生成报告。最终方案进一步优化：代码节点直接生成报告文本，完全去掉 LLM 节点。

## 二、工作流结构


```text
HTTP节点 → 代码节点 → 结束/输出节点
```

|节点|	功能|
|----|----|
|考勤查询HTTP|调用 API 获取考勤 JSON 数据
|代码执行|解析 JSON → 统计状态 → 生成报告文本
|结束/输出|返回最终报告

## 三、遇到的问题及解决方案

### 问题1：AttributeError: 'str' object has no attribute 'get'
报错信息：

```text
AttributeError: 'str' object has no attribute 'get'
error: exit status 255
```
原因分析：
HTTP 节点返回的 body 是 JSON 字符串，而非已解析的字典对象。代码中直接调用了 .get() 方法，但字符串没有该方法。

解决方案：
在代码开头添加类型判断，对字符串类型进行 json.loads() 解析：

```python
if isinstance(http_response, str):
    try:
        http_response = json.loads(http_response)
    except json.JSONDecodeError:
        return {"result": "错误：JSON解析失败"}
```

### 问题2：Output result is missing
报错信息：

```text
Output result is missing
```
原因分析：
Dify 代码节点的输出变量配置有严格要求：

- 输出变量名必须与 return 返回字典的外层 key 一致

错误写法：


```python
# 错误：直接返回数据，没有外层 key
return {"stats": stats}
```
正确写法：

```python
# 正确：外层 key 必须与输出变量名一致
return {"result": {"stats": stats}}
```

## 四、最终可用代码与节点配置

### 4.1 最终可用代码


```python
import json
from collections import Counter

def main(http_response):
    # ===== 输入处理：字符串 → 字典 =====
    if isinstance(http_response, str):
        try:
            http_response = json.loads(http_response)
        except json.JSONDecodeError:
            return {
                "result": "❌ 错误：JSON解析失败，请检查数据格式"
            }
    
    if not isinstance(http_response, dict):
        return {
            "result": f"❌ 错误：输入类型错误，期望dict，实际为{type(http_response)}"
        }
    
    # ===== 数据提取 =====
    if http_response.get("code") != 1:
        return {
            "result": "❌ 错误：接口返回异常"
        }
    
    records = http_response.get("data", [])
    if not records:
        return {
            "result": "📊 本月无考勤数据"
        }
    
    # ===== 状态映射 =====
    status_map = {
        0: "未排班",
        1: "休息",
        2: "正常上班",
        3: "旷工",
        4: "缺卡",
        5: "请假",
        6: "早退",
        7: "迟到",
        8: "出差",
        9: "外出",
        10: "加班"
    }
    
    abnormal_codes = {3, 4, 6, 7}
    
    # ===== 统计 =====
    stats = {name: 0 for name in status_map.values()}
    abnormal_dates = []
    
    for record in records:
        att_date = record.get("att_date", "未知日期")
        status_code = record.get("status")
        status_name = status_map.get(status_code, f"未知({status_code})")
        
        stats[status_name] = stats.get(status_name, 0) + 1
        
        if status_code in abnormal_codes:
            abnormal_dates.append(att_date)
    
    # ===== 计算关键指标 =====
    total_days = len(records)
    work_days = stats.get("正常上班", 0)
    rest_days = stats.get("休息", 0)
    leave_days = stats.get("请假", 0)
    absent_days = stats.get("旷工", 0)
    missing_days = stats.get("缺卡", 0)
    early_days = stats.get("早退", 0)
    late_days = stats.get("迟到", 0)
    other_abnormal = len(abnormal_dates) - absent_days - missing_days - early_days - late_days
    
    # ===== 构建报告 =====
    report = "📊 **考勤报告**\n\n"
    
    # 表格
    report += "| 状态 | 天数 |\n"
    report += "|------|------|\n"
    
    status_items = [
        ("正常上班", work_days),
        ("休息", rest_days),
        ("请假", leave_days),
        ("旷工", absent_days),
        ("缺卡", missing_days),
        ("早退", early_days),
        ("迟到", late_days),
        ("其他异常", other_abnormal)
    ]
    
    for name, count in status_items:
        if count > 0:
            report += f"| {name} | {count}天 |\n"
    
    report += "\n"
    
    # 异常信息
    if abnormal_dates:
        formatted_dates = [d[5:] for d in abnormal_dates]  # "2026-06-01" -> "06-01"
        dates_str = "、".join(formatted_dates)
        report += f"⚠️ **异常记录**（共{len(abnormal_dates)}天）：{dates_str}\n\n"
        
        if absent_days > 0:
            report += "💡 **建议**：本月旷工较多，建议加强考勤管理。"
        elif missing_days > 0:
            report += "💡 **建议**：存在缺卡情况，请提醒员工及时打卡。"
        elif early_days > 0 or late_days > 0:
            report += "💡 **建议**：存在迟到/早退情况，请关注员工出勤纪律。"
        else:
            report += "💡 **建议**：存在异常考勤，请关注具体情况。"
    else:
        report += "✅ 本月考勤正常，无异常记录。"
    
    return {
        "result": report
    }
```

### 4.2 页面配置如下

![image.png](/static/img/d7eb6fc2d5dbb0b4d75a7ae5da446056.image.webp)

# 五、优化效果对比与总结

## 优化效果对比
|指标|优化前（LLM处理原始JSON）|优化后（代码节点生成报告）|
|------|------|------|
|工作流节点|3个（HTTP → 代码 → LLM）|2个（HTTP → 代码）|
|总耗时|~30秒|<1秒|
|Token消耗|8.6K|0|
|输出稳定性|依赖LLM，不稳定,接口返回相同的内容</br>经LLM处理后结果不一致|完全可控，稳定|
|成本|消耗Token|几乎为0|

## 总结

- Dify 代码节点的输出必须包一层外层 key，且与输出变量名一致
- HTTP 节点返回的 body 是字符串，需要手动 json.loads() 解析
- 避免在变量引用中使用中文键名，Dify 解析器对此支持不完善
- 能用代码节点计算的就别用 LLM，效率提升显著


参考文档：

[Dify官方文档-代码节点](https://docs.dify.ai/zh/use-dify/nodes/code)

Dify 代码节点调试复盘文档

Dify Chatflow工作流中对接业务接口记录（一）

# Dify Chatflow 踩坑记录：通过 API 调用时，如何获取自定义 inputs 参数

## 一、需求背景

目前正在基于dify平台搭建一个对接公司考勤接口的考勤记录查询智能体。目前采用开发提供的mock接口，本人负责智能体的搭建以及搭建后postman接口调用的调试。





调用流程如下：

```text
Postman
   ↓
Dify Chatflow
   ↓
提取年月
   ↓
HTTP节点
   ↓
调用后端考勤接口
```

后端接口要求：

```http
POST /chat/captcha/get_attshifts

Header:
token: xxxxxxxxxxxxx

Body:
{
    "year":"2026",
    "month":"4"
}
```

其中 `token` 需要从调用 Dify API 时动态传入。

---

## 二、最初方案

### Postman 请求

```json
{
    "inputs":{
        "token":"a9af8fdae7ab0c857b3dfab709d14XXX"
    },
    "query":"我要查2026年4月考勤记录",
    "response_mode":"streaming",
    "conversation_id":"",
    "user":"demo-1231",
    "files":[]
}
```

### Dify 开始节点

配置了：

```
user_id
```

HTTP节点中使用：

```text
{{开始节点.user_id#}}
```

结果：

始终获取不到值。

---

## 三、第一次误区

最开始怀疑：

* HTTP节点变量引用错误
* Postman 未传递参数
* Dify API 不支持 inputs

于是查看：

```
workflow_started
```

返回内容：

```json
{
    "inputs": {
        "sys.files": [],
        "sys.user_id": "demo-1231",
        "sys.query": "我要查2026年4月考勤记录"
    }
}
```

发现：

只有：

```
sys.user_id
```

没有：

```
user_id
```

也没有：

```
token
```

---

## 四、真正原因

### （1）inputs 参数名必须与开始节点完全一致

开始节点：

```
user_id
```

Postman：

```json
{
    "inputs":{
        "token":"xxxxxxxx"
    }
}
```

二者名称不同。

Dify 不会自动映射：

```
token
≠
user_id
```

因此：

```
inputs.token
    ↓
开始节点没有对应参数
    ↓
直接丢弃
```

---

### （2）修改开始节点后必须重新发布（Publish）

这是本次最大的坑。

很多时候：

```
新增开始节点参数
    ↓
保存
    ↓
直接调用 API
```

实际上：

API 调用的仍然是旧版本工作流。

必须点击：

```
右上角
→ 发布（Publish）
```

否则：

workflow_started 中看不到新增的参数。

---

## 五、正确配置

### 1、开始节点

新增输入变量：

| 参数名     | 类型     |
| ------- | ------ |
| user_id | String |

---

### 2、Postman

```json
{
    "inputs":{
        "user_id":"a9af8fdae7ab0c857b3dfab709d1XXX"
    },
    "query":"我要查2026年4月考勤记录",
    "response_mode":"streaming",
    "conversation_id":"",
    "user":"demo-1231",
    "files":[]
}
```

注意：

```
inputs.user_id
```

必须和开始节点保持一致。

---

### 3、HTTP节点

Header：

```text
token

{{#开始节点ID.user_id#}}
```

建议不要手写。

直接：

```
插入变量
→ 用户输入：直接输入‘/’
→ user_id
```

由 Dify 自动生成变量表达式。

---

## 六、如何快速排查 inputs 是否传入

查看posman streaming 返回的第一个事件：

```json
{
    "event":"workflow_started"
}
```

重点观察：

```json
{
    "data":{
        "inputs":{
            ...
        }
    }
}
```

如果这里没有：

```json
"user_id":"xxxx"
```

说明：

* Postman 参数错误
* 开始节点参数名不一致
* 工作流未重新发布

而不是 HTTP 节点的问题。

---

## 七、本次踩坑总结

### 经验一

Dify 的 `inputs` 完全依赖名称映射：

```
Postman.inputs.xxx
==
开始节点.xxx
```

否则直接丢弃。

---

### 经验二

修改开始节点后：

一定要：

```
保存
+
重新发布（Publish）
```

否则 API 仍调用旧版本。

---

### 经验三

排查 API 参数最有效的方法不是看页面，而是查看：

```
workflow_started
```

事件中的：

```json
data.inputs
```

它能准确告诉你：

工作流真正接收到了哪些参数。

---

## 八、个人建议

以后所有需要外部传参的 Chatflow，建议统一采用：

```text
开始节点：

token
user_id
username
tenant_id
project_id
```

API：

```json
{
    "inputs":{
        "token":"xxx",
        "user_id":"xxx",
        "username":"xxx"
    }
}
```

然后通过「插入变量」引用，而不要手写变量表达式。

这样基本可以避免 90% 的参数传递问题。

---


:::tip{title="提示"}
## Tips：如何判断 Dify 是否真正收到了 inputs 参数？

不要第一时间去看 HTTP 节点。

直接观察 streaming 返回的第一个事件：

workflow_started

查看：

data.inputs

如果这里没有，说明参数压根没进入工作流。

排查顺序：

1. Postman body  
2. 开始节点参数名  
3. 是否重新 Publish
4. HTTP 节点变量引用
:::

Dify Chatflow 踩坑记录：通过 API 调用时，如何获取自定义 inputs 参数

# 前言
&ensp;对playwright所提供的元素的操作方法以及使用的条件进行简单的实践。



# 与HTML输入元素的交互
## 1. 文本输入框的交互：locator.fill()方法适用于以下三种元素类型：
- `<input>`：输入框

```python
    page.goto("https://2x.ant.design/components/input-cn/")
    page.get_by_placeholder("Basic usage", exact=False).fill("2020-02-02")
```
- `<textarea>`：多行文本，文本域。

```python
    page.goto("https://2x.ant.design/components/input-cn/")
    page.get_by_placeholder("Autosize height with minimum and maximum number of lines", exact=False).fill("多行文本")
```
- `[contenteditable]`可编辑元素：富文本/自定义输入框。

## 2. 复选框的选中与取消：locator.set_checked() 适用于三类元素：
- `input[type=checkbox]`：原生的复选框的选中与取消。

```python
    page.goto("https://2x.ant.design/components/checkbox-cn/")
    page.get_by_role("checkbox", name="Checked-Enabled").uncheck()
    page.get_by_role("checkbox", name="Checked-Enabled").check()
    expect(page.get_by_role("checkbox", name="Checked-Enabled")).to_be_checked()
```
- `input[type=radio]`：原生的单选框的选中。
```python
    page.goto("https://2x.ant.design/components/radio-cn/")
    page.locator("#components-radio-demo-radiogroup").get_by_role("radio", name="B").check()
```
- `[role=checkbox]`：ARIA组件。
```python
    page.goto("https://react-aria.adobe.com/CheckboxGroup")
    page.locator("#react-aria-_R_1mbirda_").get_by_text("Soccer").click()
```

## 3. 下拉框选项操纵：locator.set_checked() 只用于原生的 `<select> `元素：

```python
    page.goto("https://react-aria.adobe.com/CheckboxGroup")
    page.locator("#react-aria-_R_1mbirda_").get_by_text("Soccer").click()
```

:::warning{title="注意"}
目前基本都是引入组件的下拉框，很少有原生的。
原生的标准格式如下：
![image.png](/static/img/5a2fa0fc6edba5205252296d0395c220.image.webp)
:::

## 4. 鼠标的点击操作：
### 鼠标的单击操作，点击操作前的可操作性检查包括：
1. 元素必须存在（DOM中）
2. 元素必须可见（非 `display:none`/`visibility:hidden`）
3. 元素必须稳定（动画结束）
4. 自动滚动到视口内
5. 检查是否被遮挡（能否接收 pointer 事件）
6. 执行点击
7. 如果中途 DOM 变化 → 自动重试
```python
    page.goto("https://react-aria.adobe.com/CheckboxGroup")
    # 单击操作
    page.locator("#react-aria-_R_1mbirda_").get_by_text("Soccer").click()
    # 双击操作
    page.get_by_role("button", name="Star").dblclick()
    # 右键
    page.get_by_role("button", name="Star").click(button="right")
    # 也可多个修饰健组合使用如：click(modifiers=["Shift","Ctrl"])。
    page.get_by_role("button", name="Star").click(modifiers=["Shift"])
    
    # 鼠标悬停操作：图标数据的显示、有些下拉框的触发等。
      page.goto("https://2x.ant.design/components/dropdown-cn/")
    page.locator("#components-dropdown-demo-basic").get_by_role("link", name="Hover me ").hover()
    
    # 指定位置点击：地图场景、颜色选择器
     page.goto("https://www.google.com/maps/@36.1951437,138.5483037,10z?entry=ttu&g_ep=EgoyMDI2MDQwNy4wIKXMDSoASAFQAw%3D%3D")
    page.get_by_role("button", name="Star").click(position={ "x": 0, "y": 0})
```


## 5. 文件的上传操作：文件上传是通过`set_input_files()`方法完成的，该方法支持单文件、多文件、目录上传以及清空文件取消文件上传的操作。
### 5.1 单文件的上传

```python
with sync_playwright() as p:
    browser = p.chromium.launch(
        headless=False,
        # args=["--no-proxy-server"]
    )
    page = browser.new_page()
    page.goto("https://2x.ant.design/components/upload-cn/")
    page.locator('input[type="file"]').nth(0).set_input_files("/Users/jingwei/Desktop/截图/Snipaste_2024-03-20_09-40-39.png")
    sleep(5)
    browser.close()
```

### 5.2 多文件的上传：前提条件HTML必须支持`<input type="file" multiple>`，多个文件的路径放在列表中传入方法中，具体示例如下：

```html
# 元素
<input type="file" accept="" multiple="" style="display: none;">
```

```python
    page.goto("https://2x.ant.design/components/upload-cn/")

    page.locator('input[type="file"]').nth(2).set_input_files([
        "/Users/jingwei/Desktop/截图/Snipaste_2024-03-20_09-40-39.png",
        "/Users/jingwei/Desktop/截图/制图/报告文件.png"
    ])
```

### 5.3 清空文件操作，这里的`.set_input_files([])`方法。

我的实践的时候并没有发现实际的效果，建议点击页面真是的删除与清空按钮，具体原因可能是：

- `.set_input_files([])`方法并不会触发浏览器原生的文件取消/清空事件，它只是清空了Playwright内部记录的文件路径，但页面的上传组建通常不会显现这种变化。
- 在大多数情况下input元素是被隐藏的，页面上显示的“已选文件”的信息是JavaScript监听change事件后渲染的。
- `.set_input_files([])`不会触发change事件，即使清空了值，也不一定会触发change事件。
- UI状态的独立：页面上的文件列表、文件名等UI状态是由JavaScript维护的，与input的实际值可能不同步。

### 5.4 内存上传，这里指的是脚本中直接生成虚拟的文件内容，并将其作为文件上传，而不需要读取硬盘上的真实文件，这就是高级的所在。在这里可以根据测试需要，灵活地构造不同的文件类型。


```python
    page.goto("https://2x.ant.design/components/upload-cn/")
    upload = page.locator(
        'input[type="file"]'
    ).nth(0)
    upload.nth(0).set_input_files(
        files=[
            {
                "name": "test.txt", # 文件名
                "mimeType": "text/plain", # 文件类型
                "buffer": b"hello world" # 文件内容
            }
        ]
    )

    sleep(5)

    browser.close()
```

### 5.5 input 被隐藏，我们就当存在`<input type="file">`进行上传操作，我们也可以控制台命令来看看到底是否存在input标签。

```js
document.querySelectorAll('input')
```
这里以课堂派中提交作业功能来进行测试。


```python
    page.goto("https://www.ketangpai.com/#/login")
    print("the page title is {}".format(page.title()))
    page.fill('//input[@placeholder="请输入邮箱/手机号/账号"]', "")
    page.fill('//input[@placeholder="请输入密码"]', "")
    page.click('//button[./span="登录"]')
    page.wait_for_timeout(5)
    course = page.locator(
        '.header-info',
        has_text="网络安全高级课程2301"
    ).first
    course.click()
    sleep(5)
    page.get_by_text("作业").click()
    with page.context.expect_page() as new_page_info:
        page.get_by_text("w58-rce-23.6.21").click()

    new_page = new_page_info.value

    # 等待新页面加载完成
    new_page.wait_for_load_state()

    # 后续全部操作新页面
    new_page.get_by_text("提交作业").click()

    new_page.locator('input[type="file"]').set_input_files(
        "/Users/jingwei/Desktop/截图/制图/报告文件.png"
    )
    new_page.get_by_role("button", name="确认提交").click()
    new_page.get_by_role("button", name="确定").click()
    sleep(5)
    page.close()
```

## 6. 页面的滚动操作。
### 6.1 大多数情况下不需要手动滚动，元素不在可视区域时Playwright会自动滚动到可视区域。

### 6.2 手动滚动，借助`scroll_into_view_if_needed()`方法。


```python
    page.goto("https://www.ketangpai.com/#/login")
    print("the page title is {}".format(page.title()))
    page.fill('//input[@placeholder="请输入邮箱/手机号/账号"]', "")
    page.fill('//input[@placeholder="请输入密码"]', "")
    page.click('//button[./span="登录"]')
    page.wait_for_timeout(5)
    page.locator('h3:has-text("2020-2021 第一学期")').scroll_into_view_if_needed()
    sleep(5)
```

### 6.3 更加精确的鼠标滚轮滚动，`.mouse.wheel()`。


```python
    page.locator('h2:has-text("置顶课程")').scroll_into_view_if_needed()
    page.locator('h2:has-text("置顶课程")').hover()
    page.mouse.wheel(0, 100)
```

# 涉及资料
[Playwright for Python官方文档](https://playwright.dev/python/docs/input)