DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

XiRuize /

XiRuize/fin-agent-workbench

Topic repository only

基于 DeepSeek Harness 的金融智能体工作台:四栏人机协同、假设核准、证据链、研报生成与一键导出。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@303e555d

Fin Agent Workbench

基于 DeepSeek Harness 的金融智能体工作台:把「研究 → 假设核准 → 报告生成 → 导出 → 回滚」放进一个模式化工作台。

License Status DSH

Status: M0 已完成;M1/M2 已规划。 协议、领域服务、架构文档已在库;下一步是 DSH 承载 spike 与「左轨 + 主画布 + 可折叠 Dock」工作台。

接手开发请先读 HANDOFF.md:仓库状态、蓝图、UI 规范与新对话提示词都在里面。


为什么做这个

金融 Agent 的瓶颈通常不是「会不会聊天」,而是四件事:

  1. 数字不可追溯:模型写了一个目标价,却说不清用的是哪份财报、哪个公式、哪次计算。
  2. 假设没有核准:看多/看空逻辑埋在聊天记录里,没有人签字,也没法追责。
  3. 报告不可回退:改了三版之后,找不到「投委会通过的那一版」。
  4. 工具权限失控:浏览器、代码、数据接口全都交给一个 Agent,没有角色边界与审计。

Fin Agent Workbench 把这些问题当作一等对象:数字有 source_id / compute_id,假设有状态机与审批记录,报告有 Git 版本与 manifest,工具按角色授权。


它是什么

一个「左轨 + 单主画布 + 可折叠 Dock」的工作台:

┌────┬──────────────────────────────────────────────┬─────────────┐
│ 模 │ 顶栏:标的 / as-of / 搜索 / 助手 / 布局 / 导出   │  右 Dock     │
│ 式 ├──────────────────────────────────────────────┤  280–360px   │
│ 轨 │              主画布(按模式切换)                │  可折叠      │
│ 56 │                                              │             │
├────┴──────────────────────────────────────────────┴─────────────┤
│ 状态栏:数据新鲜度 · 模型 · token · 保存状态 · 版本                │
└──────────────────────────────────────────────────────────────────┘
  • 模式:研究、行情、文件、报告、核准、看板;1–6 或左轨切换。
  • 研究模式:文件树 + 报告画布 + 假设/证据检查器 + 左侧对话 Dock + 底部迷你 K 线。
  • 行情模式:自选 + 全宽 K 线 + 成交量 + MA/MACD/RSI + 标的详情。
  • 报告模式:大纲 + 块级预览/编辑 + 属性/评论;源码是高级 Tab。
  • 折叠:对话/检查器/文件树都可收起;Focus 模式隐藏全部 Dock。

配套能力:一键导出 PDF/PPTX/DOCX、回合级版本回退、投研驾驶舱与运营看板。完整 UI 规范见 docs/design/ui-shell.md。


架构

┌──────────────────────────────────────────────────────────────────┐
│ L2 体验层   DSH Web Shell + 模式化工作台(左轨 / 画布 / Dock)      │
├──────────────────────────────────────────────────────────────────┤
│ L1 领域层   FastAPI:假设 / 证据 / 数据 / 计算 / 渲染 / 导出       │
│              MCP Gateway:行情、公告、财报解析、估值、图表          │
├──────────────────────────────────────────────────────────────────┤
│ L0 内核     DSH:agent loop / tools / subagents / skills / sandbox │
│             存储:Postgres + 对象存储 + Git                         │
└──────────────────────────────────────────────────────────────────┘

边界:

  • DSH 是唯一的 agent loop。领域层只提供工具与状态,不自己跑 agent。
  • 所有数字由确定性代码计算,LLM 只负责解释与组织。
  • 浏览器/代码/导出都通过受限工具槽执行,按角色授权并留审计。

更多设计见 docs/architecture.md。


设计原则

  1. 唯一编排器:不在 DSH 之上再叠 LangGraph/CrewAI;审批用状态机,不用第二套 agent 框架。
  2. 数字与叙事分离:compute_id 可复算,source_id 可下钻;美工智能体没有数据权限。
  3. 假设是一等对象:draft → submitted → under_review → approved/rejected → frozen,每次变更写审计日志。
  4. 回合即提交:每个 agent turn 结束做一次 Git 快照;「大版本」= tag;回退开新分支,不 hard reset。
  5. 许可优先:默认 MIT / Apache-2.0;AGPL 与无 LICENSE 的组件不进闭源主链路。

仓库结构

.
├── HANDOFF.md                   # 新对话接手入口
├── docs/
│   ├── architecture.md          # 三层架构与关键流程
│   ├── roadmap.md               # M0–M5 路线图
│   ├── design/ui-shell.md       # UI / 前端实现基准
│   ├── blueprint/               # M1/M2 蓝图(md + json)
│   ├── handoff/                 # 新对话提示词
│   ├── adr/                     # 架构决策记录
│   └── research/                # 选型调研底稿
├── packages/
│   └── contracts/               # Hypothesis / Artifact JSON Schema
├── services/
│   └── domain/                  # FastAPI 领域服务(假设、审计)
├── scripts/
│   └── export_blueprint.py      # 导出蓝图 JSON/Markdown
├── .github/workflows/           # CI
├── CONTRIBUTING.md
└── LICENSE

后续会加入 apps/workbench(DSH 插件 / 模式化 UI)与 infra/(本地 compose)。


快速开始

领域服务

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install -e "services/domain[dev]"
uvicorn app.main:app --reload --app-dir services/domain

打开 http://127.0.0.1:8000/docs 查看 API。默认数据库 services/domain/data/domain.db,可用 FINA_DB_PATH 覆盖。

pytest services/domain/tests -q

契约

packages/contracts/ 下的 JSON Schema 是前后端与 Agent 的共同契约,改字段先改 schema。


路线图

阶段 目标
M0 仓库、架构、契约、假设领域 API
M1 工作台壳 / 模式切换、文件树、报告画布、行情模式
M2 假设核准 UI、EvalGate、审计时间线
M3 数据网关、确定性估值、provenance
M4 报告 DSL、PDF/PPTX 导出、版本回退
M5 投研驾驶舱、权限/合规、评测集

详见 docs/roadmap.md。


参与

  • 先开 Issue 描述问题或需求,再开 feat/<issue>-<slug> 分支。
  • 提交信息用 Conventional Commits:feat(domain): add hypothesis transition API。
  • PR 必须通过 CI,并说明「改了什么、为什么、怎么验证」。
  • 不提交密钥、真实客户数据或未授权的行情数据。

见 CONTRIBUTING.md。


License

Apache-2.0。第三方依赖与许可见 THIRD_PARTY_NOTICES.md(待补)。

—/ 5

No ratings yet

Manifest verification required

Commit 303e555de5fa

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout