# LianSyn Platform

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

## 新会话入口

1. 先读 [项目文件治理规则](AGENTS.md)。
2. 再读当前 [任务计划](task_plan.md)、[关键发现](findings.md) 和 [进度](progress.md)。
3. 通过 [业务适配登记表](agent设计规范/business-adaptation-registry.md) 定位业务入口、Skill、Schema、mapping 和实现。
4. 发布边界看 [生命周期发布门槛](agent设计规范/test-fixtures/lwlt-lifecycle/release-gate.md)，当前制品看 [发布清单](dist/release-manifest.json)。

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

## 当前发布基线

- Chrome 扩展制品版本由 [发布清单](dist/release-manifest.json) 定义；运行中的浏览器版本必须通过实时握手确认，不写入静态交接文档。
- 五个业务 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 重复抄写。

## 系统链路

```text
用户输入
  → 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](AGENTS.md)。

## 启动与验证

```bash
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 附件存储；具体连接与迁移边界见 [控制平面说明](control-plane/README.md)。

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