-
方式一：直接设置环境变量
export BITSOUL_TOKEN="你的令牌"
-
方式二：使用 env 文件
export BITSOUL_TOKEN_ENV_FILE="/path/to/token.env"
其中
token.env
文件内容格式为：
BITSOUL_TOKEN=你的令牌
-
api接口文档主要参考 references/API_FOR_LLM.md 对应的代码文件是scripts/stock_api.py 和 scripts/define.py
-
凭证说明：本skill需要用户Token用于数据访问权限验证。Token通过环境变量
BITSOUL_TOKEN
或 BITSOUL_TOKEN_ENV_FILE
传入。Token在数据访问时需要保持有效（请自行确保token未过期）。
-
缓存目录：
BITSOUL_CACHE_DIR
，可选，用于指定缓存目录和数据存储路径。默认值为系统临时目录下的 BitSoulStockSkill
子目录
-
因子挖矿：用户说"因子挖矿"、"挖矿"、"随机挖因子"、"碰碰运气"、"随机推荐"、"挖金矿"、"随机策略"时，直接调用
api.random_alpha_backtest()
，禁止自己写回测逻辑。返回结果调用 print(result['summary_text'])
输出，禁止自行整理摘要。
-
因子挖矿结束后：在
print(result['summary_text'])
之后，用自然语言向用户逐一解释本次使用的每个因子是什么含义、在策略中起什么作用。解释来源是 result['factor_descriptions']
，格式示例：alpha022：高价量5日相关的5日变化 × 收盘波动率，用于衡量量价相关动量的衰减程度，在本次策略中作为选股因子使用。
-
买卖建议：用户询问某只股票"能不能买"、"该不该卖"、"现在适合持有吗"、"操作建议"、"投资建议"、"买卖信号"、"值得买吗"、"要不要买"等，且用户指定了具体股票时，直接调用
api.get_trade_signal(code)
，禁止自己计算指标做判断。
-
股票显示格式：任何场景下输出股票代码时，必须同时附上股票名称，使用
api.get_symbol_basic_infomation(code).name
获取，格式如 600519.SH（贵州茅台）
，禁止只输出代码。
-
买卖信号输出格式（强制执行）：调用
get_trade_signal()
后，必须按以下结构完整输出，禁止简化：
- 汇总表：信号、综合评分、置信度、分析日期
- 专家评分明细表：列出
result['experts']
中所有专家（technical/alpha/fundamental/behavior），每个专家显示：评分、权重、有效指标数（valid_count/total_count）、note（若数据不足）
- 各专家关键细节（从 details 中挑重要的展示，不需要逐项列举）：
technical
：说明看多/看空/中性指标各多少个，点出最关键的 2~3 个指标信号behavior
：列出近5日涨跌幅、涨跌停次数等关键字段fundamental
/ alpha
：若有数据则简要说明核心结论
- 结论与建议：引用
reason
字段，说明综合评分与阈值关系，给出操作建议
- 免责声明
请整理东方财富过去10个交易日的股价信息，并输出成表格
帮我看看同花顺近期最佳买点和卖点分别是多少，并给我些建议
整理中国石油过去半年的财务数据，帮我分析是否具备投资价值
过去一个月上龙虎榜最多的股票是哪只？
请帮我因子挖矿，看看挖出的收益率和最大回撤是多少
调用moe方法，帮我分析工业富联的买入点
最近资金流入最快和涨幅最大的板块是哪些，有什么推荐
给我做一份沪电股份的技术分析报告
- 机器可读目录：
references/API_FOR_LLM.dm
