补全 Append / DestinationReplacement / 文档修正

- TextFile 加 PolicyItem 和 Merge(TextFile) 方法处理 Append
- KVPFile 的 PolicyItem 上提至 TextFile，子类继承
- Program.cs 合并逻辑统一为 TextFile 分支，内部分发 KVPFile
- DestinationReplacement 在 ZIP 写入时用预编译 Regex 替换路径
- FloatingConfig 文档注释修正：内容替换表 → 目标地址替换表
- CompositionEntry 提取到独立文件

Author: zms9110750

src/Packer.Core/Model/Abstract/INamespaceProvider.cs

@@ -34,28 +34,3 @@ public interface INamespaceProvider
     /// </summary>
     IEnumerable<INamespaceResource> GetNamespaces(string modName, string version);
 }
-
-/// <summary>
-/// 命名空间资源。是资源包产出物的基本单元。
-/// </summary>
-public interface INamespaceResource
-{
-    /// <summary>所属模组标识（如 "jei", "minecraft"）</summary>
-    string ModName { get; }
-
-    /// <summary>命名空间名称（如 "minecraft", "cfpa"）</summary>
-    string NamespaceName { get; }
-
-    /// <summary>目标 Minecraft 版本（如 "1.21"）</summary>
-    string ModVersion { get; }
-
-    /// <summary>文件系统上的完整路径</summary>
-    string LocalPath { get; }
-
-    /// <summary>命名空间下的局域浮动配置（local-config.json），无则为 <see cref="FloatingConfig.Shared"/></summary>
-    FloatingConfig LocalConfig { get; }
-
-    /// <summary>打包策略集合，无则为 <see cref="PackerPolicy.Shared"/></summary>
-    PackerPolicy PackerPolicies { get; }
-
-}

src/Packer.Core/Model/Abstract/INamespaceResource.cs

@@ -0,0 +1,26 @@
+namespace Packer.Core.Model.Abstract;
+
+/// <summary>
+/// 命名空间资源。是资源包产出物的基本单元。
+/// </summary>
+public interface INamespaceResource
+{
+    /// <summary>所属模组标识（如 "jei", "minecraft"）</summary>
+    string ModName { get; }
+
+    /// <summary>命名空间名称（如 "minecraft", "cfpa"）</summary>
+    string NamespaceName { get; }
+
+    /// <summary>目标 Minecraft 版本（如 "1.21"）</summary>
+    string ModVersion { get; }
+
+    /// <summary>文件系统上的完整路径</summary>
+    string LocalPath { get; }
+
+    /// <summary>命名空间下的局域浮动配置（local-config.json），无则为 <see cref="FloatingConfig.Shared"/></summary>
+    FloatingConfig LocalConfig { get; }
+
+    /// <summary>打包策略集合，无则为 <see cref="PackerPolicy.Shared"/></summary>
+    PackerPolicy PackerPolicies { get; }
+
+}

src/Packer.Core/Model/Configuration/Config.cs

@@ -10,7 +10,7 @@ public record Config(BaseConfig Base, FloatingConfig Floating)
     /// <summary>
     /// 从命名空间下的局域配置加载内容。
     /// </summary>
-    public Config Modify(FloatingConfig floatingConfig)
+    public Config Modify(FloatingConfig? floatingConfig)
     {
         return this with { Floating = Floating.Merge(floatingConfig) };
     }

src/Packer.Core/Model/Configuration/FloatingConfig.cs

@@ -8,7 +8,7 @@
 /// <param name="InclusionPaths">强制包含的路径</param>
 /// <param name="ExclusionPaths">强制排除的路径</param>
 /// <param name="CharacterReplacement">文本字符替换表</param>
