🔄 卡若AI 同步 2026-03-23 20:44 | 更新：金仓、水溪整理归档、运营中枢工作台 | 排除 >20MB: 11 个

2026-03-23 20:44:44 +08:00
parent ff46e9b223
commit dfe14fef80
18 changed files with 467 additions and 20 deletions
--- a/01_卡资（金）/金仓_存储备份/聊天记录管理/fallback/recent_chats_fallback.json
+++ b/01_卡资（金）/金仓_存储备份/聊天记录管理/fallback/recent_chats_fallback.json
@@ -1,7 +1,23 @@
 {
-"updated": "2026-03-23T12:12:36.198299+00:00",
+"updated": "2026-03-23T12:44:36.393773+00:00",
 "conversations": [
 {
+"对话ID": "27537490-475f-4f56-9a1e-7e4bca223179",
+"名称": "网站-api网关",
+"项目": "卡若AI",
+"首条消息": "这个api key sk-h7VW10iTSSXo6xJXe44nI1vUhsEcG3H8Z9XyFmWABvhaD4ZW. 只用这个不用其它的 https://api123.icu/about  阅读一下这个文档或这个文档的子链接了解清楚后安装，以后类似这种也可以自定义配置把它配置到这个网关里面，那个卡洛的网站的那个 API 网关里面，然后运行一下网站 ",
+"创建时间": "2026-03-23T12:41:57.994000+00:00",
+"消息数量": 36
+},
+{
+"对话ID": "a4f65a6c-1c9a-4b89-a4ca-9d8da25388c4",
+"名称": "Docker usage",
+"项目": "服务器",
+"首条消息": "打开docker",
+"创建时间": "2026-03-23T12:36:12.801000+00:00",
+"消息数量": 8
+},
+{
 "对话ID": "6afeb85a-5117-478f-a216-b3bfebae5b51",
 "名称": "信用卡请求",
 "项目": "卡若AI",
@@ -224,22 +240,6 @@
 "首条消息": "探索 /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平 项目中管理端（soul-admin/）和后端（soul-api/）关于\"内容管理\"的现有实现。\n\n请返回：\n1. soul-admin/src/pages/ 下所有与 content、chapter、book 相关的页面文件列表及简要说明\n2. soul-admin/src/App.tsx 中的路由配置（特别是内容相关的路由）\n3. soul-admin 侧边栏菜单中内容管理相关的菜单项\n4. soul-api/internal/handler/ 下与 content、chapter、book、upload 相关的 handler 文件列表\n5. 当前内容管理页面的主要功能有哪些\n\n请详细返回以上信息。",
 "创建时间": "2026-03-21T05:14:42.019000+00:00",
 "消息数量": 44
-},
-{
-"对话ID": "7911abf7-8c1b-447d-acfa-834c85079e8b",
-"名称": "API interface for cursor functionality",
-"项目": "工具维护",
-"首条消息": "那个我需要一个接口，这个可以直接用cursor的这个现在本机电脑这个科室，那我直接可以用变成一个接口，并且可以直接调用cursor的相应的接口的一个功能来回复这个事情，那我可以再做一个尝试，比如在那个都可以直接用科室的这一个功能。可以直接在终端或者其他的那个 tray 或者其他的地方直接可以配置这个 API，以及有 API 地址，有 key 地址也知道消耗多少 TOKEN.  科室=cursor 不是代表这个，请一定要帮我处理，那我可以连接",
-"创建时间": "2026-03-21T04:15:58.097000+00:00",
-"消息数量": 47
-},
-{
-"对话ID": "8eb0e1d1-6c55-4727-b7b5-eb4f39faec33",
-"名称": "注册信用卡技能和信息",
-"项目": "卡若AI",
-"首条消息": "那个告诉我的注册信用卡的 skill，然后把这个我最近注册的卡发给我",
-"创建时间": "2026-03-20T23:40:45.815000+00:00",
-"消息数量": 13
 }
 ]
 }
