starscape
星野(星空+地景)一键堆栈:基于 Siril 的 MCP 服务器、skill 和命令行,自动分离天空与地景 / One-shot nightscape stacking on top of Siril (MCP server + CLI)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/giaogiaogiaoluan--starscape)HTML
<a href="/listings/giaogiaogiaoluan--starscape"><img src="/api/listings/giaogiaogiaoluan--starscape/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/giaogiaogiaoluan/starscape.git cd starscape pip install . python install.py
`pip install .` 安装依赖(mcp、numpy、opencv-python、Pillow、tifffile、rawpy)和 `starscape` 命令。 `python install.py` 检查 Siril 是否找得到,把 skill 复制到 `~/.claude/skills` 和 `~/.codex/skills`, 并把 MCP 服务器注册到检测到的 Claude Code / Codex。只装其中一个用 `--client claude` 或 `--client codex`; 卸载用 `python install.py --uninstall`。
建议装在虚拟环境里(`python -m venv .venv && source .venv/bin/activate`),`install.py` 会把当前这个 Python 的完整路径写进 MCP 配置,所以之后不需要再激活环境。
Siril 不在默认位置时,设置环境变量 `SIRIL_BINARY` 指向 `siril-cli`。自检:
starscape selftest
其他 MCP 客户端
任何支持 stdio 的 MCP 客户端都可以用,配置如下(`command` 换成装了本包的 Python):
{
"mcpServers": {
"starscape": { "command": "/path/to/python", "args": ["-m", "starscape.server"] }
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 113 lines
- # Starscape
- 把固定三脚架连拍的星野照片(星空 + 地景)一键堆栈成低噪点成片。给 AI 助手用的 **MCP 服务器 + skill**
- (Claude Code、Codex 等),也可以当命令行工具单独用。
- 普通的星空叠加会按星点对齐所有照片,结果地景糊成一片,地平线附近出现拖影。Starscape **自动分离天空和地景**:
- - 天空:先把每一帧的地景遮掉,再对齐星点叠加 —— 地平线附近也是干净的星点。
- - 地景:不对齐直接叠加 —— 清晰、噪点低。
- - 蒙版自动生成(依据"星轨只出现在天空"),不用手画;不准时可以调参数或手工修正。
- - 没有暗场/平场/偏置也能出片:自动扣相机黑电平,并从亮场本身找热像素。
- - 调观感(亮度、饱和度、去光害强度…)几秒钟重新渲染一次,不用重新叠加。
- 标定、星点配准和叠加由你电脑上的 [Siril](https://siril.org) 完成,Starscape 负责 Siril 做不了的部分并把整条流程串起来。
- 
- ## 需要什么
- - **Siril 1.4 或更新**,装在本机。
- - **Python 3.10 或更新**。
- - macOS 或 Linux。Windows 有兼容代码但**没有测试过**。
- ## 安装
- ```bash
- git clone https://github.com/giaogiaogiaoluan/starscape.git
- cd starscape
- pip install .
- python install.py
- ```
- `pip install .` 安装依赖(mcp、numpy、opencv-python、Pillow、tifffile、rawpy)和 `starscape` 命令。
- `python install.py` 检查 Siril 是否找得到,把 skill 复制到 `~/.claude/skills` 和 `~/.codex/skills`,
- 并把 MCP 服务器注册到检测到的 Claude Code / Codex。只装其中一个用 `--client claude` 或 `--client codex`;
- 卸载用 `python install.py --uninstall`。
- 建议装在虚拟环境里(`python -m venv .venv && source .venv/bin/activate`),`install.py` 会把当前这个
- Python 的完整路径写进 MCP 配置,所以之后不需要再激活环境。
- Siril 不在默认位置时,设置环境变量 `SIRIL_BINARY` 指向 `siril-cli`。自检:
- ```bash
- starscape selftest
- ```
- ### 其他 MCP 客户端
- 任何支持 stdio 的 MCP 客户端都可以用,配置如下(`command` 换成装了本包的 Python):
- ```json
- {
- "mcpServers": {
- "starscape": { "command": "/path/to/python", "args": ["-m", "starscape.server"] }
- }
- }
- ```
- ## 使用
- **在 AI 助手里**,新开一个会话直接说:
- > 把 /路径/到/照片文件夹 里的星野照片堆栈成成片
- **命令行**:
- ```bash
- starscape scan "照片文件夹" # 只读盘点:有几组连拍、有没有标定场、要多少磁盘
- starscape run "照片文件夹" # 一步到成片
- starscape finish "项目目录" --set saturation=1.5 --set background=0.13 # 只重做后期
- starscape cleanup "项目目录" # 删中间文件,保留成果
- ```
- 成果在 `~/Documents/Starscape/<项目>/out/`(用环境变量 `STARSCAPE_HOME` 改位置):`final.jpg`、16 位的
- `final.tif`,以及可以在 Siril / PixInsight / Photoshop 里继续处理的线性母版 `composite_linear.fit`。
- 原始照片只被读取,不会被修改。
- ### 照片怎么放
- - 亮场(星空照片)直接放在文件夹里或 `lights/` 子文件夹。支持相机 RAW(CR2/CR3/NEF/ARW/DNG…)、FITS、TIFF。
- - 标定场可选,放进名为 `darks/`、`flats/`、`biases/`(或 `暗场/`、`平场/`、`偏置/`)的子文件夹才会被使用。
- 参数含义、"看到什么问题 → 怎么调"对照表和拍摄建议见 [starscape/GUIDE.md](starscape/GUIDE.md)。
- ## 已知限制
- - 只支持**固定三脚架**的地景分离。赤道仪跟踪拍摄会按纯星空处理。
- - 单帧本身的星点拖线叠加修不了,曝光时间请按 NPF 法则。
- - 超广角加长序列,四角星点可能变软(配准不含镜头畸变模型)。
- - 紧贴地景的一圈天空、桁架和树枝的缝隙里没有锐利星点。
- - 与天空一样亮的白色物体(白色建筑、雪)最难自动分离,可能需要手工圈选。
- - 中间文件很大:2000 万像素每帧约 0.5 GB,100 张约 50 GB,出片后可清理。
- 目前验证过的素材:合成序列(`starscape selftest`)、Canon R6 的 21 张 RAW 星野、ZWO ASI071MC 的深空 FITS
- (含偏置/暗场/平场)。**尚未验证**:一百张以上的真实长序列、相机 RAW 配平场、富士 X-Trans、Windows。
- 欢迎带着素材信息提 issue。
- ## MCP 工具一览
- | 工具 | 作用 |
- |---|---|
- | `starscape_info` / `starscape_scan` | 检查环境 / 只读盘点文件夹 |
- | `starscape_start` / `starscape_status` / `starscape_resume` / `starscape_cancel` | 后台运行管线并查看进度 |
- | `starscape_preview` | 返回蒙版、成片、天空/地景叠加、单帧的预览图 |
- | `starscape_finish` | 调参数重新出片 |
- | `starscape_mask` | 修正天空/地景蒙版并重新叠加 |
- | `starscape_frames` / `starscape_restack` | 逐帧质量表 / 剔帧后重新叠加 |
- | `starscape_siril` | 在项目里直接运行 Siril 命令 |
- | `starscape_projects` / `starscape_cleanup` | 列出项目 / 清理中间文件 |
- ## 许可
- MIT。Siril 是独立的 GPLv3 软件,本项目只通过命令行调用它,不包含也不分发它的代码。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.