treewalker 实例没有 parentnode 和 firstchild 属性或方法；其 parentnode() 和 firstchild() 是特有导航方法，语义与 node 接口完全不同：前者回溯过滤后逻辑父节点，后者深度优先查找首个匹配后代。
TreeWalker 没有 parentNode 和 firstChild 方法
直接说结论：TreeWalker 实例根本不存在 parentNode 或 firstChild 这两个属性或方法。这是个常见误解——把 Node 接口的属性误套到了 TreeWalker 上。你调用 walker.parentNode 会得到 undefined，调用 walker.firstChild() 会报 TypeError: walker.firstChild is not a function。
TreeWalker 的设计目标是「单向、受过滤约束的节点遍历」，它只提供 nextNode()、previousNode()、parentNode()（注意：这是方法，不是属性！且名字易混淆）、firstChild()（同样，是方法但行为和 Node.firstChid 不同）等导航方法——但这些方法名虽相似，语义和触发时机完全不同。
TreeWalker.parentNode() 是回溯父节点，不是获取当前节点的 parentNode
TreeWalker.parentNode() 的作用是：把内部指针从当前匹配节点「向上回退一层」，移动到该节点在过滤后视图中的逻辑父节点（即上一个通过 filter 的祖先）。它不返回 DOM 节点的原生 parentNode，也不保证该父节点一定存在于当前 TreeWalker 的遍历路径中。
实际使用时要注意：
-
parentNode()只在当前节点不是根节点（即不是root参数指定的节点）且存在符合条件的祖先时才有效；否则返回null - 它跳过的中间节点（未通过
whatToShow或filter）会被完全忽略，所以「逻辑父」可能在 DOM 树中隔了好几层 - 如果你需要原始 DOM 层级的
currentNode.parentNode，请直接访问walker.currentNode.parentNode，而不是调用walker.parentNode()
TreeWalker.firstChild() 不等于 node.firstChild
TreeWalker.firstChild() 是让指针进入当前节点的「第一个符合条件的后代」，但它不是简单取 currentNode.firstChild 然后检查是否通过过滤——而是从 currentNode 开始，深度优先搜索整个子树，找到第一个满足 whatToShow 和 NodeFilter.filter() 的节点，并将指针移过去。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
这意味着：
- 即使
currentNode.firstChild是Text节点，若你设置了whatToShow = NodeFilter.SHOW_ELEMENT，它就会被跳过 - 如果子树中没有任何节点满足条件，
firstChild()返回null，且指针不变 - 它不会修改
currentNode的 DOM 关系，只是改变 TreeWalker 内部游标位置
示例：假设 walker 当前指向一个 <div>，其子节点是 <code>Text + <span></span> + <p></p>，而你只显示元素节点，则 walker.firstChild() 会直接落到 <span></span>（而非 <p></p>），哪怕 <span></span> 在 DOM 中不是第一个子节点（比如前面有空格文本节点）。
真正可控的定向导航靠 nextNode / previousNode + currentFilter 配合
想实现类似「跳到第 3 个 button」「回到上一个带 data-role 的父容器」这种定向操作，别依赖 parentNode() 或 firstChild() 的模糊语义。稳妥做法是：
- 用
walker.currentNode获取当前真实节点，手动做 DOM 层级判断（如el.matches('[data-role]')） - 用
walker.nextNode()循环调用，配合计数或条件 break，比嵌套调用parentNode().firstChild()更可读、更可控 - 若需频繁随机访问，不如先用
document.querySelectorAll(...)收集目标节点数组，再按索引操作 —— TreeWalker 的优势在于流式、内存友好的遍历，不是随机寻址 - 注意
whatToShow设置不当会导致nextNode()跳过大量内容（比如设成SHOW_TEXT却想找元素），调试时可临时设为SHOW_ALL看是否是过滤逻辑问题
TreeWalker 的「定向」本质是「定义好过滤规则后，让指针按固定顺序停在下一个/上一个有效节点」，不是提供任意 DOM 路径跳转能力。把它的角色理解成「带筛选器的迭代器」，而不是「DOM 导航遥控器」，会少踩很多坑。
