briefloop Skill 技能

技能简介

BriefLoop 是一款面向行业研究、战略与投资者关系从业者的本地报告工作台：把分散的材料整理成可编辑简报，逐项给出重要结论的依据，处理审阅问题，并保留原稿与修订版本。界面与文档为中文，报告正文可选中文或英文——英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，支持快速、标准、深度三档研究，以及生成后的可选独立事实核查。

核心能力

• 四类报告模板：通用报告、商业报告（行业周报/月报、工作进展周报、决策分析）、证券研究（事件点评、公司研究、行业跟踪）、会议纪要；八类内置版式开箱可用，内置 46 套 Word 版式。
• 四角色分工：BriefLoop 主 Agent 对话与写稿，Evaluator 独立评分，Wiki Maintainer 沉淀反馈经验，Skill Proposer 提出技能改进；四个角色可分别指定模型，留空继承主链。
• 多执行宿主：Codex（原生通道，默认）、Opencode（1.x/2.x）、Claude Code、Kimi、Hermes、DeepSeek Reasonix、MiMo Code、CodeBuddy Code 经 bridge 接入，另有内置引擎可脱离外部 CLI 运行。
• 受控检索与预算：默认优先 Tavily，可补查博查、智谱搜索、DuckDuckGo 或宿主自带搜索；周报预设 30 次搜索、150 个去重候选、60 个全文来源，整份报告共享，额度用尽即如实列出缺口。
• 可追溯交付：重要主张绑定到原文行、PDF 页、Excel 单元格；数值绑定按币种、单位核对；独立审阅分普通与严格两档，重大事实错误与证据缺口会阻止正式交付。
• 篇幅硬控制：速览 350/500、简短 800/1000、标准 1500/2000、详细 2000/2500（目标/上限字数），数字可直接修改，页面显示保存后的实际计数。

安装配置

1. 环境要求：macOS 或 Windows + Python 3.11 或更新版本；WebUI 安装需 Node.js 20+，桌面 App 复用 Electron 内置 Node。
2. 源码启动：git clone https://github.com/Stahl-G/briefloop.git && cd briefloop && ./start.sh，首次启动自动创建虚拟环境、安装依赖并打开网页，无需二次 clone。
3. PyPI 安装：pip install briefloop 后执行 briefloop start --workspace /path/to/workspace（PyPI 版本可能晚于源码，先 briefloop --version 核对）。
4. 宿主与搜索 Key：在「设置」中选择执行宿主并完成模型认证；用 Tavily、博查或智谱搜索时另行配置对应服务的 Key。

使用步骤

1. 打开工作区，在「材料与需求」填写报告目的、读者、时间范围与字数要求，可上传材料、开启联网或勾选 MCP 连接器材料。
2. 在「设置 → 运行与搜索」选择首选与补充搜索渠道，确认执行宿主、主模型与三个角色模型（模型 ID 支持手填）。
3. 点击生成，Scout 检索资料、Analyst 写稿、Evaluator 独立评分；草稿保存后即可查看，低分或评分失败不隐藏原稿。
4. 修改正文或留下反馈，需要时启动学习（自动学习默认关闭，开启前显示调用上限确认）。
5. 通过「已保存版本检查」查看断链引用与数值绑定，独立审阅通过后导出 Word、图文 ZIP 或审计包。

适用场景

• 行业定期报告：上传历史报告作结构参考，本期指标、前值、来源由研究角色整理，数据缺口如实列出并说明影响。
• 证券与投研写作：事件点评、公司研究与行业跟踪，区分实际、预测与估值假设，用有依据的数据生成图表。
• 战略与 IR 简报：定期核数字、核口径的对外材料，重要结论逐项给出依据，保留原稿与每次修订版本。
• 会议纪要与知识沉淀：粘贴转写或笔记整理决议、待办与未定事项；反馈经 Wiki Maintainer 沉淀为可复用技能。
• 外部 Agent 协同：WorkBuddy 等外部 Agent 可通过 briefloop external 提交报告、查询进度、读取来源稿件并下载 Word。

适用人群

需要定期写行业报告、核数字和统一口径的单人研究者；服务客户的行业研究、战略咨询与 IR 从业者；使用 Codex、Claude Code、OpenCode 等多种 AI 编程助手、希望本地留痕与可审计交付的分析师；对材料外发敏感、要求文件留在本机的工作团队（隐私去向表逐项列明何种操作会外发内容）。

工作原理

报告任务启动时先冻结系统日期、时区、搜索渠道与预算，之后 Scout 在共享预算内跨渠道检索，取得的材料登记为来源并保存原件哈希与回执；Analyst 按模板写稿，正文把主张绑定到具体来源定位。Evaluator 用独立模型会话评分并对照原文核验主体、期间与财务指标，独立审阅在只读通道执行，普通模式走宿主原生只读、严格模式强制包内读取。数值绑定程序按币种、单位与正负号核对，未绑定项如实显示未检查。通过后 Word 由本机程序生成，审计包支持离线结构校验；全程本地服务只监听 127.0.0.1，模型调用与检索请求的去向在隐私表中逐条披露。

官方链接

• PyPI 主页：https://pypi.org/project/briefloop/
• GitHub 仓库：https://github.com/Stahl-G/briefloop
• 官方网站：https://briefloop.ai
• 外部 Agent 调用指南：https://briefloop.ai/docs/external-agent.html