Skip to content

六、配置 ​

本章速览:读完后你会知道 —— ① 配置的三层来源与优先级;② 敏感值怎么加密、为什么接口只回掩码;③ 为什么脏值在保存时就被拒绝(而不是运行时悄悄回退);④ §6.2 的 176 个键是检索用参考层,不必通读,按前缀搜索即可。

6.1 三层来源与优先级 ​

层位置谁改生效
数据库sys_config(176 键)后台配置面板热生效(单键缓存 ≤30 秒;保存路径立即失效)
环境变量生产 /opt/vite-cosmos/panel/backend.env部署/运维重启生效
代码默认值ConfigKeys + 迁移 V29–V33 种子开发者键缺失时兜底

规则

  1. 配置键只有一处定义(ConfigKeys),面板与文档引用同一份;
  2. 敏感键加密入库(enc: 前缀),接口只回掩码;
  3. 键的三方对齐(库 ↔ 面板 ↔ 读点证据)由 check-config-registry.mjs 守;
  4. 退役键进 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-before15上课提醒提前分钟数(到点前 N 分钟 + 到点各一条提醒;M38)
daily.portal.show-items0门户「今日」卡片是否展示待办标题:1 展示(最多 5 条未完成)/ 0 只展示计数(待办可能含私密信息,默认不展示;M38)
daily.reminder.catch-up-minutes120重启补偿窗口(分钟):重启后仅补投窗口内错过的提醒,超窗标记 skipped,避免过期提醒轰炸(M38)
daily.reminder.enabled1日程提醒总开关:1 开 0 关(关闭后扫描任务不生成也不投递提醒;M38)
daily.reminder.test.external-enabled1测试提醒是否允许外部通道:1 允许(默认,需确认+30秒冷却+每日10条);0 只发站内
daily.todo.default-remind-before30待办默认提前提醒分钟数(待办未单独设置 remind_before 时使用;M38)
site.ai.*(40)
site.ai.auto-summary1
site.ai.auto-tags1
site.ai.avatar.avatar``分身头像 URL
site.ai.avatar.daily-limit20访客每日对话轮次上限
site.ai.avatar.enabled1访客版 AI 数字分身开关:1 开启 0 关闭
site.ai.avatar.name小宇宙分身名称
site.ai.avatar.welcome你好,我是博主的 AI 数字分身,读过他发布的所有内容,来问点什么吧~分身欢迎语
site.ai.breaker-modeblock熔断模式:block 超限拒绝 / alert 仅告警 / off 关闭
site.ai.care.daily-limit3情感关怀每日条数上限(0=不限制):与 site.ai.proactive.daily-limit 是两道独立的闸,任一超限都…
site.ai.care.enabled1情感主动关怀开关:1 开 0 关(默认 0=先不打扰,先可关后开;关闭时 CareCheckInJob 记 skipped 后直接返回)
site.ai.care.interview-interval-days3访谈邀请间隔(天):多久之内不再主动邀请聊过去(默认 7 = 改动前的行为)。允许区间 [1,365]:越界/脏值由代码钳制或回落默认…
site.ai.daily-token-limit**(已掩码)**每日 AI token 限额(成本熔断,0 表示不限制;仅限制访客侧调用)
site.ai.digest.auto-draft0每日总结是否建文章草稿(默认 0;草稿≠发布,AI 绝不自动发布,发布由博主在文章页手动做;M42)
site.ai.digest.auto-note1每日总结是否写一条私密笔记(默认 1;笔记模块完全私有、仅后台可达;M42)
site.ai.digest.diary-mode1记模式1=天私人记认0=容
site.ai.digest.enabled1每日总结总开关:1 开 0 关(默认关;开启后到点自动生成小结,产物只进私密笔记/文章草稿;M42)
site.ai.digest.hindsight-context.enabled1记否使 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.enabled0记否许稿认 0记含私禁止
site.ai.digest.time00:20每日总结时间点(HH:mm,如 23:30):只存时间点不存 cron,任务每分钟轮询到点触发;M42
site.ai.egressnormal全局出网档位(V41):normal/minimal/frozen;测试期间临时置 frozen
site.ai.hindsight.recall-max-tokens**(已掩码)**Hindsight 默认召回预算 token(0=交给 Hindsight 默认;默认 2048)
site.ai.image-enabled0AI 生成封面图开关:1 开 0 关
site.ai.image-ingest.daily-limit0每日自动读图上限(0=不限;明确要求看图不占额度)
site.ai.image-model``AI 生图模型(留空用通道默认,如 dall-e-3 / flux-schnell)
site.ai.image-size1024x1024AI 生图尺寸(如 1024x1024 / 1024x1792 / 1792x1024)
site.ai.mcp.enabled1MCP 记忆服务开关:1 开(/api/agent/mcp 提供工具面)/ 0 关(tools/list 返回空、tools/call…
site.ai.mcp.result-max-chars20000MCP 工具结果的字符上限(默认 4000 ≈ 4000 token,改动前的行为)。工具结果直接进模型上下文:20000 是上下文窗…
site.ai.mcp.search-max-budget12000检索类工具返回给模型的字符预算上限(默认 4000 = 改动前的行为,budget_tokens 参数的钳制上界);下限 200 写死…
site.ai.mcp.search-max-limit100检索类工具单次返回条数的上限(默认 20 = 改动前的行为,limit 参数的钳制上界);100 为噪声上界
site.ai.moderation-actionflagAI 审核处置:flag 标记待人工复核 / reject 直接拒绝提交
site.ai.moderation-enabled0AI 内容审核(评论/留言):1 开 0 关
site.ai.open-loop.first-mention-days1未了线头「首次提起」前的最少等待天数(默认 1 = 本轮刻意的新行为;设 5 = 旧行为)。旧逻辑对从未提过的线头也用 5 天…
site.ai.proactive.daily-limit200主动性每日次数上限(0=不限制):超限不发消息、写 proactive_log(status=skipped) 后台可见(只降级不静默…
site.ai.proactive.enabled1主动性总开关:1 开 0 关(缺省视为开)。关闭后晨报/晚报/关怀/线头/访谈/周复盘/上课与待办提醒全部不再主动发出(六个 handler 共用 ProactiveSwitch;2026-11-18 审查 #30 前只有访谈读它)
site.ai.reply-suggest-enabled1AI 回复建议开关(评论/留言管理页)
site.ai.state.loop-chars1500580 = 3 p95(193 )10000
site.ai.state.loop-limit6每轮注入「未了线头」的条数上限(默认 3 = 改动前的行为);20 为技术上界
site.ai.writing-assistant-enabled1AI 写作助手开关(编辑器内的润色/续写等)
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-dim1夜间图片降亮:1 开 0 关(默认关)。开启后夜间/纯黑档的正文图片整体降亮 14%,缓解白底截图与示意图在暗色下刺眼
site.appearance.densitycomfortable界面密度:comfortable 舒适(默认)/ compact 紧凑(间距与留白整体收缩,适合列表密集型站点)
site.appearance.fontsans正文字体档:sans 无衬线(默认)/ serif 衬线(长文阅读)
site.appearance.max-width1200版心最大宽度(px,960–1600):1080 紧凑 / 1200 标准 / 1320 舒展 / 1440 宽屏
site.appearance.motionfull动效强度:full 完整 / reduced 精简(等同系统"减少动效"偏好)
site.appearance.radiussoft圆角风格:soft 圆润 14px / standard 标准 10px / sharp 利落 6px
site.appearance.theme-defaultauto访客默认主题:auto 跟随系统 / light 日间 / dark 夜间(访客手动切换后以其选择优先)
site.article.*(1)
site.article.private-default-visible0新建文章默认可见性:0 公开 / 1 仅管理员可见(M31 起不可凭密码访问)
site.backup.*(1)
site.backup.dir``备份目录:留空用默认 /opt/vite-cosmos/backup(M34 登记,运维中心使用)
site.banner.*(5)
site.banner.imagehttps://uapis.cn/api/v1/image/bing-daily首页横幅背景图 URL
site.banner.modefull首页横幅形态:hidden/mini/normal/full
site.banner.subtitle首页横幅副标题(留空取站点描述)
site.banner.title首页横幅标题(留空取站点名)
site.banner.typing1首页横幅副标题打字机效果:1 开 0 关
site.comment.*(3)
site.comment.audit1评论/留言是否需要审核:1 需要 0 不需要
site.comment.forbidden_words赌博,色情,代开发票敏感词库(逗号分隔)
site.comment.top-enabled1评论置顶功能开关:1 开 0 关
site.conversation.*(1)
site.conversation.agent-turn-retention-days0agent_turn(聊天轮次)保留天数;0=永久保留(默认)。开启后只删"记忆抽取水位已覆盖"的旧轮次
site.conversation.raw-retention-days14会话原文(agent_session_raw)保留天数;0=永久保留。实测约 87 MB/天,14 天稳态约 1.2 GB。判定所需字…
site.daily.*(3)
site.daily.holiday.enabled1节假日感知开关:1=按外部源判定放假/补班;0=关闭(默认,与"没有节假日数据"的旧行为一致)。关闭时一切判定返回 UNKNOWN,A…
site.daily.holiday.source-urlhttps://raw.githubusercontent.com/NateScarlet/holiday-cn/…节假日数据源({year} 替换为年份)。默认 holiday-cn(CI 每日抓国务院公告)。⚠️ 该源许可未核实,介意请换源 ——…
site.daily.holiday.years-ahead1除当年外再往前拉几年(默认 1):次年安排通常在当年 11-12 月公告,12 月的日期可能被下一年文件影响,所以必须同时看 N 与 N+1
site.description.*(1)
site.description记录学习笔记、思想感悟与日常生活站点描述
site.extension.*(3)
site.extension.kill-switch0扩展平台全局 kill switch(1=所有新 run 跳过;管理端可切换,重启保持)
site.extension.approval.free-tokens-per-plugin20000插件系统:单插件每日免费 token 额度;0=任何花费都先审批
site.extension.approval.free-tokens-global100000插件系统:全部插件每日免费 token 总额度(预留)
site.footer.*(12)
site.footer.brand-displaynone页脚品牌区展示档位:none 都不显示 / name 仅站名 / desc 仅描述 / both 站名+描述(V26 由 brand-…
site.footer.copyright© {year} {owner}{year} / {owner} / {site} {year}
site.footer.icp-enabled1页脚展示 ICP 备案号:1 展示 0 隐藏
site.footer.links-enabled0页脚展示站点导航快捷链接(取主导航前 N 项):1 展示 0 隐藏
site.footer.links-limit6页脚导航快捷链接最多展示条数(0–12,取主导航前 N 项)
site.footer.meta-layoutcenter底部信息条排布:split 左右分栏(版权+运行时长 / 备案) / center 居中单列(移动端始终居中)
site.footer.milestone-enabled1站点周年徽标:上线周年当天在运行状态旁展示「N 周年」徽标(1 开 0 关)
site.footer.owner志尊威少版权所有者(如公司或个人名;留空取站点名称)
site.footer.police-enabled1页脚展示公安网安备案号:1 展示 0 隐藏
site.footer.styleclassic页脚布局档位:classic 经典(品牌区+订阅+部件区+信息条)/ compact 紧凑(去掉品牌描述与部件区间距)/ minima…
site.footer.time-displaynone页脚时间信息档位:none 不显示 / uptime 仅运行天数 / since 仅始于日期 / both 两者(V26 由 upti…
site.footer.uptime-label``运行天数文案模板:支持 {days} 天数 / {years} 整年数 / {months} 余月数 / {start} 起始日期;留…
site.home.*(2)
site.home.card-styleclassic首页文章卡片样式:classic/compact/media
site.home.page-size10首页文章列表每页条数(前台分页,1–50,默认 10)
site.icp.*(1)
site.icp湘ICP备2025124058号-1ICP 备案号(页脚展示)
site.image.*(6)
site.image.compress-enabled1服务端图片压缩开关:1 开 0 关(仅 jpg/png 且超过阈值时处理)
site.image.max-width1920服务端压缩最长边(像素,超过则等比缩放)
site.image.quality82JPEG 输出质量(1-100)
site.image.watermark-enabled0图片水印开关:1 开 0 关(开启后所有上传图片加文字水印)
site.image.watermark-positionbottom-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-enabled0评论总开关:0 关闭(前台隐藏表单且后端拒绝提交)
site.interaction.like-enabled0说说点赞开关
site.interaction.link-apply-enabled0友链自助申请开关
site.interaction.message-enabled0留言板开关
site.job.*(2)
site.job.heartbeat.stale-minutes30心跳停摆告警阈值(分钟,默认 30):外部心跳(chainProbe/bridgeHeartbeat/ingestHeartbeat)…
site.job.scheduler.pool-size4调度线程池大小(默认 1=Spring Boot 默认/改动前行为;本种子 4 是用户批准的变更)。为什么需要:16 个定时任务曾共用…
site.launched-at.*(1)
site.launched-at2026-09-30站点上线日期(YYYY-MM-DD):页脚「已运行 N 天」的起点,也是「始于」文案的来源
site.layout.*(2)
site.layout.sidebar-positionright侧栏位置:none/left/right
site.layout.toc-modesticky目录形态:sticky 粘性 / float 浮动按钮
site.logo.*(1)
site.logo``站点 Logo URL(前台导航展示)
site.mail.*(8)
site.mail.enabled1邮件通知开关:1 开启 0 关闭
site.mail.hostsmtp.163.comSMTP 服务器地址(M34 登记)
site.mail.notify-commenter0评论/留言被回复或审核通过时通知访客(1 开 0 关)
site.mail.passwordenc***(已掩码)SMTP 授权码(密文入库、回显掩码;留空表示不修改;M34 登记)
site.mail.port465SMTP 端口:465 走 SSL、587 等走 STARTTLS(M34 登记,默认 465)
site.mail.ssl1SMTP 是否使用 SSL(M34 登记,默认 1)
site.mail.tovite66@163.com通知邮件接收地址
site.mail.usernamevite66@163.comSMTP 账号(同时作为发件人与默认收件人;M34 登记)
site.maintenance.*(2)
site.maintenance.enabled0维护模式:1 开启后门户接口返回维护提示
site.maintenance.message站点正在维护升级,稍后回来~维护模式提示语
site.media.*(2)
site.media.folder-enabled1媒体库分组功能开关:1 开 0 关
site.media.srcset-template``图片 DPR 模板(可选):如 {url}?x-oss-process=image/resize,w_{w} 或 {url}?w={w…
site.memory.*(1)
site.memory.max-candidates4000+ 8000 1000-20000M41 17.2.3#1
site.name.*(1)
site.nameViTe 小宇宙站点名称
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-material1晨晚报在「课程/待办/昨晚总结」全空时是否改用兜底素材(默认 1 = 本轮刻意的新行为;设 0 = 旧行为:整天不发)。兜底素…
site.notify.brief.extra-url``已退役(2026-11 晨晚报迁到扩展平台,本键已无读取方;保留在库里只为不丢历史值)。原先用于"从这里 GET 一段文本追加到晨晚报"
site.notify.brief.use-model1已退役(2026-11-18:删掉「简报二次润色」,润色统一由 DSH compose 同步完成;库里保留历史值)
site.notify.compose.lead-minutes10已退役(2026-11-18:删除预生成缓存层,同步润色没有"提前量"概念;库里保留历史值)
site.notify.channelswechatIM 渠道开关(M39):非空才启用 webhook(IM)通道,留空只用邮件;v1 只支持一个 webhook 实例(形态由 sit…
site.notify.compose.enabled1主动提醒(晨晚报/关怀/线头/提醒)是否在发送前同步经 DSH 润色:1 开 0 关(默认 0;超时或失败自动回退模板,不丢消息)
site.notify.compose.max-chars240DSH 润色后文案的最大字符数(默认 240),超出截断(按 code point 截,不会劈开 emoji)
site.notify.compose.reminder-lead-minutes10提醒提前多少分钟预润色(钳制 3–30)。到点只读缓存,DSH 慢/挂回退模板;缓存表 proactive_compose
site.notify.compose.scenesmorning_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-ms20000同步润色的最长等待毫秒(默认 20000,钳制 1000–60000)。实测 DSH 一次润色约 12s,故不能设太小;超时回退模板。V160 把历史上被 V125 写成 90000 的值归一为 20000(否则库里 90000、运行时限到 60000、面板也显示 90000,三处不一致)
site.notify.compose.tokenenc***(已掩码)DSH compose 内部令牌(密文入库;请求头 X-Compose-Token)
site.notify.compose.urlhttp://127.0.0.1:8790/composeDSH compose 内部端点(默认 http://127.0.0.1:8790/compose;只监听 loopback,由微信桥提供)
site.notify.morning-brief-time07:40已退役(迁到扩展触发器 cron)。原先的晨报时间;现在改 system.brief.morning 触发器的 cron
site.notify.evening-brief-time22:30已退役(迁到扩展触发器 cron)。原先的晚报时间;现在改 system.brief.evening 触发器的 cron
site.notify.quiet-hours23:30-07:30静默时段(HH:mm-HH:mm,可跨午夜):时段内只允许紧急到点提醒,其它主动性一律不发(写 skipped 留痕;M44)
site.notify.webhook.token``IM 推送凭据(bark device_key / serverchan key / pushplus token;密文入库、回显掩码…
site.notify.webhook.typecustomIM 推送形态:bark / pushplus / serverchan / wecom_bot / custom(各家 body 字…
site.notify.webhook.urlhttp://127.0.0.1:8790/notifyIM 推送地址:留空按形态用默认服务地址(bark=https://api.day.app、pushplus=https://www.…
site.police.*(2)
site.police粤公网安备44011302004889号公安网安备案号(如 京公网安备1101050203XXXX号;留空则页脚不展示)
site.police.iconhttps://vite66.cn/uploads/wp/2025/06/备案图标.png公安备案图标 URL(官方图标;留空则使用内置盾牌 SVG)
site.reader.*(3)
site.reader.font-size17门户默认正文字号(px),读者可在前台自行调节
site.reader.line-height1.85正文默认行距(1.5–2.2),读者可在前台自行调节
site.reader.width1200正文默认版心宽度(px;0 表示跟随页面容器),读者可在前台自行调节
site.reward.*(3)
site.reward.alipay``支付宝赞赏码图片 URL
site.reward.enabled1赞赏功能全局开关(文章级开关在其之上)
site.reward.wechat``微信赞赏码图片 URL
site.safety.*(1)
site.safety.modeofftest
site.search.*(1)
site.search.log-enabled1记录站内搜索词(用于搜索词报告与热门搜索):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-enabled0登录异常告警:新 IP 登录时发邮件提醒(1 开 0 关)
site.seo.*(3)
site.seo.baidu-token``百度站长平台推送 token(留空则不推送)
site.seo.keywords个人博客,学习笔记,AI 数字分身SEO 关键词
site.seo.rss-enabled1RSS 订阅开关:0 关闭后 /rss.xml 返回 404
site.stats.*(2)
site.stats.weekly-report-enabled0每周数据周报邮件: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-style0是否使用 Path-Style 访问(MinIO 需开启:1)
site.storage.oss.prefixvite-cosmos对象键前缀(便于与其他业务隔离)
site.storage.oss.regionus-east-1区域(MinIO 可随意填写)
site.storage.oss.secret-key``Secret Key(加密存储)
site.storage.typelocal文件存储方式:local 本地 / oss 对象存储
site.subscriber.*(2)
site.subscriber.enabled0邮件订阅开关:1 开 0 关
site.subscriber.notify-enabled0新文发布是否邮件通知订阅者:1 是 0 否
site.update.*(1)
site.update.latest-version``最新版本号(用于后台版本提示,手工维护)
site.url.*(1)
site.urlhttps://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 / DSHCOSMOS_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 的三处漂移)

本页由 docs/vite-cosmos-项目说明.md 自动生成;请改源文件,不要改生成物。