Skip to content

十三、已知缺口与设计取舍 ​

本章速览:这里列的是有意取舍或尚未实现的部分。读它的价值是避免"文档承诺了、代码却没有";每条都写明现状、影响与怎么补。

都是有意的取舍或尚未实现,写出来是为了避免"文档承诺了、代码却没有"。

缺口现状位置/影响
任务队列重启补偿@Async 任务队列在内存;重启时把遗留 running 记录改写成失败并注明「应用重启,队列不持久」,不会自动重跑module_system/runner/StaleJobLogReconciler;影响:重启瞬间在跑的后台任务需人工重放
生活模式的升维 / 过期回收每次检出直接写入(由 Hindsight 版本覆盖收敛);升维与过期回收从未实现,统计里 expired 恒为 0module_memory/service/impl/EventPatternServiceImpl;影响:模式只增不降级
AI 对话**「停止生成」**状态词表与接口都没有 cancelled;前端也没有按钮。要做需同时补状态机、端点与 UImodule_ai/service/AiChatTurnService;影响:长回答只能等完或刷新页面
异地备份所有备份同盘;无 NAS/对象存储客户端offsite-readiness.sh 显示 BLOCKED;业主已决定暂不处理 → 详见 §15.3(含怎么改)
部分表/列注释双重编码生产库里有 12 处(5 张表 + 7 个列,2026-11-17 实测 information_schema 正则计数)中文注释被存成了双重编码(乱码),成因是当时迁移执行的连接字符集不匹配。只影响元数据展示,不影响数据与查询;本文档中的注释已按迁移脚本原文还原。修它需要逐个 ALTER TABLE … COMMENT,属于纯美容,暂未做information_schema.columns/tables
DSH compose 的 token 不计入扩展预算台账主动消息润色走「后端 → 微信桥 /compose → DSH」,token 只记在桥侧日志;extension_budget_ledger 只由扩展 capability llm.chat 写入。因此 cosmos.extension.budget.monthly-tokens(默认 0=不启用)一旦打开,不会把 compose 消耗算进去影响:开启月度 token 限额时,主动消息润色这部分仍是"预算外"。修法:让 compose 客户端把桥返回的 usage 通过一个端口写入 extension_budget_ledger(跨模块,需要新增 SPI);当前先明确记录,不假装修好了
MCP tools/list 不按令牌 scope 过滤任何有效令牌都能看到全部 30 个主 MCP 工具(调用时才做 scope 校验并返回 403)。好处是实现简单;坏处是"只读/采集令牌"也会看到发布、删除类工具,模型可能据此尝试(然后吃 403)McpToolServiceImpl.listTools() 无 scope 参数;要修需给每个工具声明所需 scope(30 个工具 × 各 provider),属于可做但会影响工具面契约的改动,暂列缺口
微信主动推送依赖近期入站 context_token微信对"无上下文"的主动消息回 ret=-2 prepare failed(桥用最近一次入站 token 兜底,过期则失败)。失败后后端按设计降级邮件 → 站内,业务不报错deploy/agent/wechat-bridge/bridge.mjs;恢复:用微信给 bot 发一句话刷新 token(无需重新扫码);doctor.sh 会提示,但没有主动告警(只在跑体检/看 /health 时可见)
后台健康检查不主动推送桥的 /health 暴露 lastSendOk/lastSendError,但没有任何定时任务把它变成告警;doctor.sh 是手动跑的影响:微信侧静默失效时,只有"想起来跑一次体检"才能发现;后续可把该探针接进 chain-probe.sh 或 cron 告警
后台 Markdown 预览的代码高亮/公式/图表依赖外部 CDN,被 CSP 禁止,已关闭扩展(no-highlight/no-katex/no-mermaid/no-echarts)。2026-11-17 审查 #7 已修掉其中会造成控制台报错的部分:cropperjs/screenfull 改本地同源、prettier 直接禁用;要恢复高亮/公式/图表仍需把对应库打进 admin 包vite-cosmos-admin/* 的 MdEditor;门户侧已本地打包,不受影响

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