| name | ai-journal-match |
| description | 用于英文 / SCI 路线 P0 期刊调研第一层「探索」——输入研究方向/题目/摘要，输出 5-10 个候选期刊（含 fit_score + ISSN）。Adapter 模式：生医走 JANE（v0.1 实装），化学/材料/物理走 Springer/Elsevier（TODO），工程/CS 走 IEEE PR（TODO），商科/文社科 fallback 提示 letpub 手动筛。被 journal-research-orchestrator 第一层调用。触发关键词：JANE / AI 选刊 / AI journal recommender / 题目摘要选刊 / Boss 直聘式选刊 / 候选期刊池 / 探索期刊。不用于：全画像验证（那是 letpub-sci-journal-review）、最终决策（那是 journal-research-orchestrator）、中文期刊推荐（那是 journal-research-cn:muchong-cn-journal-review）、跨学科主源探索（那是 openalex-explore）。 |
ai-journal-match
一句话定位
ai-journal-match = 学术界的「Boss 直聘 AI 智能推荐」。
输入研究方向 / 题目 / 摘要 → 5-10 个候选期刊（含 fit_score + ISSN）。
P0 三层流程的第一层「探索」。
方法论核心（内联）
- ==AI 推荐结果必须二次核实==——AI 训练数据可能滞后或脑补 IF / 分区数字。本 skill 输出永远标
trust_level: "ai-推断"，由 orchestrator 自动调 letpub + authority-check 二次验证。
- AI 缩范围只是第一层探索——生成候选池；不直接进入决策矩阵。
- 只有
fit_score 达不到判定门槛——< 0.5 标 weak_match warning，让 orchestrator 决定取舍。
工具优先级
| 场景 | Primary | Fallback |
|---|
| GUI 内演示（视频镜头） | Tier 1 Claude Code Preview / Codex in-app browser | Tier 2 firecrawl |
| Runtime 调度（orchestrator） | Tier 2 firecrawl POST | Tier 3 chrome-devtools（仅 SPA adapter） |
Trust Level 新增
继承 letpub 的 trust 分层，本 skill 引入新一档：
| trust_level | 定义 | 决策权重 |
|---|
ai-推断 | AI 算法基于文献相似度的推荐 | ==仅供探索——不能当决策依据== |
输出里必须标 trust_level: "ai-推断"。orchestrator 看到这个标记会自动调 letpub + authority-check 二次验证。
Adapter 模式：学科路由决策树
User 输入（research_direction / abstract）
│
▼
检测语言 / 关键词 / 学科
│
┌──────────────┼──────────────┬──────────────┐
▼ ▼ ▼ ▼
生医/生物 化学/材料 工程/电气 商科/文社科
PubMed范畴 物理 计算机
│ │ │ │
✅ JANE ⏳ Springer ⏳ IEEE PR ❌ Fallback
(v0.1 实装) Suggester / (TODO) 空 list +
Elsevier JF 防护较强 提示 letpub 手筛
(TODO，SPA) 需 Tier 3-4
│
跨学科 / 多学科
│
默认 JANE（PubMed 覆盖最广）
下轮加并发其他 adapter 后取并集
JANE Adapter（v0.1 实装）
URL 模式
https://jane.biosemantics.org/suggestions.php?findJournals=&text={url-encoded title+abstract}
text 参数支持 URL 编码后的题目 + 摘要（5-200 字典型）。多段连接用空格。
抓取路径
Tier 2 firecrawl：
firecrawl scrape \
'https://jane.biosemantics.org/suggestions.php?findJournals=&text=YOUR_QUERY' \
--formats markdown,html \
--only-main-content true
curl 兜底：
curl -L -A 'Mozilla/5.0' \
"https://jane.biosemantics.org/suggestions.php?findJournals=&text=$(python3 -c 'import urllib.parse;print(urllib.parse.quote("YOUR QUERY"))')"
==无登录、无 captcha、反爬未观察到==。
输出 HTML 结构
JANE 返回 server-rendered 表格，每行一个候选：
| 列 | 字段 | 说明 |
|---|
| 期刊名 | str | 全名 |
| confidence | float 0-1 | JANE 算法相似度 |
| 标签 | list[str] | "Medline-indexed" / "PMC" / "OA" / "High-quality OA" |
| 期刊主页 URL | str | 用于 ISSN 反查 |
==ISSN 不在 JANE 直接输出==——本 skill 输出 identity 时 ISSN 字段留 None，由 orchestrator 调 letpub 反查。
详见 references/jane-adapter-cheatsheet.md。
其他 Adapter（v0.1 留 stub，下轮迭代）
| Adapter | 状态 | 待做 |
|---|
| Springer Journal Suggester | ⏳ TODO | SPA + JS 表单提交，需 Tier 3 chrome-devtools |
| Elsevier JournalFinder | ⏳ TODO | 反爬强（直 403），需真实 Chrome + UA + cookie |
| Wiley Journal Finder | ⏳ TODO | 同上，结果偏 Wiley 内部期刊 |
| IEEE Publication Recommender | ⏳ TODO | 防护较强，可能需 computer-use 兜底 |
调度上述 adapter 时本版本返回：
{"adapter": "springer", "status": "not_implemented",
"message": "v0.1 仅支持 JANE。其他 adapter 下轮迭代。"}
Fallback：商科 / 文社科 / 中文期刊
JANE 是 PubMed 语料，商科/管理/文社科召回率极低。命中此场景时：
{
"candidates": [],
"fallback_reason": "商科/文社科/管理领域无 AI 选刊器，请用 letpub 手动筛或 ABS 目录",
"trust_level": "ai-推断",
"tool_tier_used": "n/a"
}
中文期刊推荐不属于本 skill —— 提示用户改用 journal-research-cn:muchong-cn-journal-review 或 PLAN-3 后续中文探索 skill。
输出 Schema
返回 list[CandidateJournal]，本 skill 只填 identity + fit_score：
[
CandidateJournal(
identity=JournalIdentity(
title="Journal of the International AIDS Society",
issn=None,
eissn=None,
publisher=None,
official_site="https://...",
submission_site=None,
),
fit_score=0.87,
authority_metrics={},
cas_legacy=None,
cas_letpub=None,
review_intel={},
speed_intel={},
cost_intel={},
risk_flags=[],
evidence=[
SourceEvidence(
source="jane-result",
url="https://jane.biosemantics.org/suggestions.php?...",
access_level="public",
trust_level="ai-推断",
fetched_at="<ISO>",
raw_snippet_path="./cache/jane-<query-hash>.html",
tool_tier_used="2",
)
],
),
...
]
Anti-pattern
- ❌ 把 fit_score 当决策依据（必须二次验证；orchestrator 看到
trust_level=ai-推断 自动会做）
- ❌ fit_score < 0.5 还强行返回（标
weak_match warning，让 orchestrator 决定是否丢弃）
- ❌ 商科/文社科硬塞 JANE（语料不匹配 → 走 fallback）
- ❌ 中文期刊用本 skill（→
journal-research-cn:muchong-cn-journal-review / PLAN-3 中文探索 skill）
- ❌ 静默丢失 fit_score（缺则 None + error_log）
- ❌ v0.1 强行接 SPA adapter（Springer/Elsevier 留 TODO，认真做需要 Tier 3 + 字段抽取实测）
协作边界
| Skill | 关系 |
|---|
journal-research-orchestrator | 上游：第一层调度方 |
letpub-sci-journal-review | 下游：本 skill 输出由 letpub 二次验证（含 ISSN 反查） |
journal-authority-check | 下游：权威源核验（MJL/SJR/CiteScore/DOAJ） |
predatory-risk-check | 下游：可能含掠夺刊，由 risk-check 排除 |
journal-research-cn:muchong-cn-journal-review | 跨 plugin 平行（中文期刊不在本 skill 范围） |
References
| 文件 | 用途 | 何时读 |
|---|
references/jane-adapter-cheatsheet.md | JANE URL + 字段抽取 + 边缘案例 | 跑 JANE 时 |
references/discipline-routing-playbook.md | 学科 → adapter 路由决策树 + 关键词触发器 | 路由不确定时 |
本 skill 的 deletion-spec
- 触发删除条件：JANE 站停服 / 被替代；其他 4 个 adapter（Springer/Elsevier/Wiley/IEEE）全部接入后本 skill 升级到独立 plugin（v1.0+）；或 Claude/Codex 原生 AI 选刊集成（如官方 MCP）使本 skill 冗余。
- 禁用方式：
rm -rf plugins/journal-research-en/skills/ai-journal-match/ → bump plugin（patch）→ 跑 python3 plugins/scripts/generate_plugin_marketplaces.py + verify_plugin_distribution.py。
- 卸载清单：
plugins/journal-research-en/.claude-plugin/plugin.json（版本 bump）plugins/journal-research-en/README.md（Skills 表 + 三层协作图 + Roadmap）plugins/journal-research-en/skills/journal-research-orchestrator/SKILL.md（第一层调用引用）plugins/journal-research-en/_shared/journal_identity.py（CandidateJournal dataclass 仍由其他 skill 复用，本 skill 拆除不删 dataclass）
