review-mark 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +3 -128
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -6,82 +6,25 @@ A powerful CLI tool for AI-powered code review using Git diffs.
6
6
 
7
7
  `review-mark` 旨在提供一个自动化 AI 代码审查解决方案。用户可以在自己的项目中初始化该工具后,通过简单的 CLI 命令自动获取 `git diff`,并将其发送给 AI 进行代码审查,从而帮助开发者发现潜在的 bug、逻辑问题、性能问题和代码风格问题,并获得优化建议。
8
8
 
9
- ## 特性
10
-
11
- - **TypeScript 支持**: 整个项目使用 TypeScript 编写,提供强大的类型安全和开发体验。
12
- - **ESM + CommonJS**: 支持现代 Node.js 环境下的 ESM 和 CommonJS 模块系统。
13
- - **CLI 工具**: 基于 `commander` 构建,提供友好的命令行接口。
14
- - **自动化 Git Diff**: 自动检测并获取 Git 仓库中的代码变更(包括暂存区和工作区)。
15
- - **AI 代码审查**: 将 Git diff 发送给 Cursor CLI 进行 AI 驱动的代码审查。
16
- - **Cursor CLI 自动检测与安装**: 自动检测 `agent` 命令是否存在,如果不存在则提示并提供安装指引。
17
- - **易于集成**: 通过简单的 `init` 方法即可在用户项目中配置 `review` 脚本。
18
- - **可发布到 npm**: 完整的项目结构和打包配置,方便发布到 npm。
19
-
20
- ## 项目结构
21
-
22
- ```
23
- review-mark
24
-
25
- ├─ src
26
- │ ├─ core
27
- │ │ ├─ BeLinkReview.ts
28
- │ │ ├─ git.ts
29
- │ │ └─ prompt.ts
30
- │ │
31
- │ ├─ cli
32
- │ │ └─ review.ts
33
- │ │
34
- │ ├─ utils
35
- │ │ └─ checkCli.ts
36
- │ │
37
- │ └─ index.ts
38
-
39
- ├─ package.json
40
- ├─ tsconfig.json
41
- ├─ tsup.config.ts
42
- └─ README.md
43
- ```
44
-
45
- ## 技术栈
46
-
47
- - **语言**: TypeScript
48
- - **运行时**: Node.js 18+
49
- - **CLI 框架**: [commander](https://www.npmjs.com/package/commander)
50
- - **打包工具**: [tsup](https://www.npmjs.com/package/tsup)
51
- - **AI 引擎**: [Cursor CLI](https://cursor.com/cn/docs/cli/headless)
52
-
53
9
  ## 安装
54
10
 
55
11
  首先,在你的项目根目录安装 `review-mark` 作为开发依赖:
56
12
 
57
13
  ```bash
58
14
  pnpm add -D review-mark
15
+ yarn add --dev review-mark
16
+ npm install --save-dev review-mark
59
17
  ```
60
18
 
61
19
  ## 使用
62
20
 
63
21
  ### 1. 初始化
64
22
 
65
- 在你的项目入口文件(例如 `src/main.ts` 或 `app.ts`)中,调用 `BeLinkReview.init()` 方法进行初始化。你需要提供一个 `apiKey`,这将用于 Cursor CLI 的认证。
66
-
67
- ```typescript
68
- // src/main.ts (或你的项目入口文件)
69
- import { BeLinkReview } from "review-mark";
70
-
71
- BeLinkReview.init({
72
- apiKey: process.env.CURSOR_API_KEY || "YOUR_CURSOR_API_KEY", // 建议从环境变量获取
73
- });
74
-
75
- // 你可以在这里继续你的应用逻辑
76
- ```
77
-
78
- `BeLinkReview.init()` 会自动检测并向你的 `package.json` 文件中添加一个 `review-mark` 脚本:
79
-
80
23
  ```json
81
24
  // package.json
82
25
  {
83
26
  "scripts": {
84
- "review-mark": "review-mark"
27
+ "review-mark": "CURSOR_API_KEY=your-api-key review-mark"
85
28
  }
86
29
  }
87
30
  ```
@@ -119,23 +62,6 @@ CLI 将会执行以下步骤:
119
62
  [review-mark] No code changes detected
120
63
  ```
121
64
 
122
- ## 配置
123
-
124
- ### 基础配置
125
-
126
- `BeLinkReview.init()` 接受一个配置对象:
127
-
128
- ```typescript
129
- interface BeLinkReviewOptions {
130
- apiKey?: string; // 你的 Cursor API Key
131
- agentPath?: string; // Cursor CLI agent 可执行文件路径
132
- ignore?: string[]; // 需要忽略的文件模式
133
- feishu?: FeiShuConfig; // 飞书机器人配置
134
- }
135
- ```
136
-
137
- 建议将 `apiKey` 作为环境变量 `CURSOR_API_KEY` 进行管理,以避免将其硬编码到代码中。
138
-
139
65
  ### 飞书机器人集成
140
66
 
141
67
  `review-mark` 已**完全内置**飞书机器人功能,所有飞书配置已写死在代码中,**无需任何配置即可使用**!
@@ -173,29 +99,6 @@ FEISHU_ENABLED=false pnpm run review
173
99
  pnpm run review --no-feishu
174
100
  ```
175
101
 
176
- **方式三:代码配置**
177
-
178
- ```typescript
179
- BeLinkReview.init({
180
- apiKey: process.env.CURSOR_API_KEY,
181
- enableFeishu: false,
182
- });
183
- ```
184
-
185
- #### 3. 修改内置配置
186
-
187
- 如果需要修改飞书配置(如更换群聊、修改消息格式等),可以直接编辑 `src/constants.ts` 文件:
188
-
189
- ```typescript
190
- // src/constants.ts
191
- export const appId = "cli_a93822da7238dbb5";
192
- export const appSecret = "ZQdcpLUHFb4gFa8cGfrlJfVfSSyGtyzF";
193
- export const receiveId = "oc_482b6a04f95f4206c4fa9bc61829fd17"; // 修改为你的群聊 ID
194
- export const receiveIdType = "chat_id";
195
- export const messageType = "interactive"; // text | post | interactive
196
- export const messageTitle = "🔍 Code Review 结果";
197
- ```
198
-
199
102
  #### 4. 常见问题
200
103
 
201
104
  **Q: 飞书通知会发送到哪里?**
@@ -214,34 +117,6 @@ A: 支持三种格式:
214
117
  **Q: 如何完全禁用飞书功能?**
215
118
  A: 使用 `--no-feishu` 参数或设置 `FEISHU_ENABLED=false` 环境变量。
216
119
 
217
- ## 开发
218
-
219
- ### 构建项目
220
-
221
- ```bash
222
- cd review-mark
223
- pnpm install
224
- pnpm run build
225
- ```
226
-
227
- 这将使用 `tsup` 将 TypeScript 代码编译为 `dist/index.js` (ESM) 和 `dist/index.cjs` (CommonJS)。
228
-
229
- ### 运行 CLI (开发模式)
230
-
231
- ```bash
232
- pnpm run start
233
- ```
234
-
235
- 这将直接运行 `dist/cli/review.js`。
236
-
237
120
  ## 贡献
238
121
 
239
122
  欢迎提交 Issue 或 Pull Request。
240
-
241
- ## 许可证
242
-
243
- ISC License
244
-
245
- ---
246
-
247
- **Manus AI** 生成
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "review-mark",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "description": "A CLI tool for AI-powered code review using git diff.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",