opencode-diff-viewer 1.0.8 → 1.0.9

package/README.md

@@ -12,34 +12,9 @@
 - 🔧 **tmux 集成** - 在后台 tmux 会话中运行 lumen
 - 🤖 **LLM 工具集成** - LLM 可自动调用 `view_diff` 工具
 
-## 前置条件
-
-### 自动安装
-
-插件会在启动时自动检查并安装以下依赖：
-
-1. **tmux** - 终端复用器
-2. **lumen** - TUI diff 查看器
+## 快速开始
 
-### 手动安装（如果自动安装失败）
-
-**tmux**:
-```bash
-brew install tmux
-# or
-apt install tmux
-```
-
-**lumen**:
-```bash
-brew install jnsahaj/lumen/lumen
-# or
-cargo install lumen
-```
-
-## 安装（全局配置）
-
-### 1. 安装 npm 包
+### 1. 安装插件
 
 ```bash
 # npm
@@ -52,7 +27,7 @@ pnpm add -g opencode-diff-viewer
 bun add -g opencode-diff-viewer
 ```
 
-### 2. 配置全局 opencode.json
+### 2. 配置 OpenCode
 
 创建或编辑 `~/.config/opencode/opencode.json`：
 
@@ -71,38 +46,54 @@ cat > ~/.config/opencode/opencode.json << 'EOF'
 EOF
 ```
 
-### 3. 重启 OpenCode
+### 3. 启动 OpenCode（使用启动脚本）
+
+```bash
+# 使用启动脚本自动在 tmux 中启动 OpenCode
+opencode-diff-viewer
+
+# 或手动运行
+./start-opencode.sh
+```
 
-安装完成后重启 OpenCode TUI，插件会自动加载。
+启动脚本会自动：
+- 检查并安装 tmux（如果未安装）
+- 在 tmux 会话中启动 OpenCode
+- 附加到 tmux 会话
 
 ## 使用方法
 
-### 通过命令
+### 在 OpenCode 中使用 /diff
 
-在 OpenCode TUI 中直接输入：
+在 OpenCode TUI 中输入：
 
 ```bash
 /diff              # 查看所有修改文件的 diff
 /diff src/app.ts   # 查看指定文件的 diff
 ```
 
-### 通过 LLM
+执行后，lumen 会在 tmux 会话 `opencode-diff-viewer` 中运行。
 
-LLM 可以自动调用 `view_diff` 工具来展示代码变更。无需手动操作，LLM 会根据对话上下文智能判断何时需要展示 diff。
+### 查看 lumen diff
 
-### 查看 lumen
-
-执行 `/diff` 后，lumen 会在 tmux 会话中运行。要查看 lumen：
+**新开一个终端窗口**，运行：
 
 ```bash
 tmux attach -t opencode-diff-viewer
 ```
 
-**tmux 快捷键**:
-- `Ctrl+B` 然后 `D` - 分离会话（回到 OpenCode）
-- `Ctrl+B` 然后 `?` - 查看所有快捷键
+查看完成后，按 `Ctrl+B` 然后 `D` 分离 tmux 会话，回到 OpenCode。
+
+## tmux 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl+B` 然后 `D` | 分离会话（回到终端） |
+| `Ctrl+B` 然后 `?` | 查看所有快捷键 |
+| `Ctrl+C` | 终止当前会话 |
+
+## lumen 快捷键
 
-**lumen 快捷键**:
 | 快捷键 | 功能 |
 |--------|------|
 | `j` / `k` 或 `↑` / `↓` | 上/下移动 |
@@ -111,53 +102,71 @@ tmux attach -t opencode-diff-viewer
 | `e` | 在编辑器中打开文件 |
 | `q` | 退出 |
 
-## 故障排除
+## 前置条件
 
-### 1. tmux 未安装
+### tmux
 
-```
-❌ tmux is not installed
+启动脚本会自动安装 tmux。如果失败，手动安装：
+
+```bash
+brew install tmux
+# or
+apt install tmux
 ```
 
-**解决方案**: 手动安装 tmux（见上方手动安装）
+### lumen
 
-### 2. lumen 未安装
+插件会自动安装 lumen。如果失败，手动安装：
 
-```
-❌ lumen is not installed
+```bash
+brew install jnsahaj/lumen/lumen
+# or
+cargo install lumen
 ```
 
