@kabxx/dsh-btw 0.0.0-stage → 0.1.0

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,49 @@
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`:在右侧栏打开当前会话的侧问记录。「语音输入」插件就绪时,追问框可直接录音识别。
7
+
8
+ ## 安装
9
+
10
+ 从源码构建与打包需要 Node.js `>= 24.9.0`:
11
+
12
+ ```bash
13
+ git clone https://github.com/kabxx/dsh-btw.git
14
+ cd dsh-btw
15
+ npm ci
16
+ npm run pack:local
17
+ ```
18
+
19
+ 在 DSH 插件管理器中选择「添加插件」,填入 `dist/kabxx-dsh-btw-0.1.0.tgz` 的绝对路径;也可在运行 `npm run build` 后直接填入仓库目录的绝对路径。
20
+
21
+ ## 开发
22
+
23
+ 集成测试依赖本机已安装的 DSH(`0.2.2-rc.5`)。在 DSH 外部终端运行时,需先指定安装目录(以 npm 全局安装为例):
24
+
25
+ ```bash
26
+ export DSH_INSTALL_DIR="$(npm root -g)/@deepseek-ai/dsh"
27
+ ```
28
+
29
+ ```bash
30
+ npm ci
31
+ npm run build
32
+ npm test
33
+ npm pack --dry-run
34
+ ```
35
+
36
+ 修改客户端源码或词条后,运行 `npm run build` 更新 `dist/client.js`;`npm run pack:local` 会自动完成构建并在 `dist/` 生成安装包。
37
+
38
+ ## 项目结构
39
+
40
+ | 路径 | 内容 |
41
+ | --- | --- |
42
+ | [`src/host/`](src/host/) | 独立模型请求、侧问存储与远程接口 |
43
+ | [`src/client/`](src/client/) | 命令补全、侧问卡片、右侧栏与语音输入 |
44
+ | [`src/shared/`](src/shared/) | Host 与客户端共享的消息协议 |
45
+ | [`locale/`](locale/) | 中英文词条与插件元信息 |
46
+ | [`dist/`](dist/) | 客户端构建产物与本地安装包 |
47
+ | [`scripts/`](scripts/) · [`test/`](test/) | 构建脚本与回归测试 |
48
+
49
+ 插件入口与加载配置见 [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'