Comment Link Assistant

评论外链助手是一款基于 Chrome Manifest V3 的浏览器扩展，用于管理博客、论坛等站点的评论外链工作流。

它把用户导入的目标链接整理成计划和批次，依次打开目标页面、识别评论表单、读取页面上下文、生成相关评论、填写表单并记录每一步进度。遇到登录或验证码时，扩展会标记该站点、跳过当前目标并继续下一条，不会尝试绕过站点限制。

本扩展只处理用户主动导入的链接，不会自动发现网站，也不会在后台扫描整个互联网。

核心功能

• 运营看板：查看计划数量、处理进度、成功与失败统计、今日排程、实时运行状态和近期错误。
• 计划管理：将大量目标链接拆分成多个批次，逐批运行、暂停、继续、重试、归档或删除，并可随时调整每批条数。
• 网站管理：维护最多 20 个推广网站的资料，并为每个网站设定外链的锚文本配比。
• 页面识别：识别 WordPress 评论区、常见评论表单、富文本编辑器、隐藏评论入口、登录限制和验证码。
• 评论生成：根据推广网站信息和目标页面正文，生成与文章内容相关的评论。
• 自动填写：填写评论正文、姓名、邮箱和 Website 字段，并在提交前再次校验页面是否发生变化。
• 进度恢复：浏览器 Service Worker 被挂起、页面加载缓慢或任务被手动停止后，可从已保存状态继续运行。
• 过滤列表：按精确 URL 或域名跳过不希望再次处理的目标。
• 外链库：以域名为单位管理 dofollow、nofollow、是否支持匿名评论、是否需要人机验证等属性，支持看板、筛选、编辑和批量导入。
• 锚文本配比：按品牌词、裸链、精确关键词、部分匹配词、通用词和自然文本六类设定比例，逐条轮转，并统计每个词实际发出去的次数。

工作流程

1. 在设置中填写模型 API Key，在网站管理中添加推广网站、显示名称、邮箱和锚文本配比。
2. 粘贴目标 URL 或裸域名，或导入 TXT、CSV、Excel 文件。
3. 创建计划并设置每个批次包含的链接数量。
4. 从运营看板或计划详情启动下一批任务。
5. 扩展使用一个后台工作标签页，按顺序处理每个目标链接。
6. 遇到登录或验证码时，扩展标记该域名并跳过当前目标，然后自动处理下一条。
7. 在计划详情中查看每个目标的状态、尝试记录、错误码和生成结果，并对失败项进行重试。

运营看板

运营看板用于汇总整个扩展的运行情况，而不是只显示当前批次。

总览指标

看板顶部展示：

• 活跃计划数量
• 已处理链接数量
• 成功提交数量
• 失败数量
• 待处理、运行中、需要人工处理、已停止、已过滤和未知状态数量

今日排程

每个计划会按照设定的批次大小拆分。看板会显示：

• 今天可以运行的批次
• 下一批批次
• 当前是第几批
• 批次包含多少条链接
• 已处理多少条链接

扩展不会自动在固定时间发布评论。排程用于组织任务，批次仍由用户主动启动。

实时运行

任务运行时，看板会显示：

• 当前计划和批次
• 当前处理的目标链接
• 当前运行阶段
• 本批总数、已处理、成功、失败和剩余数量
• 打开当前链接、停止批次和继续运行等操作

网站统计

看板从两个维度汇总结果：

• 按推广网站统计：查看不同推广网站对应的计划和执行结果。
• 按目标域名统计：查看不同博客或论坛域名的处理量与成功、失败情况。

近期失败

看板会列出最近失败的目标，包括：

• 目标 URL
• 所属计划和批次
• 失败状态
• 友好错误说明
• 原始诊断错误码

原始错误码可以复制，用于排查识别、权限、页面变化、模型请求或提交失败等问题。

计划管理

创建计划

一个计划包含：

• 计划名称
• 推广网站
• 目标 URL 列表
• 每批处理数量

导入后，扩展会先规范化并去重 URL，再按照批次大小拆分。每个批次拥有独立状态和运行记录。

URL 导入与识别

目标输入支持以下格式：

