codingsamss/linuxdo

LINUX DO Skill (Read-Only)

通过本地 Python 脚本只读访问 LINUX DO（linux.do）论坛内容。使用 Discourse JSON API + Chrome Cookie 自动提取认证，可访问有信任等级限制的帖子。

Prerequisites

1. Python3 可用。
2. macOS 系统（Chrome Cookie 自动提取依赖 Keychain + CommonCrypto）。
3. Chrome 已登录 linux.do（首次使用时系统会弹出 Keychain 授权对话框，请点击"允许"）。
4. 如网络环境受限，建议配置代理：
   • 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 来源：

1. --cookie "name=value; ..." 命令行直传
2. --cookie-file <path> 或环境变量 LINUXDO_COOKIE_FILE
3. 环境变量 LINUXDO_COOKIE
4. Chrome Cookie 自动提取（macOS 默认，零配置）
5. 无认证（仅可访问公开内容）

手动回退（当 Chrome 提取失败时）：

# 从浏览器 DevTools > Application > Cookies 复制 Cookie 字符串
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

# urllib 和 curl 均会使用该代理

Important Notes

• 本 skill 仅开放只读能力，不包含发帖、回帖、点赞等写操作。
• Chrome Cookie 提取仅支持 macOS（依赖 Keychain + CommonCrypto）。
• 首次使用时系统会弹出 Keychain 授权对话框，选择"允许"即可。
• 若命中 Cloudflare 风控，脚本会自动回退到 curl 请求。

Excluded Actions (Write Operations)

以下操作不开放：

• 发帖 / 回帖 / 编辑帖子
• 点赞 / 收藏 / 标记
• 用户设置修改
• 任何 POST/PUT/DELETE 请求