dsh-smooth-scroll 0.1.1-rc.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VinciBeans
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# dsh-smooth-scroll
+
+## 简介
+
+让 DSH 的会话滚底从"官方瞬时跳变"变成**流畅顺滑的跟随滚动**：会话装载与"回到最新"
+保持瞬时（这是"跳"的正确语义），而流式内容增长期间，消息列以**恒定速度平滑跟随**，
+起步轻柔、收尾绵软。
+
+实现上**不触碰任何 transform**——直接对原生 `scrollTop` 做有节奏的动画，并用一个
+**合成 getter** 在动画期间向 DSH 报告"目标值"，因此它的跟随状态机（是否在底部、
+是否用户滚动）完全不受影响：不会误判脱钩、不会重复钉底、输入栏等 UI 丝毫不被扰动。
+系统开启"减少动效"（`prefers-reduced-motion`）时自动回退官方瞬时行为。
+
+## 行为（最终架构：无 transform）
+
+直接在**原生 scrollTop** 上做有节奏的平滑滚动，配合**合成 getter**：平滑期间
+`scrollTop` 读到"目标值"，DSH 自身的状态机（movedByReader/atBottom）永远看不到中间
+位置——不会误判脱钩、不会重复钉底。
+
+- **速度剖面（velocity chase + 缓启动 + 软尾）**
+  - 起步：0 → 0.9px/ms，240ms smoothstep 爬升；
+  - 巡航：恒速 0.9px/ms（内容增长只更新目标点，曲线永不逐段重启）；
+  - 收尾：停止增长 >240ms 且剩余 ≤120px 时，220ms ease-out 软着陆；
+- **同目标兜底写入**（DSH 每滚动事件重跑 `toBottom`，目标不变）→ 忽略，动画不被逐帧重启；
+- **用户滚动接管**：真实位置偏离动画自身写入（唯一只能来自用户）→ 立即停动画、
+  getter 恢复真实、DSH 正常脱钩（"回到最新"按钮照常）；
+- `prefers-reduced-motion: reduce`：完全回退官方瞬时行为；
+- **不应用任何 transform**：输入栏 overlay/sticky 永不受扰（无瞬移、无毛边、无飞出）。
+
+## 历史教训（为什么不是 transform/rAF 手写）
+
+1. transform 补偿方案与 DSH 的输入栏 overlay 测量偶发交错 → 输入栏瞬移/毛边（已弃）；
+2. JS rAF 手写动画会冻结/重启问题（已弃）——最终版由 getter 掩盖中间态 + 恒速模型。
+
+## 构建
+
+```sh
+pnpm install        # 安装 esbuild devDependency
+pnpm run build      # 产出 lib/index.js + lib/client.js
+```
+
+`lib/` 已随仓库提交，克隆后可直接安装使用；改源码才需要重新构建。
+
+## 安装（永久生效）
+
+```sh
+bash install-real-profile.sh    # Windows 用 Git Bash / WSL；Linux/macOS 直接 bash
+```
+
+脚本执行：`pnpm add link:<本目录>`（~/.dsh/profiles/web/package.json）+ 向
+`cordis.patch.yml` 追加 `- insert: [{ id: smooth-scroll, name: 'dsh-smooth-scroll' }]`。
+然后**重启 dsh web**。注意：源目录为 link 安装，改 `src/client.js` 后重建即可热更到下次启动。
+
+## 卸载
+
+删除 `cordis.patch.yml` 对应 insert 块 + `pnpm remove dsh-smooth-scroll`，重启。
+
+## 调参
+
+所有参数都在 `src/client.js` 顶部常量区：
+
+| 常量 | 默认 | 含义 |
+|---|---|---|
+| `VEL` | 0.9 | 巡航速度（px/ms） |
+| `RAMP_MS` | 240 | 起步缓加速时长（smoothstep） |
+| `QUIET_MS` | 240 | 判定"停止增长"的静默窗口 |
+| `TAIL_PX` | 120 | 进入软尾的剩余距离阈值 |
+| `TAIL_MS` | 220 | 软尾缓动时长 |
+
+改完：`pnpm run build` → 重启 dsh web。
+
+## 源码
+
+- `src/client.js` — 浏览器半部（核心逻辑）
+- `src/index.ts` — 宿主半部（空 apply，仅为组合可见）

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh 组合包层（bundle layer）：把 dsh-smooth-scroll 插入 web 配置树。
+#
+# `name` 必须是包名（而非源码相对路径）；dsh 的 client-modules 节点半部扫描到这一行，
+# 读到 dsh.client 声明后把浏览器 bundle 挂到 /plugins/dsh-smooth-scroll/client.js。
+- insert:
+    - id: 'smooth-scroll'
+      name: 'dsh-smooth-scroll'

