# 松弛特工一种 TypeScript CLI 工具，使 AI 代理和人类能够通过简单的命令界面与 Slack 工作区进行交互。具有从 Slack 桌面应用程序无缝提取令牌和多工作空间支持的功能。 ## 快速入门 # 获取工作区快照（凭证会自动提取）代理松弛快照 # 发送消息 agent-slack 消息发送一般信息“来自 AI 代理的你好！” # 列出频道代理松弛通道列表 ## 身份验证首次使用时，会自动从 Slack 桌面应用程序中提取凭证。无需手动设置 - 只需运行任何命令，身份验证就会在后台静默进行。在 macOS 上，系统可能会首次提示您输入钥匙串密码（需要解密 Slack 存储的令牌）。这是一次性提示。 ### 多工作空间支持 # 列出所有经过身份验证的工作区代理松弛工作区列表 # 切换到不同的工作空间 agent-slack 工作空间开关 # 显示当前工作空间代理松弛工作区当前 # 删除工作区代理松弛工作空间删除 <工作空间 ID> # 检查授权状态代理松弛身份验证状态 ## 命令 ### 验证命令 # 从 Slack 桌面应用程序中提取令牌（通常是自动的）代理松弛身份验证提取代理松弛身份验证提取--调试 # 检查授权状态代理松弛身份验证状态 # 从工作区注销（默认为当前工作区）代理松弛身份验证注销 Agent-slack auth 注销 <工作空间 ID> ### 消息命令 # 发送消息代理松弛消息发送 <通道> <文本> 代理松弛消息发送一般“Hello world” # 发送线程回复 agent-slack 消息发送一般“回复”--thread # 列出消息代理松弛消息列表 <通道> 代理松弛消息列表常规 --limit 50 # 跨工作区搜索消息代理松弛消息搜索代理松弛消息搜索“项目更新” 代理松弛消息搜索“来自：@用户截止日期”--限制 50 代理松弛消息搜索“in：#general Meeting”--排序时间戳 # 根据时间戳获取单条消息代理松弛消息获取 <通道> 代理松弛消息获取常规 1234567890.123456 # 获取线程回复（包括父消息）代理松弛消息回复代理松弛消息回复常规 1234567890.123456 代理松弛消息回复一般 1234567890.123456 --limit 50 代理松弛消息回复常规 1234567890.123456 --oldest 1234567890.000000 agent-slack 消息回复一般 1234567890.123456 --cursor # 更新一条消息代理松弛消息更新

# 删除一条消息代理松弛消息删除 --force ### 通道命令 # 列出频道（默认情况下不包括存档）代理松弛通道列表代理松弛通道列表 --type public 代理松弛通道列表 --type private 代理松弛频道列表 --include-archived # 获取频道信息代理松弛通道信息 <通道> Agent-slack 通道信息常规 # 获取频道历史记录（消息列表的别名） agent-slack 通道历史记录 --limit 100 ### 用户命令 # 列出用户代理松弛用户列表代理松弛用户列表--include-bots # 获取用户信息代理松弛用户信息 <用户> # 获取当前用户代理松弛用户我 ### 反应命令 # 添加反应代理松弛反应添加代理松弛反应添加一般 1234567890.123456 点赞 # 删除反应代理松弛反应删除 # 列出对消息的反应代理松弛反应列表 ### 文件命令 # 上传文件 agent-slack 文件上传 <通道> <路径> agent-slack文件上传通用./report.pdf # 列出文件代理松弛文件列表 agent-slack 文件列表 --channel 常规 # 获取文件信息代理松弛文件信息 <文件 ID> ### 未读命令 # 获取所有频道的未读计数代理空闲未读计数 # 获取线程订阅详细信息 agent-slack 未读线程 # 将通道标记为已读至时间戳代理松弛未读标记 ### 活动命令 # 列出活动源（提及、反应、回复）代理松弛活动列表代理松弛活动列表 --limit 50 代理松弛活动列表--未读代理松弛活动列表--类型 thread_reply,message_reaction ### 已保存项目命令 # 列出已保存的项目代理 slack 已保存列表代理 slack 保存列表 --limit 10 ### 草稿命令 # 列出所有草稿代理松弛草稿列表代理松弛草稿列表--pretty ### 通道部分命令 # 列出频道部分（侧边栏组织）代理松弛部分列表代理松弛部分列表--pretty ### 快照命令获取 AI 代理的全面工作区状态： # 完整快照代理松弛快照 # 过滤后的快照代理松弛快照 --仅限通道代理松弛快照--仅限用户 # 限制每个通道的消息数代理松弛快照--限制 10 返回 JSON： * 工作区元数据 * 频道（ID、名称、主题、目的） * 最近消息（ts、文本、用户、频道） * 用户（ID、姓名、个人资料） ## 输出格式 ### JSON（默认）所有命令默认输出 JSON 以供 AI 使用： { "ts": "1234567890.123456", “文本”：“你好世界”， “频道”：“C123456” } ### 漂亮（人类可读）使用“--pretty”标志进行格式化输出：代理松弛频道列表--pretty ## 常见模式请参阅“references/common-patterns.md”了解典型的 AI 代理工作流程。 ## 模板请参阅“templates/”目录以获取可运行的示例： * `post-message.sh` \- 发送带有错误处理的消息 * `monitor-channel.sh` \- 监视新消息的通道 * `workspace-summary.sh` \- 生成工作区摘要 ## 错误处理所有命令返回一致的错误格式： { “错误”：“没有经过身份验证的工作区。运行：agent-slack auth extract” } 常见错误： * `NO_WORKSPACE`：没有经过身份验证的工作区（自动提取失败 - 请参阅故障排除） * `SLACK_API_ERROR`：Slack API 返回错误 * `RATE_LIMIT`：达到 Slack 速率限制（带退避功能的自动重试） ## 配置凭证存储在：`~/.config/agent-messenger/slack-credentials.json` 格式： { “当前工作空间”：“T123456”， “工作空间”：{ “T123456”：{ "workspace_id": "T123456", "workspace_name": "我的工作空间", "token": "xoxc-...", "cookie": "xoxd-..." } } } **安全**：文件权限设置为 0600（所有者只读/写） ## 限制 * 无实时事件/套接字模式 * 无频道管理（创建/存档） * 没有工作区管理操作 * 没有预定消息 * 无用户存在功能 * 仅纯文本消息（v1 中无块/格式） ## 故障排除 ### 身份验证失败或未找到工作区凭证通常是自动提取的。如果自动提取失败，请使用调试输出手动运行它：代理松弛身份验证提取--调试常见原因： * Slack 桌面应用程序未安装或未登录 * macOS 钥匙串访问被拒绝（重新运行并批准提示） * Slack是通过使用不同存储路径的方法安装的 ### `agent-slack：找不到命令` **`agent-slack` 不是 npm 包名称。** npm 包是 `agent-messenger`。如果全局安装包，则直接使用“agent-slack”：代理松弛消息列表常规如果未安装该软件包，请使用“bunx agent-messenger slack”（注意：“slack”子命令，而不是“agent-slack”）： Bunx agent-messenger slack 消息列表常规 **永远不要运行 `bunx agent-slack`** — npm 上存在一个名为 `agent-slack` 的单独的、不相关的 npm 包。它将使用不同（更少）的命令静默安装**错误的软件包**。 ## 参考文献 * [认证指南]() * [常见模式]()

斯莱克特工

包含技能