主题
六、配置
本章速览:读完后你会知道 —— ① 配置的三层来源与优先级;② 敏感值怎么加密、为什么接口只回掩码;③ 为什么脏值在保存时就被拒绝(而不是运行时悄悄回退);④ §6.2 的 176 个键是检索用参考层,不必通读,按前缀搜索即可。
6.1 三层来源与优先级
| 层 | 位置 | 谁改 | 生效 |
|---|---|---|---|
| 数据库 | sys_config(176 键) | 后台配置面板 | 热生效(单键缓存 ≤30 秒;保存路径立即失效) |
| 环境变量 | 生产 /opt/vite-cosmos/panel/backend.env | 部署/运维 | 重启生效 |
| 代码默认值 | ConfigKeys + 迁移 V29–V33 种子 | 开发者 | 键缺失时兜底 |
规则
- 配置键只有一处定义(
ConfigKeys),面板与文档引用同一份; - 敏感键加密入库(
enc:前缀),接口只回掩码; - 键的三方对齐(库 ↔ 面板 ↔ 读点证据)由
check-config-registry.mjs守; - 退役键进
deploy/config-keys.retired.txt,§6.2 必须标注「已退役」,不能让它看起来还能配。
6.2 全部配置键(sys_config)
176 个键全列,按二级前缀分组。每个键都必须有真实读取方 ——
deploy/scripts/check-config-keys.sh与门户的check-config-registry.mjs会把每个键 对本仓库的读点(@Value或扩展config.read能力)与真库逐条对账,找不到读点即报错。含密钥的键已掩码;「当前值」是生成时生产库的真实值。
展开全部 176 个配置键(按前缀检索;参考层,无需通读)
| 配置键 | 当前值 | 说明 |
|---|---|---|
| daily.*(日程)(6) | ||
daily.course.remind-before | 15 | 上课提醒提前分钟数(到点前 N 分钟 + 到点各一条提醒;M38) |
daily.portal.show-items | 0 | 门户「今日」卡片是否展示待办标题:1 展示(最多 5 条未完成)/ 0 只展示计数(待办可能含私密信息,默认不展示;M38) |
daily.reminder.catch-up-minutes | 120 | 重启补偿窗口(分钟):重启后仅补投窗口内错过的提醒,超窗标记 skipped,避免过期提醒轰炸(M38) |
daily.reminder.enabled | 1 | 日程提醒总开关:1 开 0 关(关闭后扫描任务不生成也不投递提醒;M38) |
daily.reminder.test.external-enabled | 1 | 测试提醒是否允许外部通道:1 允许(默认,需确认+30秒冷却+每日10条);0 只发站内 |
daily.todo.default-remind-before | 30 | 待办默认提前提醒分钟数(待办未单独设置 remind_before 时使用;M38) |
| site.ai.*(40) | ||
site.ai.auto-summary | 1 | |
site.ai.auto-tags | 1 | |
site.ai.avatar.avatar | `` | 分身头像 URL |
site.ai.avatar.daily-limit | 20 | 访客每日对话轮次上限 |
site.ai.avatar.enabled | 1 | 访客版 AI 数字分身开关:1 开启 0 关闭 |
site.ai.avatar.name | 小宇宙 | 分身名称 |
site.ai.avatar.welcome | 你好,我是博主的 AI 数字分身,读过他发布的所有内容,来问点什么吧~ | 分身欢迎语 |
site.ai.breaker-mode | block | 熔断模式:block 超限拒绝 / alert 仅告警 / off 关闭 |
site.ai.care.daily-limit | 3 | 情感关怀每日条数上限(0=不限制):与 site.ai.proactive.daily-limit 是两道独立的闸,任一超限都… |
site.ai.care.enabled | 1 | 情感主动关怀开关:1 开 0 关(默认 0=先不打扰,先可关后开;关闭时 CareCheckInJob 记 skipped 后直接返回) |
site.ai.care.interview-interval-days | 3 | 访谈邀请间隔(天):多久之内不再主动邀请聊过去(默认 7 = 改动前的行为)。允许区间 [1,365]:越界/脏值由代码钳制或回落默认… |
site.ai.daily-token-limit | **(已掩码)** | 每日 AI token 限额(成本熔断,0 表示不限制;仅限制访客侧调用) |
site.ai.digest.auto-draft | 0 | 每日总结是否建文章草稿(默认 0;草稿≠发布,AI 绝不自动发布,发布由博主在文章页手动做;M42) |
site.ai.digest.auto-note | 1 | 每日总结是否写一条私密笔记(默认 1;笔记模块完全私有、仅后台可达;M42) |
site.ai.digest.diary-mode | 1 | 记模式1=天私人记认0=容 |
site.ai.digest.enabled | 1 | 每日总结总开关:1 开 0 关(默认关;开启后到点自动生成小结,产物只进私密笔记/文章草稿;M42) |
site.ai.digest.hindsight-context.enabled | 1 | 记否使 Hindsight 认 0只私记 |
site.ai.digest.hindsight-max-tokens | **(已掩码)** | 记 Hindsight token 认 1500 |
site.ai.digest.max-input-tokens | **(已掩码)** | 每日总结输入 token 预算(默认 8000):超长按会话裁剪(首尾保留),控制成本;M42 |
site.ai.digest.public-draft.enabled | 0 | 记否许稿认 0记含私禁止 |
site.ai.digest.time | 00:20 | 每日总结时间点(HH:mm,如 23:30):只存时间点不存 cron,任务每分钟轮询到点触发;M42 |
site.ai.egress | normal | 全局出网档位(V41):normal/minimal/frozen;测试期间临时置 frozen |
site.ai.hindsight.recall-max-tokens | **(已掩码)** | Hindsight 默认召回预算 token(0=交给 Hindsight 默认;默认 2048) |
site.ai.image-enabled | 0 | AI 生成封面图开关:1 开 0 关 |
site.ai.image-ingest.daily-limit | 0 | 每日自动读图上限(0=不限;明确要求看图不占额度) |
site.ai.image-model | `` | AI 生图模型(留空用通道默认,如 dall-e-3 / flux-schnell) |
site.ai.image-size | 1024x1024 | AI 生图尺寸(如 1024x1024 / 1024x1792 / 1792x1024) |
site.ai.mcp.enabled | 1 | MCP 记忆服务开关:1 开(/api/agent/mcp 提供工具面)/ 0 关(tools/list 返回空、tools/call… |
site.ai.mcp.result-max-chars | 20000 | MCP 工具结果的字符上限(默认 4000 ≈ 4000 token,改动前的行为)。工具结果直接进模型上下文:20000 是上下文窗… |
site.ai.mcp.search-max-budget | 12000 | 检索类工具返回给模型的字符预算上限(默认 4000 = 改动前的行为,budget_tokens 参数的钳制上界);下限 200 写死… |
site.ai.mcp.search-max-limit | 100 | 检索类工具单次返回条数的上限(默认 20 = 改动前的行为,limit 参数的钳制上界);100 为噪声上界 |
site.ai.moderation-action | flag | AI 审核处置:flag 标记待人工复核 / reject 直接拒绝提交 |
site.ai.moderation-enabled | 0 | AI 内容审核(评论/留言):1 开 0 关 |
site.ai.open-loop.first-mention-days | 1 | 未了线头「首次提起」前的最少等待天数(默认 1 = 本轮刻意的新行为;设 5 = 旧行为)。旧逻辑对从未提过的线头也用 5 天… |
site.ai.proactive.daily-limit | 200 | 主动性每日次数上限(0=不限制):超限不发消息、写 proactive_log(status=skipped) 后台可见(只降级不静默… |
site.ai.proactive.enabled | 1 | 主动性总开关:1 开 0 关(缺省视为开)。关闭后晨报/晚报/关怀/线头/访谈/周复盘/上课与待办提醒全部不再主动发出(六个 handler 共用 ProactiveSwitch;2026-11-18 审查 #30 前只有访谈读它) |
site.ai.reply-suggest-enabled | 1 | AI 回复建议开关(评论/留言管理页) |
site.ai.state.loop-chars | 1500 | 580 = 3 p95(193 )10000 |
site.ai.state.loop-limit | 6 | 每轮注入「未了线头」的条数上限(默认 3 = 改动前的行为);20 为技术上界 |
site.ai.writing-assistant-enabled | 1 | AI 写作助手开关(编辑器内的润色/续写等) |
| site.appearance.*(11) | ||
site.appearance.accent | #2563eb | 日间强调色(#rrggbb;留空用内置默认),派生柔和底/光晕与渐变辅助色 |
site.appearance.accent-2 | #7c3aed | #rrggbb +42 |
site.appearance.accent-2-dark | #a78bfa | 夜间渐变辅助色(#rrggbb;留空自动派生) |
site.appearance.accent-dark | #22d3ee | 夜间强调色(#rrggbb;留空用内置默认) |
site.appearance.dark-image-dim | 1 | 夜间图片降亮:1 开 0 关(默认关)。开启后夜间/纯黑档的正文图片整体降亮 14%,缓解白底截图与示意图在暗色下刺眼 |
site.appearance.density | comfortable | 界面密度:comfortable 舒适(默认)/ compact 紧凑(间距与留白整体收缩,适合列表密集型站点) |
site.appearance.font | sans | 正文字体档:sans 无衬线(默认)/ serif 衬线(长文阅读) |
site.appearance.max-width | 1200 | 版心最大宽度(px,960–1600):1080 紧凑 / 1200 标准 / 1320 舒展 / 1440 宽屏 |
site.appearance.motion | full | 动效强度:full 完整 / reduced 精简(等同系统"减少动效"偏好) |
site.appearance.radius | soft | 圆角风格:soft 圆润 14px / standard 标准 10px / sharp 利落 6px |
site.appearance.theme-default | auto | 访客默认主题:auto 跟随系统 / light 日间 / dark 夜间(访客手动切换后以其选择优先) |
| site.article.*(1) | ||
site.article.private-default-visible | 0 | 新建文章默认可见性:0 公开 / 1 仅管理员可见(M31 起不可凭密码访问) |
| site.backup.*(1) | ||
site.backup.dir | `` | 备份目录:留空用默认 /opt/vite-cosmos/backup(M34 登记,运维中心使用) |
| site.banner.*(5) | ||
site.banner.image | https://uapis.cn/api/v1/image/bing-daily | 首页横幅背景图 URL |
site.banner.mode | full | 首页横幅形态:hidden/mini/normal/full |
site.banner.subtitle | | 首页横幅副标题(留空取站点描述) |
site.banner.title | | 首页横幅标题(留空取站点名) |
site.banner.typing | 1 | 首页横幅副标题打字机效果:1 开 0 关 |
| site.comment.*(3) | ||
site.comment.audit | 1 | 评论/留言是否需要审核:1 需要 0 不需要 |
site.comment.forbidden_words | 赌博,色情,代开发票 | 敏感词库(逗号分隔) |
site.comment.top-enabled | 1 | 评论置顶功能开关:1 开 0 关 |
| site.conversation.*(1) | ||
site.conversation.agent-turn-retention-days | 0 | agent_turn(聊天轮次)保留天数;0=永久保留(默认)。开启后只删"记忆抽取水位已覆盖"的旧轮次 |
site.conversation.raw-retention-days | 14 | 会话原文(agent_session_raw)保留天数;0=永久保留。实测约 87 MB/天,14 天稳态约 1.2 GB。判定所需字… |
| site.daily.*(3) | ||
site.daily.holiday.enabled | 1 | 节假日感知开关:1=按外部源判定放假/补班;0=关闭(默认,与"没有节假日数据"的旧行为一致)。关闭时一切判定返回 UNKNOWN,A… |
site.daily.holiday.source-url | https://raw.githubusercontent.com/NateScarlet/holiday-cn/… | 节假日数据源({year} 替换为年份)。默认 holiday-cn(CI 每日抓国务院公告)。⚠️ 该源许可未核实,介意请换源 ——… |
site.daily.holiday.years-ahead | 1 | 除当年外再往前拉几年(默认 1):次年安排通常在当年 11-12 月公告,12 月的日期可能被下一年文件影响,所以必须同时看 N 与 N+1 |
| site.description.*(1) | ||
site.description | 记录学习笔记、思想感悟与日常生活 | 站点描述 |
| site.extension.*(3) | ||
site.extension.kill-switch | 0 | 扩展平台全局 kill switch(1=所有新 run 跳过;管理端可切换,重启保持) |
site.extension.approval.free-tokens-per-plugin | 20000 | 插件系统:单插件每日免费 token 额度;0=任何花费都先审批 |
site.extension.approval.free-tokens-global | 100000 | 插件系统:全部插件每日免费 token 总额度(预留) |
| site.footer.*(12) | ||
site.footer.brand-display | none | 页脚品牌区展示档位:none 都不显示 / name 仅站名 / desc 仅描述 / both 站名+描述(V26 由 brand-… |
site.footer.copyright | © {year} {owner} | {year} / {owner} / {site} {year} |
site.footer.icp-enabled | 1 | 页脚展示 ICP 备案号:1 展示 0 隐藏 |
site.footer.links-enabled | 0 | 页脚展示站点导航快捷链接(取主导航前 N 项):1 展示 0 隐藏 |
site.footer.links-limit | 6 | 页脚导航快捷链接最多展示条数(0–12,取主导航前 N 项) |
site.footer.meta-layout | center | 底部信息条排布:split 左右分栏(版权+运行时长 / 备案) / center 居中单列(移动端始终居中) |
site.footer.milestone-enabled | 1 | 站点周年徽标:上线周年当天在运行状态旁展示「N 周年」徽标(1 开 0 关) |
site.footer.owner | 志尊威少 | 版权所有者(如公司或个人名;留空取站点名称) |
site.footer.police-enabled | 1 | 页脚展示公安网安备案号:1 展示 0 隐藏 |
site.footer.style | classic | 页脚布局档位:classic 经典(品牌区+订阅+部件区+信息条)/ compact 紧凑(去掉品牌描述与部件区间距)/ minima… |
site.footer.time-display | none | 页脚时间信息档位:none 不显示 / uptime 仅运行天数 / since 仅始于日期 / both 两者(V26 由 upti… |
site.footer.uptime-label | `` | 运行天数文案模板:支持 {days} 天数 / {years} 整年数 / {months} 余月数 / {start} 起始日期;留… |
| site.home.*(2) | ||
site.home.card-style | classic | 首页文章卡片样式:classic/compact/media |
site.home.page-size | 10 | 首页文章列表每页条数(前台分页,1–50,默认 10) |
| site.icp.*(1) | ||
site.icp | 湘ICP备2025124058号-1 | ICP 备案号(页脚展示) |
| site.image.*(6) | ||
site.image.compress-enabled | 1 | 服务端图片压缩开关:1 开 0 关(仅 jpg/png 且超过阈值时处理) |
site.image.max-width | 1920 | 服务端压缩最长边(像素,超过则等比缩放) |
site.image.quality | 82 | JPEG 输出质量(1-100) |
site.image.watermark-enabled | 0 | 图片水印开关:1 开 0 关(开启后所有上传图片加文字水印) |
site.image.watermark-position | bottom-right | 水印位置:bottom-right / bottom-left / top-right / top-left / center |
site.image.watermark-text | `` | 水印文字(留空则取站点名) |
| site.inject.*(3) | ||
site.inject.body-end | `` | 注入 body 末尾的 HTML(管理员专用) |
site.inject.css | `` | 全局自定义 CSS(管理员专用) |
site.inject.head | `` | 注入 head 的 HTML(管理员专用) |
| site.interaction.*(4) | ||
site.interaction.comment-enabled | 0 | 评论总开关:0 关闭(前台隐藏表单且后端拒绝提交) |
site.interaction.like-enabled | 0 | 说说点赞开关 |
site.interaction.link-apply-enabled | 0 | 友链自助申请开关 |
site.interaction.message-enabled | 0 | 留言板开关 |
| site.job.*(2) | ||
site.job.heartbeat.stale-minutes | 30 | 心跳停摆告警阈值(分钟,默认 30):外部心跳(chainProbe/bridgeHeartbeat/ingestHeartbeat)… |
site.job.scheduler.pool-size | 4 | 调度线程池大小(默认 1=Spring Boot 默认/改动前行为;本种子 4 是用户批准的变更)。为什么需要:16 个定时任务曾共用… |
| site.launched-at.*(1) | ||
site.launched-at | 2026-09-30 | 站点上线日期(YYYY-MM-DD):页脚「已运行 N 天」的起点,也是「始于」文案的来源 |
| site.layout.*(2) | ||
site.layout.sidebar-position | right | 侧栏位置:none/left/right |
site.layout.toc-mode | sticky | 目录形态:sticky 粘性 / float 浮动按钮 |
| site.logo.*(1) | ||
site.logo | `` | 站点 Logo URL(前台导航展示) |
| site.mail.*(8) | ||
site.mail.enabled | 1 | 邮件通知开关:1 开启 0 关闭 |
site.mail.host | smtp.163.com | SMTP 服务器地址(M34 登记) |
site.mail.notify-commenter | 0 | 评论/留言被回复或审核通过时通知访客(1 开 0 关) |
site.mail.password | enc***(已掩码) | SMTP 授权码(密文入库、回显掩码;留空表示不修改;M34 登记) |
site.mail.port | 465 | SMTP 端口:465 走 SSL、587 等走 STARTTLS(M34 登记,默认 465) |
site.mail.ssl | 1 | SMTP 是否使用 SSL(M34 登记,默认 1) |
site.mail.to | vite66@163.com | 通知邮件接收地址 |
site.mail.username | vite66@163.com | SMTP 账号(同时作为发件人与默认收件人;M34 登记) |
| site.maintenance.*(2) | ||
site.maintenance.enabled | 0 | 维护模式:1 开启后门户接口返回维护提示 |
site.maintenance.message | 站点正在维护升级,稍后回来~ | 维护模式提示语 |
| site.media.*(2) | ||
site.media.folder-enabled | 1 | 媒体库分组功能开关:1 开 0 关 |
site.media.srcset-template | `` | 图片 DPR 模板(可选):如 {url}?x-oss-process=image/resize,w_{w} 或 {url}?w={w… |
| site.memory.*(1) | ||
site.memory.max-candidates | 4000 | + 8000 1000-20000M41 17.2.3#1 |
| site.name.*(1) | ||
site.name | ViTe 小宇宙 | 站点名称 |
| site.nav.*(2) | ||
site.nav.items | [{"key":"home","label":"首页","path":"/","enabled":true,"so… | 前台导航配置(菜单管理) |
site.nav.mobile-tabs | [] | 移动端底部 Tab 独立配置(JSON 数组:[{"text":"首页","link":"/"}...];留空则取导航前 5 项) |
| site.notify.*(15) | ||
| — | — | 晨报/晚报的时间已迁到扩展平台:改 system.brief.morning / system.brief.evening 的触发器 cron(扩展中心 → 对应插件 → 触发器),不再是 sys_config 键 |
site.notify.brief.extra-lines | `` | 晨报/晚报的附加内容(多行,逐行追加)。可写「记得带伞」这类固定提醒;留空则不加 |
site.notify.brief.extra-material | 1 | 晨晚报在「课程/待办/昨晚总结」全空时是否改用兜底素材(默认 1 = 本轮刻意的新行为;设 0 = 旧行为:整天不发)。兜底素… |
site.notify.brief.extra-url | `` | 已退役(2026-11 晨晚报迁到扩展平台,本键已无读取方;保留在库里只为不丢历史值)。原先用于"从这里 GET 一段文本追加到晨晚报" |
site.notify.brief.use-model | 1 | 已退役(2026-11-18:删掉「简报二次润色」,润色统一由 DSH compose 同步完成;库里保留历史值) |
site.notify.compose.lead-minutes | 10 | 已退役(2026-11-18:删除预生成缓存层,同步润色没有"提前量"概念;库里保留历史值) |
site.notify.channels | wechat | IM 渠道开关(M39):非空才启用 webhook(IM)通道,留空只用邮件;v1 只支持一个 webhook 实例(形态由 sit… |
site.notify.compose.enabled | 1 | 主动提醒(晨晚报/关怀/线头/提醒)是否在发送前同步经 DSH 润色:1 开 0 关(默认 0;超时或失败自动回退模板,不丢消息) |
site.notify.compose.max-chars | 240 | DSH 润色后文案的最大字符数(默认 240),超出截断(按 code point 截,不会劈开 emoji) |
site.notify.compose.reminder-lead-minutes | 10 | 提醒提前多少分钟预润色(钳制 3–30)。到点只读缓存,DSH 慢/挂回退模板;缓存表 proactive_compose |
site.notify.compose.scenes | morning_brief,evening_brief,care,interview,open_loop,weekly_review,reminder | 启用 DSH 润色的场景(逗号分隔)。当前真正调用润色的:morning_brief / evening_brief / care / interview / open_loop / weekly_review / reminder —— 即全部主动消息;提醒与周复盘有额外保真校验(见 §3.2.2) |
site.notify.compose.timeout-ms | 20000 | 同步润色的最长等待毫秒(默认 20000,钳制 1000–60000)。实测 DSH 一次润色约 12s,故不能设太小;超时回退模板。V160 把历史上被 V125 写成 90000 的值归一为 20000(否则库里 90000、运行时限到 60000、面板也显示 90000,三处不一致) |
site.notify.compose.token | enc***(已掩码) | DSH compose 内部令牌(密文入库;请求头 X-Compose-Token) |
site.notify.compose.url | http://127.0.0.1:8790/compose | DSH compose 内部端点(默认 http://127.0.0.1:8790/compose;只监听 loopback,由微信桥提供) |
site.notify.morning-brief-time | 07:40 | 已退役(迁到扩展触发器 cron)。原先的晨报时间;现在改 system.brief.morning 触发器的 cron |
site.notify.evening-brief-time | 22:30 | 已退役(迁到扩展触发器 cron)。原先的晚报时间;现在改 system.brief.evening 触发器的 cron |
site.notify.quiet-hours | 23:30-07:30 | 静默时段(HH:mm-HH:mm,可跨午夜):时段内只允许紧急到点提醒,其它主动性一律不发(写 skipped 留痕;M44) |
site.notify.webhook.token | `` | IM 推送凭据(bark device_key / serverchan key / pushplus token;密文入库、回显掩码… |
site.notify.webhook.type | custom | IM 推送形态:bark / pushplus / serverchan / wecom_bot / custom(各家 body 字… |
site.notify.webhook.url | http://127.0.0.1:8790/notify | IM 推送地址:留空按形态用默认服务地址(bark=https://api.day.app、pushplus=https://www.… |
| site.police.*(2) | ||
site.police | 粤公网安备44011302004889号 | 公安网安备案号(如 京公网安备1101050203XXXX号;留空则页脚不展示) |
site.police.icon | https://vite66.cn/uploads/wp/2025/06/备案图标.png | 公安备案图标 URL(官方图标;留空则使用内置盾牌 SVG) |
| site.reader.*(3) | ||
site.reader.font-size | 17 | 门户默认正文字号(px),读者可在前台自行调节 |
site.reader.line-height | 1.85 | 正文默认行距(1.5–2.2),读者可在前台自行调节 |
site.reader.width | 1200 | 正文默认版心宽度(px;0 表示跟随页面容器),读者可在前台自行调节 |
| site.reward.*(3) | ||
site.reward.alipay | `` | 支付宝赞赏码图片 URL |
site.reward.enabled | 1 | 赞赏功能全局开关(文章级开关在其之上) |
site.reward.wechat | `` | 微信赞赏码图片 URL |
| site.safety.*(1) | ||
site.safety.mode | off | test |
| site.search.*(1) | ||
site.search.log-enabled | 1 | 记录站内搜索词(用于搜索词报告与热门搜索):1 开 0 关 |
| site.security.*(3) | ||
site.security.admin-ip-whitelist | `` | 后台访问 IP 白名单(逗号分隔,支持前缀通配如 192.168.1.*;留空表示不限制) |
site.security.last-login-ip | `` | 上一次成功登录的后台 IP(运行期写入,勿在面板编辑;M34 登记) |
site.security.login-alert-enabled | 0 | 登录异常告警:新 IP 登录时发邮件提醒(1 开 0 关) |
| site.seo.*(3) | ||
site.seo.baidu-token | `` | 百度站长平台推送 token(留空则不推送) |
site.seo.keywords | 个人博客,学习笔记,AI 数字分身 | SEO 关键词 |
site.seo.rss-enabled | 1 | RSS 订阅开关:0 关闭后 /rss.xml 返回 404 |
| site.stats.*(2) | ||
site.stats.weekly-report-enabled | 0 | 每周数据周报邮件:1 开 0 关 |
site.stats.weekly-report-to | `` | 周报收件人(留空取邮件通知收件人) |
| site.storage.*(9) | ||
site.storage.oss.access-key | `` | Access Key(加密存储) |
site.storage.oss.bucket | `` | 存储桶名称 |
site.storage.oss.domain | `` | 访问域名(如 CDN 域名;留空则用 Endpoint/Bucket 拼接) |
site.storage.oss.endpoint | `` | S3 兼容 Endpoint,如 https://oss-cn-hangzhou.aliyuncs.com 或 MinIO 地址 |
site.storage.oss.path-style | 0 | 是否使用 Path-Style 访问(MinIO 需开启:1) |
site.storage.oss.prefix | vite-cosmos | 对象键前缀(便于与其他业务隔离) |
site.storage.oss.region | us-east-1 | 区域(MinIO 可随意填写) |
site.storage.oss.secret-key | `` | Secret Key(加密存储) |
site.storage.type | local | 文件存储方式:local 本地 / oss 对象存储 |
| site.subscriber.*(2) | ||
site.subscriber.enabled | 0 | 邮件订阅开关:1 开 0 关 |
site.subscriber.notify-enabled | 0 | 新文发布是否邮件通知订阅者:1 是 0 否 |
| site.update.*(1) | ||
site.update.latest-version | `` | 最新版本号(用于后台版本提示,手工维护) |
| site.url.*(1) | ||
site.url | https://vite66.cn | 站点正式地址(用于 sitemap/RSS/百度推送) |
6.3 环境变量(生产 backend.env,36 个)
下面的分组与名称来自生产的
/opt/vite-cosmos/panel/backend.env实测键名。
| 分组 | 变量 |
|---|---|
| 密钥(硬门禁) | COSMOS_JWT_SECRET、COSMOS_SECRET_KEY —— 非 dev 环境缺失则拒绝启动 |
| 数据库 | MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD(库名在 compose/yml 固定为 vite_cosmos) |
| 运行环境 | SPRING_PROFILES_ACTIVE、TZ、LOGGING_FILE_PATH |
| 上传 | COSMOS_UPLOAD_DIR;COSMOS_CHAT_ATTACHMENT_DIR(聊天附件私有目录,必须落在已挂载的 uploads 卷内;漏配会退回镜像内不可写路径,上传直接失败 —— 审查 #52) |
| DSH 集成 | COSMOS_DSH_PROFILE_PATCH(web profile 补丁共享路径:后台「权限档位」读写)、COSMOS_DSH_PROFILE_PATCH_BACKUP_DIR(改动前备份目录,需可写)、COSMOS_DSH_MODEL_CONFIG(同一份补丁文件的共享路径:后台「对话模型」读取默认模型) |
| 扩展平台 | COSMOS_EXTENSION_BOOTSTRAP_ENABLED(生产已置 true:启动时把系统扩展 manifest 与代码 SEEDS 双向对齐,自动升版并补 grant;2026-11-18 审查 #25)、COSMOS_EXTENSION_SCHEDULER_ENABLED、COSMOS_EXTENSION_EFFECT_ENABLED、COSMOS_EXTENSION_SHADOW_ENABLED、COSMOS_EXTENSION_LEGACY_MIGRATE_ENABLED、COSMOS_EXTENSION_SANDBOX_TOKEN、COSMOS_EXTENSION_SANDBOX_WORKSPACE_ROOT、COSMOS_EXTENSION_UPGRADE_*(升级脚本相关) |
| 记忆(Hindsight) | COSMOS_MEMORY_HINDSIGHT_BASE_URL、COSMOS_MEMORY_INGEST_ENABLED、COSMOS_MEMORY_INGEST_ALLOW_SESSIONS、COSMOS_MEMORY_INGEST_INCLUDE_ASSISTANT、COSMOS_MEMORY_INGEST_REAL_USERS、COSMOS_MEMORY_INGEST_REAL_USERS_MAX_SESSIONS、COSMOS_MEMORY_KB_MIRROR_ENABLED、COSMOS_MEMORY_BACKFILL_ENABLED、HINDSIGHT_API_TOKEN、HINDSIGHT_API_TIMEOUT_MS、HINDSIGHT_COMPOSE_DIR、COSMOS_HINDSIGHT_UPGRADE_SCRIPT |
| 主动消息 | COSMOS_PROACTIVE_UNIFIED_ENABLED(统一模式:提醒/总结只计划、投递交给扩展平台)。原 *_COMPOSER_ENABLED / *_REMINDER_PLANNER_ENABLED / *_BOOTSTRAP_ENABLED 已无读取方,2026-11-18 从模板与生产 env 删除 |
| AI / DSH | COSMOS_AI_ENABLED、COSMOS_DSH_BASE、COSMOS_DSH_MODEL_CONFIG、COSMOS_DSH_URL_FILE、COSMOS_DSH_PANEL_LOG |
| 安全 | COSMOS_CORS_ALLOWED_ORIGINS |
| 告警 | ALERT_WEBHOOK_URL(健康监控脚本用) |
| 进程 | JAVA_OPTS(见 §11.1) |
微信桥另有一套自己的环境(不进 backend.env):COSMOS_WX_ALLOW(白名单)、COSMOS_WX_SESSIONS 等, 由 systemd 单元的 EnvironmentFile 提供;COSMOS_WX_ALLOW 为空时桥不投递任何消息。
6.4 配置一致性与重载
| 机制 | 说明 |
|---|---|
| 单键缓存 | SysConfigService 单键缓存 ≤30s;保存时立即失效 |
| 配置面板登记表 | 后台 configIndex.ts 是唯一的"键 → 面板/档位/读点证据"登记表;缺项或读点对不上即红 |
| 退役键台账 | deploy/config-keys.retired.txt + config-keys.ledger.md(自动生成) |
| 数字类键校验 | 面板侧 numberField 钳制范围与后端 clampInt 必须一致(曾出现面板默认 90000、后端上限 60000 的三处漂移) |