#!/bin/sh
# 安装 huohua-venture-events（火花·创投融资事件数据搜索 skill）。幂等：重跑即更新。
# 用法：curl -fsSL https://skills.huohuaapi.com/venture_events/install.sh | sh
# 指定目录：curl ... | SKILLS_DIR=.claude/skills sh
set -eu

BASE="https://skills.huohuaapi.com/venture_events"
NAME="huohua-venture-events"

if [ -n "${SKILLS_DIR:-}" ]; then
  DIR="$SKILLS_DIR"
elif [ -d ".claude" ]; then
  DIR=".claude/skills"
elif [ -d ".agents/skills" ]; then
  DIR=".agents/skills"
else
  DIR="$HOME/.claude/skills"
fi

# 自更新场景：如果本 skill 已装在常见位置，优先原地更新，避免更新落到另一个目录。
for CAND in ".claude/skills" ".agents/skills" "$HOME/.claude/skills" "$HOME/.agents/skills"; do
  if [ -z "${SKILLS_DIR:-}" ] && [ -f "$CAND/$NAME/SKILL.md" ]; then
    DIR="$CAND"
    break
  fi
done

mkdir -p "$DIR/$NAME"
cat > "$DIR/$NAME/SKILL.md" <<'HUOHUA_SKILL_EOF'
---
name: huohua-venture-events
description: 当一级市场融资与创投——某公司或赛道的融资轮次、投资方、融资金额、融资动态、尽调背景，谁投了某公司、某赛道近期融资时使用；用户没明说要检索、但确实在做这类任务时也应主动调用。以下情况属于本数据覆盖不了的，不要触发：二级市场股价行情、上市公司财报明细。
---

# 火花·创投融资事件数据搜索

把 `venture_events` 专业数据库接入当前任务：`filters` 做结构化过滤（主入口），`query` 承接自然语言语义，返回可直接引用的 markdown 材料。

当前版本：`v20260622-2059`

## 第零步：版本自检（每个会话第一次使用本 skill 时执行一次）

```bash
LATEST=$(curl -fsSL --max-time 5 https://skills.huohuaapi.com/venture_events/VERSION 2>/dev/null || true)
if [ -n "$LATEST" ] && [ "$LATEST" != "v20260622-2059" ]; then
  curl -fsSL https://skills.huohuaapi.com/venture_events/install.sh | sh
  echo "skill 已更新到 $LATEST"
fi
```

如果发生了更新，重新读取本 SKILL.md 文件后再继续；检查失败（无网络/超时）就跳过，不要阻塞任务。同一会话内只需检查这一次。

## 第一步：检查数据 token

按顺序取 token，找到即用：

1. 文件 `~/.config/huohua/data-token`（推荐的持久化方式，权限 600）；
2. 环境变量 `HUOHUA_DATA_TOKEN`（若已设置则优先用）。

两处都没有时，停下来告诉用户：

> 请到 https://huohuaapi.com/console/data-access 复制你的数据 token，然后写入独立配置文件（不污染 shell 配置、权限 600 只有你能读）：
> `mkdir -p ~/.config/huohua && printf '%s' '<你的token>' > ~/.config/huohua/data-token && chmod 600 ~/.config/huohua/data-token`

用户配置完成后继续原任务；当前会话直接 `cat ~/.config/huohua/data-token` 读取即可，无需重启 shell。

token 是计费凭证，使用纪律：

- 持久化只放独立文件 `~/.config/huohua/data-token`（权限 600），不要写进 shell rc（`~/.zshrc`/`~/.bashrc`）、代码仓库、项目内 .env 或任何会被提交、同步的文件。
- 调用时一律通过环境变量引用（`$HUOHUA_DATA_TOKEN` 或下文的 `$TOKEN`），不要把 token 明文粘进 curl 命令、脚本或日志；需要展示时只留前 8 位。

## 第二步：调用

