SkillAgentSearch skills...

zcode-jetbrains-plugin

ZCode(Z.ai/GLM)AI 编程助手 JetBrains 插件:多标签对话、流式输出、模型与权限切换、任务/子代理可视化,AI 可经 browser-use 驱动内嵌 JCEF 浏览器 | ZCode (Z.ai/GLM) AI coding assistant for JetBrains IDEs: multi-tab chat, streaming output, model & permission switching, task/subagent visibility, and an embedded JCEF browser driven by the AI via brow…

Install / Use

npx skills add csuftt/zcode-jetbrains-plugin

Installs into whichever agent you are using.

About this skill
📦

Other

Other agent config

Quality Score

83/100

Supported Platforms

JetBrains

Our assessment of zcode-jetbrains-plugin

zcode-jetbrains-plugin scores 83/100 on our quality scale, 2996th of 4,700 Development & Engineering skills we index.

Its Other is 8.3 KB long, well organised into 15 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

It has 29 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
6/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so zcode-jetbrains-plugin is actively maintained.
  • Our last check on 2026-11-13 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

zcode-jetbrains-plugin compared with similar skills

All 4 of these similar skills score higher than zcode-jetbrains-plugin; compare them before choosing.

SkillScoreStarsUpdatedFormat
zcode-jetbrains-plugin (this skill)by csuftt8329todayOther
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k9d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install zcode-jetbrains-plugin?
Run npx skills add csuftt/zcode-jetbrains-plugin. The install tabs above show the steps for each supported agent.
Which AI agents does zcode-jetbrains-plugin work with?
It is written for JetBrains, as a Other file. Other agents that read the same format can often use it too.
Is zcode-jetbrains-plugin safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is zcode-jetbrains-plugin still maintained?
The repository was last updated today, so zcode-jetbrains-plugin is actively maintained.
<div align="center">

ZCode JetBrains 插件

<img src="logo/zcgui-window-soft.svg" width="120" height="120" alt="ZCode GUI" />

简体中文 · English

GitHub Stars GitHub Forks GitHub Issues License

</div>

把 ZCode 编码助手带进 JetBrains IDE:不切终端、不离开编辑器,会话、对话、模型与任务管理都在一个工具窗口里完成,AI 的 browser-use 还能直接驱动插件内嵌浏览器干活。

🙏 特别感谢开源项目 CC GUI(jetbrains-cc-gui)(MIT)—— 本项目作者是 CC GUI + Claude Code 工作流的长期用户,UI 设计深度参考了它:整体布局、状态面板、输入区交互、主题体系,文件类型图标亦提取自该项目。感谢作者 zhukunpenglinyutong 的开源工作。

社区第三方插件,与 ZCode / Z.ai 官方无关。使用前需本机安装 ZCode CLI 并完成登录。

这是一个个人业余项目,我会尽力维护,但无法保证实时响应。欢迎提交 PR(Pull Request)共同改进。

为什么做这个项目

我一直用 JetBrains 全家桶(IDEA + PyCharm)写代码,也早已习惯 CC GUI 插件 + Claude Code 的组合——在 IDE 侧栏里管理 AI 会话、看流式输出、追工具调用,不用切终端,工作流非常顺手。

后来两件事撞到了一起:Claude Code 被曝出在用户不知情的情况下收集数据的安全问题,公司出于数据安全考虑禁用了它;而替代品 ZCode 虽然好用,却一直没有 JetBrains 插件。JetBrains 的习惯改不掉,ZCode 也舍不得放弃,于是干脆自己动手——把熟悉的 CC GUI 式体验,搬到 ZCode 上。

其实在 IDE 里用 CLI 型 AI 工具的别扭是共通的,无论哪家的 CLI:

  • 切终端丢上下文:ALT+F12 切到终端敲命令,AI 在干活,你却在滚动日志里翻它到底做了什么
  • 会话管理割裂:想翻历史会话、并行推进几个任务,只能去翻 CLI 的本地存储
  • 运行时控制缺位:切模型、调思考深度、看上下文余量和额度,每次都要记命令行参数

