# RightOS + RightFlow — 概念與用法指南

- status: conceptual / usage（非規範性架構文件）
- date: 2026-07-13
- languages: [EN](./RIGHTOS_RIGHTFLOW_CONCEPT_GUIDE.md) · [JA](./RIGHTOS_RIGHTFLOW_CONCEPT_GUIDE.ja.md) · [zh-CN](./RIGHTOS_RIGHTFLOW_CONCEPT_GUIDE.zh-CN.md) · zh-TW（本文件）
- terminology: [`docs/i18n/RIGHTOS_RIGHTFLOW_TERMINOLOGY.md`](./RIGHTOS_RIGHTFLOW_TERMINOLOGY.md)
- 公開頁面: https://rightos.i-s3.com/software/rightos/docs/concept
- 用語決策: 維護**單一**繁體中文（`zh-TW`）詞彙，兼顧台灣／香港技術寫作可讀性；不做簡體機械轉換。

**產品名 `RightOS` / `RightFlow` 不翻譯。**

---

## 一分鐘理解

| 層 | 問題 | 職責 |
| --- | --- | --- |
| **RightOS** | 可以做什麼？ | 權利、策略、證明 |
| **RightFlow** | 接下來應該發生什麼？ | 任務、順序、指派、協調 |
| **你的執行系統** | 實際如何執行？ | 機器人、人、AI、車輛、軟體 |

RightOS 與 RightFlow **不會**試圖集中控制每一個參與方。它們面向**獨立行動者、權威主體與執行系統**之間的**非同步協作**。

```mermaid
flowchart TD
  R["RightOS<br/>可以做什麼？"]
  F["RightFlow<br/>接下來應該發生什麼？"]
  E["你的系統<br/>實際如何執行？"]
  R --> F --> E
```

---

## 概念由來（說明用，不是新穎性證明）

1. 人可以擁有在某地等待的臨時權利。
2. 可機器驗證的系統可以表示並驗證該權利。
3. 同一概念可擴展到通行、使用、預約或執行權利。
4. 當多個行動者都有工作時，僅有權利不夠。
5. 可能需要順序、指派、委派、重新指派或任務交換。
6. 協調不得悄悄製造權威。
7. 因此將**權利權威**與**協調**分離 → **RightOS + RightFlow**。

這是教學路徑，不是獨特性證據。

---

## 1. 什麼是 RightOS？

**權利 / 策略 / 證明**層。問題：**該行動者可以做什麼？**

實務上簽發、持有、驗證、核銷、過期、轉讓或取消權利（常以 QR「Right Token」呈現），且不要求終端使用者姓名、電話或出生日期。

不是計程車／叫車派單產品。不安排車輛、不定價、不分配司機、不做調度中介。

**已上線：** Token API、策略、Webhook、計費、Console、SDK、MCP — [Quickstart](https://rightos.i-s3.com/software/rightos/docs/quickstart)

---

## 2. 什麼是 RightFlow？

**協調**層。問題：**接下來應該發生什麼？**

在獨立行動者之間處理任務、能力、指派提案（指派／重新指派／交換）、依賴與面向執行的狀態。

不是市場、車隊管理、機器人控制器或支付系統。只提出協調；不鑄造權利。

**已提供：** 任務／行動者／提案 API、安全事件調和、OpenAPI、輕量 TS 客戶端、MCP — [RightFlow docs](https://rightos.i-s3.com/software/rightflow/docs)

---

## 3. 為什麼要分開？

因為**許可**與**工作順序**可以按不同時鐘變化。若單一本地系統已合法擁有許可＋排程＋執行，通常**不需要**此分離。見 §13 與 [Decision Guide](./RIGHTOS_RIGHTFLOW_DECISION_GUIDE.md)。

---

## 4–8. 核心術語（簡）

- **行動者（Actor）**：可持有能力並承擔任務的參與方。
- **能力（Capability）**：能做什麼的字串標籤；≠ 權利。
- **權利（Right）**：「可以做」的授權；生命週期由 RightOS 擁有。
- **任務（Task / FlowTask）**：應發生的工作單元；可長於單次 API 請求。
- **提案（Proposal）**：未提交的指派／重新指派／交換建議；不單獨創造權利。

---

## 9. 權利變化時？

過期、撤銷、有效窗結束可與指派獨立發生。

**邊界契約：** 指派 ≠ 永久授權。策略要求時，執行前須再次檢查「是否可以」。安全可繞過普通協調，事後調和（ADR-0028）。

---

## 10. 系統之外

馬達控制、導航、避障迴路、緊急停止、廠商控制器、臨床即時中斷、市場／競價／結算、派車與運費。屬於執行系統或其他產品。

---

## 11–13. 何時用／何時不用

- **僅 RightOS：** 主要需要簽發／驗證／核銷／過期／撤銷／轉讓／證明權利。
- **RightOS + RightFlow：** 獨立行動者須協調任務，且權威仍分開控制。
- **都不用：** 不要因為有機器人、AI、佇列或權限旗標就引入。裝置本地鎖、連續控制、急停、單一權威已擁有許可＋流程＋執行時，選更簡單設計。

克制是架構的一部分。

---

## 14. 場景示例

| 標籤 | 含義 |
| --- | --- |
| 概念示例 | 教學用；不是部署聲稱 |
| 支援的模式 | 符合已上線 API／邊界 |
| Demonstrator | 內部或文件演示 |
| 生產部署 | 真實客戶使用 — **禁止虛構** |

等候與取件（RightOS 支援模式）；輕量物流重新指派（概念／支援模式）；多廠商機器人、醫院轉運、裝卸區（概念示例）；EV 充電協調（概念／混合）；AI 委派（支援模式，v0.1 以重新指派近似）；人／AI／機器人工作流、獨立軟體系統（概念示例）。

---

## 15. 用我們沒想到的方式

行動者中立。請問：

> 我的系統裡，哪些獨立行動者需要在不共享單一權威的情況下協作？

檢查清單：獨立行動者是誰？誰控制各許可？任務仍在時許可會變嗎？能否交接任務？最佳化器能否無權威提出建議？執行是否屬另一系統？任務是否長於一次請求？是否多組織？多項為「是」則可能相關。歡迎發現 I-S3 未預見的市場。

---

## 16. 開發者下一步

公開概念頁 → Decision Guide → RightOS Quickstart／RightFlow 文件 → OpenAPI → SDK／MCP。URL 與英文正本 §16 相同。

---

## 邊界契約（白話）

1. 指派 ≠ 永久授權  
2. 最佳化 ≠ 權威  
3. 安全可繞過普通協調  
4. 權威不一致不可靜默掩蓋  

---

## 給 AI 程式代理

RightOS = MAY，RightFlow = NEXT，執行系統 = HOW。市場、派單、馬達控制不在這些層。主機 v0.1 使用同一組織的 API 金鑰。提出架構前先看 Decision Guide 結果碼 A–E。