docs: 核查并润色文档,对齐项目实际实现

- 删除未经验证的环境要求(Docker 版本号、浏览器条目)与括号废话
- 故障排查改为真实处理路径(升级→重新发布→强制同步→重建 Agent→提交 issue),删除仅开发时用的排障章节
- 删除设计文档中的测试与验收、实现检查清单、贡献者阅读建议等开发内容
- 修正与代码不符的事实:reset-passwd 命令名、证书续签窗口 7 天、Pages 检查间隔 1440 分钟、Relay vhost 端口 8080、SSO 仅支持 OIDC 等
- 去除口语化表述与无意义括号,改写「不是…而是…」句式
- 同步修正文档站链接锚点,构建验证通过
This commit is contained in:
ryan
2026-08-16 17:49:57 +08:00
parent 4e3d79c001
commit 600a7acdfb
37 changed files with 275 additions and 517 deletions
+3 -6
View File
@@ -1,6 +1,6 @@
# 日志存储解耦
你会学到:哪些表属于日志用途、为什么不能绑死 ClickHouse,以及新增一张日志表时必须走哪条代码路径。逐步落地步骤见 `.agents/skills/logstore/SKILL.md`。
你会学到:哪些表属于日志用途、为什么不能绑死 ClickHouse,以及新增一张日志表时必须走哪条代码路径。
观测字段与上报协议仍以 [观测上报协议与表结构](./observability-data-model.md) 为准;本文只约定**存到哪、怎么切库**。
@@ -70,7 +70,7 @@ ClickHouse 上的小时级物化视图(如 `of_access_log_hourly`)只服务
## 5. 新增一张日志表
列名必须在 ClickHouse / PostgreSQL / SQLite 三套 goose 中一致。顺序与禁止项见 `logstore` skill。要点:
列名必须在 ClickHouse / PostgreSQL / SQLite 三套 goose 迁移中一致。要点:
* 高频表:CH 用 `MergeTree` + `toYYYYMM`;PG 用 `PARTITION BY RANGE(时间列)`,主键含分区键;SQLite 普通表 + 索引。
* ID 用 snowflake `uint64`,迁移时原样保留。
@@ -83,7 +83,4 @@ ClickHouse 上的小时级物化视图(如 `of_access_log_hourly`)只服务
## 6. 相关文档
* 开发步骤:`.agents/skills/logstore/SKILL.md`
* DDL:`.agents/skills/database-migration/SKILL.md`
* 批量写入:`.agents/skills/clickhouse-batchwriter/SKILL.md`
* 实现前设计稿(历史):[日志数据库解耦设计](../superpowers/specs/2026-08-08-log-database-decoupling-design.md)
* 观测字段与上报协议:[观测上报协议与表结构](./observability-data-model.md)