--- a/02_卡人（水）/水溪_整理归档/记忆系统/structured/last_chat_collect_date.txt
+++ b/02_卡人（水）/水溪_整理归档/记忆系统/structured/last_chat_collect_date.txt
@@ -1 +1 @@
-2026-03-21
+2026-03-23
--- a/02_卡人（水）/水溪_整理归档/记忆系统/structured/memory_health.json
+++ b/02_卡人（水）/水溪_整理归档/记忆系统/structured/memory_health.json
@@ -1,6 +1,6 @@
 {
-  "updated": "2026-03-21 12:18:44",
-  "date": "2026-03-21",
+  "updated": "2026-03-23 20:44:16",
+  "date": "2026-03-23",
  "scan_total": 0,
  "copied_new": 0,
  "skipped_idempotent": 0,
--- a/开发文档/10、项目管理/开发进度.md
+++ b/开发文档/10、项目管理/开发进度.md
@@ -0,0 +1,42 @@
+# 卡若AI · 开发进度
+
+更新时间：2026-03-23
+
+---
+
+## 一、项目总览
+
+| 阶段 | 说明 | 完成比例 | 状态 |
+|---|---|---:|---|
+| P1 启动 | 目标、范围、文档骨架建立 | 100% | 已完成 |
+| P2 开发 | 各模块细化与持续迭代 | 20% | 进行中 |
+| P3 联调 | 跨模块串联验证 | 0% | 未开始 |
+| P4 测试 | 回归测试与稳定性验证 | 0% | 未开始 |
+| P5 上线 | 发布、监控、复盘 | 0% | 未开始 |
+
+---
+
+## 二、功能清单
+
+| 编号 | 模块 | 描述 | 状态 | 周期 | 所属阶段 |
+|---|---|---|---|---|---|
+| F01 | 开发文档体系 | 建立 1～10 文档结构与基础内容 | ✅ | W1 | P1 |
+| F02 | 需求沉淀 | 需求与迭代记录模板化 | ✅ | W1 | P1 |
+| F03 | 进度管理 | 统一维护开发进度看板 | 🔄 | W1-W2 | P2 |
+
+---
+
+## 三、本周记录（第1周）
+
+- 目标：把文档体系搭起来，确保后续每次开发都有地方记、有标准走。
+- 完成：✅ F01、✅ F02
+- 进行中：🔄 F03
+- 下一步：补全各目录的“场景化案例”与“验收口径”。
+
+---
+
+## 四、下一步排期
+
+1. 完善每个模块的业务案例说明  
+2. 增加按周复盘模板并固化执行  
+3. 对齐文档与实际代码路径映射
--- a/开发文档/10、项目管理/项目落地执行表.md
+++ b/开发文档/10、项目管理/项目落地执行表.md
@@ -0,0 +1,27 @@
+# 项目落地执行表
+
+更新时间：2026-03-23
+
+---
+
+## 用法
+
+这张表只干一件事：把“要做什么”变成“谁在什么时间做完”。
+
+---
+
+## 执行清单
+
+| 优先级 | 事项 | 负责人 | 截止时间 | 状态 |
+|---|---|---|---|---|
+| 高 | 完善 1～10 各目录细节文档 | 开发 | 2026-03-26 | 进行中 |
+| 高 | 对齐文档与现有代码模块映射 | 开发 | 2026-03-27 | 未开始 |
+| 中 | 增加常见问题与场景案例 | 运营+开发 | 2026-03-29 | 未开始 |
+
+---
+
+## 交付标准
+
+- 有明确交付物，不接受“口头完成”
+- 有更新时间，不接受“长期待办”
+- 有负责人，不接受“大家一起负责”
--- a/开发文档/1、需求/功能迭代记录.md
+++ b/开发文档/1、需求/功能迭代记录.md
@@ -0,0 +1,24 @@
+# 功能迭代记录
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 使用说明
+
+每次新增、修改、下线功能，都在这里记一条。
+写明“为什么做、做了什么、结果怎样”，后面复盘才有依据。
+
+---
+
+## 迭代日志
+
+### 2026-03-23
+
+- **迭代主题**：开发文档体系从 0 到 1 建立
+- **背景**：团队协作信息分散，需求、架构、进度不在同一个体系里
+- **动作**：创建 `开发文档` 目录并建立 1～10 文档框架
+- **结果**：形成统一入口，后续开发可按固定模板推进
+- **后续**：按周持续补充各模块细节，避免“空文档”
--- a/开发文档/1、需求/项目需求文档.md
+++ b/开发文档/1、需求/项目需求文档.md
@@ -0,0 +1,52 @@
+# 项目需求文档
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 这个项目到底在做什么
+
+一句话：把卡若AI 做成“能稳定运行、能持续迭代、能让团队协同”的项目中枢。
+
+简单讲，不是只做一个聊天页面。
+而是做一整套可落地的系统：有内容、有流程、有数据、有沉淀。
+
+---
+
+## 目标用户是谁
+
+- 卡若本人（主决策）
+- 开发同事（做功能）
+- 运营同事（看数据、跑流程）
+- 合作方（看结果、看交付）
+
+---
+
+## 主要功能（大白话版）
+
+1. 对话和任务能统一管理，不丢记录。
+2. 能把日常经验沉淀成可复用流程。
+3. 网站、文档、运营动作能串起来，不再各做各的。
+4. 出问题有降级、有告警，不会“直接挂死”。
+
+---
+
+## 非功能要求（必须满足）
+
+- 稳定：接口挂了能自动切换备用接口。
+- 可追踪：每次迭代有记录，出了问题能回溯。
+- 易交接：新人看文档就能接手，不靠“口口相传”。
+- 易扩展：后面加新模块，不推翻重来。
+
+---
+
+## 这份需求文档怎么用
+
+当你准备做新功能时，先回答三个问题：
+- 这功能给谁用？
+- 解决了什么具体问题？
+- 做完以后，怎么验证它真的有用？
+
+把这三个问题写清楚，再开工，返工会少很多。
--- a/开发文档/2、架构/系统架构说明.md
+++ b/开发文档/2、架构/系统架构说明.md
@@ -0,0 +1,42 @@
+# 系统架构说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 架构思路（先讲人话）
+
+把这个系统想象成一家“连锁门店”：
+- 前端是门店大厅（用户看到的界面）
+- 后端是后厨（处理业务逻辑）
+- 数据库是仓库（存货和历史记录）
+- 部署和监控是物业与安保（保证不停业）
+
+---
+
+## 模块划分
+
+1. **展示层**：页面交互、按钮流程、状态反馈
+2. **业务层**：规则判断、任务编排、流程执行
+3. **数据层**：用户数据、对话记录、配置参数、日志
+4. **运维层**：发布、回滚、告警、健康检查
+
+---
+
+## 关键设计原则
+
+- 一个功能一个责任，不搞“大杂烩模块”
+- 先保证可用，再做漂亮和复杂
+- 所有关键动作要可记录、可回看、可追责
+- 高风险点（接口、网络、三方依赖）都要有兜底
+
+---
+
+## 扩展原则
+
+后面新增模块时，优先复用现有流程：
+- 能复用就不重写
+- 需要重写就先写清楚替换理由
+- 新模块必须能接入现有文档与进度体系
--- a/开发文档/3、原型/页面流程说明.md
+++ b/开发文档/3、原型/页面流程说明.md
@@ -0,0 +1,31 @@
+# 页面流程说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 原型文档怎么理解
+
+这不是“画得漂亮就行”的文档。
+它的作用是让产品、开发、运营三方对同一条用户路径理解一致。
+
+---
+
+## 核心流程（文字版）
+
+1. 用户进入首页  
+2. 看到核心入口（对话、功能、管理）  
+3. 点击进入目标功能  
+4. 完成操作并拿到反馈  
+5. 系统记录行为，便于后续优化
+
+---
+
+## 页面设计原则
+
+- 一个页面只解决一件大事
+- 关键按钮位置固定，不让用户“到处找”
+- 错误提示要讲人话，告诉用户下一步怎么做
+- 加载要有反馈，避免用户以为系统卡死
--- a/开发文档/4、前端/前端功能说明.md
+++ b/开发文档/4、前端/前端功能说明.md
@@ -0,0 +1,29 @@
+# 前端功能说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 前端在这个项目里的角色
+
+前端不是“只负责好看”。
+它负责把复杂系统变成用户一眼就能操作的界面。
+
+---
+
+## 前端开发重点
+
+- 页面切换要顺滑，别突然跳来跳去
+- 数据加载要有骨架屏或提示
+- 手机端操作区域要够大，防止误触
+- 关键按钮文案要直白，少用模糊词
+
+---
+
+## 前端验收标准（大白话）
+
+- 用户第一次进来，30秒内知道下一步要做什么
+- 关键动作不超过三次点击
+- 出错时不甩锅，明确告诉用户怎么办
--- a/开发文档/5、后端/后端服务说明.md
+++ b/开发文档/5、后端/后端服务说明.md
@@ -0,0 +1,30 @@
+# 后端服务说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 后端在做什么
+
+后端就是系统的“大脑和执行中心”。
+前端发来请求，后端负责判断、处理、存储、返回结果。
+
+---
+
+## 后端职责
+
+- 校验输入是否合规
+- 执行业务规则
+- 对接外部服务
+- 统一错误处理
+- 写入数据库与日志
+
+---
+
+## 稳定性要求
+
+- 单接口失败时自动切换可用通道
+- 全部接口都失败时，返回可读降级信息
+- 异常要有告警，不能“悄悄失败”
--- a/开发文档/6、接口/API说明.md
+++ b/开发文档/6、接口/API说明.md
@@ -0,0 +1,30 @@
+# API说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 接口文档给谁看
+
+- 前端同学：知道怎么调接口
+- 后端同学：知道输入输出契约
+- 测试同学：知道该测什么
+
+---
+
+## 每个接口至少写清楚四件事
+
+1. 这个接口是干什么的  
+2. 需要传什么参数  
+3. 成功会返回什么  
+4. 失败会返回什么，以及用户如何处理
+
+---
+
+## 接口管理原则
+
+- 字段名别随便改，改了就要写变更记录
+- 同类错误用同类返回格式，便于统一处理
+- 涉及权限的接口必须明确鉴权规则
--- a/开发文档/7、部署/部署说明.md
+++ b/开发文档/7、部署/部署说明.md
@@ -0,0 +1,34 @@
+# 部署说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 部署目标
+
+一句话：把“本地能跑”变成“线上稳定跑”。
+
+---
+
+## 部署前检查
+
+- 配置是否齐全（环境变量、数据库连接、第三方账号）
+- 关键依赖是否可用（网络、端口、存储）
+- 回滚方案是否准备好（出问题能快速撤回）
+
+---
+
+## 部署后检查
+
+- 主页能打开，核心接口可用
+- 关键链路可走通（登录、调用、保存、查询）
+- 告警和日志正常上报
+
+---
+
+## 故障处理原则
+
+- 先止损，再定位，再修复
+- 重大问题必须留复盘，不允许“口头带过”
--- a/开发文档/8、手册/使用手册.md
+++ b/开发文档/8、手册/使用手册.md
@@ -0,0 +1,36 @@
+# 使用手册
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 这本手册给谁用
+
+给第一次接触这个系统的人。
+目标是“10分钟看懂、30分钟上手”。
+
+---
+
+## 快速上手三步
+
+1. 先看首页的核心入口，确认你要做的是哪类任务。  
+2. 按页面提示走一遍完整流程。  
+3. 出现问题时，先看错误提示，再看本手册对应章节。
+
+---
+
+## 常见问题（示例）
+
+- 看不到数据：先确认是否已完成前置步骤。  
+- 页面加载慢：先看网络和服务状态，再看是否在高峰时段。  
+- 功能入口找不到：优先回首页，从主导航重新进入。
+
+---
+
+## 手册维护规则
+
+- 每次页面改版后，同步更新对应说明
+- 新增功能必须补一条“怎么用”
+- 所有描述保持普通人能看懂
--- a/开发文档/9、其他/补充说明.md
+++ b/开发文档/9、其他/补充说明.md
@@ -0,0 +1,22 @@
+# 补充说明
+
+版本：v1.0  
+创建日期：2026-03-23  
+最后更新：2026-03-23
+
+---
+
+## 这个目录放什么
+
+放暂时不归类，但又对项目有价值的内容，比如：
+- 术语解释（避免团队理解偏差）
+- 外部资料摘录
+- 临时流程说明（后续转正再归档）
+
+---
+
+## 使用原则
+
+- 先写清楚用途，再放内容
+- 不要把“临时说明”长期堆在这里
+- 每周整理一次，该归档的归档
--- a/开发文档/README.md
+++ b/开发文档/README.md
@@ -0,0 +1,46 @@
+# 卡若AI 项目开发文档（总入口）
+
+更新时间：2026-03-23
+
+这套文档是给「能看懂业务、也准备开始开发」的人用的。
+不讲花里胡哨的术语，不贴代码，用大白话把项目讲清楚。
+
+你可以把它理解成一本“开店手册”：
+- 先看客户是谁、要卖什么（需求）
+- 再看店怎么搭（架构）
+- 再看店面怎么摆（原型、前端）
+- 再看后厨怎么出餐（后端、接口、数据库）
+- 最后看怎么开门营业（部署、手册、项目管理）
+
+---
+
+## 目录导航（1～10）
+
+1. `1、需求/`
+2. `2、架构/`
+3. `3、原型/`
+4. `4、前端/`
+5. `5、后端/`
+6. `6、接口/`
+7. `7、部署/`
+8. `8、手册/`
+9. `9、其他/`
+10. `10、项目管理/`
+
+---
+
+## 建议阅读顺序（第一次看）
+
+1. 先看 `1、需求/项目需求文档.md`，搞清楚这个项目到底解决什么问题。
+2. 再看 `2、架构/系统架构说明.md`，知道系统由哪些模块组成。
+3. 再看 `10、项目管理/开发进度.md`，知道现在做到哪一步。
+
+---
+
+## 本文档怎么维护
+
+- 每做完一个功能，更新一次：
+  - `1、需求/功能迭代记录.md`
+  - `10、项目管理/开发进度.md`
+- 每次更新时间都写当天日期，方便回溯。
+- 发现“看不懂”的句子，就立刻改成更口语的话。
--- a/运营中枢/工作台/gitea_push_log.md
+++ b/运营中枢/工作台/gitea_push_log.md
@@ -432,3 +432,4 @@
 | 2026-03-23 16:35:47 | 🔄 卡若AI 同步 2026-03-23 16:35 | 更新：Cursor规则、金仓、卡人、水溪整理归档、火炬、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-23 16:37:40 | 🔄 卡若AI 同步 2026-03-23 16:37 | 更新：Cursor规则、金仓、水溪整理归档、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-23 20:12:48 | 🔄 卡若AI 同步 2026-03-23 20:12 | 更新：金仓、水桥平台对接、卡木、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 |
+| 2026-03-23 20:13:01 | 🔄 卡若AI 同步 2026-03-23 20:12 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
--- a/运营中枢/工作台/代码管理.md
+++ b/运营中枢/工作台/代码管理.md
@@ -435,3 +435,4 @@
 | 2026-03-23 16:35:47 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-23 16:35 | 更新：Cursor规则、金仓、卡人、水溪整理归档、火炬、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-23 16:37:40 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-23 16:37 | 更新：Cursor规则、金仓、水溪整理归档、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-23 20:12:48 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-23 20:12 | 更新：金仓、水桥平台对接、卡木、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
+| 2026-03-23 20:13:01 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-23 20:12 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
@@ -1 +1 @@
 -03-21
 -03-23