weichenandCursor
0ea2ad297a
The guidelines submodule records the reviewed commit so project rules stay discoverable without copying them into this repository. Co-authored-by: Cursor <cursoragent@cursor.com>
2.3 KiB
2.3 KiB
项目工作入口
本项目采纳的通用规则：核心规则。 采纳范围、生效状态及项目差异：采纳记录。 项目事实、测试和环境入口：PROJECT.md。
- 启动：阅读以上短入口；只加载本次任务触发的专题。
- 普通交付：交付流程。
- 并行开发/正式测试/审核/合入：共同基线与同步节点，必须确认并实际同步最新权威目标。
- Bug/异常：系统性排障。
- 会话结束/换机器/换客户端/换执行者：会话、执行者与机器交接，状态写入任务主记录，不依赖本地会话历史。
- 测试与验收：验证标准。
- 模块/接口：模块契约。
- 错误与过程事件：可观测性。
- 配置：配置来源与实例隔离。
- 其他专题：按 任务索引 选择。
项目补充硬边界：
- 本库只依赖标准库。识别错误码使用
ErrorCode()/ErrorFields()鸭子接口，不import error-code-system。 - 写前脱敏覆盖 JWT、sk-key、Bearer、api_key、password 形状；采集服务写入时再脱敏一次。
- 异步队列满时丢弃最新一条并计数，不阻塞业务 goroutine。
- 追踪头为
X-Trace-Id。trace_id回答哪一次请求，不替代调用方自己的run_id。
任务权威：Gitea 仓库 weichen/Logging-System 的 Issue 与 Pull Request。
规范性文档目录与过程记录位置：policy/；过程记录豁免目录 docs/records/。
默认集成基线和提交身份：main。权威远端 ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git。
共享环境/发布入口及授权：采集服务默认 :8092。配置了 token 时要求 Authorization: Bearer 或 X-Log-Token。令牌值不入库。