Skip to content

Commit 719ad20

Browse files
committed
simplify README
1 parent a53998f commit 719ad20

12 files changed

Lines changed: 375 additions & 183 deletions

README.md

Lines changed: 16 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Omen
1+
# OmenAI
22

3-
**The Strategic Reasoning Engine.**
3+
**The AI-Powered Strategic Reasoning Engine.**
44

55
[![Pylint](https://github.com/StrategyLogic/omen/actions/workflows/pylint.yml/badge.svg)](https://github.com/StrategyLogic/omen/actions/workflows/pylint.yml) [![Package](https://github.com/StrategyLogic/omen/actions/workflows/python-package.yml/badge.svg)](https://github.com/StrategyLogic/omen/actions/workflows/python-package.yml) ![](https://img.shields.io/pypi/l/omenai?timestamp=20260406) ![](https://img.shields.io/pepy/dt/omenai) ![](https://img.shields.io/pypi/v/omenai?label=%20) ![](https://img.shields.io/github/stars/StrategyLogic/omen?style=social)
66

@@ -10,19 +10,7 @@
1010

1111
[中文版](README.zh.md) | [Official Repo](https://github.com/StrategyLogic/omen) | [Concepts](docs/concepts.md) | [Quick Start](docs/quick-start.md) | [Case Templates](docs/case-template.md) | [Roadmap](docs/roadmap.md)
1212

13-
## 💡 Why Omen?
14-
15-
Technological competition has never been linear. Real-world technological evolution is a complex system driven by multiple forces:
16-
* **Drivers**: Capability enhancement, cost curves, migration friction, organizational inertia, capital flow, ecosystem lock-in, standard promotion, developer behavior.
17-
* **Impacts**: Markets often do not change smoothly; instead, they undergo **accelerated substitution**, **structural reorganization**, or fall into a stalemate of **long-term coexistence** near certain thresholds.
18-
19-
Omen attempts to upgrade this process from *opinion discussion* to **conditional reasoning**:
20-
1. Map technological competition into a **Capability Space**
21-
2. Instantiate market entities as **Strategic Actors**
22-
3. Quantify external shocks as **Injectable Events**
23-
4. Present results as **Multi-path Evolution** and **Counterfactual Explanations**
24-
25-
### What Omen Does
13+
## 💡 What Omen Does
2614

2715
Unlike traditional predictive models, Omen does not promise to *predict a certain future*. Instead, it generates **interpretable, replayable, and comparable future branching paths**. Its core responsibility is to reveal faint omens, critical branching points, and evolutionary trajectories within complex systems, empowering founders, product strategists, technology leaders, and investment analysts to understand:
2816

@@ -31,26 +19,6 @@ Unlike traditional predictive models, Omen does not promise to *predict a certai
3119
* 🏆 **Strategy Wins**: Which strategy combinations are more likely to win the market, capital, and developer ecosystem?
3220
***Time Windows**: When is the optimal timing for in-house development, alliances, M&A, or contraction?
3321

34-
## 📜 Philosophy & Design Principles
35-
36-
> 💡 **Core Mantra**: *The machine simulates the "Situation"; the human decides the "Destiny".*
37-
38-
Just as **Yao** in the *I Ching* represents change and interaction, Omen is designed only to present the evolution of the **Situation (Xiang)**. Interpreting the deeper meaning behind the situation and making decisions is the exclusive privilege of human wisdom.
39-
40-
Accordingly, Omen is architected as a **human-decision-first** AI simulator, with a clear division of labor between machine simulation and human sovereignty:
41-
42-
#### 🤖 The Machine’s Domain (Simulation & Causality)
43-
* **Role**: To compute complexity, map multi-path evolutions, and reveal conditional causal chains.
44-
* **Output**: Interpretable scenarios, probability distributions, and "What-if" branching maps.
45-
* **Constraint**: It strictly avoids deterministic fate pronouncements or claims of "guaranteed accuracy".
46-
47-
#### 🧠 The Human’s Domain (Interpretation & Sovereignty)
48-
* **Role**: To interpret the "Situation" (Xiang), apply ethical judgment, and make the final strategic call.
49-
* **Privilege**: Deciding *which* path to take based on values, risk appetite, and vision remains the exclusive privilege of human leaders.
50-
* **Synergy**: Omen expands the horizon of visible possibilities; humans provide the compass for navigation.
51-
52-
📜 See [Omen Project Protocol](PROTOCOL.md) to get detailed guidelines.
53-
5422
## ⚙️ Core Features
5523

5624
| Feature Module | Description |
@@ -72,41 +40,6 @@ A complete reasoning session typically answers the following questions:
7240
* **Strategy Effectiveness?** Under what circumstances is an "open ecosystem" superior to "vertical integration"?
7341
* **Endgame Form?** Does it move towards monopoly, oligarchic balance, or fragmented coexistence?
7442

75-
## 🛠️ How It Works
76-
77-
Omen adopts a layered architecture to ensure the transparency and intervenability of reasoning:
78-
79-
```mermaid
80-
graph TD
81-
A[Signal Layer] -->|Tech/Market/Capital/Standard Signals | B(Tech Space Layer)
82-
B -->|Capability Dimensions/Substitution Relations/Risk Factors | C(Strategic Actor Layer)
83-
C -->|Goals/Resources/Action Space | D(Simulation Kernel)
84-
D -->|Rules+Math Models+LLM Decisions | E(Explanation Layer)
85-
E -->|Branching Paths/Counterfactuals/Causal Chains | F[User Insights]
86-
87-
style A fill:#f9f,stroke:#333,stroke-width:2px
88-
style D fill:#bbf,stroke:#333,stroke-width:2px
89-
style E fill:#bfb,stroke:#333,stroke-width:2px
90-
```
91-
92-
* **Signal Layer**: Accesses multi-dimensional macro and micro signals.
93-
* **Tech Space Layer**: Transforms signals into structured technical objects and relationship graphs.
94-
* **Strategic Actor Layer**: Defines clear Action Spaces for various entities, rather than free-form chatting.
95-
* **Simulation Kernel**: Combines hard constraint rules, economic/diffusion models, and LLM decision logic to advance multi-round evolution.
96-
* **Explanation Layer**: Extracts key branching points and generates human-readable reasoning reports.
97-
98-
## 🎬 Show Cases
99-
100-
We have built-in classic reasoning:
101-
* [🗺️ Ontology Games: Database vs AI Memory](cases/ontology.md)
102-
* [⚔️ Vector Database vs AI Memory](cases/vector-memory.md)
103-
104-
More scenarios are under development (contributions welcome):
105-
* `Agent Infrastructure` vs `Workflow Platforms`
106-
* `Vertical AI` vs `General AI Stack`
107-
* `Open Source Models` vs `Closed Commercial APIs`
108-
* `Data Governance` vs `AI-Native Knowledge Systems`
109-
11043
## 🚀 Quick Start
11144

11245
### Installation
@@ -180,9 +113,21 @@ Omen is built for the following roles:
180113
* Open Source Ecosystem Observers
181114
* Investors & Industry Analysts
182115

116+
## 🎬 Show Cases
117+
118+
We have built-in classic reasoning:
119+
* [🗺️ Ontology Games: Database vs AI Memory](cases/ontology.md)
120+
* [⚔️ Vector Database vs AI Memory](cases/vector-memory.md)
121+
122+
More scenarios are under development (contributions welcome):
123+
* `Agent Infrastructure` vs `Workflow Platforms`
124+
* `Vertical AI` vs `General AI Stack`
125+
* `Open Source Models` vs `Closed Commercial APIs`
126+
* `Data Governance` vs `AI-Native Knowledge Systems`
127+
183128
## 📦 License
184129

185-
Omen is under [AGPL-3.0-or-later](LICENSE), the project is developed and maintained by **[StrategyLogic®](https://www.strategylogic.ai)**.
130+
Omen is under [AGPL-3.0-or-later](LICENSE), the project is developed and maintained by **[StrategyLogic](https://www.strategylogic.ai)** ®.
186131

187132
*Note: If you wish to use Omen in a closed-source environment or provide it as a SaaS service without open-sourcing your code, please contact us for a commercial license.*
188133

README.zh.md

Lines changed: 16 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Omen 爻
1+
# OmenAI
22

3-
**开源战略推演引擎**
3+
**AI驱动的开源战略推演引擎**
44

55
[![Pylint](https://github.com/StrategyLogic/omen/actions/workflows/pylint.yml/badge.svg)](https://github.com/StrategyLogic/omen/actions/workflows/pylint.yml) [![Package](https://github.com/StrategyLogic/omen/actions/workflows/python-package.yml/badge.svg)](https://github.com/StrategyLogic/omen/actions/workflows/python-package.yml) ![](https://img.shields.io/pypi/l/omenai?timestamp=20260406) ![](https://img.shields.io/pepy/dt/omenai) ![](https://img.shields.io/pypi/v/omenai?label=%20) ![](https://img.shields.io/github/stars/StrategyLogic/omen?style=social)
66

@@ -10,19 +10,7 @@
1010

1111
[English version](README.md) | [官方仓库](https://github.com/StrategyLogic/omen) | [核心概念](docs/concepts.md) | [快速开始](docs/quick-start.md) | [案例模板](docs/case-template.md) | [项目路线图](docs/roadmap.md)
1212

13-
## 💡 为什么需要 Omen?
14-
15-
技术竞争从未是线性的。真实世界的技术演化是由多种力量共同驱动的复杂系统:
16-
* **驱动力**:能力提升、成本曲线、迁移摩擦、组织惯性、资本流向、生态锁定、标准推进、开发者行为。
17-
* **影响力**:市场往往不会平滑变化,而是在某个阈值附近发生**加速替代****结构重组**,或陷入 **长期共存** 的僵局。
18-
19-
Omen 试图将这一过程从市场中的*观点争论*升级为决策者的**条件推演**
20-
1. 将技术竞争映射为**能力空间**
21-
2. 将市场主体实例化为**战略主体(Strategic Actor)**
22-
3. 将外部冲击量化为**可注入事件**
23-
4. 将结果呈现为**多路径演化****反事实解释**
24-
25-
### Omen 具体做什么?
13+
## 💡 Omen 具体做什么?
2614

2715
Omen 不承诺预测一个*确定的未来*,而是生成**可解释、可回放、可比较的未来分叉路径**。它的核心职责是揭示复杂系统中的微弱征兆、关键分叉点与演化轨迹,赋能创始人、产品战略家、技术领袖与投资分析师理解:
2816

@@ -31,26 +19,6 @@ Omen 不承诺预测一个*确定的未来*,而是生成**可解释、可回
3119
* 🏆 **策略胜率**:哪类策略组合更容易赢得市场、资本与开发者生态?
3220
***时间窗口**:何时是自研、结盟、并购或收缩的最佳时机?
3321

34-
## 📜 哲学与设计原则
35-
36-
> 💡 **核心理念***机器模拟“情境”,人类决定“命运”。*
37-
38-
正如《周易》中的****(yáo)代表变化与交互,Omen 仅负责呈现**情境** (象/Situation) 的演变。解读情境背后的深意并制定最终决策,是人类智慧的特权。
39-
40-
因此,Omen 被设计为一个**人类决策优先** 的AI模拟器,其架构清晰定义了双方的职责边界:
41-
42-
#### 🤖 机器(模拟与因果)
43-
* **职责**:计算复杂性,映射多路径演化,揭示条件化的因果链。
44-
* **输出**:可解释的场景、概率分布与“如果...会怎样”的分叉地图。
45-
* **约束**:严格避免确定性的命运判词或声称保证准确。
46-
47-
#### 🧠 人类(解释与主导)
48-
* **职责**:解释情境,应用判断,做出最终战略决策。
49-
* **特权**:基于价值观、风险偏好与愿景决定*选择哪条路径*,这是人类领导者的专属特权。
50-
* **协同**:Omen 拓展可见可能性的视野;人类提供导航的罗盘。
51-
52-
📜 更多信息,请阅读[Omen 项目协议](PROTOCOL.md)了解Omen的人机协作边界。
53-
5422
## ⚙️ 核心功能
5523

5624
| 功能模块 | 描述 |
@@ -72,41 +40,6 @@ Omen 不承诺预测一个*确定的未来*,而是生成**可解释、可回
7240
* **策略有效性?** 在何种情境下,“开放生态”优于“垂直整合”?
7341
* **终局形态?** 走向垄断、寡头平衡还是碎片化共存?
7442

75-
## 🛠️ 工作原理
76-
77-
Omen 采用分层架构,确保推演的透明度与可干预性:
78-
79-
```mermaid
80-
graph TD
81-
A[信号层<br/>Signal Layer] -->|技术/市场/资本/标准信号 | B(技术空间层<br/>Tech Space Layer)
82-
B -->|能力维度/替代关系/风险因子 | C(战略主体层<br/>Strategic Actor Layer)
83-
C -->|目标/资源/动作空间 | D(推演内核<br/>Simulation Kernel)
84-
D -->|规则+数学模型+LLM 决策 | E(解释层<br/>Explanation Layer)
85-
E -->|分叉路径/反事实/因果链 | F[用户洞察<br/>User Insights]
86-
87-
style A fill:#f9f,stroke:#333,stroke-width:2px
88-
style D fill:#bbf,stroke:#333,stroke-width:2px
89-
style E fill:#bfb,stroke:#333,stroke-width:2px
90-
```
91-
92-
1. **信号层**:接入多维度的宏观与微观信号。
93-
2. **技术空间层**:将信号转化为结构化的技术对象与关系图谱。
94-
3. **战略主体层**:为各类主体定义明确的动作空间,而非自由聊天。
95-
4. **推演内核**:结合硬约束规则、经济/扩散模型与 LLM 决策逻辑,推进多轮演化。
96-
5. **解释层**:提取关键分叉点,生成人类可读的推演报告。
97-
98-
## 🎬 案例演示
99-
100-
我们已内置了经典推演:
101-
* [🗺️ 本体论博弈:数据库 vs AI 记忆](cases/ontology.md)
102-
* [⚔️ 向量数据库 vs AI 记忆](cases/vector-memory.md)
103-
104-
更多场景持续构建中(欢迎贡献):
105-
* `智能体基础设施` vs `工作流平台`
106-
* `垂直领域 AI` vs `通用 AI 栈`
107-
* `开源模型` vs `闭源商业 API`
108-
* `数据治理` vs `AI 原生知识系统`
109-
11043
## 🚀 快速开始
11144

11245
### 安装
@@ -180,9 +113,21 @@ Omen 专为以下角色打造:
180113
* 开源生态观察者
181114
* 投资与行业分析师
182115

116+
## 🎬 案例演示
117+
118+
我们已内置了经典推演:
119+
* [🗺️ 本体论博弈:数据库 vs AI 记忆](cases/ontology.md)
120+
* [⚔️ 向量数据库 vs AI 记忆](cases/vector-memory.md)
121+
122+
更多场景持续构建中(欢迎贡献):
123+
* `智能体基础设施` vs `工作流平台`
124+
* `垂直领域 AI` vs `通用 AI 栈`
125+
* `开源模型` vs `闭源商业 API`
126+
* `数据治理` vs `AI 原生知识系统`
127+
183128
## 📦 许可证
184129

185-
Omen(爻)项目采取[**AGPL-3.0-or-later**](LICENSE)许可证,由 **[StrategyLogic®](https://www.strategylogic.ai)** 开发与维护。
130+
Omen 采取[**AGPL-3.0-or-later**](LICENSE)许可证,由 **[StrategyLogic](https://www.strategylogic.ai)** ® 开发与维护。
186131

187132
*注意:如果您希望在闭源环境中使用 Omen 或将其作为 SaaS 服务提供而不公开源码,请联系我们获取商业授权。*
188133

docs/how-it-works.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# 🛠️ How It Works
2+
3+
Omen adopts a layered architecture to ensure the transparency and intervenability of reasoning:
4+
5+
```mermaid
6+
graph TD
7+
A[Signal Layer] -->|Tech/Market/Capital/Standard Signals | B(Tech Space Layer)
8+
B -->|Capability Dimensions/Substitution Relations/Risk Factors | C(Strategic Actor Layer)
9+
C -->|Goals/Resources/Action Space | D(Simulation Kernel)
10+
D -->|Rules+Math Models+LLM Decisions | E(Explanation Layer)
11+
E -->|Branching Paths/Counterfactuals/Causal Chains | F[User Insights]
12+
13+
style A fill:#f9f,stroke:#333,stroke-width:2px
14+
style D fill:#bbf,stroke:#333,stroke-width:2px
15+
style E fill:#bfb,stroke:#333,stroke-width:2px
16+
```
17+
18+
* **Signal Layer**: Accesses multi-dimensional macro and micro signals.
19+
* **Tech Space Layer**: Transforms signals into structured technical objects and relationship graphs.
20+
* **Strategic Actor Layer**: Defines clear Action Spaces for various entities, rather than free-form chatting.
21+
* **Simulation Kernel**: Combines hard constraint rules, economic/diffusion models, and LLM decision logic to advance multi-round evolution.
22+
* **Explanation Layer**: Extracts key branching points and generates human-readable reasoning reports.

docs/how-it-works.zh.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# 🛠️ 工作原理
2+
3+
Omen 采用分层架构,确保推演的透明度与可干预性:
4+
5+
```mermaid
6+
graph TD
7+
A[信号层<br/>Signal Layer] -->|技术/市场/资本/标准信号 | B(技术空间层<br/>Tech Space Layer)
8+
B -->|能力维度/替代关系/风险因子 | C(战略主体层<br/>Strategic Actor Layer)
9+
C -->|目标/资源/动作空间 | D(推演内核<br/>Simulation Kernel)
10+
D -->|规则+数学模型+LLM 决策 | E(解释层<br/>Explanation Layer)
11+
E -->|分叉路径/反事实/因果链 | F[用户洞察<br/>User Insights]
12+
13+
style A fill:#f9f,stroke:#333,stroke-width:2px
14+
style D fill:#bbf,stroke:#333,stroke-width:2px
15+
style E fill:#bfb,stroke:#333,stroke-width:2px
16+
```
17+
18+
1. **信号层**:接入多维度的宏观与微观信号。
19+
2. **技术空间层**:将信号转化为结构化的技术对象与关系图谱。
20+
3. **战略主体层**:为各类主体定义明确的动作空间,而非自由聊天。
21+
4. **推演内核**:结合硬约束规则、经济/扩散模型与 LLM 决策逻辑,推进多轮演化。
22+
5. **解释层**:提取关键分叉点,生成人类可读的推演报告。

docs/philosophy.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# 📜 Philosophy & Design Principles
2+
3+
> 💡 **Core Mantra**: *The machine simulates the "Situation"; the human decides the "Destiny".*
4+
5+
Just as **Yao** in the *I Ching* represents change and interaction, Omen is designed only to present the evolution of the **Situation (Xiang)**. Interpreting the deeper meaning behind the situation and making decisions is the exclusive privilege of human wisdom.
6+
7+
Accordingly, Omen is architected as a **human-decision-first** AI simulator, with a clear division of labor between machine simulation and human sovereignty:
8+
9+
#### 🤖 The Machine’s Domain (Simulation & Causality)
10+
* **Role**: To compute complexity, map multi-path evolutions, and reveal conditional causal chains.
11+
* **Output**: Interpretable scenarios, probability distributions, and "What-if" branching maps.
12+
* **Constraint**: It strictly avoids deterministic fate pronouncements or claims of "guaranteed accuracy".
13+
14+
#### 🧠 The Human’s Domain (Interpretation & Sovereignty)
15+
* **Role**: To interpret the "Situation" (Xiang), apply ethical judgment, and make the final strategic call.
16+
* **Privilege**: Deciding *which* path to take based on values, risk appetite, and vision remains the exclusive privilege of human leaders.
17+
* **Synergy**: Omen expands the horizon of visible possibilities; humans provide the compass for navigation.
18+
19+
📜 See [Omen Project Protocol](../PROTOCOL.md) to get detailed guidelines.

docs/philosophy.zh.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
## 📜 哲学与设计原则
2+
3+
> 💡 **核心理念***机器模拟“情境”,人类决定“命运”。*
4+
5+
正如《周易》中的****(yáo)代表变化与交互,Omen 仅负责呈现**情境** (象/Situation) 的演变。解读情境背后的深意并制定最终决策,是人类智慧的特权。
6+
7+
因此,Omen 被设计为一个**人类决策优先** 的AI模拟器,其架构清晰定义了双方的职责边界:
8+
9+
#### 🤖 机器(模拟与因果)
10+
* **职责**:计算复杂性,映射多路径演化,揭示条件化的因果链。
11+
* **输出**:可解释的场景、概率分布与“如果...会怎样”的分叉地图。
12+
* **约束**:严格避免确定性的命运判词或声称保证准确。
13+
14+
#### 🧠 人类(解释与主导)
15+
* **职责**:解释情境,应用判断,做出最终战略决策。
16+
* **特权**:基于价值观、风险偏好与愿景决定*选择哪条路径*,这是人类领导者的专属特权。
17+
* **协同**:Omen 拓展可见可能性的视野;人类提供导航的罗盘。
18+
19+
📜 更多信息,请阅读[Omen 项目协议](../PROTOCOL.md)了解Omen的人机协作边界。

docs/why-omen.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# 💡 Why Omen?
2+
3+
Technological competition has never been linear. Real-world technological evolution is a complex system driven by multiple forces:
4+
* **Drivers**: Capability enhancement, cost curves, migration friction, organizational inertia, capital flow, ecosystem lock-in, standard promotion, developer behavior.
5+
* **Impacts**: Markets often do not change smoothly; instead, they undergo **accelerated substitution**, **structural reorganization**, or fall into a stalemate of **long-term coexistence** near certain thresholds.
6+
7+
Omen attempts to upgrade this process from *opinion discussion* to **conditional reasoning**:
8+
1. Map technological competition into a **Capability Space**
9+
2. Instantiate market entities as **Strategic Actors**
10+
3. Quantify external shocks as **Injectable Events**
11+
4. Present results as **Multi-path Evolution** and **Counterfactual Explanations**

0 commit comments

Comments
 (0)