dsh-chat-buddy 0.0.0-stage → 0.1.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.
- package/CHANGELOG.md +75 -0
- package/LICENSE +21 -0
- package/README.md +86 -2
- package/cordis.patch.yml +9 -0
- package/lib/client.d.ts +46 -0
- package/lib/client.js +26577 -0
- package/lib/index.d.ts +16 -0
- package/lib/index.js +5949 -0
- package/market/icons/companion.svg +19 -0
- package/package.json +99 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.2
|
|
4
|
+
|
|
5
|
+
- 增加 macOS DSH Web `0.2.2-rc.1` 的精确版本兼容声明,隔离安装、三窗口、文本流式、图片、Stop、历史和 SSE 断流重连通过;运行代码与 0.1.1 相同,实际验收记录见 `docs/web-022-compatibility.md`;不包含 Desktop 或其他 rc 版本。
|
|
6
|
+
|
|
7
|
+
## 0.1.1
|
|
8
|
+
|
|
9
|
+
- 包名改为 `dsh-chat-buddy`,界面名改为 DSH Chat Buddy。
|
|
10
|
+
- 保留内部接口、插件节点、登录目录、环境变量、宽度设置及弹窗身份;不扩大宿主兼容范围。
|
|
11
|
+
- 更名包已公开发布;旧公开包 `dsh-deepseek-companion@0.1.0` 保留。迁移、回退和发布记录见 `docs/rename-migration.md`。
|
|
12
|
+
|
|
13
|
+
公开发布状态与当前验收进度以仓库 Releases / `docs/first-release.md` 为准;下方版本说明不代替发布记录。
|
|
14
|
+
|
|
15
|
+
## 0.1.0
|
|
16
|
+
|
|
17
|
+
- 支持 macOS 本地 DSH Web `0.1.5-rc.2` / `0.2.1-rc.2`;`0.2.2-rc.1` 与官方 Desktop 未验收,不在兼容声明内。
|
|
18
|
+
- Dock、可拖动 / 缩放 Float 与 Pop-out 共享 Host 消息和状态;三窗口跟随宿主主题,Pop-out 打开后同步字体 / 字号;提供键盘焦点、组合输入保护与可关闭的轻动效。
|
|
19
|
+
- 独立 DeepSeek 网页登录、文本流式、Markdown / 代码、Deep Think / Search、真实来源链接、跨窗口 Stop、新建和历史切换。
|
|
20
|
+
- PNG / JPEG / WebP / GIF 图文或纯图片发送,历史图片及失效文件名降级;草稿与页面附件身份冲突时安全拒绝。
|
|
21
|
+
- SSE 自动重连、页面 / Chromium 恢复、共享 30 s reconcile 预算、最多一次前端刷新、严格身份原地补全;删除证据不足时保留消息并阻止不确定发送,不自动重发。
|
|
22
|
+
- 官方 bundle 安装、Chromium 前置提示、图标及精确版本市场信息;市场使用需按公开记录添加可用索引。
|
|
23
|
+
- Search 结构化来源尽力恢复;空 parent anchor、树形历史、静默半开 SSE、多账号 / 文档附件 / Proxy 等边界见 README。完整支持范围与版本验收记录以仓库文档为准。
|
|
24
|
+
|
|
25
|
+
## 未发布:FR-2 缺陷收口
|
|
26
|
+
|
|
27
|
+
- 修复主文档失效后停在“检测失败”的恢复入口死锁:跨 origin 导航主动进入既有恢复流程,使用精确 origin 判定;旧页面及 dispose 后的迟到登录探测不再覆盖当前状态。新增 7 项生命周期接线回归;2026-11-07 同一新包的新旧固定 Web 页面故障复验通过。
|
|
28
|
+
|
|
29
|
+
- 聊天错误绑定 Host 实例与本轮 assistant 消息;同一条消息经权威状态确认完成 / 中断后清除旧提示,避免迟到错误响应重新出现;保留未恢复及身份不明的错误。
|
|
30
|
+
- 修复不确定会话中 Enter 绕过禁用按钮、清空草稿,以及跨状态选图继续上传的问题;Host 同步拒绝附件新增、Deep Think / Search 写操作,保留显式移除清理能力。
|
|
31
|
+
|
|
32
|
+
## 未发布:FR-1 市场与安装准备
|
|
33
|
+
|
|
34
|
+
- 使用官方 bundle 命令安装 / 激活插件,匹配 Chromium 从已安装 profile 准备;补充免费 npm / GitHub Pages 发布准备步骤。
|
|
35
|
+
- 首次浏览器启动失败时显示 Chromium 安装与重启提示,不把已存在浏览器的站点故障误报为安装问题。
|
|
36
|
+
- 增加随包 SVG 图标、明确标记未发布的市场索引草案及固定版本的官方索引校验;不新增运行依赖。
|
|
37
|
+
- 已补充用户提供的公开源码、主页、反馈地址和 npm 用户名 `caelum-maple`;发布认证待发布前核对,项目 Pages 索引尚未部署,未发布到 npm 或市场,版本仍为 `0.1.0-preview.2`。
|
|
38
|
+
|
|
39
|
+
## 0.1.0-preview.2 — 未发布候选(2026-10-20)
|
|
40
|
+
|
|
41
|
+
- 适配 DSH Web `0.2.1-rc.2` 的公开 Session 列表结构,保留 `0.1.5-rc.2` 的 `current` 选择;新版通过唯一的 `retainedBy.mainView` 判断主视图,无有效证据时使用 overlay。
|
|
42
|
+
- Dock 仍只在打开时选择一次 Surface;关闭后重新打开才重新判断,不读取 DSH 私有 UI 状态。
|
|
43
|
+
- 六个 DSH 开发类型包升级并固定至 `0.2.1-rc.2`,开发 Cordis 更新至 `^4.0.5`,运行 peer 保留 `^4.0.2`;精确声明两个 Web 运行时版本。
|
|
44
|
+
- 增加 13 个真实 Client 构建/Controller 回归场景,自动测试总计 667;完成新旧 Web 干净安装、Dock/Float/Pop-out、SSE EOF 重连,新版用官方本地 mock 验证非空 Session 的 rightbar。
|
|
45
|
+
- 新版首次引导改为可关闭的 Get started 弹窗;用户授权测试 profile 副本后,新版已登录核心矩阵通过(文本/Markdown、Deep Think/Search、跨窗口 Stop、图片历史/失败降级、SSE、空闲及流式中 Chromium 恢复)。会话删除等边界和升级/回退仍待验收,官方 Desktop 未支持。验收边界见 `docs/web-compatibility.md`。
|
|
46
|
+
|
|
47
|
+
## 0.1.0-preview.1 — 未发布候选(2026-10-19)
|
|
48
|
+
|
|
49
|
+
首个 Web 最小版预览候选,支持范围固定为 macOS、DSH Web `0.1.5-rc.2`、Node 22 与 Playwright `1.62.0` 的匹配 Chromium。该版本号不代表已发布或已通过最新版 DSH/官方 Desktop 验收。
|
|
50
|
+
|
|
51
|
+
### 已有能力
|
|
52
|
+
|
|
53
|
+
- 右侧 Dock、页面内可拖拽/缩放浮窗、独立浏览器窗口,共享 Host 状态。
|
|
54
|
+
- DeepSeek 网页登录持久化,文本流式聊天、Markdown/代码块、Deep Think、Search、Stop、新建及历史会话切换。
|
|
55
|
+
- PNG/JPEG/WebP/GIF 图片上传与发送、历史图片恢复、图片失效后的文件名降级。
|
|
56
|
+
- 页面/Chromium 故障恢复、按严格 identity 原地回填服务端回复、会话删除证据与恢复提示;不自动重发。
|
|
57
|
+
|
|
58
|
+
### 发布加固
|
|
59
|
+
|
|
60
|
+
- 修复新发图片立即切回历史时的页面临时图片地址问题。
|
|
61
|
+
- 修复窄屏浮窗边框造成的 2px 溢出。
|
|
62
|
+
- SSE EOF/请求失败自动退避重连,首个有效快照前禁用操作,保留消息和本地输入,完整清理连接与 timer。
|
|
63
|
+
- 接入 Prettier、Biome、类型检查、构建与测试门禁;迁移 tsdown 已弃用的 external 配置。
|
|
64
|
+
- 显式声明 `engines.dsh` 支持范围,采用本地 tarball 预览分发,随包附带本 Changelog。
|
|
65
|
+
|
|
66
|
+
- 补充干净 DSH_HOME 的首次引导步骤;通过官方 Configure later 路径即可使用 Companion,无需填写 DSH API Key。
|
|
67
|
+
|
|
68
|
+
### 已知限制
|
|
69
|
+
|
|
70
|
+
- 尚不支持最新版 DSH Web 与官方 Desktop;Desktop 的新窗口策略与当前独立窗口实现不兼容。
|
|
71
|
+
- Search 引用为 best-effort;未验证映射时不制造可点击来源。
|
|
72
|
+
- 极快连续发送的空 parent anchor 与树形历史仍 safe-fail;SSE 静默半开连接无主动心跳探测。
|
|
73
|
+
- 尚无文档附件、代理配置、DSH Composer Handoff、Task Brief、多账号或 Host 消息持久化能力。
|
|
74
|
+
|
|
75
|
+
源码中的历史 `v0.0.x` Git 节点属于开发进度记录,不据此声明已有公开分发版本。详细验收、兼容性来源和剩余工作见仓库的 `docs/release-preview.md`。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-deepseek-companion contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,87 @@
|
|
|
1
|
-
#
|
|
1
|
+
# DSH Chat Buddy for DSH
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
当前版本:`dsh-chat-buddy@0.1.2`。安装前以 [npm](https://www.npmjs.com/package/dsh-chat-buddy) 实际可下载版本为准。支持 **macOS、本地 DSH Web `0.1.5-rc.2` / `0.2.1-rc.2` / `0.2.2-rc.1`、Playwright `1.62.0` 匹配的 Chromium**;官方 Desktop、其它宿主版本/系统/浏览器及远程无界面部署未纳入兼容声明。插件要求 Node.js 22 或以上,同时需满足所选 DSH 宿主自身的 Node.js 要求。
|
|
4
|
+
|
|
5
|
+
在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 中使用自己的 DeepSeek 网页账号聊天,提供 Dock、页内 Float 与独立 Pop-out 三种窗口。`0.1.2` 保留 `0.1.1` 的运行实现,只增加新宿主的精确兼容声明;验收和发布记录见 [本轮兼容记录](docs/web-022-compatibility.md)。
|
|
6
|
+
|
|
7
|
+
原名 DeepSeek Companion。旧公开包 `dsh-deepseek-companion@0.1.0` 保留,但只兼容原来的两个固定 Web 版本;新旧包不能在同一 profile 同时启用。迁移保留原登录目录,详见文末和 [更名计划](docs/rename-migration.md)。
|
|
8
|
+
|
|
9
|
+
## 功能与边界
|
|
10
|
+
|
|
11
|
+
- 文本流式、Markdown / 代码、Deep Think、Search、跨窗口 Stop、新建及历史会话切换。
|
|
12
|
+
- PNG / JPEG / WebP / GIF 图文与纯图片发送;历史图片失效时保留文件名。
|
|
13
|
+
- 三窗口共享 Host 消息和状态;Float 可拖动、缩放,主题与可用字体设置跟随 DSH。
|
|
14
|
+
- SSE 断流重连、页面 / Chromium 恢复及严格身份原地补全;不确定时保留消息并阻止发送,不自动重发。
|
|
15
|
+
- 键盘焦点、组合输入保护、阅读历史时不抢滚动,以及支持减少动态效果的轻动效。
|
|
16
|
+
|
|
17
|
+
这是网页聊天工具,不是 DeepSeek API Provider 或 OpenAI-compatible Gateway。它不消耗 DeepSeek API 余额,但受网页账号限制和风控约束。**DSH 登录与 DeepSeek 网页登录是两套状态**;登录 DSH 不会自动登录 DeepSeek。
|
|
18
|
+
|
|
19
|
+
Search 只把真实取得并准确映射的来源变为链接,未映射编号保留为普通文本。极快连续发送的空 parent anchor、树形历史保持安全拒绝;SSE 静默半开没有主动心跳探测。首版没有文档附件、Proxy、多账号、Handoff 或 Host 消息持久化;不要把 Host 重启等同于浏览器恢复。
|
|
20
|
+
|
|
21
|
+
## 安装与首次登录
|
|
22
|
+
|
|
23
|
+
先运行 `dsh --version`,确认宿主属于上述三个固定版本。通过官方 bundle 命令安装已发布的确切版本:
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
dsh plugin --profile web add dsh-chat-buddy@0.1.2
|
|
27
|
+
dsh plugin --profile web exec playwright --version
|
|
28
|
+
dsh plugin --profile web exec playwright install chromium --no-shell
|
|
29
|
+
dsh --profile web --no-open
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
`web` 替换为实际 Web profile 名。Playwright 应显示 `1.62.0`;不要用 `playwright@latest` 代替安装后 profile 的匹配版本。Companion 使用完整可见 Chromium,`--no-shell` 省去额外的 Headless Shell。安装与运行使用同一用户;自定义 `PLAYWRIGHT_BROWSERS_PATH` 时,两者保持一致。
|
|
33
|
+
|
|
34
|
+
本地候选可把首条命令替换为 `dsh plugin --profile web add /path/to/dsh-chat-buddy-0.1.2.tgz`。从源码构建候选的命令见下方开发说明,不把未发布草案当作公开包。
|
|
35
|
+
|
|
36
|
+
官方 add 命令自动登记 bundle,无需手工 patch。曾手工加入旧 Companion patch 的用户,先停止 DSH 并备份配置,仅移除那条旧 Companion insert / 启动 patch,保留其它条目,避免重复加载。
|
|
37
|
+
|
|
38
|
+
启动后正常完成宿主预览引导:旧版可选 Continue → Configure later,新版可点“继续”并关闭 Get started。无需为 Companion 配置 DSH API Key。打开侧栏 Companion 入口,在独立 DeepSeek 网页中登录;随后返回 Companion 聊天。首次缺 Chromium 时,按界面提示安装并重启 DSH。
|
|
39
|
+
|
|
40
|
+
## 使用
|
|
41
|
+
|
|
42
|
+
- 在 Dock 标题栏切换 Float 或打开 Pop-out;三窗口共享消息和服务状态,输入框里的未发送文字属于各窗口本地草稿。
|
|
43
|
+
- 用“图片”添加附件,等待就绪后发送;失败附件需移除或重试。页面与 Companion 草稿不一致时会拒绝发送,请先检查网页,不要假定图片已经发出。
|
|
44
|
+
- 流式中使用“停止”;历史菜单支持上下方向键与 Esc,新建聊天或切换历史由 Host 确认后更新消息。
|
|
45
|
+
- 发生连接或浏览器故障时保留消息和草稿。会话无法确认时发送被禁用,可按提示新建或切换历史;恢复不会自动重发原消息。
|
|
46
|
+
|
|
47
|
+
官方 Discover 需要启用 Custom plugin markets 并添加索引,npm 发布不会自动进入所有用户的市场。正式索引为 `https://mycherish.github.io/dsh-deepseek-companion/index.json`。`0.2.1-rc.2` 的发现、安装与实际聊天已验收;其它已支持宿主可使用上面的命令行安装路径;本轮 rc.1 验收采用官方 CLI,未重做 Discover 界面流程。不能直接添加 `index.draft.json`。
|
|
48
|
+
|
|
49
|
+
## 升级、回退与卸载
|
|
50
|
+
|
|
51
|
+
更新前停止对应 DSH 实例并保留上一份已验证归档,再用官方 add 命令安装目标确切版本。重启后确认实际版本、DeepSeek 登录和历史切换;未发送草稿和 Host 内存消息不承诺跨进程升级持久化。
|
|
52
|
+
|
|
53
|
+
回退只使用同一宿主兼容的归档,不绕过 engines。原来的两个固定宿主可回退到公开 `dsh-chat-buddy@0.1.1`;`0.2.2-rc.1` 不能安装只支持旧宿主的 `0.1.1` 或旧名 `0.1.0`,不要用版本豁免绕过兼容检查。
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
dsh plugin --profile web remove dsh-chat-buddy
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
卸载后重启 DSH。普通卸载不删除 DeepSeek 登录目录,也不要手工删除整个 DSH_HOME。
|
|
60
|
+
|
|
61
|
+
## 开发
|
|
62
|
+
|
|
63
|
+
```sh
|
|
64
|
+
pnpm install --frozen-lockfile
|
|
65
|
+
pnpm format:check
|
|
66
|
+
pnpm lint
|
|
67
|
+
pnpm typecheck
|
|
68
|
+
pnpm build
|
|
69
|
+
pnpm test
|
|
70
|
+
# 已准备匹配 Chromium 后运行本地协议的真实组件交互回归
|
|
71
|
+
pnpm test:ui
|
|
72
|
+
pnpm pack --pack-destination dist/release
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
设计、版本兼容和安装 / 恢复验收记录见 [docs](https://github.com/mycherish/dsh-deepseek-companion/tree/main/docs)。`test:ui` 不代替真实站点、操作系统输入法或最终包矩阵。
|
|
76
|
+
|
|
77
|
+
问题反馈:[GitHub Issues](https://github.com/mycherish/dsh-deepseek-companion/issues)。请提供插件、宿主、操作系统和浏览器版本及复现步骤;不要附上 Cookie、token 或完整登录目录。
|
|
78
|
+
|
|
79
|
+
## Chat Buddy 安装与旧名迁移
|
|
80
|
+
|
|
81
|
+
新名称的精确安装命令(须确认 npm 已发布):
|
|
82
|
+
|
|
83
|
+
```sh
|
|
84
|
+
dsh plugin --profile web add dsh-chat-buddy@0.1.2
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
浏览器准备、宿主兼容范围和使用方式与上文相同。仅当对应 profile 已安装旧包时,先停止 DSH,执行 `dsh plugin --profile web remove dsh-deepseek-companion` 后再安装新包,重启并刷新界面。卸载新包使用 `dsh plugin --profile web remove dsh-chat-buddy`。保留旧浏览器目录与设置,不能在同一 profile 并装新旧包。旧公开包和原市场索引地址仍保留。
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# dsh-deepseek-companion bundle patch.
|
|
2
|
+
#
|
|
3
|
+
# This patch only inserts the current plugin into the composed Cordis tree.
|
|
4
|
+
# It must never remove DSH default plugins, replace default config, modify
|
|
5
|
+
# other bundles, or change the DSH preset.
|
|
6
|
+
|
|
7
|
+
- insert:
|
|
8
|
+
- id: deepseek-companion
|
|
9
|
+
name: 'dsh-chat-buddy'
|
package/lib/client.d.ts
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
|
|
2
|
+
import { Context } from "@deepseek-ai/cordis";
|
|
3
|
+
//#region src/client/index.d.ts
|
|
4
|
+
/** Cordis services the browser plugin requires before `apply`. */
|
|
5
|
+
export declare const inject: string[];
|
|
6
|
+
/** The surface a Companion dock currently occupies. */
|
|
7
|
+
export type CompanionSurface = 'rightbar' | 'overlay' | 'float';
|
|
8
|
+
/**
|
|
9
|
+
* Minimal shared UI state for the Companion dock.
|
|
10
|
+
*
|
|
11
|
+
* The surface is decided once per open: a non-blank session uses the official
|
|
12
|
+
* `rightbar` column (the conversation genuinely narrows); a blank session falls
|
|
13
|
+
* back to the frame-wide `shell.overlay` (root scope, available with no session
|
|
14
|
+
* content). The surface stays stable until close, so the UI never jumps between
|
|
15
|
+
* rightbar and overlay mid-session.
|
|
16
|
+
*/
|
|
17
|
+
export interface DockController {
|
|
18
|
+
isOpen(): boolean;
|
|
19
|
+
surface(): CompanionSurface | null;
|
|
20
|
+
dockWidth(): number;
|
|
21
|
+
setDockWidth(px: number): void;
|
|
22
|
+
/** Persist the current overlay width (no-op on rightbar / when closed). */
|
|
23
|
+
commitOverlayWidth(): void;
|
|
24
|
+
/** Open (or focus) the single Companion pop-out window. */
|
|
25
|
+
openPopout(): void;
|
|
26
|
+
/** Report the rightbar surface as open (called after the dock mounts). */
|
|
27
|
+
openRightbarSurface(): void;
|
|
28
|
+
/** Switch from the docked surface to the in-page floating window. */
|
|
29
|
+
enterFloat(): void;
|
|
30
|
+
/** Switch from the floating window back to the docked surface. */
|
|
31
|
+
dockBack(): void;
|
|
32
|
+
subscribe(listener: () => void): () => void;
|
|
33
|
+
toggle(): void;
|
|
34
|
+
open(): void;
|
|
35
|
+
close(): void;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* DeepSeek Companion browser half.
|
|
39
|
+
*
|
|
40
|
+
* Only the sidebar entry is registered at load. On open the dock transiently
|
|
41
|
+
* occupies `rightbar` (non-blank session) or `shell.overlay` (blank session),
|
|
42
|
+
* and disposes that registration on close — the shipped right Sidebar and the
|
|
43
|
+
* overlay roster both recover untouched.
|
|
44
|
+
*/
|
|
45
|
+
export declare function apply(ctx: Context): void;
|
|
46
|
+
//#endregion
|