Skip to content

INSTALL.md

Latest commit

 

History

History
267 lines (186 loc) · 9.3 KB

INSTALL.md

File metadata and controls

267 lines (186 loc) · 9.3 KB
Raw

安装：先选 Agent，再照着做

这是全仓库最该先看的一份文档。 只回答两件事：你要装什么、怎么装。

装错了会白忙 —— 因为 Pi Agent 和 DeepSeek Harness 是两套完全不同的框架， 接线方式、配置文件、甚至 lab 闸门都是各自实现的。

第 0 步：30 秒做决定

你用的是 走哪条路 一句话
Pi Agent → 路线 A 写 mcp.json + 拷技能目录
DeepSeek Harness（DSH） → 路线 B 装一个插件包
不确定 继续往下看 共同前提 先把前提装好，再回来选

两个都想装？ 两条路互不干扰，先后顺序随意，但各自都要做一遍。

共同前提（两个 Agent 都需要）

1. 系统与运行时

需要 最低 检查命令 说明
操作系统 Windows 10 1809+ / Linux / macOS — Web 取证那 8 个工具是 PowerShell 实现，Unix 需装 pwsh
Python 3.11+（必须能 import mcp） python -c "import mcp; print('ok')" seep 的 MCP 服务端靠它跑
Node.js 18+ node -v js-reverse / playwright 这两个 MCP 靠它
Java 11+ java -version jadx / apktool 反编译 APK 用
Git 任意 git --version 拉仓库、面板里更新都要

Python 那个 import mcp 最容易翻车：系统装的是 3.10、或 python 指向商店占位别名， 都会让 MCP 一启动就挂，而现象只是「工具连不上」。先跑一遍这条命令再往下走。

2. 把仓库拉下来（两个 Agent 都要）

git clone https://github.com/angusdevgo/Seep-Reverse-Lab.git seep
cd seep

仓库里已经带了全部工具本体（jadx / apktool / radare2 / aotopsy…，约 561 MB）， 不需要另外下载。只有两个 node_modules 被打包成 zip，第一次要解压：

powershell -File setup/extract-deps.ps1        # Windows：单独跑，只解压

Linux / macOS 没有单独的这一个脚本 —— ./setup/install.sh 会顺带把 zip 解好。 想先只解压、不做别的，用 unzip 手动解：

cd Tool/mcp/Tool/safe/js-reverse-mcp && unzip -q node_modules.zip
cd ../playwright-mcp && unzip -q node_modules.zip

3. 装 Python 依赖（两个 Agent 都要）

powershell -File setup/install-python.ps1      # Windows：建 venv 并装 mcp

Linux / macOS 走 ./setup/install.sh，它内部处理 PEP 668（系统 pip 被锁的情况） 并建好同一套 venv。想单独装也行：

python3 -m venv ~/.pi/agent/seep-venv
~/.pi/agent/seep-venv/bin/pip install mcp

这个 venv 两边共用：pi 的 mcp.json 与 DSH 插件都指向它。

路线 A：Pi Agent

装什么

东西 落到哪
MCP 注册表 ~/.pi/agent/mcp.json（增量合并，不覆盖你已有的条目）
10 个技能 ~/.pi/agent/skills/（拷贝一份过去）
纪律正文 ~/.pi/agent/seep-system.md
lab 闸门 + 词替换 ~/.pi/agent/extensions/security-audit-interceptor.ts
提示词 ~/.pi/agent/AGENTS.md / SYSTEM.md

怎么装

powershell -File setup/install-pi.ps1

它会先备份 ~/.pi/agent，再逐项合并。加上 -SkipPackages 可跳过 npm 依赖检查。

怎么验

powershell -File setup/verify.ps1

看到 核心检查通过: 64 项 就对了。里面包含 pi 的那几项（技能是否同步、mcp.json 是否写对）。

装完必须做

完全退出并重开 Pi（含终端）。MCP 是会话启动时握手的，不重开看不到工具。

然后发一句 lab： 试一下。

怎么更新

cd seep && git pull
powershell -File setup/install-pi.ps1      # 技能/扩展/mcp.json 变了才需要

pi 的技能是拷贝的，所以 git pull 之后必须重跑 install-pi.ps1 才能同步技能。 （DSH 是直接指过去的，没这一步 —— 这是两边最大的差别。）

装完之后怎么更新、插件发在哪、更新时会连带什么：见 MANUAL/UPDATING.md。

路线 B：DeepSeek Harness

装什么

东西 落到哪
插件包 seep-dsh-workbench ~/.dsh/profiles/web/node_modules/
一条挂载配置 ~/.dsh/profiles/web/cordis.patch.yml
运行状态 ~/.dsh/seep-workbench.status.json（只有 DSH 写这个文件）

