paseo-dsh-direct 0.1.4 → 0.2.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.
Files changed (3) hide show
  1. package/README.md +36 -22
  2. package/README.zh.md +36 -22
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,37 +4,31 @@ English | [中文](README.zh.md)
4
4
 
5
5
  `paseo-dsh-direct` connects a local [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) to [Paseo](https://github.com/getpaseo/paseo) through a Direct Provider.
6
6
 
7
- Version `0.1.3` registers the provider `dsh-pi`, shown in Paseo as **DeepSeek Harness**. The plugin id is `paseo-dsh-direct`.
7
+ ## Install
8
8
 
9
- ## Install locally
9
+ You need `dsh` on the machine that runs the Paseo daemon, with the same `major.minor` as the plugin line you install.
10
10
 
11
- The validated alpha combination is Paseo `0.9.2`, DSH `0.1.7-rc.2`, and a supported Node.js runtime. DSH must already be installed on the Paseo Daemon host; no other DSH add-on is needed.
11
+ In Paseo, open **Settings → Plugins → Install Plugin** and paste either the npm or the Git source:
12
12
 
13
- ```bash
14
- git clone https://github.com/Jecvay/paseo-dsh-direct.git
15
- cd paseo-dsh-direct
16
- npm ci
17
- npm run build
18
- paseo plugin install "$PWD"
19
- paseo plugin ls
20
- paseo provider models dsh-pi
21
- ```
13
+ | Your dsh | npm | Git |
14
+ |---|---|---|
15
+ | `0.2.x` | `npm:paseo-dsh-direct` | `https://github.com/Jecvay/paseo-dsh-direct` |
16
+ | `0.1.x` | `npm:paseo-dsh-direct@dsh-0.1` | CLI only: `paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref release/0.1` |
22
17
 
23
- The same local source can be installed directly with `paseo plugin install /absolute/path/to/paseo-dsh-direct` after building. Git installation is available for an existing remote ref:
18
+ More: [compatibility](docs/en/compatibility.md) · [CLI and local install, environment variables](docs/en/installation.md)
24
19
 
25
- ```bash
26
- paseo plugin add Jecvay/paseo-dsh-direct --ref <tag-or-commit>
27
- ```
20
+ ## Why "Direct"
28
21
 
29
- ## Versioning
22
+ Most dsh integrations go through ACP, a generic protocol that every agent can speak. This plugin skips it and talks to dsh natively, so what dsh does shows up in Paseo the way Paseo expects:
30
23
 
31
- The plugin's `major.minor` tracks the dsh line it supports (`0.1.x` works with dsh `0.1.*`); the patch number is the plugin's own release count and does not follow dsh. Install the tag that matches your local dsh version.
24
+ - Replies and thinking stream smoothly instead of arriving in chopped pieces.
25
+ - Tool approvals and dsh's questions to you appear as Paseo's own approval and question cards.
26
+ - Your existing dsh sessions can be imported and resumed in Paseo.
27
+ - dsh's slash commands (`/compact`, `/plan`, ...) appear in Paseo's `/` menu.
32
28
 
33
- | Plugin line | dsh line |
34
- |---|---|
35
- | `0.1.x` | `0.1.*` |
29
+ ## Versioning
36
30
 
37
- See the [compatibility notes](docs/compatibility.md) for the full rule and the dsh versions actually tested.
31
+ The plugin's `major.minor` tracks the dsh line it supports; the patch number is the plugin's own release count and does not follow dsh. Install the line matching your local dsh version — see the table above, or the [compatibility notes](docs/compatibility.md) for the full rule and the dsh versions actually tested.
38
32
 
39
33
  ## Use
40
34
 
@@ -46,6 +40,26 @@ The plugin uses the DSH profile `paseo`. On first start it creates that profile
46
40
 
47
41
  If a native session is still held by another DSH client (such as a terminal UI), release it there before importing or resuming it from Paseo.
48
42
 
43
+ ## Install from source
44
+
45
+ For local development, or to install without going through the Settings UI:
46
+
47
+ ```bash
48
+ git clone https://github.com/Jecvay/paseo-dsh-direct.git
49
+ cd paseo-dsh-direct
50
+ npm ci
51
+ npm run build
52
+ paseo plugin install "$PWD"
53
+ paseo plugin ls
54
+ paseo provider models dsh-pi
55
+ ```
56
+
57
+ The same local source can be installed directly with `paseo plugin install /absolute/path/to/paseo-dsh-direct` after building. The CLI also accepts a Git ref that the Settings UI cannot:
58
+
59
+ ```bash
60
+ paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref <tag-or-commit>
61
+ ```
62
+
49
63
  ## Development
50
64
 
51
65
  ```bash
package/README.zh.md CHANGED
@@ -4,37 +4,31 @@
4
4
 
5
5
  `paseo-dsh-direct` 通过 Direct Provider，把本机的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）接入 [Paseo](https://github.com/getpaseo/paseo)。
6
6
 
7
- 当前版本为 `0.1.3`。插件注册 Provider `dsh-pi`，在 Paseo 中显示为 **DeepSeek Harness**；插件标识为 `paseo-dsh-direct`。
7
+ ## 安装
8
8
 
9
- ## 本地安装
9
+ 运行 Paseo daemon 的机器上要装好 `dsh`，它的 `major.minor` 要和你装的插件线一致。
10
10
 
11
- 当前 alpha 验证组合为 Paseo `0.9.2`、DSH `0.1.7-rc.2`，以及受支持的 Node.js 运行时。运行 Paseo Daemon 的主机需要预先装好 DSH，不需要额外的 DSH 扩展包。
11
+ 在 Paseo 里打开 **Settings → Plugins → Install Plugin**，npm 和 Git 两种来源任填一个：
12
12
 
13
- ```bash
14
- git clone https://github.com/Jecvay/paseo-dsh-direct.git
15
- cd paseo-dsh-direct
16
- npm ci
17
- npm run build
18
- paseo plugin install "$PWD"
19
- paseo plugin ls
20
- paseo provider models dsh-pi
21
- ```
13
+ | 你的 dsh | npm | Git |
14
+ |---|---|---|
15
+ | `0.2.x` | `npm:paseo-dsh-direct` | `https://github.com/Jecvay/paseo-dsh-direct` |
16
+ | `0.1.x` | `npm:paseo-dsh-direct@dsh-0.1` | 只能用命令行：`paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref release/0.1` |
22
17
 
23
- 构建后也可以直接安装本地源码：`paseo plugin install /absolute/path/to/paseo-dsh-direct`。从 Git 安装已有远端 ref：
18
+ 更多：[兼容性说明](docs/compatibility.md) · [命令行安装、本地目录安装、环境变量](docs/plugin-guide.md)
24
19
 
25
- ```bash
26
- paseo plugin add Jecvay/paseo-dsh-direct --ref <tag-or-commit>
27
- ```
20
+ ## 为什么叫 Direct
28
21
 
29
- ## 版本号
22
+ 其他 dsh 接入大多走 ACP，那是一套所有 agent 都能用的通用协议。本插件不走 ACP，直接原生对接 dsh，dsh 的各种行为都能按 Paseo 自己的方式呈现：
30
23
 
31
- 插件版本号的 `major.minor` 跟随它支持的 dsh 线（`0.1.x` 对应 dsh `0.1.*`）；最后一位是插件自己的发布计数，不跟 dsh 走。按本机的 dsh 版本选装对应 tag。
24
+ - 回复和思考过程流畅地流式输出，不会被切成一段一段。
25
+ - 工具审批和 dsh 向你提的问题，显示成 Paseo 自带的审批卡片和问答卡片。
26
+ - 已有的 dsh 会话可以导入 Paseo 接着用。
27
+ - dsh 的斜杠命令（`/compact`、`/plan` 等）出现在 Paseo 的 `/` 菜单里。
32
28
 
33
- | 插件版本线 | dsh 版本线 |
34
- |---|---|
35
- | `0.1.x` | `0.1.*` |
29
+ ## 版本号
36
30
 
37
- 完整规则和已实测的 dsh 版本见[兼容性说明](docs/compatibility.md)。
31
+ 插件版本号的 `major.minor` 跟随它支持的 dsh 线；最后一位是插件自己的发布计数，不跟 dsh 走。按本机的 dsh 版本选装对应线——见上表，完整规则和已实测的 dsh 版本见[兼容性说明](docs/compatibility.md)。
38
32
 
39
33
  ## 使用
40
34
 
@@ -46,6 +40,26 @@ Provider 支持连续正文和思考输出、工具执行与审批、用户问
46
40
 
47
41
  如果原生会话仍被另一个 DSH 客户端（如终端界面）占用，请先在那里释放，再从 Paseo 导入或恢复。
48
42
 
43
+ ## 从源码安装
44
+
45
+ 用于本地开发，或不走 Settings 界面直接安装：
46
+
47
+ ```bash
48
+ git clone https://github.com/Jecvay/paseo-dsh-direct.git
49
+ cd paseo-dsh-direct
50
+ npm ci
51
+ npm run build
52
+ paseo plugin install "$PWD"
53
+ paseo plugin ls
54
+ paseo provider models dsh-pi
55
+ ```
56
+
57
+ 构建后也可以直接安装本地源码：`paseo plugin install /absolute/path/to/paseo-dsh-direct`。命令行还能指定 Settings 界面给不了的 Git ref：
58
+
59
+ ```bash
60
+ paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref <tag-or-commit>
61
+ ```
62
+
49
63
  ## 开发
50
64
 
51
65
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "paseo-dsh-direct",
3
- "version": "0.1.4",
3
+ "version": "0.2.1",
4
4
  "description": "DeepSeek Harness Direct Provider Plugin for Paseo",
5
5
  "repository": {
6
6
  "type": "git",