wechat-article-parser 0.0.7__tar.gz → 0.0.9__tar.gz

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: wechat-article-parser
-Version: 0.0.7
+Version: 0.0.9
 Summary: WeChat MP article parser - extract metadata and content from WeChat public account articles
 License-Expression: MIT
 License-File: LICENSE
@@ -102,6 +102,7 @@ result = parse(
 | `mp_id` | `int` | 公众号 ID（解码后的整数） |
 | `mp_name` | `str` | 公众号名称 |
 | `mp_alias` | `str` | 公众号别名 |
+| `mp_user_name` | `str` | 公众号用户名（如 `aifaner383402` 或 `gh_9a1919baf888`），未获取到时为空字符串 |
 | `mp_image` | `str` | 公众号头像链接 |
 | `mp_description` | `str` | 公众号简介 |
 | `mp_account_type` | `AccountType` | 账号类型：`AccountType.SUBSCRIPTION`（订阅号）/ `AccountType.SERVICE`（服务号）/ `AccountType.UNKNOWN`（未识别） |
@@ -115,6 +116,7 @@ result = parse(
 | `article_markdown` | `str` | 文章正文的 Markdown 内容；视频分享没有文字附言时可为空 |
 | `article_publish_time` | `int` | 发布时间（Unix 时间戳） |
 | `article_display_type` | `ArticleDisplayType` | 文章展示类型：`article`、`video`、`image`、`text` 或 `unknown` |
+| `article_item_show_type` | `int \| None` | 微信页面中的原始展示类型：`0` 图文、`5` 视频、`8` 图片轮播、`10` 文字；其他已提取的数值原样保留，缺失或无法解析时为 `None` |
 | `raw_html` | `str` | 原始 HTML 网页源代码（仅在 `include_raw_html=True` 时填充，否则为空字符串） |
 | `images` | `list[str]` | 文章中提取的所有图片链接 |
 | `is_valid` | `bool` | 关键字段是否全部解析成功（属性） |
@@ -144,10 +146,11 @@ if result.article_display_type == "video":
     print("视频分享可以没有文字正文")
 
 print(result.article_display_type)  # 例如 video
+print(result.article_item_show_type)  # 例如 5
 ```
 
 `article_display_type` 是返回结果中的数据字段，包含在 `dataclasses.asdict(result)` 中，JSON 序列化时输出语义字符串。
-微信原始的 `item_show_type` 仅在解析器内部使用，不包含在返回结果中。
+`article_item_show_type` 返回微信页面中 `item_show_type` 的原始数值，也包含在 `dataclasses.asdict(result)` 中；JSON 序列化时输出数字或 `null`。
 
 ### 判断账号类型
 

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/README.md

@@ -87,6 +87,7 @@ result = parse(
 | `mp_id` | `int` | 公众号 ID（解码后的整数） |
 | `mp_name` | `str` | 公众号名称 |
 | `mp_alias` | `str` | 公众号别名 |
+| `mp_user_name` | `str` | 公众号用户名（如 `aifaner383402` 或 `gh_9a1919baf888`），未获取到时为空字符串 |
 | `mp_image` | `str` | 公众号头像链接 |
 | `mp_description` | `str` | 公众号简介 |
 | `mp_account_type` | `AccountType` | 账号类型：`AccountType.SUBSCRIPTION`（订阅号）/ `AccountType.SERVICE`（服务号）/ `AccountType.UNKNOWN`（未识别） |
@@ -100,6 +101,7 @@ result = parse(
 | `article_markdown` | `str` | 文章正文的 Markdown 内容；视频分享没有文字附言时可为空 |
 | `article_publish_time` | `int` | 发布时间（Unix 时间戳） |
 | `article_display_type` | `ArticleDisplayType` | 文章展示类型：`article`、`video`、`image`、`text` 或 `unknown` |
+| `article_item_show_type` | `int \| None` | 微信页面中的原始展示类型：`0` 图文、`5` 视频、`8` 图片轮播、`10` 文字；其他已提取的数值原样保留，缺失或无法解析时为 `None` |
 | `raw_html` | `str` | 原始 HTML 网页源代码（仅在 `include_raw_html=True` 时填充，否则为空字符串） |
 | `images` | `list[str]` | 文章中提取的所有图片链接 |
 | `is_valid` | `bool` | 关键字段是否全部解析成功（属性） |
@@ -129,10 +131,11 @@ if result.article_display_type == "video":
     print("视频分享可以没有文字正文")
 
 print(result.article_display_type)  # 例如 video
+print(result.article_item_show_type)  # 例如 5
 ```
 
 `article_display_type` 是返回结果中的数据字段，包含在 `dataclasses.asdict(result)` 中，JSON 序列化时输出语义字符串。
-微信原始的 `item_show_type` 仅在解析器内部使用，不包含在返回结果中。
+`article_item_show_type` 返回微信页面中 `item_show_type` 的原始数值，也包含在 `dataclasses.asdict(result)` 中；JSON 序列化时输出数字或 `null`。
 
 ### 判断账号类型
 

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wechat-article-parser"
-version = "0.0.7"
+version = "0.0.9"
 description = "WeChat MP article parser - extract metadata and content from WeChat public account articles"
 readme = "README.md"
 requires-python = ">=3.10"

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/src/wechat_article_parser/models.py

@@ -68,8 +68,12 @@ class ArticleResult:
     # 文章中提取的图片列表
     images: list[str] = field(default_factory=list)
 
-    # 对外返回语义展示类型，微信原始数值仅在解析器内部使用。
+    # 语义展示类型和微信页面中的原始数值。
     article_display_type: ArticleDisplayType = ArticleDisplayType.UNKNOWN
+    article_item_show_type: int | None = None
+
+    # 当前公众号的页面全局 user_name，未提取到时为空字符串。
+    mp_user_name: str = ""
 
     @property
     def is_valid(self) -> bool:

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/src/wechat_article_parser/parser.py

@@ -35,12 +35,22 @@ _JS_DATA_TOKEN_RE = re.compile(
 # ---------------------------------------------------------------------------
 
 class _MarkdownConverter(MarkdownConverter):
-    def convert_span(self, el, text, parent_tags):
-        return text.strip()
+    def convert_br(self, el, text, parent_tags):
+        # 代码中的换行不需要 Markdown 硬换行所用的两个尾随空格。
+        if "pre" in parent_tags:
+            return "\n"
+        return super().convert_br(el, text, parent_tags)
 
-    def convert_p(self, el, text, parent_tags):
-        text = " ".join(text.split())
-        return super().convert_p(el, text, parent_tags)
+    def convert_pre(self, el, text, parent_tags):
+        # BeautifulSoup 已解码  ；代码中将其还原为可直接复制的普通空格。
+        return super().convert_pre(el, text.replace("\xa0", " "), parent_tags)
+
+    def convert_td(self, el, text, parent_tags):
+        # GFM 表格内的管道符即使位于行内代码中，也必须转义。
+        return super().convert_td(el, text.replace("|", r"\|"), parent_tags)
+
+    def convert_th(self, el, text, parent_tags):
+        return super().convert_th(el, text.replace("|", r"\|"), parent_tags)
 
 
 def _to_markdown(html: str) -> str:
@@ -50,8 +60,7 @@ def _to_markdown(html: str) -> str:
 def _to_markdown_plain(html: str) -> str:
     """用于纯文本类内容（纯文本/转载/视频/轮播/全屏）的转换。
 
-    这些内容由 <br> 承载换行，必须保留；故使用未覆写 convert_p 的基础转换器，
-    避免 _MarkdownConverter 折叠空白时把换行一并吞掉。
+    这些内容由 <br> 承载换行，使用基础转换器保留换行。
     """
     return MarkdownConverter().convert(html)
 
@@ -220,6 +229,84 @@ def _extract_item_show_type(scripts: list[Tag]) -> int | None:
     return None
 
 
+def _extract_user_name(scripts: list[Tag]) -> str:
+    """读取全局 user_name，缺失时读取 window.cgiDataNew 的直接属性。
+
+    文章元数据脚本中该变量位于 nickname、ct 附近；不依赖行号或账号值。
+    使用词法标记跳过注释和字符串，不执行页面脚本。
+    """
+    for script in scripts:
+        if "user_name" not in script.text:
+            continue
+        history: deque[str] = deque(maxlen=4)
+        brace_depth = 0
+        for match in _JS_DATA_TOKEN_RE.finditer(script.text):
+            if match.lastgroup == "comment":
+                continue
+            token = match.group()
+            previous = tuple(history)
+            if (
+                brace_depth == 0
+                and token == ";"
+                and previous[:3] == ("var", "user_name", "=")
+                and len(previous) == 4
+                and previous[3].startswith(("'", '"'))
+            ):
+                value = _decode_text(previous[3][1:-1])
+                if value:
+                    return value
+            if token == "{":
+                brace_depth += 1
+            elif token == "}":
+                brace_depth -= 1
+            history.append(token)
+    return _extract_cgi_user_name(scripts)
+
+
+def _extract_cgi_user_name(scripts: list[Tag]) -> str:
+    """从当前文章的 cgiDataNew 对象中读取 user_name，排除嵌套账号。"""
+    for script in scripts:
+        if "cgiDataNew" not in script.text or "user_name" not in script.text:
+            continue
+        history: deque[str] = deque(maxlen=5)
+        stack: list[str] = []
+        for match in _JS_DATA_TOKEN_RE.finditer(script.text):
+            if match.lastgroup == "comment":
+                continue
+            token = match.group()
+            previous = tuple(history)
+            if not stack:
+                if (
+                    token == "{"
+                    and previous[-4:] == ("window", ".", "cgiDataNew", "=")
+                    and (len(previous) < 5 or previous[-5] != ".")
+                ):
+                    stack.append(token)
+            else:
+                # 只接受完整的字符串属性值，不读取表达式或嵌套对象的值。
+                if (
+                    stack == ["{"]
+                    and token in (",", "}")
+                    and len(previous) >= 4
+                    and previous[-4] in ("{", ",")
+                    and previous[-3].strip("\"'") == "user_name"
+                    and previous[-2] == ":"
+                    and previous[-1].startswith(("'", '"'))
+                ):
+                    value = _decode_text(previous[-1][1:-1])
+                    if value:
+                        return value
+                if token in ("{", "["):
+                    stack.append(token)
+                elif token in ("}", "]"):
+                    if stack[-1] == {"}": "{", "]": "["}[token]:
+                        stack.pop()
+                    else:
+                        stack.clear()
+            history.append(token)
+    return ""
+
+
 def _extract_account_type(script_text: str, result: ArticleResult) -> None:
     """从 new_service_type 中提取账号类型：0/1 → 订阅号，2 → 服务号。"""
     if result.mp_account_type:
@@ -332,7 +419,8 @@ def _extract_swiper_meta(script_text: str, result: ArticleResult) -> None:
 
 def _extract_rich_media_content(content_tag: Tag, result: ArticleResult) -> None:
     """将 rich_media_content 区块转换为 Markdown。"""
-    soup = BeautifulSoup(content_tag.prettify(), "html.parser")
+    # prettify 会在行内标签之间插入空白，改变代码和引用链接的内容。
+    soup = BeautifulSoup(str(content_tag), "html.parser")
     seen: set[str] = set()
 
     # 处理 <img> 标签
@@ -385,7 +473,7 @@ def _extract_rich_media_content(content_tag: Tag, result: ArticleResult) -> None
     for tag in to_remove:
         tag.decompose()
 
-    result.article_markdown = _to_markdown(soup.prettify())
+    result.article_markdown = _to_markdown(str(soup))
 
 
 def _extract_repost_content(content_tag: Tag, result: ArticleResult) -> None:
@@ -568,7 +656,9 @@ def _parse_html(url: str, html: str) -> ArticleResult:
 
     scripts = soup.find_all("script", attrs={"type": "text/javascript"})
 
+    result.mp_user_name = _extract_user_name(soup.find_all("script"))
     item_show_type = _extract_item_show_type(scripts)
+    result.article_item_show_type = item_show_type
     result.article_display_type = _ARTICLE_DISPLAY_TYPES.get(
         item_show_type, ArticleDisplayType.UNKNOWN,
     )

wechat_article_parser-0.0.9/tests/test_markdown.py

@@ -0,0 +1,85 @@
+"""富文本 Markdown 转换的离线回归测试。"""
+
+import pytest
+
+from wechat_article_parser.parser import _parse_html
+
+
+def _convert(body: str) -> str:
+    html = f'<div class="rich_media_content">{body}</div>'
+    return _parse_html("https://mp.weixin.qq.com/s/test", html).article_markdown
+
+
+def test_highlighted_code_preserves_breaks_spaces_and_entities() -> None:
+    # 微信 mdnice 代码块：语法高亮 span 切分 token，br 换行，nbsp 占位。
+    body = (
+        '<pre data-tool="mdnice编辑器"><code>'
+        '<span><span># ======== 基础体验 ========</span></span><span><br></span>'
+        '<span><span>set</span></span><span>&nbsp;-g default-terminal&nbsp;</span>'
+        '<span><span>"tmux-256color"</span></span><span><br></span>'
+        '<span>set</span><span>&nbsp;-as terminal-features&nbsp;</span>'
+        '<span>",*:RGB"</span><span><br></span>'
+        '<span>set</span><span>&nbsp;-g mouse on &nbsp; &nbsp;</span>'
+        '<span># 支持鼠标操作</span><span><br></span><span><br></span>'
+        '<span>&nbsp;&nbsp;echo &quot;&lt;tag&gt;&quot; &amp;&amp; echo &#160;ok</span>'
+        '</code></pre>'
+    )
+
+    assert _convert(body) == (
+        '```\n'
+        '# ======== 基础体验 ========\n'
+        'set -g default-terminal "tmux-256color"\n'
+        'set -as terminal-features ",*:RGB"\n'
+        'set -g mouse on    # 支持鼠标操作\n\n'
+        '  echo "<tag>" && echo  ok\n'
+        '```'
+    )
+
+
+def test_plain_pre_preserves_indentation_and_blank_lines() -> None:
+    assert _convert('<pre><code>if ready:\n    run()\n\n    done()\n</code></pre>') == (
+        '```\nif ready:\n    run()\n\n    done()\n```'
+    )
+
+
+@pytest.mark.parametrize("cell", ["td", "th"])
+def test_table_pipes_in_text_and_inline_code_are_escaped(cell: str) -> None:
+    output = _convert(
+        f'<table><tr><{cell}>A | B</{cell}><{cell}><section>'
+        '<span>验证 </span><code><span>tailscale status | grep peer-relay</span></code>'
+        f'</section></{cell}></tr></table>'
+    )
+
+    assert r'A \| B' in output
+    assert r'`tailscale status \| grep peer-relay`' in output
+    # 每行仍然只有两个单元格（三个未转义的分隔符）。
+    assert all(line.replace(r'\|', '').count('|') == 3 for line in output.splitlines())
+
+
+def test_pipe_outside_table_is_unchanged() -> None:
+    assert _convert('<p><code>left | right</code></p><pre>left | right</pre>') == (
+        '`left | right`\n\n```\nleft | right\n```'
+    )
+
+
+def test_inline_spans_and_paragraph_breaks_preserve_spacing() -> None:
+    assert _convert(
+        '<p><span>hello </span><span>world</span><br><span>next line</span></p>'
+    ) == 'hello world  \nnext line'
+
+
+def test_bold_reference_stays_inline() -> None:
+    assert _convert(
+        '<ul><li><section><strong><span>Hermes</span><sup>'
+        '<a href="https://example.com/hermes">[1]</a></sup></strong>'
+        '<span>：Nous Research 的自主 AI Agent</span></section></li></ul>'
+    ) == '* **Hermes[[1]](https://example.com/hermes)**：Nous Research 的自主 AI Agent'
+
+
+def test_literal_asterisks_in_source_stay_literal_and_inline() -> None:
+    # 这篇原文没有 strong 标签；不能把普通星号自动猜测为加粗语义。
+    assert _convert(
+        '<ul><li><section><span>**</span><span>Hermes</span>'
+        '<sup><span>[1]</span></sup><span>**：Nous Research 的自主 AI Agent</span>'
+        '</section></li></ul>'
+    ) == r'* \*\*Hermes[1]\*\*：Nous Research 的自主 AI Agent'

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/tests/test_models.py

@@ -79,11 +79,11 @@ def test_display_type_has_semantic_string_values(expected: str) -> None:
     assert json.dumps(result.article_display_type) == json.dumps(expected)
     serialized = json.loads(json.dumps(asdict(result)))
     assert serialized["article_display_type"] == expected
-    assert "item_show_type" not in serialized
-    assert not hasattr(result, "item_show_type")
+    assert serialized["article_item_show_type"] is None
 
 
 def test_default_display_type_is_unknown() -> None:
     result = ArticleResult()
     assert result.article_display_type is ArticleDisplayType.UNKNOWN
+    assert result.article_item_show_type is None
     assert not result.is_valid

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/tests/test_parser.py

@@ -47,6 +47,7 @@ def _assert_result(result: ArticleResult, url: str) -> None:
     print(f"公众号ID:     {result.mp_id}")
     print(f"公众号名称:   {result.mp_name}")
     print(f"公众号别名:   {result.mp_alias}")
+    print(f"公众号用户名: {result.mp_user_name}")
     print(f"账号类型:     {result.mp_account_type}")
     print(
         f"公众号图片:   {result.mp_image[:80]}..."
@@ -64,6 +65,7 @@ def _assert_result(result: ArticleResult, url: str) -> None:
     print(f"文章签名:     {result.article_sn}")
     print(f"文章标题:     {result.article_title}")
     print(f"展示类型:     {result.article_display_type}")
+    print(f"原始展示类型: {result.article_item_show_type}")
     print(
         f"封面图:       {result.article_cover_image[:80]}..."
         if result.article_cover_image
@@ -82,6 +84,7 @@ def _assert_result(result: ArticleResult, url: str) -> None:
 
     assert result.mp_id > 0, "mp_id should be positive"
     assert result.mp_name, "mp_name should not be empty"
+    assert result.mp_user_name, "mp_user_name should not be empty for these reference articles"
     assert result.article_id, "article_id should not be empty"
     assert result.article_msg_id > 0, "article_msg_id should be positive"
     assert result.article_idx > 0, "article_idx should be positive"
@@ -105,6 +108,7 @@ def test_fetch_all(url: str, proxy: str | None) -> None:
     print(f"公众号ID:     {result.mp_id}")
     print(f"公众号名称:   {result.mp_name}")
     print(f"公众号别名:   {result.mp_alias}")
+    print(f"公众号用户名: {result.mp_user_name}")
     print(f"账号类型:     {result.mp_account_type}")
     print(f"公众号图片:   {result.mp_image}")
     print(f"公众号简介:   {result.mp_description}")
@@ -114,6 +118,7 @@ def test_fetch_all(url: str, proxy: str | None) -> None:
     print(f"文章签名:     {result.article_sn}")
     print(f"文章标题:     {result.article_title}")
     print(f"展示类型:     {result.article_display_type}")
+    print(f"原始展示类型: {result.article_item_show_type}")
     print(f"封面图:       {result.article_cover_image}")
     print(f"文章摘要:     {result.article_description}")
     print(f"发布时间:     {result.article_publish_time}")

{wechat_article_parser-0.0.7 → wechat_article_parser-0.0.9}/tests/test_type_routing.py

@@ -1,5 +1,8 @@
 """类型字段优先分发、模板细分及 HTML 兜底的离线回归测试。"""
 
+from dataclasses import asdict
+import json
+
 import pytest
 from bs4 import BeautifulSoup
 
@@ -63,6 +66,9 @@ def test_read_current_article_type(script: str, expected: int | None) -> None:
     soup = BeautifulSoup(_html(script=script), "html.parser")
 
     assert parser._extract_item_show_type(soup.find_all("script")) == expected
+    result = parser._parse_html(_URL, _html(_RICH_TEXT, script))
+    assert result.article_item_show_type == expected
+    assert json.loads(json.dumps(asdict(result)))["article_item_show_type"] == expected
 
 
 @pytest.mark.parametrize("current_assignment", ["", "window.item_show_type = '8';"])
@@ -102,6 +108,7 @@ def test_type_zero_uses_html_to_distinguish_rich_text_and_repost(
     result = parser._parse_html(_URL, _html(body, 'var item_show_type = "0";'))
 
     assert result.article_display_type is ArticleDisplayType.ARTICLE
+    assert result.article_item_show_type == 0
     assert expected in result.article_markdown
     if expected == "转载附言":
         assert "[查看原文](https://example.com/original)" in result.article_markdown
@@ -130,7 +137,7 @@ def test_known_type_takes_priority_over_other_html_templates(
     assert expected in result.article_markdown
     assert "富文本正文" not in result.article_markdown
     assert result.article_display_type is display_type
-    assert not hasattr(result, "item_show_type")
+    assert result.article_item_show_type == item_type
     if item_type == 8:
         assert result.images == ["https://mmbiz.qpic.cn/mmbiz_png/body/640"]
 
@@ -154,6 +161,7 @@ def test_known_type_without_matching_data_falls_back_to_html(item_type: int) ->
     )
 
     assert result.article_markdown == "富文本正文"
+    assert result.article_item_show_type == item_type
 
 
 def test_type_zero_without_matching_html_falls_back_to_other_templates() -> None:
@@ -196,6 +204,7 @@ def test_unrecognized_content_still_returns_metadata() -> None:
 
     assert result.article_title == "原标题"
     assert result.mp_alias == "account"
+    assert result.article_item_show_type == 999
     assert result.article_display_type is ArticleDisplayType.UNKNOWN
     assert result.article_markdown == ""
     assert not result.is_valid

wechat_article_parser-0.0.9/tests/test_user_name.py

@@ -0,0 +1,137 @@
+"""当前公众号 user_name 的位置规则及公开返回接口回归测试。"""
+
+from dataclasses import asdict
+import json
+
+import httpx
+import pytest
+
+from wechat_article_parser import ArticleResult, parser
+
+
+_URL = "https://mp.weixin.qq.com/s/tBqB3134QzILypNVUW1fdw"
+# 精简自参考页面的文章元数据脚本，保留字段上下文。
+_METADATA = """
+var nickname = htmlDecode("爱范儿");
+var appmsg_type = "9";
+var ct = "1784779200";
+var user_name = "aifaner383402";
+var fakeid = "";
+"""
+_DECOYS = """
+var ad = {biz_info: {user_name: 'gh_1e80bb81a1d2'}};
+window.cgiDataNew = {ad: {user_name: 'nested-ad-account'}};
+(function () { var user_name = 'local-account'; })();
+function report() { var user_name = 'another-local-account'; }
+var example = "var user_name = 'string-account';";
+var template = `var user_name = 'template-account';`;
+// var user_name = 'comment-account';
+/* var user_name = 'block-comment-account'; */
+var original_user_name = 'reference-account';
+var info = {userName: window.user_name};
+"""
+
+
+def _html(*scripts: str, body: str = "") -> str:
+    return body + "".join(
+        f'<script type="text/javascript">{script}</script>' for script in scripts
+    )
+
+
+@pytest.mark.parametrize("body", ["", '<div class="rich_media_content">正文</div>'])
+def test_user_name_comes_from_global_metadata(body: str) -> None:
+    result = parser._parse_html(_URL, _html(_DECOYS, _METADATA, _DECOYS, body=body))
+
+    assert result.mp_user_name == "aifaner383402"
+    assert json.loads(json.dumps(asdict(result)))["mp_user_name"] == "aifaner383402"
+
+
+@pytest.mark.parametrize(
+    ("declaration", "expected"),
+    [
+        ("var user_name = 'gh_another-account';", "gh_another-account"),
+        ('var\nuser_name /* comment */ = "other_account";', "other_account"),
+        (r'var user_name = "gh_\x61bc";', "gh_abc"),
+        ("", ""),
+        ("var user_name = '';", ""),
+        ("var user_name = null;", ""),
+        ("var user_name = another_variable;", ""),
+        ("var user_name = 'prefix' + suffix;", ""),
+    ],
+)
+def test_user_name_is_dynamic_and_missing_values_are_empty(
+    declaration: str, expected: str,
+) -> None:
+    result = parser._parse_html(_URL, _html(_DECOYS, declaration))
+    assert result.mp_user_name == expected
+
+
+def test_script_without_type_attribute() -> None:
+    result = parser._parse_html(_URL, f"<script>{_METADATA}</script>")
+    assert result.mp_user_name == "aifaner383402"
+
+
+def test_default_user_name() -> None:
+    assert ArticleResult().mp_user_name == ""
+
+
+@pytest.mark.parametrize("key", ["user_name", "'user_name'", '"user_name"'])
+@pytest.mark.parametrize("body", ["", '<div class="rich_media_content">正文</div>'])
+def test_cgi_direct_user_name_fallback(key: str, body: str) -> None:
+    data = (
+        "(function () { window.cgiDataNew = {"
+        "base_resp: {ret: '0' * 1},"
+        "ad: {user_name: 'wrong-ad'},"
+        "references: [{user_name: 'wrong-reference'}],"
+        f"{key}: 'gh_9a1919baf888'"
+        "}; })();"
+    )
+    result = parser._parse_html(_URL, _html(_DECOYS, data, body=body))
+    assert result.mp_user_name == "gh_9a1919baf888"
+
+
+def test_global_metadata_has_priority_over_cgi_fallback() -> None:
+    data = "window.cgiDataNew = {user_name: 'cgi-account'};"
+    result = parser._parse_html(_URL, _html(data, _METADATA))
+    assert result.mp_user_name == "aifaner383402"
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        "window.cgiDataNew = {user_name: ''};",
+        "window.cgiDataNew = {user_name: 'prefix' + suffix};",
+        "other.window.cgiDataNew = {user_name: 'wrong'};",
+        "var text = \"window.cgiDataNew = {user_name: 'wrong'};\";",
+        "// window.cgiDataNew = {user_name: 'wrong'};",
+        "/* window.cgiDataNew = {user_name: 'wrong'}; */",
+    ],
+)
+def test_cgi_fallback_ignores_decoys_and_nonliteral_values(data: str) -> None:
+    result = parser._parse_html(_URL, _html(_DECOYS, data))
+    assert result.mp_user_name == ""
+
+
+@pytest.fixture
+def mock_article_http(monkeypatch):
+    transport = httpx.MockTransport(
+        lambda request: httpx.Response(200, text=_html(_DECOYS, _METADATA))
+    )
+    client = httpx.Client
+    async_client = httpx.AsyncClient
+    monkeypatch.setattr(
+        parser.httpx, "Client", lambda **kwargs: client(transport=transport, **kwargs),
+    )
+    monkeypatch.setattr(
+        parser.httpx, "AsyncClient", lambda **kwargs: async_client(transport=transport, **kwargs),
+    )
+
+
+def test_sync_parse_returns_user_name(mock_article_http) -> None:
+    assert parser.parse(_URL).mp_user_name == "aifaner383402"
+
+
+@pytest.mark.asyncio
+async def test_async_parse_returns_user_name(mock_article_http) -> None:
+    result = await parser.parse_async(_URL)
+    assert result.mp_user_name == "aifaner383402"