maintain | 固化推送流程：wiki-push.ps1、WIKI-SCHEMA 第10节、.gitignore 排除 Obsidian 运行时文件

2026-08-07 04:52:21 +08:00
parent c6ec760e71
commit 084650a35c
5 changed files with 112 additions and 245 deletions
@@ -1,6 +1,6 @@
 ---
 title: "WikiLLM 知识库规范"
-last_updated: 2026-08-03
+last_updated: 2026-08-07
 type: schema
 ---

@@ -198,3 +198,28 @@ pwsh -File .\tools\wiki-reflect.ps1
 ```

 严格门禁可使用 `-FailOnWarning` 或 `-FailOnFindings`，但超长页面、历史规则和低置信度页面首先是人工审阅任务，不等于自动错误。
+
+## 10. 远程同步与推送流程
+
+本仓库的唯一远程是自建 Gitea：`gitea` → `http://10.4.167.10:63000/jzy/my_wiki.git`（账户 `jzy`，分支 `main`）。搭建时参考的 GitHub 上游 `origin` 已移除，不得再依赖外部仓库。
+
+每次维护完成后的标准推送：
+
+```powershell
+pwsh -File .\tools\wiki-push.ps1 -Audit -Message "描述本次变更"
+```
+
+`tools/wiki-push.ps1` 固化流程：
+
+1. `-Audit` 时先运行 `wiki-audit.ps1`，存在 ERROR 即中止（`-FailOnWarning` 可升级为严格门禁）；
+2. `git add -A` 并提交（`-Message` 缺省时自动生成 `maintain | 日期 Wiki 增量更新`）；
+3. `git push gitea main`，失败时提示检查网络与凭据。
+
+凭据说明：access token 明文保存在 `.git/config` 的远程 URL 中，仅限内网使用；如 token 泄露或服务器可被他人访问，应在 Gitea「设置 → 应用」轮换 token，或改用 SSH 密钥方式。`git` 凭据不得写入仓库内任何文件（`.env`、脚本、日志均禁止）。
+
+版本控制约定：
+
+- `.obsidian/workspace.json` 等 Obsidian 运行时状态已被 `.gitignore` 排除并停止跟踪，不进入提交；
+- `raw/llm_wiki/.git.bak` 是上游子仓库元数据备份，被 `.gitignore` 排除；恢复上游更新时改名为 `.git` 使用；
+- `__pycache__/` 与 `*.pyc` 等编译缓存不进入提交；
+- 每次推送前应确认 `git status` 中无意外文件，推送后在 Gitea 页面核对提交记录。