by 运行时依赖
安装命令
点击复制技能文档
weread-导入
通过 scripts/运行.sh 运行 命令行工具。首次执行时会自动安装依赖。
默认策略 默认使用官方 Gateway 后端，需要环境变量 WEREAD_API_KEY。 WEREAD_API_KEY 获取路径：打开微信读书 应用 最新版 -> 我的 -> 右上角设置按钮 -> 微信读书 技能 -> 快速配置第 2 步 -> 获取 API Key。 未配置 WEREAD_API_KEY 时，提示用户配置并复述获取路径，同时展示 Gateway、受管浏览器、外部 Chrome、手动 Cookie 四种可选路径；不要自行切换到 Cookie。 Gateway 已配置但网络失败、HTTP 5xx、网关不可达或接口不支持时，自动回退 网页 后端。 用户显式传入 --cookie-from 或 --cookie 时，视为老用户旧链路，自动使用 网页 后端；若显式 --API-backend gateway，则 Gateway 优先并忽略 cookie 参数。 修改模板、合并逻辑或 frontmatter 后，先输出到临时目录验证。 验证通过后，再对真实目录执行。 目的是重新渲染或验证时，加上 --force 跳过增量检查。
详细命令模板见 references/工作流s.md。
推荐命令 # 导入单本书 bash ./scripts/运行.sh --book "自卑与超越" --输出 "/path/to/Reading"
# 导入全部书 bash ./scripts/运行.sh --all --输出 "/path/to/Reading"
# 强制重新渲染 bash ./scripts/运行.sh --book "自卑与超越" --输出 "/path/to/Reading" --force
# 覆盖 frontmatter tags bash ./scripts/运行.sh --book "自卑与超越" --输出 "/path/to/Reading" --tags "reading/weread,book"
# 明确不使用官方 Gateway，改用旧浏览器/Cookie 链路 bash ./scripts/运行.sh --all --no-gateway --cookie-from browser-managed --输出 "/path/to/Reading"
代理 决策表 场景 行为 新用户 / 常规导入 使用默认 Gateway 命令：bash ./scripts/运行.sh --all --输出 "/path/to/Reading" 缺少 WEREAD_API_KEY 报告 命令行工具 给出的可选项，并复述获取路径：微信读书 应用 最新版 -> 我的 -> 右上角设置按钮 -> 微信读书 技能 -> 快速配置第 2 步 -> 获取 API Key；不要替用户选择 老用户命令含 --cookie-from 或 --cookie 直接执行，命令行工具 会按旧 网页 后端运行，并提示 Gateway 升级优势 用户明确不用 Gateway 使用 --no-gateway --cookie-from browser-managed，或按用户指定的 cookie/browser 参数执行 Gateway 临时不可用 允许 命令行工具 自动回退 网页 后端，报告最终 backend Gateway 鉴权失败或 升级_信息 不回退，报告原始错误和升级/配置要求 定时任务 新任务推荐 Gateway 固定命令；已有旧 cron 命令继续执行，不要自动改参数或加 --force 可用参数 --all --book