项目管理手册
本页说明 SkillFlaw 项目模块的入口、界面结构与主要操作路径。 内容覆盖列表页页签、项目详情页签、版本动作、资源绑定与 API 接入区。
入口位置
用户通过 项目管理 菜单进入该模块。 列表页包含三个一级页签：
- 开发
- 广场
- 个人 / 已绑定
页面截图
本手册包含列表页页签、关键新增 / 修改弹窗，以及详情页主要页签的真实截图。
项目开发页签
这张页面是所选作用域下项目创建与维护的主工作台。
它体现了：
- 项目开发 / 项目广场 / 个人项目 一级页签切换
- 作用域为 个人
- 组织、权限、状态、关键字筛选区
- 新建项目 入口卡片
- 可进入详情页的项目卡片
新增项目弹窗
弹窗包含的关键字段有：
- 所属租户
- 所属业务域
- 项目名称
- 所属组织
- 受众类型
- Icon / Logo
- 项目说明
界面行为要点：
- 在个人上 下文创建时，租户与业务域会按可写作用域固定展示
- 组织与受众类型是必填项
- 图标既可以输入，也可以上传
- 描述支持 AI 草稿辅助生成
项目广场页签
该页面是项目的浏览与发现入口，可见：
- 租户筛选
- 范围选择器
- 组织与权限筛选
- 关键字搜索
- 更广可读范围内的已发布项目卡片
个人项目页签
该页面展示个人上下文下已绑定项目的区域。 当用户尚未绑定任何个人项目时，页面会展示对应空态。
项目详情页签
该页面展示了默认 项目详情页签以及页头动作区。
可见内容包括：
- 项目标识、状态、受众类型
- 页头动作：创建版本、发布、下线、修改
- 选中版本提示
- 基础信息、版本概览、资源概览、API 概览四个摘要分区
修改项目弹窗
该弹窗复用了项目主表单，并预填项目已有信息。 与新增相比，它展示的是项目的可编辑值。
项目技能页签
该页签是项目级技能内容维护区。 页面包含：
- 生成后的 SKILL Markdown 预览
- 查看原文
- 自动生成
- 编辑技能
项目资源页签
项目资源页签拆分为两个内层页签：
- 绑定的工作流
- 绑定的技能
截图展示的是 绑定的工作流 子页签，可见：
- 关联工作流 入口
- 展示租户、业务域、范围、在线存在状态、访问类型、创建者、版本、更新时间的工作流表格
- 行级 Remove 动作
- 批量移除区域
项目资源“绑定的技能”子页签
当前抓取到的 绑定的技能 子页签展示了该项目的空态。 页面仍保留 关联技能 入口，但还没有任何技能资源被绑定进项目。
绑定工作流弹窗
工作流绑定采用独立弹窗完成。 弹窗包含：
- 租户选择器
- 范围选择器
- 一级业务域选择器
- 工作流关键字输入框
- 搜索 查询动作
- 已选数量指示
- 分页结果表格区域
- 确认关联工作流 确认动作
当前抓取状态下，结果区是明确空态：暂无可关联的工作流。
绑定技能弹窗
技能绑定同样走独立弹窗。 弹窗包含：
- 租户选择器
- 范围选择器
- 一级业务域选择器
- 技能关键字输入框
- 搜索 查询动作
- 已选数量指示
- 含 ID、名称、租户、业务域、范围、更新时间的候选表格
- 确认关联技能 确认动作
解绑工作流确认弹窗
移除已绑定工作流不是直接生效，而是需要单独确认。 弹窗会明确展示待解绑的工作流 ID，并提供 取消 与 移除工作流 两个动作。
项目版本页签
项目版本页签是项目版本发布工作区。 截图展示了：
- 版本选择器
- 当前在线版本摘要
- 版本详情 / 技能 / 绑定的工作流 / 绑定的技能 内层页签
项目版本“技能”子页签
所选版本还会保留自己的技能快照。 截图展示的是版本级 markdown 快照页面，包含 查看原文 入口，以及该版本的业务标识和调用路径摘要。
项目版本“绑定的工作流”子页签
该子页签展示所选版本内固化的工作流快照。 页面会列出工作流 ID、名称、租户、业务域、范围、在线存在状态、创建者与创建时间。
项目版本“绑定的技能”子页签
当前抓取到的版本级 绑定的技能 页面是空态。 页面明确提示：该版本快照中还没有绑定任何技能。
创建版本弹窗
弹窗包含：
- Version
- 发布说明
- SKILL 来源
可见的技能来源选项有：
- 使用当前 SKILL
- 自动 生成项目技能
发布项目版本弹窗
发布不是直接点击即生效，而是单独弹出确认窗口。 弹窗要求先选择要发布的版本，再通过 下一步 继续，同时提供关闭与 取消 返回路径。
项目版本下线弹窗
下线也采用独立确认弹窗。 告警明确说明：清空当前在线版本后，项目调用入口将不再指向任何在线版本。
项目授权页签
项目授权页签是项目授权维护页。 页面继续拆分为：
- 用户授权
- 用户组授权
- 组织授权
截图展示的是用户授权视图，包含搜索与 添加用户授权 入口。
新增用户授权弹窗
用户授权新增采用选择式弹窗。 弹窗包含：
- 用户搜索输入框
- 已选数量指示
- 搜索 查询动作
- 含 用户 ID、用户名、昵称 的候选表格
- 分页控件
- 添加用户授权 与 确认 动作
项目授权“用户组授权”子页签
用户组授权视图提供：
- 用户组搜索框
- 搜索 查询动作
- 添加用户组授权 新增授权入口
- 当前无任何已授权用户组时的空态 提示
新增用户组授权弹窗
用户组授权新增也采用独立弹窗。 弹窗包含：
- 用户组搜索输入框
- 已选数量指示
- 搜索 查询动作
- 含 用户组 ID、用户组名称、备注 的候选表格
- 添加用户组授权 与 确认 动作
当前抓取状态下，候选区为空，并明确提示没有可授权的用户组候选项。
项目授权“组织授权”子页签
组织授权视图沿用了相同的维护模式。 页面包含组织搜索、显式新增授权入口，以及“尚无已授权组织”的空态提示。
新增组织授权弹窗
组织授权新增使用独立弹窗。 弹窗包含：
- 组织搜索输入框
- 已选数量指示
- 搜索 查询动作
- 包含子组织 复选框
- 含 组织 ID、组织名称、组织简称 的候选表格
- 添加组织授权 与 确认 动作
项目 API 接入页签
API 接入页签不只是单纯展示一个 URL，还包含：
- 工作流调用 与 技能下载 两个内层页签
- 调用地址摘要
- 多在线工作流时的目标工作流选择器
- 权限与调用说明
- Python / JavaScript / cURL 示例代码页签
项目 API“技能下载”子页签
技能下载 是单独的下载说明界面。 截图展示了：
- 目标技能选择器
- “下载接口是 GET 且无 request body”的说明
- 当项目尚无可下载在线技能时的真实空态提示
项目访问日志页签
访问日志页签在截图中显示为空态页面，表示该视图当前未展示访问日志内容。
列表页
开发页签
开发页签是所选工作范围下的主维护界面。 支持的用户动作包括：
- 新增项目
- 打开项目详情
- 编辑项目元数据
- 删除项目
支持的筛选包括：
- 权限 / 受众类型
- 组织
- 业务域
- 状态
- 关键字
项目创建依赖所选上下文中的写入权限；当对应权限不可用时，创建卡片会直接禁用。
创建流程使用独立弹窗，而不是在列表页内联编辑。
广场页签
广场页签是项目的可见资源浏览与绑定界面。 支持的筛选包括：
- 租户
- 范围
- 组织
- 业务域
- 权限 / 受众类型
- 关键字
当项目被标记为可绑定时，卡片会暴露 绑定 或 解绑 动作。
广场页截图也表明：系统租户项目与个人项目可以同时出现在浏览面，但资源归属标签仍会分别展示。
个人页签
个人页签展示用户上下文下已经绑定的项目。 它的关注点更偏向“已绑定资源管理”，而不是广场式的广泛发现。
截图对应空态，因此本手册也覆盖“尚无已绑定项目”的页面表现。
项目详情页
打开项目后，会进入多页签的详情工作区。 详情页包含：
- 详情
- Skill
- 资源
- 版本
- 授权
- API
- 日志
项目详情页签
项目详情页签展示项目画像与摘要信息，包括：
- 租户
- 受众类型
- 业务域
- 组织
- 在线版本
- 工作流数量
- 关联技能数量
- API 路径摘要
页头动作包括：
- 创建版本
- 发布
- 下线
- 修改项目
这些动作都依赖项目的修改权限。
修改 动作会打开独立编辑弹窗，而不是原地改写详情页。 发布 与 下线 也都通过单独确认弹窗执行，而不是直接落操作。
技能页签
技能页签用于维护项目技能内容。 支持的动作包括：
- 编辑项目 skill markdown
- 保存回项目
- 自动生成项目 skill 草稿
页面还提供 查看原文 等预览辅助动作。
项目资源页签
项目资源页签用于维护项目绑定的工作流与技能。 支持的动作包括：
- 添加工作流
- 移除单个工作流
- 批量移除工作流
- 添加技能
- 移除单个技能
- 批量移除技能
页面拆分为 绑定的工作流 与 绑定的技能 两个内层页签。已抓取的工作流视图也表明，表格会直接展示资源归属与线上存在状态。 工作流绑定、技能绑定都通过独立选择弹窗完成，而工作流解绑则使用独立确认弹窗。
版本页签
版本页签是项目版本与上线流程的主入口。 支持的动作包括：
- 创建新版本
- 填写版本备注
- 选择技能来源
- 将选中版本发布上线
- 将当前在线版本下线
- 查看选中版本详情
版本工作区还继续拆分为版本详情、版本技能快照、绑定工作流快照、绑定技能快照。
创建版本流程使用独立弹窗，并要求显式填写版本号。
授权信息页签
授权信息页签用于维护项目授权数据。 它挂在项目详情内部，而不是单独放在列表页完成。
页面进一步拆分为用户、用户组、组织三类授权子视图。 当前抓取到的用户组与组织子页都属于“可新增、但暂未授权任何对象”的空态。 用户、用户组、组织三类新增授权都采用各自独立的选择弹窗，而不是在列表页内联编辑。
API 接入页签
API 接入页签汇总项目的调用路径与 API 接入信息，是项目对外调用说明与代码片段的用户入口。
页面进一步确认：
- 多工作流项目必须显式传
workflow_id - 页面提供多语言示例代码
- API 入口区分工作流调用与技能下载两类调用面
- 技能下载走独立 GET 下载语义，在没有可下载在线技能时允许出现空态
访问日志页签
访问日志页签用于展示项目访问日志信息；当暂无日志数据时，页面会显示空态。
权限与边界
项目模块遵循平台权限口径：
- 创建项目依赖所选作用域中的写入权限
- 编辑、删除、版本发布、版本下线、技能编辑、资源维护等动作，依赖目标项目的修改或删除权限
- 项目详情行为以项目自身 tenant / business 归属为准，而不是用页面上下文做替代