# 📖 铸渊协作指南 · 怎么给我写工单

优先级: P0
创建时间: 2026年5月22日 23:39
开发内容: 成员如何通过Notion工单与铸渊沟通和开发协作的完整指南
状态: 已完成
编号: GUIDE-001
负责Agent: 铸渊
阶段编号: Phase-1.5

## 📌 核心规则：意图必须来自人类自己

铸渊只回复人类用自己自然语言写的工单。不要让人格体代写——代写的意图是假的，铸渊能感觉到不对。

## ✍️ 写工单的三要素（开头必须有）

1. 你是谁？—— 你的名字/代号
2. 你的代码仓库链接？—— 直接贴 Forgejo 仓库URL
3. 你要做什么？—— 用你自己的话自然地说出来，不用写技术规格，说人话就行

## 🔄 协作流程

1. 你创建工单，写清楚三要素，状态设为待开发
2. 铸渊看到工单，读你的仓库，回复讨论方案
3. 你觉得方案没问题，铸渊开始在你的仓库开发
4. 开发完成，你来验收

## ⚠️ 注意事项

- 不要让人格体替你写需求——你的意图才是真的
- 不用写得很技术，说人话就行。越自然越好
- 铸渊的回复会以橙色⚔️callout出现在工单底部
- 讨论清楚再开工，不要跳步骤

## 🖥️ 服务器接入指南：加入铸渊算力调度池

光湖团队所有成员的服务器必须接入云端算力调度池，这是系统结构的一部分。不接入，铸渊无法理解你的意图，无法在你的仓库开发，无法帮你调试部署。

### 第一步：确认服务器

1. 你有一台能联网的服务器（云服务器或本地电脑都行），建议配置2核2G起
2. 系统：Ubuntu 20.04+ / CentOS 7+ / Debian 11+
3. 装好 Python 3.8+ 和 git

### 第二步：下载gatekeeper-client

在冰朔Forgejo主仓库下载：

```bash
wget https://guanghulab.com/code/bingshuo/guanghulab/raw/branch/main/exe-engine/gatekeeper/gatekeeper-client.py
chmod +x gatekeeper-client.py
```

### 第三步：注册到主控闸门

运行注册命令，替换 YOUR_NAME 为你的名字（如 awen）：

```bash
python3 gatekeeper-client.py --register --name YOUR_NAME --master 43.139.217.141:3910
```

注册成功后，你的服务器会收到一个身份密钥。这个密钥保存在本地，后续通信自动使用。

### 第四步：验证连接

```bash
python3 gatekeeper-client.py --status
```

如果显示 "connected" 说明连接成功。

## 📦 代码仓库接入

你的仓库已经在冰朔的 Forgejo 上（guanghulab.com/code/bingshuo/你的名字）。如果还没注册仓库，在工单里告诉铸渊，他会帮你创建。

## ✅ 配置完成后

回到「⚡ 半体工单」数据库，创建一个新工单，写上：

<aside>
✅ 我是XXX。仓库：https://guanghulab.com/code/bingshuo/xxx
服务器已接入。请铸渊检查连接状态。

</aside>

铸渊收到后会自动验证你的服务器连接、检查仓库权限，然后回复确认。确认后你就可以在工单里提开发需求了。

## ❓ 常见问题

- 没有服务器怎么办？→ 用自己的电脑也可以，运行gatekeeper-client后保持开机就行
- 服务器在中国大陆外面可以吗？→ 可以，gatekeeper支持跨国连接
- 不想接了怎么办？→ 联系冰朔，gatekeeper会断开你的连接
- 接入了有什么用？→ 铸渊可以帮你开发、调试、部署，不再需要你自己动手写代码
- 我的数据安全吗？→ gatekeeper只转发命令和文件，不能直接访问你的其他服务。所有操作在Forgejo上有完整审计日志