文档 CocoSpark

安装

系统要求

项目	最低要求
操作系统	Windows 10+、macOS 11+、Ubuntu 20.04+ / Debian 11+
处理器	x86_64 或 ARM64
内存	4 GB（推荐 8 GB 以上）
磁盘空间	200 MB（不含AI运行时）
Java	Java 11+（已内置，无需单独安装）

下载

前往 下载页面 获取适用于你操作系统的安装包：

平台	安装包	说明
Windows	CocoSpark-Setup.exe	双击运行安装向导，支持自定义安装路径
macOS	CocoSpark.dmg	打开DMG文件，将CocoSpark拖入Applications文件夹
Linux	cocospark.deb / cocospark.rpm	使用 dpkg -i 或 rpm -i 安装

安装步骤

Windows：下载 .exe 安装包后双击运行。按照安装向导提示选择安装路径，点击"安装"即可完成。安装完成后，桌面和开始菜单中会出现CocoSpark的快捷方式。

macOS：下载 .dmg 文件后双击挂载，将 CocoSpark 图标拖入 Applications 文件夹。首次打开时，如果系统提示"无法验证开发者"，请前往 系统设置 > 隐私与安全性 中点击"仍要打开"。

Linux：对于 Debian/Ubuntu 系列，使用以下命令安装：

sudo dpkg -i cocospark_1.0.0_amd64.deb
sudo apt-get install -f

对于 Fedora/RHEL 系列：

sudo rpm -i cocospark-1.0.0.x86_64.rpm

首次使用

启动与创建工作区

安装完成后启动 CocoSpark，你将看到欢迎页面。首先需要创建一个 工作区（Workspace）。工作区是 CocoSpark 管理文件和项目的基本单位，所有AI对话记录和文档都保存在工作区内。

点击欢迎页面中的 "打开文件夹" 按钮，选择你的项目文件夹或新建一个空文件夹作为工作区。CocoSpark 会自动在该文件夹下创建 .cocospark 目录来存储配置和对话历史。

选择AI提供商

CocoSpark 支持 8 大 AI 提供商。首次使用时，你可以在 设置 > AI提供商 中配置你偏好的AI服务。每个提供商的配置方式不同，详见下方 配置AI提供商 章节。

你也可以同时配置多个提供商，在对话过程中随时切换。CocoSpark 会记住每个对话使用的提供商，确保上下文连贯。

开始第一次对话

配置好AI提供商后，点击左侧面板中的 "新建对话" 按钮（或使用快捷键 Ctrl+N），即可开始与AI对话。

你可以在对话中直接询问编程问题、请求AI帮助撰写文档、分析代码，或者讨论任何话题。对话记录会自动保存在当前工作区中，支持全文搜索和收藏。

配置AI提供商

CocoSpark 通过集成已有的AI工具和CLI来接入各大AI服务。以下是目前支持的所有提供商及其配置要求：

提供商	需要安装	API Key
Claude Code	Node.js + Claude CLI	Anthropic账号
DeepSeek (Cline)	VS Code + Cline扩展	DeepSeek API Key
DeepSeek (OpenCode)	OpenCode CLI	DeepSeek API Key
GitHub Copilot	-	GitHub账号
Google Gemini	Gemini CLI	Google账号
Ollama	Ollama	不需要（本地运行）
OpenAI Codex	Codex CLI	OpenAI账号
通义千问	Qwen Code CLI	阿里云账号

配置步骤：打开 设置 > AI提供商，选择你想要使用的提供商，按照界面提示完成安装和认证即可。CocoSpark 会自动检测你已安装的工具，并在状态栏中显示当前可用的AI服务。

如果你希望在无网络环境下使用AI，推荐安装 Ollama。Ollama 支持在本地运行开源大模型（如 Llama、Qwen 等），所有数据完全在本地处理，无需联网。

CocoMark基础语法

CocoMark 是 CocoSpark 专为正式文档设计的标记语言。与 Markdown 不同，CocoMark 采用 名称=内容 的格式来定义文档结构，这使得它天然适合生成符合国标排版规范的 Word 和 PDF 文档。

基本格式

CocoMark 的核心语法非常简单：使用 数字=标题文字 来定义各级标题，正文内容直接书写，无需任何标记符号。

0=文档标题
1=一级标题
正文内容直接书写，无需任何标记。
2=二级标题
这是二级标题下的内容。

其中，0 表示文档标题（对应 Word 文档的封面标题），1 表示一级标题，2 表示二级标题，以此类推。正文文字直接写在标题行之后，不需要添加任何前缀或标记。

