# LianSyn Platform

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

## 新会话入口

1. 先读 [项目文件治理规则](AGENTS.md)。
2. 加载 `maintain-project-docs` Skill，通过 Concurrent Task Gate 取得当前 worktree 所有权。
3. 按 [项目记忆入口](.project-docs/05-agent-entry/read-before-planning.md) 加载当前任务、集成状态、决策和架构。
4. 通过 [业务适配登记表](agent设计规范/business-adaptation-registry.md) 定位业务入口、Skill、Schema、mapping 和实现。
5. 发布边界看 [生命周期发布门槛](agent设计规范/test-fixtures/lwlt-lifecycle/release-gate.md)，当前制品看 [发布清单](dist/release-manifest.json)。

`.project-docs/` 是唯一活动项目记忆；旧 Planning with Files 已日期化归档。`archive/` 是只读历史，不定义当前规则；桌面不是当前源码或发布源。

## 当前发布基线

- Chrome 扩展制品版本由 [发布清单](dist/release-manifest.json) 定义；运行中的浏览器版本必须通过实时握手确认，不写入静态交接文档。
- 五个业务 Skill：`0.5.125`；运营 DOCX：`0.5.125`。
- Agent Prompt：`ltjt-agent-prompt-v1.8-independent-headcount-categories`。
- 控制面确定性解析器：`ltjt-program-parser-v1.0.6`；18 项路由迁移后仍默认 `ai`，由操作台逐项晋级；两项名单 route 固定为 Program-only。
- 独立团/散拼子单名单固定为 Program-only：文字用于业务定位，名单由单个 `.xls`/`.xlsx` 附件确定性规范化；附件到齐前任务保持等待。
- 生命周期契约：`ltjt-lifecycle-v2.9-roster-leader-contact-2026-08`。
- 新增的 SGL/TWN 与成人/占床儿童/不占床儿童/领队人数映射仍需授权 ERP 实写复测；未验证宽字段继续转人工复核或失败关闭。

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

## 系统链路

```text
手工输入 / AgentBus 输入
  → 18 项机器路由 + 任务级模式快照
  → AI / Shadow / Auto / Program 解析编排
  → AI Skill 或业务系统确定性解析器
  → 统一 operation 契约校验
  → 解析态 operation
  → 控制面任务与确认
  → Chrome 插件前门禁
  → ERP 只读唯一解析与页面联动
  → 执行态 operation + 严格写前门禁
  → ERP 原生操作
  → 明确响应与 fresh requery
```

AI Agent/Skill 与确定性解析器都只负责业务语义、字段抽取和归一化；两者通过同一个最终 operation 契约，不查询 ERP、不生成内部引用、不声明业务成功。`shadow` 只让 AI 结果生效，`auto` 仅对固定技术错误调用 AI，`program` 不调用 AI。平台任务 ID、会话、解析决策、确认、通讯和审计属于平台信封，不进入业务 operation。

解析路由、AI / Shadow / Auto / Program 模式和组织全自动化开关对手工与 AgentBus 新任务使用同一套规则；任务来源只影响输入/回执适配，不覆盖解析器或确认模式。无业务指令时只允许完整且唯一的已登记字段签名确定 route，未知或歧义输入继续失败关闭或保留兼容 AI 路径。

## 目录

| 目录 | 用途 |
|---|---|
| `.project-docs/` | worktree 所有权门禁、任务作用域记录和经 Integration Gate 更新的 canonical 项目记忆 |
| `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)。
- 生产结构化日志通过 Docker 有界轮转保留；服务端可运行 `sh infra/diagnose-server.sh --since 30m --match <request/task/frame/error>` 只读检查容器、readiness 与关联日志。

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