ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
37 lines
2.1 KiB
Markdown
37 lines
2.1 KiB
Markdown
# apps +init
|
||
|
||
`+init` 初始化妙搭应用的代码（clone 仓库、scaffold/同步源码、拉取本地环境变量）。运行时命令事实以 `lark-cli apps +init --help` 为准。
|
||
|
||
## 何时用
|
||
|
||
用于把妙搭全栈应用源码拉到本地并准备开发环境。用户只是要云端 Agent 生成应用时，不要初始化本地仓库。
|
||
|
||
## 命令骨架
|
||
|
||
- 必填：`--app-id`。
|
||
- 可选：`--dir`，clone 目标目录；省略时默认 `./<app-id>`。
|
||
- 可选：`--template`，空仓库脚手架模板；省略时当前回退 `nestjs-react-fullstack`。
|
||
- 固定 checkout 分支：`sprint/default`。
|
||
- `+init` 会初始化 Git 凭证、clone 仓库、切到工作分支并生成/同步本地项目。
|
||
|
||
## 示例
|
||
|
||
```bash
|
||
lark-cli apps +init --app-id app_xxx --dir ./my-app
|
||
lark-cli apps +init --app-id app_xxx --dir /absolute/path/my-app --template nestjs-react-fullstack
|
||
lark-cli apps +init --app-id app_xxx --dir ./my-app --dry-run
|
||
```
|
||
|
||
## 输出契约
|
||
|
||
- 真跑时 stdout 是 JSON envelope；stderr 会有 `->` / `→` 进度行。成功读 stdout，失败解析 stderr 末尾的 JSON 错误。
|
||
- 成功普通初始化读取 `data.clone_path`、`branch`、`committed`、`pushed`；`repository_url` 已脱敏，不要当凭据使用。
|
||
- `scaffold=already_initialized` 表示目录已初始化：跳过 clone/scaffold/commit，但仍会执行一次 env-pull 刷新本地环境变量（输出含 `env_pulled`，成功时含 `env_file`，失败时含 `env_pull_error` 且退出码仍为 0）；此时通常没有 `repository_url` / `branch`。
|
||
- `--dry-run` 只打印计划，不执行 git / npx；若输出含 `dir_error`，真跑前先让用户换目录。
|
||
|
||
## Agent 规则
|
||
|
||
- 目标目录必须不存在、为空目录，或已含 `.spark/meta.json` 的已初始化仓库。
|
||
- 目标目录已含 `.spark/meta.json` 时，`+init` 会跳过 clone/scaffold，但仍执行一次 env-pull 刷新本地环境变量；告知用户“仓库已初始化，本地环境变量已刷新，可直接开发”，不要误报失败或重复 clone。
|
||
- `+init` 输出没有必要原样复述；告诉用户 clone path、分支和下一步即可。
|