🧭 ARWharness

Academic Research Workflow Harness — 一键把研究方向变成投稿级论文

npx arwharness ｜ GitHub ｜ npm ｜ MIT Shell · Cloud Core

输入一个研究方向 → 六阶段全自动科研闭环 → 文献矩阵 · 立项书 · 专属模型代码包 · 中英 LaTeX 手稿 · 质量评审 → 投稿包 🚀

🏗️ 系统架构总览

✨ 它是什么

传统科研：调研 2 周 · 写代码 3 周 · 写作 4 周 · 改稿 N 轮，90% 时间花在重复劳动上。

ARWharness 把这些重复劳动全部自动化：22 个科研角色 agent 多子代理并行协作，六阶段流水线自动推进，13 道质量门把关，评审-返工-复审循环直到达标。您只做三件事：选题 → 决策点审批 → 投稿。

你输入："储能电站参与电能量与辅助服务联合市场的分层收益建模"
   │
   ▼  ① Discovery   多源文献检索 → 矩阵 → 深度研究空白清单
   │  ② Design      立项书（FINER）→ 方法对抗评审 → 风险登记
   │  ③ Execution   研究专属数据集 → LLM 独立生成模型代码（沙箱执行）
   │                统计 · 图表 · IEEE 表格 → 一键复现代码包
   │  ④ Writing     六章中英手稿 → LaTeX 编译零错误
   │  ⑤ Quality     5 视角模拟审稿 → 交付门禁 → 返工循环
   ▼  ⑥ Submission  投稿包（Cover Letter + tex + PDF）

🏗️ Harness 架构

┌───────────────────── 用户本机（100% 掌控数据） ─────────────────────┐
│                                                                      │
│  npx arwharness ──► Node.js 外壳（MIT）                              │
│   ├─ Vue 3 完整工作流控制台（127.0.0.1，外网不可达）                   │
│   ├─ 研究目录沙箱（您自选目录，路径逃逸 403 拦截）                      │
│   └─ 产物自动同步（云端手稿/图表/代码包 → 本地目录）                    │
│                          │ HTTPS + 邀请码鉴权                        │
└──────────────────────────┼──────────────────────────────────────────┘
                           ▼
┌───────────────────── 云端核心（Railway · 闭源） ─────────────────────┐
│                                                                      │
│  Python 引擎 · 22 角色 agent · 多子代理并行                           │
│  ├─ 六阶段 orchestrator（断点续跑 · 异常自愈不终止）                    │
│  ├─ 13 道质量门（G1-G13）+ 期刊分级交付门禁                            │
│  ├─ 研究完全独立（每项研究的数据/模型/图表由 LLM 独立设计，不套模板）     │
│  └─ 密钥 AES-GCM 加密 · 90 天自动删除 · 不用于训练                     │
└──────────────────────────────────────────────────────────────────────┘

⚡ 快速开始

方式一：图形控制台（推荐，Node 18+）

# ① 一键启动（首次在弹窗中输入邀请码，验证通过即进入）
npx arwharness

# ② 浏览器自动打开（首次在弹窗中输入邀请码，验证通过即进入）
#    研究目录：未指定时自动使用默认目录 D:\research_workflow（Windows），
#    所有论文/数据/图表/代码包/PDF 只写入该目录；可用 --dir 指定其他位置
#    创建后自动以全自动模式启动，六阶段进度实时刷新

# ③ 每个决策点一键审批；质量达标后下载投稿包

方式二：命令行（Python 3.9+）

# ① 安装（或仓库内直接 python wf.py）
pip install arw-harness

# ② 指向云端核心（部署方提供域名；本仓库默认内置 Railway 域名）
$env:WORKFLOW_CORE_URL="https://<云端核心域名>"

# ③ 六阶段闭环。研究文件默认全部保存在本地 D:\research_workflow（Windows；
#    可用 $env:WORKFLOW_STUDIES_DIR 指定其他目录）——云端仅处理研究上下文，
#    产物（含论文 PDF）下载到本地后立即从云端删除
wf create "储能电站参与电能量与辅助服务联合市场的分层收益建模" --journal "Applied Energy"
wf run <research_id> --mode auto
wf status <research_id>
wf export <research_id>
wf quota

• 🎛️ 三种模式：分步 / 半自动（决策点人工审批）/ 全自动
• 🔁 随时控制：任何阶段可暂停 / 停止 / 从头开始（不消耗配额）
• 🔑 两种凭据：平台邀请码（内测期免费版月度 2 次研究配额，创建/暂停/重跑不计数）或自备 API Key（验证通过后不限次数）

🧠 核心技术亮点

