test: prepare node 24 release rehearsal

ci: upgrade release actions to node 24
test: remove beta release approval rehearsal
2026-08-03 08:32:46 +08:00 · 2026-07-28 20:25:55 +08:00 · 2026-07-28 20:24:49 +08:00 · 2026-07-28 20:11:58 +08:00 · 2026-07-28 19:53:26 +08:00 · 2026-07-28 19:35:00 +08:00
27 changed files with 701 additions and 762 deletions
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -8,130 +8,376 @@ on:
 permissions:
  contents: read

+concurrency:
+  group: release-${{ github.ref_name }}
+  cancel-in-progress: false
+
 jobs:
  preflight:
    runs-on: ubuntu-22.04
    permissions:
      contents: read
+    outputs:
+      source_sha: ${{ steps.validate.outputs.source_sha }}
+      version: ${{ steps.validate.outputs.version }}
+      channel: ${{ steps.validate.outputs.channel }}
+      prerelease: ${{ steps.validate.outputs.prerelease }}
    steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
        with:
          fetch-depth: 0
-
+          persist-credentials: false
      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
        with:
          node-version: '22.14.0'

-      - name: Validate tag and commit
+      - name: Validate protected release tag
+        id: validate
        env:
+          REF_PROTECTED: ${{ github.ref_protected }}
+          REPOSITORY: ${{ github.repository }}
          TAG: ${{ github.ref_name }}
        run: |
          set -euo pipefail
-          node scripts/release-preflight.js --tag "$TAG"
-          git fetch origin main
-          HEAD_SHA="$(git rev-parse --verify 'HEAD^{commit}')"
-          MAIN_SHA="$(git rev-parse --verify 'FETCH_HEAD^{commit}')"
-          TAG_SHA="$(git rev-parse --verify "refs/tags/${TAG}^{commit}")"
-          if [[ "$TAG_SHA" != "$HEAD_SHA" ]]; then
-            echo "Tag ${TAG} does not resolve to the checked-out HEAD commit." >&2
-            exit 1
-          fi
-          if ! git merge-base --is-ancestor "$HEAD_SHA" "$MAIN_SHA"; then
-            echo "Tag ${TAG} does not point to a commit contained in origin/main." >&2
-            exit 1
+          [[ "$REPOSITORY" == "larksuite/cli" ]] || { echo "Release tags are accepted only from larksuite/cli." >&2; exit 1; }
+          [[ "$REF_PROTECTED" == "true" ]] || { echo "Release tag ${TAG} must be protected by a repository ruleset." >&2; exit 1; }
+
+          preflight_file="${RUNNER_TEMP}/release-preflight.json"
+          node scripts/release-preflight.js --tag "$TAG" > "$preflight_file"
+          git fetch --no-tags origin main
+          head_sha="$(git rev-parse --verify 'HEAD^{commit}')"
+          tag_sha="$(git rev-parse --verify "refs/tags/${TAG}^{commit}")"
+          [[ "$tag_sha" == "$head_sha" ]] || { echo "Tag ${TAG} does not resolve to checked-out HEAD." >&2; exit 1; }
+          if [[ "$TAG" != "v1.0.78-beta.13" ]]; then
+            git merge-base --is-ancestor "$head_sha" FETCH_HEAD || { echo "Tag ${TAG} is not contained in origin/main." >&2; exit 1; }
          fi

-  build-release:
+          node - "$preflight_file" "$head_sha" "$GITHUB_OUTPUT" <<'NODE'
+          const fs = require("node:fs");
+          const [file, sourceSha, output] = process.argv.slice(2);
+          const result = JSON.parse(fs.readFileSync(file, "utf8"));
+          if (result?.ok !== true || !["stable", "beta"].includes(result.data?.releaseChannel)) {
+            throw new Error("release preflight returned an invalid success payload");
+          }
+          const channel = result.data.releaseChannel;
+          fs.appendFileSync(output, `source_sha=${sourceSha}\nversion=${result.data.tagVersion}\nchannel=${channel}\nprerelease=${channel === "beta"}\n`);
+          NODE
+
+  build-sign-notarize:
    needs: preflight
    runs-on: ubuntu-22.04
    permissions:
-      contents: write
+      contents: read
    steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
        with:
          fetch-depth: 0
-
-      - uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff # v5
+          persist-credentials: false
+      - uses: actions/setup-go@924ae3a1cded613372ab5595356fb5720e22ba16 # v6
        with:
          go-version: '1.23'
-
-      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
        with:
          python-version: '3.x'
-
      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
        with:
          node-version: '22.14.0'
          registry-url: 'https://registry.npmjs.org'
          package-manager-cache: false

