chaitin/chaitin-cli

Profil chaitin

Dernière activité source enregistrée: 3 août 2026 à 02:28

Catalogue SkillsMP mis à jour: 17 octobre 2026 à 00:09

skills collectés: 1

Étoiles GitHub: 114
Forks GitHub: 17

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# chaitin-cli [![CI](https://img.shields.io/github/actions/workflow/status/chaitin/chaitin-cli/ci.yml?branch=main&label=CI)](https://github.com/chaitin/chaitin-cli/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/chaitin/chaitin-cli?label=Release)](https://github.com/chaitin/chaitin-cli/releases) [![Go Version](https://img.shields.io/github/go-mod/go-version/chaitin/chaitin-cli?label=Go)](https://github.com/chaitin/chaitin-cli/blob/main/go.mod) [![License](https://img.shields.io/github/license/chaitin/chaitin-cli?label=License)](https://github.com/chaitin/chaitin-cli/blob/main/LICENSE) 长亭安全产品统一命令行工具 [English README](./README.en.md) ## 项目简介 `chaitin-cli` 是面向长亭安全产品的统一命令行工具，目标是在一个二进制中提供多产品的常用运维、查询和自动化能力。它解决了不同产品 API、认证方式和输出格式分散的问题，让开发者、运维人员和 AI Agent 可以用一致的方式管理 SafeLine、X-Ray、MonkeyScan、Cloud Atlas、CloudWalker、Veinmind、T-Answer、DDR 等产品。核心能力： - 统一入口：通过 `chaitin-cli <product> <command>` 调用不同产品能力 - 配置复用：支持配置文件、环境变量、`.env` 和命令行参数 - 自动化友好：提供 dry-run、JSON 输出和 AI Skill，便于脚本和 Agent 集成 ## 快速开始 macOS / Linux 可直接运行安装脚本： ```bash curl -fsSL https://raw.githubusercontent.com/chaitin/chaitin-cli/main/skills/chaitin-cli/scripts/install-chaitin-cli.sh | bash ``` Windows 用户请从 [GitHub Releases](https://github.com/chaitin/chaitin-cli/releases) 下载对应版本，解压 `chaitin-cli.exe` 并加入 PATH。查看当前版本： ```bash chaitin-cli version chaitin-cli --version ``` ## Skill 本项目提供了 skill，安装后 AI Agent（Claude Code、Cursor 等）可以直接调用 `chaitin-cli` 命令管理长亭安全产品。如果你希望 AI Agent 自动调用 `chaitin-cli`，可以安装 Skill： ```bash npx skills add chaitin/chaitin-cli ``` 安装后，向 AI Agent 描述需求即可，例如： - "帮我查看 SafeLine 最近的攻击日志" - "在 X-Ray 中创建一个扫描任务" - "列出 Cloud Atlas 中待处理的漏洞" - "列出 CloudWalker 中的漏洞事件" - "在 CodeForce 中创建降噪任务并查看结果" - "使用 MonkeyScan 对当前项目发起全量安全扫描" ## 演示 ### CloudWalker [![asciicast](https://asciinema.org/a/894643.svg)](https://asciinema.org/a/894643) ### Veinmind [![asciicast](https://asciinema.org/a/cTKHufj2Fewwl95j.svg)](https://asciinema.org/a/cTKHufj2Fewwl95j) ### T-Answer [![asciicast](https://asciinema.org/a/Gs8KPOIcEnRRnXWr.svg)](https://asciinema.org/a/Gs8KPOIcEnRRnXWr) ### SafeLine [![asciicast](https://asciinema.org/a/x7I8JDzbtjsRjb5M.svg)](https://asciinema.org/a/x7I8JDzbtjsRjb5M) ### SafeLine-CE [![asciicast](https://asciinema.org/a/dzJzibRTm8arWRmU.svg)](https://asciinema.org/a/dzJzibRTm8arWRmU) ### DDR [![asciicast](https://asciinema.org/a/IHulIbJ5nsy924qd.svg)](https://asciinema.org/a/t0cFuOjkLkExjREx) ### X-Ray [![asciicast](https://asciinema.org/a/923077.svg)](https://asciinema.org/a/923077) ## 功能模块 | 模块 | 中文名 | 说明 | | ------------- | ---------------------- | -------------------------------------------------------- | | `chaitin` | 主模块 | 示例和基础命令 | | `safeline` | 下一代Web应用防火墙（雷池20系列） | SafeLine WAF 站点、策略、ACL、攻击日志和系统信息管理 | | `safeline-3` | 下一代Web应用防火墙（雷池30系列） | SafeLine-3 保护对象、策略、ACL、日志、监控、系统和网络管理 | | `safeline-ce` | 雷池WAF社区版 | SafeLine CE 站点、规则、日志、证书和增强防护管理 | | `xray` | 风险评估系统（洞鉴） | X-Ray 扫描任务、资产、漏洞、报告和系统配置管理 | | `cloudAtlas` | 资产暴露面运营管理（云图） | Cloud Atlas 资产、暴露面、风险、情报、策略和任务管理 | | `cloudwalker` | 云工作负载保护平台（牧云-主机安全） | CloudWalker CWPP 事件、资产、漏洞、防护策略和系统管理 | | `veinmind` | 云工作负载保护平台（牧云-容器安全） | CloudWalker CNAPP 容器、镜像、逃逸防护管理 | | `tanswer` | 流量威胁检测响应系统（全悉） | 全悉威胁告警、文件告警、资产配置、安全策略、响应处置和 Open API fallback | | `ddr` | 终端统一管控与安全检测响应平台（长亭DDR） | DDR API Token 和连接配置辅助能力 | | `apisec` | 高级API安全系统（APISEC） | APISec API 资产、站点、应用、访问者、数据安全和风险事件管理 | | `dsensor` | 主动威胁欺骗防御系统（谛听） | D-Sensor 谛听安全监控、探针、蜜罐、告警和威胁日志管理 | | `codeinsight` | 智能静态应用程序安全测试系统（慧鉴） | CodeInsight 项目、代码托管配置、扫描任务和报告导出管理 | | `codeforce` | 智能开发与安全一体化平台（码力） | CodeForce 项目、项目 AI 员工、AI 开发任务、原生审计、降噪、代码包、仓库和 Git 授权配置管理 | | `cosmos` | 安全分析与运营管理平台（万象） | Cosmos / AISOC 告警、日志、情报、封禁、资产、通知、运维、SOAR 和漏洞管理 | | `monkeyscan` | AI 代码安全平台 MonkeyScan | 本地目录、源码压缩包与 GitHub 仓库全量安全扫描 | 根命令负责配置加载、产品命令注册和 BusyBox 风格调用分发；各产品目录负责自己的命令、参数、配置解析和 API 调用逻辑。 ## 配置推荐将各产品的连接信息写入 `~/.chaitin-cli/config.yaml`。如果当前目录存在 `./config.yaml`，且顶层包含 chaitin-cli 产品名，CLI 会优先读取这个本地配置，以兼容既有使用流程： ```yaml cloudAtlas: url: https://cloud-atlas.example.com/openapi token: YOUR_TOKEN space_id: YOUR_SPACE_ID cloudwalker: url: https://cloudwalker.example.com/rpc api_key: YOUR_API_KEY tanswer: url: 'https://<全悉 Web 端 IP>' api_key: '<全悉 OpenAPI Token>' # chaitin-cli ddr get-api-token --url https://ddr.example.com:8443 --jwt-token "YOUR_JWT_TOKEN" 可以直接获取 url & api_key & company_id ddr: url: "https://ddr.example.com:8443/qzh/api/v1" api_key: "YOUR_API_KEY" company_id: "YOUR_COMPANY_ID" veinmind: url: "https://veinmind.example.com" api_key: "YOUR_64_CHARACTER_API_TOKEN" xray: url: https://xray.example.com/api/v2 api_key: YOUR_API_KEY apisec: url: https://apisec.example.com api_token: YOUR_API_TOKEN safeline-3: url: https://safeline3.example.com api_token: YOUR_API_TOKEN dsensor: url: https://dsensor.example.com api_key: YOUR_API_KEY codeinsight: url: https://codeinsight.example.com access_token: YOUR_ACCESS_TOKEN codeforce: url: https://codeforce.example.com access_token: YOUR_ACCESS_TOKEN account_type: admin cosmos: url: https://cosmos.example.com api_key: YOUR_JWT_BEARER_TOKEN monkeyscan: url: https://monkeyscan-ai.com api_key: YOUR_API_KEY agent-compose: url: https://agent-compose.example.com api_token: YOUR_API_TOKEN default_project: YOUR_PROJECT ``` 也可以把同样的配置放到环境变量或本地 `.env` 文件中。变量命名规则为 `<PRODUCT>_<FIELD>`： ```text cloudAtlas.url -> CLOUD_ATLAS_URL cloudAtlas.token -> CLOUD_ATLAS_TOKEN cloudAtlas.space_id -> CLOUD_ATLAS_SPACE_ID cloudwalker.url -> CLOUDWALKER_URL cloudwalker.api_key -> CLOUDWALKER_API_KEY tanswer.url -> TANSWER_URL tanswer.api_key -> TANSWER_API_KEY tanswer.timeout -> TANSWER_TIMEOUT tanswer.insecure -> TANSWER_INSECURE ddr.url -> DDR_URL ddr.api_key -> DDR_API_KEY ddr.company_id -> DDR_COMPANY_ID veinmind.url -> VEINMIND_URL veinmind.api_key -> VEINMIND_API_KEY xray.url -> XRAY_URL xray.api_key -> XRAY_API_KEY apisec.url -> APISEC_URL apisec.api_token -> APISEC_API_TOKEN dsensor.url -> DSENSOR_URL dsensor.api_key -> DSENSOR_API_KEY codeinsight.url -> CODEINSIGHT_URL codeinsight.access_token -> CODEINSIGHT_ACCESS_TOKEN 或 CODEINSIGHT_TOKEN codeforce.url -> CODEFORCE_URL codeforce.access_token -> CODEFORCE_ACCESS_TOKEN 或 CODEFORCE_API_KEY codeforce.account_type -> CODEFORCE_ACCOUNT_TYPE cosmos.url -> COSMOS_URL cosmos.api_key -> COSMOS_API_KEY safeline-ce.url -> SAFELINE_CE_URL safeline-ce.api_key -> SAFELINE_CE_API_KEY safeline-3.url -> SAFELINE_3_URL safeline-3.api_token -> SAFELINE_3_API_TOKEN safeline.url -> SAFELINE_URL safeline.api_key -> SAFELINE_API_KEY monkeyscan.url -> MONKEYSCAN_URL monkeyscan.api_key -> MONKEYSCAN_API_KEY agent-compose.url -> AGENT_COMPOSE_URL agent-compose.api_token -> AGENT_COMPOSE_API_TOKEN agent-compose.api_key -> AGENT_COMPOSE_API_KEY (alias of api_token) agent-compose.default_project -> AGENT_COMPOSE_DEFAULT_PROJECT ``` ### 全悉快速开始全悉命令使用 OpenAPI Token。可在全悉 Web 控制台的“系统管理 → Open API”创建 Token，再配置 `tanswer.api_key` 或 `TANSWER_API_KEY`。可使用 `--url`、`--api-key`、`--timeout`、`--insecure`；环境变量 `TANSWER_URL`、`TANSWER_API_KEY`、`TANSWER_TIMEOUT`、`TANSWER_INSECURE`；或 `config.yaml` 的 `tanswer.url`、`tanswer.api_key`、`tanswer.timeout`、`tanswer.insecure` 配置全悉连接。不要将 Token 提交到仓库。 ```bash chaitin-cli tanswer auth check chaitin-cli tanswer --help chaitin-cli tanswer manifest chaitin-cli tanswer system status chaitin-cli tanswer alarm overview --time today chaitin-cli tanswer asset list --page-size 10 ``` 全悉产品的命令、参数、示例、输出字段和写操作确认要求以安装后二进制的 `--help` 与 `chaitin-cli tanswer manifest` 为准。 #### 人工使用指引 - 使用本仓库源码时，可先阅读 [全悉 CLI 入门](./products/tanswer/README.md) 和 [全悉 CLI 命令索引](./products/tanswer/COMMAND_REFERENCE.md)，了解常见任务和安全示例。 - 仅安装了二进制时，先执行 `chaitin-cli tanswer --help`，再按领域或具体命令继续执行 `--help`；需要完整结构化契约时执行 `chaitin-cli tanswer manifest`。 - 查询命令可在确认目标环境后直接执行。语义写操作必须先使用 `--preview`，核对目标、影响和风险，再按运行时要求使用精确的 `--confirm` token。`tanswer api` 的 GET/HEAD 可直接执行；其他 HTTP 方法同样必须先预览并确认。 - 根级 `--dry-run` 不适用于 `tanswer`；全悉语义写操作和 raw API 的实际保护规则以对应命令的 `--help` 与 manifest 为准。 #### AI Agent 使用规则当任务涉及全悉时，使用 `chaitin-cli tanswer`，并遵循以下流程： 1. 首次连接先执行 `chaitin-cli tanswer auth check`。 2. 先执行 `chaitin-cli tanswer --help`；进入具体领域或不确定参数时，继续执行相应的 `--help`。 3. 需要机器可读的完整命令、参数、输出、风险和确认契约时，执行 `chaitin-cli tanswer manifest`。 4. 优先使用语义命令；只有当前版本没有对应语义命令、且用户已提供已知、已授权的 endpoint、方法和请求体时，才使用 `tanswer api`。不得猜测 RPC 方法、路径或请求体。 5. 语义写操作必须先使用 `--preview`；向用户说明目标、影响和风险，并等待用户对该次变更的明确确认后，才能使用命令 help 或 manifest 指定的精确 `--confirm` token。不能仅因已知 token 就自行执行。 6. `tanswer api` 的 GET/HEAD 可直接执行；非 GET/HEAD 请求默认只返回 preview。必须展示请求的方法、路径、query 和 body，等待用户对该次请求明确确认后，才可使用 `--confirm CONFIRM_TANSWER_RAW_API_WRITE` 发送请求。根级 `--dry-run` 不适用于 `tanswer`。 AI 使用已安装的全悉 CLI 时不依赖产品专属 README 或 skill；运行时 `--help` 和 `manifest` 是唯一的命令事实来源。 ### MonkeyScan MonkeyScan 支持对本地目录、源码压缩包或 GitHub 仓库发起全量安全扫描。首次使用时，先设置 MonkeyScan CLI API Key，再确认授权状态： ```bash chaitin-cli monkeyscan auth set-key chaitin-cli monkeyscan auth status ``` 也可以通过 `MONKEYSCAN_API_KEY` 环境变量提供 API Key；服务地址默认是 `https://monkeyscan-ai.com`，可通过 `MONKEYSCAN_URL` 覆盖。全量扫描支持目录、压缩包和 GitHub 仓库三种来源。添加 `--wait` 可等待任务完成并输出结果，添加 `--full` 可获取完整报告，`--output` 可将结果写入文件： ```bash chaitin-cli monkeyscan scan --path . --wait chaitin-cli monkeyscan scan --file ./source.zip --wait --full --output ./monkeyscan-report.md chaitin-cli monkeyscan scan --repo https://github.com/example/project --branch main chaitin-cli monkeyscan scan list chaitin-cli monkeyscan scan result TASK_GROUP_ID --full ``` ### Cloud Atlas Cloud Atlas 命令由内置 OpenAPI Schema 生成，认证使用 `TOKEN` 请求头。配置 `cloudAtlas.space_id` 后，查询命令会自动把它作为默认空间 ID；也可以通过根命令参数 `--space-id` 指定默认空间，或在具体子命令中用 `--space` 覆盖。 ```bash export CLOUD_ATLAS_URL=https://cloud-atlas.example.com/openapi export CLOUD_ATLAS_TOKEN=YOUR_TOKEN export CLOUD_ATLAS_SPACE_ID=YOUR_SPACE_ID chaitin-cli cloudAtlas asset ip list --status valid --page 1 --size 20 --output json chaitin-cli cloudAtlas exposure website list --status valid --page 1 --size 20 --output json chaitin-cli cloudAtlas risk vulnerability list --status open --page 1 --size 20 --output json ``` 常用命令分组包括 `asset`、`exposure`、`risk`、`intelligence`、`strategy` 和 `task`。完整参数以 `chaitin-cli cloudAtlas --help` 及对应子命令的 `--help` 为准。 APISec 常用查询不需要手动传内部 `scope`，优先使用语义化命令： ```bash # 查询站点资产 chaitin-cli apisec asset site list --query count=100 --query offset=0 --output json # 查询 API 资产 chaitin-cli apisec asset api list --query count=100 --query offset=0 --output json # 查询风险事件 chaitin-cli apisec risk event list --query count=20 --query offset=0 --output json ``` `apisec raw` 保留为高级入口，用于调用生成出的底层 API 操作；日常查询建议先运行 `chaitin-cli apisec --help` 或对应语义命令的 `--help`。 ### SafeLine-3 SafeLine-3 命令使用 OpenAPI Token，请在配置中填写 `safeline-3.api_token`，或设置 `SAFELINE_3_API_TOKEN`。 AI Agent 的 SafeLine-3 调用策略见 [`products/safeline3/agent-skill.md`](products/safeline3/agent-skill.md)。 ```bash chaitin-cli safeline-3 node-group list --output json chaitin-cli safeline-3 site list --type reverse-proxy --page 1 --page-size 20 --output json chaitin-cli safeline-3 policy-group list --page 1 --page-size 20 --output json chaitin-cli safeline-3 log attack list --start -24h --page 1 --page-size 20 --output json chaitin-cli safeline-3 raw request GET /api/v3/license ``` 创建、更新、删除等复杂请求优先使用实体命令的语义参数；复杂嵌套结构可使用对应的 `--payload-file`、`--application-file` 等文件入口。`raw request` 是兜底入口，可调用未封装的 `/api/v3/...` 接口。 ### Cosmos / AISOC 完整模块文档见 [`products/cosmos/README.md`](products/cosmos/README.md)。 Cosmos 通用 JSON-RPC 命令覆盖告警、日志、情报、封禁、资产、通知、运维、SOAR 和漏洞管理。根级 `--dry-run` 会打印脱敏后的请求摘要，不会发送请求。保存主机资产时，当前后端通常需要资产类型、分类和分组；`--asset_ip_type` 当前取值为 `1` 实际 IP、`2` 虚拟 IP： ```bash chaitin-cli cosmos asset search-host-asset --count 20 --offset 0 --raw chaitin-cli --dry-run cosmos asset save-host-asset \ --ip 10.0.0.1/32 \ --name demo-host \ --organization_id 1 \ --asset_ip_type 1 \ --category_ids '[{"id":41,"name":"Linux"}]' \ --group_id 1 \ --raw ``` ### SafeLine 企业版 AI 站点操作 SafeLine 企业版命令支持面向 AI/AISOC 调度的环境检查、证书查询/上传、站点创建预览、站点创建和回退删除。首版站点创建支持的部署模式： - `Software Reverse Proxy` - `Software Cluster Reverse Proxy` 推荐调度流程： ```bash chaitin-cli safeline inspect --indent chaitin-cli safeline site create capabilities --indent chaitin-cli safeline cert list --indent chaitin-cli safeline site create --check --name app-a --domain app.example.com --port 443 --ssl --cert-id 12 --upstream http://10.0.0.1:8080 --policy-group 3 --indent chaitin-cli safeline site create --yes --name app-a --domain app.example.com --port 443 --ssl --cert-id 12 --upstream http://10.0.0.1:8080 --policy-group 3 --indent chaitin-cli safeline site delete 123 --yes --indent ``` `.env` 示例： ```bash SAFELINE_URL=https://safeline.example.com SAFELINE_API_KEY=YOUR_API_KEY XRAY_URL=https://xray.example.com/api/v2 XRAY_API_KEY=YOUR_API_KEY ``` 优先级为 `flags > environment/.env > 识别后的 ./config.yaml > ~/.chaitin-cli/config.yaml`。如果 `./config.yaml` 不包含 chaitin-cli 产品名，会被视为其他项目配置并忽略。识别到本地配置时，不会再合并全局配置。可以通过根命令的 `-c` 或 `--config` 指定其他配置文件。这在切换多个产品实例或临时使用项目内配置时很有用，例如多个 SafeLine 环境： ```bash chaitin-cli -c ./configs/safeline-prod.yaml safeline stats overview chaitin-cli -c ./configs/safeline-staging.yaml safeline stats overview ``` 会创建或更新配置的命令默认遵循同样的路径选择：如果当前目录存在可识别的 `./config.yaml`，优先写入本地文件；否则写入 `~/.chaitin-cli/config.yaml`。显式使用 `-c` / `--config` 时，只写入指定文件。支持 dry-run 的命令可以使用根级别的 `--dry-run`： ```bash chaitin-cli --dry-run xray plan PostPlanFilter --filterPlan.limit=10 chaitin-cli --dry-run cosmos asset save-host-asset --ip 10.0.0.1/32 --name demo-host --organization_id 1 --asset_ip_type 1 --category_ids '[{"id":41,"name":"Linux"}]' --group_id 1 ``` ### CodeInsight 项目与任务 ```bash export CODEINSIGHT_URL=https://codeinsight.example.com export CODEINSIGHT_TOKEN=YOUR_ACCESS_TOKEN chaitin-cli codeinsight project create --name demo-java --language java chaitin-cli codeinsight repo-config create --name git-prod --repo-type git --git-provider gitlab --server-host https://git.example.com/group/demo.git --auth-type access_token --access-token GIT_TOKEN chaitin-cli codeinsight task create repo --project-name demo-java --task-name demo-repo --rule-set-name Corax-Java --repo-config-name git-prod --ref-type branch --ref-name main chaitin-cli codeinsight task result --task-id 12345 chaitin-cli codeinsight task result download --task-id 12345 --out ./reports/12345.json ``` ### CodeForce 项目与任务 ```bash export CODEFORCE_URL=https://codeforce.example.com export CODEFORCE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN export CODEFORCE_ACCOUNT_TYPE=admin chaitin-cli codeforce project create --name demo-app --repository-id repo-1 chaitin-cli codeforce project ai-employee model-options --project-id project-1 chaitin-cli codeforce project ai-employee create --project-id project-1 --type dev --name backend-dev-agent --enabled chaitin-cli codeforce project ai-dev create --project-id project-1 --employee-id employee-1 --title "Add repository health dashboard" --issue-url https://github.com/example/demo/issues/12 --branch feature/repo-health chaitin-cli codeforce audit native create git --repository-id repo-1 --source-ref branch:main --audit-rule-id 101 --task-name "main native audit" chaitin-cli codeforce code-management create --name demo-code-drop --version-description "2026-06 release" --file ./artifacts/demo.zip chaitin-cli codeforce repository create project --name demo-git --platform gitlab --repositories-url https://git.example.com/group/demo.git --token GIT_TOKEN chaitin-cli codeforce git-auth create --name github-personal --platform github --token GIT_TOKEN chaitin-cli codeforce denoise parse --type sast --report-file ./reports/sast.json chaitin-cli codeforce denoise create --type sast --name repo-noise-check --engineer-id engineer-1 --source-type repository --repository-name demo-repo --branch-or-tag main --report-file ./reports/sast.json chaitin-cli codeforce denoise result --task-id denoise-task-1 ``` 说明： - `account_type=admin|user` 走管理接口，适用于项目创建、AI 员工、AI 开发任务、原生审计、代码管理、项目仓库和 git-auth。 - `account_type=openapi` 走 CodeForce 对外 OpenAPI，适用于 `openapi whoami`、`denoise parse`、OpenAPI 方式的 `denoise create` 和部分结果查询。 - 如果当前令牌实际上是 OpenAPI key，管理接口命令会明确提示切换凭证类型，而不会伪造成功。 ## 项目结构 ```text main.go # 主入口、根命令、产品注册和 BusyBox 风格调用 config/ # 配置加载、环境变量/.env 覆盖和配置写入逻辑 products/<name>/ # 每个产品一个独立目录，包含命令和 API 客户端 products/<name>/cmd/ # 手写产品命令分组 products/<name>/client/ # 生成或封装的产品 API 客户端 skills/chaitin-cli/ # AI Agent Skill 和自动安装脚本 cmd/gen-cli/ # CLI 生成工具 Taskfile.yml # 构建、运行、检查和打包任务 .github/workflows/ci.yml # CI、跨平台打包和 GitHub Release 发布流程 ``` ## 添加新产品在 `products` 目录下新增产品实现新增产品检查清单： - 在 `main.go` 中导入产品包 - 在 `newApp()` 中通过 `a.registerProductCommand(...)` 注册命令 - 如果 `NewCommand()` 返回 `(*cobra.Command, error)`，需要在注册前处理错误 - 如果产品依赖 `config.yaml` 或根级运行时参数，在产品包里实现 `ApplyRuntimeConfig(...)`，并从 `main.go` 的 `wrapProductCommand()` 中调用 - 产品配置应在产品包内部从 `config.Raw` 解码，不要把产品字段解析逻辑塞进根命令 ## BusyBox 风格调用同一个二进制可以通过软链接，或者直接重命名后，以子命令名直接调用： ```bash task build ln -s ./bin/chaitin-cli ./chaitin ./chaitin ``` 等价于： ```bash ./bin/chaitin-cli chaitin ``` ## 开发仓库地址： ```bash git clone https://github.com/chaitin/chaitin-cli.git cd chaitin-cli ``` 环境准备： - Go 版本以 [`go.mod`](./go.mod) 为准 - 安装 [Task](https://taskfile.dev/) 后可使用 `task` 命令本地运行： ```bash go run . chaitin go run . safeline --help ``` 常用任务: ```bash task build task run:chaitin task fmt task lint task test task package GOOS=linux GOARCH=amd64 ``` 版本信息: - `task build` / `task package` 通过 `-ldflags "-X main.version=..."` 把版本注入二进制，默认取 `git describe --tags --always --dirty` 的结果。 - 需要指定版本时显式传入，例如 `task build VERSION=v1.2.3`。 - 未注入版本时（例如 `go run .`、直接 `go build`），命令回退到 Go 构建信息：对应到具体 commit 的未发布构建显示 `dev+<commit>`，通过 `go install <module>@<version>` 安装到正式 tag 时显示模块版本，都取不到时显示 `dev`。 - 校验方式：`task build VERSION=v0.0.0-test && ./bin/chaitin-cli version`。 ## 维护与反馈 - 主线分支：[`main`](https://github.com/chaitin/chaitin-cli/tree/main) - 版本发布：通过 [`GitHub Releases`](https://github.com/chaitin/chaitin-cli/releases) 提供跨平台安装包 - 发布流程：推送 `v*` tag 后由 GitHub Actions 自动测试、打包并创建 Release - 维护状态：当前持续维护，欢迎通过 PR 贡献产品命令、文档和 bugfix 需求建议和 Bug 反馈请通过 [GitHub Issues](https://github.com/chaitin/chaitin-cli/issues) 提交。提交前请先搜索已有 Issue，避免重复反馈。请勿在公开 Issue 中粘贴 API Key、Token、真实业务地址或其他敏感信息。 ## FAQ **安装后找不到 `chaitin-cli` 怎么办？** 确认安装目录是否在 `PATH` 中。macOS / Linux 安装脚本会优先安装到用户或系统 PATH 目录；如果当前 shell 未刷新，可以重新打开终端或使用脚本输出的完整路径运行。 **配置从哪里读取？** 默认优先读取当前目录中识别为 chaitin-cli 配置的 `./config.yaml`，否则读取 `~/.chaitin-cli/config.yaml`。优先级为 `flags > environment/.env > 识别后的 ./config.yaml > ~/.chaitin-cli/config.yaml`。根命令的 `-c` / `--config` 可以指定其他配置文件。 **自签名证书连接失败怎么办？** 部分产品命令提供 `--insecure` 参数，SafeLine 默认跳过 TLS 证书校验；不同产品行为可能不同，可先运行对应产品命令的 `--help` 查看支持的参数。 **如何发布新版本？** 在 `main` 上创建并推送 `v*` tag，例如 `v2605.0.0`，GitHub Actions 会自动构建跨平台包并发布到 Releases。

Chargement du README du dépôt…

Skills dans ce dépôt

Analystes en sécurité de l'information

1 catégories métier · 100% classifié

skill

métier

description

mis à jour

chaitin-cli

Analystes en sécurité de l'information

Use when running chaitin-cli commands to manage Chaitin security products: SafeLine WAF (site management, IP blocking, ACL, policy rules, attack logs), X-Ray vulnerability scanner (scan tasks, results, assets), CodeInsight (projects, repository configs, scan…

Langue du texte source : anglais

2026-08-03

Affichage de 1 skills collectés sur 1.

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/chaitin/chaitin-cli.