完整示例

下面是一个典型的 CocoMark 文档示例：

0=2026年度工作总结报告
1=工作概述
本年度团队共完成了13个项目的开发与交付，涵盖数据可视化、文档引擎、语法高亮等多个技术方向。
2=重点项目
CocoSpark 作为旗舰产品，已实现 AI 工作台和智能文档两大核心功能。
2=团队建设
持续推进开源社区建设，6个核心库均已在 GitHub 上公开发布。
1=下阶段计划
持续优化产品体验，扩大用户规模。

标题与段落

标题级别

CocoMark 支持 0 到 15 共 16 个标题级别。数字越小，级别越高：

级别	语法	对应含义
0	0=文档标题	文档主标题（封面标题）
1	1=一级标题	章级标题
2	2=二级标题	节级标题
3	3=三级标题	小节标题
4-15	4=四级标题 ...	更深层次标题（适用于复杂文档结构）

中英文别名

除了使用数字，CocoMark 还支持中文和英文别名来定义标题，提升可读性：

title=文档标题
h1=一级标题
h2=二级标题
h3=三级标题

中文别名同样可用：

标题=文档标题
一级=一级标题
二级=二级标题

数字、英文别名和中文别名可以在同一文档中混合使用，效果完全等价。

样式表达式

你可以在标题级别后使用方括号 [] 添加行内样式，精确控制标题的外观：

1[bold,color=red]=重要警告
2[italic,fontSize=18]=备注说明
1[center,underline]=居中带下划线的标题

样式表达式中支持多个属性用逗号分隔。常用的样式属性包括：bold（加粗）、italic（斜体）、underline（下划线）、center（居中）、color（颜色）、fontSize（字号）等。

段落

在 CocoMark 中，段落无需任何标记，直接书写即可。连续的文本行会被合并为同一段落，空行用于分隔不同段落：

1=概述
这是第一个段落的内容。CocoMark 会自动
将连续的文本行合并为同一段落。

这是第二个段落，由空行分隔。

表格

CocoMark 使用 table={...} 语法来定义表格。表头使用 head= 声明，数据行直接用逗号分隔各列内容：

table={
  head=序号, 姓名, 成绩
  1, 张三, 92
  2, 李四, 88
  3, 王五, 95
}

上面的代码会生成一个包含表头和三行数据的标准表格。

表格变体

CocoMark 内置了 7 种表格类型，适用于不同的文档场景：

类型	语法名称	说明
通用表格	table	标准表格，适用于大多数场景
三线表	sxb	学术论文常用的三线表样式
全边框表	qdb	四周和内部均有边框线的表格
无边框表	wkx	无任何边框线，适用于布局排版
条纹表	twb	奇偶行交替背景色，提升可读性
紧凑表	jcb	减小内边距，适用于数据密集场景
宽松表	ksb	增大内边距，适用于展示性表格

使用方式与 table 相同，只需替换关键字即可。例如使用三线表：

sxb={
  head=实验组, 样本数, 均值, 标准差
  对照组, 30, 72.5, 8.3
  实验组A, 30, 81.2, 7.1
  实验组B, 30, 85.6, 6.8
}

图片与媒体

在 CocoMark 中插入图片非常直观。最简单的方式是使用 image= 加上文件名或路径：

image=photo.png

如果需要控制图片的显示尺寸或其他属性，使用花括号展开参数：

image={
  src=diagram.png
  width=80%
}

支持的属性

属性	说明	示例
src	图片路径（相对路径或绝对路径）	src=images/fig1.png
width	图片宽度（百分比或像素）	width=60%
height	图片高度	height=300px
title	图片标题（显示在图片下方）	title=图1 系统架构图
align	对齐方式：left / center / right	align=center

完整示例

image={
  src=architecture.png
  width=90%
  align=center
  title=图1 CocoSpark系统架构图
}

图片路径支持相对路径（相对于当前文档所在目录）和绝对路径。建议将图片统一放在文档同目录下的 images 文件夹中进行管理。

图表与公式

CocoMark 支持直接嵌入 Mermaid 图表、ECharts 可视化图表和 MathJax 数学公式，无需额外配置。

Mermaid 图表

使用 mermaid={...} 语法嵌入流程图、时序图、甘特图等 Mermaid 支持的所有图表类型：

mermaid={
  graph TD
  A[开始] --> B{判断}
  B -->|是| C[执行]
  B -->|否| D[结束]
}

