@lark-apaas/coding-miaoda-sandbox-skills 0.1.0-dev.61b3ece → 0.1.0-dev.6f4e4bc

package/shared/lark-cli/lark-sheets/scripts/lark_sheet_range.py

@@ -0,0 +1,176 @@
+# Copyright (c) 2026 Lark Technologies Pte. Ltd.
+# SPDX-License-Identifier: MIT
+"""Range and coordinate helpers for Lark Sheet scripts."""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+
+CELL_RE = re.compile(r"^\$?([A-Za-z]+)\$?([1-9][0-9]*)$")
+ROW_RE = re.compile(r"^\$?([1-9][0-9]*)$")
+COLUMN_RE = re.compile(r"^\$?([A-Za-z]+)$")
+
+
+@dataclass(frozen=True)
+class RangeBounds:
+    start_row: int
+    start_col: int
+    end_row: int
+    end_col: int
+
+    @property
+    def row_count(self) -> int:
+        return self.end_row - self.start_row + 1
+
+    @property
+    def col_count(self) -> int:
+        return self.end_col - self.start_col + 1
+
+
+def col_to_index(col: str) -> int:
+    value = 0
+    for char in col.strip().upper():
+        if not ("A" <= char <= "Z"):
+            raise ValueError(f"Invalid column: {col}")
+        value = value * 26 + (ord(char) - ord("A") + 1)
+    if value <= 0:
+        raise ValueError(f"Invalid column: {col}")
+    return value
+
+
+def index_to_col(index: int) -> str:
+    if index < 1:
+        raise ValueError(f"Column index must be >= 1: {index}")
+    chars = []
+    n = index
+    while n:
+        n, rem = divmod(n - 1, 26)
+        chars.append(chr(ord("A") + rem))
+    return "".join(reversed(chars))
+
+
+def parse_cell(cell_ref: str) -> tuple[int, int]:
+    match = CELL_RE.match(cell_ref.strip())
+    if not match:
+        raise ValueError(f"Invalid cell reference: {cell_ref}")
+    col, row = match.groups()
+    return int(row), col_to_index(col)
+
+
+def _parse_endpoint(endpoint: str) -> tuple[str, int, int] | tuple[str, int]:
+    cell = CELL_RE.match(endpoint)
+    if cell:
+        col, row = cell.groups()
+        return "cell", int(row), col_to_index(col)
+    row = ROW_RE.match(endpoint)
+    if row:
+        return "row", int(row.group(1))
+    column = COLUMN_RE.match(endpoint)
+    if column:
+        return "column", col_to_index(column.group(1))
+    raise ValueError(f"Invalid A1 range endpoint: {endpoint}")
+
+
+def parse_range(
+    range_ref: str,
+    *,
+    max_row: int | None = None,
+    max_col: int | None = None,
+) -> RangeBounds:
+    """Parse the A1 range forms accepted by ``+csv-get``.
+
+    Open-ended forms need the caller's actual returned grid dimensions. This
+    keeps generated ranges finite without guessing a spreadsheet-wide limit.
+    """
+    ref = range_ref.strip()
+    if "!" in ref:
+        _, ref = ref.rsplit("!", 1)
+    if not ref:
+        raise ValueError(f"Invalid A1 range: {range_ref}")
+    parts = ref.split(":")
+    if len(parts) > 2:
+        raise ValueError(f"Invalid A1 range: {range_ref}")
+    start = _parse_endpoint(parts[0])
+    end = _parse_endpoint(parts[-1])
+
+    if len(parts) == 1:
+        if start[0] != "cell":
+            raise ValueError(f"A1 range must include a cell or ':' separator: {range_ref}")
+        _, row, col = start
+        return RangeBounds(row, col, row, col)
+
+    if start[0] == end[0] == "cell":
+        _, start_row, start_col = start
+        _, end_row, end_col = end
+    elif start[0] == end[0] == "row":
+        _, start_row = start
+        _, end_row = end
+        start_col = 1
+        if max_col is None:
+            raise ValueError(f"Range needs a maximum column: {range_ref}")
+        end_col = max_col
+    elif start[0] == end[0] == "column":
+        _, start_col = start
+        _, end_col = end
+        start_row = 1
+        if max_row is None:
+            raise ValueError(f"Range needs a maximum row: {range_ref}")
+        end_row = max_row
+    elif start[0] == "cell" and end[0] == "column":
+        _, start_row, start_col = start
+        _, end_col = end
+        if max_row is None:
+            raise ValueError(f"Range needs a maximum row: {range_ref}")
+        end_row = max(start_row, max_row)
+    elif start[0] == "cell" and end[0] == "row":
+        _, start_row, start_col = start
+        _, end_row = end
+        if max_col is None:
+            raise ValueError(f"Range needs a maximum column: {range_ref}")
+        end_col = max(start_col, max_col)
+    else:
+        raise ValueError(f"Invalid A1 range: {range_ref}")
+    return RangeBounds(min(start_row, end_row), min(start_col, end_col), max(start_row, end_row), max(start_col, end_col))
+
+
+def format_cell(row: int, col: int) -> str:
+    if row < 1:
+        raise ValueError(f"Row must be >= 1: {row}")
+    return f"{index_to_col(col)}{row}"
+
+
+def format_range(start_row: int, start_col: int, end_row: int, end_col: int) -> str:
+    bounds = RangeBounds(
+        min(start_row, end_row),
+        min(start_col, end_col),
+        max(start_row, end_row),
+        max(start_col, end_col),
+    )
+    start = format_cell(bounds.start_row, bounds.start_col)
+    end = format_cell(bounds.end_row, bounds.end_col)
+    return start if start == end else f"{start}:{end}"
+
+
+def iter_cells(bounds: RangeBounds):
+    for row in range(bounds.start_row, bounds.end_row + 1):
+        for col in range(bounds.start_col, bounds.end_col + 1):
+            yield row, col
+
+
+def ranges_intersect(a: RangeBounds, b: RangeBounds) -> bool:
+    return not (
+        a.end_row < b.start_row
+        or b.end_row < a.start_row
+        or a.end_col < b.start_col
+        or b.end_col < a.start_col
+    )
+
+
+def range_union(a: RangeBounds, b: RangeBounds) -> RangeBounds:
+    return RangeBounds(
+        min(a.start_row, b.start_row),
+        min(a.start_col, b.start_col),
+        max(a.end_row, b.end_row),
+        max(a.end_col, b.end_col),
+    )

