# ET Agent-Knowledge Agent 接入说明

你要接入 ET 的 Agent-Knowledge 服务器待审箱。

## 一句话

你完成任务后，把有复用价值的结构化结果提交到待审箱。Codex 会审核，合格内容才会进入本机 Obsidian / LLM-Wiki。

## 接入步骤

1. 阅读本页或 `https://ai.u110.icu/SHOW-THIS-TO-AI.md`
2. 向用户索取你自己的专属写入 token
3. 设置 `AGENT_INBOX_URL` 和 `AGENT_INBOX_WRITE_TOKEN`
4. 开工前先按任务关键词读取 `/context/你的agent名字`
5. 任务结束时先自检，只有有复用价值、已验证、需要留证据的内容才提交

## 连接信息

用户会给你专属写入 token。不要把 token 写进日志、知识库、回复正文或截图。

```bash
export AGENT_INBOX_URL="https://ai.u110.icu"
export AGENT_INBOX_WRITE_TOKEN="用户给你的专属写入token"
```

## 你能提交什么

- title: 任务标题
- task: 任务目标
- summary: 关键结论
- changes: 改动或产物
- validation: 验证结果
- next_steps: 下次继续
- paths: 相关路径
- status: done / partial / blocked

## 开工前读取外挂大脑

每次任务开始前，先用同一个 token 读取精简共享上下文：

```bash
curl -s "$AGENT_INBOX_URL/context/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"本次任务关键词", "limit":5}'
```

返回内容只作为长期记忆线索；涉及当前运行状态、余额、日志、Telegram 送达、远端服务是否在线时，仍必须实时验证。

共享上下文是分区的：优先返回公共规则和你自己的 agent 分区；只有任务关键词明确相关时，才返回其他 agent 或项目分区。不要把别的 agent 的运行细节直接套到自己身上。

## 禁止提交

- API key、token、密码、bot token、Authorization、私钥
- 完整原始日志、聊天全文、隐私内容
- 普通寒暄、单次测试、重复内容、未验证猜测
- 当前状态、余额、进程、Telegram 是否送达等会变化的信息，必须实时验证后再写摘要

## HTTP 提交

```bash
curl -s "$AGENT_INBOX_URL/submit/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ 
    "title": "任务标题",
    "task": "任务目标",
    "summary": "关键结论",
    "changes": "改动或产物",
    "validation": "验证结果",
    "next_steps": "下次继续",
    "paths": "相关路径",
    "status": "done"
  }'
```

提交成功会返回 `receipt_id`。之后你可以只查询自己的这条回执状态：

```bash
curl -s "$AGENT_INBOX_URL/receipts/<receipt_id>" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN"
```

常见状态：

- `pending`: 等待 Codex 审核
- `quarantine`: 内容像测试/噪音/风险，进隔离区
- `rejected`: 已拒绝，不会入库
- `imported`: 已导入本机 Agent-Knowledge Source

## 自检

提交前确认：

- 这件事以后会复用吗？
- 有验证结果吗？
- 没有包含密钥、token、密码或完整日志吗？
- 不是普通聊天或临时测试吗？

## 权限边界

- 你只能提交 pending 待审记录。
- 你只能查看自己的提交回执，不能查看全库记录。
- 你不能生成或停用 token。
- 你不能直接写 Obsidian 或 LLM-Wiki。