| 能力 | 说明 | |---|---| | 🕸️ 多 agents 子代理并行 | 22 个科研角色，分章写作/多视角评审/多假设检验全部并行；每个环节有方向无关的撰写规则约束质量 | | 🔬 研究完全独立 | 每项研究的数据 schema、模型公式、图表计划由该研究的 LLM 独立设计——平台不套任何跨研究模板 | | 🛡️ 质量门体系 | G1-G13 脚本门（数字-数据一致性/公式完整性/LaTeX 编译零错误/证据链）+ 交付门禁（Major≤3 且 Minor≥2） | | ♻️ 自愈闭环 | 代码执行失败 → 错误反馈 LLM 重写；任何异常自动恢复 + 断点续跑，全自动模式永不静默终止 | | 📦 一键复现 | 每项研究产出工程化代码包（README + 复现入口 + requirements），研究专属 seed 全流程可复算 | | 💰 计费透明 | Token 用量与费用实时展示；定价自动探测（模型自报 + 官方定价页交叉） |

🧩 Skills 体系（云端技能库）

平台内置 219 个云端 Skills，覆盖科研流程全链路，默认全部启用；每个研究可独立勾选启用范围，亦可安装自定义 Skill（URL 或自然语言描述，AI 自动生成）。

| 类别 | 数量级 | 举例 | |---|---|---| | 📚 学术写作与润色 | 60+ | nature-writing、academic-paper、scientific-writing、writing-anti-ai | | 🔍 文献检索与综述 | 40+ | deep-literature-search、systematic-review-guide、literature-review、meta-analysis-guide | | 📊 统计与数据 | 30+ | statistical-analysis、bayesian-statistics-guide、pandas-data-wrangling、plotly-interactive-guide | | 🛠️ 工程与复现 | 30+ | test-driven-development、systematic-debugging、verification-before-completion、subagent-driven-development | | 📄 文档与图表 | 25+ | pdf、docx、xlsx、tikz-diagrams-guide、publication-figures-guide | | 🤖 评审与发布 | 20+ | nature-reviewer、peer-review-guide、rebuttal-writing-guide、response-to-reviewers | | 🔧 其他科研辅助 | 10+ | open-science-guide、zenodo-api、zotero-obsidian-bridge |

• ☁️ Skills 库部署在云端，所有用户共享，不占用本地空间
• ✅ 工作台「🧩 Skills 库」面板可搜索、可勾选（默认全启用）、按研究生效
• ➕ 自定义 Skill：输入名称 + URL 或自然语言描述 → 安装到本地独立 Skills 文件夹（云端已有同名自动提示）

🔒 安全与隐私

• 🏠 本地服务只监听 127.0.0.1；文件操作仅限您自选的研究目录（路径沙箱）
• 🔐 API 密钥 AES-GCM 加密，仅存环境变量，任何接口不回显
• 🧹 云端研究数据留存 90 天自动删除，不用于任何模型训练
• 🎫 邀请码鉴权（无有效凭据一律 401）；自备 Key 加密存储并贯穿调用链

🗺️ Roadmap

• [x] 六阶段自动化闭环 + 13 道质量门 + 评审-返工-复审循环
• [x] 完整工作流 Web 控制台（多模式/决策审批/实时活动流/文件树）
• [x] npx 一键分发（npm + GitHub 双通道）+ Railway 云端核心
• [ ] 真实数据源接入（PJM/EIA/CN 分时电价）
• [ ] 订阅计划（Free / Pro / Team）
• [ ] 团队协作与多研究并行面板

❓ FAQ

Q: 需要会编程吗？ A: 不需要。npx 一条命令，全程点按钮。 Q: 我的数据安全吗？ A: 研究文件只存您本机；云端仅处理研究上下文，90 天自动删除。 Q: 配额怎么算？ A: 内测期免费版月度 2 次研究配额（按自然月滚动，UTC 计算）；创建、暂停、重跑不计数；自备 API Key 不限次数。 Q: 能投顶刊吗？ A: 质量门与期刊分级（T1-T4）自动收紧评审标准；人审决策点始终兜底。

📄 License

外壳（本仓库）：MIT — cli.js / server.js / web/ / wf.py / arw_harness/ 云端核心：闭源，API 契约公开（docs/14_harness_api_contract.md）

让机器做苦活，让研究者做思考。 🧭

| | | | |:---:|:---:|:---:| | | | | | 系统全景 | ① 调研 Discovery | ② 立项 Design | | | | | | ③ 实施 Execution | ④ 写作 Writing | ⑤ 质量 Quality | | | | | | ⑥ 投稿准备 Submission | | |