Skip to content
Merged
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
6 changes: 6 additions & 0 deletions plugins/process-killer/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
node_modules/
.DS_Store
*.log

# 打包结果不进仓库(安装包走 GitHub Releases)
releases/
10 changes: 10 additions & 0 deletions plugins/process-killer/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Changelog

## 1.0.0 - 2026-11-20

- 初次发布到 ZTools 插件市场,插件 ID `process-killer`(进程管家)。
- 列出进程的 CPU、内存与监听端口,支持按内存 / CPU / 名称 / 端口排序,搜索进程名、路径、PID 或端口。
- 关闭进程:先发送 SIGTERM(Windows 走 WM_CLOSE),3 秒未退出时提示可强制结束;另有重启 .app、复制路径、在文件夹中显示、查看完整启动命令。
- 主搜索框直出结果:输入 `kill chrome`、`netstat 8080` 直接列出进程,回车即可关闭。
- 自动 / 手动刷新开关;关闭进程前弹出确认框,确认后才执行。
- 支持 macOS 与 Windows 双端。
61 changes: 61 additions & 0 deletions plugins/process-killer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# 进程管家(process-killer)

ZTools 插件(ID `process-killer`):搜索进程名或端口,查看 CPU、内存与端口占用,关闭、强制结束或重启进程。支持 macOS 与 Windows。

在 ZTools 里输入 `kill`、`关闭进程`、`进程管理`、`进程管家`、`netstat`、`端口占用` 即可打开。

## 功能

- 列出进程及其 CPU、内存、监听端口,按内存 / CPU / 名称 / 端口排序
- 搜索进程名、路径、PID 或端口号
- 关闭(先温和退出,3 秒未退提示可强制结束)、强制结束、重启 .app / .exe、复制路径、文件夹中显示、查看完整启动命令
- 关闭前弹确认框,确认后才真正结束进程
- 自动 / 手动刷新开关
- 主搜索框直接推结果:输入 `kill chrome` 或 `netstat 8080` 即列出,回车关闭

## 目录结构

