# Astro 天文研究工作台 3.4.0

这是在原插件基础上补齐的 Codex 本地可视化工作台。需要 **Node.js 22+**，无需安装 npm 依赖，不要求 DSH 运行时，不依赖付费模型 API。

## 启动与主界面按钮

Windows 双击 `start-ui.cmd` 可在终端运行；双击 `start-ui-en.cmd` 可直接打开英文界面。也可运行 `node scripts/open-ui.mjs --lang zh`，自动复用/启动后台服务并打开网页。使用 Codex 浏览器面板时，打开启动器打印的真实地址。

给每位用户提供的原生快捷入口是 **Codex 主界面顶栏的项目操作按钮**，不是置顶聊天，也不声称是全局侧栏按钮。

1. 将插件解压到稳定位置，不要随后删除或移动该目录。
2. Windows 双击 `install-button-zh.cmd`，输入平时在 Codex 打开的项目目录。跨平台也可运行：

```sh
node scripts/install-action.mjs --project "你的项目目录" --lang zh
```

3. 在 Codex 中重新打开该项目，使用顶栏的 **打开 Astro 工作台** 操作。

安装器只在该项目 `.codex/environments/environment.toml` 中追加按钮，保留已有配置并先备份；重复安装不重复添加。它不会改全局 Codex 配置，不会跳过信任确认。若已有 Astro 按钮、但插件目录移动了，请更新按钮的命令路径。机器专属绝对路径不宜原样提交给其他用户。

源码包和独立包都附带可共享的相对路径配置；把解压目录直接作为 Codex 项目打开，也可使用其顶栏操作。按钮的配置和启动器已测试；宿主是否发现并显示该配置，取决于 Codex 桌面版。只安装 skill/插件，不能保证自动创建全局按钮。依据：[官方本地环境/操作说明](https://learn.chatgpt.com/docs/environments/local-environment)。

## 网页已接入的功能

- 文献检索与阅读清单：Crossref/arXiv、筛选、题录核验、去重、来源快照、笔记与三种导出。
- 写作工作台：期刊/学位项目、10 种写作目标、期刊/学校资料、作者材料与文本导入、10 个章节编辑器、启发式检查、作者确认、Markdown 导出和写作交接。
- 新手路径：原插件的九步研究流程；笔记、检查项与进度本地保存。
- 研究计划：任务、上级依赖、状态、来源和交付物；阻止循环依赖。
- 方法与设备库：34 方法、9 统计、30 设施、工具、公开源表和 8 条推荐书目。
- 跨学科检查：9 个方向的提问与本地检查笔记。
- 汇报大纲：将阅读清单与计划整理为 Markdown，供演示文稿工具接续制作。
- 设置：中英文界面切换、完整工作区备份。

## 语言、模型与科研边界

顶栏和设置页均可切换中英文，浏览器会记住选择。切换不会改写论文正文、个人笔记和科学元数据。英文版提供新手路径及研究检查的英文配套内容；方法、设备等详细原始资料保留原语言，并明确标注。

网页不会自行调用模型写论文，而是根据真实项目材料生成可复制到 Codex 的交接提示词。汇报导出是 **Markdown，不是 PPTX**。启发式评分不验证科学正确性；四项作者确认必须由本人完成，正文修改后旧确认和评分自动失效。题录核验不等于同行评议、结论或撤稿状态核验；投稿前须检查当年官方格式指南。

## 数据和升级

本地数据为 `ui/local-data/library.json` 与 `ui/local-data/workbench.json`，与原 DSH 库独立。设置 `ASTRO_UI_LIBRARY` 时，工作台文件放在该文件的同目录。每个数据库目录只运行一个写入进程。

升级前在设置页备份。恢复时先停服务并备份旧文件，再将完整备份中的 `library` 与 `workspace` 对象分别写回上述两个文件。发布包不含运行时个人数据。原有 9 个 skills、离线 CLI 和 DSH 功能仍保留。

英文说明见 [README.en.md](README.en.md)，发布与验收说明见 [VALIDATION.md](VALIDATION.md)。

## 声明与反馈

设置页“关于与声明”可查看版权、AIGC、免责、非盈利立场及致谢，并下载完整声明。软件仍采用原 MIT 许可，非盈利维护不等于新增禁止商业使用限制。详见 [DISCLAIMER.md](DISCLAIMER.md)。

**用户反馈 QQ 交流群：1126615665** · 邮箱：1253932197@qq.com。