@kabxx/dsh-btw 0.0.0-stage → 0.1.1

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/NOTICE ADDED
@@ -0,0 +1,50 @@
1
+ The plugin icon and the in-app side question glyph are adapted from Tabler Icons v3.31.0, message-circle-question.
2
+ https://github.com/tabler/tabler-icons/blob/v3.31.0/icons/outline/message-circle-question.svg
3
+
4
+ MIT License
5
+
6
+ Copyright (c) 2020-2024 Paweł Kuna
7
+
8
+ Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ of this software and associated documentation files (the "Software"), to deal
10
+ in the Software without restriction, including without limitation the rights
11
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ copies of the Software, and to permit persons to whom the Software is
13
+ furnished to do so, subject to the following conditions:
14
+
15
+ The above copyright notice and this permission notice shall be included in all
16
+ copies or substantial portions of the Software.
17
+
18
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ SOFTWARE.
25
+
26
+ The side question waiting indicator includes the ongoing StateDot markup, styles,
27
+ and animation timing from DeepSeek Harness Web 0.2.2-rc.5.
28
+ https://github.com/deepseek-ai/deepseek-harness
29
+
30
+ MIT License
31
+
32
+ Copyright (c) 2026 DeepSeek
33
+
34
+ Permission is hereby granted, free of charge, to any person obtaining a copy
35
+ of this software and associated documentation files (the "Software"), to deal
36
+ in the Software without restriction, including without limitation the rights
37
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
38
+ copies of the Software, and to permit persons to whom the Software is
39
+ furnished to do so, subject to the following conditions:
40
+
41
+ The above copyright notice and this permission notice shall be included in all
42
+ copies or substantial portions of the Software.
43
+
44
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
45
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
46
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
47
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
48
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
49
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
50
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,47 @@
1
- # Temporary Holding Version
1
+ # @kabxx/dsh-btw
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 面向 DeepSeek Harness(`0.2.2-rc.5`)的侧问插件。
4
+
5
+ - `/侧问 <问题>` 或 `/btw <question>`:基于当前对话已完成的上下文快照生成文本回答,在输入框上方展开侧问卡片;可通过卡片右上角入口移至右侧栏继续追问。
6
+ - `/侧问` 或 `/btw`:在右侧栏打开当前会话的侧问记录,支持查看单轮与累计 token 用量及上下文窗口占用。「语音输入」插件就绪时,追问框可直接录音识别。
7
+ - 支持多标签页与断线重连实时同步,追问发送失败或切换视图时自动保留未发草稿。
8
+
9
+ ## 安装
10
+
11
+ 需要 Node.js `>= 24.9.0`:
12
+
13
+ ```bash
14
+ dsh plugin --profile web add @kabxx/dsh-btw
15
+ ```
16
+
17
+ 也可在 DSH 插件管理器中选择「添加插件」并输入 `@kabxx/dsh-btw`。本地调试源码时,先执行 `npm ci && npm run build`,再填入仓库目录绝对路径或执行 `dsh plugin --profile web add .` 即可。
18
+
19
+ ## 开发
20
+
21
+ 集成测试依赖本机已安装的 DSH(`0.2.2-rc.5`)。在 DSH 外部终端运行时,需先指定安装目录(以 npm 全局安装为例):
22
+
23
+ ```bash
24
+ export DSH_INSTALL_DIR="$(npm root -g)/@deepseek-ai/dsh"
25
+ ```
26
+
27
+ ```bash
28
+ npm ci
29
+ npm run build
30
+ npm test
31
+ npm pack --dry-run
32
+ ```
33
+
34
+ 修改客户端源码或词条后,运行 `npm run build` 更新 `dist/client.js`;`npm run pack:local` 会自动完成构建并在 `dist/` 生成本地安装包。
35
+
36
+ ## 项目结构
37
+
38
+ | 路径 | 内容 |
39
+ | --- | --- |
40
+ | [`src/host/`](src/host/) | 独立模型请求、侧问存储与远程接口 |
41
+ | [`src/client/`](src/client/) | 命令补全、侧问卡片、右侧栏与语音输入 |
42
+ | [`src/shared/`](src/shared/) | Host 与客户端共享的消息协议 |
43
+ | [`locale/`](locale/) | 中英文词条与插件元信息 |
44
+ | `dist/` | 构建生成的客户端 bundle 与本地安装包 |
45
+ | [`scripts/`](scripts/) · [`test/`](test/) | 构建脚本与回归测试 |
46
+
47
+ 插件入口与加载配置见 [package.json](package.json) 和 [cordis.patch.yml](cordis.patch.yml),第三方素材声明见 [NOTICE](NOTICE)。
@@ -0,0 +1,3 @@
1
+ - insert:
2
+ - id: kabxx-btw
3
+ name: '@kabxx/dsh-btw'