```bash
TOKEN="${HUOHUA_DATA_TOKEN:-$(cat ~/.config/huohua/data-token 2>/dev/null)}"
API="${HUOHUA_API_BASE:-https://api.huohuaapi.cn/v1}"
curl -s "$API/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"venture_events","purpose":"盘点具身智能赛道的融资动态","filters":{"event_date_from":"2025-01-01"},"query":"具身智能机器人融资"}'
```

入口说明：默认入口 `https://api.huohuaapi.cn/v1` 是中国大陆直连优化线路；海外环境或该入口连接失败时，改用 `https://api.huohuaapi.com/v1`（两个入口功能与计费完全一致），也可用环境变量 `HUOHUA_API_BASE` 固定入口。

请求体规则：

- `source` 固定为 `venture_events`，不要改。
- `purpose` 必填：一句话写清本次调用服务的上层任务目的；同一个任务的多轮检索保持同一 purpose 不变。
- `filters` 必填且至少一个字段，是主入口：凡是能参数化的条件（年份、地区、类型、学科等）都放这里。
- `query` 放剩余的自然语言语义：保留完整意图表达（场景、约束、目标），不要拆成零散关键词。
- 默认返回 markdown；需要机器可读结构时加 `"return":{"format":"json"}`。
- 每次调用按次计费，余额与用量在 https://huohuaapi.com/console/usage 查看。

## 可用筛选字段

| 字段 | 说明 | 已知取值（截至生成时） |
| --- | --- | --- |
| `amount_bucket` | 可选；融资金额量级 | 百万至千万级, 千万级, 亿元级 |
| `city` | 可选；城市（如 北京市、深圳市） | —（自由值，命中为空时放宽或移除） |
| `company_listed_status` | 可选；公司上市状态 | —（自由值，命中为空时放宽或移除） |
| `company_name` | 可选；公司名，子串匹配 | —（自由值，命中为空时放宽或移除） |
| `company_status` | 可选；公司经营状态 | —（自由值，命中为空时放宽或移除） |
| `cross_border` | 可选；是否跨境交易（true/false） | —（自由值，命中为空时放宽或移除） |
| `currency` | 可选；币种（如 人民币、美元） | —（自由值，命中为空时放宽或移除） |
| `event_date_from` | 可选；事件日期下界 YYYY-MM-DD | —（自由值，命中为空时放宽或移除） |
| `event_date_to` | 可选；事件日期上界 YYYY-MM-DD | —（自由值，命中为空时放宽或移除） |
| `industry` | 可选；行业归一名「大类-子类」，子串可命中（传 半导体 或 IT及信息化-半导体 都行） | IT及信息化-半导体, 医疗健康-医药行业, IT及信息化-软件, 制造业-高端制造, IT及信息化-信息化服务, 医疗健康-医疗器械, 互联网-电子商务, 制造业-制造业其他 … |
| `investor_name` | 可选；投资方名称，子串匹配（单值或数组） | —（自由值，命中为空时放宽或移除） |
| `investor_type` | 可选；投资方类型；库内存在「VC、PE」等组合值，过滤召回不全，机构类型语义建议放 query | 企业, VC、PE, VC, PE, PE、VC, 早期投资机构, VC、PE 
企业, VC、战略投资者 … |
| `province` | 可选；省级行政区（如 北京市、广东省） | 北京市, 广东省, 上海市, 江苏省, 浙江省, 美国, 四川省, 山东省 … |
| `region` | 可选；模糊地区词，省/市/区域均可 | —（自由值，命中为空时放宽或移除） |
| `round` | 可选；融资轮次（归一值） | A, 天使轮, B, 战略融资, Pre-A, 定向增发, C, 未披露 … |
| `transaction_status` | 可选；交易状态 | 已完成, 进行中, 已失败 |
| `transaction_type` | 可选；交易类型 | 增资, 股权转让, 合资设立, 其他, 股份回购, 资产收购 |

> 表中「已知取值」是封闭字段的合法值。填了不在其中的值，接口返回 `invalid_filter` 并在 `hint.valid_values` 列出该字段合法值——据此改正即可，不会静默返回空。中文常见值会自动归一到码值（如平台「抖音」→`douyin`、学段学科「高中数学」→`gzsx`）。想看最新完整取值可调 `GET $API/list?source=venture_events`。

