Skip to content

anbeime/skill / projects/companion-simple

xiaoyue-companion

Verified

专为软件开发工程师与综合办公文员打造。当你在等待任务执行、工作疲惫或需要鼓励时,使用此技能通过智谱AI自动生成温暖对话回应与场景配图,一键获取专属情绪价值与虚拟陪伴,让AI助手更懂你。

FileKindSize
.gitignoreother603 B
API_INTEGRATION.mdmarkdown4.3 KB
DEMO-SUCCESS.mdmarkdown4.3 KB
DEPLOYMENT_CHECKLIST.mdmarkdown5.8 KB
DEPLOYMENT_GUIDE.mdmarkdown6.0 KB
FINAL-SUMMARY.mdmarkdown1.3 KB
PROJECT_SUMMARY.mdmarkdown5.3 KB
QUICKSTART.mdmarkdown4.8 KB
README-FINAL.mdmarkdown3.1 KB
README.mdmarkdown10.5 KB
SKILL.mdskill md6.6 KB
SUMMARY.mdmarkdown3.1 KB
USAGE-GUIDE.mdmarkdown5.9 KB
XIAOYI-README.mdmarkdown5.1 KB
api_client.pyscript5.5 KB
api_server_example.pyscript6.3 KB
config.pyscript859 B
crawler.pyscript4.6 KB
data/last_update.txtmarkdown26 B
data/local_skills.jsonconfig5.4 KB
data/skills.jsonconfig66.5 KB
data_manager.pyscript4.6 KB
docs/D盘tool目录整理完成报告.mdmarkdown15.8 KB
docs/技能数量差异分析报告.mdmarkdown7.0 KB
docs/技能清理与迁移指南.mdmarkdown14.6 KB
docs/技能管理数据库.mdmarkdown32.1 KB
docs/整理完成总结.mdmarkdown5.7 KB
main.pyscript5.0 KB
package-lock.jsonmanifest103 B
public/index-en.htmlother9.9 KB
public/index.htmlother11.1 KB
public/local-skills.htmlother8.4 KB
public/skills-en.htmlother16.7 KB
public/skills.htmlother28.0 KB
public/styles.cssother6.6 KB
requirements.txtmanifest140 B
run_once.batscript560 B
scheduler.pyscript4.2 KB
scripts/xiaoyi-chat.ps1script1.7 KB
scripts/xiaoyue-chat.jsscript2.8 KB
scripts/xiaoyue-chat.ps1script1.5 KB
scripts/xiaoyue-companion.shscript2.2 KB
setup_scheduled_task.ps1script1.0 KB
start_daemon.batscript771 B
templates/soul-injection.mdmarkdown1.8 KB
vercel.jsonconfig371 B
技能清单.mdmarkdown2.7 KB

API_INTEGRATION.md

View on GitHub
# API 集成指南

## 概述

本系统支持将爬取的技能数据自动推送到技能商店 API。

## 配置 API

编辑 `config.py` 文件:

```python
# 技能商店 API 配置
SKILL_STORE_API_URL = "https://your-api-server.com/api/skills"
SKILL_STORE_API_KEY = "your_api_key_here"
```

## API 接口规范

### 1. 批量推送技能

**端点**: `POST /api/skills/batch`

**请求体**:
```json
{
  "skills": [
    {
      "name": "anthropics/docx",
      "description": "Create, edit, and analyze Word documents",
      "link": "https://github.com/anthropics/skills/tree/main/skills/docx",
      "category": "Document Creation",
      "source": "VoltAgent/awesome-agent-skills",
      "crawled_at": "2026-02-02T10:30:00"
    }
  ]
}
```

**响应**:
```json
{
  "success": true,
  "added": 182,
  "message": "Skills imported successfully"
}
```

### 2. 获取技能列表

**端点**: `GET /api/skills`

**响应**:
```json
{
  "skills": [
    {
      "name": "anthropics/docx",
      "description": "...",
      "link": "...",
      "category": "..."
    }
  ],
  "total": 182
}
```

### 3. 更新单个技能

**端点**: `PUT /api/skills/{skill_name}`

**请求体**:
```json
{
  "name": "anthropics/docx",
  "description": "Updated description",
  "link": "...",
  "category": "..."
}
```

### 4. 删除技能

**端点**: `DELETE /api/skills/{skill_name}`

## 启用 API 同步

修改 `main.py`,在创建调度器时启用 API 同步:

```python
# 启用 API 同步
scheduler = UpdateScheduler(enable_api_sync=True)
```

## 示例:Flask API 服务器

创建一个简单的 Flask API 服务器接收技能数据:

```python
# api_server.py
from flask import Flask, request, jsonify
import json
import os

app = Flask(__name__)
SKILLS_FILE = 'skills_store.json'

def load_skills():
    if os.path.exists(SKILLS_FILE):
        with open(SKILLS_FILE, 'r', encoding='utf-8') as f:
            return json.load(f)
    return {'skills': []}

def save_skills(data):
    with open(SKILLS_FILE, 'w', encoding='utf-8') as f:
        json.dump(data, f, ensure_ascii=False, indent=2)

@app.route('/api/skills', methods=['GET'])
def get_skills():
    data = load_skills()
    return jsonify(data)

@app.route('/api/skills/batch', methods=['POST'])
def batch_import():
    data = request.json
    skills = data.get('skills', [])
    
    store = load_skills()
    store['skills'] = skills
    store['total'] = len(skills)
    save_skills(store)
    
    return jsonify({
        'success': True,
        'added': len(skills),
        'message': 'Skills imported successfully'
    })

@app.route('/api/skills/<skill_name>', methods=['PUT'])
def update_skill(skill_name):
    skill_data = request.json
    store = load_skills()
    
    # 查找并更新
    for i, skill in enumerate(store['skills']):
        if skill['name'] == skill_name:
            store['skills'][i] = skill_data
            save_skills(store)
            return jsonify({'success': True})
    
    # 不存在则添加
    store['skills'].append(skill_data)
    save_skills(store)
    return jsonify({'success': True, 'created': True})

@app.route('/api/skills/<skill_name>', methods=['DELETE'])
def delete_skill(skill_name):
    store = load_skills()
    store['skills'] = [s for s in store['skills'] if s['name'] != skill_name]
    save_skills(store)
    return jsonify({'success': True})

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000)
```

运行服务器:
```bash
pip install flask
python api_server.py
```

## 测试 API 集成

```bash
# 1. 启动 API 服务器
python api_server.py

# 2. 配置 config.py
SKILL_STORE_API_URL = "http://localhost:8000/api/skills"

# 3. 运行更新(启用 API 同步)
python main.py --once --api-sync
```

## 安全建议

1. **使用 HTTPS**: 生产环境必须使用 HTTPS
2. **API 密钥认证**: 在请求头中添加 `Authorization: Bearer YOUR_API_KEY`
3. **速率限制**: 实现 API 速率限制防止滥用
4. **数据验证**: 服务器端验证所有输入数据
5. **日志记录**: 记录所有 API 请求用于审计

## 故障处理

### API 连接失败
- 检查 API URL 配置
- 验证网络连接
- 查看日志文件 `logs/updater.log`

### 认证失败
- 确认 API Key 正确
- 检查 API Key 权限

### 数据同步不一致
- 手动触发完整同步
- 检查数据格式是否匹配
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall