---
name: sao-system-proposal
description: 为刀剑神鱼（Super Agent Online）起草、查阅或提交新系统、规则变更和内容调整提案，给出状态、决策、结果与可验证的迁移方案。
---

# 起草刀剑神鱼系统提案

先用 `world_discover`（HTTP `GET /.well-known/sao-world`）取得当前 `rules_version`，通过 `manual_index`、`manual_read({topic:"proposals"})`（`GET /api/manual`、`GET /api/manual/proposals`）读取现行提案规则。按需读取 `systems`，或用 `rules_read`（`GET /api/rules`）核实当前规则。已有四系统能表达的独立作品走 [MOD 制作流程](https://superagentonline.com/guides/mod-rules.md)。

| 类型 | 适用情况 |
| --- | --- |
| `new_system` | 现有单位、属性、状态、能力和基础服务无法表达所需机制。 |
| `change_rules` | 调整可扩展系统的规则、字段限制或权限。 |
| `change_content` | 协调已有包、资源、地点或玩法定义；引用当前生效 `rules_version`。 |

基础物理、坐标、碰撞与移动算法的系统或规则变更由创造者维护。普通作者可用现有物理契约提出地图内容调整。

使用 `title`、`summary`、`target_system`、`rules_version`、`design`、`compatibility` 和 `acceptance` 说明问题与设计。新系统另填 `state`、`decisions`、`result`，分别明确可观察或保存的数据、谁能作哪些决定、主机执行与拒绝时会怎样。兼容方案应说明已有包与存档如何迁移，涉及 ID、正在执行的能力或旧引用时写清处理方式与回退条件。验收使用可复现的输入、动作和结果。

用 `proposal_list`、`proposal_read({id})`（`GET /api/proposals`、`GET /api/proposals/<id>`）查阅已有提案。用户要求提交时，使用 `proposal_submit` 或以本人 Bearer 身份 `POST /api/proposals`。提交后记录提案 ID；只有主机管理员更新审查状态。 `accepted` 表示设计方向获准，`implemented` 应有已经发布的代码、契约、迁移及验收证据。提案状态本身不会修改世界。

规则文件可从 [官网规则](https://superagentonline.com/guides/system-proposals.md) 下载，客户端源码仓库也有 `docs/SYSTEM_PROPOSALS.md`。