离线与内网安装

内网、隔离网、涉密环境里，客户端连不上外网，扩展市场自然也拉不到列表。 星汉的插件和模板都是独立的安装包文件，拷贝进去就能装 —— 两条路，按规模选。

方案一：拷贝安装包，本地安装

适合装几个插件、几套模板的情况，不需要任何服务端配置。

1. 在有外网的机器上下载

   打开扩展市场，点你要的插件 / 模板的下载按钮，拿到：

   • 插件 → <插件id>.tgz，例如 xinghan.terminal.tgz
   • 模板 → <模板id>.xht.zip，例如 crm.xht.zip

2. 拷进内网

   U 盘、内部文件服务器、跳板机都行，就是一个普通文件。

3. 在客户端里本地安装

   • 插件：右上角插件市场 → 右上角 「从本地安装」 → 选中 .tgz
   • 模板：文件树的模板库 → 右上角 「从本地安装」 → 选中 .xht.zip

4. 装完即用

   插件会解包到 ~/xinghan/plugins/<插件id>/（Windows 是 %USERPROFILE%\xinghan\plugins\） 然后热加载，不用重启应用。模板则按原样导入到当前项目，表 / 视图 / 字段一并生成。

校验完整性

每个扩展的详情页都标了 SHA-256。文件经过多次转手，想确认没被改动，可以在内网机器上比对一下：

# macOS / Linux
shasum -a 256 xinghan.terminal.tgz
# Windows PowerShell
Get-FileHash xinghan.terminal.tgz -Algorithm SHA256

「从本地安装」这条路不会自动校验哈希（它没有 catalog 可比对），所以来源不明的包请务必手动核对。

注意插件的平台

纯前端插件（列表里标全平台）一个包通吃。带原生模块的插件（比如终端依赖 node-pty） 只覆盖标注的平台，当前是 macOS 与 Windows，没有 Linux 包 —— 国产化平台上装不了， 别白拷。

方案二：内网自建一份扩展市场

要给整个内网几十上百台机器统一供货，逐个拷文件就不合适了。客户端的市场地址是可以改的， 在内网起一份服务，客户端指过去，就能用上完整的市场界面 —— 列表、安装、升级、卸载都在。

1. 在内网部署后台服务

   星汉的服务端带扩展市场接口，用一个本地目录当仓库：

   marketplace/
   ├── catalog.json                    插件目录
   ├── packages/<id>-<version>.tgz     插件包
   └── templates/
       ├── catalog.json                模板目录
       └── packages/<id>.xht.zip       模板包

   把从官网下载的包放进对应的 packages/，在 catalog.json 里登记（id / name / version / size / sha256 / file 几个字段），服务就能对外供货了。

2. 客户端改服务器地址

   客户端设置里把服务器地址指向内网这台服务。插件市场和模板库跟着同一个地址走， 改一次两边都生效。

3. 照常用市场

   这之后内网用户看到的就是完整的扩展市场：装、升级、卸载，跟联网时一模一样。

注意

上架自己开发的插件也走同一套：用仓库里的 apps/desktop/scripts/plugin-pack.mjs 把插件打成 .tgz 并写进 catalog.json，模板则用 template-pack.mjs。

客户端本身的离线安装

客户端安装包（.exe / .dmg / .deb）在首页下载。它是完整的桌面应用， 装完不联网也能建表、编辑、跑自动化 —— 数据全在本机 ~/xinghan/ 下。 需要联网的只有云端项目、AI 相关功能，以及这里说的扩展市场在线拉取。