股票分析 Agent

UOMP 旗舰示例 Agent（v1.0）。升级为自服务 HTTP API，可部署到 Digital Ocean，任何人都可以连接并授权分析。分析维度覆盖：盈亏、行业分布、集中度、波动率、Sharpe、VaR、Beta、Alpha、相关矩阵、RSI/MACD 技术指标、再平衡建议、情景分析。

完整代码与数据文件在参考实现的 examples/stock-analyst 目录。

前置条件

Node.js >= 20
pnpm 9（corepack enable 或 npm install -g pnpm@9）
已克隆 uomp-core 仓库

1. 构建并初始化

pnpm install
pnpm build
pnpm cli init

2. 启动 Auth + Guard 服务

在终端 1启动本地服务：

pnpm --filter @uomp/server start

保持该终端运行。

3. 导入私有数据

在终端 2导入风险偏好：

pnpm cli import ./examples/stock-analyst/sample-risk.json

导入持仓 CSV（高敏感）：

pnpm cli import ./examples/stock-analyst/sample-holdings.csv \
  --tag portfolio:holdings \
  --sensitivity high

4. 发现并连接 Agent

pnpm cli discover ./examples/stock-analyst
pnpm cli connect ./examples/stock-analyst

5. 授权 Agent

交互式授权（推荐）：

pnpm cli authorize ./examples/stock-analyst

按提示选择标签后，CLI 会输出：

export UOM_TOKEN="<token>"
export UOMP_BASE_URL="http://127.0.0.1:9374"

脚本化授权：

pnpm cli authorize ./examples/stock-analyst \
  --scope portfolio:holdings profile:risk \
  --output /tmp/uomp.env

6. 运行 Agent

source /tmp/uomp.env
node ./examples/stock-analyst/index.js

Agent 会读取授权数据、获取行情、生成 Markdown 报告到 output/。

7. 查看会话与审计

pnpm cli sessions -a
pnpm cli audit --limit 20

8. 撤销授权

pnpm cli revoke <session-id>

9. 自服务模式（HTTP API）

v1.0 新增 HTTP 服务器模式：Agent 作为独立服务运行，提供 Web UI 和 REST API。用户可以直接在浏览器中粘贴 Token 进行分析，无需运行 CLI。

node examples/stock-analyst/server.js
# 访问 http://localhost:3080/ 粘贴 Token 即可
# 或通过 API 调用：
curl -X POST http://localhost:3080/analyze \
  -H 'Content-Type: application/json' \
  -d '{"token":"...","gateway_url":"..."}'

部署到 Digital Ocean 后即为公共服务，任何人连接即可使用。见完整 README。

10. 远程模式：通过 Gateway 访问

如果 Agent 运行在另一台机器或容器里，可以用 apps/gateway 把本地 Memory Guard 暴露为 HTTPS + mTLS 入口。Agent 会通过 mTLS 连接 Gateway，先做聚合查询，再读取授权数据，最后生成报告、上传 Payload、提交删除证明。

一键端到端测试（含本地模式和远程 Gateway 模式）：

./scripts/test-stock-analyst.sh

或手动执行 Gateway 流程：

./scripts/generate-gateway-certs.sh
node apps/gateway/dist/index.js
# 然后在另一个终端用 --output 授权，设置 UOMP_BASE_URL=https://localhost:9443 运行 Agent

分析维度：盈亏分析、行业分布（含目标偏差）、集中度 HHI、年化波动率、Beta、止损/止盈信号、回撤告警、组合波动率、中英双语报告。

完整配置见 apps/gateway/README.md。

查看完整 README → 实现设计