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

QUICKSTART.md

View on GitHub
# 快速开始指南

## 🚀 5分钟快速部署

### 1. 安装依赖

```bash
cd C:\D\StepFun\skill_store_updater
pip install -r requirements.txt
```

### 2. 立即运行一次

```bash
python main.py --once
```

这将:
- 从 GitHub 爬取最新的 182+ 个技能
- 保存到 `data/skills.json`
- 生成日志到 `logs/updater.log`

### 3. 查看结果

```bash
# 查看统计
python main.py --stats

# 导出为 CSV
python main.py --export skills.csv
```

## 📋 完整功能

### 基础使用

```bash
# 单次更新
python main.py --once

# 后台持续运行(每24小时自动更新)
python main.py --daemon

# 查看统计
python main.py --stats

# 导出 CSV
python main.py --export output.csv

# 详细日志
python main.py --once -v
```

### 高级功能:API 同步

#### 步骤 1: 配置 API

编辑 `config.py`:

```python
SKILL_STORE_API_URL = "https://your-api.com/api/skills"
SKILL_STORE_API_KEY = "your_api_key"
```

#### 步骤 2: 启用 API 同步

```bash
python main.py --once --api-sync
```

#### 步骤 3: 测试 API(可选)

启动示例 API 服务器:

```bash
pip install flask flask-cors
python api_server_example.py
```

然后在另一个终端:

```bash
python main.py --once --api-sync
```

## 🔄 自动化部署

### Windows 任务计划程序

#### 方法 1: 使用 PowerShell 脚本

以管理员身份运行 PowerShell:

```powershell
.\setup_scheduled_task.ps1
```

#### 方法 2: 手动创建

1. 打开"任务计划程序"
2. 创建基本任务
3. 名称: `SkillStoreAutoUpdate`
4. 触发器: 每天凌晨 2:00
5. 操作: 启动程序
   - 程序: `python`
   - 参数: `C:\D\StepFun\skill_store_updater\main.py --once`
   - 起始于: `C:\D\StepFun\skill_store_updater`

### 使用批处理脚本

双击运行:

```bash
# 单次更新
run_once.bat

# 后台持续运行
start_daemon.bat
```

## 📊 数据格式

### JSON 输出

`data/skills.json`:

```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"
    }
  ],
  "total": 182,
  "updated_at": "2026-02-02T10:30:00"
}
```

### CSV 导出

```csv
name,description,link,category,source
anthropics/docx,Create edit and analyze Word documents,https://...,Document Creation,VoltAgent/awesome-agent-skills
```

## 🔧 配置选项

### `config.py` 主要配置

```python
# 更新频率(秒)
UPDATE_INTERVAL = 3600 * 24  # 24小时

# GitHub 仓库
GITHUB_RAW_README_URL = "https://raw.githubusercontent.com/..."

# 数据存储
DATA_DIR = "C:\\D\\StepFun\\skill_store_updater\\data"

# API 配置
SKILL_STORE_API_URL = "http://localhost:8000/api/skills"
SKILL_STORE_API_KEY = "your_api_key_here"
```

## 🐛 故障排查

### 问题 1: 爬取失败

```bash
# 检查网络连接
ping github.com

# 查看详细日志
python main.py --once -v
```

### 问题 2: 解析错误

```bash
# 查看日志
type logs\updater.log
```

### 问题 3: API 同步失败

```bash
# 测试 API 连接
curl http://localhost:8000/health

# 检查 API 配置
python -c "from config import SKILL_STORE_API_URL; print(SKILL_STORE_API_URL)"
```

## 📈 监控和维护

### 查看日志

```bash
# Windows
type logs\updater.log

# 实时监控
Get-Content logs\updater.log -Wait
```

### 数据备份

```bash
# 备份数据
copy data\skills.json data\skills_backup_%date:~0,10%.json
```

### 清理旧日志

```bash
# 删除 30 天前的日志
forfiles /p logs /s /m *.log /d -30 /c "cmd /c del @path"
```

## 🎯 使用场景

### 场景 1: 个人使用

```bash
# 每天手动更新一次
python main.py --once
```

### 场景 2: 团队共享

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

# 配置定时任务每天自动更新
.\setup_scheduled_task.ps1
```

### 场景 3: CI/CD 集成

```yaml
# .github/workflows/update-skills.yml
name: Update Skills
on:
  schedule:
    - cron: '0 2 * * *'  # 每天凌晨2点
jobs:
  update:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v2
      - name: Setup Python
        uses: actions/setup-python@v2
      - name: Install dependencies
        run: pip install -r requirements.txt
      - name: Update skills
        run: python main.py --once --api-sync
```

## 📚 更多文档

- [完整 README](README.md)
- [API 集成指南](API_INTEGRATION.md)
- [配置文件说明](config.py)

## 💡 提示

1. **首次运行**: 建议先运行 `python main.py --once -v` 查看详细过程
2. **定期备份**: 定期备份 `data/skills.json`
3. **监控日志**: 定期检查 `logs/updater.log` 确保正常运行
4. **API 测试**: 集成 API 前先用示例服务器测试
5. **网络问题**: 如遇网络问题,可调整 `RETRY_TIMES` 和 `RETRY_DELAY`
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