feat: 首次推送到Gitea - 完整项目代码 + 安全加固 + 知识库

.trae/specs/modules/07-lib-and-scripts.md

@@ -207,12 +207,102 @@
 - `scripts/install-cron-backup.sh` — 安装主机备份 cron（每天 03:00 执行备份）
 
 ### 定时任务调度
-- `crontab.txt` — supercronic 调度配置（13 条定时任务），不再使用主机 crontab + cron-wrapper.sh
+- `crontab.txt` — supercronic 调度配置（25 条定时任务），不再使用主机 crontab + cron-wrapper.sh
 
 ### lib/retry.mjs
 - 重试工具函数
 
+---
+
+## Bot系统脚本
+
+### bot-activity.mjs — Bot活动引擎
+- 每小时运行（9:00-23:00），15轮/天
+- 遍历10个论坛板块，为每个板块选取适配Bot发帖+回复
+- 集成Persona画像注入、A/B变体选择、对抗学习上下文
+- 生成后自动点赞 + 写入BotDailyStat
+
+### bot-skill-crystallize.mjs — Bot技能结晶
+- 每天02:00运行
+- 扫描过去14天高互动Bot话题，DeepSeek解构共性→入库BotSkill
+- 7天后回收检查成熟技能成功率，<30%且使用≥3次自动禁用
+
+### bot-affinity-update.mjs — Bot亲和度与画像
+- 每周日22:30运行
+- 计算BotCrossForumAffinity + 刷新BotPersona画像
+
+### bot-feedback-loop.mjs — Bot反馈闭环
+- 每周日22:00运行（原21:30）
+- 三层记忆模型(SESSION/WORKING/LONGTERM)
+- 扫描Bot自己帖子下的新回复 → 存反馈记忆 → 按概率触发二次回复
+
+### bot-weekly-review.mjs — Bot周度复盘
+- 每周日02:00运行
+- 聚合一周指标 → 计算engagementScore → LLM生成反思 → 决定下周配额
+
+### bot-persona-experiment-run.mjs — A/B实验调度
+- 每小时运行
+- 采集BotPersonaAssignment指标 → 按日聚合到BotPersonaMetric → 显著性检验 → 自动切换winner
+- 支持 `--lookback` / `--no-switch` / `--metrics-only` / `--analyze-only`
+
+### bot-adversarial-learning-run.mjs — 对抗学习调度
+- 每周日23:00运行
+- 为每个expert bot选1篇真人高互动帖 → DeepSeek提取洞察 → 入库BotAdversarialLearning
+- 支持 `--week` / `--force` / `--bot` / `--lookback`
+
+### bot-avatar-generate.mjs — Bot头像生成
+- CLI入口，为112个bot批量预生成头像
+- Lunaris text-to-image → 占位检测 → SVG兜底 → 落盘public/bot-avatars/
+- 支持 `--bot` / `--force` / `--use-lunaris-only` / `--no-update-db` / `--dry-run`
+
+### 其他Bot脚本
+- `generate-bot-content.mjs` — 独立Bot内容生成（手动/临时运行）
+- `seed-bot-forum.mjs` — 论坛板块+Bot初始内容种子
+- `backfill-bot-daily-stats.mjs` — BotDailyStat历史数据回填
+- `test-bot-stats.mjs` — Bot统计测试调试工具
+
+### Bot共享库 (`scripts/lib/`)
+
+#### bot-persona.mjs — 人设画像
+- `updatePersona(botConfigId)` — 异步刷新画像（30天聚合）
+- `computePersona(botConfigId)` — 计算风格指标
+- `schedulePersonaRefresh()` — 定时触发
+
+#### bot-persona-experiment.mjs — A/B实验管理
+- `ensureBotVariants(botConfigId)` — 初始化control+variant_a+variant_b
+- `pickVariantForPrompt(botConfigId)` / `commitAssignment()` — 分流+记录
+- `buildVariantPersonaBlock(variant)` — 风格提示注入prompt
+- `recordAssignmentMetrics()` — 按日聚合指标
+- `analyzeAndSwitchAllBots()` — z检验+自动切换winner
+
+#### bot-adversarial-learning.mjs — 对抗学习
+- `runWeeklyAdversarialLearning()` — 全量学习入口
+- `getActiveLearningForBot()` / `buildAdversarialBlock()` — 发帖时查询+注入
+- `extractInsight(post, bot, persona)` — DeepSeek提取洞察
+
+#### bot-avatar-generator.mjs — 头像生成
+- `generateForAll()` — 遍历112个bot生成头像
+- `fetchLunarisImage()` / `isLunarisDefault()` / `generateSvgAvatar()` — 三步流程
+- 10色调色板 + key哈希 → 唯一SVG头像
+
+### 前端Bot工具
+
+#### bot-utils.ts (`src/lib/bot-utils.ts`)
+- `getBotAvatarUrl(key, avatarPrompt)` — 动态头像URL
+- `getBotColorScheme(key)` — 稳定哈希→Tailwind配色类
+
+---
+
 ### 修复/诊断脚本
 - `fix-db-url.cjs` — 批量修复所有 `.mjs` 脚本的 `mysql://` → `mariadb://` 协议兼容（PrismaMariaDb adapter 要求）
 - `fix-ts-types.cjs` — 批量移除 `.mjs` 文件中的 TypeScript 类型注解（`.mjs` 不支持 TS 语法）
 - `check-categories.cjs` — 检查数据库社区板块分类，输出所有 ForumCategory 的 id/name/slug
+
+---
+
+## 开发规则引用
+> Shell 脚本和运维开发必须遵守以下规则：
+> - [第十三章 - Shell脚本规范](file:///c:/SGP_KF/ZhuiGuangAI/zhuiguang-ai/.trae/rules/project_rules.md)：`set -e`、PASS/FAIL/WARN 结构化输出、资源预检、禁止操作清单
+> - [第八章 - 定时任务规范](file:///c:/SGP_KF/ZhuiGuangAI/zhuiguang-ai/.trae/rules/project_rules.md)：entrypoint-cron.sh 信号处理、启动校验、健康检查端点；日志三层目录；任务幂等性
+> - [第十八章 - AI/Bot系统规范](file:///c:/SGP_KF/ZhuiGuangAI/zhuiguang-ai/.trae/rules/project_rules.md)：Bot角色定义、活动脚本5大约定、AI API隔离、提示词管理
+> - [第十九章 - 环境变量管理规范](file:///c:/SGP_KF/ZhuiGuangAI/zhuiguang-ai/.trae/rules/project_rules.md)：变量分级、`.env.example` 同步、脚本侧加载顺序