package/shared/lark-cli/lark-sheets/scripts/lark_sheet_read_cli.py

@@ -0,0 +1,184 @@
+# Copyright (c) 2026 Lark Technologies Pte. Ltd.
+# SPDX-License-Identifier: MIT
+"""Read-only Lark Sheet subset wrapper for the helper scripts."""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from typing import Any
+
+
+class LarkCliError(RuntimeError):
+    def __init__(self, message: str, *, cmd: list[str] | None = None):
+        super().__init__(message)
+        self.cmd = cmd or []
+
+
+def add_spreadsheet_args(
+    parser,
+    *,
+    require_sheet: bool = False,
+    allow_sheet: bool = True,
+) -> None:
+    spreadsheet = parser.add_mutually_exclusive_group(required=True)
+    spreadsheet.add_argument("--url")
+    spreadsheet.add_argument("--spreadsheet-token")
+    if allow_sheet:
+        sheet = parser.add_mutually_exclusive_group(required=require_sheet)
+        sheet.add_argument("--sheet-id")
+        sheet.add_argument("--sheet-name")
+
+
+def _append_flag(cmd: list[str], name: str, value: Any) -> None:
+    flag = f"--{name.replace('_', '-')}"
+    if value is None:
+        return
+    if isinstance(value, bool):
+        cmd.append(flag if value else f"{flag}=false")
+        return
+    cmd.extend([flag, str(value)])
+
+
+def run_sheets(
+    shortcut: str,
+    *,
+    url: str | None = None,
+    spreadsheet_token: str | None = None,
+    sheet_id: str | None = None,
+    sheet_name: str | None = None,
+    flags: dict[str, Any] | None = None,
+    timeout: int = 60,
+) -> dict[str, Any]:
+    if bool(url) == bool(spreadsheet_token):
+        raise LarkCliError("Pass exactly one of --url or --spreadsheet-token")
+    if sheet_id and sheet_name:
+        raise LarkCliError("Pass only one of --sheet-id or --sheet-name")
+
+    cmd = ["lark-cli", "sheets", shortcut]
+    _append_flag(cmd, "url", url)
+    _append_flag(cmd, "spreadsheet_token", spreadsheet_token)
+    _append_flag(cmd, "sheet_id", sheet_id)
+    _append_flag(cmd, "sheet_name", sheet_name)
+    for key, value in (flags or {}).items():
+        _append_flag(cmd, key, value)
+
+    try:
+        completed = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+            check=False,
+        )
+    except FileNotFoundError as exc:
+        raise LarkCliError("lark-cli not found", cmd=cmd) from exc
+    except subprocess.TimeoutExpired as exc:
+        raise LarkCliError(f"lark-cli timed out after {timeout}s", cmd=cmd) from exc
+
+    if completed.returncode != 0:
+        detail = (completed.stderr or completed.stdout or "").strip()
+        raise LarkCliError(detail or f"lark-cli exited with {completed.returncode}", cmd=cmd)
+
+    try:
+        envelope = json.loads(completed.stdout)
+    except json.JSONDecodeError as exc:
+        snippet = completed.stdout[:500].replace("\n", "\\n")
+        raise LarkCliError(f"lark-cli stdout was not JSON: {snippet}", cmd=cmd) from exc
+
+    if isinstance(envelope, dict) and envelope.get("ok") is False:
+        raise LarkCliError(json.dumps(envelope, ensure_ascii=False), cmd=cmd)
+    if not isinstance(envelope, dict):
+        raise LarkCliError("lark-cli returned a non-object JSON payload", cmd=cmd)
+    return envelope
+
+
+def envelope_data(envelope: dict[str, Any]) -> dict[str, Any]:
+    data = envelope.get("data")
+    return data if isinstance(data, dict) else envelope
+
+
+def emit_success(action: str, data: dict[str, Any], warnings: list[str] | None = None) -> None:
+    print(
+        json.dumps(
+            {
+                "ok": True,
+                "engine": "lark",
+                "action": action,
+                "data": data,
+                "warnings": warnings or [],
+            },
+            ensure_ascii=False,
+            indent=2,
+        )
+    )
+
+
+def emit_error(action: str, message: str, warnings: list[str] | None = None) -> None:
+    print(
+        json.dumps(
+            {
+                "ok": False,
+                "engine": "lark",
+                "action": action,
+                "error": message,
+                "warnings": warnings or [],
+            },
+            ensure_ascii=False,
+            indent=2,
+        )
+    )
+    sys.exit(1)
+
+
+def sheet_title(sheet: dict[str, Any]) -> str:
+    return str(sheet.get("title") or sheet.get("sheet_name") or sheet.get("name") or "")
+
+
+def sheet_identifier(sheet: dict[str, Any]) -> str:
+    return str(sheet.get("sheet_id") or sheet.get("id") or "")
+
+
+def sheet_locator(sheet: dict[str, Any]) -> dict[str, str]:
+    sid = sheet_identifier(sheet)
+    if sid:
+        return {"sheet_id": sid}
+    title = sheet_title(sheet)
+    if title:
+        return {"sheet_name": title}
+    return {}
+
+
+def extract_sheets(workbook_data: dict[str, Any]) -> list[dict[str, Any]]:
+    sheets = workbook_data.get("sheets")
+    if isinstance(sheets, list):
+        return [sheet for sheet in sheets if isinstance(sheet, dict)]
+    workbook = workbook_data.get("workbook")
+    if isinstance(workbook, dict) and isinstance(workbook.get("sheets"), list):
+        return [sheet for sheet in workbook["sheets"] if isinstance(sheet, dict)]
+    return []
+
+
+def resolve_target_sheets(
+    workbook_data: dict[str, Any],
+    *,
+    sheet_id: str | None = None,
+    sheet_name: str | None = None,
+    require_one: bool = False,
+) -> list[dict[str, Any]]:
+    sheets = extract_sheets(workbook_data)
+    if sheet_id:
+        matches = [sheet for sheet in sheets if sheet_identifier(sheet) == sheet_id]
+    elif sheet_name:
+        matches = [sheet for sheet in sheets if sheet_title(sheet) == sheet_name]
+    else:
+        matches = sheets
+
+    if require_one:
+        if len(matches) == 1:
+            return matches
+        if not matches:
+            raise LarkCliError("No matching sheet found")
+        raise LarkCliError("Multiple sheets matched; pass --sheet-id or --sheet-name")
+    return matches

