股票交易技能

基于 opencli stock 插件获取 Cookie，使用 Node.js 脚本管理股票交易数据。

环境

• 脚本目录：~/.agents/skills/stock-skill/scripts/（所有命令必须在此目录下执行）
• 数据库：~/.duckdb/stock/stock.db｜Cookie 配置：~/.duckdb/stock/config｜备份：~/.duckdb/stock/backup/
• Node 版本：node v24 可正常运行（2026-09 验证）；若遇 DuckDB 原生模块加载错误，先 npm rebuild，仍失败再降级 node v20，详见 references/troubleshooting.md

命令总览

功能	命令	说明
Cookie 获取	opencli stock init	通过浏览器获取 Cookie 并写入配置文件
数据库初始化	node init-db.js	初始化表结构并同步账户信息（幂等）
交易记录同步	node sync.js [start] [end]	同步交易记录，日期格式 YYYYMMDD；自动分页、重试 3 次、幂等
交易记录匹配	node match.js [start] [end]	匹配买入/卖出，范围应 ≤ 同步范围
收益统计	node profit.js [startMonth] [endMonth]	查询网格收益，月份格式 YYYY-MM；年收益 = 年初至截止月累计。执行时自动清理 0 过户费脏数据：匹配记录按查询月份范围清理（tradeMatch 重配即修复）、交易记录仅当月清理（sync 重拉修复）；查询范围内其他历史月若仍有 0 过户费交易记录会提示用 sync.js 修复
实时行情	node quotes.js [account]	持仓实时行情，实时 API 无需同步
账户收益	node account-profit.js [account] [--json]	总资产、持有盈亏、当日盈亏，实时 API
未匹配查询	node unmatched.js [--code] [--name] [--op] [--start] [--end] [--account]	查询未配对交易记录

📋 触发词与动作映射：首次使用/init → 初始化流程；同步、拉取交易 → sync.js；匹配、配对 → match.js；收益、赚了多少、网格收益 → profit.js；行情、持仓、最新价 → quotes.js；账户收益、总资产、当日盈亏 → account-profit.js；重跑、重新匹配 → match.js [起止日期]。

⚠️ 不提供删除能力：本技能没有删除交易/匹配记录的工具，也禁止手写 SQL DELETE。数据修正一律通过幂等的 sync/match 重跑覆盖完成。

标准工作流

场景：首次使用

# 🔴 STOP · 检查点：首次使用前确认环境
# 执行前询问："首次使用需要初始化，确认继续？"

# 1. 检查 opencli stock 插件是否存在，不存在则自动复制
ls ~/.opencli/plugins/stock/init.js || cp -r ~/.agents/skills/stock-skill/resources/stock ~/.opencli/plugins/stock

# 2. 获取 Cookie
opencli stock init

# 🔴 STOP · 检查点：Cookie 获取后确认
# 执行前询问："Cookie 已获取，确认初始化数据库？"

# 3. 初始化数据库
cd ~/.agents/skills/stock-skill/scripts && node init-db.js

场景：查看收益（最常用）

cd ~/.agents/skills/stock-skill/scripts

# 步骤1：同步最新数据（用户说"同步"或"最新"时执行）
node sync.js

# 步骤2：匹配交易记录（步骤1之后必须执行）
node match.js

# 步骤3：统计收益（始终执行）；查单只股票/指定月份加参数即可
node profit.js [YYYY-MM] [YYYY-MM]

执行规则：

• 用户说"这个月收益" → 直接执行 node profit.js
• 用户说"同步并查看收益" / "最新收益" → 按顺序执行 sync → match → profit
• 结果必须以 Markdown 表格输出给用户（收益/持仓/账户等统计结果均适用），格式见下方「输出格式」

边界处理：

• Cookie 过期：同步失败时提示执行 opencli stock init 更新 Cookie
• 网络异常：提示检查网络连接后重试
• 无数据：提示是否需要同步历史数据

输出示例（仅含盈利配对，无负数；以 Markdown 表格输出给用户）：

## 📊 收益统计结果（2026-07）

| 账户 | 代码 | 名称 | 交易次数 | 收益（元） |
|------|------|------|:---:|---:|
| 国泰-冯* | 02269 | 药明生物 | 5 | 5,020.87 |
| 国泰-冯* | 512400 | 有色金属ETF南方 | 6 | 403.26 |

| 项目 | 收益（元） |
|------|---:|
| **月收益（2026-07）** | **6,654.73** |
| 年收益（2026 累计） | 75,942.36 |

