docs: clarify doc block insert ordering

shortcuts/doc/doc_resource_cover.go

@@ -1,795 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package doc
-
-import (
-	"bytes"
-	"context"
-	"fmt"
-	"io"
-	"math"
-	"mime"
-	"net"
-	"net/http"
-	"net/url"
-	"path"
-	"path/filepath"
-	"strings"
-	"time"
-
-	larkcore "github.com/larksuite/oapi-sdk-go/v3/core"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/extension/fileio"
-	"github.com/larksuite/cli/internal/validate"
-	"github.com/larksuite/cli/shortcuts/common"
-)
-
-const (
-	docCoverResourceType    = "cover"
-	docCoverUploadParent    = "docx_image"
-	docCoverURLMaxBytes     = int64(20 * 1024 * 1024)
-	docCoverDownloadName    = "cover"
-	docCoverURLDownloadName = "cover"
-)
-
-type docCoverHTTPStatusCause int
-
-func (c docCoverHTTPStatusCause) Error() string {
-	return http.StatusText(int(c))
-}
-
-type docCoverURLGuardError string
-
-func (e docCoverURLGuardError) Error() string {
-	return string(e)
-}
-
-var docCoverAllowedContentTypes = map[string]string{
-	"image/gif":  ".gif",
-	"image/jpeg": ".jpg",
-	"image/png":  ".png",
-	"image/webp": ".webp",
-}
-
-var DocResourceDownload = common.Shortcut{
-	Service:     "docs",
-	Command:     "resource-download",
-	Description: "Download a document resource (type=cover downloads the cover image content)",
-	Risk:        "read",
-	Scopes:      []string{"docx:document:readonly", "docs:document.media:download"},
-	AuthTypes:   []string{"user", "bot"},
-	Flags: []common.Flag{
-		{Name: "doc", Desc: "document URL or document_id", Required: true},
-		{Name: "type", Default: docCoverResourceType, Desc: "resource type: cover"},
-		{Name: "output", Desc: "local save path", Required: true},
-		{Name: "overwrite", Type: "bool", Desc: "overwrite existing output file"},
-	},
-	Validate: validateDocCoverType,
-	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
-		docRef, err := parseDocumentRef(runtime.Str("doc"))
-		if err != nil {
-			return common.NewDryRunAPI().Set("error", err.Error())
-		}
-		documentID := docRef.Token
-		d := common.NewDryRunAPI()
-		if docRef.Kind == "wiki" {
-			documentID = "<resolved_docx_token>"
-			d.GET("/open-apis/wiki/v2/spaces/get_node").
-				Desc("[1] Resolve wiki node to docx document").
-				Params(map[string]interface{}{"token": docRef.Token})
-		}
-		d.GET("/open-apis/docx/v1/documents/:document_id").
-			Desc("Read document cover metadata").
-			Set("document_id", documentID)
-		d.GET("/open-apis/drive/v1/medias/:cover_token/download").
-			Desc("Download cover image content").
-			Set("cover_token", "<cover.token>").
-			Set("output", runtime.Str("output"))
-		return d
-	},
-	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		documentID, err := resolveDocxDocumentIDForResource(runtime, runtime.Str("doc"))
-		if err != nil {
-			return err
-		}
-		outputPath := runtime.Str("output")
-		if _, err := runtime.ResolveSavePath(outputPath); err != nil {
-			return errs.NewValidationError(errs.SubtypeInvalidArgument, "unsafe output path: %s", err).WithParam("--output").WithCause(err)
-		}
-
-		cover, err := getDocCover(runtime, documentID)
-		if err != nil {
-			return err
-		}
-		if cover.Token == "" {
-			return errs.NewValidationError(errs.SubtypeFailedPrecondition, "document has no cover (cover is empty): %s", common.MaskToken(documentID)).WithParam("--type")
-		}
-
-		fmt.Fprintf(runtime.IO().ErrOut, "Downloading cover: %s\n", common.MaskToken(cover.Token))
-		resp, err := runtime.DoAPIStream(ctx, &larkcore.ApiReq{
-			HttpMethod: http.MethodGet,
-			ApiPath:    fmt.Sprintf("/open-apis/drive/v1/medias/%s/download", validate.EncodePathSegment(cover.Token)),
-		})
-		if err != nil {
-			return wrapDocNetworkErr(err, "download cover failed: %v", err)
-		}
-		defer resp.Body.Close()
-
-		finalPath, _ := autoAppendDocMediaExtension(outputPath, resp.Header, "")
-		if finalPath != outputPath {
-			if _, err := runtime.ResolveSavePath(finalPath); err != nil {
-				return errs.NewValidationError(errs.SubtypeInvalidArgument, "unsafe output path: %s", err).WithParam("--output").WithCause(err)
-			}
-		}
-		if !runtime.Bool("overwrite") {
-			if _, statErr := runtime.FileIO().Stat(finalPath); statErr == nil {
-				return errs.NewValidationError(errs.SubtypeFailedPrecondition, "output file already exists: %s (use --overwrite to replace)", finalPath).WithParam("--output")
-			}
-		}
-
-		result, err := runtime.FileIO().Save(finalPath, fileio.SaveOptions{
-			ContentType:   resp.Header.Get("Content-Type"),
-			ContentLength: resp.ContentLength,
-		}, resp.Body)
-		if err != nil {
-			return common.WrapSaveErrorTyped(err)
-		}
-		savedPath, _ := runtime.ResolveSavePath(finalPath)
-		if savedPath == "" {
-			savedPath = finalPath
-		}
-		runtime.Out(map[string]interface{}{
-			"document_id":  documentID,
-			"type":         docCoverResourceType,
-			"saved_path":   savedPath,
-			"size_bytes":   result.Size(),
-			"content_type": resp.Header.Get("Content-Type"),
-			"cover":        cover.toOutput(),
-		}, nil)
-		return nil
-	},
-}
-
-var DocResourceUpdate = common.Shortcut{
-	Service:     "docs",
-	Command:     "resource-update",
-	Description: "Upload and update a document resource (type=cover)",
-	Risk:        "write",
-	Scopes:      []string{"docx:document:readonly", "docx:document:write_only", "docs:document.media:upload"},
-	AuthTypes:   []string{"user", "bot"},
-	Flags: []common.Flag{
-		{Name: "doc", Desc: "document URL or document_id", Required: true},
-		{Name: "type", Default: docCoverResourceType, Desc: "resource type: cover"},
-		{Name: "file", Desc: "local image file path (files > 20MB use multipart upload automatically)"},
-		{Name: "from-clipboard", Type: "bool", Desc: "read image from system clipboard instead of a local file"},
-		{Name: "url", Desc: "HTTPS image URL to download and upload"},
-		{Name: "offset-ratio-x", Type: "float64", Desc: "cover horizontal offset ratio"},
-		{Name: "offset-ratio-y", Type: "float64", Desc: "cover vertical offset ratio"},
-	},
-	Validate: validateDocCoverUpdate,
-	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
-		docRef, err := parseDocumentRef(runtime.Str("doc"))
-		if err != nil {
-			return common.NewDryRunAPI().Set("error", err.Error())
-		}
-		documentID := docRef.Token
-		d := common.NewDryRunAPI()
-		if docRef.Kind == "wiki" {
-			documentID = "<resolved_docx_token>"
-			d.GET("/open-apis/wiki/v2/spaces/get_node").
-				Desc("[1] Resolve wiki node to docx document").
-				Params(map[string]interface{}{"token": docRef.Token})
-		}
-		source := docCoverDryRunSource(runtime)
-		d.Desc("upload cover image and update document cover").
-			POST("/open-apis/drive/v1/medias/upload_all").
-			Desc("Upload cover image").
-			Body(map[string]interface{}{
-				"file":        source,
-				"file_name":   "<cover_file_name>",
-				"parent_type": docCoverUploadParent,
-				"parent_node": documentID,
-				"extra":       fmt.Sprintf(`{"drive_route_token":"%s"}`, documentID),
-			})
-		d.PATCH("/open-apis/docx/v1/documents/:document_id").
-			Desc("Update document cover").
-			Body(map[string]interface{}{"update_cover": map[string]interface{}{"cover": buildDocCoverUpdateBody("<file_token>", runtime)}})
-		d.Set("document_id", documentID)
-		if runtime.Str("url") != "" {
-			d.Set("url_safety", "HTTPS only; private/loopback/link-local IPs rejected; max 3 redirects; image content-types only; max 20MiB")
-		}
-		return d
-	},
-	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		documentID, err := resolveDocxDocumentIDForResource(runtime, runtime.Str("doc"))
-		if err != nil {
-			return err
-		}
-
-		source, err := readDocCoverUpdateSource(ctx, runtime)
-		if err != nil {
-			return err
-		}
-
-		fmt.Fprintf(runtime.IO().ErrOut, "Uploading cover image: %s (%d bytes)\n", source.FileName, source.FileSize)
-		if source.FileSize > common.MaxDriveMediaUploadSinglePartSize {
-			fmt.Fprintf(runtime.IO().ErrOut, "File exceeds 20MB, using multipart upload\n")
-		}
-
-		uploadCfg := UploadDocMediaFileConfig{
-			FilePath:   source.FilePath,
-			Reader:     source.Reader,
-			FileName:   source.FileName,
-			FileSize:   source.FileSize,
-			ParentType: docCoverUploadParent,
-			ParentNode: documentID,
-			DocID:      documentID,
-		}
-		fileToken, err := uploadDocMediaFile(runtime, uploadCfg)
-		if err != nil {
-			return err
-		}
-		fmt.Fprintf(runtime.IO().ErrOut, "File uploaded: %s\n", common.MaskToken(fileToken))
-
-		coverBody := buildDocCoverUpdateBody(fileToken, runtime)
-		if _, err := runtime.CallAPITyped("PATCH",
-			fmt.Sprintf("/open-apis/docx/v1/documents/%s", validate.EncodePathSegment(documentID)),
-			nil,
-			map[string]interface{}{"update_cover": map[string]interface{}{"cover": coverBody}},
-		); err != nil {
-			return err
-		}
-
-		runtime.Out(map[string]interface{}{
-			"document_id": documentID,
-			"type":        docCoverResourceType,
-			"updated":     true,
-			"source":      source.Kind,
-			"file_token":  fileToken,
-			"cover":       coverBody,
-		}, nil)
-		return nil
-	},
-}
-
-var DocResourceDelete = common.Shortcut{
-	Service:     "docs",
-	Command:     "resource-delete",
-	Description: "Delete a document resource (type=cover is idempotent when empty)",
-	Risk:        "write",
-	Scopes:      []string{"docx:document:readonly", "docx:document:write_only"},
-	AuthTypes:   []string{"user", "bot"},
-	Flags: []common.Flag{
-		{Name: "doc", Desc: "document URL or document_id", Required: true},
-		{Name: "type", Default: docCoverResourceType, Desc: "resource type: cover"},
-	},
-	Validate: validateDocCoverType,
-	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
-		docRef, err := parseDocumentRef(runtime.Str("doc"))
-		if err != nil {
-			return common.NewDryRunAPI().Set("error", err.Error())
-		}
-		documentID := docRef.Token
-		d := common.NewDryRunAPI()
-		if docRef.Kind == "wiki" {
-			documentID = "<resolved_docx_token>"
-			d.GET("/open-apis/wiki/v2/spaces/get_node").
-				Desc("[1] Resolve wiki node to docx document").
-				Params(map[string]interface{}{"token": docRef.Token})
-		}
-		d.GET("/open-apis/docx/v1/documents/:document_id").
-			Desc("Read document cover metadata for idempotency").
-			Set("document_id", documentID)
-		d.PATCH("/open-apis/docx/v1/documents/:document_id").
-			Desc("Clear document cover when one exists").
-			Body(map[string]interface{}{"update_cover": map[string]interface{}{"cover": nil}})
-		return d
-	},
-	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		documentID, err := resolveDocxDocumentIDForResource(runtime, runtime.Str("doc"))
-		if err != nil {
-			return err
-		}
-		cover, err := getDocCover(runtime, documentID)
-		if err != nil {
-			return err
-		}
-		if cover.Token == "" {
-			runtime.Out(map[string]interface{}{
-				"document_id":   documentID,
-				"type":          docCoverResourceType,
-				"deleted":       false,
-				"already_empty": true,
-			}, nil)
-			return nil
-		}
-
-		if _, err := runtime.CallAPITyped("PATCH",
-			fmt.Sprintf("/open-apis/docx/v1/documents/%s", validate.EncodePathSegment(documentID)),
-			nil,
-			map[string]interface{}{"update_cover": map[string]interface{}{"cover": nil}},
-		); err != nil {
-			return err
-		}
-		runtime.Out(map[string]interface{}{
-			"document_id":    documentID,
-			"type":           docCoverResourceType,
-			"deleted":        true,
-			"already_empty":  false,
-			"previous_cover": cover.toOutput(),
-		}, nil)
-		return nil
-	},
-}
-
-type docCoverMetadata struct {
-	Token        string
-	OffsetRatioX *float64
-	OffsetRatioY *float64
-}
-
-func (c docCoverMetadata) toOutput() map[string]interface{} {
-	out := map[string]interface{}{"token": c.Token}
-	if c.OffsetRatioX != nil {
-		out["offset_ratio_x"] = *c.OffsetRatioX
-	}
-	if c.OffsetRatioY != nil {
-		out["offset_ratio_y"] = *c.OffsetRatioY
-	}
-	return out
-}
-
-type docCoverUpdateSource struct {
-	Kind     string
-	FilePath string
-	Reader   io.Reader
-	FileName string
-	FileSize int64
-}
-
-func validateDocCoverType(ctx context.Context, runtime *common.RuntimeContext) error {
-	if runtime.Str("type") != docCoverResourceType {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "unsupported --type %q, expected cover", runtime.Str("type")).WithParam("--type")
-	}
-	docRef, err := parseDocumentRef(runtime.Str("doc"))
-	if err != nil {
-		return err
-	}
-	if docRef.Kind == "doc" {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "docs resource-* only supports docx documents; use a docx token/URL or a wiki URL that resolves to docx").WithParam("--doc")
-	}
-	return nil
-}
-
-func validateDocCoverUpdate(ctx context.Context, runtime *common.RuntimeContext) error {
-	if err := validateDocCoverType(ctx, runtime); err != nil {
-		return err
-	}
-	sourceCount := 0
-	var params []errs.InvalidParam
-	if runtime.Str("file") != "" {
-		sourceCount++
-		params = append(params, errs.InvalidParam{Name: "--file", Reason: "source flag"})
-	}
-	if runtime.Bool("from-clipboard") {
-		sourceCount++
-		params = append(params, errs.InvalidParam{Name: "--from-clipboard", Reason: "source flag"})
-	}
-	if runtime.Str("url") != "" {
-		sourceCount++
-		params = append(params, errs.InvalidParam{Name: "--url", Reason: "source flag"})
-	}
-	if sourceCount == 0 {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "one of --file, --from-clipboard or --url is required").WithParams(
-			errs.InvalidParam{Name: "--file", Reason: "provide one source"},
-			errs.InvalidParam{Name: "--from-clipboard", Reason: "provide one source"},
-			errs.InvalidParam{Name: "--url", Reason: "provide one source"},
-		)
-	}
-	if sourceCount > 1 {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--file, --from-clipboard and --url are mutually exclusive").WithParams(params...)
-	}
-	if err := validateCoverOffset(runtime, "offset-ratio-x"); err != nil {
-		return err
-	}
-	if err := validateCoverOffset(runtime, "offset-ratio-y"); err != nil {
-		return err
-	}
-	if rawURL := runtime.Str("url"); rawURL != "" {
-		if _, err := parseDocCoverURLSyntax(rawURL); err != nil {
-			return err
-		}
-	}
-	return nil
-}
-
-func validateCoverOffset(runtime *common.RuntimeContext, name string) error {
-	if !runtime.Changed(name) {
-		return nil
-	}
-	value := runtime.Float64(name)
-	if math.IsNaN(value) || math.IsInf(value, 0) {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--%s must be a finite number", name).WithParam("--" + name)
-	}
-	return nil
-}
-
-func resolveDocxDocumentIDForResource(runtime *common.RuntimeContext, input string) (string, error) {
-	docRef, err := parseDocumentRef(input)
-	if err != nil {
-		return "", err
-	}
-	switch docRef.Kind {
-	case "docx":
-		return docRef.Token, nil
-	case "wiki":
-		return resolveDocxDocumentID(runtime, input)
-	case "doc":
-		return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "docs resource-* only supports docx documents; use a docx token/URL or a wiki URL that resolves to docx").WithParam("--doc")
-	default:
-		return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "docs resource-* only supports docx documents").WithParam("--doc")
-	}
-}
-
-func getDocCover(runtime *common.RuntimeContext, documentID string) (docCoverMetadata, error) {
-	data, err := runtime.CallAPITyped("GET",
-		fmt.Sprintf("/open-apis/docx/v1/documents/%s", validate.EncodePathSegment(documentID)),
-		nil, nil)
-	if err != nil {
-		return docCoverMetadata{}, err
-	}
-	coverData := common.GetMap(data, "document", "cover")
-	if len(coverData) == 0 {
-		coverData = common.GetMap(data, "cover")
-	}
-	cover := docCoverMetadata{Token: common.GetString(coverData, "token")}
-	if value, ok := getOptionalFloat(coverData, "offset_ratio_x"); ok {
-		cover.OffsetRatioX = &value
-	}
-	if value, ok := getOptionalFloat(coverData, "offset_ratio_y"); ok {
-		cover.OffsetRatioY = &value
-	}
-	return cover, nil
-}
-
-func getOptionalFloat(m map[string]interface{}, key string) (float64, bool) {
-	if m == nil {
-		return 0, false
-	}
-	switch v := m[key].(type) {
-	case float64:
-		return v, true
-	case int:
-		return float64(v), true
-	case int64:
-		return float64(v), true
-	}
-	return 0, false
-}
-
-func readDocCoverUpdateSource(ctx context.Context, runtime *common.RuntimeContext) (docCoverUpdateSource, error) {
-	if runtime.Bool("from-clipboard") {
-		fmt.Fprintf(runtime.IO().ErrOut, "Reading image from clipboard...\n")
-		content, err := readClipboardImage()
-		if err != nil {
-			return docCoverUpdateSource{}, err
-		}
-		return docCoverUpdateSource{
-			Kind:     "clipboard",
-			Reader:   bytes.NewReader(content),
-			FileName: "clipboard.png",
-			FileSize: int64(len(content)),
-		}, nil
-	}
-	if rawURL := runtime.Str("url"); rawURL != "" {
-		content, fileName, err := downloadDocCoverURL(ctx, runtime, rawURL)
-		if err != nil {
-			return docCoverUpdateSource{}, err
-		}
-		return docCoverUpdateSource{
-			Kind:     "url",
-			Reader:   bytes.NewReader(content),
-			FileName: fileName,
-			FileSize: int64(len(content)),
-		}, nil
-	}
-
-	filePath := runtime.Str("file")
-	stat, err := runtime.FileIO().Stat(filePath)
-	if err != nil {
-		return docCoverUpdateSource{}, wrapDocInputFileErr(err, "file not found")
-	}
-	if !stat.Mode().IsRegular() {
-		return docCoverUpdateSource{}, errs.NewValidationError(errs.SubtypeInvalidArgument, "file must be a regular file: %s", filePath).WithParam("--file")
-	}
-	return docCoverUpdateSource{
-		Kind:     "file",
-		FilePath: filePath,
-		FileName: filepath.Base(filePath),
-		FileSize: stat.Size(),
-	}, nil
-}
-
-func buildDocCoverUpdateBody(fileToken string, runtime *common.RuntimeContext) map[string]interface{} {
-	cover := map[string]interface{}{"token": fileToken}
-	if runtime.Changed("offset-ratio-x") {
-		cover["offset_ratio_x"] = runtime.Float64("offset-ratio-x")
-	}
-	if runtime.Changed("offset-ratio-y") {
-		cover["offset_ratio_y"] = runtime.Float64("offset-ratio-y")
-	}
-	return cover
-}
-
-func docCoverDryRunSource(runtime *common.RuntimeContext) string {
-	if runtime.Bool("from-clipboard") {
-		return "<clipboard image>"
-	}
-	if rawURL := runtime.Str("url"); rawURL != "" {
-		return rawURL
-	}
-	if filePath := runtime.Str("file"); filePath != "" {
-		return "@" + filePath
-	}
-	return "<cover image>"
-}
-
-func downloadDocCoverURL(ctx context.Context, runtime *common.RuntimeContext, raw string) ([]byte, string, error) {
-	u, err := parseAndValidateDocCoverURL(ctx, raw)
-	if err != nil {
-		return nil, "", err
-	}
-
-	baseClient, err := runtime.Factory.HttpClient()
-	if err != nil {
-		return nil, "", errs.NewInternalError(errs.SubtypeSDKError, "http client: %v", err).WithCause(err)
-	}
-	client := newDocCoverHTTPClient(baseClient)
-	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u.String(), nil) //nolint:forbidigo // cover --url fetches external user content; RuntimeContext API helpers are Lark-API only.
-	if err != nil {
-		return nil, "", errs.NewValidationError(errs.SubtypeInvalidArgument, "invalid --url: %v", err).WithParam("--url").WithCause(err)
-	}
-	resp, err := client.Do(req) //nolint:forbidigo // cover --url uses a guarded external downloader, not Lark API transport.
-	if err != nil {
-		return nil, "", wrapDocNetworkErr(err, "download cover URL failed: %v", err)
-	}
-	defer resp.Body.Close()
-	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
-		subtype := errs.SubtypeNetworkTransport
-		if resp.StatusCode >= 500 {
-			subtype = errs.SubtypeNetworkServer
-		}
-		cause := docCoverHTTPStatusCause(resp.StatusCode)
-		return nil, "", errs.NewNetworkError(subtype, "download cover URL failed: HTTP %d", resp.StatusCode).WithCode(resp.StatusCode).WithCause(cause)
-	}
-
-	mediaType, _, err := mime.ParseMediaType(resp.Header.Get("Content-Type"))
-	if err != nil || mediaType == "" {
-		return nil, "", errs.NewValidationError(errs.SubtypeInvalidArgument, "cover URL response must include an image Content-Type").WithParam("--url")
-	}
-	mediaType = strings.ToLower(mediaType)
-	ext, ok := docCoverAllowedContentTypes[mediaType]
-	if !ok {
-		return nil, "", errs.NewValidationError(errs.SubtypeInvalidArgument, "cover URL Content-Type %q is not supported; expected image/png, image/jpeg, image/gif or image/webp", mediaType).WithParam("--url")
-	}
-
-	limited := io.LimitReader(resp.Body, docCoverURLMaxBytes+1)
-	content, err := io.ReadAll(limited)
-	if err != nil {
-		return nil, "", wrapDocNetworkErr(err, "read cover URL response failed: %v", err)
-	}
-	if int64(len(content)) > docCoverURLMaxBytes {
-		return nil, "", errs.NewValidationError(errs.SubtypeInvalidArgument, "cover URL response exceeds 20MiB limit").WithParam("--url")
-	}
-
-	fileName := docCoverURLFileName(resp.Request.URL, ext)
-	return content, fileName, nil
-}
-
-func parseAndValidateDocCoverURL(ctx context.Context, raw string) (*url.URL, error) {
-	u, err := parseDocCoverURLSyntax(raw)
-	if err != nil {
-		return nil, err
-	}
-	if err := validateDocCoverURLHost(ctx, u.Hostname()); err != nil {
-		return nil, err
-	}
-	return u, nil
-}
-
-func parseDocCoverURLSyntax(raw string) (*url.URL, error) {
-	u, err := url.Parse(strings.TrimSpace(raw))
-	if err != nil {
-		return nil, errs.NewValidationError(errs.SubtypeInvalidArgument, "invalid --url: %v", err).WithParam("--url").WithCause(err)
-	}
-	if u.Scheme != "https" {
-		return nil, errs.NewValidationError(errs.SubtypeInvalidArgument, "--url must use https").WithParam("--url")
-	}
-	if u.User != nil {
-		return nil, errs.NewValidationError(errs.SubtypeInvalidArgument, "--url must not include userinfo").WithParam("--url")
-	}
-	host := u.Hostname()
-	if host == "" {
-		return nil, errs.NewValidationError(errs.SubtypeInvalidArgument, "--url host cannot be empty").WithParam("--url")
-	}
-	return u, nil
-}
-
-func docCoverURLFileName(u *url.URL, ext string) string {
-	base := path.Base(u.EscapedPath())
-	if base == "." || base == "/" || base == "" {
-		return docCoverURLDownloadName + ext
-	}
-	unescaped, err := url.PathUnescape(base)
-	if err == nil {
-		base = unescaped
-	}
-	base = filepath.Base(base)
-	if strings.TrimSpace(base) == "" || base == "." || base == string(filepath.Separator) {
-		return docCoverURLDownloadName + ext
-	}
-	if filepath.Ext(base) == "" {
-		base += ext
-	}
-	return base
-}
-
-func validateDocCoverURLHost(ctx context.Context, host string) error {
-	host = strings.TrimSpace(strings.ToLower(host))
-	if host == "" {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--url host cannot be empty").WithParam("--url")
-	}
-	if host == "localhost" || strings.HasSuffix(host, ".localhost") {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--url must not resolve to a local or internal address").WithParam("--url")
-	}
-	if ip := net.ParseIP(host); ip != nil {
-		if isUnsafeDocCoverIP(ip) {
-			return errs.NewValidationError(errs.SubtypeInvalidArgument, "--url must not resolve to a local or internal address").WithParam("--url")
-		}
-		return nil
-	}
-	ips, err := net.DefaultResolver.LookupIP(ctx, "ip", host)
-	if err != nil {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "failed to resolve --url host: %v", err).WithParam("--url").WithCause(err)
-	}
-	if len(ips) == 0 {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "failed to resolve --url host: no addresses").WithParam("--url")
-	}
-	for _, ip := range ips {
-		if isUnsafeDocCoverIP(ip) {
-			return errs.NewValidationError(errs.SubtypeInvalidArgument, "--url must not resolve to a local or internal address").WithParam("--url")
-		}
-	}
-	return nil
-}
-
-func isUnsafeDocCoverIP(ip net.IP) bool {
-	if ip == nil {
-		return true
-	}
-	if ip.IsLoopback() || ip.IsUnspecified() || ip.IsMulticast() || ip.IsLinkLocalUnicast() || ip.IsLinkLocalMulticast() {
-		return true
-	}
-	if v4 := ip.To4(); v4 != nil {
-		if v4[0] == 10 || v4[0] == 127 {
-			return true
-		}
-		if v4[0] == 169 && v4[1] == 254 {
-			return true
-		}
-		if v4[0] == 172 && v4[1] >= 16 && v4[1] <= 31 {
-			return true
-		}
-		if v4[0] == 192 && v4[1] == 168 {
-			return true
-		}
-		if v4[0] == 100 && v4[1] >= 64 && v4[1] <= 127 {
-			return true
-		}
-		if v4[0] == 198 && (v4[1] == 18 || v4[1] == 19) {
-			return true
-		}
-		if v4[0] >= 240 {
-			return true
-		}
-		return false
-	}
-	return ip.IsPrivate()
-}
-
-func newDocCoverHTTPClient(base *http.Client) *http.Client { //nolint:forbidigo // guarded external --url downloader cannot use Lark API runtime helpers.
-	if base == nil {
-		base = &http.Client{} //nolint:forbidigo // fallback only; caller normally supplies Factory.HttpClient.
-	}
-	cloned := *base
-	if cloned.Timeout == 0 { //nolint:forbidigo // external download timeout guard on cloned client.
-		cloned.Timeout = 30 * time.Second //nolint:forbidigo // external download timeout guard on cloned client.
-	}
-	cloned.Transport = cloneDocCoverTransport(base.Transport)                   //nolint:forbidigo // external download transport adds proxy/IP guards.
-	cloned.CheckRedirect = func(req *http.Request, via []*http.Request) error { //nolint:forbidigo // redirects must be validated for external --url downloads.
-		if len(via) >= 3 {
-			return errs.NewValidationError(errs.SubtypeInvalidArgument, "cover URL redirects too many times").WithParam("--url")
-		}
-		if len(via) > 0 {
-			prev := via[len(via)-1]
-			if strings.EqualFold(prev.URL.Scheme, "https") && strings.EqualFold(req.URL.Scheme, "http") {
-				return errs.NewValidationError(errs.SubtypeInvalidArgument, "cover URL redirect from https to http is not allowed").WithParam("--url")
-			}
-		}
-		_, err := parseAndValidateDocCoverURL(req.Context(), req.URL.String())
-		return err
-	}
-	return &cloned
-}
-
-func cloneDocCoverTransport(base http.RoundTripper) *http.Transport { //nolint:forbidigo // external --url downloader wraps caller transport with IP/proxy guards.
-	var cloned *http.Transport
-	if src, ok := base.(*http.Transport); ok && src != nil {
-		cloned = src.Clone()
-	} else if def, ok := http.DefaultTransport.(*http.Transport); ok && def != nil { //nolint:forbidigo // fallback for guarded external downloader only.
-		cloned = def.Clone()
-	} else {
-		cloned = &http.Transport{}
-	}
-	cloned.Proxy = nil
-
-	origDial := cloned.DialContext
-	cloned.DialContext = func(ctx context.Context, network, addr string) (net.Conn, error) {
-		conn, err := dialDocCoverConn(ctx, origDial, network, addr)
-		if err != nil {
-			return nil, err
-		}
-		if err := validateDocCoverConnRemoteIP(conn); err != nil {
-			conn.Close()
-			return nil, err
-		}
-		return conn, nil
-	}
-	if cloned.DialTLSContext != nil {
-		origDialTLS := cloned.DialTLSContext
-		cloned.DialTLSContext = func(ctx context.Context, network, addr string) (net.Conn, error) {
-			conn, err := dialDocCoverConn(ctx, origDialTLS, network, addr)
-			if err != nil {
-				return nil, err
-			}
-			if err := validateDocCoverConnRemoteIP(conn); err != nil {
-				conn.Close()
-				return nil, err
-			}
-			return conn, nil
-		}
-	}
-	return cloned
-}
-
-func dialDocCoverConn(ctx context.Context, dialFn func(context.Context, string, string) (net.Conn, error), network, addr string) (net.Conn, error) {
-	if dialFn != nil {
-		return dialFn(ctx, network, addr)
-	}
-	var dialer net.Dialer
-	return dialer.DialContext(ctx, network, addr)
-}
-
-func validateDocCoverConnRemoteIP(conn net.Conn) error {
-	if conn == nil {
-		return docCoverURLGuardError("nil connection")
-	}
-	addr := conn.RemoteAddr()
-	if addr == nil {
-		return docCoverURLGuardError("missing remote address")
-	}
-	host, _, err := net.SplitHostPort(addr.String())
-	if err != nil {
-		host = addr.String()
-	}
-	ip := net.ParseIP(strings.Trim(host, "[]"))
-	if ip == nil {
-		return docCoverURLGuardError("invalid remote IP")
-	}
-	if isUnsafeDocCoverIP(ip) {
-		return docCoverURLGuardError("local/internal host is not allowed")
-	}
-	return nil
-}

