DSH Plugins Marketplace

DSH Plugins

Plugins

/

fish-body

f

fish-body

Manifest valid★ 1

The "Body" Layer of the DSH Agent Framework: Meal → Stomach → Hand Process Entry, Directory Viewing, Body Switch, and the SHA-256 Tool That Is Only Mounted When Enabled

UI (client)hasBundlePatch

fish-body(鱼的身体)

源码分析与按需取证(0.0.6)

本版新增 fish_hand 的 analyze / query 动作;submit/review/approve/reject/status 和安装决定沿用原有语义。正式来源为 github:2233heorbrin/fish-body#v0.0.6, 交给 DSH 原生插件管理安装。运行实现及依赖与已验收测试版 0.0.6-dev.1 (提交 33e8a793dd5eee6c3c60f23a36977d3f5c21b382)一致,仅整理版本和发布说明。 该测试版已通过真实 DSH 对话的工具可见性、初扫、关联深查、分页查询和有效复用验收; 深查保留 7 项关系不完整。此处复用测试版证据,不声称正式版已重新调用模型。 仅用户明确请求分析时启动独立 Node 子进程,不执行候选入口、可执行配置、构建、 安装脚本或模型请求。启用身体、status、query 均不启动深查;身体关闭或 closing 时拒绝新动作,已接纳操作按现有在途机制收尾。

对话工具参数示例(path 由用户明确指定源码目录的绝对路径):

{"action":"analyze","analysisType":"initial","analysisSource":{"kind":"local","path":"<absolute-source-directory>"}}

返回 analysisId 后按需读取,而非把完整分析 JSON 注入对话:

{"action":"query","analysisId":"<returned-id>","queryType":"summary","queryOptions":{"limit":5}}
{"action":"query","analysisId":"<returned-id>","queryType":"file","queryOptions":{"file":"index.js","line":10}}
{"action":"query","analysisId":"<returned-id>","queryType":"evidence","queryOptions":{"id":"initial/E0001","limit":3}}
{"action":"query","analysisId":"<returned-id>","queryType":"capability","queryOptions":{"name":"<candidate-name>"}}
{"action":"query","analysisId":"<returned-id>","queryType":"phase","queryOptions":{"function":"apply","stage":"用户指定的注册阶段问题"}}

evidence 使用返回的完整命名空间 ID;file 是源码相对文件名,不能用它读取任意 结果文件。默认 5 项、最多 20 项、整个工具返回最多 16000 字节;用 nextOffset 继续。保留原始文件、坐标单位和 JSON pointer,以及 revision/conflict/supplement 关系。事实、语法候选、解释、unknown、any、多来源、条件和截断分别可见。

显式深查:同样的 analysisSource,使用 analysisType:"deep";可加 initialAnalysisId:"<initial-id>" 合并同内容的初扫证据与修订关系。 这是整批 JS/TS 源码深查,不是按函数增量。初扫结果本身不能冒充深查。 同类型请求可传原 analysisId 复用;跨类型、缺失/未知类型、源码、有效规则、 配置或分析器版本改变会拒绝,不覆盖旧结果或自动重跑。

已有请求可选择 analysisSource:{"kind":"request","requestId":"<existing-id>"}: 只读当前 Profile 请求所指的饭中固定材料,不制造新安装意图。提交和内容身份来自 既有采集记录,分析层不重新联网证明该提交;进入分析前会按原采集清单校验完整 文件集合、逐文件内容及登记摘要(含分析器忽略的文件),再核对实际分析快照。 材料或清单失配时明确拒绝,不重新采集、不改写登记或自动改走 local;复用、查询 和关联初扫也沿用此检查。local 仍分析明确选择的当前目录,不要求采集清单。 结果写入身体绑定根的 鱼的胃/分析/<analysisId>,记录完整 Profile 所属身份, 跨 Profile 拒绝读取。切换绑定不迁移旧结果。失效结果不能继续作为有效证据引用。

