---
name: chanshu
description: 在 chanshu MCP(A 股 / 港股 / 美股行情、国内期货行情、公募基金十大持仓与调仓、个人负债 / 自选 / 持仓 / 股价提醒 / 消费记账、意见反馈、分析笔记)上查行情、看基金、做持仓周复盘、记一笔持仓买卖、算下月还款、记负债、管自选与提醒、记消费 / 查花销 / 导账单、给 chanshu 提意见反馈与跟进进度、定时任务把每个时段的分析写成分析笔记的用法与流程。用户提到股票行情、期货行情、K 线、基金持仓、自己的持仓 / 自选 / 借款 / 消费,或要在 chanshu 上记一笔借款 / 还款、加自选、设提醒、记一笔消费、问这个月花了多少、导入支付宝 / 微信账单、把 chanshu 的问题 / 建议反馈上去、问之前报的问题处理得怎样,或让定时任务把分析结论记进 chanshu、推到自己的群里时使用。
---

# chanshu

本 skill 只写用法和流程;数据与计算全在 MCP 服务端(`https://chanshu.top/api/mcp`),这里不复述任何口径。
没接 MCP 的,先看 https://chanshu.top/docs/ 接上再用。

## 代码格式

- 股票代码带小写市场前缀:`sh600519`、`sz000001`、`hk00700`、`usNVDA`;指数同此(如 `sh000001` 上证指数);美股指数 `us.IXIC`(纳斯达克综合)/ `us.DJI` / `us.INX`(标普 500)/ `us.NDX`(纳指 100)/ `us.SOX`(费城半导体)。开盘前看隔夜外盘用 `stock_tickers` 一次取齐。美股只有行情、自选与资讯:财报 / 简况 / 公告不覆盖,持仓记录与股价提醒不收美股代码。
- 基金代码是 6 位数字,如 `510300`。
- 期货代码是品种 + 四位年月:`rb2701`、`sa2701`、`if2612`(郑商所的三位写法 `SA701` 也认);品种 + 0 是主力连续:`rb0`(螺纹钢主力)、`if0`。用户说「螺纹」「沪深300 期货」「lwg」之类时先 `futures_search` 拿确切代码。
- 用户给的是名称、拼音首字母或不带前缀的数字时,**先 `search_stock`(或 `search_fund`)拿到确切代码再查**,不要猜前缀。
- 同名或多个候选时把候选列给用户确认,不要替用户选。

## 工具分八组

