科研自动评审套件 yuan-source-666/dsh-research-autoresearch

dsh-research-autoresearch

AutoResearch 科研插件全家桶（单 bundle 发布）：

| 插件 | 工具 | 功能 |
| arxiv-search | arxiv_search | 文献 Recall（arXiv 检索+去重） |
| lit-score | lit_score | LQS 五维评分分桶 |
| research-state | research_state | 研究状态/进度面板（7 操作） |
| stall-check | stall_check | 停滞检测（pivot/escalate/cap 红绿灯） |
| peer-review | peer_review | 五人格中位数评审 |
| research-ui | research_ui_switch | 🎛️ 可视化总控台（运行时开关） |

结构（仿 dsh-github-manager 工程形态）

src/bundle.ts 宿主半侧入口（6 字段扁平 config） src/client/locales.ts 卡片双语字典 src/client/card-model.ts React-free 控制器：staged drafts -> save -> settings scope src/client/ResearchUiCard.tsx 设置页卡片组件（jsx-runtime + 宿主设计令牌） src/client/index.ts 浏览器半侧入口（locale/slots/settingsScope） src/client/shims.d.ts 外部模块环境声明（零 @types 依赖） tsconfig.client.json strict 类型检查（npm run typecheck:client） build.mjs 宿主半：strip-types -> lib/.js scripts/build-client.mjs 浏览器半：tsc transpileModule -> __ModuleLoader__ 信封 tests/smoke-test.mjs 宿主半冒烟（lossless 门 + settings 同步 + 卡门控） tests/client-smoke.mjs 浏览器半回放（vm 沙箱跑完整 loader 契约）

构建：npm run build（两半都编译）；测试：npm test；类型：npm run typecheck:client。
lib/client.js 为生成物，勿手改。

可视化开关（三档）

1. 套件级：config.enabled=false → 整个 bundle 不注册（重启生效）
2. 部署级：Cards 声明式注入各工具进度卡片（默认 false=关闭）
3. 会话级：research_ui_switch {feature, action: on|off|reset} 即时开合；defaultCards 总闸播种

卡片关闭 = 展示器返回 undefined → DSH 通用回退，工具功能零影响。
运行时门控在 execute 时盖进 presentationMeta 持久化，会话日志回放永远一致。

设计灵感

本插件是 Deli Chen（陈德里） AutoResearch 框架协议的 DSH 工具化实现：

- 灵感论文 / 案例研究：Deli Chen, 从初稿到 Strong-Accept：一篇自我博弈综述如何被推到 8.6（"From Draft to Strong-Accept: How a Self-Play Survey Hit 8.6"）—— https://victorchen96.github.io/blog_self_play_story.html。
该论文 16 轮评审的实证直接塑造了本插件三条核心设计：
- peer_review 采用 MEDIAN 而非均值（防单人格抬分，对应其 V14→V16 中位数爬升）；
- 诚实降分信号（对应 V12：外部引用核查后框架主动把 8.5 降为 8.2，scoreDropped 字段即为此而设）；
- stall_check 的 "pivot structure, not tactics"（结构转向而非战术调参）与 15 轮 / 30 分钟双上限。
- 协议全文：AutoResearch Framework Protocol（SKILL.md） —— 五工具的状态文件、LQS 权重、五人格评审、行为约束（零交互 / ready-means-execute）逐条来自该协议。

v0.4.0 编排层补全（诊断驱动）

发布后取证（解压宿主全部 83 个会话日志）发现：六个工具被调用了 0 次——插件"装着但没生效"。根因：AutoResearch 框架的原生形态是 SKILL.md 协议（编排层）+ 工具（执行层） 两件套，本包此前只有后者；模型对被动工具描述的自发调用率≈0。修复：

1. 注册 autoresearch runtime skill（官方 ctx.skills 通道）：技能目录里带上中英触发描述，研究会话加载后即注入完整协议——任务目录约定、迭代循环、文献漏斗、五人格评审循环、stall 行动语义。skill 目录每会话只占 name+description 两个字段，正文按需加载（对 token 成本近乎零）。
2. 注册走 ctx.get('skills') 可选查找而非 inject：skills 子系统缺席的 profile 依旧完整启动六工具（断言已锁进 smoke，本项目的 brick 教训不允许第二次）。
3. 五路可视化卡片默认改为开启（原先全 false = 效果不可见是"没发挥作用"的放大器）；enabled:false、设置页总控台、research_ui_switch 三档退出路径不变。

v0.3.0 文献驱动升级（2026-07）用本插件自己的 Recall→Score 漏斗对 2024-09 ~ 2026-08 前沿文献（67 篇召回 / LQS 分桶）做了自省研究，两处实证缺陷已修复：

1. lit_score · 引用窗口校正：实测一批 22 篇 2026 前沿论文因 citation=0 全部被 dropped——新论文尚没时间积累引用，25% 引用权重系统性错杀最新文献。现在 /dsh-research-autoresearch

方式二（预构建 tarball，免构建授权）： bash
npm run build && npm pack
dsh plugin --profile web add ./dsh-research-autoresearch-0.3.1.tgz

安装后在 profile 的 cordis.patch.yml 加 - id: dsh-research-autoresearch + disabled: true 可整体停用；Web 设置页「插件配置」的 科研可视化总控台 卡片可运行时切换五路可视化（zh/en 双语界面）。