技能介绍

要解决什么问题

很多人用 自选理财助手（韭菜账本） 记基金、A 股、 crypto、贵金属等持仓，但对话式助手若不能对接官方 Agent API，就只能让用户手工抄代码、成本和数量，还容易和 App 里的账本不一致。本技能把读写边界钉死在「账本记录」上：不代下单、不划转资产，也不代表券商或交易所授权。

技能如何工作

运行前只需配置 PORTFOLIO_AGENT_TOKEN（从环境或密钥读取；不要在公开聊天或仓库里粘贴）。所有请求带指定 User-Agent 等头，避免 Cloudflare 1010；后端用 Token 识别用户，无需传 userId。

核心流程大致如下：

持仓 CRUD：增删改前先 GET /api/AgentPortfolio/assets；删之前复述类型、代码、名称并确认；改成本或数量时展示旧值与新值；写操作后再拉列表汇总结果。
单品今日分析：对用户已保存的标的，优先 GET /api/AgentPortfolio/assetAnalysis/today；若 queryStatus 为 processing 则提示稍后重试；完成后归纳 analysis_summary、operation_advice 等字段，并说明仅供参考。
截图与市场辅助：从支付宝、券商、交易所等截图提取名称、代码、数量、成本等；用只读接口搜索候选、拉参考价；仅有市值和盈亏时可走 /api/AgentPortfolio/resolve 反推估算量，明确标注为估算，待用户确认后再写入。
组合分析与日报：支持持仓分析、读取或生成当日报告缓存（忙时可能 429，分析超时 504 时 CRUD 与日报仍可能可用）。

资产类型需规范化：fund（基金代码）、stock（东财 secid）、crypto（大写符号）、metal（如 118.AU9999）；A 股代码多种写法可由后端归一。

适用边界与注意点

401/403 通常表示 Token 缺失、过期或权限不足，应在 App 内复制或重置 Agent Token。409 表示标的已存在，应走更新而非新增。分析接口返回的建议不是交易指令；任何「买/卖/加/减」讨论都应提醒用户自行决策。辅助行情与 resolve 结果有缓存，同一用户请求不必反复轮询。

截图预览

使用场景

对照券商或支付宝 App 截图，提取基金/股票代码与数量，经候选搜索与报价核对后写入韭菜账本并回查列表确认。
账本里已保存的某只标的，需要拉取当日单品分析接口，汇总趋势、市场情绪与操作建议（处理中则提示稍后重试）。
修改某条持仓的成本价或份额前，先 GET 当前资产列表，展示旧值与新值，用户确认后再调用更新接口。
删除重复或错误录入的持仓时，复述 assetType、代码与名称，用户确认删除后再次查询 holdings 核对最终状态。

适合人员

在自选理财助手里维护基金、A 股、crypto、贵金属等多类持仓，希望用自然语言做增删改查而非反复手填代码的个人投资者。
每周用券商或交易所 App 截图对账，需要把识别出的数量、成本与参考价整理成待确认变更清单的运营型持仓维护者。
关注单品当日解读与组合日报，想在对话里读取 analysis 或 daily report，但清楚这些内容不能当作下单指令的记账型用户。
已为韭菜账本配置 Agent Token，需要在助手侧安全使用环境变量鉴权、并处理 401/409/Cloudflare 1010 等 API 反馈的技术向理财用户。