固定依赖为 dependency-cruiser 18.8.0、ast-grep CLI 0.51.3、ts-morph 28.0.0。 当前 native launcher 验证范围为 Windows x64;使用官方 ast-grep 可选平台包的 直接二进制路径,安装可禁用生命周期脚本,无需全局分析器。初扫依赖的 Node 支持范围 为 22、24 或 >=26;身体原有 Node 最低要求不变,其他 Node 版本不声称分析可用。 系统 Node 与 DSH 内嵌 Node 的专项验证和测试版真实 DSH 对话验收分别记录; 真实对话已验证工具可调用并提供分析材料,不代表静态分析已证明可安全拆分。 原有 manager v2、来源保留、releaseExact、市场兼容扩展仍按下文独立维护。

支持边界:JS/TS 模块图、结构观察及有限语法追踪;初扫另有 Python/Rust/C/C++ 结构规则。其他语言、打包代码、二进制可以清点,但不保证依赖分析、反编译或提取。 模块闭包不是能力的最小依赖;局部同名修订不是“无脑区行为”;无命中不是行为不存在。 阶段来自人工问题;静态关系不能证明可达性、取消、卸载或资源释放。解析失败及追踪 不完整保留 diagnostic-partial;有界追踪、any 和动态关系仍有已知限制, 不输出“拆分成功”或“安全可安装”。目前没有模式选择入口、兼容拆分或逆向拆分执行流程, 也没有组件改写、候选安装或运行验证;它只是分析材料入口。

维护入口为 internal/analysis/;实验命令仅封装正式模块,不在正式包内。 独立安装包专项见 test/analysis-tools.test.mjs,需设 FISH_TEST_INSTALL_ROOT 与全新 FISH_ANALYSIS_TEST_ROOT;不指向日常 Profile。

0.0.5 提供安装来源保留修复。身体与鱼脑各自启停,不要求另一方存在、开启或先完成初始化。同宿主退出仍影响双方,不提供进程隔离。显式继续入口依赖单独维护的实验宿主扩展 v2,不随身体包安装。

一个 DSH bundle,包含饭(固定上游材料)→胃(审查、依赖准备、构建)→手(受管包、决定、部署和恢复)的现有完整后端、设置页及内置 SHA-256。无需另找未发布的 fish-hand 后端。

官方原版仍无安装事务扩展。 根入口识别宿主明确导出的 installTransactionExtensionVersion=1|2;本版本的待决定/原包/原生继续流程要求 v2。官方 rc.5 继续显示 FISH_NATIVE_INSTALL_INTERCEPT_UNAVAILABLE。扩展宿主按已选择 bundle 的 dsh.installTransaction 元数据调用后端,最终仍由原生执行器安装,保留兼容性、脚本策略、失败和恢复语义。插件不会自行修改宿主。

安装入口与运行要求

需要 Node >=22.14。已验证 Windows、DSH 0.2.1-rc.5 及指定扩展环境的生命周期、后端挂载与资源释放;完整安装接管的证据属于扩展环境,不外推为官方原版兼容。其他宿主版本、macOS 和 Linux 未验证。

当前正式版本为 0.0.6,通过 GitHub main 与 annotated tag v0.0.6 交付;旧版本标签保持不动。固定版本安装来源为:

github:2233heorbrin/fish-body#v0.0.6

将所选来源交给 DSH 原生插件管理。开发者也可在仓库根执行 npm pack --ignore-scripts,把对应版本 tgz 作为 file:<绝对 tgz 路径> 使用。启停以原生插件选择为准,不增加第二个总开关。完整安装接管需要指定 rc.5 实验宿主扩展,该扩展不随身体包静默安装;“换用线上版本”另需市场可选接口支持。

