一句话回答：ppcli 怎么用——先跑
opencli doctor检查环境，再用opencli list看当前支持哪些平台命令；每个平台命令都遵循「平台名 + 子命令 + 参数」的结构，比如opencli xiaohongshu feed、opencli bilibili hot --limit 5；登录态直接复用你已经打开的 Chrome，不需要单独填账号密码。装完到能跑通第一条命令，通常 5 分钟以内。
装完 npm install -g @jackwener/opencli，敲一句 opencli --help，跳出来几十行命令，平台名、子命令、参数一大堆，人是懵的。这是这两周在几个技术群里被问得最多的问题：这东西到底该怎么用，是不是装完就能自动发小红书了。
为什么装完不知道从哪下手
ppcli（也就是 opencli，PublishPort 维护着它的一份分支）不是一个「一条命令搞定一件事」的工具，它更像一整套平台适配器的集合：小红书、B 站、知乎、Twitter/X、Reddit、HackerNews 等上百个网站，每个都被封装成了自己的子命令。这带来的好处是覆盖面广，坏处是你打开 --help 看到的是一整棵命令树，不知道自己要的那一支在哪。
真实的踩坑经验是：大多数人卡住不是因为命令语法难，而是因为不知道该先跑哪条命令去确认环境是通的。跳过这一步直接去跑发布类命令，失败了也搞不清是环境问题还是账号问题。
装完第一步：别急着发内容，先确认环境通了
顺序建议是这样：
opencli doctor：检查 Node 版本（要求 ≥20）、浏览器桥接扩展是否装好、守护进程是否在跑。这一步会把大部分「命令跑不起来」的环境问题提前暴露。opencli list：看当前版本实际支持哪些平台和子命令，不同版本收录的平台数量会变，别对着旧教程猜。- 挑一个只读命令跑通：比如
opencli zhihu hot -f json或opencli bilibili hot --limit 5，先验证「读」这条链路是通的，比一上来就跑发布类命令风险小得多。 - 再碰跟账号相关的命令：小红书的
feed、notifications这类需要登录态的命令，前提是你在同一台机器的 Chrome 里已经登录着对应账号——ppcli 不会另存一份密码，它读的是浏览器里现成的会话。
跑通这四步，比对着一份写满命令的文档从头背到尾有用得多。
常用命令怎么写：按平台看几个真实例子
不同平台的子命令名字不完全一样，但结构是一致的：opencli <平台> <动作> [参数] [-f 格式]。几个高频场景：
- 小红书：
opencli xiaohongshu search "关键词"搜索笔记，opencli xiaohongshu feed看首页推荐，opencli xiaohongshu comments <笔记链接>拉评论。 - B 站：
opencli bilibili hot --limit 10拉热门榜，opencli bilibili video <BV号>看视频详情，opencli bilibili download <BV号> --output ./bilibili下载。 - 知乎：
opencli zhihu hot看热榜，opencli zhihu question <问题链接>拉某个问题下的回答。
输出格式用 -f 切：-f table 是默认的终端友好格式，-f json 方便脚本/程序读取，-f csv 方便丢进表格，-f md 方便直接粘进文档。想接自己写的脚本或者喂给 AI 处理，优先用 -f json。
具体到某个平台还支持哪些参数，opencli <平台> --help 永远是最新的。命令行版本迭代快，教程里的参数名可能过时，--help 不会骗你。
--help 就是 schema：这决定了它怎么被 AI 用起来
这里有个容易被忽略的点：ppcli 每个命令自带的 --help 输出，本身就足够详细到可以当参数说明书用。这意味着如果你想让 AI（Claude、Cursor 之类）来操作它，不需要单独写一层「工具描述文件」去告诉 AI 每个参数是什么意思——AI 自己执行一次 --help 就能读懂。
这也是 PublishPort 接入 ppcli 时选的路子：不给 AI 塞一堆 per-平台的封装接口，只暴露两个入口——local_bash 执行任意命令、list_capabilities 告诉 AI 当前机器上有哪些工具能用。AI 想用小红书能力，自己跑 opencli xiaohongshu --help 查怎么调，再用 local_bash 执行。好处是接一个新平台不需要重新设计一层适配层，上游 CLI 加了新命令，AI 立刻能用。这个思路在 MCP 内容发布服务器到底是怎么工作的 里写过实现细节。
想让云端 AI 真正跑起来：命令行本身不是终点
跑通命令是第一步，但很多人卡在下一步：AI 助手在云端，你的 Chrome 登录态、ppcli 命令都在本地机器上，怎么让两边接上。
直接的做法是装一个 GUI 客户端做本地守护进程，把 SSH 中转接进来，让云端的 AI 通过一个受鉴权保护的通道，在你本机执行 local_bash。命令实际执行的位置还是你自己的电脑、自己的浏览器、自己的登录态——不是把账号密码上传到某个第三方服务器代发。这也是为什么本地真实环境比纯云端自动化更稳的原因，之前写过详细对比。
这条链路装起来的入口在 publishport.app/download，配好之后 AI 就能直接用你机器上的 ppcli 去搜索、发布、回评论，不用你自己再写一层胶水代码。
安全与边界：账号在你手里，凭证保管也在你手里
ppcli 的账号安全模型是「复用浏览器已登录的会话，密码不外传」——这个设计本身是靠谱的，凭证不会被 ppcli 存成明文文件。但把它接进云端 AI 之后，多了一层新的东西要保管：中转鉴权的 token。这个 token 如果泄露，等同于把这台机器的命令执行权限交出去，所以它要跟你的账号密码一样当成敏感信息保管，别贴到公开的聊天记录或者仓库里。
另外要说清楚的是：ppcli 能帮你把「发布」这个动作自动化，但内容本身是否符合平台规则，责任还在使用者这边。有开发者实测过直接自动发布小红书，笔记因为违规被平台直接删掉，后来改成了先落地到本地文件夹人工审核再发，这是更稳妥的做法。没有任何工具能保证「绝对不违规、绝对不限流」，按真人的节奏发、遵守平台规则，永远比追求全自动更省心。
常见问题 / FAQ
opencli 免费吗？
免费开源，基于 Node.js，npm install -g @jackwener/opencli 直接装。运行时不消耗额外的 token 或调用额度，本地跑多少次都不产生这部分费用，唯一的成本是你自己接的 AI 模型调用费用（如果你用 AI 来驱动它的话）。
opencli 安全吗，会不会存我的账号密码？
不会另存密码。它复用你 Chrome 里已经登录的会话，凭证始终留在浏览器本地，通过浏览器扩展和本地守护进程通信，不经过第三方服务器转发。真正需要额外保管的是接入云端 AI 时用到的中转鉴权 token，这个要自己保管好。
opencli 支持哪些平台？
覆盖小红书、B 站、知乎、Twitter/X、Reddit、HackerNews、微博、雪球等上百个站点，每个平台的具体命令以 opencli list 当前输出为准，版本更新会增加新平台，别对着旧文档的清单数数。
opencli 和用浏览器插件类工具（比如 OpenClaw）自动发布小红书有什么区别？
opencli 本身是「把网站变成命令行接口」的底层能力，你可以直接敲命令用，也可以被别的编排工具（包括 AI agent）当作执行层调用。像 OpenClaw 这类工具是在它之上再搭一层多 agent 编排逻辑，负责选题、写文案、决定什么时候调用发布命令。两者不是互斥关系，一个是执行层、一个是决策层。
AI 能不能直接帮我用 ppcli 自动发布内容？
技术上可以，但更稳妥的做法是先只跑读命令（搜索、拉数据），发布类命令留一步人工确认，尤其是内容还没摸清平台规则的阶段。有开发者的真实经验是直接全自动发布导致笔记因违规被删，改成人工审核后再发的做法明显更稳。
命令跑不起来该先查什么？
先跑 opencli doctor 看环境哪里没配好，八成是 Node 版本不够、浏览器桥接扩展没装，或者对应平台账号在 Chrome 里没登录。这一步能排掉大多数「命令报错」类问题，再去纠结具体参数写法。