主题
十三、已知缺口与设计取舍
本章速览:这里列的是有意取舍或尚未实现的部分。读它的价值是避免"文档承诺了、代码却没有";每条都写明现状、影响与怎么补。
都是有意的取舍或尚未实现,写出来是为了避免"文档承诺了、代码却没有"。
| 缺口 | 现状 | 位置/影响 |
|---|---|---|
| 任务队列重启补偿 | @Async 任务队列在内存;重启时把遗留 running 记录改写成失败并注明「应用重启,队列不持久」,不会自动重跑 | module_system/runner/StaleJobLogReconciler;影响:重启瞬间在跑的后台任务需人工重放 |
| 生活模式的升维 / 过期回收 | 每次检出直接写入(由 Hindsight 版本覆盖收敛);升维与过期回收从未实现,统计里 expired 恒为 0 | module_memory/service/impl/EventPatternServiceImpl;影响:模式只增不降级 |
| AI 对话**「停止生成」** | 状态词表与接口都没有 cancelled;前端也没有按钮。要做需同时补状态机、端点与 UI | module_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;门户侧已本地打包,不受影响 |