Table of Contents

39 Supervisor 托管本地服务

背景与目标
最终方案
修改文件
验收结果
测试
相关提交
人工验收

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

39 Supervisor 托管本地服务

类型：本地运行 / Supervisor 配置
所属 Epic：#3
所属 MVP / 版本：#35 / MVP-2 开发基础设施
状态：已完成
日期：2026-08-24
Gitea 工单：#39
Wiki 页面：Task-39-Supervisor-托管本地服务

背景与目标

本机安装 Go 版 Supervisor 后，需要用项目统一配置常驻运行 Portal、Admin API 与 Admin UI，并继续隔离 Portal 环境文件和 Admin settings 中的敏感值。

最终方案

增加 scripts/install-supervisor.bat 和 scripts/chorus-supervisor.ps1。安装器验证统一配置、构建稳定二进制、生成三个独立 program 配置并接入 programs/*.conf；运行器以前台模式启动组件。Supervisor INI 路径统一使用正斜杠，Admin UI 通过安装目录内的 Corepack/pnpm 代理启动，避免依赖 Supervisor 启动时继承的用户 PATH。

实施中 Gitea Wiki PATCH 的空标题在当前服务端导致三个核心页面被重命名失联；在同步本地镜像前发现，已从原只读镜像恢复完整正文、使用原页面名重新创建、追加本任务内容并在线回读 revision。未用错误远端内容覆盖本地镜像。

修改文件

scripts/install-supervisor.bat：提供重复安装与更新入口。
scripts/chorus-supervisor.ps1：构建产物、生成外部 program 配置并运行三个前台组件。
docs/00-project-profile.md：同步 Supervisor 运行结论。
docs/04-local-development-and-verification.md：同步安装、状态、日志和实例说明。
docs/10-deployment-and-operations.md：同步本地运维与回退方式。

验收结果

验收标准	结果
三个实例独立显示并保持 Running	通过
Portal 使用统一配置当前地址	通过，`127.0.0.1:8085`
Admin API 使用 settings 当前地址	通过，`127.0.0.1:8090`
Admin UI 使用统一配置并连接正确 API	通过，`127.0.0.1:9528`，API 基址为 `8090`
三个 HTTP 地址与日志检查	通过，均为 HTTP 200，日志未发现敏感字段名
stop/start 释放端口且无残留	通过，三个实例逐项验证
测试与 Wiki 文档闭环	通过

测试

go test ./...：通过。
go -C admin test ./...：通过。
go vet ./...：通过。
python -m unittest discover -s tests -v：42 项通过。
python dev_scripts/harness.py check --strict：通过。
python dev_scripts/harness.py sync --check：通过。
PowerShell AST、安装器重复执行、Supervisor reload/status、三实例 stop/start、HTTP 与 Admin UI API 基址：通过。
未验证部分：Windows 开机自启和生产静态部署；本任务未执行 migration、seed、账号变更或真实 Provider 请求。

人工验收

验收人：用户
验收时间：2026-08-24
结果：#39 验收通过。