- 行情:`search_stock` → `stock_quote`(单只快照)/ `stock_tickers`(批量精简)/ `stock_kline`(日 / 周 / 月,前复权)/ `stock_trends`(当日分时)/ `market_breadth`(涨跌家数)/ `stock_financials`(财报核心指标:年报、单季、最新一份累计报告)/ `stock_profile`(简况:公司资料、行业、主营业务、市盈率 / 市净率与股本、A 股股东户数)/ `stock_shareholders`(A 股十大股东 / 十大流通股东与较上期新进、增减持、退出)/ `stock_margin`(A 股个股与 ETF 的融资融券逐日明细:融资余额、净买入、融券余额)/ `stock_notices`(公司公告:标题、类型、原文链接)/ `stock_news`(媒体资讯:标题、导语摘要、链接)。用户问一只股票「最近怎么样」直接 `stock_brief`:一次拿到快照、近 5 / 20 日涨幅、我的持仓 / 自选态、持有它的基金(A+H 两地上市的还有对面那只的行情与 (A/H) 比价),别再分四五次查。
- 期货(国内六家交易所,一期只有行情与自选):`futures_search` → `futures_quote`(单个合约快照:昨结、结算价、持仓量与日增仓、是否在交易时段)/ `futures_tickers`(批量 1..50)/ `futures_list`(行情列表:`session=main` 全部主力、`night` 夜盘主力、`all` 全部合约,可按板块 / 交易所 / 品种筛)/ `futures_trends`(当个交易日分时,含夜盘)/ `futures_kline`(日 K,原始价、带结算价与持仓量,一页 120 / 250 根);期货自选 `my_futures_watchlist` 读、`futures_watchlist_add` / `futures_watchlist_remove` 写(与股票自选分开,写要 `watchlist:write`)。涨跌一律相对昨结算价;问「今天期货哪些涨得多 / 黑色系怎么样」直接 `futures_list` 一次拿全部主力。期货持仓单独记(与股票持仓分开):`my_futures_positions`(多空、均价、浮动 / 当日盈亏、保证金占用,`totals.equity` 是计入全景资产的期货权益)/ `futures_record_list`;写 `futures_record_add`(开多 / 开空 / 平多 / 平空,只记录不下单,主力连续 rb0 不能记,先 `futures_quote` 看 `mainCode`)/ `futures_record_delete`,要 `portfolio:write`;记一笔前复述合约、方向、日期、价、手数。期货不能设股价提醒。
- 基金:`search_fund` → `fund_detail`(基本信息 + 十大持仓)/ `funds_holding_stock`(哪些基金持有某股)/ `fund_holding_changes`(本期 vs 上期十大变动:新进、退出、占比上升 / 下降——比的是占净值比例,不是股数,是否真在买卖用 `fund_stock_analysis` 的股数变化)/ `fund_stock_analysis`(站在一只 A 股上看全部基金:本季 vs 上季十大重仓的基金数、股数、期末市值、增减持排行,分全部 / 主动)。
- 我的:`finance_overview`(财务全景:资产、负债含券商融资、净资产、每天利息、未来 60 天应还、按已记持仓估算的维持担保比例,一次调用)/ `my_positions`(按股汇总的持仓)/ `my_watchlist`(自选,已附最新价)/ `my_loans`(借款摘要;要逐期计划带 `id`)/ `alert_list`(提醒清单)/ `portfolio_week`(本周复盘)/ `portfolio_record_list`(持仓买卖记录,卖出带这笔已实现)/ `portfolio_pnl`(盈亏日历:按日 / 月 / 年的盈亏、收益率与已实现);写工具分四组——负债 `debt_loan_create` / `debt_loan_update`(改条款,只传要改的字段)/ `debt_loan_mark` / `debt_prepay_add` / `debt_prepay_revoke`(撤销录错的提前还款)/ `debt_loan_delete` / `debt_loan_restore`,自选 `watchlist_add` / `watchlist_remove`,提醒 `alert_set` / `alert_remove`,持仓 `portfolio_record_add` / `portfolio_record_update` / `portfolio_record_delete` / `portfolio_record_restore` / `portfolio_settings_set` / `portfolio_cash_set`。
- 财务健康:`finance_health`(对照用户**自己设**的目标:资产比例 / 负债占资产 / 利息成本 / 集中度 / 月还款占收入 / 应急金,每个维度只给 现状 / 目标 / 差额)/ 写 `finance_health_set`(改目标、手填月收入与现金等、偏离提醒,要 `health:write`)。
- 消费记账(金额单位元,退款为负,时间东八区):读 `expense_list`(明细,默认只列生效,可要 `status=pending` / `deleted`)/ `expense_get`(一笔,带所见版本)/ `expense_summary`(按月 / 分类 / 月×分类汇总)/ `expense_categories`(固定分类清单)/ `expense_quota`(识别配额)/ `expense_import_list`(导入批次)/ `expense_recurring_list`(周期规则:固定开销的状态与下次触发日);成本型读 `expense_draft`(图片或文本 → 草稿)/ `expense_import_preview`(支付宝 CSV / 微信 XLSX → 逐行去重标记 + 预览 token),**个人 API 令牌不能调,只给 OAuth 连接**;写 `expense_add` / `expense_update` / `expense_delete` / `expense_restore` / `expense_import_commit` / `expense_import_revoke` / `expense_recurring_set`(登记 / 改固定开销规则)/ `expense_recurring_pause`(暂停 / 恢复)。

