云馨AI COSMIC 智能文档工具 · 用户操作手册-平芜编程栈

云馨AI COSMIC 智能文档工具 · 用户操作手册

产品名称：云馨AI COSMIC 智能文档工具 V1.0
官网地址：http://cosmic.yunxinai.com/
软件著作权登记号：2026SR0602365（国家版权局登记）
文档版本：V1.0 ｜编制日期：2026-08-18

第 1 章产品概述

1.1 产品简介

云馨AI COSMIC 是一款智能功能点度量与文档工具，面向开发、产品与造价评估团队，提供"从需求文档到可交付 Excel"的一条链路规模度量准备能力，减少手工整理与反复核对。

产品已获国家版权局计算机软件著作权登记（登记号 2026SR0602365），覆盖需求解析、模板编写、Excel 校验与功能点对比四大环节。

1.2 核心能力

能力	说明
需求一键生成	上传 Word / PDF / Excel 需求文档，解析功能点后生成 COSMIC 文件包
COSMIC 编写	按标准模板导入业务数据，自动编写功能点并导出结果 Excel
Excel 校验	检查关键列组合是否全局唯一，快速定位重复行
功能点对比	需求侧与系统侧对照，自动输出差异清单，辅助范围确认

1.3 适用对象

角色	使用价值
开发团队	把需求材料快速转成可核对的功能点结果，减少重复整理
产品同学	用对比清单看需求覆盖与缺口，辅助范围确认
造价评估	拿到更规范的 COSMIC Excel，作为规模度量准备输入

1.4 总体使用流程

上传材料 → AI 编写 → 校验对比 → 导出交付 （需求文档或标准模板数据） （自动生成功能点） （去重与双侧差异） （可交付 Excel）

一次完整流程后，您将得到：

可下载的 COSMIC Excel 结果表
配套系统需求说明书（文件包内）
可编辑确认的功能点清单
校验与对比后的核对依据

1.5 术语说明

术语	说明
COSMIC	一种软件规模度量方法（ISO/IEC 19761），以功能点（CFP）量化软件规模
功能点	COSMIC 度量的基本单位，由功能过程及其数据移动构成
需求侧 / 系统侧	对比场景中的两方材料：需求规格说明书 vs 系统功能文档（或 COSMIC Excel）
Token	平台计费单位，用于计量大模型调用；通常 1 个汉字 ≈ 1.5～2 个 Token

第 2 章快速上手

2.1 注册账号

操作入口：官网首页右上角【免费注册】，或直接访问http://cosmic.yunxinai.com/register

操作步骤：

在注册页填写手机号码；
设置密码，并在"确认密码"中再次输入；
输入图形验证码（按图片内容填写）；
点击【发送验证码】，将手机短信收到的短信验证码填入；
点击【注册】，完成后即可进入工作台。

注意：注册采用手机号 + 短信验证开通，注册成功即可使用需求一键生成、模板编写、Excel 校验与功能点对比全部功能。

2.2 登录工作台

操作入口：官网首页右上角【登录】，或直接访问http://cosmic.yunxinai.com/login

操作步骤：

输入账号（注册手机号）；
输入密码；
按图片内容输入验证码；
（可选）勾选记住密码，下次免输；
点击【登录】，进入工作台。

注意：验证码区分形近字符（如 Z/2、B/8、5/S），若提示"图形验证码错误"，点击验证码图片刷新后重新输入。

2.3 工作台总览

登录后默认进入工作台（/center）。页面包含：

顶部导航栏：全部功能入口（详见 2.4）；
四步流程导览：上传需求 → AI 编写 → 校验对比 → 导出交付；
推荐入口：需求一键生成（主路径：需求文档 → 功能点 → COSMIC）；
更多能力：COSMIC 编写、Excel 校验、功能点对比三张功能卡片；
产品与资质：软著证书查看入口；
使用建议：大批量请分批导入；先用少量数据试跑流程更稳妥。

2.4 顶部导航结构

导航项	子菜单	说明
工作台	—	返回工作台首页
COSMIC	需求一键生成 / 模板编写 / 编写记录	功能点生成相关入口
功能点对比	功能点对比 / 对比记录	差异分析相关入口
工具	Excel 校验 / Token 用量	辅助工具与账户额度
COSMIC记录	—	编写历史列表（同"编写记录"）
功能点对比列表	—	对比历史列表（同"对比记录"）
去官网	—	返回产品官网首页
头像（账号名）	个人中心 / 布局设置 / 退出登录	账户管理

第 3 章功能操作详解

3.1 需求一键生成

功能简介：上传 Word / PDF / Excel 需求文档，系统自动解析提取功能点，确认编辑后生成 COSMIC 文件包（含 Excel 结果表与系统需求说明书）。适合还没有填好模板、希望从原始需求直接起步的场景。

操作入口：顶部导航【COSMIC】→【需求一键生成】；或工作台"推荐入口"卡片点击【上传需求文档】

规格限制：

支持格式：docx/pdf/xlsx，每次上传 1 个文件
单次最多50 条，超量请分批
平均约2 分钟出结果

