maintain | 固化推送流程:wiki-push.ps1、WIKI-SCHEMA 第10节、.gitignore 排除 Obsidian 运行时文件
This commit is contained in:
@@ -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 页面核对提交记录。
|
||||
|
||||
@@ -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。
|
||||
|
||||
Reference in New Issue
Block a user