small-packages/simple-obfs/README-maintenance.md

simple-obfs 维护说明（维护模式）

当前定位

simple-obfs 已长期停更。当前仓库策略是：

• 以 兼容性维护 为主（保证新工具链可编译）
• 不做大规模功能迭代
• 优先保证打包可复现、构建稳定

关键设计

1) 版本来源

• 上游基础：simple-obfs v0.0.7
• 本仓库发布：v0.0.9（仅做构建可复现增强）

2) libcork 处理

历史问题：v0.0.7 的 libcork 是 submodule gitlink，tarball 不含子模块内容，导致构建中 autoreconf/Makefile 链路失败。

当前方案：

• 在 kenzok8/simple-obfs v0.0.9 中直接 vendor libcork 源码
• 打包阶段不再在线 git clone libcork
• OpenWrt 包仅使用固定 tarball + hash

收益：

• 构建可复现
• 减少 CI 网络依赖
• 降低“偶发失败”概率

打包规范

Makefile 关键字段：

• PKG_VERSION:=0.0.9
• PKG_SOURCE_URL:=https://codeload.github.com/kenzok8/simple-obfs/tar.gz/v$(PKG_VERSION)?
• PKG_HASH:=f9c05de42608691dad77c707504ad855191cd26ccd7095a0b3d4be939055111e
• PKG_FIXUP:=autoreconf

排错要点

1. 先看 logs/package/feeds/packages_ci/simple-obfs/compile.txt
2. 常见失败关键词：
   • No targets specified and no makefile found
   • required file 'libcork/Makefile.in' not found
3. 优先确认：
   • 版本和 hash 是否一致
   • 是否误回退到旧版（v0.0.7）

未来路线（建议）

• simple-obfs 保持兼容包定位
• 新能力优先放到更活跃的替代方案
• 若要继续维护，仅做最小兼容补丁（工具链/警告）