package/shared/lark-cli/lark-sheets/scripts/sheets_df.py

@@ -19,11 +19,29 @@ import pandas as pd
 
 def df_to_sheet(df, name, formats=None):
     """Pack one DataFrame into one entry of a `+table-put --sheets` payload."""
+    packed = json.loads(df.to_json(orient="split", date_format="iso"))
+    # The protocol requires string column names. pandas keeps integer labels
+    # (e.g. the default RangeIndex columns 0/1/2) as JSON numbers, while the
+    # dtypes dict keys get stringified during JSON serialization — the CLI
+    # then rejects `columns` ("cannot unmarshal number into … type string")
+    # and the dtype lookup would miss anyway. Stringify every key once, and
+    # refuse to continue when that conversion silently merges two columns.
+    normalized_labels = [str(c) for c in df.columns]
+    columns = [str(c) for c in packed["columns"]]
+    if normalized_labels != columns:
+        columns = normalized_labels
+    if len(set(columns)) != len(columns):
+        raise ValueError(
+            "column labels collide after str() conversion; "
+            "rename the DataFrame columns before packing"
+        )
+    packed["columns"] = columns
+    dtype_values = list(df.dtypes)
     return {
         "name": name,
-        **json.loads(df.to_json(orient="split", date_format="iso")),
-        "dtypes": df.dtypes.astype(str).to_dict(),
-        **({"formats": formats} if formats else {}),
+        **packed,
+        "dtypes": {key: str(dtype) for key, dtype in zip(columns, dtype_values)},
+        **({"formats": {str(k): v for k, v in formats.items()}} if formats else {}),
     }
 
 

