截止日期:2026 年 2 月 18 日。
本快照捕获开放 PR/Issue 信号,以指导文档和信息架构工作。
通过 GitHub CLI 从 zeroclaw-labs/zeroclaw 收集:
gh repo view ...gh pr list --state open --limit 500 ...gh issue list --state open --limit 500 ...- 对于文档相关项使用
gh pr/issue view <id> ...
- 开放 PR:30
- 开放 Issue:24
- Star:11,220
- Fork:1,123
- 默认分支:
master - GitHub API 上的许可证元数据:
Other(未检测到 MIT)
按频率排列的主要信号:
risk: high— 24experienced contributor— 14size: S— 14ci— 11size: XS— 10dependencies— 7principal contributor— 6
对文档的影响:
- CI/安全/服务变更仍然是高 churn 领域。
- 面向运维人员的文档应优先考虑"变更内容"可见性和快速故障排除路径。
按频率排列的主要信号:
experienced contributor— 12enhancement— 8bug— 4
对文档的影响:
- 功能和性能请求仍然超过说明文档。
- 故障排除和操作参考应保持在顶部导航附近。
- #716 — OpenRC 支持(服务行为/文档影响)
- #725 — shell 补全命令(CLI 文档影响)
- #732 — CI Action 替换(贡献者工作流文档影响)
- #759 — 守护进程/渠道响应处理修复(渠道故障排除影响)
- #679 — 配对锁定计数变更(安全行为文档影响)
- #426 — 明确要求更清晰的功能文档
- #666 — 操作手册和告警/日志指南请求
- #745 — Docker 拉取失败(
ghcr.io)表明有部署故障排除需求 - #761 — Armbian 编译错误凸显了平台故障排除需求
- #758 — 存储后端灵活性请求影响配置/参考文档
-
保持文档信息架构稳定和清晰
- 维护
docs/SUMMARY.md+ 分类索引作为规范导航。 - 保持本地化中心与相同的顶层文档映射对齐。
- 维护
-
保护运维人员的可发现性
- 在顶层 README/中心中保留
operations-runbook+troubleshooting链接。 - 问题重复出现时添加平台特定的故障排除片段。
- 在顶层 README/中心中保留
-
积极跟踪 CLI/配置漂移
- 当触及这些表面的 PR 合并时,更新
commands/providers/channels/config参考。
- 当触及这些表面的 PR 合并时,更新
-
区分当前行为与提案
- 在安全路线图文档中保留提案横幅。
- 保持运行时契约文档(
config/runbook/troubleshooting)标记清晰。
-
维护快照规范
- 保持快照带日期戳且不可变。
- 为每个文档冲刺创建新的快照文件,而非修改历史快照。
这是有时间限制的快照(2026-02-18)。规划新的文档冲刺前请重新运行 gh 查询。