feat(os/gcfg): Add file watcher with custom callback support

[LanceAdd]

为gcfg添加配置文件变更自定义回调，实现了WatcherAdapter接口，以下是AdapterFile的用法
test.yaml

b: "b"

package main

import (
	"fmt"
	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/os/gcfg"
	"github.com/gogf/gf/v2/os/gctx"
)

func main() {
	ctx := gctx.New()
	file, _ := gcfg.NewAdapterFile("test.yaml")
	file.Data(ctx)
	file.AddWatcher("test", func() {
		value := file.MustGet(ctx, "b")
		fmt.Println(value.String())
	})
	server := g.Server()
	server.Run()
}

使用g和默认配置文件

	file := g.Cfg().GetAdapter().(*gcfg.AdapterFile)
	file.AddWatcher("test", func() {

	})
	file := g.Cfg().GetAdapter().(*gcfg.AdapterFile)
	file.RemoveWatcher("test")

注意：由于gf的AdapterFile使用的监听到文件变化删除缓存下一次重新初始化的懒加载方案，所有除了默认加载的config.xxx文件外，自定义的配置文件像test.yaml之类的都需要在AddWatcher前主动读取一次数据进行初始化监听(
g.Cfg("test").Data(ctx))

[hailaz]

@LanceAdd 看实现的功能，只能知道文件变化了，但不知道文件是由哪个事件引起的变化，是不是应该将变化的具体情况也透传一下？

[hailaz]

@LanceAdd 看实现的功能，只能知道文件变化了，但不知道文件是由哪个事件引起的变化，是不是应该将变化的具体情况也透传一下？

另外可能要考虑一下是否预置一个ctx context.Context参数

[wln32]

@LanceAdd 看实现的功能，只能知道文件变化了，但不知道文件是由哪个事件引起的变化，是不是应该将变化的具体情况也透传一下？

另外可能要考虑一下是否预置一个ctx context.Context参数

赞同，是否也应该增加一个file参数？

[LanceAdd]

@LanceAdd 看实现的功能，只能知道文件变化了，但不知道文件是由哪个事件引起的变化，是不是应该将变化的具体情况也透传一下？

我在内部魔改的版本是带个ctx参数，把这些信息都放到ctx里面，需要什么就去ctx里拿，不同实现的Adapter结构体参数可能不一样。
这个不加的原因是gcfg的具体实现像AdapterFile，AdapterContent还有AdapterNacos这些的配置缓存的更新方式和配置来源元数据都不相同，有的懒加载有的主动刷新，然后是只要个path的本地文件，有的是需要namespace/groupId之类的，没法统一，不知道大家能不能接受，所以才希望大家不关注具体细节，只关注事件发生以及触发后自己去读自己需要的东西进行具体操作。如果大家能接受ctx的方案，我明天加一下，或者有其他方案也可以让我学习一下

[Copilot]

Pull Request Overview

This PR adds file watcher functionality with custom callback support to the gcfg package. It implements the WatcherAdapter interface for both AdapterFile and AdapterContent types, allowing users to register callbacks that are triggered when configuration changes occur.

Key changes:

• Adds WatcherAdapter interface with AddWatcher and RemoveWatcher methods
• Implements watcher functionality in both AdapterFile and AdapterContent with callback notification
• Adds comprehensive test coverage for watcher functionality including file changes, content updates, and watcher removal

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
os/gcfg/gcfg_adaper.go	Defines the new WatcherAdapter interface
os/gcfg/gcfg_adapter_file.go	Implements watcher functionality for file-based configurations
os/gcfg/gcfg_adapter_content.go	Implements watcher functionality for content-based configurations
os/gcfg/gcfg_adapter_file_content.go	Adds watcher notifications to content manipulation methods
os/gcfg/gcfg_z_unit_watcher_test.go	Comprehensive test suite for watcher functionality

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[hailaz]

@wln32 cc

[Copilot]

Pull Request Overview

Copilot reviewed 20 out of 20 changed files in this pull request and generated 8 comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}