开机自启管家 NamesMT/dsh-home-hosted

📌 dsh-home-hosted

用提示词把服务器「变」出来——让它们常驻运行，并通过 dsh / home-hosted 面板 UI 管理。

整套家庭服务栈，每次重启后自动拉起——包括你的 dsh Web。

这是 DeepSeek Harness 插件，对接 home-hosted——那个帮你监管各项服务的面板。
想要 Gitea、Jellyfin、FTP 服务器？说一声就行，dsh-home-hosted 会建好条目并接管管理——面板、端口、重启、开机自启全都包了。
你没点头之前，什么都不会安装、不会启动。

🚀 快速开始 · 🎛️ 插件能做什么 · 🤖 智能体工具 · 🧩 深入一层

插件页面：Detailed 与 Compact 两种样式，位于 Settings → Home Hosted

先是 Detailed 样式，然后是 Compact 下的同样几个区块——都能从页面顶部切换。

🚀 快速开始

dsh plugin --profile web add dsh-home-hosted

打开 Settings → Home Hosted，添加你的服务器——或者直接跟智能体说：

add a Gitea on 3000, and a Jellyfin on 8096

然后，可选地打开 Manage dsh 和 Autostart，这样重启之后面板——以及面板里的一切——都会回来。

🤔 为什么

有没有试过自己搭媒体服务器、Gitea 再加几个别的——然后还得把它们全管起来？

dsh-home-hosted 用 home-hosted 来做这件事：说出你想要的服务器，让它写好并配好条目，然后从 dsh 或面板统一管理——端口、健康状态、重启、自启全都包含在内。

you ──▶ "add a Gitea, a Jellyfin, a cache…"
│
▼
dsh-home-hosted ──▶ home-hosted panel ──▶ ┌──────────────┐
page · agent │ │ gitea :3000 │ │ └──────────────┘ ├──────────▶ ┌──────────────┐ │ │ jellyfin │ │ │ :8096 │ │ └──────────────┘ └──────────▶ ┌──────────────┐ │ postgres │ │ :5432 │ └──────────────┘

★ OS 启动项 ──▶ 面板回来了，里面的东西也都回来了 systemd · launchd · XDG · Run key

dsh 只是面板里的一个条目，不是整个产品。 面板才是总管：它启动每个条目，盯着它们，把挂掉的重新拉起，并收回端口。把你的 Gitea、Jellyfin、compose 栈、数据库都加进来——在页面上管理，或者把条目 id 交给智能体。

管理 dsh 本身算是附赠：让 harness 保持运行的条目，是服务器管理之上的一个亮点，而不是这个插件的主业。

🎛️ 插件做什么

| 🖥️ 服务器，用提示词就能配好 | 添加、编辑、启动、停止、重启条目——Gitea、Jellyfin、FTP、compose 栈。全部通过面板 API 写入，不会在你背后偷偷重启。 |
| 🏠 整套自托管面板 | 不只是服务器：BYOU 自定义 UI、workspaces、带自动 HTTPS 的反向代理、备份（zip 或 AES-256）、通知、动态 DNS、健康探测、实时日志和主机状态。 |
| 🤖 智能体工具 | 默认开启，每次写入仍受会话权限把关。 |
| 🚀 开机自启 | 亮点： 安装、校验并移除 OS 启动项，让面板开机就启动。按机器选择是否启用。 |
| 🧭 有意义的 token 警告 | API token 缺失或被拒绝时，页面上会直接指出，一键就能生成可用的 token。 |
| 🪟 认得其他面板 | 一台机器上有好几个面板？会告诉智能体这个插件管的是哪一个，动别的之前先问。 |

🤖 智能体工具

| 工具 | 作用 |
| home_hosted_status | 面板、启动项和受管条目的状态 |
| home_hosted_workspaces_list | 面板服务的每个 workspace，带计数 |
| home_hosted_servers_list | 某个 workspace 里每个受管服务器 |
| home_hosted_servers_lifecycle | start · stop · restart |
| home_hosted_servers_edit | create · update · delete |
| home_hosted_autostart_manage | install · uninstall |
| home_hosted_ui_manage | status · update · revert · switch（官方资源或本地 zip） |
| home_hosted_panel_logs | 面板自己的控制台输出。不需要 API token，所以面板还活着但不响应时也能用。 |

每个服务器工具都要写明它的 workspace，因为 id 只在一个 workspace 内唯一。