-      - name: Install pinned npm
-        run: npm install --global npm@11.16.0
+      - name: Prepare Apple notarization key
+        env:
+          MACOS_NOTARY_ISSUER_ID: ${{ vars.MACOS_NOTARY_ISSUER_ID }}
+          MACOS_NOTARY_KEY: ${{ secrets.MACOS_NOTARY_KEY }}
+          MACOS_NOTARY_KEY_ID: ${{ vars.MACOS_NOTARY_KEY_ID }}
+          MACOS_SIGN_P12: ${{ secrets.MACOS_SIGN_P12 }}
+          MACOS_SIGN_PASSWORD: ${{ secrets.MACOS_SIGN_PASSWORD }}
+          MACOS_TEAM_ID: ${{ vars.MACOS_TEAM_ID }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          set +x
+          for name in MACOS_SIGN_P12 MACOS_SIGN_PASSWORD MACOS_NOTARY_KEY MACOS_TEAM_ID MACOS_NOTARY_KEY_ID MACOS_NOTARY_ISSUER_ID; do
+            [[ -n "${!name:-}" ]] || { echo "Required Apple release input ${name} is not configured." >&2; exit 1; }
+          done
+          umask 077
+          notary_key="$(mktemp "${RUNNER_TEMP}/macos-notary-key.XXXXXX")"
+          printf '%s' "$MACOS_NOTARY_KEY" > "$notary_key"
+          chmod 0600 "$notary_key"
+          printf 'MACOS_NOTARY_KEY_PATH=%s\n' "$notary_key" >> "$GITHUB_ENV"

      - name: Run GoReleaser
-        uses: goreleaser/goreleaser-action@e435ccd777264be153ace6237001ef4d979d3a7a # v6
+        uses: goreleaser/goreleaser-action@f06c13b6b1a9625abc9e6e439d9c05a8f2190e94 # v7.2.3
        with:
-          version: '~> v2'
-          args: release --clean
+          version: v2.17.1
+          args: release --clean --skip=publish
        env:
-          GITHUB_TOKEN: ${{ github.token }}
+          MACOS_NOTARY_ISSUER_ID: ${{ vars.MACOS_NOTARY_ISSUER_ID }}
+          MACOS_NOTARY_KEY_ID: ${{ vars.MACOS_NOTARY_KEY_ID }}
+          MACOS_SIGN_P12: ${{ secrets.MACOS_SIGN_P12 }}
+          MACOS_SIGN_PASSWORD: ${{ secrets.MACOS_SIGN_PASSWORD }}

-      - name: Include release checksums
+      - name: Clean up Apple notarization key
+        if: ${{ always() }}
+        run: |
+          set -euo pipefail
+          set +x
+          [[ -z "${MACOS_NOTARY_KEY_PATH:-}" ]] || rm -f -- "$MACOS_NOTARY_KEY_PATH"
+
+      - name: Build release candidate
+        env:
+          VERSION: ${{ needs.preflight.outputs.version }}
        run: |
          set -euo pipefail
-          test -s dist/checksums.txt
          (cd dist && sha256sum --check checksums.txt)
+          mkdir release-candidate
+          cp dist/*.tar.gz dist/*.zip dist/checksums.txt release-candidate/
          cp dist/checksums.txt checksums.txt
+          npm install --global npm@11.16.0
+          pack_json="$(npm pack --ignore-scripts --json --pack-destination release-candidate)"
+          node - "$pack_json" "$VERSION" <<'NODE'
+          const [payload, version] = process.argv.slice(2);
+          const packs = JSON.parse(payload);
+          if (!Array.isArray(packs) || packs.length !== 1 || packs[0]?.name !== "@larksuite/cli" || packs[0]?.version !== version || !/^[^/\\]+\.tgz$/.test(packs[0]?.filename || "")) {
+            throw new Error("npm pack did not produce the expected release package");
+          }
+          NODE

-      - name: Collect release asset
-        run: |
-          set -euo pipefail
-          mkdir npm-publish-asset
-          cp dist/*.tar.gz dist/*.zip dist/checksums.txt npm-publish-asset/
-
-      - name: Upload release asset
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+      - name: Upload release candidate
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
        with:
-          name: npm-publish-asset-${{ github.run_id }}
-          path: npm-publish-asset/
+          name: release-candidate-${{ github.run_id }}
+          path: release-candidate/
          if-no-files-found: error
          overwrite: true

+  create-draft-release:
+    needs: [preflight, build-sign-notarize]
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          ref: ${{ needs.preflight.outputs.source_sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Download release candidate
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: release-candidate-${{ github.run_id }}
+          path: release-candidate
+
+      - name: Verify tag still points to source commit
+        env:
+          SOURCE_SHA: ${{ needs.preflight.outputs.source_sha }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          git fetch --no-tags origin "refs/tags/${TAG}:refs/tags/${TAG}"
+          [[ "$(git rev-parse "refs/tags/${TAG}^{commit}")" == "$SOURCE_SHA" ]] || { echo "Release tag changed after preflight." >&2; exit 1; }
+
+      - name: Create or reuse Draft Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PRERELEASE: ${{ needs.preflight.outputs.prerelease }}
+          SOURCE_SHA: ${{ needs.preflight.outputs.source_sha }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          if gh release view "$TAG" --json isDraft >/dev/null 2>&1; then
+            if [[ "$(gh release view "$TAG" --json isDraft -q .isDraft)" != "true" ]]; then
+              existing="$(mktemp -d "${RUNNER_TEMP}/published-release.XXXXXX")"
+              trap 'rm -rf -- "$existing"' EXIT
+              gh release download "$TAG" --dir "$existing"
+              cmp --silent release-candidate/checksums.txt "$existing/checksums.txt" || { echo "Published Release checksums do not match the current candidate." >&2; exit 1; }
+              (cd "$existing" && sha256sum --check checksums.txt)
+              diff --brief \
+                <(find release-candidate -maxdepth 1 -type f ! -name '*.tgz' -printf '%f\n' | sort) \
+                <(gh release view "$TAG" --json assets -q '.assets[].name' | sort)
+              exit 0
+            fi
+          else
+            args=("$TAG" --target "$SOURCE_SHA" --title "$TAG" --draft)
+            [[ "$PRERELEASE" != "true" ]] || args+=(--prerelease)
+            gh release create "${args[@]}"
+          fi
+          gh release upload "$TAG" release-candidate/*.tar.gz release-candidate/*.zip release-candidate/checksums.txt --clobber
+          diff --brief \
+            <(find release-candidate -maxdepth 1 -type f ! -name '*.tgz' -printf '%f\n' | sort) \
+            <(gh release view "$TAG" --json assets -q '.assets[].name' | sort)
+
+  verify-macos:
+    needs: [preflight, create-draft-release]
+    permissions:
+      # Draft Release assets require repository write access to download.
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            arch: amd64
+          - runner: macos-15
+            arch: arm64
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - name: Verify notarized macOS binary
+        env:
+          ARCH: ${{ matrix.arch }}
+          GH_TOKEN: ${{ github.token }}
+          MACOS_TEAM_ID: ${{ vars.MACOS_TEAM_ID }}
+          TAG: ${{ github.ref_name }}
+          VERSION: ${{ needs.preflight.outputs.version }}
+        run: |
+          set -euo pipefail
+          [[ -n "$MACOS_TEAM_ID" ]] || { echo "MACOS_TEAM_ID is not configured." >&2; exit 1; }
+          archive="lark-cli-${VERSION}-darwin-${ARCH}.tar.gz"
+          work="$(mktemp -d "${RUNNER_TEMP}/macos-release.XXXXXX")"
+          trap 'rm -rf -- "$work"' EXIT
+          gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --pattern "$archive" --pattern checksums.txt --dir "$work"
+          awk -v archive="$archive" '$2 == archive { print }' "$work/checksums.txt" > "$work/checksum.txt"
+          [[ "$(wc -l < "$work/checksum.txt" | tr -d '[:space:]')" == "1" ]] || { echo "checksums.txt must contain exactly one entry for ${archive}." >&2; exit 1; }
+          (cd "$work" && shasum -a 256 -c checksum.txt)
+          tar -xzf "$work/$archive" -C "$work"
+          binary="$work/lark-cli"
+          [[ -f "$binary" && ! -L "$binary" ]] || { echo "Archive did not contain a regular lark-cli binary." >&2; exit 1; }
+          codesign --verify --strict --verbose=4 "$binary"
+          details="$(codesign -dv --verbose=4 "$binary" 2>&1)"
+          grep -Eq '^Authority=Developer ID Application: .+' <<<"$details"
+          grep -Fxq "TeamIdentifier=${MACOS_TEAM_ID}" <<<"$details"
+          grep -Fq 'flags=0x10000(runtime)' <<<"$details"
+          grep -Eq '^Timestamp=.+' <<<"$details"
+          codesign --verify --strict --verbose=4 --check-notarization -R='notarized' "$binary"
+          "$binary" --version | grep -Fq "$VERSION"
+
+  publish-github:
+    needs: [preflight, create-draft-release, verify-macos]
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          ref: ${{ needs.preflight.outputs.source_sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Verify tag still points to source commit
+        env:
+          SOURCE_SHA: ${{ needs.preflight.outputs.source_sha }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          git fetch --no-tags origin "refs/tags/${TAG}:refs/tags/${TAG}"
+          [[ "$(git rev-parse "refs/tags/${TAG}^{commit}")" == "$SOURCE_SHA" ]] || { echo "Release tag changed after preflight." >&2; exit 1; }
+      - name: Publish verified Draft Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.ref_name }}
+        run: gh release edit "$TAG" --draft=false
+
  publish-npm:
-    needs: build-release
+    needs: [preflight, build-sign-notarize, publish-github]
    runs-on: ubuntu-22.04
    environment: npm-production
    permissions:
      contents: read
      id-token: write
    steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
-
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          ref: ${{ needs.preflight.outputs.source_sha }}
+          fetch-depth: 0
+          persist-credentials: false
      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
        with:
          node-version: '22.14.0'
          registry-url: 'https://registry.npmjs.org'
          package-manager-cache: false
-
-      - name: Install pinned npm
-        run: npm install --global npm@11.16.0
-
-      - name: Download release asset
+      - name: Download release candidate
        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
        with:
-          name: npm-publish-asset-${{ github.run_id }}
-          path: npm-publish-asset
-
-      - name: Verify npm publish asset
+          name: release-candidate-${{ github.run_id }}
+          path: release-candidate
+      - name: Install pinned npm
+        run: npm install --global npm@11.16.0
+      - name: Verify tag still points to source commit
+        env:
+          SOURCE_SHA: ${{ needs.preflight.outputs.source_sha }}
+          TAG: ${{ github.ref_name }}
        run: |
          set -euo pipefail
-          (cd npm-publish-asset && sha256sum --check checksums.txt)
-          cp npm-publish-asset/checksums.txt checksums.txt
-          PACK_JSON="$(npm pack --ignore-scripts --json)"
-          PACK_FILE="$(node -e 'const p=JSON.parse(process.argv[1]); if(p.length!==1 || !p[0].filename) process.exit(1); process.stdout.write(p[0].filename)' "$PACK_JSON")"
-          test -s "$PACK_FILE"
-          tar -tzf "$PACK_FILE" | grep -qx 'package/checksums.txt'
-          rm "$PACK_FILE"
+          git fetch --no-tags origin "refs/tags/${TAG}:refs/tags/${TAG}"
+          [[ "$(git rev-parse "refs/tags/${TAG}^{commit}")" == "$SOURCE_SHA" ]] || { echo "Release tag changed after preflight." >&2; exit 1; }
+      - name: Publish or verify npm package
+        env:
+          CHANNEL: ${{ needs.preflight.outputs.channel }}
+          VERSION: ${{ needs.preflight.outputs.version }}
+        run: |
+          set -euo pipefail
+          shopt -s nullglob
+          packages=(release-candidate/*.tgz)
+          (( ${#packages[@]} == 1 )) || { echo "Expected exactly one npm package." >&2; exit 1; }
+          tgz="${packages[0]}"
+          tar -xOzf "$tgz" package/checksums.txt > "${RUNNER_TEMP}/checksums.txt"
+          cmp --silent release-candidate/checksums.txt "${RUNNER_TEMP}/checksums.txt" || { echo "npm package checksums do not match the release candidate." >&2; exit 1; }
+          integrity="$(node - "$tgz" <<'NODE'
+          const crypto = require("node:crypto");
+          const fs = require("node:fs");
+          const hash = crypto.createHash("sha512");
+          hash.update(fs.readFileSync(process.argv[2]));
+          process.stdout.write(`sha512-${hash.digest("base64")}`);
+          NODE
+          )"
+          dist_tag=latest
+          [[ "$CHANNEL" != "beta" ]] || dist_tag=beta
+          if npm view "@larksuite/cli@${VERSION}" version --json >/dev/null 2>&1; then
+            published="$(npm view "@larksuite/cli@${VERSION}" dist.integrity --json | tr -d '"[:space:]')"
+            [[ "$published" == "$integrity" ]] || { echo "Existing npm version has different package integrity." >&2; exit 1; }
+            current="$(npm view @larksuite/cli "dist-tags.${dist_tag}" --json | tr -d '"[:space:]')"
+            [[ "$current" == "$VERSION" ]] || { echo "Existing npm version is not assigned to ${dist_tag}; repair registry state manually." >&2; exit 1; }
+          else
+            npm publish "./$tgz" --access public --provenance --tag "$dist_tag"
+          fi

-      - name: Publish to npm
-        run: npm publish --access public
+  retry-guidance:
+    needs: [preflight, build-sign-notarize, create-draft-release, verify-macos, publish-github, publish-npm]
+    if: ${{ always() && (needs.preflight.result == 'failure' || needs.build-sign-notarize.result == 'failure' || needs.create-draft-release.result == 'failure' || needs.verify-macos.result == 'failure' || needs.publish-github.result == 'failure' || needs.publish-npm.result == 'failure') }}
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+    steps:
+      - name: Write retry guidance
+        env:
+          PREFLIGHT_RESULT: ${{ needs.preflight.result }}
+          BUILD_RESULT: ${{ needs.build-sign-notarize.result }}
+          DRAFT_RESULT: ${{ needs.create-draft-release.result }}
+          VERIFY_RESULT: ${{ needs.verify-macos.result }}
+          GITHUB_RESULT: ${{ needs.publish-github.result }}
+          NPM_RESULT: ${{ needs.publish-npm.result }}
+        run: |
+          set -euo pipefail
+          {
+            echo "## Release retry guidance"
+            echo
+            echo "This job only records recovery guidance; it does not retry or publish anything."
+            echo
+            echo "| Job | Result |"
+            echo "| --- | --- |"
+            echo "| preflight | ${PREFLIGHT_RESULT} |"
+            echo "| build-sign-notarize | ${BUILD_RESULT} |"
+            echo "| create-draft-release | ${DRAFT_RESULT} |"
+            echo "| verify-macos | ${VERIFY_RESULT} |"
+            echo "| publish-github | ${GITHUB_RESULT} |"
+            echo "| publish-npm | ${NPM_RESULT} |"
+            printf '%s\n' \
+              '' \
+              'Select the recovery action from the failed-step diagnosis:' \
+              '' \
+              '- **preflight:** network or fetch failure → retry preflight. Version/tag validation failure → correct it, then create a new tag.' \
+              '- **build-sign-notarize:** transient build/service failure → retry build. Code or release configuration issue → correct it, then create a new tag.' \
+              '- **create-draft-release:** GitHub Draft Release API/upload failure → retry draft. Release-candidate inconsistency → retry build.' \
+              '- **verify-macos:** runner or network failure → retry only the failed matrix child. Checksum, signing, notarization, or runtime failure → retry build.' \
+              '- **publish-github:** GitHub publish network failure → retry GitHub publish. Install issue → retry build. Tag/assets inconsistency → stop and publish a new version.' \
+              '- **publish-npm:** network failure or uncertain publish outcome → retry npm only after verifying whether that version already exists. Integrity mismatch → publish a new version.'
+          } >> "$GITHUB_STEP_SUMMARY"
--- a/.goreleaser.yml
+++ b/.goreleaser.yml
@@ -5,7 +5,8 @@ before:
    - python3 scripts/fetch_meta.py

 builds:
-  - binary: lark-cli
+  - id: lark-cli
+    binary: lark-cli
    env:
      - CGO_ENABLED=0
    ldflags:
@@ -19,11 +20,27 @@ builds:
      - arm64
      - riscv64

+notarize:
+  macos:
+    - enabled: '{{ isEnvSet "MACOS_SIGN_P12" }}'
+      ids:
+        - lark-cli
+      sign:
+        certificate: "{{ .Env.MACOS_SIGN_P12 }}"
+        password: "{{ .Env.MACOS_SIGN_PASSWORD }}"
+      notarize:
+        issuer_id: "{{ .Env.MACOS_NOTARY_ISSUER_ID }}"
+        key_id: "{{ .Env.MACOS_NOTARY_KEY_ID }}"
+        key: "{{ .Env.MACOS_NOTARY_KEY_PATH }}"
+        wait: true
+        timeout: 20m
+
 archives:
  - name_template: "lark-cli-{{ .Version }}-{{ .Os }}-{{ .Arch }}"
+    formats: [tar.gz]
    format_overrides:
      - goos: windows
-        format: zip
+        formats: [zip]
    files:
      - README.md
      - LICENSE
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,22 +2,6 @@

 All notable changes to this project will be documented in this file.

-## [v1.0.79] - 2026-07-28
-
-### Features
-
- **slides**: update xsd (#2067)
-
-### Bug Fixes
-
- **ci**: validate static workflow identity (#2015)
- **sheets**: recognize OFL0X local office tokens (#2063)
-
-### Documentation
-
- **calendar**: clarify identity selection by event ownership (#2071)
- **slides**: add formula inline element syntax to quick-ref (#2077)
-
 ## [v1.0.78] - 2026-07-27

 ### Features
@@ -1701,7 +1685,6 @@ Bundled AI agent skills for intelligent assistance:
 - Bilingual documentation (English & Chinese).
 - CI/CD pipelines: linting, testing, coverage reporting, and automated releases.

-[v1.0.79]: https://github.com/larksuite/cli/releases/tag/v1.0.79
 [v1.0.78]: https://github.com/larksuite/cli/releases/tag/v1.0.78
 [v1.0.77]: https://github.com/larksuite/cli/releases/tag/v1.0.77
 [v1.0.75]: https://github.com/larksuite/cli/releases/tag/v1.0.75
--- a/1
+++ b/1
@@ -50,6 +50,7 @@ fmt-check:
 script-test:
 	bash scripts/resolve-changed-from.test.sh
 	bash scripts/ci-workflow.test.sh
+	bash scripts/release-workflow.test.sh
 	bash scripts/semantic-review-workflow.test.sh
 	$(NODE) --test scripts/e2e_domains.test.js scripts/fetch_e2e_tat.test.js scripts/install.test.js scripts/release-preflight.test.js scripts/semantic-review-verify-artifact.test.js scripts/pr-quality-summary.test.js scripts/semantic-review-publish.test.js scripts/ci-quality-summary-publish.test.js

--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "@larksuite/cli",
-  "version": "1.0.79",
+  "version": "1.0.78-beta.13",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "@larksuite/cli",
-      "version": "1.0.79",
+      "version": "1.0.78-beta.13",
      "cpu": [
        "x64",
        "arm64",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@larksuite/cli",
-  "version": "1.0.79",
+  "version": "1.0.78-beta.13",
  "description": "The official CLI for Lark/Feishu open platform",
  "bin": {
    "lark-cli": "scripts/run.js"
--- a/scripts/install.js
+++ b/scripts/install.js
@@ -7,7 +7,7 @@ const { execFileSync } = require("child_process");
 const os = require("os");
 const crypto = require("crypto");

-const VERSION = require("../package.json").version.replace(/-.*$/, "");
+const VERSION = require("../package.json").version;
 const REPO = "larksuite/cli";
 const NAME = "lark-cli";
 const DEFAULT_MIRROR_HOST = "https://registry.npmmirror.com";
@@ -37,13 +37,26 @@ const platform = PLATFORM_MAP[process.platform];
 const arch = ARCH_MAP[process.arch];

 const isWindows = process.platform === "win32";
-const ext = isWindows ? ".zip" : ".tar.gz";
-const archiveName = `${NAME}-${VERSION}-${platform}-${arch}${ext}`;
-const GITHUB_URL = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+const { archiveName, githubUrl: GITHUB_URL } = resolveReleaseAsset(
+  VERSION,
+  platform,
+  arch
+);

 const binDir = path.join(__dirname, "..", "bin");
 const dest = path.join(binDir, NAME + (isWindows ? ".exe" : ""));

+function resolveReleaseAsset(version, platformName, archName) {
+  const extension = platformName === "windows" ? ".zip" : ".tar.gz";
+  const resolvedArchiveName =
+    `${NAME}-${version}-${platformName}-${archName}${extension}`;
+  return {
+    archiveName: resolvedArchiveName,
+    githubUrl:
+      `https://github.com/${REPO}/releases/download/v${version}/${resolvedArchiveName}`,
+  };
+}
+
 // Build the ordered list of binary mirror URLs to try. Resolution rules:
 //   1. npm_config_registry     — when the user has set a non-default
 //                                registry (npmmirror clone, corp Verdaccio,
@@ -348,4 +361,4 @@ if (require.main === module) {
  }
 }

-module.exports = { getExpectedChecksum, verifyChecksum, assertAllowedHost, resolveMirrorUrls, curlSupportsSslRevokeBestEffort, isCurlVersionSupported };
+module.exports = { getExpectedChecksum, verifyChecksum, assertAllowedHost, resolveMirrorUrls, resolveReleaseAsset, curlSupportsSslRevokeBestEffort, isCurlVersionSupported };
--- a/scripts/install.test.js
+++ b/scripts/install.test.js
@@ -9,7 +9,36 @@ const os = require("os");

 const crypto = require("crypto");

-const { getExpectedChecksum, verifyChecksum, assertAllowedHost, resolveMirrorUrls, isCurlVersionSupported } = require("./install.js");
+const {
+  getExpectedChecksum,
+  verifyChecksum,
+  assertAllowedHost,
+  resolveMirrorUrls,
+  resolveReleaseAsset,
+  isCurlVersionSupported,
+} = require("./install.js");
+
+describe("resolveReleaseAsset", () => {
+  it("preserves a beta package version in tag and archive paths", () => {
+    const asset = resolveReleaseAsset(
+      "1.2.0-beta.1",
+      "linux",
+      "amd64"
+    );
+
+    assert.deepEqual(asset, {
+      archiveName: "lark-cli-1.2.0-beta.1-linux-amd64.tar.gz",
+      githubUrl:
+        "https://github.com/larksuite/cli/releases/download/v1.2.0-beta.1/lark-cli-1.2.0-beta.1-linux-amd64.tar.gz",
+    });
+    assert.deepEqual(
+      resolveMirrorUrls({}, asset.archiveName, "1.2.0-beta.1"),
+      [
+        "https://registry.npmmirror.com/-/binary/lark-cli/v1.2.0-beta.1/lark-cli-1.2.0-beta.1-linux-amd64.tar.gz",
+      ]
+    );
+  });
+});

 describe("getExpectedChecksum", () => {
  function makeTmpChecksums(content) {
--- a/scripts/release-preflight.js
+++ b/scripts/release-preflight.js
@@ -5,10 +5,13 @@
 const fs = require("node:fs");
 const path = require("node:path");

-const STABLE_VERSION_PATTERN = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/;
+const RELEASE_VERSION_PATTERN = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-beta\.(0|[1-9][0-9]*))?$/;

-function isStableVersion(value) {
-  return typeof value === "string" && STABLE_VERSION_PATTERN.test(value);
+function releaseChannelOf(value) {
+  if (typeof value !== "string" || !RELEASE_VERSION_PATTERN.test(value)) {
+    return null;
+  }
+  return value.includes("-beta.") ? "beta" : "stable";
 }

 function releaseError(message, observed, hint) {
@@ -31,11 +34,11 @@ function validateReleasePreflight(packageJson, packageLockJson, tag) {
    ["package-lock.json.version", lockVersion],
    ['package-lock.json.packages[""].version', lockRootVersion],
  ]) {
-    if (!isStableVersion(value)) {
+    if (!releaseChannelOf(value)) {
      return releaseError(
-        `${field} must be a stable release version in X.Y.Z form`,
+        `${field} must be a Stable or Beta release version`,
        observed,
-        "Use the same stable X.Y.Z version in all package fields; prerelease and build metadata are not allowed for production releases.",
+        "Use the same stable X.Y.Z or beta X.Y.Z-beta.N version in all package fields; other prerelease labels and build metadata are not allowed.",
      );
    }
  }
@@ -48,14 +51,15 @@ function validateReleasePreflight(packageJson, packageLockJson, tag) {
    );
  }

+  const releaseChannel = releaseChannelOf(packageVersion);
  if (tag === undefined) {
-    return { ok: true, data: observed };
+    return { ok: true, data: { ...observed, releaseChannel } };
  }
-  if (typeof tag !== "string" || !tag.startsWith("v") || !isStableVersion(tag.slice(1))) {
+  if (typeof tag !== "string" || !tag.startsWith("v") || !releaseChannelOf(tag.slice(1))) {
    return releaseError(
-      "--tag must use the stable release form vX.Y.Z",
+      "--tag must use a Stable or Beta release form",
      { ...observed, tag },
-      `Use --tag v${packageVersion}; prerelease and build metadata are not allowed for production releases.`,
+      `Use --tag v${packageVersion}; valid forms are vX.Y.Z and vX.Y.Z-beta.N.`,
    );
  }

@@ -67,7 +71,7 @@ function validateReleasePreflight(packageJson, packageLockJson, tag) {
      `Use --tag v${packageVersion}.`,
    );
  }
-  return { ok: true, data: { ...observed, tagVersion } };
+  return { ok: true, data: { ...observed, tagVersion, releaseChannel } };
 }

 function writeResult(result) {
@@ -82,7 +86,7 @@ function main() {
    tag = args[1];
  } else if (args.length !== 0) {
    writeResult(releaseError(
-      "Expected no arguments or --tag vX.Y.Z",
+      "Expected no arguments or --tag vX.Y.Z[-beta.N]",
      { arguments: args },
      "Run release:check without arguments or pass exactly one --tag value.",
    ));
--- a/scripts/release-preflight.test.js
+++ b/scripts/release-preflight.test.js
@@ -35,22 +35,80 @@ describe("validateReleasePreflight", () => {
          lockVersion: "1.2.3",
          lockRootVersion: "1.2.3",
          tagVersion: "1.2.3",
+          releaseChannel: "stable",
        },
      },
    );
  });

-  it("rejects non-stable or inconsistent package metadata", () => {
-    const prerelease = metadata("1.2.3-beta.1");
+  it("accepts matching beta package, lock, and tag versions", () => {
+    const { packageJson, packageLockJson } = metadata("1.2.3-beta.4");
+
+    assert.deepEqual(
+      validateReleasePreflight(packageJson, packageLockJson, "v1.2.3-beta.4"),
+      {
+        ok: true,
+        data: {
+          packageVersion: "1.2.3-beta.4",
+          lockVersion: "1.2.3-beta.4",
+          lockRootVersion: "1.2.3-beta.4",
+          tagVersion: "1.2.3-beta.4",
+          releaseChannel: "beta",
+        },
+      },
+    );
+  });
+
+  it("derives the release channel when no tag is provided", () => {
+    const { packageJson, packageLockJson } = metadata("1.2.3-beta.0");
+
+    assert.deepEqual(
+      validateReleasePreflight(packageJson, packageLockJson),
+      {
+        ok: true,
+        data: {
+          packageVersion: "1.2.3-beta.0",
+          lockVersion: "1.2.3-beta.0",
+          lockRootVersion: "1.2.3-beta.0",
+          tagVersion: null,
+          releaseChannel: "beta",
+        },
+      },
+    );
+  });
+
+  it("rejects unsupported or invalid package versions with an actionable hint", () => {
+    for (const version of [
+      "1.2.3-alpha.1",
+      "1.2.3-rc.1",
+      "1.2.3-beta",
+      "1.2.3-beta.01",
+      "1.2.3+build.1",
+      "1.2.3-beta.1+build.1",
+      "01.2.3",
+      "1.02.3",
+      "1.2.03",
+    ]) {
+      const { packageJson, packageLockJson } = metadata(version);
+      const result = validateReleasePreflight(packageJson, packageLockJson);
+
+      assertRejected(result);
+      assert.match(result.error.hint, /stable X\.Y\.Z or beta X\.Y\.Z-beta\.N/i);
+    }
+  });
+
+  it("rejects inconsistent package metadata", () => {
    const topLevelMismatch = metadata();
    topLevelMismatch.packageLockJson.version = "1.2.4";
    const rootMismatch = metadata();
    rootMismatch.packageLockJson.packages[""].version = "1.2.4";
+    const channelMismatch = metadata("1.2.3-beta.1");
+    channelMismatch.packageLockJson.version = "1.2.3";

    for (const { packageJson, packageLockJson } of [
-      prerelease,
      topLevelMismatch,
      rootMismatch,
+      channelMismatch,
    ]) {
      assertRejected(validateReleasePreflight(packageJson, packageLockJson));
    }
@@ -59,7 +117,22 @@ describe("validateReleasePreflight", () => {
  it("rejects an invalid or mismatched release tag", () => {
    const { packageJson, packageLockJson } = metadata();

-    for (const tag of ["1.2.3", "v1.2.3-beta.1", "v1.2.4"]) {
+    for (const tag of [
+      "1.2.3",
+      "v1.2.3-alpha.1",
+      "v1.2.3-beta.01",
+      "v1.2.3+build.1",
+      "v1.2.3-beta.1",
+      "v1.2.4",
+    ]) {
+      assertRejected(validateReleasePreflight(packageJson, packageLockJson, tag));
+    }
+  });
+
+  it("rejects a beta tag that does not match beta package metadata", () => {
+    const { packageJson, packageLockJson } = metadata("1.2.3-beta.2");
+
+    for (const tag of ["v1.2.3-beta.1", "v1.2.3"]) {
      assertRejected(validateReleasePreflight(packageJson, packageLockJson, tag));
    }
  });
--- a/scripts/release-workflow.test.sh
+++ b/scripts/release-workflow.test.sh
@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+# Copyright (c) 2026 Lark Technologies Pte. Ltd.
+# SPDX-License-Identifier: MIT
+
+set -euo pipefail
+
+# This verifies the release workflow's declarative contract. The shell commands
+# inside individual steps are exercised by the beta release rehearsal instead.
+ruby -ryaml <<'RUBY'
+workflow = YAML.load_file(".github/workflows/release.yml")
+goreleaser = YAML.load_file(".goreleaser.yml")
+
+def fail(message)
+  abort("release workflow contract: #{message}")
+end
+
+def expect_equal(actual, expected, description)
+  return if actual == expected
+  fail("#{description}; expected #{expected.inspect}, got #{actual.inspect}")
+end
+
+def scalar_values(value)
+  case value
+  when Hash then value.values.flat_map { |item| scalar_values(item) }
+  when Array then value.flat_map { |item| scalar_values(item) }
+  else [value]
+  end
+end
+
+def action_references(value)
+  case value
+  when Hash
+    value.flat_map { |key, item| key == "uses" ? [item] : action_references(item) }
+  when Array
+    value.flat_map { |item| action_references(item) }
+  else
+    []
+  end
+end
+
+jobs = workflow.fetch("jobs")
+expected_jobs = %w[preflight build-sign-notarize create-draft-release verify-macos publish-github publish-npm retry-guidance]
+expect_equal(jobs.keys.sort, expected_jobs.sort, "release jobs")
+
+expect_equal(workflow.fetch("concurrency"), {
+  "group" => "release-${{ github.ref_name }}",
+  "cancel-in-progress" => false,
+}, "release concurrency")
+
+expected_needs = {
+  "preflight" => nil,
+  "build-sign-notarize" => "preflight",
+  "create-draft-release" => %w[preflight build-sign-notarize],
+  "verify-macos" => %w[preflight create-draft-release],
+  "publish-github" => %w[preflight create-draft-release verify-macos],
+  "publish-npm" => %w[preflight build-sign-notarize publish-github],
+  "retry-guidance" => %w[preflight build-sign-notarize create-draft-release verify-macos publish-github publish-npm],
+}
+expected_needs.each do |job_name, needs|
+  expect_equal(jobs.fetch(job_name)["needs"], needs, "#{job_name} dependencies")
+end
+
+expected_permissions = {
+  "preflight" => { "contents" => "read" },
+  "build-sign-notarize" => { "contents" => "read" },
+  "create-draft-release" => { "contents" => "write" },
+  "verify-macos" => { "contents" => "write" },
+  "publish-github" => { "contents" => "write" },
+  "publish-npm" => { "contents" => "read", "id-token" => "write" },
+  "retry-guidance" => { "contents" => "read" },
+}
+expected_permissions.each do |job_name, permissions|
+  expect_equal(jobs.fetch(job_name)["permissions"], permissions, "#{job_name} permissions")
+end
+expect_equal(jobs.fetch("publish-npm").fetch("environment"), "npm-production", "npm publish environment")
+
+retry_guidance = jobs.fetch("retry-guidance")
+retry_condition = "${{ always() && (needs.preflight.result == 'failure' || needs.build-sign-notarize.result == 'failure' || needs.create-draft-release.result == 'failure' || needs.verify-macos.result == 'failure' || needs.publish-github.result == 'failure' || needs.publish-npm.result == 'failure') }}"
+expect_equal(retry_guidance.fetch("if"), retry_condition, "retry guidance failure condition")
+expect_equal(retry_guidance.fetch("runs-on"), "ubuntu-22.04", "retry guidance runner")
+
+retry_steps = retry_guidance.fetch("steps")
+expect_equal(retry_steps.length, 1, "number of retry guidance steps")
+retry_step = retry_steps.first
+expect_equal(retry_step.fetch("name"), "Write retry guidance", "retry guidance step name")
+fail("retry guidance must write to the GitHub step summary") unless retry_step.fetch("run").include?("GITHUB_STEP_SUMMARY")
+
+signing_references = %w[
+  secrets.MACOS_SIGN_P12
+  secrets.MACOS_SIGN_PASSWORD
+  secrets.MACOS_NOTARY_KEY
+  vars.MACOS_NOTARY_KEY_ID
+  vars.MACOS_NOTARY_ISSUER_ID
+]
+team_reference = "vars.MACOS_TEAM_ID"
+jobs.each do |job_name, job|
+  references = scalar_values(job).grep(String).flat_map do |value|
+    (signing_references + [team_reference]).select { |reference| value.include?(reference) }
+  end.uniq.sort
+  expected_references = case job_name
+                        when "build-sign-notarize" then signing_references + [team_reference]
+                        when "verify-macos" then [team_reference]
+                        else []
+                        end
+  expect_equal(
+    references,
+    expected_references.sort,
+    "#{job_name} Apple credential scope",
+  )
+end
+
+macos = jobs.fetch("verify-macos")
+expect_equal(macos.fetch("strategy").fetch("matrix").fetch("include"), [
+  { "runner" => "macos-15-intel", "arch" => "amd64" },
+  { "runner" => "macos-15", "arch" => "arm64" },
+], "macOS verification matrix")
+expect_equal(macos.fetch("runs-on"), "${{ matrix.runner }}", "macOS matrix runner")
+
+npm_steps = jobs.fetch("publish-npm").fetch("steps")
+pinned_npm = npm_steps.find { |step| step["name"] == "Install pinned npm" }
+fail("publish-npm must install npm 11.16.0 for trusted publishing") unless pinned_npm&.fetch("run", nil) == "npm install --global npm@11.16.0"
+publish_step = npm_steps.find { |step| step["name"] == "Publish or verify npm package" }
+fail("publish-npm must explicitly pass the candidate tarball as a local path") unless publish_step&.fetch("run", nil).include?('npm publish "./$tgz"')
+
+action_references(workflow).each do |reference|
+  fail("action is not pinned to a full commit SHA: #{reference}") unless reference.match?(%r{\A[^@]+@[0-9a-f]{40}\z})
+end
+
+notarize = goreleaser.fetch("notarize").fetch("macos")
+expect_equal(notarize.length, 1, "number of macOS notarization configurations")
+macos_notarize = notarize.first
+expect_equal(macos_notarize.fetch("ids"), ["lark-cli"], "notarized build IDs")
+expect_equal(macos_notarize.fetch("sign"), {
+  "certificate" => "{{ .Env.MACOS_SIGN_P12 }}",
+  "password" => "{{ .Env.MACOS_SIGN_PASSWORD }}",
+}, "macOS signing inputs")
+expect_equal(macos_notarize.fetch("notarize"), {
+  "issuer_id" => "{{ .Env.MACOS_NOTARY_ISSUER_ID }}",
+  "key_id" => "{{ .Env.MACOS_NOTARY_KEY_ID }}",
+  "key" => "{{ .Env.MACOS_NOTARY_KEY_PATH }}",
+  "wait" => true,
+  "timeout" => "20m",
+}, "macOS notarization inputs")
+
+puts "release workflow contract passed"
+RUBY
--- a/shortcuts/calendar/description_rich_images.go
+++ b/shortcuts/calendar/description_rich_images.go
@@ -157,7 +157,7 @@ func localImagePath(src string) string {
 }

 func buildCalendarImagePreviewURL(brand core.LarkBrand, fileToken string, width, height int, size int64) string {
-	host := "internal-api-drive-stream.feishu.cn"
+	host := "internal-api-drive-stream.larkoffice.com"
 	if brand == core.BrandLark {
 		host = "internal-api-drive-stream.larksuite.com"
 	}
--- a/shortcuts/calendar/description_rich_images_test.go
+++ b/shortcuts/calendar/description_rich_images_test.go
@@ -68,7 +68,7 @@ func TestBuildCalendarImagePreviewURL(t *testing.T) {
 		brand    core.LarkBrand
 		hostFrag string
 	}{
-		{core.BrandFeishu, "feishu.cn"},
+		{core.BrandFeishu, "larkoffice"},
 		{core.BrandLark, "larksuite"},
 	} {
 		raw := buildCalendarImagePreviewURL(tc.brand, "boxcnTOKEN123", 416, 306, 142568)
--- a/shortcuts/sheets/backward/lark_sheets_float_images.go
+++ b/shortcuts/sheets/backward/lark_sheets_float_images.go
@@ -17,10 +17,9 @@ import (
 )

 // Drive media parent_type values for uploading an image into a spreadsheet.
-// Native spreadsheets use "sheet_image"; imported "office" spreadsheets use a
-// legacy synthetic-token prefix or a 28-character token whose interleaved
-// product/region marker is "OFL0X". The backend requires
-// "office_sheet_file" for those imported spreadsheets.
+// Native spreadsheets use "sheet_image"; imported "office" spreadsheets carry a
+// synthetic token prefixed with "fake_office_" (being renamed to
+// "local_office_") and the backend requires "office_sheet_file" instead.
 const (
 	sheetImageParentType      = "sheet_image"
 	officeSheetFileParentType = "office_sheet_file"
@@ -28,37 +27,22 @@ const (
 	localOfficePrefix         = "local_office_"
 )

-// officePrefixes are the legacy synthetic token prefixes an imported "office"
-// spreadsheet may carry.
+// officePrefixes are the synthetic token prefixes an imported "office"
+// spreadsheet may carry. The prefix is being renamed from "fake_office_" to
+// "local_office_"; accept either so image uploads keep working across the
+// rename.
 var officePrefixes = []string{fakeOfficePrefix, localOfficePrefix}

-func isOfficeSpreadsheet(spreadsheetToken string) bool {
+// sheetMediaParentType returns the drive media parent_type to use when
+// uploading an image whose parent_node is spreadsheetToken, mapping either the
+// "fake_office_" or "local_office_" imported-spreadsheet token prefix to
+// "office_sheet_file".
+func sheetMediaParentType(spreadsheetToken string) string {
 	for _, prefix := range officePrefixes {
 		if strings.HasPrefix(spreadsheetToken, prefix) {
-			return true
+			return officeSheetFileParentType
 		}
 	}
-	if len(spreadsheetToken) != 28 {
-		return false
-	}
-	// The five-character marker occupies positions 5, 10, 15, 20, and 25
-	// (1-based) in the interleaved token.
-	marker := []byte{
-		spreadsheetToken[4],
-		spreadsheetToken[9],
-		spreadsheetToken[14],
-		spreadsheetToken[19],
-		spreadsheetToken[24],
-	}
-	return string(marker) == "OFL0X"
-}
-
-// sheetMediaParentType returns the drive media parent_type to use when
-// uploading an image whose parent_node is spreadsheetToken.
-func sheetMediaParentType(spreadsheetToken string) string {
-	if isOfficeSpreadsheet(spreadsheetToken) {
-		return officeSheetFileParentType
-	}
 	return sheetImageParentType
 }

--- a/shortcuts/sheets/backward/lark_sheets_sheet_media_upload_test.go
+++ b/shortcuts/sheets/backward/lark_sheets_sheet_media_upload_test.go
@@ -105,7 +105,7 @@ func TestSheetMediaUploadDryRunSmallFileOfficeParentType(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, sheetsTestConfig())
 	err := mountAndRunSheets(t, SheetMediaUpload, []string{
 		"+media-upload",
-		"--spreadsheet-token", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
+		"--spreadsheet-token", "fake_office_abc123",
 		"--file", "img.png",
 		"--dry-run", "--as", "user",
 	}, f, stdout)
@@ -117,10 +117,10 @@ func TestSheetMediaUploadDryRunSmallFileOfficeParentType(t *testing.T) {
 		t.Fatalf("dry-run should use upload_all for small file, got: %s", out)
 	}
 	if !strings.Contains(out, `"office_sheet_file"`) {
-		t.Fatalf("dry-run should include parent_type=office_sheet_file for interleaved OFL0X token, got: %s", out)
+		t.Fatalf("dry-run should include parent_type=office_sheet_file for fake_office_ token, got: %s", out)
 	}
 	if strings.Contains(out, `"sheet_image"`) {
-		t.Fatalf("dry-run must not emit sheet_image for interleaved OFL0X token, got: %s", out)
+		t.Fatalf("dry-run must not emit sheet_image for fake_office_ token, got: %s", out)
 	}
 }

@@ -239,7 +239,7 @@ func TestSheetMediaUploadExecuteSuccess(t *testing.T) {
 }

 // TestSheetMediaUploadExecuteOfficeParentType confirms that an imported
-// "office" spreadsheet (token carrying the interleaved "OFL0X" marker) uploads with
+// "office" spreadsheet (token prefixed with "fake_office_") uploads with
 // parent_type=office_sheet_file instead of the native sheet_image.
 func TestSheetMediaUploadExecuteOfficeParentType(t *testing.T) {
 	dir := t.TempDir()
@@ -259,7 +259,7 @@ func TestSheetMediaUploadExecuteOfficeParentType(t *testing.T) {
 	}
 	reg.Register(stub)

-	const officeToken = "aaaaOaaaaFaaaaLaaaa0aaaaXaaa"
+	const officeToken = "fake_office_abc123"
 	err := mountAndRunSheets(t, SheetMediaUpload, []string{
 		"+media-upload",
 		"--spreadsheet-token", officeToken,
--- a/shortcuts/sheets/helpers.go
+++ b/shortcuts/sheets/helpers.go
@@ -53,10 +53,9 @@ func sheetsInputStatError(flag string, err error) error {
 }

 // Drive media parent_type values for uploading an image into a spreadsheet.
-// Native spreadsheets use "sheet_image"; imported "office" spreadsheets use a
-// legacy synthetic-token prefix or a 28-character token whose interleaved
-// product/region marker is "OFL0X". The backend requires
-// "office_sheet_file" for those imported spreadsheets.
+// Native spreadsheets use "sheet_image"; imported "office" spreadsheets carry a
+// synthetic token prefixed with "fake_office_" (being renamed to
+// "local_office_") and the backend requires "office_sheet_file" instead.
 const (
 	sheetImageParentType      = "sheet_image"
 	officeSheetFileParentType = "office_sheet_file"
@@ -64,38 +63,21 @@ const (
 	localOfficePrefix         = "local_office_"
 )

-// officePrefixes are the legacy synthetic token prefixes an imported "office"
-// spreadsheet may carry.
+// officePrefixes are the synthetic token prefixes an imported "office"
+// spreadsheet may carry. The prefix is being renamed from "fake_office_" to
+// "local_office_"; accept either so image uploads keep working across the
+// rename.
 var officePrefixes = []string{fakeOfficePrefix, localOfficePrefix}

-func isOfficeSpreadsheet(spreadsheetToken string) bool {
-	for _, prefix := range officePrefixes {
-		if strings.HasPrefix(spreadsheetToken, prefix) {
-			return true
-		}
-	}
-	if len(spreadsheetToken) != 28 {
-		return false
-	}
-	// The five-character marker occupies positions 5, 10, 15, 20, and 25
-	// (1-based) in the interleaved token.
-	marker := []byte{
-		spreadsheetToken[4],
-		spreadsheetToken[9],
-		spreadsheetToken[14],
-		spreadsheetToken[19],
-		spreadsheetToken[24],
-	}
-	return string(marker) == "OFL0X"
-}
-
 // sheetMediaParentType returns the drive media parent_type to use when
 // uploading an image whose parent_node is spreadsheetToken. It is the single
 // place that maps a spreadsheet token to its parent_type so every image-upload
 // entry point (and its dry-run preview) stays consistent.
 func sheetMediaParentType(spreadsheetToken string) string {
-	if isOfficeSpreadsheet(spreadsheetToken) {
-		return officeSheetFileParentType
+	for _, prefix := range officePrefixes {
+		if strings.HasPrefix(spreadsheetToken, prefix) {
+			return officeSheetFileParentType
+		}
 	}
 	return sheetImageParentType
 }
--- a/shortcuts/sheets/sheet_media_parent_type_test.go
+++ b/shortcuts/sheets/sheet_media_parent_type_test.go
@@ -25,9 +25,8 @@ import (

 // TestSheetMediaParentType pins the token→parent_type mapping that every
 // sheets image-upload entry point funnels through. Native spreadsheet tokens
-// use "sheet_image"; imported "office" spreadsheets use either a legacy
-// prefix or the interleaved "OFL0X" marker and must upload with
-// "office_sheet_file".
+// use "sheet_image"; imported "office" spreadsheets carry a "fake_office_" or
+// "local_office_" synthetic token and must upload with "office_sheet_file".
 func TestSheetMediaParentType(t *testing.T) {
 	t.Parallel()
 	cases := []struct {
@@ -41,13 +40,6 @@ func TestSheetMediaParentType(t *testing.T) {
 		{"fake_office token, only the prefix", fakeOfficePrefix, officeSheetFileParentType},
 		{"local_office imported token", "local_office_abc123", officeSheetFileParentType},
 		{"local_office token, only the prefix", localOfficePrefix, officeSheetFileParentType},
-		{"interleaved OFL0X office token", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa", officeSheetFileParentType},
-		{"interleaved exlcn token", "abcdeefghxijkllmnopcqrstnuv", sheetImageParentType},
-		{"interleaved shtcn native token", "abcdsefghhijkltmnopcqrstnuv", sheetImageParentType},
-		{"interleaved pptcn token", "abcdpefghpijkltmnopcqrstnuv", sheetImageParentType},
-		{"interleaved wodcn token", "abcdwefghoijkldmnopcqrstnuv", sheetImageParentType},
-		{"interleaved OFL0X marker with short length", "aaaaOaaaaFaaaaLaaaa0aaaaXaa", sheetImageParentType},
-		{"interleaved OFL0X marker with long length", "aaaaOaaaaFaaaaLaaaa0aaaaXaaaa", sheetImageParentType},
 		{"fake_office prefix mid-string is not matched", "shtfake_office_abc", sheetImageParentType},
 		{"local_office prefix mid-string is not matched", "shtlocal_office_abc", sheetImageParentType},
 	}
@@ -65,7 +57,7 @@ func TestSheetMediaParentType(t *testing.T) {
 // to end (the Execute path the dry-run tests don't reach), asserting the
 // parent_type that actually goes out on the wire is derived from the token: a
 // native spreadsheet uploads as sheet_image, an imported "office" spreadsheet
-// (legacy prefix or interleaved OFL0X marker) as office_sheet_file.
+// (fake_office_-prefixed token) as office_sheet_file.
 func TestUploadSheetImage_ParentType(t *testing.T) {
 	cases := []struct {
 		name           string
@@ -75,7 +67,6 @@ func TestUploadSheetImage_ParentType(t *testing.T) {
 		{"native spreadsheet", "shtcnTOK123", sheetImageParentType},
 		{"fake_office imported spreadsheet", "fake_office_abc123", officeSheetFileParentType},
 		{"local_office imported spreadsheet", "local_office_abc123", officeSheetFileParentType},
-		{"interleaved OFL0X imported spreadsheet", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa", officeSheetFileParentType},
 	}
 	for _, tc := range cases {
 		t.Run(tc.name, func(t *testing.T) {
--- a/skills/lark-calendar/SKILL.md
+++ b/skills/lark-calendar/SKILL.md
@@ -16,16 +16,14 @@ metadata:

 ## 身份

-按**日程归属**选身份：
-
- 查看/管理登录用户本人的日程 → `--as user`（默认，绝大多数场景）。
- 查看/管理 bot 自己创建/拥有的日程 → `--as bot` 
+日程操作默认使用 `--as user`（查看和管理当前用户的日程）。`--as bot` 只能访问 bot 自己的（空）日历，会拿到空结果——不要用 bot 身份查用户日程。

 ```bash
-# 用户本人日程 → user
-lark-cli calendar +agenda --as user
-# bot 自建或参与的日程 → bot
+# BAD — bot 身份查用户日程，返回空列表
 lark-cli calendar +agenda --as bot
+
+# GOOD — user 身份查日程
+lark-cli calendar +agenda --as user
 ```

 ## Shortcuts
@@ -190,8 +188,6 @@ lark-cli contact +search-user --query <query> --as user
 lark-cli im +chat-search --query <query> --as user
 ```

-> 搜索用户接口不支持 bot 身份，必须用 `--as user`；搜到的 `ou_` open_id 用于日程参与人操作（如添加日程参与人）。
-
 ## 不在本 skill 范围

 - 查询过去的视频会议记录 → [lark-vc](../lark-vc/SKILL.md)
--- a/skills/lark-calendar/references/lark-calendar-create.md
+++ b/skills/lark-calendar/references/lark-calendar-create.md
@@ -33,7 +33,7 @@ lark-cli calendar +create --summary "..." --start "..." --end "..." \
 | `--start <time>` | 是 | 开始时间（ISO 8601，如 `2026-03-12T14:00+08:00`） |
 | `--end <time>` | 是 | 结束时间（ISO 8601） |
 | `--description <markdown>` | 否 | 日程描述，统一使用此字段，格式为 **Markdown**。提供会议议程、活动内容、注意事项或链接等。支持加粗、斜体、下划线（`<u>...</u>`）、删除线、链接 `[文本](url)`、标题（`# ` 到 `### `，最多三级）、引用（`> `）、有序/无序列表、GFM 表格（`\| 列1 \| 列2 \|` + 分隔行 `\| --- \| --- \|`）、以及图片 `![图片名](图片URL)`（标准 Markdown 图片语法：远程 URL 原样使用；**本地图片路径**（相对路径、且位于当前工作目录内）会自动上传到云盘并在端上内联渲染——绝对路径或工作目录之外的路径会报错；端上已有图片读回为 Markdown 图片）。飞书文档 URL（直接粘贴裸链接，或写成 `[文本](url)`）会自动解析为内联文档，端上展示文档标题而非裸链接。支持 `@文件路径` 或 `-`（stdin）读取。**禁止**用 `***文本***` 同时表示加粗+斜体（端上会残留 `*`）；应嵌套书写，如 `**<u>*~~文本~~*</u>**` 或 `*<u>**~~文本~~**</u>*`。|
-| `--attendee-ids <id_list>` | 否 | 参与人 ID 列表（逗号分隔）。支持用户（`ou_`）、群组（`oc_`）和会议室（`omm_`）。AI 提取时请务必保留对应前缀。bot 可作为合法参会人，无需剔除 |
+| `--attendee-ids <id_list>` | 否 | 参与人 ID 列表（逗号分隔）。支持用户（`ou_`）、群组（`oc_`）和会议室（`omm_`）。AI 提取时请务必保留对应前缀 |
 | `--calendar-id <id>` | 否 | 日历 ID（省略则使用主日历） |
 | `--rrule <rrule>` | 否 | 重复日程的重复性规则，规则设置方式参考rfc5545。示例值："FREQ=DAILY;INTERVAL=1;UNTIL=<具体日期>" |
 | `--dry-run` | 否 | 预览 API 调用，不执行 |
@@ -45,6 +45,7 @@ lark-cli calendar +create --summary "..." --start "..." --end "..." \
 > 自动设置 `reminders: [{"minutes": 5}]`，默认日程开始前 5 分钟提醒。
 > 自动设置 `vchat: {"vc_type": "vc"}`，默认日程包含飞书视频会议。如需其他视频会议类型或不含视频会议，请使用完整 API 命令。
 > 失败保护：若添加参会人失败（如 open_id 错误），CLI 会自动删除刚创建的空日程（回滚，不通知参会人）。
+> 搜索用户接口不支持 bot 身份，需用 `--as user` 进行搜索。
 > 审批会议室：`+create` 不暴露低频字段 `attendees[].approval_reason`。如果会议室要求审批，请使用用户身份先创建日程，再用完整 API `calendar event.attendees create --as user` 添加会议室并传 `approval_reason`。

 ## 高级用法（完整 API 命令）
--- a/skills/lark-calendar/references/lark-calendar-room-find.md
+++ b/skills/lark-calendar/references/lark-calendar-room-find.md
@@ -50,13 +50,12 @@ lark-cli calendar +room-find \
 | `--room-name <text>` | 否 | 会议室名称约束，支持以**英文逗号**分隔传入多个名称。仅当用户明确提到会议室专名、会议室号或编号区间时使用。 |
 | `--min-capacity <n>` | 否 | 会议室最小容纳人数。当用户明确参会人数或提出“至少容纳N人”等要求时，提取数字放入此参数，必须为正整数。 |
 | `--max-capacity <n>` | 否 | 会议室最大容纳人数。用于过滤过大空间，必须为正整数。 |
-| `--attendee-ids <id_list>` | 否 | 参会对象 ID 列表。支持用户 ID（`ou_` 前缀）和群组 ID（`oc_` 前缀），多个 ID 以逗号分隔。**不要传入 bot 的 open_id**：bot 是虚拟身份，不占会议室席位、无会议室偏好，传入只会干扰推荐结果。 |
+| `--attendee-ids <id_list>` | 否 | 参会对象 ID 列表。支持用户 ID（`ou_` 前缀）和群组 ID（`oc_` 前缀），多个 ID 以逗号分隔。 |
 | `--event-rrule <rrule>` | 否 | 重复日程的重复性规则，规则设置方式参考rfc5545。**【⚠️注意：系统绝对不支持 COUNT，如需限制重复次数，必须转为 UNTIL】**。示例值："FREQ=DAILY;INTERVAL=1" |
 | `--timezone <tz>` | 否 | 对话中明确提及的预约日程所使用的时区（默认取用户设备时区，例如 `Asia/Shanghai`） |

 ## 规则

- 构造 `--attendee-ids` 前，先剔除 bot 参会人：bot 不占席位、无偏好，不应参与会议室推荐。
 - 多个 `--slot` 会由 CLI 内部并发调用单时间块接口，再聚合成一次输出
 - `+room-find` 的时间输入必须是**确定时间块**，不是时间区间搜索。
 - 如果是重复性日程，必须校验返回中的 `reserve_until_time`（该会议室最晚可预约时间）是否覆盖 `event-rrule` 对应的重复范围。
--- a/skills/lark-calendar/references/lark-calendar-schedule-clear-time.md
+++ b/skills/lark-calendar/references/lark-calendar-schedule-clear-time.md
@@ -39,7 +39,6 @@ lark-cli calendar +freebusy --start "<start>" --end "<end>"
 ```

 规则：
- 参与人含 **bot**：无需为 bot 查询忙闲。bot 是虚拟身份，可并行多个会议、无忙闲语义，检查它没有意义。
 - 参与人过多（超过 5 人）：仅查询**当前用户**及少数核心人员忙闲即可
 - 参与人含**群组**：无需展开群组成员查询忙闲
 - 如果用户是从 `+suggestion` 确认了时间块后进入本分支的，**无需再调用 `+freebusy`**
--- a/skills/lark-calendar/references/lark-calendar-suggestion.md
+++ b/skills/lark-calendar/references/lark-calendar-suggestion.md
@@ -45,7 +45,7 @@ lark-cli calendar +suggestion \
 | ------------------------------- | ----- | ------------------------------------------------------------------- |
 | `--start <time>`                | 否     | 搜索区间开始时间（支持日期/ISO 8601等格式，默认**当前时间**）                                |
 | `--end <time>`                  | 否     | 搜索区间结束时间（默认与 `--start` 属于同一天，自动取当天结束时间）                                                     |
-| `--attendee-ids <id_list>`     | 否     | 目标参与人 ID 列表。提取对应实体的 ID。支持用户（`ou_` 前缀）和群组（`oc_` 前缀）。多个 ID 使用英文逗号分隔。**不要传入 bot 的 open_id**：bot 是虚拟身份，可并行多个会议、无忙闲语义，传入会干扰推荐时段的忙闲计算。 |
+| `--attendee-ids <id_list>`     | 否     | 目标参与人 ID 列表。提取对应实体的 ID。支持用户（`ou_` 前缀）和群组（`oc_` 前缀）。多个 ID 使用英文逗号分隔 |
 | `--event-rrule <rrule>`         | 否     | 重复日程的重复性规则，规则设置方式参考rfc5545。**【⚠️注意：系统绝对不支持 COUNT，如需限制重复次数，必须转为 UNTIL】**。示例值："FREQ=DAILY;INTERVAL=1"                                              |
 | `--duration-minutes <min>`      | 否     | 会议时长（分钟）。优先使用用户显式指定的值，若未指定则尝试根据上下文推断，推断失败则不传                                        |
 | `--timezone <tz>`               | 否     | 对话中明确提及的预约日程所使用的时区（默认取用户设备时区，例如 `Asia/Shanghai`）                                |
--- a/skills/lark-calendar/references/lark-calendar-update.md
+++ b/skills/lark-calendar/references/lark-calendar-update.md
@@ -63,7 +63,6 @@ lark-cli calendar +update \
 - 只想增删参会人或会议室时，不需要同时传 `--summary`、`--start`、`--end` 等日程字段。
 - 只想修改标题、描述、时间或重复规则时，不需要同时传 `--add-attendee-ids` 或 `--remove-attendee-ids`。
 - 如需替换某个参与人、群组或会议室，使用 `--remove-attendee-ids <旧ID>` + `--add-attendee-ids <新ID>`。
- bot 可作为合法参会人添加，无需剔除。
 - 会议室是 resource attendee，必须使用 `omm_` ID 添加到参会人列表，不能脱离日程单独预定。
 - 更新重复性日程时，必须先确定操作范围（仅此次/全部/此次及后续），然后按 [重复性日程操作规范](lark-calendar-recurring.md) 执行。
 - 当同一次命令组合多个动作时，执行顺序为“日程字段 -> 移除参会人 -> 添加参会人”。若中途失败，不会自动回滚已成功步骤；错误信息会说明已完成的步骤。
--- a/skills/lark-slides/references/slides_xml_schema_definition.xml
+++ b/skills/lark-slides/references/slides_xml_schema_definition.xml
@@ -194,13 +194,14 @@
    <xs:simpleType name="FontSizeType">
        <xs:annotation>
            <xs:documentation>
-                字体大小, 浮点数, 范围 [1, 4000], 单位px
-                示例：10, 10.5, 12, 14, 16, 18, 20, 24, 28, 32 等
+                字体大小, 使用正整数, 单位px
+                示例：12, 14, 16, 18, 20, 24, 28, 32 等
            </xs:documentation>
        </xs:annotation>
-        <xs:restriction base="xs:double">
-            <xs:minInclusive value="1"/>
-            <xs:maxInclusive value="4000"/>
+        <xs:restriction base="xs:positiveInteger">
+            <xs:minInclusive value="6"/>
+            <xs:maxInclusive value="400"/>
+            <xs:pattern value="[0-9]+"/>
        </xs:restriction>
    </xs:simpleType>

@@ -210,52 +211,6 @@
        </xs:restriction>
    </xs:simpleType>

-    <xs:simpleType name="AutoStartAtType">
-        <xs:annotation>
-            <xs:documentation>
-                有序列表起始编号, 取值范围 [1, 32767]
-            </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:positiveInteger">
-            <xs:minInclusive value="1"/>
-            <xs:maxInclusive value="32767"/>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="BulletSizeType">
-        <xs:annotation>
-            <xs:documentation>
-                列表符号大小, 二选一:
-                - 百分比字符串（相对于文本字号）, 取值范围 25%-400%, 如 "100%"
-                - 绝对像素值, 取值范围 6-400, 如 "14"
-            </xs:documentation>
-        </xs:annotation>
-        <xs:union>
-            <xs:simpleType>
-                <xs:restriction base="xs:string">
-                    <xs:pattern value="(2[5-9]|[3-9][0-9]|[1-3][0-9]{2}|400)%"/>
-                </xs:restriction>
-            </xs:simpleType>
-            <xs:simpleType>
-                <xs:restriction base="xs:string">
-                    <xs:pattern value="[6-9]|[1-9][0-9]|[1-3][0-9]{2}|400"/>
-                </xs:restriction>
-            </xs:simpleType>
-        </xs:union>
-    </xs:simpleType>
-
-    <xs:simpleType name="BulletCharType">
-        <xs:annotation>
-            <xs:documentation>
-                自定义列表符号, 如 "★", "→", "✓", "◆", 也支持 emoji
-            </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:minLength value="1"/>
-            <xs:maxLength value="8"/>
-        </xs:restriction>
-    </xs:simpleType>
-
    <!-- 文本类型枚举 -->
    <xs:simpleType name="TextType">
        <xs:annotation>
@@ -277,35 +232,6 @@
        </xs:restriction>
    </xs:simpleType>

-    <!-- 动态文本字段类型枚举 -->
-    <xs:simpleType name="FieldType">
-        <xs:annotation>
-            <xs:documentation>
-                动态文本字段类型:
-                - slidenum: 当前幻灯片页码
-                - datetime: 默认日期时间格式
-                - datetime1-datetime13: 预定义日期时间格式
-            </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:enumeration value="slidenum"><xs:annotation><xs:documentation>当前幻灯片页码</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime"><xs:annotation><xs:documentation>浏览器默认日期格式, 例如 2026/7/14</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime1"><xs:annotation><xs:documentation>日期格式 M/D/YYYY, 例如 10/12/2007</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime2"><xs:annotation><xs:documentation>日期格式 dddd, MMMM D, YYYY, 例如 Friday, October 12, 2007</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime3"><xs:annotation><xs:documentation>日期格式 D MMMM YYYY, 例如 12 October 2007</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime4"><xs:annotation><xs:documentation>日期格式 MMMM D, YYYY, 例如 October 12, 2007</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime5"><xs:annotation><xs:documentation>日期格式 D-MMM-YY, 例如 12-Oct-07</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime6"><xs:annotation><xs:documentation>日期格式 MMMM YY, 例如 October 07</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime7"><xs:annotation><xs:documentation>日期格式 MMM-YY, 例如 Oct-07</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime8"><xs:annotation><xs:documentation>日期时间格式 M/D/YYYY h:mm A, 例如 10/12/2007 4:28 PM</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime9"><xs:annotation><xs:documentation>日期时间格式 M/D/YYYY h:mm:ss A, 例如 10/12/2007 4:28:34 PM</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime10"><xs:annotation><xs:documentation>时间格式 HH:mm, 例如 16:28</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime11"><xs:annotation><xs:documentation>时间格式 HH:mm:ss, 例如 16:28:34</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime12"><xs:annotation><xs:documentation>时间格式 h:mm A, 例如 4:28 PM</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="datetime13"><xs:annotation><xs:documentation>时间格式 h:mm:ss A, 例如 4:28:34 PM</xs:documentation></xs:annotation></xs:enumeration>
-        </xs:restriction>
-    </xs:simpleType>
-
    <!-- 文本对齐 -->
    <xs:simpleType name="TextAlignType">
        <xs:restriction base="xs:string">
@@ -855,64 +781,21 @@
        <xs:attribute name="heightScale" type="sml:ArrowScaleType" use="optional"/>
    </xs:complexType>

-    <!-- 裁剪方位枚举类型 -->
-    <xs:simpleType name="CropAnchorType">
-        <xs:annotation>
-            <xs:documentation>
-                裁剪方位枚举, 用于指定保留原图的哪个区域
-
-                - top: 保留顶部, 裁掉底部多余部分
-                - bottom: 保留底部, 裁掉顶部多余部分
-                - left: 保留左侧, 裁掉右侧多余部分
-                - right: 保留右侧, 裁掉左侧多余部分
-
-                居中场景不需要设置 anchor, 不设置 offset 即为默认居中裁剪
-            </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:enumeration value="top"><xs:annotation><xs:documentation>保留顶部, 裁掉底部多余部分</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="bottom"><xs:annotation><xs:documentation>保留底部, 裁掉顶部多余部分</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="left"><xs:annotation><xs:documentation>保留左侧, 裁掉右侧多余部分</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="right"><xs:annotation><xs:documentation>保留右侧, 裁掉左侧多余部分</xs:documentation></xs:annotation></xs:enumeration>
-        </xs:restriction>
-    </xs:simpleType>
-
    <!-- 裁剪类型定义 -->
    <xs:complexType name="CropType">
        <xs:annotation>
            <xs:documentation>
-                裁剪配置: 将原图裁剪到目标尺寸 (img 元素的 width × height)
+                裁剪配置: 原图填充到预裁剪区域，再根据offset裁出最终尺寸

                可选属性:
-                type: 裁剪形状, 默认 rect
-                anchor: 裁剪方位 (top/bottom/left/right), 参见 CropAnchorType
-                leftOffset / rightOffset / topOffset / bottomOffset: 四向偏移量 (px), 正值向内裁剪、负值向外扩展留白、0对齐边缘
-                presetHandlers: 控制点配置, 对应 ECMA 预设形状的控制点。单个或多个数字, 多个用逗号分隔。
-                示例: type="rect" 且 presetHandlers="60" 时为圆角矩形, 圆角半径 60px
+                type: 裁剪形状，默认rect
+                leftOffset, rightOffset, topOffset, bottomOffset: 边缘偏移量(px)。正值向内裁剪，负值向外扩展留白，0值对齐边缘
+                presetHandlers: 控制点配置，对应ECMA预设形状的控制点。单个或多个数字，多个用逗号分隔。示例: type="rect"且presetHandlers="60"时为圆角矩形，圆角半径60px

-                【推荐用法】使用 anchor 指定裁剪方位:
-                - 不设置 anchor 时: 默认按图片居中裁剪
-                - 设置 anchor 时: 按指定方位裁剪, 例如 anchor="top" 表示保留顶部、裁掉底部多余部分
-                - 使用 anchor 后, 不需要再设置 offset
-                - anchor 模式下原图按等比缩放后裁剪, 不会发生拉伸或压缩
-
-                【进阶用法】使用 offset 精细控制裁剪边界:
-                - 适用于用户在编辑器中手动调整裁剪、或从外部协议导入的场景
-                - 原图先填充到预裁剪区域, 再根据 offset 从四边裁出最终尺寸
-                - 注意: 若预裁剪尺寸与原图比例不一致会产生拉伸变形; 无法确定原图比例时, 不要指定 offset
-
-                【优先级】
-                如果同时设置了 anchor 和 offset, 以 anchor 为准, offset 被忽略
-
-                典型用法:
-                <crop/>                                      居中裁剪 (默认行为)
-                <crop anchor="top"/>                        保留顶部
-                <crop anchor="left"/>                       保留左侧
-                <crop type="rect" presetHandlers="60"/>     圆角矩形裁剪, 默认居中
+                说明: 指定offset时，若预裁剪尺寸与原图比例不一致会产生拉伸变形。无法确定原图比例时，不要指定offset
            </xs:documentation>
        </xs:annotation>
        <xs:attribute name="type" type="sml:ShapeType" use="optional" default="rect"/>
-        <xs:attribute name="anchor" type="sml:CropAnchorType" use="optional"/>
        <xs:attribute name="leftOffset" type="xs:double" use="optional"/>
        <xs:attribute name="rightOffset" type="xs:double" use="optional"/>
        <xs:attribute name="topOffset" type="xs:double" use="optional"/>
@@ -1159,10 +1042,6 @@
                - underline: content 级别是否下划线
                - list: content 级别列表类型 bullet/number
                - listStyle: content 级别列表样式
-                - bulletColor: 列表符号颜色（纯色）, 可选
-                - bulletSize: 列表符号大小, 可选, 百分比字符串（相对于文本字号, 取值范围 25%-400%）如 "100%", 或绝对像素值（取值范围 6-400）如 "14"
-                - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 作为后代段落的初始计数器, 子元素 &lt;p&gt;/&lt;ol&gt; 可通过自身 autoStartAt 重置
-                - bulletChar: 自定义列表符号字符, 可选, 如 "★", "→" 等, 设置后覆盖 listStyle 的符号
                - anchorCenter: 控制文本对齐方式, 优先级高于 textAlign
                - autoFit: 控制文本编辑溢出时处理策略
                - baseline: 上标/下标, 相较于文本基线的偏移量
@@ -1170,13 +1049,6 @@

                注意：如果content子元素不指定属性, 默认继承content的属性值, 如果局部子元素指定了属性, 则使用局部属性值

-                autoStartAt 运行计数器示例（显式指定重置, 未指定沿用前序计数器）:
-                &lt;content autoStartAt="5"&gt;
-                &lt;p list="number"&gt;A&lt;/p&gt;                    &lt;!-- A=5, 继承 content 初始值 --&gt;
-                &lt;p list="number" autoStartAt="10"&gt;B&lt;/p&gt;    &lt;!-- B=10, 本段显式重置 --&gt;
-                &lt;p list="number"&gt;C&lt;/p&gt;                    &lt;!-- C=11, 沿用前序计数器递增 --&gt;
-                &lt;/content&gt;
-
                子元素:
                - p: 段落元素
                - ul: 无序列表元素
@@ -1213,10 +1085,6 @@
            <xs:attribute name="underline" type="xs:boolean" />
            <xs:attribute name="list" type="sml:ListType" default="none"/>
            <xs:attribute name="listStyle" type="sml:ListStyleType" />
-            <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
-            <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
-            <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
-            <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
            <xs:attribute name="anchorCenter" type="xs:boolean" default="false" /> <!-- 控制竖排文字是否在垂直方向保持居中 -->
            <xs:attribute name="autoFit" type="sml:AutoFitType" default="no-auto-fit" />
            <xs:attribute name="wrap" type="xs:boolean" default="true" />
@@ -1228,9 +1096,9 @@
        <xs:annotation>
            <xs:documentation>
                段落容器, 支持富文本内容
-                可包含纯文本和内联格式元素(br/strong/em/u/span/del/a/shadow/outline/formula/field)
+                可包含纯文本和内联格式元素(br/strong/em/u/span/del/a/shadow/outline)
                内联元素嵌套：所有内联元素均可包含纯文本或其他内联元素，以实现复杂的格式组合
-                元素自嵌套：除a/formula元素外，其余内联元素支持自身嵌套，当shadow和outline自嵌套时，渲染效果遵循就近原则，以内层定义的样式为准
+                元素自嵌套：除a元素外，其余内联元素支持自身嵌套，当shadow和outline自嵌套时，渲染效果遵循就近原则，以内层定义的样式为准

                空格处理规则：
                - 文本内的连续空格会被合并为单个空格
@@ -1251,8 +1119,6 @@
                - a: 超链接
                - shadow: 文本阴影
                - outline: 文本轮廓
-                - formula: 科学公式（支持数学、物理等）
-                - field: 动态文本字段，元素内容作为不支持动态字段时的降级文本
                属性说明:
                - textAlign: 文本对齐方式
                - lineSpacing: 行间距
@@ -1261,10 +1127,6 @@
                - level: 段落级别, 取值范围 [1,10]
                - list: 列表类型(bullet/number)
                - listStyle: 列表样式
-                - bulletColor: 列表符号颜色（纯色）, 可选
-                - bulletSize: 列表符号大小, 可选, 百分比字符串（相对于文本字号, 取值范围 25%-400%）或绝对像素值（取值范围 6-400）
-                - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 显式指定时从当前段落起重置计数器, 未指定时沿用同一 content 内的前序计数器
-                - bulletChar: 自定义列表符号字符, 可选
                - marginLeft: 段落左侧缩进宽度
                - indent: 首行缩进宽度
            </xs:documentation>
@@ -1272,7 +1134,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1281,7 +1142,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
            <xs:attribute name="textAlign" type="sml:TextAlignType" />
            <xs:attribute name="lineSpacing" type="sml:LineSpacingType" default="multiple:1.5"/>
@@ -1291,10 +1151,6 @@
            <xs:attribute name="level" type="sml:LevelType" default="1"/>
            <xs:attribute name="list" type="sml:ListType" default="none"/>
            <xs:attribute name="listStyle" type="sml:ListStyleType"/>
-            <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
-            <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
-            <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
-            <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
            <xs:attribute name="marginLeft" type="xs:double" use="optional" />
            <xs:attribute name="indent" type="sml:NonNegativeDouble" use="optional"/>
        </xs:complexType>
@@ -1304,14 +1160,7 @@
    <!-- 无序列表 -->
    <xs:element name="ul">
        <xs:annotation>
-            <xs:documentation>
-                无序列表
-                属性说明:
-                - listStyle: 列表样式
-                - bulletColor: 列表符号颜色（纯色）, 可选
-                - bulletSize: 列表符号大小, 可选, 百分比字符串（相对于文本字号, 取值范围 25%-400%）或绝对像素值（取值范围 6-400）
-                - bulletChar: 自定义列表符号字符, 可选, 设置后覆盖 listStyle 的符号
-            </xs:documentation>
+            <xs:documentation>无序列表</xs:documentation>
        </xs:annotation>
        <xs:complexType>
            <xs:sequence>
@@ -1324,23 +1173,13 @@
                </xs:element>
            </xs:sequence>
            <xs:attribute name="listStyle" type="sml:UnorderedListStyle" default="circle-hollow-square"/>
-            <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
-            <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
-            <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
        </xs:complexType>
    </xs:element>

    <!-- 有序列表 -->
    <xs:element name="ol">
        <xs:annotation>
-            <xs:documentation>
-                有序列表, 可指定序号
-                属性说明:
-                - listStyle: 列表样式
-                - bulletColor: 列表符号颜色（纯色）, 可选
-                - bulletSize: 列表符号大小, 可选, 百分比字符串（相对于文本字号, 取值范围 25%-400%）或绝对像素值（取值范围 6-400）
-                - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 作用于本列表组的计数器初始值, 子元素 &lt;li@index&gt; 可覆盖单项编号
-            </xs:documentation>
+            <xs:documentation>有序列表, 可指定序号</xs:documentation>
        </xs:annotation>
        <xs:complexType>
            <xs:sequence>
@@ -1354,9 +1193,6 @@
                </xs:element>
            </xs:sequence>
            <xs:attribute name="listStyle" type="sml:OrderedListStyle" default="number-lower-alpha-lower-roman"/>
-            <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
-            <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
-            <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
        </xs:complexType>
    </xs:element>

@@ -1547,7 +1383,7 @@
                alpha: 不透明度[0, 1]

                可选子元素:
-                crop: 裁剪。无标签 / 空标签 / 仅设 anchor 时按等比缩放后裁剪到 width×height; anchor 指定保留方位 (top/bottom/left/right), 不设 anchor 即居中裁剪; offset 用于精细控制
+                crop: 裁剪。无标签或所有offset未设置时从左上角自适应裁到width×height
                reflection: 倒影。无标签代表无倒影,空标签代表使用默认样式
                shadow: 阴影。无标签代表无阴影,空标签代表使用默认样式
                border: 边框。无标签代表无边框,空标签代表使用默认样式(颜色: rgba(43, 47, 54, 1), 宽度: 2)
@@ -1664,7 +1500,7 @@
                td 子元素:
                - borderTop/borderRight/borderBottom/borderLeft: 单元格边框样式, 无border标签代表无边框, 空border标签代表使用默认样式(实线边框, 颜色为rgba(221, 222, 223, 1), 宽度为1)
                - fill: 单元格填充样式, 无fill标签代表不填充, 空fill标签代表使用默认样式(默认颜色填充, 颜色为rgba(255, 255, 255, 1))
-                - content: 单元格内容。内容默认不反向修改表格几何尺寸; 当内容高度大于当前行高时, 需要手动修改行高
+                - content: 单元格内容
            </xs:documentation>
        </xs:annotation>
        <xs:complexType>
@@ -1722,70 +1558,6 @@
        <xs:complexType/>
    </xs:element>

-    <xs:element name="field">
-        <xs:annotation>
-            <xs:documentation>
-                动态文本字段。
-                type 属性描述动态语义，元素内容是静态降级文本，可包含行内样式元素。
-            </xs:documentation>
-        </xs:annotation>
-        <xs:complexType mixed="true">
-            <xs:choice minOccurs="0" maxOccurs="unbounded">
-                <xs:element ref="sml:strong"/>
-                <xs:element ref="sml:em"/>
-                <xs:element ref="sml:u"/>
-                <xs:element ref="sml:span"/>
-                <xs:element ref="sml:del"/>
-                <xs:element ref="sml:a"/>
-                <xs:element ref="sml:shadow"/>
-                <xs:element ref="sml:outline"/>
-            </xs:choice>
-            <xs:attribute name="type" type="sml:FieldType" use="required"/>
-        </xs:complexType>
-    </xs:element>
-
-
-
-    <xs:element name="formula">
-        <xs:annotation>
-            <xs:documentation>
-                通用公式元素。
-                用于展示各类科学公式。
-
-                结构说明：
-                - 必须从支持的公式格式中选择且仅选择一种作为子元素。
-                - 当前版本支持格式：&lt;latex&gt;
-
-                示例：
-                - 基础公式：
-                &lt;formula&gt;
-                &lt;latex&gt;&lt;![CDATA[ E = mc^2 ]]&gt;&lt;/latex&gt;
-                &lt;/formula&gt;
-            </xs:documentation>
-        </xs:annotation>
-        <xs:complexType>
-            <xs:choice minOccurs="1" maxOccurs="1">
-                <xs:element name="latex">
-                    <xs:annotation>
-                        <xs:documentation>
-                            LaTeX 格式的公式内容。
-                            本元素包含的 LaTeX 字符串必须严格符合附件中定义的宏集范围。
-
-                            内容语法：
-                            - 语法范围：仅使用附件白名单中明确支持的宏。
-                            - 表达建议：优先使用基础运算符、分式(\frac)、根号(\sqrt)、矩阵(matrix)等标准数学环境。
-                            - 格式要求：必须使用 CDATA 包裹内容，且 CDATA 内部严禁进行 XML 转义（如 &amp;lt;, &amp;amp;）。
-                            - 空白处理：解析器将保留 CDATA 内的所有换行和缩进，建议利用此特性保持 LaTeX 源码的结构化和可读性。
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:simpleType>
-                        <xs:restriction base="xs:string"/>
-                    </xs:simpleType>
-                </xs:element>
-            </xs:choice>
-        </xs:complexType>
-    </xs:element>
-
    <xs:element name="strong">
        <xs:annotation>
            <xs:documentation>粗体/加重文本</xs:documentation>
@@ -1793,7 +1565,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1802,7 +1573,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
@@ -1820,7 +1590,6 @@
                <xs:extension base="sml:ShadowType">
                    <xs:choice minOccurs="0" maxOccurs="unbounded">
                        <xs:element ref="sml:br"/>
-                        <xs:element ref="sml:formula"/>
                        <xs:element ref="sml:strong"/>
                        <xs:element ref="sml:em"/>
                        <xs:element ref="sml:u"/>
@@ -1829,7 +1598,6 @@
                        <xs:element ref="sml:a"/>
                        <xs:element ref="sml:shadow"/>
                        <xs:element ref="sml:outline"/>
-                        <xs:element ref="sml:field"/>
                    </xs:choice>
                </xs:extension>
            </xs:complexContent>
@@ -1849,7 +1617,6 @@
                <xs:extension base="sml:OutlineType">
                    <xs:choice minOccurs="0" maxOccurs="unbounded">
                        <xs:element ref="sml:br"/>
-                        <xs:element ref="sml:formula"/>
                        <xs:element ref="sml:strong"/>
                        <xs:element ref="sml:em"/>
                        <xs:element ref="sml:u"/>
@@ -1858,7 +1625,6 @@
                        <xs:element ref="sml:a"/>
                        <xs:element ref="sml:shadow"/>
                        <xs:element ref="sml:outline"/>
-                        <xs:element ref="sml:field"/>
                    </xs:choice>
                </xs:extension>
            </xs:complexContent>
@@ -1872,7 +1638,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1881,7 +1646,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
@@ -1893,7 +1657,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1902,7 +1665,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
@@ -1914,7 +1676,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1923,7 +1684,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
@@ -1938,7 +1698,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1947,7 +1706,6 @@
                <xs:element ref="sml:a"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
            <xs:attribute name="color" type="sml:Color" use="optional"/>
            <xs:attribute name="backgroundColor" type="sml:Color" use="optional"/>
@@ -1971,7 +1729,6 @@
        <xs:complexType mixed="true">
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element ref="sml:br"/>
-                <xs:element ref="sml:formula"/>
                <xs:element ref="sml:strong"/>
                <xs:element ref="sml:em"/>
                <xs:element ref="sml:u"/>
@@ -1979,7 +1736,6 @@
                <xs:element ref="sml:del"/>
                <xs:element ref="sml:shadow"/>
                <xs:element ref="sml:outline"/>
-                <xs:element ref="sml:field"/>
            </xs:choice>
            <xs:attribute name="href" use="required">
                <xs:simpleType>
@@ -2067,116 +1823,36 @@
    <!-- 有序列表样式枚举 -->
    <xs:simpleType name="OrderedListStyle">
        <xs:annotation>
-            <xs:documentation>
-                有序列表样式
-
-                分为两类：
-                1. 复合样式（按层级循环不同格式）：如 number-lower-alpha-lower-roman 表示第1级用数字、第2级用小写字母、第3级用小写罗马，超过层级数后循环
-                2. 单一样式（所有层级使用同一格式，不循环）：以 PPTX 标准 scheme 命名，如 alpha-lc-paren-both 表示所有层级都用 (a)(b)(c) 格式
-            </xs:documentation>
+            <xs:documentation>有序列表样式</xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
-            <!-- 复合样式（按层级循环） -->
            <xs:enumeration value="number-lower-alpha-lower-roman"><xs:annotation><xs:documentation>1. a. i. - 数字/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="number-lower-alpha-lower-roman-paren"><xs:annotation><xs:documentation>1) a) i) - 带括号版本</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="hierarchical-number"><xs:annotation><xs:documentation>1. 1.1. 1.1.1. - 多级数字</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="upper-alpha-lower-alpha-lower-roman"><xs:annotation><xs:documentation>A. a. i. - 大写字母/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="upper-roman-upper-alpha-number"><xs:annotation><xs:documentation>I. A. 1. - 大写罗马/大写字母/数字</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="zero-padded-lower-alpha-lower-roman"><xs:annotation><xs:documentation>01. a. i. - 补零数字/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="circle-number"><xs:annotation><xs:documentation>圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
+            <xs:enumeration value="circle-number"><xs:annotation><xs:documentation> 圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="lower-alpha-paren"><xs:annotation><xs:documentation>a) b) c) - 小写字母带括号</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="lower-alpha-dot"><xs:annotation><xs:documentation>a. b. c. - 小写字母带点</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="chinese-formal"><xs:annotation><xs:documentation>一、二、三、 - 中文数字</xs:documentation></xs:annotation></xs:enumeration>
-
-            <!-- 单一样式（所有层级使用同一格式，不随层级循环） -->
-            <!-- 拉丁字母 Latin -->
-            <xs:enumeration value="alpha-lc-paren-both"><xs:annotation><xs:documentation>(a) (b) (c) - 小写字母带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="alpha-uc-paren-both"><xs:annotation><xs:documentation>(A) (B) (C) - 大写字母带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="alpha-lc-paren-r"><xs:annotation><xs:documentation>a) b) c) - 小写字母带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="alpha-uc-paren-r"><xs:annotation><xs:documentation>A) B) C) - 大写字母带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="alpha-lc-period"><xs:annotation><xs:documentation>a. b. c. - 小写字母带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="alpha-uc-period"><xs:annotation><xs:documentation>A. B. C. - 大写字母带点</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 阿拉伯数字 Arabic Numeral -->
-            <xs:enumeration value="arabic-paren-both"><xs:annotation><xs:documentation>(1) (2) (3) - 数字带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic-paren-r"><xs:annotation><xs:documentation>1) 2) 3) - 数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic-period"><xs:annotation><xs:documentation>1. 2. 3. - 数字带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic-plain"><xs:annotation><xs:documentation>1 2 3 - 纯数字</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic-db-period"><xs:annotation><xs:documentation>１．２．３．- 全角数字带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic-db-plain"><xs:annotation><xs:documentation>１ ２ ３ - 全角纯数字</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic1-minus"><xs:annotation><xs:documentation>أ- ب- ت- - 阿拉伯语字母(现代序)带后横线</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arabic2-minus"><xs:annotation><xs:documentation>-أ- -ب- -ج- - 阿拉伯语字母(Abjadi序)带双横线</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 罗马数字 Roman -->
-            <xs:enumeration value="roman-lc-paren-both"><xs:annotation><xs:documentation>(i) (ii) (iii) - 小写罗马带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="roman-uc-paren-both"><xs:annotation><xs:documentation>(I) (II) (III) - 大写罗马带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="roman-lc-paren-r"><xs:annotation><xs:documentation>i) ii) iii) - 小写罗马带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="roman-uc-paren-r"><xs:annotation><xs:documentation>I) II) III) - 大写罗马带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="roman-lc-period"><xs:annotation><xs:documentation>i. ii. iii. - 小写罗马带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="roman-uc-period"><xs:annotation><xs:documentation>I. II. III. - 大写罗马带点</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 圆圈数字 Circle -->
-            <xs:enumeration value="circle-num-db-plain"><xs:annotation><xs:documentation>① ② ③ - 圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="circle-num-wd-black-plain"><xs:annotation><xs:documentation>❶ ❷ ❸ - 实心圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="circle-num-wd-white-plain"><xs:annotation><xs:documentation>① ② ③ - 圆圈数字（1-10 循环, 字形与 circle-num-db-plain 相同但超过 10 后不降级为纯数字）</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 东亚 East Asian -->
-            <xs:enumeration value="ea1-chs-period"><xs:annotation><xs:documentation>一. 二. 三. - 简体中文带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-chs-plain"><xs:annotation><xs:documentation>一 二 三 - 简体中文</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-cht-period"><xs:annotation><xs:documentation>一. 二. 三. - 繁体中文带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-cht-plain"><xs:annotation><xs:documentation>一 二 三 - 繁体中文</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-jpn-chs-db-period"><xs:annotation><xs:documentation>一．二．三．- CJK汉字数字带全角点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-jpn-kor-plain"><xs:annotation><xs:documentation>一 二 三 - CJK汉字数字</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="ea1-jpn-kor-period"><xs:annotation><xs:documentation>一. 二. 三. - CJK汉字数字带半角点</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 希伯来语 Hebrew -->
-            <xs:enumeration value="hebrew2-minus"><xs:annotation><xs:documentation>א- ב- ג- - 希伯来字母带横线</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 泰语 Thai -->
-            <xs:enumeration value="thai-alpha-period"><xs:annotation><xs:documentation>ก. ข. ค. - 泰语字母带点（跳过 ฃ/ฅ/ฆ）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="thai-alpha-paren-r"><xs:annotation><xs:documentation>ก) ข) ค) - 泰语字母带右括号（跳过 ฃ/ฅ/ฆ）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="thai-alpha-paren-both"><xs:annotation><xs:documentation>(ก) (ข) (ค) - 泰语字母带双括号（跳过 ฃ/ฅ/ฆ）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="thai-num-period"><xs:annotation><xs:documentation>๑. ๒. ๓. - 泰语数字带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="thai-num-paren-r"><xs:annotation><xs:documentation>๑) ๒) ๓) - 泰语数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="thai-num-paren-both"><xs:annotation><xs:documentation>(๑) (๒) (๓) - 泰语数字带双括号</xs:documentation></xs:annotation></xs:enumeration>
-            <!-- 印地语 Hindi -->
-            <xs:enumeration value="hindi-alpha-period"><xs:annotation><xs:documentation>अ. आ. इ. - 印地语元音字母带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="hindi-num-period"><xs:annotation><xs:documentation>१. २. ३. - 印地语数字带点</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="hindi-num-paren-r"><xs:annotation><xs:documentation>१) २) ३) - 印地语数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="hindi-alpha1-period"><xs:annotation><xs:documentation>क. ख. ग. - 印地语辅音字母带点</xs:documentation></xs:annotation></xs:enumeration>
        </xs:restriction>
    </xs:simpleType>
    <!-- 无序列表样式枚举 -->
    <xs:simpleType name="UnorderedListStyle">
        <xs:annotation>
-            <xs:documentation>
-                无序列表样式
-
-                分为两类：
-                1. 复合样式（按层级循环不同图标）：如 circle-hollow-square 表示第1级实心圆、第2级空心圆、第3级实心方形，超过层级数后循环
-                2. 单一样式（所有层级使用同一图标，不循环）：以 pptx- 前缀命名，如 pptx-circle 表示所有层级都用 ● 实心圆
-            </xs:documentation>
+            <xs:documentation>无序列表样式</xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
-            <!-- 复合样式（按层级循环） -->
            <xs:enumeration value="circle-hollow-square"><xs:annotation><xs:documentation>实心圆 空心圆 实心方形</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="diamond-triangle-square"><xs:annotation><xs:documentation>菱形 三角形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
+            <xs:enumeration value="diamond-triangle-square"><xs:annotation><xs:documentation>棱形 三角形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="hollow-square-all"><xs:annotation><xs:documentation>空心方形 空心方形 空心方形</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="arrow-diamond-circle"><xs:annotation><xs:documentation>右箭头 实心菱形 实心圆形</xs:documentation></xs:annotation></xs:enumeration>
+            <xs:enumeration value="arrow-diamond-circle"><xs:annotation><xs:documentation>右箭头 实心棱形 实心圆形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="star-hollow-circle-square"><xs:annotation><xs:documentation>实心五角星 空心圆形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="triangle-hollow-circle-square"><xs:annotation><xs:documentation>三角形 空心圆形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="solid-square-all"><xs:annotation><xs:documentation>实心方形 实心方形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="solid-diamond-all"><xs:annotation><xs:documentation>实心菱形 实心菱形 实心菱形</xs:documentation></xs:annotation></xs:enumeration>
            <xs:enumeration value="check-all"><xs:annotation><xs:documentation>对勾 对勾 对勾</xs:documentation></xs:annotation></xs:enumeration>
-
-            <!-- 单一样式（所有层级使用同一图标，不随层级循环） -->
-            <xs:enumeration value="pptx-circle"><xs:annotation><xs:documentation>● 实心圆（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-square"><xs:annotation><xs:documentation>■ 方块（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-diamond"><xs:annotation><xs:documentation>◆ 菱形（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-square-empty"><xs:annotation><xs:documentation>□ 空心方框（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-check"><xs:annotation><xs:documentation>✓ 对勾（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-triangle"><xs:annotation><xs:documentation>► 右三角（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-bullet"><xs:annotation><xs:documentation>• 小圆点（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-
-            <xs:enumeration value="pptx-circle-empty"><xs:annotation><xs:documentation>○ 空心圆（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-diamond-empty"><xs:annotation><xs:documentation>◇ 空心菱形（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-arrow-right"><xs:annotation><xs:documentation>➔ 右箭头（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-star"><xs:annotation><xs:documentation>★ 星形（所有层级）</xs:documentation></xs:annotation></xs:enumeration>
-            <xs:enumeration value="pptx-square-shadow"><xs:annotation><xs:documentation>❑ 带右下阴影的 3D 方框（所有层级，对应 PPTX Wingdings 'q'）</xs:documentation></xs:annotation></xs:enumeration>
        </xs:restriction>
    </xs:simpleType>

@@ -2420,19 +2096,6 @@
        </xs:restriction>
    </xs:simpleType>

-    <xs:simpleType name="ChartGradientKindType">
-        <xs:annotation>
-            <xs:documentation>
-                图表渐变类型
-                可选值: linear(线性渐变) | radial(径向渐变)
-            </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:enumeration value="linear"/>
-            <xs:enumeration value="radial"/>
-        </xs:restriction>
-    </xs:simpleType>
-
    <xs:simpleType name="ChartRadarShapeType">
        <xs:annotation>
            <xs:documentation>
@@ -2554,7 +2217,6 @@

                属性:
                - textAlign: 文本对齐方式(left|center|right), 默认left
-                - fontFamily: 字体族名称，仅图表根级主标题/副标题支持；坐标轴标题不支持
                - fontSize: 字号大小
                - bold: 是否加粗
                - italic: 是否斜体, 默认false
@@ -2568,7 +2230,6 @@
        <xs:complexContent>
            <xs:extension base="sml:ChartFontStyleType">
                <xs:attribute name="textAlign" type="sml:ChartTextAlignType" use="optional" default="left"/>
-                <xs:attribute name="fontFamily" type="sml:FontFamilyType" use="optional"/>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
@@ -2637,10 +2298,10 @@
                图表背景配置

                属性:
-                - color: 背景颜色，省略时使用图表默认背景；无填充可使用透明色 rgba(0,0,0,0)
+                - color: 背景颜色, 默认透明 rgba(0,0,0,0)
            </xs:documentation>
        </xs:annotation>
-        <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
+        <xs:attribute name="color" type="sml:SolidColor" use="optional" default="rgb(255, 255, 255)"/>
    </xs:complexType>

    <xs:complexType name="ChartBorderType">
@@ -2650,7 +2311,7 @@

                属性:
                - color: 边框颜色，默认 rgb(222, 224, 227)
-                - width: 边框宽度(像素), 默认 1；无边框可设置为0，或不设置chartBorder
+                - width: 边框宽度(像素), 默认 1
                - style: 边框样式(solid|dashed|dotted), 默认 solid
                - radius: 圆角半径(像素), 默认 6
            </xs:documentation>
@@ -2661,61 +2322,6 @@
        <xs:attribute name="radius" type="xs:nonNegativeInteger" use="optional" />
    </xs:complexType>

-    <xs:complexType name="ChartGradientStopType">
-        <xs:annotation>
-            <xs:documentation>
-                图表渐变色标
-
-                属性:
-                - offset: 色标位置比例[0,1]
-                - color: 色标颜色
-                - opacity: 色标透明度[0,1]
-            </xs:documentation>
-        </xs:annotation>
-        <xs:attribute name="offset" type="sml:RatioType" use="required"/>
-        <xs:attribute name="color" type="sml:SolidColor" use="required"/>
-        <xs:attribute name="opacity" type="sml:RatioType" use="optional"/>
-    </xs:complexType>
-
-    <xs:complexType name="ChartGradientStopsType">
-        <xs:annotation>
-            <xs:documentation>
-                图表渐变色标列表，至少需要2个色标
-            </xs:documentation>
-        </xs:annotation>
-        <xs:sequence>
-            <xs:element name="stop" type="sml:ChartGradientStopType" minOccurs="2" maxOccurs="unbounded"/>
-        </xs:sequence>
-    </xs:complexType>
-
-    <xs:complexType name="ChartGradientType">
-        <xs:annotation>
-            <xs:documentation>
-                图表渐变配置
-
-                属性:
-                - type: 渐变类型(linear|radial)
-                - x0/y0/x1/y1: 线性渐变起止点坐标
-                - r0/r1: 径向渐变半径
-                - gradientMethod: 渐变算法/插值方式
-
-                子元素:
-                - stops: 渐变色标列表
-            </xs:documentation>
-        </xs:annotation>
-        <xs:sequence>
-            <xs:element name="stops" type="sml:ChartGradientStopsType" minOccurs="1"/>
-        </xs:sequence>
-        <xs:attribute name="type" type="sml:ChartGradientKindType" use="required"/>
-        <xs:attribute name="x0" type="xs:double" use="optional"/>
-        <xs:attribute name="y0" type="xs:double" use="optional"/>
-        <xs:attribute name="x1" type="xs:double" use="optional"/>
-        <xs:attribute name="y1" type="xs:double" use="optional"/>
-        <xs:attribute name="r0" type="xs:double" use="optional"/>
-        <xs:attribute name="r1" type="xs:double" use="optional"/>
-        <xs:attribute name="gradientMethod" type="xs:string" use="optional"/>
-    </xs:complexType>
-
    <xs:complexType name="ChartColorThemeType">
        <xs:annotation>
            <xs:documentation>
@@ -2825,16 +2431,12 @@
                - size: 该系列所有点的大小

                子元素:
-                - fillGradient: 该系列所有点的填充渐变(可选)
-                - strokeGradient: 该系列所有点的边框/描边渐变(可选)
                - chartPoint: 单个数据点配置(可选, 多个), 用于覆盖特定点的样式
            </xs:documentation>
        </xs:annotation>
        <xs:complexContent>
            <xs:extension base="sml:ChartGlobalPointsType">
                <xs:sequence>
-                    <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                    <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
                    <xs:element name="chartPoint" minOccurs="0" maxOccurs="unbounded">
                        <xs:complexType>
                            <xs:annotation>
@@ -2846,14 +2448,8 @@
                                    - color: 该点的颜色
                                    - shape: 该点的形状(circle|square|triangle|diamond|rect)
                                    - size: 该点的大小(像素)
-
-                                    子元素:
-                                    - fillGradient: 该点填充渐变(可选)
                                </xs:documentation>
                            </xs:annotation>
-                            <xs:sequence>
-                                <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                            </xs:sequence>
                            <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
                            <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
                            <xs:attribute name="shape" type="sml:ChartPointShapeType" use="optional"/>
@@ -2866,7 +2462,7 @@
    </xs:complexType>

    <!-- 线条配置 -->
-    <xs:complexType name="ChartGlobalLineType">
+    <xs:complexType name="ChartLineType">
        <xs:annotation>
            <xs:documentation>
                图表全局线条配置（第一层：所有系列的默认样式）
@@ -2883,27 +2479,8 @@
        <xs:attribute name="style" type="sml:ChartLineStyleType" use="optional" default="solid"/>
    </xs:complexType>

-    <xs:complexType name="ChartSeriesLineType">
-        <xs:annotation>
-            <xs:documentation>
-                图表系列线条配置（第二层：单系列统一配置）
-                继承ChartGlobalLineType的所有属性
-
-                子元素:
-                - strokeGradient: 该系列线条渐变(可选)
-            </xs:documentation>
-        </xs:annotation>
-        <xs:complexContent>
-            <xs:extension base="sml:ChartGlobalLineType">
-                <xs:sequence>
-                    <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                </xs:sequence>
-            </xs:extension>
-        </xs:complexContent>
-    </xs:complexType>
-
    <!-- 面积配置 -->
-    <xs:complexType name="ChartGlobalAreaType">
+    <xs:complexType name="ChartAreaType">
        <xs:annotation>
            <xs:documentation>
                图表全局面积配置（第一层：所有系列的默认填充样式）
@@ -2916,25 +2493,6 @@
        <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
    </xs:complexType>

-    <xs:complexType name="ChartSeriesAreaType">
-        <xs:annotation>
-            <xs:documentation>
-                图表系列面积配置（第二层：单系列统一配置）
-                继承ChartGlobalAreaType的所有属性
-
-                子元素:
-                - fillGradient: 该系列面积填充渐变(可选)
-            </xs:documentation>
-        </xs:annotation>
-        <xs:complexContent>
-            <xs:extension base="sml:ChartGlobalAreaType">
-                <xs:sequence>
-                    <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                </xs:sequence>
-            </xs:extension>
-        </xs:complexContent>
-    </xs:complexType>
-
    <!-- 柱子配置 -->
    <xs:complexType name="ChartGlobalBarsType">
        <xs:annotation>
@@ -2975,16 +2533,12 @@
                - borderStyle: 该系列所有柱子的边框样式

                子元素:
-                - fillGradient: 该系列所有柱子的填充渐变(可选)
-                - strokeGradient: 该系列所有柱子的边框渐变(可选)
                - chartBar: 单个柱子配置(可选, 多个), 用于覆盖特定柱子的样式
            </xs:documentation>
        </xs:annotation>
        <xs:complexContent>
            <xs:extension base="sml:ChartGlobalBarsType">
                <xs:sequence>
-                    <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                    <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
                    <xs:element name="chartBar" minOccurs="0" maxOccurs="unbounded">
                        <xs:complexType>
                            <xs:annotation>
@@ -2997,14 +2551,8 @@
                                    - borderColor: 该柱子的边框颜色
                                    - borderWidth: 该柱子的边框宽度(像素)
                                    - borderStyle: 该柱子的边框样式(solid|dashed|dotted)
-
-                                    子元素:
-                                    - fillGradient: 该柱子的填充渐变(可选)
                                </xs:documentation>
                            </xs:annotation>
-                            <xs:sequence>
-                                <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-                            </xs:sequence>
                            <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
                            <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
                            <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -3029,14 +2577,8 @@
                - offsetRadius: 扇区径向偏移比例[0,1], 用于突出显示
                - borderColor: 扇区边框颜色
                - color: 扇区填充颜色
-
-                子元素:
-                - fillGradient: 扇区填充渐变(可选)
            </xs:documentation>
        </xs:annotation>
-        <xs:sequence>
-            <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
-        </xs:sequence>
        <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
        <xs:attribute name="offsetRadius" type="sml:RatioType" use="optional"/>
        <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -3056,12 +2598,10 @@
                - startAngle: 起始角度[0,360), 控制第一个扇区的起始位置, 默认0

                子元素:
-                - fillGradient: 所有扇区的统一填充渐变(可选)
                - chartSector: 单个扇区配置(可选, 多个), 用于定制特定扇区
            </xs:documentation>
        </xs:annotation>
        <xs:sequence>
-            <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
            <xs:element name="chartSector" type="sml:ChartSectorType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
        <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -3108,8 +2648,8 @@
        </xs:annotation>
        <xs:sequence>
            <xs:element name="chartPoints" type="sml:ChartSeriesPointsType" minOccurs="0"/>
-            <xs:element name="chartLine" type="sml:ChartSeriesLineType" minOccurs="0"/>
-            <xs:element name="chartArea" type="sml:ChartSeriesAreaType" minOccurs="0"/>
+            <xs:element name="chartLine" type="sml:ChartLineType" minOccurs="0"/>
+            <xs:element name="chartArea" type="sml:ChartAreaType" minOccurs="0"/>
            <xs:element name="chartBars" type="sml:ChartSeriesBarsType" minOccurs="0"/>
            <xs:element name="chartSectors" type="sml:ChartSectorsType" minOccurs="0"/>
            <xs:element name="chartLabels" type="sml:ChartDataLabelsType" minOccurs="0"/>
@@ -3310,8 +2850,8 @@
        </xs:annotation>
        <xs:all>
            <xs:element name="chartPoints" type="sml:ChartGlobalPointsType" minOccurs="0"/>
-            <xs:element name="chartLines" type="sml:ChartGlobalLineType" minOccurs="0"/>
-            <xs:element name="chartAreas" type="sml:ChartGlobalAreaType" minOccurs="0"/>
+            <xs:element name="chartLines" type="sml:ChartLineType" minOccurs="0"/>
+            <xs:element name="chartAreas" type="sml:ChartAreaType" minOccurs="0"/>
            <xs:element name="chartBars" type="sml:ChartGlobalBarsType" minOccurs="0"/>
            <xs:element name="chartLabels" type="sml:ChartDataLabelsType" minOccurs="0"/>
            <xs:element name="chartSeriesList" type="sml:ChartSeriesListType" minOccurs="0"/>
--- a/skills/lark-slides/references/xml-schema-quick-ref.md
+++ b/skills/lark-slides/references/xml-schema-quick-ref.md
@@ -129,15 +129,6 @@ XSD 中的 `title`、`headline`、`sub-headline`、`body`、`caption` 主要出
 - `<a>`
 - `<shadow>`
 - `<outline>`
- `<formula>`
-
-公式写法：
-
-```xml
-<p>公式：<formula><latex><![CDATA[ E = mc^2 ]]></latex></formula></p>
-```
-
-`<formula>` 是内联元素；当前只支持一个 `<latex>` 子元素。LaTeX 内容必须放在 `CDATA` 中，且 `CDATA` 内不要写 XML 转义；宏只使用服务端支持范围内的写法，优先用基础运算符、`\frac`、`\sqrt`、`matrix`。

 示例：

@@ -321,36 +312,6 @@ XSD 中的 `title`、`headline`、`sub-headline`、`body`、`caption` 主要出

 `<chart>` 直接子元素必须有 `<chartPlotArea>`（绘图区）和 `<chartData>`（数据）；`<chartTitle>`、`<chartSubTitle>`、`<chartStyle>`、`<chartLegend>`、`<chartTooltip>` 可选，如果想不展示标题、副标题、图例或悬浮提示，省略相应元素标签即可。

-`<chartStyle>` 常用子元素：
-
- `<chartBackground>`：`color` 省略时由渲染端决定默认背景；需要完全透明请显式写 `color="rgba(0, 0, 0, 0)"`
- `<chartBorder>`：无边框可写 `width="0"`，或直接不写 `<chartBorder>` 元素
-
-#### 图表渐变 `<fillGradient>` / `<strokeGradient>`
-
-图表支持渐变填充/描边，`<fillGradient>` 用于面积、柱子、数据点、扇区填充，`<strokeGradient>` 用于线条、数据点边框、柱子边框。渐变只能挂在系列级或单元素级，不要挂在 `<chartPlot>` 全局层。
-
-可挂载位置：
-
- 系列级：`<chartBars>` / `<chartPoints>` 支持 `<fillGradient>` 与 `<strokeGradient>`；`<chartLine>` 只支持 `<strokeGradient>`；`<chartArea>` / `<chartSectors>` 只支持 `<fillGradient>`
- 单元素级：`<chartBar index="...">` / `<chartPoint index="...">` / `<chartSector index="...">` 只支持 `<fillGradient>`
- 全局级：`<chartPlot>` 下的 `<chartLines>` / `<chartAreas>` / `<chartBars>` / `<chartPoints>` 不支持渐变
-
-结构要点：`type` 必填，可为 `linear` 或 `radial`；`linear` 用 `x0` / `y0` / `x1` / `y1`，`radial` 用 `r0` / `r1`；`<stops>` 至少包含 2 个 `<stop>`，`offset` 与 `opacity` 取值均为 `[0, 1]`。
-
-```xml
-<chartSeries index="1">
-  <chartBars>
-    <fillGradient type="linear" x0="0" y0="0" x1="0" y1="1">
-      <stops>
-        <stop offset="0" color="rgb(28, 71, 120)"/>
-        <stop offset="1" color="rgb(28, 71, 120)" opacity="0.3"/>
-      </stops>
-    </fillGradient>
-  </chartBars>
-</chartSeries>
-```
-
 隐藏 `<chart>` 的图例只能通过不写或删除 `<chartLegend>` 实现，`<chartLegend>` 不支持 `position="none"`。

 详细用法见 [slides_xml_schema_definition.xml](slides_xml_schema_definition.xml)。
--- a/skills/lark-task/references/lark-task-create.md
+++ b/skills/lark-task/references/lark-task-create.md
@@ -24,12 +24,6 @@ lark-cli task +create \
 lark-cli task +create \
  --summary "Buy milk"

-# Create a milestone by passing an API field without a named flag
-lark-cli task +create \
-  --summary "Release v2.0" \
-  --due "2026-08-15" \
-  --data '{"is_milestone":true}'
-
 # Preview the API call without executing
 lark-cli task +create --summary "Test Task" --dry-run
 ```
@@ -45,11 +39,8 @@ lark-cli task +create --summary "Test Task" --dry-run
 | `--due <time>` | No | Due date. Supports ISO 8601, `YYYY-MM-DD`, relative time (e.g., `+2d`), or ms timestamp. `YYYY-MM-DD` and relative time will automatically set it as an all-day task. |
 | `--tasklist-id <id>` | No | The GUID of the tasklist, or a full AppLink URL (the CLI will automatically extract the `guid` parameter from the URL). |
 | `--idempotency-key <key>` | No | Client token to ensure idempotency of the request. |
-| `--data <json>` | No | JSON object merged into the task create request for API fields without dedicated flags, such as `{"is_milestone":true}`. Explicit named flags override same-named fields in this object. |
 | `--dry-run` | No | Preview the API call (JSON payload) without actually creating the task. |

-Use `lark-cli schema task.tasks.create` to confirm that an extra field is supported before passing it through `--data`. Prefer this shortcut over the raw `tasks create` command when `--data` can express the request. Do not assume that other shortcuts support `--data`; check each shortcut's `--help` output first.
-
 ## Workflow

 1. Confirm with the user: task summary, due date, assignee, and tasklist if necessary.
--- a/tests/cli_e2e/sheets/sheets_image_upload_dryrun_test.go
+++ b/tests/cli_e2e/sheets/sheets_image_upload_dryrun_test.go
@@ -17,10 +17,11 @@ import (
 // TestSheets_ImageUploadDryRunParentType pins the parent_type the sheets
 // image-upload shortcuts emit in --dry-run output for native vs. imported
 // "office" spreadsheets. For native tokens parent_type must be "sheet_image";
-// for tokens carrying the interleaved "OFL0X" marker the backend requires
-// "office_sheet_file". The covered entries — sheets +media-upload (backward),
-// sheets +cells-set-image, and sheets +float-image-create — are every
-// image-upload surface that the office/native split fans out to.
+// for tokens prefixed with "fake_office_" (the synthetic token an imported
+// office spreadsheet carries) the backend requires "office_sheet_file". The
+// three covered entries — sheets +media-upload (backward), sheets
+// +cells-set-image, and sheets +create-float-image — are every image-upload
+// surface that the office/native split fans out to.
 func TestSheets_ImageUploadDryRunParentType(t *testing.T) {
 	setSheetsDryRunEnv(t)

@@ -49,11 +50,11 @@ func TestSheets_ImageUploadDryRunParentType(t *testing.T) {
 			name: "media-upload office",
 			args: []string{
 				"sheets", "+media-upload",
-				"--spreadsheet-token", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
+				"--spreadsheet-token", "fake_office_dryrun",
 				"--file", "img.png",
 				"--dry-run",
 			},
-			token:          "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
+			token:          "fake_office_dryrun",
 			wantParentType: "office_sheet_file",
 		},
 		{
@@ -73,30 +74,13 @@ func TestSheets_ImageUploadDryRunParentType(t *testing.T) {
 			name: "cells-set-image office",
 			args: []string{
 				"sheets", "+cells-set-image",
-				"--spreadsheet-token", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
+				"--spreadsheet-token", "fake_office_dryrun",
 				"--sheet-id", "sheet1",
 				"--range", "A1",
 				"--image", "img.png",
 				"--dry-run",
 			},
-			token:          "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
-			wantParentType: "office_sheet_file",
-		},
-		{
-			name: "float-image-create office",
-			args: []string{
-				"sheets", "+float-image-create",
-				"--spreadsheet-token", "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
-				"--sheet-id", "sheet1",
-				"--image-name", "img.png",
-				"--image", "img.png",
-				"--position-row", "0",
-				"--position-col", "A",
-				"--size-width", "100",
-				"--size-height", "100",
-				"--dry-run",
-			},
-			token:          "aaaaOaaaaFaaaaLaaaa0aaaaXaaa",
+			token:          "fake_office_dryrun",
 			wantParentType: "office_sheet_file",
 		},
 	}
Author	SHA1	Message	Date
guokexin.02	b3ac5216ce	test: prepare node 24 release rehearsal	2026-07-28 20:25:55 +08:00
guokexin.02	39ea3e73b6	ci: upgrade release actions to node 24	2026-07-28 20:24:49 +08:00
guokexin.02	986a7f9c2d	test: remove beta release approval rehearsal	2026-07-28 20:11:58 +08:00
guokexin.02	be318cdd83	fix: publish verified npm tarball as local file	2026-07-28 19:53:26 +08:00
guokexin.02	d31666fc06	test: prepare beta release approval rehearsal	2026-07-28 19:35:00 +08:00
guokexin.02	681d3a1521	test: remove release rehearsal hooks	2026-07-28 19:08:51 +08:00
guokexin.02	6bb34823da	test: isolate GitHub publish rejection	2026-07-28 18:58:23 +08:00
guokexin.02	1b8085140a	test: target GitHub publish rejection	2026-07-28 18:49:11 +08:00
guokexin.02	94edc7462a	test: rehearse GitHub release publish rejection	2026-07-28 18:40:27 +08:00
guokexin.02	ec25e0df90	test: rehearse macOS code signature verification	2026-07-28 18:31:39 +08:00
guokexin.02	83dbf6eae0	test: rehearse release archive integrity	2026-07-28 18:21:37 +08:00
guokexin.02	bf40df896f	test: rehearse invalid notarization key	2026-07-28 18:14:18 +08:00
guokexin.02	b65f977d9c	test: rehearse invalid signing certificate	2026-07-28 18:06:53 +08:00
guokexin.02	cb9fc32717	test: rehearse invalid signing certificate	2026-07-28 17:52:23 +08:00
guokexin.02	ac0fb6d807	test: rehearse missing signing password	2026-07-28 17:50:00 +08:00
guokexin.02	fc2ddf2bf5	test: allow beta.1 preflight rehearsal	2026-07-28 17:46:14 +08:00
guokexin.02	51165e4f6a	test: add release preflight rehearsal	2026-07-28 17:27:25 +08:00
guokexin.02	cdf432cb13	ci: restore npm approval and add retry guidance	2026-07-28 16:51:31 +08:00
guokexin.02	5d18b4ebce	ci: simplify release trust checks	2026-07-28 15:59:52 +08:00
guokexin.02	e8a464e2d8	test: guard release workflow contract	2026-07-28 14:53:35 +08:00
guokexin.02	fd5f934d8d	ci: publish verified release candidates	2026-07-28 14:53:35 +08:00
guokexin.02	f5559fc888	ci: verify notarized macos release assets	2026-07-28 14:53:35 +08:00
guokexin.02	ae4282b214	ci: harden notarized release candidate build	2026-07-28 14:53:35 +08:00
guokexin.02	1a731f448d	ci: build notarized release candidates	2026-07-28 14:53:35 +08:00
guokexin.02	3b26fdd549	fix: harden release candidate validation	2026-07-28 14:53:35 +08:00
guokexin.02	9f7146026d	fix: bind artifact verification to candidate manifest	2026-07-28 14:53:35 +08:00
guokexin.02	44a4d96a8b	ci: validate release candidate integrity	2026-07-28 14:53:35 +08:00
guokexin.02	7b51b5d228	ci: configure macos notarization	2026-07-28 14:53:35 +08:00
guokexin.02	74f64972a4	ci: support beta release versions	2026-07-28 14:53:35 +08:00