--- name: v2ex description: 'Interact with V2EX (v2ex.com) — browse hot and latest topics, read topic details and replies, search posts, create topics, reply to discussions, thank posts, favorite topics/nodes, follow members, daily check-in. Use this skill whenever the user mentions V2EX, v2ex.com, wants to browse tech forum topics, read V2EX discussions, search V2EX posts, check V2EX notifications, create or reply to V2EX topics, or look up V2EX users/nodes. Also trigger when the user pastes a V2EX URL (e.g. v2ex.com/t/12345), mentions a V2EX node name, or asks about Chinese tech community discussions. Keywords: V2EX, v2ex, 论坛, 技术社区, 节点, 主题, 回复.' --- # V2EX Browse, search, read, and interact with V2EX — the creative workers' community. ## Skill Directory `` is the directory containing this SKILL.md file. Determine it ONCE at the start and reuse it. ## Setup (run FIRST — every time, before any operation) You MUST complete this setup before running any script. Do NOT skip this step. ```bash sig status v2ex 2>&1 ``` Check the JSON output fields `configured` and `valid`: - **`configured: false`** → run Provider Setup below. Do NOT proceed without completing it. - **`valid: false` (but configured: true)** → run `sig login v2ex`, then re-check. - **`valid: true`** → detect proxy (see below), then execute the user's request. ### Provider Setup 1. Read `/references/provider-config.yaml` 2. Append the provider block to `~/.sig/config.yaml` under `providers:` 3. Ask the user: "Do you need a proxy to access this site?" — if yes, add `networkProxy: ` under the provider in config.yaml 4. Run `sig login v2ex` (with `--network-proxy ` if proxy was specified) 5. Verify: run `sig status v2ex` again — must show `valid: true` before proceeding ### Proxy Detection (after provider is valid) ```bash grep -A15 "^\s*v2ex:" ~/.sig/config.yaml | grep networkProxy | awk '{print $2}' ``` If this outputs a URL, prefix ALL python3 commands with `HTTPS_PROXY= HTTP_PROXY=`. If using socks5, convert to socks5h for python (e.g. `socks5://...` → `socks5h://...`). If empty, no proxy needed. ## Running Scripts All scripts require setup to be completed first (see above). **Read operations** — use `sig run` to inject cookie (enables authenticated features): ```bash sig run v2ex -- bash -c 'python3 /scripts/v2ex_hot.py --cookie "$SIG_V2EX_COOKIE"' ``` **Write operations** — require `sig run` (cookie is mandatory): ```bash sig run v2ex -- bash -c 'python3 /scripts/v2ex_reply.py --cookie "$SIG_V2EX_COOKIE" --topic-id 12345 --content "Nice post!"' ``` Env var: `SIG_V2EX_COOKIE` **On auth error (401/403):** run `sig login v2ex` automatically (no user prompt), then retry. ## Scripts Reference All scripts are in this skill's `scripts/` directory. Run via Bash tool. ### Read Operations | Script | Purpose | Auth | | ----------------------- | ---------------------------------- | -------- | | `v2ex_hot.py` | Hot topics of the day | Optional | | `v2ex_latest.py` | Latest topics | Optional | | `v2ex_topic.py` | Topic detail + replies | Optional | | `v2ex_node.py` | Node info + topics, list nodes | Optional | | `v2ex_member.py` | Member profile + topics | Optional | | `v2ex_search.py` | Full-text search via SOV2EX | None | | `v2ex_notifications.py` | User notifications | Required | | `v2ex_profile.py` | Authenticated user profile/balance | Required | ### Write Operations | Script | Purpose | Auth | | ------------------ | --------------------------------- | -------- | | `v2ex_create.py` | Create a new topic | Required | | `v2ex_reply.py` | Reply to a topic | Required | | `v2ex_thank.py` | Thank a topic or reply | Required | | `v2ex_favorite.py` | Favorite/unfavorite topic or node | Required | | `v2ex_follow.py` | Follow/unfollow/block/unblock | Required | | `v2ex_daily.py` | Daily sign-in reward | Required | | `v2ex_append.py` | Append supplement to own topic | Required | ### v2ex_hot.py ``` --cookie COOKIE V2EX session cookie (optional) ``` ### v2ex_latest.py ``` --cookie COOKIE V2EX session cookie (optional) ``` ### v2ex_topic.py ``` --cookie COOKIE V2EX session cookie (optional) --id ID Topic ID (required) --page N Reply page number (default: 1) ``` ### v2ex_node.py ``` --cookie COOKIE V2EX session cookie (optional) --name NAME Node name (e.g., "python", "apple") --page N Page number for topic listing (default: 1) --list-all List all available nodes (flag) ``` ### v2ex_member.py ``` --cookie COOKIE V2EX session cookie (optional) --username NAME Member username (required) --include-topics Also fetch member's recent topics (flag) ``` ### v2ex_search.py ``` --query TEXT Search query (required) --size N Max results (default: 20) --sort FIELD Sort by: "sumup" (relevance, default) or "created" --node NAME Filter by node name (optional) --username NAME Filter by author (optional) ``` ### v2ex_notifications.py ``` --cookie COOKIE V2EX session cookie (required) --page N Page number (default: 1) ``` ### v2ex_profile.py ``` --cookie COOKIE V2EX session cookie (required) ``` ### v2ex_create.py ``` --cookie COOKIE V2EX session cookie (required) --node NAME Target node name (required, e.g., "python") --title TEXT Topic title (required) --content TEXT Topic body content (required) --syntax SYNTAX Content syntax: "default" or "markdown" (default: "default") ``` ### v2ex_reply.py ``` --cookie COOKIE V2EX session cookie (required) --topic-id ID Topic ID to reply to (required) --content TEXT Reply content (required) ``` ### v2ex_thank.py ``` --cookie COOKIE V2EX session cookie (required) --type TYPE "topic" or "reply" (required) --id ID Topic ID or Reply ID (required) ``` ### v2ex_favorite.py ``` --cookie COOKIE V2EX session cookie (required) --type TYPE "topic" or "node" (required) --id ID Topic ID or Node ID (required) --undo Unfavorite instead (flag) ``` ### v2ex_follow.py ``` --cookie COOKIE V2EX session cookie (required) --action ACTION "follow", "unfollow", "block", or "unblock" (required) --id ID Member numeric ID (required) ``` ### v2ex_daily.py ``` --cookie COOKIE V2EX session cookie (required) ``` ### v2ex_append.py ``` --cookie COOKIE V2EX session cookie (required) --topic-id ID Topic ID to append to (required) --content TEXT Supplement content (required) ``` ## Safety **Always show the user the content (title, body, node) and get explicit confirmation before calling `v2ex_create.py`, `v2ex_reply.py`, or `v2ex_append.py`.** These actions post publicly and cannot be easily undone. **`v2ex_thank.py` costs coins and is irreversible — confirm with the user first.** ## Key Concepts **Nodes** — V2EX organizes topics into nodes (like subreddits). Examples: `python`, `apple`, `jobs`, `create`, `programmer`, `shanghai`. Use `v2ex_node.py --list-all` to see all. **Once token** — V2EX uses a CSRF token called `once` for all write operations. The client extracts it automatically from HTML pages before each mutation. **Topic IDs** — Numeric IDs (e.g., `12345`). Found in URLs like `v2ex.com/t/12345`. Get from hot/latest/search results, then use with `v2ex_topic.py`. **Member IDs vs usernames** — Profiles use usernames, but follow/block actions require numeric member IDs. `v2ex_member.py` returns both. **Daily check-in** — V2EX awards coins for daily sign-in. Use `v2ex_daily.py` to redeem. **Search** — Uses the SOV2EX third-party search engine (sov2ex.com) which indexes V2EX content for full-text search. ## Error Handling | Error | Cause | Fix | | ---------------- | ---------------------------- | --------------------------------------------------- | | 403 Forbidden | Session expired / no cookie | Auto-run `sig login` (no user prompt needed), retry | | 302 Redirect | Not logged in | Check cookie is valid | | `ONCE_NOT_FOUND` | Failed to extract CSRF token | Session expired — auto-run `sig login`, retry | | `RATE_LIMITED` | Too many requests | Wait and retry | | `SEARCH_ERROR` | SOV2EX service unavailable | Try again later | ## Workflow Examples ### Browse hot topics 1. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_hot.py --cookie "$SIG_V2EX_COOKIE"'` ### Read a specific topic and its replies 1. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_topic.py --cookie "$SIG_V2EX_COOKIE" --id 12345 --page 1'` ### Search for topics 1. `python3 /scripts/v2ex_search.py --query "Docker 部署" --size 10` ### Create a new topic 1. **Show title/body/node to user and get confirmation** 2. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_create.py --cookie "$SIG_V2EX_COOKIE" --node python --title "Question about asyncio" --content "How do I..."'` ### Reply to a topic 1. Read the topic first: `sig run v2ex -- bash -c 'python3 /scripts/v2ex_topic.py --cookie "$SIG_V2EX_COOKIE" --id 12345'` 2. **Show reply to user and get confirmation** 3. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_reply.py --cookie "$SIG_V2EX_COOKIE" --topic-id 12345 --content "I think you should..."'` ### Check notifications 1. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_notifications.py --cookie "$SIG_V2EX_COOKIE"'` ### Daily check-in 1. `sig run v2ex -- bash -c 'python3 /scripts/v2ex_daily.py --cookie "$SIG_V2EX_COOKIE"'` ### Follow a member 1. Look up member: `sig run v2ex -- bash -c 'python3 /scripts/v2ex_member.py --cookie "$SIG_V2EX_COOKIE" --username livid'` 2. Follow: `sig run v2ex -- bash -c 'python3 /scripts/v2ex_follow.py --cookie "$SIG_V2EX_COOKIE" --action follow --id 1'`