操作步骤：

上传文档：点击【选择需求文档】，选择本地需求规格说明书；
解析功能点：点击【上传并解析】，系统自动提取功能点；
确认编辑：解析完成后在弹窗中核对功能点，支持新增、修改、删除与批量操作；
确认提交：核对无误后提交，按上限生成 COSMIC（单次 ≤ 50 条）；
下载交付：生成完成后在【编写记录】中下载 COSMIC 文件包（压缩包，含 Excel 与系统需求说明书）。

注意事项：

建议先用少量数据试跑，确认文档结构可被正确解析；
生成期间保持网络畅通，无需重复提交；
该过程会产生 Token 消耗（文档上传、功能点提取、生成 COSMIC 分别计量）。

3.2 COSMIC 编写（模板流程）

功能简介：按标准模板导入业务数据，系统自动编写 COSMIC 功能点并导出结果。适合已有结构化材料的场景。

操作入口：顶部导航【COSMIC】→【模板编写】；或工作台"COSMIC 编写"卡片点击【开始编写】

规格限制：仅支持.xlsx，单次最多50 条，平均约2 分钟出结果。

操作步骤：

下载模板：点击【下载模板】，获取标准 Excel 模板文件；
填写数据：按模板结构填写真实业务数据（红色 * 列为必填，详见附录 A）；
- Sheet1：功能点信息
- Sheet2：数据属性信息
上传编写：点击【选择 Excel】选中填好的文件，再点击【开始上传】，系统自动生成功能点结果；
下载交付：生成完成后在【编写记录】中下载压缩包（含 Excel 与系统需求说明书）。

注意事项：

务必使用系统模板填写，避免字段不兼容导致导入失败；
导入失败时优先检查必填项与字段格式；
大批量请分批导入；
提交后约 2 分钟完成，请勿重复提交。

3.3 编写记录（COSMIC 记录）

功能简介：展示本账号全部 COSMIC 生成历史，支持检索与结果导出。

操作入口：顶部导航【COSMIC】→【编写记录】；或直接点击导航【COSMIC记录】

操作步骤：

进入记录列表，可按用户名搜索，点击【搜索】/【重置】；
列表展示每条记录的业务耗时、消耗 Token、创建时间；
点击对应行的【导出】按钮，下载该次生成的 COSMIC 结果文件包；
列表支持分页浏览（可选 10 条/页等）。

页面快捷入口：列表上方提供【COSMIC 模版导入】【需求文档一键生成 COSMIC】按钮，可直接跳转对应功能页。

3.4 功能点对比

功能简介：需求侧与系统侧对照，系统流式输出功能点对比结果，自动生成差异清单，适合范围确认与缺口排查。

操作入口：顶部导航【功能点对比】→【功能点对比】；或工作台"功能点对比"卡片点击【去对比】

规格限制：支持docx/xlsx/pdf，需求侧与系统侧各上传 1 个文件。

操作步骤：

上传需求侧（文档 A）：在"需求规格说明书"区域点击【选择需求文档】，上传原始需求文档，用于生成需求侧功能清单；
上传系统侧（文档 B）：在"系统功能文档"区域点击【选择系统文档】，可上传系统功能说明，或已生成的 COSMIC Excel（建议与需求侧材料对应同一版本范围）；
生成对比：两侧文件都选好后，点击【一键生成功能点对比清单】，系统流式输出对比结果；
复制结果：对比完成后，在"对比清单结果"区域查看差异清单，支持一键复制到剪贴板。

注意事项：

两侧文件都选择后，【一键生成功能点对比清单】按钮才可点击；
对比结果会同步保存到【对比记录】，可后续导出 Word。

3.5 对比记录（功能点对比列表）

功能简介：展示本账号全部功能点对比历史，支持检索与 Word 导出。

操作入口：顶部导航【功能点对比】→【对比记录】；或直接点击导航【功能点对比列表】

操作步骤：

进入列表，可按用户名搜索；
列表展示每条记录的业务耗时（秒）、消耗 Token、创建时间；
点击【导出 Word】，下载该次对比的差异清单文档；
点击列表上方【需求比对】按钮，可直接跳转功能点对比页。

3.6 Excel 校验

功能简介：检查 COSMIC Excel 中关键列组合是否全局唯一，快速定位重复行，作为交付前的质量门禁。

操作入口：顶部导航【工具】→【Excel 校验】；或工作台"Excel 校验"卡片点击【打开校验】

规格限制：支持.xlsx/.xls。

校验规则：上传结果表后，系统校验以下列相关组合是否全局唯一，并标出重复行：

第 8 列：子过程描述
第 10 列：数据组
第 11 列：数据属性

发现重复时，返回行号与重复列信息，方便直接修正。

操作步骤：

选择文件：点击【选择文件】，上传 COSMIC Excel（建议使用系统导出的标准结果表，避免自定义列导致校验偏差）；
开始校验：点击【开始校验】，系统检查关键列组合唯一性；
查看结果：按重复列筛选定位问题行，直接对照修改；
修正后复验：改完再次上传确认，校验通过后即可用于交付或后续对比。

