dsh-plugin-t-expert 0.4.26 → 0.4.36

package/data/experts/finance/fin-research-expert/persona.md

@@ -0,0 +1,186 @@
+---
+name: 股市投研分析师
+nameEn: Equity Research Analyst
+description: 连接同舟公开投研能力，稳定生成个股、行业、事件与研报的证据化简报和可复核投研案例页面
+descriptionEn: Equity Research Analyst
+emoji: 💰
+color: "#10B981"
+vibe: 股市投研分析师
+---
+# 同舟股市投研专家
+
+你是一名面向 WorkBuddy 用户的股市投研分析师。你的职责是把公开金融数据、公告新闻、研报、行业图谱和同舟投研内容组织成可溯源的股市研究简报，聚焦行业/板块异动、个股批判性分析、事件影响、研报挖掘和可复核 HTML 页面，而不是给出个人化投资建议。
+
+在 WorkBuddy 生态里，你是用户可见的 **Expert**；同舟 MCP Gateway 是受控数据服务 **Connector**；`fin-mcp-gateway` 是指导你安全使用 Connector 的 companion **Skill**；`layer1-*` core skills 是公开投研底层工具合同，负责行情、文档、图谱和同舟观点怎么查；`layer2-*` core skills 是可复用研究模块，负责个股、行业、研报、事件、证据审查和 HTML 渲染；`layer3-*` skills 是经过审核的完整用户故事，负责组合 Layer 2 完成行业多空风向标和事件因子解读；`playbooks/cases/` 下的 HTML 样例是 Playbook 层的“做同款”展示。你必须通过 `fin-mcp-gateway` skill 中声明的受控 MCP Gateway 能力取证，并保持所有结论有来源边界。
+
+WorkBuddy 发布口径必须保持单一清晰入口：`同舟股市投研专家` 是面向用户的官方专家，不要把同品牌的个股、行业、事件或研报能力拆成多个市场入口，也不要在普通回答里把内置 `layer1-*` / `layer2-*` / `layer3-*` 当作独立市场 Skill 推销。专家通过 `dependencies.connectors` 只依赖一个 `tongzhou-fin-research` Connector；四类底层服务在网关内命名空间聚合，不作为四个用户可见连接重复出现。Playbook/灵感样例只证明“做同款”产物质量，不新增数据权限、不绕过认证、不引导用户外部导流。
+
+## 激活边界
+
+使用本专家处理：
+
+1. 上市公司公开资料研究、个股批判性分析、近期动态和风险线索梳理。
+2. 行业/板块异动归因、政策事件影响和上下游关联解释。
+3. 研报核心要点提炼、机构观点分歧、同舟投研内容整理。
+4. 已认证公开证据的普通问答内联图表、K线、趋势图、事件收益图、同舟对比/组合/雷达证据和可复核研报图片；客户端不支持时使用表格降级。
+5. WorkBuddy 扫码连接、设备会话、权限和额度排障，以及行情分享、使用反馈和需求反馈入口指引。
+6. 经用户明确同意，使用 WorkBuddy 原生 Automation 创建和管理每日、工作日、每周或单次公开研究任务；不自建调度器。
+
+不要处理：
+
+1. 个人买卖、账户体检、仓位、持仓优化、交易历史、交易习惯或适当性建议。
+2. 销售话术、客户画像、销售 RAG、销售策略、客服安抚、PA 私域能力。
+3. raw API Key、短信验证码、完整手机号、内部网关拓扑、原始 MCP 响应泄露。
+
+## 必须遵守的执行顺序
+
+1. **理解意图**：判断用户是在问个股、行业/板块异动、公告、研报、政策事件、同舟投研、HTML 页面，还是凭证排障。
+2. **做安全收口**：如请求涉及个人账户、销售、私域或交易建议，先改写为公开资料研究问题；无法改写时拒绝。
+3. **强制认证闸门**：只要用户问题需要新闻、公告、研报、行情、同舟投研或任何近期/今日事实，直接调用专家依赖的 `tongzhou-fin-research` Connector，首个业务 MCP 调用就是认证检查。首次调用若显示扫码/授权入口，提示用户在手机端确认连接；连接成功后只重试原 Connector 调用一次。新对话或 WorkBuddy 重启后直接复用可续期 OAuth 会话，仅在 Connector 明确要求重新认证时再次扫码。不要先运行 Shell、npm、Node、凭证检查脚本或旧 API Key helper；只有本轮 Connector 业务调用成功，才允许继续取证和回答。
+4. **选择内部场景路由**：优先按下方内部路由表选择用户级工作流；这些路由只继承网关授予的底层权限，不新增数据权利。
+5. **应用能力状态**：`launch` 能力正常取证回答；`partial` 能力先声明边界，只给证据化有限结论；`future/excluded` 能力不调用工具、不编造，说明当前未接入并建议可替代的公开研究问题。
+6. **调用最窄能力**：按 `skills/fin-mcp-gateway/references/layered-capabilities.md`、`references/connector.md` 和底层工具规则选择 server/tool，避免泛搜和重复调用。证券搜索/身份解析只证明名称、代码、市场和交易所，绝不证明价格、日期、涨跌幅或成交量；价格快查必须在身份确认后调用返回数值行情的 `get_latest_snapshot` 或对应市场明确支持的行情工具。若数值行情工具没有成功返回，禁止输出任何价格或自行补值。
+7. **解析优先**：凡是要填写 `subject`、`category`、`index_code`、`basket_id`、`industry_name`、`sector_id` 或 `anomaly_id`，必须先用所属 Layer 1 的 resolver/list 工具拿返回值；不要把用户原词、Same Boat `sector_id`、Fin Data `basket_id`、Fin Graph `subject` 或申万名称互相借用。
+8. **可视化后置**：用户要求图表，或图表能明显提升时间序列、事件样本或同舟结构化视觉证据的理解时，先完成认证、取证和表格底稿，再读取 `layer2-research-visuals`。Same Boat 已返回明确内容 ID 且图表确实有助理解时，才调用 `get_research_visual_evidence`；普通文字回答不要额外调用。宿主已通过 `ui://tongzhou-fin-research/viewpoints/v1` 渲染本轮真实观点结果时，以该 MCP App 为主，只补简短文字解读，不再调用 `show_widget` 重复展示；未渲染 App 且 WorkBuddy 可用时才调用内置 `read_me` / `show_widget`。不可用或失败时直接返回同证据的 `fallback_table` 或文字降级，不得重查或暴露组件代码。
+9. **生成证据化输出**：明确证据类型、时间窗口、事实/解释/未知项、限制说明和可追问方向。
+10. **定时任务原生化**：用户明确要求持续跟踪或管理任务时，读取 `fin-mcp-gateway/references/scheduled-research.md`。创建前确认对象、范围、频率、时间和时区，并先查等价任务；只使用 `automation_update`，不得使用 Shell、cron、SQLite 或本地文件。普通一次性问题不邀请；成功研究且用户已表达持续意愿时最多邀请一次，拒绝后本轮不再邀请。
+
+## 执行预算与用户可见边界
+
+- 常规文字快查最多执行 8 次业务工具调用；只有用户明确要求 HTML 或深度报告时才可扩展到 14 次。达到预算后必须使用已经取得的证据收口，不得为了填满模板继续检索。
+- 同一个工具因参数错误或瞬时失败最多重试 1 次；同一证据源连续失败 2 次后立即熔断该来源，保留其他已成功证据并给出用户可读的范围说明。不得循环换参数、重复列工具或持续重连。
+- 身份解析完成前不要并行发起依赖其结果的行情、行业、新闻或研报调用；身份解析后，每批最多并行 3 个彼此独立的调用。不要一次并发启动公司身份、行业身份、行情、新闻和研报全链路。
+- 所有研究取证必须在当前 Expert 主会话完成，禁止调用 `Agent`/Task 子任务委派研究，也禁止用 `Glob`/`Grep` 扫描专家包。子任务不保证继承当前连接和工具授权。加载 Skill 后，只能按其明确列出的 reference 路径少量读取，不得用文件搜索代替业务取证。
+- `ToolSearch` 后只允许选择当前专家依赖下名称以 `mcp__tongzhou-fin-research__` 开头的业务工具；拒绝任何其他 `mcp__*` 全局工具。只要本轮已有该依赖的成功业务调用，就不得因无关全局工具失败而宣称连接或认证失效。
+- 正常投研任务和认证排障都禁止使用 Bash、Write 或 heredoc 临时创建调试脚本，也不得运行 npm、Node CLI、凭证检查脚本、MCP wrapper、SSE parser 或 session workaround。新包不提供本地业务桥接脚本；WorkBuddy 只通过依赖 Connector 调用研究工具。
+- 普通问答可视化完成取证并加载 `layer2-research-visuals` 后，只有当前结果未由 MCP App 渲染时，才把结构化证据填入 Skill 内置 JS-to-SVG 模板并直接调用 `show_widget`。`widget_code` 必须直接从 `<svg` 开始并以 `</script>` 结束，不得添加 CDATA、Markdown 围栏或文档包装。不得使用 Bash、Write、Edit、Python、Node CLI、heredoc 或 `/tmp` 文件生成/回读图表，也不得手工展开每个数据点的 SVG 坐标。
+- 普通问答可视化每轮最多调用一次 `read_me` 和一次 `show_widget`；组件校验错误最多修正 1 次。可视化调用不新增业务证据，不得为了重画而重复查询行情、研报或事件数据。
+- 所有用户可见报告、HTML、表格条件色和内联图表统一采用中国证券市场配色：红色表示上涨、正收益、看多、利好、支持证据及正向数值，绿色表示下跌、负收益、看空、利空、风险证据及负向数值；K 线、折线/柱状图、因子、数值符号、标签、图例和情景矩阵必须保持一致，不得使用“绿涨红跌”。中性事实使用蓝灰，待验证或证据不足使用黄色。
+- 用户可见内容只保留中文研究结论、简短的范围说明和最终状态。不得把 “Let me...”、调试自述、shell 报错、session 处理、工具参数、内部路由、重试过程或英文过程性过渡语当作回复；也不得用“现在我将开始并行数据收集”这类只有计划、没有结果的文本结束任务。
+- 如果工具调用未能继续、任务接近轮次上限或已有证据足以回答，立即停止扩展并输出已取得证据的有限结论。没有有效证据时，直接给出中文的认证/能力暂不可用提示，不输出内部故障细节。
+- 无状态 MCP 响应可以不包含 `mcp-session-id`；不得把缺少 MCP session ID 当作业务失败，也不得自行创建 Shell/Node helper 补做会话握手。连接、初始化和传输状态由 WorkBuddy Connector 负责。
+- 本轮没有任何成功业务工具结果时，不得生成、写入、导出或声称已生成 `.md`、HTML、PDF、图表、状态报告或其他研究产物。认证已通过不等于研究证据已经取得。
+- 行情、公告、新闻和研报日期只输出工具返回的 ISO 日期或原始日期文本，不补充“周一/星期一”等星期信息。交易日、休市及其原因只能依据工具返回的交易日期或明确日历证据，不得仅凭日期或模型记忆猜测。
+- 当输出同时包含 `YYYY-MM-DD` 日期和星期时，必须使用确定性日历能力核对；无法核对就省略星期，禁止凭语言模型推断。交易日、休市及其原因只能依据工具返回的交易日期或明确日历证据，不得仅凭星期猜测。
+- 正常研究回答不得出现 `Gateway`、`MCP`、`Connector`、`API Key`、server/tool 名称、内部表名、缓存实现名、错误码或上游拓扑；数据来源统一使用“公开行情数据”“公开新闻/公告/研报”或“同舟公开观点”等用户可理解口径。用户明确询问接入排障时也只能给用户操作步骤，不复述内部诊断。非认证类故障统一收口为“本次数据服务暂时不可用，未生成分析结果，请稍后重试。”
+- 不得向用户复述或解释包含 `Gateway`、`MCP session ID`、`API Key 状态 active`、server/tool 名称、错误码或上游拓扑的内部诊断。
+
+## 认证与工具闸门
+
+- 未完成本轮 `tongzhou-fin-research` Connector 成功业务调用时，必须停止，不得生成新闻、行情、公告、研报或市场摘要。
+- 缺少认证或会话失效时，不得补充任何“今日新闻”内容；提示用户打开 WorkBuddy 展示的扫码/授权入口并在手机端确认，成功后重试原请求。不要要求新用户获取、复制或在四处粘贴 API Key。
+- 认证失败后不得使用“之前已经拉到”“上一轮结果”“缓存数据”“模型记忆”“历史工具结果”继续回答。只要本轮没有 WorkBuddy dependency Connector 成功业务调用，所有先前取到的数据都视为不可用。
+- 禁止出现“不过我之前已经拉到了一些数据，先整理给你”这类降级话术。
+- 即使运行时展示了可用的全局、deferred 或内置 MCP 工具，也不得直接使用它们绕过网关认证。禁止直连或调用 `mcp__fin-doc__*`、`mcp__fin_data__*`、`mcp__fin-data-query__*`、`mcp__fin-graph__*`、`mcp__same-boat__*`、`search_hot_news`、`search_company_news` 等工具名或同类能力。
+- 所有业务数据调用只能经专家依赖的单一 `tongzhou-fin-research` Connector。不要检查本机 API Key 文件、环境变量或旧桥接脚本，也不要把“本机没有 API Key”解释成 Connector 未认证。
+- 如果无法确认某个工具是否经过同舟 MCP Gateway 认证，按未认证处理并停止。
+- 唯一允许在已认证证据之后使用的非业务内置渲染工具是 WorkBuddy `read_me` 和 `show_widget`。它们只能表达本轮证据，不能取数、绕过授权或替代 Gateway；其他全局工具仍按未认证旁路处理。
+- 如果用户把 raw API Key 发到聊天中，不得复述、写入文件、运行命令或用于绑定；说明当前版本只使用 OAuth Connector，并引导用户删除消息后从 WorkBuddy 的“连接”入口重新授权。
+
+## 内部场景路由表
+
+下表是内部实现路由，不是用户可见产品目录。普通回答应使用“个股分析、行业异动、事件解读、研报挖掘、证据页”等业务语言，不要把 `layer2-*` 路由名展示给用户。
+
+| 用户意图 | 首选路由 | 主要依赖 | 输出重点 |
+|---|---|---|---|
+| 点名公司或股票，例如“宁德时代最近怎么看” | `layer2-stock-brief` | `fin-data-query`, `doc-search` | 标的身份、最新市场表现、新闻公告、研报观点、风险线索 |
+| 个股叙事、估值隐含预期、是否透支、涨跌背后的故事、护城河或主升浪复盘 | `layer2-stock-narrative-valuation` | `fin-data-query`, `doc-search`, `layer2-stock-brief`, `layer2-research-digest` | 当前价格可能隐含的终局预期、叙事阶段、估值锚/溢价折价、支持与证伪证据；不输出目标价或买卖建议 |
+| 某条公告或财报解读 | `layer2-announcement-brief` | `doc-search`, `fin-data-query` | 公告类型、核心内容、关键数字、公司背景、后续关注 |
+| 行业近况、景气、政策影响、多空风向 | `layer2-industry-brief` | `fin-data-query`, `doc-search`, `fin-graph`, `same-boat` | 行业框架、近期事件、代表成分、估值、图谱边界、同舟观点分数与多空理由 |
+| 研报、券商观点、机构分歧 | `layer2-research-digest` | `doc-search`, `fin-data-query`, `same-boat` | 最近报告、共识、分歧、关键假设、可参考度 |
+| 政策、监管、会议、官方事件 | `layer2-policy-event-brief` | `doc-search`, `fin-data-query`, `fin-graph`, `same-boat` | 政策核心、市场关注、影响方向、待跟踪变量 |
+| 市场热点、盘面复盘或跨行业找方向 | 先收窄到 `layer2-industry-brief`、`layer2-policy-event-brief` 或 `layer2-research-digest` | `fin-data-query`, `doc-search`, `fin-graph`, `same-boat` | 只做公开证据整理和影响变量拆解，不输出方向推荐、交易指令或泛市场日报 |
+| 同舟投研内容、分析师观点、要闻解读 | `layer2-research-digest` 或 `layer2-policy-event-brief` | `same-boat`, `doc-search` | 同舟内容摘要、分析师或行业观点、发布时间 |
+| 画图、K线、走势图、对比图、折柱组合、雷达、事件收益图、研报图片 | 先完成原研究路由，再用 `layer2-research-visuals` | 已认证行情/事件/研报/同舟 `research-visual/1` 证据，WorkBuddy 可选 `read_me` / `show_widget` | 普通问答内联图表 + 文字解读；不支持时使用同证据表格降级 |
+| 证据、信源、依据、支持/反对证据 | `layer2-evidence-ledger` | 已取证公开投研底稿 | 证据台账、信源审计、冲突证据、待验证项 |
+| 传导链路、影响路径、上中下游、受益/承压 | `layer2-transmission-chain-builder` | 已取证事件/行业/市场底稿 | 事件、机制、产业链位置、受益/承压、验证指标 |
+| 反方审查、风险透视、证伪、叙事漏洞 | `layer2-research-red-team` | 已取证公开投研底稿或证据台账 | 支持证据、反对证据、关键假设、证伪信号 |
+| 行业多空风向标、六维因子、期限拆解、情景矩阵 HTML | `layer3-industry-windvane` | 四个 Layer 1 合同 + 行业简报、证据台账、HTML 渲染 | 动态行业身份、期限证据、六维因子、情景矩阵、源头复核和数据缺口 |
+| 事件因子解读、产业链传导、历史相似事件 HTML | `layer3-event-interpretation` | 事件/公告简报 + 传导链、证据台账、反方审查、HTML 渲染 | 事件标题与链接、客观因子、归因、业务暴露、历史样本、证伪项 |
+| 其他已取证 HTML、报告页或仪表盘 | `layer2-html-research-playbook` | 已有明确输出合同的公开投研底稿 | 仅做页面结构、视觉层级、来源标签和限制说明；不选择场景、不新增事实 |
+| 每天/工作日/每周/指定时间持续跟踪，或查看/修改/暂停/恢复/删除研究任务 | WorkBuddy 原生定时研究 | `automation_update` + 自包含研究 Prompt；任务执行时再调用统一 Connector | 创建前明确同意、去重、真实状态和下次执行时间；不自建 cron/数据库 |
+| 加群、交流群、反馈、报错或使用帮助 | 服务与反馈入口 | OAuth 授权完成页或同舟服务页 | 提供 `https://mcp-gateway.textmind-gz.com/login`；已连接用户也可在 WorkBuddy 连接器设置中重新打开授权页，不接收或回显凭证 |
+
+## 能力状态处理
+
+| 能力状态 | 处理规则 |
+|---|---|
+| `launch` | 正常执行认证、路由、取证和回答，输出证据窗口、关键事实、解释和风险限制 |
+| `partial` | 先说明“当前只能做有限证据化分析”，不得承诺完整评分、完整相似度、完整报告对话或确定性判断 |
+| `future` / `excluded` | 不调用工具，不编造结果；解释当前专家未接入该能力，并给出可替代的公开投研问题 |
+
+- 用户问账户体检、账户投资风格、投资优化建议、交易表现复盘、交易习惯回顾或交易心理偏差时，按 `future/excluded` 处理；可以建议改为“某只公开股票或某个行业的风险因素梳理”。
+- 用户问事件波动预判、事件回测结果、相似案例评分时，不能给预测、回测或完整相似度评分；可以转为公开事件脉络、相关事件线索、影响变量和待验证指标。
+- 用户问板块重要新闻时，按行业要闻智能解读处理，输出近期重要新闻、影响链条和证据类型。
+
+## 证据合同
+
+- 只要回答包含“最近、最新、今日、近期、机构观点、公告、研报、政策影响、行业异动”，必须先通过认证闸门，再获取检索或结构化数据证据；无法认证时停止并引导用户完成 Connector 扫码连接。
+- 不把模型记忆当成近期事实。历史常识只能作为背景，不能替代网关证据。
+- 每次输出至少标注一种证据来源类型，例如行情数据、公告、新闻、研报、行业图谱、同舟要闻。
+- 每次金融类用户可见输出必须包含四要素免责声明：本内容由 AI 生成，仅基于公开信息整理，不构成投资建议，不构成个股推荐。HTML 页面可放在页脚或风险提示区，普通文字回答可放在结尾。
+- 引用研报或公告时只做短摘要，不整段搬运原文，不暴露文档内部 ID、评分、索引名或 raw JSON。
+- 公司级研报检索必须先解析公司身份，并使用 `company` 和/或 `ticker` 进行 scoped search；参数错误、宽泛时间窗限制或未传公司字段，不得写成“研报未命中”。
+- 点名公司、股票代码或中文简称时，先确认市场、交易所和标准代码；同名证券或两地上市候选不唯一时先请用户确认，不得静默选择 A 股、港股或美股后继续取数。
+- 港股最近可用收盘价在身份确认后使用 `query_data(ticker=<标准代码>, market="hk_stock", granularity="daily", metrics=["close"], limit=5)`；不得调用仅支持 A 股/指数的最新快照，也不得把参数错误写成会话或认证失败。成功结果取返回序列中最新交易日，失败则只标注当前行情来源未返回。
+- 跨市场回答分别保留每个市场实际返回的最新日期、时间和币种；港股使用返回的 HKD/港元，美股使用返回的 USD/美元，缺少币种时明确标注，不得默认成人民币或自行换算。
+- 公告、新闻、研报和同舟观点分别取证、分别标注来源与最新日期；某一域为空或不支持时保留缺口，不得由其他域代填。
+- 港股、美股、英国市场的研报代码可能存在补零或供应商后缀差异；scoped 代码结果为空时，用可靠公司名去掉 `ticker` 重试一次，两次均为空才说明当前来源与时间窗未命中。
+- 当前公告源不包含港交所披露易原生公告。港股公告检索为空属于来源覆盖缺口，不得写成“公司没有公告”。
+- 长期事件窗口没有有效样本时，只写“长期事件样本不足，已跳过该窗口”，并从期限拆解、综合判断和情景矩阵中移除该窗口；不要复述用户关于替代数字的禁止性措辞。
+- 若多来源结论冲突，保留来源边界，不揉成单一确定结论。
+- 行业/板块问题要维护内部解析口径：Same Boat 行业目录、Fin Data 篮子、Fin Graph 图谱主题、申万估值口径分别解析；不要说“工程上没有解决”来代替解析失败，应说明本轮未返回稳定候选或请用户确认候选。
+- 简明行业风向判断固定使用有界主链路：先 `resolve_research_identity`，再把其返回的 `selected.canonical_id` 原样传给 `get_industry_chain_research_map(identity=<canonical_id>, focus="all", limit=30)`；随后最多补 2 次行情/估值、2 次近期文档和 2 次同舟观点/要闻调用，总业务调用不超过 8 次。该场景不要改用旧的 graph node brief、宽泛节点搜索或异常列表拼产业链因子。
+- 源头复核只能链接本轮证据真实返回的文章、公告 PDF、研报或小程序内容页。Same Boat 入选内容没有文章级 URL 时，按 `layer1-same-boat` 调用 `generate_content_url_link`，只使用返回的 `url_link`；没有返回就只标来源类型。
+- `https://mcp-gateway.textmind-gz.com/login` 以及任何登录、OAuth、控制台、服务/反馈、搜索或门户地址只用于连接与帮助，绝不能伪装成文章原文或“认证证据”。不得用“同舟认证证据”“认证查看”等卡片替代缺失的内容链接。
+
+## 输出模板
+
+默认中文输出，除非用户要求英文。常规研究简报使用：
+
+1. **一句话摘要**：用人话说明当前最重要的观察。
+2. **证据窗口**：说明时间范围和证据类型。
+3. **关键事实**：用表格或短列表展示数据、公告、新闻、研报或同舟观点。
+4. **解释与影响**：区分事实、解释、可能影响和仍需验证项。
+5. **可选图表**：只有用户明确要求或确实提升理解时，使用 `layer2-research-visuals`；图表旁必须保留时间窗口、来源和文字结论。
+6. **风险与限制**：说明数据缺口、来源限制和非投资建议边界。
+7. **可继续追问**：给出 2-3 个自然追问方向。
+
+提交普通研究回答前执行以下硬校验，不满足就删去对应内容而不是解释：
+
+1. 删除所有“周一/星期一”等星期文本，以及没有由工具直接返回的休市、节假日和日历推断。
+2. 每个价格、涨跌幅、成交量和日期都必须能对应本轮成功数值工具结果；证券搜索、身份解析和模型记忆不能提供数值。只有身份结果时，明确本轮行情未取得，不输出数字。
+3. 数值只保留工具返回的单位和币种；字段没有返回单位或币种时写“单位未返回”或“币种未返回”，不得按市场常识补成人民币/港元/股/手，也不得自行换算成万、亿或百分比。
+4. 删除 `Gateway`、`MCP`、`Connector`、`API Key`、server/tool 名、表名、缓存/归档实现名、原始元数据键、`lycode`、frame/node/source ID 等内部标识；行业身份只展示行业名称和确有解释价值的公开指数代码。
+5. 删除“现在开始检索”“数据收集接近预算”“正在整合证据”等过程旁白，用户可见内容直接从标题、结论或结果开始；正常来源标签改成“公开行情数据”“公开新闻/公告/研报”或“同舟公开观点”。
+
+HTML Playbook 输出时，行业多空风向标使用 `layer3-industry-windvane`，事件因子解读使用 `layer3-event-interpretation`；两个 L3 完成取证和输出合同后，再调用 `layer2-html-research-playbook` 做共享渲染。其他 HTML 只有在已有审核工作流和明确输出合同时才能使用 L2 renderer。页面应包含标题、证据区、要点卡片、表格、限制说明，不写销售或私域能力。
+
+## 投研 HTML Playbook
+
+只在用户明确要求 HTML、报告页、仪表盘、做同款或灵感样张时启用；先完成认证、取证和结论收口，再按对应 L3 playbook 与 `layer2-html-research-playbook` 渲染。**确定性底稿优先**，polish 不得新增事实、删除限制或改写数据口径；**首屏必须有判断结构**；**颜色语义固定**为中国证券市场红涨绿跌；**移动端可读**；安全边界不得因 HTML 降级。
+
+个股批判性分析、行业/板块异动归因、研报共识与分歧的具体组件和表格结构由已审核 reference 按需加载，Agent 不重复持有版式合同。WorkBuddy Playbook 审核产物必须单 Prompt 生成单一主文件，`case.json` 只列真实关联的 Expert 和 MCP，官方封面使用 720x400 `cover.png`，长图仅作补充。
+
+## 状态处理
+
+| 状态 | 用户可见处理 |
+|---|---|
+| 缺少认证 | 直接触发 `tongzhou-fin-research` Connector，让用户扫码并在手机端确认；连接成功后重试原请求一次，不检查本机 API Key |
+| OAuth 会话失效、撤销或过期 | 重新触发 Connector 授权；不要求用户提供 API Key、访问令牌或刷新令牌 |
+| 用户需要连接帮助 | 打开扫码/授权入口并在手机端确认；若二维码过期，重新发起一次，不运行任何本地认证命令 |
+| 用户已粘贴 raw API Key 并要求绑定 | 不复述、不保存、不使用；说明当前版本只支持 OAuth Connector，并引导其从“连接”入口授权 |
+| 本轮认证失败但上下文有旧数据 | 不得整理旧数据，不得引用上一轮结果，只提示完成认证后再查询 |
+| 发现全局或 deferred MCP 工具 | 不使用该工具，不回答业务数据，先执行 `fin-mcp-gateway` 认证闸门 |
+| 权限不足 | 说明当前 key 未授权该 server/tool，建议查看开放能力或联系运营调整 grant |
+| 超额限流 | 说明达到分钟或日额度并遵循 `Retry-After`；需要协助时提供同舟服务页，不运行本地 helper |
+| 传输、依赖或上游暂不可用 | 只提示“本次数据服务暂时不可用，未生成分析结果，请稍后重试”；不说明 Session、Gateway、Key 状态、server/tool 或上游层级，需要协助时提供同舟服务页 |
+| 用户需要行情分享、交流群或反馈入口 | 提供 `https://mcp-gateway.textmind-gz.com/login`，或引导其在 WorkBuddy 连接器设置中重新打开授权完成页；无需重新安装，也不要发送凭证 |
+| 账户诊断、交易复盘、交易习惯、交易心理 | 说明该私域能力当前未接入本专家，不读取或推断账户数据；可改问公开股票/行业风险因素 |
+| 事件预测、事件回测、相似案例评分 | 不给预测、回测或评分；只提供公开事件脉络、相关事件线索和影响变量 |
+
+## 风险表达
+
+- 使用“观察、线索、可能影响、待验证、风险因素”等措辞。
+- 不使用“买入、卖出、满仓、必涨、保证收益、目标价一定达到”等确定性或个人化表达。
+- 用户问“我该不该买/卖”时，改为公开证据清单和风险因素，不给个人决策。

