dsh-vscode-workbench 0.1.6 → 0.1.8

package/README.en.md

@@ -34,6 +34,9 @@ Resizable and collapsible primary view, an extensible bottom panel, and a status
 ### DSH conversation
 Reuses the official conversation UI with messages, coding tools, models, attachments, and permissions.
 
+### Terminal
+The workbench includes an interactive local terminal powered by `node-pty` and xterm. Use the terminal icon in the left activity bar to open the bottom panel; it supports multiple terminals, renaming, resize, ANSI output, and Ctrl+C.
+
 ### Restore
 Persists the active view, tabs, widths, and panel state per workspace across reloads.
 
@@ -51,12 +54,21 @@ The workbench mounts through the official `sidebar.footer.action` and `shell.ove
   <br><em>Source control and commit graph</em>
 </p>
 
+![2026-08-31 22-52-58.png](https://pic1.imgdb.cn/i/034GkZFU8ULHsWgFio93Lw.png)
+
 ## Installation
 
 ```bash
 dsh plugin --profile web add dsh-vscode-workbench
 ```
 
+With pnpm, `node-pty` needs approval to run its native build script. If pnpm asks for it, add the following to the active profile's `pnpm-workspace.yaml`:
+
+```yaml
+allowBuilds:
+  node-pty: true
+```
+
 ## Shortcuts
 
 | Shortcut | Action |
@@ -66,10 +78,12 @@ dsh plugin --profile web add dsh-vscode-workbench
 | `Ctrl+Shift+G` | Open Source Control |
 | `Ctrl+S` | Save the active file |
 | `Ctrl+Alt+B` | Toggle the DSH conversation panel |
+| `Ctrl+\`` | Show or hide the terminal |
+| `Ctrl+Shift+\`` | Create a terminal |
 
 ## Security
 
-The host accepts only paths relative to the active DSH session workspace and rejects traversal and symlink escape. Saves use revision checks and atomic replacement. Git and ripgrep run with argument arrays rather than shell-concatenated commands.
+The host accepts only paths relative to the active DSH session workspace and rejects traversal and symlink escape. Saves use revision checks and atomic replacement. Git and ripgrep run with argument arrays rather than shell-concatenated commands. The terminal accepts same-origin loopback requests only, starts in the session workspace, and removes API keys, tokens, secrets, and similar environment variables.
 
 ## Development
 
@@ -80,7 +94,7 @@ pnpm test
 pnpm build
 ```
 
-Requires Node.js `^22.19 || >=24`, pnpm 11.7, and system Git.
+Requires Node.js `^22.19 || >=24`, pnpm 11.7, system Git, and the native build prerequisites for `node-pty` when no prebuild is available.
 
 ## License
 

package/README.md

@@ -35,6 +35,9 @@ Markdown 默认渲染，可切换源码与大纲；支持工作区相对链接
 ### DSH 对话
 右侧复用官方会话界面，保留消息、编程工具、模型、附件与权限能力。
 
+### 终端
+内置由 `node-pty` 与 xterm 驱动的本地交互终端。点击左侧活动栏终端图标打开底部面板，支持多终端、重命名、尺寸自适应、ANSI 输出与 Ctrl+C。
+
 ### 状态恢复
 按工作区保存活动视图、标签、栏宽与面板状态，刷新后继续工作。
 
@@ -52,12 +55,21 @@ Markdown 默认渲染，可切换源码与大纲；支持工作区相对链接
   <br><em>源代码管理与提交图表</em>
 </p>
 
+![2026-08-31 22-52-58.png](https://pic1.imgdb.cn/i/034GkZFU8ULHsWgFio93Lw.png)
+
 ## 安装
 
 ```bash
 dsh plugin --profile web add dsh-vscode-workbench
 ```
 
+使用 pnpm 安装时，`node-pty` 需要执行受限的原生构建脚本。若出现构建许可提示，请在当前 profile 的 `pnpm-workspace.yaml` 中加入：
+
+```yaml
+allowBuilds:
+  node-pty: true
+```
+
 ## 快捷键
 
 | 快捷键 | 操作 |
@@ -67,10 +79,14 @@ dsh plugin --profile web add dsh-vscode-workbench
 | `Ctrl+Shift+G` | 打开源代码管理 |
 | `Ctrl+S` | 保存当前文件 |
 | `Ctrl+Alt+B` | 显示或隐藏 DSH 对话栏 |
+| `Ctrl+\`` | 显示或隐藏终端 |
+| `Ctrl+Shift+\`` | 新建终端 |
+
+左侧活动栏的终端按钮会展开终端面板；已打开时再次点击不会关闭它。
 
 ## 安全
 
-Host 只接受当前 DSH 会话工作目录内的相对路径，并阻止目录穿越与符号链接越界。保存使用版本校验与原子替换；Git 与 ripgrep 使用参数数组启动，不拼接 Shell 命令。
+Host 只接受当前 DSH 会话工作目录内的相对路径，并阻止目录穿越与符号链接越界。保存使用版本校验与原子替换；Git 与 ripgrep 使用参数数组启动，不拼接 Shell 命令。终端只接受同源 loopback 请求，固定在会话工作目录启动，并移除 API key、token、secret 等敏感环境变量。
 
 ## 开发
 
@@ -81,7 +97,7 @@ pnpm test
 pnpm build
 ```
 
-需要 Node.js `^22.19 || >=24`、pnpm 11.7 与系统 Git。
+需要 Node.js `^22.19 || >=24`、pnpm 11.7、系统 Git，以及 `node-pty` 所需的本机构建环境（预编译产物不可用时）。
 
 ## 许可证