dsh-plugin-terminal-agent

Readme

# dsh-plugin-terminal-agent · 终端智能体

在 DSH 会话中提供终端智能体面板，作为「对话」与「轨迹」之外的第三种会话形态。
打开后可以创建普通终端，也可以一键启动 Claude、Codex 等已配置的智能体并在新终端中继续工作。

插件通过 `conversation.view` 增量槽位添加页面，并直接加载 `dsh-better-sidebar` 提供的
`TerminalView`，因此复用其 xterm、PTY WebSocket、自动重连、终端主题和依赖诊断能力。

## 效果展示

### 在设置中管理终端智能体

在设置页的「终端智能体」中启用或停用终端智能体，也可添加自定义智能体命令和快捷指令。

![在设置中管理终端智能体](docs/images/terminal-agent-settings.png)

### 在终端使用指定智能体

打开会话的「终端智能体」页签，点击 `+` 后可创建普通终端，或直接选择已启用的智能体。

![在终端中启动指定智能体](docs/images/terminal-agent-launcher.png)

### 交接给新的智能体

「转发到新终端」会携带当前会话上下文，并在新终端中启动选中的智能体继续任务，原终端保持不变。

![将当前进度交接给新智能体](docs/images/terminal-agent-handoff.png)

## 功能

- 在「对话」和「轨迹」旁新增「终端智能体」页签
- 页签内提供二级终端标签栏，可同时管理多个独立终端
- 点击 `+` 菜单第一项「新终端」可创建空 shell；或在 Claude / Codex 等智能体项中创建带对应命令的终端，新终端会自动执行对应的 `claude` / `codex` 命令
- 设置页提供「终端智能体」菜单，可启用/禁用内置项，并分别配置名称、命令和启动参数
- 每个智能体可配置独立的快捷指令（标题、指令内容、工作区、是否启用）；工作区从宿主已有列表中选择，留空时全局通用
- 智能体终端底部同时展示全局快捷指令和当前工作区专属指令；点击后立即把指令内容写入当前 PTY 并执行
- 快捷指令配置随智能体写入 `~/.dsh/settings.yaml`，不使用浏览器缓存
- 智能体配置保存在 DSH 用户配置文件 `~/.dsh/settings.yaml` 的 `terminal-agent` 区域；升级后首次加载会自动迁移旧版浏览器 `localStorage` 配置
- 右上角「交接」可把当前会话交给已启用的另一智能体；完整 transcript 以只读文件保存，并附带原会话、工作目录和最近进展提示
- 双击二级终端标题可编辑；失焦或按 Enter 后保存，并在对应终端执行 `/rename 新标题`
- 每个终端首次提交的非空文本会自动成为终端标题，并在对应终端执行 `/rename 新标题` 设置智能体会话名称；标题会合并空白并截取前 60 个字符，后续输入不会覆盖
- 每个会话拥有独立且可重连的终端进程
- 自动使用当前会话工作目录
- 明暗主题自动适配
- 首次打开终端时才加载 xterm 资源

## 安装方式

### 方式一：从 GitHub 在线安装

```bash
dsh plugin --profile web add github:<GitHub 用户名>/dsh-plugin-terminal-agent
dsh web
```

### 方式二：Git Clone 下载后安装

```bash
git clone https://github.com/<GitHub 用户名>/dsh-plugin-terminal-agent.git
cd dsh-plugin-terminal-agent
npm install
npm run build
dsh plugin --profile web add "$(pwd)"
dsh web
```

安装并重启后，进入任意会话；顶部出现「终端智能体」页签即表示插件已生效。

## 开发

```bash
npm install
npm run build
dsh plugin --profile web add 'link:/你的路径/dsh-plugin-terminal-agent'
dsh web
```

构建产物位于 `lib/`，发布时必须一并提交。

## 依赖与兼容性

- 依赖 `dsh-better-sidebar >= 0.14.0` 提供终端 Host 路由和原生 `TerminalView`
- `dsh-better-sidebar` 必须在同一 web profile 中启用；本插件不会重复挂载它，以避免终端 Host 路由冲突
- 使用当前 DSH rc.8 系列的 `conversation.view`、`modules` 与 session standard props 契约