dsh-ssh-tui 0.1.0 → 0.1.2

package/lib/types/tui.d.ts

@@ -178,6 +178,7 @@ export declare class SshTui {
     private input;
     private cursor;
     private inputFolded;
+    private inPaste;
     private history;
     private historyIndex;
     private status;
@@ -326,6 +327,10 @@ export declare class SshTui {
     /** /usage and /quota: show Zen billing info or live Go quota usage. */
     private runUsageCommand;
     private readonly handleData;
+    /** Handle one data chunk that may contain bracketed-paste markers. */
+    private processPasteChunk;
+    /** Insert pasted text into the input buffer; CR/LF are literal newlines. */
+    private handlePasteText;
     private handlePlainText;
     private handleChar;
     private handleDialogChar;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -41,7 +41,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
-    "README.zh-CN.md",
+    "README.en.md",
     "LICENSE"
   ],
   "license": "MIT",

package/README.zh-CN.md

@@ -1,206 +0,0 @@
-# dsh-ssh-tui
-
-DeepSeek Harness（`dsh`）的 SSH 友好交互终端插件：纯 ANSI 聊天式转录、流式输出、
-工具卡片、git 风格 diff、历史会话选择、滚动回看与鼠标点击展开，并带终端标题栏
-进度与完成提示音。
-
-English: [README.md](README.md)
-
-## 功能一览
-
-- 纯终端渲染，无需浏览器/鼠标/重量级终端框架，适合慢速或远程 SSH；
-- 模型思考流默认折叠，显示 `▸ 思考中 ⠹ · N 字 · Ns` 动画；结束后折叠为
-  `▸ 已思考 · N 行`，可单独展开；思考过程中也能实时展开/收起查看原文；
-- 工作区支持 markdown 渲染：多级标题（H1 放大/下划线、H2 下划线、H3 着色）、
-  粗体、斜体、行内代码、代码块、列表、引用与链接；模型最终回复以粗体白色显示；
-- 工具调用卡片化：彩色状态点（运行黄 / 成功绿 / 失败红）、shell 命令友好展示、
-  编辑工具 git 风格 diff（`-` 浅红底 / `+` 浅绿底 / 文件统计，编辑卡片默认展开且
-  diff 内容不截断）、JSON 参数与结果自动转可读内容；
-- 转录区滚动回看（`PgUp`/`PgDn`、鼠标滚轮），点击思考/工具标题行直接展开收起；
-- 输入框下方会话统计行：轮次/步数、模型与工具耗时、TTFT、tok/s、缓存命中率、
-  输入/输出 token（与 web 端口径一致）；
-- 历史会话启动选择器：`dsh --profile tui --resume`（或 `resume`）先选会话再进入；
-- 终端窗口标题栏：运行中旋转图标 + `运行中 · 工具 N`，完成后 `✓ 已完成`，并响
-  一声终端铃（`DSH_TUI_NO_BELL=1` 关闭）；
-- 审批、`ask_user_question`、子代理进度、`/mode` 模式切换、`/model` 模型切换、
-  `/resume` 会话切换等完整支持。
-
-## 环境要求
-
-- Node.js ≥ 22.19
-- DeepSeek Harness CLI：`npm i -g @deepseek-ai/dsh`
-- pnpm（`dsh plugin` 通过 pnpm 管理 profile 依赖）
-- 支持 ANSI 的终端（推荐 SSH 直连；Windows 用 PowerShell / Windows Terminal）
-
-## 部署指南
-
-### 方式一：一键脚本（推荐）
-
-```bash
-git clone https://github.com/cyjyyd/dsh-ssh-tui.git
-cd dsh-ssh-tui
-bash scripts/install.sh            # 默认安装到 tui profile
-```
-
-安装到其它 profile（例如自定义 `work` profile）：
-
-```bash
-bash scripts/install.sh work
-```
-
-脚本会依次：安装依赖 → 构建 `lib/` → 通过 `dsh plugin --profile <name> add link:<repo>`
-把插件链接进 profile，并自动把 `dsh-ssh-tui` 加入该 profile 的 `dsh.profile.bundles`。
-
-### 方式二：手动安装
-
-```bash
-cd dsh-ssh-tui
-npm install --no-audit --no-fund
-npm run build
-dsh plugin --profile tui add "link:$(pwd)"
-```
-
-### 方式三：npm 安装（发布后）
-
-前置要求：已全局安装 `@deepseek-ai/dsh`（`npm i -g @deepseek-ai/dsh`）且有 pnpm。
-
-```bash
-dsh plugin --profile tui add dsh-ssh-tui
-# 或在仓库内快捷执行：bash scripts/install-npm.sh
-# 指定其它 profile：bash scripts/install-npm.sh work
-```
-
-`dsh plugin add` 会从 npm 拉取包、写入 profile 依赖，并自动把 `dsh-ssh-tui`
-加入该 profile 的 `dsh.profile.bundles`。
-
-## 启动与命令行参数
-
-```bash
-dsh --profile tui                          # 直接进入主界面（新建会话）
-dsh --profile tui --resume                 # 打开历史会话选择器
-dsh --profile tui resume                   # 同上（选择器）
-dsh --profile tui --resume <session-id>    # 直接恢复指定会话
-dsh --profile tui resume <session-id>      # 等价写法
-dsh --profile tui --new                    # 显式新建会话（默认即新建，供脚本使用）
-dsh --profile tui --model deepseek-v4-flash
-dsh --profile tui --provider <id>
-dsh --profile tui --no-color
-```
-
-选择器操作：`1-9` 选择历史会话；`0` / `Enter` 新建；`Esc` 取消退出。
-
-## 交互与快捷键
-
-| 键 | 作用 |
-| --- | --- |
-| `Enter` | 发送；运行中则 steer 当前轮次；输入为空且有选中块时展开/收起 |
-| `↑` / `↓` | 输入为空时在思考/工具块间移动选择；有输入时切换历史 |
-| `Ctrl+N` / `Ctrl+P` | 在思考/工具块间移动选择 |
-| `Ctrl+R` | 全部展开/全部收起（逐项展开请用 `↑`/`↓` 选中后按 `Enter`） |
-| `Ctrl+T` | 折叠/展开输入框（折叠只影响显示，提交时仍为完整文本） |
-| 鼠标左键 | 点击思考/工具标题行直接展开/收起 |
-| `PgUp` / `PgDn`、滚轮 | 转录区滚动回看 |
-| `Esc` | 取消选择 / 回到底部 / 取消当前轮次 |
-| `Ctrl+C` | 中断当前轮次；空闲时退出 |
-| `Ctrl+D` | 退出 |
-| `Ctrl+L` | 重绘 |
-
-斜杠命令：`/help`、`/model`、`/mode`、`/resume`、`/status`、`/subagents`、
-`/usage`（`/quota` 同义）、`/setup`、`/clear`，以及 harness 自带命令
-（`/goal`、`/plan`、`/compact` 等）。
-
-`/usage` 在当前提供商为 OpenCode 源时可用，并区分两种计费方式：
-
-- **OpenCode Go**：调用官方额度接口，显示滚动 5 小时 / 本周 / 本月用量
-  百分比、限流状态与重置时间；
-- **OpenCode Zen**：按 API 账单计费、没有固定额度，TUI 不假装查询余额，
-  只提示到 `https://opencode.ai/zen` 查看，并附本会话已记录的 token 用量。
-
-## 配置
-
-### 模型默认值（`$DSH_HOME/settings.yaml`）
-
-```yaml
-agent-default-model:
-  provider: opencode-go
-  model: deepseek-v4-pro
-  reasoningEffort: max
-agent-presets:
-  default: standard
-```
-
-`/model` 与 `/mode` 的修改会写回这里，web 端与 TUI 共用同一份设置。
-
-对 OpenCode 和其他第三方提供商，`/model` 会先调用提供商的端点
-（`GET {baseURL}/models`）获取实时模型列表；端点不可达时回退到已配置的
-模型列表。若选中的模型尚未写入提供商配置，会自动追加到
-`llm-pi-ai.providers.<id>.models`，保证 Harness 可以正常调用。
-
-首次配置向导的自定义/OpenCode 提供商步骤中，输入模型 ID 前可按
-`Ctrl+F` 直接从端点拉取模型列表，免去手动输入。
-
-### profile 用户层
-
-每个 profile 的 `cordis.patch.yml` 是用户覆盖层，可覆盖插件 patch 的任何行；
-`--patch <file>` 可临时叠加。
-
-## 验证
-
-```bash
-bash scripts/verify.sh              # 检查 profile 组合与 CLI 语法
-```
-
-或手动：
-
-```bash
-dsh --profile tui --dump-config | grep -A12 'id: ssh-tui'
-dsh --profile tui --help
-```
-
-## 卸载
-
-```bash
-bash scripts/uninstall.sh           # 默认 tui profile
-bash scripts/uninstall.sh work      # 指定 profile
-```
-
-卸载只移除 profile 中的插件依赖与 bundle 层，不会删除会话数据。
-
-## 隐私与上传安全
-
-- 所有会话、凭据、设置都保存在 `$DSH_HOME`（默认 `~/.dsh`），**不落在本仓库**；
-- `.gitignore` 已排除 `node_modules/`、`lib/`、`.env*`、`*.key`、`session*.jsonl*`、
-  `sessions/`、日志与临时文件；
-- 上传前请自查：`find . -type f | grep -Ei 'credential|\.env|\.key|session'`；
-- 插件本身不收集、不上传任何数据；会话日志仅按需读写于本机 `$DSH_HOME`。
-
-## 开发与目录结构
-
-```text
-src/index.ts        插件入口：启动选择器、会话创建/恢复/切换
-src/startup.ts      命令行参数解析（--resume / --new / --model ...）
-src/picker.ts       启动历史会话选择器
-src/session-list.ts 历史会话扫描与标签（共享给 /resume）
-src/tui.ts          终端渲染、交互、统计、标题/铃声
-cordis.patch.yml    dsh bundle patch（挂载 TUI 与 agent-presets）
-scripts/            安装 / 卸载 / 验证脚本
-```
-
-```bash
-npm install
-npm run typecheck
-npm run build
-```
-
-## 常见问题
-
-- **`dsh-ssh-tui: both stdin and stdout must be TTYs`**：必须从真实终端/SSH 会话启动。
-- **pnpm 拒绝 git 依赖的构建脚本**：git 安装的插件需要把 pnpm 打印的 key 加入
-  profile 的 `pnpm-workspace.yaml` 的 `allowBuilds`。
-- **标题栏或铃声不生效**：确认终端支持 OSC 0 与 BEL；铃声可用
-  `DSH_TUI_NO_BELL=1` 关闭。
-- **滚轮误触取消**：已加入转义序列缓冲，网络拆包也不会把 `ESC` 当取消。
-
-## License
-
-MIT，见 [LICENSE](LICENSE)。