opencode-diff-viewer 1.0.0 → 1.0.1

package/README.md

@@ -1,18 +1,20 @@
 # OpenCode Diff Viewer Plugin
 
+[![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 插件，使用 [lumen](https://github.com/jnsahaj/lumen) 提供美观的 TUI diff 查看功能。
 
-## 功能
+## 功能特性
 
-- `/diff` 命令查看所有修改的文件
-- `/diff <file>` 命令查看指定文件的 diff
-- LLM 可调用的 `view_diff` 工具
-- 自动安装 lumen（如果未安装）
-- 自动在新终端窗口中打开
+- ✨ **自动安装 lumen** - 插件会自动检测并安装 lumen 依赖
+- 🚀 **一键查看 diff** - 使用 `/diff` 命令快速查看代码变更
+- 🔧 **智能终端适配** - 自动检测操作系统，打开新终端窗口展示 diff
+- 🤖 **LLM 工具集成** - LLM 可自动调用 `view_diff` 工具
 
 ## 安装
 
-### 方式一：npm 安装（推荐）
+### 1. 安装 npm 包
 
 ```bash
 npm install opencode-diff-viewer
@@ -22,7 +24,9 @@ pnpm add opencode-diff-viewer
 yarn add opencode-diff-viewer
 ```
 
-然后在 `opencode.json` 中添加插件：
+### 2. 配置 opencode.json
+
+在项目的 `opencode.json` 中添加插件：
 
 ```json
 {
@@ -30,68 +34,152 @@ yarn add opencode-diff-viewer
 }
 ```
 
-### 方式二：本地开发
+### 3. 重启 OpenCode
 
-将插件复制到你的项目：
+安装完成后重启 OpenCode TUI，插件会自动加载。
 
-```bash
-# 复制插件文件
-cp -r node_modules/opencode-diff-viewer/dist .opencode/plugin/diff-viewer
-cp node_modules/opencode-diff-viewer/command-diff.md .opencode/command/diff.md
+## 使用方法
 
-# 或使用 npm link
-npm link opencode-diff-viewer
+### 通过命令
+
+在 OpenCode TUI 中直接输入：
+
+```bash
+/diff              # 查看所有修改文件的 diff
+/diff src/app.ts   # 查看指定文件的 diff
+/diff src/         # 查看目录下所有文件的 diff
 ```
 
+### 通过 LLM
+
+LLM 可以自动调用 `view_diff` 工具来展示代码变更。无需手动操作，LLM 会根据对话上下文智能判断何时需要展示 diff。
+
+## lumen 快捷键
+
+在 lumen diff 查看器中：
+
+| 快捷键 | 功能 |
+|--------|------|
+| `j` / `k` 或 `↑` / `↓` | 上/下移动 |
+| `{` / `}` | 跳转到上/下一个变更块 |
+| `Tab` | 切换侧边栏 |
+| `e` | 在编辑器中打开文件 |
+| `q` | 退出 |
+
 ## 前置条件
 
-插件会自动安装 lumen。如果自动安装失败，需要手动安装：
+### lumen 安装
+
+插件会自动尝试安装 lumen，如果自动安装失败，需要手动安装：
 
+**macOS / Linux (Homebrew)**:
 ```bash
-# macOS / Linux (Homebrew)
 brew install jnsahaj/lumen/lumen
+```
 
-# 或使用 Cargo (Rust)
+**Cargo (Rust)**:
+```bash
 cargo install lumen
 ```
 
-## 使用方法
+**Windows**:
+下载 [lumen releases](https://github.com/jnsahaj/lumen/releases) 并添加到 PATH
+
+### Git 仓库
+
+确保项目是 git 仓库，并且有修改的文件：
+```bash
+git status  # 查看修改的文件
+```
 
-### 通过 / 命令
+## 故障排除
 
-在 OpenCode TUI 中输入：
+### 1. lumen 未安装
 
 ```
-/diff          # 查看所有修改文件的 diff
-/diff src/app.ts   # 查看指定文件的 diff
+❌ lumen is not installed
 ```
 
-### 通过 LLM 工具调用
+**解决方案**: 手动安装 lumen（见上方前置条件）
 
-LLM 可以自动调用 `view_diff` 工具来展示代码变更。
+### 2. 没有修改的文件
 
-## lumen 快捷键
+```
+📝 No modified files to show diff for
+```
 
-在 lumen diff 查看器中：
+**解决方案**: 确保文件已修改并暂存：
+```bash
+git add .
+```
 
-| 快捷键 | 功能 |
-|--------|------|
-| `j/k` 或 `↑/↓` | 导航 |
-| `{` / `}` | 跳转到上/下一个 hunk |
-| `Tab` | 切换侧边栏 |
-| `e` | 在编辑器中打开文件 |
-| `q` | 退出 |
+### 3. 新终端未打开
+
+检查终端模拟器是否支持：
+- macOS: Terminal.app
+- Linux: gnome-terminal 或 xterm
+
+## 工作原理
+
+1. **检测修改文件** - 插件使用 `git diff` 获取已暂存和未暂存的修改
+2. **启动 lumen** - 在新终端窗口中运行 `lumen diff --file <files>`
+3. **自动安装** - 插件启动时检查 lumen，未安装则自动安装
+
+## 项目结构
+
+```
+opencode-diff-viewer/
+├── src/
+│   ├── index.ts           # 插件主逻辑
+│   └── command-diff.md    # /diff 命令定义
+├── dist/                  # 编译输出
+├── package.json           # npm 配置
+└── tsconfig.json          # TypeScript 配置
+```
 
-## 发布到 npm
+## 开发
+
+### 本地开发
 
 ```bash
-# 登录 npm
-npm login
+# 克隆项目
+git clone https://github.com/AruNi-01/opencode-diff-viewer.git
+cd opencode-diff-viewer
 
-# 发布包
-npm publish
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 链接本地包
+npm link
+
+# 在测试项目中
+npm link opencode-diff-viewer
+```
+
+### 发布新版本
 
-# 发布新版本
-npm version patch|minor|major
+```bash
+# 更新版本号
+npm version patch   # 1.0.0 -> 1.0.1
+npm version minor   # 1.0.0 -> 1.1.0
+npm version major   # 1.0.0 -> 2.0.0
+
+# 发布
 npm publish
 ```
+
+## 依赖
+
+- [lumen](https://github.com/jnsahaj/lumen) - TUI Diff 查看器
+- [@opencode-ai/plugin](https://www.npmjs.com/package/@opencode-ai/plugin) - OpenCode 插件 SDK
+
+## License
+
+MIT
+
+## 作者
+
+[AarynLu](https://github.com/AruNi-01)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-diff-viewer",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OpenCode plugin for viewing git diffs using lumen TUI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,8 +18,16 @@
     "lumen",
     "git"
   ],
-  "author": "",
+  "author": "AarynLu",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AruNi-01/opencode-diff-viewer"
+  },
+  "bugs": {
+    "url": "https://github.com/AruNi-01/opencode-diff-viewer/issues"
+  },
+  "homepage": "https://github.com/AruNi-01/opencode-diff-viewer#readme",
   "peerDependencies": {
     "@opencode-ai/plugin": "^1.0.0"
   },