前言¶
在 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
