diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 448df30..ec9d2ff 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -32,6 +32,7 @@ export default defineConfig({ items: [ { text: "产品介绍", link: "/xcodeclaw" }, { text: "飞书机器人配置", link: "/guide/feishu-bot" }, + { text: "新用户上手指引", link: "/guide/trial-guide" }, ], }, ], diff --git a/docs/guide/feishu-bot.md b/docs/guide/feishu-bot.md index acdc7ac..82eb056 100644 --- a/docs/guide/feishu-bot.md +++ b/docs/guide/feishu-bot.md @@ -222,6 +222,8 @@ App Secret 是应用的密钥，请妥善保管，不要在公开场合泄露。 :::tip 配置完成 🎉 应用发布后，在飞书中搜索您创建的机器人名称，发送任意消息即可开始使用。 + +👉 不知道从哪开始？查看 [新用户上手指引](/guide/trial-guide)，5 分钟体验完整学术工作流。 ::: ## 9. 授权飞书资源访问 diff --git a/docs/guide/trial-guide.md b/docs/guide/trial-guide.md new file mode 100644 index 0000000..e8d8dde --- /dev/null +++ b/docs/guide/trial-guide.md @@ -0,0 +1,378 @@ +--- +title: XCodeClaw 新用户上手指引 +--- + + + +# XCodeClaw 新用户上手指引 + +5 分钟体验完整学术工作流：文献检索 → 综述撰写 → AI 配图 → LaTeX 排版 + +## 第一步：认识你的学术助手 + +打开飞书，找到你的机器人（管理员创建时会告诉你名字），发送第一条消息——**介绍一下自己**。 + +
+
+
你
+
你好！我叫李明，是材料科学与工程专业的硕士研究生，研究方向是钙钛矿太阳能电池的稳定性优化。
+
+
+
🦞
+
你好李明！我是学术龙虾🦞，你的专属 AI 科研助手。很高兴认识你！

钙钛矿太阳能电池是个非常热门的研究方向，我可以帮你进行文献检索、论文写作、数据分析和图表制作。需要我帮你做什么？
+
+
+ +:::tip 为什么要先自我介绍？ +AI 会根据你的专业背景调整回答的深度和术语使用。介绍越具体，后续对话越精准。建议包含：**姓名、专业方向、当前研究课题**。 +::: + +## 第二步：体验文献检索 + +告诉龙虾你想了解的研究主题，它会自动检索学术论文数据库并联网搜索最新进展。 + +
+
试试发送
+
帮我检索一下「钙钛矿太阳能电池稳定性」的最新研究进展，找 10 篇高引用论文。
+ +
+ +龙虾会做两件事： + +
+
+
📚
+

学术论文检索

+

通过 OpenAlex 搜索学术论文，返回标题、作者、引用量、DOI、摘要等结构化信息。

+
+
+
🌐
+

Tavily 联网搜索

+

实时搜索最新学术动态、综述报告和前沿趋势，补充论文数据库尚未收录的内容。

+
+
+ +## 第三步：撰写文献综述 + +检索完成后，让龙虾帮你把论文整理成一篇结构化的文献综述。 + +
+
试试发送
+
根据检索到的论文，帮我写一篇关于「钙钛矿太阳能电池稳定性优化策略」的文献综述，要求： +1. 按研究主题分类（如界面工程、封装技术、组分优化等） +2. 每篇引用的论文要标注作者、年份和 DOI +3. 最后总结当前研究的不足和未来方向
+ +
+ +龙虾会生成一篇带有**规范学术引用**的综述文稿。所有引用均来自真实论文，拒绝编造。 + +## 第四步：AI 生成配图 + +综述写好后，让龙虾为你生成一张与主题相关的学术插图。 + +
+
试试发送
+
帮我画一张钙钛矿太阳能电池结构的示意图，要求学术风格、清晰标注各层结构，适合放在综述论文中。
+ +
+ +
+
+
🎨
+

Banana 画图

+

内置 Gemini 4K 画图引擎，支持流程图、结构示意图、架构图等学术插图生成。

+
+
+
📊
+

Python 数据可视化

+

也可以让龙虾用 matplotlib / seaborn 绘制数据图表，直接输出高分辨率图片。

+
+
+ +## 第五步：LaTeX 排版输出 PDF + +最后一步——将综述和配图整合为专业排版的 PDF 文档。 + +
+
试试发送
+
把刚才的综述整理成 LaTeX 格式，插入配图，用 xelatex 编译成 PDF 发给我。要求中文排版，使用宋体正文、黑体标题。
+ +
+ +:::tip 支持的 LaTeX 功能 +预装 TeX Live 完整版 + 中文字体（宋体、黑体、微软雅黑、Noto CJK），支持 `ctex` 宏包、`biblatex` 文献管理、`tikz` 绘图等。编译完成后直接发送 PDF 文件到飞书对话。 +::: + +## 完整流程一览 + +
+
+
+
1
+
+
+
+

自我介绍

+

告诉龙虾你的名字、专业和研究方向，建立个性化上下文。

+
+
+
+
+
2
+
+
+
+

文献检索

+

学术论文数据库 + Tavily 联网搜索，获取高质量文献。

+
+
+
+
+
3
+
+
+
+

撰写综述

+

结构化文献综述，规范学术引用，拒绝编造。

+
+
+
+
+
4
+
+
+
+

AI 配图

+

Banana 4K 画图 / matplotlib 数据可视化，论文插图一步到位。

+
+
+
+
+
5
+
+
+

LaTeX 输出 PDF

+

专业中文排版，自动编译，直接发送 PDF 到飞书。

+
+
+
+ +## 上手后，还可以探索更多 + +
+
+
🔬
+

深度调研

+

多轮检索、交叉引用分析、输出完整研究报告。

+
+
+
✍️
+

论文润色降重

+

学术写作优化，消除 AI 痕迹，保持学术规范。

+
+
+
🧮
+

科学计算

+

NumPy / SciPy / pandas / scikit-learn，数据分析与统计建模。

+
+
+
📄
+

飞书文档协作

+

发送 /feishu auth 授权后，可直接读写飞书文档和多维表格。

+
+
+ +:::warning 温馨提示 +首次使用建议发送 `/feishu auth` 完成飞书资源授权，解锁文档读写等高级功能。详见 [配置指南 - 授权飞书资源访问](/guide/feishu-bot#_9-授权飞书资源访问)。 +::: + + diff --git a/docs/index.md b/docs/index.md index a8c49ca..f07570e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,7 +10,7 @@ hero: text: 快速开始 link: /guide/ - theme: alt - text: OpenClaw + text: XCodeClaw link: /xcodeclaw features: