Selaa lähdekoodia

feat: enterprise configuration mapping and pinned workshop bootstrap

pengzhikang 5 päivää sitten
commit
9cde2fc0bb
5 muutettua tiedostoa jossa 89 lisäystä ja 0 poistoa
  1. 1 0
      .gitattributes
  2. 67 0
      README.md
  3. BIN
      ksf-enterprise-workshop-20261110-r1.zip
  4. 13 0
      release.json
  5. 8 0
      validation.json

+ 1 - 0
.gitattributes

@@ -0,0 +1 @@
+* -text

+ 67 - 0
README.md

@@ -0,0 +1,67 @@
+# 康师傅企业工作坊初始化 r1
+
+本组件补齐企业配置仓库、宿主机企业映射与工作坊文件初始化。沿康师傅现有应用和统一数据库;不建库、不重跑迁移、不更换现有数字人。
+
+企业编号 `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,不改其他技能。VOC 的宿主接入按当前实例现状另验。
+
+数字人身份与学员身份分别处理:为新容器登记自己的 role=workshop Agent 档案;学员必须来自本轮可信登录/通道上下文。平台用户ID不能直接当作康师傅业务库_User指针;不能把数字人拥有者固定当成30多名学员。尚未取得学员上下文时不得伪造参与者或标记小组归属已通过。
+
+## 1. 管理员建立组织与私有配置仓库
+
+从核验后的发行目录运行。--token-file 是现有管理员的私有 JSON 文件,只有 token 字段,0600;不要在命令行、回执或仓库中填写令牌。脚本先验证登录账号必须是18307996893,再创建组织和仓库。已有仓库只允许内容完全一致时复用;不会覆盖未知文件或强推。
+
+```sh
+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或仓库配置文件。下面 /实际仓库路径 和 固定提交 由运维根据真实回执替换。
+
+```sh
+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。
+
+当前容器文件安装可先完成,授权另办。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内执行:
+
+```sh
+python3 -B readiness.py --data-dir /opt/data --out /opt/data/ksf-enterprise-readiness --activate-research
+```
+
+此命令只读验证研究contract与加密业务contract。两端通过后,仅向现有.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;两端独立授权contract;新任务实际加载;真实学员/小组上下文;正常保存→编号回读→看板归属;新建数字人自动初始化。后几项必须用真实上下文,不为凑验收造学员、会话或成果。
+
+企微机器人853000独立处理,不因机器人尚未连通而撤销已完成的仓库或文件安装;也不能声称企微消息链路已可用。旧库仍封存,统一PG仍为生产数据源。

BIN
ksf-enterprise-workshop-20261110-r1.zip


+ 13 - 0
release.json

@@ -0,0 +1,13 @@
+{
+  "release": "ksf-enterprise-workshop-20261110-r1",
+  "archive": "ksf-enterprise-workshop-20261110-r1.zip",
+  "bytes": 430269,
+  "sha256": "5aef5b678cc83611d0e2b7fec6e78947717747fedecb3cf569442fd038d415bb",
+  "files": 68,
+  "skillVersion": "r13",
+  "existingSkillFilesChanged": 0,
+  "credentialsIncluded": false,
+  "productionDeployed": false,
+  "automaticLifecycleHookInstalled": false,
+  "businessWrites": 0
+}

+ 8 - 0
validation.json

@@ -0,0 +1,8 @@
+{
+  "ok": true,
+  "testsRun": 19,
+  "exitCode": 0,
+  "productionWrites": 0,
+  "realPostgreSQLTested": false,
+  "remoteDeploymentTested": false
+}