askinfo 是一个终端优先的资产收集 Agent。当前开源版本面向直接命令行使用,核心入口是:
askinfo "帮我梳理示例科技有限公司的互联网资产,重点关注登录页和后台"它会完成自然语言规划、多平台查询、资产归一化、去重归并、有效性验证和 xlsx 报告导出。
- Python
3.10+ - 可用的 OpenAI-compatible 接口
- 至少一个可用的资产平台 API 凭据
如果你希望在任意目录、任意新终端里都能直接执行 askinfo,推荐使用用户级安装:
python -m pip install -r requirements.txt
python -m pip install --user .安装完成后,直接在普通终端里使用:
askinfo --doctor
askinfo "帮我梳理示例科技有限公司的互联网资产"如果系统提示找不到 askinfo,请确认下面目录已经加入 PATH:
C:\Users\<你的用户名>\AppData\Roaming\Python\Python310\Scripts
不同 Python 版本号会不同,比如 Python311、Python312。
修改 PATH 后,需要重新打开终端。
你可以在项目目录里放 .env,也可以放全局配置文件。推荐全局方式,这样在任何目录执行 askinfo 都能自动读取。
推荐全局配置路径:
C:\Users\<你的用户名>\AppData\Roaming\askinfo\.env
如果你想从项目模板复制,可以先执行:
copy .env.example %APPDATA%\askinfo\.envaskinfo 默认按下面顺序查找配置文件:
- 当前目录的
.env %APPDATA%\askinfo\.env~\.askinfo\.env
你也可以显式指定:
askinfo --env-file C:\path\to\custom.env "你的任务文本"常见配置示例:
OPENAI_API_KEY=
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4.1-mini
OPENAI_TIMEOUT=60
FOFA_EMAIL=
FOFA_API_KEY=
QUAKE_API_KEY=
HUNTER_API_KEY=
SHODAN_API_KEY=
URLSCAN_API_KEY=
SECURITYTRAILS_API_KEY=
WHOISXML_API_KEY=
REQUEST_TIMEOUT=20
HTTP_PROXY=
HTTPS_PROXY=说明:
OPENAI_API_KEY:必填,终端 Agent 用它做任务规划。OPENAI_BASE_URL:如果你使用代理网关或兼容接口,在这里替换。OPENAI_MODEL:规划时使用的模型名。- 平台密钥按需填写,没填的平台不会参与执行。
REQUEST_TIMEOUT:平台请求超时,单位秒。HTTP_PROXY/HTTPS_PROXY:有代理时再填。
检查运行环境:
askinfo --doctor执行主流程:
askinfo "帮我梳理示例科技有限公司的互联网资产,重点关注登录页和后台"指定输出文件:
askinfo "帮我梳理示例科技有限公司的互联网资产" --output .\tmp\report.xlsx如果你不想安装命令,也可以在项目目录里继续用:
python agent.py "帮我梳理示例科技有限公司的互联网资产"- 默认输出目录:
.\tmp\ - 默认输出格式:
xlsx
agent.py: 仓库内直接运行入口src/asset_mapping_agent/cli.py:askinfo命令入口src/asset_mapping_agent/: 核心实现prompts/intent_and_plan.md: Agent 规划提示词.env.example: 环境变量模板