sundynix-agentix

Author SHA1 Message Date

Author	SHA1	Message	Date
Blizzard	c1420b5665	fix(rag): 全文索引在容器里根本没持久化 —— 补 /data 卷 + BLEVE_PATH 排查「fulltext 路 0 命中」时发现的真问题，比原以为的分词器问题严重得多。现状：mcp-go 容器没有任何 volume，也没设 BLEVE_PATH，于是索引落到相对 CWD 的 .data/bleve。而运行阶段没有 WORKDIR（CWD=/）、进程又是非 root(uid 10001)，两种结局都糟： - 在 / 下建不了目录 → openBleve 静默退回内存索引，重启即清零； - 就算建得了，也只是写进容器可写层，每次发版重建容器一样清零。更糟的是它不报错：混合检索少一路只表现为召回变差，看不出故障。改动： - Dockerfile：建 /data 并 chown 给 app，WORKDIR 设为 /data； - 两份 compose：BLEVE_PATH=/data/bleve + 挂持久卷（132 那份此前连顶层 volumes 段都没有）； - .env.example：写清默认相对路径相对的是启动目录——本地从仓库根起和从 sundynix-mcp-go/ 起会写出两份互不相干的索引，排查时极易被坑。附带澄清：中文分词本身没问题。直接开落盘索引验证过，mapping 里 text 字段确实是 cjk，实测「星间链」命中 4 条、「海关监管」命中 104 条，BM25 打分正常。 `a4852c3` 那次修复是有效的，之前怀疑分词器的判断作废。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-20 13:40:31 +08:00
Blizzard	6b45adbbd2	chore(deploy): 三机部署 compose 拆分 + NATS 3 节点集群 126=MinIO(已部署)、128=基础设施、132=应用。 - deploy/128-infra:NATS 3 节点集群(独立卷+cluster routes,暴露4222/4223/4224)+PG/Redis/ Milvus(自带etcd+自带内部minio,不复用126)/Neo4j/Jaeger;端口对局域网暴露、卷持久化。 - deploy/nats-cluster/nats{1,2,3}.conf:max_payload 一致 + jetstream + cluster。 - deploy/132-app:仅 gateway(3000:8080)+dispatcher+mcp-go+mcp-py,无 admin nginx;env 指向 126/128;mcp-go 补齐 MINIO env(本会话 blob 遗漏);NATS_STREAM_REPLICAS=3;.env.example 模板。 - docker-compose.prod.yml(单机):删 admin 服务(已内嵌)、mcp-go 补 MINIO env。 - 三个 compose 均 docker compose config 校验通过;.env 已 gitignore、.env.example 可提交。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-18 14:45:24 +08:00
Blizzard	a5fd251fc0	feat(deploy): 容器化 + 一键独立部署 —— 5 服务镜像 + prod compose + 安装/备份/许可此前应用服务只是本机裸二进制、无 Dockerfile、无法交付。本提交把项目从"只能在我笔记本跑"变成"任何人一条命令起一整套"，是「演示 / 拉投资 / 卖给客户独立部署」的可交付基础。 - Dockerfile ×5：gateway/dispatcher/mcp-go 多阶段(distroless static, 36–55MB)； mcp-py(python-slim, 268MB)；admin(node 构建→nginx 托管 SPA + 反代 /api，76MB)。 Go 构建上下文为仓库根以兜住 replace ../sundynix-shared；.dockerignore 瘦上下文。 - docker-compose.prod.yml：应用 + 基建一把起；经服务名互连（顺带避开 localhost DNS 坑）；基建端口不对宿主暴露；depends_on 健康检查保序（mcp-go 待 Milvus healthy）； APP_ENV=production 强制密钥校验 + 锁 CORS + 管理员白名单。 - .env.example + DEPLOY.md：两类密钥分层（引导密钥走 .env，模型 key 控制台加密存库）；首次管理员流程；安全建议。LICENSE 专有（授权模型可后定）。 - scripts/backup.sh + restore.sh：PG 逻辑备份 + 各数据卷快照 / 恢复。 - .gitignore 挡 .env*（密钥不入库）。 live：5 镜像全构建通过；独立 project 起整套 → nginx→gateway→NATS→dispatcher→mcp 全链路注册+提任务 running→done，depends_on 保序生效。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-26 15:23:36 +08:00

