@cogita/plugin-comments 为文章页提供可选的第三方评论区接入能力,一期支持 Giscus 和 Utterances:前者使用 GitHub Discussions,后者使用 GitHub Issues。
插件不引入数据库、不在构建期访问 GitHub API,也不把提供商脚本打包进 Cogita。只有站点显式启用且配置校验通过时,Lucid 才会在文章页动态加载对应脚本。
enabled 默认关闭,避免未完成 GitHub 配置时意外加载第三方脚本。issueTerm: 'specific' 时还必须配置 term。虚拟模块只包含最终配置和文章路由列表,不包含 GitHub Token、评论内容或本地文件路径。第三方脚本仅在评论启用的文章页加载,授权由提供商和 GitHub OAuth 处理;加载失败时主题显示可访问的错误状态。
Knowledge 示例站点绑定公开评论仓库 wu9o/cogita-comments,使用 General Discussions 分类。首次启用前还需要安装 Giscus GitHub App。