- 意见反馈(反馈人侧,与网页 https://chanshu.top/account/feedback/ 同一条线程):读 `feedback_list`(我提过的,默认只列普通 = 还没完结的;`status=done` 看已完结、`all` 看全部)/ `feedback_get`(一条的完整往来、允许的下一步动作、所见 `version`)/ `feedback_image`(按句柄取附图);写 `feedback_create` / `feedback_reply` / `feedback_reply_retract` / `feedback_close` / `feedback_mark_read`。状态只有普通(`open`)/ 已完结(`done`)两种:已完结的不能追加、不能重开,要说别的就新提一条。

- 分析笔记(用户自己的定时任务写进来的主题、报告、记忆,只对本人可见):读 `analysis_state_get`(全局记忆、各主题与最近一份报告)/ `analysis_report_list`(翻历史报告)/ `analysis_report_get`(一份全文与同步记录);写 `analysis_topic_set` / `analysis_memory_set` / `analysis_report_add` / `analysis_report_delete` / `analysis_report_restore`(要 `analysis:write`)。

「我的」「消费记账」与「意见反馈」要登录身份:个人 API 令牌只读;写工具只对 OAuth 连接开放且按 scope 分组(负债 `debt:write`、自选 `watchlist:write`、提醒 `alert:write`、消费 `expense:write`、反馈 `feedback:write`、持仓 `portfolio:write`、财务健康目标 `health:write`、分析笔记 `analysis:write`),缺哪个 scope 工具会回「请重新授权」,照实告诉用户去 https://chanshu.top/account/settings/ 重新授权并勾上对应权限。

批量看行情用 `my_watchlist`(自选已附最新价)或 `stock_tickers`(一次 1..50 只),**不要逐只调 `stock_quote`**;期货同理用 `my_futures_watchlist` / `futures_tickers` / `futures_list`。

## 工具分组与轻量档

- OAuth 连接可以只开一部分工具(授权页「开放的工具」:完整 / 轻量 / 自定义按组勾选;之后在 https://chanshu.top/account/settings/#connections 点工具数改,宿主下次取工具列表即生效,不用重新授权)。组:行情 `market`、公司资料 `company`、期货 `futures`、基金 `fund`、我的持仓 `portfolio`、自选与提醒 `watch`、财务全景 `overview`、财务健康 `health`、负债 `debt`、消费记账 `expense`、意见反馈 `feedback`、分析笔记 `analysis`;轻量档是 13 只高频只读工具(行情、自选、持仓、盈亏日历、本周复盘、财务全景、基金详情、资讯)。
- 本 skill 提到的工具在当前连接的工具列表里找不到,或调用回「该工具未在此连接开放」:**不要换别的工具硬凑、也不要反复重试**,告诉用户这组工具在这个连接没开,去上面的设置页把对应组打开(或改回完整)。
- 组只做隐藏:写权限照旧按 scope 判;个人 API 令牌恒为全部只读工具。

## 财务健康怎么用

1. 目标是用户自己的:用户说「股票目标 60%」「负债不超过资产 30%」才 `finance_health_set`,只改用户明说的字段;**用户没说数就问,不要替用户定目标,也不要按年龄、收入、风险偏好去推一个数。**
2. 示例配比只有一份(股票 60 / 债券 30 / 大宗商品 10,公开读物的经典配比示例):只在用户明说要用时传 `template=classic_60_30_10`,转述时带上出处,说清可改可删。
3. 问「离我定的目标差多少」调 `finance_health`,按维度复述 现状 / 目标 / 差额;`gap` 只是差额,**不要加「偏高 / 该减仓 / 建议买债基」之类的判断与操作,也不推荐任何标的**。用户追问「那我该怎么办」,只回答目标是他自己定的、差额在这里、怎么处理由他决定,可以帮他改目标值。
4. `missing` 不是错误:`no_income` 让用户告诉你月收入再 `finance_health_set(income={value})`,`no_cash` 同理填现金;`no_target` 是启用了但没设目标。
5. 口径与 `finance_overview` 同一份(股票账户现金自动计入「现金」类;用户在 `finance_health_set` 手填现金时提醒只填股票账户以外的,别算两遍);本站没有的资产(银行存款、房产等)不在里面,转述比例时说明「按本站已记录的数据」。预置 prompt `health_review` 一步到位。

## 分析笔记怎么写(定时任务)

分析方法、信号叫什么、价位与步骤怎么定,全由用户自己的提示词决定;chanshu 只存储、展示、按用户的设置转发,不生成、不改写内容,本 skill 也不提供任何分析方法。chanshu 只规定**报告格式**(结构),不规定内容。

报告格式(七段,顺序固定,空的段页面不画):`instruction` 指令(一句 ≤80 字,必填)→ `summary` 摘要(≤300 字)→ `levels` 价位(`{label, price, note}` ≤6 条)→ `signals` 信号(`{label, state green / yellow / red, state_label, evidence, as_of, key?}` ≤12 条)→ `steps` 步骤(`{label, text, status, mark waiting / triggered / entered / failed / locked}` ≤8 条)→ `snapshot` 关键数字(`{k, v, ref}` ≤40 行)→ `body` 正文(Markdown ≤20000 字)。**每份报告自带一整套**:没给的段就是这份报告没有这一段,不会沿用上一份。

1. 每次运行先 `analysis_state_get`:拿全局记忆 `memory`、各主题(自用参数 `params`、`version`、该主题的记忆 `memory`)与最近一份报告 `latest_report`——它就是报告格式的同一形状(不带 `body`)。再用行情工具取数(`stock_tickers` / `stock_kline` / `stock_brief` 等)。
2. 每个时段 `analysis_report_add` 整份交一份报告:在第 1 步的 `latest_report` 上改(信号的状态与依据、价位、步骤、关键数字),连同新的指令、摘要、正文一起交。`idempotency_key` 必填,取「交易日 + 时段」这类同一份报告不变的值,重试带同一个——不会写出两份,也不会再推送一次。`model` 可以带上你自己的名字(如 `Claude Fable 5.2`),页面在报告底部灰字署名。
3. 格式不对回 `invalid`,`reason` 指明哪一段哪个字段(如 `signals[2].as_of`):照着把那一处改对,整份重交;内容不会被截断或改写。
4. 主题只是容器:新主题先 `analysis_topic_set`(不带 `version`)。主题键带类型:股票用行情工具的代码写法、不带前缀(`sz300308`),期货 `futures/<合约>`(`futures/rb2701`,郑商所也写四位年月),基金 `fund/<6 位代码>`(`fund/025208`),「市场」这类无代码主题用自定义短键(`market`);读回来每个主题带 `type`;之后只在改显示名、启用、`params` 时再调,带读到的 `version`,回 `conflict` 就看 `current` 后以 `current.version` 重调。用户说过的态度、风格、规则这类跨报告不变的背景,用 `analysis_memory_set` 记成记忆(每条「名字 + 一句话」,只留当前值):`topic` 空 = 全局(与具体股票无关;`style` 约定为投资风格),给了 = 记在那个主题下。记忆不是行情也不是持仓——持仓以 `my_positions` 为准,别抄进记忆;用户只在页面上看记忆,要改由你来写。
5. 结果里的 `push` 是同步结果,没同步成不是错误、报告已经记下:`partial` / `failed` 把 `items` 里失败的源与原因告诉用户;`skipped` 看 `code`——`sync_disabled`(没开同步)、`no_sources`(没勾选通知源)照 `suggested_actions` 请用户去账号设置,`quota_exhausted` 是当日推送次数用完。**通知源与同步设置只能用户本人在网页改,你没有这类工具。**
6. 定时任务没人在场:五个写工具带 `unattended=true` 照常生效(分析笔记是用户自己的笔记,不同于记账、负债那几组)。
7. 内容按原样存:超出长度或条数上限回 `invalid` / `quota_exceeded`,不会被截断——按 `reason` 自己缩短后重写;每个连接每日写报告默认 100000 份、写主题与记忆默认合计 100000 次,用完回 `quota_exceeded` 附 `reset_at`,当天别再重试。
8. 报告写错了 `analysis_report_delete`(可 `analysis_report_restore` 恢复);翻历史 `analysis_report_list`,看全文与每个通知源的推送记录 `analysis_report_get`。

## 整体财务怎么看

1. 用户问「我现在财务状况怎么样 / 净资产多少 / 欠多少 / 每天利息多少 / 最近要还多少」直接 `finance_overview`,别再拼 `my_positions` + `my_loans` 自己加。净资产的股票部分是股票账户净资产(市值 + 股票账户现金 − 融资),融资与现金各只算一次;只问股票账户(总资产 / 持仓市值 / 可用资产 / 负债 / 净资产)看 `my_positions` 的 `totals`。
2. 负债分两块说:消费借款余额与券商融资(本金 + 已计利息),两者都计入总负债;港股按港元原值计入、未换汇,有港股时要说明。
3. `estMaintenanceRatioPct`(与 `my_positions` 的 `maintenance` 同一算法)只在有融资时出现,**是按本站数据估算的**:设过持仓现金才计入现金,不含没在本站记录的持仓——转述时原样带上 `estMaintenanceNote` 的限定,并提醒以券商显示为准,不要当成真实担保比例下结论。
4. 要看某笔借款的逐期计划(或要 `debt_loan_mark` 的期号 k)才 `my_loans(id=…)`;`my_loans` 默认只给每笔摘要、不列已结清,`includeSettled=true` 要回。

## 数据一致性

- 持仓由买卖记录实时推导:`my_positions` 与 `portfolio_record_list` 同源、无缓存。前后两次结果对不上,是两次调用之间用户在网页改了记录,以后一次为准,不要报成「两套数据不同步」。
- 今天休市(周末 / 节假日)时持仓的今日盈亏为 0,`asOf` 是行情所属交易日;别把上一交易日的涨跌说成「今天」。
- `market_breadth` 带 `stale: true` 时是最近一次成功取到的数据,转述时说明是 `asOf` 那个时刻的。

## 周复盘怎么查

1. `my_positions` 拿按股汇总的持仓(每只带持股、均价、市值、浮动 / 今日 / 累计已实现盈亏,外加合计)。
2. 需要近一周走势时,按股票去重后用 `stock_kline`(period=day)取最近几根;只要最新价与涨跌幅的话 `stock_tickers` 一次批量取。
3. 解读口吻:先给合计与变化,再按盈亏幅度排前几只,有信用批次的单独点出(它们的浮动盈亏已扣利息);描述事实,不预测、不劝买卖。
4. 用户主动问「我这周怎么样」直接调 `portfolio_week`,它和预置 prompt `weekly_position_review` 是同一份算法;只有要按 prompt 的固定口吻输出时才用 prompt。

## 记一笔持仓怎么做

1. 持仓由买卖记录推导,`portfolio_record_*` **只记录、不下单**。用户说「今天融资 152.3 买了 2000 股平安,手续费 15」:代码不确定先 `search_stock`,同名多只让用户选。
2. 整理成交事实——股票或场外基金(基金代码写 `of` + 6 位,如 `of025208`;申购 = buy、赎回 = sell,价格填确认净值、数量填份额、费用填申购 / 赎回费,不记信用)、买 / 卖、成交日期、成交时间(HH:MM,知道就带,网页分时图上才标得出这笔)、成交价、股数、费用合计、是否信用(信用买入不给年化就取默认)、备注——**逐项复述给用户确认**后调 `portfolio_record_add`(代人,不传 `unattended`;带 `idempotency_key`,重试同一笔用同一个)。预置 prompt `record_position` 已写好这个流程。
3. 记完复述返回的 `summary`(该股持股、均价、累计已实现的前后变化;卖出附这笔已实现)与持仓页 `url`。
4. 纠错:`portfolio_record_list(code, from, to)` 找到那笔与所见 `version` → `portfolio_record_update`(结果带操作前记录,可据此改回);记重了 `portfolio_record_delete`,删错了 `portfolio_record_list(status=deleted)` → `portfolio_record_restore`。融资利率变了用 `portfolio_settings_set`,已有记录不跟着变。用户说「账户里还有 X 现金」或「转入 / 取出多少」用 `portfolio_cash_set`(`set` 设余额 / `delta` 转入转出);买卖记录会自动增减现金,不用每笔都调。设过现金后 `my_positions` 带 `cash`、`totals.totalAssets` 与各股占比 `weight`,回答「仓位多重、各占多少」就用它们。
5. 问「这个月 / 今年赚了多少、收益率多少、哪天亏最多、落袋多少」用 `portfolio_pnl`(每格盈亏含持仓涨跌,收益率按日连乘,另给已实现;不含信用利息);当前浮动与今日盈亏看 `my_positions`。
6. 失败分支:`oversold` → 把 `structuredContent.error` 里冲突的那笔卖出(日期、股数、当时持股)告诉用户,问是不是漏记了买入或日期记错了,补 `portfolio_record_add(买)` 或 `portfolio_record_update` 改日期后再试;`conflict` → `portfolio_record_list` 重读再改;`unknown_stock` → `search_stock`;`needs_confirmation` → 等人在场以代人姿态再调,或让用户在持仓页自己记;`scope_missing` → 让用户重新授权并勾上「管理我的持仓」。
7. **无人值守**(定时任务、没人在场)时持仓只读:带 `unattended=true` 的写一律 `needs_confirmation`,不要去掉这个标记绕过;把整理好的成交列给人,人在场说「记上」再逐笔代人记。

## 下月还款怎么查

1. `my_loans` 拿全部借款,每笔自带服务端算好的计划与状态(余额、下期到期、逾期天数)。
2. 从各笔计划里挑出下个自然月到期的期数,列到期日、应还、本息拆分与合计;逾期的单独提醒。
3. 预置 prompt `next_month_repayment` 已做好这一步,优先用它。

## 基金重叠怎么查

1. 基金代码不确定先 `search_fund`。
2. `fund_detail` 取十大持仓,`my_positions` 取我的持仓(按股汇总),按股票代码对上(基金持仓里的代码也带市场前缀)。
3. 列重合的股票与它在基金里的权重,再谈集中度;预置 prompt `fund_overlap`(参数 `code`)一步到位。
4. 反过来「哪些基金持有我这只」用 `funds_holding_stock`。
5. 「这只基金这季度加了什么 / 退了什么」用 `fund_holding_changes`;它只比最近两期,返回里说「无上期可比」就照实说,不要用当期持仓硬凑变化。
6. 「基金这季度对某只股票是加是减」用 `fund_stock_analysis`(只支持 A 股):增减持金额 = 股数变化 × 本期期末价,已剔除股价涨跌,别拿市值变化当增减持;`final=false` 说明季报还在陆续披露,要提醒数字会变;排行只给前列,全量把返回的 `url` 给用户。

## 业绩 / 财报怎么查

1. 「营收 / 利润 / 毛利率 / ROE 怎么样」直接 `stock_financials`:`annual` 是年报(全年),`quarterly` 是单季(只报半年报的港股是 H1 / H2 半年),`latest` 是年报之后最新一份累计报告(一季报 / 中报 / 三季报的年初至今数)——别把累计数当单季说,也别拿中报累计和年报比增速。
2. 金额单位元(说的时候换成亿),比率与同比单位 %;港股金额是东财折算的人民币。缺的指标(银行没有毛利率、港股没有扣非)就是不适用或源没给,照实说,不要自己推算补上。
3. 行业指标只在 `extras` 列出来的那几项里找(银行不良率 / 拨备覆盖率 / 净息差,保险新业务价值,券商净资本,年报员工人数);没有用户数、门店数这类经营数据,用户问到就说没有。
4. 回答附上返回的 `url`(站内个股页的财报卡)。
5. 「这家公司做什么 / 哪个行业 / 估值贵不贵 / 股东多不多」用 `stock_profile`:市盈率为负是亏损,静态市盈率只 A 股有、股息率只港股有,股东户数只 A 股有(港股不披露,change 是较上一次披露的变化 %),缺的照实说没有;业绩数字仍以 `stock_financials` 为准。问「大股东是谁、这期谁新进 / 增减持 / 退出」用 `stock_shareholders`(只 A 股;不带 period 取最新一期,要看更早的从返回的 `periods` 里挑)。
6. 「融资余额多少、这几天融资是买是还、融券有多少」用 `stock_margin`(只 A 股沪深北个股与 ETF;港股 / 美股 / 指数回错误,不是两融标的 `marginable=false`):`rows` 最新在前,金额元(说的时候换成亿)、融券余量是股、`finFloatPct` 是融资余额占流通市值 %;数据是上一交易日的(当天的次日上午才出),说清 `asOf` 是哪天;默认 60 个交易日,`lmt=250` 看一年,更早的带 `end` 往前翻。只照实说数字和变化,不要把融资增减说成看多看空的结论。

## 消息面(公告 / 资讯)怎么查

1. 「最近 / 明天有没有利好利空、公司发了什么公告」先 `stock_notices`(公司公告,发布倒序):`date` 是公告日(盘后发布的记次一交易日,所以「明天」的公告常在今晚就能看到),`time` 是实际发布时刻,`type` 是东财栏目(业绩预告、分红、增减持、回购、重大合同等一眼可分);要看媒体怎么说再 `stock_news`(标题 + 媒体 + 导语摘要)。
2. 两只都只有标题与摘要,不含正文:别只凭标题断言利好利空,给出判断时说明依据是标题 / 摘要,并附上原文链接(`url` / `pdf`)让用户点开核实;需要细节就请用户看原文,不要编造正文内容。
3. `stock_news` 按简称匹配标题,可能混入同名或板块报道,挑和这只股票直接相关的说;同一事件多家转载已去重。
4. 指数没有公告与资讯(返回空);港股公告类型是繁体,链接直接是 PDF。

## 记一笔消费怎么做

1. 用户给截图或支付通知原文:你自己能读出金额 / 时间 / 商户 / 分类就直接读,不要为此调 `expense_draft` 浪费配额;读不出、或想要站内的分类建议与疑似重复提示时再调(文本模式规则抓全不计配额)。分类只能取 `expense_categories` 的 code。
2. 把字段逐项复述给用户确认后调 `expense_add`(代人姿态,不传 `unattended`)。
3. 回 `duplicate`:`hard=true`(交易号已存在)不要再加,要补字段就 `expense_update` 那条已有记录;`hard=false`(疑似重复)先 `expense_get` 看 `candidates`,和用户核对是不是同一笔,确认不是再带 `ignore_similar=true` 重调。
4. 记完复述返回的操作前 / 后摘要(本月合计变化、状态)与站内 `url`;状态是 `pending` 的告诉用户去网页 / App 里确认。
5. 问「这个月花了多少 / 花在哪 / 比上月多在哪」直接 `expense_summary`(要明细再 `expense_list`);只计生效记录、退款抵消,待确认单列不计入,回答时说清;区间含本月时结果另带 `fixed`(本月固定开销还没生效的几期:待确认 / 到期了没记录 / 还没到期),不计入 `total`,要分开说「生效 X 元,另有固定开销 Y 元待入账」——网页上的本月支出是两者之和。
6. 月度导账单:`expense_import_preview`(文件内联 base64)→ 把统计(新增 / 跳过 / 疑似重复)与疑似重复行讲给用户、让用户定每行 → `expense_import_commit`(30 分钟内);导错整批 `expense_import_revoke`。回 `already_imported` 就查 `expense_import_list`,别重导。
7. 预置 prompt `expense_record`(记一笔)和 `expense_review_pending`(过一遍待确认)分别对应 1–4 与下面第 8 条。
8. **无人值守**(没人在场、定时跑、自己决定要记)时 `expense_add` 带 `unattended=true`:这些记录一律落为待确认、不计汇总,由人之后在网页 / App 里放行;自主姿态不能 `expense_update`、只能 `expense_delete` 自己产生的待确认记录、不能提交导入(都回 `needs_confirmation`)。**你没有确认工具**(`expense_confirm` 只在本人会话),不要尝试替人确认,早上用 `expense_review_pending` / `expense_list(status=pending)` 列给人看即可。
9. 房租、订阅这类固定开销用周期规则:`expense_recurring_set`(金额、分类、商户、`period_kind` monthly / weekly 与 `period_day`;当月无此日取月末)登记,**新登记一律「手动触发」**——到期只生成待确认记录,人在网页里放行;登记时本期到期日已过(如 15 号登记每月 1 号的房租)会当场补本期一笔待确认(当期已有同额记录则跳过),登记后提醒用户去确认;**给规则开「自动」(到期直接生效)只能用户本人在网页 / App 的记账页操作,你没有这个工具**,用户要开自动就告诉用户去页面点。规则跑错了 `expense_recurring_pause` 暂停(恢复回暂停前状态);`expense_recurring_list` 看状态、下次触发日、最近生成的记录;自动中的规则连续两期生成的记录被删会自动降回手动触发。
10. 契约错误的结果 `isError`,`structuredContent.error` 带 `code` / `reason` / `suggested_actions`(以及 `candidates` / `current` / `reset_at` / `batch_id` 载荷),照 `suggested_actions` 处理;`conflict` 用 `current.version` 重试,`quota_exceeded` 改自己读图或文本模式,`token_not_allowed` 让用户改用 OAuth 连接。

## 反馈一个问题怎么做

1. 用户说「把刚才那个问题反馈给婵姝」:从对话里整理类型(`bug` 问题反馈 / `suggestion` 优化建议)、标题(一句话 ≤60 字)、正文(现象、复现步骤、期望 ≤2000 字),能拿到的环境信息(宿主、页面地址、平台 / 版本)放进 `env`;有截图就内联 base64 放进 `images`(≤3 张,单张 ≤1MB)。预置 prompt `feedback_report` 已把流程和我未完结的反馈拉好,优先用它。
2. 先 `feedback_list`(默认只列还没完结的)看有没有同一问题的未完结反馈;有就改 `feedback_reply` 在那条里追加,不要新建。同一问题在已完结的那条里,就新提一条并在正文引用旧 id。
3. **逐字段复述给用户确认**后调 `feedback_create`(代人,不传 `unattended`;`idempotency_key` 取这段对话的指纹,重试带同一个),把返回的 id、状态与站内 `url` 告诉用户。
4. 用户补一句「还有截图」:`feedback_reply(id, images=[base64])`。
5. 问「上周报的那个处理得怎么样了」:`feedback_list(status=all)` 找到那条 → `feedback_get` 看处理方最后一条消息,复述给用户。处理方回复通常即结单(状态变已完结),在等补充的仍是普通。还是普通的:用户说「确实好了 / 不需要了」→ `feedback_close(id, version)`,说「还是不行」→ `feedback_reply` 补充现象;已完结的还是不行 → `feedback_create` 新提一条,正文引用旧 id。**解没解决只有人知道,不要替用户确认**。用户真的看过回复之后才 `feedback_mark_read`,只是代为查询时别标。
6. **无人值守**(定时任务、没人在场)时 `feedback_create` / `feedback_reply` 带 `unattended=true`,照常生效;处理方问的能从自己掌握的事实里答就答,答不了的留给人、不标已读。`feedback_close` 自主一律回 `needs_confirmation`,记下来等人在场。
7. 失败分支:`duplicate` → 改 `feedback_reply` 追加到 `existing_id`;`conflict` → `feedback_get` 重读,看清处理方刚做了什么再决定(以 `current.version` 为准);`state_invalid` → 按 `allowed` 换能力(已完结的不能追加,`allowed` 只剩 `create_new`:新提一条并在正文引用旧 id);`payload_too_large` → 压缩或改文字描述;`needs_confirmation`(Agent 每日创建 5 条 / 消息 30 条额度用完,或自主关闭)与 `quota_exceeded` → 把 `reset_at` 告诉用户,让用户决定要不要到网页里提;缺 `feedback:write` 的回「请重新授权」→ 让用户去设置页重新授权并勾上「提交反馈」。
8. 反馈人侧看不到处理方的内部结论;「已完结」的原因看处理方写给用户的那条消息,照实转述,不要猜。

## 写工具的约定

1. 写之前先 `my_loans` 拿借款 `id`(恢复已删除的要带 `includeDeleted=true`)。
2. **调用前把将要做的改动逐字段复述给用户确认**(新增:来源 / 本金 / 利率与计息基数 / 起息日 / 首次还款日 / 期数 / 方式;修改:哪几个字段、改前改后的值;标记:第几期、已还还是未还;提前还款:日期与金额),确认了再调。
3. 调用后把返回里的操作前 / 后摘要复述给用户,并附上返回的站内 `url`。
4. 录错了字段用 `debt_loan_update` 改——只传要改的字段,带 `my_loans` 看到的 `version`(过期回 conflict 就重读再改),别删了重建(id 会变、分期本金补不回)。`basis`(计息基数)是最常改的:App 展示的年化是日息 × 365,照着抄的年化配 365;合同实际按 360 计息的才配 360;日息录入的借款改基数只影响展示的年化、不动利息。
5. 提前还款是已发生的事实,没有「改」:录错了用 `debt_prepay_revoke` 撤销(`prepayId` 见 `my_loans(id=…)` 的 `prepays[].id`),所以金额与日期务必二次确认;`debt_loan_delete` 是软删除,可用 `debt_loan_restore` 恢复。无人值守(定时任务、没人在场)时负债写工具一律带 `unattended=true`,会回 `needs_confirmation` 不写——把要改的内容列出来等人在场。
6. 自选与提醒按 `code` 操作,不确定代码先 `search_stock`;自选增删是幂等的(已在 / 不在都算成功),`alert_set` 每只一条、重设覆盖,方向不传时服务端按现价与目标价自动推出来,把返回里推出的方向复述给用户。
7. 消费记账的写都带所见 `version`(`expense_get` / `expense_list` 返回)做比对,过期回 `conflict` 附当前记录;`expense_delete` 是软删除,`expense_restore` 可恢复;重试同一笔 `expense_add` 带同一个 `idempotency_key`。

## 回答时提醒

- 港股、美股是延迟行情;A 股是最新快照。说到港股 / 美股价格顺带带一句「延迟」;美股时间是纽约时间、价格单位美元。
- 基金持仓来自季报,滞后一到三个月,说清是哪一期的数据。
- 行情类工具按令牌限速、写工具更严;超限的结果 isError 且 `structuredContent.retry_after_seconds` 给了等待秒数,等够再试,不要连打。
- 行情原料类工具(`search_stock` / `stock_quote` / `stock_tickers` / `stock_kline` / `stock_trends` / `market_breadth` / `stock_financials` / `stock_profile` / `stock_shareholders` / `stock_margin` / `stock_notices` / `stock_news`,以及期货 `futures_search` / `futures_list` / `futures_quote` / `futures_tickers` / `futures_trends` / `futures_kline`)另有每人每日合计配额;用尽回 `quota_exceeded` 附 `reset_at`,当天别再重试,告诉用户明天恢复。省着用:问一只股票的近况优先 `stock_brief`(不计日配额),多只最新价用 `stock_tickers` 一次批量取。
- 单次返回有上限:`stock_kline` / `futures_kline` 一页 120 / 250 根、`stock_margin` 一页 20 / 60 / 250 个交易日,更早的带 `end`(上一页最早一根 / 一行的前一天)往前翻;`portfolio_record_list` 一页最多 500 条,有 `nextCursor` 就带回 `cursor` 取下一页。用户要整份数据(持仓记录、消费记录)时,让用户到对应网页点「导出」(借款没有导出,逐笔看 `my_loans`),不要一页页翻完代为拼。
- 数据仅供参考,不构成投资建议;用户问「该不该买」时给事实与框架,不替用户做决定。
