RegFish Notebook

在 VS Code / Cursor 中管理回归工作簿，运行本地回归并导出 RTF 表格。

主要功能

• 回归分析：基准回归（baseline）与组间差异检验（bdiff）。
• 研究表格：变量定义（def）、描述性统计（sum），按 KJYJ 格式导出 RTF。
• 可视化配置：全局参数、宏引用与备选组合，支持按列、按表或整本运行。
• 变量范围：def、sum 支持宏与变量的加减，减法作用于前面累计的整个集合。
• 结果管理：工作簿自动保存，复用有效结果，支持停止任务。
• 可选 AI：补全变量名称、生成回归说明。

快速开始

1. 从 GitHub Releases 下载 regfish-1.0.0.vsix。
2. 在 VS Code / Cursor 中执行 Extensions: Install from VSIX...，选择下载的 VSIX 安装。
3. 执行 RegFish: 新建工作簿，或打开已有的 .regfish 文件。
4. 在左侧 RegFish 面板设置 input、output 和全局参数，再配置各表。
5. 点击列、表或顶栏运行按钮。结果自动保存；开启表头“导出”后，同时生成 RTF，点击文件图标即可打开。

新建工作簿预置变量定义、描述性统计、基准回归、稳健性检验和截面检验五张表。也可复制 examples 目录，用 welcome.regfish 和同目录的合成数据 input.csv 试用。

运行要求

计算在本地 R 中执行，默认最多使用 8 个进程。首次使用会检测 R 和所需包，缺失时尝试自动安装；也可通过 regfish.rscriptPath 指定已有 Rscript。

AI 功能按需开启，需配置服务地址、Key 和模型。AI 仅接收相关变量定义和统计结果，不发送原始观测数据。

更多参数、运行规则和开发命令见详细说明。

独立项目开发

克隆仓库后，在项目根目录执行以下命令。源码、R 引擎、提示词、测试和合成示例均保存在本项目内，不依赖其他项目目录。

git clone https://github.com/Lachryz/RegFish.git
cd RegFish
npm ci --ignore-scripts
npm run prepare
npm test
npm run package
npm run verify:package

prepare 是开发构建入口；package 会先构建，再按 package.json 的版本生成 dist/regfish-<version>.vsix、SHA-256 校验文件和文件清单。单元测试默认使用 8 个并发进程；真实 VS Code 宿主测试与开发约束见详细说明。