LWLT-AIBOT/README.md

LianSyn Platform

本项目把业务人员的自然语言指令解析为标准 operation，再由控制面、平台页面和 Chrome ERP 适配器完成确定性校验与受控执行。

新会话入口

1. 先读 项目文件治理规则。
2. 再读当前 任务计划、关键发现 和 进度。
3. 通过 业务适配登记表 定位业务入口、Skill、Schema、mapping 和实现。
4. 发布边界看 生命周期发布门槛，当前制品看 发布清单。

archive/ 是只读历史，不定义当前规则；桌面不是当前源码或发布源。

当前发布基线

• Chrome 扩展制品版本由 发布清单 定义；运行中的浏览器版本必须通过实时握手确认，不写入静态交接文档。
• 五个业务 Skill：0.5.119；运营 DOCX：0.5.118。
• Agent Prompt：ltjt-agent-prompt-v1.5-next-date-rollover。
• 生命周期契约：ltjt-lifecycle-v2.8-updating-wide-parse-2026-08。
• 新增的 SGL/TWN 与成人/占床儿童/领队人数映射仍需授权 ERP 实写复测；未验证宽字段继续转人工复核或失败关闭。

版本、文件名和 SHA-256 只维护在 dist/release-manifest.json，不在多个 README 重复抄写。

系统链路

用户输入
  → Agent Prompt + 对应 Skill
  → 解析态 operation
  → 控制面任务与确认
  → Chrome 插件前门禁
  → ERP 只读唯一解析与页面联动
  → 执行态 operation + 严格写前门禁
  → ERP 原生操作
  → 明确响应与 fresh requery

Agent/Skill 只负责业务语义、字段抽取和归一化；不查询 ERP、不生成内部引用、不声明业务成功。平台任务 ID、会话、确认、通讯和审计属于平台信封，不进入业务 operation。

目录

目录	用途
agent设计规范/	Agent Prompt、五个 Skill、业务模板、业务入口和稳定夹具
schemas/、mappings/	当前解析/执行契约与 ERP 映射
chrome-extension/	已登录 ERP 页面内的浏览器适配器源码
control-plane/	PostgreSQL 任务、会话、确认、审计与 AgentBus 控制面；生产附件通过 OSS provider 存储
LianSyn-platform/	正式操作台和外部 Agent 解析适配器
tools/	自动测试、构建器、只读诊断和受控写入工具
infra/	网关、部署检查、备份和恢复检查
samples/	脱敏稳定样例
.build/	Git 忽略的 TypeScript 编译输出，不手工维护
dist/	当前版本化交付物和机器可读发布清单
reports/、quarantine/	临时报告边界与不可信输入隔离边界
archive/	日期化历史证据、版本、研究、交接和规划快照

完整放置与轮转规则见 AGENTS.md。

启动与验证

npm run dev
npm run start:platform-adapter
npm run check:repo
npm test
npm run build

• 正式操作台：http://127.0.0.1:8786/
• 独立解析适配器：http://127.0.0.1:8765/
• npm run build 输出到 .build/；dist/ 不再保存编译后的控制面代码。
• 本地 .env 与 LianSyn-platform/.env 只用于本机运行并由 Git 忽略；生产使用部署环境变量。
• 生产默认使用远程 PostgreSQL 的独立 DATABASE_SCHEMA 和 OSS 附件存储；具体连接与迁移边界见 控制平面说明。

真实 ERP 写入、测试数据创建/清理、服务重启、部署、外部发送或云端 Profile 更新都需要本轮明确授权。