# Fr Fvs

> Use when editing FineReport `.fvs` files after datasource, target path, and creation or pull prerequisites are clear. Trigger for FVS tree structure, view definitions, and grouping or aggregation changes.

- Skill: `ninestep/fr-fvs` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add ninestep/fr-fvs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ninestep/fr-fvs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ninestep (https://skillmd.com/u/ninestep)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ninestep/fr-fvs

---


# FineReport FVS 编辑

## Overview

Use this skill for local `.fvs` editing after the project config and datasource evidence are already confirmed.

## Inputs

- Confirmed local `.fvs` path
- Datasource or field evidence from `fr-db`
- Remote freshness evidence from `fr-download-sync` or `fr-create`

## Execution

- macOS / Linux: `python3 .codex/skills/fr-fvs/scripts/run.py reportlets/<目标文件>.fvs`
- Windows: `py .codex\\skills\\fr-fvs\\scripts\\run.py reportlets\\<目标文件>.fvs`

## Example Index

- `examples/README.md`
  - 先看这里，按“结构速查 / 图表类型速查”选入口
- `examples/chart-type-cookbook.md`
  - 需要先判断饼图、柱图、折线图、地图、仪表盘时直接看这个

## Expected Evidence

- Edited FVS path
- Changed view or grouping sections
- Datasource linkage summary

## Failure Handling

- Do not guess datasource names or field names
- Stop if the target is not a `.fvs`
- Stop if remote freshness was not established

## Next Skill

- `fr-upload-sync`