这个项目的目标只有一个:让你在写代码的地方,就能用上 ZCode 的核心能力。打开工具窗口,多标签各管一个任务,流式对话实时呈现,子代理在干什么、任务清单进展到哪、改了哪些文件,一目了然。

功能一览

对话 — 流式输出(思考过程 / 正文 / 工具调用实时渲染)、Markdown / Mermaid / 代码高亮、思考耗时统计、消息排队(生成中回车自动排队,排队卡片可立即发送 / 删除 / 引导插队——不打断生成,AI 在回合中途收到指令调整方向,被引导消息带 ⚡ 徽标)、最后一轮用户消息可编辑重发(修改后自动回退该轮重新生成)、会话内定时发送(预设时间 + 提示词到点自动执行,支持指定模型 / 新会话执行,任务列表跨会话管理)、Ctrl+F 会话内搜索(大小写 / 整词 / 正则)、消息锚点导航(用户消息圆点定位 + hover 预览)

多任务 — 多标签页并行会话(每标签独立上下文互不串扰)、重启 IDE 自动恢复、会话列表 / 重命名(支持 AI 根据最近对话重新起标题)/ 搜索 / 批量多选删除、不常用会话归档收起(支持自动归档)、任意历史回复一键分叉新会话(任务执行中也可)

过程可视 — 任务清单(TodoWrite)实时进度、子代理(Agent)面板与执行过程 / 最终报告弹窗、文件改动统计(点击在编辑器打开、行内 diff 前后对比)、AskUserQuestion 交互弹窗(底部停靠可最小化、默认一直等待回答、回合结束可回看当时的问答)、计划模式(ExitPlanMode)审批弹窗

目标模式 — /goal 设定长目标后自动多轮推进:每轮工作结束服务端独立校验一次(时间线分隔卡显示通过与否与下一步行动),未通过自动续跑直至目标达成;右上角目标卡实时显示轮次 / 用时 / 校验中状态,支持暂停 / 恢复 / 换目标 / 二次确认清除,目标与轮次进度跨重启恢复

内嵌浏览器 — Header 一键在聊天区右侧展开浏览器分栏:多 tab(全局共享、跨会话沿用)、后退 / 前进 / 刷新 / 地址栏 / 自由尺寸(DevTools 设备工具栏形态的虚拟屏)/ DevTools / 外部打开,浏览器控制台(CDP)支持清理站点数据与概览查看;插件作为宿主实现 browser-use 反向协议,AI 无需任何配置即可驱动这方浏览器导航、截图、执行 JS、跑 playwright 定位器与 CUA 鼠标键盘操作

运行时控制 — 模型下拉切换(内置渠道跟随 ZCode 客户端当前生效渠道,下拉内可手动刷新)、权限模式(build / edit / plan / yolo)与思考级别(随模型动态)调整,待命态(未建会话)可预选、建会话即生效;上下文容量圆环(含用量构成与缓存命中)、5 小时 / 每周额度查询

设置中心 — 七页签:基础(主题 / 字体 / 语言 / 自定义配色 + 环境路径)、模型(内置渠道以 ZCode 客户端配置为准、只展示当前生效渠道并标注命中方式(客户端选中 / 兜底生效),内置渠道支持自定义 API Key——团队套餐从 bigmodel 开放平台拿项目 key 填入即走团队额度,卡片显示当前实际计费的 key(默认脱敏、可看全部)与来源,未配置时给出计费提醒;第三方供应商可启停;路径跟随数据目录迁移,新增 / 删除引导前往 Zcode 配置并可一键打开配置文件)、用量(应用用量:本地会话统计,覆盖第三方模型,7 天 / 30 天 / 全部区间;GLM 套餐用量:额度卡片 + 模型 / 工具用量曲线与明细表,标注查询凭证来源渠道与所用 key(脱敏))、记忆(AGENTS.md 指令记忆 + 自动记忆,缺失可创建)、技能(全局 / 项目 / 插件三来源扫描,行内启用禁用)、MCP(服务器清单 / 工具列表 / 连接日志)、其他(输入历史补全开关与历史记录管理)