• 每行一个 HTTP、HTTPS URL 或裸域名（例如 example.com/post）
• 同一行包含多个、以空格分隔的 URL
• TXT 内容
• CSV 内容
• Excel（.xlsx、.xls）文件
• 带有 url、link、target、网址、目标网址 等表头的 CSV
• CSV 中混合 URL、裸域名和说明文字时，只提取目标单元格

处理规则：

• http://、https:// 和 www. 都不是必填；裸域名会按 HTTPS 规范化。
• 只接受可规范化为 HTTP 或 HTTPS 的目标，不接受其他 Scheme。
• 自动移除 URL Fragment。
• 自动去除重复目标。
• 拒绝包含用户名或密码的 URL。
• 普通 URL 最长为 2048 个字符。
• CSV 中包含逗号的 URL 应使用双引号包裹。
• URL 查询参数或 Fragment 中的未引用逗号会保留为 URL 的一部分。
• 无法识别的行会显示具体行号，而不是静默忽略。

计划与批次状态

计划状态包括：

• 进行中
• 已完成
• 已归档

批次状态包括：

• 待运行
• 运行中
• 需要人工处理
• 已停止
• 已完成
• 完成但有错误

在计划详情中可以查看每个批次和每条链接的处理结果、更新时间、尝试次数与完整时间线。

管理操作

计划支持：

• 修改计划名称
• 修改每批条数
• 启动下一批
• 继续被阻塞或停止的批次
• 选择失败目标重新生成并重试
• 删除单条目标链接
• 删除目标时同时加入过滤列表
• 归档计划
• 永久删除计划及其本地运行记录

已经发布到第三方网站的评论不会因为删除本地计划而被撤回。

网站管理

网站管理是独立的导航页，左侧是站点列表，右侧是选中站点的资料和锚文本配比。设置抽屉只保留评论模型、API Key、界面语言和数据备份。

站点资料

每个站点包含名称、要推广的网站、显示名称、邮箱和链接放置方式，最多可配置 20 个。列表中标记为“默认”的站点会被侧边栏和新建计划优先使用。

站点资料需要点击“保存网站”才会写入存储；有未保存的修改时保存栏会提示，并可一键撤销。

锚文本配比

链接放置方式为“a 标签换行”时，外链的锚文本不再固定使用网站标题，而是按设定比例在六类之间轮转：

类别	含义	默认比例
品牌词	网站名或产品名	30%
裸链	网址本身作为链接文字	20%
精确关键词	目标关键词，一字不差	20%
部分匹配词	围绕关键词的变体说法	15%
通用词	完全不带关键词的说法	10%
自然文本	融进上下文句子里的短语	5%

比例必须合计 100%，合计不足或超出时会提示并可一键归一化。每类下方的词池按每行一个锚文本填写；裸链可从网站链接自动填入三种写法，通用词可插入内置推荐词，自然文本可调用模型生成兜底词。

配比在合计等于 100% 时即时保存，不需要点“保存网站”。

选词方式

模型只输出带占位符的纯文本，锚文本由扩展按算法选定后再拼接，因此比例不会被模型带偏。

下一条外链落在哪一类，取当前欠得最多的那一类：

weight = 该类比例 / 有效类别的比例之和
score  = weight × (已发布数 + 待审核数 + 1) − 该类已计数

比例为 0 或词池为空的类别会被剔除，剩余比例重新归一化。自然文本是唯一由模型现写的一类，但类别仍由算法先定；模型给出的短语不可用时回落到该类词池，占用的配额不变。

用词统计

配比按网站维度终身累计，只统计真正发出去的外链：

• 已确认发布：立即计入
• 待审核：先挂起，定时复查确认发布后才计入
• 结果未确认、失败、无表单、需要人机验证：永不计入

每一类下方会列出该类已发布的具体用词和次数，条形长度按该类中最高的一条归一化。大小写和多余空格视为同一个词。

用词统计从该功能上线后开始记录，此前发布的外链只有类别总数、没有用词明细；两者对不上时会明确写出“另有 N 条没有留下用词记录”。

外链库

外链库是独立的完整页面，不再只显示为右侧抽屉。顶部统计卡片展示：

• 外链总数
• Dofollow
• Nofollow
• 匿名评论（无需登录）
• 无需人机验证

