refactor(backend): rename OpenFlare directory to lowercase openflare

This commit is contained in:
ryan
2026-08-30 17:43:23 +08:00
parent 06d5fedbfc
commit c93ff6674f
543 changed files with 819 additions and 819 deletions
+26
View File
@@ -0,0 +1,26 @@
# share — 跨插件共享资源层
本目录存放被 **两个及以上插件共同消费**、且无处安放的可复用资源:
- 不能放 `Wavelet/pkg/`:该层是上游通用库,禁止包含业务语义。
- 不能放进某个插件内部:Cordis 规则禁止插件之间互相 import 实现包。
因此 `share/` 是内核(`core/`)之外唯一允许被任意插件直接 import 的共享层。
本目录内的包**禁止** import `Wavelet/openflare/...`(下游业务)与 `Wavelet/plugins/...`(具体插件实现),
只允许 import 标准库、第三方库与 `Wavelet/core`、`Wavelet/pkg`。
## 当前内容
| 包 | 内容 | 消费方 |
| :-- | :-- | :-- |
| `share/protocol` | server 与边缘三进制的控制消息线格式 | `server`、`agent`、`relay`、`flared` |
| `share/geoip` | GeoIP 解析与 IP 工具(含 `iputil` 子包) | `server`、`agent` |
| `share/edge/logging` | 边缘守护进程统一日志初始化 | `agent`、`relay`、`flared` |
## 所有权与上游同步
**本目录由 OpenFlare 拥有,不属于上游 merge 范围**:`git merge wavelet/main` 吸收
`backend/{core,pkg,plugins}` 等上游变更,从不覆盖 `share/` 与 `openflare/`。
计划迁入的候选(随插件化进度):`wsclient`(需先合并 `pkg/util` 的仅存符号)、
`render`(openresty 配置渲染)、`pagesarchive`(Pages 产物解包)。