dsh-financial-analysis

方式一：从 npm 安装（推荐，面向使用者）

插件发布到 npm 后（包名 dsh-financial-analysis）：

# 在插件包目录内（相对路径会锚定到当前目录），或使用绝对路径
cd ${your_dir}\financial-analysis-plugin
dsh plugin --profile web add .

安装后同样执行方式一中的**「必做」复制步骤**，并重启 dsh web。

方式三：用户预设目录部署（免 pnpm，仅预设能力）

不装 bundle、只要「财报分析师」预设时，直接把 preset 复制到用户预设根 （发现是"每次读取"式的，新会话立即可见，无需重启、无需 pnpm）：

Windows（PowerShell）

$dest = "$env:USERPROFILE\.dsh\.agent-presets\financial-analyst"
New-Item -ItemType Directory -Path $dest -Force | Out-Null
Copy-Item -Path "${your_dir}\financial-analysis-plugin\config\agent-presets\financial-analyst\*" `
          -Destination $dest -Recurse -Force

macOS（Apple）/ Linux（bash 或 zsh）

dest="$HOME/.dsh/.agent-presets/financial-analyst"
mkdir -p "$dest"
cp -R "${your_dir}/financial-analysis-plugin/config/agent-presets/financial-analyst/." "$dest/"

（${your_dir} 为插件源码所在目录，例如 D:/aispace 或 /home/user/aispace）

---

三、使用步骤

1. 启动 DSH Web（若未运行）：dsh web，打开浏览器访问 Web 界面（默认 http://127.0.0.1:3080）。
2. 新建会话并选择预设：在 Agent 预设列表中选择 「财报分析师」（financial-analyst）； 若列表未出现，先确认方式一中的「必做」复制步骤已执行，再刷新页面。
3. 开始提问，例如：
   • “帮我分析某公司的资产负债表，重点看存货和合同负债的变化说明什么”
   • “分析这家公司的现金流量表：经营/投资/筹资都是什么方向？”
   • “验证三张报表的钩稽关系：它是不是先搞钱再扩产？”
   • “在软件上怎么看这家公司的营收结构和海外占比？”
   • “用 AKShare 拉取某公司最近几期季报和年报的三大报表，并做一份完整分析”
   • “帮我搜索某公司最新一期的财报数据（营收/净利/研发费用等）”
   • “综合评估一下这家公司的财务健康状况和风险信号”
4. Agent 会按需加载对应技能（balance-sheet-analysis 等）并按照提炼的规则输出结构化分析； 分析新案例时，通过**财经数据 API（AKShare、Tushare，Python 运行）或网络公开信息 （新浪财经、东方财富，web_search 检索）**获取最新财务报告，注明报告期与来源并交叉核验。

---

四、环境依赖

能力	依赖	说明
财经数据 API（AKShare/Tushare）	Python 3.9+，pip install akshare tushare pandas	agent 通过 pwsh 运行 Python 取数；未安装时自动回退到网络公开信息
Tushare	需在 tushare.pro 注册并配置 token	未配置 token 时自动改用 AKShare 或网络公开信息
网络检索（web_search）	部署自带 web 服务（deepseek-official 提供方）	标准 web profile 自带，无需额外配置
行情软件查看	无（操作指南）	仅作为查看方法说明

---

五、能力内容

技能	覆盖内容
balance-sheet-analysis	时点快照概念、恒等式、科目两面性；货币资金/应收/存货/固定资产/在建工程/商誉/合同负债/预付/借款/权益的判断规则；结构比重→同比环比→商业模式互验三步框架；风险信号
income-statement-analysis	时间段概念、层层剥开结构；收入/成本/毛利率/四费/营业利润/营业外收入/净利润规则；六步框架；行业费用结构特征（半导体高研发低销售、化妆品反之）
cash-flow-analysis	流水账概念、最难造假；三大结构；销售收现/购买付现/CAPEX/筹资分红科目规则；经营+投资−筹资−等正负号组合情景判断；风险信号
three-statement-articulation	三表定位（根基/过程/结果）；商业模式四循环；筹资/投资/经营三步对应；案例验证法（先搞钱→等订单→扩产→放量）；利润表看增长内驱力
finding-financial-reports	F10资料→经营分析→财务分析路径；资产负债表百分比报表；利润表单季环比；现金流量表三大结构；财经数据 API（AKShare/Tushare）与网络公开信息（新浪财经/东方财富/web_search）获取最新财报

核心分析铁律：不看公司自我介绍看科目构成；没有无缘无故的大涨大跌；用"破案"视角交叉验证三张报表；科技公司先看研发费用；经营(−)+投资(−)+筹资(+)为危险组合；新案例用财经数据 API 或网络公开信息获取最新数据，注明报告期与来源。

---

六、验证清单

• dsh plugin --profile web list 能看到 dsh-financial-analysis（方式一/二）
• $DSH_HOME/.agent-presets/financial-analyst/ 存在且含 agent.cordis.yml、preset.yml 与 skills/（「必做」复制步骤）
• Web 新建会话时预设列表出现「财报分析师」（刷新页面）
• 提问后 agent 能调用 web_search 与 pwsh（运行 Python 取数），并输出结构化分析

---

七、常见问题

Q1：新预设没有出现在列表里？ 先确认执行了方式一中的「必做」复制步骤——preset 应位于用户预设根 $HOME/.dsh/.agent-presets/financial-analyst（Windows 为 %USERPROFILE%\.dsh\.agent-presets\financial-analyst， 不是 .dsh/skills），再刷新页面；新预设无需重启进程。

Q2：dsh plugin 报 pnpm 错误？ 安装 pnpm（npm install -g pnpm 或 corepack enable pnpm）后重试；或直接使用方式三。

Q3：只想加技能不想换预设？ 把 skills/ 下任意 SKILL.md 复制到项目 .dsh/skills// 或 $DSH_HOME/skills/ 即可被通用发现。

Q4：如何卸载？ 方式一/二：dsh plugin --profile web remove dsh-financial-analysis；方式三： 删除 $env:USERPROFILE\.dsh\.agent-presets\financial-analyst。两种都装过则都清理。

Q5：取数失败或 akshare 报错？ 确认 Python 已装且 pip install akshare tushare pandas 成功；接口失败时 agent 会自动换备用接口 （东财→新浪→同花顺）或改用 web_search；网络受限时以官方公告/公开信息为准。

---

三、使用步骤

1. 启动 DSH Web（若未运行）：dsh web，打开浏览器访问 Web 界面（默认 http://127.0.0.1:3080）。
2. 新建会话并选择预设：在 Agent 预设列表中选择 「财报分析师」（financial-analyst）； 若列表未出现，先确认方式一中的「必做」复制步骤已执行，再刷新页面。
3. 开始提问，例如：
   • “帮我分析某公司的资产负债表，重点看存货和合同负债的变化说明什么”
   • “分析这家公司的现金流量表：经营/投资/筹资都是什么方向？”
   • “验证三张报表的钩稽关系：它是不是先搞钱再扩产？”
   • “在软件上怎么看这家公司的营收结构和海外占比？”
   • “用 AKShare 拉取某公司最近几期季报和年报的三大报表，并做一份完整分析”
   • “帮我搜索某公司最新一期的财报数据（营收/净利/研发费用等）”
   • “综合评估一下这家公司的财务健康状况和风险信号”
4. Agent 会按需加载对应技能（balance-sheet-analysis 等）并按照提炼的规则输出结构化分析； 分析新案例时，通过**财经数据 API（AKShare、Tushare，Python 运行）或网络公开信息 （新浪财经、东方财富，web_search 检索）**获取最新财务报告，注明报告期与来源并交叉核验。

---