场景：查看持仓实时行情

cd ~/.agents/skills/stock-skill/scripts
node quotes.js          # 所有账户；node quotes.js 冯 指定账户

实时 API，无需提前同步。

场景：查看账户收益

cd ~/.agents/skills/stock-skill/scripts
node account-profit.js            # 所有账户；node account-profit.js 冯 指定账户
node account-profit.js --json     # JSON 格式（便于程序消费）

实时调用 stock_card 接口，无需提前同步；末尾「汇总」行的当日收益率按 当日盈亏/(总资产-当日盈亏) 加权计算。回复用户时同样转为 Markdown 表格（账户名称/总资产/持有盈亏/当日盈亏/当日收益率 + 汇总行）。

场景：重跑某月配对（不删数据）

配对结果不对或想纳入新对手盘时，不删数据，直接重跑匹配（sync 幂等，会覆盖同窗口记录）：

cd ~/.agents/skills/stock-skill/scripts
node match.js 20260901 20260930
node profit.js 2026-09

注意：sync.js 采用 INSERT OR REPLACE 幂等写入，同窗口重跑即数据修正的唯一手段。

场景：同步历史数据

cd ~/.agents/skills/stock-skill/scripts

# 🔴 STOP · 检查点：同步前必须确认时间范围
# 执行前询问："确认同步 XXXX-XX-XX 至 XXXX-XX-XX 的数据？"

node sync.js 20250101 20260627
# 🔴 STOP · 检查点：匹配前确认同步完成
node match.js 20250101 20260627

🔴 STOP · 检查点： 大范围同步（超过 3 个月）前必须确认用户意图，避免长时间等待。

场景：查询交易记录（DuckDB MCP）

优先使用 DuckDB MCP 工具直接查询，不要写 node 脚本。

MCP工具调用方式：

mcp_mcp_server_duckdb_query(query="SQL语句")

常用查询模板：

-- 查询个股交易记录
SELECT account_name, name, code, op, entry_price, entry_count, entry_money, entry_date, entry_time
FROM t_trade_record WHERE name LIKE '%股票名%' ORDER BY entry_date DESC, entry_time DESC LIMIT 20

-- 查询匹配记录
SELECT account_name, name, code, sell_entry_price, buy_entry_count, sell_entry_money, buy_entry_money, profit, sell_time, buy_time
FROM t_trade_matched_record WHERE name LIKE '%股票名%' ORDER BY sell_time DESC LIMIT 20

-- 查询今日交易
SELECT entry_date, entry_time, code, name, op, entry_price, entry_count, entry_money
FROM t_trade_record WHERE entry_date = current_date ORDER BY entry_time

注意： op='1' 买入，op='2' 卖出。始终用 op 字段，不要用 op_name。

输出格式（回复用户规范）

命令	输出格式
profit	脚本原始输出为纯文本表格；回复用户时必须转为 Markdown 表格：个股明细表（账户/代码/名称/交易次数/收益）+ 汇总表（月收益/年收益），金额千分位格式化
quotes	按账户分组，每组末尾附汇总行，按当日盈亏率降序；转为 Markdown 表格
account-profit	Markdown 表格：账户名称/总资产/持有盈亏/当日盈亏/当日收益率，末尾附汇总行
sync	成功：记录数+时间范围；失败：提示更新 Cookie
match	成功：匹配数量；部分未匹配：提示原因

数据速查

项目	值
交易记录表	t_trade_record
匹配记录表	t_trade_matched_record
数据库索引	idx_trade_op_date(op,entry_date), idx_trade_code, idx_matched_sell_history, idx_matched_sell_time 等
op='1' / op='2'	买入 / 卖出（⚠️ 始终用 op 数字字段，op_name 不可靠）
GC001（204001）	国债逆回购，查询时排除

注意事项

• 账户超 1000 条自动分页拉取（根据 API 返回的 max_page）
• history_id 基于交易数据生成，确保幂等性
• 不支持手动删记录：无删除工具且禁止手写 SQL DELETE，修正数据靠幂等重跑 sync/match

🔴 红线速查

• 不要手写 SQL DELETE / 手动 INSERT 修改数据（无删除工具，修正数据靠幂等重跑 sync/match）
• 不要跳过 match 直接查收益（未匹配记录不计入收益）
• 不要同时运行多个 sync/match 进程（DuckDB 单写者锁会静默丢写入）

完整禁例清单与危险动作见 references/anti-patterns.md；同步/匹配/收益/行情故障排查见 references/troubleshooting.md。