← 全部手册首页

公司（租户）管理员手册

版本：2026-08-08 第二稿（groups/公司后端落地、标配 6 组） · 随功能迭代更新 读者：中小企业老板 / 公司管理员（非技术背景） 事实基准：已实现功能以代码（ontology/public/ 下的 home.html、org_manage.html/js 等）和生产环境实测为准；设计内容以 ontology/docs/company-design.md、ontology/docs/group-design.md 为准。

0. 读前须知：功能状态总览

2026-08-08 起，「公司」相关功能的前后端均已完成开发并本地验证通过（冒烟 30/30），但尚未部署到生产环境。 为避免误导，本手册对每项功能用四种标记区分：

标记 含义
✅ 已上线 生产环境（47.122.125.97）现在就能用，操作路径照做即可
🟠 已实现待部署 前后端均完成、本地验证通过，生产环境还用不了（等部署）；操作步骤按已实现的代码描述，上线后照做即可
🟡 前端就绪 界面和交互已开发完成，但后端接口未实现，暂时用不了
【规划中】 只有设计文档，尚未开发
功能 状态
创建项目（填项目名） ✅ 已上线（但目前线上流程没有「选公司」这一步）
公司概念与自动命名规则 🟠 已实现待部署（2026-08-08 前后端完成；存量项目已按规则补建公司）
新建项目时「加入已有公司 / 新建公司」两步流程 🟠 已实现待部署（home.html + 后端 create_project 三分支均已接线）
公司标配 6 组（3 权限组 + 3 资源组自动建仓） 🟠 已实现待部署（2026-08-08 新增，见 §2.6）
公司管理页（org_manage）：公司列表、权限组、资源组 🟠 已实现待部署（org_manage.html/js + /api/my/companies、/api/groups 后端均已落地）
公司改名、默认公司设置 【规划中】设计有，前端尚未做
平台模板库（BMC 查看者/编辑者/管理员、采购/研发/财务组） 🟠 已实现待部署（6 个平台模板已随建库迁移预置，saas_manage 模板库 Tab 可用）
权限组接入画布授权（建了组就真能管住谁能改画布） 【规划中】（实施分期 P2）
资源组接派活/调度（IPD 推演） 【规划中】（实施分期 P3）
多人协作：邀请成员、公司成员管理 【规划中】

1. 公司是什么

1.1 一句话：公司是「权限壳」，不是业务实体 🟠 已实现待部署

在 Lucid Foundry（明见）里，「公司」不是你营业执照上那个公司的数字化建模——系统不会帮你管公司的供应链、品牌、现金、组织架构。这些被刻意排除在外（设计裁定：这些是经营判断题，不是数据，建进系统反而是负资产）。

公司只做四件事：

真正的业务对象是项目（一张 BMC 商业模式画布及其推演）。公司是装项目的壳。

1.2 公司从哪来：自动创建、自动命名 🟠 已实现待部署

你不需要手工注册公司。规则（用户定调，2026-08-07；后端 2026-08-08 落地）：

1.3 改名安全

公司名可以随时改（改名入口本身还在开发中，见第 2 章）。改名不影响任何项目归属和关联——系统内部靠的是公司 id（形如 org_company_<uuid>），名字只是给人看的。

1.4 现阶段的现实：单人租户

当前版本里，公司创建者就是公司的唯一成员和管理员，没有成员管理界面。多人协作的设计方向见第 6 章。

待补充：公司正式上线时间；公司 id 在哪里可查看（目前无界面）。

2. 公司管理页（org_manage）操作 🟠 已实现待部署

该页面（org_manage.html）与后端接口（/api/my/companies、/api/groups 系列）均已完成（2026-08-08），本地验证通过，待部署到生产后可用。以下步骤按已实现的代码描述，上线后照做即可。

2.1 入口

  1. 打开首页（home.html）。
  2. 页面右上方找到 「🏢 我的公司」 按钮，点击进入公司管理页。
  3. 注意：这个按钮在你拥有公司之后才显示。公司在你创建首个项目时自动生成，所以正常路径是「先建项目 → 按钮出现」。
  4. 若首页没有这个按钮：要么你还没有任何公司，要么该功能尚未在你使用的环境上线（当前线上即此情况）。

2.2 页面布局

页面从上到下三块：

2.2b 成员 Tab（2026-08-09 新增）

成员是人事事实层：加入公司的人（和 agent）登记在这里；新成员默认零权限——权限通过入组、派活（👥 配人）、将来的入职包（P2）显式授予。

2.3 公司列表

