diff options
| author | 魏曹先生 <1992414357@qq.com> | 2026-01-10 18:01:52 +0800 |
|---|---|---|
| committer | 魏曹先生 <1992414357@qq.com> | 2026-01-10 18:01:52 +0800 |
| commit | ea3e324c82d4c76638d53534a8f8d8d32fb8c5e0 (patch) | |
| tree | cfd4276686e104531fa894d06d436da36cc2583c /README_zh_CN.md | |
| parent | a09d7538191846a0c0e86fcb87638e0bec182587 (diff) | |
Update README with new branding and detailed documentation
Diffstat (limited to 'README_zh_CN.md')
| -rw-r--r-- | README_zh_CN.md | 157 |
1 files changed, 130 insertions, 27 deletions
diff --git a/README_zh_CN.md b/README_zh_CN.md index 6f7a495..de96c33 100644 --- a/README_zh_CN.md +++ b/README_zh_CN.md @@ -1,13 +1,12 @@ <p align="center"> <a href="https://github.com/JustEnoughVCS/VersionControl"> - <img alt="JustEnoughVCS" src="docs/images/Header_Large.png" width="100%"> + <img alt="JustEnoughVCS" src="docs/Resources/Visual/Yizi_Icon.png" width="20%"> </a> </p> - <h1 align="center">JustEnoughVCS</h1> <p align="center"> - 让版本控制比呼吸还简单! + 多文件结构的集中式版本控制 </p> @@ -17,58 +16,152 @@ <img src="https://img.shields.io/badge/Release-Not%20Available-lightgrey?style=for-the-badge"> </p> - ## 写在开头 -如果您正在寻找一款让您团队成员可以轻松上手的版本控制,那么我们非常推荐您尝试一下。这款版本控制正如其名字讲述的那样:“刚好够用”,不产生过多的心智负担。 - +> [!Warning] +> +> `JustEnoughVCS` 还在稳步开发,目前并无发布的计划 +> +> 如果您对该项目感兴趣,欢迎直接[联系](#支持)我们! +> [!NOTE] +> +> `JustEnoughVCS` 为**资产内容管理**而设计,并**不适合作为源代码版本控制**,多结构、无分支的设计理念决定了其无法胜任任何强结构依赖的项目。 -## 架构 +## 介绍 -`JustEnoughVCS` 是一款 **集中式** 的版本控制,分为 **客户端** 和 **服务端** 两个部分。 +`JustEnoughVCS` 是一款 **集中式版本控制系统**,它专注于为 **以二进制文件为主的资产管理场景** 提供简洁、自由的工作流。它不将文件路径视为文件的身份,而是分离成 **唯一身份(文件是什么)** 和 **路径映射(文件在哪)** 的关系。 -> [!NOTE] -> -> 该版本控制解决的是二进制资产的结构和版本管理的问题,不适合管理代码和文本。 +> [!TIP] > -> 在代码和文本领域,有极为成熟且被认可的其他 SCM 系统。 +> 若您希望直接安装,可以点击[此处](#安装) + + + +### 一、结构表系统 (Struct Sheet System) + +**个人结构表** + +`JustEnoughVCS` 允许每名成员都建立自己的 **结构表**,它是 **该成员对于自己可见文件的理解**,它不会也不需要被其他成员知道长什么样。每名成员都在自己的 **结构表** 内工作,在需要的时候将部分 **文件可见性** 分享给他人即可。 + +**参考结构表** + +在 `JustEnoughVCS` 的上游仓库(Upstream Vault)中,会由 **仓库管理员** 维护一份公开可见的 **参考结构表** (Reference Sheet),所有成员都可以查询到 **文件在参考结构表中的位置**,以方便建立对文件的理解。 + +<p align="center"> + <a href="https://github.com/JustEnoughVCS/VersionControl"> + <img alt="JustEnoughVCS" src="docs/Resources/Visual/Image2.png" width="100%"> + </a> + <p align="center"> + 参考结构表用于锚定文件的权威命名 + </p> +</p> + + + +### 二、串行编辑 + +`JustEnoughVCS` 采用 **串行编辑模型**,从根本上消除合并冲突。我们的权限原则是:**可见即可读,持有则可写**。 + +当您持有文件时,您拥有独占的编辑权。其他成员可以看到当前版本,但无法同时编辑。编辑完成后,您提交的新版本立即可供所有人获取。 +串行编辑确保只有一个“真相来源”。如果有成员在未持有权限或基于过时版本进行编辑,系统会明确标记这些修改为**无效编辑**,也就是说,它们不会被意外提交或覆盖有效版本。 +不过不用担心,在 `JustEnoughVCS` 的前端([命令行、桌面端](#安装))中,提供了清晰可见视图,用于确认文件状态。 -## 多文件结构 -它鼓励用户以习惯的方式去放置、管理自己的资产,并按需将文件的 **可见性** 分享给团队内的其他成员。正因每位成员都有自己的结构,也不必担心文件的移动会影响他人。 +### 三、架构 +`JustEnoughVCS` 为集中式版本控制,分为 **服务端** 和 **客户端**,本地工作区仅为用于记录修改和更新的文件拷贝。 -## 串行编辑 +**上游库 (Upstream Vault)** -同时,`JustEnoughVCS` 以文件为粒度进行权限管理,在同一时刻内,只有一名成员持有该文件,即拥有文件的 **编辑权**。在更新文件版本后,其他成员可在下次状态检查时发现新版本,并决定是否将最新版本更新到本地。 +上游库记录了如下信息: +1. 上游库配置信息 +2. 成员注册信息及公钥 +3. 结构表 + 1. 当前持有者 + 2. 映射关系 +4. 文件元数据 + 1. 当前持有者 + 2. 版本顺序 +5. 文件历史版本存储**(全量、未压缩)** -## 拒绝模糊映射 -在实际文件结构与记录的文件结构有 **偏差** 时,`JustEnoughVCS` 将会禁止您追踪文件的版本,您需要解释清楚您本地的结构变动才能继续。 +**工作区 (Local Workspace)** + +工作区记录了如下信息: + +1. 工作区配置信息 +2. 上游库元数据的本地缓存 +3. 结构表的本地缓存:用来对比本地和上游差异 +4. 本地结构表:用来分析工作区变化 +5. 物理文件 + +<p align="center"> + <a href="https://github.com/JustEnoughVCS/VersionControl"> + <img alt="JustEnoughVCS" src="docs/Resources/Visual/Image1.png" width="100%"> + </a> + <p align="center"> + Vault 和 Workspace 的关系 + </p> +</p> + + + +## 安装 + +该仓库为 `JustEnoughVCS` 的核心库,不提供任何交互功能。 + +请前往对应的仓库以下载或构建 `JustEnoughVCS` 的前端: + +- [命令行前端](https://github.com/JustEnoughVCS/CommandLine) +- [桌面端](https://github.com/JustEnoughVCS/Desktop) **开发中** ## 路线图 -### 核心库 +- [ ] 核心功能 -- [ ] 增量的文件更新和存储 -- [ ] 多参照表 + - [x] 表管理 + - [x] 追踪 + - [x] 对齐 + - [x] 分享 + - [x] 参考 + - [x] 管理员工具 + - [ ] 版本跳转 + - [ ] 版本冻结 + - [ ] 借用器 +- [ ] 命令行 + - [ ] 完整核心功能封装 -### 拓展工具 + - [x] 帮助 + - [x] 补全 + - [ ] 内嵌文档 + - [ ] JSON 输出 + +- [ ] 桌面端 + + - [ ] 完整核心功能封装 + + - [x] 命令行包装器 + - [ ] 主题 + +- [ ] 2026 计划 + + - [ ] 桌面端支持 **当前阶段** + + - [ ] 规范化核心、命令行代码 + - [ ] 提高异步、并发支持 + - [ ] 存储优化 + - [ ] 分布式内容存储、集中式权限管理 -- [x] 命令行客户端 -> [CommandLine](https://github.com/JustEnoughVCS/CommandLine ) -- [ ] 桌面客户端 -> [JVDesktop](https://github.com/JustEnoughVCS/JVDesktop ) -- [ ] 声明式资产管理 -> [JVRefs](https://github.com/JustEnoughVCS/AssetsConfig) (目前 Private) -- [ ] 文件合并器 -> [JVBinMerger](https://github.com/JustEnoughVCS/BinMerger) (目前 Private) @@ -84,8 +177,18 @@ 本项目采用 **MIT 许可证**。 -有关完整的许可证条款,请参阅项目根目录中的 ./LICENSE-MIT.md 文件。 +有关完整的许可证条款,请参阅项目根目录中的 *./LICENSE-MIT.md* 文件。 --- 最后,感谢您对 `JustEnoughVCS` 的关注! + + + +## 一些碎语 + +> 为什么要给它命名 `JustEnoughVCS` ? +> +> 如果你认为它听起来像是 Minecraft 中的 Mod 才会取的名字,那你就猜对了! +> +> 其实灵感正是来自 `JustEnoughItems` 😄 |
