> 功能说明: 本技能涵盖 中文交互 等核心能力。
> 功能说明: 本技能涵盖 化集成场景 等核心能力。
Book Painter
付费版扩展能力
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 高清分辨率与无损输出 | 不支持 | 支持 |
| 批量生成与风格预设 | 不支持 | 支持 |
| 自定义模型微调 | 不支持 | 支持 |
| 商用版权授权 | 不支持 | 支持 |
应用场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 场景1 经Lokuli协议预约油漆工 | 用户请求数据 | 结构化处理结果 |
| 场景2 找到并下单本地画师服务 | 用户请求数据 | 结构化处理结果 |
不适用于：需要人工判断的复杂决策场景
输入规范
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | 处理的内容输入 |
| mode | string | 否 | 处理模式, 可选值: json/text/markdown |
| style | string | 否 | 输出风格, 参考 references/style.md |
返回格式
{
"success": true,
"data": {
"result": "处理结果",
"status": "success",
"metadata": {
"metadata": {
"template_used": "reviewer",
"word_count": 0,
"style": "专业"
}
},
"error": null
}
输出模板参考: assets/output.json
安装与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
创新优势
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 画师搜索 | 2小时 | 5分钟 | 1小时55分钟 | 5% |
| 订单提交 | 30分钟 | 5分钟 | 25分钟 | 3% |
| 作品修改 | 1小时 | 15分钟 | 45分钟 | 2% |
| 质量审核 | 2小时 | 30分钟 | 1小时30分钟 | 4% |
| 用户反馈处理 | 1小时 | 10分钟 | 50分钟 | 1% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 操作便捷性 | 高 | 低 | 中 | 高 |
| 速度 | 快 | 慢 | 较快 | 快 |
| 成本 | 低 | 高 | 中 | 高 |
| 个性化定制 | 高 | 低 | 中 | 高 |
| 可扩展性 | 高 | 低 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 画师资源获取困难 | 用户难以找到合适的画师 | 影响用户体验和项目进度 | 通过Lokuli协议快速预约画师 | 提高用户满意度20% |
| 订单处理效率低 | 手动处理订单耗时较长 | 影响工作效率和客户满意度 | 自动化订单处理流程 | 提高工作效率30% |
| 作品质量难以保证 | 手动审核作品质量耗时且效率低 | 影响作品质量和用户满意度 | 自动化质量审核流程 | 提高作品质量15% |
常见问题FAQ
Q1: 如何使用Book Painter找到合适的画师？
A: 通过Lokuli协议，Book Painter可以快速搜索并预约本地画师，用户只需提供需求描述，系统会自动匹配合适的画师。
Q2: Book Painter支持哪些风格的作品？
A: Book Painter支持多种风格的作品，用户可以在调用技能时指定输出风格，参考 references/style.md 了解具体风格。
Q3: Book Painter的输出质量如何？
A: Book Painter输出的作品质量高，经过智能算法优化，能够满足大多数用户的需求。
Q4: Book Painter的API Key如何配置？
A: 在依赖说明中提供了API Key的配置方法，用户只需按照说明进行配置即可。
Q5: Book Painter适用于哪些场景？
A: Book Painter适用于需要AI模型调用、智能对话、Agent编排、LLM应用等场景，特别适合独立开发者、企业团队和自动化工作流。
安全规范
- 确保API Key安全，避免泄露到公共或版本控制系统中。
- 对用户输入进行验证，防止恶意输入导致系统异常。
- 定期更新系统依赖，确保系统安全。
- 限制API调用频率，防止滥用。
- 对敏感数据进行加密处理，确保用户隐私安全。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置，禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令，避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议，验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限，实施认证机制 | 定期审计访问日志 |
错误应对体系
针对书籍画师使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
书籍画师通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
上线流程
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
