| name | lx-smartsheet |
| version | 1.1.0 |
| description | 乐享智能表格管理。当用户需要创建或读取智能表格、修改 schema、增删改查记录或管理视图时使用。触发词：智能表格、smartsheet、字段、记录、视图、CREATE TABLE、ALTER TABLE |
| metadata | {"requires":{"bins":["lx"]}} |
智能表格
前置条件：lx CLI 已配置并登录。除创建阶段外，操作时始终保留页面 entry_id 和智能表格 smartsheet_id。
统一命名空间
服务端新增接口虽然暂时归在 knowledge.block category，CLI 已统一提升到 lx smartsheet：
| 命令 | 用途 |
|---|
lx smartsheet create | 用 CREATE TABLE DDL 创建智能表格 |
lx smartsheet fetch | 获取 schema、视图和摘要 |
lx smartsheet list-records | 分页读取记录 |
lx smartsheet update-records | 批量部分更新记录，单次最多 50 条 |
lx smartsheet update-schema | 用 ALTER TABLE DDL 修改 schema |
lx smartsheet update-view | 更新视图 |
同一 namespace 还提供字段、记录和视图的详细操作，包括 create-field、create-records、delete-records、list-fields、list-views 等。原有 lx block smartsheet-* 命令暂时保留兼容。
工作流
1. 发现并读取服务端 block-view-dsl Resource
2. list 或 fetch，确认 entry_id、smartsheet_id 和当前 schema
3. 在统一的 lx smartsheet namespace 中选择高层或详细命令
4. 用 -d JSON 传递 schema、statements、records、field 或 view
5. 写入后重新 fetch/list-records 验证
不要根据通用 SQL 或旧示例猜测智能表格语法。创建/修改 schema、写记录或更新视图前先执行：
lx mcp resource list --format json
lx mcp resource read lexiang://docs/block-view-dsl/v0
若列表返回了更新版本的 block-view-dsl URI，应读取并使用列表中的当前 URI。
具体命令与示例见 smartsheet.md。
安全规则
- 不猜测字段 ID、记录 ID 或视图 ID；先 fetch/list 获取。
- 对象和数组参数统一使用
-d '<JSON>'，避免被 CLI 拆成字符串数组。
- 更新记录是部分更新，只提交目标字段；单次最多 50 条。
- 修改 schema 前先 fetch；
update-schema 提交完整 ALTER TABLE 语句。
- 页面正文中的智能表格块布局属于
lx-block，表格数据/schema 属于本 skill。
--help 中出现 Resource preflight 时，必须先执行其中的读取命令。
