Airtag

询问用户

"你已经有一个飞书多维表格用来存物品位置数据吗？如果有，请发链接给我；如果没有，我帮你创建一个。"

选项 A：用户提供已有表链接

1. 从链接中提取 base_token（格式：https://xxx.feishu.cn/base/BASE_TOKEN 或 https://xxx.feishu.cn/wiki/WIKI_TOKEN）
2. 如果是 wiki 链接，先用 lark-cli wiki spaces get_node 解析真实 token
3. 用 lark-cli base +table-list --base-token <token> --as user 列出表，让用户选择或确认目标表
4. 用 lark-cli base +field-list --base-token <token> --table-id <id> --as user 检查字段是否匹配
5. 如果字段不完整，补建缺失字段

选项 B：自动创建新表

# Step 1: 创建 Base
lark-cli base +base-create --name "AirTag 物品位置" --as user

# Step 2: 从返回结果中获取 base_token，创建数据表和字段
lark-cli base +table-create \
  --base-token <base_token> \
  --name "物品位置" \
  --fields '[{"name":"物品名称","type":"text"},{"name":"位置","type":"text"},{"name":"备注","type":"text"},{"name":"记录时间","type":"date"}]' \
  --as user

保存配置

将 base_token 和 table_id 写入全局配置 ~/.config/airtag/config.json（目录不存在则创建）：

{
  "base_token": "app_xxx",
  "table_id": "tbl_xxx"
}

2. 日常使用：记录物品位置

用户说出物品和位置后，用以下命令写入记录：

lark-cli base +record-upsert \
  --base-token <base_token> \
  --table-id <table_id> \
  --json '{"物品名称":"<物品>","位置":"<位置>","备注":"<备注>","记录时间":"<YYYY-MM-DD HH:mm:ss>"}' \
  --as user

解析用户输入的规则：

• "护照在书房抽屉里" → 物品名称=护照, 位置=书房抽屉
• "把钥匙放到玄关了" → 物品名称=钥匙, 位置=玄关
• 如果用户没提到备注，备注字段留空字符串
• 记录时间使用当前时间

3. 查找物品

用户问"XX在哪"时：

lark-cli base +record-list \
  --base-token <base_token> \
  --table-id <table_id> \
  --as user

从返回结果中搜索匹配的物品，返回最近一条位置记录给用户。

4. 更新物品位置

如果用户说物品换了位置，先查找该物品最近的 record_id，然后更新：

lark-cli base +record-upsert \
  --base-token <base_token> \
  --table-id <table_id> \
  --record-id <record_id> \
  --json '{"位置":"<新位置>","记录时间":"<当前时间>"}' \
  --as user

5. 删除物品

用户说"删掉XX"或"不记录XX了"时，先查找该物品的 record_id，然后删除：

lark-cli base +record-delete \
  --base-token <base_token> \
  --table-id <table_id> \
  --record-id <record_id> \
  --as user

删除前需向用户确认。

6. 列出所有物品

lark-cli base +record-list \
  --base-token <base_token> \
  --table-id <table_id> \
  --as user

以表格形式展示所有物品及其位置。

常见错误处理

权限