CLAUDE.md · diff
git:20260410.6e71a47 to git:20260602.0fbdd5e
23 added, 17 removed. Audit A to A.
- # last30days-cn 技能
+ # last30days-cn
- > Author: Jesse (https://github.com/Jesseovo)
+ Agent-facing notes for local development.
- 面向 Agent 的简短指引：**中国平台深度研究引擎**（微博、小红书、B 站、知乎、抖音、微信公众号、百度、今日头条），默认聚焦近 **30 天** 内容，经打分与去重后输出简报。
+ ## Purpose
- ## 结构
+ `last30days-cn` researches recent Chinese-platform discussion across Weibo, Xiaohongshu, Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu, and Toutiao. The default window is the last 30 days.
- - `scripts/last30days.py` — 主流程：多源并行搜索、归一化、排序、去重、写报告
- - `scripts/lib/` — 平台适配与通用能力（`env`、`http`、`normalize`、`score`、`render` 等）
- - `SKILL.md` — 对外技能定义（部署到各 Agent 的 skills 目录时使用）
+ ## Structure
- ## 命令
+ - `skills/last30days/SKILL.md`: installable Agent Skill entrypoint.
+ - `skills/last30days/scripts/`: self-contained runtime payload for Agent Skills installs.
+ - `scripts/`: root development copy kept for compatibility.
+ - `scripts/lib/render.py`: Markdown, JSON context, and HTML report rendering.
+ - `tests/`: focused regression tests.
+ ## Commands
+
```bash
- # 研究主题（默认 compact 输出）
- python3 scripts/last30days.py "你的主题" --emit=compact
+ python scripts/last30days.py "你的主题" --emit compact
+ python scripts/last30days.py "你的主题" --emit html-path
+ python scripts/last30days.py --diagnose
+ ```
- # 可选：同步到本机 skills 目录（路径见 scripts/sync.sh 内 TARGETS）
- bash scripts/sync.sh
+ When validating on this Windows workspace, prefer:
+
+ ```bash
+ py -m pytest
```
- ## 规则
+ The `python` command may resolve to the Windows Store shim on some machines.
- - `scripts/lib/__init__.py` 必须为**裸包标记**（仅注释，**禁止**在包内做 eager import）。
- - 修改代码后若需部署到 `~/.claude` / `~/.agents` 等，执行 `bash scripts/sync.sh`（可按需改脚本中的目标目录名以匹配 `last30days-cn`）。
+ ## Release Notes
- ## 配置
+ For v3.0.0, the skill payload is self-contained under `skills/last30days`, and the new HTML renderer emits a Guizang-inspired Swiss/IKB report.
- 密钥与选项见 `~/.config/last30days-cn/.env`，细节以 `scripts/lib/env.py` 为准。