LianSyn Platform

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

新会话入口

1. 先读 项目文件治理规则。
2. 加载 maintain-project-docs Skill，通过 Concurrent Task Gate 取得当前 worktree 所有权。
3. 按 项目记忆入口 加载当前任务、集成状态、决策和架构。
4. 通过 业务适配登记表 定位业务入口、Skill、Schema、mapping 和实现。
5. 发布边界看 生命周期发布门槛，当前制品看 发布清单。

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

当前发布基线

• Chrome 扩展制品版本由 发布清单 定义；运行中的浏览器版本必须通过实时握手确认，不写入静态交接文档。
• 五个业务 Skill：0.5.126；运营 DOCX：0.5.126。
• 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 重复抄写。

系统链路

手工输入 / 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。

启动与验证

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 附件存储；具体连接与迁移边界见 控制平面说明。
• 生产结构化日志通过 Docker 有界轮转保留；服务端可运行 sh infra/diagnose-server.sh --since 30m --match <request/task/frame/error> 只读检查容器、readiness 与关联日志。

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