alphacouncil-agent

Name: alphacouncil-agent
Author: Zhao73

本地服务

github.com/Zhao73金融数据37 周前更新

代码仓库

关于 alphacouncil-agent

alphacouncil-agent 将股票等标的研究拆分为证据收集、投资方法分析、多空辩论和投资组合经理决策，面向需要可审查研究过程的投资研究者。来源追踪、分歧保留和运行前确认是其特点。

主要功能

01并行收集公开证据
02按标的类型选择研究路径
03冻结方法立场后再解释
04多空交叉质询与经理决策
05重要论断关联来源 ID
06保存异议与审计记录

适用场景

01审查公司的投资研究结论
02通过 ETF 持仓穿透分析资产
03比较看多与看空论据
04回看决策依据及失效条件

MCP 相关

项目支持 Codex、Claude Code、OpenCode、Grok Build，以及 ChatGPT Work 的工具网关；README 未说明提供 MCP 服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "zhao73-alphacouncil-agent": {
      "command": "npx",
      "args": [
        "-y",
        "alphacouncil-agent"
      ]
    }
  }
}

启动命令npx -y alphacouncil-agent

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmalphacouncil-agent1.0.15stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
host	string	否	调用来源主机，例如 codex、claude-code、opencode 或 grok-build。
prompt	string	否	用户目标或额外指示。
symbol	string	是	交易所代码。支持 US、HK、JP、KR、CN 和 TW 代码，例如 AAPL、0700.HK、7203.T、005930.KS、600519.SS。
language	string	否	面向子 Agent 和最终报告的语言，例如 auto、zh-CN、en-US、ja-JP。Auto 会根据提示词推断。
council_mode	enum	否	full 运行包含八种角色的证据分发和三轮交叉质询。quick 运行固定的四角色预设（含新闻），最多使用四个 master，进行一轮并行看涨/看跌分析、简短的 PM，并设置严格的全局预算。full \| quick
council_pace	enum	否	仅预填：当请求中已指定速度（如 fast 或 slow）时使用。它会在返回的 pace_options 中突出显示该档位，但绝不会确认选择。仅限 Full。fast \| normal \| slow
preselected_master_ids	array	否	从请求中明确提及的 master 推断出的可选稳定 ID。它们仅作高亮显示；用户仍必须提交本次运行的选择。

详细介绍

一个可供审视的投资研究委员会

一个请求，即可获得有来源的证据、相互竞争的方法观点、多空交锋，以及投资组合经理的裁决。

英语 · 中文 · 日语

安装 · 试用数据层 · 查看调用如何逐步展开 · 阅读报告

v1.7： 简洁设置并记住选择、结论优先、扩展的每日历史记录，以及完整的方法依赖检查。仍需重新确认。升级详情与数据源边界。

问题 → 有来源的证据 → 已冻结的方法立场 → 多空交锋 → 投资组合经理决策 + 已保存的审计记录

历史版界面录像（MP4） · 历史版报告文件（SOX，中文）

_{该录像早于当前的 26 席候选阵容，仅展示早期界面，并不代表当前耗时、方法保真度、数据准确性、四个代码托管平台上的验证结果或 ChatGPT Work 验证结果。}

一个问题，一份可审查的案例。

AlphaCouncil 将关于股票代码的问题转化为可审查的研究流程。并行的证据工作者收集公开来源，选定的投资方法席位解读同一组带日期的事实，多方与空方对案例展开交锋，投资组合经理则记录决策及其失效条件。缺失的输入会明确显示，而不会被臆测填补。

同一代码库支持 Codex、Claude Code、OpenCode 和 Grok Build，以及仅限工具的 ChatGPT Work 开发者模式网关。它会先对公司、ETF 和市场指数进行分类，再开展研究，避免把一篮子资产当作运营中的公司来分析。

在 Codex 中安装

前提条件：Node.js 18 或更高版本。使用以下两条 shell 命令进行安装：

codex plugin marketplace add Zhao73/alphacouncil-agent
codex plugin add alphacouncil-agent@alphacouncil

Codex 启动时会加载插件。完全退出并重启 Codex，开启新会话，然后在 Codex 输入框中输入：

@alphacouncil-agent analyze AAPL

有关 ChatGPT Work 开发者模式、Claude Code、OpenCode、Grok Build、Windows、故障排除以及可选的全局 npm 命令，请参阅**完整安装指南**。

