gssh-agent 1.0.3 → 1.0.5

package/pkg/rpc/handler_test.go

@@ -0,0 +1,36 @@
+package rpc
+
+import (
+	"encoding/json"
+	"testing"
+
+	"gssh/internal/protocol"
+)
+
+func TestHandle_InvalidJSON(t *testing.T) {
+	handler := NewHandler(nil)
+
+	invalidJSON := []byte(`{invalid json`)
+
+	respBytes, err := handler.Handle(invalidJSON)
+	if err != nil {
+		t.Fatalf("Handle returned unexpected error: %v", err)
+	}
+
+	var resp protocol.Response
+	if err := json.Unmarshal(respBytes, &resp); err != nil {
+		t.Fatalf("Failed to unmarshal response: %v", err)
+	}
+
+	if resp.Error == nil {
+		t.Fatal("Expected error in response, got nil")
+	}
+
+	if resp.Error.Code != -32700 {
+		t.Errorf("Expected error code -32700, got %d", resp.Error.Code)
+	}
+
+	if resp.Error.Message != "Parse error" {
+		t.Errorf("Expected error message 'Parse error', got '%s'", resp.Error.Message)
+	}
+}

package/plan.md

@@ -0,0 +1,4 @@
+1. **Create `pkg/rpc/handler_test.go`:** I will create a test file in the `pkg/rpc` directory.
+2. **Add test for invalid JSON:** I will add a test `TestHandle_InvalidJSON` that initializes a new `Handler` and calls `Handle` with an invalid JSON byte slice. It will assert that the returned error JSON structure matches the JSON-RPC error response for parse errors (`code: -32700`).
+3. **Run pre-commit steps:** Complete pre commit steps to ensure proper testing, verifications, reviews and reflections are done.
+4. **Submit change:** Once everything works and tests pass, I will submit the change.

package/skill.md

@@ -4,13 +4,20 @@ description: "Manage SSH sessions with gssh CLI for agents"
 allowed-tools: Read, Write, Glob, Grep, Bash
 triggers:
   - gssh
-  - ssh session
-  - ssh 连接
-  - ssh 管理
-  - sftp
-  - scp 文件传输
 ---
 
+## 安装
+
+```bash
+npm install -g gssh-agent
+```
+
+## 启动
+
+```bash
+gssh-daemon
+```
+
 ## 连接认证
 
 ```bash
@@ -27,9 +34,11 @@ gssh connect -u user -h host -i ~/.ssh/id_rsa
 |------|------|
 | `connect` | 建立 SSH 连接 |
 | `exec` | 执行命令 |
-| `scp` | 文件传输 |
+| `scp` / `sync` | 文件传输与同步 |
 | `sftp` | SFTP 操作 |
 | `forward` | 端口转发 |
+| `forwards`| 列出所有端口转发 |
+| `forward-close`| 关闭端口转发 |
 | `list` | 列出 session |
 | `use` | 切换默认 session |
 
@@ -39,18 +48,29 @@ gssh connect -u user -h host -i ~/.ssh/id_rsa
 # 普通命令
 gssh exec "ls -la"
 
+# 带超时命令
+gssh exec -t 10 "ls -la"
+
 # sudo 命令
 gssh exec -S password "sudo systemctl restart nginx"
+
+# 后台运行（推荐格式）
+gssh exec "nohup python3 app.py > /dev/null 2>&1 &"
+gssh exec "python3 app.py &"
+
+推荐使用 `nohup command > /dev/null 2>&1 &` 格式，可确保命令立即返回且不阻塞。
 ```
 
 ## 文件传输
 
 ```bash
-# 上传本地 -> 远程
+# 上传本地文件/文件夹 -> 远程
 gssh scp -put local.txt /remote/path/
+gssh sync -put local_dir /remote/path/
 
-# 下载远程 -> 本地
+# 下载远程文件/文件夹 -> 本地
 gssh scp -get /remote/file.txt ./
+gssh sync -get /remote/dir ./
 
 # SFTP 目录操作
 gssh sftp -c ls -p /home/user
@@ -66,6 +86,12 @@ gssh forward -l 8080 -r 80
 
 # 远程转发: remote:9000 -> localhost:3000
 gssh forward -R -l 9000 -r 3000
+
+# 列出所有端口转发
+gssh forwards
+
+# 关闭端口转发
+gssh forward-close <forward_id>
 ```
 
 ## Session 管理