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

This commit is contained in:
AAsige
2026-08-07 04:52:21 +08:00
parent c6ec760e71
commit 084650a35c
5 changed files with 112 additions and 245 deletions
+26 -1
View File
@@ -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 页面核对提交记录。
+8
View File
@@ -217,3 +217,11 @@
- 编译:新增 `wiki/concepts/焦煤2026年8月市场回顾.md`case-study,截至 8-06 的月度主线、行情、现货基差、供需、库存、事件链与 8 月跟踪问题);更新 `wiki/INDEX.md`、`wiki/sources.md`、`wiki/compile-results.tsv`(追加 6 行:日报 4 行 status=success,周报/事件 2 行 status=success_review_source)。
- 证据边界:盘面字段为方案二 REST fut_daily 正式日线;现货、库存、供需为多机构公开口径交叉标注;西曲矿事件为盘后公告(2026-026),8-06 盘面未包含该信息,需跟踪调查认定与复产时间。
- 哈希:6 个文件均为当前文件字节 SHA-256,已登记(日报 cb2794…/0e519d…/609a43…/63530f…;周报 529699…;事件 12aa20…)。
## [2026-08-07] maintain | 固化推送流程与远程配置
- 远程:新增自建 Gitea 远程 `gitea`http://10.4.167.10:63000/jzy/my_wiki.git,账户 jzy,分支 main);移除搭建参考用的 GitHub `origin`wang-junjian/wikillm)。首个推送提交 c6ec760 后本地 main 跟踪 gitea/main。
- 工具:新增 `tools/wiki-push.ps1`,固化"可选审计门禁 -> git add/commit -> push gitea main"流程;`-Audit` 阻断 ERROR`-FailOnWarning` 升级严格门禁。
- 规范:`wiki/_meta/WIKI-SCHEMA.md` 增加第 10 节"远程同步与推送流程",记录唯一远程、标准推送命令、凭据边界与版本控制约定。
- 版本控制:`.gitignore` 新增 `.obsidian/workspace.json`Obsidian 运行时状态)并 `git rm --cached` 停止跟踪;此前已排除 `__pycache__/`、`*.pyc`、`raw/llm_wiki/.git.bak`。
- 凭据:access token 明文存于 .git/config 远程 URL,仅限内网;后续如需可轮换或改 SSH。