shortcuts/doc/doc_resource_cover_test.go

@@ -1,712 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package doc
-
-import (
-	"bytes"
-	"context"
-	"crypto/tls"
-	"encoding/json"
-	"errors"
-	"io"
-	"net"
-	"net/http"
-	"net/http/httptest"
-	"net/url"
-	"os"
-	"path/filepath"
-	"strings"
-	"testing"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/httpmock"
-	"github.com/larksuite/cli/shortcuts/common"
-)
-
-func TestDocResourceDownloadCoverDownloadsImageContent(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-download-app"))
-	documentID := "doxcnCoverDownload1"
-	coverToken := "cover_token_download_123"
-	reg.Register(docCoverMetadataStub(documentID, map[string]interface{}{
-		"token":          coverToken,
-		"offset_ratio_x": 0.25,
-		"offset_ratio_y": 0.75,
-	}))
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/drive/v1/medias/" + coverToken + "/download",
-		Status: 200,
-		Body:   []byte("png-data"),
-		Headers: http.Header{
-			"Content-Type": []string{"image/png"},
-		},
-	})
-
-	tmpDir := t.TempDir()
-	withDocsWorkingDir(t, tmpDir)
-
-	err := mountAndRunDocs(t, DocResourceDownload, []string{
-		"resource-download",
-		"--doc", documentID,
-		"--type", "cover",
-		"--output", "cover",
-		"--as", "bot",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-
-	out := decodeDocResourceOutput(t, stdout)
-	data := out.Data
-	if data["type"] != "cover" {
-		t.Fatalf("type = %v, want cover", data["type"])
-	}
-	if data["content_type"] != "image/png" {
-		t.Fatalf("content_type = %v, want image/png", data["content_type"])
-	}
-	if int(data["size_bytes"].(float64)) != len("png-data") {
-		t.Fatalf("size_bytes = %v", data["size_bytes"])
-	}
-	savedPath, _ := data["saved_path"].(string)
-	if !strings.HasSuffix(savedPath, "cover.png") {
-		t.Fatalf("saved_path = %q, want cover.png suffix", savedPath)
-	}
-	content, err := os.ReadFile(filepath.Join(tmpDir, "cover.png"))
-	if err != nil {
-		t.Fatalf("ReadFile(cover.png) error: %v", err)
-	}
-	if string(content) != "png-data" {
-		t.Fatalf("downloaded content = %q", string(content))
-	}
-	cover := data["cover"].(map[string]interface{})
-	if cover["token"] != coverToken {
-		t.Fatalf("cover.token = %v, want %s", cover["token"], coverToken)
-	}
-}
-
-func TestDocResourceDownloadCoverEmptyReturnsErrorWithoutDownload(t *testing.T) {
-	f, _, _, reg := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-empty-download-app"))
-	documentID := "doxcnCoverEmptyDownload1"
-	reg.Register(docCoverMetadataStub(documentID, map[string]interface{}{}))
-
-	tmpDir := t.TempDir()
-	withDocsWorkingDir(t, tmpDir)
-
-	err := mountAndRunDocs(t, DocResourceDownload, []string{
-		"resource-download",
-		"--doc", documentID,
-		"--type", "cover",
-		"--output", "cover.png",
-		"--as", "bot",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected empty cover error, got nil")
-	}
-	assertValidationContract(t, err, errs.SubtypeFailedPrecondition, "--type")
-	if _, statErr := os.Stat(filepath.Join(tmpDir, "cover.png")); !os.IsNotExist(statErr) {
-		t.Fatalf("cover.png should not be created, statErr=%v", statErr)
-	}
-}
-
-func TestDocResourceDeleteCoverEmptyIsIdempotent(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-empty-delete-app"))
-	documentID := "doxcnCoverEmptyDelete1"
-	reg.Register(docCoverMetadataStub(documentID, map[string]interface{}{}))
-
-	err := mountAndRunDocs(t, DocResourceDelete, []string{
-		"resource-delete",
-		"--doc", documentID,
-		"--type", "cover",
-		"--as", "bot",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-
-	data := decodeDocResourceOutput(t, stdout).Data
-	if data["deleted"] != false {
-		t.Fatalf("deleted = %v, want false", data["deleted"])
-	}
-	if data["already_empty"] != true {
-		t.Fatalf("already_empty = %v, want true", data["already_empty"])
-	}
-}
-
-func TestDocResourceDeleteCoverClearsExistingCover(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-delete-app"))
-	documentID := "doxcnCoverDelete1"
-	reg.Register(docCoverMetadataStub(documentID, map[string]interface{}{"token": "cover_token_delete_123"}))
-	patchStub := &httpmock.Stub{
-		Method: "PATCH",
-		URL:    "/open-apis/docx/v1/documents/" + documentID,
-		Body:   map[string]interface{}{"code": 0, "msg": "ok"},
-	}
-	reg.Register(patchStub)
-
-	err := mountAndRunDocs(t, DocResourceDelete, []string{
-		"resource-delete",
-		"--doc", documentID,
-		"--type", "cover",
-		"--as", "bot",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-
-	body := string(patchStub.CapturedBody)
-	if !strings.Contains(body, `"update_cover"`) || !strings.Contains(body, `"cover":null`) {
-		t.Fatalf("PATCH body = %s, want update_cover.cover=null", body)
-	}
-	data := decodeDocResourceOutput(t, stdout).Data
-	if data["deleted"] != true {
-		t.Fatalf("deleted = %v, want true", data["deleted"])
-	}
-	if data["already_empty"] != false {
-		t.Fatalf("already_empty = %v, want false", data["already_empty"])
-	}
-}
-
-func TestDocResourceUpdateCoverUploadsFileAndReturnsFullTokenOnlyOnStdout(t *testing.T) {
-	f, stdout, stderr, reg := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-update-app"))
-	documentID := "doxcnCoverUpdate1"
-	fileToken := "file_cover_uploaded_token_12345"
-	tmpDir := t.TempDir()
-	withDocsWorkingDir(t, tmpDir)
-	if err := os.WriteFile("cover.png", []byte("png-data"), 0644); err != nil {
-		t.Fatalf("WriteFile() error: %v", err)
-	}
-
-	uploadStub := &httpmock.Stub{
-		Method: "POST",
-		URL:    "/open-apis/drive/v1/medias/upload_all",
-		Body: map[string]interface{}{
-			"code": 0,
-			"data": map[string]interface{}{"file_token": fileToken},
-		},
-	}
-	reg.Register(uploadStub)
-	patchStub := &httpmock.Stub{
-		Method: "PATCH",
-		URL:    "/open-apis/docx/v1/documents/" + documentID,
-		Body:   map[string]interface{}{"code": 0, "msg": "ok"},
-	}
-	reg.Register(patchStub)
-
-	err := mountAndRunDocs(t, DocResourceUpdate, []string{
-		"resource-update",
-		"--doc", documentID,
-		"--type", "cover",
-		"--file", "cover.png",
-		"--offset-ratio-x", "0.2",
-		"--offset-ratio-y", "0.8",
-		"--as", "bot",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v — stderr: %s", err, stderr.String())
-	}
-
-	if !bytes.Contains(uploadStub.CapturedBody, []byte("png-data")) {
-		t.Fatalf("upload body does not contain file bytes")
-	}
-	uploadBody := string(uploadStub.CapturedBody)
-	if !strings.Contains(uploadBody, `name="parent_type"`) || !strings.Contains(uploadBody, "docx_image") {
-		t.Fatalf("upload body missing docx_image parent type: %s", uploadBody)
-	}
-	if !strings.Contains(uploadBody, "drive_route_token") || !strings.Contains(uploadBody, documentID) {
-		t.Fatalf("upload body missing drive_route_token extra: %s", uploadBody)
-	}
-	patchBody := string(patchStub.CapturedBody)
-	for _, want := range []string{`"update_cover"`, `"token":"` + fileToken + `"`, `"offset_ratio_x":0.2`, `"offset_ratio_y":0.8`} {
-		if !strings.Contains(patchBody, want) {
-			t.Fatalf("PATCH body = %s, missing %s", patchBody, want)
-		}
-	}
-
-	if strings.Contains(stderr.String(), fileToken) {
-		t.Fatalf("stderr leaked full file_token: %s", stderr.String())
-	}
-	data := decodeDocResourceOutput(t, stdout).Data
-	if data["file_token"] != fileToken {
-		t.Fatalf("stdout file_token = %v, want %s", data["file_token"], fileToken)
-	}
-	cover := data["cover"].(map[string]interface{})
-	if cover["token"] != fileToken {
-		t.Fatalf("stdout cover.token = %v, want %s", cover["token"], fileToken)
-	}
-}
-
-func TestDocResourceUpdateCoverRejectsMultipleSources(t *testing.T) {
-	f, _, _, _ := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-source-validation-app"))
-
-	err := mountAndRunDocs(t, DocResourceUpdate, []string{
-		"resource-update",
-		"--doc", "doxcnCoverValidate1",
-		"--type", "cover",
-		"--file", "cover.png",
-		"--from-clipboard",
-		"--as", "bot",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected mutual exclusion error, got nil")
-	}
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "", "--file", "--from-clipboard")
-}
-
-func TestDocResourceUpdateCoverRejectsMissingSource(t *testing.T) {
-	f, _, _, _ := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-source-required-app"))
-
-	err := mountAndRunDocs(t, DocResourceUpdate, []string{
-		"resource-update",
-		"--doc", "doxcnCoverValidateRequired1",
-		"--type", "cover",
-		"--as", "bot",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected missing source error, got nil")
-	}
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "", "--file", "--from-clipboard", "--url")
-}
-
-func TestDocResourceUpdateCoverRejectsUnsafeURLSource(t *testing.T) {
-	f, _, _, _ := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-url-validation-app"))
-
-	err := mountAndRunDocs(t, DocResourceUpdate, []string{
-		"resource-update",
-		"--doc", "doxcnCoverURLValidate1",
-		"--type", "cover",
-		"--url", "https://127.0.0.1/cover.png",
-		"--as", "bot",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected unsafe URL error, got nil")
-	}
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "--url")
-}
-
-func TestDocCoverURLSyntaxValidation(t *testing.T) {
-	cases := []struct {
-		name string
-		raw  string
-		ok   bool
-	}{
-		{name: "https", raw: " https://example.com/cover.png ", ok: true},
-		{name: "http", raw: "http://example.com/cover.png"},
-		{name: "userinfo", raw: "https://user:pass@example.com/cover.png"},
-		{name: "empty host", raw: "https:///cover.png"},
-	}
-	for _, tc := range cases {
-		t.Run(tc.name, func(t *testing.T) {
-			u, err := parseDocCoverURLSyntax(tc.raw)
-			if tc.ok {
-				if err != nil {
-					t.Fatalf("parseDocCoverURLSyntax() error: %v", err)
-				}
-				if u.String() != "https://example.com/cover.png" {
-					t.Fatalf("URL = %q, want normalized https URL", u.String())
-				}
-				return
-			}
-			assertValidationContract(t, err, errs.SubtypeInvalidArgument, "--url")
-		})
-	}
-}
-
-func TestDocResourceCoverDryRunsPlanAPIs(t *testing.T) {
-	downloadRT := docValidateRuntime(t, map[string]string{
-		"doc":    "doxcnCoverDryRunDownload",
-		"output": "cover",
-	}, nil, nil)
-	download := decodeDocDryRun(t, DocResourceDownload.DryRun(context.Background(), downloadRT))
-	if len(download.API) != 2 {
-		t.Fatalf("download dry-run API count = %d, want 2", len(download.API))
-	}
-	if got := download.API[0].URL; got != "/open-apis/docx/v1/documents/doxcnCoverDryRunDownload" {
-		t.Fatalf("download metadata URL = %q", got)
-	}
-	if got := download.API[1].URL; got != "/open-apis/drive/v1/medias/%3Ccover.token%3E/download" {
-		t.Fatalf("download media URL = %q", got)
-	}
-
-	updateRT := docValidateRuntime(t, map[string]string{
-		"doc": "https://example.larksuite.com/wiki/wikcnCoverDryRunUpdate",
-		"url": "https://example.com/cover.png",
-	}, nil, nil)
-	update := decodeDocDryRun(t, DocResourceUpdate.DryRun(context.Background(), updateRT))
-	if len(update.API) != 3 {
-		t.Fatalf("update dry-run API count = %d, want 3", len(update.API))
-	}
-	if got := update.API[0].URL; got != "/open-apis/wiki/v2/spaces/get_node" {
-		t.Fatalf("wiki resolve URL = %q", got)
-	}
-	if got := update.API[1].URL; got != "/open-apis/drive/v1/medias/upload_all" {
-		t.Fatalf("upload URL = %q", got)
-	}
-	if got := update.API[2].URL; got != "/open-apis/docx/v1/documents/%3Cresolved_docx_token%3E" {
-		t.Fatalf("patch URL = %q", got)
-	}
-	if got := update.API[1].Body["file"]; got != "https://example.com/cover.png" {
-		t.Fatalf("upload source = %#v", got)
-	}
-
-	deleteRT := docValidateRuntime(t, map[string]string{"doc": "doxcnCoverDryRunDelete"}, nil, nil)
-	deleteDry := decodeDocDryRun(t, DocResourceDelete.DryRun(context.Background(), deleteRT))
-	if len(deleteDry.API) != 2 {
-		t.Fatalf("delete dry-run API count = %d, want 2", len(deleteDry.API))
-	}
-	if got := deleteDry.API[1].URL; got != "/open-apis/docx/v1/documents/doxcnCoverDryRunDelete" {
-		t.Fatalf("delete patch URL = %q", got)
-	}
-}
-
-func TestDocResourceCoverDryRunReportsInvalidDoc(t *testing.T) {
-	rt := docValidateRuntime(t, map[string]string{"doc": "https://example.com/sheets/shtxxx"}, nil, nil)
-	dry := DocResourceDownload.DryRun(context.Background(), rt)
-	if got := dry.Format(); !strings.Contains(got, "error:") {
-		t.Fatalf("dry-run error output = %q, want error field", got)
-	}
-}
-
-func TestParseAndValidateDocCoverURLRejectsUnsafeIP(t *testing.T) {
-	_, err := parseAndValidateDocCoverURL(context.Background(), "https://127.0.0.1/cover.png")
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "--url")
-}
-
-func TestValidateDocCoverURLHost(t *testing.T) {
-	for _, host := range []string{"", "localhost", "service.localhost", "127.0.0.1"} {
-		t.Run(host, func(t *testing.T) {
-			assertValidationContract(t, validateDocCoverURLHost(context.Background(), host), errs.SubtypeInvalidArgument, "--url")
-		})
-	}
-	if err := validateDocCoverURLHost(context.Background(), "1.1.1.1"); err != nil {
-		t.Fatalf("validateDocCoverURLHost(public IP) error: %v", err)
-	}
-}
-
-func TestDocCoverIPSafetyBlocksSpecialRanges(t *testing.T) {
-	for _, rawIP := range []string{
-		"10.0.0.1",
-		"127.0.0.1",
-		"169.254.1.1",
-		"172.16.0.1",
-		"192.168.0.1",
-		"100.64.0.1",
-		"198.18.0.1",
-		"240.0.0.1",
-	} {
-		t.Run(rawIP, func(t *testing.T) {
-			if !isUnsafeDocCoverIP(net.ParseIP(rawIP)) {
-				t.Fatalf("%s was classified as safe", rawIP)
-			}
-		})
-	}
-	if isUnsafeDocCoverIP(net.ParseIP("1.1.1.1")) {
-		t.Fatal("public IPv4 address was classified as unsafe")
-	}
-}
-
-func TestDocCoverHTTPClientDoesNotUseProxy(t *testing.T) {
-	baseTransport := &http.Transport{Proxy: http.ProxyFromEnvironment}
-	baseClient := &http.Client{Transport: baseTransport}
-
-	client := newDocCoverHTTPClient(baseClient)
-	transport, ok := client.Transport.(*http.Transport)
-	if !ok {
-		t.Fatalf("client transport = %T, want *http.Transport", client.Transport)
-	}
-	if transport.Proxy != nil {
-		t.Fatal("cover URL downloader must not inherit proxy settings")
-	}
-	if baseTransport.Proxy == nil {
-		t.Fatal("base transport proxy was mutated")
-	}
-}
-
-func TestDocCoverHTTPClientRedirectValidation(t *testing.T) {
-	client := newDocCoverHTTPClient(&http.Client{})
-	req, err := http.NewRequest(http.MethodGet, "https://1.1.1.1/cover.png", nil)
-	if err != nil {
-		t.Fatalf("NewRequest() error: %v", err)
-	}
-	if err := client.CheckRedirect(req, []*http.Request{{}, {}, {}}); err == nil {
-		t.Fatal("expected too many redirects error")
-	}
-
-	prev, err := http.NewRequest(http.MethodGet, "https://1.1.1.1/start", nil)
-	if err != nil {
-		t.Fatalf("NewRequest(prev) error: %v", err)
-	}
-	downgrade, err := http.NewRequest(http.MethodGet, "http://1.1.1.1/cover.png", nil)
-	if err != nil {
-		t.Fatalf("NewRequest(downgrade) error: %v", err)
-	}
-	if err := client.CheckRedirect(downgrade, []*http.Request{prev}); err == nil {
-		t.Fatal("expected https-to-http redirect error")
-	}
-}
-
-func TestDocCoverConnRemoteIPValidation(t *testing.T) {
-	if err := validateDocCoverConnRemoteIP(nil); err == nil {
-		t.Fatal("expected nil connection error")
-	}
-	if err := validateDocCoverConnRemoteIP(docCoverRemoteAddrConn{}); err == nil {
-		t.Fatal("expected missing remote address error")
-	}
-	if err := validateDocCoverConnRemoteIP(docCoverRemoteAddrConn{addr: testAddr("not-ip")}); err == nil {
-		t.Fatal("expected invalid remote IP error")
-	}
-	if err := validateDocCoverConnRemoteIP(docCoverRemoteAddrConn{addr: &net.TCPAddr{IP: net.ParseIP("127.0.0.1"), Port: 443}}); err == nil {
-		t.Fatal("expected local remote IP error")
-	}
-}
-
-func TestDocCoverURLFileName(t *testing.T) {
-	cases := []struct {
-		raw  string
-		ext  string
-		want string
-	}{
-		{raw: "https://example.com/images/cover", ext: ".png", want: "cover.png"},
-		{raw: "https://example.com/images/cover.jpeg", ext: ".png", want: "cover.jpeg"},
-		{raw: "https://example.com/", ext: ".webp", want: "cover.webp"},
-		{raw: "https://example.com/images/%2Fescaped", ext: ".gif", want: "escaped.gif"},
-	}
-	for _, tc := range cases {
-		t.Run(tc.want, func(t *testing.T) {
-			u, err := url.Parse(tc.raw)
-			if err != nil {
-				t.Fatalf("url.Parse(%q): %v", tc.raw, err)
-			}
-			if got := docCoverURLFileName(u, tc.ext); got != tc.want {
-				t.Fatalf("docCoverURLFileName() = %q, want %q", got, tc.want)
-			}
-		})
-	}
-}
-
-func TestDownloadDocCoverURLSuccess(t *testing.T) {
-	runtime, rawURL := newDocCoverURLTestRuntime(t, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Content-Type", "image/png")
-		_, _ = w.Write([]byte("png-data"))
-	}))
-
-	content, fileName, err := downloadDocCoverURL(context.Background(), runtime, rawURL)
-	if err != nil {
-		t.Fatalf("downloadDocCoverURL() error: %v", err)
-	}
-	if string(content) != "png-data" {
-		t.Fatalf("content = %q, want png-data", string(content))
-	}
-	if fileName != "cover.png" {
-		t.Fatalf("fileName = %q, want cover.png", fileName)
-	}
-}
-
-func TestDownloadDocCoverURLRejectsHTTPStatus(t *testing.T) {
-	runtime, rawURL := newDocCoverURLTestRuntime(t, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusServiceUnavailable)
-		_, _ = w.Write([]byte("unavailable"))
-	}))
-
-	_, _, err := downloadDocCoverURL(context.Background(), runtime, rawURL)
-	if err == nil {
-		t.Fatal("expected HTTP status error, got nil")
-	}
-	p, ok := errs.ProblemOf(err)
-	if !ok {
-		t.Fatalf("error = %T %v, want typed problem", err, err)
-	}
-	if p.Category != errs.CategoryNetwork {
-		t.Fatalf("problem category = %v, want %v", p.Category, errs.CategoryNetwork)
-	}
-	if p.Subtype != errs.SubtypeNetworkServer {
-		t.Fatalf("problem subtype = %v, want %v", p.Subtype, errs.SubtypeNetworkServer)
-	}
-	if p.Code != http.StatusServiceUnavailable {
-		t.Fatalf("problem code = %v, want %v", p.Code, http.StatusServiceUnavailable)
-	}
-	var networkErr *errs.NetworkError
-	if !errors.As(err, &networkErr) {
-		t.Fatalf("error = %T %v, want *errs.NetworkError", err, err)
-	}
-	if networkErr.Cause == nil {
-		t.Fatal("expected preserved underlying cause, got nil")
-	}
-}
-
-func TestDownloadDocCoverURLRejectsUnsupportedContentType(t *testing.T) {
-	runtime, rawURL := newDocCoverURLTestRuntime(t, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Content-Type", "text/plain")
-		_, _ = w.Write([]byte("not-image"))
-	}))
-
-	_, _, err := downloadDocCoverURL(context.Background(), runtime, rawURL)
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "--url")
-}
-
-func TestDownloadDocCoverURLRejectsOversizeResponse(t *testing.T) {
-	runtime, rawURL := newDocCoverURLTestRuntime(t, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Content-Type", "image/png")
-		_, _ = io.CopyN(w, repeatByteReader('x'), docCoverURLMaxBytes+1)
-	}))
-
-	_, _, err := downloadDocCoverURL(context.Background(), runtime, rawURL)
-	assertValidationContract(t, err, errs.SubtypeInvalidArgument, "--url")
-}
-
-func TestDocCoverMetadataOutputAndOptionalFloats(t *testing.T) {
-	x := 0.25
-	y := 1.0
-	out := docCoverMetadata{
-		Token:        "cover_token",
-		OffsetRatioX: &x,
-		OffsetRatioY: &y,
-	}.toOutput()
-	if out["token"] != "cover_token" || out["offset_ratio_x"] != x || out["offset_ratio_y"] != y {
-		t.Fatalf("cover output = %#v", out)
-	}
-
-	data := map[string]interface{}{
-		"float": float64(1.5),
-		"int":   2,
-		"int64": int64(3),
-		"text":  "4",
-	}
-	if got, ok := getOptionalFloat(data, "float"); !ok || got != 1.5 {
-		t.Fatalf("float optional = %v/%v, want 1.5/true", got, ok)
-	}
-	if got, ok := getOptionalFloat(data, "int"); !ok || got != 2 {
-		t.Fatalf("int optional = %v/%v, want 2/true", got, ok)
-	}
-	if got, ok := getOptionalFloat(data, "int64"); !ok || got != 3 {
-		t.Fatalf("int64 optional = %v/%v, want 3/true", got, ok)
-	}
-	if _, ok := getOptionalFloat(data, "text"); ok {
-		t.Fatal("string optional unexpectedly parsed as float")
-	}
-	if _, ok := getOptionalFloat(nil, "missing"); ok {
-		t.Fatal("nil map optional unexpectedly returned a value")
-	}
-}
-
-func TestDocCoverDryRunSource(t *testing.T) {
-	cases := []struct {
-		name  string
-		str   map[string]string
-		bools map[string]bool
-		want  string
-	}{
-		{name: "clipboard", bools: map[string]bool{"from-clipboard": true}, want: "<clipboard image>"},
-		{name: "url", str: map[string]string{"url": "https://example.com/cover.png"}, want: "https://example.com/cover.png"},
-		{name: "file", str: map[string]string{"file": "cover.png"}, want: "@cover.png"},
-		{name: "empty", want: "<cover image>"},
-	}
-	for _, tc := range cases {
-		t.Run(tc.name, func(t *testing.T) {
-			rt := docValidateRuntime(t, tc.str, tc.bools, nil)
-			if got := docCoverDryRunSource(rt); got != tc.want {
-				t.Fatalf("docCoverDryRunSource() = %q, want %q", got, tc.want)
-			}
-		})
-	}
-}
-
-func TestDocShortcutsIncludeCoverResourceCommands(t *testing.T) {
-	got := map[string]bool{}
-	for _, shortcut := range Shortcuts() {
-		got[shortcut.Command] = true
-	}
-	for _, want := range []string{"resource-download", "resource-update", "resource-delete"} {
-		if !got[want] {
-			t.Fatalf("Shortcuts() missing %s", want)
-		}
-	}
-}
-
-func newDocCoverURLTestRuntime(t *testing.T, handler http.Handler) (*common.RuntimeContext, string) {
-	t.Helper()
-
-	server := httptest.NewTLSServer(handler)
-	t.Cleanup(server.Close)
-
-	f, _, _, _ := cmdutil.TestFactory(t, docsTestConfigWithAppID("docs-cover-url-download-app"))
-	targetAddr := server.Listener.Addr().String()
-	f.HttpClient = func() (*http.Client, error) {
-		return &http.Client{
-			Transport: &http.Transport{
-				TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
-				DialContext: func(ctx context.Context, network, addr string) (net.Conn, error) {
-					var d net.Dialer
-					conn, err := d.DialContext(ctx, network, targetAddr)
-					if err != nil {
-						return nil, err
-					}
-					return docCoverRemoteAddrConn{
-						Conn: conn,
-						addr: &net.TCPAddr{IP: net.ParseIP("1.1.1.1"), Port: 443},
-					}, nil
-				},
-			},
-		}, nil
-	}
-	return &common.RuntimeContext{Factory: f}, "https://1.1.1.1/assets/cover"
-}
-
-type docCoverRemoteAddrConn struct {
-	net.Conn
-	addr net.Addr
-}
-
-func (c docCoverRemoteAddrConn) RemoteAddr() net.Addr {
-	return c.addr
-}
-
-type testAddr string
-
-func (a testAddr) Network() string {
-	return "test"
-}
-
-func (a testAddr) String() string {
-	return string(a)
-}
-
-type repeatByteReader byte
-
-func (r repeatByteReader) Read(p []byte) (int, error) {
-	for i := range p {
-		p[i] = byte(r)
-	}
-	return len(p), nil
-}
-
-func docCoverMetadataStub(documentID string, cover map[string]interface{}) *httpmock.Stub {
-	return &httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/docx/v1/documents/" + documentID,
-		Body: map[string]interface{}{
-			"code": 0,
-			"msg":  "ok",
-			"data": map[string]interface{}{
-				"document": map[string]interface{}{
-					"cover": cover,
-				},
-			},
-		},
-	}
-}
-
-type docResourceOutput struct {
-	OK   bool                   `json:"ok"`
-	Data map[string]interface{} `json:"data"`
-}
-
-func decodeDocResourceOutput(t *testing.T, stdout *bytes.Buffer) docResourceOutput {
-	t.Helper()
-	var out docResourceOutput
-	if err := json.Unmarshal(stdout.Bytes(), &out); err != nil {
-		t.Fatalf("decode resource output: %v; output=%s", err, stdout.String())
-	}
-	return out
-}