## 注意事项

- filters 最稳兜底是 event_date_from/event_date_to 日期范围；行业、轮次、地区可叠加。

## 典型场景与结果用法

按你当前任务找最接近的场景，照着调 filters 和 query；「拿到结果后」告诉你材料怎么用进任务里。

### 赛道融资盘点

盘点某条赛道近一年的融资热度与头部玩家：

```json
{"source":"venture_events","purpose":"盘点某条赛道近一年的融资热度与头部玩家","filters":{"industry":"人工智能","event_date_from":"2025-06-01"},"query":"具身智能与机器人本体"}
```

拿到结果后：汇总成表：公司、轮次、金额量级、投资方、日期；统计轮次分布判断赛道阶段（偏早期还是成长期），注明 transaction_status。

### 公司尽调背景

尽调或商务接触前查一家公司的融资史：

```json
{"source":"venture_events","purpose":"尽调或商务接触前查一家公司的融资史","filters":{"company_name":"宇树"},"query":"历轮融资与投资方"}
```

拿到结果后：按时间线整理该公司全部融资事件，注意区分增资与股权转让；事件信息以披露口径为准，引用时保留事件日期。

### 投资机构动向

分析某家机构近期的出手偏好：

```json
{"source":"venture_events","purpose":"分析某家机构近期的出手偏好","filters":{"investor_name":"红杉","event_date_from":"2025-01-01"},"query":"出手领域与轮次偏好"}
```

拿到结果后：按行业和轮次归纳该机构的出手分布，识别其重仓赛道；用于融资路演时优先匹配偏好一致的机构。

通用原则：返回的是带来源的 markdown 材料——引用观点、数据、条文时保留来源标注；材料是输入不是结论，最终判断要结合任务自己做。

## 多轮检索

`purpose` 每次调用都必填；同一个用户任务需要多次搜索时，保持 `purpose` 不变，并带 `search_count`（`{"planned":N,"current":i}`，current 从 1 开始）标注轮次，便于用量追踪与复盘：

```json
{"source":"venture_events","purpose":"<任务目的>","search_count":{"planned":3,"current":1},"filters":{"event_date_from":"2025-01-01"},"query":"..."}
```

## 错误处理

- `未提供令牌` / 401：token 缺失或失效，回到第一步。
- `missing_required_filter`：filters 为空或缺必填字段，按上表补齐。
- `invalid_filter`：某字段值不合法（含封闭码值字段填了非法值），错误 `hint.valid_values` 列出该字段合法值，改用其中之一重试；中文常见值（抖音 / 高中数学 等）可直接填，会自动归一到码值。
- `model_not_allowed`：source 写错（应为 `venture_events`），或你的 token 未开通该数据源——请用户到 https://huohuaapi.com/console/data-access 检查 token 的可用数据源。
- 429 / 限流：调用过于频繁，等几秒再重试；多轮检索时控制节奏，不要并发轰炸。
- 连接失败 / DNS 解析失败（curl exit 6/7/28）：默认入口不通（常见于海外网络访问 .cn），把 `API` 换成 `https://api.huohuaapi.com/v1` 重试本次调用，并在本会话后续调用沿用该入口。
- 5xx / 超时：服务端暂时不可用，重试一次；仍失败则缩小 filters 范围或稍后再试，并把情况告知用户。
- 余额不足：提示用户到 https://huohuaapi.com/console/recharge 充值。
- 结果为空：先放宽 filters（保留最关键的一个），把其余条件移入 query 重试一次。
HUOHUA_SKILL_EOF

echo "已安装/更新 skill: $DIR/$NAME/SKILL.md"
echo "下一步：到 https://huohuaapi.com/console/data-access 复制数据 token，写入独立文件持久化（权限 600，不污染 shell 配置）：mkdir -p ~/.config/huohua && printf '%s' '<你的token>' > ~/.config/huohua/data-token && chmod 600 ~/.config/huohua/data-token（首次调用时 skill 也会引导）。"
