| name | linuxdo |
| description | Read LINUX DO forum content via Discourse JSON API + Chrome Cookie auth. Actions: check login, latest topics, top/trending, full-text search, read topic details, browse categories. Keywords: linuxdo, linux.do, l站, 帖子, 搜索, 最新, 热门, 分类, discourse, forum. |
LINUX DO Skill (Read-Only)
通过本地 Python 脚本只读访问 LINUX DO（linux.do）论坛内容。使用 Discourse JSON API + Chrome Cookie 自动提取认证，可访问有信任等级限制的帖子。
Prerequisites
- Python3 可用。
- macOS 系统（Chrome Cookie 自动提取依赖 Keychain + CommonCrypto）。
- Chrome 已登录 linux.do（首次使用时系统会弹出 Keychain 授权对话框，请点击"允许"）。
- 如网络环境受限，建议配置代理：
HTTPS_PROXY=http://127.0.0.1:7897
Script Path
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
SCRIPT="${CODEX_HOME}/skills/linuxdo/scripts/linuxdo.py"
Cookie Authentication
脚本按优先级自动解析 Cookie 来源：
--cookie "name=value; ..." 命令行直传--cookie-file <path> 或环境变量 LINUXDO_COOKIE_FILE- 环境变量
LINUXDO_COOKIE
- Chrome Cookie 自动提取（macOS 默认，零配置）
- 无认证（仅可访问公开内容）
手动回退（当 Chrome 提取失败时）：
python3 "$SCRIPT" --cookie "_t=xxx; _forum_session=yyy" latest --limit 5
Commands
1. 查看登录身份
Triggers: "linuxdo 登录状态", "linuxdo whoami", "l站身份"
python3 "$SCRIPT" whoami
2. 查看最新帖子
Triggers: "linuxdo 最新帖子", "l站最新", "latest linuxdo"
python3 "$SCRIPT" latest --limit 20
可选参数：
--page <n>：翻页（从 0 开始）--chars <n>：摘要最大字符（默认 140）
3. 查看热门帖子
Triggers: "linuxdo 热门", "l站热帖", "linuxdo top", "l站 trending"
python3 "$SCRIPT" top --period weekly
可选参数：
--period：daily / weekly / monthly / yearly / all（默认 weekly）--limit <n>：输出条数（默认 20）
4. 搜索帖子
Triggers: "搜索 linuxdo", "linuxdo 搜索", "search linuxdo", "l站搜索"
python3 "$SCRIPT" search "Claude Code" --limit 10
说明：
- 使用 Discourse 原生 search.json 全文搜索
- 支持 Discourse 搜索语法：
@username、#category、in:title、order:latest 等
- 同时返回匹配主题和匹配回帖
5. 查看帖子详情
Triggers: "查看 linuxdo 帖子", "读帖", "linuxdo topic", "看看这个帖子"
python3 "$SCRIPT" topic 1611298 --posts 5
也支持：
topic "https://linux.do/t/topic/1611298"topic "topic/1611298"
可选参数：--posts <n>：输出楼层数（默认 5）--chars <n>：每条内容最大字符（默认 300）--page <n>：楼层翻页（默认 0）
6. 浏览分类
Triggers: "linuxdo 分类", "l站分类", "linuxdo categories"
列出所有分类：
python3 "$SCRIPT" category
查看某分类帖子：
python3 "$SCRIPT" category develop --limit 20
内置分类映射（slug -> 中文名）：
develop 开发调优 | domestic 国产替代 | resource 资源荟萃wiki 文档共建 | job 非我莫属 | reading 读书成诗news 前沿快讯 | feeds 网络记忆 | welfare 福利羊毛gossip 搞七捻三 | square 虫洞广场 | feedback 运营反馈
Proxy Configuration
HTTPS_PROXY=http://127.0.0.1:7897 python3 "$SCRIPT" latest --limit 5
Important Notes
- 本 skill 仅开放只读能力，不包含发帖、回帖、点赞等写操作。
- Chrome Cookie 提取仅支持 macOS（依赖 Keychain + CommonCrypto）。
- 首次使用时系统会弹出 Keychain 授权对话框，选择"允许"即可。
- 若命中 Cloudflare 风控，脚本会自动回退到 curl 请求。
Excluded Actions (Write Operations)
以下操作不开放：
- 发帖 / 回帖 / 编辑帖子
- 点赞 / 收藏 / 标记
- 用户设置修改
- 任何 POST/PUT/DELETE 请求
