apitweet-cli

使用此技能当任务应通过运行 apitweet 命令完成，而非手动重写请求逻辑。

使用此技能的场景

• 用户希望安装或运行 apitweet CLI
• 用户希望配置 API 密钥、Cookie 或 auth_token
• 用户希望使用 --dry-run 测试或检查请求
• 用户希望调用支持的 Twitter/X apitweet 命令，包括用户、推文、文章、私信、个人资料、时间线、全球热门推文、搜索、关注者、关注对象、列表或关注操作
• 用户已知某个端点路径，并希望通过通用形式 apitweet <path> 调用

不要将此技能作为主要接口用于编辑 CLI 源代码本身的任务。

默认处理流程

1. 确认 CLI 已可用。
2. 确保有可用于读取请求的应用配置或 API 密钥。
3. 确保有可用于写入请求的已保存配置文件或显式 Cookie。
4. 优先使用便捷命令。
5. 仅在没有合适的便捷命令时，才退用 apitweet <path>。
6. 在执行真实写入操作前，除非用户明确要求，否则始终使用 --dry-run。

安装与运行

对于普通用户，推荐使用发布的 npm 包：

npm install -g apitweet-cli
apitweet --help

从本仓库运行时：

node ./bin/apitweet.js --help

开发过程中需要本地可执行文件时：

npm link
apitweet --help

需要 Node.js 18 或更高版本。

认证规则

• API 密钥来自 https://apitweet.com/dashboard。
• 对于一次性命令，APITWEET_KEY 或 --api-key 均可接受。
• CLI 还支持 APITWEET_BASE_URL 和 APITWEET_CONFIG_DIR。
• 对于重复使用，建议通过 auth apps add 保存应用配置。
• 对于写入操作，必须提供 --cookie 或已保存的配置文件。
• 如果请求写入操作但没有可用的配置文件或 Cookie，应停止并询问认证信息，而不是自行猜测。
• 默认情况下，CLI 在 ~/.apitweet/config.json 中读写持久化配置。
• 已保存的应用配置可包含 API 密钥，已保存的配置文件可包含 Cookie、auth_token 或 ct0，以明文 JSON 格式存储。
• 在共享机器或 CI 环境中，建议使用 --config-dir 或 APITWEET_CONFIG_DIR 来隔离凭证。

应用配置设置：

apitweet auth apps add --name prod --api-key "sk_1d90c878..."
apitweet auth apps use prod

从 Cookie 设置配置文件：

apitweet auth profiles add --name founder --cookie "ct0=...; auth_token=..."
apitweet auth profiles use founder

从 auth_token 设置配置文件：

apitweet auth cookie --auth-token "your_auth_token" --save-as founder

查看配置信息：

apitweet config show
apitweet config path

命令选择

优先使用便捷命令，例如：

apitweet --app prod about elonmusk
apitweet --app prod users elonmusk sama
apitweet --app prod search users "openai" --count 20
apitweet --app prod trending tweets --country "United States" --topic "Sports" --count 50
apitweet --app prod --profile founder article publish-md ./article.md --title "Launch Notes"
apitweet --app prod tweet lookup 1900000000000000000 --summary

当已知端点但未封装为便捷命令时，使用通用路径形式：

apitweet /api/twitter/elonmusk/about
apitweet -X POST -d '["elonmusk","sama"]' /api/twitter/users

安全与执行规则

• 将全局选项如 --app、--profile、--api-key 和 --dry-run 放在命令之前。
• 对于写入操作（如 tweet create、tweet like、user follow、list create 和 article publish-md），优先使用 --dry-run。
• 仅在用户明确要求执行后，才发送真实的写入请求。
• CLI 会在配置输出和 dry-run 预览中隐藏敏感信息，但仍避免将原始凭证回显给用户。
• auth cookie 使用包含 auth_token 的请求路径，因此需注意日志和追踪记录的安全性。
• 本地媒体文件上传功能尚未实现；推文创建支持 --media-url。

推荐测试流程

使用独立的配置目录进行本地测试：

apitweet --config-dir ./.apitweet-local config show

推荐顺序：

1. 通过 apitweet --help 或 node ./bin/apitweet.js --help 验证 CLI 是否正常启动。
2. 验证读取类命令，如 about 或 users。
3. 如有必要，验证原始路径请求。
4. 在任何真实写入操作前，使用 --dry-run 验证写入命令的构造。