Blizzard

c1420b5665

fix(rag): 全文索引在容器里根本没持久化 —— 补 /data 卷 + BLEVE_PATH

排查「fulltext 路 0 命中」时发现的真问题，比原以为的分词器问题严重得多。

现状：mcp-go 容器**没有任何 volume**，也没设 BLEVE_PATH，于是索引落到相对
CWD 的 .data/bleve。而运行阶段没有 WORKDIR（CWD=/）、进程又是非 root(uid 10001)，
两种结局都糟：
  - 在 / 下建不了目录 → openBleve 静默退回内存索引，重启即清零；
  - 就算建得了，也只是写进容器可写层，每次发版重建容器一样清零。
更糟的是它不报错：混合检索少一路只表现为召回变差，看不出故障。

改动：
  - Dockerfile：建 /data 并 chown 给 app，WORKDIR 设为 /data；
  - 两份 compose：BLEVE_PATH=/data/bleve + 挂持久卷（132 那份此前连
    顶层 volumes 段都没有）；
  - .env.example：写清默认相对路径相对的是**启动目录**——本地从仓库根起
    和从 sundynix-mcp-go/ 起会写出两份互不相干的索引，排查时极易被坑。

附带澄清：中文分词本身没问题。直接开落盘索引验证过，mapping 里 text 字段
确实是 cjk，实测「星间链」命中 4 条、「海关监管」命中 104 条，BM25 打分正常。
a4852c3 那次修复是有效的，之前怀疑分词器的判断作废。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-20 13:40:31 +08:00

Blizzard

6b45adbbd2

chore(deploy): 三机部署 compose 拆分 + NATS 3 节点集群

126=MinIO(已部署)、128=基础设施、132=应用。

- deploy/128-infra:NATS 3 节点集群(独立卷+cluster routes,暴露4222/4223/4224)+PG/Redis/
  Milvus(自带etcd+自带内部minio,不复用126)/Neo4j/Jaeger;端口对局域网暴露、卷持久化。
- deploy/nats-cluster/nats{1,2,3}.conf:max_payload 一致 + jetstream + cluster。
- deploy/132-app:仅 gateway(3000:8080)+dispatcher+mcp-go+mcp-py,无 admin nginx;env 指向
  126/128;mcp-go 补齐 MINIO env(本会话 blob 遗漏);NATS_STREAM_REPLICAS=3;.env.example 模板。
- docker-compose.prod.yml(单机):删 admin 服务(已内嵌)、mcp-go 补 MINIO env。
- 三个 compose 均 docker compose config 校验通过;.env 已 gitignore、.env.example 可提交。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-18 14:45:24 +08:00

Blizzard

a5fd251fc0

feat(deploy): 容器化 + 一键独立部署 —— 5 服务镜像 + prod compose + 安装/备份/许可

此前应用服务只是本机裸二进制、无 Dockerfile、无法交付。本提交把项目从"只能在我笔记本
跑"变成"任何人一条命令起一整套"，是「演示 / 拉投资 / 卖给客户独立部署」的可交付基础。

- Dockerfile ×5：gateway/dispatcher/mcp-go 多阶段(distroless static, 36–55MB)；
  mcp-py(python-slim, 268MB)；admin(node 构建→nginx 托管 SPA + 反代 /api，76MB)。
  Go 构建上下文为仓库根以兜住 replace ../sundynix-shared；.dockerignore 瘦上下文。
- docker-compose.prod.yml：应用 + 基建一把起；经服务名互连（顺带避开 localhost DNS 坑）；
  基建端口不对宿主暴露；depends_on 健康检查保序（mcp-go 待 Milvus healthy）；
  APP_ENV=production 强制密钥校验 + 锁 CORS + 管理员白名单。
- .env.example + DEPLOY.md：两类密钥分层（引导密钥走 .env，模型 key 控制台加密存库）；
  首次管理员流程；安全建议。LICENSE 专有（授权模型可后定）。
- scripts/backup.sh + restore.sh：PG 逻辑备份 + 各数据卷快照 / 恢复。
- .gitignore 挡 .env*（密钥不入库）。

live：5 镜像全构建通过；独立 project 起整套 → nginx→gateway→NATS→dispatcher→mcp 全链路
注册+提任务 running→done，depends_on 保序生效。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-26 15:23:36 +08:00

3 Commits