shortcuts/doc/shortcuts.go

@@ -60,9 +60,6 @@ func Shortcuts() []common.Shortcut {
 		DocMediaUpload,
 		DocMediaPreview,
 		DocMediaDownload,
-		DocResourceDownload,
-		DocResourceUpdate,
-		DocResourceDelete,
 	}
 }
 

shortcuts/vc/shortcuts.go

@@ -13,8 +13,6 @@ func Shortcuts() []common.Shortcut {
 		VCRecording,
 		VCMeetingJoin,
 		VCMeetingLeave,
-		VCMeetingListActive,
 		VCMeetingEvents,
-		VCMeetingMessageSend,
 	}
 }

shortcuts/vc/vc_meeting_events.go

@@ -48,7 +48,7 @@ var VCMeetingEvents = common.Shortcut{
 	Description: "List bot meeting events by meeting ID",
 	Risk:        "read",
 	Scopes:      []string{"vc:meeting.meetingevent:read"},
-	AuthTypes:   []string{"user", "bot"},
+	AuthTypes:   []string{"user"},
 	HasFormat:   true,
 	Flags: []common.Flag{
 		{Name: "meeting-id", Required: true, Desc: "meeting ID to query"},
@@ -156,9 +156,6 @@ func validateMeetingEventsMeetingID(meetingID string) error {
 	if meetingID == "" {
 		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--meeting-id is required").WithParam("--meeting-id")
 	}
-	if validMeetingNumber(meetingID) {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--meeting-id must be a long meeting_id, not a 9-digit meeting number; use +meeting-join or +meeting-list-active to get meeting_id").WithParam("--meeting-id")
-	}
 	value, err := strconv.ParseInt(meetingID, 10, 64)
 	if err != nil || value <= 0 {
 		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--meeting-id must be a positive integer, got %q", meetingID).WithParam("--meeting-id")

shortcuts/vc/vc_meeting_events_test.go

@@ -262,26 +262,6 @@ func TestMeetingEvents_Validation_InvalidMeetingID(t *testing.T) {
 	}
 }
 
-func TestMeetingEvents_Validation_RejectsMeetingNumber(t *testing.T) {
-	runtime := newMeetingEventsRuntime()
-	mustSetMeetingEventsFlag(t, runtime, "meeting-id", "732067044")
-
-	err := VCMeetingEvents.Validate(context.Background(), runtime)
-	if err == nil {
-		t.Fatal("expected validation error for 9-digit meeting number")
-	}
-	if !strings.Contains(err.Error(), "not a 9-digit meeting number") {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	var ve *errs.ValidationError
-	if !errors.As(err, &ve) {
-		t.Fatalf("expected *errs.ValidationError, got %T: %v", err, err)
-	}
-	if ve.Param != "--meeting-id" {
-		t.Errorf("Param = %q, want %q", ve.Param, "--meeting-id")
-	}
-}
-
 func TestMeetingEvents_Validation_InvalidTimeRange(t *testing.T) {
 	runtime := newMeetingEventsRuntime()
 	mustSetMeetingEventsFlag(t, runtime, "meeting-id", "7628568141510692381")
@@ -838,7 +818,7 @@ func TestVCShortcuts_RegistersMeetingAgentCommands(t *testing.T) {
 	for _, shortcut := range got {
 		commands = append(commands, shortcut.Command)
 	}
-	want := []string{"+search", "+notes", "+recording", "+meeting-join", "+meeting-leave", "+meeting-list-active", "+meeting-events", "+meeting-message-send"}
+	want := []string{"+search", "+notes", "+recording", "+meeting-join", "+meeting-leave", "+meeting-events"}
 	if !reflect.DeepEqual(commands, want) {
 		t.Fatalf("shortcut commands = %#v, want %#v", commands, want)
 	}

shortcuts/vc/vc_meeting_join.go

@@ -28,7 +28,7 @@ var VCMeetingJoin = common.Shortcut{
 	Description: "Join a meeting by meeting number (bot join)",
 	Risk:        "write",
 	Scopes:      []string{"vc:meeting.bot.join:write"},
-	AuthTypes:   []string{"user", "bot"},
+	AuthTypes:   []string{"user"},
 	HasFormat:   true,
 	Flags: []common.Flag{
 		{Name: "meeting-number", Required: true, Desc: "meeting number to join"},

shortcuts/vc/vc_meeting_leave.go

@@ -20,7 +20,7 @@ var VCMeetingLeave = common.Shortcut{
 	Description: "Leave a meeting by meeting ID",
 	Risk:        "write",
 	Scopes:      []string{"vc:meeting.bot.join:write"},
-	AuthTypes:   []string{"user", "bot"},
+	AuthTypes:   []string{"user"},
 	HasFormat:   true,
 	Flags: []common.Flag{
 		{Name: "meeting-id", Required: true, Desc: "meeting ID to leave"},

shortcuts/vc/vc_meeting_list_active.go

@@ -1,121 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"context"
-	"fmt"
-	"io"
-	"net/http"
-	"strings"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/internal/output"
-	"github.com/larksuite/cli/shortcuts/common"
-)
-
-const vcMeetingListActiveAPIPath = "/open-apis/vc/v1/bots/user_active_meeting"
-
-// VCMeetingListActive lists meetings the current or target user is actively in.
-var VCMeetingListActive = common.Shortcut{
-	Service:     "vc",
-	Command:     "+meeting-list-active",
-	Description: "List active meetings for the current identity or target user",
-	Risk:        "read",
-	Scopes:      []string{"vc:meeting.meetingevent:read"},
-	AuthTypes:   []string{"user", "bot"},
-	HasFormat:   true,
-	Flags: []common.Flag{
-		{Name: "user-id", Desc: "target user ID when using bot identity"},
-	},
-	Validate: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		return validateMeetingListActiveUserID(runtime)
-	},
-	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
-		params, err := buildMeetingListActiveParams(runtime)
-		if err != nil {
-			return common.NewDryRunAPI().Set("error", err.Error())
-		}
-		dryRun := common.NewDryRunAPI().GET(vcMeetingListActiveAPIPath)
-		if len(params) > 0 {
-			dryRun.Params(params)
-		}
-		return dryRun
-	},
-	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		params, err := buildMeetingListActiveParams(runtime)
-		if err != nil {
-			return err
-		}
-		data, err := runtime.CallAPITyped(http.MethodGet, vcMeetingListActiveAPIPath, params, nil)
-		if err != nil {
-			return err
-		}
-		if data == nil {
-			data = map[string]interface{}{}
-		}
-		meetings := common.GetSlice(data, "meetings")
-		runtime.OutFormat(data, &output.Meta{Count: len(meetings)}, func(w io.Writer) {
-			if len(meetings) == 0 {
-				fmt.Fprintln(w, "No active meetings.")
-				return
-			}
-			displayedMeetings := 0
-			for _, raw := range meetings {
-				meeting, _ := raw.(map[string]interface{})
-				if meeting == nil {
-					continue
-				}
-				if displayedMeetings > 0 {
-					fmt.Fprintln(w)
-				}
-				displayedMeetings++
-				title := common.GetString(meeting, "meeting_title")
-				if title == "" {
-					title = "Untitled meeting"
-				}
-				fmt.Fprintf(w, "%s\n", title)
-				if id := common.GetString(meeting, "meeting_id"); id != "" {
-					fmt.Fprintf(w, "  Meeting ID:  %s\n", id)
-				}
-				if no := common.GetString(meeting, "meeting_no"); no != "" {
-					fmt.Fprintf(w, "  Meeting No:  %s\n", no)
-				}
-			}
-			if displayedMeetings > 1 {
-				fmt.Fprintln(w)
-				fmt.Fprintln(w, "Multiple active meetings found. Ask the user to choose one meeting_id before calling +meeting-events.")
-			}
-		})
-		return nil
-	},
-}
-
-// validateMeetingListActiveUserID validates the target user only for bot identity.
-func validateMeetingListActiveUserID(runtime *common.RuntimeContext) error {
-	if !runtime.IsBot() {
-		return nil
-	}
-	userID := strings.TrimSpace(runtime.Str("user-id"))
-	if userID == "" {
-		return errs.NewValidationError(errs.SubtypeInvalidArgument, "--user-id is required when --as bot").WithParam("--user-id")
-	}
-	if _, err := common.ValidateUserIDTyped("--user-id", userID); err != nil {
-		return err
-	}
-	return nil
-}
-
-// buildMeetingListActiveParams builds the query params for active meeting lookup.
-func buildMeetingListActiveParams(runtime *common.RuntimeContext) (map[string]interface{}, error) {
-	if err := validateMeetingListActiveUserID(runtime); err != nil {
-		return nil, err
-	}
-	params := map[string]interface{}{}
-	if runtime.IsBot() {
-		userID := strings.TrimSpace(runtime.Str("user-id"))
-		params["user_id"] = userID
-	}
-	return params, nil
-}

shortcuts/vc/vc_meeting_message_send.go

@@ -1,135 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"context"
-	"fmt"
-	"io"
-	"net/http"
-	"strings"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/shortcuts/common"
-)
-
-const (
-	meetingMessageTypeText     = "text"
-	meetingMessageTypeReaction = "reaction"
-)
-
-// VCMeetingMessageSend sends an in-meeting text message or reaction emoji.
-var VCMeetingMessageSend = common.Shortcut{
-	Service:     "vc",
-	Command:     "+meeting-message-send",
-	Description: "Send an in-meeting text message or reaction emoji",
-	Risk:        "write",
-	Scopes:      []string{"vc:meeting.message:write"},
-	AuthTypes:   []string{"user", "bot"},
-	HasFormat:   true,
-	Flags: []common.Flag{
-		{Name: "meeting-id", Required: true, Desc: "meeting ID to send into"},
-		{Name: "msg-type", Desc: "message type: text or reaction"},
-		{Name: "text", Desc: "text content when --msg-type text"},
-		{Name: "emoji-type", Desc: "emoji key when --msg-type reaction, for example LOVE, THUMBSUP, VC_NoSound"},
-		{Name: "uuid", Desc: "optional idempotency key"},
-	},
-	Validate: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		if err := validateMeetingEventsMeetingID(runtime.Str("meeting-id")); err != nil {
-			return err
-		}
-		_, err := resolveMeetingMessageType(runtime)
-		return err
-	},
-	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
-		body, err := buildMeetingMessageSendBody(runtime)
-		if err != nil {
-			return common.NewDryRunAPI().Set("error", err.Error())
-		}
-		return common.NewDryRunAPI().
-			POST(buildMeetingMessageSendPath()).
-			Body(body)
-	},
-	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
-		body, err := buildMeetingMessageSendBody(runtime)
-		if err != nil {
-			return err
-		}
-		data, err := runtime.CallAPITyped(http.MethodPost, buildMeetingMessageSendPath(), nil, body)
-		if err != nil {
-			return err
-		}
-		if data == nil {
-			data = map[string]interface{}{}
-		}
-		runtime.OutFormat(data, nil, func(w io.Writer) {
-			fmt.Fprintln(w, "Meeting message sent.")
-			if msgType := common.GetString(data, "msg_type"); msgType != "" {
-				fmt.Fprintf(w, "  Type:  %s\n", msgType)
-			} else if msgType, _ := body["msg_type"].(string); msgType != "" {
-				fmt.Fprintf(w, "  Type:  %s\n", msgType)
-			}
-			if uuid := common.GetString(data, "uuid"); uuid != "" {
-				fmt.Fprintf(w, "  UUID:  %s\n", uuid)
-			}
-		})
-		return nil
-	},
-}
-
-func buildMeetingMessageSendPath() string {
-	return "/open-apis/vc/v1/bots/message"
-}
-
-func buildMeetingMessageSendBody(runtime *common.RuntimeContext) (map[string]interface{}, error) {
-	msgType, err := resolveMeetingMessageType(runtime)
-	if err != nil {
-		return nil, err
-	}
-	body := map[string]interface{}{
-		"meeting_id": strings.TrimSpace(runtime.Str("meeting-id")),
-		"msg_type":   msgType,
-	}
-	switch msgType {
-	case meetingMessageTypeText:
-		body["content"] = strings.TrimSpace(runtime.Str("text"))
-	case meetingMessageTypeReaction:
-		body["content"] = strings.TrimSpace(runtime.Str("emoji-type"))
-	}
-	if uuid := strings.TrimSpace(runtime.Str("uuid")); uuid != "" {
-		body["uuid"] = uuid
-	}
-	return body, nil
-}
-
-func resolveMeetingMessageType(runtime *common.RuntimeContext) (string, error) {
-	msgType := strings.ToLower(strings.TrimSpace(runtime.Str("msg-type")))
-	text := strings.TrimSpace(runtime.Str("text"))
-	emojiType := strings.TrimSpace(runtime.Str("emoji-type"))
-
-	if msgType == "" {
-		switch {
-		case text != "" && emojiType == "":
-			msgType = meetingMessageTypeText
-		case text == "" && emojiType != "":
-			msgType = meetingMessageTypeReaction
-		default:
-			return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "--msg-type is required when both --text and --emoji-type are empty or both are set").WithParam("--msg-type")
-		}
-	}
-
-	switch msgType {
-	case meetingMessageTypeText:
-		if text == "" {
-			return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "--text is required when --msg-type text").WithParam("--text")
-		}
-	case meetingMessageTypeReaction:
-		if emojiType == "" {
-			return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "--emoji-type is required when --msg-type reaction").WithParam("--emoji-type")
-		}
-	default:
-		return "", errs.NewValidationError(errs.SubtypeInvalidArgument, "--msg-type must be text or reaction").WithParam("--msg-type")
-	}
-	return msgType, nil
-}