公开候选已在指定扩展环境验证 GitHub 首次安装、旧版更新和原生加载,来源保留修复分支随后完成日常原生安装及真实更新 API 检查。用户确认该候选的脑 UI、身体设置页和目录按钮正常;独立启停复用此前验证。正式版仅整理版本与交付说明,运行实现与已验收候选一致。原生更新 API 已验证,桌面更新按钮尚未点击,不能由 API 成功推定桌面交互通过;未创建 GitHub Release,未发布 npm/其他 registry。

扩展交付限制

两阶段决定需要 manager v2(installTransactionExtensionVersion=2、原生 install-decision 入口和对应结果/恢复契约);鱼脑另需 agentLoop.releaseExact。市场 client-only 资源占位的唯一挂载修复也是独立兼容补丁,不属于身体包,也不保证任意市场版本都需要同一补丁。

本版本的原包来源保留还要求匹配宿主导出 fixedPackageSourcesVersion=1,并支持 pnpm 12 的原生 resolver。普通原包安装、明确 original 续接和 repair 采用同一规则:manifest 与 lock 的 GitHub specifier 保留用户所选分支或标签,解析身份绑定本次已审提交,归档地址和完整性记录本次实际原包。缺少扩展时明确拒绝丢失来源的远端部署,不以插件名称免检,也不修改官方宿主。

临时 resolver 由宿主在原生安装锁内接入并撤下,保留原有 pnpm hooks、脚本授权和供应链检查;manifest/lock 由 pnpm 生成,不在 file: 安装后手改。实际发布文件逐字节核对,依赖按包声明由 pnpm 解析,正常生成文件不混作原包;不要求不同压缩渠道的 tgz 天然相同。原包仍可能被锁文件引用,不能当临时缓存删除。显式续接不重新读取已变化的分支;后续明确更新才重新采集分析。固定标签保持固定,不自动改成追踪未来版本的渠道。

这些扩展目前没有公开可下载的配套补丁发行物。本仓库不会静默安装它们,完整流程只支持环境维护者已经按实际宿主基线部署并核验的指定 rc.5 环境。其他用户应先向环境维护者取得独立维护、带来源/许可证/应用和恢复说明的匹配扩展;缺少这些材料时不能按官方原版全功能即装即用操作。这里不提供虚构下载地址或作者机器路径作为安装步骤。

首次初始化与数据

每个 DSH Profile 分别保存 fish-brain-data.json 和 fish-body-data.json。本包只维护 <Profile>/fish-body-data.json,结构沿用:

{"schema":"fish-profile-data/v1","root":"<绝对数据根目录>","components":["body"],"origin":"conversation-workspace"}
  • 有效独立绑定优先。独立文件存在但无效或根失效时明确报错,不回退到共享文件或另一方位置;可以在本包数据设置中明确重新选择。
  • 首次升级才读取旧 fish-data.json 和本包明确旧配置;所有来源指向同一根时登记原位置,只补本组件缺失结构,不覆盖正文、迁移或删除数据。来源冲突显示具体来源,等待用户选择,不猜测。身体还核对旧后端投影 fish-body-state.json:frameworkRoot,停机事务按宿主原生组合读取旧 fishRoot。
  • 独立绑定建立后忽略旧共享文件及旧配置的后续修改;不改写另一方绑定或删除共享文件。另一方继续使用旧版不会带动本包切根。
  • 真正新装时只使用明确寻址的对话工作区;不用 cwd、最近会话或安装目录推断位置。无工作区时显示待选择入口。
  • 双方可明确选择相同或不同根。切换一方不改变另一方绑定或位置,不自动搬迁旧数据。保存新路径不表示运行实例已经换根;已挂载实例提示需要原生重载,身体旧事务拒绝继续向旧根工作。
  • 降级到旧版不会自动读取独立绑定的新根。旧版仍可能使用旧共享文件或旧配置;降级前需核对位置,不能承诺自动反向同步。
  • 数据页保留初始化、目录打开、手动切换、失败详情及重试;目录初始化与程序准备分别显示,host-blocked 不表示完整功能就绪。

