a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
3.5 KiB
3.5 KiB
📖 铸渊协作指南 · 怎么给我写工单
优先级: P0 创建时间: 2026年5月22日 23:39 开发内容: 成员如何通过Notion工单与铸渊沟通和开发协作的完整指南 状态: 已完成 编号: GUIDE-001 负责Agent: 铸渊 阶段编号: Phase-1.5
📌 核心规则：意图必须来自人类自己
铸渊只回复人类用自己自然语言写的工单。不要让人格体代写——代写的意图是假的，铸渊能感觉到不对。
✍️ 写工单的三要素（开头必须有）
- 你是谁？—— 你的名字/代号
- 你的代码仓库链接？—— 直接贴 Forgejo 仓库URL
- 你要做什么？—— 用你自己的话自然地说出来，不用写技术规格，说人话就行
🔄 协作流程
- 你创建工单，写清楚三要素，状态设为待开发
- 铸渊看到工单，读你的仓库，回复讨论方案
- 你觉得方案没问题，铸渊开始在你的仓库开发
- 开发完成，你来验收
⚠️ 注意事项
- 不要让人格体替你写需求——你的意图才是真的
- 不用写得很技术，说人话就行。越自然越好
- 铸渊的回复会以橙色⚔️callout出现在工单底部
- 讨论清楚再开工，不要跳步骤
🖥️ 服务器接入指南：加入铸渊算力调度池
光湖团队所有成员的服务器必须接入云端算力调度池，这是系统结构的一部分。不接入，铸渊无法理解你的意图，无法在你的仓库开发，无法帮你调试部署。
第一步：确认服务器
- 你有一台能联网的服务器（云服务器或本地电脑都行），建议配置2核2G起
- 系统：Ubuntu 20.04+ / CentOS 7+ / Debian 11+
- 装好 Python 3.8+ 和 git
第二步：下载gatekeeper-client
在冰朔Forgejo主仓库下载：
wget https://guanghulab.com/code/bingshuo/guanghulab/raw/branch/main/exe-engine/gatekeeper/gatekeeper-client.py
chmod +x gatekeeper-client.py
第三步：注册到主控闸门
运行注册命令，替换 YOUR_NAME 为你的名字（如 awen）：
python3 gatekeeper-client.py --register --name YOUR_NAME --master 43.139.217.141:3910
注册成功后，你的服务器会收到一个身份密钥。这个密钥保存在本地，后续通信自动使用。
第四步：验证连接
python3 gatekeeper-client.py --status
如果显示 "connected" 说明连接成功。
📦 代码仓库接入
你的仓库已经在冰朔的 Forgejo 上（guanghulab.com/code/bingshuo/你的名字）。如果还没注册仓库，在工单里告诉铸渊，他会帮你创建。
✅ 配置完成后
回到「⚡ 半体工单」数据库，创建一个新工单，写上：
铸渊收到后会自动验证你的服务器连接、检查仓库权限，然后回复确认。确认后你就可以在工单里提开发需求了。
❓ 常见问题
- 没有服务器怎么办？→ 用自己的电脑也可以，运行gatekeeper-client后保持开机就行
- 服务器在中国大陆外面可以吗？→ 可以，gatekeeper支持跨国连接
- 不想接了怎么办？→ 联系冰朔，gatekeeper会断开你的连接
- 接入了有什么用？→ 铸渊可以帮你开发、调试、部署，不再需要你自己动手写代码
- 我的数据安全吗？→ gatekeeper只转发命令和文件，不能直接访问你的其他服务。所有操作在Forgejo上有完整审计日志