Skip to content

fix broken actor link #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
RCFans merged 2 commits into from
Apr 13, 2026
Merged

fix broken actor link #43

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
477ab06
fix broken actor link
RCFans Apr 13, 2026
b684d86
prepare demo and documents
RCFans Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 40 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,34 @@ A complete reasoning session typically answers the following questions:

---

## 🫧 Online Demo

If you are a:
- Strategy Consultant
- C-level Executive
- Industry Analyst
- Product Manager
- Other non-technical users

Want to quickly experience Omen without local installation? Please visit our online demo deployed on Streamlit Cloud to quickly see the effect.

You can explore the strategic reasoning flow directly online:

[👉 Explore Omen on Streamlit Cloud](https://omen-demo.streamlit.app/)

---

## 🚀 Quick Start

If you are:

- Data Scientist
- AI Researcher
- Strategy Analyst
- Other technical users

Want to run Omen in your local environment? Please follow the installation and running guide below.

### 🏗️ Installation

Environment requirements: Python 3.12+ with `pip` package manager.
Expand All @@ -59,19 +85,21 @@ pip install --upgrade pip setuptools wheel
pip install -e .
```

### 🌰 View Example
### 🌰 Run Demo

If you want to quickly see Omen in action, a visualized sample case and its results are available in the `sample` directory. Run:
If you want to quickly see Omen in action, a visualized sample case and its results are available in the `demo` directory. Run:

```bash
streamlit run sample/app/scenario_planning.py
streamlit run demo/app/scenario_planning.py
```

Then open `http://localhost:8501` in your browser to explore the full strategic reasoning flow.

### 🎵 Run Built-in Case

If you want to run a complete end-to-end workflow, we have prepared a built-in case simulating SAP's acquisition of Reltio in March 2026. The case document is `cases/sap_reltio_acquisition.md`, and it can be run end-to-end with the following commands:
If you want to run a complete **Analyze - Simulate - Explain** workflow, we have prepared a built-in case simulating SAP's acquisition of Reltio in March 2026.

The case document is `cases/situations/sap_reltio_acquisition.md`, and it can be run end-to-end with the following commands:

#### Step 1. Analyze

Expand Down Expand Up @@ -153,17 +181,17 @@ Omen is built for the following roles:

### Strategic Actor Analyze

* [👤 Elon Musk](cases/actors/elon-musk.md)
* [👤 Jeff Bezos](cases/actors/jeff-bezos.md)
* [👤 Steve Jobs](cases/actors/steve-jobs.md)
* [👤 Jack Ma](cases/actors/jack-ma.md)
* [👤 Chen Jiaxing (me)](cases/actors/chen-jiaxing.md)
* 👤 [Elon Musk](cases/actors/elon-musk.md)
* 👤 [Jeff Bezos](cases/actors/jeff-bezos.md)
* 👤 [Steve Jobs](cases/actors/steve-jobs.md)
* 👤 [Jack Ma](cases/actors/jack-ma.md)
* 👤 [Chen Jiaxing (me)](cases/actors/chen-jiaxing.md)

### Strategic Reasoning Cases

* [🧩 Acquisition: SAP vs Reltio](cases/situations/sap_reltio_acquisition.md)
* [🗺️ Ontology Games: Database vs AI Memory](cases/ontology.md)
* [⚔️ Vector Database vs AI Memory](cases/vector-memory.md)
* 🧩 [Acquisition: SAP vs Reltio](cases/situations/sap_reltio_acquisition.md)
* 🗺️ [Ontology Games: Database vs AI Memory](cases/ontology.md)
* ⚔️ [Vector Database vs AI Memory](cases/vector-memory.md)

More scenarios are under development (contributions welcome):
* `Agent Infrastructure` vs `Workflow Platforms`
Expand Down
57 changes: 43 additions & 14 deletions README.zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,34 @@ Omen **不预测**单一未来，它是**为复杂性而生**的推演引擎。

---

## 🚀 快速开始
## 🫧 在线演示

如果你是：

- 战略顾问
- C级决策者
- 行业分析师
- 产品经理
- 其它非技术用户

希望快速体验 Omen 而勿须本地安装，请访问我们部署在 Streamlit Cloud 的在线演示应用，快速查看效果。

你可以直接在线探索战略推演流程：

[👉 在线体验 Omen](https://omen-demo.streamlit.app)

---

## 🚀 快速上手

如果你是：

- 数据科学家
- AI 研究者
- 技术战略分析师
- 其它技术用户

希望在本地环境中运行 Omen，请继续阅读以下安装和运行指南。

### 🏗️ 安装

Expand All @@ -60,19 +87,21 @@ pip install --upgrade pip setuptools wheel
pip install -e .
```

### 🌰 看个例子
### 🌰 看例子

如果你希望快速查看 Omen 的运行效果，`sample` 目录中提供了可视化案例及其结果。运行：
如果你希望快速查看 Omen 的运行效果，`demo` 目录中提供了可视化案例及其结果。运行：

```bash
streamlit run sample/app/scenario_planning.py
streamlit run demo/app/scenario_planning.py
```

然后在浏览器中打开 `http://localhost:8501`，即可查看完整的战略推演流程。
在浏览器中打开 `http://localhost:8501`，即可查看完整的战略推演流程。

### 🎵 亲自运行

如果你希望亲自运行一遍完整的流程，请使用我们准备的内置案例，用于模拟 2026 年 3 月 SAP 收购 Reltio 的情境。案例文档位于 `cases/sap_reltio_acquisition.md`，可以通过以下步骤端到端运行。
如果你希望亲自运行一遍完整的**分析——模拟——解释**流程，请使用我们准备的内置案例，用于模拟 2026 年 3 月 SAP 收购 Reltio 的情境。

案例文档位于 `cases/situations/sap_reltio_acquisition.md`，可以通过以下步骤端到端运行。

#### 第一步：分析

Expand Down Expand Up @@ -152,17 +181,17 @@ Omen 专为以下角色打造：

### 战略主体分析

* [👤 Elon Musk](cases/actors/elon-musk.md)
* [👤 Jeff Bezos](cases/actors/jeff-bezos.md)
* [👤 Steve Jobs](cases/actors/steve-jobs.md)
* [👤 Jack Ma](cases/actors/jack-ma.md)
* [👤 Chen Jiaxing (me)](cases/actors/chen-jiaxing.md)
* 👤 [Elon Musk](cases/actors/elon-musk.md)
* 👤 [Jeff Bezos](cases/actors/jeff-bezos.md)
* 👤 [Steve Jobs](cases/actors/steve-jobs.md)
* 👤 [Jack Ma](cases/actors/jack-ma.md)
* 👤 [Chen Jiaxing (me)](cases/actors/chen-jiaxing.md)

### 战略推演案例

* [🧩 SAP 收购 Reltio：主数据迷雾](cases/situations/sap_reltio_acquisition.md)
* [🗺️ 本体论博弈：数据库 vs AI 记忆](cases/ontology.md)
* [⚔️ 向量数据库 vs AI 记忆](cases/vector-memory.md)
* 🧩 [SAP 收购 Reltio：主数据迷雾](cases/situations/sap_reltio_acquisition.md)
* 🗺️ [本体论博弈：数据库 vs AI 记忆](cases/ontology.md)
* ⚔️ [向量数据库 vs AI 记忆](cases/vector-memory.md)

更多场景持续构建中（欢迎贡献）：
* `智能体基础设施` vs `工作流平台`
Expand Down
19 changes: 10 additions & 9 deletions sample/app/scenario_planning.py → demo/app/scenario_planning.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,17 +37,18 @@ def _render_json(path: str, payload: dict[str, Any] | None) -> None:

def _read_json_file(*, base_dir: Path, pack_id: str, filename: str) -> dict[str, Any] | None:
try:
workspace_base = os.path.normpath(str(WORKSPACE_ROOT))
base_path = os.path.normpath(str(base_dir))
if not base_path.startswith(workspace_base):
workspace_base = os.path.normpath(str(WORKSPACE_ROOT.resolve()))
base_path_obj = base_dir if base_dir.is_absolute() else (WORKSPACE_ROOT / base_dir)
base_path = os.path.normpath(str(base_path_obj.resolve()))
if os.path.commonpath([workspace_base, base_path]) != workspace_base:
return None

safe_pack_id = _normalize_pack_id(pack_id)
if not safe_pack_id:
return None

fullpath = os.path.normpath(os.path.join(base_path, safe_pack_id, filename))
if not fullpath.startswith(base_path):
if os.path.commonpath([base_path, fullpath]) != base_path:
return None

resolved_path = Path(fullpath)
Expand All @@ -62,8 +63,8 @@ def _read_json_file(*, base_dir: Path, pack_id: str, filename: str) -> dict[str,

def _load_sample_actor_payloads(pack_id: str) -> dict[str, Any]:
safe_pack_id = _normalize_pack_id(pack_id)
actor_dir = Path("sample/data/actors") / safe_pack_id
actor_base = Path("sample/data/actors")
actor_dir = Path("demo/data/actors") / safe_pack_id
actor_base = Path("demo/data/actors")
actor_profile_path = actor_dir / "actor_ontology.json"
persona_path = actor_dir / "analyze_persona.json"
status_path = actor_dir / "analyze_status.json"
Expand Down Expand Up @@ -584,9 +585,9 @@ def _render_flow_fallback(payloads: dict[str, Any]) -> None:

with st.sidebar:
st.header("Sample Data Source")
st.warning("Demo mode: this app reads bundled sample artifacts only.")
DATA_ROOT = "sample/data/scenarios"
OUTPUT_ROOT = "sample/output"
st.warning("Demo mode: this app reads bundled demo artifacts only.")
DATA_ROOT = "demo/data/scenarios"
OUTPUT_ROOT = "demo/output"
st.caption(f"Data root: {DATA_ROOT}")
st.caption(f"Output root: {OUTPUT_ROOT}")

Expand Down
0 sample/data/actors/sap/actor_ontology.json → demo/data/actors/sap/actor_ontology.json
View file
Open in desktop
File renamed without changes.
0 sample/data/actors/sap/analyze_persona.json → demo/data/actors/sap/analyze_persona.json
View file
Open in desktop
File renamed without changes.
0 sample/data/actors/sap/analyze_status.json → demo/data/actors/sap/analyze_status.json
View file
Open in desktop
File renamed without changes.
0 sample/data/actors/sap/generation.json → demo/data/actors/sap/generation.json
View file
Open in desktop
File renamed without changes.
0 ...le/data/actors/sap/strategy_ontology.json → demo/data/actors/sap/strategy_ontology.json
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion ...le/data/scenarios/sap/generation/log.json → demo/data/scenarios/sap/generation/log.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@
"scenario_planner": {
"actor_style_enhancement": {
"stage": "scenario_enhance_prompt",
"actor_ref": "output/actors/sap_reltio_acquisition/actor_ontology.json",
"actor_ref": "data/actors/sap/actor_ontology.json",

Copilot AI Apr 13, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This trace log actor_ref points to data/actors/sap/actor_ontology.json, but data/actors/ is not present in this repo (sample actor ontology is under sample/data/actors/sap/actor_ontology.json). Update to an existing path so the trace can be followed from the bundled sample artifacts.

Suggested change
"actor_ref": "data/actors/sap/actor_ontology.json",
"actor_ref": "sample/data/actors/sap/actor_ontology.json",

Copilot uses AI. Check for mistakes.
"admissible_before": true,
"enhanced": false,
"status": "noop",
Expand Down
0 sample/data/scenarios/sap/scenario_pack.json → demo/data/scenarios/sap/scenario_pack.json
View file
Open in desktop
File renamed without changes.
0 sample/data/scenarios/sap/scenario_pack.md → demo/data/scenarios/sap/scenario_pack.md
View file
Open in desktop
File renamed without changes.
4 changes: 2 additions & 2 deletions sample/data/scenarios/sap/situation.json → demo/data/scenarios/sap/situation.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
"How effectively Reltio's system will integrate data across SAP and non-SAP applications",
"Whether the acquisition will address the fundamental adoption barriers of BDC"
],
"actor_ref": "output/actors/sap_reltio_acquisition/actor_ontology.json"
"actor_ref": "data/actors/sap/actor_ontology.json"

Copilot AI Apr 13, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actor_ref points to data/actors/sap/actor_ontology.json, but the bundled sample actor ontology is at sample/data/actors/sap/actor_ontology.json and data/actors/ does not exist in-repo. Use an in-repo path so the sample situation can be loaded without missing actor context.

Suggested change
"actor_ref": "data/actors/sap/actor_ontology.json"
"actor_ref": "sample/data/actors/sap/actor_ontology.json"

Copilot uses AI. Check for mistakes.
},
"signals": [
{
Expand Down Expand Up @@ -197,6 +197,6 @@
"generated_at": "2026-04-12T12:23:29.498395",
"pack_id": "sap",
"pack_version": "1.0.0",
"actor_ref": "output/actors/sap_reltio_acquisition/actor_ontology.json"
"actor_ref": "data/actors/sap/actor_ontology.json"

Copilot AI Apr 13, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

source_meta.actor_ref now points to data/actors/sap/actor_ontology.json, but that path does not exist in this repo (sample actor ontology is under sample/data/actors/sap/actor_ontology.json). Keeping this consistent with the real file location avoids broken links in downstream viewers/loader utilities.

Suggested change
"actor_ref": "data/actors/sap/actor_ontology.json"
"actor_ref": "sample/data/actors/sap/actor_ontology.json"

Copilot uses AI. Check for mistakes.
}
}
0 sample/data/scenarios/sap/situation.md → demo/data/scenarios/sap/situation.md
View file
Open in desktop
File renamed without changes.
0 ...cenarios/sap/traces/actor_derivation.json → ...cenarios/sap/traces/actor_derivation.json
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion .../scenarios/sap/traces/planning_query.json → .../scenarios/sap/traces/planning_query.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"situation_id": "sap_reltio_acquisition",
"actor_ref": "output/actors/sap_reltio_acquisition/actor_ontology.json",
"actor_ref": "data/actors/sap/actor_ontology.json",

Copilot AI Apr 13, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

actor_ref now points to data/actors/sap/actor_ontology.json, but there is no data/actors/ directory in this repo; the sample actor ontology is under sample/data/actors/sap/actor_ontology.json. This reference will still be broken when resolving actor_ref from the bundled sample artifacts.

Suggested change
"actor_ref": "data/actors/sap/actor_ontology.json",
"actor_ref": "sample/data/actors/sap/actor_ontology.json",

Copilot uses AI. Check for mistakes.
"space_inputs": [
{
"name": "Enterprise AI adoption shifting from model-first to data-context-first",
Expand Down
2 changes: 1 addition & 1 deletion .../scenarios/sap/traces/prior_snapshot.json → .../scenarios/sap/traces/prior_snapshot.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"pack_id": "sap",
"pack_version": "1.0.0",
"situation_id": "sap_reltio_acquisition",
"actor_ref": "output/actors/sap_reltio_acquisition/actor_ontology.json",
"actor_ref": "data/actors/sap/actor_ontology.json",

Copilot AI Apr 13, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

actor_ref now points to data/actors/sap/actor_ontology.json, but this repo does not contain a data/actors/ directory (the bundled sample actor ontology lives under sample/data/actors/sap/actor_ontology.json). Update the reference to a path that actually exists for the sample bundle so the link resolves when loading the sample artifacts.

Suggested change
"actor_ref": "data/actors/sap/actor_ontology.json",
"actor_ref": "sample/data/actors/sap/actor_ontology.json",

Copilot uses AI. Check for mistakes.
"raw_prior_scores": [
{
"scenario_key": "A",
Expand Down
0 ...ta/scenarios/sap/traces/reason_chain.json → ...ta/scenarios/sap/traces/reason_chain.json
View file
Open in desktop
File renamed without changes.
0 .../scenarios/sap/traces/reason_chain_a.json → .../scenarios/sap/traces/reason_chain_a.json
View file
Open in desktop
File renamed without changes.
0 .../scenarios/sap/traces/reason_chain_b.json → .../scenarios/sap/traces/reason_chain_b.json
View file
Open in desktop
File renamed without changes.
0 .../scenarios/sap/traces/reason_chain_c.json → .../scenarios/sap/traces/reason_chain_c.json
View file
Open in desktop
File renamed without changes.
0 sample/output/sap/explanation.json → demo/output/sap/explanation.json
View file
Open in desktop
File renamed without changes.
0 sample/output/sap/result.json → demo/output/sap/result.json
View file
Open in desktop
File renamed without changes.
6 changes: 2 additions & 4 deletions docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,7 @@
2. 阅读 [Core Concepts](concepts.md) 理解术语与边界
3. 阅读 [Ontology Input](ontology.md) 理解战场输入结构
4. 阅读 [Precision Guide](precision.md) 理解精度评估与门禁
5. 阅读 [Ingest Workspace](ingest.md) 理解数据摄取目录与流程
6. 参考 [Roadmap](roadmap.md) 查看阶段演进
5. 参考 [Roadmap](roadmap.md) 查看阶段演进

## Documents

Expand All @@ -18,7 +17,6 @@
- [Roadmap](roadmap.md)
- [Quick Start](quick-start.md)
- [Precision Guide](precision.md)
- [Ingest Workspace](ingest.md)

## Core Concepts

Expand All @@ -35,5 +33,5 @@

- `cases/` 下的案例文件必须使用**场景名称**命名，而不是通用名。
- 使用小写英文文件名，必要时用连字符连接。
- 示例：`ontology.md`、`vector-memory.md`、`workflow-agents.md`
- 示例：`ontology.md`、`vector-memory.md`、`nokia-elop-2010.md`
- 不使用：`case.md`、`demo.md`、`example.md`
6 changes: 2 additions & 4 deletions docs/concepts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -233,15 +233,13 @@ Omen 默认输出多种路径类型：

避免使用会误导为确定性预测的表达。

## Precision & Ingest Terms
## Precision Terms

为保持外部文档一致性，新增以下统一术语：

- **Precision Evaluation**：用于度量重复性、方向正确性、证据链完整性
- **Precision Gate**：基于阈值的通过/未通过判定
- **Ingest Workspace**：`data/ingest/` 下的标准目录（`sources/extracted/knowledge/graph`）

相关文档：

- [精度评估](precision.md)
- [数据摄取](ingest.md)
- [精度评估](precision.md)
8 changes: 4 additions & 4 deletions docs/concepts/artifact-situation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ Omen 将 `known_unknowns` 定义为“已经识别到、但尚未被证据充分

#### 示例片段

摘自 SAP 收购 Reltio 的[情势模型](../../sample/data/scenarios/sap/situation.json)：
摘自 SAP 收购 Reltio 的[情势模型](../../data/scenarios/sap/situation.json)：

```json
"known_unknowns": [
Expand All @@ -161,7 +161,7 @@ Omen 将 `assumptions_explicit` 定义为针对关键未知给出的可检验假

#### 示例片段

摘自 SAP 收购 Reltio 的[情势模型](../../sample/data/scenarios/sap/situation.json)：
摘自 SAP 收购 Reltio 的[情势模型](../../data/scenarios/sap/situation.json)：

```json
"assumptions_explicit": [
Expand Down Expand Up @@ -205,8 +205,8 @@ if "founder/ceo/strategic" in actor_id:

### 参考样例
- [情势案例：SAP 收购 Reltio](../../cases/situations/sap_reltio_acquisition.md)
- [情势简报：SAP 收购 Reltio](../../sample/data/scenarios/sap/situation.md)
- [情势模型：SAP 收购 Reltio](../../sample/data/scenarios/sap/situation.json)
- [情势简报：SAP 收购 Reltio](../../data/scenarios/sap/situation.md)
- [情势模型：SAP 收购 Reltio](../../data/scenarios/sap/situation.json)

## 相关文档

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/strategic-actor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -305,7 +305,7 @@ Omen 提供可校验、可重复运行的自动化流程，能够从非结构化

### 如何使用

> 如果你尚未安装 Omen，请先阅读[快速指南（LLM）](../quick-start-llm.md)，完成环境配置和模型接入。
> 如果你尚未安装 Omen，请先阅读[快速开始](../quick-start.md)，完成环境配置和模型接入。

**首次使用**：运行 CLI 生成一个简单案例：

Expand Down
7 changes: 3 additions & 4 deletions docs/guides/run-strategic-reasoning-flow.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,9 +130,8 @@ omen/

## 📚 阅读更多

- 术语与边界： [concepts.md](concepts.md)
- 战场输入结构： [ontology.md](ontology.md)
- 精度评估与门禁： [precision.md](precision.md)
- 数据摄取工作区： [ingest.md](ingest.md)
- 术语与边界： [concepts.md](../concepts.md)
- 战场输入结构： [ontology.md](../ontology.md)
- 精度评估与门禁： [precision.md](../precision.md)

*Simulate the Signs. Reveal the Chaos.*
6 changes: 3 additions & 3 deletions docs/ontology.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,9 @@ Strategy Ontology Schema 包含 TBox/ABox + 推理配置：

## 战略本体案例

[Ontology之战](cases/ontology.md)：`data/scenarios/ontology.json`
[Ontology之战](../cases/ontology.md)：`data/scenarios/ontology.json`

[向量 vs. 记忆](cases/vector-memory.md)：`data/scenarios/vector-memory.json`
[向量 vs. 记忆](../cases/vector-memory.md)：`data/scenarios/vector-memory.json`

### TBox 概念体系

Expand Down Expand Up @@ -199,7 +199,7 @@ omen compare --scenario data/scenarios/ontology.json --overrides '{"user_overlap

### 本体复用

你也可以直接复用同一工作流运行[第二个案例](cases/vector-memory.md)：
你也可以直接复用同一工作流运行[第二个案例](../cases/vector-memory.md)：

```bash
omen simulate --scenario data/scenarios/vector-memory.json
Expand Down
3 changes: 1 addition & 2 deletions docs/precision.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,5 +83,4 @@ omen precision-gate --profile-json path/to/profile.json --precision-json output/
## 7 相关文档

- [快速开始](quick-start.md)
- [战略本体](ontology.md)
- [数据摄取](ingest.md)
- [战略本体](ontology.md)
Loading