10 KiB
10 KiB
name, description, domain, version, tags, triggers
| name | description | domain | version | tags | triggers | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| simple-llm | 简单的 LLM 请求 - 明确上下文、明确需求结果，不支持推理/工具调用/复杂过程，支持 1M 上下文和图片识别 | utilities | 1.2.0 |
|
|
Simple LLM
简单的 LLM 请求工具，适用于明确上下文和明确需求结果的场景。
特点
| 特性 | 说明 |
|---|---|
| 上下文 | 支持 1M tokens |
| 成本 | 本地部署，无 token 成本 |
| 功能 | 文本生成 + 图片识别/分析 |
| 限制 | 不支持推理、工具调用、复杂过程 |
API 配置
Endpoint: https://one.hao.work/v1/chat/completions
Model: qwen3.5-plus
Auth: Bearer sk-2e51c350efdeb41e27fcea4c3116567e514435db291b291e
图片上传服务
本地图片需要先上传获取 URL，再传给 LLM 识别。
上传 API
curl -u admin:whoami139 \
-F "file=@/path/to/image.png" \
https://img.hao.work/upload
| 参数 | 说明 |
|---|---|
| file | 图片或 JSON 文件 |
| ttl_days | 可选，默认 90 天，小于 90 天按 90 天保存 |
返回示例
{"filename":"abc123.png","size":12345,"url":"https://img.hao.work/images/abc123.png"}
本地图片处理流程
┌─────────────────────────────────────────────────────────────┐
│ 本地图片识别流程 │
│ │
│ ┌─────────────┐ │
│ │ 本地图片路径 │ │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 上传到图床 │ curl -u admin:whoami139 -F "file=@..." │
│ │ img.hao.work│ │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 获取图片URL │ https://img.hao.work/images/xxx.png │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 调用LLM识别 │ image_url + prompt │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 返回结果 │ │
│ └─────────────┘ │
└─────────────────────────────────────────────────────────────┘
使用方式
文本请求
curl -X POST https://one.hao.work/v1/chat/completions \
-H "Authorization: Bearer sk-2e51c350efdeb41e27fcea4c3116567e514435db291b291e" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.5-plus",
"messages": [{"role": "user", "content": "<你的提示词>"}],
"stream": true
}'
图片识别请求
curl -X POST https://one.hao.work/v1/chat/completions \
-H "Authorization: Bearer sk-2e51c350efdeb41e27fcea4c3116567e514435db291b291e" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.5-plus",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "<你的问题或指令>"},
{"type": "image_url", "image_url": {"url": "https://example.com/image.png"}}
]
}],
"stream": true
}'
多图片请求
curl -X POST https://one.hao.work/v1/chat/completions \
-H "Authorization: Bearer sk-2e51c350efdeb41e27fcea4c3116567e514435db291b291e" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.5-plus",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "对比这两张图片的区别"},
{"type": "image_url", "image_url": {"url": "https://example.com/image1.png"}},
{"type": "image_url", "image_url": {"url": "https://example.com/image2.png"}}
]
}],
"stream": true
}'
自动任务分配机制
当主模型接收到任务时，自动评估是否适合委托给 Simple LLM：
任务适配规则
┌─────────────────────────────────────────────────────────────┐
│ 任务分发决策 │
│ │
│ 收到任务 │
│ │ │
│ ▼ │
│ ┌─────────────┐ 否 ┌─────────────┐ │
│ │ 是否需要推理? │ ──────→ │ 主模型处理 │ │
│ └─────────────┘ └─────────────┘ │
│ │是 │
│ ▼ │
│ ┌─────────────┐ 是 ┌─────────────┐ │
│ │ 是否需要工具? │ ──────→ │ 主模型处理 │ │
│ └─────────────┘ └─────────────┘ │
│ │否 │
│ ▼ │
│ ┌─────────────┐ 是 ┌─────────────┐ │
│ │ 是否多步骤? │ ──────→ │ 主模型处理 │ │
│ └─────────────┘ └─────────────┘ │
│ │否 │
│ ▼ │
│ ┌─────────────┐ │
│ │ Simple LLM │ ──→ 执行 → 评估 → 记录结果 │
│ └─────────────┘ │
└─────────────────────────────────────────────────────────────┘
适合自动分配的任务类型
| 类型 | 示例 | 优先级 |
|---|---|---|
| 文本总结 | 总结这篇文章的核心观点 | 高 |
| 翻译 | 将这段文字翻译成英文 | 高 |
| 格式转换 | 将 JSON 转成 YAML | 高 |
| 代码解释 | 这段代码做了什么 | 中 |
| 图片描述 | 描述这张图片的内容 | 高 |
| OCR | 识别图片中的文字 | 高 |
| 简单分析 | 分析这段文字的情感倾向 | 中 |
| 改写润色 | 改写这段文字使其更专业 | 中 |
不适合分配的任务
- 需要多轮对话推理
- 需要调用外部工具/API
- 需要文件系统操作
- 需要代码执行验证
- 复杂的规划和决策
效果评估与记录
评估标准
执行完成后，按以下标准评估效果：
评估维度:
准确性: 输出是否正确回答了问题 (1-5)
完整性: 输出是否覆盖了所有要求 (1-5)
格式: 输出格式是否符合预期 (1-5)
速度: 响应是否及时 (1-5)
综合评分: (准确性 + 完整性 + 格式) / 3
记录机制
在 ~/.agents/skills/simple-llm/records.json 中记录：
{
"task_records": [
{
"id": "task_001",
"timestamp": "2026-02-26T10:00:00Z",
"task_type": "summarize",
"prompt": "总结以下文章...",
"result_quality": 4.5,
"success": true,
"notes": "总结准确，要点清晰"
}
],
"type_stats": {
"summarize": {"count": 10, "avg_quality": 4.3},
"translate": {"count": 15, "avg_quality": 4.5},
"ocr": {"count": 5, "avg_quality": 4.0}
}
}
优先级调整
根据历史记录动态调整任务分配优先级：
if (任务类型 in type_stats && avg_quality >= 4.0) {
优先分配给 Simple LLM
} else if (任务类型 in type_stats && avg_quality < 3.0) {
优先使用主模型
} else {
首次尝试 Simple LLM，记录结果
}
示例模板
文本总结
请总结以下文章的核心内容，用 3-5 个要点表示：
[文章内容]
要求：
- 每个要点不超过 50 字
- 保留关键数据和结论
图片识别
识别这张图片中的所有文字，按原文排版输出：
[图片URL]
要求：
- 保持原始排版
- 标注不确定的文字
翻译
将以下内容翻译成英文：
[内容]
要求：
- 保持原文语气
- 专业术语保持准确
注意事项
- 充分利用 1M 上下文 - 可以传入大段文本，无需担心 token 限制
- 图片支持 - 通过 image_url 传入图片链接进行识别
- 避免复杂指令 - 单步任务效果最佳
- 明确输出格式 - 让模型清楚知道期望的输出形式
- 效果反馈 - 执行后评估效果，用于优化后续任务分配