6.7 从源码运行与调试
日常使用优先看安装指南。本页面向修改源码的人：应用在 Node.js 中运行，PostgreSQL 由标准 Docker 提供。
环境与启动
需要已取得源码、Node ^22.19.0 || >=24.0.0、pnpm 11.7.0 和可连接的本机 Docker。
sh
pnpm install
pnpm setup:database
pnpm setup:dsh
pnpm dev:dsh启动器会先构建，并输出当前认证地址。使用完整地址进入。不要把令牌提交到仓库或错误报告。
修改后的验证
sh
pnpm check:dsh
pnpm test:contract
pnpm test:bindings按修改范围补跑后端、Harness 或浏览器测试。插件配置与界面构建通常需要重新构建并重启宿主，不能依赖浏览器刷新自动加载新代码。
隔离运行
使用仓库提供的 pnpm dev:dsh:acceptance 验收启动器，按其提示创建独立 profile、端口、工作目录和数据库范围。不要只改一个端口就复用正式工作数据。
默认 3100 是日常宿主。结束验收时只操作自己启动的进程，不按模糊关键词批量终止。
排查日志
先看启动命令的错误，再看 .runtime/teloa/harness.log 和相应执行记录。分享前删除令牌、Cookie、密钥、数据库连接和私人内容。构建输出、模型错误和业务状态错误应分别记录。