AlgoQuant Insights

AlgoQuant Insights（简称 AQI）是 AQS 的研究与发表平台。策略开发者可以在这里撰写研究文章、关联相关研究，并通过公开个人资料展示系统化交易研究成果。

AQI 以 AQS 为主要工作环境。你可以在网站上阅读已发表的研究文章、浏览公开文章列表；完整的创作与互动流程则在 AlgoQuant Studio 中完成。

AQI 的用途

需要记录和分享以下内容时，可使用 AQI：

• 策略想法和研究笔记
• 回测结论和实时运行经验
• 市场结构观察
• 其他开发者可以检查的实现决策
• 对工作产生影响的参考研究文章
• LaTeX 方程和简洁技术记法

这样，研究就能与策略开发和运行工具放在一起，而不是散落在互不关联的笔记中。

主要功能

AQI 当前支持：

• 已发表研究文章：用于公开研究和策略文章
• 文章草稿：发表前在 AQS 内管理
• 回测块：包含结果汇总、净值预览，以及指向 AQS 完整结果的链接
• 笔记本块：包含选定研究单元格、Rust 源代码和已保存输出样本
• 研究文章引用：将一篇 AQI 研究文章关联到另一篇
• 行内文章引用：在编辑器中插入 AQI 文章链接
• LaTeX 块和行内 LaTeX：使用 KaTeX 渲染
• Tiptap 富文本内容：用于结构化研究文章编辑和阅读
• 点赞、表态和评论：用于读者反馈和讨论
• 个人资料、关注者和正在关注：将研究活动与作者关联
• 浏览量：用于已发表研究文章

网站视图

AQI 公开网站支持：

• 浏览最新发表的研究文章
• 浏览获赞最多的研究文章
• 阅读已发表研究文章
• 无需运行代码即可查看嵌入的回测汇总、笔记本单元格、已保存表格和图表预览
• 查看研究文章引用
• 查看只读评论
• 登录后为研究文章点赞

如需写作、编辑草稿、管理引用、评论、表态、关注个人资料，以及使用完整 AQ Insights 工作流程，请打开 AQS。

创建有证据支持的研究文章

1. 在 AQS 中打开 AQI，再进入 My Papers，创建新研究文章。
2. 添加标题、简短摘要和研究正文。让读者清楚看到假设、数据来源和测试期间。
3. 如果工作建立在其他 AQI 研究之上，添加参考研究文章。保存前检查关联标题。
4. 附加符合条件的回测，或插入回测块，为具体论点提供依据。一篇文章可以引用多个结果；请解释每项测试能够说明什么。
5. 使用 Add notebook 包含选定研究单元格和已保存结果。解释代码和输出展示了什么。
6. 审核内容和分享权限，保存草稿，准备好后再发表。

发表研究文章不会自动公开所有本地回测或笔记本。每个组件都有自己的分享行为，详见下文。

内置研究文章组件

将光标放在要插入内容的位置，然后使用编辑器工具栏。将鼠标悬停在图标上可查看名称。工具栏包括：

控件	用途
Insert backtest	公开回测汇总及其完整结果链接。
Add notebook	选定笔记本单元格、源代码和已保存输出的只读快照。
Reference paper	行内 AQI 研究文章链接，以及保存研究文章时生成的引用条目。
Insert link	为所选文本或新插入文本设置普通 URL。
Insert image	从图片 URL 插入带替代文本的图或插图。
Insert 3x3 table	用于假设、参数或比较的可编辑表格。
Code block / Inline code	仅供显示的源代码或简短标识符。
LaTeX block / Inline LaTeX	渲染后的数学记法。

标题、段落、列表、引用、水平线、对齐和文本格式用于组织文章内容。这些是文章编辑工具，不是执行笔记本的控件。

添加回测

1. 选择 Insert backtest。
2. 在 Public backtests 下选择符合条件的结果。自己的结果标记为 Owner；其他作者的合格结果标记为 Co-op。附加其他作者的结果，要求双方互相关注。
3. 也可以在未公开的 Local backtest 旁选择 Make public & insert。这会公开上传结果，并在验证结果可用后插入预览。
4. 添加文字，说明测试期间、假设、成本和局限。可在其他光标位置重复操作，加入更多结果。