shortcuts/vc/vc_meeting_message_send_test.go

@@ -1,142 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"context"
-	"strings"
-	"testing"
-
-	"github.com/spf13/cobra"
-
-	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/shortcuts/common"
-)
-
-func newMeetingMessageSendRuntime() *common.RuntimeContext {
-	cmd := &cobra.Command{Use: "test"}
-	cmd.Flags().String("meeting-id", "", "")
-	cmd.Flags().String("msg-type", "", "")
-	cmd.Flags().String("text", "", "")
-	cmd.Flags().String("emoji-type", "", "")
-	cmd.Flags().String("uuid", "", "")
-	return common.TestNewRuntimeContext(cmd, defaultConfig())
-}
-
-func mustSetMeetingMessageSendFlag(t *testing.T, runtime *common.RuntimeContext, name, value string) {
-	t.Helper()
-	if err := runtime.Cmd.Flags().Set(name, value); err != nil {
-		t.Fatalf("Flags().Set(%q, %q) error = %v", name, value, err)
-	}
-}
-
-func TestMeetingMessageSendBuildBody_Text(t *testing.T) {
-	runtime := newMeetingMessageSendRuntime()
-	mustSetMeetingMessageSendFlag(t, runtime, "text", " hello ")
-	mustSetMeetingMessageSendFlag(t, runtime, "uuid", " cid-1 ")
-
-	body, err := buildMeetingMessageSendBody(runtime)
-	if err != nil {
-		t.Fatalf("buildMeetingMessageSendBody() error = %v", err)
-	}
-	if body["msg_type"] != meetingMessageTypeText {
-		t.Fatalf("msg_type = %v, want text", body["msg_type"])
-	}
-	if body["content"] != "hello" {
-		t.Fatalf("content = %v, want hello", body["content"])
-	}
-	if body["uuid"] != "cid-1" {
-		t.Fatalf("uuid = %v, want cid-1", body["uuid"])
-	}
-}
-
-func TestMeetingMessageSendBuildBody_Reaction(t *testing.T) {
-	runtime := newMeetingMessageSendRuntime()
-	mustSetMeetingMessageSendFlag(t, runtime, "msg-type", "reaction")
-	mustSetMeetingMessageSendFlag(t, runtime, "emoji-type", "LOVE")
-
-	body, err := buildMeetingMessageSendBody(runtime)
-	if err != nil {
-		t.Fatalf("buildMeetingMessageSendBody() error = %v", err)
-	}
-	if body["msg_type"] != meetingMessageTypeReaction {
-		t.Fatalf("msg_type = %v, want reaction", body["msg_type"])
-	}
-	if body["content"] != "LOVE" {
-		t.Fatalf("content = %v, want LOVE", body["content"])
-	}
-	if _, ok := body["text"]; ok {
-		t.Fatalf("text should be omitted for reaction, got %#v", body["text"])
-	}
-	if _, ok := body["emoji_type"]; ok {
-		t.Fatalf("emoji_type should be omitted for reaction, got %#v", body["emoji_type"])
-	}
-}
-
-func TestMeetingMessageSendBuildBody_ReactionVCFeedbackKey(t *testing.T) {
-	runtime := newMeetingMessageSendRuntime()
-	mustSetMeetingMessageSendFlag(t, runtime, "msg-type", "reaction")
-	mustSetMeetingMessageSendFlag(t, runtime, "emoji-type", "VC_NoSound")
-
-	body, err := buildMeetingMessageSendBody(runtime)
-	if err != nil {
-		t.Fatalf("buildMeetingMessageSendBody() error = %v", err)
-	}
-	if body["content"] != "VC_NoSound" {
-		t.Fatalf("content = %v, want VC_NoSound", body["content"])
-	}
-}
-
-func TestMeetingMessageSendValidateRejectsMeetingNumber(t *testing.T) {
-	runtime := newMeetingMessageSendRuntime()
-	mustSetMeetingMessageSendFlag(t, runtime, "meeting-id", "123456789")
-	mustSetMeetingMessageSendFlag(t, runtime, "text", "hello")
-
-	err := VCMeetingMessageSend.Validate(context.Background(), runtime)
-	if err == nil {
-		t.Fatal("expected validation error")
-	}
-	if !strings.Contains(err.Error(), "9-digit meeting number") {
-		t.Fatalf("error = %v, want 9-digit meeting number hint", err)
-	}
-}
-
-func TestMeetingMessageSendValidateRejectsMissingEmojiType(t *testing.T) {
-	runtime := newMeetingMessageSendRuntime()
-	mustSetMeetingMessageSendFlag(t, runtime, "meeting-id", "7651377260537433044")
-	mustSetMeetingMessageSendFlag(t, runtime, "msg-type", "reaction")
-
-	err := VCMeetingMessageSend.Validate(context.Background(), runtime)
-	if err == nil {
-		t.Fatal("expected validation error")
-	}
-	if !strings.Contains(err.Error(), "--emoji-type is required") {
-		t.Fatalf("error = %v, want --emoji-type required", err)
-	}
-}
-
-func TestMeetingMessageSendDryRun_Text(t *testing.T) {
-	f, stdout, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingMessageSend, []string{
-		"+meeting-message-send", "--dry-run", "--as", "user",
-		"--meeting-id", "7651377260537433044",
-		"--text", "hello",
-		"--uuid", "cid-1",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	out := stdout.String()
-	for _, want := range []string{
-		"/open-apis/vc/v1/bots/message",
-		"\"meeting_id\": \"7651377260537433044\"",
-		"\"msg_type\": \"text\"",
-		"\"content\": \"hello\"",
-		"\"uuid\": \"cid-1\"",
-	} {
-		if !strings.Contains(out, want) {
-			t.Fatalf("dry-run output missing %q: %s", want, out)
-		}
-	}
-}

shortcuts/vc/vc_meeting_test.go

@@ -8,7 +8,6 @@ import (
 	"context"
 	"encoding/json"
 	"errors"
-	"net/http"
 	"strings"
 	"testing"
 
@@ -16,7 +15,6 @@ import (
 
 	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/core"
 	"github.com/larksuite/cli/internal/httpmock"
 	"github.com/larksuite/cli/shortcuts/common"
 )
@@ -591,335 +589,6 @@ func TestMeetingLeave_Execute_APIError(t *testing.T) {
 	}
 }
 
-func TestMeetingListActive_DryRun_UserIdentity(t *testing.T) {
-	f, stdout, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--dry-run", "--as", "user",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	out := stdout.String()
-	if !strings.Contains(out, "/open-apis/vc/v1/bots/user_active_meeting") {
-		t.Errorf("dry-run should include API path, got: %s", out)
-	}
-	if strings.Contains(out, "user_id") {
-		t.Errorf("user identity should not send user_id by default, got: %s", out)
-	}
-}
-
-func TestMeetingListActive_ScopeMatchesEventReadPermission(t *testing.T) {
-	if len(VCMeetingListActive.Scopes) != 1 || VCMeetingListActive.Scopes[0] != "vc:meeting.meetingevent:read" {
-		t.Fatalf("scopes = %#v, want [vc:meeting.meetingevent:read]", VCMeetingListActive.Scopes)
-	}
-}
-
-func TestMeetingListActive_DryRun_UserIdentityIgnoresUserID(t *testing.T) {
-	f, stdout, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--dry-run", "--as", "user", "--user-id", "not-open-id",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	if strings.Contains(stdout.String(), "user_id") {
-		t.Errorf("user identity should not send user_id, got: %s", stdout.String())
-	}
-}
-
-func TestMeetingListActive_Execute_UserIdentityIgnoresInvalidUserID(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, defaultConfig())
-
-	var gotUserID string
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		OnMatch: func(req *http.Request) {
-			gotUserID = req.URL.Query().Get("user_id")
-		},
-		Body: map[string]interface{}{
-			"code": 0, "msg": "ok",
-			"data": map[string]interface{}{"meetings": []interface{}{}},
-		},
-	})
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--as", "user", "--user-id", "not-open-id", "--format", "json",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	if gotUserID != "" {
-		t.Fatalf("user identity should not send user_id, got %q", gotUserID)
-	}
-}
-
-func TestMeetingListActive_Validate_BotRequiresUserID(t *testing.T) {
-	f, _, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingListActive, []string{"+meeting-list-active", "--as", "bot"}, f, nil)
-	if err == nil {
-		t.Fatal("expected error when --as bot omits --user-id")
-	}
-	assertMeetingListActiveUserIDValidationError(t, err)
-}
-
-func TestMeetingListActive_Validate_UserIDOpenIDFormat(t *testing.T) {
-	f, _, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--as", "bot", "--user-id", "300",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected error for non-open_id user-id")
-	}
-	assertMeetingListActiveUserIDValidationError(t, err)
-}
-
-func TestMeetingListActive_Execute_BotPassesUserID(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, defaultConfig())
-
-	var gotUserID string
-	stub := &httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		OnMatch: func(req *http.Request) {
-			gotUserID = req.URL.Query().Get("user_id")
-		},
-		Body: map[string]interface{}{
-			"code": 0, "msg": "ok",
-			"data": map[string]interface{}{
-				"meetings": []interface{}{
-					map[string]interface{}{
-						"meeting_id":    "9001",
-						"meeting_no":    "123456789",
-						"meeting_title": "Standup",
-					},
-				},
-			},
-		},
-	}
-	reg.Register(stub)
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--user-id", "ou_300",
-		"--format", "json", "--as", "bot",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	if gotUserID != "ou_300" {
-		t.Fatalf("user_id query = %q, want ou_300", gotUserID)
-	}
-
-	var resp map[string]any
-	if err := json.Unmarshal(stdout.Bytes(), &resp); err != nil {
-		t.Fatalf("failed to parse stdout: %v", err)
-	}
-	data, _ := resp["data"].(map[string]any)
-	meetings, _ := data["meetings"].([]any)
-	if len(meetings) != 1 {
-		t.Fatalf("meetings = %d, want 1 (envelope: %s)", len(meetings), stdout.String())
-	}
-}
-
-func TestMeetingListActive_DryRun_BotValidationErrorEnvelope(t *testing.T) {
-	cmd := &cobra.Command{Use: "+meeting-list-active"}
-	cmd.Flags().String("user-id", "", "")
-	runtime := common.TestNewRuntimeContextWithIdentity(cmd, defaultConfig(), core.AsBot)
-
-	dry := VCMeetingListActive.DryRun(context.Background(), runtime)
-	if dry == nil {
-		t.Fatal("DryRun returned nil")
-	}
-	raw, err := json.Marshal(dry)
-	if err != nil {
-		t.Fatalf("failed to marshal dry-run output: %v", err)
-	}
-	got := string(raw)
-	if !strings.Contains(got, "--user-id") {
-		t.Fatalf("dry-run error = %q, want user-id validation", got)
-	}
-}
-
-func TestMeetingListActive_DryRun_BotSendsUserID(t *testing.T) {
-	f, stdout, _, _ := cmdutil.TestFactory(t, defaultConfig())
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--dry-run", "--as", "bot", "--user-id", "ou_300",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	if !strings.Contains(stdout.String(), "user_id") || !strings.Contains(stdout.String(), "ou_300") {
-		t.Fatalf("dry-run should include user_id=ou_300, got: %s", stdout.String())
-	}
-}
-
-func TestMeetingListActive_Execute_ValidationError(t *testing.T) {
-	cmd := &cobra.Command{Use: "+meeting-list-active"}
-	cmd.Flags().String("user-id", "", "")
-	runtime := common.TestNewRuntimeContextWithIdentity(cmd, defaultConfig(), core.AsBot)
-
-	err := VCMeetingListActive.Execute(context.Background(), runtime)
-	if err == nil {
-		t.Fatal("expected validation error")
-	}
-	assertMeetingListActiveUserIDValidationError(t, err)
-}
-
-func TestMeetingListActive_ExecutePretty_Empty(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, defaultConfig())
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		Body:   map[string]interface{}{"code": 0, "msg": "ok"},
-	})
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--format", "pretty", "--as", "user",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	if !strings.Contains(stdout.String(), "No active meetings.") {
-		t.Fatalf("pretty output = %q, want empty-state message", stdout.String())
-	}
-}
-
-func TestMeetingListActive_ExecutePretty_SingleMeetingNoSelectionPrompt(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, defaultConfig())
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		Body: map[string]interface{}{
-			"code": 0,
-			"data": map[string]interface{}{
-				"meetings": []interface{}{
-					map[string]interface{}{
-						"meeting_id":    "9001",
-						"meeting_no":    "123456789",
-						"meeting_title": "Standup",
-					},
-				},
-			},
-		},
-	})
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--format", "pretty", "--as", "user",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	out := stdout.String()
-	for _, want := range []string{"Standup", "Meeting ID:  9001", "Meeting No:  123456789"} {
-		if !strings.Contains(out, want) {
-			t.Fatalf("pretty output missing %q: %s", want, out)
-		}
-	}
-	if strings.Contains(out, "Multiple active meetings found") {
-		t.Fatalf("single meeting should not show selection prompt: %s", out)
-	}
-}
-
-func TestMeetingListActive_ExecutePretty_MultipleMeetings(t *testing.T) {
-	f, stdout, _, reg := cmdutil.TestFactory(t, defaultConfig())
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		Body: map[string]interface{}{
-			"code": 0,
-			"data": map[string]interface{}{
-				"meetings": []interface{}{
-					map[string]interface{}{
-						"meeting_id":    "9001",
-						"meeting_no":    "123456789",
-						"meeting_title": "Standup",
-					},
-					"ignored",
-					map[string]interface{}{
-						"meeting_id":    "9002",
-						"meeting_no":    "987654321",
-						"meeting_title": "Planning",
-					},
-					map[string]interface{}{
-						"meeting_id": "9003",
-					},
-				},
-			},
-		},
-	})
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--format", "pretty", "--as", "user",
-	}, f, stdout)
-	if err != nil {
-		t.Fatalf("unexpected error: %v", err)
-	}
-	out := stdout.String()
-	for _, want := range []string{
-		"Standup",
-		"Meeting ID:  9001",
-		"Meeting No:  123456789",
-		"Planning",
-		"Meeting ID:  9002",
-		"Meeting No:  987654321",
-		"Untitled meeting",
-		"Meeting ID:  9003",
-		"Multiple active meetings found. Ask the user to choose one meeting_id before calling +meeting-events.",
-	} {
-		if !strings.Contains(out, want) {
-			t.Fatalf("pretty output missing %q: %s", want, out)
-		}
-	}
-}
-
-func TestMeetingListActive_Execute_APIError(t *testing.T) {
-	f, _, _, reg := cmdutil.TestFactory(t, defaultConfig())
-	reg.Register(&httpmock.Stub{
-		Method: "GET",
-		URL:    "/open-apis/vc/v1/bots/user_active_meeting",
-		Body:   map[string]interface{}{"code": 121005, "msg": "no permission"},
-	})
-
-	err := mountAndRun(t, VCMeetingListActive, []string{
-		"+meeting-list-active", "--format", "json", "--as", "user",
-	}, f, nil)
-	if err == nil {
-		t.Fatal("expected API error")
-	}
-	if p, ok := errs.ProblemOf(err); !ok || p.Category != errs.CategoryAuthorization {
-		t.Fatalf("error problem = (%+v, %t), want authorization problem", p, ok)
-	} else if p.Subtype != errs.SubtypePermissionDenied {
-		t.Fatalf("error subtype = %q, want %q", p.Subtype, errs.SubtypePermissionDenied)
-	} else if p.Code != 121005 {
-		t.Fatalf("error code = %d, want 121005", p.Code)
-	}
-	var pe *errs.PermissionError
-	if !errors.As(err, &pe) {
-		t.Fatalf("expected *errs.PermissionError, got %T: %v", err, err)
-	}
-}
-
-func assertMeetingListActiveUserIDValidationError(t *testing.T, err error) {
-	t.Helper()
-	p, ok := errs.ProblemOf(err)
-	if !ok {
-		t.Fatalf("expected typed problem, got %T: %v", err, err)
-	}
-	if p.Category != errs.CategoryValidation {
-		t.Errorf("Category = %q, want %q", p.Category, errs.CategoryValidation)
-	}
-	if p.Subtype != errs.SubtypeInvalidArgument {
-		t.Errorf("Subtype = %q, want %q", p.Subtype, errs.SubtypeInvalidArgument)
-	}
-	var ve *errs.ValidationError
-	if !errors.As(err, &ve) {
-		t.Fatalf("expected *errs.ValidationError, got %T: %v", err, err)
-	}
-	if ve.Param != "--user-id" {
-		t.Errorf("Param = %q, want %q", ve.Param, "--user-id")
-	}
-}
-
 // ---------------------------------------------------------------------------
 // Typed error lock assertions
 // ---------------------------------------------------------------------------

