跳到主要内容
AI教程

使用 vn-law-check 审查网站和应用中的越南法律风险

了解如何安装 vn-law-check、扫描源代码或公共网站、解读按优先级排列的发现、请求修复并起草隐私材料。本教程涵盖受支持的 AI 代理、移动应用检查、高级扫描行为以及该项目的重要法律限制。

使用 vn-law-check 审查网站和应用中的越南法律风险

什么是 vn-law-check?

vn-law-check 是一套免费的指令、检查清单、参考资料和扫描脚本,可帮助 AI 编码代理根据越南法律审查网站和移动应用是否存在潜在合规风险。它支持 Claude Code、Cursor、GitHub Copilot、Windsurf、Cline 和 Codex。

你可以要求代理审计一个项目,它会检查代码中的相关功能,按文件和行号识别可能存在的问题,引用适用的法律条款,并提出修改建议。随后,你可以要求代理处理高优先级问题。

咖啡店和静态博客的审计示例

当应用收集姓名、电子邮件地址或电话号码;使用 Google Analytics 或 Facebook Pixel 等服务;提供账户、购物车或支付功能;或包含 AI 聊天机器人时,该项目尤其适用。它也可以审查简单的静态网站,并在未发现相关数据收集时予以说明。

vn-law-check 是初步审查工具,不能替代律师。它生成的报告和政策草案可能不完整或不准确,关键问题应由具备资质的法律专业人士审核。

主要功能

  • 源代码和 URL 审计:审查本地项目,或扫描网站公开可访问的页面。
  • 文件级问题定位:报告可以指出文件、行号、存在问题的文本或实现、法律依据以及建议的修正方案。
  • 结果分级:问题分为 🔴 需要立即处理、🟡 建议改进、🟢 符合要求或 ⚪ 不适用。
  • 隐私政策起草:代理可以根据代码中检测到的数据流和第三方服务起草隐私政策。
  • 同意机制指导:检查清单包含对同意表单和 Cookie 横幅的指导。
  • 移动应用支持:扫描器可以检查权限、跟踪或广告 SDK,以及账户删除功能。
  • 支持多种 AI 工具:仓库文件采用结构化方式,使受支持的代理能够通过各自偏好的指令格式加载相同的核心合规指导。

涵盖的法律领域

仓库称其参考资料包含截至 2026 年 11 月仍有效的越南法律文件。涵盖领域包括个人数据保护、电子商务、网络安全、广告、人工智能、消费者保护和电子交易。完整文本链接及生效日期维护在 sources/legal-references.md 中。

README 特别强调《个人数据保护法》91/2025 和第 356/2025 号法令。文档指出,自 2026 年 1 月 1 日起,组织必须明确披露收集个人数据的目的,并以适当方式取得同意。仓库还提醒,不要继续使用仍引用已被替代法规的过时政策。

安装和设置

选项 1:在 Claude Code 中安装

请在 Claude Code 内输入以下命令,而不是在普通终端中输入:

/plugin marketplace add mhfed/vn-law-check
/plugin install vn-law-check

安装完成后,在 Claude Code 中打开要审查的项目。

选项 2:为 Cursor、Windsurf、Copilot、Cline 或 Codex 安装

在项目目录中打开终端并运行:

curl -fsSL https://raw.githubusercontent.com/mhfed/vn-law-check/main/install.sh | bash

安装程序会将检查清单放入 .vn-law-check/,不会覆盖项目文件。如果项目中已经存在 AGENTS.md 或 CLAUDE.md 等指令文件,脚本只会添加一条简短的已安装检查清单引用。再次运行安装程序时,它会更新集成内容,不会插入重复引用。

选项 3:手动克隆技能

如需在不使用 marketplace 的情况下为 Claude 全局安装该技能,请运行:

git clone --depth=1 https://github.com/mhfed/vn-law-check ~/.claude/skills/vn-law-check

如需为特定项目安装,请将其克隆到该项目内的 .claude/skills/vn-law-check,不要使用主目录路径。

运行首次法律审计

审计已打开的项目

在受支持的 AI 编码代理中打开项目,并输入仓库推荐的越南语提示词:

audit pháp lý website này theo luật Việt Nam

其含义是“根据越南法律审计此网站”。代理会先判断网站类型,然后应用相关检查清单。根据项目情况,它可能会查找表单、跟踪器、账户系统、购物功能、支付、AI 集成、托管信息及相关披露。

审计公开 URL

如果你没有源代码,请提供公开网站地址:

audit pháp lý https://ten-mien-cua-ban.vn

对于 URL 审计,仓库中的 fetch-site.sh 脚本会从指定网站下载公开页面,以便 scan.sh 对其进行检查。根据 README,该过程最多处理 15 个页面和来自同一域名的 20 个 JavaScript 文件,不会将收集的网站数据发送到其他地方。

