kangshifu-board/deploy/enterprise-workshop

康师傅企业工作坊初始化 r2

本组件补齐企业配置仓库、宿主机企业映射与工作坊文件初始化。沿康师傅现有应用和统一数据库；不建库、不重跑迁移、不更换现有数字人。

企业编号 FKieRbIoGt，业务 appId FKieRbIoGt_main。字段逐字核对，不去下划线。Gogs 组织 kangshifu、私有配置仓库 workshop-config，初始管理员为已有账号 18307996893。原 18307996893/kangshifu-board 保留。

配置来源和授权

配置仓库只保存公开配置、固定组件及校验信息。current.json 中的 masterKey、Gogs token、SSH 私钥、加密信封、credential-binding.json、个人档案均不进仓库。企业侧配置修改经新提交、核验后更新宿主映射中的 commit；新建数字人不会静默追随分支最新内容。

本组件安装既有正式 r13 的45个公开文件，字节不变；研究组件来自已验收运行补丁r1。只保留一个活动工作坊 Skill；旧研究目录只放脚本，不建立第二个 SKILL.md。VOC是必需依赖：核验复用官方0.3.44，缺少时安装；已有其他版本或未知改动停止，不降级或强行覆盖。不改其他技能。

研究流程沿现有r13规则：拆解问题，结合已有数据形成有依据的初步回答；自主检查关键缺口；必要时通过VOC执行接口检索→参数契约→真实外部采集；核原件和反证后修订结论，按授权入库并保存回读。不是逐轮无差别采集，也不把VOC演示数据当作真实研究证据。

数字人身份与学员身份分别处理：为新容器登记自己的 role=workshop Agent 档案；学员必须来自本轮可信登录/通道上下文。平台用户ID不能直接当作康师傅业务库_User指针；不能把数字人拥有者固定当成30多名学员。尚未取得学员上下文时不得伪造参与者或标记小组归属已通过。

1. 管理员建立组织与私有配置仓库

从核验后的发行目录运行。--token-file 是现有管理员的私有 JSON 文件，只有 token 字段，0600；不要在命令行、回执或仓库中填写令牌。脚本先验证登录账号必须是18307996893，再创建组织和仓库。已有本版只核验；完整已知r1可正常快进升级，未知内容停止，不强推。r1已装容器只更新本组件的企业版本绑定并私有备份；Skill、身份和授权保持。

python3 -B gogs_setup.py --token-file /实际私有路径/gogs-admin.json
python3 -B gogs_setup.py --token-file /实际私有路径/gogs-admin.json --apply

回传 repositoryURL、commit、private=true、filesReadBack。这是Gogs操作，不等于平台已自动下发Skill。若本地当前凭据属于其他账号，停止，使用现有管理员授权；不重置账号密码。

2. 宿主建立企业映射并安装当前容器

在fmode01用现有受控通道取得私有配置仓库，checkout到上述回执的固定commit。令牌使用现有受控Git凭据机制；不要写进remote URL或仓库配置文件。下面 /实际仓库路径 和 固定提交 由运维根据真实回执替换。

python3 -B /实际仓库路径/registry.py bind --registry /opt/fmode-containers/enterprise-workshops.json --checkout /实际仓库路径 --commit 固定提交
python3 -B /实际仓库路径/registry.py bind --registry /opt/fmode-containers/enterprise-workshops.json --checkout /实际仓库路径 --commit 固定提交 --apply
python3 -B /实际仓库路径/registry.py after-twin --registry /opt/fmode-containers/enterprise-workshops.json --container agent-node-kangshifu
python3 -B /实际仓库路径/registry.py after-twin --registry /opt/fmode-containers/enterprise-workshops.json --container agent-node-kangshifu --apply

宿主映射以companyObjectId索引固定仓库、提交、清单哈希，其他企业映射保持。安装前核容器current.json与uid10000；用hermes执行plan/apply/verify。只复制清单内公开文件，不复制.git。已有组件仅核验，未知差异停止，不直接覆盖。安装回执包含容器内packageDirectory和resultsDirectory。

after-twin会继续执行VOC的plan/apply/verify。官方0.3.44从npm固定地址取得，核501255字节、SHA-256和169个声明文件；依赖按本包锁文件npm ci --ignore-scripts安装。新安装只适配.mcp.json中的本机路径；已有可用安装及连接配置保留。本包不包含第三方VOC源码归档或任何凭据。