后端与自动程序依赖

身体初始化 <根>/饭、鱼的胃/{来源审查,脑组件,手组件}、鱼的手/{插件仓,插件注册表,运行数据,审计日志}。身体独立绑定是数据根权威;<Profile>/fish-body-state.json 是后端运行路径投影,不要把它当成另一份需要手动维护的根配置。

完整后端在 internal/backend/,保留已实现的源码包身份、GitHub 子目录/固定 commit/归档回退、批准复用、依赖生命周期语义、产包、部署原有文件完整性、正常 .bin 生成入口及失败恢复。市场适配复用既有可选 fish-body.market.v1 接口,按 Profile 注册、随身体卸载撤销;没有该接口的市场不宣称已适配。

固定正常依赖:yaml@2.8.1、pnpm@12.4.2、npm@11.6.2、tar@7.5.23。npm 发布包采集与构建产物回解使用 Node 的 tar 库处理 UTF-8 文件名,不依赖 Git for Windows 的安装位置;Git 来源采集仍沿用既有外部工具。优先使用宿主 ProfileContext 提供的包管理命令,缺省使用包内声明的 pnpm;npm 生命周期执行器来自声明的 npm 依赖,不依赖作者机器的隐藏安装。Node 优先严格校验宿主显式提供的 DSH_NODE,无效即失败;未配置时才逐个验证当前进程和 PATH 候选。Electron 运行时须保留 ELECTRON_RUN_AS_NODE=1 等所需环境。自身无 install/build 脚本;候选插件确需执行的生命周期钩子仍按现有授权处理。

不需要安装鱼脑;身体不读取人格或记忆。普通工具安装意图、权限、新增执行范围和完整性沿用原流程;不是通过放宽准入来解决发行问题。

Windows 默认 pnpm 按配置 PATH/PATHEXT 选择同一安装,支持标准 npm 全局或 node_modules/.bin 布局的 pnpm shim,依据对应包声明执行 exe 或 JS bin。显式可执行文件、Node/DSH + pnpm JS、参数顺序和配置环境保持原选择;无效显式配置明确失败,不静默改用另一套安装。不解释任意 shim 内容,也不承诺所有 Corepack 或第三方脚本布局兼容。

原生开关和限制

安装分析与明确继续(实验宿主 v2)

身体开启且可用时,脑、UI 和其他候选都经过既有采集与静态分析,不要求鱼脑先启动。不预设所有候选为工具;事实、候选判断、未知项和具体操作位置分别返回。缺少线索不证明运行安全,也不会把全部未知风险自动记为已接受。范围匹配的普通工具安装意图及同内容、同 Profile 的有效既有批准继续复用;新增具体人格/记忆操作或无法判定的形态会返回待决定,不静默安装。

待决定返回 DSH_INSTALL_DECISION_REQUIRED、决定引用、目标编号及证据,exit=2;当前调用结束,Profile 安装锁释放。用户与模型讨论后,可以从同一个原生 CLI 明确继续(命令中的占位符取自本次结果):

dsh plugin --profile <p> install-decision <决定引用> status
dsh plugin --profile <p> install-decision <决定引用> original <目标编号>
dsh plugin --profile <p> install-decision <决定引用> native <目标编号>
dsh plugin --profile <p> install-decision <决定引用> reject <目标编号>
dsh plugin --profile <p> install-decision <决定引用> cancel <目标编号>

审查失败、超时或结论不明且原包已成功固定时,用户可以明确选择本次原包;这不等于分析通过,也不是自动放行。下载、身份、归档或完整性错误不能借此绕过。

original 用于已经采集并固定的原包:npm 使用原发布归档;Git 使用选定提交/子目录的 npm pack --ignore-scripts 文件,不构建、不拆分或改写源码。继续只消费这份保存内容,不重新解析可变分支。native 仅用于胃未初始化、根失效或导入/启动不可用且尚无固定原包的本次操作;该入口在宿主层,不依赖身体工具或页面能否加载,也不要求先初始化数据。没有分析通过的记录,不伪造受管批准。