公司切换条即公司列表：公司名 + 下挂项目数。当前代码显示名称和项目数两项。

待补充：公司创建时间在设计文档中列为列表字段，当前前端未展示。

2.4 公司改名 【规划中】

设计文档（company-design §5）明确「公司名可后续修改（公司管理页），改名不影响任何关联」，但当前页面的代码里还没有改名入口。上线后如找不到改名位置，属正常——该能力待补。

2.5 默认公司 【规划中】

「默认公司」决定新建项目时下拉框预选哪家公司（只影响新项目的预选，不改变任何已有项目的归属）。后端接口已能返回默认公司（前端会用它做预选和默认选中），但设置默认公司的操作入口尚未开发。

待补充：改名与默认公司设置的界面位置和操作步骤，待前端补做后更新本章。

2.6 公司标配 6 组（自动建仓）🟠 已实现待部署

每家公司创建时，系统自动配好 6 个组，不用手工建（用户定调，2026-08-08）：

规则细节：

为什么标配这 6 个：权限三组对应「看 / 改 / 管」三档画布授权（P2 生效），资源三组对应 IPD 资源线最常用的三个业务域。用不上可以删，需要别的可以自建（§3.3、§4.3）。

3. 权限组管理 🟠 已实现待部署

3.1 权限组是什么

权限组回答一个问题：谁能看、改、删、发布画布。它是「批量授权单位」——把一组人放进组里，给组授权，全组生效。权限组只收真人用户（user），不收 AI agent。

注意（重要）：当前阶段权限组接画布授权链路属于实施分期 P2【规划中】。也就是说，现在建组、加人，只是先把组织结构搭好，还不会实际改变任何人对画布的访问权限。当前线上实际是「项目归创建者本人，非本人无权访问（403）」。

3.2 从模板新建（fork）

平台预置了一套权限模板（BMC 查看者 / BMC 编辑者 / BMC 管理员，已随建库迁移预置，由平台运营在 saas_manage「模板库」维护）。从模板建组的操作：

  1. 进入公司管理页，顶部切换到目标公司。
  2. 确认当前 Tab 是「权限组」。
  3. 点右上角 「+ 从模板新建」。
  4. 弹窗列出平台模板（模板名、版本号 vN、说明）。点想要的模板卡片（或卡片上的「选用」按钮）。
  5. 弹窗关闭，提示「已从模板创建」，列表里出现新组。

「fork」的含义：模板被复制成你公司的实例，之后你可以自由改，和平台模板互不影响；组卡片「来源」一栏会记录它 fork 自哪个模板、哪个版本（溯源信息在详情抽屉顶部也能看到）。平台模板以后升级时，系统能算出你的实例落后了几个版本（升级提醒功能本身【规划中】）。

3.3 自建权限组

  1. 点右上角 「+ 自建」。
  2. 填「名称」（必填，如「画布编辑者」）和「描述」（选填，写清用途）。
  3. 点 「创建」。

自建组没有模板溯源，卡片来源显示「自建」。

3.4 修改、删除权限组

3.5 成员增删

待补充：user_id 在哪里查（当前界面要求手填 ID，无人员选择器）；一个人可同时加入多个权限组（设计已支持多对多）。

4. 资源组管理 🟠 已实现待部署

4.1 资源组是什么

权限组管「权限」，资源组管「人和能力」。资源组是人和 AI agent 共同的「家」——一个业务能力的集合容器。它面向的问题是：哪些人和 agent 能承载什么角色、能投入多少负荷。将来 IPD 推演里的调度 agent 派活时，读的就是资源组的成员、负荷和成本（该链路为 P3【规划中】）。

资源组与权限组的关键区别（设计裁定，两种组是两种东西）：

4.2 从模板新建

平台预置资源模板（采购组 / 研发组 / 财务组，已随建库迁移预置，模板附带业务域标签）。操作步骤与权限组完全相同：切到「资源组」Tab → 「+ 从模板新建」 → 点模板卡片。资源模板在弹窗里会多显示一行「业务域」。

4.3 自建资源组

  1. 点 「+ 自建」。
  2. 填「名称」（必填，如「采购组」）、「描述」。
  3. 选「业务域（kind）」：下拉预置 采购 / 研发 / 财务 / 人力资源 四项；选「自定义…」会出现输入框，可填任意业务域（如 legal）。业务域标签供将来调度 agent 匹配用。
  4. 点 「创建」。

4.4 成员管理：负荷上限与能力标签

资源组成员列表每行显示：图标（👤 真人 / 🤖 agent）、成员 ID、能力标签、负荷上限条、「移除」按钮。

添加成员（抽屉底部表单）：

  1. 类型：下拉选「👤 真人 user」或「🤖 agent」。
  2. 负荷上限 %（capacity_pct）：1–100，默认 100。含义是此人/agent 最多能被挂多少负荷——例如张姐同时还服务别的项目，可以设 80，表示最多把 80% 的精力派给这边的活。
  3. 成员 ID：真人填 user_id；agent 填 agent 注册名（如「供应市场分析」）。
  4. 能力标签：逗号分隔（中英文逗号都行），如 供应商审核, 谈判。
  5. 点 「+ 添加成员」。

移除成员：成员行末点「移除」，确认一次即可。

说明：当前成员行的条形图展示的是负荷上限，不是「当前已占用负荷」。设计上还有「当前负荷」（来自派活记录 assignment 的汇总）和超载预警，属于 P3【规划中】。

4.5 修改、删除资源组

待补充：agent 注册名清单在哪查；「当前负荷」视图上线时间；成员删除时「该成员还有 N 条在职 assignment」的提示（设计已定，代码未做，见第 7 章 FAQ）。

4.6 项目配人（👥 配人，2026-08-09 新增）

项目成立第一步 = 配人：把角色交给人。点公司切换条右侧「👥 配人」→ 顶部选本公司项目 → 行式编辑器逐行配：

设计语义（people-management-design.md §3.2）：assignment = 角色 × 担任者 × 来源组 × 规则载荷（计费/SLA/验收等七项规则载荷为预留字段，v1 只用备注）；授权模板自动收权、调度协商（报价）、绩效回流属后续版本。

5. 新建项目：选公司还是新建公司

5.1 当前线上实际流程 ✅

线上版本现在没有公司这一步：首页点新建项目 → 弹出输入框填项目名 → 确定，项目即创建。你和公司管理页暂时不会打任何交道。（注：公司后端已于 2026-08-08 实现，生产环境要等下次部署才切换为 5.2 的新流程。）

5.2 即将上线的两步流程 🟠 已实现待部署

新流程（前后端均已完成，待部署）把新建项目变成两步：

  1. 首页点新建项目，弹出小表单。
  2. 第一行填 项目名。
  3. 第二行选 公司，二选一：
  4. (•) 加入已有公司（默认选中）：下拉框列出你的公司（每家显示「名称（N 个项目）」），并自动预选你的默认公司。
  5. ( ) 新建公司：下方公司名输入框会自动带出「项目名 + 公司」（随你输入项目名实时联动；你手动改过公司名后就不再联动），可以改成你想要的名字。
  6. 确定后项目创建；若选了新建公司，会提示「已自动创建公司：XXX公司」。

怎么选：同一个生意下的多个项目（不同方案、不同推演线）选「加入已有公司」，权限组/资源组可以复用；互不相关的生意选「新建公司」，保持隔离。一个项目只属于一个公司，建好后挂哪家公司即固定。

兼容性说明：新流程里，如果后端公司接口未就绪（比如部署先于后端），前端会自动回退到 5.1 的老流程（只填项目名），保证项目永远建得起来。

待补充：项目创建后能否改挂到别的公司（设计文档未覆盖，当前规则是「不能」）。

6. 多人协作预告【规划中】

以下均为设计方向，均未实现，列出便于你提前规划：

待补充：邀请流程的具体形态（手机号邀请？链接邀请？）；多人协作上线时间。

7. 常见问题（FAQ）

Q1：为什么我在首页看不到「🏢 我的公司」按钮？ 两个可能：① 你还没有任何公司——公司在创建首个项目时自动生成，先去建一个项目；② 你访问的环境还没上线公司功能（截至 2026-08-08，生产环境尚未部署，属正常；本地开发环境已可用）。

Q2：公司名起错了，能改吗？ 设计上可以，改名不影响任何项目关联（内部靠 id）。但改名入口本身还没做出来【规划中】，目前改不了。

Q3：为什么公司删不掉？ 【规划中】设计规则：还有项目的公司不可删——先把项目迁走或删掉，空公司才可删。另请注意：目前界面上没有删除公司的入口，此规则是后端上线后的行为预告。

Q4：为什么组删不掉 / 成员删不掉？ 分两层说：

Q5：我一个人能有几家公司？ 任意多家。常见于同时经营多个互不相关的业务，各做一个权限壳。但记住：一个项目只能属于一个公司。

Q6：项目建好后能换公司吗？ 不能（当前设计未提供迁移路径）。【待补充】

