# Fr Cpt

> Use when editing FineReport `.cpt` files after the datasource, target path, and creation or pull prerequisites are clear. Trigger for CPT layout, dataset XML, parameters, table headers, and cell-level report edits.

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

---


# FineReport CPT 编辑

## Overview

Use this skill for local `.cpt` editing only after datasource evidence is ready. It covers dataset XML, parameters, table layout, and report cell changes.

## Inputs

- Confirmed local `.cpt` 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-cpt/scripts/run.py reportlets/<目标文件>.cpt`
- Windows: `py .codex\\skills\\fr-cpt\\scripts\\run.py reportlets\\<目标文件>.cpt`

## Example Index

- `examples/README.md`
  - 先看这里，按“业务列表 / 综合模板 / 空白骨架”选样本
- `examples/live-remote-patterns.md`
  - 需要直接抄 XML 块，例如 SQL、参数面板、高亮、公式、样式、超链接时看这个

## Expected Evidence

- Edited CPT path
- Changed sections or XML blocks
- Datasource linkage summary

## Failure Handling

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

## Next Skill

- `fr-upload-sync`