列表支持搜索、按属性筛选、分页、新增、编辑和删除。外链库保存完整的博客文章 URL（包括路径和查询参数），以规范化后的完整 URL 去重；同一域名下可以保存多篇文章。域名仅用于搜索、分组以及登录/CAPTCHA 的站点级过滤。

批量导入支持 TXT、CSV、XLSX 和 XLS。默认列顺序为：

1. 博客文章 URL（必填；也兼容裸域名）
2. 是否 Dofollow
3. 是否需要登录
4. 是否 CAPTCHA

其他列不存在时保持“未知”，存在时按顺序读取。导入前会显示有效与无效行预览；重复的完整 URL 会更新已有记录，不会创建重复项。页面也提供标准 CSV 模板下载。从外链库创建计划时会直接使用完整文章 URL，因此不会丢失评论表单所在的路径。

任务进度与状态机

每个目标链接按照以下阶段顺序处理：

queued
  → opening
  → analyzing
  → generating
  → prepared
  → click_dispatched
  → verifying
  → submitted

可能出现的其他状态：

• login_required：需要登录；标记域名、跳过当前目标并继续批次。
• captcha_required：需要完成人机验证；标记域名、跳过当前目标并继续批次。
• no_form：未找到可信的评论表单。
• validation_error：表单字段、页面结构或提交结果校验失败。
• failed：页面加载、模型请求、权限或运行环境失败。
• filtered：命中过滤列表，未打开或提交。
• stopped：用户主动停止任务。

扩展会为每个目标保存阶段事件、时间戳、错误信息和尝试记录。运营看板和计划详情从这些持久化状态中恢复进度。

页面和评论表单的识别方式

扩展优先使用确定性的 DOM 规则识别表单，不会把整个页面交给模型后让模型随意点击。

1. 页面上下文

目标页面会提取：

• 当前 URL
• 页面标题
• Meta Description 或 Open Graph Description
• 文章正文摘要，最多 8000 个字符
• 页面语言
• 是否存在 Website 字段

正文优先从 article、.entry-content、.post-content、main、[role="main"] 等文章区域读取，找不到时才回退到页面正文。

2. WordPress 快速识别

对于原生 WordPress 评论表单，扩展使用结构化标识直接识别：

• #commentform
• 提交到 wp-comments-post.php 的表单
• #respond 或 .comment-respond
• textarea#comment 或 textarea[name="comment"]
• #submit、input[name="submit"] 或 .comment-submit

这一识别方式不依赖按钮语言，因此中文、英文或其他语言的 WordPress 评论区都可以使用同一套规则。

隐藏的反垃圾 honeypot 字段会因为不可见而被排除，真实的可见评论输入框会被优先选择。

3. 通用评论表单识别

通用识别支持以下编辑器：

• textarea
• contenteditable
• ARIA textbox
• ProseMirror
• Quill
• Lexical
• 位于同源 iframe 中的编辑器
• 位于开放 Shadow DOM 中的编辑器

扩展会综合以下信息为候选编辑器评分：

• id、name、class
• Placeholder
• ARIA Label
• 可见文本
• 容器和标题中的 comment、reply、discussion、评论、回复、留言等语义

搜索框、订阅框、联系表单、问卷、客服、订单、支付、登录、注册、举报、删除和管理操作会被降权或直接排除。

4. 提交按钮识别

提交按钮通过以下方式识别：

• button 或 input[type="submit"]
• id、name 中的 submit、post、publish、send、reply、respond
• 按钮文本中的提交评论、发表评论、发布回复等语义
• WordPress 的标准提交标识

搜索、订阅、预览、取消、删除、举报、点赞、投票、分享、登录和注册按钮不会被当作评论提交按钮。

5. 姓名、邮箱和 Website 字段

字段识别会综合：

• type
• autocomplete
• inputmode
• id、name、class
• Placeholder
• ARIA Label
• <label> 和 aria-labelledby

扩展还会读取 required、aria-required、必填容器以及标签中的星号，确认姓名、邮箱或 Website 是否为必填项。

6. 隐藏评论入口

如果页面初始没有显示评论表单，扩展会尝试寻找一个安全的同页按钮，例如：

