Company Research Report

向 GodKnows 投资分析平台提交研报。本技能为通用技能，安装到统一目录后可供 Cursor、Qoder 等多种 agent 引用。

研报类型

类型代码	说明
NEWS_REPORT	新闻研报
INVESTMENT_REPORT	投资研报
VALUE_INVESTING_ANALYSIS	价投分析

配置（与安装位置解耦）

• 推荐：使用统一配置路径 ~/.config/godknows/config.json（与技能安装位置无关，便于多端共用）。格式：

  { "api_base": "http://money.whatis.vip", "username": "xxx", "password_b64": "xxx", "token": "获取到的token" }
  

• 运行时脚本会自动从该配置文件读取 api_base 和 token。
• 与 company-checkup、cashflow-viewer、dcf-three-scenario 共用配置。

首次使用

若尚无 token，向用户询问用户名和密码，在技能根目录下执行登录脚本（将 <SKILL_ROOT> 替换为当前技能的安装根目录）：

bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]

登录成功后会写入 ~/.config/godknows/config.json（含 api_base、token、username、password_b64）。后续脚本会自动读 token。token 过期时：执行 bash <SKILL_ROOT>/scripts/login.sh（不传参），会从 config 读取账号密码并刷新 token，无需再向用户索要。config 含敏感信息，请勿泄露。

后续使用

直接使用 config 中的 token。若 API 返回 errorCode: "NOT_LOGIN"，执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token 即可，无需再向用户要账号密码。

执行流程

1. 确认研报信息

收集必填字段：

• type: 研报类型（NEWS_REPORT / INVESTMENT_REPORT / VALUE_INVESTING_ANALYSIS）
• companyName: 公司名称
• content: 研报内容

可选字段：

• stockCode: 股票代码（如 AAPL、TSLA）
• title: 研报标题
• reportDate: 研报日期（格式：yyyy-MM-dd，默认当天）

2. 提交研报

在技能根目录下执行：

bash <SKILL_ROOT>/scripts/submit.sh <type> <company_name> <content> [stock_code] [title] [report_date]

示例：

bash <SKILL_ROOT>/scripts/submit.sh "VALUE_INVESTING_ANALYSIS" "苹果公司" "基于DCF模型的估值分析..." "AAPL" "苹果2026年价值投资分析"

3. 校验提交结果

成功响应：

{"success":true,"data":1,"errorCode":null,"errorMessage":null}

校验标准：

• success 必须为 true
• data 返回有效的研报ID（正整数）

4. 错误处理

• errorCode: "NOT_LOGIN" → 执行 bash <SKILL_ROOT>/scripts/login.sh 刷新token
• success: false + 参数错误 → 检查必填字段是否完整、类型是否正确
• 网络超时 → 提示 API 不可达

其他API

方法	路径	说明
GET	/api/research-report/list	查询研报列表（支持type/stockCode/companyName筛选）
GET	/api/research-report/{id}	查询研报详情
DELETE	/api/research-report/{id}	删除研报
GET	/api/research-report/types	获取研报类型列表