回测块显示策略名称、可用的描述和品种信息、总收益率、夏普比率、盈亏比、周期、测试日期和持续时间。数据可用时，还会显示整个运行期间的最大回撤、已平仓交易数、生成的交易信号数、胜率和获利因子。缺失指标显示为“—”，而不是零。生成的交易信号数包含父信号、子信号，以及未成交或被拒绝的信号，不等于盈利交易数。这些汇总有助于读者检查证据，但不能证明策略稳健，也不能证明未来能够盈利。如果有账户净值样本，块中还会提供交互式 Lightweight Charts 预览，最多显示最近 500 个带时间戳的数据点。较早公开的结果在重新发布前，仍使用原来较短的样本。预览不包含完整的净值历史或交易日志；请使用 Open full backtest in AQS 查看完整结果，详见回测评估。

**Make public & insert 会立即公开回测，即使文章仍是私有草稿。**选择前请检查结果。保存文章时，只能附加公开回测。

对于你自己的公开结果，选择器还提供 Make private。该操作会更改结果的访问权限，但不会自动删除已保存在文章中的嵌入汇总。如果文章不应继续分享该结果，请在保存前移除对应块及所有剩余附件。仅移除块，并不会将回测设为私有。

编辑器和网站中的笔记本时间序列图使用与 AQR 相同的 Lightweight Charts 渲染器，支持 K 线、叠加线、同步窗格、UTC 十字光标值和信号标记。热力图、散点图和分布保留相同的研究 SVG 渲染器。JavaScript 不可用时，仍提供安全的静态预览。图表只显示已保存样本，绝不会执行笔记本代码或连接数据源。

添加研究笔记本

1. 选择 Add notebook 打开选择器对话框，无需滚动离开编辑器当前位置。
2. 选择 Strategy project 和 Notebook，然后选择 Load notebook preview。
3. 选择要包含的单元格。选择是否包含 Rust source code 和 Saved tables, charts and results。
4. 检查预览和所有输出省略警告，然后选择 Insert notebook cells。
5. 检查代码和输出样本是否包含机密，并审核数据分享权限。在 Save Draft 或 Publish 前勾选分享审核复选框。

插入笔记本不会执行单元格、加载数据源，也不会上传任何内容。文章中保存的是固定快照，保留单元格边界、Markdown、所选 Rust 代码、表格样本、受支持的图表和纯文本结果。读者无需安装 Rust 或 AQS，也无需连接数据源，就能在网站上查看这些已保存结果。

过时、失败或未经验证的输出，以及执行日志，都会被排除。原始数据集文件、连接设置和其他任意笔记本元数据不会自动包含在内，但代码或打印出的值仍可能泄露敏感信息。选中的表格行会作为数据分享出去，请检查内容，并确认数据提供商允许分享。每个快照最多选择 100 个单元格，大小上限为 2 MiB；含笔记本块的文章也有 2 MiB 的分享上限。

每个选定单元格会成为独立的文章块，将代码和已保存输出放在一起。鼠标悬停时，单元格标题栏会显示 Move up、Move down、Add text before、Add text after 和 Remove block 图标。图标有工具提示，也会在获得键盘焦点时显示；触摸设备上则始终可见。这些操作不会改变源笔记本的顺序或内容。旧版的整本笔记本块仍受支持，可以在编辑器中选择 Split into cells 拆分，无需重新运行笔记本。

已保存单元格内容只读。结果变化时，应编辑源笔记本，在 Research 中运行并审核，然后插入新快照。后续笔记本编辑不会自动更新现有研究文章。编辑研究文章内容会清除分享审核勾选。保存或发布前不会上传任何内容。

在 AQS 文章阅读器中，你可以选中单元格代码、文本或表格输出中的一部分，在评论中引用，无需选中整个笔记本。可引用范围仅限文章正文，不包括表态和其他界面文本。在 AQS 和公开网站中滚动页面时，作者信息及点赞、评论、分享操作会保留在顶部。网站评论仍为只读；发表评论或回复请打开 AQS。

也可以从笔记本的 AQI paper 部分开始：

