用途：这是 Factorial Code（fcode）的平台使用指南技能，面向基于 Factorial Public API 构建应用与自动化的用户旅程与支持。应用本身的构建（进程、模块、CLI、表单）由其他 fcode-* 技能负责。详细分阶段说明见 references/journey.md，常见问题见 references/troubleshooting.md。
用户角色：Factorial 内部开发者可自行在 Backoffice 创建 OAuth 应用并直接用 Demo 生成器创建演示公司，内部有 Slack #factorial-code-users；合作伙伴需管理员预配置 OAuth 应用，演示公司需申请；个人贡献者与合作伙伴相同，不应称其为“终端客户”。所有角色都通过 Public API 访问，且属于某个开发团队，团队内应用共享。
平台结构：一切位于 https://code.factorialhr.com，分为 docs（公开文档与申请访问表单）、dashboard（应用控制台）、platform（工作区控制台，含进程、执行、计划、变量、版本、API 凭证）。
旅程概览：1 申请访问 → 2 在 Apps 创建应用（名称用途、JavaScript/Python、OAuth scopes、是否启用 integrations framework）→ 3 App detail 页的 Getting started 清单 → 4 App settings 的 OAuth 标签配置凭证 → 5 本地用 CLI 开发（fcode clone、fcode team:clone、fcode push）→ 6 获取演示公司 → 7 在 Test marketplace 做真实 OAuth 安装测试 → 8 在 Production 标签请求发布 → 9 在 Publication 标签发布上架 → 10 生产 marketplace 可见可装，每次安装获得独立工作区。
工作区：dev-{appId} 开发，prod-{appId} 生产（代码只读，变量为线上共享），deploy-{installationId} 每个安装独立。注意工作区在控制台/API/CLI 中也称 “team”，与人类开发团队含义不同。发布版本为固定 tag，stable 别名指向当前版本；marketplace 应用须走发布流程，不可手动发布版本或移动 stable。
Factorial 内按钮（UI 触发器）：已安装的 marketplace 应用可在 Factorial 页面放置按钮，位置 id 由 Factorial 团队提供，部分位置一次仅允许一个应用，配置在进程页或 metadata.json，详见 fcode-ui-triggers。
支持规则：只依据已记录流程与公开文档回答，不得编造 UI、URL、命令或政策；先确认用户角色；按页面与区域名描述流程；管理员操作只讲结果；用用户语言回答；有网络时先读文档；需要时升级。路由：平台模型→fcode-core-concepts；CLI→fcode-cli；进程代码→fcode-javascript / fcode-python；表单 schema→fcode-json-schema；网页表单→fcode-forms；Factorial actions→fcode-factorial-actions；UI 触发器→fcode-ui-triggers；智能体方法/MCP→fcode-agent；示例→fcode-examples。文档路径相对于 https://code.factorialhr.com。
升级与管理员操作：访问申请待审会通知结果；合作伙伴/个人贡献者的 OAuth 由管理员预配置；演示公司在 Demo companies 页申请后邮件通知；发布审核后要么部署要么通知需修改；提升到生产由所属团队的 Factorial 管理员自助，其他走操作员；私有应用安装由管理员或提供公司 ID 的开发者创建；提高限额无自助升级，内部走 Slack，其他走 Factorial 联系人。