Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added assets/ai-pair/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 8 additions & 0 deletions assets/icon-sources.json
Original file line number Diff line number Diff line change
Expand Up @@ -2582,5 +2582,13 @@
"source": "original artwork for the rfauto plugin, generated by devtests/make_rfauto_icon.py from a geometric description of an |S11| resonance dip on a VNA graticule (no third-party material); released with the plugin under GPL-3.0-only",
"mimeType": "image/png",
"sha256": "a8095016915887061ae5191c98a5396f8b9d09fd422868f6c4ffed7436351485"
},
{
"name": "ai-pair",
"icon": "ai-pair/icon.png",
"source": "original design; vector source at ui-plugins/ai-pair/icon.svg",
"matchedBy": "original-design",
"mimeType": "image/png",
"sha256": "dc62e7f44052dd35fda86845aee73cef390882c8392f9a9c3a92e83884d35cb2"
}
]
42 changes: 42 additions & 0 deletions external_plugins/ai-pair/.zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
{
"name": "ai-pair",
"version": "0.4.8",
"description": "AI Pair 评审:主对话改完代码后,一键送两个异构模型(复用 ZCode 模型管理里的渠道)并行评审,侧栏面板查看报告。",
"skills": "skills",
"author": {
"name": "JustinChia"
},
"license": "MIT",
"mcpServers": {
"ai-pair": {
"type": "stdio",
"command": "node",
"args": [
"${ZCODE_PLUGIN_ROOT}/dist/server.mjs"
],
"env": {
"ZCODE_PLUGIN_DATA": "${ZCODE_PLUGIN_DATA}",
"ZCODE_PROJECT_DIR": "${ZCODE_PROJECT_DIR}"
}
}
},
"ui": {
"surfaces": [
{
"id": "reviews",
"title": {
"zh-CN": "AI Pair 评审",
"en-US": "AI Pair Review"
},
"icon": "activity",
"server": "ai-pair",
"resourceUri": "ui://ai-pair/panel.html",
"availability": "session"
}
]
},
"description_i18n": {
"en": "Send completed work to two heterogeneous reviewers (reusing ZCode model channels) for parallel review; read reports in the side pane.",
"zh-CN": "AI Pair 评审:主对话改完代码后,一键送两个异构模型(复用 ZCode 模型管理里的渠道)并行评审,侧栏面板查看报告。"
}
}
22 changes: 22 additions & 0 deletions external_plugins/ai-pair/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
MIT License