• Leave a comment
• Write a reply
• Join the discussion
• 发表评论
• 我要留言

只会尝试一次，并且不会点击会跳转页面、提交表单、登录、注册、举报或执行破坏性操作的控件。

7. iframe 支持

支持：

• 页面主 DOM
• 开放 Shadow DOM
• 同源 iframe
• Jetpack Comments 的专用评论 iframe

不支持无法安全访问的第三方跨域评论组件，例如部分 Disqus、Giscus 或 Hyvor 嵌入。此类页面会记录：

CROSS_ORIGIN_COMMENT_FRAME_UNSUPPORTED

评论正文的生成逻辑

推广网站资料

每个批次开始前，扩展会获取推广网站：

• 最终规范化 URL
• Meta Title、Open Graph Title 或页面 Title
• Meta Description、Open Graph Description 或 Twitter Description

网站资料会缓存在本地，避免每个目标都重复请求。

模型提供商

当前支持：

• DeepSeek 官方 API：deepseek-v4-flash
• KIE OpenAI-compatible/Gemini API：gemini-3.5-flash

扩展直接从浏览器调用所选模型，不需要配套服务器。

生成要求

发送给模型的上下文包含：

• 推广网站标题、描述和 URL
• 目标页面标题、描述、正文摘要和语言
• 目标表单是否存在 Website 字段
• 当前链接写入模式

模型被要求：

• 针对目标页面中的具体观点写评论。
• 避免只有“好文章”“感谢分享”等空泛内容。
• 不虚构个人经历、产品使用、身份、结果或与作者的关系。
• 避免关键词堆砌、重复品牌名和明显销售语言。
• 使用目标页面的主要语言。
• 忽略目标页面正文中试图指挥模型的提示词。
• 返回严格 JSON：{"comment":"..."}。
• 评论正文最长 2000 个字符。

链接写入规则

模型不负责写链接。它只返回带一个 {LINK} 占位符的纯文本，锚点由扩展拼接后替换进去：

<a href="https://example.com">自然锚文本</a>

校验的对象是模型返回的模板，不是拼接后的成品：

• 必须恰好包含一个 {LINK} 占位符。
• 去掉占位符后，正文中不允许出现任何 URL。
• 不允许 HTML 标签、Markdown 链接或 BBCode。
• 评论正文最长 2000 个字符。

因为 href 由扩展提供、锚文本由算法从词池中选定，拼接后不再重复校验。安全不变量仍然是“恰好一条链接，指向当前推广网站”：提示注入最多让模型写出一个外站 URL，而模板中的 URL 数必须为 0。

提交前还有一道独立的 DOM 防线，确认评论正文中确实带有指向推广网站的锚点。同一批次中出现相同评论指纹时，会标记为重复生成并停止提交该条评论。

锚文本的具体选取方式见锚文本配比。

当前代码行为：正文始终保留一个内联锚点；如果页面同时存在 Website 字段，扩展也会把推广网站 URL 填入该字段。

评论正文写入页面的逻辑

扩展将“填写”和“点击提交”拆成两个阶段，避免页面变化后误点错误按钮。

1. 填写阶段

对于原生输入框和 textarea：

• 调用浏览器原生 value setter。
• 触发 input 和 change 事件。
• 对评论编辑器额外触发 keyup，兼容依赖键盘事件更新状态的页面。

对于 contenteditable、ProseMirror、Quill 和 Lexical：

• 聚焦编辑器。
• 写入文本内容。
• 触发 InputEvent 和 change 事件。

随后填写可识别的：

• 显示名称
• 邮箱
• Website URL

2. 提交前校验

写入完成后，扩展会等待提交按钮解除禁用，然后重新扫描页面并确认：

• 页面 URL 没有变化。
• 评论编辑器仍是之前识别的编辑器。
• 提交按钮仍是之前识别的按钮。
• 姓名、邮箱和 Website 字段数量没有变化。
• 所有字段中的值与准备提交的值一致。
• 评论正文没有被页面脚本替换或清空。

校验通过后，扩展会为本次提交创建一个短期、一次性的 DOM Token，同时保存提交前的反馈消息和评论渲染状态作为 Baseline。

