前言¶
在 DSH（DeepSeek Harness）生态中，将研究资料、文献管理、写作工具与 AI 智能体打通，往往需要分别维护多个本地服务或工具链。对于天文研究场景，这更涉及专业数据格式（FITS/XML）、大量工具与资源列表、以及一套标准化的研究路径与检查清单。重复配置、数据分散、跨工具切换频繁，会消耗大量时间。
wing-tn/astro-ph-researcher 3.4.0 把这些能力收敛到一个本地工作台里：在 Codex 窗口中打开文献、写作、新手路径、研究计划和研究资料，同时保留原插件的 DSH 宿主/客户端、9 个 skills、离线数据与 CLI。数据保存在用户本机；Codex 窗口不要求 DSH，不自动调用模型或上传个人笔记。
插件简介¶
- 名称：wing-tn/astro-ph-researcher
- 维护者：天外奇航（@hyperskysail）
- 版本：3.4.0
- 许可：MIT License
- 分类：本地双语天文研究工作台（DSH + Codex）
它面向天文研究场景，提供文献检索与核验、写作编辑与启发式检查、新手研究路径、研究计划与循环依赖检查、研究资源（方法/统计/设施/工具/源表/书目）以及多领域盲点问题检查等能力，并通过 Codex 顶栏按钮与独立 UI 两种方式使用。
核心功能¶
插件在本地窗口中提供以下模块能力：
- 文献（Literature）
- Crossref/arXiv 检索与筛选
- DOI/arXiv 核验
- 来源快照与去重
- 阅读清单
-
BibTeX/Markdown/JSON 导出
-
写作（Writing）
- 期刊/学位项目模板
- 10 种写作目标
- 真实材料与文本导入
- 10 章节编辑器
- 启发式检查
- 作者确认
-
Markdown 与 Codex 交接
-
新手（Learning）
- 九步研究路径
- 检查项、交付物、笔记与进度
-
英文配套路径
-
计划（Planning）
- 节点、上级依赖、状态、来源与交付标准
-
循环依赖检查
-
资料（Resources）
- 34 种方法、9 种统计、30 个设施
-
分析工具、公开源表、8 条推荐书目
-
研究检查（Research checks）
-
9 个领域的盲点问题及笔记
-
汇报（Briefing）
- 从阅读清单和计划生成 Markdown 大纲
-
演示文稿交接提示词
-
设置（Settings）
- 中英文界面切换
- 完整工作区备份
数据存储在本地：阅读清单为 codex/ui/local-data/library.json，其余工作区为同目录 workbench.json；与原 DSH 库独立。升级前可在设置页下载备份。
安装与启用¶
1. 准备环境¶
- 需要安装 Node.js 22 或更高版本
- 安装 DSH（DeepSeek Harness）客户端
2. 下载插件¶
在 v3.4.0 下载页 选择：
*-dsh.zip：完整 DSH bundle，同时保留 Codex 目录*-codex-zh.zip/*-codex-en.zip：独立 Codex 插件（中/英文默认入口）*-source.zip：完整源码（与 DSH 包内容相同，另有独立说明和 SHA256 校验文件）
3. 安装 DSH 插件¶
解压 DSH bundle 后，在包含 package.json 的目录运行：
dsh plugin --profile desktop add .
完全退出并重启 DSH。使用 web profile 的用户将 desktop 替换为 web。
4. 启动本地工作台¶
在源码目录运行：
npm run ui
终端会打印本地 URL。Windows 可双击 codex/start-ui.cmd；英文入口为 codex/start-ui-en.cmd。
5. 在 Codex 主界面提供可点击入口¶
本版本采用官方支持的项目顶栏操作按钮。在目标 Codex 项目目录运行：
node codex/scripts/install-action.mjs --project "你的 Codex 项目目录" --lang zh
English: 使用 --lang en 安装 Open Astro Workbench 操作按钮。Windows 用户可运行 codex/install-button-en.cmd 或 codex/install-button-zh.cmd。安装后在 Codex 桌面应用中重新打开目标项目即可使用。
6. Codex 插件安装（可选）¶
Codex 插件清单位于 codex/.codex-plugin/plugin.json。在完整源码目录可按本机 CLI 支持的命令配置本地 marketplace：
codex plugin marketplace add .
codex plugin add astro-ph-researcher@astro-ph-researcher-local
安装/更新缓存的行为依赖本机 CLI；先备份个人数据并查阅 codex plugin --help。本次发布不自动替换用户已安装缓存。
典型用法¶
快速启动工作台¶
npm run ui
打开终端返回的本地 URL，即可在浏览器中访问双语工作台。
启动 Codex 顶栏按钮¶
node codex/scripts/install-action.mjs --project "你的 Codex 项目目录" --lang zh
在 Codex 桌面应用中重新打开该项目，点击顶栏按钮即可启动工作台。
离线 CLI（原 DSH 功能）¶
node codex/scripts/astro-cli.mjs stats
node codex/scripts/astro-cli.mjs beginner
node codex/scripts/astro-cli.mjs goal refutation
9 个原 skills 的内容保持一致，离线 CLI 仍可单独运行。
升级前备份¶
升级前在设置页下载完整工作区备份。
适用场景与注意¶
- 适合在天文及相关物理领域进行文献检索、写作与计划管理的 DSH / Codex 用户。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 题录存在不证明科学论断、同行评议或未撤稿；启发式评分不验证科学正确性；作者本人须核对并确认各节。
- 汇报导出为 Markdown，不是 PPTX；投稿前应核对当年官方指南。
生态背景¶
DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。本插件由社区维护，代码与文档等采用 AIGC 辅助，科学内容仍需人工核验。作者以非盈利方式维护，现有功能免费；这一立场不缩减 MIT 许可权利。第三方资料与商标归各自权利人，致谢不表示官方背书。
短结尾¶
astro-ph-researcher 3.4.0 把文献、写作、新手路径、研究计划和研究资料放在本地窗口中，同时保留原 DSH 插件的 skills 与离线能力，适合需要专业研究工具链的 DSH / Codex 用户。
- 目录页：https://www.skillhub.cn/plugins/wing-tn/astro-ph-researcher
- GitHub：https://github.com/wing-tn/astro-ph-researcher
