dsh-smooth-stream 0.1.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/README.en.md +103 -0
  2. package/README.md +62 -47
  3. package/lib/client.js +608 -75
  4. package/lib/client.js.map +1 -1
  5. package/lib/index.js +229 -0
  6. package/package.json +25 -3
  7. package/src/client/SmoothStreamCard.module.css +253 -0
  8. package/src/client/SmoothStreamCard.tsx +122 -0
  9. package/src/client/TypewriterAssistantNodeView.module.css +2 -2
  10. package/src/client/TypewriterAssistantNodeView.tsx +26 -11
  11. package/src/client/index.ts +96 -3
  12. package/src/client/locales.ts +74 -0
  13. package/src/client/smooth-stream-card-controller.ts +162 -0
  14. package/src/client/smooth-stream-settings-api.ts +65 -0
  15. package/src/client/teleprompterGlide.ts +71 -41
  16. package/src/package-meta.ts +39 -0
  17. package/src/plugin.ts +101 -0
  18. package/src/profile-installation.ts +121 -0
  19. package/src/settings-api.ts +33 -0
  20. package/src/settings.ts +30 -0
  21. package/README.zh.md +0 -88
package/README.zh.md DELETED
@@ -1,88 +0,0 @@
1
- # dsh-smooth-stream
2
-
3
- [English](README.md) | 中文
4
-
5
- [![featured on dsh-suite](https://img.shields.io/badge/featured%20on-dsh--suite-4d6bfe)](https://whyihaveyou.github.io/dsh-suite/)
6
-
7
- **dsh-smooth-stream** 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）的社区插件，给 Web 对话做**丝滑流式渲染**：字跟着模型走、换行滑入、不闪。不是官方发行的一部分。
8
-
9
- 项目主页：<https://laplace-bit.github.io/dsh-smooth-stream/>
10
-
11
- ## 效果
12
-
13
- 左：默认 Web UI。右：dsh-smooth-stream。
14
-
15
- ![左：未使用插件。右：使用 dsh-smooth-stream。](docs/compare.gif)
16
-
17
- ## 它做什么
18
-
19
- - **揭示跟着模型走。** 助手文本按到达速率出现。突发不会整段倒出来，慢流也不会停住再猛地补上。
20
- - **一直是 Markdown。** 代码、强调等在流式过程中就按格式渲染，没有先出纯文本再换成排版的交接。
21
- - **换行是滑进来的。** 新的一行或正在变高的工具卡片会滑入视野，而不是把整段记录往上顶一格。
22
- - **滚动条归你。** 往上翻看前文时 overlay 会松手。只有回到底部才会继续跟随——点「回到底部」也算。
23
- - **思考仍是内置那一行。** 推理用原来的 disclosure。它是当前流式尾部时展开，思考一结束就收起；箭头仍可手动开关。
24
- - **整轮一起动。** 运行中的工具卡片、模型重试、workflow run 共用同一套跟随，所以滑的是整轮回复，不只是助手正文。
25
- - **该停的时候会停。** `prefers-reduced-motion` 会直接给出全文，也不接管跟随。帧率低于 30 fps 且回复在屏外时，揭示会暂停，画面恢复后再补上。
26
-
27
- ## 安装
28
-
29
- 在 DeepSeek Harness 源码仓库里：
30
-
31
- ```sh
32
- pnpm dsh plugin --profile web add github:Laplace-bit/dsh-smooth-stream
33
- ```
34
-
35
- 如果 `PATH` 上已经有 `dsh`：
36
-
37
- ```sh
38
- dsh plugin --profile web add github:Laplace-bit/dsh-smooth-stream
39
- ```
40
-
41
- 第一次 `add` 失败是正常的。git 安装需要跑这个包的 `prepare` 脚本，pnpm ≥10 在你授权之前会拦截。打开 `~/.dsh/profiles/web/pnpm-workspace.yaml`，把 pnpm 打印的那段加进去。当前 pnpm 打印的是：
42
-
43
- ```yaml
44
- onlyBuiltDependencies:
45
- - dsh-smooth-stream
46
- ```
47
-
48
- 然后重新执行同一条 `add`。
49
-
50
- 启动界面：
51
-
52
- ```sh
53
- pnpm dsh web
54
- ```
55
-
56
- Host 日志里应出现 `[dsh-smooth-stream] plugin loaded!`。
57
-
58
- 卸载：`pnpm dsh plugin --profile web remove dsh-smooth-stream`（或 `dsh plugin --profile web remove dsh-smooth-stream`）。
59
-
60
- ## 配置
61
-
62
- 组合包默认 `preset: balanced`。要换节拍，在 profile 的 `cordis.patch.yml` 里改：
63
-
64
- | `preset` | 手感 |
65
- | --- | --- |
66
- | `realtime` | 更贴模型到达 |
67
- | `balanced` | 默认 |
68
- | `silky` | 缓冲更大，追上更慢 |
69
-
70
- `maxScrollSpeedPxPerSec`（默认 `1000`）是速度上限，避免第一次滞后过大时瞬移。
71
-
72
- ## 常见问题
73
-
74
- **这是 DeepSeek 官方插件吗？**
75
- 不是。它是 DeepSeek Harness（`dsh`）Web UI 的社区插件，MIT 协议开源，不属于 DeepSeek 官方发行。
76
-
77
- **dsh 插件怎么安装？**
78
- 用内置插件命令：在 dsh 源码目录运行 `dsh plugin --profile web add github:Laplace-bit/dsh-smooth-stream`（pnpm ≥10 的构建授权说明见[安装](#安装)）。
79
-
80
- **能用 npm 安装吗？**
81
- 暂时不能，目前只支持从 GitHub 安装。可以关注本仓库，npm 发布后会有通知。
82
-
83
- **支持 `prefers-reduced-motion` 吗？**
84
- 支持。系统开启减少动态效果时直接显示完整文本、不接管跟随；帧率低于 30 fps 且回复在屏外时，揭示自动暂停、恢复后再补上。
85
-
86
- ## 许可证
87
-
88
- [MIT](LICENSE)