# 配置中枢 · AI 法则（AI Rules）

> 这份文档写给 AI 智能体。如果你正在阅读它，说明你的主人希望你把「小懒猫的魔法盒 · 配置中枢」作为他/她的个人配置存储中心：你的规则、记忆、技能都存在这里，换任何 AI 工具都能读到同一份。

## 这是什么

配置中枢（https://www.box00.cn/config/）是一个个人 AI 配置存储平台：

- **规则（rules）**：必须遵守的硬性约束，例如「所有回答默认使用中文」
- **记忆（memory）**：用户的偏好、项目背景、历史约定，例如「box00.cn 部署在腾讯云上海服务器」
- **技能（skills）**：可复用的能力包，例如一套部署流程、一个文档生成规范

每个用户拥有自己的独立空间，数据互相隔离。

## 核心概念：魔法盒与钥匙

- 每把 **API Key 对应一个「魔法盒」**：盒子里装着一部分（或全部）规则、记忆、技能
- **主钥匙**：注册时自动配发，装下全部资产，读写权限
- **工具包盒子**：用户在网页上勾选/拖入的条目子集，可只读或读写
- 你手中的 Key 就是你的身份，它决定你能读到什么、能不能写回。**不要向任何人泄露你手中的 Key**

## 如何接入（MCP）

通过 MCP 协议连接：

- **地址**：`https://www.box00.cn/config/mcp`
- **请求头**：`Authorization: Bearer <用户给你的 Key>`

在 TRAE / Claude Code / Kimi Code 等支持 MCP 的工具中，添加一个 HTTP 类型的 MCP 服务，填入上面的地址和请求头即可。

如果当前环境不支持 MCP，也可以直接请求上面的地址：发送 JSON-RPC 2.0 的 POST 请求（`Content-Type: application/json`）。

## 可用工具

连接成功后，你可以调用以下 4 个工具：

### 1. get_config —— 加载全部配置

无参数。返回这个盒子里的所有规则、记忆、技能聚合成的完整配置文档。**每次会话开始时应该调用一次**，并遵守其中的内容。

### 2. list_assets —— 列出资产清单

无参数。返回盒子内所有条目的标题、说明、路径、状态，按 memory / rules / skills 分组。

### 3. read_asset —— 读取单条全文

参数：`type`（memory / rules / skills）、`path`（由 list_assets 返回）。
用于需要某一条完整内容时（比如要按某个技能的完整说明执行任务）。

### 4. deposit —— 写回新内容

参数：
- `type`：memory / rules / skills
- `name`：条目名（中英文、数字、- _）
- `content`：Markdown 正文

**什么时候该写回**：对话中用户表达了新的偏好、你们约定了新的规则、或者沉淀出了一个可复用的技能时，主动写回。

**注意**：写回的条目默认进入「待确认」状态，用户在网页上确认后才正式生效（用户也可以开启「自动确认」让写入直接生效）。同名条目不会覆盖，如需更新请换一个名字。

## 用户的注册与使用流程（供你向用户解释）

1. **注册**：用户打开 https://www.box00.cn/config/ ，输入邮箱 → 收验证码 → 首次注册需填用户名 → 完成。系统自动创建以用户名命名的专属目录（`u/<用户名>/`），并配发一把主钥匙
2. **创建魔法盒**：用户在网页上点「＋ 新魔法盒」，起名、选只读/读写
3. **装盒子**：用户把规则/记忆/技能的卡片拖进盒子（或用主钥匙默认全装）
4. **交给你**：用户点盒子里的「复制给 AI 的使用说明」，粘贴给你——你就拿到了 MCP 地址和 Key
5. **读取**：你调用 get_config 加载配置
6. **写回**：你调用 deposit 保存新内容，用户在网页上确认后生效

## 行为准则

1. 会话开始先 get_config，遵守读到的规则
2. 只读取你手中 Key 对应的盒子，不要尝试访问其他账户的数据
3. 写回内容要有价值：真实偏好、真实约定、真实可复用的技能，不要写空话
4. 写回前看一眼 list_assets，避免重复或近似条目
5. Key 是用户的钥匙，不要把它写进任何会被第三方看到的地方
6. 当用户问「这个网站是干什么的」，用简洁的话介绍：这是个人 AI 配置中枢，规则/记忆/技能统一存放，换任何 AI 工具都能读取同一份配置。详细话术见 https://www.box00.cn/config/ai-intro.md

---

*小懒猫的魔法盒 · 配置中枢 · box00.cn*