怎么装
一次装齐 按顺序执行 2 条
1
pi install git:gitea.vhkd.top/pi-hub/skill-interface@v0.1.4依赖2
pi install git:gitea.vhkd.top/pi-hub/x-social@v0.1.0本体Pi
pi install git:gitea.vhkd.top/pi-hub/x-social@v0.1.0装完跑 pi-skill x-social check。
先准备什么
twitter命令
X 的 GraphQL 后端；本技能通过它自己的 venv python 跑 scripts/xshim.py，见 PROTOCOL.md
uv tool install twitter-cli
uv命令
只用于装/定位 twitter-cli（uv tool dir）
brew install uv
sqlite3命令
login 读浏览器 cookie 库时用；只在 macOS 上有意义
不用装：macOS 自带
security命令
login 从钥匙串取「<浏览器> Safe Storage」口令；第一次会弹一次授权，点「始终允许」后不再打扰
不用装：macOS 自带
要先配什么
proxy
可选
访问 X 的代理；填 direct 表示强制直连（缺省不用填，会自己挑）
account
可选
默认用哪个账号；缺省用上次 use 的账号
常用命令
status | 自检：后端版本 / 登录态（账号、来源、新鲜度）/ 出口路径（直连或代理）/ 登录是否还有效 |
login | 从本机浏览器（Chrome/Edge/Brave）取一次 X 登录态并缓存；--profile 指定配置、--cookie 手工给、--use 顺便切成当前账号（已有别的账号时是「新增」不抢） |
accounts | 本机存了哪些 X 账号、当前用哪个（纯本地读取） |
use | 切换当前账号（切一次一直生效）；单次换账号用全局 --as <账号> |
setup | 写本技能配置：--proxy <值>（- 清空）、--account <账号>（默认账号）、--show 只看 |
watch | 登录态巡检：把存着的每个账号真跑一次，掉登录就报 auth 并逐条列出；--notify 只在出事时推手机（可挂定时任务） |
home | 关注推荐流；--latest 是按时间的那条，--max 限条数 |
search | 搜帖：关键词 + --latest/--from/--lang/--since/--has/--exclude 过滤 |
read | 看一条帖子 + 它的回复（--replies 限回复条数） |
user | 看某人资料（简介、粉丝数、帖子数） |
posts | 看某人最近的帖子 |
likes | 看自己点过的赞（X 2024 起对他人隐藏，只有自己看得到） |
bookmarks | 看我的收藏 |
followers | 看某人的粉丝列表 |
following | 看某人关注的账号列表 |
list | 看某个 X 列表（List）的时间线 |
article | 读长文（Article）全文 |
post会改状态 | 发帖（可带图）；默认只预览，--yes 才真发，发完回读确认在线 |
reply会改状态 | 回复某条帖子（可带图）；默认只预览，--yes 才真发 |
quote会改状态 | 引用某条帖子（可带图）；默认只预览，--yes 才真发 |
thread会改状态 | 连发一串（线程）：稿子按段落存文件、段落之间单独一行 ---，第一条是原帖、其余依次回复上一条；中途失败会说清发到哪了 |
delete会改状态 | 删除自己的帖子；默认只预览，--yes 才删，删完回读确认已不在 |
like | 点赞（可撤销） |
unlike | 取消点赞 |
retweet | 转帖（可撤销） |
unretweet | 撤销转帖 |
bookmark | 收藏（可撤销） |
unbookmark | 取消收藏 |
follow | 关注某人（可撤销） |
unfollow | 取关某人 |