VOC首次安装需要目标环境能访问npm；也可先提供经过同一哈希核验的原始tgz，用voc.py --archive指明本机文件。原VOC临时配置、其他VOC技能和其他数字人的令牌不作为新容器凭据复制。

需要单独安装或复验时，在容器内packageDirectory执行：

python3 -B voc.py plan --data-dir /opt/data --out /opt/data/ksf-enterprise-voc-results
python3 -B voc.py apply --data-dir /opt/data --out /opt/data/ksf-enterprise-voc-results
python3 -B voc.py verify --data-dir /opt/data --out /opt/data/ksf-enterprise-voc-results

回执voc-mcp.fragment.json供宿主按实际支持机制接入；不直接猜测修改Hermes配置。请核验宿主真实工具登记，并在当前数字人自己的运行环境确认VOC凭据可解析。check-voc.cjs只返回凭据可用布尔值，不回传令牌。安装、19个工具的本地加载/目录查询/参数读取、宿主工具登记、真实联网调用分别验收。实际补采在真实研究缺口任务中验证，不在初始化时新造采集批次。

当前容器文件安装可先完成，授权另办。bootstrap不会创建会话、项目、报告或学员；不会复制旧Agent绑定。

3. 为新容器配置独立授权

使用现网已有签发工具，并先核其支持新收件人。旧的restore工具是原容器恢复工具，不可仅替换hostname后当作新容器签发器。

• 研究：在本容器以hermes生成自己的设备键，由资料服务维护者核实目标authorized_keys真实路径并追加受限wrapper条目；保留已有键。本阶段使用只读研究权限（独立receiver配置canPublish=false或现有等效限制），不默认授予原件发布权限。将可信来源核实的host key放进本容器known_hosts。不要用未核验的ssh-keyscan结果当作信任依据。channel.json格式沿现有ksf.library-channel.v1，文件/私钥/known_hosts 0600、目录0700。
• 业务：在本容器生成自己的收件密钥，通过现有受控签发端为hostname实际值封装独立服务凭据；使用新容器自己的KsfServiceCredential，不复用旧数字人的token。服务权限按既有工作坊所需范围配置，不发masterKey。绑定、信封、公钥/解密模块指纹必须与冻结的ksf-secure.mjs契约一致。不得复制他人的私钥、绑定、信封或Agent档案。当前恢复包本身不证明具备任意新收件人签发功能，需真实签发回执；可回传凭据记录ID和scope，不回传令牌值。
• Agent档案：经现有ksf-identity.mjs register用真实平台账号与runtimeAgentId登记role=workshop。姓名来自可信配置或本人登记，不猜测、不标成企微通讯录已认证。

组件已安装后，以hermes在回执packageDirectory内执行：

python3 -B readiness.py --data-dir /opt/data --out /opt/data/ksf-enterprise-readiness --activate-research

此命令只读验证VOC本地运行、研究contract与加密业务contract，并报告VOC凭据可用状态。两端通过后，仅向现有.env补充非敏感KSF_LIBRARY_CHANNEL；修改前本机私有备份，其他字节保留。同键冲突停止。Hermes是否重新读取环境及新任务是否实际加载，须按宿主机制再验；该脚本不重启容器。

4. 接入新数字人初始化流程

registry.py after-twin是供twin_init成功后的调用入口：根据容器实际companyObjectId查宿主映射；无映射企业跳过，康师傅精确核对appId后安装。入口本身已实现，但未修改或接入生产twin_init.sh或云函数。

请先回传 /opt/fmode-containers/twin_init.sh 与 /enterprise/twin-bootstrap 中负责调用它的非敏感片段及文件SHA。根据真实成功分支接入after-twin，保留原初始化错误码，不在原初始化失败时继续安装。授权签发也须接入该生命周期，文件安装成功不得当成授权完成。没有生产源文件和执行回执，不能标记“以后新增数字人会自动可用”。

验收口径

依次报告：Gogs组织/私有库与固定提交；企业映射；文件plan/apply/verify；VOC版本、169文件、依赖与本地工具运行、凭据与宿主工具登记；两端独立授权contract；新任务实际加载；真实学员/小组上下文；正常保存→编号回读→看板归属；新建数字人自动初始化。真实补采、保存和归属用真实上下文验证，不为凑验收造学员、会话或成果。

企微机器人853000独立处理，不因机器人尚未连通而撤销已完成的仓库或文件安装；也不能声称企微消息链路已可用。旧库仍封存，统一PG仍为生产数据源。