naver-news-briefing

使用位于 scripts/naver_news_briefing.py 的 CLI 脚本。

入门引导（Onboarding）

• 首次实际使用前，必须配置 Naver 搜索 API 凭据。
• 尽早向用户说明：在 client_id 和 client_secret 存储完成前，所有 search / briefing / watch 流程均会失败。
• 若用户尚未完成初始化配置，请引导其执行以下命令：
  • python scripts/naver_news_briefing.py setup --client-id ... --client-secret ...
  • python scripts/naver_news_briefing.py check-credentials --json
• 将配置流程明确作为首次运行的必经路径，而非可选的高级步骤。
• 在协助安装或首次使用时，请说明凭据将保存在 data/config.json 中；在 Windows 平台上尽可能使用基于 DPAPI 的密钥安全存储机制。

工作流（Workflow）

1. 在执行任意 search / briefing / watch 命令前，需先完成一次凭据存储：
   • python scripts/naver_news_briefing.py setup --client-id ... --client-secret ...
   • 通过 python scripts/naver_news_briefing.py check-credentials --json 验证配置有效性。
2. 执行一次性新闻简报：
   • python scripts/naver_news_briefing.py search "최근 3일 반도체 뉴스 브리핑 -광고"
   • 添加 --json 参数以获得机器可读输出。
3. 管理持久化的 watch 规则，并支持可选的运营元数据：
   • 新增规则：python scripts/naver_news_briefing.py watch-add semiconductor "최근 7일 반도체 -광고" --label "반도체 감시" --tag watch --template watch-alert
   • 列出全部规则：python scripts/naver_news_briefing.py watch-list
   • 移除规则：python scripts/naver_news_briefing.py watch-remove semiconductor
   • 检查规则状态：python scripts/naver_news_briefing.py watch-check semiconductor --json
4. 管理用于周期性简报的持久化关键词组：
   • 新增分组：python scripts/naver_news_briefing.py group-add market-watch "최근 3일 반도체 -광고" "오늘 AI 데이터센터 -주가" --label "아침 시장" --tag 테크 --context "오전 보고용" --template morning-briefing
   • 列出全部分组：python scripts/naver_news_briefing.py group-list
   • 查看单个分组详情：python scripts/naver_news_briefing.py group-list market-watch --json
   • 更新分组：python scripts/naver_news_briefing.py group-update market-watch --add-query "배터리 공급망 -광고" --tag 공급망 --template analyst
   • 删除分组：python scripts/naver_news_briefing.py group-remove market-watch
5. 执行组合式简报：
   • python scripts/naver_news_briefing.py brief-multi --group market-watch
   • python scripts/naver_news_briefing.py brief-multi --group market-watch --query "환율 뉴스" --template morning-briefing --json
   • 若未指定 --template，则优先采用已保存分组中定义的模板。
6. 将类聊天风格的自动化请求转换为结构化执行计划：
   • 查看解析后的计划：python scripts/naver_news_briefing.py plan "반도체 뉴스 1시간마다 모니터링해줘" --json
   • 构建兼容 OpenClaw 的集成包：python scripts/naver_news_briefing.py integration-plan "반도체 뉴스 1시간마다 모니터링해줘" --json
   • 支持常见韩语表达模式，例如：매일 아침 7시에 반도체랑 AI 데이터센터 뉴스 브리핑해줘、증권사 리포트 빼고 삼성전자 뉴스 계속 체크해줘 等。
7. 将解析后的计划固化为持久化配置：
   • 创建 watch：python scripts/naver_news_briefing.py plan-save "반도체 뉴스 1시간마다 모니터링해줘" --as watch --name semiconductor-hourly
   • 创建 group：python scripts/naver_news_briefing.py plan-save "매일 아침 7시에 반도체랑 AI 데이터센터 뉴스 브리핑해줘" --as group --name morning-tech --label "아침 브리핑"

行为规范（Behavior）

• 依据上游 tab-search 策略，解析正向关键词及 -제외어 排除项。
• 将诸如 오늘、최근 3일、최근 2주、한달、이번주、지난주 等近期新闻短语识别为时间窗口，并从 API 搜索查询中移除该短语。
• 对更自然的韩语句子输入进行归一化处理：剔除请求类短语、常见助词（조사）、重复词元，以及如 A 말고、B 빼고、C 제외 等韩语排除表达，并统一转换为 -제외어 标记。
• 从韩语聊天请求中解析出实用的调度意图，映射为 interval、daily、weekly 或 manual 类型的计划。
• 在已保存的 watch / group 条目中保留面向运营人员的元数据字段：label、tags、template、schedule、operator_hints 及原始请求上下文。
• 在 Windows 平台上尽可能使用基于 DPAPI 的密钥安全存储机制。
• 通过 (watch_id, link) 对 watch 通知进行去重，确保定时任务重复执行时仅推送新发现的内容项。
• plan 命令返回适配 cron 的运营提示、推荐命令，以及存储目标建议（watch 或 group）。
• integration-plan 返回更实用的运营集成包：包含保存命令、执行命令、调度对象（schedule object）、cron 表达式行、兼容 OpenClaw 的 systemEvent 文本，以及韩语确认摘要。
• plan-save 将已解析的计划固化为已保存的 watch 或 group 配置，但不负责 cron 自动化逻辑的绑定与部署。
• brief-multi 默认返回适合聊天场景的合并文本；添加 --json 参数后返回结构化 JSON 输出。

备注（Notes）

• 重大修改前，请先阅读 references/upstream-notes.md。
• 本能力依赖 Naver 搜索 API 提供的标题（headline）与摘要（summary）元数据，**不抓取也不生成全文内容的摘要**。
• 新增功能应保持向后兼容：务必保留现有 search、watch-add、watch-list、watch-remove 和 watch-check 功能流程不变。
• 面向终端用户的公开文档存放于 README.md，请始终以韩语为首选语言，并确保内容具体、可操作。