skills/lark-doc/SKILL.md

@@ -5,7 +5,7 @@ description: "飞书云文档（Docx / Wiki 文档，v2 API）：读取和编辑
 metadata:
   requires:
     bins: ["lark-cli"]
-  cliHelp: "lark-cli docs --api-version v2 --help; lark-cli docs +create --api-version v2 --help; lark-cli docs +fetch --api-version v2 --help; lark-cli docs +update --api-version v2 --help; lark-cli docs resource-download --help; lark-cli docs resource-update --help; lark-cli docs resource-delete --help"
+  cliHelp: "lark-cli docs --api-version v2 --help; lark-cli docs +create --api-version v2 --help; lark-cli docs +fetch --api-version v2 --help; lark-cli docs +update --api-version v2 --help"
 ---
 
 # docs (v2)
@@ -45,8 +45,6 @@ lark-cli docs +update --api-version v2 --doc "文档URL或token" --command appen
 - 新增画板必须隔离到 SubAgent：简单图由 SubAgent 直接插入 `<whiteboard type="svg">完整 SVG</whiteboard>`，不读 `lark-whiteboard`；复杂图才由主 Agent 先建 `<whiteboard type="blank"></whiteboard>`，再启动 SubAgent 读取 `lark-whiteboard` 写入
 - 用户说"看一下文档里的图片/附件/素材""预览素材" → 用 `lark-cli docs +media-preview`
 - 用户明确说"下载素材" → 用 `lark-cli docs +media-download`
-- 用户明确说"下载/更新/删除文档封面图" → 用 `lark-cli docs resource-download/resource-update/resource-delete --type cover`
-- `resource-*` 目前仅支持 Docx 封面资源；其他图片、附件或素材请走 `+media-*`
 - 如果目标是画板/whiteboard/画板缩略图 → 只能用 `lark-cli docs +media-download --type whiteboard`（不要用 `+media-preview`）
 - 拿到 spreadsheet URL/token 后 → 切到 `lark-sheets` 做对象内部操作
 - 用户说"给文档加评论""查看评论""回复评论""给评论加/删除表情 reaction" → 切到 `lark-drive` 处理
@@ -73,7 +71,6 @@ Shortcut 是对常用操作的高级封装（`lark-cli docs +<verb> [flags]`）
 | [`+media-insert`](references/lark-doc-media-insert.md) | Insert a local image or file at the end of a Lark document (4-step orchestration + auto-rollback). Prefer `--from-clipboard` when the image is already on the system clipboard (screenshots, copy from Feishu/browser); use `--file` only for on-disk sources. |
 | [`+media-download`](references/lark-doc-media-download.md) | Download document media or whiteboard thumbnail (auto-detects extension) |
 | [`+media-preview`](references/lark-doc-media-preview.md) | Preview document media file (auto-detects extension) |
-| [`resource-download` / `resource-update` / `resource-delete`](references/lark-doc-resource-cover.md) | Download, update, or delete a Docx cover image resource with `--type cover` |
 | [`+whiteboard-update`](../lark-whiteboard/references/lark-whiteboard-update.md) | Alias of `whiteboard +update`. Update an existing whiteboard with DSL, Mermaid or PlantUML. Prefer `whiteboard +update`; refer to lark-whiteboard skill for details. |
 
 ## 不在本 Skill 范围

skills/lark-doc/references/lark-doc-fetch.md

@@ -124,7 +124,6 @@ lark-cli docs +fetch --api-version v2 --doc Z1Fj...tnAc \
 - `<img>` / `<source>` 带 `url` 时，直接用该 URL 下载即可（普通 HTTP GET），无需走 shortcut。
 - 没有 `url`、或只想预览 → `docs +media-preview --token <token> --output ./preview_media`
 - 明确下载，或目标是 `<whiteboard>`（画板只能走 shortcut） → `docs +media-download --token <token> --output ./downloaded_media`
-- 文档封面图不是正文素材；下载/更新/删除封面图 → `docs resource-download/resource-update/resource-delete --type cover`
 
 ## 嵌入电子表格 / 多维表格
 
@@ -135,5 +134,4 @@ lark-cli docs +fetch --api-version v2 --doc Z1Fj...tnAc \
 - [lark-doc-create](lark-doc-create.md) — 创建文档
 - [lark-doc-update](lark-doc-update.md) — 更新文档
 - [lark-doc-media-preview](lark-doc-media-preview.md) — 预览素材
-- [lark-doc-media-download](lark-doc-media-download.md) — 下载素材/画板缩略图
-- [lark-doc-resource-cover](lark-doc-resource-cover.md) — 读取、更新、删除文档封面图
+- [lark-doc-media-download](lark-doc-media-download.md) — 下载素材/画板缩略图

skills/lark-doc/references/lark-doc-resource-cover.md

@@ -1,70 +0,0 @@
-# docs resource-*（Docx 封面图资源）
-
-> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
-
-Docx 封面图不是正文里的 `<img token="...">` 素材块。读取、更新、删除文档封面图时，使用 `docs resource-download/resource-update/resource-delete --type cover`，不要使用 `+media-insert` 或 `+media-download --token <cover.token>` 让用户手动拼步骤。
-
-## 选择规则
-
-- 用户要下载文档封面图：`docs resource-download --type cover`
-- 用户要设置/替换文档封面图：`docs resource-update --type cover`
-- 用户要删除文档封面图：`docs resource-delete --type cover`
-- 用户要下载正文图片、附件、画板缩略图：继续使用 [`docs +media-download`](lark-doc-media-download.md)
-
-## 命令
-
-```bash
-# 下载封面图。CLI 会先读取 document.cover.token，再下载图片内容并保存到本地。
-lark-cli docs resource-download --doc doxcnXXX --type cover --output ./cover
-
-# 使用本地文件更新封面图。
-lark-cli docs resource-update --doc doxcnXXX --type cover --file ./cover.png
-
-# 使用剪切板图片更新封面图。
-lark-cli docs resource-update --doc doxcnXXX --type cover --from-clipboard
-
-# 使用 HTTPS URL 更新封面图。CLI 会先下载 URL 内容，再上传并写入 cover.token。
-lark-cli docs resource-update --doc doxcnXXX --type cover --url "https://example.com/cover.png"
-
-# 可选：设置封面图裁切偏移。
-lark-cli docs resource-update --doc doxcnXXX --type cover --file ./cover.png --offset-ratio-x 0.2 --offset-ratio-y 0.8
-
-# 删除封面图；当文档本来没有封面图时也成功返回。
-lark-cli docs resource-delete --doc doxcnXXX --type cover
-```
-
-## 参数
-
-| 命令 | 参数 | 必填 | 说明 |
-|------|------|------|------|
-| all | `--doc <id>` | 是 | 文档 ID、docx URL，或可解析为 docx 的 wiki URL |
-| all | `--type cover` | 否 | 当前只支持 `cover`；默认值也是 `cover` |
-| download | `--output <path>` | 是 | 本地保存路径；不带扩展名会根据响应类型自动补全 |
-| download | `--overwrite` | 否 | 覆盖已存在的输出文件 |
-| update | `--file <path>` | 三选一 | 磁盘上的真实图片文件；大于 20MiB 自动使用分片上传 |
-| update | `--from-clipboard` | 三选一 | 从系统剪切板读取图片 |
-| update | `--url <https-url>` | 三选一 | 从 HTTPS URL 下载图片后上传 |
-| update | `--offset-ratio-x <number>` | 否 | 视图相对原图中心的横向偏移比例：水平偏移 px / 原图宽度 px；0 为居中，正数向右，负数向左 |
-| update | `--offset-ratio-y <number>` | 否 | 视图相对原图中心的纵向偏移比例：垂直偏移 px / 原图高度 px；0 为居中，正数向上，负数向下 |
-
-## 输出契约
-
-- `resource-download` 成功时 stdout JSON 的 `data` 包含 `document_id`、`type`、`saved_path`、`size_bytes`、`content_type`、`cover.token`。如果文档没有封面图，命令失败退出，错误包含 `document has no cover` 和脱敏 `document_id`，不会创建输出文件。
-- `resource-update` 成功时 stdout JSON 的 `data` 包含完整 `file_token` 和 `cover.token`；stderr 只打印脱敏 token。
-- `resource-delete` 成功时 stdout JSON 的 `data.deleted` 表示本次是否真的发起删除，`data.already_empty` 表示删除前是否没有封面图。空封面图是幂等成功，不报错。
-
-## URL 来源安全边界
-
-`resource-update --url` 只用于下载公开 HTTPS 图片：
-
-- 只允许 `https://`，拒绝 HTTP、空 host 和 URL userinfo。
-- 拒绝解析到 private、loopback、link-local、multicast、unspecified 地址的 host。
-- 最多跟随 3 次跳转，每次跳转都重新校验 URL。
-- 响应 `Content-Type` 只允许 `image/png`、`image/jpeg`、`image/gif`、`image/webp`。
-- 响应体最大 20MiB。
-
-## 参考
-
-- [lark-doc-media-download](lark-doc-media-download.md) — 下载正文素材或画板缩略图
-- [lark-doc-media-insert](lark-doc-media-insert.md) — 在正文插入图片/文件
-- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

skills/lark-doc/references/lark-doc-update.md

@@ -99,6 +99,8 @@ lark-cli docs +update --api-version v2 --doc "<doc_id>" --command str_replace \
 
 ### block_insert_after — 在指定 block 之后插入
 
+> ⚠️ **同一锚点多次插入会反序**：`block_insert_after` 每次都会把内容插入到 `--block-id` 指定块的正后方。如果多次复用同一个锚点，后一次插入会排在前一次插入之前（例如依次插入 A、B、C，最终顺序是 anchor → C → B → A）。若要保持自然顺序，优先把同一位置的多个 block 合并到一次 `--content` 写入；必须分多次写入时，每次写入后重新 `fetch --detail with-ids`，用上一次新插入的最后一个 block 作为下一次锚点。
+
 ```bash
 lark-cli docs +update --api-version v2 --doc "<doc_id>" --command block_insert_after \
   --block-id "目标 block_id" \
@@ -236,6 +238,7 @@ lark-cli docs +update --api-version v2 --doc "<doc_id>" --command str_replace \
 - **保护不可重建的内容**：图片、画板、电子表格等以 token 形式存储，替换时避开这些 block
 - **str_replace 的 replacement 支持富文本**：可以用行内标签 `<b>`、`<a>`、`<cite>`、`<latex>` 等替换普通文本为富文本
 - **同一 block 只能被 replace 一次**：多次修改同一 block 请合并为一次 block_replace
+- **同一插入位置优先合并写入**：不要对同一个 `--block-id` 多次执行 `block_insert_after` 来追加多段内容；这会让后插入的内容出现在前插入内容之前。把连续内容合并到一次 `--content`，或每次插入后重新获取最后一个新 block 的 ID 作为下一次锚点
 - **block_replace 后重新获取 ID**：`block_replace` 成功后旧 block ID 不保证继续可用；继续做相邻块操作前，重新 `docs +fetch --detail with-ids`
 - **block_delete 支持批量**：用逗号分隔多个 block_id 一次删除
 - **复杂结构重组**：将多个段落转换为 grid / table 等复杂布局时，分步操作比 overwrite 更安全：

skills/lark-doc/references/style/lark-doc-create-workflow.md

@@ -22,7 +22,7 @@
 2. 设计大纲——每个 h1/h2 章节至少规划 1 个非文本 block；承载重要信息的章节优先规划画板
 3. `docs +create --api-version v2` **只建骨架**：标题 + 开头 `<callout>` + 各级标题 + 每节一句占位摘要
    - ⚠️ **不要**一次性把完整章节内容塞进 `--content`。超长 `--content` 容易触发字符/参数限制。
-   - 完整内容留到第二波，由各 Agent 用 `block_insert_after --block-id <章节标题 block_id>` 分段写入。
+   - 完整内容留到第二波，由各 Agent 用 `block_insert_after --block-id <章节标题 block_id>` 写入；同一章节内的连续内容优先合并成一次 `--content`，不要多次复用同一个章节标题 block_id 追加，否则后写入内容会排在前写入内容之前。
    - ⚠️ **`@file` 路径限制**：`--content @file` 只接受当前工作目录下的相对路径，传绝对路径（如 `@/tmp/xxx.md`）会报 `unsafe file path`。需要落盘时，将文件写在 cwd 下，用完自行清理。
 
 ### 第二波 — 内容撰写（并行 Agent）
@@ -30,7 +30,7 @@
 4. Spawn Agent 并行撰写各章节。每个 Agent 需收到：
    - 文档 token、负责的章节范围、期望的 block 类型
    - `lark-doc-xml.md` 和 `lark-doc-style.md` 的完整路径（Agent 须先读取）
-   - 使用 `block_insert_after --block-id <章节标题 block_id>` 写入对应章节内容
+   - 使用 `block_insert_after --block-id <章节标题 block_id>` 写入对应章节内容；每个 Agent 对自己的章节尽量一次性写入完整片段。若必须分多次插入，第二次起必须先重新 `fetch --detail with-ids` 获取上一次新插入的最后一个 block ID，并把它作为新的插入锚点。
 
 ### 第三波 — 整合审查 + 画板意图识别（串行）
 

skills/lark-vc-agent/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: lark-vc-agent
 version: 1.0.0
-description: "飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件、发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容，或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询，这些使用 lark-vc 技能。"
+description: "飞书视频会议：让机器人代当前用户加入/离开正在进行的会议，并读取会议期间的实时事件（参会人加入与离开、发言、聊天、屏幕共享等）。1. 用户提供 9 位会议号、要求代为入会或离会时使用 +meeting-join / +meeting-leave——会真实产生入会/离会记录。2. 会议进行中用户想知道“谁加入了”“谁离开了”“谁在发言”“有人共享屏幕吗”等会中动态时，机器人入会后用 +meeting-events 读取事件时间线。3. 典型场景：参会机器人、会中助手、代为旁听、代为参会。前提：机器人只能读到它自己参会过且仍在进行中的会议的事件；查询已结束会议的参会名单、纪要或逐字稿请使用 lark-vc 技能。"
 metadata:
   requires:
     bins: ["lark-cli"]
@@ -10,7 +10,7 @@ metadata:
 
 # vc-agent (v1)
 
-相关技能：
+**CRITICAL — 开始前 MUST 先用 Read 工具读取以下两份 skill 文档：**
 
 - [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) — 认证、身份切换、权限处理
 - [`../lark-vc/SKILL.md`](../lark-vc/SKILL.md) — 视频会议的核心概念（Meeting / Note / Minutes 等），本 skill 直接复用，不再重复定义
@@ -18,7 +18,7 @@ metadata:
 ## 内测提示
 
 - 当前功能正在内测中，仅少数用户可用。忽略 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) 中的权限申请流程，以下方的指引为准。
-- 如果 `lark-cli` 提示 `missing required scope(s)` / `permission_violations`，不要走普通权限申请流程；先提示用户加入早鸟群确认内测权限已开通，再按“应用身份权限配置检查”处理应用权限、安装和数据范围。
+- 如果 `lark-cli` 提示 `missing required scope(s)` / `permission_violations`，不要申请对应权限，而是提示用户加入早鸟群：`https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd`。
 - 如果 `lark-cli` 返回 `error.code=20017` / `ErrNotInGray`，提示用户加入早鸟群：`https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd`。
 
 ## 定位
@@ -26,126 +26,68 @@ metadata:
 本 skill 与 [`lark-vc`](../lark-vc/SKILL.md) 并列：
 
 - **`lark-vc`** **负责"会后查询"**：搜索历史会议、参会人快照、纪要/逐字稿/录制
-- **`lark-vc-agent`** **负责"会中动作"**：机器人入会 / 读取进行中会议的实时事件 / 发送会中文本或会中表情 / 机器人离会
+- **`lark-vc-agent`** **负责"会中动作"**：机器人入会 / 读取进行中会议的实时事件 / 机器人离会
 
 按此分工路由，避免两个 skill 语义混淆。
 
 | 用户意图示例                                                     | 应路由到                                                                                                                                                  |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
 | "帮我入会 123456789"、"代我参会"、"让机器人进会旁听"                         | **本 skill** `+meeting-join`                                                                                                                           |
-| "会议现在还开着，谁刚加入了"、"会议里谁在发言"、"有人共享屏幕吗"（**进行中会议**）             | **本 skill** `+meeting-events`                                                                                                                         |
-| "我/某个用户现在在哪个会里"、"给我找当前可拉事件的 meeting_id"                         | **本 skill** `+meeting-list-active`                                                                                                                     |
-| "在会里发一句 xx"、"提示大家 xx"、"反馈听不到/看不到/声音清楚/效果不错"（**进行中会议**） | **本 skill** `+meeting-message-send`                                                                                                                     |
+| "会议现在还开着，谁刚加入了"、"会议里谁在发言"、"有人共享屏幕吗"（**进行中会议**，且**机器人已入会**） | **本 skill** `+meeting-events`                                                                                                                         |
 | "退出会议"、"让机器人离开"                                            | **本 skill** `+meeting-leave`                                                                                                                          |
 | "昨天那场会有谁参加过"、"搜昨天的会"、"查纪要/逐字稿/录制"                          | [`lark-vc`](../lark-vc/SKILL.md)                                                                                                                      |
 | "帮我参会，结束后把纪要发到群" 等跨阶段场景                                    | 按序编排：本 skill（入会 → 读事件）→ 会议结束后用 [`lark-vc`](../lark-vc/SKILL.md) / [`lark-minutes`](../lark-minutes/SKILL.md) 拉纪要 → [`lark-im`](../lark-im/SKILL.md) 发群 |
 
-## 身份路由
-
-不要向用户暴露内部身份缩写；对用户只说“用户身份”或“应用身份”。
-
-| 场景 | 使用身份 | 关键规则 |
-| ---- | -------- | -------- |
-| 查询当前登录用户正在参加的会议 | `--as user` | 不传 `--user-id`；拿到的 `meeting_id` 后续继续用 `--as user` 读事件 |
-| 查询目标用户且应用机器人也在会中的会议 | `--as bot --user-id <user_open_id>` | `--user-id` 必须是 `ou_...`；拿到的 `meeting_id` 后续继续用 `--as bot` 读事件 |
-| 用户明确要求应用机器人入会/旁听/代参会 | `--as bot` | 这是写操作，会真实产生入会记录；返回的 `meeting.id` 后续继续用 `--as bot` |
-
-硬规则：`meeting_id` 从哪种身份路径拿到，后续 `+meeting-events` / `+meeting-message-send` 就沿用哪种身份，除非用户明确要求切换场景（例如从“仅查询我当前会”改成“让应用机器人入会旁听”）。
-
 ## 核心场景
 
 ### 1. 加入正在进行的会议（写操作）
 
 1. 只有用户明确表达"让 Agent **真实入会**"（参会机器人、会中助手、代为旁听、代参会）时才用 `+meeting-join`。只是查数据不要入会。
-2. `+meeting-join --meeting-number` 只接受 **9 位纯数字**会议号，不是会议链接整串、也不是 `meeting_id`。如果用户只是给了 9 位会议号并询问会中内容，先按 `+meeting-list-active` 的会议号匹配流程找 `meeting_id`，不要直接入会。
+2. `+meeting-join --meeting-number` 只接受 **9 位纯数字**会议号，不是会议链接整串、也不是 `meeting_id`。
 3. 返回体中的 `meeting.id` **必须立刻记录**——后续 `+meeting-events` / `+meeting-leave` 都靠它，**不能用 9 位会议号替代**。
 4. 入会对所有参会人可见，执行前核实 9 位会议号来源，避免误入错会。
-5. 使用应用身份 `--as bot` 执行真实入会；不要用当前登录用户身份尝试让应用机器人入会。
+5. 仅支持 `user` 身份，需提前 `lark-cli auth login`。
 6. 若入会失败，优先查看 `+meeting-join` reference 的错误排查段落，重点确认会议号、密码、会议状态、等候室 / 审批以及会议是否禁止当前身份加入。
 
 ### 2. 感知会中事件（读操作）
 
 1. 用户要看"会议里正在发生什么"（参会人加入/离开、聊天、转写、屏幕共享）时，用 `+meeting-events`。
 2. 输入是 **`meeting_id`**（长数字 ID），不是 9 位会议号。
-3. 不依赖默认身份。`meeting_id` 来自用户身份发现时，继续用 `--as user`；来自应用身份发现或 `+meeting-join` 时，继续用 `--as bot`。身份不一致会导致空结果或权限错误。
+3. Bot 必须**真实参会过**（先 `+meeting-join`），否则事件流通常不可见。具体的状态边界、结束后宽限窗口与错误码（如 `10005 / 20001 / 20002`）请查看 `+meeting-events` reference。
 4. **不能做会后复盘**，**不能替代参会人快照查询**。如果会议已结束：
-   - 先用 `lark-cli vc +notes --meeting-ids <meeting.id>` 获取会议产物信息。
-   - 再根据 `note_display_type`、`note_id`、`minute_token` 和用户意图，按 [`lark-vc`](../lark-vc/SKILL.md) 的产物决策读取正文、逐字稿或妙记。
+   - 想拿纪要文档或逐字稿文档 token：用 `lark-cli vc +notes --meeting-ids <meeting.id>`
+   - 想拿 AI 产物（summary / todos / chapters）或导出逐字稿文件：先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`
    - 想看参会人快照：用 `vc meeting get --with-participants`（见 [`lark-vc`](../lark-vc/SKILL.md)）
 5. **默认必须使用** **`--page-all`**，除非用户明确要求“只查一页”，或确实需要控制返回体大小。
 6. 输出格式默认优先 `--format pretty`（时间线更易读）；只有在需要完整保留原始消息流与结构化字段时，才使用 `--format json`。
 7. **必须识别分页信号**：只要响应里出现 `has_more=true`、pretty 里的 `more available`，或返回了非空 `page_token`，就不能把当前结果当作完整事件流；默认应继续分页，或明确告诉用户当前只是部分结果。
 8. 保留响应里的 `page_token`，下次增量拉取直接续，不要从头再拉。
 9. **只要你是基于** **`+meeting-events`** **来回答一场正在进行中的会议内容，就不能直接复用旧结果。** 无论用户是在问“现在/刚刚/最新”的状态，还是让你“总结一下这个会议讲什么”，都必须先重新拉一次当前事件流，确认拿到的是最新信息，再基于最新结果回答。只有在用户明确要求基于某次历史快照继续分析时，才可以复用旧结果。