环境检测 — 启动自检 Node.js(≥18)/ ZCode CLI / 登录凭证三件套,异常时顶栏提醒条逐项给出修复入口与重新检测(凭证缺失不阻断启动,仅提示补配);路径可手动配置,留空自动探测

IDE 集成 — 项目视图 / 编辑器标签右键发送文件、编辑器右键发送选中代码到输入框(Ctrl+Alt+K)、复制选区引用(路径 + 行号);文件、记忆、技能、MCP 配置均可一键在编辑器打开

输入增强 — @ 引用文件(chip + 补全,粘贴绝对路径或从系统拖入文件自动转 chip)、/ 调用技能、长文本粘贴折叠、输入历史回溯与前缀幽灵补全(Tab 采纳)

多语言 — 简体中文 / English / 日本語 / 한국어 / 繁體中文,跟随 IDE 界面语言自动切换

界面预览

内嵌浏览器 · browser-use 宿主(复刻 ZCode 客户端的亮点能力)

内嵌浏览器:聊天区右侧分栏,AI 的 browser-use 工具直接驱动这方浏览器

Header 地球按钮在聊天区右侧展开浏览器分栏(上图):工具条带后退 / 前进 / 刷新 / 地址栏 / 自由尺寸 / DevTools / 外部打开,多 tab 全局共享、跨会话沿用,宽度可拖拽调整、收起后页面保留。

它不只是一个内置浏览器——插件实现了 ZCode app-server 的 browser-use 宿主协议(interaction/browserList / browserExecute 反向请求),AI 调用 browser-use 工具时零配置落到这方 JCEF 浏览器执行:

  • 导航与采集:newTab / navigate / screenshot / evaluate,截图直接回传模型
  • playwright 定位器透传:getByRole / getByText / label / testid / and / or / nth / css 链等选择器引擎,ARIA 树 DOM 快照供 AI 读取
  • CUA 鼠标键盘:坐标点击 / 输入 / 拖拽 / 滚动 / 组合按键,JS 对话框自动挂起处理
  • tab 生命周期:markDeliverable / markHandoff / finalize 标记与回读,tab.close 真关闭
  • 自由尺寸:DevTools 设备工具栏形态——虚拟屏居中信箱、缩放档、尺寸持久化
  • playwright 能力不可用时,AI 可用 title / get_visible_dom / screenshot 组合优雅降级,链路始终可用

上图即 AI 在内嵌浏览器中打开 webview 调试页的实际场景——截图、DOM 读取、GUI 验收全程由 AI 自驱完成。

对话与过程可视(以下截图取自 webview 独立开发模式,mock 演示数据,界面与 IDE 内完全一致)

| 流式生成中:思考块 / 子代理卡 / 停止按钮 / 模式自动切换 | 完整会话:批量工具组卡 / 任务清单 / 子代理与后台通知卡 / Mermaid | | :---: | :---: | | 流式生成中 | 完整会话 | | 子代理执行过程弹窗:任务指令 / 工具调用 / 总结 | 子代理最终报告弹窗:Markdown 全文阅读,可与过程弹窗互切 | | 子代理执行过程 | 子代理最终报告 | | 计划模式审批(ExitPlanMode):计划全文 Markdown + 批准 / 拒绝反馈,批准后退出规划模式开始执行 | | | 计划模式审批 | |

目标模式(/goal 自动多轮推进)

| 多轮推进中:每轮校验分隔卡(未通过 → 下一步行动)+ 目标卡轮次 / 用时 / 校验中 | 全部轮次完成:最终校验通过,目标卡转完成态 | | :---: | :---: | | 目标模式运行中 | 目标模式完成 |

输入增强与多任务

| @ 引用文件补全 | / 技能调用 | | :---: | :---: | | @ 文件补全 | / 技能补全 | | 历史会话(搜索 / 多选删除) | 欢迎页(待命态可预选模式与思考级别) | | 历史会话 | 欢迎页 |

设置中心

| 基础设置(主题 / 字体 / 语言 / 自定义配色 + 环境路径) | 模型管理(内置渠道只读 + 命中方式徽章 / 第三方启停) | | :---: | :---: | | 基础设置 | 模型管理 | | 用量查询(应用用量:本地统计 + 第三方模型明细) | 记忆(指令 / 自动记忆管理) | | 用量查询 | 记忆 | | 技能(三来源扫描与启用管理) | MCP(服务器清单 / 工具列表 / 连接日志) | | 技能 | MCP | | 其他(输入历史补全与管理) | | | 其他 | |