注意事项：若出现大量重复，建议先按重复列筛选定位问题行，再批量修正。

第 4 章账号与个人中心

4.1 Token 用量

功能简介：查看账户 Token 概览（总量 / 已用 / 剩余）、消耗明细、充值档位与计费说明。

操作入口：顶部导航【工具】→【Token 用量】；或工作台底部【查看 Token 用量】

页面内容：

账户概览：总 Token、已用 Token、剩余 Token；
充值档位（永久有效，按需选择）：

金额	赠送 Token
50 元	40w token
100 元	100w token
200 元	250w token
500 元	900w token

充值请联系微信cqyunxinai（页面内点击微信号即可复制）。

消耗明细：仅展示当前登录账号记录，按时间倒序，包含业务类型、消耗 Token、关联记录、耗时（秒）、备注、时间；
计费说明：
- 通常 1 个汉字 ≈ 1.5～2 个 Token；
- 示例：输入 18 + 输出 2631 = 总量 2649；
- Excel 导入、需求解析、生成与对比都会产生消耗；
- 精简输入、分批处理有助于降低单次消耗。

4.2 个人资料

操作入口：点击右上角头像（账号名）→【个人中心】

可执行操作：

上传头像：点击个人信息卡中的头像图片；
查看账号信息：用户名称、手机号码、用户邮箱、所属部门、所属角色、创建日期；
编辑基本资料：在【基本资料】选项卡中修改用户昵称（必填）、手机号码（必填）、邮箱（必填）、性别，点击【保存】生效。

4.3 修改密码

操作入口：个人中心 →【修改密码】选项卡

操作步骤：

输入旧密码；
输入新密码；
再次输入确认密码；
点击【保存】完成修改。

4.4 退出登录

操作入口：点击右上角头像（账号名）→【退出登录】，退出后返回登录页。

第 5 章端到端操作示例

以下以"一份需求规格说明书"为例，串起完整链路：

┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ 1 上传需求文档 │ → │ 2 AI 编写 │ → │ 3 校验对比 │ → │ 4 导出交付 │ │ 需求一键生成页 │ │ 解析+确认 │ │ 校验+对比 │ │ 记录页下载 │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘

步骤	操作	入口	产出
1	上传需求文档并解析	COSMIC → 需求一键生成	可编辑的功能点清单（弹窗）
2	核对功能点后确认提交	同上	生成任务（约 2 分钟）
3	下载 COSMIC 文件包	COSMIC → 编写记录 → 导出	压缩包（Excel + 系统需求说明书）
4	交付前校验 Excel	工具 → Excel 校验	重复行检查报告（通过/行号定位）
5	（可选）与系统侧对比	功能点对比 → 功能点对比	差异清单（可复制/导出 Word）

建议：大批量需求请分批导入（单次 ≤ 50 条）；先用少量数据试跑流程，确认文档结构可被正确解析后再全量执行。

第 6 章常见问题 FAQ

Q1：支持哪些文件格式？

需求一键生成：docx/pdf/xlsx
COSMIC 编写：仅.xlsx（必须使用系统模板）
功能点对比：docx/xlsx/pdf（双侧各 1 个文件）
Excel 校验：.xlsx/.xls

Q2：单次可以处理多少条数据？
统一上限50 条/次，超量请分批导入。

Q3：生成需要多长时间？
平均约2 分钟。生成期间请保持网络畅通，无需重复提交。

Q4：解析出来的功能点不对怎么办？
解析完成后会弹出确认窗口，支持新增、修改、删除与批量操作，核对无误后再提交生成。

Q5：Excel 校验发现重复行怎么办？
按结果中的行号与重复列信息定位问题行，在 Excel 中修正后重新上传复验，直至通过。

Q6：Token 是怎么扣的？用完了怎么办？
Excel 导入、需求解析、生成与对比都会产生消耗（1 汉字 ≈ 1.5～2 Token）。在【工具 → Token 用量】查看余额与明细；不足时微信联系cqyunxinai充值，充值永久有效。

Q7：忘记密码怎么办？
目前登录页未提供自助找回入口，请联系客服：微信cqyunxinai，邮箱master@yunxinai.com。

附录

附录 A：导出物说明

功能	导出物
需求一键生成 / COSMIC 编写	COSMIC 文件包（压缩包，含结果 Excel + 系统需求说明书），在【编写记录】中下载
功能点对比	差异清单（页面一键复制；或在【对比记录】中导出 Word）

附录 B：产品资质

产品名称：云馨AI COSMIC智能文档工具 V1.0
登记号：2026SR0602365
登记机构：国家版权局（计算机软件著作权登记）
证书原件：官网首页 / 工作台"产品与资质"区域点击查看

附录 C：联系方式

渠道	信息
微信	cqyunxinai（Token 充值 / 使用问题）
邮箱	master@yunxinai.com
官网	http://cosmic.yunxinai.com/

本手册基于 2026-08-18 线上版本编写，后续功能更新以官网实际页面为准。

云馨AI COSMIC 智能文档工具 · 用户操作手册