name: investment-tracker description: 投资组合管理助手。可查询/更新持仓、现金、日记、权益曲线，以及通过截图导入持仓。 user-invocable: true metadata: {"openclaw": {"emoji": "📈", "requires": {"bins": ["curl"]}, "primaryEnv": "DASHSCOPE_API_KEY"}}

Investment Tracker 操作手册

本文档供 AI 代理使用。基础 URL：http://localhost:8000。 接口详情见 references/api-docs.md。

全局规则

操作分级

通用错误处理

工作流 A：截图导入持仓

触发词：上传截图、导入持仓、更新持仓、今天持仓、截图持仓

Step 1：上传截图，获取分析结果

curl -sS -X POST http://localhost:8000/api/external/upload \
  -F "images=@<图片绝对路径>" \
  -F "notes=<用户补充说明，无则省略>" \
  -F "portfolio_date=<YYYY-MM-DD，无则省略>"

多张截图时重复 -F "images=@<路径>" 参数。

解析返回结果，向用户展示：

• summary：AI 点评
• diff.added：新增持仓（代码、名称、股数）
• diff.removed：移除持仓（代码、名称）
• diff.modified：变动持仓（代码、名称、before/after 对比）
• diff.unchanged_count：未变动数量
• total_assets / total_pnl（若不为 null）

必须暂停，向用户提问：

"分析完成，是否确认将以上变动更新至持仓系统？"

Step 2：用户确认后，提交持仓更新

将 Step 1 返回的 analyzed_holdings 数组写入临时文件，然后提交：

# 将 analyzed_holdings 写入临时文件（在当前工作目录）
echo '<analyzed_holdings 的 JSON 数组>' > /tmp/holdings_update.json

curl -sS -X POST http://localhost:8000/api/holdings/bulk \
  -H "Content-Type: application/json" \
  -d "{\"holdings\": $(cat /tmp/holdings_update.json), \"label\": \"<YYYY-MM-DD> 截图导入\"}"

rm /tmp/holdings_update.json

成功后告知用户持仓已更新。

Step 3（可选）：更新权益曲线

若 Step 1 返回的 total_assets 不为 null，询问用户：

"本次截图识别到总资产 ¥<total_assets>，是否同时记录到权益曲线？"

用户确认后执行（日期取 Step 1 返回的 date）：

curl -sS -X POST http://localhost:8000/api/curve/point \
  -H "Content-Type: application/json" \
  -d "{\"date\": \"<date>\", \"value\": <total_assets>}"

工作流 B：查询当前持仓

触发词：查看持仓、我的持仓、现在持仓、持仓情况、持仓列表

直接执行（无需确认）：

curl -sS http://localhost:8000/api/holdings

展示格式建议（表格形式）：

若返回空数组，告知用户："当前持仓为空。"

工作流 C：现金管理

触发词：

• 查询：现金余额、账户现金、剩余资金
• 更新：更新现金、修改现金、现金改成、现金设为

查询现金（只读，直接执行）

curl -sS http://localhost:8000/api/cash

取响应中的 amount 字段，告知用户当前现金余额。

更新现金（写操作，需确认）

先告知用户将要执行的操作：

"将现金余额更新为 ¥，确认吗？"

用户确认后执行：

curl -sS -X POST http://localhost:8000/api/cash \
  -H "Content-Type: application/json" \
  -d "{\"amount\": <数值>}"

取响应中的 amount 字段，告知用户更新后的余额。

工作流 D：投资日记

触发词：

• 查看：查看日记、投资记录、操作记录、历史日记
• 新增：记一条日记、记录操作、今天买了/卖了、写日记

查看日记（只读，直接执行）

curl -sS http://localhost:8000/api/diary

按日期倒序展示，包含字段：日期、类型、股票代码、备注、情绪。

若返回空数组，告知用户："暂无日记记录。"

新增日记（写操作，需确认）

从用户描述中提取信息，先展示将要记录的内容：

"将新增以下日记，确认吗？ 日期： | 类型： | 代码： | 备注： | 情绪："

curl -sS -X POST http://localhost:8000/api/diary \
  -H "Content-Type: application/json" \
  -d "{\"date\": \"<YYYY-MM-DD>\", \"type\": \"<type>\", \"code\": \"<code>\", \"remark\": \"<remark>\", \"mood\": \"<mood>\"}"

curl -sS http://localhost:8000/api/curve

curl -sS -X POST http://localhost:8000/api/curve/point \
  -H "Content-Type: application/json" \
  -d "{\"date\": \"<YYYY-MM-DD>\", \"value\": <数值>}"

# 默认 180 个交易日
curl -sS "http://localhost:8000/api/hs300"

# 指定天数（7～1000）
curl -sS "http://localhost:8000/api/hs300?days=<N>"

curl -sS http://localhost:8000/api/imports

curl -sS -X POST http://localhost:8000/api/imports/rollback/<id>

curl -sS -X DELETE http://localhost:8000/api/imports/<id>