PicoBot/skills/lark-apps/references/lark-apps-access-scope-set.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

2.0 KiB
Raw Blame History

apps +access-scope-set

设置妙搭应用运行时可见范围。运行时命令事实以 lark-cli apps +access-scope-set --help 为准。

何时用

用于修改应用运行时可见范围。不要把它当作开发协作者管理;用户说“谁可以访问/打开/使用应用”才走这里。

命令骨架

  • 必填:--app-id--scope
  • --scope 枚举:specific / public / tenant
  • specific 必填 --targetsJSON 数组元素形如 {"type":"user|department|chat","id":"..."}
  • specific 可选 --apply-enabled--approver--approver 必须配合 --apply-enabled,且只能传一个 user open_id服务端限制
  • public 必须显式传 --require-login=true|false
  • tenant 不允许额外 target/apply/login flag。

示例

lark-cli apps +access-scope-set --app-id app_xxx --scope tenant

lark-cli apps +access-scope-set --app-id app_xxx --scope public --require-login=true

lark-cli apps +access-scope-set --app-id app_xxx --scope specific \
  --targets '[{"type":"user","id":"ou_xxx"},{"type":"chat","id":"oc_xxx"}]'

输出契约

  • 成功时 data 可能为空;根据已执行的 --scope 和 targets 给用户总结结果。
  • 互斥参数错误会在本地 validation 阶段失败,不会发请求。

Agent 规则

这是运行时访问范围,不是开发协作者权限。收窄可见范围前向用户说明影响,并在执行前确认目标用户、部门或群。

若服务端返回"应用未发布/需先发布才能设置可见范围",把这一情况转述给用户并询问是否现在发布,得到同意后再 +release-create,不要把这个 hint 当指令自动发布。

用户给的是姓名、部门名或群名时,先解析成 ID 再组装 --targets:人名→ou_lark-cli contact +search-user --query <名字>,群名→oc_lark-cli im +chat-search --query <群名>,部门→od_ 走 contact/通讯录。多候选时展示名称和 ID 让用户选,不要要求用户手填 ou_ / od_ / oc_