• Use notebook as paper 打开完整 AQI 编辑器，创建新本地草稿，并使用独立笔记本单元格块。
• Attach to a paper 将单元格块追加到某个私有草稿，同时保留现有内容和未保存编辑。

两种快捷方式都不会上传或发表研究文章。原笔记本仍位于策略的 research/ 文件夹。有关完整分享流程，请参阅研究笔记本。

图表与已保存输出

在 Research 中使用 aqs_plot、aqs_plot_many 和 aqs_chart 等辅助工具生成图表，然后将相关输出单元格包含在笔记本块中。支持 K 线图、折线叠加、独立 Volume/ATR 窗格、信号标记、散点图、分布和热力图。已保存的回测比较曲线和收益热力图也可按此方式分享。有关代码示例和采样限制，请参阅研究图表与辅助工具和策略复用与回测。

已保存的时间序列图在 AQS 和网站中使用 TradingView Lightweight Charts，支持缩放、平移、十字光标、叠加线和同步窗格。它们显示的是已保存数据，而不是实时数据源。交互式渲染不可用时，仍可显示 SVG 备用图；散点图、分布图和热力图则使用各自的已保存结果渲染器。图表可能使用了聚合或采样数据，请先阅读说明文字，不要直接将每个显示点视为一根原始行情 K 线。表格输出只是有限行列的预览，不是可下载的完整数据集副本。

引用其他研究文章和外部来源

选择 Reference paper，按标题、作者或标签搜索，再选择一篇 AQI 研究文章，即可插入行内文章链接。保存时会同步文章之间的引用关系，被引用的文章以紧凑卡片显示在正文下方。你可以通过引用交代前期工作、比较其他研究，或补充支持证据。

对于外部文章、仓库或数据集页面，应使用 Insert link。它为所选文本应用 URL，或在光标处插入带链接文本。普通网页链接不会创建 AQI 引用卡片。Remove link 移除所选链接的链接格式。

表格、图片与代码

• **表格：**选择 Insert 3x3 table，插入带表头行的表格。光标位于单元格中时，可使用 Add row、Add column、Delete row、Delete column 或 Delete table。这些表格是可编辑的文章内容，与笔记本中固定的表格输出不同。
• **图片：**选择 Insert image，提供图片 URL 和描述性 Alt text，然后插入。公开研究文章应使用可访问的 HTTPS URL。AQS 也接受粘贴或拖放图片文件，但网站目前会省略嵌入的 data: 图片；需要在两种阅读器中显示时，请使用托管 URL。本地文件路径不是公开图片 URL。
• **代码：**多行示例使用 Code block，变量或函数名称使用 Inline code。代码块默认语言为 Rust，仅显示源代码：不会编译、运行或产生输出。需要让读者同时看到代码和已保存结果时，使用笔记本块。

LaTeX 与技术记法

AQI 编辑器支持行内和块级 LaTeX。段落中的简短记法使用行内 LaTeX；需要独占一行的方程使用块级 LaTeX。

网站使用 KaTeX 渲染这些节点，使数学记法在公开研究文章视图中保持易读。

选择 LaTeX block 或 Inline LaTeX，输入表达式并选择 Insert。例如，直接输入 r_t = (P_t - P_{t-1}) / P_{t-1}，不加美元符号分隔符。选择现有公式并重新打开相应控件即可编辑。

分享前审核

使用 Save Draft 将文章上传为私有草稿，准备好公开时再选择 Publish。尚未保存的本地编辑内容不会作为云端草稿持久保留。发表前，请检查笔记本分享警告、引用文章、关联回测、图片是否可访问，以及市场数据的分享权限。发表后再检查公开文章，尤其是图表说明和在 AQS 中打开完整结果的链接。

最佳实践

让 AQI 研究文章对未来读者仍然有用：

• 展示结果前先定义交易问题
• 包含假设、数据来源、周期和执行上下文
• 链接相关 AQI 研究文章，不重复冗长背景
• 纯文本可能产生歧义时，使用 LaTeX 表达方程
• 用可核实的回测或实时运行证据支持有关实现的论断
• 使用 AQS 完成完整的编写、编辑、评论和表态工作流程