3. 点击阶段

在真正点击之前，批次状态先持久化为：

click_dispatched

点击前会再次检查 DOM Token、元素引用、字段值和页面结构。任何一项不一致都会终止点击并记录：

PAGE_CHANGED_SINCE_GENERATION

这样可以避免页面重新渲染后，扩展对错误的按钮执行提交。

4. 提交结果验证

点击后，扩展根据以下信号判断结果：

• 新出现的成功、待审核或错误提示
• WordPress 的 unapproved 和 moderation-hash 回执
• WordPress 评论提交后的 URL 回执
• 页面中是否新增包含评论指纹的评论内容
• 评论是否仍停留在编辑器中
• 是否出现登录或验证码页面
• 是否出现重复评论提示
• 已渲染链接的 rel 和落点，可识别 dofollow、nofollow、ugc、链接被移除或等待审核等状态

如果已经触发点击，并且页面没有明确返回失败，当前版本会将该目标记录为 submitted。

submitted 表示扩展已完成提交操作或收到站点接受信号，不等同于评论已经公开可见、被搜索引擎收录或产生 SEO 效果。

待审核评论定时复查

对于已经提交但尚未公开显示的评论，看板提供独立的“定时复查”页面：

• 默认每 6 小时扫描一批持久化的待审核记录，并限制单次检查数量。
• 复查过程只读取目标页面，不会再次填写或提交评论。
• 检测到原评论指纹公开出现后，会同步更新目标状态和尝试记录。
• 支持手动添加“评论页面 + 推广网站”组合、立即复查单条记录以及查看最近检查结果。
• 定时任务会复用专用验证标签页，并在完成或加载失败后关闭该标签页。

跳过、停止与恢复

登录和验证码

遇到以下情况会标记并跳过当前目标，批次继续处理下一条：

• 页面明确要求登录后评论
• 跳转到登录、注册、账号或身份验证路径
• 页面出现 reCAPTCHA、hCaptcha 或 Cloudflare Turnstile

识别结果会同步写入外链库。后续批次再次遇到已知需要登录或验证码的域名时，会在打开页面前直接跳过。

防止重复提交

扩展会在关键动作之前保存下一阶段：

• 模型请求前保存 COMMENT_GENERATION_REQUESTED
• 点击前保存 click_dispatched

如果模型请求结果未知，恢复后不会盲目重复生成。

如果点击是否成功未知，恢复后会进入 verifying，只验证原来的提交结果，不会再次点击评论按钮。

手动停止批次时，已经处于 click_dispatched 或 verifying 的目标会保留其准备数据，以便继续时验证原提交，而不是重复发布。

后台工作标签页

扩展只使用一个可复用的后台工作标签页：

• 标签页不会在处理每个链接时自动抢占当前窗口焦点。
• 标签页会被放入折叠的 Comment Assistant 标签组。
• 登录或验证码目标会被标记并跳过，不会占住后台工作标签页。
• 每次读取、导航和执行页面命令前都会校验 { batchId, tabId } 所有权。
• 所有权标记保存在 chrome.storage.session 中，浏览器重启后不会信任旧 tabId。
• 批次完成或停止后，会自动关闭属于该批次的工作标签页。

数据与权限

本地数据

以下数据保存在浏览器本地：

• 推广网站配置
• 每个网站的锚文本配比与用词统计
• 模型 API Key
• 计划、批次、目标和尝试记录
• 当前批次快照和恢复状态
• 过滤列表
• 外链库

看板数据主要使用 IndexedDB，当前运行状态与设置使用 chrome.storage.local，工作标签页所有权使用 chrome.storage.session。

API Key

DeepSeek 和 KIE API Key 保存在 chrome.storage.local，并限制为可信扩展上下文访问。Key 只发送给用户选择的模型提供商，不会注入目标页面，也不会写入批次快照或评论正文。

Chrome 权限

固定权限：

• storage：保存设置、计划和进度。
• unlimitedStorage：保存较大的计划、历史和尝试记录。
• activeTab：在用户操作后读取当前标签页。
• scripting：按需注入页面分析和表单操作逻辑。
• alarms：Service Worker 被挂起后唤醒恢复任务。
• sidePanel：展示侧边栏控制界面。
• tabGroups：管理后台工作标签页分组。
• webNavigation：跟踪提交后的导航状态。

