dsh-memory-bridge

LIMITATIONS

Known limitations

**如实披露**（非 bug，是设计边界或未完成项）： | 项 | 状态 | 说明 | |---|---|---| | 提取质量依赖所选 LLM | 设计边界 | 写入端用 LLM，选错模型（如 reasoner 思考模型）会污染提取；默认预设已关思考，文档有"非思考模型"选型建议 | | 检索是词级相关度召回，非语义联想 | 设计边界 | BM25+RRF 按词命中相关度排序（含沿链/实体多跳扩展），对**措辞漂移**召回有限（靠别名/归链缓解），不适合"语义联想"类查询（如"和上次那个类似的东西"）| | 画像蒸馏为手动触发 | 未完成 | `DistillWorker`（每周 + idle 门槛自动调度）已实现，sidecar 未启动后台线程，当前需手动点「蒸馏画像」 | | `persona.py`（引擎内置人格库）| 刻意不接线 | agent 人格由 **DSH 侧 persona 插件/系统提示词**管理（引擎 README §9.5 明确不迁移清单）；本插件只负责"记忆"，不负责"分身人格" | | 偏好信号需 ≥3 次同类提及才提案 | 设计边界 | 避免单次随口一说即沉淀；反复表达才入 pending | | **无法替代会话历史全量重放** | 设计边界 | resume 旧会话时 DSH 会把全部历史重放进上下文，插件注入**叠加**在历史上、**无法替代或抑制**（历史由 dsh-session `deriveMessages` 全量生成，插件无裁剪 API）；会话内历史瘦身需靠 DSH compaction | | 本地小模型边缘波动 | 设计边界 | 4B 级本地模型在规范条文/别名等边缘用例有波动，云端全绿，低置信走 pending 人工兜底 | ### 语言环境说明（当前主要面向中文） **当前插件主要面向中文环境**。以下环节深度依赖中文，英文用户需要自行改造： | 环节 | 依赖中文的位置 | 英文用户改造建议 | |---|---|---| | **零 LLM 规则触发词** | `rules.py`（记住/记下/记住教训/踩坑/我喜欢/习惯/别用 等）+ `guard.py`（_DIRECTIVE / _FACT_HINTS / _CHIT_CHAT 等）| 在对应元组中**追加英文触发词**（如 remember / lesson learned / I like / don't use / today / project / thanks）——纯数据改动，不影响逻辑 | | **LLM 提取提示词** | `extract.py` 的 `_EXTRACT_PROMPT` / `_EXTRACT_PROMPT_SMALL`（中文提取指令 + 示例）| 编写**英文版提示词**并实测提取质量（提示词是提取质量命门，不能照译）| | **画像蒸馏提示词** | `distill.py` 的 `DISTILL_PROMPT`（中文）| 同步英文版 | | **UI 文案** | `client/client.js` 的 141 行中文 UI 字符串（tab 名/标签/提示）| 替换为英文或中英并存 | | **Agent 工具描述** | `lib/index.js` 的 3 个工具 `description`（模型可见）| 英文化利于模型理解工具用途 | > **注意**：中英并存（方案 A）时，若需按对话语言自动切换提示词，还需要新增**语言检测逻辑**（当前未实现，提取提示词固定为中文）。不做语言检测也可用——英文内容仍会被中文提示词提取（LLM 能理解中文指令），只是英文用户需自行评估提取质量是否可接受。 ---