🍲 sip 用户快速手册
写给刚拿到 sip 的你。五分钟读完，就能开始用。 面向真实用户；Agent/AI 使用者请看高级用户手册（Agent）。
0. sip 是什么（一句话定位）
本地优先的个人信息库：收集（RSS + 任意文字/网页）、保存（带版本和来源）、追踪（被改过你永远知道）、筛选（去重/主题）、使用（检索/问答）。数据全在你电脑上，不上传、不云端，拷走 readwithhotsoup 文件夹就是迁移。
1. sip 能做什么（完整命令 + 界面）
1.1 命令行（CLI）——所有能力，完整清单
订阅管理
sip -l [编号] 列出订阅源/文章（带编号）
sip -d <URL> 添加 RSS 源
sip -u <编号> 更新一个源
sip -r <编号> [--yes] 删除一个源
sip -a <编号> / -una <编号> 归档 / 取消归档
sip --sync [--feed N] 只更新"到期"的源
sip --update-all 强制更新全部源
sip --schedule <编号> <表达式> 更新计划：30m / 1h / 7d / daily@10:00 / weekly@Mon 08:00 / manual
sip --import-opml <文件> 导入 OPML
sip --export-opml [文件] 导出 OPML
sip --onboarding 推荐源模板（可编辑 templates.json）阅读与版本
sip --show <编号> 全屏阅读（W 进完整 TUI，Esc 退出）；--json 输出原文给脚本
sip --versions <编号> 看一篇文章的全部版本
sip --diff <编号> [vA vB] 对比两个版本改了什么（默认最近两版）
sip --export <编号|feed:N|all> 导出 Markdown
sip --fulltext <编号> [--yes] 抓取全文到本地缓存
sip --purge-fulltext [编号] 清空全文缓存
sip --feed-info <编号> 源身份与健康状态
sip --today [--refresh] 今日哈汤：每天一小碗值得读的
sip --like <编号> [--ai [理由]] 标记喜欢（♥ 你 / 🤖 AI）
sip --likes 列出所有标记搜索
sip --grep "关键词" 全文搜索（不用 AI，中文可搜，百万级 0.5 秒）
sip --search "关键词" [--feed N] 语义搜索（需先 --init 配 AI）AI 配置与摘要
sip --init 首次配置 AI（模型 + API Key；必须真实终端手动跑）
sip --config 查看/修改 AI 配置
sip --index / --reindex 给文章生成向量 / 换模型后重建
sip --summary <编号> 生成摘要
sip --summary-all 补全所有摘要语义 diff（v1.2.2 新增）
sip --diff <编号> [--semantic] 查看版本差异（--semantic 显示语义距离和改动分级）报告与系统
sip --insights [--window N d] 阅读报告（需开启遥测）
sip --insights-interval <周期> 设定报告提醒（7d/30d/off）
sip --dedup scan|hide|list|undo 跨源去重
sip --policy list|set|remove 源规则（你确认后自动执行）
sip telemetry status|enable|… 遥测（默认关闭，仅本地）
sip simon status|level <1|2|3> 孟思琳安全守护（默认开启，挡位可调）
sip --help / --version 帮助 / 版本全局选项：
--json（结构化输出给脚本）、--ignoresafeannouncement（跳过安全横幅）、--lang zh-CN|en-US（语言）。
1.2 界面（TUI）——全键盘操作
启动 sip（不带参数）进入界面：
| 按键 | 作用 |
|---|---|
| ↑↓ 或 j/k | 移动选择 |
| Enter | 打开文章 / 折叠展开源 |
| ←→ | 切换左侧列表 / 右侧正文 |
| PageUp / PageDown | 翻页 |
| u | 更新当前源 |
| F6 | 更新全部源 |
| a / r | 归档 / 取消归档 |
| x | 删除 |
| s | 更新计划 |
| d | 添加订阅源 |
| i | 查看已隐藏 |
| l | 点赞 |
| v | 版本历史 |
| S | 搜索 |
| Y | 摘要 |
| H | 帮助 |
| P | 阅读报告（需开启遥测） |
| M | 订阅管理 |
| W | 全屏阅读 |
| Q / Esc | 退出 / 返回 |
| 输入 today | 今日哈汤 |
| 命令栏输入 report | 打开报告 |
2. 你应该如何使用 sip
2.1 第一次（5 分钟上手）
- 下载单文件 exe，双击或
sip启动 → 进入界面 sip -d <你的订阅源 URL>或按d添加几个源sip --update-all（或 F6）拉取文章- 打开
sip --today读今天的一小碗 - 想要 AI 能力（语义搜索/摘要/证据问答）：真实终端跑一次
sip --init
2.2 每天（养成习惯）
- 早上：
sip --today读今日哈汤
2.3 数据在哪
所有数据在 exe 同级的 readwithhotsoup/ 文件夹（rss.db + JSON + fulltext/）——拷走它就是迁移。
3. 快速故障排查
| 症状 | 原因 | 处理 |
|---|---|---|
| 中文乱码 | 终端编码不是 UTF-8（Windows GBK） | PowerShell 先执行 [Console]::OutputEncoding=[Text.Encoding]::UTF8；或把输出按 UTF-8 解码 |
| 命令被拦：🔒 孟思琳拦截 | simon 挡位 2/3 拦截 CLI 写操作 | sip simon status 看挡位；挡位 2 用只读命令或去 TUI 操作；挡位 3 只能 TUI；降挡只能在 TUI 命令栏 |
| 报 NO_INDEX / 尚无向量索引 | 没跑过 --index | 先 sip --init 再 --index；--grep 不依赖 AI，可先用 |
--init 报"需真实交互终端" | 脚本/AI 代跑被拒（安全设计） | 你自己在真实终端跑 sip --init |
| 添加源报 NETWORK_ERROR | 网络不通 / URL 格式错 / 私网被 SSRF 拦 | 检查 URL；内网源需在 ai_config.json 设 allowPrivateNet: true |
| 退出码非 0 | 见说明 | 0 成功 / 1 参数或数据库错误 / 2 网络或服务不可达 / 3 资源未就绪（AI 未配置/找不到） |
| 提示"恢复默认语言文件" | 语言文件缺失自动恢复 | 正常现象；自定义翻译编辑 readwithhotsoup/languages/ 里的文件 |
| 库打不开/损坏 | 数据库自愈 | 自动重建，原库保留现场（simon status 看修复记录） |
4. 获取帮助
sip --help命令全集（本手册即据此整理）sip simon status查看安全守护状态- Wiki 首页 · 快速开始 · Bot 接入
- 作者博客：https://blog.hotsouprealm.top/
- Agent/AI 使用者：高级用户手册（Agent）
品，你细品。🍲