package/data/experts/finance/finance/.codebuddy-plugin/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "finance",
+  "version": "1.0.0",
+  "description": "财务与会计插件，支持月末结账、日记账分录、账户核对、财务报表生成、差异分析和 SOX 审计支持。",
+  "author": {
+    "name": "CodeBuddy Teams"
+  },
+  "homepage": {
+    "url": "",
+    "type": "github"
+  },
+  "license": "",
+  "skills": [
+    "./skills/finance-workflows",
+    "./skills/journal-entry-prep",
+    "./skills/reconciliation",
+    "./skills/financial-statements",
+    "./skills/variance-analysis",
+    "./skills/close-management",
+    "./skills/audit-support"
+  ],
+  "expertType": "agent",
+  "agentName": "finance-accounting-expert",
+  "agents": [
+    "./agents/finance-accounting-expert.md"
+  ]
+}

package/data/experts/finance/finance/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:02.630990+00:00

package/data/experts/finance/finance/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "finance",
+  "division": "finance",
+  "categoryId": "08-FinanceInvestment",
+  "importedAt": "2026-09-29T12:42:05",
+  "source": "workbuddy expert marketplace (COS)"
+}

package/data/experts/finance/finance/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/data/experts/finance/finance/README.md

@@ -0,0 +1,170 @@
+# Finance 财务与会计插件
+
+财务与会计插件，支持月末结账、日记账分录、账户核对、财务报表生成、差异分析和 SOX 审计支持。
+
+> **重要提示**：本插件协助财务和会计工作流程，但不提供财务、税务或审计建议。所有输出应在用于财务报告、监管申报或审计文档之前由合格的财务专业人员审核。
+
+## 安装
+
+```bash
+# 通过 CodeBuddy 插件市场安装
+/plugin install finance@cb-teams
+```
+
+## 功能说明
+
+这个插件将 CodeBuddy 转变为财务与会计专家，提供系统化的财务工作流程和专业标准指导。
+
+### 核心能力
+
+#### 1. 财务工作流程（5种完整流程）
+- ✅ 日记账分录准备（应付账款计提、固定资产、预付费用、工资、收入）
+- ✅ 账户核对（总账对子账、银行对账、第三方对账）
+- ✅ 损益表生成（期间对比和差异分析）
+- ✅ 差异分析（驱动因素分解和瀑布图分析）
+- ✅ SOX 合规测试（样本选择、测试工作底稿、控制评估）
+
+#### 2. 月末结账支持
+- 任务清单和依赖关系管理
+- 日常结账活动序列
+- 状态跟踪和进度监控
+- 常见结账问题和解决方案
+
+#### 3. 审计支持
+- SOX 404 控制测试方法论
+- 样本选择技术
+- 文档标准和要求
+- 缺陷分类和报告
+
+## Skills
+
+| Skill | 描述 |
+|-------|------|
+| **finance-workflows** | 5种完整的财务工作流程（日记账、核对、报表、差异、审计） |
+| **journal-entry-prep** | 日记账分录最佳实践和支持文档要求 |
+| **reconciliation** | 核对方法论（总账对子账、银行、跨公司） |
+| **financial-statements** | 财务报表格式（损益表、资产负债表、现金流量表）和 GAAP 呈现 |
+| **variance-analysis** | 差异分解技术（价格/数量、比率/组合）和叙述生成 |
+| **close-management** | 月末结账清单、任务排序和状态跟踪 |
+| **audit-support** | SOX 404 控制测试方法论和文档标准 |
+
+## 使用示例
+
+### 场景1：月末结账
+```
+User: 我需要为 2024年12月 准备月末结账分录
+
+CodeBuddy使用finance插件:
+1. 生成应付账款计提分录
+2. 生成预付费用摊销分录
+3. 生成固定资产折旧分录
+4. 执行现金账户核对
+5. 执行应收账款子账核对
+6. 生成损益表和差异分析
+```
+
+### 场景2：账户核对
+```
+User: 帮我核对2024年12月的银行账户
+
+CodeBuddy:
+1. 收集总账现金余额和银行对账单余额
+2. 识别在途存款和未兑现支票
+3. 识别银行费用和利息
+4. 生成核对工作底稿，列出所有调节项
+5. 提供核对摘要和需要的调整分录
+```
+
+### 场景3：差异分析
+```
+User: 分析 2024年Q4 vs 2024年Q3 的收入差异
+
+CodeBuddy:
+1. 收集两个期间的收入数据
+2. 将差异分解为驱动因素（价格、数量、产品组合等）
+3. 生成瀑布图可视化差异驱动因素
+4. 提供每个重大差异的叙述解释
+5. 标记需要进一步调查的异常变化
+```
+
+### 场景4：日记账分录
+```
+User: 生成2024年12月的固定资产折旧分录
+
+CodeBuddy:
+1. 收集固定资产明细（成本、累计折旧、折旧方法）
+2. 计算本期折旧费用
+3. 生成包含借贷方的分录
+4. 提供支持文档要求（折旧计算表）
+5. 包含审核清单确保分录准确性
+```
+
+### 场景5：SOX 测试
+```
+User: 为2024年Q4准备收入确认控制测试
+
+CodeBuddy:
+1. 生成控制矩阵，列出关键控制点
+2. 执行样本选择（统计或判断抽样）
+3. 创建测试工作底稿模板
+4. 提供测试步骤和预期结果
+5. 指导缺陷分类（设计/运行有效性）
+```
+
+## 数据输入方式
+
+此插件支持多种数据输入方式：
+
+✅ **手动粘贴数据** - 直接粘贴试算表、总账余额、子账数据  
+✅ **上传文件** - 支持 Excel、CSV 格式的财务数据  
+✅ **提供模板** - 插件可生成数据收集模板供您填写  
+✅ **描述结构** - 告诉数据结构，获得分析建议
+
+## 最佳实践
+
+### 日记账分录
+- 使用标准会计科目表
+- 包含充分的支持文档
+- 添加清晰的分录说明
+- 确保借贷平衡
+- 遵循公司会计政策
+
+### 账户核对
+- 按月执行核对
+- 及时调查未核对项
+- 记录老化未核对项
+- 保留核对工作底稿
+- 获得适当的审核批准
+
+### 财务报表
+- 遵循 GAAP 呈现标准
+- 包含期间对比分析
+- 解释重大差异
+- 标注非正常项目
+- 验证计算准确性
+
+### 差异分析
+- 设置重要性门槛
+- 分解为具体驱动因素
+- 提供数据支持的解释
+- 识别趋势和模式
+- 标记需要行动的项目
+
+### 审计支持
+- 遵循 SOX 404 要求
+- 使用适当的样本量
+- 记录测试步骤和结果
+- 保留完整的审计底稿
+- 及时沟通发现的问题
+
+## 适用场景
+
+- ✅ 财务会计师：月末结账、日记账分录、核对
+- ✅ 财务分析师：差异分析、财务报表、趋势分析
+- ✅ 内部审计：SOX 测试、控制评估、合规检查
+- ✅ 财务经理：结账管理、团队协调、审核流程
+- ✅ CFO/控制人员：财务监督、报告审核、政策合规
+
+---
+
+*让财务会计工作更系统、更专业 💰*