lyfZhixing/dsh-anchor-rail

README 摘要

dsh-anchor-rail DSH Web 会话锚点导轨插件：长会话快速定位历史问题。 功能 会话锚点导轨 - 会话聊天区左缘一条固定导轨，展示 当前模型表面上的全部用户问题 锚点（不随滚动移动，整组上下居中） - 悬浮导轨（或任意锚点）→ 导轨右侧展示全部锚点名称 ，每个名称与对应锚点垂直对齐（ 序号 + 问题文本 ），方便直接阅读问题并选择；移出后自动收起（150ms 宽限） - 当前正在阅读的问题对应锚点/名称 高亮加长 （品牌色），随滚动实时切换 - 点击锚点或名称跳转到该问题：已渲染的直接滚动定位（与当前判定同参考线，点击谁高亮谁）；窗口外的问题自动逐页加载历史后再定位，加载中锚点有脉冲动画 - 锚点过多时导轨内部滚动并跟随当前锚点，名称列表同步滚动 - 问题少于 2 个或内容无需滚动时导轨自动隐藏 效果展示 悬浮导轨后，全部锚点名称在导轨右侧按标记位置对齐展开（ 序号 + 问题文本 ），当前阅读的问题高亮： 安装 方式一：dsh plugin 安装（推荐） 方式二：profile 本地包 1. 将本仓库放到 /.dsh/profiles/web/plugins/dsh-anchor-rail/ 2. 在 /.dsh/profiles/web/package.json 增加： 3. 在 profile 目录执行 pnpm install 4. 重启 DSH Web 服务 工作原理 - Host 半 ： sessionQuery.readSurface 一次性读取会话当前模型表面的全部用户消息（compaction 后仍是完整表面，被折叠替换的旧问题自动排除），提取 {seq, text} 并按 sessionId + 表面尾部 seq 缓存——只有新消息才重读，其余请求均为缓存命中。通过 /dsh-anchor-rail/anchors 路由提供给客户端。 - Client 半 ：锚点按序号映射（渲染窗口始终是表面的后缀），标记等距分布、上下居中；滚动只扫描已渲染行计算"当前"索引；跳转窗口外问题时循环调用会话 loadOlder() （50 条/页）逐页加载直到目标渲染后定位。 结构 - lib/index.js — Host 半：锚点数据路由 + 缓存 - lib/client.js — Client 半（ window. ModuleLoader 打包格式）：导轨 + 悬浮名称列表 - cordis.patch.yml — bundle 组合层，插入 anchor-rail 行 License MIT

分类