-10. 用户直接问“这个会议讲了什么 / 现在讲到哪了”且上下文没有明确 `meeting_id` 时，先用用户身份发现当前会议；如果用户明确要求应用机器人视角，或上下文已经是应用机器人参会流程，再用应用身份发现。若返回多个会议，展示候选并让用户选择。
-11. 用户直接提供 **9 位会议号** 并询问会中事件/会议内容时，默认把它当作 active meeting 的筛选条件：先按当前身份查 active meetings，并在返回里匹配 `meeting_no == <9位会议号>`；匹配到唯一会议后取长数字 `meeting_id`，再用同一身份查事件。只有用户明确要求“入会 / 让应用机器人旁听 / 代我参会”时才改用 `+meeting-join`。
 
-### 3. 发送会中文本或会中表情（写操作）
+### 3. 离开会议（写操作）
 
-1. 用户明确要求在当前进行中的会议里发送提示、说明、会中表情，或反馈“听不到 / 看不到 / 声音清楚 / 效果不错”时，用 `+meeting-message-send`。
-2. 输入是长数字 `meeting_id`，不是 9 位会议号。若用户只给 9 位会议号，先按当前身份执行 `+meeting-list-active` 并按 `meeting_no` 匹配，匹配到唯一会议后再发送；不要为了发消息自动入会。
-3. 身份必须延续：`meeting_id` 来自用户身份发现，就继续 `--as user`；来自应用身份发现或应用机器人入会，就继续 `--as bot`。
-4. 文本消息使用 `--text`；会中表情 / 反馈使用 `--emoji-type`。`--emoji-type` 必须从 reference 里的完整列表中选择，大小写敏感。
-5. 支持普通 Feishu reaction emoji（如 `LOVE`、`SMILE`、`THUMBSUP`）和 4 个 VC 反馈 key（`VC_CanNotSee`、`VC_NoSound`、`VC_LooksGood`、`VC_SoundsClear`）。
-6. 不要编造列表外的 `emoji_type`，也不要把 natural language 硬编码成不存在的 key；如果用户只给语义，可在完整列表中选择最接近的 key，无法判断时先确认。
-7. 该命令只暴露会中文本和会中表情，不作为“发送绑定群消息”的默认能力；如果用户明确要发群聊，请路由到 [`lark-im`](../lark-im/SKILL.md)。
-8. 若使用应用身份发送，应用机器人必须在会中；若使用用户身份发送，当前用户必须正在该会议中。权限错误时按“应用身份权限配置检查”或“用户身份被拒绝时”处理。
-
-示例：
-
-```bash
-lark-cli vc +meeting-message-send --as user --meeting-id <meeting_id> --text "稍等，我在看文档"
-lark-cli vc +meeting-message-send --as bot --meeting-id <meeting_id> --msg-type reaction --emoji-type LOVE
-lark-cli vc +meeting-message-send --as bot --meeting-id <meeting_id> --msg-type reaction --emoji-type VC_NoSound
-```
-
-### 4. 离开会议（写操作）
-
-1. 只有用户明确要求机器人退出 / 离开 / 结束参会时，才用应用身份执行 `+meeting-leave --as bot --meeting-id <长数字 meeting_id>`；不应因任务完成而执行离会。
-2. `--meeting-id` **必须**是长数字会议 ID，通常来自 `+meeting-join` 返回的 `meeting.id`，也可以来自应用身份 `+meeting-list-active` 返回的 `meeting_id`。如果来自 list-active，必须确认应用机器人当前就在该会中。**不接受 9 位会议号**。
+1. 只有用户明确要求机器人退出 / 离开 / 结束参会时，才用 `+meeting-leave --meeting-id <从 +meeting-join 拿到的 meeting.id>`；不要把任务完成当作离会指令。
+2. `--meeting-id` **必须**是 `+meeting-join` 返回的长数字 `meeting.id`，**不接受 9 位会议号**。
 3. 离会**立即生效**，机器人从会议的参会人列表中消失，对其他参会人可见；若需要重新入会，再跑一次 `+meeting-join` 即可（非真正"不可逆"）。
-4. 使用与入会或 active meeting 发现相同的应用身份离会。
+4. 仅支持 `user` 身份。
 
-### 5. 获取当前可用的进行中会议 ID（读操作）
-
-1. `+meeting-list-active` 用来发现当前进行中的会议，并拿到后续 `+meeting-events` 需要的长数字 `meeting_id`。
-2. 用户身份：`lark-cli vc +meeting-list-active --as user --format json`，用于发现当前登录用户正在参加的会议；后续 `+meeting-events` 继续 `--as user`。
-3. 应用身份：`lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json`，`--user-id` 必须是目标用户 open_id，即 `ou_...`；返回该用户当前正在参加且应用机器人也在会中的会议。它不是全量会议搜索接口。后续 `+meeting-events` 继续 `--as bot`。
-4. 如果返回空，先按当前身份解释：用户身份下表示当前用户没有可见的进行中会议；应用身份下表示没有找到“目标用户在会中且应用机器人也在会中”的当前会。
-5. 如果返回多个会议，不要自动任选一个；按 `meeting_title` / `meeting_no` / `meeting_id` 展示候选，等待用户明确选择后再调用 `+meeting-events`。
-6. 如果用户给了 9 位会议号，先在 active meeting 结果中按 `meeting_no` 匹配。匹配失败时，不要自动入会；只有用户明确要求应用机器人真实入会时，才询问或执行 `+meeting-join`。
-
-### 6. Agent 参会示范
+### 4. Agent 参会示范
 
 ```bash
 # 1. 入会，捕获 meeting.id
-JOIN=$(lark-cli vc +meeting-join --as bot --meeting-number 123456789 --format json)
+JOIN=$(lark-cli vc +meeting-join --meeting-number 123456789 --format json)
 MID=$(echo "$JOIN" | jq -r '.data.meeting.id')
 
 # 2. 会中轮询事件
 #    默认用 --page-all 拉全当前可见事件；下次增量优先复用 page_token
 #    典型间隔 10-30 秒
-lark-cli vc +meeting-events --as bot --meeting-id "$MID" --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id "$MID" --page-all --format pretty
 
-# 3. 会后可选：进入 lark-vc 获取会议产物信息，再按 note_display_type / minute_token 决策读取
+# 3. 会后可选：取纪要 / 逐字稿（跨到 lark-vc）
 lark-cli vc +notes --meeting-ids "$MID"
 ```
 
-如果用户随后明确要求退出 / 离开 / 结束参会，再单独调用 `lark-cli vc +meeting-leave --as bot --meeting-id "$MID"`。
-
-如果已经知道目标用户 `open_id`，且 bot 已在会中，也可以先发现当前会：
-
-```bash
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-lark-cli vc +meeting-events --as bot --meeting-id <meeting_id> --page-all --format pretty
-```
-
-如果只是回答当前登录用户所在会议发生了什么，使用用户身份一路查：
-
-```bash
-lark-cli vc +meeting-list-active --as user --format json
-lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --format pretty
-```
+如果用户随后明确要求退出 / 离开 / 结束参会，再单独调用 `lark-cli vc +meeting-leave --meeting-id "$MID"`。
 
 ## Shortcuts
 
@@ -154,33 +96,20 @@ Shortcut 是对常用操作的高级封装（`lark-cli vc +<verb> [flags]`）。
 | Shortcut                                                        | 类型 | 说明                                                                         |
 | --------------------------------------------------------------- | -- | -------------------------------------------------------------------------- |
 | [`+meeting-join`](references/lark-vc-agent-meeting-join.md)     | 写  | Join an in-progress meeting by 9-digit meeting number                      |
-| [`+meeting-list-active`](references/lark-vc-agent-meeting-list-active.md) | 读  | List active meetings and discover meeting_id for event reads               |
-| [`+meeting-events`](references/lark-vc-agent-meeting-events.md) | 读  | List meeting events visible to the app agent (participant joined/left, transcript, chat, share) |
-| [`+meeting-message-send`](references/lark-vc-agent-meeting-message-send.md) | 写  | Send an in-meeting text message or reaction emoji                          |
+| [`+meeting-events`](references/lark-vc-agent-meeting-events.md) | 读  | List bot meeting events (participant joined/left, transcript, chat, share) |
 | [`+meeting-leave`](references/lark-vc-agent-meeting-leave.md)   | 写  | Leave a meeting by meeting\_id                                             |
 
-- [`+meeting-join`](references/lark-vc-agent-meeting-join.md)：入参格式、写操作可见性风险、入会失败排查。
-- [`+meeting-list-active`](references/lark-vc-agent-meeting-list-active.md)：用户身份和应用身份的不同返回范围。
-- [`+meeting-events`](references/lark-vc-agent-meeting-events.md)：`meeting_id` 来源、身份延续、分页和错误码（10005 / 20001 / 20002）。
-- [`+meeting-message-send`](references/lark-vc-agent-meeting-message-send.md)：会中文本、完整 `emoji_type` 列表、身份延续和写操作风险。
-- [`+meeting-leave`](references/lark-vc-agent-meeting-leave.md)：`meeting_id` 的来源与写操作可见性。
+- 使用 `+meeting-join` 前**必须**阅读 [references/lark-vc-agent-meeting-join.md](references/lark-vc-agent-meeting-join.md)，了解入参格式与写操作可见性风险。
+- 使用 `+meeting-events` 前**必须**阅读 [references/lark-vc-agent-meeting-events.md](references/lark-vc-agent-meeting-events.md)，了解 `meeting_id` 来源、分页、错误码（10005 / 20001 / 20002）与 "bot 仍在会中" 硬约束。
+- 使用 `+meeting-leave` 前**必须**阅读 [references/lark-vc-agent-meeting-leave.md](references/lark-vc-agent-meeting-leave.md)，了解 `meeting_id` 的来源与写操作可见性。
 
-## 应用身份权限配置检查
+## 权限表
 
-应用身份 `--as bot` 报 `no permission`、`missing required scope(s)`、`permission_violations`、`ErrNotInGray` 或 `20017` 时，不要引导用户执行 `auth login`。按顺序检查：
-
-1. 以 CLI 返回的 metadata / error envelope 为准，确认提示的 VC Agent 相关权限已开通。常见读取 active meeting / events 需要会中事件读取权限；应用机器人入会 / 离会需要 bot 入会写权限。
-2. 应用已发布并安装到当前租户。
-3. 开放平台“权限可访问的数据范围”已开通并保存。
-4. 数据范围选择“按条件筛选”，条件配置为：**会议的归属者 包含 与应用的可用范围一致**。
-5. 如果 scope、安装和数据范围都正确，仍返回 `ErrNotInGray` / `20017`，再按 VC Agent 内测 privilege / 灰度白名单处理，提示加入早鸟群或联系平台同学开通。
-
-## 用户身份被拒绝时
-
-用户身份 `--as user` 报权限或身份不支持类错误时，不要反复引导用户执行 `auth login`。先以 CLI 返回的 metadata / error envelope 为准判断：如果错误表明当前接口不支持用户身份访问，再按用户意图切换处理：
-
-1. 如果用户只是查询当前登录用户所在的进行中会议，说明当前接口链路不支持用户身份访问，改用应用身份流程；需要目标用户 open_id，并要求应用机器人已在会中或先按用户确认执行入会。
-2. 如果用户明确要求应用机器人入会、旁听、代参会或读取应用机器人可见事件，直接切到 `--as bot`，并按上面的应用身份权限配置检查处理。
+| Shortcut          | 所需 scope                       |
+| ----------------- | ------------------------------ |
+| `+meeting-join`   | `vc:meeting.bot.join:write`    |
+| `+meeting-events` | `vc:meeting.meetingevent:read` |
+| `+meeting-leave`  | `vc:meeting.bot.join:write`    |
 
 ## 延伸
 

skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md

@@ -1,30 +1,29 @@
 
 # vc +meeting-events
 
-查询一场正在进行的视频会议中的会中事件列表。该命令是**读操作**，必须沿用 `meeting_id` 的来源身份：用户身份发现的会议继续用用户身份读，应用身份发现或应用机器人入会得到的会议继续用应用身份读。对已结束会议，存在一个**结束后 5 分钟内的宽限窗口**；应用身份读取时，要求应用机器人曾经在这场会里出现过。
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+查询当前 bot 在一场正在进行的视频会议中收到的会中事件列表。该命令是**读操作**。对进行中会议，要求 bot 当前仍在会中；对已结束会议，存在一个**结束后 5 分钟内的宽限窗口**，只要 bot 曾经在这场会里出现过，仍可继续拉取事件。
 
 本 skill 对应 shortcut：`lark-cli vc +meeting-events`（调用 `GET /open-apis/vc/v1/bots/events`）。
 
-可见性边界：
-
-- `meeting_id` 来自 `+meeting-list-active --as user`：后续读取事件继续 `--as user`。
-- `meeting_id` 来自 `+meeting-list-active --as bot --user-id <user_open_id>` 或 `+meeting-join --as bot`：后续读取事件继续 `--as bot`。
-- 应用身份下，应用机器人必须在该会中或参会过；应用身份 active meeting 返回的是“目标用户在会中且应用机器人也在会中”的会议，不表示可以读取任意 `meeting_id`。
-
 ## 命令
 
 ```bash
 # 默认用法：全量拉取当前可见事件
-lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28 --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --page-all --format pretty
 
 # 指定时间范围，并拉全该时间窗内当前可见事件
-lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28 --start 2026-04-17T15:00:00+08:00 --end 2026-04-17T16:00:00+08:00 --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --start 2026-04-17T15:00:00+08:00 --end 2026-04-17T16:00:00+08:00 --page-all --format pretty
 
 # 基于上一次保存的 page_token 继续查新增事件
-lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28 --page-token <last_page_token> --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --page-token <last_page_token> --page-all --format pretty
 
 # 调试或控制返回体大小时，显式只查一页
-lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28 --page-size 20 --format json
+lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --page-size 20 --format json
+
+# 预览 API 调用（不实际请求）
+lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --dry-run
 ```
 
 ## 参数
@@ -37,6 +36,8 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28
 | `--page-token <token>` | 否 | 从指定分页游标继续拉取下一页 |
 | `--page-size <n>` | 否 | 单页模式每页大小。CLI 会自动夹紧到 `20-100`；传 `--page-all` 时固定使用 `100` |
 | `--page-all` | 否 | 自动分页，直到没有更多页面为止（内部有安全上限） |
+| `--format <fmt>` | 否 | 输出格式：json (CLI 默认) / pretty（本 skill 推荐默认） / table / ndjson / csv |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
 
 ## 核心约束
 
@@ -44,55 +45,37 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id 69xxxxxxxxxxxxx28
 
 `--meeting-id` 必须是会议的长数字 ID。它通常来自：
 - `+meeting-join` 返回体中的 `meeting.id`
-- `+meeting-list-active` 返回体中的 `meeting_id`
 - `+search` 结果中的 `id`
 
 **不要**把 9 位会议号（`--meeting-number`）传给这个命令。
-如果 `meeting_id` 来自 `+meeting-list-active`，后续 `+meeting-events` 必须沿用同一身份；如果返回多个会议，先让用户选择具体 `meeting_id`。
 
-如果用户提供的是 9 位会议号且没有明确要求应用机器人入会，先按当前场景身份查 active meetings 并按 `meeting_no` 匹配。匹配到唯一项后，取该项的长数字 `meeting_id`，再用同一身份调用本命令；匹配失败时不要自动入会，除非用户明确说“入会 / 让应用机器人旁听 / 代我参会”。
+### 2. 仅支持 user 身份
 
-### 2. 身份来源是读取事件的权限锚点
+该命令仅支持 `user` 身份。
 
-- 用户身份路径：先用 `+meeting-list-active --as user` 发现当前登录用户的会议，再用 `+meeting-events --as user` 读取该 `meeting_id`。
-- 应用身份路径：应用机器人必须在会中或参会过；不要拿任意 `meeting_id` 直接用 `--as bot` 查。
-- 不要混用身份。身份不一致时，常见结果是空列表、`no permission` 或 `bot is not in meeting`。
+### 3. bot 必须在会中，或在会议结束后的 5 分钟宽限窗口内曾经在会中
 
-### 3. 读取事件前必须先拿到可见的 meeting_id
+这是查询“bot 在会中观察到的事件”的接口。若 bot 已离会、未入会、或会议已经无法再判断 bot 身份，后端通常会报：
+- `bot is not in meeting, no permission`
 
-最稳妥的调用顺序通常是：
+因此，最稳妥的调用顺序通常是：
 
 ```bash
-# 方式 1：先入会，直接记录返回的 meeting.id
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+# 先入会
+lark-cli vc +meeting-join --meeting-number 123456789
+
+# 记录返回的 meeting.id
 
 # 再查询事件
-lark-cli vc +meeting-events --as bot --meeting-id <meeting.id>
+lark-cli vc +meeting-events --meeting-id <meeting.id>
 ```
 
-如果应用机器人已经在会中，也可以先通过 active meeting 找会：
-
-```bash
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-lark-cli vc +meeting-events --as bot --meeting-id <meeting_id> --page-all --format pretty
-```
-
-如果只是查询当前登录用户所在会议：
-
-```bash
-lark-cli vc +meeting-list-active --as user --format json
-lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --format pretty
-```
-
-若应用机器人已离会、未入会、或会议已经无法再判断身份，后端通常会报：
-- `bot is not in meeting, no permission`
-
 更精确地说，后端当前的判断规则是：
 
-- **会议进行中**：要求应用机器人**当前仍在会中**
-- **会议已结束后的 5 分钟内**：只要应用机器人**曾经在这场会中出现过**，仍可拉取事件
+- **会议进行中**：要求 bot **当前仍在会中**
+- **会议已结束后的 5 分钟内**：只要 bot **曾经在这场会中出现过**，仍可拉取事件
 - **会议结束超过 5 分钟**：按会议结束处理，通常不再返回事件流