会改动东西的工具只有在会话不是 Full access 时才请求批准。
被拒绝的 token 会当场重新注册，工具随即重试——见下文 automatic regeneration。
每个工具都接受可选的 instance（面板的 --home 或 URL）。省略它，就作用于本插件管理的面板；如果发现多个面板，调用会先问你要哪一个；指定另一个面板时也会先询问——然后通过编辑它的配置文件、对它运行命令行，或签发 token 并调用它的 API 来访问它。

🧩 深入

开机自启动，按平台

| 平台 | 机制 | 启动时机 |
| Linux | systemd-user、systemd-system、XDG autostart | 登录时，或用 system 单元 / loginctl enable-linger 开机启动 |
| macOS | launchd-agent、launchd-daemon | 登录时，或用 daemon 开机启动（需一次性 sudo） |
| Windows | Run 键、任务计划程序 | 登录时 |

进程无法提权时，页面会直接打印出确切的命令——包括让 Mac 在登录之前启动的 launchd-daemon。

开机启动项以安装者的身份运行面板：账号来自提权的登录用户（SUDO_UID），或面板根目录的所有者，而不是 $USER。
没有账号可指定的启动项会以 root 身份运行面板——这是默认行为，页面会明说，而不是藏着。systemd 无法解析的 User= 也会被拒绝，因为它会让单元启动失败。之后要把安装从 root 迁到某个用户，需要 chown -R <user> <home>。

home 托管的运行用哪一个

默认用锁定的依赖；页面可以切换到全局安装，或替你全局安装锁定的版本范围。开机启动项运行插件写入的小型稳定启动器，所以 node_modules 路径变动永远不会弄坏开机启动。

来自本地克隆的 dsh

你自己克隆并构建的 dsh 也支持：托管的启动项会启动稳定启动器，开机时重新找到你的构建，所以重新构建、移动检出目录或新建配置档都不会让它失联。
找不到时回退到 PATH 上的 dsh，两者都找不到就报错并说明原因。

dsh Desktop

支持 Desktop 客户端，只有一个例外。服务端的一切都和浏览器里一样：页面、智能体工具、工作区、面板、开机自启动。

Manage dsh 仅限网页端，在 Desktop 里显示为禁用，因为 Desktop 在 Electron 中启动自己保留的配置档——它从来不是面板的服务端条目之一。（命令行会拒绝 dsh --profile desktop，所以为它加一行只会崩溃重启。）其他所有类型的服务端条目都不受影响。

延伸阅读

专题文档，每个领域一篇——写给下一个必须接手它的人：

开机自启动 · 面板 · 服务端条目 ·工作区与多个面板 · 智能体工具

受管入口与端口策略

一个入口（dsh），一个开关：面板让它保持存活，重启它并回收它的端口。在 macOS 和 Linux 上，分离式重启会被识别（follow）；Windows 无法通过 .cmd 垫片证明身份，所以用 onPortConflict: kill。插件锁定 home-hosted 0.8+，因此它写入的每个 key 都是面板能解析的。
仅 Web —— 见上文 dsh Desktop。

API token 与自动重新生成

插件需要自己的 home-hosted API token 才能读写面板。home-hosted 只保留 token 的哈希，所以不是它签发的 token 永远无法找回 —— <stateDir>/panel-token 权限为 0600，从不渲染也不记录日志，而 Regenerate token 会登记一个新 token 替换它。

token 缺失或被拒绝时，页面上会用那个按钮标出来，面板完全无响应时也一样 —— token 问题往往正是它无法访问的原因。
Regenerate token automatically（Agent tools 区域，默认开启）在面板调用被拒绝时做同样的事：工具会重新登记并重试一次，而不是直接失败。关掉它，就会改为询问你，而不是悄悄替换掉一个还能用的 token。

运维配置

Cordis 行配置只用于运维覆盖：

- id: dsh-home-hosted
name: 'dsh-home-hosted'
config:
stateDir: /custom/state/dir # default: $DSH_HOME/dsh-home-hosted
homeHostedCommand: /usr/bin/home-hosted
defaultEntryId: dsh

用户能切换的一切都在 <stateDir>/settings.json 里。

每次安装都驱动自己的面板根目录 —— <stateDir>/panel，或者设置了 $HHOSTED_HOME 时用该值 —— 并给自己的启动入口命名，所以两个 dsh 安装不再共用一个面板。已有的 ~/.home-hosted 面板会原样沿用，页面会显示本次安装拥有哪个根目录。

开发

pnpm install
pnpm typecheck && pnpm test && pnpm build

Node 24+，pnpm。与 CI 运行的是同一组命令。

MIT · npm · releases · issues · built on home-hosted