#   doc-study-V1

**Repository Path**: zhangdatou/doc-study-v1

## Basic Information

- **Project Name**:   doc-study-V1
- **Description**: 关于一些日常通过claude4问答式学习的内容
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-09
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学习文库

本目录是 Git 仓库根目录，覆盖主学习库、Hot 100 复习区和草稿箱三个 Obsidian Vault。学习笔记与手写代码可随仓库提交，在其他电脑克隆后继续使用；Obsidian 的窗口布局等本机状态不纳入同步。

## 目录职责

| 路径 | 职责 | 使用方式 |
| --- | --- | --- |
| `学习文库/算法学习/` | 唯一正式算法库，使用 schema v3、单题五层、概念层和跨题对照层 | 日常学习与维护入口 |
| `LeetCode-系统复习/` | 面向当前 Hot 100 复习的独立 Java 课程、弹性计划、分级题单和学习 skill | 从 [Hot 100 稳定复习](LeetCode-系统复习/00-总入口.md) 开始 |
| `草稿箱/草稿箱/` | 手动输入、打代码和巩固记忆的草稿 Vault | 在草稿 Vault 中直接练习，完成后按需整理回正式笔记 |
| `整理工作区/` | 旧库盘点、路径映射、迁移评估、执行记录和可重复脚本 | 管理与审计入口 |
| `doc-study-v1/` | Gitee 旧仓库的只读来源快照 | 只查来源，不直接作为学习入口 |
| `site/` | 学习站构建器与前端，把正式库渲染成可浏览、可搜索的网站 | 只改站点代码，正文仍写在学习文库 |
| `scripts/` | 发布与预览脚本、多仓库同步规则 | `scripts/publish.sh` 一条命令发两个仓库 |

正式库入口是 [算法学习总索引](学习文库/算法学习/README.md)。旧快照来自 `doc-study-v1` 的 `master` 提交 `777cf6ba4cf8c5b81e46df8aeeff4b2007021fac`，保留它是为了追溯题目来源、错因和旧推导。

## 在其他电脑继续学习

克隆仓库后，可在 Obsidian 中分别打开以下 Vault 文件夹：`学习文库/`、`LeetCode-系统复习/`、`草稿箱/草稿箱/`。完成笔记或代码练习后，在仓库根目录提交并推送；另一台电脑先拉取最新提交再继续编辑。`.obsidian/workspace.json` 和 `.obsidian/workspace-mobile.json` 是设备窗口布局，不会同步；课程、草稿和可移植的 Vault 设置会随 Git 同步。

新电脑首次使用（先配置好 Gitee 与 GitHub 的 SSH 访问）：

```bash
git clone -b master git@gitee.com:zhangdatou/doc-study-v1.git 学习文库
cd 学习文库
git remote add github git@github.com:zhangshun2/doc-study-v1.git
bash scripts/install-hooks.sh
```

已有克隆的电脑无需重新克隆；在仓库根目录执行 `git pull --ff-only origin master`。开始编辑前先拉取，切换电脑前提交并推送。拉取被本地改动阻挡或分支已分叉时，先保存改动、处理差异，不覆盖本地笔记。

保存本次复习和草稿的常用命令：

```bash
git status --short
git add -- LeetCode-系统复习 草稿箱
git commit -m "保存复习记录和手写练习"
scripts/publish.sh
```

提交其他目录时，把相应路径加入 `git add`。发布脚本需要 Python 3，并要求已跟踪文件的改动都已提交；如需保留其他未提交改动，可在站点构建通过后使用 `git push origin master`，由已安装的钩子镜像到 GitHub，检查两边的推送结果。

草稿箱可以保留重复实现、未完成代码和试错过程，也可以随时提交；不需要等到做完一题或整理成正式题解再同步。

## 融合边界

以下规则适用于正式算法库及旧资料迁移。复习区按自身课程组织，草稿箱用于记录练习过程。

- 当前 `学习文库/算法学习/AGENTS.md` 与 schema v3 是唯一规范。
- 官方题意、约束、签名、示例和事实哈希只从 LeetCode 重新同步，旧题面不能覆盖。
- 每道题只保留一份权威 Java 实现，位于标准题解；旧 Java 只作为对照素材。
- 旧题解、问题档案和长文按职责拆入核心卡、标准题解、建模专题、概念卡或 Java 速查，不整目录搬迁。
- 旧导航、批量索引、重复副本和临时 QA 不进入正式层。
- 网络协议和 Spring Boot 内容不属于算法正式库，后续应进入更宽的资料区。

## 当前状态

- 正式库：66 道题、66 张核心卡、24 个建模专题。
- 已验证：66/66 提交代码编译、66/66 本地示例运行、172/172 官方示例断言通过。
- 首批融合：`32, 150, 224, 232, 301, 1249` 已完成。
- 旧库独有剩余：47 道，按评估记录中的批次继续处理，不提前创建空壳。

完整判断依据见 [doc-study-v1 与当前算法库融合评估](整理工作区/doc-study-v1-迁移评估.md)，逐题执行情况见 [首批融合执行记录](整理工作区/doc-study-v1-首批融合执行记录.md)。

## 发布与同步

- 远端：`origin` = Gitee（`master`），`github` = GitHub（`main`，默认分支）。
- 发布：`scripts/publish.sh`，会做构建自检后同时推送两个仓库，并确认 GitHub 已触发构建。
- 兜底：`pre-push` 钩子会在 `git push` 时自动镜像 `master`，新克隆仓库先跑 `scripts/install-hooks.sh`。
- 站点：GitHub Actions 自动发布到 <https://zhangshun2.github.io/doc-study-v1/>。

完整规则见 [发布脚本与规则](scripts/README.md)，站点说明见 [学习站说明](site/README.md)。

## 校验

```bash
cd 学习文库/算法学习
./validate-all.sh
```

迁移盘点可以重复生成：

```bash
cd 整理工作区
ruby tools/build-doc-study-v1-inventory.rb
```