{"_id":"@360safe/safe-cli","name":"@360safe/safe-cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@360safe/safe-cli","version":"1.0.0","description":"360 Safe CLI Tool - Terminal interface for 360 Safe client","bin":{"safe":"dist/index.js","software":"dist/software.js"},"scripts":{"build":"tsup","dev":"tsup --watch","postinstall":"node scripts/postinstall.js"},"keywords":["360","safe","cli","security","optimizer"],"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"commander":"^13.1.0"},"devDependencies":{"tsup":"^8.3.6","typescript":"^5.7.3","@types/node":"^22.10.0"},"_id":"@360safe/safe-cli@1.0.0","gitHead":"fd998d3e19ceff997dc9ae1c2f6e12eb6ed8862e","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-bV3kvR9GbmqBP5T7olgiBYlPj+IkTEBGOsuJcMqs/t0tYhG3dMasDe4CinORZXH95tT3mo2HI/hfnLuFsWWuqg==","shasum":"e33d14ad47c5b5a9146fad8a187e97b4dfbb7412","tarball":"https://registry.npmjs.org/@360safe/safe-cli/-/safe-cli-1.0.0.tgz","fileCount":11,"unpackedSize":71808,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEv2pJY41spSF2m2hvA9or6TC3MHdJd7nGU/8Sug1hMoAiEAgk5TqGueOuu6S031jBqofoThDBiA5nsCIum2mQd2d50="}]},"_npmUser":{"name":"safe-product","email":"xiaoyu1@360.cn"},"directories":{},"maintainers":[{"name":"safe-product","email":"xiaoyu1@360.cn"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/safe-cli_1.0.0_1782806458502_0.11281282803930215"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-30T08:00:58.254Z","1.0.0":"2026-06-30T08:00:58.642Z","modified":"2026-06-30T08:00:58.924Z"},"maintainers":[{"name":"safe-product","email":"xiaoyu1@360.cn"}],"description":"360 Safe CLI Tool - Terminal interface for 360 Safe client","keywords":["360","safe","cli","security","optimizer"],"license":"MIT","readme":"# @360safe/safe-cli\n\n360 安全卫士终端 CLI 工具，为 AI Agent 提供系统清理、修复、优化和软件管理能力。\n\n## 安装\n\n```bash\nnpm install -g @360safe/safe-cli\n```\n\n安装完成后，工具会自动检测已安装的 Agent 平台（Claude Code、Cursor、Windsurf 等），并将内置 Skills 分发到对应目录。\n\n## 使用\n\n```bash\n# 查看版本\nsafe --version\nsafe -v\n\n# 查看帮助\nsafe --help\nsafe -h\n\n# 初始化/安装客户端\nsafe --setup\n\n# 查看客户端状态\nsafe --status\n\n# 电脑清理\nsafe clean              # 一键清理全部\nsafe clean_junk         # 只清理垃圾\nsafe clean_traces       # 只清理痕迹\n\n# 优化加速\nsafe bootspeed          # 开机慢、开机加速\nsafe netspeed           # 网速慢、网络优化、网速加速\nsafe performancespeed   # 电脑卡、性能优化、运行加速\nsafe win11speed         # Win11 优化、Win11 加速\nsafe optimize           # 一键优化全部\n\n# 软件管家\nsoftware search \"微信\"\nsoftware search \"微信\" 10\nsoftware list\nsoftware list --system\nsoftware install 103595847\nsoftware uninstall A1B2C3\n\n# 手动分发 Skills\nsafe skills\n```\n\n## 输出格式\n\n所有命令输出 JSON 到 stdout，错误输出 stderr。\n\n### 成功\n```json\n{\"status\": \"success\", \"data\": { ... }}\n```\n\n### 需手动完成（非静默安装）\n```json\n{\"status\": \"manual_required\", \"data\": {\"name\": \"...\", \"message\": \"...\"}}\n```\n\n### 错误（stderr）\n```json\n{\"code\": \"client_not_installed\", \"message\": \"client is not installed\", \"fix\": \"run 'safe setup' to install\"}\n```\n\n### 退出码\n- `0` - 成功（含 manual_required）\n- `1` - 一般失败\n- `2` - 用法错误\n\n## WSL 支持\n\n本项目支持在 WSL (Windows Subsystem for Linux) 环境下运行，执行链路分为两层：\n\n1. **安装期桥接（postinstall）**\n   - 执行 `scripts/wsl-bridge.sh`\n   - 将 `bat/*.bat` 复制到 Windows 用户目录下（`%USERPROFILE%\\AppData\\Local\\safe-cli`）\n   - 在 WSL 的可执行目录生成 wrapper（`safe` / `software`）\n\n2. **运行期兜底（executor）**\n   - 当 CLI 在 WSL 内执行时，`executor` 会优先尝试把 bat 复制到 `/mnt/c` 可写目录并通过 `cmd.exe` 执行\n   - 若失败，再尝试 `\\\\wsl$\\<distro>\\tmp\\...` + `pushd` 方式执行\n   - 以上策略用于规避 WSL 下 UNC 工作目录限制与 bat 直接调用失败问题\n\n### 输出净化与调试开关\n\n默认情况下，CLI 会对输出做净化，过滤 Windows 本地化系统提示/乱码噪声，优先保留业务 JSON 或业务文本。\n\n如需排查底层问题，可开启原始输出：\n\n```bash\nSAFE_RAW_OUTPUT=1 node dist/index.js --status\nSAFE_RAW_OUTPUT=1 node dist/index.js --setup\n```\n\n> `SAFE_RAW_OUTPUT=1` 时将直接返回原始 `stdout/stderr`，不做任何过滤。\n\n如需查看执行器内部策略日志（例如当前命中了 WSL 哪条执行分支），可额外开启：\n\n```bash\nSAFE_EXECUTOR_DEBUG=1 node dist/index.js --status\n```\n\n> `SAFE_EXECUTOR_DEBUG=1` 会将 executor 调试日志输出到 `stderr`。\n\n## 开发\n\n```bash\n# 安装依赖\nnpm install\n\n# 构建\nnpm run build\n\n# 开发模式（watch）\nnpm run dev\n```\n\n## 支持的 Agent 平台\n\n安装时自动检测以下平台并分发 Skills：\n\n| 平台 | 目录 |\n|------|------|\n| 通用兼容目录 | `%USERPROFILE%\\.agents\\skills\\` |\n| Claude Code | `%USERPROFILE%\\.claude\\skills\\` |\n| GitHub Copilot | `%USERPROFILE%\\.copilot\\skills\\` |\n| Windsurf | `%USERPROFILE%\\.codeium\\windsurf\\skills\\` |\n| Gemini CLI | `%USERPROFILE%\\.gemini\\skills\\` |\n| Codex | `%USERPROFILE%\\.codex\\skills\\` |\n| Kimi Code CLI | `%USERPROFILE%\\.config\\agents\\skills\\` |\n| Qwen Code | `%USERPROFILE%\\.qwen\\skills\\` |\n| Trae | `%USERPROFILE%\\.trae\\skills\\` |\n| Trae CN | `%USERPROFILE%\\.trae-cn\\skills\\` |\n| Kiro | `%USERPROFILE%\\.kiro\\skills\\` |\n| Cline | `%USERPROFILE%\\.cline\\skills\\` |\n| Warp | `%USERPROFILE%\\.agents\\skills\\` |\n| OpenClaw | `%USERPROFILE%\\.openclaw\\skills\\` |\n| QClaw | `%USERPROFILE%\\.qclaw\\skills\\` |\n| Cursor | `%USERPROFILE%\\.cursor\\skills\\` |\n| OpenCode | `%USERPROFILE%\\.config\\opencode\\skills\\` |\n| Hermes | `%USERPROFILE%\\.hermes\\skills\\` |\n| Hermes (Windows) | `%LOCALAPPDATA%\\hermes\\skills\\` |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-1d95b4985d88fc8005d2e38ce0592709"}