skills(lark-im): card style guide's metric-card example sets `corner_radius` on `column` — real send fails with 200621 "unknown property"
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 17.3k
- Forks
- 1.4k
- Avg merge
- 2d 4h
- Merged PRs (30d)
- 105
Description
What happened
The card style guide skills/lark-im/references/card/lark-im-card-style.md section 3 (指标卡模式, line ~134 on main) tells the model this pattern is mandatory whenever the content contains KPI/numeric words, and its example JSON (lines ~143-158) sets "corner_radius": "8px" directly on a column inside a column_set:
{
"tag": "column_set",
"flex_mode": "none",
"horizontal_spacing": "12px",
"columns": [
{ "tag": "column", "width": "weighted", "weight": 1,
"background_style": "grey-50", "corner_radius": "8px",
"padding": "12px", "vertical_spacing": "2px",
...
column does not support corner_radius in card 2.0 — the component reference in the same skill (components/column_set.md, "column 字段" table) lists background_style/padding/margin/etc. for column but no corner_radius. Any card built by faithfully following the style guide's example is rejected by the open platform at send time:
Lark API error: Failed to create card content, ext=ErrCode: 200621;
ErrMsg: msg: [parse card json err, please check whether the card json is correct],
value: [unknown property, property: corner_radius,
path: ROOT -> body -> elements -> [1](tag: column_set) -> columns -> [0](tag: column)],
code: 200621; (code: 230099)
Why it matters
This is an agent-facing skill doc: models follow the example verbatim, and the style guide marks the metric-card pattern as mandatory for numeric content, so any KPI/statistics card generated from these docs fails to deliver. The error only surfaces at send time, after authoring.
Reproduce
- Take the metric-card example from section 3 of
lark-im-card-style.mdas-is (a complete card with thatcolumn_setinbody.elements). - Send it via
im/v1/messageswithmsg_type=interactive(orlark-cli im +messages-send). - The API returns code 230099 / ErrCode 200621
unknown property: corner_radiusat thecolumnpath.
Removing "corner_radius": "8px" from the column makes the same card deliver successfully.
Suggested fix
- Remove
corner_radiusfrom thecolumnin the section-3 example (keepbackground_style/padding/vertical_spacing, which are valid). - Optionally add a warning line to the style guide:
columndoes not supportcorner_radius; when rounded corners are needed, wrap the block in aninteractive_container(section 4's pattern), which does support it.
Observed with the skill docs shipped in 1.0.64; the example is unchanged on current main.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Open skills/lark-im/references/card/lark-im-card-style.md and inspect section 3 alongside components/column_set.md, focusing on the metric-card JSON example and the column field table. Confirm the documented properties against the reported send error, then update the example so it matches the component reference and verify that the invalid corner_radius usage is no longer present.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 85/100