dsh-remote 0.5.0 → 0.5.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 +25 -0
  2. package/README.zh.md +25 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -66,6 +66,31 @@ Provide a default machine in `cordis.patch.yml`:
66
66
 
67
67
  If `host` is empty the plugin starts disconnected and you configure machines in the UI.
68
68
 
69
+ ## CLI quick reference
70
+
71
+ Installing and driving DSH may live in different shells, so both the `dsh` binary and the `npx` form are shown. Always tell DSH **which profile** to use with `--profile <name>` (usually `web`).
72
+
73
+ ```bash
74
+ # install the bundle into a profile (npm is pulled by pnpm; recommended)
75
+ dsh plugin --profile web add dsh-remote
76
+ # same but when `dsh` is not on PATH (e.g. Windows PowerShell inside a repo)
77
+ npx --yes @deepseek-ai/dsh plugin --profile web add dsh-remote
78
+
79
+ # confirm it is installed wire
80
+ dsh plugin --profile web list
81
+ npx --yes @deepseek-ai/dsh plugin --profile web list
82
+
83
+ # start the web surface (reload profile; the plugin activates on boot)
84
+ dsh --profile web
85
+ npx --yes @deepseek-ai/dsh --profile web # http://127.0.0.1:3080
86
+
87
+ # use a local checkout instead of the npm version (dev iteration)
88
+ npx --yes @deepseek-ai/dsh plugin --profile web add D:/work/dsh-community/dsh-remote
89
+ npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-remote # back to release
90
+ ```
91
+
92
+ After a successful start, `Settings → 远程工作区` appears and the "Add workspace" flow gains the 本机 / 远程 tabs (screenshots above).
93
+
69
94
  ## Configuration
70
95
 
71
96
  | Key | Type | Default | Meaning |
package/README.zh.md CHANGED
@@ -67,6 +67,31 @@ dsh plugin add dsh-remote # 添加 bundle
67
67
 
68
68
  若 `host` 为空,插件启动时处于断开状态,在 UI 里配置机器即可。
69
69
 
70
+ ## 常用命令(安装 / 查看 / 启动)
71
+
72
+ DSH 的 `dsh` 可能不在某些 shell 的 PATH(比如 Windows PowerShell 里在某个仓库目录下),所以同时列出 `dsh` 与 `npx` 两种写法。操作都要用 `--profile <name>` 指定 profile(一般 `web`):
73
+
74
+ ```bash
75
+ # 安装(从 npm 拉到 profile)
76
+ dsh plugin --profile web add dsh-remote
77
+ # 同一效果:当 `dsh` 不在 PATH 时用 npx
78
+ npx --yes @deepseek-ai/dsh plugin --profile web add dsh-remote
79
+
80
+ # 确认已装
81
+ dsh plugin --profile web list
82
+ npx --yes @deepseek-ai/dsh plugin --profile web list
83
+
84
+ # 启动 web 界面(重载 profile,新插件在启动时生效)
85
+ dsh --profile web
86
+ npx --yes @deepseek-ai/dsh --profile web # 访问 http://127.0.0.1:3080
87
+
88
+ # 迭代用本地源码替换 npm 版(便于改 dsh 插件代码后即测)
89
+ npx --yes @deepseek-ai/dsh plugin --profile web add D:/path/to/dsh-remote
90
+ npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-remote # 恢复用发行版
91
+ ```
92
+
93
+ 启动成功后,设置 →「远程工作区」会出现;「Add workspace」流程会带「本机 / 远程」两个 tab(见上方效果图)。
94
+
70
95
  ## 配置
71
96
 
72
97
  | 键 | 类型 | 默认 | 说明 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-remote",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "Remote-work assistant for DeepSeek Harness: connect SSH (password or key), pick a remote workspace, operate on it with rw_pick_workspace / rw_list_dir / rw_read_file / rw_exec / rw_sync tools, and mirror it to a real local directory (SFTP) so the DSH native workspace can adopt it.",
5
5
  "keywords": [
6
6
  "deepseek-harness",