用途：II-Commons 为研究型智能体提供跨 arXiv、PubMed/PMC 及受支持美国政策语料库的确定性检索，适合需要可复现搜索、元数据查询、全文 Markdown 获取，或在回答前检查语料新鲜度的任务。
主要能力：支持按语料库搜索（arxiv 用于预印本与技术研究，pubmed 用于生物医学与临床文献，policy 用于受支持的美国政策语料库）；支持服务端日期过滤（如 --start、--end）；可查询稳定标识符的元数据与全文 Markdown；提供 cutoff 命令作为各语料库的权威新鲜度边界。
使用方式：先运行 npx @intelligentinternet/ii-commons cutoff 检查新鲜度，再执行搜索，例如 npx @intelligentinternet/ii-commons search arxiv "large language model inference" --max-results 10、npx @intelligentinternet/ii-commons search pubmed "type 2 diabetes review" --start 20240000 --max-results 10、npx @intelligentinternet/ii-commons search policy "state overtime rule for agricultural workers" --jurisdictions US-CA --max-results 10。检索后用稳定标识符获取元数据或 Markdown，例如 npx @intelligentinternet/ii-commons meta "arXiv:2402.03578"、npx @intelligentinternet/ii-commons markdown "PMCID:PMC11152602"。安装可用 npx @intelligentinternet/ii-commons --help，或 npm install -g @intelligentinternet/ii-commons。当查询来自用户提示时，应通过 runner API 以参数数组传入，而非拼接进 shell 字符串。
适用场景：跨科学文献与政策文件比较证据；需要最新研究且语料新鲜度重要时；需要稳定标识符、元数据或全文 Markdown 供下游分析时。
限制：需要 Node.js 18 或更新版本，并能访问 commons.ii.inc；基础使用无需认证，更高用量限制可能需要来自 https://commons.ii.inc/ 的 API 令牌；政策覆盖仅限 II-Commons 暴露的语料库。不要打印或暴露 II_COMMONS_API_KEY；输出应视为检索证据而非专家评审，医疗、法律或政策敏感工作需引用来源并保留不确定性；运行前确认环境允许外部网络访问。