-**解决方案**: 手动安装 lumen（见上方手动安装）
+## 故障排除
 
-### 3. 没有修改的文件
+### 1. 没有修改的文件
 
 ```
 📝 No modified files
 ```
 
 **解决方案**: 确保文件已修改并暂存：
+
 ```bash
 git add .
 ```
 
-### 4. 插件未加载
+### 2. 插件未加载
+
+检查配置：
 
-检查全局配置文件是否正确：
 ```bash
 cat ~/.config/opencode/opencode.json
 ```
 
+### 3. tmux 会话丢失
+
+重新运行启动脚本：
+
+```bash
+opencode-diff-viewer
+```
+
 ## 工作原理
 
-1. **检测依赖** - 插件启动时检查 tmux 和 lumen
-2. **自动安装** - 如果未安装，自动通过 brew 或 cargo 安装
-3. **创建 tmux 会话** - 执行 `/diff` 时创建后台 tmux 会话
-4. **运行 lumen** - 在 tmux 会话中运行 lumen diff
+1. **启动脚本** - 用 tmux new-session 启动 OpenCode
+2. **插件加载** - 在 OpenCode 启动时自动加载
+3. **自动安装依赖** - 检查并安装 tmux 和 lumen
+4. **执行 /diff** - 创建新的 tmux 会话 "opencode-diff-viewer"
+5. **运行 lumen** - 在 tmux 会话中显示 diff
 
 ## 项目结构
 
 ```
 opencode-diff-viewer/
+├── start-opencode.sh      # 启动脚本
 ├── src/
 │   ├── index.ts           # 插件主逻辑
 │   └── command-diff.md    # /diff 命令定义

package/package.json

@@ -1,21 +1,24 @@
 {
   "name": "opencode-diff-viewer",
-  "version": "1.0.8",
-  "description": "OpenCode plugin for viewing git diffs using lumen TUI",
+  "version": "1.0.9",
+  "description": "OpenCode plugin for viewing git diffs using lumen TUI with tmux",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist/",
-    "command-diff.md"
+    "command-diff.md",
+    "start-opencode.sh"
   ],
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "start": "./start-opencode.sh"
   },
   "keywords": [
     "opencode",
     "opencode-plugin",
     "diff",
     "lumen",
+    "tmux",
     "git"
   ],
   "author": "AarynLu",

package/start-opencode.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+# OpenCode Diff Viewer - 启动脚本
+# 自动在 tmux 中启动 OpenCode
+
+set -e
+
+SESSION_NAME="opencode"
+
+# 检查 tmux 是否安装
+if ! command -v tmux &> /dev/null; then
+    echo "❌ tmux 未安装，正在安装..."
+    if command -v brew &> /dev/null; then
+        brew install tmux
+    else
+        echo "❌ 请先安装 tmux: brew install tmux"
+        exit 1
+    fi
+fi
+
+# 检查 OpenCode 是否安装
+if ! command -v opencode &> /dev/null; then
+    echo "❌ OpenCode 未安装"
+    exit 1
+fi
+
+# 检查是否有正在运行的 OpenCode 会话
+if tmux has-session -t "$SESSION_NAME" 2>/dev/null; then
+    echo "📎 已存在 OpenCode 会话，正在附加..."
+    tmux attach-session -t "$SESSION_NAME"
+else
+    echo "🚀 在 tmux 中启动 OpenCode..."
+    tmux new-session -d -s "$SESSION_NAME" "opencode"
+    echo "✅ OpenCode 已在 tmux 会话 '${SESSION_NAME}' 中启动"
+    echo ""
+    echo "下一步:"
+    echo "  1. 运行: tmux attach -t ${SESSION_NAME}"
+    echo "  2. 在 OpenCode 中使用 /diff 命令查看代码变更"
+    echo "  3. lumen 会在后台 tmux 会话 'opencode-diff-viewer' 中运行"
+    echo ""
+    echo "tmux 快捷键:"
+    echo "  Ctrl+B 然后 D - 分离会话"
+    echo "  Ctrl+B 然后 ? - 查看帮助"
+    echo ""
+    tmux attach-session -t "$SESSION_NAME"
+fi