76 lines
3.7 KiB
Markdown
76 lines
3.7 KiB
Markdown
# 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 更新都需要本轮明确授权。
|