zhijunio Article Read
Role: 读 — URL / PDF → Markdown for reading, citation, or archive. Scripts under scripts/; policy under references/.
Hard rules
- Quote URLs in shell.
- Repo text (non-PDF) → editor Read tool.
- Never invent body on fetch failure.
- Paywall/login wall → reject; see
references/cascade.md. - One mode per run unless user sequences (e.g. convert then summarize).
Modes
| Mode | User signals | Read |
|---|---|---|
| convert (default) | 读一下, 抓取, fetch URL | references/workflow.md |
| summarize | 摘要, 总结 + URL | references/summarize.md |
| save | 保存, save to file | references/output.md § save |
| preview | 预览, 太长 | references/output.md § length |
Workflow (convert)
- Intake —
references/workflow.md(classify input). - Route —
references/router.md→ domain refs if needed. - Fetch:
READ_ROOT="<path-to>/article-read"
bash "${READ_ROOT}/scripts/read.sh" "https://…"
- Deliver — wrapper in
references/output.md. - On failure —
references/vet.md+references/mcp-fallback.md.
Script surface
| Script | Purpose |
|---|---|
scripts/read.sh |
Main fetch |
scripts/save.sh |
stdin → ~/Downloads/{slug}.md |
scripts/pdf-extract.sh |
Local PDF text |
scripts/feishu-fetch.py |
Feishu Open API (needs creds) |
scripts/github-blob-to-raw.py |
GitHub blob → raw URL |
scripts/lib/common.sh |
Shared (sourced by read.sh) |
Deps: scripts/requirements.txt (requests for Feishu).
Validation
After editing scripts:
bash -n article-read/scripts/read.sh
bash -n article-read/scripts/save.sh
bash -n article-read/scripts/pdf-extract.sh
bash -n article-read/scripts/lib/common.sh
Smoke: bash article-read/scripts/read.sh "https://example.com" (expect fetch attempt or documented fallback).
Boundaries
| Use | Use instead |
|---|---|
| Single URL/PDF → MD | Multi-query writing research → article-write gather |
Citation / topic-learn sources/ |
Systematic topic mastery workspace → topic-learn |
| Optional summarize after fetch | Article drafting → article-write; codebase audit → codebase-audit |
| Repo text (non-PDF) → editor Read tool | Multi-platform排版导出 |
References
references/workflow.md— intake, modes, commandsreferences/router.md— decision treereferences/cascade.md— proxy tiers, paywallsreferences/domain-cn.md— 微信、飞书references/domain-stealth.md— JS / 反爬域名references/domain-github-pdf.md— GitHub、PDFreferences/mcp-fallback.mdreferences/output.mdreferences/summarize.mdreferences/vet.mdreferences/topic-sources.md