package/shared/lark-cli/lark-slides/README.md

@@ -10,8 +10,7 @@
 
 - 读取整份演示文稿的完整 XML（`slides xml_presentations get`）。
 - 按 `slide_id` 读取单页 XML，可指定历史版本（`slides xml_presentation.slide get`）。
-- 列出历史版本、查询回滚任务状态（`slides xml_presentation.history list` /
-  `revert_status`）。
+- 列出历史版本、查询回滚任务状态（`slides +history-list` / `+history-revert-status`）。
 
 ## 核心概念
 
@@ -31,6 +30,9 @@ wiki 节点，确认 `node.obj_type == "slides"`，再用 `node.obj_token` 作
 lark-cli wiki spaces get_node --as user --params '{"token":"wiki_token"}'
 ```
 
+例外：`slides +history-list` / `+history-revert-status` 的 `--presentation` 可以直接接收
+wiki URL（自动解析，要求该节点是幻灯片），不需要先手动查询节点。
+
 ### 资源关系
 
 ```text
@@ -51,6 +53,18 @@ Slides (演示文稿)
 - 读取单页 XML：[`lark-slides-xml-presentation-slide-get.md`](references/lark-slides-xml-presentation-slide-get.md)
 - 历史版本与回滚状态：[`lark-slides-history.md`](references/lark-slides-history.md)
 
+## 快捷命令（沙箱内仅以下两个可用，均只读）
+
+- `+history-list` — 分页列出历史版本，返回 `entries[]`（含 `history_version_id`、`revision_id`、`edit_time`）
+- `+history-revert-status` — 按 `task_id` 查询回滚任务状态（`status`、`failed_block_tokens`）
+
+`--presentation` 接收 `xml_presentation_id`、`/slides/` URL 或可解析为幻灯片的 `/wiki/` URL。
+
+```bash
+lark-cli slides +history-list --as user --presentation "<slides_url_or_token>" --page-size 20
+lark-cli slides +history-revert-status --as user --presentation "<slides_url_or_token>" --task-id "<task_id>"
+```
+
 ## API（沙箱内仅以下原生 API 调用可用）
 
 本沙箱内**仅**以下原生 `<service> <resource> <method>` 组合可用（全部只读），不要再自行拼其它
@@ -71,16 +85,3 @@ lark-cli slides xml_presentations get --as user --params '{"xml_presentation_id"
 ```bash
 lark-cli slides xml_presentation.slide get --as user --params '{"xml_presentation_id":"<id>","slide_id":"<slide_id>","revision_id":-1}'
 ```
