dsh-plugin-t-expert 0.4.26 → 0.4.37

package/data/experts/spatial-computing/fbsir-eight-seat-board/README.md

@@ -0,0 +1,236 @@
+# 独董会 | FBSir Independent Review Board
+
+> **中文品牌**：福帮手
+>
+> **英文品牌**：FBSir
+>
+> **出品**：悟空共创（杭州）智能科技有限公司
+>
+> **联系**：unique@u3w.com
+
+面向实体企业一号位（董事长、CEO、创始人）的可配置 AI 经营决策审议团队：把模糊焦虑变成可审议议案，只召集必要的专业席位，让各席先独立判断、再公开分歧，最终交付有证据、有条件、有行动期限的审议备忘录。
+
+## 当前版本
+
+`26.8.19`。本版本聚焦首值激活与安全续作：五路入口按意图交付不同首值，紧凑起手卡固定一个主动作和两个次级分支，最多追问两个决定性问题；确认前不写案卷、不建团，并把 exact `v2@26.8.1` 前序案卷和 exact `v1@26.7.20` legacy 案卷保留为只读续办来源。
+
+### Canonical 产品身份
+
+| 字段 | 真值 |
+|---|---|
+| 中文产品名 | 独董会 |
+| 英文产品名 | FBSir Independent Review Board |
+| 中文品牌 | 福帮手 |
+| 英文品牌 | FBSir |
+| 稳定包 ID | `fbsir-eight-seat-board` |
+| 证据命名空间 | `fbsir-eight-seat-board` |
+
+### WorkBuddy 卡片显示
+
+WorkBuddy 2.3 对 Team 包强制要求 `displayName.zh=profession.zh`。本机 WorkBuddy 5.2.6 前台读回同时表明：市场团队卡将这两个同值字段作为产品标题，将 `author.name` 作为发布方/品牌第二行；“我的专家”本地卡可能隐藏第二行。由于 2.3 的 `author.name` 是单一、非多语言字段，本包优先匹配中文卡片截图，把作者行固定为“福帮手”；英文品牌 FBSir 保留在 `brand.en`，不声称作者行会随界面语言自动切换：
+
+| 位置/字段 | 中文 | 英文 |
+|---|---|---|
+| Team 标题（`displayName=profession`） | 独董会 | Independent Review Board |
+| 市场发布方/品牌行（`author.name`，非多语言字段） | 福帮手 | 同一字段，不会自动切换为 FBSir |
+| 品牌元数据 | 福帮手 | FBSir |
+
+包内静态门禁会核对 Team 标题字段相等、中文发布方署名和双语品牌元数据，防止产品名与品牌名互换或退回旧组合名称。英文界面的最终作者行及正式市场页面仍以上架后的官方读回为准。
+
+本产品与已上架的“超级合伙人”AI+OPC 产品相互独立：可以共存，但不复用产品 ID、入口文案、版本、运行回执或产品信用。
+
+稳定包 ID 中的 `eight-seat` 是为兼容既有包、路径和证据链保留的技术标识，不是品牌名，也不约束当前或未来席位人数。
+
+## 角色在册，按案成会
+
+独董会采用可配置角色池。当前 `26.8.19` 阵容以 manifest 为唯一人数真源，包含一席召集人、一席不表态的流程秘书和当前可用专业角色；人数不是品牌承诺，后续可以新增、合并、暂退或替换角色，而无需改名产品。每次审议按案选席，不为凑人数让无关席位发言。召集人与秘书都不计专业席。
+
+| 席位 | 角色 | 核心职责 |
+|---|---|---|
+| 召集人 | 常远虑 | 立案、选席、质询编排、异议留痕和备忘录汇编 |
+| 秘书 | 纪周全 | 授权材料索引、宿主能力发现、进度、长文档与产物编排；不投票 |
+| 战略 | 詹维高 | 产业、竞争、业务组合、第二曲线与市场选择 |
+| 资本财务 | 金润泽 | 财务体检、现金流、估值、交易结构与投入产出 |
+| 营销增长 | 张扬 | 客户、品牌、渠道、销售体系与增长杠杆 |
+| 制造运营 | 甄实干 | 生产、供应链、质量、成本、交付与改善 |
+| 组织人力 | 柳成荫 | 组织、高管、激励、绩效、文化与传承 |
+| 法务风控 | 严守成 | 股权、合同、合规、劳动、交易与风险结构 |
+| 数智化 | 舒智深 | 数字化、AI 场景、智能制造、数据与系统选型 |
+
+## 第一次响应先给价值
+
+独董会不会先要求用户填完整套问卷。第一次响应先交付《决策起手卡》：
+
+- 一句话真议案；
+- 决策选项与 Non-goals；
+- 已知事实、待验证假设和关键缺口；
+- 推荐的审议模式与必要席位；
+- 唯一下一步。
+
+候选席先按“是否会改变结论”排序，再通过不写案卷、无需用户确认的选席预检；起手卡只展示预检回执中的规范化结果：快审 1 个专业席，标准审议和深度准备 2—3 个专业席。流程秘书不计专业席，候选池也不等于同时入选清单。
+
+最多只追问 2 个决定性问题，即会改变合法性、选项集合或资金承受力的问题。资料不足时仍形成议案和缺口图；只有关键事实不足时才标记 `not_ready_for_conclusion`，不输出确定结论。
+
+起手卡末尾固定一个主动作 `按建议开始独立审议`，以及两个次级分支 `补充关键事实`、`切换审议模式`。只有用户明确选择主动作才进入确认流程；卡片展示本身不是确认，确认前不写案卷、不建团。
+
+### 五路入口与稳定动作
+
+入口意图由 `fbsir.entry-intent/v1` 结构化表达并经确定性校验。关键词只作提示，不替代用户意图；问候和能力询问不会被虚构成经营议案。五路入口与首值固定如下：
+
+| route | firstValue | 最多追问 | 确认前写入 / 建团 |
+|---|---|---:|---|
+| `capability_discovery` | `capability_card` | 0 | 否 / 否 |
+| `decision_intake` | `decision_start_card` | 2 | 否 / 否 |
+| `material_review_intake` | `decision_start_card_with_material_sufficiency` | 2 | 否 / 否 |
+| `continue_or_resume` | `case_resume_card` | 1 | 否 / 否 |
+| `graceful_redirect` | `graceful_redirect_card` | 1 | 否 / 否 |
+
+入口阶段使用以下稳定 actionId；普通用户正文只显示自然语言，完整动作 envelope 默认只进入宿主元数据或显式 debug。actionId 只表示包提出的动作，不证明宿主执行、连接器 ACK、正式上架或自然业务转化。
+
+| actionId | 可见文案 | 用途 |
+|---|---|---|
+| `confirm_review` | 按建议开始独立审议 | 确认起手卡后进入计划冻结流程 |
+| `add_facts` | 补充关键事实 | 补充材料并重算卡片，不建团 |
+| `change_mode` | 切换审议模式 | 重算模式与席位提案 |
+| `resume_case` | 确认继续案卷 | exact digest 只读重验后，current 续同一 run；predecessor/legacy 进入不同的新 26.8.19 run |
+
+续办卡使用 `fbsir.case-resume-card/v1`：current 只展示事件链可复算的观察里程碑，不解释 checkpoint 的自由文本状态，也不投影 checkpoint 未绑定的材料记录；exact `v2@26.8.1` predecessor 与 exact `v1@26.7.20` legacy 都只展示各自字节证据绑定，不声称旧内容或旧节点真实完成。三种 release tuple 严格分层；混合、扩展或未知 tuple 均失败关闭。`--inspect-only` 只在本次卡片展示中隐藏继续动作，不撤销调用方独立构造的 action envelope。卡片生成本身不写案卷、不证明宿主执行、用户确认、正文真实性或产品信用。
+
+## 三种审议模式
+
+| 模式 | 何时使用 | 专业席 | 质询 | 主要交付 |
+|---|---|---:|---:|---|
+| 快审 | 单域、低至中风险、时间紧 | 1 | 无 | 快速审议卡 |
+| 标准审议 | 跨 2—3 个专业域的真实取舍 | 2—3 | 1 轮 | 审议备忘录 |
+| 深度准备 | 并购、重大转型、传承等高影响议案 | 2—3 | 1 轮 | 深度审议准备卡与扩大范围建议 |
+
+默认采用标准审议。公开核心一次最多处理 5 个议题，超过时按依赖、风险和决策时点分批。完整深度会只有在宿主资源和已验证权益都允许时才扩大角色池；“可访问全角色池”不等于默认全员出场。
+
+## 四幕审议
+
+1. **立案**：形成决策起手卡，核查范围、关联关系、证据偏差和信息充分性。
+2. **独立审阅**：各专业席只收到最小必要议案切片；首轮互不可见。
+3. **交叉质询**：围绕真正影响结论的冲突点质询，记录坚持、修正或让步。
+4. **交付**：按全部选定参与席 N/N 收齐、且至少保留一个有效专业结果后，汇编表态、共识、异议、成立条件、失效条件和 7/30/90 天行动，并生成可点击的模式对应 Markdown 文件。
+
+## 七类预设议案
+
+- 全面经营诊断
+- 战略转型与第二曲线
+- 投融资、并购与现金流
+- 增长破局与渠道变革
+- 组织人才与传承
+- 出海市场决策
+- 数智化与 AI 转型
+
+单一领域问题优先快审，不升级为多人会议；跨域综合问题进入标准审议；只有重大影响且确需广泛独立判断时进入深度审议。
+
+## 交付结构
+
+### 快速审议卡
+
+```text
+# 独董会快速审议卡
+一、一句话判断
+二、事实 / 估计 / 假设 / 判断 / 未知与最强反证
+三、专业席立场及成立条件
+四、最大风险与失效条件
+五、决策质量最弱链
+六、唯一下一步、触发器、负责人、复审日期与人工关卡
+```
+
+### 标准/深度十节合同
+
+```text
+# 独董会审议备忘录
+【表态统计】赞成 X / 有条件赞成 Y / 反对 Z / 不具备表态条件 W
+【一句话建议】……
+
+一、议案、选项与 Non-goals
+二、证据、假设与关键缺口
+三、各席核心判断
+四、质询、修正与保留异议
+五、建议、成立条件与失效条件
+六、决策质量六链门禁（最弱链 / 缺口 / 状态）
+七、决策日志（选择 / 指标 / 触发器 / 负责人 / 复审日期）
+八、7/30/90 天行动（责任方向 / 人工关卡 / 验收标准）
+九、证据台账、席位回执与资产包索引
+十、专业边界与需人工复核事项
+```
+
+`standard_review` 使用上述标题；`deep_review` 仅将首行替换为 `# 独董会深度审议准备卡`，十节标题与顺序保持不变。表态统计与一句话建议是前置摘要，不计入十节；快审不得静默升级为十节。
+
+六链逐项覆盖问题框架、可行替代、可靠信息、价值与取舍、推理、执行承诺。决策日志保留最终选择、未选方案、可解析时的关键概率与截止日、领先指标、触发器、负责人、复审日期。
+
+详细估值表、法律附录、关键变量观察台仅在议案需要时追加。
+
+## 基础秘书与包内 Skill
+
+秘书是能力经纪人，不是自带所有工具的“万能 Agent”。她发现并编排当前 WorkBuddy 实际提供的资料整理、搜索、研究、翻译、媒体、Office/PDF、发布和自动化能力；不可用或未授权时必须降级，不能虚构调用。26.8.19 公开核心提供材料/版本索引、能力可用性说明、进度卡、S/P/C/B/G 文档门、决策质量六链检查、决策日志和产物验收清单。这是本版为保证基础审议可用性的折中，不表示 VIP 身份、积分、Webhook、完整秘书权益或 Connector 已实现；完整增值能力仍需后续经验证的权益与 Connector。
+
+`skills/independent-board-core/` 提供：
+
+- 七类核心场景词典与最小席位路由提示；
+- 当前默认清单为九角色、21 张短卡、6 个来源；人数调整时，目录须随成员清单同步闭合，并继续通过目录/来源/新鲜度/哈希门禁；
+- 每个议题 × 席位的确定性资产选择、首轮同席隔离和 `assetbundle:<sha256>` 绑定；
+- 专用 Case Workspace 初始化与边界检查；
+- 用户确认后的议题、模式和选席计划校验；
+- 成员任务/结果信封校验；
+- 成员结果耐久记录、与结果哈希绑定的 `SendMessage` 成功观察；
+- 按议题与全部选定参与席 N/N 收齐、至少一个有效专业结果、一次重试后的失败闭合和漏唤醒恢复；
+- 默认 Markdown 交付物的收齐、标题、路径与 SHA-256 门禁；
+- 仅由召集人写入的追加式哈希事件链；
+- 哈希链意外损坏检测（非抗攻击防篡改）和本地检查点标记；
+- 审议备忘录、Word/PDF、翻译和视觉交付的结构与质量门。
+
+这些确定性协同程序不替代 `TeamCreate → AgentTool/Agent → SendMessage`，也不能把资产包、本地事件或成员侧工具成功观察升级为方法采用证明、宿主签名回执、主会话消费证明或业务效果。
+
+决策起手卡可以只在对话中完成。用户确认开始本地独立审议后，必须在当前 WorkBuddy 任务目录内初始化新的 `local_managed` 专用案卷；失败时不在普通目录继续写入，也不建团。
+
+## 连接器与降级
+
+连接器仅用于增强工商、金融、法规或公开资料核验，不是首次价值的前置条件。没有连接器时，独董会仍可基于用户当次材料、已授权公开来源和明确假设开展审议；无法核实的数据标记“待人工核验”。
+
+## WorkBuddy 协作事实
+
+进入成员审阅前，召集人先计算确认版起手卡哈希，校验并耐久记录冻结计划，以计划 `payloadHash` 追加 `plan.frozen`；随后校验认知资产目录，为每个议题 × 席位构建并验证独立短包，校验并耐久记录每席任务。记录回执返回的任务原始字节 `taskPayloadHash` 必须贯穿同一 `agendaItemId + seatId + revision` 的派发请求、派发终态、收齐与交付；派发后任务字节变化即失败关闭。只有这些门禁完成后才亲自执行 `TeamCreate`，再通过规范 2.3 所称 `AgentTool` 调度成员（WorkBuddy 5.2.6 实际函数名为 `Agent`），成员只通过 `SendMessage` 回传召集人。成员先验证本席短包、耐久记录回显同一摘要的结果，`SendMessage` 成功后再记录与结果哈希绑定的成员侧投递观察；召集人在每次消息或团队终态唤醒时运行收齐器，并再次验证计划、任务、冻结路由、资料有效期、资产包和全部选定参与席 N/N 结果。恢复结果、失败、收齐完成和成稿分别用精确哈希绑定到 `seat.result_recovered`、`seat.result_failed`、`collection.ready` 和 `memo.compiled`，交付脚本再次复核。成员不得互相直连，也不得 spawn 召集人。UI 绿勾、团队终态通知和成员侧观察都不能冒充宿主签名回执；工具不可用时，只交付决策起手卡和恢复建议，不模拟成员意见，也不生成伪造的审议备忘录。
+
+机器可读能力合同见 `contracts/runtime-capabilities.json`。
+审核承诺与包内证据索引见 `contracts/commitment-traceability.json`。
+
+## 法律与专业边界
+
+所有席位均为 AI 角色，不具有人格、现实职务、执业资格、股权、经济利益或受托义务。本产品借鉴独立董事的独立审阅、充分质询、逐席表态和异议留痕形式，但不是公司法意义上的董事会，不生成董事会决议，也不替代公司治理程序。
+
+交易签署、资金划转、裁员或解聘、股权与税务安排、生产安全、数据跨境等高风险事项，必须由有权责任人、执业律师、注册会计师或相应专业人士基于完整材料人工复核后执行。
+
+## 隐私与权限
+
+- 默认最小必要披露，建议先对个人信息、商业秘密和未公开交易数据脱敏。
+- 起手卡默认只在当前对话交付；用户确认建团后，只在新建专用案卷内记录结果与基础 Markdown 交付物。
+- 未获用户对明确对象、范围和当次动作的授权，不进行外部写入、发信、上传、付款、签约、系统配置、监控或自动化。
+
+## 头像
+
+`avatars/` 只存放当前 manifest 实际引用的一张团队头像和当前角色头像。评审候选统一为 512×512 PNG、单张不超过 500KB；逐图视觉 QA 未发现可见文字、水印或第三方标识。该结论不等同于版权或授权认证，正式使用前仍由资产权利人完成权属复核。
+
+生成式视觉资源在源码仓中按母版、候选、既有资源副本和运行时资源分层保存；母版与既有资源不会被运行时构建覆盖。评审 ZIP 只携带 manifest 实际引用的运行头像，不携带候选库和工程母版。
+
+## 安装
+
+推荐在 WorkBuddy 的“我的专家/自定义专家”入口导入本包。手工安装时，先确定配置根目录；Windows 默认值如下，也可由 `WORKBUDDY_CONFIG_DIR` 覆盖：
+
+```powershell
+$configRoot = if ($env:WORKBUDDY_CONFIG_DIR) { $env:WORKBUDDY_CONFIG_DIR } else { Join-Path $env:USERPROFILE '.workbuddy' }
+$expertDir = Join-Path $configRoot 'plugins\marketplaces\my-experts\plugins\fbsir-eight-seat-board'
+```
+
+将包根目录复制到 `$expertDir` 后，通过 WorkBuddy UI 完成注册。若需命令行注册，只使用目标宿主当前版本内置的专家管理器；本包不携带宿主脚本。
+
+本地安装只能证明 `review_package_my_experts_test_state`，不能证明正式上架、正式宿主运行或自然业务闭环。
+
+## 验证与交付边界
+
+本 README 会随评审 ZIP 分发，因此不把源码仓的工程脚本当作包内用户命令。候选包在生成前必须通过 V2.3 内容门、入口/合同一致性审计、核心协同负向测试、双 cleanroom 可重复构建和目标 WorkBuddy 官方校验器。工程脚本、审计报告、视觉母版与构建回执保留在源码及发布证据区，不进入运行包。
+
+这些结果只能证明候选包和已明确记录的本地宿主联调事实，不等于正式上架、自然业务闭环或商业权益证明。