﻿玖峰投研工作台 · 安装说明
================================================================

这是给 DSH Desktop（DeepSeek Harness）用的投研插件包。
装完之后，你的 DSH 会变成一套完整的投研工作台。


----------------------------------------------------------------
★ 系统要求（装之前先看这一条）
----------------------------------------------------------------

  能用：Windows 10 / 11（64 位）

  不能用：Windows 7 / 8 / 8.1

  为什么：本工作台跑在 DSH Desktop 之上，而 DSH Desktop 用的是
  Electron 43，Electron 从 23 版起就取消了对 Windows 7 / 8 / 8.1 的支持
  （官方要求 Windows 10 及以上）。这不是本插件包的限制，
  是底层框架的硬性要求，换任何装法都一样。

  32 位系统同样不支持（只发布 x64 版本）。

  如果你的电脑是 Windows 7，请先升级系统；装的时候安装程序也会
  直接提示"系统版本过低"，不会装到一半报错。


----------------------------------------------------------------
怎么装（推荐：一键安装包）
----------------------------------------------------------------

  1. 双击 Jiufeng-Invest-Setup.exe

  2. 一路「下一步」。中途会弹出一次「用户账户控制」，
     点「是」放行即可（最后一步要写 DSH 的安装目录，必须提权）。

  3. 完成页有两个选择：
       · 勾选「立即打开 玖峰投研工作台」→ 装完直接进应用
       · 只点「完成」→ 之后双击桌面上的「玖峰投研工作台」图标

  装完后桌面上只有一个「玖峰投研工作台」图标（DSH 自带的那个会被清理掉）。


----------------------------------------------------------------
备用装法（解压 + install.bat）
----------------------------------------------------------------

  如果你拿到的是 zip 包，而不是 exe：

  1. 先把整个压缩包解压出来
     （要在解压出来的文件夹里操作，不要直接双击压缩包里的文件）

  2. 双击 install.bat

  3. 跟着提示走。中途可能弹出一次「用户账户控制」，
     点「是」放行即可。

  4. 装完双击桌面「玖峰投研工作台」图标


----------------------------------------------------------------
★ 装完之后：只需要填一次 API Key
----------------------------------------------------------------

  除了下面这一件事，其它什么都不用配。

  窗口模式、插件市场、通知偏好都在安装时替你设好了
  （兼容模式 / 插件市场关闭 / 通知开启），打开就是玖峰投研工作台的
  正式界面 —— 不会再弹 DSH 的「选择窗口模式」设置向导，
  也不会先弹一屏「内测声明」。

  （安装期间 DSH 会跑一次「首次初始化」，大约 1-2 分钟。那一次的窗口是
   藏起来运行的，全程不会弹任何需要你点的窗 —— 那不是卡住，等它跑完就行。）

  第一次打开会看到「添加一个 API Key 开始使用」，填上你自己的 Key 就能
  开始对话（DeepSeek 官方 / 通义 / 智谱 等任选一个）。

  ★ 这个弹窗只在第一次打开时出现一次，装的时候不会再问一遍。

  作者本机用的是自己的 API Key，额度是个人的，没法分发给别人。

  不填也能打开界面、能看到全部卡片，
  但一发起对话就会报错 —— 因为后端没有可用的模型。


----------------------------------------------------------------
使用数据说明（请花 10 秒看一眼）
----------------------------------------------------------------

  软件会匿名记录三项信息，用于改进产品：

    · 使用时长，以及每天打开软件的次数
    · 用到了哪些功能（只记功能名与次数）
    · 程序报错信息，用于定位故障

  不会记录：你查询的股票、自选股、持仓、文档内容，以及任何输入的文字。
  样本以匿名设备号区分，不含任何账号信息。

  这项记录默认开启。想关掉：侧边栏最底部的 ⚙（关于与更新）
  → 找到「使用数据上报」，点一下变成「已关闭」即可。
  同一行的「查看告知」可以随时复查完整说明。


----------------------------------------------------------------
包里有什么
----------------------------------------------------------------

  install.bat        双击运行这个，一键安装
  install.ps1        安装脚本本体（install.bat 会调用它）
  app-patch.ps1      应用外观补丁（图标 / 品牌文案 / 更新守卫）
                     install.ps1 最后一步会自动调用它
  README.txt         本说明文件

  plugins/
    dsh-ai-invest-sidebar/   投研工作台侧边栏
                             7 个分析师工作流 + 104 个专业技能
    dsh-finance-tools/       21 个金融数据工具

  agent-preset/
    ai-finance/              投研 Agent 预设（89 个技能，含多空辩论）

  icons/                     品牌图标（应用图标 / 托盘图标 / 快捷方式图标）

  如果本包内还带有一个 DSH-Desktop-xxxx-Setup.exe，
  那是 DSH Desktop 官方安装程序，会在你需要时自动调用。