-
-### xml_presentation.history
-
-- `list` — 分页列出历史版本，返回 `entries[]`（含 `history_version_id`、`revision_id`、`edit_time`）
-- `revert_status` — 查询回滚任务状态（`status`、`failed_block_tokens`）
-
-```bash
-lark-cli slides xml_presentation.history list --as user --params '<json_params>'
-lark-cli slides xml_presentation.history revert_status --as user --params '<json_params>'
-```
-
-> 参数结构以 `lark-cli schema slides.xml_presentation.history.list` /
-> `lark-cli schema slides.xml_presentation.history.revert_status` 输出为准。

package/shared/lark-cli/lark-slides/references/lark-slides-history.md

@@ -1,14 +1,14 @@
 # slides history（历史版本与回滚任务状态）
 
 用于查看 Slides XML presentation 的历史版本列表，以及查询回滚任务的执行状态。这两个都是
-**只读**接口：
+**只读**快捷命令：
 
-- `slides xml_presentation.history list` — 分页列出历史版本。
-- `slides xml_presentation.history revert_status` — 按 `task_id` 查询回滚任务状态。
+- `slides +history-list` — 分页列出历史版本。
+- `slides +history-revert-status` — 按 `task_id` 查询回滚任务状态。
 
-> 发起回滚本身（`xml_presentation.history revert`）是高风险写操作，不在本沙箱的只读推荐入口
-> 内。用户临时要求回滚而撞到 exit 10 时，按上层 lark-cli SKILL.md 的高风险写审批协议处理。`revert_status`
-> 只负责查询一个已存在的回滚任务的执行进度。
+> 发起回滚本身（`+history-revert`）是高风险写操作，不在本沙箱的只读推荐入口
+> 内。用户临时要求回滚而撞到 exit 10 时，按上层 lark-cli SKILL.md 的高风险写审批协议处理。
+> `+history-revert-status` 只负责查询一个已存在的回滚任务的执行进度。
 
 `entries[].edit_time` 是 UTC RFC3339 时间字符串（例如 `2026-06-22T12:24:45Z`）。按时间匹配时先将
 其解析为时间值，再比较先后关系或时间差。
@@ -17,23 +17,35 @@
 
 ```bash
 # 列出历史版本
-lark-cli slides xml_presentation.history list --as user --params '<json_params>'
+lark-cli slides +history-list --as user --presentation "<slides_url_or_token>" --page-size 20
+
+# 翻页
+lark-cli slides +history-list --as user --presentation "<slides_url_or_token>" --page-size 20 --page-token "<page_token>"
 
 # 查询回滚任务状态
-lark-cli slides xml_presentation.history revert_status --as user --params '<json_params>'
+lark-cli slides +history-revert-status --as user --presentation "<slides_url_or_token>" --task-id "<task_id>"
 ```
 
-> 参数结构以 schema 为准，调用前先查看：
-> `lark-cli schema slides.xml_presentation.history.list` /
-> `lark-cli schema slides.xml_presentation.history.revert_status`。
-> `list` 支持分页：无 `page_token` 取第一页，`has_more=true` 时用上一页返回的 `page_token`
-> 继续翻页；`revert_status` 需要提供发起回滚时返回的 `task_id`。
+## 参数
+
+| 命令 | 参数 | 必填 | 说明 |
+|-|-|-|-|
+| `+history-list` | `--presentation` | 是 | `xml_presentation_id`、Slides URL，或可解析为 Slides 的 wiki URL |
+| `+history-list` | `--page-size` | 否 | 返回条数，范围 `1-20`，默认 `20` |
+| `+history-list` | `--page-token` | 否 | 上一页返回的 `page_token` |
+| `+history-revert-status` | `--presentation` | 是 | 同一个演示文稿 |
+| `+history-revert-status` | `--task-id` | 是 | 发起回滚时返回的 `task_id` |
+
+> `+history-list` 支持分页：无 `--page-token` 取第一页，`has_more=true` 时用上一页返回的
+> `page_token` 继续翻页。`--presentation` 收到 wiki URL 时自动解析出真实演示文稿 ID，
+> 无需先手动查询 wiki 节点。
 
 ## 按 revision_id 或时间点定位版本
 
-当用户说"看看昨天下午 3 点的版本""revision_id=42 是哪一条"这类需求时，用 `list` 定位：
+当用户说"看看昨天下午 3 点的版本""revision_id=42 是哪一条"这类需求时，用 `+history-list` 定位：
 