上面的代码会渲染出一个从上到下的流程图。你可以使用 Mermaid 的完整语法来绘制各类图表，包括流程图（graph）、时序图（sequenceDiagram）、甘特图（gantt）、类图（classDiagram）等。

ECharts 图表

使用 echarts={...} 语法嵌入 ECharts 可视化图表，支持 ECharts 的完整配置项：

echarts={
  type=bar
  title=季度销售数据
  xAxis=Q1, Q2, Q3, Q4
  data=120, 200, 150, 280
}

数学公式

使用 mathjax= 语法插入 LaTeX 数学公式。行内公式直接书写，块级公式使用花括号：

mathjax=E=mc^2

对于复杂的多行公式，可以使用花括号展开：

mathjax={
  \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
}

CocoSpark 内置了 MathJax 渲染引擎，支持完整的 LaTeX 数学语法，在编辑器中即可实时预览公式渲染效果。

样式控制

CocoMark 支持通过方括号 [] 为任意元素添加行内样式，让你在保持标记语法简洁性的同时，精确控制文档的视觉呈现。

基本语法

在元素的级别编号或名称后，添加方括号括起的样式属性列表：

1[bold,color=red]=重要标题

多个样式属性用逗号分隔。上面的例子会生成一个加粗且字体为红色的一级标题。

常用样式属性

属性	说明	示例
bold	加粗	1[bold]=加粗标题
italic	斜体	2[italic]=斜体标题
underline	下划线	1[underline]=下划线标题
center	居中对齐	1[center]=居中标题
color	文字颜色（支持颜色名称和十六进制值）	1[color=#ff5722]=橙色标题
fontSize	字体大小	2[fontSize=20]=大字号标题
bgColor	背景颜色	1[bgColor=yellow]=高亮标题

组合使用

多个样式可以自由组合，满足复杂的排版需求：

1[bold,center,color=navy,fontSize=24]=年度报告封面标题
2[italic,color=gray]=副标题说明文字
3[underline,bold]=重要小节标题

样式控制让你无需离开标记语法即可实现精细化的文档排版，尤其适合需要自定义格式的正式文档场景。

导出HTML

CocoSpark 支持将 CocoMark 文档导出为独立的 HTML 文件，方便在浏览器中查看和分享。

导出步骤

打开你要导出的 CocoMark 文档，点击工具栏中的 "导出" 按钮（或使用快捷键 Ctrl+E），在弹出的导出对话框中选择 "HTML" 格式，设定输出路径后点击"导出"即可。

导出的 HTML 文件是完全独立的单文件，所有样式和图片均已内联嵌入，无需额外依赖。你可以直接用浏览器打开查看，也可以发布到网站或发送给他人。

HTML 导出支持保留 Mermaid 图表、ECharts 图表和 MathJax 公式的渲染效果，确保导出结果与编辑器中的预览完全一致。

导出Word

导出 Word 文档是 CocoSpark 的核心功能之一。CocoMark 语法从设计之初就以生成符合中国国家标准排版规范的 Word 文档为目标。

选择国标规范

在导出 Word 时，你需要选择一个排版规范。CocoSpark 目前支持两种主要的国家标准：

标准	名称	适用场景
GB/T 7713	科学技术报告、学位论文和学术论文的编写格式	学术论文、毕业设计、实验报告、科技文档
GB/T 9704	党政机关公文格式	通知、请示、批复、报告等党政公文

导出步骤

点击 "导出" > "Word"，在导出对话框中选择所需的国标规范，设定输出路径后点击导出。CocoSpark 会根据所选标准自动设置页边距、字体字号、标题编号、行距、页眉页脚等所有格式细节。

导出的 .docx 文件可以在 Microsoft Word、WPS Office 或 LibreOffice 中正常打开和编辑。文档格式完全符合对应国标的要求，可直接用于提交和打印。

导出PDF

CocoSpark 支持将 CocoMark 文档导出为 PDF 格式。PDF 导出基于 HTML 渲染引擎实现，先将文档渲染为高质量的 HTML 页面，再转换为 PDF 文件。

点击 "导出" > "PDF"，选择纸张大小（默认为 A4）和页面方向，设定输出路径后即可导出。导出的 PDF 文件保留了完整的排版效果，包括图表、公式和图片。

如果你需要符合国标排版规范的打印输出，建议优先使用 导出 Word 功能，然后在 Word 中另存为 PDF，以确保字体嵌入和格式精确性达到最佳效果。