# 企服科学 Skill · 安装说明

给 Agent 装一个「企服科学」新闻技能。装好之后，用户随口问一句「今天企服圈发生了什么」，
Agent 就会自己去取企服科学的稿件，并带原文链接作答。

- 技能名：`qifu-news`
- 数据源：<https://qifukexue.com>
- 接口地址：<https://qifukexue.com/qifu-agent/api/v1>
- **无需密钥、无需注册、无需登录**
- 版本：1.0.0

---

## 一、把这句话丢给你的 Agent（推荐）

正在用的 Agent 支持安装技能（Claude Code、Codex、Cursor、Gemini CLI、Cline、OpenCode 等），
直接把下面这句发给他：

```
请安装企服科学 Skill：https://qifukexue.com/qifu-agent/skill/README.md 装完告诉我是否需要开启新会话。
```

Agent 会自己下载 <https://qifukexue.com/qifu-agent/skill/install.sh> 并执行安装。
如果它不认这个地址，就让它读本文件，按下面第二节手动装。

---

## 二、手动安装

### 一条命令

```bash
curl -fsSL https://qifukexue.com/qifu-agent/skill/install.sh | bash -s -- --target agents
```

`--target` 可选：

| target | 安装位置 | 适用 |
| --- | --- | --- |
| `agents` | `~/.agents/skills/qifu-news` | 跨客户端事实标准目录（默认推荐） |
| `claude` | `~/.claude/skills/qifu-news` | Claude Code |
| `codex` | `~/.codex/skills/qifu-news` | Codex CLI |
| `gemini` | `~/.gemini/skills/qifu-news` | Gemini CLI |
| `opencode` | `~/.config/opencode/skills/qifu-news` | OpenCode |
| `all` | 以上全部 | 一次装齐 |

安装器会默认做两件事：把技能真身放在 `~/.agents/skills/qifu-news`，
再为各客户端建**软链接**，这样升级一次、处处生效，不会出现多份副本版本不一致。

### 先看再装（更稳妥）

```bash
curl -fsSLO https://qifukexue.com/qifu-agent/skill/install.sh
less install.sh
bash install.sh --target agents --dry-run
bash install.sh --target agents
```

### 完全手工（三个文件，复制即可）

技能目录只要三个文件：

```
qifu-news/
├── SKILL.md                 # 必需：技能主体
├── agents/openai.yaml       # 可选：Codex 界面元信息
└── references/api.md        # 可选：接口详细参考
```

```bash
DEST=~/.agents/skills/qifu-news
mkdir -p "$DEST/references" "$DEST/agents"
curl -fsSL https://qifukexue.com/qifu-agent/skill/qifu-news/SKILL.md                -o "$DEST/SKILL.md"
curl -fsSL https://qifukexue.com/qifu-agent/skill/qifu-news/references/api.md       -o "$DEST/references/api.md"
curl -fsSL https://qifukexue.com/qifu-agent/skill/qifu-news/agents/openai.yaml      -o "$DEST/agents/openai.yaml"
```

装完**开一个新会话**，技能才会被扫描到。

---

## 三、验证是否装好

对 Agent 说：

```
用企服科学技能，给我近 24 小时企业服务领域的 5 条要闻
```

也可以直接验证接口连通（不依赖任何技能）：

```bash
curl -s "https://qifukexue.com/qifu-agent/api/v1/meta" | head -c 400
curl -s "https://qifukexue.com/qifu-agent/api/v1/items?mode=latest&window=24h&limit=3"
```

---

## 四、不装技能也能用

本服务同时提供另外三条通道，任何能发 HTTP 请求的 Agent 都能直接用：

| 通道 | 地址 | 说明 |
| --- | --- | --- |
| REST API | `https://qifukexue.com/qifu-agent/api/v1` | 9 个只读端点，JSON |
| OpenAPI | `https://qifukexue.com/qifu-agent/openapi-v1.json` | 3.1 描述文件，可导入支持 OpenAPI 的客户端 |
| MCP | `https://qifukexue.com/qifu-agent/mcp` | Streamable HTTP，7 个工具，无需鉴权 |
| RSS | `https://qifukexue.com/feed.xml` | 精选；另有 `/feed/all.xml` 等频道 |
| 机读索引 | `https://qifukexue.com/llms.txt` | 给 Agent 读的站点说明 |

MCP 接入：

```bash
claude mcp add --transport http qifu-news https://qifukexue.com/qifu-agent/mcp
codex mcp add qifu-news --url https://qifukexue.com/qifu-agent/mcp
```

---

## 五、卸载

```bash
bash install.sh --target all --uninstall
```

手工卸载即删除技能目录（若为软链接，删链接即可，真身保留在 `~/.agents/skills/qifu-news`）：

```bash
rm -rf ~/.agents/skills/qifu-news
```

---

## 六、授权与边界

- 个人使用、学习研究、公益用途：**免费**，无需申请。
- 向最终用户展示时，**必须署名「企服科学」并附原文链接**。
- 正文不得整篇搬运；需要正文时只做要点转述。
- 对外商业化分发、白标转售、整站镜像或批量再分发：**需事先书面授权**。
- 联系方式见站内页脚；询价请注明用途与预计调用量。
- 服务条款与数据口径：<https://qifukexue.com/qifu-agent/>

---

## 七、常见问题

**装完 Agent 没反应？** 开新会话。技能目录通常在会话启动时扫描一次。

**只有一个客户端生效？** 用 `--target all`，或手动补软链接：
`ln -s ~/.agents/skills/qifu-news ~/.claude/skills/qifu-news`

**接口报 429 或超时？** 限流为 10 请求/秒、突发 60。批量取数请复用一次响应，不要逐条请求。

**数据有多新？** 边缘缓存 3 至 5 分钟，刚发布的稿件会略有延迟。

**能取多早的稿？** 全站 4000 余篇可回溯，默认窗口 7 天，显式传 `window=all` 才不限时间。