{"owner":"Guovin","repo":"iptv-api","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Repository agent guidelines\n\n## Test execution\n\n- For a focused code change, run only the directly related test module(s)\n  before reporting completion.\n- Run the full suite (`pipenv run python -m unittest discover -s tests -v`)\n  for release work, shared-module changes, or when requested by the user.\n- Keep CI's existing full suite for now: it is deterministic and completes in\n  seconds locally. Do not split it into separate jobs unless a measured slow\n  test category emerges.\n\n## Code comments\n\n- Do not add non-essential comments that explain a fix, patch rationale, or\n  transient implementation detail. Add comments only when needed for function\n  definitions, key classes or public interfaces, or genuinely complex logic\n  that would otherwise be difficult to understand.\n\n## GUI screenshot updates\n\n- Regenerate the checked-in Chinese and English GUI screenshots only when a\n  change visibly affects the desktop GUI home page (Dashboard) as it appears\n  in the light or dark variants under `docs/images/desktop-ui*.png`.\n- Home-page changes include visible Dashboard cards, tables, status or stream\n  indicators, collapsed navigation, localization, typography, colors,\n  spacing, window layout, or showcase data displayed in those two images.\n- Do not regenerate the checked-in screenshots for changes limited to other\n  pages, channel drawers or tables, dialogs, menus, settings, tasks, RTMP\n  views, interaction behavior, backend code, or other content not visible in\n  the home-page screenshots.\n- For non-home GUI changes, use targeted temporary screenshots when visual\n  verification is useful, but do not update the checked-in home-page images.\n- Keep GUI screenshot generators, fixtures, and demo assets under\n  `scripts/gui_showcase/`.\n- Screenshot tooling must not be imported by production modules under\n  `desktop_ui/`, `service/`, `utils/`, or `main.py`.\n- Exclude `scripts/gui_showcase/` from Docker build contexts and GUI packaging\n  artifacts. Exclude screenshot-specific validation tests from Docker images,\n  and do not add fixtures or generated assets to PyInstaller `datas`.\n- Demo generation must use temporary directories and must not modify user\n  configuration, `config/`, or `output/`.\n- When home-page regeneration is required, generate both Chinese and English\n  screenshots in both light and dark themes, then verify demo data, service\n  status, stream states, local logos, collapsed navigation, window focus, and\n  native title-bar controls.\n- The checked-in home-page screenshots should show the Dashboard cards in the\n  simulated running visual state, including glass/activity colors and progress\n  controls. The showcase generator must use Dashboard UI-state injection only;\n  it must not call the real update workflow, start update threads, make network\n  requests, or invoke FFmpeg.\n- After setting the simulated running state, wait for at least one activity\n  animation frame before capturing. Validate that the dashboard is running,\n  progress is non-zero, and pause/cancel controls are visible.\n- Visually inspect regenerated screenshots before staging or committing them.\n- CI may report stale screenshots or validate fixtures, but must not\n  automatically commit regenerated binary assets.\n- When packaging rules change, verify that screenshot tooling is absent from\n  both Docker images and GUI distributions.\n"},"files":{"AGENTS.md":"# Repository agent guidelines\n\n## Test execution\n\n- For a focused code change, run only the directly related test module(s)\n  before reporting completion.\n- Run the full suite (`pipenv run python -m unittest discover -s tests -v`)\n  for release work, shared-module changes, or when requested by the user.\n- Keep CI's existing full suite for now: it is deterministic and completes in\n  seconds locally. Do not split it into separate jobs unless a measured slow\n  test category emerges.\n\n## Code comments\n\n- Do not add non-essential comments that explain a fix, patch rationale, or\n  transient implementation detail. Add comments only when needed for function\n  definitions, key classes or public interfaces, or genuinely complex logic\n  that would otherwise be difficult to understand.\n\n## GUI screenshot updates\n\n- Regenerate the checked-in Chinese and English GUI screenshots only when a\n  change visibly affects the desktop GUI home page (Dashboard) as it appears\n  in the light or dark variants under `docs/images/desktop-ui*.png`.\n- Home-page changes include visible Dashboard cards, tables, status or stream\n  indicators, collapsed navigation, localization, typography, colors,\n  spacing, window layout, or showcase data displayed in those two images.\n- Do not regenerate the checked-in screenshots for changes limited to other\n  pages, channel drawers or tables, dialogs, menus, settings, tasks, RTMP\n  views, interaction behavior, backend code, or other content not visible in\n  the home-page screenshots.\n- For non-home GUI changes, use targeted temporary screenshots when visual\n  verification is useful, but do not update the checked-in home-page images.\n- Keep GUI screenshot generators, fixtures, and demo assets under\n  `scripts/gui_showcase/`.\n- Screenshot tooling must not be imported by production modules under\n  `desktop_ui/`, `service/`, `utils/`, or `main.py`.\n- Exclude `scripts/gui_showcase/` from Docker build contexts and GUI packaging\n  artifacts. Exclude screenshot-specific validation tests from Docker images,\n  and do not add fixtures or generated assets to PyInstaller `datas`.\n- Demo generation must use temporary directories and must not modify user\n  configuration, `config/`, or `output/`.\n- When home-page regeneration is required, generate both Chinese and English\n  screenshots in both light and dark themes, then verify demo data, service\n  status, stream states, local logos, collapsed navigation, window focus, and\n  native title-bar controls.\n- The checked-in home-page screenshots should show the Dashboard cards in the\n  simulated running visual state, including glass/activity colors and progress\n  controls. The showcase generator must use Dashboard UI-state injection only;\n  it must not call the real update workflow, start update threads, make network\n  requests, or invoke FFmpeg.\n- After setting the simulated running state, wait for at least one activity\n  animation frame before capturing. Validate that the dashboard is running,\n  progress is non-zero, and pause/cancel controls are visible.\n- Visually inspect regenerated screenshots before staging or committing them.\n- CI may report stale screenshots or validate fixtures, but must not\n  automatically commit regenerated binary assets.\n- When packaging rules change, verify that screenshot tooling is absent from\n  both Docker images and GUI distributions.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Repository agent guidelines\n\n## Test execution\n\n- For a focused code change, run only the directly related test module(s)\n  before reporting completion.\n- Run the full suite (`pipenv run python -m unittest discover -s tests -v`)\n  for release work, shared-module changes, or when requested by the user.\n- Keep CI's existing full suite for now: it is deterministic and completes in\n  seconds locally. Do not split it into separate jobs unless a measured slow\n  test category emerges.\n\n## Code comments\n\n- Do not add non-essential comments that explain a fix, patch rationale, or\n  transient implementation detail. Add comments only when needed for function\n  definitions, key classes or public interfaces, or genuinely complex logic\n  that would otherwise be difficult to understand.\n\n## GUI screenshot updates\n\n- Regenerate the checked-in Chinese and English GUI screenshots only when a\n  change visibly affects the desktop GUI home page (Dashboard) as it appears\n  in the light or dark variants under `docs/images/desktop-ui*.png`.\n- Home-page changes include visible Dashboard cards, tables, status or stream\n  indicators, collapsed navigation, localization, typography, colors,\n  spacing, window layout, or showcase data displayed in those two images.\n- Do not regenerate the checked-in screenshots for changes limited to other\n  pages, channel drawers or tables, dialogs, menus, settings, tasks, RTMP\n  views, interaction behavior, backend code, or other content not visible in\n  the home-page screenshots.\n- For non-home GUI changes, use targeted temporary screenshots when visual\n  verification is useful, but do not update the checked-in home-page images.\n- Keep GUI screenshot generators, fixtures, and demo assets under\n  `scripts/gui_showcase/`.\n- Screenshot tooling must not be imported by production modules under\n  `desktop_ui/`, `service/`, `utils/`, or `main.py`.\n- Exclude `scripts/gui_showcase/` from Docker build contexts and GUI packaging\n  artifacts. Exclude screenshot-specific validation tests from Docker images,\n  and do not add fixtures or generated assets to PyInstaller `datas`.\n- Demo generation must use temporary directories and must not modify user\n  configuration, `config/`, or `output/`.\n- When home-page regeneration is required, generate both Chinese and English\n  screenshots in both light and dark themes, then verify demo data, service\n  status, stream states, local logos, collapsed navigation, window focus, and\n  native title-bar controls.\n- The checked-in home-page screenshots should show the Dashboard cards in the\n  simulated running visual state, including glass/activity colors and progress\n  controls. The showcase generator must use Dashboard UI-state injection only;\n  it must not call the real update workflow, start update threads, make network\n  requests, or invoke FFmpeg.\n- After setting the simulated running state, wait for at least one activity\n  animation frame before capturing. Validate that the dashboard is running,\n  progress is non-zero, and pause/cancel controls are visible.\n- Visually inspect regenerated screenshots before staging or committing them.\n- CI may report stale screenshots or validate fixtures, but must not\n  automatically commit regenerated binary assets.\n- When packaging rules change, verify that screenshot tooling is absent from\n  both Docker images and GUI distributions.\n","category":"root","tokens":841}]}