-/// <param name="DestinationReplacement">内容替换表</param>
+/// <param name="DestinationReplacement">目标地址替换表</param>
 public record FloatingConfig(
     IEnumerable<string> InclusionDomains,
     IEnumerable<string> ExclusionDomains,
@@ -65,16 +65,17 @@ public static FloatingConfig Load(INamespaceResource ns)
     /// <summary>
     /// 从另一对象合并配置
     /// </summary>
-    public FloatingConfig Merge(FloatingConfig other)
+    public FloatingConfig Merge(FloatingConfig? other)
     {
-        if (this == Shared)
-        {
-            return other;
-        }
+
         if ((other ??= Shared) == Shared)
         {
             return this;
         }
+        if (this == Shared)
+        {
+            return other;
+        }
 
         return new FloatingConfig(
             InclusionDomains: InclusionDomains.Union(other.InclusionDomains).ToFrozenSet(),

src/Packer.Core/Model/PackerPolicys/PackerPolicyItem.cs

@@ -73,7 +73,7 @@ protected IResourceFileProvider CreateProvider(string filePath, string relativeP
 
             case { parentDir: "lang" }:
             case { ext: ".txt" or ".json" or ".md" }:
-                return new TextFile(File.ReadAllText(filePath), relativePath) { Namespace = ns };
+                return new TextFile(File.ReadAllText(filePath), relativePath) { Namespace = ns, PolicyItem = this };
 
             default:
                 return new RawFile(filePath, relativePath) { Namespace = ns };

src/Packer.Core/Model/ResourceFile/KVPFile.cs

@@ -9,8 +9,6 @@ public abstract class KVPFile : TextFile
     /// <summary>键值对条目</summary>
     public Dictionary<string, string> Entries { get; protected set; } = [];
 
-    /// <summary>创建此 provider 的策略项，合并时读取 <c>ModifyOnly</c></summary>
-    public PackerPolicyItem? PolicyItem { get; set; }
     /// <param name="relativePath">在资源包中的相对路径</param>
     protected KVPFile(string relativePath) : base(relativePath)
     {

src/Packer.Core/Model/ResourceFile/TextFile.cs

@@ -7,6 +7,9 @@ public class TextFile : ResourceFileProvider
     /// <summary>生效的浮动配置，<see cref="GetContentStream"/> 写入前根据此配置做字符替换。</summary>
     public FloatingConfig? EffectiveConfig { get; set; }
 
+    /// <summary>创建此 provider 的策略项，合并时读取 <c>Append</c></summary>
+    public PackerPolicyItem? PolicyItem { get; set; }
+
     public TextFile(string content, string relativePath)
         : base(relativePath)
     {
@@ -16,6 +19,16 @@ public TextFile(string content, string relativePath)
     protected TextFile(string relativePath)
         : base(relativePath) { }
 
+    /// <summary>与另一个 TextFile 合并。</summary>
+    public virtual TextFile Merge(TextFile other)
+    {
+        if (this is KVPFile selfKvp && other is KVPFile otherKvp)
+            return selfKvp.Merge(otherKvp);
+        return other.PolicyItem?.Append == true
+            ? new TextFile(string.Concat(Content, Environment.NewLine, other.Content), RelativePath)
+            : this;
+    }
+
     public override Stream GetContentStream()
     {
         var text = Content;

src/Packer.Core/Program.cs

@@ -3,7 +3,7 @@
 // 入口：解析参数 → 加载配置 → 获取命名空间（全量/增量）
 //       → 按策略展开 Provider → 合并 → 替换 → 写 ZIP → MD5
 // ============================================================
- 
+
 // -- 参数解析 ------------------------------------------------------------------
 var versionOpt = new Option<string>("--version", "--v");
 var incrementOpt = new Option<bool>("--increment", "--i");
@@ -49,13 +49,15 @@
 // 其他类型冲突时保留第一个，打出警告
 var merged = allProviders.Select(group =>
 {
-    if (!group.Skip(1).Any()) return group.First();
-    if (group.All(p => p is KVPFile))
+    if (!group.Skip(1).Any())
+        return group.First();
+    if (group.All(p => p is TextFile))
     {
-        var r = group.Cast<KVPFile>().Aggregate((a, n) => a.Merge(n));
-        if (r is ResourceFileProvider rfp)
-            rfp.Namespace = group.Cast<KVPFile>().First().Namespace;
-        return r;
+        TextFile result = group.All(p => p is KVPFile)
+            ? group.Cast<KVPFile>().Aggregate((a, n) => a.Merge(n))
+            : group.Cast<TextFile>().Aggregate((a, n) => a.Merge(n));
+        result.Namespace = ((ResourceFileProvider)group.First()).Namespace;
+        return result;
     }
     Log.Warning("Destination 冲突但无法合并: {Dest}, 保留第一个", group.Key);
     return group.First();
@@ -76,12 +78,21 @@
 // -- 写入 ZIP -----------------------------------------------------------------
 var packName = $"./Minecraft-Mod-Language-Modpack-{config.Base.Version}.zip";
 await using var stream = File.Create(packName);
+var destReplacements = config.Floating.DestinationReplacement
+    .ToDictionary(kv => new Regex(kv.Key), kv => kv.Value);
+
 using (var archive = new ZipArchive(stream, ZipArchiveMode.Update, leaveOpen: true))
 {
     foreach (var p in merged.Concat(initialFiles))
     {
+        var dest = p.Destination;
+        foreach (var (pattern, replacement) in destReplacements)
+        {
+            dest = pattern.Replace(dest, replacement);
+        }
+
         using var content = p.GetContentStream();
-        var entry = archive.CreateEntry(p.Destination);
+        var entry = archive.CreateEntry(dest);
         using var es = entry.Open();
         await content.CopyToAsync(es);
     }