49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# TaskPilot Windows 本地版
|
|
|
|
## 启动
|
|
|
|
```powershell
|
|
.\start.ps1
|
|
```
|
|
|
|
然后访问 <http://127.0.0.1:3000>。
|
|
|
|
需要自动打开浏览器时：
|
|
|
|
```powershell
|
|
.\start.ps1 -OpenBrowser
|
|
```
|
|
|
|
## 数据目录
|
|
|
|
- SQLite 数据库：`data/task_pilot.db`
|
|
- 运行日志：`logs/{task_id}/{run_id}.log`
|
|
|
|
## 配置
|
|
|
|
```powershell
|
|
$env:TASK_PILOT_PORT = "3000"
|
|
$env:TASK_PILOT_DATABASE_URL = "sqlite://data/task_pilot.db"
|
|
$env:TASK_PILOT_LOG_DIR = "logs"
|
|
$env:TASK_PILOT_LOG_RETENTION_DAYS = "30"
|
|
$env:TASK_PILOT_LOG_MAX_TOTAL_MB = "512"
|
|
$env:TASK_PILOT_LOG_ENCODING = "auto"
|
|
$env:TASK_PILOT_STATIC_DIR = "web"
|
|
```
|
|
|
|
`TASK_PILOT_LOG_ENCODING` 默认 `auto`，会按 UTF-8 → 系统 ANSI 代码页（简体中文为 GBK）的顺序解码子进程输出；日志出现乱码时可显式指定 `gbk` 或 `utf-8`。
|
|
|
|
## 安全边界
|
|
|
|
- 服务只监听 `127.0.0.1`。
|
|
- 浏览器跨站 Origin 会被拒绝。
|
|
- 写操作需要运行期随机管理令牌。
|
|
- 管理令牌在进程重启后自动更换。
|
|
|
|
## 故障排查
|
|
|
|
- 3000 端口被占用时，通过 `TASK_PILOT_PORT` 修改端口；打包版前端使用同源 API，无需重新构建。
|
|
- 页面无法打开时，确认 `web/index.html` 存在。
|
|
- 任务未执行时，确认任务已启用、Action 配置有效，并在日志抽屉查看错误。
|
|
- 进程无法启动时，检查解释器或可执行文件路径、工作目录和执行权限。
|