什么是 YouTrack 项目与账单管理器？

YouTrack 集成通过其 REST API 提供了一个与 YouTrack 项目管理系统交互的强大接口。它使开发人员能够直接通过脚本或 AI 代理无缝读取项目、管理问题并处理知识库文章。通过利用 Openclaw Skills，该工具简化了手动项目监督和数据检索这一通常繁琐的过程。

其中一个突出的功能是集成的发票生成系统。它根据时间跟踪数据自动计算计费金额，确保根据可自定义的时薪和特定的舍入逻辑向客户准确计费。这使其成为需要使用 Openclaw Skills 桥接项目执行与财务报告之间鸿沟的自由职业者和代理机构的必备工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/digisal/youtrack-digisal

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

YouTrack 项目与账单管理器 应用场景

• 自动检索项目列表和问题详情，用于状态报告。
• 直接通过 CLI 或代理以编程方式创建和更新任务及错误报告。
• 根据 YouTrack 工作项和时间日志生成每月客户发票。
• 为了文档记录目的同步或读取内部知识库文章。
• 在 Openclaw Skills 生态系统中监控特定团队成员的问题分配和更新。

1. 该技能使用作为环境变量存储的永久 API 令牌与 YouTrack REST API 进行身份验证。
2. 用户可以触发核心 API 客户端脚本，使用 YouTrack 原生查询语言查询项目、问题或文章。
3. 对于计费，发票生成器会获取特定项目和日期范围的工作项（时间日志）。
4. 逻辑将时间数据处理为 30 分钟的增量，并应用 30 分钟的最低收费。
5. 最终输出以文本形式的发票或原始数据生成，可直接交付给客户或通过 Openclaw Skills 进一步处理。

YouTrack 项目与账单管理器 配置指南

首先，在 YouTrack 的“管理 > 访问管理 > 用户”下生成一个永久令牌。然后，设置环境变量：

export YOUTRACK_TOKEN=your-permanent-token-here

列出项目，运行：

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects

要生成发票，请使用发票生成器脚本：

python3 scripts/invoice_generator.py --url https://your-instance.youtrack.cloud --project MyProject --month "January 2026" --from-date "2026-01-01"

YouTrack 项目与账单管理器 数据架构与分类体系

该技能与以下结构的几个 YouTrack 实体进行交互：

name: youtrack
description: Interact with YouTrack project management system via REST API. Read projects and issues, create tasks, generate invoices from time tracking data, and manage knowledge base articles. Use for reading projects and work items, creating or updating issues, generating client invoices from time tracking, and working with knowledge base articles.

YouTrack

YouTrack integration for project management, time tracking, and knowledge base.

Quick Start

Authentication

To generate a permanent token:

1. From the main navigation menu, select Administration > Access Management > Users
2. Find your user and click to open settings
3. Generate a new permanent API token
4. Set the token as an environment variable:

export YOUTRACK_TOKEN=your-permanent-token-here

Important: Configure your hourly rate (default $100/hour) by passing --rate to invoice_generator.py or updating hourly_rate parameter in your code.

Then use any YouTrack script:

# List all projects
python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects

# List issues in a project
python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject"

# Generate invoice for a project
python3 scripts/invoice_generator.py --url https://your-instance.youtrack.cloud --project MyProject --month "January 2026" --from-date "2026-01-01"

Python Scripts

scripts/youtrack_api.py

Core API client for all YouTrack operations.

In your Python code:

from youtrack_api import YouTrackAPI

api = YouTrackAPI('https://your-instance.youtrack.cloud', token='your-token')

# Projects
projects = api.get_projects()
project = api.get_project('project-id')

# Issues
issues = api.get_issues(query='project: MyProject')
issue = api.get_issue('issue-id')

# Create issue
api.create_issue('project-id', 'Summary', 'Description')

# Work items (time tracking)
work_items = api.get_work_items('issue-id')
issue_with_time = api.get_issue_with_work_items('issue-id')

# Knowledge base
articles = api.get_articles()
article = api.get_article('article-id')
api.create_article('project-id', 'Title', 'Content')

CLI usage:

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud r
    --token YOUR_TOKEN r
    --list-projects

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud r
    --get-issue ABC-123

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud r
    --get-articles

scripts/invoice_generator.py

Generate client invoices from time tracking data.

In your Python code:

from youtrack_api import YouTrackAPI
from invoice_generator import InvoiceGenerator

api = YouTrackAPI('https://your-instance.youtrack.cloud', token='your-token')
generator = InvoiceGenerator(api, hourly_rate=100.0)

# Get time data for a project
project_data = generator.get_project_time_data('project-id', from_date='2026-01-01')

# Generate invoice
invoice_text = generator.generate_invoice_text(project_data, month='January 2026')
print(invoice_text)

CLI usage:

python3 scripts/invoice_generator.py r
    --url https://your-instance.youtrack.cloud r
    --project MyProject r
    --from-date 2026-01-01 r
    --month "January 2026" r
    --rate 100 r
    --format text

Save the text output and print to PDF for clients.

Common Workflows

1. List All Projects

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects

2. Find Issues in a Project

# All issues in a project
python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject"

# Issues updated since a date
python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject updated >= 2026-01-01"

# Issues assigned to you
python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "assignee: me"

3. Create a New Issue

from youtrack_api import YouTrackAPI

api = YouTrackAPI('https://your-instance.youtrack.cloud')
api.create_issue(
    project_id='MyProject',
    summary='Task title',
    description='Task description'
)

4. Generate Monthly Invoice

# Generate invoice for January 2026
python3 scripts/invoice_generator.py r
    --url https://your-instance.youtrack.cloud r
    --project ClientProject r
    --from-date 2026-01-01 r
    --month "January 2026" r
    --rate 100 r
    --format text > invoice.txt

Save the text output and print to PDF for clients.

5. Read Knowledge Base

from youtrack_api import YouTrackAPI

api = YouTrackAPI('https://your-instance.youtrack.cloud')

# All articles
articles = api.get_articles()

# Articles for specific project
articles = api.get_articles(project_id='MyProject')

# Get specific article
article = api.get_article('article-id')

Billing Logic

Invoice generator uses this calculation:

1. Sum all time tracked per issue (in minutes)
2. Convert to 30-minute increments (round up)
3. Minimum charge is 30 minutes (at configured rate/2)
4. Multiply by rate (default $100/hour = $50 per half-hour)

Examples:

• 15 minutes → $50 (30 min minimum)
• 35 minutes → $100 (rounded to 60 min)
• 60 minutes → $100
• 67 minutes → $150 (rounded to 90 min)

Environment Variables

• YOUTRACK_TOKEN: Your permanent API token (recommended over passing as argument)
• Set with export YOUTRACK_TOKEN=your-token

API Details

See REFERENCES.md for:

• Complete API endpoint documentation
• Query language examples
• Field IDs and structures

Error Handling

Scripts will raise errors for:

• Missing or invalid token
• Network issues
• API errors (404, 403, etc.)

Check stderr for error details.