免费首次运行

启动 council 前，先检查无需密钥的公共数据层：

# Codex
@alphacouncil-agent AAPL news

# Claude Code, OpenCode, or Grok Build
/alpha AAPL news

此检查不会启动任何 council 工作进程，也不需要数据供应商密钥。在 Codex 中进行有限范围的研究，请使用 @alphacouncil-agent AAPL quick；在三个支持斜杠命令的宿主中，请使用 /alpha AAPL quick。

运行前选择研究深度

AlphaCouncil 会先显示工作计划。完整研究会分别询问方法席位、证据广度和研究深度；用户确认后，工作进程才会启动。完整档位的时限上限为 15 / 30 / 60 分钟，不会暗中估算令牌或货币成本。

运行	模型调用结构	时限上限
数据检查	仅使用无需密钥的工具；不启动 council 工作进程，也不额外扇出模型调用	不属于 council 档位
快速研究	4 个证据工作进程并行 → 1–4 个方法席位并行 → Bull 和 Bear 并行 → PM	10 分钟
完整 — 快速	8 个核心证据工作进程或全部 11 个范围内的证据工作进程同时启动；每个选定的方法立场都会以确定性方式冻结，然后由一个隔离的说明工作进程进行解释；3 轮辩论 → PM	15 分钟
完整 — 标准	使用相同的已确认名单、立场冻结流程、3 轮辩论和 PM，并提供更大的研究深度额度	30 分钟
完整 — 慢速	使用相同的已确认名单和阶段，并提供最大的研究深度额度	60 分钟

这些是从进入队列到持久化终态记录的时限上限，并非实测完成时间。即使工作未完成，也能确保生成明确的终态记录；目前尚未证明四个宿主都能在 15 分钟内成功完成实时快速运行。快速档保留完整的约定，但使用可审计、感知阶段的推理配置，并为每条主运行／重试／修复链共用一个生命周期预算；重试不会悄悄使席位上限翻倍。

当资产分类和类型化事实覆盖情况已可用时，选择器还会根据全部 26 份实体分析包清单，显示八类建议方法匹配。此外，明确的目标和持有期限还会校准该匹配，并区分方向性贡献、非投票风险贡献和仅供参考的背景贡献；out_of_scope 绝不会作为负面投票。对于为期一年的方向性请求，PM 会将有来源依据的基准情景总回报映射到一套已发布的评级标准，而不是按保守型方法席位计数；服务端会绑定冻结的价格／币种，并根据同币种目标价加收入重新计算该回报。out_of_scope 席位仍会显示在方法席位组中，但在结构上不会进入 PM 评级流程。这仅用于预填：每个分析包仍可供选择；未经明确确认，不会启动任何运行；缺少分类时也不会猜测默认值。输出代表 AI 生成的方法模拟，而非人类专家、独立模型或盈利承诺。请参阅方法面板推荐与席位证据。

只有选择全部方法和全部证据工作进程的慢速运行，才会启用额外的验证流程；其他完整档位不声称包含此项额外检查。

你将获得什么

优势	带来的变化
一组 council，而非单一答案	证据专家、方法席位、对立观点和 PM 会展示共识的由来。
先确定立场，再展开叙述	完整运行中，每个选定的方法立场都会根据结构化输入确定，然后才撰写隔离的说明。
可追溯的主张	报告中的重要主张必须指向来源 ID；缺失的证据会明确列为缺口。
综合后仍保留分歧	通过 3 轮交叉质询，并持久化少数意见或对立报告，让未获采纳的观点仍可供审查。
适合资产的研究路径	公司使用发行方证据；ETF 使用带日期的持仓穿透分析；指数使用汇总方法论。首次数据检查无需密钥。

架构有何不同

这里比较的是工作流形态，而非特定产品。具体工具可能采用不同的设计。

审查关注点	单模型回复或常见的共享上下文流程	AlphaCouncil
相关错误	一个共享上下文可能会将早期错误带入每个后续步骤	证据席位和对立路径在相互隔离的工作进程中运行；它们仍可能使用同一提供商或模型，因此不是独立模型
立场形成	立场可能与其解释一同撰写	结构化立场会在说明性文字撰写前冻结
来源追溯	可追溯性取决于提示词和宿主	每项重要主张都必须附带来源 ID
少数意见	异议可能被纳入最终摘要	少数意见和对立报告仍会作为审查材料呈现