Skip to content

Support document heading auto-numbering / document display settings in docs shortcuts #671

@Arctic5151

Description

@Arctic5151

Problem

lark-cli docs supports creating, fetching, updating, and media operations for Lark Docs, but it does not currently expose document-level display settings such as heading auto-numbering.

For documents with many headings, users may want to remove manually typed section numbers and enable the native Lark/Feishu heading auto-numbering setting instead. Today this seems to require using the web UI manually.

Current behavior

From the current CLI implementation:

  • docs +update --api-version v2 supports block/content operations such as str_replace, block_insert_after, block_replace, overwrite, and append.
  • There does not appear to be a shortcut or API command for updating document display settings.
  • Searching the repository for display_setting, heading numbering, or auto-numbering only finds unrelated Base auto-number fields or ordered-list numbering.

Expected behavior

It would be useful for lark-cli to support one of the following:

  1. A docs shortcut, for example:
lark-cli docs +settings --doc <doc_token> --heading-auto-numbering true
  1. Or a more general document display settings command, for example:
lark-cli docs +settings --doc <doc_token> --set heading_auto_numbering=true

Use case

When editing long-form documents programmatically, agents or scripts can remove manually typed heading numbers, but cannot enable the native document heading auto-numbering setting. This leaves the final formatting step manual.

Notes

If the Lark Open Platform does not currently expose this setting, it would still be helpful for the CLI/docs to clarify that this is unsupported and must be configured manually in the document UI.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions