Refactor code structure for improved readability and maintainability

.qoder/skills/simplified-technical-chinese/examples/after.md

@@ -0,0 +1,43 @@
+# 日志采集器部署指南
+
+本文档说明如何在生产环境部署日志采集器。读者是运维人员。
+
+## 前置条件
+
+- 服务器操作系统：Ubuntu 22.04 或 CentOS 8。
+- 磁盘剩余空间不小于 10 GB。
+- 服务器能访问镜像仓库 `registry.example.com`。
+
+服务器不能访问镜像仓库时，向网络组申请访问权限。审批时间为 1 至 3 个工作日。
+
+## 部署步骤
+
+1. 登录目标服务器。
+2. 切换到 `/opt` 目录。
+3. 创建工作目录 `/opt/collector`。工作目录存放配置文件和临时数据。
+4. 下载与服务器 CPU 架构匹配的安装包。
+5. 解压安装包。
+6. 在配置文件中，把 `server_addr` 改为服务端地址。
+7. 在配置文件中，把 `batch_size` 改为 200 至 500 之间的值。
+8. 运行启动命令。systemd 接管采集器。采集器每 10 秒把日志上报到服务端。
+9. 运行状态查询命令。系统显示 `active`。
+
+说明：架构不匹配时，安装包无法运行，系统显示错误「exec format error」。
+
+## 排查故障
+
+采集器无法启动时，按下面的步骤排查：
+
+1. 运行配置校验命令。
+2. 如果校验失败，按输出修改配置文件。
+3. 重启采集器。
+
+采集器的内存占用约为 200 MB。内存占用大于 500 MB 时，把 `batch_size` 调小到 200。
+
+## 调试模式
+
+需要查看详细日志时，启用调试模式。调试模式写入的日志量是正常模式的 10 倍。
+
+## 版本计划
+
+v2.0 于 2026 年 12 月 1 日发布。v2.0 的吞吐量是 v1.x 的 3 倍，内存占用减少到 v1.x 的 1/2。

.qoder/skills/simplified-technical-chinese/examples/before.md

@@ -0,0 +1,19 @@
+# 日志采集器部署指南
+
+本文档主要是介绍一下如何在生产环境对日志采集器进行部署以及相关配置的说明，适用于运维同学以及对此感兴趣的开发同学等。
+
+## 部署前的准备
+
+首先需要确认服务器的操作系统版本是比较新的，然后检查一下磁盘空间是否充足（一般来说 10GB 以上就基本够用了），最后还要保证服务器能够访问到我们的镜像仓库。如果服务器无法访问外网的话，需要联系网络组的同事开通相关的权限，这个过程可能需要几天时间，所以最好尽快提交申请。
+
+## 部署步骤
+
+1. 用户首先需要登陆到目标服务器，然后切换到 /opt 目录并且创建一个用于存放采集器配置文件以及运行时产生的临时数据的工作目录。
+2. 请下载安装包并进行解压，注意安装包必须和服务器的 CPU 架构匹配，否则会报错。
+3. 修改配置文件里的 server_addr（服务端地址）参数，把它改成实际的地址，然后再修改一下 batch_size 参数，这个参数不要设置得太大也不要设置得太小，一般几百左右就可以了。
+4. 执行启动命令以后，采集器会被 systemd 接管，日志会由采集器定期上报到服务端，这时候应该能看到状态变成 active 了吧？
+5. 开启调试功能（如果需要排查问题的话）。
+
+## 常见问题
+
+如果采集器起不来，大概率是因为配置文件的格式有问题，可以用校验命令对配置文件进行校验，校验通过之后再重新拉起服务。采集器的内存占用一般在 200MB 左右，如果内存占用非常高，说明 batch_size 参数设置得不合适，适当调小即可。近期我们会发布新版本来对这个问题加以优化，届时性能会提升 3 倍以上，内存占用也会降低 2 倍。