sn-deepresearch-cli

1# sn-deepresearch-cli
2 
3作为 SenseNova-Skills-DeepResearch 的用户入口，负责环境预检、安装引导、参数确认、任务启动、进度告知和结果交付。
4默认 npm 包为 `sensenova-skills-deepresearch`，项目源码仓库为
5`https://github.com/OpenSenseNova/SenseNova-Skills-DeepResearch`。用户侧直接安装已构建并发布到 npm 的包，
6不需要 clone 仓库或本地构建。
7 
8## 环境预检
9 
10在安装或启动 SenseNova-Skills-DeepResearch 前，仅检查当前环境是否具备运行条件：
11 
12- Node.js >= 22、Python >= 3.10 和 npm 是否可用；
13- 是否已安装 SenseNova-Skills-DeepResearch 提供的 `deepresearch` 命令；
14- 用户选择的 Hermes、Codex、Claude Code 或 OpenClaw 是否存在。
15 
16这里使用系统的命令存在性和版本检查即可。SenseNova-Skills-DeepResearch 提供的 `deepresearch` 命令尚未安装时，不得提前调用
17`deepresearch doctor`、`sources`、`browser`、`status` 等 SenseNova-Skills-DeepResearch 子命令。SenseNova-Skills-DeepResearch 或 Harness 缺失时先报告缺失项，
18不要静默改用其他 Harness。
19 
20不得显示环境变量值、token、Cookie、npm 凭据或 Harness Profile。
21 
22## 安装或升级 SenseNova-Skills-DeepResearch
23 
24安装会访问网络并修改用户级 npm 目录，执行前先取得当前环境要求的授权。
25 
26从 npm 安装已构建好的包：
27 
28```bash
29npm install --global sensenova-skills-deepresearch
30deepresearch --help
31```
32 
33升级到最新版本：
34 
35```bash
36npm install --global sensenova-skills-deepresearch@latest
37```
38 
39维护者在发布侧负责构建 Python wheel 和 npm tarball；Skill 不得让用户 clone 源码、运行
40`scripts/build_npm_package.py`、创建构建虚拟环境或从 GitHub Release 下载 tarball。只有用户明确提供本地
41`.tgz` 并要求测试时，才可执行 `npm install --global <local-tgz>`。
42 
43安装后初始化用户级 Search 配置：
44 
45```bash
46deepresearch sources init
47deepresearch sources list --json
48```
49 
50配置文件位于 `~/.deepresearch-cli/search/.env`。公开来源无需 API key；需要扩展来源时，只告知应填写的变量名，
51不索取或回显凭据。
52 
53## 准备 Harness
54 
55- Hermes：复用现有 Hermes 登录和模型配置。
56- Codex：确认 `codex` 存在且已执行 `codex login`。
57…