-- **应用机器人从未真实入会过**：即使会议仍在进行或刚结束，也会返回 `10005 bot is not in meeting`
+- **bot 从未真实入会过**：即使会议仍在进行或刚结束，也会返回 `10005 bot is not in meeting`
 
 ### 4. 自动分页规则
 
@@ -104,9 +87,9 @@ lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --for
 
 执行准则：
 
-- **默认命令模板**：`lark-cli vc +meeting-events --as <same_identity> --meeting-id <meeting.id> --page-all --format pretty`
+- **默认命令模板**：`lark-cli vc +meeting-events --meeting-id <meeting.id> --page-all --format pretty`
 - 如果你发现自己执行成了不带 `--page-all` 的单页查询，而响应里又出现 `has_more=true` / `more available` / 非空 `page_token`，应立刻意识到这只是部分结果。
-- 遇到上述情况，默认补救方式是继续使用返回的 `page_token` 续拉，例如：`lark-cli vc +meeting-events --as <same_identity> --meeting-id <meeting.id> --page-token <returned_page_token> --page-all --format pretty`
+- 遇到上述情况，默认补救方式是继续使用返回的 `page_token` 续拉，例如：`lark-cli vc +meeting-events --meeting-id <meeting.id> --page-token <returned_page_token> --page-all --format pretty`
 - 只有在用户明确要求“就看第一页”“先不要翻页”时，才不要默认带 `--page-all`
 - 只要你是基于 `+meeting-events` 来回答一场**正在进行中的会议内容**，就不能直接复用上一次查询结果。无论用户是在问“现在是谁在说话”“刚刚发生了什么”“最新事件有哪些”，还是让你“总结一下这个会议讲什么”，都必须先重新执行一次 `+meeting-events`，确认拿到的是最新事件流，再回答用户。只有在用户明确要求基于某次历史快照继续分析时，才可以复用旧结果。
 
@@ -132,10 +115,7 @@ lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --for
 
 执行准则：
 
-- 如果上下文已有明确 `meeting_id` 和来源身份，直接用同一身份执行 `+meeting-events --page-all --format json`。
-- 如果上下文没有明确 `meeting_id`，先按用户当前意图选择身份：问“我/当前用户所在会议”用 `lark-cli vc +meeting-list-active --as user --format pretty`；问“应用机器人可见的目标用户会议”用 `lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format pretty`。返回多个会议时先让用户选择。
-- 如果上下文只有 9 位会议号，先按当前身份执行 `+meeting-list-active` 并按 `meeting_no` 匹配；匹配到唯一会议后再查事件。不要为了总结会议而自动调用 `+meeting-join`。
-- 这类问题拿到 `meeting_id` 后，用 `lark-cli vc +meeting-events --as <same_identity> --meeting-id <meeting.id> --page-all --format json` 拉取最新事件流。
+- 这类问题默认先用 `lark-cli vc +meeting-events --meeting-id <meeting.id> --page-all --format json` 拉取最新事件流。
 - 如果事件中出现共享文档线索，例如：
   - `magic_share_started`
   - `share_doc.title`
@@ -191,7 +171,7 @@ lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --for
 
 | 输入参数 | 获取方式 |
 |---------|---------|
-| `meeting-id` | `+meeting-join` 返回的 `meeting.id`；或 `+meeting-list-active` 返回的 `meeting_id`；或 `+search` 结果中的 `id`。必须同时记录来源身份 |
+| `meeting-id` | `+meeting-join` 返回的 `meeting.id`；或 `+search` 结果中的 `id` |
 | `start` / `end` | 用户给出的时间范围；如未给出则默认取全量可见事件 |
 | `page-token` | 上一页或上一次查询结果中保存的 `page_token`；建议持久化保存，便于下次继续拉取新增事件 |
 
@@ -201,31 +181,16 @@ lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --for
 
 ```bash
 # 第 1 步：加入会议，记录返回的 meeting.id
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+lark-cli vc +meeting-join --meeting-number 123456789
 
 # 第 2 步：查询事件流
-lark-cli vc +meeting-events --as bot --meeting-id <meeting.id> --page-all --format pretty
-```
-
-### 场景 1b：应用机器人已在会中，先发现 meeting_id 再读事件
-
-```bash
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-lark-cli vc +meeting-events --as bot --meeting-id <meeting_id> --page-all --format pretty
-```
-
-### 场景 1c：当前登录用户正在会中，先发现 meeting_id 再读事件
-
-```bash
-lark-cli vc +meeting-list-active --as user --format json
-lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id <meeting.id> --page-all --format pretty
 ```
 
 ### 场景 2：过滤某段时间内的事件
 
 ```bash
 lark-cli vc +meeting-events \
-  --as <same_identity> \
   --meeting-id <meeting.id> \
   --start 2026-04-17T15:00:00+08:00 \
   --end 2026-04-17T16:00:00+08:00 \
@@ -239,7 +204,6 @@ lark-cli vc +meeting-events \
 # 上一次查询结束后，保留最后返回的 page_token
 # 这次直接从该游标继续拉新增事件
 lark-cli vc +meeting-events \
-  --as <same_identity> \
   --meeting-id <meeting.id> \
   --page-token <last_page_token> \
   --page-all \
@@ -257,27 +221,23 @@ lark-cli vc +meeting-events \
 | 错误现象 | 根本原因 | 解决方案 |
 |---------|---------|---------|
 | `--meeting-id is required` | 未传入 `--meeting-id` | 传入长数字 `meeting.id` |
-| `not a 9-digit meeting number` | 把 9 位会议号误传给 `--meeting-id` | 如果只是查询会中内容，先用 `+meeting-list-active` 按 `meeting_no` 匹配拿长数字 `meeting_id`；只有用户明确要求入会时才用 `+meeting-join --as bot --meeting-number <9位号>` |
-| `10005 bot is not in meeting` | 使用应用身份读取，但应用机器人从未真实入会该会议；或会议已结束但应用机器人从未在会中出现过 | 如果本来是用户身份发现的 `meeting_id`，改回 `--as user`；如果确实要应用身份读取，先 `+meeting-join --as bot --meeting-number <9位号>` 真实入会再查。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants`** |
-| 用户身份不支持 | 当前事件读取接口不支持用用户身份访问 | 不要反复执行 `auth login`。改用应用身份流程：先通过 `+meeting-list-active --as bot --user-id <user_open_id>` 获取应用身份可读的 `meeting_id`，或在用户明确同意后让应用机器人入会，再用 `+meeting-events --as bot` 读取 |
-| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。先用 `lark-cli vc +notes --meeting-ids <meeting.id>` 获取会议产物信息，再根据 `note_display_type` / `note_id` / `minute_token` 和用户意图选择纪要正文、逐字稿或妙记；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants` |
+| `10005 bot is not in meeting` | bot 从未真实入会该会议；或会议已结束但 bot 从未在会中出现过 | 先 `+meeting-join --meeting-number <9位号>` 真实入会再查；如果会议已经结束且当时 bot 没进过会，本接口也拉不到数据。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants`**（不依赖 bot 身份参会） |
+| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。若要拿纪要文档或逐字稿 token，用 `lark-cli vc +notes --meeting-ids <meeting.id>`；若要拿 AI 产物（summary / todos / chapters）或导出逐字稿文件，先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants` |
 | `20002 meeting not exist` | `meeting_id` 错误，或会议实例当前已不可获取（常见于把 9 位会议号当 meeting_id 传） | 确认传入的是长数字 `meeting_id`，不是 9 位会议号 |
-| 应用身份权限不足 | 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 | 不要执行 `auth login`。以 CLI 返回的 metadata / error envelope 为准确认缺失权限；检查应用发布/安装，以及开放平台“权限可访问的数据范围”：选择“按条件筛选”，条件为“会议的归属者 包含 与应用的可用范围一致”；仍失败再排查内测 privilege / 灰度 |
 | `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id，或排查后端问题 |
 
 ## 提示
 
 - 这是**会中事件流**查询，不适合拿来搜历史会议记录；搜历史会议请用 `+search`。
 - 如果会议已经结束，不要卡在 `+meeting-events`：  
-  - 先用 `lark-cli vc +notes --meeting-ids <meeting.id>` 获取会议产物信息。
-  - 再根据 `note_display_type`、`note_id`、`minute_token` 和用户意图，按 `lark-vc` 的产物决策读取纪要正文、逐字稿或妙记。
-- 事件列表是否完整，取决于应用机器人何时入会、何时离会，以及后端当前可见的会中事件范围。对于已结束会议，通常只在**结束后 5 分钟内**、且应用机器人**曾经在会中**时还能继续拉到事件。
+  - 想拿纪要文档或逐字稿 token：用 `lark-cli vc +notes --meeting-ids <meeting.id>`
+  - 想拿 AI 产物（summary / todos / chapters）或导出逐字稿文件：先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`
+- 事件列表是否完整，取决于 bot 何时入会、何时离会，以及后端当前可见的会中事件范围。对于已结束会议，通常只在**结束后 5 分钟内**、且 bot **曾经在会中**时还能继续拉到事件。
 - 查询"谁参加过某会议"请用 `vc meeting get --params '{"meeting_id":"<id>","with_participants":true}'`——这是参会人**快照** API，不依赖 bot 是否参会，对已结束会议也可查；**不要** 用 `+meeting-events` 做参会人查询。
 
 ## 参考
 
 - [lark-vc-agent-meeting-join](lark-vc-agent-meeting-join.md) — 先真实入会
-- [lark-vc-agent-meeting-list-active](lark-vc-agent-meeting-list-active.md) — 发现当前可读事件的进行中会议 ID
 - [lark-vc-agent-meeting-leave](lark-vc-agent-meeting-leave.md) — 用户明确要求时离会
 - [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
 - [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token

skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md

@@ -1,29 +1,29 @@
 
 # vc +meeting-join
 
-通过 9 位会议号让应用机器人加入一场正在进行的视频会议。这是一次**写操作**，会实际让应用机器人加入会议。
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+通过 9 位会议号加入一场正在进行的视频会议（bot join）。这是一次**写操作**，会实际让当前身份加入会议。
 
 本 skill 对应 shortcut：`lark-cli vc +meeting-join`（调用 `POST /open-apis/vc/v1/bots/join`）。
 
-> **不要把 9 位会议号等同于入会意图。** 用户给出 9 位会议号并询问“会议讲了什么 / 查会中事件”时，先用 `+meeting-list-active` 查当前 active meetings 并按 `meeting_no` 匹配；只有用户明确要求“入会 / 让应用机器人旁听 / 代我参会”时才调用本命令。
-
 ## 命令
 
 ```bash
 # 仅指定会议号（无密码）
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+lark-cli vc +meeting-join --meeting-number 123456789
 
 # 指定会议号 + 密码
-lark-cli vc +meeting-join --as bot --meeting-number 123456789 --password 8888
+lark-cli vc +meeting-join --meeting-number 123456789 --password 8888
 
 # 从邀请事件透传 call_id（参见「如何获取输入参数」）
-lark-cli vc +meeting-join --as bot --meeting-number 123456789 --call-id a08e06bf-9a41-44e4-a89c-a7871899e783
+lark-cli vc +meeting-join --meeting-number 123456789 --call-id a08e06bf-9a41-44e4-a89c-a7871899e783
 
 # 输出格式
-lark-cli vc +meeting-join --as bot --meeting-number 123456789 --format json
+lark-cli vc +meeting-join --meeting-number 123456789 --format json
 
 # 预览 API 调用（不实际加入会议）
-lark-cli vc +meeting-join --as bot --meeting-number 123456789 --dry-run
+lark-cli vc +meeting-join --meeting-number 123456789 --dry-run
 ```
 
 ## 参数
@@ -33,13 +33,14 @@ lark-cli vc +meeting-join --as bot --meeting-number 123456789 --dry-run
 | `--meeting-number <no>` | 是 | 会议号，必须为 **9 位纯数字** |
 | `--password <pw>` | 否 | 会议密码，仅在该会议设置了入会密码时传入 |
 | `--call-id <id>` | 否 | 从 `vc.bot.meeting_invited_v1` 邀请事件透传的 `call_id`，原样回传即可。Agent 主动入会或无邀请事件来源时不传 |
-| `--dry-run` | 否 | 预览 API 调用，不实际加入会议；会议号或身份不确定时先用它确认请求 |
+| `--format <fmt>` | 否 | 输出格式：json (默认) / pretty / table / ndjson / csv |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
 
 ## 核心约束
 
-### 1. 使用应用身份
+### 1. 仅支持 user 身份
 
-这是应用机器人入会能力，使用 `--as bot`。不要用当前登录用户身份尝试让应用机器人入会。
+该命令仅支持 `user` 身份。
 
 ### 2. 会议号格式严格校验
 
@@ -52,8 +53,8 @@ lark-cli vc +meeting-join --as bot --meeting-number 123456789 --dry-run
 
 ### 3. 会议必须已开始且允许入会
 
-- 会议必须处于**进行中**状态，应用机器人无法加入尚未开始或已结束的会议。
-- 若会议设置了**等候室 / 入会审批**，应用机器人可能需要主持人放行后才真正入会。
+- 会议必须处于**进行中**状态，bot 无法加入尚未开始或已结束的会议。
+- 若会议设置了**等候室 / 入会审批**，bot 可能需要主持人放行后才真正入会。
 - 若返回 `HTTP 403: no permission`（错误码 `121003`），不要只理解成“账号没权限”。这类报错更常见的原因是：会议参数或会控配置当前不满足入会条件，例如会议号填错、密码未传或错误、会议尚未开始、等候室 / 入会审批未放行、会议禁止外部/特定身份加入等。应先确认这些配置项，再重试。
 
 ### 4. 机器人入会后对其他参会人可见
@@ -66,7 +67,7 @@ lark-cli vc +meeting-join --as bot --meeting-number 123456789 --dry-run
 
 | 字段 | 说明 |
 |------|------|
-| `meeting.id` | 会议 ID（可后续传给 `+meeting-leave --as bot --meeting-id`） |
+| `meeting.id` | 会议 ID（可后续传给 `+meeting-leave --meeting-id`） |
 | `meeting.meeting_no` | 会议号（与入参一致） |
 | `meeting.topic` | 会议主题 |
 | `meeting.start_time` | 会议开始时间 |
@@ -87,30 +88,25 @@ lark-cli vc +meeting-join --as bot --meeting-number 123456789 --dry-run
 
 ```bash
 # 第 1 步：加入会议，记录返回的 meeting.id
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+lark-cli vc +meeting-join --meeting-number 123456789
 
 # 第 2 步：使用返回的 meeting.id 查询会中事件
-lark-cli vc +meeting-events --as bot --meeting-id <meeting.id> --page-all --format pretty
+lark-cli vc +meeting-events --meeting-id <meeting.id> --page-all --format pretty
 ```
 
-如果 bot 已经在会中，也可以通过 active meeting 找回 `meeting_id`：
-
-```bash
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-```
-
-### 场景 2：加入会议 → 会后进入 lark-vc 获取会议产物信息
+### 场景 2：加入会议 → 会后拉取纪要 / 录制
 
 ```bash
 # 第 1 步：加入并参会
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+lark-cli vc +meeting-join --meeting-number 123456789
 
-# 第 2 步：会议结束后，先查询会议产物
+# 第 2 步：会议结束后，查询录制（拿到 minute_token）
+lark-cli vc +recording --meeting-ids <meeting.id>
+
+# 第 3 步：查询会议纪要（总结 / 待办 / 章节 / 逐字稿）
 lark-cli vc +notes --meeting-ids <meeting.id>
 ```
 
-后续按 `lark-vc` 的产物决策处理：根据 `note_display_type`、`note_id`、`minute_token` 和用户意图选择纪要正文、逐字稿或妙记。
-
 ## 常见错误与排查
 
 | 错误现象 | 根本原因 | 解决方案 |
@@ -118,20 +114,18 @@ lark-cli vc +notes --meeting-ids <meeting.id>
 | `--meeting-number must be exactly 9 digits` | 会议号不是 9 位纯数字 | 检查是否误传了会议链接或 meeting_id |
 | 会议密码错误 | `--password` 错误或未提供 | 向主持人确认会议密码 |
 | 会议不存在 / 已结束 | 会议号错误或会议未进行中 | 确认会议正在进行中 |
-| `HTTP 403: no permission` / `121003` | 入会前置条件不满足，通常不是单纯 scope 问题 | 依次确认：1）会议允许智能体加入；2）会议号正确；3）如有密码，已正确传入 `--password`；4）会议已开始；5）等候室 / 入会审批已放行；6）会议未禁止当前身份加入（如限制外部、限制应用机器人、仅特定成员可入会）；确认后重试 |
-| 应用身份权限不足 | 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 | 不要执行 `auth login`。以 CLI 返回的 metadata / error envelope 为准确认缺失权限；检查应用发布/安装，以及开放平台“权限可访问的数据范围”：选择“按条件筛选”，条件为“会议的归属者 包含 与应用的可用范围一致”；仍失败再排查内测 privilege / 灰度 |
+| `HTTP 403: no permission` / `121003` | 入会前置条件不满足，通常不是单纯 scope 问题 | 依次确认：1）会议允许智能体加入；2）会议号正确；3）如有密码，已正确传入 `--password`；4）会议已开始；5）等候室 / 入会审批已放行；6）会议未禁止当前身份加入（如限制外部、限制 bot、仅特定成员可入会）；确认后重试 |
 | 入会被拒绝 | 等候室 / 入会审批 / 限制外部入会 | 联系主持人放行或调整会议设置 |
 
 ## 提示
 
 - 仅在 Agent 需要**真实加入**会议（例如参会机器人、会中助手）时使用；只拉取会议数据不需要入会。
-- 入会会让机器人立即出现在参会列表；若用户要求退出 / 离开 / 结束参会，直接使用 `+meeting-leave --as bot --meeting-id <meeting.id>`。参数格式不确定时可选 `--dry-run` 预览，但不是必经步骤。
+- 入会会让机器人立即出现在参会列表；若用户要求退出 / 离开 / 结束参会，直接 `+meeting-leave` 即可。参数格式不确定时可选 `--dry-run` 预览，但不是必经步骤。
 - 执行成功后，立即记录返回的 `meeting.id`，用于后续 `+meeting-leave` / `+meeting-events`。
 
 ## 参考
 
 - [lark-vc-agent-meeting-leave](lark-vc-agent-meeting-leave.md) — 对应的离会命令
-- [lark-vc-agent-meeting-list-active](lark-vc-agent-meeting-list-active.md) — 发现当前可读事件的进行中会议 ID
 - [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 会中事件流
 - [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议记录
 - [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token

skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md

@@ -1,6 +1,8 @@
 
 # vc +meeting-leave
 
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
 通过 `meeting_id` 离开当前身份所在的视频会议（bot leave）。这是一次**写操作**，会实际把当前身份从会议中移出。
 
 本 skill 对应 shortcut：`lark-cli vc +meeting-leave`（调用 `POST /open-apis/vc/v1/bots/leave`）。
@@ -9,13 +11,13 @@
 
 ```bash
 # 通过 meeting_id 离会
-lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28
+lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28
 
 # 输出格式
-lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28 --format json
+lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --format json
 
 # 预览 API 调用（不实际离会）
-lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28 --dry-run
+lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --dry-run
 ```
 
 ## 参数
@@ -23,21 +25,22 @@ lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28 --dry-run
 | 参数 | 必填 | 说明 |
 |------|------|------|
 | `--meeting-id <id>` | 是 | 会议 ID（**不是 9 位会议号**） |
-| `--dry-run` | 否 | 预览 API 调用，不实际离会；meeting_id 或身份不确定时先用它确认请求 |
+| `--format <fmt>` | 否 | 输出格式：json (默认) / pretty / table / ndjson / csv |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
 
 ## 核心约束
 
 ### 1. 入参是 meeting_id，不是会议号
 
-`--meeting-id` 必须是会议的长数字 ID，通常由 `+meeting-join --as bot` 返回体中的 `meeting.id` 提供，也可从应用身份 `+meeting-list-active --as bot --user-id <user_open_id>` 返回体中的 `meeting_id` 获取。**传 9 位会议号会失败**。
+`--meeting-id` 必须是会议的长数字 ID，通常由 `+meeting-join` 返回体中的 `meeting.id` 提供，也可从 `+search` 结果中的 `id` 字段获取。**传 9 位会议号会失败**。
 
-### 2. 优先使用 bot 身份
+### 2. 仅支持 user 身份
 
-这是应用机器人离会能力，使用与入会或 active meeting 发现相同的 `--as bot`。只能让当前身份自己离会，无法强制移出其他参会人。
+该命令仅支持 `user` 身份。只能让当前身份自己离会，无法强制移出其他参会人。
 
 ### 3. 当前身份必须在会议中
 
-应用机器人必须已经在该会议中，否则接口会报错。如果 `meeting_id` 来自 `+meeting-list-active`，必须确认这是应用身份发现到的会议。
+必须先通过 `+meeting-join` 或其他方式在该会议中，否则接口会报错。
 
 ### 4. 离会立即生效，对其他参会人可见
 
@@ -52,7 +55,7 @@ lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28 --dry-run
 
 | 输入参数 | 获取方式 |
 |---------|---------|
-| `meeting-id` | `+meeting-join --as bot` 返回的 `meeting.id`；或应用身份 `+meeting-list-active --as bot --user-id <user_open_id>` 返回的 `meeting_id` |
+| `meeting-id` | `+meeting-join` 返回的 `meeting.id`；或 `+search` 结果中的 `id` 字段 |
 
 ## Agent 组合场景
 
@@ -60,13 +63,13 @@ lark-cli vc +meeting-leave --as bot --meeting-id 69xxxxxxxxxxxxx28 --dry-run
 
 ```bash
 # 第 1 步：加入会议，记录 meeting.id