不需要改 ~/.pi/agent 下任何东西，也不需要装任何技能副本 —— 插件会在运行时把 MCP 和技能直接指向仓库。

怎么装

python setup/dsh-plugin-setup.py

常用参数：

python setup/dsh-plugin-setup.py --check              # 只报状态，不改文件
python setup/dsh-plugin-setup.py --with-playwright    # 多挂 25 个浏览器工具
python setup/dsh-plugin-setup.py --with-ida           # 多挂 48 个 IDA 工具
python setup/dsh-plugin-setup.py --root D:\新位置\seep # 仓库搬家后重跑这条

两种装法，差别只在「以后怎么更新」

默认（本地目录） --from-npm
命令 python setup/dsh-plugin-setup.py python setup/dsh-plugin-setup.py --from-npm
插件从哪来 仓库里的 packages/dsh-workbench/ npm 上的 seep-dsh-workbench
改了 lib/*.js 重启就生效（硬链接） 不生效，要等发新版
面板「更新插件」 灰色不可点 可点，自动拉新版
适合谁 想改代码 / 没网 只想用，不想管插件版本

两者都需要先 clone 仓库 —— 561 MB 的工具本体在仓库里，不进 npm 包。 装完想换装法，直接跑另一条命令即可（脚本会自动卸掉旧的再装新的）。

怎么验

python setup/verify-dsh.py

要看到 100.0% (102 / 102 分)。它查的是 DSH 专属接线： 插件装了没、MCP 能不能真起来（真的启动数工具，不是看配置）、技能进没进注册表、面板在不在。

装完必须做

完全退出并重开 DSH。 然后：设置 → Seep 工作台，能看到运行状态就对了。

怎么更新

cd seep && git pull      # 工具 / 技能 / 知识库
dsh plugin update --profile web seep-dsh-workbench   # 只更新插件（从 npm 装时才有意义）

或者全在面板上点：更新插件 / 更新工作台 / 更新内容。

技能不用重装：插件直接指向仓库目录，git pull 就生效（新会话可见）。 只有 MCP 服务端变了才需要重启 DSH。

一次装全部（图省事）

powershell -File setup/install.ps1

这一条会依次做：解压依赖 → 检测环境 → 装 Python 依赖 → 配 Pi → 生成各家配置 → 装 DSH 插件 → 可选能力包 → 跑 verify.ps1 → 跑 verify-dsh.py。

适合「我全都要」，不适合「只想装一个」 —— 只想装 DSH 就别用这条， 用路线 B 的两条命令更干净。

装完之后：怎么用

在对话框里发：

lab：

只有这一句（或 实验： / enter lab）才会进入作战模式。 聊到 APK、破解、hook 都不算激活 —— 这是刻意的安全边界。

退出：退出实验。

DSH 还可以直接点面板上的 Lab 开关，效果一样。

常见失败对照表

症状 大概是 怎么办
verify 说 Python 没 import mcp python 指向了错误解释器 SEEP_PYTHON=<正确路径> 或重跑 install-python.ps1
MCP 工具一个都看不到 Agent 没重启 完全退出重开（不是新开一个标签页）
verify-dsh.py 说插件没装 装到了别的 profile 加 --profile <名字> 重跑
DSH 面板一片空白 / 没有「Seep 工作台」 插件没生效 python setup/dsh-plugin-setup.py --check
提示「工作台路径不存在」 仓库搬过家 面板改路径，或 --root 重跑，然后重启 DSH
pi 的技能是旧的 技能是拷贝的 重跑 install-pi.ps1
未找到 jadx 依赖 zip 没解压 setup/extract-deps.ps1
Windows 上 tar 报错 Git Bash 把 C: 当主机名 用 PowerShell，或加 --force-local

两者到底差在哪（防止装混）

Pi DSH
技能 拷贝到 ~/.pi/agent/skills 插件直接指向仓库目录
git pull 后 要重跑 install-pi.ps1 技能直接生效，MCP 要重启
lab 闸门 TS 扩展 插件里的 JS
设置面板 没有 有（设置 → Seep 工作台）
校验命令 verify.ps1 verify-dsh.py

更细的对照见 MANUAL/AGENTS.md。

只想看目录结构

seep/
├── INSTALL.md          ← 你在看的这份
├── setup/              所有安装/校验脚本
├── Tool/
│   ├── mcp/            MCP 服务端 + 内置工具本体
│   ├── skill/          10 个技能
│   ├── cases/          14 个脱敏案例
│   └── prompts/        纪律正文（SYSTEM.md）与指令入口（AGENTS.md）
├── packages/dsh-workbench/   DSH 插件源码（发布到 npm 的就是它）
└── MANUAL/             部署细节、校验基准、发布章程