Update app.json to change openBehavior to file:README; enhance git.md with structured sections and additional installation instructions; create new OMOOSPACE.md file

This commit is contained in:
2026-04-16 10:08:47 +08:00
parent 125adffe2a
commit 7ea78c779a
4 changed files with 70 additions and 19 deletions

View File

@@ -1,3 +1,5 @@
# Git 基操
## 工作流程
我们选择 Git 作为版本管理的工具(确保已经安装 Git 和 VS Code,详见[starter](starter.md)),工作流程主要是以下 4 点:
@@ -12,14 +14,11 @@ flowchart LR
文件改动 -- 提交 --> 个人分支 -- 合并请求 --> 主分支
```
通过上述流程,个人的本地改动被,有选择性地、有监督地被同步到项目主分支。
有效避免同步盘方案下,高频改动文件的冲突和 AI 无法参与的尴尬。这样,即释放了本地创作的限制,又规范了线上协作的管理,还解决了私有盘无法分享的问题。
有效避免同步盘方案下,高频改动文件的冲突和 AI 无法参与的尴尬。这样,即释放了本地创作的限制,又规范了线上协作的管理,还解决了私有盘无法分享的问题。接下来,我将详细描述操作步骤
接下来,我将详细描述操作步骤。
## 在自己的「个人分支」工作
### 在自己的「个人分支」工作
**1. 下载仓库(Repository)**
@@ -32,7 +31,7 @@ flowchart LR
**2. 创建自己的个人分支**
点左下角的`main`,点击`Create new branch...`,然后输入分支名`[your-name]/[do-something]`(比如`manan/dev`)
点左下角的`main`,点击 Create new branch...,然后输入分支名`[your-name]/[do-something]`(比如`manan/dev`)
![](assets/Pasted%20image%2020260415201156.png)
@@ -45,7 +44,7 @@ flowchart LR
> 或 Bash 执行 `git push -u origin [branch-name]`
## 通过「提交」来确认改动到「个人分支」
### 通过「提交」来确认改动到「个人分支」
**1. 有选择性地添加(Add)到暂存改动**
@@ -72,9 +71,9 @@ flowchart LR
> 或 Bash 执行 `git push`
这是工作中最常见的循环:一边工作,一边适时地 add > commit > push
这步是工作中最常用的:一边工作,一边适时地 Add > Commit > Push
## 接收其他人在「主分支」的改动
### 接收其他人在「主分支」的改动
当你在自己分支工作的时候,其他人也在不断更新「主分支」`main`。有时需要对齐一下,拉取(Pull)并合并(Merge)来自`main`的改动到你自己的分支。
@@ -86,9 +85,9 @@ flowchart LR
如果冲突,会进入`([branch-name]|MERGING)` 状态,详见 [解决冲突](#解决合并冲突)
## 通过「合并请求」来确认改动到「主分支」
### 通过「合并请求」来确认改动到「主分支」
合并请求(Pull Request,简称 PR)就是申请「个人分支」改动并入「主分支」
合并请求(Pull Request,PR)就是「个人分支」合并入「主分支」的申请
浏览器访问仓库主页,切换到「个人分支」,点击 New Pull Request 按钮(3)
@@ -104,9 +103,20 @@ PR 会加入队列,等待审核通过。通过后就会合并到`main`啦。
> 注意,如果在提 PR 后,如果你又更新了你的分支,不必再次提 PR
> 注意,在提 PR 前,一定要在本地执行[同步「主分支」的改动](#同步「主分支」的改动)(并 push 到了远程)
> 注意,在提 PR 前,一定要在本地执行[同步「主分支」的改动](#同步「主分支」的改动)(且 push 到了远程「个人分支」)
## 解决合并冲突
## 一些小问题
### 多设备编辑同一分支
首先不推荐这样做,但是为了一个设备,新加分支也很没必要。但如果由一个人操作这些设备,比如个人的 macbook、iphone 共同编辑,只要严格遵守下面两条:
- 在 A 设备编辑,Commit 后立即 Push,以保证远程仓库及时更新
- 切换到 B 设备,在编辑前立即 Pull,以保证 B 设备及时更新
> 为什么不用 icloud?因为这样可以实现部分同步,能适应复杂的文件夹,打开也更快。
### 解决合并冲突
解决完冲突后,继续