固定 Host 权限：

• https://api.deepseek.com/*
• https://api.kie.ai/*
• http://*/*
• https://*/*

目标网站权限在安装时一次性授予，运行批次和读取推广网站资料时不会再逐站弹窗。安装时 Chrome 会提示“读取和更改您在所有网站上的数据”——这正是扩展打开任意博客、识别评论表单并提交评论所需要的权限。

扩展没有常驻 <all_urls> Content Script，脚本按需注入且只注入到用户导入的目标页面；扩展也不依赖宽泛的 tabs 权限。

安装方式

安装已发布版本

1. 打开项目的 Releases 页面。
2. 在对应版本的 Assets 中点击 Chrome extension ZIP 下载扩展安装包。不要下载 Source code (zip) 或 Source code (tar.gz)，它们是未构建的源码，不包含 manifest.json。
3. 解压下载的 ZIP 文件。
4. 打开 chrome://extensions/，开启右上角的“开发者模式”。
5. 点击“加载已解压的扩展程序”，选择解压后直接包含 manifest.json 的目录。

环境要求

• Node.js 22 或更高版本
• pnpm
• Chrome 或兼容 Manifest V3 的 Chromium 浏览器

插件首次安装时默认使用简体中文。打开运营看板左下角的“设置”，在“界面语言”中可以切换为 English；语言选择会同步应用到侧边栏和运营看板，并保存在浏览器本地。

从源码构建

git clone https://github.com/codeugar/comment-link-assistant-extension.git
cd comment-link-assistant-extension

pnpm install
pnpm typecheck
pnpm test
pnpm build

生产构建输出目录：

.output/chrome-mv3/

在 Chrome 中安装源码构建

1. 打开 chrome://extensions/。
2. 开启右上角的“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择项目中的 .output/chrome-mv3/ 目录。
5. 将扩展固定到浏览器工具栏。
6. 点击扩展图标打开侧边栏。
7. 通过侧边栏中的运营看板入口打开完整看板。
8. 在设置中填写模型 API Key 和推广网站资料。

首次运行某个计划时，Chrome 会要求授权访问推广网站和计划中的目标站点。

开发模式

pnpm dev

WXT 会启动开发构建和热更新。按照终端输出加载对应的开发构建目录。

生成安装包

pnpm zip

压缩包会生成在 .output/ 目录中。

常用开发命令

命令	用途
pnpm dev	启动 WXT 开发模式
pnpm build	构建 Chrome Manifest V3 生产版本
pnpm zip	生成扩展压缩包
pnpm test	运行 Vitest 测试
pnpm typecheck	运行 TypeScript 类型检查
pnpm lint	运行 Biome 检查
pnpm format	使用 Biome 格式化代码

主要目录

entrypoints/
  background.ts          后台 Service Worker 和消息调度
  sidepanel/             快速操作、设置和当前批次控制
  dashboard/             运营看板与计划管理界面

src/
  anchor/                锚文本类别、选词算法与词池处理
  api/client.ts          模型请求、正文解析和链接安全校验
  batch/runner.ts        批次状态机和恢复逻辑
  batch/state.ts         批次与目标状态变更
  dashboard/             看板数据库、汇总和计划服务
  page/dom.ts            页面分析、表单识别、填写、点击和验证
  runtime/               页面命令、权限和工作标签页管理
  storage/               设置、快照、过滤列表和本地数据
  website/               推广网站资料提取与缓存

已知限制

• 第三方跨域评论 iframe 无法安全访问时，需要人工处理。
• 登录和验证码不会被自动绕过。
• 页面在生成评论后重新渲染或改变表单结构时，提交会被阻止并记录校验错误。
• 某些站点会过滤 HTML、移除链接、添加 nofollow 或要求审核，扩展无法保证最终外链属性。
• submitted 是提交操作状态，不是公开展示、搜索收录或 SEO 结果保证。
• 用词统计只覆盖功能上线后发布的外链，更早的记录只保留类别总数。
• 自动化评论必须遵守目标网站规则、适用法律和社区规范。