brainsmatics 1.2.9 → 1.2.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -55,10 +55,13 @@ export default function App() {
55
55
  - 展示 3D 标准脑图谱。
56
56
  - 在同一个 Three.js 场景中展示脑区、核团、血管、神经元等对象。
57
57
  - 各场景共用的模型右键菜单仅在右击时打开,并保留当次模型的操作目标;从模型移入菜单后可正常选择。普通菜单在移出菜单卡片、选择菜单项或点击外部后关闭,带方位筛选的菜单改为点击外部、按 Esc 或选择普通菜单项关闭,避免嵌套下拉框交互被打断;重新悬停模型不会自动打开。
58
- - FBX 脑区模型右键菜单的 AI 分组显示“知识解释、连接查询、条件筛选、比较分析、环路探索、跨模态验证、研究规划、病毒注射”八个分类标题,不展示问题正文;点击标题后发送包含当前核团名称的对应问题。例如右击 OLF 的“病毒注射”发送“以 OLF 为靶点做自动病毒注射。”,坐标和路径继续由现有 AI 工作流处理。菜单支持视口边界避让及超高滚动。SWC 保留胞体位置、轴突投射、形态特征三个神经元专属问题;两类菜单均携带当次右击模型的名称/ID,中英文随全局语言切换。
59
- - FBX 核团菜单仅在 Knowledge 页签提供“查看上游核团”和“查看下游核团”,其他 Tab 不显示这两个入口,切走后旧菜单回调也不再执行。从当前 `soma_axon` 数据的胞体 `soma` 与轴突 `axon` 神经元 ID 交集推导核团(候选 `id=1`,排除自身),按共享神经元去重后的数量降序选择最多 10 个,同分保留数据顺序。新增模型使用连接展示的透明度,已显示模型不重复加载或隐藏,重复点击不会继续追加下一批。同步查询当前核团与这些核团的完整 `FunctionalCircuit` 数据,自动开启病毒示踪、MRI、电生理、光遗传、突触连接及接口返回的单神经元列表,不截断连接证据;没有证据的脑区对不编造连线。无匹配核团时提示,不用 `up/down` 神经元 ID 直接充当核团名称。
58
+ - FBX 脑区模型右键菜单的 AI 分组显示“知识解释、STAM anatomy、连接查询、条件筛选、比较分析、环路探索、跨模态验证、研究方案模拟、病毒注射”九个分类标题,不展示问题正文;点击标题后发送包含当前核团名称的对应问题。“STAM anatomy”明确调用 `stam-anatomy` 查询方位点、空间毗邻、层级与体积,区分空间毗邻和神经投射。“病毒注射”要求审查靶区、证据支持的规避约束和针道审计,并明确缺失数据或不可用的规划服务,不是自动执行注射或手术处方。菜单支持视口边界避让及超高滚动。SWC 提供胞体位置、轴突经过脑区、重建记录三个神经元专属问题;两类菜单均携带当次右击模型的名称/ID,中英文随全局语言切换。
59
+ - FBX 核团菜单仅在 Knowledge 页签提供“查看上游核团”和“查看下游核团”,其他 Tab 不显示这两个入口,切走后旧菜单回调也不再执行。每次操作仅向现有 `POST /FunctionalCircuit` 发送一次 `{"fbx":["当前核团"],"connection_direction":"upstream","include_self":true}` 或 `downstream` 方向请求,复用响应筛选核团、更新 Knowledge 和展示连接,不再对所选核团发起第二次分析请求。方向请求只返回病毒示踪、MRI、电生理、光遗传、突触的完整连接证据字段(包括目标核团自身证据),不返回 `swc_tree` 神经元或分子数据;上下游不依赖 `soma_axon`、`soma/axon` 神经元交集,也不把基因表达关联当作连接。按 `region_start_id` → `region_end_id` 判断方向,仅病毒示踪的 `direction` 去除首尾空格并转小写后为 `retrograde` 时反转端点,与现有箭头一致。选择邻居时排除自身及缺失/`Unknown` 端点,合并 `/` 与 `_` 名称别名,按连接证据条数降序选择最多 10 个核团,同分保留数据顺序;目标自身证据不占邻居名额。新增模型使用连接展示的透明度,已显示模型不重复加载或隐藏,重复点击不会继续追加下一批。初始上游仅显示其他已选核团 → 当前核团,下游仅显示当前核团 → 其他已选核团;默认关闭自身连接,不展示相邻核团之间的连接。所选脑区对的全部匹配证据均保留,自动开启这五类连接,不开启单神经元列表;没有证据的脑区对不编造连线,无匹配核团时提示。
60
+ - Connections of interest、“脑区”及五类连接证据面板仅提供中英文“核团自身连接”开关,不再显示连接范围选择器;注射、纯分子和单神经元面板不显示。普通连接视图默认开启自身连接,右键上下游默认关闭;开关只在本地即时更新列表及三维显示,不发 HTTP 请求,不开启已关闭的证据类型,也不恢复手动隐藏的非自身连接。未选择核团或正在分析时禁用开关。上下游方向仍由模型右键菜单查询控制,普通 Analyze、手动选择和 AI 查询保持原有显式触发流程,不因初次渲染或改选自动分析。
61
+ - “查看上下游核团”作为独立菜单分组,带分隔线和分组标题,位于普通模型操作之后、“询问 AI”之前。
62
+ - 模型右键菜单的操作项、链接和分组标题统一使用主题正文颜色、字体及字号,分组通过标题和分隔线区分,不以浅色文字区分。
60
63
  - 用户已开启连接显示时,FBX 右键菜单顶部提供独立的“方位筛选”区域,与模型操作和 AI 问题菜单分开。支持数据库 `relation.stam_direction_points.direction_points` 定义的全部 26 个方向(6 单向、12 双向、8 三向),使用可搜索的多选下拉框,按单一方位、双向组合、三向组合分组;列表限高 200px,超出内部滚动。已选条件最多显示两个标签,其余收为 `+N`,不再平铺全部选项。点击标题旁的说明按钮后,在筛选框下方展开自动换行的说明,再次点击收起;不使用会遮挡或被滚动容器裁切的悬浮提示,重新打开菜单时默认收起。说明按钮支持键盘操作及展开状态提示。选择立即生效,多选取并集;操作筛选时菜单不因鼠标移出而关闭,点击外部、按 Esc 或选择普通菜单项关闭。组合方向要求同一端点的同一方位短语包含全部分量,例如“背外侧”同时满足背侧和外侧,“吻背内侧”同时满足吻侧、背侧和内侧;分别选择“背侧”“外侧”仍是 OR,并不等于选择“背外侧”。删除最后一个标签或点击分组中的“清空”恢复原有连接选择,Knowledge 中的“取消连接筛选”入口保留。匹配仅使用当前核团端点的 `region_start_modifier` / `region_end_modifier`,支持英文连写、空格、连字符、下划线及中文组合,不用另一端修饰词、摘要、中心坐标或空间邻接关系推断。未标注方位或无法明确映射的解剖术语不归入所选方位。筛选同步更新证据列表与已开启类型的 3D 连线,不自动开启其他连接;Knowledge 显示当前条件及无匹配提示。后端继续使用配套 `Brain_lit/app.py` 的 `FunctionalCircuit` 完整响应字段。
61
- - 点击问题复用现有 AI 对话、登录和流式响应:登录后自动打开并发送,未登录时先保留问题并要求登录。已有请求、历史加载或待填表单时仅填入草稿,不打断当前操作。SWC 回答要求依据该神经元的真实数据,无法获取的测量不得以脑区常识替代。
64
+ - 点击问题复用现有 AI 对话、登录和流式响应:登录后自动打开并发送,未登录时先保留问题并要求登录。已有请求、历史加载或待填表单时仅填入草稿,不打断当前操作。脑区问题先核对标准全称和 ID,限制代表证据范围,区分有向投射、功能相关与机制推断,排除同缩写异脑区;没有检索到证据不等于证据不存在。SWC 胞体与轴突问题明确使用 `connectivity-query` 的 `soma_check.json` 中 `soma` / `axon` 字段,精确匹配神经元名称,区分祖先层级、轴突经过与末梢/突触靶点。“形态特征”入口改为“重建记录”,查询 `swc_tree.json` 的图谱、文件及元数据,不再承诺索引中不存在的形态测量。
62
65
  - 加载并展示 SWC 神经元形态数据;悬停时红色高亮,移至空白、其他神经元或画布外后恢复原色,快速移开同样生效。
63
66
  - SideBar 搜索支持脑区缩写、英文全名和中文名,不区分大小写,忽略首尾及重复空格,支持多个关键词;Neurons 的脑区选项和已选标签仅显示缩写与英文全名,搜索结果优先显示精确匹配。输入搜索词不会修改已选筛选条件。
64
67
  - Regions 搜索框内的 `Cc` 小图标用于切换严格匹配,悬浮显示说明,开启后高亮;严格模式仅完整匹配脑区缩写、英文全名或中文名(仍忽略大小写及多余空格)。原样式的放大镜按钮和回车均可立即执行搜索,修改文字仍自动搜索。Neurons 保持原来的下拉输入框样式,不显示 `Cc` 或额外搜索按钮,输入即搜索。
@@ -74,12 +77,19 @@ export default function App() {
74
77
  - 支持 TIFF 脑片图像配准相关工作流;atlas 模式移动面片后更新图谱切片,first/second 模式移动或旋转面片时保持上传图像不变。面片隐藏后再次显示仍保留该任务的平移、旋转和图像方向。Mouse Position 默认显示当前选中面片中心的 M-L、D-V、A-P 坐标,悬停其他模型时优先显示鼠标坐标。
75
78
  - 支持 TIFF 图像栈体积分析相关工作流。
76
79
  - 提供基于 Ant Design X 的 AI 对话界面,支持 Markdown、工具调用结果和图表结果展示。
80
+ - AI Assistant 主界面保留紧凑英文卡片,新增 **Viral injection**(`linear.viral-injection`,后端加载 `stam-injection-path-planning`),审查靶区、证据支持的规避约束与针道;是否能规划取决于实际服务与数据,不能将不可用结果编造成手术方案。
81
+ - **STAM anatomy** 案例卡位于 **Viral injection** 与 **Research design simulation** 之间,详情提供可点击的 VTA 空间解剖示例,选择后填入草稿而不自动发送。卡片使用 `linear.anatomy`,经后端 `anatomy` 路由加载已有 `stam-anatomy` skill,查询内部方位点、空间邻域、本体层级与半球体积;采用实际图谱来源与坐标单位,不把毗邻关系当投射连接。主界面现为九类卡片,模型右键问题继续复用现有登录、草稿和对话流程。
82
+ - **Research design simulation / 研究方案模拟** 保留 `linear.research-planner` 请求值,后端仅加载独立 `research-design-simulation` skill:对齐来源研究、校准证据等级、推演可证伪机制假说及针对性对照;不声称执行真实实验或数值模拟。其余类别 workflow 不变。
83
+ - 点击卡片仅选择输入框旁的 skill 标签;点击详情中的示例同时选择对应 skill 并填入草稿,不自动发送。卡片、详情、示例支持键盘,详情支持悬停和点击,Esc 可收起;实际发送的 `/app-api/langgraph-api/api/chat` JSON 使用所选 `workflow`。
77
84
  - 支持功能环路分析,包括连接关系、基因表达、突触、单神经元等数据展示。
78
- - Knowledge 的 Interest 卡片提供核团下拉框,复用当前脑区树,支持按缩写、英文全名和中文名搜索;每次选择添加一个核团并加载对应模型,可连续添加且不重复,仍可通过标签删除、清空或点击 Analyze 分析。已审核病毒注射路径保持只读,不显示该选择框。
85
+ - Knowledge 的 Interest 卡片提供核团下拉框,复用当前脑区树,支持按缩写、英文全名和中文名搜索;每次选择添加一个核团并加载对应模型,可连续添加且不重复,仍可通过标签删除、清空或点击 Analyze 分析。分析按钮点击后置灰且不可重复点击,感兴趣脑区列表更新后恢复可点击;分析请求进行中保持禁用。已审核病毒注射路径保持只读,不显示该选择框。
86
+ - 左侧脑区树勾选与 Interest 添加核团只更新选择和模型,不自动运行分析;普通分析由 Analyze 按钮触发。手动改选后,改选前未完成的右键上下游查询失效,迟到结果不会替换当前选择、启动旧核团分析或重新开启连接;显式右键上下游操作和 AI 查询仍可触发各自分析。
87
+ - Knowledge 的感兴趣核团气泡按当前 `linkRegions` 从脑区树读取颜色,不依赖模型是否已加载或已勾选。AI 查询先更新气泡、另一个 skill 稍后加载模型时,气泡仍立即显示核团自身颜色;此颜色更新不触发模型加载或分析。
88
+ - Knowledge 单神经元标题不再显示连接数量;原右下角说明图标移到标题文字右侧,沿用病毒示踪标题提示的大小、间距及橙色(`#d48806`),常态、悬停与键盘聚焦时保持一致,聚焦轮廓同色。列表保留虚拟滚动,实际滚动容器使用与其他连接卡片一致的滚动条宽度、轨道和滑块样式;滚动条贴齐卡片右侧,列表项自行保留内容留白,不再因外层左右 padding 内缩。
79
89
  - Knowledge 的病毒示踪、磁共振、电生理、光遗传、突触管道统一使用贝塞尔曲线。每条连接(含不同证据类型和反向连接)分配独立的螺旋偏移方向与幅度,避免同端点管道沿整条路径重合;同一展示周期内关闭再开启保留原偏移,清空展示后重新分配。保留共同端点,不保证任意视角下的二维投影无交叉;弧线仅表示脑区连接关系,不代表真实轴突轨迹或手术进针路径。
80
- - Knowledge 五类连接统一显示为细管道,保留 `TubeGeometry` 和证据数量到半径的映射 `min((10 + 证据数 × 5) × 0.0004, 0.01)`(单条证据半径 `0.006` 场景单位)。管道和箭头与对应类型卡片左侧圆点共用颜色(病毒标记绿、磁共振蓝、电生理紫、光遗传黄、突触粉),强度对应的透明度保持不变。管道与箭头支持悬停提亮、手势光标和点击文献,保留沿整条路径的宽不可见拾取区域。拖拽和隐藏连接不触发文献弹窗,无文献时显示空状态,支持点击 DOI 跳转。短距离连接缩短端点,非病毒坐标重合连接使用三次贝塞尔环;病毒同脑区或坐标重合时仍显示绿色点,不生成管道、箭头或注射器。
81
- - Knowledge 病毒标记保持原列表名称、气泡和样式:顺行显示 `→`,逆行(`Retrograde`)显示 `←`,三维箭头严格跟随列表方向,不根据注射点字段重新改变列表方向。同一脑区对的顺行、逆行分别统计证据、文献、强度并独立开关,每条连接只有一个箭头。标题感叹号仍显示原提示“左侧为靶点,右侧为注射点”,中英文保持原文。
82
- - Knowledge 磁共振保持原来的单张“磁共振 / MRI”卡片、脑区对名称、`modality_end` 气泡及配色,不追加 A/B、结构性/功能性或实线/虚线说明文字。内部按“脑区对+`modality_type`”分别统计并控制连接:`A` 为结构性实线细管道,`B` 为功能性虚线细管道(沿弧长移除部分管道面形成真实间隔)。同一脑区对的两类证据为独立列表记录和错开的三维管道,单项开关各自独立,原卡片总开关同时控制两类;未知或缺少类型不根据 `modality` 文本猜测为 A/B。
90
+ - Knowledge 五类连接统一显示为细管道,保留 `TubeGeometry` 和证据数量到半径的映射 `min((10 + 证据数 × 5) × 0.0004, 0.01)`(单条证据半径 `0.006` 场景单位)。管道和箭头与对应类型卡片左侧圆点共用颜色(病毒标记绿、磁共振蓝、电生理紫、光遗传黄、突触粉),强度对应的透明度保持不变。管道与箭头支持悬停提亮、手势光标和点击文献,保留沿整条路径的宽不可见拾取区域。拖拽和隐藏连接不触发文献弹窗,无文献时显示空状态,支持点击 DOI 跳转;卡片和三维连接打开的文献面板均显示对应证据类型。短距离连接缩短端点,非病毒坐标重合连接使用三次贝塞尔环;病毒同脑区或坐标重合时仍显示绿色点,不生成管道、箭头或注射器。
91
+ - Knowledge 病毒标记保持原列表名称、气泡和样式:顺行显示 `→`,逆行(`Retrograde`)显示 `←`,三维箭头严格跟随列表方向,不根据注射点字段重新改变列表方向。同一脑区对的顺行、逆行分别统计证据、文献、强度并独立开关,每条连接只有一个箭头。标题感叹号提示“左侧为注射点,右侧为靶点”,支持中英文。
92
+ - Knowledge 磁共振保持单张“磁共振 / MRI”卡片、脑区对名称、`modality_end` 气泡及配色;标题注解说明“实线代表结构性连接,虚线代表功能性连接”,支持悬停和键盘聚焦查看。内部按“脑区对+`modality_type`”分别统计并控制连接:`A` 为结构性实线细管道,`B` 为功能性虚线细管道(沿弧长移除部分管道面形成真实间隔)。同一脑区对的两类证据为独立列表记录和错开的三维管道,单项开关各自独立,原卡片总开关同时控制两类;未知或缺少类型不根据 `modality` 文本猜测为 A/B。
83
93
  - Knowledge 页签跟随全局语言(`en_us` / `zh_cn`)显示中英文:包括脑区选择提示、分析按钮、证据类型、分子指纹/连接卡片、图例、统计、悬浮说明及证据来源弹窗;脑区标识、基因/受体名称和文献内容保持原始数据。
84
94
  - Knowledge 基因分布按“基因名(不区分大小写)+脑区”过滤重复圆球和标签;保留原有圆球材质、颜色、透明度和立体文字,标签仍选取该组有 DOI 且影响因子最高的文献。
85
95
  - 文献文字不再显示“双击查看”悬浮提示;双击 DOI 跳转保持不变。
@@ -88,11 +98,20 @@ export default function App() {
88
98
  - Knowledge 子项小眼睛、类型总开关及 AI 展示共用同一份选中状态:单次操作不会重复绘制,AI 展示后可直接用小眼睛关闭。神经递质/受体分布与突触连接独立控制,关闭一类不会改变另一类。
89
99
  - Knowledge 基因/受体总开关和 AI 多名称展示按类型批量调用 `ExpressionSearch`,不再逐名称并发或串行请求;基因与受体仍分开查询。批量结果可供后续单项和子集复用,重叠在途查询只补取缺失名称,缓存按类型与排除脑区隔离。连接展示复用已有分析数据,不逐条补发请求。
90
100
  - 分析、连接展示及基因/受体预览复用现有 Loading 遮罩;并发或嵌套加载全部结束后才收起,失败时释放 loading 并提示错误。关闭或清空展示会取消在途预览,迟到的数据不会重新显示。
91
- - `FunctionLoop` controller 的 `loadMethodData`、`previewGene`、`previewReceptor` 返回 `Promise<void>`,调用方应等待展示完成并处理失败;`previewGene` / `previewReceptor` 的首参支持单个名称或名称数组。`removeGroupData` 同时更新场景与开关状态;批次中关闭单项不影响其余项,关闭全部则取消该批次的展示等待。
101
+ - `FunctionLoop` controller 的 `triggerAnalysis`、`loadMethodData`、`previewGene`、`previewReceptor` 返回 `Promise<void>`,调用方应等待完成并处理失败。`triggerAnalysis(overrideRegions?, suppliedData?: FunctionLoopData)` 可传入已取得的数据,内外 controller 均透传第二参数;提供数据时仍执行清空旧展示、记录已提交核团、更新目标核团及取消旧请求等分析生命周期,但直接更新面板,不读缓存、不发请求,也不将方向性局部结果写入普通查询缓存。仅传核团或不传参数时保留普通分析的缓存与请求流程。`previewGene` / `previewReceptor` 的首参支持单个名称或名称数组。`removeGroupData` 同时更新场景与开关状态;批次中关闭单项不影响其余项,关闭全部则取消该批次的展示等待。
92
102
  - AI 对话通过 `brain-3d-commander` 的结构化 `circuit_panel` 自动更新 Knowledge:标题按意图显示“脑区”“连接关系”“病毒注射”,或现有的病毒标记、电生理、光遗传、磁共振、突触、基因、神经递质/受体、单神经元分类。脑区列表来自 `region_ids`,不依赖 `highlight_region`;连接聚焦不高亮脑区时也能更新面板。
93
103
  - `circuit_panel` 示例:`{"category":"connections","region_ids":["VTA","ACB"]}`。可选 `connections:[{"source_id":"VTA","target_id":"ACB"}]` 仅用于已核验方向;不确定方向时省略,面板保留查询脑区间两个方向的证据。`GeneExpression` / `Neurotransmitter` 可携带 `gene_names` / `receptor_names` 复用现有预览。
94
104
  - 注射分类仅展示真实 `injection_path` 的靶点、进针端点、规避核团和穿经结构,坐标使用 STAM `[ML, DV, AP]`、10 μm 体素;缺少审计结果时明确显示不可用,不以连接证据代替手术针道,也不自动运行普通环路分析。
95
105
  - 异步模型勾选不会覆盖 AI 当前查询;手动勾选脑区树恢复“脑区”模式。切换历史会话恢复最近一条结构化面板指令;旧历史没有该字段时不从正文推测。
106
+ - AI 结果包含已审核 `injection_path` 时优先保留 Virtual surgery,不因同时携带 `circuit_panel` 而跳转 Knowledge、清空针道;注射分类更新只读面板数据,不强制切页。其他分类且无注射路径时默认打开 Knowledge。实时结果与历史会话恢复共用此规则。
107
+
108
+ ### AI 快捷问题实测边界(2026-11-13)
109
+
110
+ - 已用真实 `/api/chat`、`router` 工作流逐项测试 11 类中文问题及替换问题;脑区示例为 STAM `LH`(缰外侧核,ID 718),单神经元示例为 `16167_1`,另测了后端索引缺失的 `16146_1`。HTTP 200 或存在 DOI 不作为科学正确性通过标准。
111
+ - 调整后的胞体问题查得 `16167_1 → MOs5`,与仓库胞体标注一致;轴突问题取得该细胞的脑区记录,但回答的层级归并和汇总仍需核对。重建记录问题查得真实 STAM 文件路径及空缺元数据;后端未读取重建文件,未验证轴突长度、树突或分支测量。英文文案同步,未逐项执行英文模型验证。
112
+ - 连接查询替换问题可以完成有限输入/输出表,但文献归属仍需人工复核;比较分析替换问题可以返回比较结果,但仍有把电生理/基因证据当作直接投射的问题。病毒注射现有问题取得同次 `compute` / `findn` 及结构化 `injection_path`,仅验证当前约束下的规划链路,不表示手术安全或全部文字解释正确。
113
+ - 知识解释、条件筛选、环路探索、跨模态验证、研究方案的严格替换文案均已重测,仍出现 240 秒内无最终回答;原回答还出现 LH/LHA 混淆、投射方向反写和不相关文献。源码已收紧问题范围与证据要求,但这些类别**尚未通过正确性验证**,不能宣称仅靠修改问题已修复后端检索/推理。
114
+
96
115
 
97
116
  ## 主要导出
98
117
 
@@ -353,15 +372,17 @@ npm run storybook
353
372
 
354
373
  也可使用 `bun run storybook`。Storybook 会自动发现 `.storybook/middleware.js` 并加载 API 代理,无需在 `.storybook/main.ts` 中导入或注册;代理仍使用 CommonJS,已有环境变量覆盖和 WebSocket 路由保持不变。
355
374
 
375
+ AI 主界面独立预览:打开 **3D → AiViewer → Open Panel**(`http://localhost:6006/?path=/story/3d-aiviewer--open-panel`,纯画布为 `/iframe.html?id=3d-aiviewer--open-panel&viewMode=story`)。此故事直接挂载真实组件并展开面板,不需要加载整个 3D 工作台;登录、会话和发送仍依赖真实代理/后端,不伪造成功响应。
376
+
356
377
  ### 组件故事的组织方式
357
378
 
358
379
  - `.storybook/main.ts`:类型化的 ESM 配置,加载 React Vite 框架、Docs 和 MSW 插件;监视器排除 `dist`、`storybook-static` 等产物,避免 Windows 上并行构建触发文件锁错误。
359
380
  - `.storybook/preview.tsx`:统一 Ant Design 主题、目录排序和 MSW 2 worker;不再修改原生 `Headers`。
360
381
  - `src/component/**/组件名.stories.tsx`:与组件同目录的 CSF3 示例,按 `Charts`、`2D`、`3D`、`Common` 分类。
361
- - `src/demos/`:完整工作台及图谱演示,统一归入 `Demo`;查看器故事的场景包装也放在这里,不进入组件库构建。
382
+ - `src/demos/`:不进入组件库构建的演示与开发工具;完整工作台及图谱演示归入 `Demo`,语言包编辑工具归入 `Common/LanguageEditor`。
362
383
  - `Meta` / `StoryObj` 从 `@storybook/react-vite` 导入;回调使用 `storybook/test` 的 `fn()`,交互使用同一入口的测试工具。Controls、Actions、Interactions 已由 Storybook 内置,无需旧版 Essentials / Interactions 插件。
363
384
 
364
- 现有 28 组组件及演示文档包含 73 个故事。静态图表示例可通过 Controls 修改参数;Carddata 的授权、查询失败、克隆权限和披露级别等场景使用 MSW 本地响应。新增示例沿用上述目录和 CSF3 格式。
385
+ 组件及演示故事中,静态图表示例可通过 Controls 修改参数;Carddata 的授权、查询失败、克隆权限和披露级别等场景使用 MSW 本地响应。新增示例沿用上述目录和 CSF3 格式。
365
386
 
366
387
  更新 MSW worker:
367
388
 
@@ -377,6 +398,16 @@ npm run init-msw
377
398
  npm run build-storybook
378
399
  ```
379
400
 
401
+ ### 中英文语言包可视化编辑
402
+
403
+ - 启动 Storybook 后打开 **Common → LanguageEditor → Default**(`?path=/story/common-languageeditor--default`)。
404
+ - 编辑页使用视口高度的独立滚动容器,不受其他 Story 遗留的 `body { overflow: hidden }` 影响;支持鼠标滚轮,Tab 聚焦编辑页后可用键盘滚动,页面底部可访问分页与导出操作。
405
+ - 中英文按 Key 并排展示;支持搜索 Key/文案、Key 前缀分组、缺失翻译/已修改/占位符差异筛选。点击“编辑”同时修改两种语言,或通过“新增词条”添加唯一 Key;已有 Key 不可重命名。
406
+ - “保存到草稿”仅保存到当前浏览器的 localStorage,刷新后可恢复,不改变运行中的 i18n 资源。可撤销单条修改或确认清空全部草稿;草稿写入失败会提示,请及时导出。
407
+ - 分别导出 `zh_cn.json`、`en_us.json` 后,替换 `src/component/util/` 中的同名文件。导出始终包含完整语言包,不受筛选影响,保留未修改的单侧缺失 Key、多行文本及插值占位符。
408
+ - Chrome / Edge 的 localhost 或 HTTPS 环境可点击“写回语言包”,确认后授权选择 `src/component/util` 目录。目录必须已包含两个同名 JSON 文件;该操作覆盖文件,建议先提交或备份。两文件并非原子写入,若部分失败会提示已写入的文件,可重新写回或导出补齐。写回后草稿仍保留,需手动清空。
409
+ - 普通 HTTP 局域网地址或不支持目录授权的浏览器使用 JSON 导出;无需新增后端接口或依赖。
410
+
380
411
  ## 发布
381
412
 
382
413
  当前包发布到 npm 的包名是:
@@ -53,12 +53,13 @@ interface DataTypeButton {
53
53
  hasData: boolean;
54
54
  }
55
55
  type WorkflowType = 'router' | 'linear' | SkillWorkflowType;
56
- type SkillWorkflowType = 'linear.knowledge-explainer' | 'linear.connection-finder' | 'linear.conditional-filter' | 'linear.comparative-analyzer' | 'linear.circuit-explorer' | 'linear.cross-modal-validator' | 'linear.research-planner';
56
+ type SkillWorkflowType = 'linear.knowledge-explainer' | 'linear.anatomy' | 'linear.connection-finder' | 'linear.conditional-filter' | 'linear.comparative-analyzer' | 'linear.circuit-explorer' | 'linear.cross-modal-validator' | 'linear.viral-injection' | 'linear.research-planner';
57
57
  interface LangGraphSendParams {
58
58
  message: string;
59
59
  sessionId: string | null;
60
60
  workflow: WorkflowType;
61
61
  signal: AbortSignal;
62
+ retry?: boolean;
62
63
  onStart?: () => void;
63
64
  onText?: (delta: string) => void;
64
65
  onTool?: (tool: ToolCall) => void;
@@ -8,6 +8,7 @@ export interface LiteratureModalProps {
8
8
  open: boolean;
9
9
  onCancel: () => void;
10
10
  title?: string;
11
+ evidenceType?: string;
11
12
  literature?: LiteratureItem[];
12
13
  }
13
14
  export declare const LiteratureModal: React.NamedExoticComponent<LiteratureModalProps>;
@@ -1,20 +1,22 @@
1
+ import type { FunctionLoopData } from '../../store/functionLoopStore';
1
2
  export type ConnectionDirection = 'upstream' | 'downstream';
3
+ export interface DirectionalConnectionFilter {
4
+ region: string;
5
+ direction: ConnectionDirection;
6
+ }
2
7
  export declare const MODEL_CONNECTION_COMPARTMENTS: readonly ["dorsal", "ventral", "rostral", "caudal", "medial", "lateral", "dorsal_medial", "dorsal_lateral", "ventral_medial", "ventral_lateral", "rostral_dorsal", "rostral_ventral", "rostral_medial", "rostral_lateral", "caudal_dorsal", "caudal_ventral", "caudal_medial", "caudal_lateral", "rostral_dorsal_medial", "rostral_dorsal_lateral", "rostral_ventral_medial", "rostral_ventral_lateral", "caudal_dorsal_medial", "caudal_dorsal_lateral", "caudal_ventral_medial", "caudal_ventral_lateral"];
3
8
  export type ModelConnectionCompartment = typeof MODEL_CONNECTION_COMPARTMENTS[number];
4
9
  export interface ModelConnectionFilter {
5
10
  region: string;
6
11
  compartments: ModelConnectionCompartment[];
7
12
  }
8
- interface RegionNeurons {
9
- soma: string[];
10
- axon: string[];
11
- id: number;
12
- }
13
+ export declare function isSelfConnection(value: unknown): boolean;
14
+ /** Return the opposite endpoint only for a direct edge in the displayed direction. */
15
+ export declare function getDirectionalConnectionRegion(value: unknown, method: string, filter: DirectionalConnectionFilter, includeSelfConnections?: boolean): string | null;
13
16
  /**
14
- * Use neuron membership, not the legacy up/down fields. Return at most ten
15
- * regions ranked by unique shared neuron count; ties retain data order.
17
+ * Rank direct connection endpoints by evidence count, not neuron membership.
18
+ * Match the displayed direction, including reversed retrograde tracing.
16
19
  */
17
- export declare function getConnectedRegions(connections: Record<string, RegionNeurons>, region: string, direction: ConnectionDirection): string[];
20
+ export declare function getConnectedRegions(connections: FunctionLoopData, region: string, direction: ConnectionDirection): string[];
18
21
  /** Match any selected internal orientation at the clicked raw endpoint only. */
19
22
  export declare function matchesModelConnection(value: unknown, filter: ModelConnectionFilter): boolean;
20
- export {};
@@ -1,6 +1,7 @@
1
1
  import React from "react";
2
2
  import type { SequenceLivePose, SequenceVolumeGeometry } from "./stamPlane";
3
3
  import type { SequenceDisplayMode, SequenceSlice, SequenceTransform, SequenceTransformMode } from "./types";
4
+ import type { SequenceMatchCandidate, SequenceMatchResult, SequenceMatchSection } from "./matching";
4
5
  import "./index.css";
5
6
  interface Props {
6
7
  onShowSlice?: (slice: SequenceSlice, mode: SequenceDisplayMode) => void | Promise<void>;
@@ -17,6 +18,8 @@ interface Props {
17
18
  }) => SequenceLivePose | null;
18
19
  onGetLivePose?: (sliceId: string) => SequenceLivePose | null;
19
20
  onBusyChange?: (busy: boolean) => void;
21
+ onPreviewMatch?: (slice: SequenceSlice, result: SequenceMatchResult, section: SequenceMatchSection) => SequenceMatchCandidate;
22
+ onApplyMatch?: (slice: SequenceSlice, candidate: SequenceMatchCandidate) => void;
20
23
  }
21
24
  declare const SequenceRegistrationPanel: React.FC<Props>;
22
25
  export default SequenceRegistrationPanel;
@@ -3,7 +3,7 @@ export declare function configureSequenceConnection(token: unknown, loginId: unk
3
3
  export declare function clearSequenceConnection(): void;
4
4
  export declare function sequenceAuthToken(): string;
5
5
  export declare function sequenceRequest<T>(path: string, init?: RequestInit): Promise<T>;
6
- export declare function sequenceImageBlob(url: string): Promise<Blob>;
6
+ export declare function sequenceImageBlob(url: string, signal?: AbortSignal): Promise<Blob>;
7
7
  export declare function sequenceTiffPreviewBlob(url: string): Promise<Blob>;
8
8
  export declare const listSequenceSessions: () => Promise<SequenceSession[]>;
9
9
  export declare const getSequenceSession: (id: string) => Promise<SequenceSession & {
@@ -0,0 +1,26 @@
1
+ import type { SequenceLivePose } from "./stamPlane";
2
+ import type { SequenceSlice, SequenceTransform } from "./types";
3
+ export type SequenceMatchInput = "Config_DAPI.ini" | "Config_PI.ini" | "Config_Mask.ini";
4
+ export type SequenceMatchSection = 0 | 1 | 2;
5
+ export interface SequenceMatchResult {
6
+ tx: number;
7
+ angles: [number, number, number];
8
+ preview?: string;
9
+ }
10
+ export interface SequenceMatchCandidate {
11
+ pose: SequenceLivePose;
12
+ transform: SequenceTransform;
13
+ }
14
+ export interface SequenceMatchProgress<T> {
15
+ status: "matching" | "ready" | "error" | "saved";
16
+ value?: T;
17
+ error?: string;
18
+ }
19
+ /** The existing calculation service is shared: process one original TIFF at a time. */
20
+ export declare function runSequenceMatchBatch<T>(slices: readonly SequenceSlice[], signal: AbortSignal, calculate: (slice: SequenceSlice, signal: AbortSignal) => Promise<T>, update: (sliceId: string, state: SequenceMatchProgress<T>) => void, timeoutMs?: number): Promise<void>;
21
+ export declare function readSequenceMatchResult(value: unknown): SequenceMatchResult;
22
+ /** Use the same reference bounds and local-axis rotation order as 2D Registration.insertInto3d. */
23
+ export declare function sequenceMatchTransform(result: SequenceMatchResult, section: SequenceMatchSection): Pick<SequenceTransform, "position" | "quaternion">;
24
+ export declare function sequenceMatchSnapshot(slice: SequenceSlice, pose: SequenceLivePose | null | undefined): string;
25
+ /** Send the original TIFF through the existing 2D Registration service, never a rendered Label preview. */
26
+ export declare function calculateSequenceMatch(file: Blob, filename: string, input: SequenceMatchInput, section: SequenceMatchSection, signal: AbortSignal, request?: typeof fetch): Promise<SequenceMatchResult>;
@@ -1,6 +1,6 @@
1
1
  import { type StateUpdate } from "./stateUpdate";
2
2
  import type { InjectionPath } from "../3d/injectionPath";
3
- import { type ModelConnectionFilter } from "../3d/functionLoop/modelConnectionFilter";
3
+ import { type DirectionalConnectionFilter, type ModelConnectionFilter } from "../3d/functionLoop/modelConnectionFilter";
4
4
  export type FunctionLoopPanelCategory = "brain_regions" | "connections" | "injection" | "ViralTracing" | "Electrophysiology" | "Optogenetics" | "MRI" | "Synapse" | "GeneExpression" | "Neurotransmitter" | "swc_tree";
5
5
  /**
6
6
  * The analysis payload keyed by connection method. Structurally the
@@ -16,6 +16,8 @@ export interface FunctionLoopPanelFilter {
16
16
  source_id: string;
17
17
  target_id: string;
18
18
  }>;
19
+ directionalConnectionFilter?: DirectionalConnectionFilter | null;
20
+ includeSelfConnections?: boolean;
19
21
  }
20
22
  /** Derive a panel view without truncating evidence or changing the shared raw data. */
21
23
  export declare function filterFunctionLoopData(data: FunctionLoopData, filter: FunctionLoopPanelFilter): FunctionLoopData;
@@ -30,7 +32,7 @@ export type FunctionLoopFilterGroup = {
30
32
  export interface FunctionLoopController {
31
33
  clearFunctionLoopData(): void;
32
34
  removeGroupData(id: string, groupName?: string): void;
33
- triggerAnalysis(overrideRegions?: string[]): Promise<void>;
35
+ triggerAnalysis(overrideRegions?: string[], suppliedData?: FunctionLoopData): Promise<void>;
34
36
  loadMethodData(id: string, filterGroup?: FunctionLoopFilterGroup | null, externalData?: unknown): Promise<void>;
35
37
  previewGene(geneName: string | string[], excludeRegions?: string[]): Promise<void>;
36
38
  previewReceptor(receptorName: string | string[], excludeRegions?: string[]): Promise<void>;
@@ -39,7 +41,7 @@ export interface FunctionLoopController {
39
41
  export interface FunctionalAnalysisController {
40
42
  clearDisplay(): void;
41
43
  removeGroupData(id: string, groupName?: string): void;
42
- triggerAnalysis(overrideRegions?: string[]): Promise<void>;
44
+ triggerAnalysis(overrideRegions?: string[], suppliedData?: FunctionLoopData): Promise<void>;
43
45
  loadMethodData(id: string, filterGroup?: FunctionLoopFilterGroup, externalData?: unknown): Promise<void>;
44
46
  previewGene(geneName: string | string[], excludeRegions?: string[]): Promise<void>;
45
47
  previewReceptor(receptorName: string | string[], excludeRegions?: string[]): Promise<void>;
@@ -71,12 +73,20 @@ export declare class FunctionLoopStore {
71
73
  selectedMethods: string[];
72
74
  private loadingCount;
73
75
  modelConnectionFilter: ModelConnectionFilter | null;
76
+ directionalConnectionFilter: DirectionalConnectionFilter | null;
77
+ includeSelfConnections: boolean;
78
+ private molecularData;
79
+ setIncludeSelfConnections(include: boolean): void;
80
+ setDirectionalConnectionFilter(filter: DirectionalConnectionFilter | null): void;
74
81
  get hasDisplayedConnections(): boolean;
75
82
  setModelConnectionFilter(filter: ModelConnectionFilter | null): void;
76
83
  get isLoading(): boolean;
77
84
  /** Use the same selection for the heading and the cards below it. */
78
85
  get panelTitleKey(): string;
79
86
  isPanelMethodVisible(id: string): boolean;
87
+ /** Molecular distributions do not inherit connection-direction or self-edge filters. */
88
+ get molecularSourceData(): FunctionLoopData;
89
+ setMolecularSourceData(data: FunctionLoopData): void;
80
90
  get connectionSourceData(): FunctionLoopData;
81
91
  get functionLoopData(): FunctionLoopData;
82
92
  get expandedViralItems(): Set<string>;
@@ -1,4 +1,5 @@
1
1
  import type { FunctionLoopData } from '../store/functionLoopStore';
2
+ import type { ConnectionDirection } from '../3d/functionLoop/modelConnectionFilter';
2
3
  /** Region/name lists are sets for these endpoints. Preserve identifier case. */
3
4
  export declare const normalizeRegionIds: (values: string[]) => string[];
4
5
  export declare const getStableRegionIdsKey: (regionIds: string[]) => string;
@@ -7,6 +8,7 @@ export interface BrainRegionRadarItem {
7
8
  [key: string]: unknown;
8
9
  }
9
10
  export declare function fetchFunctionalCircuitData(regionIds: string[], signal?: AbortSignal): Promise<FunctionLoopData>;
11
+ export declare function fetchDirectionalCircuitData(region: string, direction: ConnectionDirection, signal?: AbortSignal): Promise<FunctionLoopData>;
10
12
  export declare function getCachedFunctionalCircuitData(regionIds: string[]): FunctionLoopData | undefined;
11
13
  /** Already supplied AI results can also serve charts and subsequent panel selections. */
12
14
  export declare function cacheFunctionalCircuitData(regionIds: string[], data: FunctionLoopData): void;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./index-Vl_BECD1.js"),t=require("./basedecoder-CsHP9rmG.js");class d extends t.BaseDecoder{decodeBlock(e){return r.inflate_1(new Uint8Array(e)).buffer}}exports.default=d;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./index-D8zSo9ek.js"),t=require("./basedecoder-CsHP9rmG.js");class d extends t.BaseDecoder{decodeBlock(e){return r.inflate_1(new Uint8Array(e)).buffer}}exports.default=d;
@@ -1,4 +1,4 @@
1
- import { i as r } from "./index-DXi3wJl5.mjs";
1
+ import { i as r } from "./index-B4durbpc.mjs";
2
2
  import { B as a } from "./basedecoder-PoXbLGBV.mjs";
3
3
  class s extends a {
4
4
  decodeBlock(e) {