k88936
f5368c825f
重构了editor agent. 使得它能进行多轮工具调用， 把工具调用的结果嵌入到上下文里。 对于上下文的图片， 使用哈希后的id用来引用，不暴露细节信息to llm。 当前实现， 状态直接维护在json doc里， 需要对整个doc加锁，任务目前只能串行。 把SSE改成一个简单请求（ 因为生图工具耗时需要二次确认， 不需要再实时展示给用户进度）。 增加确认/取消生图操作。 把tool的参数和错误情况做了反馈。 TODO： 工具调用的规范/prompt还可以改进。 改用external job来做素材生成， 针对来自editor agent 的生成会把生成资产的引用加入到结果json里， 客户端轮询 external job 确定生成状态， 发现结束了或者失败了就 重新get 会话，后端重新提供会话的时候把 结果插入回会话历史里，用来让 ai 引用 以及显示 --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/76 Reviewed-by: 段舒康 <kdletters@qq.com> Co-authored-by: 王德宇 <kvtodev@outlook.com> Co-committed-by: 王德宇 <kvtodev@outlook.com>
61 lines
3.6 KiB
Markdown
61 lines
3.6 KiB
Markdown
# 文档地图与阅读索引
|
||
|
||
更新时间：`2026-07-16`
|
||
|
||
## 当前文档入口
|
||
|
||
| 场景 | 优先阅读 |
|
||
| --- | --- |
|
||
| 建立项目背景 | `README.md`、`AGENTS.md`、`docs/project-memory/shared-memory/project-overview.md` |
|
||
| Agent 复杂任务执行规则 | `AGENTS.md`、`docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md` |
|
||
| 找当前文档 | `docs/README.md` |
|
||
| 产品、命名、UI、协作和废弃路线 | `docs/【项目基线】当前产品与工程约束-2026-05-15.md` |
|
||
| 后端、DDD、API、SpacetimeDB schema 和表目录 | `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md` |
|
||
| 创作入口、草稿架和玩法链路 | `docs/【玩法创作】平台入口与玩法链路-2026-05-15.md` |
|
||
| 创作流程统一阶段计划 | `docs/planning/【玩法创作】创作流程统一总计划-2026-05-30.md` |
|
||
| 宿主壳、移动 App、桌面 App 与 AI H5 沙箱边界 | `docs/【前端架构】宿主壳能力统一协议-2026-06-17.md`、`docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md` |
|
||
| 本地启动、验证、部署、埋点和运营查询 | `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md` |
|
||
| 微信小程序虚拟支付 | `docs/【技术方案】微信虚拟支付接入-2026-05-26.md` |
|
||
| UI 像素资产与 9-slice 规范 | `UI_CODING_STANDARD.md` |
|
||
| 图片画布生成面板与模型定价 | `docs/【编辑器】生成类面板Lovart统一改造方案-2026-06-17.md`、`docs/【编辑器】模型定价配置管理方案-2026-06-22.md` |
|
||
| 图片画布右侧 Agent 对话、会话消息 OSS 持久化、普通 JSON 消息、工具任务懒回填及侧栏并存规则 | `docs/【编辑器】画布Agent对话面板-2026-07-03.md`、`docs/adr/【ADR】画布Agent会话消息存OSS-2026-07-03.md` |
|
||
|
||
## 阅读顺序
|
||
|
||
通用复杂任务：
|
||
|
||
1. `AGENTS.md`
|
||
2. `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md`
|
||
3. `docs/project-memory/shared-memory/`
|
||
4. `docs/README.md`
|
||
5. 与任务匹配的当前融合文档
|
||
|
||
后端 / 数据真相 / SpacetimeDB：
|
||
|
||
1. `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`
|
||
2. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
3. 对应 crate README 或源码
|
||
|
||
玩法 / 创作入口 / 运行态：
|
||
|
||
1. `docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`
|
||
2. 若任务涉及跨玩法创作流程统一，读取 `docs/planning/【玩法创作】创作流程统一总计划-2026-05-30.md`
|
||
3. `docs/【项目基线】当前产品与工程约束-2026-05-15.md`
|
||
4. 相关前端组件、service、shared contract 和后端 module
|
||
|
||
生产部署 / 服务器 / Jenkins：
|
||
|
||
1. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
2. `deploy/env/api-server.env.example`
|
||
3. `deploy/nginx/README.md`
|
||
|
||
## 维护规则
|
||
|
||
- 当前 `docs/` 只保留少量融合文档。
|
||
- `AGENTS.md` 只保留最高优先级入口；Agent 执行细则优先沉到 `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md` 或对应专题文档。
|
||
- 新增工程实现时，如果已有对应当前文档，必须同步更新。
|
||
- 如果没有合适位置，新文档文件名必须使用 `【标签名】中文标题-YYYY-MM-DD.md`。
|
||
- 阶段性流水账、一次性修复记录和已关闭实验不要再新增为长期文档。
|
||
- 阶段性计划和一次性 TODO 不再作为长期文档目录；需要保留的决策、流程和坑点应进入 `docs/` 当前文档或 `docs/project-memory/shared-memory/`。
|
||
- 如果文档与代码冲突，先确认代码事实，再更新过期文档和共享记忆。
|