weichen
2e2620009f
Why: Make independent version consumption work from ordinary clones while retaining historical commits and existing branch workspaces. Evidence: SELF Dev task receipts record 24 CI boundary cases, all workflow syntax checks, readonly private-source prefetch in clean exports, provider tests and package installation without acquisition scripts. Platform CI remains pending. Impact: Remove only replaced index links, preserve old physical checkouts, and update dependency guidance. Library consumers retain their immutable versions until an explicit dependency update. Refs: Agent-System-Dev feature/dependency-workspace; approved versioned-dependency r1, U3-U7 and R15.
3.3 KiB
3.3 KiB
Logging-System 项目事实
工作规则见 AGENTS.md。此文件维护本项目事实，不复制通用规范。
仓库与操作
- 目标/产品边界：结构化日志库与可独立部署的采集服务。把一次请求的日志和错误码对齐到同一个
trace_id。不导入错误码模块。 - 源码、资产、文档、机器契约位置：模块路径
git-ssh.u1680832.nyat.app/weichen/Logging-System.git。包为logsys、sink、redact、config、slogadapter、server、cli、conformance、examples/trace。配置示例在docs/example.json。 - 权威远端、集成基线、受保护分支：
ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git，基线main。 - 并行共同基线记录位置、合入通知/主动检查方式：Gitea Issue/PR。消费方用自己的 go.mod/go.sum 固定实际版本。
- 发布线与批准版本/实际制品查询入口：无独立制品库。
go build -o bin/logctl .从当前提交构建。 - 提交/审核/合并/发布身份与权限：仓库所有者 weichen。
- 任务唯一来源：Gitea
weichen/Logging-System的 Issue 与 Pull Request。 - 规范性文档目录：
policy/。 - 过程文档仓/目录：
docs/records/（项目内豁免）。 - 交接记录位置：随任务主记录；需要落盘的交接放入
docs/records/。 - 凭证查找入口及所需字段：采集 token 来自服务配置或环境，字段名为 token /
X-Log-Token，值不入库。进程内日志还可由LOGSYS_CONFIG、LOGSYS_LEVEL、LOGSYS_SERVICE、LOGSYS_REDACT覆盖。
依赖组合
| 逻辑 ID | 路径 | 角色 |
|---|---|---|
| development-guidelines | Dev .workspace/Development-Guidelines（源码锁固定） |
development-only |
主库只依赖标准库。消费方通过 go get git-ssh.u1680832.nyat.app/weichen/Logging-System.git@<已审核提交>
生成真实提交版本，go.mod/go.sum 是消费权威，正式测试关闭本地 Go 覆盖。
私有传输由 Dev 固定入口配置；旧提交保留自己的历史依赖方式。
克隆：
git clone ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git
验证命令
| 影响 | 工作目录与真实命令/CI | 前提与不覆盖范围 |
|---|---|---|
| 文档 | 核对 docs/integration.md 与示例 |
不证明消费方已接线 |
| 模块/接口 | 仓库根：go vet ./... && go test -count=1 ./... |
不含 examples/trace（独立模块） |
| 数据/权限/恢复 | 文件滚动与采集 JSONL 由 sink/server 测试覆盖 | 无共享数据库 |
| 跨库追溯示例 | 在 examples/trace：go test ./... |
独立模块通过 go.mod 固定远端两库版本 |
环境与数据
| 环境/实例 ID | 只读查询入口 | 授权写入入口 | DB/存储归属 | 恢复入口 |
|---|---|---|---|---|
| 本地采集器 | GET /v1/logs、logctl query |
POST /v1/logs |
配置的 JSONL 文件，默认由 CLI --data 指定 |
重放该 JSONL；SSE 游标过期后从查询接口对账 |
共享项及 ACL：配置 token 时写入与读取都要带令牌。部署、迁移、发布的审批依据与负责角色：合并进 main 由仓库所有者批准。
实际制品/配置/schema 的查询方法：以运行中的配置文件与 LOGSYS_* 环境变量为准，不以 docs/example.json 代替现场配置。