每个目标单独决定;repair 在所有待决定目标明确选择前不部署,多包操作返回此前实际完成结果及后续待决定引用。重复安装、--yes、超时或模型判断都不是选择。拒绝/取消不部署本次目标。下载、包身份、归档或完整性失败继续失败,不提供这种放行。原包安装不授权脑区合并、人格记忆覆盖,也不保证未知插件运行时不会产生这些行为;按实际发现及已有授权判断。

决定与 Profile、目标、操作及固定文件对应;依赖变化须重新分析,文件变化拒绝继续。等待期间身体可关闭、切根;继续不持有旧实例或写旧根,原生启停选择和脚本策略保留。不提供永久自动绕过授权。决定文件及其原包保存在 Profile 的 .plugin-manager/install-decisions,已安装依赖仍可能引用原包,不能随意删除。

这是 CLI/manager 参数入口,不表示桌面新增按钮已经实现或验收。fish_hand 的 review/approve 仍用于独立材料审查及明确范围的正式受管批准;返回材料不等于用户已决定,也不用伪造全部残留风险接受来选择原包。

关闭身体插件时,本 Profile 已接纳的身体操作先收尾,期间拒绝新流程;实际 Cordis 卸载释放路由、fish_hand 及 utility_sha256,另一个 Profile 和独立工具保持可用。已有文件和记录保留,不主动开关独立插件。

扩展宿主仅在身体 bundle 已选择时调用事务入口;关闭后原生安装不读取身体注册表、不产生身体审计。普通启用、停用不经过安装事务。既有独立插件不随身体卸载。官方原版和扩展版的验收必须分别报告。

普通 Node 与实际 DSH.exe 的 Node 模式已完成真实 CLI 故障、解除故障后的安装和 Loader 验证;默认 pnpm 在保留实际 perf/compat imports、worker-events require 的隔离宿主中也完成安装及 Loader 验证。日常指定扩展环境的原生安装与重载、独立开关已验证,页面及目录按钮由用户确认;完整第三方市场安装链和插件页自动发现更新不因此视为通过。历史 EPIPE 的精确触发路径仍为 unknown。实现归属与验收范围见 PATCHES.md。

开发验证

将发行物独立安装在临时目录,设置 FISH_TEST_INSTALL_ROOT;官方原生测试另设 FISH_DSH_TEST_ANCHOR 为临时官方宿主 package.json。

node --test test/distribution.test.mjs test/backend-*.test.mjs test/official-native.test.mjs

包含真实本地产包、依赖生命周期、源码身份、Git/归档替身、本地离线 pnpm 安装与部署校验、多 Profile 状态隔离及原生卸载。测试中的网络替身不是 GitHub 在线验收;路由与文件夹打开的自动化测试使用最小连接/桌面 opener 接缝。实际远端安装及用户页面/目录操作证据单独记录,不能由自动化接缝推定;完整第三方市场安装链仍未验收。

历史 W6-A 本机隔离辅助函数 internal/backend/lib/w6-runner.mjs 的 makeRunPnpm() / runnerFact() 保留旧验收机器的宿主定位,仅供对应历史本机测试,不是跨机器安装入口;正式插件安装链不调用这两个函数。不能据此宣称这些旧辅助入口可在其他机器通用运行。当前安装产物回归按 test/README.md 使用明确的隔离根和可配置工具路径。

MIT,第三方来源与许可见 THIRD-PARTY-NOTICES.md。

受管产物保留

身体停用、卸载或切根不删除旧手目录中的受管 tgz、登记和数据。已安装的独立插件保持自己的生命周期;原生离线修复或重装仍可能需要 manifest 中 file: 指向的原 tgz,不能把这些文件当作可随意清理的缓存。

Comments

Loading…