核心功能
wip-license-guard 是一款面向开源项目的 CLI 许可证合规工具,专为维护多仓库许可证一致性而设计。其核心能力包括:
1. 版权与许可证头检查
- 扫描源码文件,确保包含正确的版权声明
- 支持
--fix自动修复缺失或错误的头信息
2. 双许可证模式管理
- 专为 MIT/AGPLv3 双许可证场景设计
- 标准化 LICENSE 文件和 CLA(贡献者许可协议)处理
3. README 许可证区块管理
readme-license子命令提供三种模式:- 审计模式:识别非标准、缺失或需要移除的许可证区块
- 预览模式 (
--dry-run):展示变更预览,零风险 - 修复模式 (
--fix):批量应用标准双许可证声明 - 智能区分主仓库与子工具仓库,避免过度添加
4. 项目初始化与配置
- 交互式配置向导 (
init) - 企业/团队标准一键应用 (
--from-standard)
显著优点
- 批量能力:支持单仓库或整个目录结构的批量处理
- 安全设计:dry-run 预览机制,修复操作可审计
- 双许可证专业支持:针对 copyleft 与宽松许可证并存的复杂场景
- 低依赖:仅需 Node.js 和 Git
潜在局限
- 作者背景(WIP Computer)公开信息有限,项目权威性待社区验证
- 目前聚焦特定双许可证模式(MIT/AGPL),通用性有限
- 缺乏 CI/CD 集成示例,手动运行为主
适合人群
- 维护多开源仓库的独立开发者或小团队
- 采用 MIT/AGPL 双许可证策略的项目
- 需要统一组织级许可证规范的 DevOps 团队
常规风险提示
- 自动修复可能覆盖现有许可证声明,建议配合版本控制使用
- 法律合规工具非法律建议,关键决策仍需专业法务审核