a65adcc2e5
Sources: extracted from two upstream archives (skill-repo, skills-main),
merged with the following policy:
- 15 broken symlinks (pointing to /Users/jameslee/.cc-switch/skills or
../../.agents/skills on a foreign machine) discarded
- 3 real name collisions with identical content (ai-pair, ifind-http-api,
zhipu-websearch) kept as one copy
- Functional overlaps deduped keeping the strongest variant:
- docx family: kept docx (official, full toolchain) + docx-cn
(GB/T 9704 Chinese official-document constants),
dropped docx_writer (no scripts, name collided with docx)
- humanizer family: kept humanizer-zh (6 zh reference docs),
dropped humanizer (en, redundant for CN workflow)
- Skills that only ran in a foreign environment removed:
ablemind-ops, app-publish, hlb-design-system, openclaw-adj-skill,
claude-driver
- alphapai excluded from this public repo because its SKILL.md hard-coded
live credentials
Result: 25 skills, 572 files, ~7.5 MB.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
265 lines
10 KiB
Markdown
265 lines
10 KiB
Markdown
# Layout: `comparison_cards` — 对比卡片（A vs B）
|
||
|
||
> 幻灯片尺寸: 13.333 × 7.5 英寸 | 边距: 0.6 英寸 | 内容宽: 12.133 英寸
|
||
|
||
---
|
||
|
||
## 用途
|
||
|
||
两家公司对比、方案A vs 方案B、Before/After、两只基金横向比较。
|
||
|
||
---
|
||
|
||
## ASCII 线框图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ [标题] y=0.25 │
|
||
│ ▬▬ (accent 装饰线) y=0.90 │
|
||
│ │
|
||
│ ┌──────────────────────────┐VS┌──────────────────────────┐ │
|
||
│ │ [left_color 顶部色带] │ │ [right_color 顶部色带] │ │
|
||
│ │ │ │ │ │
|
||
│ │ [Left Title] │ │ [Right Title] │ │
|
||
│ │ [Left Subtitle] │ │ [Right Subtitle] │ │
|
||
│ │ ─────────────────────── │ │ ─────────────────────── │ │
|
||
│ │ 指标A 3,521点 │ │ 指标A 3,089点 │ │
|
||
│ │ 指标B +12.3% │ │ 指标B +8.7% │ │
|
||
│ │ 指标C 0.85 │ │ 指标C 0.62 │ │
|
||
│ │ 指标D 2.15% │ │ 指标D 3.40% │ │
|
||
│ │ 指标E AA │ │ 指标E A │ │
|
||
│ └──────────────────────────┘ └──────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 精确坐标标注
|
||
|
||
### 固定元素
|
||
|
||
| 元素 | x | y | w | h | 字号 | 颜色 | 对齐 |
|
||
|------|---|---|---|---|------|------|------|
|
||
| 页面标题 | 0.60 | 0.25 | 12.133 | 0.60 | title_size-2 | text_dark | 左 |
|
||
| 装饰线 | 0.60 | 0.90 | 2.00 | 0.04 | — | accent | — |
|
||
|
||
### "VS" 中间分隔
|
||
|
||
| 元素 | x | y | w | h | 字号 | 颜色 | 对齐 |
|
||
|------|---|---|---|---|------|------|------|
|
||
| "VS" 文字 | 6.167 | 3.50 | 1.00 | 0.60 | subtitle_size+4 | text_muted | 中 |
|
||
| 中央竖线（可选） | 6.617 | 1.10 | 0.01 | 5.80 | — | border | — |
|
||
|
||
> VS 文字居中于两卡片之间间隙 (x≈6.167，间隙约1.0英寸)
|
||
|
||
### 卡片尺寸
|
||
|
||
```
|
||
vs_gap = 1.00 # VS 区域宽度
|
||
card_w = (12.133 - vs_gap) / 2 = 5.567"
|
||
left_x = 0.60
|
||
right_x = 0.60 + 5.567 + 1.00 = 7.167
|
||
card_y = 1.10
|
||
card_h = 5.80 (到 y=6.90)
|
||
```
|
||
|
||
### 左/右卡片内部结构（以左卡片 x=0.60 为例）
|
||
|
||
| 元素 | x（相对 card_x） | y | w | h | 字号 | 颜色 | 对齐 |
|
||
|------|-----------------|---|---|---|------|------|------|
|
||
| 卡片背景（圆角矩形） | +0 | 1.10 | 5.567 | 5.80 | — | card_bg | — |
|
||
| 顶部色带 | +0 | 1.10 | 5.567 | 0.08 | — | left_color / right_color | — |
|
||
| 卡片标题 | +0.20 | 1.28 | 5.167 | 0.55 | subtitle_size+2 | text_dark | 左 |
|
||
| 卡片副标题 | +0.20 | 1.88 | 5.167 | 0.40 | body_size | text_muted | 左 |
|
||
| 分隔线 | +0.20 | 2.35 | 5.167 | 0.02 | — | border | — |
|
||
| 指标区域（起始 y） | +0.20 | 2.50 | 5.167 | — | — | — | — |
|
||
|
||
**指标行（每行）**:
|
||
```
|
||
row_start_y = 2.50
|
||
row_h = 0.55 # 每行高度
|
||
max_rows = floor((6.90 - 2.50) / 0.55) = 8行（最多）
|
||
建议 5-7 行
|
||
```
|
||
|
||
| 元素 | x（相对 card_x） | y（相对 row_y） | w | h | 字号 | 颜色 | 对齐 |
|
||
|------|-----------------|----------------|---|---|------|------|------|
|
||
| 指标名称 | +0.20 | +0 | 2.80 | 0.40 | body_size | text_muted | 左 |
|
||
| 指标数值 | +3.00 | +0 | 2.37 | 0.40 | body_size | text_dark | 右 |
|
||
| 行间细线 | +0.20 | +0.47 | 5.167 | 0.01 | — | border | — |
|
||
|
||
**胜出方高亮规则**（当某指标某卡片更优时）:
|
||
- 数值颜色改为 `positive`（绿），`bold=True`
|
||
- 或在数值前加 ▲ 符号
|
||
- 或行背景加极浅的 `positive` 色（透明度 10%）
|
||
|
||
### 底部注释（可选）
|
||
|
||
| 元素 | x | y | w | h | 字号 | 颜色 |
|
||
|------|---|---|---|---|------|------|
|
||
| 来源说明 | 0.60 | 7.10 | 12.133 | 0.30 | caption_size | text_muted |
|
||
|
||
---
|
||
|
||
## 颜色约定
|
||
|
||
| 元素 | 默认值 | 说明 |
|
||
|------|--------|------|
|
||
| left_color | primary | 左卡片顶部色带 |
|
||
| right_color | secondary | 右卡片顶部色带（可自定义） |
|
||
| 胜出数值 | positive | 某指标上较优的一方 |
|
||
| 劣势数值 | negative | 某指标上较差的一方（可选显示） |
|
||
| "VS" 文字 | text_muted | 居中，降调处理 |
|
||
|
||
---
|
||
|
||
## 数据接口
|
||
|
||
```python
|
||
data = {
|
||
"title": str, # 页面标题
|
||
"subtitle": str, # 可选，如 "截至2024年12月31日"
|
||
"left": {
|
||
"title": str, # 左卡片主标题（如公司名/方案名）
|
||
"subtitle": str, # 可选，左卡片副标题
|
||
"color": str, # 可选，顶部色带颜色（主题变量名，默认 "primary"）
|
||
"items": [
|
||
{
|
||
"label": str, # 指标名（如 "近一年收益"）
|
||
"value": str, # 指标值（如 "+12.3%"）
|
||
"better": bool, # 可选，是否为该指标的优胜方（高亮显示）
|
||
},
|
||
...
|
||
],
|
||
},
|
||
"right": {
|
||
# 同上
|
||
},
|
||
"source": str, # 可选，数据来源
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 实现伪代码
|
||
|
||
```python
|
||
def layout_comparison_cards(slide, data, theme):
|
||
m = theme["margin"]
|
||
sw, sh = 13.333, 7.5
|
||
cw = sw - 2 * m
|
||
|
||
set_slide_bg(slide, theme["bg_light"])
|
||
add_text(slide, data["title"],
|
||
x=m, y=0.25, w=cw, h=0.60,
|
||
font_size=theme["title_size"]-2, color=theme["text_dark"],
|
||
bold=True, font_name=theme["header_font"])
|
||
add_rect(slide, m, 0.90, 2.0, 0.04, fill=theme["accent"])
|
||
|
||
# "VS"
|
||
add_text(slide, "VS",
|
||
x=6.167, y=3.50, w=1.00, h=0.60,
|
||
font_size=theme["subtitle_size"]+4, color=theme["text_muted"],
|
||
bold=True, align="center", font_name=theme["header_font"])
|
||
|
||
vs_gap = 1.00
|
||
card_w = (cw - vs_gap) / 2 # 5.567"
|
||
card_y = 1.10
|
||
card_h = 5.80
|
||
|
||
for side, card_x in [("left", m), ("right", m + card_w + vs_gap)]:
|
||
card_data = data[side]
|
||
top_color = theme.get(card_data.get("color", "primary" if side=="left" else "secondary"))
|
||
|
||
# 卡片背景
|
||
add_rounded_rect(slide, card_x, card_y, card_w, card_h,
|
||
fill=theme["card_bg"], border=theme["border"], radius=0.10)
|
||
# 顶部色带
|
||
add_rect(slide, card_x, card_y, card_w, 0.08, fill=top_color)
|
||
|
||
# 标题
|
||
add_text(slide, card_data["title"],
|
||
x=card_x+0.20, y=1.28, w=card_w-0.40, h=0.55,
|
||
font_size=theme["subtitle_size"]+2, color=theme["text_dark"],
|
||
bold=True, font_name=theme["header_font"])
|
||
if card_data.get("subtitle"):
|
||
add_text(slide, card_data["subtitle"],
|
||
x=card_x+0.20, y=1.88, w=card_w-0.40, h=0.40,
|
||
font_size=theme["body_size"], color=theme["text_muted"],
|
||
font_name=theme["body_font"])
|
||
|
||
# 分隔线
|
||
add_rect(slide, card_x+0.20, 2.35, card_w-0.40, 0.02, fill=theme["border"])
|
||
|
||
# 指标行
|
||
row_y = 2.50
|
||
row_h = 0.55
|
||
for item in card_data["items"]:
|
||
val_color = theme["positive"] if item.get("better") else theme["text_dark"]
|
||
add_text(slide, item["label"],
|
||
x=card_x+0.20, y=row_y, w=3.00, h=0.40,
|
||
font_size=theme["body_size"], color=theme["text_muted"],
|
||
font_name=theme["body_font"])
|
||
add_text(slide, item["value"],
|
||
x=card_x+0.20, y=row_y, w=card_w-0.40, h=0.40,
|
||
font_size=theme["body_size"], color=val_color,
|
||
bold=item.get("better", False),
|
||
align="right", font_name=theme["body_font"])
|
||
add_rect(slide, card_x+0.20, row_y+0.47, card_w-0.40, 0.01, fill=theme["border"])
|
||
row_y += row_h
|
||
|
||
if data.get("source"):
|
||
add_text(slide, f"数据来源：{data['source']}",
|
||
x=m, y=7.10, w=cw, h=0.30,
|
||
font_size=theme["caption_size"], color=theme["text_muted"],
|
||
font_name=theme["body_font"])
|
||
```
|
||
|
||
---
|
||
|
||
## 设计要点
|
||
|
||
1. **"VS" 居中** 在两卡片之间间隙正中，字号略大，用 `text_muted` 降调，不抢主体
|
||
2. **顶部色带** 区分左右卡片身份，通常左用 `primary`，右用 `secondary` 或 `accent`
|
||
3. **胜出指标高亮** 用 `positive` 绿色+粗体，对比一目了然
|
||
4. **指标行数** 最多 7 行（含卡片标题区后剩余 4.4 英寸 / 0.55 = 8 行，预留间距后7行）
|
||
5. **指标名长度** 建议 8 字以内；数值最长 10 个字符（含符号）
|
||
|
||
---
|
||
|
||
## 测试数据示例
|
||
|
||
```python
|
||
data = {
|
||
"title": "基金产品横向对比",
|
||
"subtitle": "截至2024年12月31日",
|
||
"left": {
|
||
"title": "国投养老稳健型 A",
|
||
"subtitle": "成立日期：2015年3月",
|
||
"items": [
|
||
{"label": "近一年收益", "value": "+12.3%", "better": True},
|
||
{"label": "近三年年化", "value": "+8.7%", "better": True},
|
||
{"label": "最大回撤", "value": "-5.2%", "better": True},
|
||
{"label": "夏普比率", "value": "1.85", "better": True},
|
||
{"label": "管理费率", "value": "0.80%", "better": False},
|
||
{"label": "规模（亿元）", "value": "380"},
|
||
{"label": "评级", "value": "★★★★★"},
|
||
],
|
||
},
|
||
"right": {
|
||
"title": "同类产品均值",
|
||
"subtitle": "（Wind 同类基金平均）",
|
||
"items": [
|
||
{"label": "近一年收益", "value": "+8.9%"},
|
||
{"label": "近三年年化", "value": "+6.2%"},
|
||
{"label": "最大回撤", "value": "-8.1%"},
|
||
{"label": "夏普比率", "value": "1.12"},
|
||
{"label": "管理费率", "value": "0.65%", "better": True},
|
||
{"label": "规模（亿元）", "value": "85"},
|
||
{"label": "评级", "value": "★★★"},
|
||
],
|
||
},
|
||
"source": "Wind 资讯，国投养老基金管理有限公司",
|
||
}
|
||
```
|