快速开始

# 一键清理 + 重建(推荐):
#   清 Gradle 构建目录 + webview 缓存 → 双产物构建(多文件+sourcemap / singlefile fallback)→ buildPlugin
#   产物:intellij-plugin/build/distributions/ZC-GUI-<版本>.zip(IDE 内离线安装)
./build.sh               # 完整清理 + 重建
./build.sh --skip-clean  # 跳过清理,仅增量构建

# 或分步执行:
cd webview && npm install && npm run build && npm run build:single && cd ..
./gradlew :intellij-plugin:buildPlugin

# 或启动沙箱 IDE 直接体验
./gradlew :intellij-plugin:runIde

前端可脱离 IDE 独立开发(自动切换 mock 数据源):cd webview && npm run dev

生产模式下插件会用内置 HttpServer(127.0.0.1 随机端口)serve 多文件产物——webview 拥有真实 origin 与 sourcemap,DevTools 中可直接看 TS/TSX 源码断点;server 启动失败时自动降级 singlefile 单文件加载。

远程开发(JetBrains Gateway / WSL)

支持 JetBrains Gateway 远程开发(SSH 远程主机 / WSL2),插件只装在后端 IDE:

  • 在 JetBrains Client 的 Settings → Plugins 中对 ZC GUI 选「在后端安装」,或从磁盘安装时选择后端;前端(Client 侧)不要装副本——双端同时安装会使面板落到前端实例,文件补全与发送功能失效(须卸载前端副本、仅保留后端安装才能恢复),参见 issue #6。
  • 远程机需要具备运行条件:Node.js ≥ 18、ZCode CLI(按标准路径安装会被自动发现,如 /opt/ZCode/app/resources/glm/zcode.cjs;也可在插件设置 → 基础设置 → 环境中手动指定路径)与登录凭证(~/.zcode/v2/)。
  • 已知限制:AI 浏览器工具(browser-use)依赖的 CEF 调试通道跑在前端本机,远程开发下不可用;插件已做静默降级,不再显示误报横幅。

工作原理

插件以子进程方式启动 ZCode 的 app-server(node zcode.cjs app-server),通过 stdin/stdout 上的 JSON-RPC 驱动会话;事件流按会话分发、节流批量推入 JCEF,前端 reducer 增量归约为消息树与任务 / 子代理 / 文件改动等派生状态。插件同时充当宿主,实现 app-server 下行的 browser-use 宿主协议(interaction/browserList / browserExecute 反向请求),把 AI 的浏览器工具落到内嵌 JCEF 浏览器上执行。

graph LR
    UI[webview React UI] <-->|"JCEF 桥(事件 16ms 批量合并)"| Plugin[Intellij 插件<br/>多标签 + JS 桥 + 内嵌浏览器]
    Plugin --> Client[protocol-client<br/>JSON-RPC 客户端]
    Client <-->|"stdio"| CLI[ZCode app-server]
    CLI --> API[Z.ai / GLM API]
    CLI -.->|"browser-use 反向请求"| Plugin

对 app-server 协议面(RPC 方法清单、V4 会话协议、反向请求、事件流、错误码)的整理见 docs/zcode-appserver-protocol.md。

致谢

  • codicon(MIT)— 界面图标
  • ZCode — 本插件对接的 AI 编码服务

免责声明

本项目为个人开源项目,非 ZCode / Z.ai 官方产品;"ZCode"、"Zai" 名称与图标版权归其所有者所有。使用产生的费用与额度消耗由你的 ZCode 账号承担,请遵守 ZCode 服务条款。协议实现基于对 CLI app-server 接口的分析,随官方版本升级可能需要适配。

License

MIT

Related Skills

View on GitHub
GitHub Stars29
CategoryDevelopment
Updated15h ago
Forks2

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info
zcode-jetbrains-plugin — Other: Install & Safety Check | SkillAgent