-lark-cli vc +meeting-join --as bot --meeting-number 123456789
+lark-cli vc +meeting-join --meeting-number 123456789
 
 # 第 2 步：在会中处理用户请求（如监听发言、记录信息等）
 # ...
 
 # 第 3 步：仅在用户明确要求退出 / 离开 / 结束参会时，使用上一步记录的 meeting.id 离会
-lark-cli vc +meeting-leave --as bot --meeting-id <meeting.id>
+lark-cli vc +meeting-leave --meeting-id <meeting.id>
 ```
 
 ### 场景 2：会后补拉产物（不需要离会）
@@ -74,7 +77,10 @@ lark-cli vc +meeting-leave --as bot --meeting-id <meeting.id>
 如果用户只是要求会议结束后拉录制、纪要或逐字稿，不要先调用 `+meeting-leave`；直接跨到 `lark-vc` 查询会后产物。
 
 ```bash
-# 第 1 步：会议结束后进入 lark-vc 获取会议产物信息
+# 第 1 步：会议结束后查询录制
+lark-cli vc +recording --meeting-ids <meeting.id>
+
+# 第 2 步：查询会议纪要
 lark-cli vc +notes --meeting-ids <meeting.id>
 ```
 
@@ -82,20 +88,19 @@ lark-cli vc +notes --meeting-ids <meeting.id>
 
 | 错误现象 | 根本原因 | 解决方案 |
 |---------|---------|---------|
-| `--meeting-id is required` | 未传入 `--meeting-id` | 传入从 `+meeting-join --as bot` 得到的 `meeting.id`，或应用身份 `+meeting-list-active` 返回的 `meeting_id` |
+| `--meeting-id is required` | 未传入 `--meeting-id` | 传入从 `+meeting-join` 得到的 `meeting.id` |
 | `meeting not found` / `invalid meeting_id` | 误传了 9 位会议号 | 必须使用 `meeting.id`，不是会议号 |
 | `not in meeting` | 当前身份并不在该会议中 | 确认先 `+meeting-join` 成功 |
 
 ## 提示
 
 - 只有用户明确要求退出 / 离开 / 结束参会时才调用；离会会让机器人从参会列表消失，对其他参会人可见。若需要重新入会直接再 `+meeting-join`，不是真正的"不可逆"。参数格式不确定时可选 `--dry-run` 预览。
-- `+meeting-leave` 优先使用 `+meeting-join --as bot` 返回的 `meeting.id`，但不是每次 join 后都必须调用 leave。
-- `meeting_id` 如果来自 `+meeting-list-active`，必须来自应用身份，并确认应用机器人就在该会议中。不要用 9 位会议号。
+- `+meeting-leave` 依赖 `+meeting-join` 返回的 `meeting.id`，但不是每次 join 后都必须调用 leave。
+- `meeting_id` 优先使用 `+meeting-join` 返回的 `meeting.id`；如果来自 `+search`，也必须先确认当前身份就在该会议中。不要用 9 位会议号。
 
 ## 参考
 
 - [lark-vc-agent-meeting-join](lark-vc-agent-meeting-join.md) — 对应的入会命令
-- [lark-vc-agent-meeting-list-active](lark-vc-agent-meeting-list-active.md) — 发现当前可读事件的进行中会议 ID
 - [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 会中事件流
 - [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
 - [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token

skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md

@@ -1,91 +0,0 @@
-# vc +meeting-list-active
-
-列出当前进行中的会议，用来发现 `+meeting-events` 需要的长数字 `meeting_id`。
-
-本 skill 对应 shortcut：`lark-cli vc +meeting-list-active`（调用 `GET /open-apis/vc/v1/bots/user_active_meeting`）。
-
-## 命令
-
-```bash
-# 查询当前登录用户正在参加的会议
-lark-cli vc +meeting-list-active --as user --format json
-
-# 查询指定用户当前参加、且应用机器人也在会中的会议
-lark-cli vc +meeting-list-active --as bot --user-id ou_xxx --format json
-```
-
-## 参数
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--user-id <id>` | 应用身份必填 | 目标用户 open_id，格式为 `ou_...`。用户身份不传；应用身份直接透传给接口，不接受 internal user_id 或数字 ID |
-
-## 身份语义
-
-不要向用户暴露内部身份缩写；对用户只说“用户身份”或“应用身份”。
-
-| 身份 | 命令 | 返回范围 | 后续事件读取 |
-| ---- | ---- | -------- | ------------ |
-| 用户身份 | `--as user` | 当前登录用户正在参加的会议 | 继续 `+meeting-events --as user` |
-| 应用身份 | `--as bot --user-id <user_open_id>` | 目标用户正在参加、且应用机器人也在会中的会议 | 继续 `+meeting-events --as bot` |
-
-硬规则：`meeting_id` 从哪种身份路径拿到，后续 `+meeting-events` 就沿用哪种身份。不要把用户身份拿到的 `meeting_id` 改用应用身份查，也不要把应用身份拿到的 `meeting_id` 改用用户身份查，除非用户明确要求切换场景。
-
-应用身份返回空，不代表目标用户不在任何会议中，只能说明没有找到“目标用户在会中且应用机器人也在会中”的当前会。
-
-常见流程：
-
-```bash
-# 方式 1：先让应用机器人入会，直接从 join 响应拿 meeting.id
-lark-cli vc +meeting-join --as bot --meeting-number 123456789 --format json
-lark-cli vc +meeting-events --as bot --meeting-id <meeting.id> --page-all --format pretty
-
-# 方式 2：应用机器人已经在会中时，用应用身份发现 meeting_id
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-lark-cli vc +meeting-events --as bot --meeting-id <meeting_id> --page-all --format pretty
-
-# 方式 3：只回答当前登录用户所在会议发生了什么
-lark-cli vc +meeting-list-active --as user --format json
-lark-cli vc +meeting-events --as user --meeting-id <meeting_id> --page-all --format pretty
-```
-
-## 多会议选择
-
-- 如果返回多个会议，不要自动挑第一个。
-- 向用户展示每个候选的 `meeting_title` / `meeting_no` / `meeting_id`，等待用户选择。
-- 选择后继续使用发现该会议时的同一身份调用 `+meeting-events`。
-
-## 9 位会议号匹配
-
-用户提供 9 位会议号但没有明确要求应用机器人入会时，把会议号当作 active meeting 的筛选条件，而不是写操作指令。
-
-```bash
-# 用户问“我当前这个会讲了什么”
-lark-cli vc +meeting-list-active --as user --format json
-
-# 用户问“让应用机器人所在/可见的这个会讲了什么”
-lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
-```
-
-匹配规则：
-
-- 在返回会议中匹配 `meeting_no == <9位会议号>`。
-- 匹配到唯一会议：取该项的长数字 `meeting_id`，后续用同一身份调用 `+meeting-events`。
-- 匹配到多个会议：展示候选，让用户选择。
-- 没有匹配：说明当前身份没有发现该会议号对应的 active meeting；不要自动调用 `+meeting-join`，除非用户明确要求应用机器人入会。
-
-## 常见错误与排查
-
-| 错误现象 | 根本原因 | 解决方案 |
-|---------|---------|---------|
-| `--user-id is required when --as bot` | 应用身份未传目标用户 | 传入目标用户 open_id |
-| 用户身份返回空列表 | 当前登录用户没有可见的进行中会议 | 确认用户是否在会中，或是否切错身份 |
-| 用户身份不支持 | 当前接口不支持用用户身份访问 | 不要反复执行 `auth login`。改用应用身份流程：先拿目标用户 open_id，再执行 `+meeting-list-active --as bot --user-id <user_open_id>`；同时按应用身份权限配置检查应用权限、安装、数据范围和灰度 |
-| 应用身份返回空列表 | 没有满足“目标用户在会中且应用机器人也在会中”的当前会 | 先让应用机器人入会，或确认 `user_id` 和会议状态 |
-| `--user-id` 格式错误 | 传入了 internal user_id 或其他非 `ou_...` 值 | 改传目标用户 open_id |
-| 应用身份权限不足 | 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 | 不要执行 `auth login`。以 CLI 返回的 metadata / error envelope 为准确认缺失权限；检查应用发布/安装，以及开放平台“权限可访问的数据范围”：选择“按条件筛选”，条件为“会议的归属者 包含 与应用的可用范围一致”；仍失败再排查内测 privilege / 灰度 |
-
-## 参考
-
-- [lark-vc-agent-meeting-join](lark-vc-agent-meeting-join.md) — 让应用机器人真实入会并拿 `meeting.id`
-- [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 使用 `meeting_id` 读取会中事件

skills/lark-vc-agent/references/lark-vc-agent-meeting-message-send.md

@@ -1,134 +0,0 @@
-# vc +meeting-message-send
-
-发送会中文本消息或会中 reaction emoji。
-
-本 skill 对应 shortcut：`lark-cli vc +meeting-message-send`（调用 `POST /open-apis/vc/v1/bots/message`）。
-
-## 适用场景
-
-- 用户要求“在会里发一句话”“提示大家”“给当前会议发消息”。
-- 用户要求发送会中表情，例如“发个点赞”“发个 OK”“发个爱心”。
-- 用户要求表达会中反馈，例如“听不到”“看不到”“声音清楚”“效果不错”。
-- 只用于正在进行中的会议；已结束会议不支持。
-
-## 身份规则
-
-`meeting_id` 从哪种身份路径拿到，发送消息时就沿用哪种身份：
-
-| meeting_id 来源 | 发送时身份 |
-| --- | --- |
-| `+meeting-list-active --as user` | `+meeting-message-send --as user` |
-| `+meeting-list-active --as bot --user-id <user_open_id>` | `+meeting-message-send --as bot` |
-| `+meeting-join --as bot` 返回的 `meeting.id` | `+meeting-message-send --as bot` |
-
-不要把用户身份发现的 `meeting_id` 改用应用身份发送，也不要把应用身份发现的 `meeting_id` 改用用户身份发送，除非用户明确要求切换。
-
-## 参数
-
-| 参数 | 说明 |
-| --- | --- |
-| `--meeting-id` | 必填，长数字 `meeting_id`，不是 9 位会议号 |
-| `--msg-type` | 可选，`text` 或 `reaction`；只传 `--text` 或只传 `--emoji-type` 时可自动推断 |
-| `--text` | 文本消息内容 |
-| `--emoji-type` | 会中 reaction emoji key，大小写敏感，必须从本文“完整 `emoji_type` 列表”中选择 |
-| `--uuid` | 可选，幂等 key；不传则服务端生成 |
-
-CLI 会把 `--text` 或 `--emoji-type` 统一映射到 OpenAPI 请求体的 `content` 字段；`meeting_id` 也在请求体中传递。
-
-## 文本消息
-
-```bash
-lark-cli vc +meeting-message-send --as user --meeting-id <meeting_id> --text "稍等，我在看文档"
-```
-
-文本消息会出现在会议内的文本互动区。不要把它当成绑定群消息发送能力；如果用户明确要求发到群聊，路由到 `lark-im`。
-
-## 会中表情
-
-会中 reaction 支持普通 Feishu reaction emoji，也支持 4 个 VC 反馈 key。
-
-常见语义：
-
-| 用户表达 | 推荐 `emoji_type` |
-| --- | --- |
-| 点赞、赞一下、认可 | `THUMBSUP` |
-| +1、加一、附议、同上 | `JIAYI` |
-| OK、好的 | `OK` |
-| 收到、了解 | `Get` |
-| 爱心、红心 | `HEART` |
-| 喜欢、爱了 | `LOVE` |
-| 比心 | `FINGERHEART` |
-| 看起来没问题、可以继续 | `LGTM` |
-| 搞定、已完成 | `DONE` |
-| -1、减一 | `MinusOne` |
-| 不赞同、踩 | `ThumbsDown` |
-| 听不到、没声音 | `VC_NoSound` |
-| 看不到、画面有问题 | `VC_CanNotSee` |
-| 声音清楚 | `VC_SoundsClear` |
-| 会议画面效果不错、画面看起来可以 | `VC_LooksGood` |
-
-```bash
-lark-cli vc +meeting-message-send --as bot --meeting-id <meeting_id> --msg-type reaction --emoji-type LOVE
-lark-cli vc +meeting-message-send --as bot --meeting-id <meeting_id> --msg-type reaction --emoji-type VC_NoSound
-```
-
-不要编造列表外的 `emoji_type`，也不要把 mixed-case 值改成全大写，例如 `EatingFood`、`CheckMark`、`StatusInFlight` 都要按原值传。
-
-如果用户给的是自然语言语义，可以在下方列表中选择语义最接近的 key；如果不确定，先向用户确认。
-
-### 完整 `emoji_type` 列表
-
-以下列表与 IM reaction 官方 emoji 列表保持一致，并额外包含 VC 会中特定反馈 key：
-
-```text
-OK, THUMBSUP, THANKS, MUSCLE, FINGERHEART, APPLAUSE, FISTBUMP, JIAYI
-DONE, SMILE, BLUSH, LAUGH, SMIRK, LOL, FACEPALM, LOVE
-WINK, PROUD, WITTY, SMART, SCOWL, THINKING, SOB, CRY
-ERROR, NOSEPICK, HAUGHTY, SLAP, SPITBLOOD, TOASTED, GLANCE, DULL
-INNOCENTSMILE, JOYFUL, WOW, TRICK, YEAH, ENOUGH, TEARS, EMBARRASSED
-KISS, SMOOCH, DROOL, OBSESSED, MONEY, TEASE, SHOWOFF, COMFORT
-CLAP, PRAISE, STRIVE, XBLUSH, SILENT, WAVE, WHAT, FROWN
-SHY, DIZZY, LOOKDOWN, CHUCKLE, WAIL, CRAZY, WHIMPER, HUG
-BLUBBER, WRONGED, HUSKY, SHHH, SMUG, ANGRY, HAMMER, SHOCKED
-TERROR, PETRIFIED, SKULL, SWEAT, SPEECHLESS, SLEEP, DROWSY, YAWN
-SICK, PUKE, BETRAYED, HEADSET, EatingFood, MeMeMe, Sigh, Typing
-Lemon, Get, LGTM, OnIt, OneSecond, VRHeadset, YouAreTheBest, SALUTE
-SHAKE, HIGHFIVE, UPPERLEFT, ThumbsDown, SLIGHT, TONGUE, EYESCLOSED, RoarForYou
-CALF, BEAR, BULL, RAINBOWPUKE, ROSE, HEART, PARTY, LIPS
-BEER, CAKE, GIFT, CUCUMBER, Drumstick, Pepper, CANDIEDHAWS, BubbleTea
-Coffee, Yes, No, OKR, CheckMark, CrossMark, MinusOne, Hundred
-AWESOMEN, Pin, Alarm, Loudspeaker, Trophy, Fire, BOMB, Music
-XmasTree, Snowman, XmasHat, FIREWORKS, 2022, REDPACKET, FORTUNE, LUCK
-FIRECRACKER, StickyRiceBalls, HEARTBROKEN, POOP, StatusFlashOfInspiration, 18X, CLEAVER, Soccer
-Basketball, GeneralDoNotDisturb, Status_PrivateMessage, GeneralInMeetingBusy, StatusReading, StatusInFlight, GeneralBusinessTrip, GeneralWorkFromHome
-StatusEnjoyLife, GeneralTravellingCar, StatusBus, GeneralSun, GeneralMoonRest, MoonRabbit, Mooncake, JubilantRabbit
-TV, Movie, Pumpkin, BeamingFace, Delighted, ColdSweat, FullMoonFace, Partying
-GoGoGo, ThanksFace, SaluteFace, Shrug, ClownFace, HappyDragon
-VC_CanNotSee, VC_NoSound, VC_LooksGood, VC_SoundsClear
-```
-
-## 9 位会议号处理
-
-如果用户给的是 9 位会议号并要求发送会中消息：
-
-1. 先按当前身份执行 `+meeting-list-active`。
-2. 在返回结果中按 `meeting_no` 匹配该 9 位会议号。
-3. 匹配到唯一会议后取长数字 `meeting_id`。
-4. 用发现该会议时的同一身份执行 `+meeting-message-send`。
-
-匹配失败时不要自动入会。只有用户明确要求“让应用机器人入会/旁听/代参会”时，才改用 `+meeting-join`。
-
-## 权限和前置条件
-
-- 用户身份：当前用户必须正在该会议中。
-- 应用身份：应用机器人必须正在该会议中。
-- 会议需要开启会中智能体/Agent 能力开关。
-- 需要 `vc:meeting.message:write` 权限；应用身份还需要应用已安装、数据范围已配置。
-
-应用身份权限错误时，不要引导用户反复 `auth login`。按主 skill 的“应用身份权限配置检查”处理。
-
-## 相关
-
-- [lark-vc-agent-meeting-list-active](lark-vc-agent-meeting-list-active.md) — 发现当前进行中会议 ID
-- [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 读取会中事件
-- [lark-vc-agent-meeting-join](lark-vc-agent-meeting-join.md) — 应用机器人入会

tests/cli_e2e/vc/coverage.md

@@ -1,11 +0,0 @@
-# VC CLI E2E Coverage
-
-## Summary
-- TestVCMeetingMessageSendDryRun: dry-run coverage for `vc +meeting-message-send`; asserts CLI flag parsing, validation, and dry-run request shape for both text and reaction messages.
-- Live coverage for `vc +meeting-message-send` is intentionally not included here because it requires an active meeting, a joined user or bot identity, and meeting-message permission setup.
-
-## Command Table
-
-| Status | Cmd | Type | Testcase | Key parameter shapes | Notes / uncovered reason |
-| --- | --- | --- | --- | --- | --- |
-| dry-run ✓ / live ✕ | vc +meeting-message-send | shortcut | vc/vc_meeting_message_send_dryrun_test.go::TestVCMeetingMessageSendDryRun | `--meeting-id`; `--text`; `--msg-type reaction`; `--emoji-type`; `--uuid` | live E2E requires active VC meeting and message-enabled in-meeting identity |

tests/cli_e2e/vc/vc_meeting_message_send_dryrun_test.go

@@ -1,88 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	clie2e "github.com/larksuite/cli/tests/cli_e2e"
-	"github.com/stretchr/testify/require"
-	"github.com/tidwall/gjson"
-)
-
-func TestVCMeetingMessageSendDryRun(t *testing.T) {
-	setVCMeetingMessageSendDryRunEnv(t)
-
-	tests := []struct {
-		name        string
-		args        []string
-		wantMsgType string
-		wantContent string
-		wantUUID    string
-	}{
-		{
-			name: "text",
-			args: []string{
-				"vc", "+meeting-message-send",
-				"--meeting-id", "7651377260537433044",
-				"--text", "hello from dry-run",
-				"--uuid", "cid-dryrun-text",
-				"--dry-run",
-			},
-			wantMsgType: "text",
-			wantContent: "hello from dry-run",
-			wantUUID:    "cid-dryrun-text",
-		},
-		{
-			name: "reaction",
-			args: []string{
-				"vc", "+meeting-message-send",
-				"--meeting-id", "7651377260537433044",
-				"--msg-type", "reaction",
-				"--emoji-type", "VC_NoSound",
-				"--dry-run",
-			},
-			wantMsgType: "reaction",
-			wantContent: "VC_NoSound",
-		},
-	}
-
-	for _, temp := range tests {
-		tt := temp
-		t.Run(tt.name, func(t *testing.T) {
-			ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
-			t.Cleanup(cancel)
-
-			result, err := clie2e.RunCmd(ctx, clie2e.Request{
-				Args:      tt.args,
-				DefaultAs: "user",
-			})
-			require.NoError(t, err)
-			result.AssertExitCode(t, 0)
-
-			out := result.Stdout
-			require.Equal(t, int64(1), gjson.Get(out, "api.#").Int(), "stdout:\n%s", out)
-			require.Equal(t, "POST", gjson.Get(out, "api.0.method").String(), "stdout:\n%s", out)
-			require.Equal(t, "/open-apis/vc/v1/bots/message", gjson.Get(out, "api.0.url").String(), "stdout:\n%s", out)
-			require.Equal(t, "7651377260537433044", gjson.Get(out, "api.0.body.meeting_id").String(), "stdout:\n%s", out)
-			require.Equal(t, tt.wantMsgType, gjson.Get(out, "api.0.body.msg_type").String(), "stdout:\n%s", out)
-			require.Equal(t, tt.wantContent, gjson.Get(out, "api.0.body.content").String(), "stdout:\n%s", out)
-			if tt.wantUUID == "" {
-				require.False(t, gjson.Get(out, "api.0.body.uuid").Exists(), "stdout:\n%s", out)
-			} else {
-				require.Equal(t, tt.wantUUID, gjson.Get(out, "api.0.body.uuid").String(), "stdout:\n%s", out)
-			}
-		})
-	}
-}
-
-func setVCMeetingMessageSendDryRunEnv(t *testing.T) {
-	t.Helper()
-	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
-	t.Setenv("LARKSUITE_CLI_APP_ID", "vc_meeting_message_send_dryrun_test")
-	t.Setenv("LARKSUITE_CLI_APP_SECRET", "vc_meeting_message_send_dryrun_secret")
-	t.Setenv("LARKSUITE_CLI_BRAND", "feishu")
-}