bund-workshop-candidates

# 外滩大会 Workshop 候选项目 本仓库包含三个独立项目（基于 ms-agent sdk）。每个项目都可以单独上传到魔搭灵感流，并提供 完整的 Notebook、运行脚本、Agent 配置、Prompt、Skill、工具、Callback、Hook、测试和 一次真实运行样例。 | 目录 | 默认产出 | 主要机制 | 真实数据源 | 预计用时 | | --- | --- | --- | --- | ---: | | [`01_cross_market_morning_brief`](01_cross_market_morning_brief/) | 自选与同市场基准晨报 | Skill、MCP、Callback、Hook | `stock-sdk` MCP | 10–12 分钟 | | [`02_portfolio_review_team`](02_portfolio_review_team/) | A/HK/US 持仓复盘看板 | Memory、子 Agent、Compaction、Harness | `stock-sdk` MCP、Frankfurter | 12–15 分钟 | | [`03_trip_budget_planner`](03_trip_budget_planner/) | 天气驱动的旅行预算看板 | 自定义 MCP、子 Agent、确定性预算 | Open-Meteo、Frankfurter | 10–13 分钟 | 三个项目的设计差异和选择建议见 [`SUMMARY_ZH.md`](SUMMARY_ZH.md)。 ## 快速开始 先准备 Python 3.10+。前两个项目还需要 Node.js/npm，用于启动 `stock-sdk` MCP。 MS-Agent SDK 不由本仓库固定安装方式。可使用本地源码： ```bash python -m pip install -e /path/to/ms-agent ``` 也可以安装已经确认可用的 commit： ```bash python -m pip install git+https://github.com/modelscope/ms-agent.git@<commit> ``` 然后进入任一项目目录： ```bash python -m pip install -r requirements.txt cp .env.example .env # 在 .env 中填写 MODELSCOPE_API_KEY python run.py --preflight --probe-data ``` 看到 `ready: true` 后，打开 `workshop.ipynb` 并从上到下运行。三个项目仅需 `MODELSCOPE_API_KEY`，行情、天气、地理编码和参考汇率不需要额外密钥。 ## 数据和运行约束 - 默认模型为 `inclusionAI/Ling-3.0-flash`，通过魔搭 API Inference 调用； - 外部事实必须来自当前运行的实时 observation； - 上游服务失败时直接报错，不使用 mock、旧缓存或静态数字补齐； - 自选列表、持仓场景和旅行预算属于任务输入，不冒充外部数据； - Callback 保存原始证据，确定性工具负责计算，模型负责规划和文本组织； - Harness 与 Hook 在发布前检查数据完整性、工具顺序和内容边界； - 每次成功运行都会生成 HTML、结构化结果和 Action/Observation 轨迹。 ## 目录结构 ```text project/ ├── README.md # 项目说明和运行方法 ├── workshop.ipynb # 魔搭灵感流入口 ├── run.py # CLI 与 Notebook 共用入口 ├── agent.yaml # 模型和 Agent loop 配置 ├── mcp.json # MCP 配置 ├── workshop_manifest.json # 项目元数据和验收约束 ├── requirements.txt ├── .env.example ├── prompts/ # SOUL / PROFILE / AGENTS ├── skills/ # 任务流程和完成标准 ├── tools/ # 确定性计算、验收和页面渲染 ├── callbacks/ # observation 保存与 trace ├── hooks/ # 发布和停止门禁 ├── agents/ # 子 Agent 配置，仅部分项目包含 ├── tests/ # 不联网的契约测试 └── sample_outputs/ # 真实运行样例，不参与后续运行 ``` ## 已有样例 每个项目的 `sample_outputs/live_validation/` 保存一次成功运行的 HTML、证据、计算结果和 轨迹，便于在运行前查看页面效果。样例带有采集日期，不代表当前行情、天气或汇率，也不会 被代码作为缓存读取。