----------------------------------------------------------------
装到哪里（一共四层）
----------------------------------------------------------------

  1. 侧边栏界面      %USERPROFILE%\.dsh\jiufeng-plugins\dsh-ai-invest-sidebar
  2. 金融数据工具    %USERPROFILE%\.dsh\jiufeng-plugins\dsh-finance-tools
  3. 投研 Agent 预设 %USERPROFILE%\.dsh\.agent-presets\ai-finance
  4. 应用外观        DSH 安装目录（图标、品牌文案、更新守卫）

  同时会改这几处配置：

    · %USERPROFILE%\.dsh\profiles\<profile>\package.json
      挂上两个插件依赖与 bundle
    · %USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml
      停用 6 个与投研无关的插件行（遥测、消息反馈、Open In 等）
    · %USERPROFILE%\.dsh\settings.yaml
      默认 Agent 预设设为 ai-finance
      并补上窗口模式（兼容模式）/ 通知偏好 / 插件市场开关
    · %APPDATA%\DSH Desktop\profile-setup\<哈希>\state.json
      写入「设置向导已完成」标记 —— 这一份就是让向导不再弹出的关键
    · %APPDATA%\DSH Desktop\profile-preferences\<哈希>\state.json
      偏好记录（窗口模式 / 通知 / 插件市场）
    · %APPDATA%\DSH Desktop\desktop-market\state.json
      插件市场 = 关闭
    · %USERPROFILE%\.dsh\icons\
      铺品牌图标

  改之前都会自动备份（文件名带 .bak-jiufeng-时间戳）。

  重复运行是安全的：已经正确的配置不会重复改，也不会重复备份。
  升级插件版本时，直接再双击一次 install.bat 即可。


----------------------------------------------------------------
装完会看到什么
----------------------------------------------------------------

打开 DSH Desktop，左侧栏会变成：

  · 投研工作流   —— 7 个分析师工作流
  · 专业工具     —— 104 个专业技能，分成 7 类
  · 历史对话

把窗口拖窄、或点标题栏的「收起侧边栏」，左侧栏会收成一条图标轨道
（工作流 + 工具分类 + 展开按钮），点任意图标就展开回来。

跟 Agent 对话时，用的是「AI金融投研」预设 ——
89 个投研技能随时可调用，包括多空辩论、技术面诊断、DCF 估值等。

21 个金融数据工具（行情 / 财报 / 资金流 / 龙虎榜 …）直接可用，
不需要配任何数据源 Key。
股票代码搜索也开箱可用（用的是公开的搜索接口，不需要账号）。


----------------------------------------------------------------
常见问题
----------------------------------------------------------------

Q：提示"禁止运行脚本"或"无法加载文件"？
A：请双击 install.bat 来运行，不要直接右键 install.ps1 运行。
   install.bat 里面已经带了绕过执行策略的参数。

Q：中途弹出「用户账户控制」要怎么办？
A：点「是」。最后一步要往 DSH 的安装目录写图标和品牌文案，
   必须管理员权限。脚本会自己申请，你不用手动右键"以管理员身份运行"。

Q：提权时我点了「否」怎么办？
A：功能不受影响，只是图标和品牌文案还是 DSH 默认样式。
   想补做：右键 install.bat → 以管理员身份运行。

Q：提示找不到 DSH Desktop？
A：说明你还没装 DSH。
   如果本包里带了 DSH 安装程序，脚本会自动帮你装；
   如果没带，去官网下载安装后再运行本脚本：
   https://github.com/anywhere-labs/dsh-desktop/releases/latest

Q：对话一发起就报错？
A：还没有填 API Key。见上面「装完之后：只需要填一次 API Key」。

Q：怎么没让我选「窗口模式」？跟官方教程不一样。
A：安装时已经替你设成「兼容模式」并标记为已完成，所以不再弹这个向导。
   想改成别的模式：DSH 设置里可以随时改，
   玖峰投研侧边栏在三种模式下都在。

Q：怎么关掉使用数据上报？
A：侧边栏最底部的 ⚙（关于与更新）→「使用数据上报」点一下变成「已关闭」。
   同一行的「查看告知」是完整说明。

Q：装完了但界面没变化？
A：请完全退出 DSH Desktop（注意右下角托盘图标也要退），
   然后重新打开。

Q：联网搜索用的是什么？
A：DSH 自带的搜索服务。作者本机接的是第三方搜索 API，
   但那是个人凭据、无法分发，所以这里不接管，用 DSH 默认的。
   想换成别的搜索服务，可以在 DSH 设置里自行配置。

Q：怎么卸载？
A：按四层逐一删：

   1. 删目录  %USERPROFILE%\.dsh\jiufeng-plugins
   2. 删目录  %USERPROFILE%\.dsh\.agent-presets\ai-finance
   3. 还原    %USERPROFILE%\.dsh\profiles\<profile>\package.json
              → 用同目录下 package.json.bak-jiufeng-* 备份
   4. 还原    %USERPROFILE%\.dsh\settings.yaml
              → 用同目录下 settings.yaml.bak-jiufeng-* 备份
              （安装时往里面补过的 dsh-desktop / dsh-desktop-notifications /
                ui-onboarding 三段，可以直接删掉）

   还有安装时写的三份首启状态文件，想彻底还原就删掉：

     %APPDATA%\DSH Desktop\profile-setup
     %APPDATA%\DSH Desktop\profile-preferences
     %APPDATA%\DSH Desktop\desktop-market

   删掉它们只是让 DSH 下次启动重新弹一次设置向导，不影响插件使用。

   应用层的图标和品牌文案想还原，以管理员身份运行：

     powershell -NoProfile -ExecutionPolicy Bypass -File app-patch.ps1 -Revert


----------------------------------------------------------------
关于 DSH Desktop
----------------------------------------------------------------

DSH Desktop（DeepSeek Harness）由 anywhere-labs 开发，以 MIT 许可发布：

  https://github.com/anywhere-labs/dsh-desktop

如果本包内附带了它的安装程序，那纯粹是为了让你一次装好，
版权归原作者所有，安装程序未经任何修改。


----------------------------------------------------------------
许可
----------------------------------------------------------------

本插件集以 MIT 许可发布：

  https://github.com/haiting202-web/jiufeng-invest

源码也在上面这个仓库里，欢迎提 issue。
