# 怪兽的家评估套件

更新日期：2026 年 10 月 2 日。本文按 `main` 源码版本 5.1.777 核对，已发布安装包以实际版本为准。

## 介绍

**GSDJDesktop 桌面客户端** 是"怪兽的家 资产评估工作套件"的核心组件，专为资产评估行业的专业用户设计。它提供了一个功能齐全、易于操作的本地化工作环境，同时又有可私有化的后台的数据计算服务、AI 大模型服务、各类数据库服务作为支撑。

当前源码基于 **Electron 44 + Angular 22 + TypeScript 6** 构建，核心能力包括：
- **Deep Agent Harness 2.0**：完整的 Agent 执行引擎，支持 MCP 工具调用、Skills 白名单过滤、工作流执行和多步任务分解
- **服务端协同**：任务执行前先由云端服务做工作流路由和缺失输入判断
- **多模型支持**：兼容 OpenAI、通义千问、Anthropic 等任何 OpenAI 兼容的 API 服务
- **流式响应**：实时流式输出，支持长文本和逐步推理
- **知识库集成**：内置 RAGFlow 支持，可基于企业知识库进行问答
- **Human-in-the-Loop**：关键步骤支持人工确认，保证执行可控
- **长期记忆**：保持完整对话历史，支持项目级长期记忆

文件与任务处理还包括：

- **折旧摊销表持久化加固**：改善折旧摊销计算表的保存与生命周期处理，避免数据丢失
- **大文件渐进加载**：部分工具采用渐进式加载；二进制读取接口设有 512 MiB 上限，不代表所有文本读取均无阻塞
- **工作流控制**：支持工作流暂停、恢复与重启
- **紧凑状态检查点**：工作流检查点支持紧凑表示；恢复仍要求宿主持久化了完整可用状态
- **Python 运行时缓存**：预装常用 Python 包并持久化 venv 缓存，加快工作流工具执行

它支持复杂的评估任务和数据处理，帮助用户在高效、安全的环境中完成各种评估工作。

## 登录

用户在窗口内输入用户名、登录密码，点击“进入”按钮进行登录验证。

系统默认“记住密码”和“方便快速操作系统”。

（系统目前支持钉钉扫描登录，服务器中如果已经登记）

![image-20260621220448407](https://guaishoudejia.com/assets/img/image-20260621220448407.png)

## 工作区列表（主界面）

用户登录成功后，应用会自动跳转到工作区列表页面。工作区列表是从企业服务器中实时同步获得的，包含所有预先设置的工作区。每个工作区都对应不同的项目，便于用户按需选择和管理。具体功能描述如下：

#### **同步更新：**

工作区列表会自动从企业服务器同步更新，确保用户看到的始终是最新的工作区信息。

#### **项目分类：**

不同的项目隶属于不同的工作区，用户可以根据项目的分类快速找到所需的工作区。

### **简洁明了的界面：**

工作区列表界面设计简洁明了，方便用户快速浏览和选择所需的工作区。

界面如下图：

![image-20260621220631575](https://guaishoudejia.com/assets/img/image-20260621220631575.png)

### **1.** **登录系统**

1. 打开桌面客户端应用程序。
2. 在登录界面输入企业分配的用户名和密码（支持钉钉登录）。
3. 点击“登录”按钮进入系统。

### **2.** **退出系统**

1. 点击左侧导航栏中的用户头像下方的“退出”按钮。
2. 确认退出系统。

 

## 同花顺 Excel 强化登录与企业代理

行情指标、交易日、板块和历史成员通过同花顺 FT 网页接口取数；不再要求用户填写旧 THS API access_token。组织登录与同花顺网页登录是两套认证。

1. 在「系统设置 → 同花顺服务」完成「同花顺」强化登录。登录窗口使用 iFinD Mac Excel 流程，应等待 FT 落地页完成会话交换；仅看到旧 Cookie 或打开了页面不等于重新登录成功。
2. 组织配置 `thsserver` 时，登录流量通过该服务器的 CONNECT 隧道；取数由 Desktop 主进程提交到 `/ths_ft/request`，使用企业共享账号池。没有本地凭据时，仍可借用池中空闲账号。
3. 未配置 `thsserver` 时，使用本地网页登录凭据直连 FT。远程服务失败时不会自动换成本地账号。

「快查」入口服务于企业信息查询；行情权限与登录是否有效，应以实际取数结果为准。当前本地登录状态检查不等于向上游验证了账号权限。

| 远程状态 | 含义与处理 |
| --- | --- |
| 401 | 组织 JWT 无效；客户端经现有认证拦截器刷新后重试一次，仍失败时检查组织登录 |
| 424 | 上游网页登录凭据失效，需重新登录 |
| 428 | 共享池没有可用凭据，需提供有效登录 |
| 429 | 可用账号正被占用，稍后重试 |

Cookie 由主进程处理，不返回 Angular。远程传输要求 HTTPS；本机 NAT 隧道允许 loopback HTTP。实际账号权限、网络出口和部署连通性需在使用环境验证。

## 工作流与结果恢复

工作流执行使用共享 `GSDJWorkflowEngine`；Desktop 保存本地 SQLite 运行记录，运行轨迹由 `GSDJAgentTrace` 记录。暂停、继续、重启和终止各有不同语义，请先查看当前运行状态与输出，再决定是否重新开始。

历史记录、运行轨迹与可恢复检查点不是同一件事。异常退出后，只有已保存的完整状态才能用于恢复；显示过结果或仍能查看任务条目，并不保证断点可继续。需要跨宿主排查时，参见 [AI 集成说明](/AI%E9%9B%86%E6%88%90.md) 和 [开发说明](/%E5%BC%80%E5%8F%91/%E8%BD%AF%E4%BB%B6%E5%BC%80%E5%8F%91%E7%BB%86%E8%8A%82.md)。