3095df3d2a
回传只进不出：list_envoy_returns 无处置状态、LIMIT 50 把更早的回传静默挤掉； 入口只有 Claude /envoy，08-23 后 enterprise 主力转 DSH/Codex 即零回传。 - envoy.rs 业务本体（连接注入）+ envoy_dispositions 回执表（migrate 补表） - report_envoy_return（项目级，Claude/Codex/DSH 在项目地址均可用）：字段枚举校验、 内容压单行限长、兜底拒绝明显凭据；同项目 1 天内同内容未处置幂等返回原编号 （IMMEDIATE 事务防并发重复）；复用 append_project_note 的档案双写 - resolve_envoy_return（控制面）：landed/carded 必填落点、reason 必填、允许更正 - list_envoy_returns 默认只列未处置（带编号），附已处置计数，超出展示上限明说； LEFT JOIN 不再丢掉登记已删项目的回传；include_resolved 可审计回执 - lian-jing skill 新增「遇到摩擦时回传炼境」；/envoy 改为指向该入口的薄指引 （保留扫描与分类硬门槛，炼境分发物出错免门槛，身份改读 .lian-jing/context.json）； AGENTS 托管块加一行指路（1.9.0→1.10.0），能力包 base-onboarding 1.6.0→1.7.0 - 删除炼境仓库内 Codex 迁移遗留的 source-command-envoy 技能（读旧身份文件、走旧写入路径） - 契约与架构文档同步：project-context.yaml、project-brief.md、AGENTS.md、agents-meta-rules.md Rules-Applied: R05,R06,R12 Feature-Confirmed: true Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# 炼境 — 速查卡
|
||
|
||
**定位**：agent 开发子项目的管家。agent 反复摩擦之处，炼境沉淀为跨 agent 可调用的结构化能力（分发版本化基线、提供项目身份/环境/验证资源/任务上下文、汇总交付信号）；项目本身仍拥有业务规则、测试、部署声明与交付决策。准入/退出规则见 AGENTS.md「管家准入与退出」。
|
||
|
||
## 技术栈
|
||
|
||
| 层 | 技术 |
|
||
|----|------|
|
||
| 前端 | React 19 + TypeScript + TailwindCSS + React Query + Zustand + React Flow |
|
||
| 后端 | Rust + Tauri v2 |
|
||
| 数据 | SQLite（rusqlite + r2d2） |
|
||
| MCP | 内嵌 HTTP Server（供 Codex、Claude 等客户端 adapter 调用） |
|
||
| 包管理 | pnpm |
|
||
|
||
## 关键约定（改代码前必看）
|
||
|
||
1. **Tauri command ↔ 前端封装**：新增 command 必须同步更新 `src/lib/commands.ts`
|
||
2. **DB 变更必须有 migration**：在 `src-tauri/src/db.rs` 的 `migrate()` 里补语句，否则旧版本升级报错
|
||
3. **Rust 业务函数依赖注入**：禁止内部 `pool().get()`，连接由调用方传入
|
||
4. **接入包模板 = 分发给被管理项目的规则**：改 `resources/onboarding/` 务必同步 `docs/templates/`
|
||
5. **项目身份上下文**：`.lian-jing/context.json` 是工具无关的 `project_id` 单一事实来源；`.claude/liangjing.json` 仅保留为 Claude 兼容投影；`.lian-jing/capability-packs.json` 记录托管基线版本，版本不符必须通过自检报告升级提示
|
||
|
||
## 目录速查
|
||
|
||
```
|
||
src/lib/commands.ts 前后端契约（唯一前端入口）
|
||
src-tauri/src/commands/ Rust 后端实现（一功能一文件）
|
||
src-tauri/src/db.rs 数据库 schema + migration
|
||
src-tauri/src/credential_store.rs Windows 本机凭证引用、校验与兼容迁移
|
||
src-tauri/src/mcp_server.rs MCP Server（agent 调用炼境的入口）
|
||
src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch
|
||
src-tauri/src/envoy.rs 使者回传本体（三端回传写入、处置回执、待处置列表）
|
||
src-tauri/src/commands/dev_variables.rs 项目开发变量本体（Agent 登记、人填写、受认证单项读取）
|
||
src-tauri/src/commands/delivery_status.rs 项目交付信号聚合（Git / Gitea / 部署证据）
|
||
src-tauri/resources/onboarding/ 接入包分发模板
|
||
.blueprint/ 项目蓝图
|
||
docs/ai-context/ AI 上下文文档（本文件、契约映射）
|
||
docs/templates/ 接入包模板草案（设计层）
|
||
```
|
||
|
||
## 验收命令
|
||
|
||
```bash
|
||
pnpm typecheck # TypeScript 类型检查
|
||
pnpm tauri dev # 启动开发环境
|
||
cargo test # Rust 单元测试（src-tauri/ 目录下运行）
|
||
```
|