仅通过 URL 进行的扫描无法检查未公开暴露的私有服务器代码或配置。应将其结果视为对可访问网站的审查,而不是对底层系统的完整评估。

了解报告

每项结果都会获得以下四种分类之一:

  • 🔴 需要立即处理:可能存在严重问题,应及时调查并纠正。
  • 🟡 建议改进:存在薄弱环节或实现不完整,应予以改进。
  • 🟢 满意:经审查的项目似乎符合相关检查清单的要求。
  • ⚪ 不适用:该要求不适用于经审查的项目或功能。

检查结果可能会指出存在问题的文本、其来源位置、所引用的法律依据以及建议的修改方案。演示中的一个示例指出,某隐私政策将继续使用网站视为同意。报告引用了《第91/2025/QH15号法律》第9条第4款第d点,其中规定不得将沉默或未作回应视为同意,并建议在收集数据时请求明确同意。

如果博客或静态网站不收集相关信息,报告可能只会给出简短结论,而不是列出大量检查结果。

要求代理修复关键问题

审阅报告后,可以要求代理处理红色项目:

sửa giúp các mục 🔴

这句话的意思是“修复 🔴 项目”。在接受修改前,请审阅拟议的变更,测试受影响的表单和跟踪行为,并确认实现符合实际业务流程。代码变更无法核实仓库中不存在的组织事实。

生成隐私政策草案

如果项目缺少隐私政策,或当前使用的是通用的复制版政策,可以请求生成针对项目的草案:

soạn chính sách bảo mật cho dự án này

代理可以检查代码,以确定应用程序似乎收集哪些数据,以及哪些服务可能接收这些数据,包括 Google Analytics、Firebase 或 OpenAI 等集成服务。随后,它可以起草政策文本,并建议更新同意表单和 Cookie 横幅。

无法从代码中确定的信息,例如组织的法定名称或税务识别号,会留空供你填写。在发布草案前,请核实每个字段、数据用途、接收方、保留做法和联系方式。

高级使用技巧

尽可能优先进行源代码审计

本地源代码审计可以检查公共 URL 可能无法显示的实现细节。仓库说明,扫描代码目录时,scan.sh 只读取本地文件。因此,源代码审计更适合发现嵌入式 SDK、条件式跟踪器、移动端权限、账户删除逻辑,以及从渲染页面中不易发现的集成。

检查同意前的跟踪行为

请特别关注访客作出同意选择前就加载的分析和广告脚本。同时确认隐私声明准确描述项目中发现的服务,并且不将持续浏览、沉默或不活动视为同意。

区分技术事实与业务事实

代理可以推断许多实现细节,但无法仅凭代码可靠地发现所有运营做法。请向组织内的负责人确认数据控制者身份、保留期限、内部访问规则、跨境处理、合同关系和客户支持流程等事实。

无需 AI 代理也可使用检查清单

当前自动化工作流要求使用受支持的 AI 工具之一。如果你不使用 AI 编程代理,仍可以阅读仓库 references 目录中的文件,并将其作为手动自查清单。

负责任地处理第三方审计

如果扫描的不是你拥有的网站,请对结果保密,并直接发送给网站所有者。该项目明确建议,不要仅依据扫描结果公开羞辱相关组织。

仔细审阅未经核实的参考资料

维护者自称开发者而非律师,并将尚未与完整法律文本核对的参考资料标记为 CHƯA XÁC MINH,意为“尚未核实”。README 说明仍有数十项此类内容,主要位于处罚参考资料和第356/2025号法令材料中。请对这些条目格外谨慎。

提交更正

法律引用和检查清单可能发生变化,因此社区审查十分重要。你可以提交 GitHub issue,报告错误的条款编号、过时的文件、不准确的处罚、遗漏的法律、检查清单未涵盖的常见问题或错误的网站分类。附上原始法律文本的链接,有助于维护者核实更正内容。

提交拉取请求的开发者应编辑仓库列出的源文件,运行 tools/sync.sh 重新生成工具专用副本;如果修改了 scripts/scan.sh,还应运行 tests/run.sh。如果生成的副本未同步,持续集成会报告错误。

费用、许可和限制

该仓库免费使用。你唯一的使用成本,是现有编程工具收取的 AI 使用费用。代码和仓库结构采用 MIT 许可证;所引用的越南法律文本属于政府公开文件,不受该软件许可证覆盖。

最重要的是,审计并不能保证完全符合法律要求。使用 vn-law-check 来发现可能存在的缺口、安排整改工作并创建初稿。在将其用于生产环境之前,应让具备资质的法律专业人士审查关键发现和政策文件。

结论

vn-law-check 在越南合规清单与 AI 辅助软件开发之间提供了实用的衔接。将其安装到受支持的代理中,审计源代码或公开 URL,查看按优先级排序的报告,并请求针对性的修复或隐私政策草案。该工作流程可以加快初步审查,但最终的法律决策仍需要经过核实的事实、最新的法律原文以及专业判断。