# slack-rs - Slack Web API CLI (Rust) 使用“slack-rs”使用您自己的 OAuth 凭据与 Slack 工作区进行交互。它支持多个配置文件（工作区/应用程序），将凭据存储在“~/.config/slack-rs/”下的基于文件的存储中，并且可以调用任何 Slack Web API 方法。 ## 安装从 crates.io 安装（推荐）：货物安装 slack-rs 从源代码构建： git 克隆 https://github.com/tumf/slack-rs.git cd slack-rs 货物构建--发布 ./target/release/slack-rs --help 或者从本地结帐安装：货物安装--路径。 ## OAuth 设置（每个 Slack 应用程序一次）创建 Slack 应用程序并配置 OAuth。推荐的登录流程（尤其是远程/SSH 环境）：使用 `--cloudflared`。在这种模式下，“slack-rs auth login”会为您生成一个 Slack App Manifest YAML（并将其复制到剪贴板，尽最大努力）。 1. 前往并创建一个应用程序。 2. 从“基本信息”->“应用程序凭据”复制您的 Client ID 和 Client Secret。 3. 要么： * 使用清单流 (`--cloudflared`) 并将生成的 YAML 粘贴到 Slack 中，或者 * 手动配置 OAuth（替代）： * 在“OAuth & Permissions”下，添加重定向 URL：`http://127.0.0.1:8765/callback` * 为您的用例添加所需的“用户令牌范围” 建议：存储每个配置文件的 OAuth 配置（客户端密钥安全地存储在文件存储中）。 slack-rs config oauth 设置 my-workspace \ --客户端 ID 123456789012.1234567890123 \ --redirect-uri http://127.0.0.1:8765/callback \ --scopes“聊天：写入，用户：读取，频道：读取” 您可以使用“--scopes“all””进行广泛的预设，或使用“--bot-scopes”和“--user-scopes”标志进行自定义。常见范围： * `chat:write` \- 发布消息 * `users:read` \- 查看用户 * `channels:read` \- 列出公共频道 * `search:read` \- 搜索工作区内容 * `reactions:write` \- 添加/删除反应完整列表： ## 身份验证（每个配置文件） slack-rs 身份验证登录我的工作区 slack-rs 身份验证状态我的工作区 slack-rs 身份验证列表远程/SSH 环境（推荐）： slack-rs 身份验证登录 my-workspace --client-id 123456789012.1234567890123 --cloudflared 注意：检查“slack-rs auth login --help”以获取当前隧道支持（例如“--cloudflared”、“--ngrok”）。登录期间，CLI 打开浏览器进行 OAuth 授权并存储： * `~/.config/slack-rs/profiles.json` 中的配置文件元数据 * `~/.config/slack-rs/` 下文件中的 OAuth 配置和令牌（视为机密）安全说明：“~/.config/slack-rs/”包含 OAuth 凭据（客户端密钥和访问令牌）。将其视为敏感。 ## 调用 API 对 Slack Web API 支持的任何内容使用通用 API 调用： slack-rs api 调用 users.info user=U123456 slack-rs api调用conversations.list limit=200 slack-rs api调用conversations.history通道=C123456限制=50 slack-rs api 调用 chat.postMessage Channel=C123456 text="Hello from slack-rs" ### 统一输出包络默认情况下，命令输出统一的结构： { “元”：{ "profile_name": "默认", "method": "conversations.list", "command": "api 调用", “token_type”：“用户” }, “响应”：{ “好的”：正确的， “频道”：[] } } 要获取原始 Slack Web API 响应（不带信封），请使用 `--raw`： slack-rs api调用conversations.list --raw ### 选择机器人还是用户令牌如果您的 Slack 应用程序同时具有机器人令牌和用户令牌，请为每个配置文件设置默认令牌类型： slack-rs 配置集 my-workspace --token-type 用户 slack-rs 配置集 my-workspace --token-type bot 确认： slack-rs 身份验证状态我的工作区有关更多可复制/粘贴的食谱，请参阅“slack-rs/references/recipes.md”。 ## 自省（命令/帮助/模式）使用这些命令来了解 CLI 可以做什么以及如何调用它（机器可读）： slack-rs 命令--json slack-rs 转换列表 --help --json slack-rs 消息帖子 --help --json slack-rs schema --command msg.post --output json-schema slack-rs schema --command conv.list --output json-schema slack-rs schema --command api.call --output json-schema ## 对话助手对于常见任务，请使用便捷命令而不是“api 调用”： slack-rs 转换列表 slack-rs 转换搜索 slack-rs 转换历史记录注意事项： * 命令名称接受点和空格格式（例如 `conv.list` == `conv list`、`msg.post` == `msg post`）。 * `schema` 描述默认封装的 JSON 输出；它不描述“--raw”输出。 * `meta` 是一个基线信封，并不详尽；随着时间的推移，可能会添加其他字段。 * `conv list` 支持 `--filter`、`--format` 和 `--sort` （请参阅 `slack-rs conv list --help`）。 * `conv select` 和 `conv History --interactive` 需要交互式终端 (TTY)。示例输出（`slack-rs schema --command msg.post --output json-schema`）： { “架构版本”：1， “类型”：“模式”， “好的”：正确的， "command": "msg.post", “架构”：{ "$schema": "http://json-schema.org/draft-07/schema#", “类型”：“对象”， “属性”：{ “架构版本”：{ “类型”：“整数”， "description": "架构版本号" }, “类型”：{ “类型”：“字符串”， "description": "响应类型标识符" }, “好的”：{ “类型”：“布尔值”， "description": "表示操作是否成功" }, “响应”：{ “类型”：“对象”， "description": "Slack API 响应数据" }, “元”：{ “类型”：“对象”， "description": "有关请求和配置文件的元数据", “属性”：{ “个人资料”：{“类型”：“字符串”}， "team_id": {"type": "string"}, "user_id": {"type": "string"}, “方法”：{“类型”：“字符串”}， “命令”：{“类型”：“字符串”} } } }, “必需”：[“schemaVersion”，“类型”，“确定”] } } ## 写操作的安全默认值许多 Slack 方法都是写操作（发布、更新、删除、反应）。在存在写入风险的环境中使用防护：导出 SLACKCLI_ALLOW_WRITE=false 当您打算写入时显式重新启用：导出 SLACKCLI_ALLOW_WRITE=true ## 配置文件备份/迁移使用加密文件导出/导入配置文件（视为机密）： # 提示输入密码（推荐） slack-rs auth 导出 --all --out all-profiles.enc --passphrase-prompt slack-rs auth import --all --in all-profiles.enc --passphrase-prompt 对于非交互式自动化选项，请参阅“slack-rs auth export --help”和“slack-rs auth import --help”。 ## 配置常用环境变量： * `SLACKCLI_ALLOW_WRITE`：允许/拒绝写入操作（默认：允许） * `SLACK_OAUTH_BASE_URL`：自定义 OAuth 基本 URL（测试/企业 Slack）对于导出/导入密码选项，请使用 `--passphrase-prompt` 或参阅 `slack-rs auth export --help`。 ## 故障排除 * 远程环境：使用隧道 (ngrok/cloudflared) 并相应地设置您的个人资料重定向 URI。 ### 私人频道缺失私人频道通常需要用户令牌。确保： 1. `slack-rs config set --token-type user` 2.您的 Slack 应用程序具有用户范围（`groups:read`、`groups:history` / `conversations:read` 等） ## 有用的命令档案管理： slack-rs 身份验证列表 slack-rs 身份验证状态 <配置文件> slack-rs auth 重命名 <旧> <新> slack-rs auth 注销 <配置文件> OAuth 配置管理： slack-rs config oauth show <配置文件> slack-rs config oauth 删除 <配置文件>

松弛卢比

包含技能