Q7：我建了权限组、把人加进去了，为什么他还是打不开我的画布？ 因为权限组接入画布授权是 P2【规划中】，现在建组不产生实际授权效果。当前线上规则是：项目只有创建者本人可访问，其他人访问会得到 403。多人协作上线后此限制解除。

Q8：权限组和资源组到底啥区别，我该建哪个？ 口诀：权限组管「谁能动画布」，资源组管「谁能干活」。要给同事开画布权限 → 权限组（只收真人）；要组织干活的人手和 AI agent、管负荷和能力 → 资源组（真人/agent 混合）。两者互不替代，可以都建。

Q9：负荷上限（capacity_pct）填多少合适？ 默认 100 表示此成员可以全负荷投入。身兼多职的真人建议按实际可投入比例填（如 50、80）；agent 一般填 100。它目前是「声明的上限」，等派活链路（P3）上线后，调度会拿它做约束。

待补充：各功能实际上线后的真实报错文案与排查步骤；公司数量/组数量是否有上限（设计未定）。

本手册为第二稿（2026-08-08：groups/公司后端落地、标配 6 组上线前更新）。标注【规划中】的内容以 ontology/docs/company-design.md、ontology/docs/group-design.md 为最终依据；标注 🟠/🟡 的内容以 ontology/public/org_manage.js、ontology/public/home.html 与后端 routes/groups.rs 代码为最终依据。功能上线或设计变更后，请同步更新本手册。

8. 2026-09-12 增补：数据备份 / 定时备份到飞书 / 宣言中心租户隔离

本章功能随 2026-09-12 部署上线。你是公司数据的第一责任人——备份这章请通读。

8.1 🛟 数据备份（手动下载）【已实现】

入口：公司管理（org_manage）→ 左侧「数据」组 →「🛟 数据备份」。

8.2 ⏰ 定时备份到飞书【已实现】

同一页顶部的配置卡：

  1. 先配飞书凭证：如果卡里显示红字「还没配飞书凭证」——点红字里的「点这里直接配」就地弹窗，填你们飞书自建应用的 App ID / App Secret（飞书开放平台 → 开发者后台 → 自建应用 → 凭证与基础信息；应用需开云文档权限）。公司层（📄 飞书凭证）和项目层（项目管理 → 文档影子）配的都认；
  2. ☑ 开启自动备份，设「每隔 N 天」（1-30）、「保留 V 个版本」（1-50），点「保存配置」；
  3. 点「立即推一份」做首次验证——到你们飞书的「明见备份-公司名」文件夹（首次自动建）里应能看到一个 .bin；
  4. 之后每晚 02 点档自动检查到期推送；超过保留数的旧版自动删除；上次推送结果显示在配置卡里（含失败原因）。

8.3 恢复（灾难时）【已实现】

恢复由平台管理员代工（防滥用），你只能提供包：

  1. 把 .bin 发给平台管理员；
  2. 管理员在 SaaS 管理 → 🛟 租户恢复：先演练（解密验证+版本追平+出行数报告，主库不动），确认后真恢复；
  3. 两道闸自动生效：包被改过一个字节=拒收；公司数据还健在=拒收（防止覆盖活人数据）；
  4. 恢复完成后，成员用原手机号+短信码登录即见全部数据。客户下载后平台升过版本也不怕——恢复时自动按迁移链追平到当前版本。

8.4 宣言中心租户隔离【已实现】

8.5 把您的 AI 接上明见（AI 令牌）🟠 已实现待部署

不需要懂任何技术名词，三步：

  1. 发钥匙：设置页 →「🔑 AI 令牌」→ 点「发放」。级别先选「只读」（能看不能改，最安全）。 发放时选定一个项目——您的 AI 只在这一个项目里工作（一个项目一枚钥匙； 要换项目，重新发一枚即可，旧的随手吊销）。那串钥匙只显示一次，当场复制；
  2. 给 AI：把钥匙粘给您自己的 AI（如 Claude Code），对它说一句「用这个令牌连明见， MCP 地址 https://xwos.com.cn/api/agent/mcp；以后我问明见上的任务/特性/需求时，用 mingjian 的工具回答」。配完或换过钥匙要重启 AI 客户端——连接是启动时建立的；
  3. 验一下：打开「网关测试台」（令牌页里有链接），粘钥匙，从上往下点按钮—— 全绿=接上了；有红=把红字截图发给明见客服。 说话技巧：提问带上「明见」两个字——「明见上我有什么任务」，AI 就不会去错地方找。

钥匙安全三条常识：丢了就吊销重发（令牌页一键）；只读和读写分开发；别在群里晒钥匙。

哪些 AI 能拿这枚钥匙用？