Copyright (c) 2026 JustinChia
Copyright (c) 2026 Axton Liu (original ai-pair skill, https://github.com/axtonliu/ai-pair)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
49 changes: 49 additions & 0 deletions external_plugins/ai-pair/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# ai-pair

AI Pair 评审:主对话完成代码/内容创作后,把成果送 **两个异构模型** 并行评审,在会话侧栏面板查看分级报告。模型渠道完全复用 ZCode「管理模型」里已配置的渠道,插件里**不需要单独填 API Key**。

## 用法(对话里)

- "改完了,送 ai-pair 评审" / "让两个模型评一下刚才的改动"
- Agent 会调用 `request_review` 工具(传 diff 或文件列表),评审后台运行,侧栏「AI Pair 评审」面板自动刷新
- `get_review` 取完整报告;`list_reviews` 列历史;`list_models` 列渠道与实测连通性

## 配置(推荐:面板级联选择)

侧栏「AI Pair 评审」面板 → **⚙ 设置**:两个评审位各自 **渠道下拉 → 模型下拉 → 保存**,
渠道与模型来自 ZCode「管理模型」的已有配置,密钥自动复用、无需手填,保存立即生效。

也可在对话里让 AI 跑 `configure_reviewers` 工具(如"评审模型 1 用 Kimi 的 k3.1-pro")。

### 评审员角色定义

两个评审槽位是**固定分工**(借鉴原版 ai-pair 的具名评审员模式),角色由插件注入每次评审的提示词,不随所选渠道变化:

| 评审位 | 角色 | 代码评审重点(focus=dev) | 内容评审重点(focus=content) |
| --- | --- | --- | --- |
| 评审模型 1 | **正确性把关** | bug、安全漏洞、并发问题、性能、边界条件、错误处理 | 逻辑严密性、事实准确性、无依据的论断、内部矛盾、缺少引用 |
| 评审模型 2 | **设计与可维护性** | 架构与模块边界、设计模式、可读性与可维护性、命名、未来隐患 | 可读性、结构与行文节奏、语气与风格一致性、受众契合度、标题与开头 |

评审模型 2 建议选**不同厂商**的渠道——两个模型加两个视角,异构评审的价值才在;
结论冲突时插件不做仲裁,并列呈现交由用户裁决。

支持的渠道协议:OpenAI chat/completions 与 Anthropic messages(自动识别)。
需要新渠道时直接在 ZCode「管理模型」里添加,插件面板重开即能看到。

> 隐私说明:提交评审的 diff 与文件全文会发送到**你自己配置的模型渠道**(由所选渠道的厂商处理),
> 评审记录仅保存在本机插件数据目录;API Key 只在插件服务端内存中使用,不落盘、不下发面板。

## OpenCode Go 渠道注意

- Go 网关要求 `x-opencode-session` 会话头与自定义 User-Agent —— 插件对 `opencode.ai` 域名自动处理
- OpenCode 隐私设置默认屏蔽部分模型(如 DeepSeek 系),需在 OpenCode Settings › Privacy 开启

评审数据存放在插件持久目录(按工作区隔离)。

## 作者与致谢

- 作者:**JustinChia**
- 本插件改编自 [axtonliu/ai-pair](https://github.com/axtonliu/ai-pair)(MIT License, Copyright (c) 2026 Axton Liu),
衷心感谢原作者 Axton Liu 提出的「一个创作、两个审查」异构评审思路与原版 Claude Code Skill 的提示词设计。
- 本插件在其思路基础上重写为 ZCode UI 插件:评审由插件服务端直连模型渠道执行、
侧栏面板查看报告、评审模型复用 ZCode「管理模型」的渠道配置。协议同为 MIT。
49 changes: 49 additions & 0 deletions external_plugins/ai-pair/README_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# ai-pair

AI Pair 评审:主对话完成代码/内容创作后,把成果送 **两个异构模型** 并行评审,在会话侧栏面板查看分级报告。模型渠道完全复用 ZCode「管理模型」里已配置的渠道,插件里**不需要单独填 API Key**。

## 用法(对话里)

- "改完了,送 ai-pair 评审" / "让两个模型评一下刚才的改动"
- Agent 会调用 `request_review` 工具(传 diff 或文件列表),评审后台运行,侧栏「AI Pair 评审」面板自动刷新
- `get_review` 取完整报告;`list_reviews` 列历史;`list_models` 列渠道与实测连通性

## 配置(推荐:面板级联选择)

侧栏「AI Pair 评审」面板 → **⚙ 设置**:两个评审位各自 **渠道下拉 → 模型下拉 → 保存**,
渠道与模型来自 ZCode「管理模型」的已有配置,密钥自动复用、无需手填,保存立即生效。

也可在对话里让 AI 跑 `configure_reviewers` 工具(如"评审模型 1 用 Kimi 的 k3.1-pro")。

### 评审员角色定义

两个评审槽位是**固定分工**(借鉴原版 ai-pair 的具名评审员模式),角色由插件注入每次评审的提示词,不随所选渠道变化:

| 评审位 | 角色 | 代码评审重点(focus=dev) | 内容评审重点(focus=content) |
| --- | --- | --- | --- |
| 评审模型 1 | **正确性把关** | bug、安全漏洞、并发问题、性能、边界条件、错误处理 | 逻辑严密性、事实准确性、无依据的论断、内部矛盾、缺少引用 |
| 评审模型 2 | **设计与可维护性** | 架构与模块边界、设计模式、可读性与可维护性、命名、未来隐患 | 可读性、结构与行文节奏、语气与风格一致性、受众契合度、标题与开头 |

评审模型 2 建议选**不同厂商**的渠道——两个模型加两个视角,异构评审的价值才在;
结论冲突时插件不做仲裁,并列呈现交由用户裁决。

支持的渠道协议:OpenAI chat/completions 与 Anthropic messages(自动识别)。
需要新渠道时直接在 ZCode「管理模型」里添加,插件面板重开即能看到。

> 隐私说明:提交评审的 diff 与文件全文会发送到**你自己配置的模型渠道**(由所选渠道的厂商处理),
> 评审记录仅保存在本机插件数据目录;API Key 只在插件服务端内存中使用,不落盘、不下发面板。

## OpenCode Go 渠道注意

- Go 网关要求 `x-opencode-session` 会话头与自定义 User-Agent —— 插件对 `opencode.ai` 域名自动处理
- OpenCode 隐私设置默认屏蔽部分模型(如 DeepSeek 系),需在 OpenCode Settings › Privacy 开启

评审数据存放在插件持久目录(按工作区隔离)。

## 作者与致谢

- 作者:**JustinChia**
- 本插件改编自 [axtonliu/ai-pair](https://github.com/axtonliu/ai-pair)(MIT License, Copyright (c) 2026 Axton Liu),
衷心感谢原作者 Axton Liu 提出的「一个创作、两个审查」异构评审思路与原版 Claude Code Skill 的提示词设计。
- 本插件在其思路基础上重写为 ZCode UI 插件:评审由插件服务端直连模型渠道执行、
侧栏面板查看报告、评审模型复用 ZCode「管理模型」的渠道配置。协议同为 MIT。
74 changes: 74 additions & 0 deletions external_plugins/ai-pair/skills/ai-pair/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
name: ai-pair
description: |
AI Pair 评审工作流。主对话完成代码修改或内容创作后,把成果送给两个异构模型
(评审模型 1 / 评审模型 2,复用 ZCode 模型管理里的渠道)并行评审,
报告在「AI Pair 评审」侧栏面板展示。

Trigger: ai-pair, 送评审, 双模型评审, request_review, 打开评审面板
metadata:
version: 0.4.8
note: 本 skill 由 ai-pair UI 插件自带;评审由插件 MCP server 执行,不消耗对话上下文
---

# AI Pair 评审工作流

你(主对话 agent)负责把待评审材料提交给 ai-pair 插件,并如实转达评审结果。评审本身
由插件的 MCP server 调用用户在 ZCode 里配置的两个模型渠道完成——你**不需要也不能**
自己扮演评审员。

## 工具清单

- `request_review`:提交评审(见下)
- `get_review {id}`:取回完整报告
- `list_reviews`:列历史评审
- `delete_review {id}` 或 `{all:true}`:删除单条/清空评审记录(用户说"删掉这条评审/清空评审记录"时调用;进行中的任务不可删)
- `open_panel`:打开「AI Pair 评审」侧栏面板。用户说"打开评审面板""打开 AI Pair"时立即调用
- `list_models`:列出 ZCode 全部渠道与模型,并实测两个评审位的连通性
- `configure_reviewers {reviewer1:{channel,model}, reviewer2:{channel,model}, cross}`:
级联选择评审位的渠道+模型,立即生效。用户说"评审模型 1 用 Kimi 的 k3.1-pro"这类话时调用。
channel 填渠道名或 ID;某槽位不传表示清除该位选择。**绝不未经用户确认就自动选渠道。**

## 何时使用

- 用户说"送 ai-pair 评审"、"让两个模型看看"、"双模型评审一下"
- 用户要求质量把关:重构、安全相关改动、发布前检查、重要文章定稿前

## 流程

1. **提交评审**:调用 `request_review` 工具:
- `title`:一句话说明改了什么
- `focus`:代码改动用 `dev`,文章/文案用 `content`
- `diff`:本次改动的 diff(优先;可用 git diff 生成)
- `files`:或提供工作区内相对路径列表(服务端读取全文)
- `notes`:给评审员的背景与关注点(可选但建议提供)
- `cross`:交叉质证轮开关。用户说"要交叉质证/互相复核"时传 true,"不用质证"传 false;
不传则按面板设置里的默认值。开启后渠道 token 约翻倍,需先告知用户
- 默认立即返回任务 id,评审后台运行(通常 1-3 分钟;启用质证约 3-6 分钟)
2. **等待与取回**:
- 用户可打开侧栏「AI Pair 评审」面板实时查看
- 完成后调用 `get_review(id)` 取回完整报告,向用户总结:
两份报告的共识问题、各自独有的发现、冲突之处(如实并列,交用户裁决);
若有交叉质证轮,优先转述 [WRONG]/[MISS] 项——那是最可能有价值的发现
- 评审未完成时不要轮询刷屏;告知用户面板会自动刷新,或稍后再取
3. **后续**:用户决定是否按 CRITICAL → WARNING → SUGGESTION 的顺序修改;
修改后可再次提交评审形成新的一轮

## 配置与排障

- `list_models`:列出 ZCode 全部渠道与模型,并实测两个槽位的连通性。
为评审位选渠道/模型前先跑它,把渠道名/模型 ID 照抄给用户。
- 某个槽位评审失败时如实告知原因(常见:未选渠道、模型 ID 不在渠道里、渠道鉴权失败),
不要自己补写"评审意见"。

## 规则

- 两位评审员是固定分工(角色由插件注入提示词,不随渠道变化):
评审模型 1 · **正确性把关**(代码偏 bug/安全/边界,内容偏事实与逻辑),
评审模型 2 · **设计与可维护性**(代码偏架构/可读性,内容偏结构/风格/受众);
结论冲突时不要替用户做决定,并列呈现
- CRITICAL 项建议优先处理,但处理与否由用户决定

---

> 改编自 [axtonliu/ai-pair](https://github.com/axtonliu/ai-pair)(MIT, © 2026 Axton Liu),感谢原作者的异构评审思路与提示词设计。
Loading