-1. 执行 `list` 获取第一页历史记录；只有 `has_more=true` 且还需要更多候选时才继续翻页。
+1. 执行 `slides +history-list --presentation <presentation>` 获取第一页历史记录；只有
+   `has_more=true` 且还需要更多候选时才继续传 `--page-token` 翻页。
 2. 如果用户给出 `revision_id`：先筛选当前页中 `entries[].revision_id == 用户给出的 revision_id`。
    如果未命中且 `has_more=true`，继续拉下一页；如果已经命中候选，最多额外再拉一页，补齐同一个
    `revision_id` 可能跨页出现的相邻 `history_version_id`。若用户同时给出目标时间，在候选里选择
@@ -56,17 +68,17 @@ lark-cli slides xml_presentation.history revert_status --as user --params '<json
 已发起的回滚任务返回 `task_id` 与 `status` 后：
 
 1. 如果 `status` 不是 `running`，不再调用状态接口。
-2. 如果 `status` 是 `running`，等待响应中的 `poll_after_ms` 后调用 `revert_status`；`poll_after_ms`
-   缺失、为 `0` 或非法时，默认等待 10 秒。
+2. 如果 `status` 是 `running`，等待响应中的 `poll_after_ms` 后调用 `+history-revert-status`；
+   `poll_after_ms` 缺失、为 `0` 或非法时，默认等待 10 秒。
 3. 状态查询返回 `running` 时继续轮询；返回 `done`、`partial_failed` 或 `failed` 时停止。
 4. 默认最多轮询 5 分钟。达到上限后停止轮询，向用户说明任务仍在运行并返回 `task_id`，不得将其
    描述为回滚失败。
-5. 状态查询出现临时错误时，按相同间隔最多连续重试 3 次；只重试 `revert_status`。
+5. 状态查询出现临时错误时，按相同间隔最多连续重试 3 次；只重试 `+history-revert-status`。
 6. `partial_failed` 或 `failed` 时展示 `failed_block_tokens`。
 
 ## 返回值要点
 
-`list` 返回：
+`+history-list` 返回：
 
 ```json
 {
@@ -86,7 +98,7 @@ lark-cli slides xml_presentation.history revert_status --as user --params '<json
 }
 ```
 
-`revert_status` 返回：
+`+history-revert-status` 返回：
 
 ```json
 {

package/shared/lark-cli/lark-slides/references/lark-slides-xml-presentation-slide-get.md

@@ -48,7 +48,7 @@ lark-cli slides xml_presentation.slide get --as user --params '{
 ```bash
 lark-cli slides xml_presentation.slide get --as user \
   --params '{"xml_presentation_id":"slides_example_presentation_id","slide_id":"slide_example_id"}' \
