快速开始

BI Brain

BI Brain 是项目管理与协作平台，支持集成配置中心、阿里云AI网关消费者治理、统一RBAC权限、数字员工价值评估、中心智能超级Agent、Aiko自主进化、可视化监控仪表盘、Wiki知识库、Issue协作图谱、Issue状态机与串行工作流、Team层级治理、Core动态Skill、文件空间命名链接等全链路研发协同能力。

---

v3.0.4 （Latest）

发布日期：2026-08-28 | 状态：正式版本 本期主题：团队维度用户画像 + 工单数据源中立化 + 状态机确认流程 + 专家 Agent 增强 + 圈复杂度专项整改 代码范围：v3.0.3..v3.0.4（develop / origin/develop）

1.1 新增功能

模块	详情
团队维度用户画像（全新模块）	1. 新增 user_team_portrait 团队画像覆盖层，同一用户在不同小组可有差异化定位 2. 支持 8 个可覆盖字段 + 团队独有 note 字段，多值字段整字段替换、显式置空不回落全局 3. 任务评估自动回写团队实测（team_id 快照列冻结评估时刻归属），派工按样本量四档降级避免跨组数据冒充本组表现 4. 新增团队画像 API（list/get/put/delete、清空覆盖层）与前端 TeamPortraitPanel 编辑器，权限区分个人修改与管理员操作
工单数据源中立化（work-item）	1. 新增来源中立 work_item 表，身份改为 (source, external_id)，不再要求伪造 Jira Key，接入新来源不撞唯一约束 2. 父票/子票同构一张表，角色由 parent_external_id 实时计算，叶子票（role=leaf）作为派工入口、父票作为背景 3. 新增 description 与 5 个父票快照列，子票自带背景上下文 4. 新增 /api/work-items/* 系列接口，apply-plan 的 jira_data_id/jira_bound 更名 work_item_id/work_item_bound
工单责任人字段与 Team 绑定	1. work_item 新增 assignee_name / assignee_email 两列，支持按责任人派单（邮箱视来源可空） 2. 新增 PUT /api/work-items/data/{id}/team 绑定端点，工单可绑定/改绑/解绑 Team，校验同工作区且 Team 未归档，重同步保持绑定不变
下一状态草案（人工确认后落库）	1. 新增只读草案接口 POST /api/bibrain/issues/{issue_id}/state-instances/proposal，全程不写库 2. 服务端组装工单/状态链/执行轨迹/成果物/候选人池，草案优先由 BiBrain Core 只读模式生成（readonly 由鉴权强制，不可用时回落原链路） 3. 结构化输出 + Pydantic 校验（json_schema → json_object → 纯提示词三级降级，校验失败带拒绝原因重试一次） 4. 前端状态链卡片新增「生成下一状态」入口与可编辑表单
任务状态机确认流程	1. 引入 pending_confirmation 状态承载人工审核流程，complete 后进入待确认，仅核心服务可追加状态 2. 实现 confirm / request-changes 状态命令；后收敛为 complete → completed 两段式，check 完成后不再二次确认 3. Redmine 工单由「待确认」直接到 done，去掉同步时每次联网状态查询
任务截止日提醒	Issue 新增截止日期字段与提醒服务（issue due reminders），到期任务自动推送通知
按 Team 隔离的动态流	新增按 Team 隔离的部门动态流接口与团队动态快照迁移，动态按小组归属过滤展示
专家成果物归属	1. 专家执行结果落库时自动回填成果物专家归属（uploaded_by_agent_id），不依赖手动上传也不丢归属 2. workspace_file 支持按专家 agent 过滤成果文件，并显式声明上传归属（expert_agent_id） 3. 提供 one-shot 回填脚本处理历史 NULL 归属
通用专家记忆 API	1. 新增 /expert-memory/* 通用记忆 HTTP API（pages/snapshots/config/search/context），成员可浏览/检索频道 2. /expert-memory 为主路径、/expert 为 legacy alias；新建专家自动绑定 memory_channel 3. 知识文件全文注入（xlsx 全文注入上下文），专家 run 结果桥接 Issue 并挂载真报告为成果物
任务文档导入 Schema 校验	1. 新增 plan schema registry / schema drafts / schema binding 与导入内容审计快照 2. 支持 schema 抽取、草稿评审与发布流程，AI 异步解析 + 草稿持久化 + 证据校验
进度工时看板	1. 新增 progress_dashboard 模块，按日期/分组/状态/风险多维聚合筛选与分页查询 2. 新增 /api/progress-dashboard 与 /api/w/{slug}/progress-dashboard 兼容路由
禁止同工作区重名小组	team 名称新增活跃范围唯一约束（大小写不敏感、空白归一化），创建/改名/归档恢复均校验重名并返回 409
指派 Jira 后通知 Team Leader	工单指派后自动通知团队负责人
Jira 批量导入与版本护栏	1. 新增批量导入端点，单次成员校验 + 单事务 + savepoint 逐条隔离 2. Jira 入库版本护栏防止旧版本静默覆盖新版本（updated/stale 响应） 3. 父子关系改用 parent_jira_key 索引列读时派生，导入复杂度 O(N²)→O(N)
点检模块迁移	1. 点检模块迁移至 BiBrain：git-log API + 计划解析 + 频道记忆 2. GitLab API 备用数据源，仓库 project_id 缺省时按仓库名自动解析并给出明确 per-repo 错误
Expert Agent 专家智能体（全新模块）	1. 新增专家 Agent 完整 CRUD（创建/编辑/删除/列表），支持角色提示词与知识文件绑定 2. 新增专家 Agent 编排引擎，支持在会话中指定专家执行任务，管理任务生命周期 3. 前端新增专家 Agent 管理页（AdminExpertAgents）与知识库管理页（AdminKnowledgeBases） 4. 对话输入框新增 ExpertPicker 选择器，支持在对话中选择专家 Agent 5. 配套 Alembic 迁移：expert_agent 表、知识文件表、知识绑定表
Jira 数据增强	1. 新增 Jira 数据父子关系支持（children_ids→parent_jira_key 读时派生），实现创建/移动/删除操作与并发安全锁定 2. Jira 原始数据支撑元数据提取与分页查询，支持按票号搜索与类型筛选，排序改为 updated_at 3. 组织空间按专家过滤成果文件（uploaded_by_agent_id） 4. Jira 数据存储格式从 JSON 迁移为 NDJSON 文本格式 5. 删除接口权限调整：移除 DEBUG 模式限制，权限从 owner/admin 调整为任意成员
动态工单拆解	1. 需求分析接口新增 feature_type 参数，支持 epic/bug/qa/custom 四种类型 2. 根据 feature_type 和需求内容动态决定 Issue 数量，不再使用固定模板 3. 派工方案 Markdown 格式更新，feature_type 写入 frontmatter，旧版兼容默认 custom
IssueStateInstance 子任务内容	1. IssueStateInstance 模型新增 title（必填）和 description（可选）字段 2. 状态流转、批量创建、拒绝/重试均传递子任务标题与描述信息 3. 分解服务将计划项标题和说明存入初始状态内容
动态增加实例节点	支持运行中的工作流动态增加实例节点
AIKO 会话分享 facade	1. 新增 /api/session-shares 会话分享 API（create/get/download/incoming/outgoing/delete） 2. 能力式访问控制——任意登录用户凭有效 share_id 即可读取 3. 新增 InboxType.CONVERSATION_SHARED 通知类型 4. Owner 软删即刻使链接失效
用户参与特性查询	1. 扩展特性查询接口，从查询用户领导的特性扩展为查询与用户相关的特性（含历史参与） 2. 新增按优先级和标题搜索过滤功能 3. 实现用户工作区权限控制和查询范围限制
Kiosk 用户身份	1. 引入 KIOSK_USER_ID 常量标识匿名监视器终端身份 2. Core 操作权限从全局管理员调整为已登录用户，Kiosk 身份禁止访问核心操作 3. 前端侧边栏移除权限控制，所有登录用户均可访问 BiBrain Core

1.2 变更功能

模块	详情
工单模型迁移（Breaking）	工单存储从 Jira 线上格式迁移到来源中立 work-item/v1 信封；apply-plan 的 jira_data_id / jira_bound 更名 work_item_id / work_item_bound；旧 jira_raw_data 停写但保留（downgrade 一级可回滚）
状态机收敛（Breaking）	pending_confirmation 运行态移除，complete → completed 两段式；rejection_reason 列标注废弃不再写入，历史数据保留
技能存储库迁移	SkillRegistry 的 trusted_root 从 skills-aiko 迁移到 skills-core 目录；移除 bibrain-readonly 只读模式相关逻辑；operator 模式从 skills-core/bibrain-data 加载
aiko_core 默认启动模式	aiko_core 默认改为 local 启动，不再需要沙箱环境；更新 Dockerfile 与部署配置
圈复杂度专项整改	1. 新增本地圈复杂度闸门（tools/cc_report.py + baseline，只减不增）与 golden-master 表征测试基建（tests/_golden.py） 2. B1-B4 批次完成 20+ 个高复杂度函数改造：bibrain_ask 121→8、build_dashboard 70→7、build_history 55→3、build_brain_context 48→6、build_agent_summary 48→8 等 3. 新增 200+ golden 快照用例锁定行为，重构全程测试零改动
Jira 数据接口文档	补充 Jira 接口的搜索/筛选功能说明，新增类型选项、选择性删除、批量导入与调试清空接口文档，添加服务器源码部署更新说明

1.3 删除功能

模块	详情
expert_orchestration 模块	合并入 expert_agent 模块后删除独立的 expert_orchestration 包
bibrain-readonly 技能	移除 bibrain-readonly 只读模式相关的技能注册逻辑与测试
前端项目管理页	移除 Web 前端 ProjectManagement 页面
pending_confirmation 运行态	移除 Issue 状态机的 pending_confirmation 运行态及 confirm / request-changes 端点与相关死代码

1.4 修正Bug

模块	详情
Jira 子任务 ID	修复子任务 ID 重建功能，允许先上传子任务再上传父任务的场景
Jira 数据删除权限	移除 DEBUG 模式限制，生产环境可正常使用；权限从 admin 调整为成员级别
流转推荐	修复流转推荐需要任务完成的问题，流转推荐不再要求任务完成
工单 Feature 标题	修复工单派工时 Feature 标题落库为 JSON 原文的问题（改由 LLM 产出标题 + 兜底清洗，13 个新增用例）
专家 Agent 创建	修复新建专家 Agent 的 TypeError 与 500（补全 role_prompt / description / instructions 字段，恢复可信注入）
内核流错误	内核流错误无输出时自动重试并透传错误消息到 run（CORE_KERNEL_STREAM_RETRIES，已有输出的失败不重试）
Jira 版本覆盖	修复旧版本 Jira 数据静默覆盖新版本的问题（入库版本护栏，Last-Write-Wins）
任务导入	修复任务导入日期序列化失败、AI 解析草稿不持久化的问题
数据库迁移	修复 alembic 双 head 导致服务启动失败（合并 issue due reminders 与 task parse 两个 head，收敛为单一 head）
专家过滤	修复按专家过滤成果文件时历史 NULL 归属文件丢失的问题（兜底返回无归属文件）
Core 会话	修复专家 run 上传 public 工作区失败的鉴权问题（workspace_file 端点放行 Core 服务 superuser 身份）
性能	get_settings() 缓存避免每请求重新解析 .env；团队 AIKO 池轮询从 N 次请求合并为 1 次（消除 N+1）
CORS	放行 Tauri WebView 与浏览器 dev origin 跨域请求
GitLab 地址	点检仓库列表与数据源配置迁移到新 GitLab（192.168.20.26）

---

v3.0.3

发布日期：2026-08-07 本期主题：Issue 状态机与串行工作流 + Team 层级治理 + Core 动态 Skill + 文件空间命名链接 代码范围：v3.0.2-stable..9ff4117（develop / origin/develop） 当前状态：候选代码材料已更新，但后端全量回归仍有 P0 阻断，仅用于内部测试，暂不部署到生产环境。

1.1 新增功能

模块	详情
Issue 状态机与串行工作流（全新模块）	1. 新增 issue_state_chain / issue_state_instance 状态链模型，以不可覆盖的状态实例历史承载 Issue 当前状态、执行人、转换结果与审计信息 2. 新增状态命令 API：complete、reject、fail、retry、transfer、cancel，并使用 lock_version 防止并发重复转换 3. 新增 GET /api/issues/{issue_id}/state-chain 与 GET /api/agent/active-issue-state-instances，分别用于查看完整状态链和当前 Aiko 的活动工作项 4. 新增 POST /api/teams/{team_id}/features:batch-create，在单一事务内创建 Feature、严格串行的 Issue 链、依赖边、状态链及初始状态 5. 新增 Feature 工作流图接口与详情页图表，展示串行依赖、Issue 当前状态、执行人和完整状态历史
Team → Feature → Issue 层级治理（全新模块）	1. Feature 新增 team_id 与 feature_type，Issue 创建、列表与工作流操作统一校验 Team、Feature、Workspace 的归属一致性 2. Feature/Issue 列表新增 Team 范围筛选；前端手工创建 Issue 时 Feature 选项随 Team 联动，并过滤已完成或已取消 Feature 3. 已进入状态机管理的串行图禁止随意修改依赖或关键归属字段，避免运行中工作流被破坏
Core 动态 Skill	1. Core 会话支持查询可用 Skill、设置会话默认 Skill，以及在单次 Run 中显式覆盖可选 Skill 2. Run 创建时冻结 Skill 文件清单、版本与 digest；执行前重新校验文件大小和 hash，防止运行期间被静默篡改 3. 新增托管 Skill 管理目录及管理员 API，支持上传、版本更新、启用/禁用、软删除与恢复，并对内置 Skill 保持不可变保护 4. 前端新增 Core Skill 选择器和管理员 Skill 管理页面
文件空间命名链接	1. Workspace 与个人文件空间支持创建命名超链接；目录接口分别返回 folders、files、links，链接不占用文件存储 2. 命名链接支持更新、移动与软删除，并继承父目录的共享读写权限
迁移与部署保护	1. 新增历史 Alembic 分支顺序修复 runner，确保配置表创建迁移先于相关列重命名迁移 2. 新增一次性层级数据库重建保护：仅在显式开关、数据库名二次确认、指定前置 revision 且非系统数据库时允许重建 PostgreSQL public schema 3. Swarm 部署流程补充 heads、migrate、verify 门禁，要求业务容器部署前数据库 revision 与镜像中的唯一 head 完全一致

1.2 变更功能

模块

详情

破坏性变更（Breaking Changes）

1. 移除 issue.status 持久化列与旧状态合同：继续发送 status 或按旧状态字段筛选的客户端将失效，需改用 Issue State 命令 API，列表筛选改用 state_type，详情读取状态链 / current state 2. Feature/Issue 强化 Team 层级：跨 Workspace 的 Team/Feature 关联、缺少必要 Team 归属的创建请求会被拒绝，需发布前清理历史层级数据，客户端创建时先选 Team 再选同 Team 的 Feature 3. 串行状态机管理的图不可任意编辑：运行中修改依赖、Feature 归属或关键图字段会返回冲突/校验错误，须在原子 batch-create 阶段确定串行链，运行后通过状态命令推进 4. Core Run 固化 Skill manifest：修改 Skill 源文件不会影响已创建 Run，文件被篡改时 Run 会在注入前失败，Skill 变更必须发布新版本、不要原地修改已引用版本 5. 新增 6 个 Alembic 迁移：业务代码依赖状态链、托管 Skill 和层级字段，必须先单独提交/部署迁移，在服务器执行 alembic heads（唯一 head）与 alembic upgrade head 确认 revision 后再部署业务代码

1.3 删除功能

模块	详情
Issue 状态合同	移除 issue.status 持久化列与旧状态字段合同，状态改由 Issue State 状态链与状态命令 API 承载

1.4 修正Bug

模块	详情
Issue 创建	修复前端手工创建 Issue 时 Team/Feature 选择和请求合同不一致的问题
Issue 详情	修复 Issue 详情页执行人展示逻辑，优先使用当前状态实例的 executor 并提供兼容回退
数据库迁移	修复新数据库上历史配置迁移分支顺序导致的升级失败
文件空间	修复 Workspace 文件树命名链接与共享权限协同逻辑
文档一致性	更新 bibrain-service、bibrain-data Skill 与聚合 API 文档，使状态机与层级合同保持一致

1.5 验证结果与发布前置条件（2026-08-07）

项目	结果	结论
后端全量 pytest tests/ -q	1061 passed / 61 failed / 6 skipped（1128 collected）	未通过
v3.0.3 核心增量集合	89 passed	通过
前端 npm run test	24 files / 154 tests passed	通过
前端 npm run build	Vite 构建成功（主 chunk 约 2.95 MB）	通过
Alembic heads	e57672a20dca，单一 head	代码图通过；PostgreSQL 实库待验证
npm 依赖审计	2 moderate / 1 high	需安全评估与修复

后端 61 个失败集中在 Core 会话、Run 事件和 Skill 注册：内置 Skill 仍引用已删除的 skills-aiko/bibrain-data 目录，属于 P0 发布阻断。以下前置条件未完成前不建议正式发布：

1. 修正 Core 内置 Skill 根目录/迁移逻辑，确保不再引用已删除的 skills-aiko/bibrain-data，并重跑 Core 定向测试与后端全量测试至 0 failed。
2. pyproject.toml 仍声明 version = "3.0.2"、config.py 的 APP_VERSION 仍为 0.1.0，正式打标签前必须与 v3.0.3 对齐。
3. 处置 npm audit 报告的 2 个中危、1 个高危漏洞，并在依赖变更后重跑前端测试与构建。
4. 待部署制品再次执行 alembic heads 确认唯一 head；新增迁移必须独立于业务代码先行部署。
5. 目标 PostgreSQL 执行 alembic upgrade head 并核验 revision，再执行状态机、串行激活、Core Skill、命名链接与权限隔离 E2E。

1.6 版本升级操作指南

⚠️ 本期新增 6 个 Alembic 迁移，且已移除 issue.status 列，必须先单独部署迁移、确认数据库 revision 后再部署业务代码，切勿把迁移与业务代码同批上线。

1. 同步代码与依赖

   git fetch && git checkout develop && git pull
   uv sync

2. 先行部署数据库迁移（务必先于业务代码）

   uv run alembic heads          # 必须为唯一 head：e57672a20dca
   uv run alembic upgrade head   # 升级后核验数据库 revision

3. 确认数据库 revision 正确后，再部署依赖新表结构的业务代码

4. 前端构建

   cd web && npm install && npm run build

5. 发布后验证：执行状态机、串行激活、Core Skill、命名链接与权限隔离等 E2E

---

v3.0.2

发布日期：2026-07-17 | 迭代周期：W5 迭代 本期主题：集成配置中心 + 阿里云 AI 网关消费者治理 + 生产化部署 覆盖范围：BiBrain-Server（FastAPI后端）+ Web前端 + 生产部署（Podman 四机）

1.1 新增功能

模块	详情
集成配置中心（全新模块）	1. 统一集成配置页面：新增 Settings 侧集成配置页与配套 API，把第三方凭证、个人 MCP、OA 账号统一到配置中心管理 2. 个人 MCP 凭证管理：支持手填并加密存储钉钉（通讯录/日历/机器人）、GitLab、Gerrit、Jira、Redmine 等第三方凭证；敏感字段落 user_profile.secrets_enc（加密），非敏感项落 integrations（JSONB） 3. 飞书（Lark）OAuth 绑定：新增 /api/auth/lark/oauth（start/callback/disconnect）授权流程，一键绑定飞书用户令牌，供飞书 MCP 工具使用 4. 画像配置 Schema 接口：GET /api/auth/profile/schema 由后端字段定义驱动前端表单渲染（string/password/oauth/number/boolean），后端新增字段即自动出现在前端 5. 配置解析内部端点：POST /internal/config/resolve 供 Aiko 客户端用 PAT 拉取解密后的运行期配置（凭证/MCP URL）
OA 登录服务重构	1. OA 登录集成配置中心：重构 OA 登录服务，登录时自动把 OA 账号信息（oa_user_id/oa_password 等）合入用户画像配置，统一由配置中心承载 2. OA 登录接口协议修复对齐
阿里云 AI 网关治理（全新模块）	1. 消费者治理：/api/gateway 新增阿里云 AI 网关消费者管理——CRUD + 授权规则 + RBAC 门禁 + API Key 鉴权 2. ModelApi 列表与授权绑定：新增 GET /model-apis 与 POST /authorizations，service 层编排 + client 层扁平化嵌套 versioned_http_apis + 消费者×API 笛卡尔积原子批量绑定 3. 模型 API Key 绑定管理 4. 网关消费者管理前端：新增网关消费者管理控制台与前端客户端 5. 授权门禁：bibrain-core 调用功能接口的授权消费者校验与 RBAC 覆盖
中心智能 / 评估 / 大屏	1. 中心智能问答流式输出：BiBrain Core 问答改为流式（SSE）输出 2. Token 用量统计：更新工单类型定义并新增 token 用量统计，issue 汇总关联任务 token 总量 3. 运行时模型切换配置：新增 /api/admin/llm-config 管理端点，全局管理员在线查询/切换中心智能所用模型 4. 数据大屏打磨：本周任务、历史已完成、平均完成时间修正、排名、标题与配色等大量优化 5. 健康检查：新增 /api/health 健康检查端点
GitLab 集成	1. 新增 GitLab 评论转发接口 2. Webhook 接口兼容 GitLab 原始 payload 格式
部署	生产化 Podman 四机部署：新增 deploy/production/——入口机（Nginx/前端）+ 3 台后端副本 + PostgreSQL 的四机拓扑，含分服务 compose、Dockerfile、env 示例与部署指南

1.2 变更功能

模块	详情
破坏性变更（Breaking Changes）	1. 移除 Pillow 依赖：不再支持图片 OCR、图表内容识别或版式还原，文档解析仅保留文本/代码/Office/PDF 2. 移除 PyMuPDF（mupdf）依赖：PDF 解析改用 pypdf，复杂版式还原能力弱化，需重新执行 uv sync 3. OA 登录重构接入配置中心：OA 账号信息改由配置中心（user_profile.integrations/secrets_enc）承载，需运行本期迁移；老客户端沿用 device-login/login 不受影响 4. 新增阿里云 AI 网关治理：中心智能调用功能接口需通过网关消费者授权校验，需为中心智能配置对应消费者与授权规则

1.3 删除功能

模块	详情
图片解析依赖	移除 Pillow 依赖，下线图片 OCR、图表内容识别与版式还原能力
PDF 解析依赖	移除 PyMuPDF（mupdf）依赖，PDF 解析改用 pypdf，弱化高保真版式还原

1.4 修正Bug

模块	详情
数据大屏	修复大屏数据统计的 bug
依赖安全	修复软件包的高危漏洞（依赖升级）
阿里云 AI 网关	修正网关 model API 授权请求
OA 登录	修复 OA 登录服务接口协议
价值评估	保留评估指标成果物字段别名（deliverables alias）

1.5 各模块开发进度快照（W5）

模块	W4上期进度	W5本期进度
RBAC 权限体系	85%	88%
价值评估体系	80%	82%
BiBrain Core 中心智能	60%	70%（问答流式化 + 网关授权）
监控与仪表盘 / 数据大屏	70%	85%
集成配置中心	-	80%（全新模块）
阿里云 AI 网关治理	-	75%（全新模块）
IM 集成（飞书 / 钉钉）	-	55%（全新模块，飞书 OAuth + 钉钉 MCP 凭证）
生产化部署（Podman 四机）	-	80%（全新模块）

1.6 版本升级操作指南

1. 拉取代码

   git fetch && git checkout develop && git pull

2. 安装依赖（移除 Pillow / PyMuPDF，网关相关依赖）

   uv sync            # 或 pip install -e .

3. 数据库迁移

   alembic upgrade head

4. 配置集成中心与网关（可选）

   • 飞书绑定需在 .env 配置飞书应用 App ID / App Secret 与回调地址
   • 阿里云 AI 网关消费者治理需配置网关实例访问凭据
   • 中心智能运行时模型切换见 /api/admin/llm-config

5. 前端构建

   cd web && npm install && npm run build

6. 生产部署（可选，Podman 四机）：参考 deploy/production/README.md

---

v3.0.1

发布日期：2026-07-02 | 迭代周期：W4 迭代 本期主题：统一权限体系 + 价值评估闭环 + 中心智能落地 覆盖范围：BiBrain-Server（FastAPI后端）+ Web前端 + Aiko/中心智能Skill（bibrain-service / bibrain-data）

1.1 新增功能

模块	详情
权限与安全（全新RBAC权限体系）	1. 引入Casbin带域RBAC统一授权层，替换分散手写鉴权，统一权限点与角色矩阵 2. 注解式功能权限自动注册、支持功能分组批量赋权 3. workspace归属式数据门禁，统一资源所有权校验 4. 内置角色收敛：工作区owner等价admin，废弃per-ws g2角色投射；角色管理仅全局admin可操作 5. 重构管理员控制台双模式外壳，角色管理页新增角色删除入口 6. 新增「当前用户权限查询」「用户目录搜索」只读接口
价值评估系统（全新评估闭环模块）	1. 五维任务质量评估体系（交付/质量/效率/协作/自主性）+数字员工综合评分 2. 自动评估闭环：任务完成自动打分并回写用户画像，形成执行-评估-画像更新链路 3. 前端页面展示任务价值评估结果
BiBrain Core 中心智能（超级数字员工）	1. 首版中枢侧DeepAgents Agent，集成bibrain-service/data技能，标准后端API调用链路 2. Web端专属多轮对话交互页面 3. 新增2个全局信息查询接口支撑智能问答
Aiko 自主进化	Aiko进化产出按agent_id隔离存储至独立技能文件夹，配套存储接口与前端管理页面
监控与仪表盘V2（全新可视化模块）	1. 多维度数据分析面板：工作量、进度、Token消耗、Agent运行状态监控 2. 新版全局Dashboard，新增AI对话卡片、用户画像卡片，展示职位、技能、负载、可用性数据 3. 可配置数据库连接池监控指标
Wiki知识库（原knowledge重构）	1. 文件型Wiki架构：Issue附件统一单份存储并自动纳入知识库 2. Issue关闭后自动触发Wiki文档构建
工作区与协作增强	1. 新增管理员管理工作区全套接口与前端页面 2. 支持按需一键拉起多人协作群聊 3. 新增指定Issue执行过程、成果物查询接口 4. 全平台文件上传记录留存功能
Agent / Aiko 协作（原有能力迭代）	1. 高层聚合接口 bibrain_api：为 Aiko 提供面向场景的封装接口，减少多轮原子 API 调用 2. Agent 可视化监控：新增 Agent 监控页，支持画布拖拽、Issue 悬浮显示、实时日志展示 3. Aiko 完工/交付物提交流程：bibrain-http skill 新增成果物处理流程与完工总结评论模板，规范Aiko任务闭环 4. pm-assistant 一次性依赖设置：任务创建流程支持一次性配置依赖关系，简化 Aiko 编排 5. 废弃旧aiko-code-fixer技能，新增bibrain-data技能，负责数据统计、任务分解派发
Issue 协作（原有能力迭代）	1. Issue 依赖图谱：新增问题依赖图功能与依赖关系展示 2. 任务日期与计划属性：Issue 支持日期、计划属性 3. 批量操作与状态扩展：Issue 支持批量删除、维度发放约束、待确认状态 4. 代理分配显示优化：Issue 列表中 Agent 分配信息可视化增强 5. Issue评论/附件完整文件上传链路
基础设施	1. 数据库标准PostgreSQL，配套完整Alembic迁移脚本，本次新增casbin_rule权限表 2. 事务提交后WebSocket事件广播，保证多端数据一致性 3. 完善数据库连接池Metrics监控配置 4. 新增多类设计文档、验证报告归档规范
概念统一	业务层统一project替换为feature，全栈对齐研发语义，前后端、Skill同步适配建模约定
用户认证基础	OA登录、JWT鉴权、PAT令牌、OAuth集成
前端 Web 应用	全新升级：权限管理控制台、中心智能对话页、新版监控Dashboard、Wiki知识库、工作区管理、角色配置等页面全覆盖
Redmine / GitLab 集成	用户映射、项目/Issue 同步、Commit 查询

1.2 变更功能

模块

详情

破坏性变更（Breaking Changes）

1. Casbin为强制硬依赖，RBAC默认开启；未授权接口统一返回403，需执行数据库迁移+初始化管理员脚本 2. 角色体系重构：废弃per-ws g2角色，工作区owner等同于admin，旧多角色投射逻辑失效 3. 知识库模块重命名：路由由/api/knowledge改为/api/wiki，原知识相关接口全部迁移 4. 新增运行期依赖deepagents/langchain-openai/tavily-python/aiomysql/pymupdf，部署需重新执行uv sync/pip安装依赖 5. Aiko技能包调整，下线aiko-code-fixer，必须升级bibrain-service、bibrain-data技能包 6. 数据库由 SQLite 切换为 PostgreSQL：部署方式变更；连接串、迁移脚本均不兼容 7. project → feature 概念重命名：涉及 API、数据模型、前端路由 8. Aiko 完工流程移除 assignee 修改：旧版 Aiko 在完工时自动改 assignee 的逻辑被废弃 9. Issue 任务只能以"维度"发放：直接给 Aiko 派发非维度任务将被拒绝

1.3 删除功能

模块	详情
Aiko技能	下线旧版 aiko-code-fixer 技能包
权限逻辑	废弃各路由手写独立鉴权逻辑、废弃per-ws g2角色投射机制
知识库	废弃旧knowledge模块架构，统一迁移至wiki体系

1.4 修正Bug

模块	详情
价值评估模块	1. 修复Issue评估无法自动触发问题 2. 修复评估流程中Agent与用户身份混淆bug
知识库Wiki	修复文件构建状态显示异常问题
消息通知	修复任务派发后无通知推送问题
Aiko执行推送	修正Aiko实时推送执行过程逻辑
权限管控	修复ws-admin接口权限越权漏洞，叠加资源所有权校验闸门
BiBrain Core	优化更新核心模块全局错误捕获处理机制
显示问题	修复悬浮的 Issue 显示问题
Redmine 集成	修复 Redmine 创建同步问题
数据库	修复数据库相关bug，新增连接池监控
日志显示	显示日志改为使用真实数据，移除 mock
路由	修复路由刷新与匹配顺序问题
日期时间	统一处理日期时间的 UTC 时区转换
项目分配器	修复项目分配器禁用状态判断
缓存同步	优化删除操作后的缓存同步

1.5 各模块开发进度快照（W4）

模块	W3上期进度	W4本期进度
Agent (Aiko) 任务调度	85%	90%
实时通信与消息推送	80%	85%
知识库 / Wiki	65%	75%
前端 Web 应用	60%	75%
RBAC 权限体系	-	85%（全新模块）
价值评估体系	-	80%（全新模块）
BiBrain Core 中心智能	-	60%（全新模块）
Aiko 自主进化 (Evolution)	-	55%（全新模块）
监控与仪表盘 v2	-	70%（全新模块）

1.6 版本升级操作指南

1. 同步最新代码

   git fetch && git checkout develop && git pull

---

outline: deep

快速开始

BI Brain

BI Brain 是项目管理与协作平台，支持 Issue 依赖图谱、知识库 AI 语义检索、Aiko 协作等功能。

---

v3.0.0

发布日期：2026-05-29 | 基础版本：-

1.1 新增功能

模块	详情
Agent / Aiko 协作	1. 高层聚合接口 bibrain_api：为 Aiko 提供面向场景的封装接口，减少多轮原子 API 调用 2. Agent 可视化监控：新增 Agent 监控页，支持画布拖拽、Issue 悬浮显示、实时日志展示 3. Aiko 完工/交付物提交流程：bibrain-http skill 新增成果物处理流程与完工总结评论模板，移除 assignee 修改逻辑，规范 Aiko 任务闭环 4. pm-assistant 一次性依赖设置：任务创建流程支持一次性配置依赖关系，简化 Aiko 编排
Issue 协作	1. Issue 依赖图谱：新增问题依赖图功能与依赖关系展示 2. 任务日期与计划属性：Issue 支持日期、计划属性 3. 批量操作与状态扩展：Issue 支持批量删除、维度发放约束、待确认状态 4. 代理分配显示优化：Issue 列表中 Agent 分配信息可视化增强 5. 文件上传支持：Issue 评论/附件文件上传链路打通
知识库	1. 新增 knowledge 与 agent_file 数据模型 2. 知识库支持 AI 语义检索 + 大模型回答
基础设施	1. 数据库切换至 PostgreSQL：从 SQLite 迁移到 PostgreSQL，解决多 Aiko 并发心跳与消息流写锁瓶颈 2. 配套迁移脚本、部署脚本、数据导入脚本 3. 事务提交后广播：WebSocket 事件在事务提交后再广播，保证多端一致性 4. 人员名单导入脚本：支持从管理平台批量导入 5. 配置体系完善：数据库连接配置与环境变量更新
概念统一	1. Project → Feature 概念重构：业务层将 project 统一替换为 feature，对齐研发语义 2. bibrain-http skill 同步更新 Feature/Issue 建模约定与状态字段规范
用户认证与权限系统	OA 登录、JWT 鉴权、PAT 令牌、OAuth 集成
工作空间与项目管理	Workspace CRUD、成员邀请、Project 进度跟踪
服务端骨架	FastAPI + SQLAlchemy async + Alembic + SQLite WAL
前端 Web 应用	登录、Issue 列表/详情、项目管理、知识库、GitLab、Inbox
Redmine / GitLab 集成	用户映射、项目/Issue 同步、Commit 查询

1.2 变更功能

模块	详情
破坏性变更	1. 数据库由 SQLite 切换为 PostgreSQL：部署方式变更；连接串、迁移脚本均不兼容 2. project → feature 概念重命名：涉及 API、数据模型、前端路由 3. Aiko 完工流程移除 assignee 修改：旧版 Aiko 在完工时自动改 assignee 的逻辑被废弃 4. Issue 任务只能以"维度"发放：直接给 Aiko 派发非维度任务将被拒绝

1.3 删除功能

模块	详情
无	无

1.4 修正Bug

模块	详情
显示问题	修复悬浮的 Issue 显示问题
Redmine 集成	修复 Redmine 创建同步问题
数据库	修复数据库相关 bug
日志显示	显示日志改为使用真实数据，移除 mock
路由	修复路由刷新与匹配顺序问题
日期时间	统一处理日期时间的 UTC 时区转换
项目分配器	修复项目分配器禁用状态判断
缓存同步	优化删除操作后的缓存同步