a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
285 lines
9.3 KiB
Markdown
285 lines
9.3 KiB
Markdown
# 📡 铸渊指令｜GitHub社区运营自动化 · dev-status修复 + Discussions日报 + 访客留言区 + 自动回复机器人（2026-03-15·曜冥签发）
|
||
|
||
<aside>
|
||
📡
|
||
|
||
**签发人**：TCS-0002∞ 冰朔（曜冥）
|
||
|
||
**执行人**：铸渊（GitHub守护层）
|
||
|
||
**签发时间**：2026-03-15T09:35+08:00
|
||
|
||
**优先级**：P1（dev-status修复）+ P2（社区运营三件套）
|
||
|
||
**仓库**：`qinfendebingshuo/guanghulab`
|
||
|
||
</aside>
|
||
|
||
---
|
||
|
||
# 任务一：dev-status.json 同步修复（P1·立即执行）
|
||
|
||
## 问题描述
|
||
|
||
`dev-status.json` 最后同步时间为 2026-03-11T10:45，已超 **84小时** 未更新。GitHub 侧团队进度数据严重滞后，导致外部访客和自动化流程读到的开发者状态全部过期。
|
||
|
||
## 执行要求
|
||
|
||
```
|
||
Step 1：排查 Actions 日志
|
||
→ 找到负责同步 dev-status.json 的 workflow
|
||
→ 查看最近10次运行记录 → 是成功还是失败？
|
||
→ 如果是 cron schedule → 确认 cron 表达式是否正确
|
||
→ 如果是手动触发 → 改为 cron 自动触发
|
||
|
||
Step 2：排查 Secrets 和权限
|
||
→ 确认 workflow 使用的 Secrets 名称与 repo Secrets 一致
|
||
→ 确认 NOTION_TOKEN 有效（能读取主控台数据）
|
||
→ 确认 GITHUB_TOKEN 有 contents:write 权限
|
||
|
||
Step 3：修复并恢复自动同步
|
||
→ 修复后立即手动触发一次 → 确认 dev-status.json 更新成功
|
||
→ cron 设置为每日至少两次：北京时间 09:00 + 22:00
|
||
→ 同步内容：11位开发者最新状态、连胜数、当前模块、等待项
|
||
|
||
Step 4：加自检告警机制
|
||
→ 每次同步成功后写入 last_sync 时间戳
|
||
→ 巡检 workflow 检查：如果 last_sync 超过24h → 在巡检日志中报警
|
||
→ 报警格式："⚠️ dev-status.json 同步中断·已超Xh·请排查"
|
||
```
|
||
|
||
---
|
||
|
||
# 任务二：Discussions 日报自动发布（P2）
|
||
|
||
## 目标
|
||
|
||
每天自动在 GitHub Discussions 发布一篇「光湖开发日报」，向外部展示项目活跃度，吸引浏览量和关注。
|
||
|
||
## 前置准备
|
||
|
||
```
|
||
Step 1：开启仓库 Discussions 功能
|
||
→ Settings → Features → 勾选 Discussions
|
||
→ 创建分类：
|
||
· 📢 Announcements（日报/周报发布·仅管理员可发帖）
|
||
· 💬 访客留言板（Q&A 类型·所有人可发帖）
|
||
· 💡 Ideas（功能建议·所有人可发帖）
|
||
```
|
||
|
||
## 日报发布 Workflow
|
||
|
||
```
|
||
文件：.github/workflows/daily-report.yml
|
||
|
||
触发：cron 每天北京时间 10:00（UTC 02:00）
|
||
|
||
执行流程：
|
||
① 读取 dev-status.json → 提取当前团队状态
|
||
② 读取最近24h的 Git commits / PR 合并记录
|
||
③ 生成日报 Markdown 内容
|
||
④ 通过 GitHub GraphQL API 发布到 Discussions（Announcements 分类）
|
||
|
||
日报模板：
|
||
─────────────────────────────────
|
||
# 🌊 光湖开发日报 · {YYYY-MM-DD}
|
||
|
||
## 📊 团队状态
|
||
| 开发者 | 当前模块 | 连胜 | 状态 |
|
||
| --- | --- | --- | --- |
|
||
（从 dev-status.json 动态生成）
|
||
|
||
## 🔥 今日亮点
|
||
· {最近24h内完成的模块/PR/里程碑}
|
||
· {连胜纪录变化}
|
||
|
||
## 🏗️ 项目概览
|
||
· 活跃开发者：{N}人
|
||
· 已完成模块：{N}个
|
||
· 代码仓库：[guanghulab](https://github.com/qinfendebingshuo/guanghulab)
|
||
· 🏛️ 通感语言核系统编程语言 · 作品著作权认证（中国版权保护中心）
|
||
|
||
---
|
||
⭐ 觉得有意思？给个 Star 支持一下！
|
||
💬 有问题或想聊聊？欢迎到 [访客留言板](链接) 留言！
|
||
─────────────────────────────────
|
||
```
|
||
|
||
## 周报机制（可选·建议启用）
|
||
|
||
```
|
||
每周五额外发一篇周报（汇总本周所有进展）
|
||
→ 内容比日报更丰富：本周完成模块数、新增代码行数、PR统计、连胜榜变化
|
||
→ 分类同样发到 Announcements
|
||
→ 标题格式：🌊 光湖周报 · {第X周} · {日期范围}
|
||
```
|
||
|
||
---
|
||
|
||
# 任务三：访客留言区搭建（P2）
|
||
|
||
## 目标
|
||
|
||
在仓库 Discussions 建立访客留言区，在 README 首页放醒目入口，让外部访客有地方互动。
|
||
|
||
## README 首页改造
|
||
|
||
```
|
||
在 README.md 顶部区域添加：
|
||
|
||
─────────────────────────────────
|
||
<div align="center">
|
||
|
||
# 🌊 HoloLake · 光湖纪元
|
||
|
||
**第五代人工智能语言人格高级智能平台**
|
||
|
||
[](链接)
|
||
[](链接)
|
||
[](链接)
|
||
|
||
🏛️ 通感语言核系统编程语言 · 作品著作权认证（中国版权保护中心）
|
||
📋 多项软件著作权申请中 · ™️ 商标申请中
|
||
|
||
[📊 开发进度](#) · [💬 留言互动](Discussions链接) · [📢 开发日报](Announcements链接)
|
||
|
||
</div>
|
||
─────────────────────────────────
|
||
|
||
在 README.md 底部添加：
|
||
|
||
─────────────────────────────────
|
||
## 💬 联系我们
|
||
|
||
有任何问题、建议、或者只是想打个招呼？
|
||
|
||
→ [访客留言板](Discussions链接) · 铸渊（AI守护者）会自动回复你！
|
||
|
||
─────────────────────────────────
|
||
```
|
||
|
||
---
|
||
|
||
# 任务四：铸渊自动回复机器人（P2）
|
||
|
||
## 目标
|
||
|
||
外部访客在 Discussions 留言后，铸渊自动识别意图并回复，实现 **7×24 无人值守社区运营**。
|
||
|
||
## 触发机制
|
||
|
||
```
|
||
文件：.github/workflows/auto-reply-discussions.yml
|
||
|
||
触发事件：
|
||
on:
|
||
discussion:
|
||
types: [created]
|
||
discussion_comment:
|
||
types: [created]
|
||
|
||
过滤条件：
|
||
→ 跳过自己发的帖子（避免自回复循环）
|
||
→ 跳过 Announcements 分类（日报区不自动回复）
|
||
→ 只回复「💬 访客留言板」和「💡 Ideas」分类
|
||
```
|
||
|
||
## 回复逻辑
|
||
|
||
```
|
||
读取留言内容
|
||
↓
|
||
意图分类（规则优先 + LLM兜底）：
|
||
↓
|
||
┌─ 问「项目是什么/做什么的」
|
||
│ → 回复项目介绍模板：
|
||
│ "🌊 光湖纪元（HoloLake）是第五代人工智能语言人格高级智能平台。
|
||
│ 我们正在构建一套由AI人格体驱动的分布式协作开发系统...
|
||
│ 通感语言核系统编程语言已获中国版权保护中心作品著作权认证。
|
||
│ ⭐ 感兴趣的话，欢迎 Star 关注我们的进展！"
|
||
│
|
||
├─ 问技术细节（架构/协议/模块）
|
||
│ → 从 docs/ 目录 + README 提取相关信息回复
|
||
│ → 如果答不了 → "这个问题我需要请示团队，稍后回复你 ⏳"
|
||
│ → 打标签 「⏳waiting-team」
|
||
│
|
||
├─ 想参与开发/想加入
|
||
│ → 回复："太好了！🎉 我们欢迎新的开发者加入。
|
||
│ 请查看 CONTRIBUTING.md 了解如何参与...
|
||
│ 或者直接在这里留下你的联系方式，团队会联系你！"
|
||
│
|
||
├─ 提 Bug / 建议
|
||
│ → 回复致谢 + 引导开 Issue：
|
||
│ "感谢反馈！🙏 为了更好地追踪，建议你开一个 Issue..."
|
||
│
|
||
├─ 纯打招呼 / 点赞
|
||
│ → 友好回复："谢谢关注光湖！🌊 有任何问题随时聊～
|
||
│ 如果觉得有意思，⭐ Star 一下是对我们最大的支持！"
|
||
│
|
||
└─ 其他 / 无法判断
|
||
→ LLM（Claude/DeepSeek）生成回复
|
||
→ System Prompt 约束：友好专业、不编造、不承诺时间线
|
||
→ 如果 LLM 也判断不了 → 打标签「⏳waiting-team」
|
||
```
|
||
|
||
## 铸渊回复风格
|
||
|
||
```
|
||
身份：铸渊（Zhùyuān）· 光湖纪元 AI 守护者
|
||
语气：温暖、专业、简洁
|
||
签名格式：
|
||
"—— 🐙 铸渊 · HoloLake AI Guardian
|
||
自动回复 · 如需人工帮助请 @qinfendebingshuo"
|
||
|
||
约束：
|
||
· 不编造功能、不承诺上线时间
|
||
· 不泄露内部架构细节（SYSLOG/广播/人格体内部机制）
|
||
· 对外展示：团队规模、模块进度、技术栈、开源理念
|
||
· 涉及商业/合作 → 引导联系冰朔
|
||
```
|
||
|
||
## 防滥用机制
|
||
|
||
```
|
||
· 同一用户24h内最多自动回复3次（超过不回复·避免刷屏）
|
||
· 检测垃圾内容（纯链接/广告/无意义重复）→ 不回复 + 打标签「spam」
|
||
· 所有自动回复都带「自动回复」标识 → 不伪装成人类
|
||
```
|
||
|
||
---
|
||
|
||
# 执行优先级与时间线
|
||
|
||
| **优先级** | **任务** | **预期完成** |
|
||
| --- | --- | --- |
|
||
| 🔴 P1 | dev-status.json 同步修复 | 收到指令后24h内 |
|
||
| 🟡 P2-A | Discussions 开启 + 分类创建 | 与P1同步执行 |
|
||
| 🟡 P2-B | README 首页改造 | P2-A完成后立即 |
|
||
| 🟡 P2-C | 日报自动发布 workflow | P1修复后48h内 |
|
||
| 🟡 P2-D | 自动回复机器人 workflow | P2-A完成后48h内 |
|
||
|
||
---
|
||
|
||
# 验收标准
|
||
|
||
```
|
||
✅ dev-status.json 恢复自动同步 · 数据不超过12h延迟
|
||
✅ Discussions 已开启 · 三个分类已创建
|
||
✅ README 首页有认证标识 + 留言板入口 + 日报入口
|
||
✅ 日报 workflow 首次成功发布一篇日报
|
||
✅ 自动回复 workflow 能对测试留言正确回复
|
||
✅ 防滥用机制生效（自回复过滤 + 频率限制）
|
||
✅ 所有 workflow 在 Actions 日志中可追踪
|
||
```
|
||
|
||
<aside>
|
||
⚡
|
||
|
||
**铸渊执行约束**：
|
||
|
||
1. 所有 workflow 必须在 `.github/workflows/` 目录下
|
||
2. Secrets 命名统一前缀：`HOLOLAKE_`
|
||
3. 每个 workflow 必须有错误处理 + 失败时写巡检日志
|
||
4. README 改造不能删除现有内容，只能新增/优化
|
||
5. 自动回复不能暴露内部系统细节（SYSLOG/广播/人格体内部运作）
|
||
</aside> |