-  | jq -r '.data.slide.content'
+  --jq '.data.slide.content'
 ```
 
 ### 读指定历史版本
@@ -99,7 +99,7 @@ lark-cli slides xml_presentation.slide get --as user --params '{
    ```bash
    lark-cli slides xml_presentation.slide get --as user \
      --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}" \
-     | jq -r '.data.slide.content' | grep -oE 'id="[^"]+"' | sed 's/id="//;s/"//'
+     --jq '.data.slide.content' | grep -oE 'id="[^"]+"' | sed 's/id="//;s/"//'
    ```
 
 ## 相关命令

package/shared/lark-cli/lark-whiteboard/README.md

@@ -21,8 +21,7 @@
 |---|---|
 | 查看画板内容 / 导出图片 | [`+export --output-type preview`](references/lark-whiteboard-export.md) |
 | 导出 SVG 矢量图 | [`+export --output-type svg`](references/lark-whiteboard-export.md) |
-| 获取画板的 Mermaid/PlantUML 代码 | [`+export --output-type source`](references/lark-whiteboard-export.md) |
-| 检查画板是否由代码绘制 | [`+export --output-type source`](references/lark-whiteboard-export.md) |
+| 提取画板的 Mermaid/PlantUML 源码 | [`+export --output-type source`](references/lark-whiteboard-export.md) |
 | 导出画板原始节点结构（OpenAPI 原生格式） | [`+export --output-type raw`](references/lark-whiteboard-export.md) |
 
 ## 获取画板 token

package/shared/lark-cli/lark-wiki/references/lark-wiki-node-get.md

@@ -54,6 +54,17 @@ lark-cli wiki +node-get \
 - Prefer this shortcut over the raw `wiki spaces get_node` API for every node-resolution step, including when you only need `space_id` — read it from `data.space_id` (the raw API nests it under `data.node.space_id`).
 - A truncated `node_token` is rejected outright rather than sent as a lookup. If the token you were given looks cut off, ask for the full URL or token instead of retrying variants.
 
+## Terminal business errors
+
+These HTTP 200 responses carry a non-zero business code and are not retryable with the same input:
+
+| Code | Meaning | Required action |
+|------|---------|-----------------|
+| `131006` | The current user identity lacks access to the Wiki node or space | This is resource access, not app scope authorization. Do not retry the same request or switch identity as trial and error; ask the node owner or wiki administrator to grant read access, or use an accessible resource |
+| `131012` | The Wiki node has been deleted | Do not retry the same node token; rediscover the node or ask for a current Wiki link |
+| `131013` | The resource token is invalid | Do not retry or switch identity; correct the URL/token |
+| `131014` | The document is not mounted in Wiki | Stop Wiki resolution; use the corresponding docs/sheets/base/drive command, or provide a Wiki URL/node_token |
+
 ## Required Scope
 
 `wiki:node:retrieve`

package/shared/lark-cli/lark-wiki/references/lark-wiki-node-list.md

@@ -87,7 +87,7 @@ lark-cli wiki +node-list --space-id 6946843325487912356 --parent-node-token wikc
 - `--space-id my_library` is a per-user alias and only valid with `--as user`.
 - `--space-id` is a numeric wiki `space_id`. Do not pass a wiki URL, wiki node token, document token, or title. Use `lark-cli wiki +space-list --as user` to discover it.
 - `--parent-node-token` must resolve to a wiki node token. If you have a docx/sheet/base/file URL, first run `lark-cli wiki +node-get --node-token <url> --as user` and use the returned `node_token`.
-- Treat `invalid_parameters` (`space_id is not int`, `invalid page_token`), `not_found` (`node not found by parent node token`), and `permission_denied` as terminal for the current arguments. Fix the argument or permission before retrying.
+- Treat `invalid_parameters` (`space_id is not int`, `invalid page_token`), `not_found` (`node not found by parent node token`), and `permission_denied` as terminal for the current arguments. For `131006 permission_denied`, the user identity lacks access to the target space or parent node; this is resource access, not app scope authorization. Do not retry the same request or switch identity as trial and error. Ask the resource owner or wiki administrator to grant read access, or use an accessible resource.
 - For `rate_limit`, stop immediate retries and retry later with exponential backoff or a smaller `--page-limit`.
 
 ## Required Scope

package/shared/dev-channel-probe/SKILL.md

@@ -1,40 +0,0 @@
----
-name: dev-channel-probe
-description: "[临时] sandbox-skills dev 发布通道连通性探针，验证完即删。不面向用户，已标 control-by-feature-ab 因此不会被 agent 加载。"
-control-by-feature-ab: true
----
-
-# dev 通道探针
-
-验证 sandbox-skills 的 dev 发布通道端到端连通：
-
-```
-develop 分支合入
-  → publish-sandbox-skills-dev.sh 自动发 <base>-dev.<sha> + dist-tag dev
-  → BOE 沙箱（FORCE_FRAMEWORK_ENVIRONMENT=boe 且未配 TCC tgz-key）走 @dev
-  → miaoda skills sync 落盘
-```
-
-## 判据
-
-沙箱内出现以下路径即通道连通：
-
-```
-.agent/skills/dev-channel-probe/SKILL.md
-```
-
-本 skill 放在 `shared/` 层，会分发到 miaoda / miaoda-modern / miaoda-design
-三条业务线，因此顺带验证 shared 层的分发路径。
-
-## 为什么不会被 agent 加载
-
-frontmatter 标了 `control-by-feature-ab: true`。该标记的语义是「只有出现在 TCC
-`feature=skill` 的 `skillNames` 白名单里才加载」，而本 skill 不会被加进任何白名单，
-所以它只存在于磁盘、不进 agent 上下文、不消耗 token。
-
-未标该字段的 skill 是无条件加载的 —— 这也是本探针刻意标它的原因。
-
-## 清理
-
-验证通过后**尽快删除本目录**。它不提供任何用户价值，长期留存只会让 skill 列表
-和后续排查变噪。