package/lib/client.js

@@ -0,0 +1,225 @@
+window.__ModuleLoader__.load({ id: "dsh-smooth-scroll", factory: (require) => { var module = { exports: {} }; var exports = module.exports; Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.js
+var client_exports = {};
+__export(client_exports, {
+  apply: () => apply
+});
+module.exports = __toCommonJS(client_exports);
+var VEL = 0.9;
+var RAMP_MS = 240;
+var QUIET_MS = 240;
+var TAIL_PX = 120;
+var TAIL_MS = 220;
+var easeOut = (t) => 1 - Math.pow(1 - t, 3);
+var smooth = (t) => t * t * (3 - 2 * t);
+var now = () => typeof performance === "object" && performance !== null && typeof performance.now === "function" ? performance.now() : Date.now();
+function apply(ctx) {
+  ctx.effect(() => {
+    const doc = document;
+    const root = doc.body ?? doc.documentElement;
+    if (typeof MutationObserver !== "function" || typeof requestAnimationFrame !== "function") return;
+    const reduced = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+    const states = /* @__PURE__ */ new Map();
+    let announced = false;
+    const readTop = (state) => state.chase || state.settle !== null ? state.target : state.desc.get.call(state.el);
+    const stopAll = (state) => {
+      state.chase = false;
+      state.settle = null;
+      state.rafId = 0;
+    };
+    const tick = (state, ts) => {
+      state.rafId = 0;
+      if (!state.el.isConnected) {
+        stopAll(state);
+        return;
+      }
+      if (state.lastTs === 0) state.lastTs = ts;
+      const dt = Math.min(50, ts - state.lastTs);
+      state.lastTs = ts;
+      if (state.settle !== null) {
+        const s = state.settle;
+        const t = Math.min(1, (ts - s.start) / s.ms);
+        const v2 = s.from + (s.to - s.from) * easeOut(t);
+        state.lastWrite = v2;
+        state.desc.set.call(state.el, v2);
+        if (t >= 1) {
+          state.settle = null;
+          state.lastTs = 0;
+          return;
+        }
+        state.rafId = requestAnimationFrame((t2) => tick(state, t2));
+        return;
+      }
+      if (!state.chase || state.target === null) {
+        state.chase = false;
+        state.lastTs = 0;
+        return;
+      }
+      const pos = state.desc.get.call(state.el);
+      const remaining = Math.max(0, state.target) - pos;
+      if (Math.abs(remaining) <= 0.5) {
+        state.desc.set.call(state.el, Math.max(0, state.target));
+        state.chase = false;
+        state.lastTs = 0;
+        return;
+      }
+      if (Math.abs(remaining) <= TAIL_PX && now() - state.lastPinTs > QUIET_MS) {
+        state.settle = { from: pos, to: state.target, start: ts, ms: TAIL_MS };
+        state.chase = false;
+        state.rafId = requestAnimationFrame((t2) => tick(state, t2));
+        return;
+      }
+      const ramp = Math.min(1, Math.max(0, (ts - state.chaseStart) / RAMP_MS));
+      const v = VEL * smooth(ramp);
+      const step = Math.sign(remaining) * Math.min(Math.abs(remaining), v * dt);
+      const nv = pos + step;
+      state.lastWrite = nv;
+      state.desc.set.call(state.el, nv);
+      state.rafId = requestAnimationFrame((t2) => tick(state, t2));
+    };
+    const writeScrollTop = (state, desc, value) => {
+      const el = state.el;
+      const current = desc.get.call(el);
+      const max = Math.max(0, el.scrollHeight - el.clientHeight);
+      const target = Math.min(value, max);
+      state.pinnedTop = target;
+      const isPin = value >= max - 1 && Math.abs(target - current) > 0.5;
+      if (!isPin) {
+        if (Math.abs(target - current) > 0.5) {
+          stopAll(state);
+          desc.set.call(el, value);
+        }
+        return;
+      }
+      if (reduced) {
+        desc.set.call(el, value);
+        return;
+      }
+      const firstPin = state.firstPin;
+      state.firstPin = false;
+      const big = Math.abs(target - current) > state.el.clientHeight * 2;
+      if (firstPin || big) {
+        state.target = null;
+        state.chase = false;
+        state.settle = null;
+        desc.set.call(el, value);
+        return;
+      }
+      state.target = target;
+      state.settle = null;
+      state.lastPinTs = now();
+      if (!state.chase) {
+        state.chase = true;
+        state.chaseStart = now();
+        state.lastTs = 0;
+        state.rafId = requestAnimationFrame((t2) => tick(state, t2));
+      }
+    };
+    const attach = (el) => {
+      if (states.has(el) || typeof el.querySelector !== "function") return;
+      let proto = el;
+      let desc = null;
+      while (proto !== null) {
+        const candidate = Object.getOwnPropertyDescriptor(proto, "scrollTop");
+        if (candidate !== void 0) {
+          desc = candidate;
+          break;
+        }
+        proto = Object.getPrototypeOf(proto);
+      }
+      if (desc === null || typeof desc.get !== "function" || typeof desc.set !== "function") return;
+      const state = {
+        el,
+        desc,
+        flow: null,
+        pinnedTop: -1,
+        firstPin: true,
+        chase: false,
+        settle: null,
+        target: null,
+        lastPinTs: 0,
+        lastTs: 0,
+        rafId: 0,
+        lastWrite: 0,
+        chaseStart: 0
+      };
+      states.set(el, state);
+      Object.defineProperty(el, "scrollTop", {
+        configurable: true,
+        enumerable: false,
+        get() {
+          return readTop(state);
+        },
+        set(value) {
+          writeScrollTop(state, desc, value);
+        }
+      });
+      if (!announced) {
+        announced = true;
+        console.log("[dsh-smooth-scroll] attached to the conversation scroller");
+      }
+    };
+    const disposeState = (state) => {
+      stopAll(state);
+      if (Object.prototype.hasOwnProperty.call(state.el, "scrollTop")) {
+        try {
+          delete state.el.scrollTop;
+        } catch (e) {
+        }
+      }
+      state.flow = null;
+      states.delete(state.el);
+    };
+    const scan = () => {
+      for (const el of doc.querySelectorAll("*[data-conversation-scroll]")) attach(el);
+      for (const [el, state] of states) if (!el.isConnected) disposeState(state);
+    };
+    let scanQueued = false;
+    const queueScan = () => {
+      if (scanQueued) return;
+      scanQueued = true;
+      requestAnimationFrame(() => {
+        scanQueued = false;
+        scan();
+      });
+    };
+    const onDocScroll = (event) => {
+      const target = event.target;
+      if (target === null || target === void 0) return;
+      const state = states.get(target);
+      if (state === void 0) return;
+      const real = state.desc.get.call(state.el);
+      if ((state.chase || state.settle !== null) && Math.abs(real - state.lastWrite) > 0.5) {
+        stopAll(state);
+      }
+    };
+    doc.addEventListener("scroll", onDocScroll, { capture: true, passive: true });
+    const observer = new MutationObserver(queueScan);
+    observer.observe(root, { childList: true, subtree: true });
+    queueScan();
+    return () => {
+      observer.disconnect();
+      doc.removeEventListener("scroll", onDocScroll, true);
+      for (const state of [...states.values()]) disposeState(state);
+    };
+  });
+}
+return module.exports; } });

package/lib/index.js

@@ -0,0 +1,6 @@
+// src/index.ts
+function apply() {
+}
+export {
+  apply
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "dsh-smooth-scroll",
+  "version": "0.1.1-rc.2",
+  "description": "DSH 平滑滚底插件：会话装载与“回到最新”瞬时钉底，流式内容以恒速平滑跟随（缓启动/软尾）；无 transform、不扰动输入栏等 UI、不干扰 DSH 自身跟随状态机，prefers-reduced-motion 自动回退官方行为。适配 dsh-0.1.1-rc.2。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "smooth-scroll",
+    "scroll"
+  ],
+  "license": "MIT"
+}