本仓库按 [ZToolsCenter/ZTools-plugins](https://github.com/ZToolsCenter/ZTools-plugins) 的目录约定组织,插件 ID 为 `process-killer`:

```text
src-ztools/
├── build-plugin.sh 官方 CI 的构建钩子:跑 npm run build
└── ztools/ 插件目录(提交在仓库里,清单所在目录 = 安装包内容)
├── plugin.json 清单(name / title / version / main / preload / platform …)
├── logo.png 图标
├── index.html 界面入口
├── main.js / style.css
└── preload/ Node 侧采集与操作
```

发布 CLI 会把整个工程目录复制成仓库里的 `plugins/process-killer/`,但它复制时会**跳过所有名为 `dist` 的目录**,所以运行时代码放在 `src-ztools/ztools/`;本地构建输出的 `dist/` 是安装包内容,不提交(已在 `.gitignore` 里)。

官方 CI 没有 `build-plugin.sh` 时,会把 `src-ztools/` 整份打成安装包;有钩子则先执行构建。两条路径都能拿到正确的安装包结构,

## 本地开发

Node.js >= 20(本机用 nvm 的 v20.19.5)。

```sh
npm run build # 把 src-ztools/ztools 整理成 dist/(安装包内容),并核对清单声明的文件
npm run package # 另外输出 releases/process-killer-<版本>.zip
npm test # 单元测试
npm run test:ui # Chrome 里跑一遍界面,需要 playwright 与本机 Chrome
```

ZTools 开发者工具里的开发模式添加 `src-ztools/ztools/plugin.json` 即可加载本工程。

## 发布

```sh
ztools publish
```

本机已安装 `@ztools-center/plugin-cli`(`~/.nvm/versions/node/v14.21.3/bin/ztools`),token 存在 `~/.config/ztools/cli-config.json`。发布前需要:`plugin.json` 的 version 已升、`CHANGELOG.md` 有对应 `## 版本 - 日期` 段落、工作区干净。

## 注意

- CPU 取自 `ps` / CIM 的累计百分比,不是瞬时值,与活动监视器口径不同。
- `lsof`(macOS)/ `netstat`(Windows)看不到无权限用户进程的端口,界面会提示。
- 只能重启应用包(.app / .exe);命令行程序直接启动会丢环境变量,故明确报错。
- 关闭系统进程需要更高权限,插件不做提权。
23 changes: 23 additions & 0 deletions plugins/process-killer/package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
{
"name": "ztools-process-killer",
"private": true,
"version": "1.0.0",
"type": "module",
"description": "ZTools 插件:搜索进程名或端口,关闭/重启/查看进程",
"scripts": {
"build": "node scripts/build-process-killer.mjs",
"package": "node scripts/build-process-killer.mjs --zip",
"test": "node --test test/*.test.cjs",
"test:ui": "node test/ui-smoke.cjs && node test/ui-smoke-win.cjs && node test/auto-refresh.test.cjs"
},
"dependencies": {
"vite": "^6.0.11",
"vue": "^3.5.13"
},
"devDependencies": {
"@vitejs/plugin-vue": "^5.2.1",
"@ztools-center/ztools-api-types": "^1.0.1",
"typescript": "^5.3.0",
"vue-tsc": "^2.0.0"
}
}
45 changes: 45 additions & 0 deletions plugins/process-killer/scripts/build-process-killer.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
// 把 src-ztools 整理成可安装、可分发的插件目录
//
// ZTools 插件仓库对静态插件的打包规则是:清单所在目录 = 安装包内容。
// 同时 src-ztools 这个目录会被发布 CLI 整份复制进插件仓库,而它复制时会跳过
// 名为 dist 的目录。于是约定:
// src-ztools/plugin.json ← 发布清单(main/preload/logo 指向 runtime/…)
// src-ztools/runtime/ ← 清单 + 图标 + 运行时代码(安装包内容)
// 本地 build 只是把它整理成 dist/,用来打 zip、装进 ZTools 开发者工具试跑。
import { cp, rm, mkdir, readFile, stat } from 'node:fs/promises'
import { execFileSync } from 'node:child_process'
import path from 'node:path'

const root = path.resolve(import.meta.dirname, '..')
const src = path.join(root, 'src-ztools')
// 运行时目录:清单与图标在里面,src-ztools/plugin.json 只是发布用的清单
const pkg = path.join(src, 'runtime')
const out = path.join(root, 'dist')
const manifest = JSON.parse(await readFile(path.join(pkg, 'plugin.json'), 'utf8'))

await rm(out, { recursive: true, force: true })
await mkdir(out, { recursive: true })
await cp(pkg, out, { recursive: true, filter: p => !p.endsWith('.DS_Store') })

// 清单声明的文件必须真的存在,否则装上是白屏
for (const file of [manifest.main, manifest.preload, manifest.logo]) {
if (!file) continue
await stat(path.join(out, file)).catch(() => {
throw new Error('plugin.json 声明的文件不存在: ' + file)
})
}

console.log('build ok ->', path.relative(root, out))

if (process.argv.includes('--zip')) {
const zip = path.join(root, 'releases', `process-killer-${manifest.version}.zip`)
await mkdir(path.dirname(zip), { recursive: true })
await rm(zip, { force: true })
// Windows 自带 tar(bsdtar)也能打 zip,Mac 上用 ditto 保留架构信息
if (process.platform === 'win32') {
execFileSync('tar.exe', ['-a', '-c', '-f', zip, '-C', out, '.'])
} else {
execFileSync('/usr/bin/ditto', ['-c', '-k', '--norsrc', out, zip])
}
console.log('zip ->', path.relative(root, zip))
}
7 changes: 7 additions & 0 deletions plugins/process-killer/src-ztools/build-plugin.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
#!/usr/bin/env bash
# ZTools 插件仓库的官方构建钩子:打包目录由 src-ztools/pkg 决定
# (scripts/build-plugins.js 只认插件根目录下的 plugin.json,
# 或 main 字段所在目录里确实有 plugin.json,因此运行时代码放在 pkg/)
set -euo pipefail
cd "$(dirname "$0")/.."
node scripts/build-process-killer.mjs
31 changes: 31 additions & 0 deletions plugins/process-killer/src-ztools/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
{
"$schema": "node_modules/@ztools-center/ztools-api-types/resource/ztools.schema.json",
"name": "process-killer",
"title": "进程管家",
"description": "搜索进程名或端口,查看 CPU、内存与端口占用,关闭、强制结束或重启进程",
"version": "1.0.0",
"author": "xiewz",
"homepage": "https://github.com/XiewzHub/ztools-process-killer",
"platform": ["win32", "darwin"],
"main": "runtime/index.html",
"preload": "runtime/preload/services.js",
"logo": "runtime/logo.png",
"pluginSetting": {
"height": 560
},
"features": [
{
"code": "kill",
"explain": "搜索进程名或端口,关闭或管理进程",
"icon": "runtime/logo.png",
"cmds": [
"kill",
"关闭进程",
"进程管理",
"进程管家",
"netstat",
"端口占用"
]
}
]
}
64 changes: 64 additions & 0 deletions plugins/process-killer/src-ztools/runtime/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>关闭进程</title>
<link rel="stylesheet" href="./style.css" />
</head>
<body>
<div class="app">
<header class="toolbar">
<input id="search" class="search" type="text" placeholder="搜索进程名、路径或端口…" autofocus />
<div class="sorts" id="sorts">
<button data-sort="mem" class="active">内存</button>
<button data-sort="cpu">CPU</button>
<button data-sort="name">名称</button>
<button data-sort="ports">端口</button>
</div>
<button id="refresh" class="icon-btn auto" title="自动刷新中,点击改为手动(Ctrl/⌘+R 随时刷新)">⟳</button>
</header>

<div id="banner" class="banner" hidden></div>

<div class="table-head">
<span class="col-name">进程</span>
<span class="col-pid">PID</span>
<span class="col-port">端口</span>
<span class="col-cpu">CPU</span>
<span class="col-mem">内存</span>
</div>

<main id="list" class="list"></main>

<div id="empty" class="empty" hidden>没有匹配的进程</div>

<footer class="status">
<span id="summary">加载中…</span>
<span class="hint">↑↓ 选择 · ⏎ 关闭 · Ctrl/⌘+⏎ 重启 · ⇧⏎ 详情 · Ctrl/⌘+C 复制路径</span>
</footer>
</div>

<div id="menu" class="menu" hidden></div>
<div id="dialog" class="dialog-backdrop" hidden>
<div class="dialog">
<h3 id="dialog-title">进程详情</h3>
<pre id="dialog-body"></pre>
<div class="dialog-actions"><button id="dialog-close">关闭</button></div>
</div>
</div>
<div id="confirm" class="dialog-backdrop" hidden>
<div class="dialog confirm-dialog">
<h3 id="confirm-title">确认关闭进程</h3>
<p id="confirm-body" class="confirm-text"></p>
<div class="dialog-actions">
<button id="confirm-cancel">取消</button>
<button id="confirm-ok" class="danger-btn">确认关闭</button>
</div>
</div>
</div>
<div id="toast" class="toast" hidden></div>

<script type="module" src="./main.js"></script>
</body>
</html>
Binary file added plugins/process-killer/src-ztools/runtime/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading