chore: initial commit (sources + docs, ignore build artifacts and secrets)

2026-09-16 12:24:49 +08:00
commit 8a6c55d94a
124 changed files with 12168 additions and 0 deletions
@@ -0,0 +1,19 @@
+# Controller 配置与迁移
+
+## 可迁移配置
+
+发行目录下的 `config/controller-config.json` 是可复制到另一台电脑的非敏感配置。当前支持：
+
+```json
+{
+  "config_version": 1,
+  "agent_host": "0.0.0.0",
+  "agent_port": 8443
+}
+```
+
+Wails 总控从发行目录和开发目录中的 `config/controller-config.json` 加载该文件。可用 `MULTICLAW_CONTROLLER_CONFIG_PATH` 指向一份隔离配置。未来设置页保存后必须原子写回同一文件。
+
+## 不可迁移的安全状态
+
+当前 Windows 用户配置目录中的 `MultiClawControllerWails` 保存 TLS 证书、私钥、SQLite 数据库和已配对 Agent 凭据，不能与程序目录一起复制。可用 `MULTICLAW_CONTROLLER_DATA_DIR` 创建测试或隔离数据目录。将总控迁到另一台电脑后，它会建立新的控制端身份，所有 Agent 需使用新的一次性配对码重新配对。