PicoBot/skills/lark-apps/references/lark-apps-git-credential.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

1.8 KiB
Raw Blame History

apps Git credential

妙搭 Git 凭证用于本地原生 git clone/pull/push。运行时命令事实以 lark-cli apps +git-credential-init --help+git-credential-list --help+git-credential-remove --help 为准。

命令

lark-cli apps +git-credential-init --app-id app_xxx
lark-cli apps +git-credential-list
lark-cli apps +git-credential-remove --app-id app_xxx

输出契约

  • +git-credential-init 成功后读取 data.repository_url;不要展示或保存其中的凭据细节,只用于下一步 git clone
  • +git-credential-list 返回本地记录和状态;可用来判断是否需要重新 init。
  • +git-credential-remove 只清本地配置;成功后告知不会删除云端应用或仓库。

行为规则

  • +git-credential-init 返回 repository_url,并配置 URL-scoped Git credential helper。后续 clone/pull/push 使用原生 git。
  • +git-credential-list 列出本地已配置的妙搭 Git 凭证,不需要 --app-id
  • +git-credential-remove 只移除本地凭证/helper不删除云端应用或仓库。
  • 看到 Repository URL 后继续:
git clone <repository_url>
cd <repo>
git checkout sprint/default

Agent 规则

  • 不要手动打印、保存或拼接 token。
  • clone、pull、push、diff、log 等代码仓库操作都使用原生 git;不存在 apps +pull / apps +push / apps code +read 这类代码读写 shortcut不要臆造。
  • 不要 push/force-push mainmain 是发布态快照,由 apps +release-create 成功后服务端推进,直推/force-push 会被服务端护栏拒绝。
  • Git 认证失败、本地凭证损坏或 helper 缺失时,重新执行 +git-credential-init --app-id <id> 覆盖本地配置;不要让用户复制 token 到 remote URL。