opencode-diff-viewer 1.0.6 → 1.0.7

package/README.md

@@ -3,33 +3,38 @@
 [![npm version](https://img.shields.io/npm/v/opencode-diff-viewer.svg)](https://www.npmjs.com/package/opencode-diff-viewer)
 [![npm downloads](https://img.shields.io/npm/dm/opencode-diff-viewer.svg)](https://www.npmjs.com/package/opencode-diff-viewer)
 
-一个 OpenCode 插件，使用 [delta](https://github.com/dandavison/delta) 提供语法高亮的 git diff 查看功能。
+一个 OpenCode 插件，使用 [lumen](https://github.com/jnsahaj/lumen) 提供美观的 TUI diff 查看功能。
 
 ## 功能特性
 
-- ✨ **自动安装 delta** - 插件会自动检测并安装 delta 依赖
+- ✨ **自动安装 lumen** - 插件会自动检测并安装 lumen 依赖
 - 🚀 **一键查看 diff** - 使用 `/diff` 命令快速查看代码变更
-- 🎨 **语法高亮** - 支持多种编程语言的语法高亮
+- 🔧 **智能终端适配** - 自动检测操作系统，打开新终端窗口展示 diff
 - 🤖 **LLM 工具集成** - LLM 可自动调用 `view_diff` 工具
 
 ## 前置条件
 
-### 1. 安装 delta
+### 1. 安装 lumen
 
-插件会自动尝试安装 delta，如果自动安装失败，需要手动安装：
+插件会自动尝试安装 lumen，如果自动安装失败，需要手动安装：
 
 **macOS / Linux (Homebrew)**:
 ```bash
-brew install dandavison/delta/delta
+brew install jnsahaj/lumen/lumen
+```
+
+**Bun**:
+```bash
+bun install jnsahaj/lumen/lumen
 ```
 
 **Cargo (Rust)**:
 ```bash
-cargo install delta
+cargo install lumen
 ```
 
 **Windows**:
-下载 [delta releases](https://github.com/dandavison/delta/releases) 并添加到 PATH
+下载 [lumen releases](https://github.com/jnsahaj/lumen/releases) 并添加到 PATH
 
 ### 2. Git 仓库
 
@@ -63,8 +68,8 @@ cat > ~/.config/opencode/opencode.json << 'EOF'
 {
   "command": {
     "diff": {
-      "template": "View git diff with syntax highlighting.",
-      "description": "Show git diff with syntax highlighting"
+      "template": "View git diff using lumen TUI.",
+      "description": "View diff of modified files using lumen TUI"
     }
   },
   "plugin": ["opencode-diff-viewer"]
@@ -91,25 +96,27 @@ EOF
 
 LLM 可以自动调用 `view_diff` 工具来展示代码变更。无需手动操作，LLM 会根据对话上下文智能判断何时需要展示 diff。
 
-## delta 快捷键
+## lumen 快捷键
 
-在 diff 输出中：
+在 lumen diff 查看器中：
 
 | 快捷键 | 功能 |
 |--------|------|
-| `n` / `p` | 下/上一个变更 |
-| `N` / `P` | 下/上一个文件 |
-| `q` | 退出（如果启用 pager） |
+| `j` / `k` 或 `↑` / `↓` | 上/下移动 |
+| `{` / `}` | 跳转到上/下一个变更块 |
+| `Tab` | 切换侧边栏 |
+| `e` | 在编辑器中打开文件 |
+| `q` | 退出 |
 
 ## 故障排除
 
-### 1. delta 未安装
+### 1. lumen 未安装
 
 ```
-❌ delta is not installed
+❌ lumen is not installed
 ```
 
-**解决方案**: 手动安装 delta（见上方前置条件）
+**解决方案**: 手动安装 lumen（见上方前置条件）
 
 ### 2. 没有修改的文件
 
@@ -122,7 +129,13 @@ LLM 可以自动调用 `view_diff` 工具来展示代码变更。无需手动操
 git add .
 ```
 
-### 3. 插件未加载
+### 3. 新终端未打开
+
+检查终端模拟器是否支持：
+- macOS: Terminal.app
+- Linux: gnome-terminal 或 xterm
+
+### 4. 插件未加载
 
 检查全局配置文件是否正确：
 ```bash
@@ -134,8 +147,8 @@ cat ~/.config/opencode/opencode.json
 {
   "command": {
     "diff": {
-      "template": "View git diff with syntax highlighting.",
-      "description": "Show git diff with syntax highlighting"
+      "template": "View git diff using lumen TUI.",
+      "description": "View diff of modified files using lumen TUI"
     }
   },
   "plugin": ["opencode-diff-viewer"]
@@ -145,8 +158,8 @@ cat ~/.config/opencode/opencode.json
 ## 工作原理
 
 1. **检测修改文件** - 插件使用 `git diff` 获取已暂存和未暂存的修改
-2. **格式化输出** - 通过 `delta` 管道输出，带语法高亮
-3. **自动安装** - 插件启动时检查 delta，未安装则自动安装
+2. **启动 lumen** - 在新终端窗口中运行 `lumen diff --file <files>`
+3. **自动安装** - 插件启动时检查 lumen，未安装则自动安装
 
 ## 项目结构
 
@@ -200,7 +213,7 @@ npm publish
 
 ## 依赖
 
-- [delta](https://github.com/dandavison/delta) - 语法高亮的 git diff 查看器
+- [lumen](https://github.com/jnsahaj/lumen) - TUI Diff 查看器
 - [@opencode-ai/plugin](https://www.npmjs.com/package/@opencode-ai/plugin) - OpenCode 插件 SDK
 
 ## License

package/dist/index.js

@@ -1,8 +1,8 @@
 import { tool } from "@opencode-ai/plugin";
 export const DiffViewerPlugin = async ({ project, client, $, directory, worktree }) => {
-    const isDeltaInstalled = async () => {
+    const isLumenInstalled = async () => {
         try {
-            await $ `which delta`;
+            await $ `which lumen`;
             return true;
         }
         catch {
@@ -27,10 +27,10 @@ export const DiffViewerPlugin = async ({ project, client, $, directory, worktree
             return false;
         }
     };
-    const installDelta = async () => {
+    const installLumen = async () => {
         if (await isBrewInstalled()) {
             try {
-                await $ `brew install delta`;
+                await $ `brew install jnsahaj/lumen/lumen`;
                 return { success: true, method: "brew" };
             }
             catch (e) {
@@ -39,7 +39,7 @@ export const DiffViewerPlugin = async ({ project, client, $, directory, worktree
         }
         if (await isCargoInstalled()) {
             try {
-                await $ `cargo install delta`;
+                await $ `cargo install lumen`;
                 return { success: true, method: "cargo" };
             }
             catch (e) {
@@ -48,20 +48,20 @@ export const DiffViewerPlugin = async ({ project, client, $, directory, worktree
         }
         return {
             success: false,
-            error: "Neither brew nor cargo available. Please install delta manually:\n  brew install dandavison/delta/delta\n  # or\n  cargo install delta"
+            error: "Neither brew nor cargo available. Please install lumen manually:\n  brew install jnsahaj/lumen/lumen\n  # or\n  cargo install lumen"
         };
     };
-    const ensureDeltaInstalled = async () => {
-        if (await isDeltaInstalled()) {
+    const ensureLumenInstalled = async () => {
+        if (await isLumenInstalled()) {
             return { installed: true };
         }
-        const result = await installDelta();
+        const result = await installLumen();
         if (result.success) {
-            return { installed: true, message: `✅ delta installed via ${result.method}` };
+            return { installed: true, message: `✅ lumen installed via ${result.method}` };
         }
         return { installed: false, message: `❌ ${result.error}` };
     };
-    await ensureDeltaInstalled();
+    await ensureLumenInstalled();
     const getModifiedFiles = async () => {
         try {
             const unstaged = await $ `git diff --name-only`.text();
@@ -76,14 +76,14 @@ export const DiffViewerPlugin = async ({ project, client, $, directory, worktree
             return [];
         }
     };
-    const showDiff = async (files) => {
-        if (!await isDeltaInstalled()) {
-            return `❌ delta is not installed.
+    const launchDiffViewer = async (files) => {
+        if (!await isLumenInstalled()) {
+            return `❌ lumen is not installed.
 
 To install:
-  brew install dandavison/delta/delta
+  brew install jnsahaj/lumen/lumen
   # or
-  cargo install delta
+  cargo install lumen
 
 Then restart OpenCode.`;
         }
@@ -91,38 +91,49 @@ Then restart OpenCode.`;
         if (modifiedFiles.length === 0) {
             return "📝 No modified files.\n\nRun \`git add .\` to stage changes first.";
         }
+        const fileList = modifiedFiles.map(f => `  • ${f}`).join('\n');
+        const fileArgs = modifiedFiles.map(f => `"${f}"`).join(' ');
+        const cmd = `cd "${directory}" && lumen diff ${fileArgs}`;
+        const platform = process.platform;
+        // Try to launch in new terminal
+        let launched = false;
+        let errorMsg = "";
         try {
-            // Get diff output with delta
-            let diffOutput = "";
-            // Show staged diff
-            const stagedDiff = await $ `cd "${directory}" && git diff --staged`.text();
-            if (stagedDiff.trim()) {
-                diffOutput += "=== STAGED CHANGES ===\n\n";
-                diffOutput += await $ `cd "${directory}" && git diff --staged | delta --pager=never`.text();
+            if (platform === 'darwin') {
+                await $ `osascript -e 'tell application "Terminal" to do script "${cmd}; exit"'`;
+                launched = true;
             }
-            // Show unstaged diff
-            const unstagedDiff = await $ `cd "${directory}" && git diff`.text();
-            if (unstagedDiff.trim()) {
-                if (diffOutput)
-                    diffOutput += "\n=== UNSTAGED CHANGES ===\n\n";
-                diffOutput += await $ `cd "${directory}" && git diff | delta --pager=never`.text();
+            else if (platform === 'linux') {
+                try {
+                    await $ `which gnome-terminal && gnome-terminal -- bash -c "${cmd}; read -p 'Press Enter to close...'" `;
+                    launched = true;
+                }
+                catch {
+                    try {
+                        await $ `which xterm && xterm -e "bash -c '${cmd}; read -p Press Enter to close...'" `;
+                        launched = true;
+                    }
+                    catch (e) {
+                        errorMsg = "No terminal emulator found (gnome-terminal/xterm)";
+                    }
+                }
             }
-            if (!diffOutput.trim()) {
-                return "📝 No changes to show.";
-            }
-            const fileList = modifiedFiles.map(f => `  • ${f}`).join('\n');
-            return `✅ Modified files (${modifiedFiles.length}):\n${fileList}\n\n${diffOutput}`;
         }
         catch (e) {
-            return `❌ Error showing diff: ${e.message || e}`;
+            errorMsg = e.message || "Unknown error";
+        }
+        if (launched) {
+            return `✅ Opened lumen diff viewer:\n${fileList}\n\nKeybindings:\n  j/k: Navigate  {/}: Jump hunks  tab: Sidebar  e: Edit  q: Quit`;
         }
+        // If we couldn't launch, show manual instructions
+        return `📺 Could not open terminal automatically.\n\nTo view diffs in lumen:\n1. Open a new terminal\n2. Run:\n   ${cmd}\n\nModified files:\n${fileList}`;
     };
     return {
         "tui.command.execute": async (input, output) => {
             if (input.command === "diff") {
                 const files = input.args?.trim() ? [input.args.trim()] : undefined;
                 output.handled = true;
-                output.result = await showDiff(files);
+                output.result = await launchDiffViewer(files);
             }
         },
         "file.edited": async ({ event }) => {
@@ -130,12 +141,12 @@ Then restart OpenCode.`;
         },
         tool: {
             view_diff: tool({
-                description: "Show git diff with syntax highlighting using delta.",
+                description: "Open the lumen diff viewer to show git diff for modified files.",
                 args: {
                     file: tool.schema.string().optional().describe("Optional: specific file path"),
                 },
                 async execute(args, ctx) {
-                    return await showDiff(args.file ? [args.file] : undefined);
+                    return await launchDiffViewer(args.file ? [args.file] : undefined);
                 },
             }),
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-diff-viewer",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "OpenCode plugin for viewing git diffs using lumen TUI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",