larksuite / larksuite/cli

Question: server-side rejection and atomicity contract for sheets +batch-update in CLI 1.0.82

Open
#2,720 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug domain/sheets
Dominant language
Go
Stars
17.3k
Forks
1.4k
Avg merge
2d 4h
Merged PRs (30d)
105

Description

我们正在核验 @larksuite/cli 1.0.82 的
sheets +batch-update 失败行为。
对应npm gitHead为:
0f29e039d71eb598330f50a60a77b573f9996e0b

希望确认以下通用合成场景:
一个批次先向已有Sheet的单元格写入合成值,
再向不存在的Sheet写入合成值。

请提供适用于该版本的明确契约:

  1. 该场景会在CLI本地转换阶段被拒绝,还是由服务端处理后拒绝?
    如何通过可靠的结构化字段区分?

  2. 若由服务端拒绝,缺失Sheet对应什么错误标识?
    返回结构如何定位失败子操作?
    请提供官方schema、版本化说明或脱敏响应示例。

  3. 该接口支持的严格原子模式如何启用?
    在上述服务端拒绝场景下,是否保证整个批次没有任何操作生效?
    该保证覆盖哪些失败类型,又有哪些例外?

  4. CLI最终JSON保留哪些能够支持上述判断的字段?
    哪些字段只是客户端包装生成,不能作为服务端确认?

我们会将启动、凭证、传输、超时和解析错误单独处理;
不会仅凭CLI抛错、revision不变或单元格无变化,
认定已经验证服务端原子性。

感谢提供准确的契约链接或对应实现位置。

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the exact @larksuite/cli 1.0.82 sheets +batch-update scenario at gitHead 0f29e039d71eb598330f50a60a77b573f9996e0b and inspect its structured JSON output. Done means documenting the server-versus-client failure distinction, missing-Sheet error and failed sub-operation fields, atomic-mode behavior and exceptions, with an official schema, versioned reference, or redacted response example.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
api, cli
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.