接入文档
无尽书证提供 Waline 兼容的托管评论服务。注册账号后创建实例，把实例 API 地址替换到现有 Waline 配置中即可。
1. 注册账号
使用 GitHub 完成 OAuth 登录，注册即自动创建账号。
2. 创建实例
在控制台创建实例，得到 instance.waline.infvar.com/{标识} 地址。
3. 配置接入网站
在实例编辑页填写自己的博客域名，开启 CORS 防盗链。
4. 替换 serverURL
在 Waline 客户端中把 serverURL 指向实例地址，客户端会自行请求 /api 接口。
创建实例
登录后进入「实例」页面，点击「新建实例」。完成 PoW 人机验证后填写实例名称， 系统会自动生成实例标识和专属 API 地址。
实例地址格式为 https://instance.waline.infvar.com/{标识}。Waline 客户端会自动在实例地址后请求 /api 评论接口。
你可以在实例列表中复制 API 地址、启停实例，或进入实例编辑页配置审核、敏感词和微信通知。
在「编辑实例」中填写允许接入的网站地址（每行一个）后，其他网站将无法跨域调用该实例的评论 API。
Waline 接入
引入 Waline 客户端时，把 serverURL 设置为实例地址。以下示例使用 Waline 官方客户端。
<link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
<div id="comments"></div>
<script type="module">
import { init } from "https://unpkg.com/@waline/client@v3";
init({
el: "#comments",
serverURL: "https://instance.waline.infvar.com/myblog",
path: location.pathname,
lang: "zh-CN",
dark: "auto"
});
</script>如果你的站点使用了 VuePress、VitePress 或 Hexo 的 Waline 插件，只需把 插件配置里的 serverURL 替换为实例地址，其他配置保持不变。
API 概览
以下接口使用实例地址作为服务端根路径。
/api/comment?path=/post获取指定页面的评论列表/api/comment提交新评论/api/comment/:objectId获取单条评论/api/user?token=...获取当前评论用户信息/api/article?path=/post获取文章评论计数/api/token使用 Waline Token 换取用户数据创建评论时需要携带表单数据与可选的人机验证 Token。开启审核时评论默认进入待审核， 关闭审核时直接发布；敏感词审核命中的内容仍会进入待审核。
审核策略
每个实例都可以独立配置基础审核开关、敏感词模式、IP/用户黑名单以及匿名评论与 PoW 验证策略。付费套餐的 AI 垃圾审核由平台统一配置，实例只需打开开关。
敏感词支持「拦截」「替换」「转入待审核」三种动作；黑名单规则支持 IP、用户、 邮箱、链接与昵称五种维度。AI 审核使用 OpenAI 兼容接口，密钥支持多个并以英文逗号分隔轮询。 AI 审核与基础审核开关相互独立，打开 AI 垃圾审核后每条评论都会执行 AI 判定； 实例可设置 AI 垃圾判定阈值，AI 分达到阈值后会自动判为垃圾。
数据导入导出
在实例编辑页可以导出当前实例的 Waline 官方 JSON 数据，也可以导入 Waline、 Twikoo 或 Artalk 导出的 JSON 评论数据。导入会保留原文、状态、时间、回复关系 与浏览量数据，已存在的外键标识会自动跳过。
兼容 API
主 API 保持 Waline 兼容。实例地址同时提供 Twikoo（action 参数）、Artalk （/api/v2）和 Valine（/api/1.1/classes/Comment）的基础评论接口，便于迁移现有站点。
登录弹窗
无尽书证沿用 Waline 的登录弹窗协议：客户端打开 /ui/login，用户完成 OAuth 登录后弹窗通过 postMessage 返回 userInfo 并自动关闭。
Waline 官方客户端无需额外配置即可使用这一流程，第三方客户端也可以按相同 协议实现自定义登录。