核心用法
wip-license-guard 是一款面向开源项目维护者的许可证合规自动化工具，专注于解决多仓库许可证标准化难题。其核心工作流围绕三个命令展开：
1. `check` —— 审计模式扫描源代码文件的版权头完整性，检测LICENSE文件缺失，识别不符合既定许可证模式的文件；附加 --fix 标志可自动注入标准版权头、生成或修复LICENSE文件。
2. `init` —— 交互式配置初始化，支持从零开始建立许可证策略；--from-standard 选项可一键应用WIP Computer组织预设的MIT/AGPLv3双许可证模板，零配置开箱即用。
3. `readme-license` —— 针对README文档的专项审计工具，提供audit/dry-run/fix三阶段工作流，智能区分主仓库与子工具目录，避免在不适用的位置强制插入许可证声明。
工具采用Node.js实现，依赖Git环境，通过npm分发，CLI设计遵循Unix哲学，支持单仓库或批量目录操作。
显著优点
- 双许可证原生支持：内置MIT/AGPLv3组合模式，满足 copyleft 与宽松许可的并存需求，避免手动维护两份声明的繁琐与错误风险。
- 批量治理能力：
readme-license支持对整个项目目录树批量处理，适合维护者统一管理数十个微仓库的许可证一致性。
- 安全优先的修复策略：所有写操作需显式声明
--fix，默认dry-run预览机制防止意外覆盖，审计日志清晰可追溯。
- 子工具感知：自动识别子目录是否为独立工具，避免在内部模块错误放置顶层许可证声明，减少维护噪音。
潜在缺点与局限性
- 许可证生态局限：当前仅深度优化MIT/AGPLv3双模式，GPLv2、Apache-2.0、BSD家族等其他许可证组合需自定义配置，自动化程度下降。
- Node.js环境绑定：非Node项目或容器化构建环境需额外安装运行时，对纯Go/Rust/Python生态的项目集成成本略高。
- 版权头侵入性：自动注入的版权头可能破坏某些语言特定的文件头规范（如特定格式的shebang或编码声明），需人工复核。
- 无SPDX集成：缺少与SPDX标准标识符的深度整合，无法自动生成SBOM所需的许可证元数据。
适合人群
- 需要维护多仓库开源项目的独立开发者或小型组织
- 采用MIT/AGPL双许可策略的SaaS开放核心模式团队
- 发布前需强制合规检查的CI/CD流水线维护者
- 希望标准化遗留项目许可证声明的技术负责人
常规风险
- 过度修复风险：
--fix模式可能覆盖手写的许可证例外声明或第三方代码的原始版权声明，执行前务必通过dry-run确认变更范围。 - 法律解释局限：工具仅机械执行配置模板，无法替代法律顾问对许可证兼容性、专利授权条款的解读，关键商业决策仍需专业审核。
- 配置漂移：
--from-standard依赖上游模板更新，长期未同步可能导致组织内新旧项目许可证声明版本不一致。