From f4544652c49b738d35da203264011351b7002b39 Mon Sep 17 00:00:00 2001
From: qyh15 <qyh15@local>
Date: Tue, 9 Jun 2026 10:27:19 +0800
Subject: [PATCH] Add Chinese README

---
 README.md | 182 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 182 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e8a2357
--- /dev/null
+++ b/README.md
@@ -0,0 +1,182 @@
+# QQcites
+
+QQcites 是用于论文写作阶段“按句子/段落/性能表查找参考文献”的 Codex skill。它的核心目标不是泛泛搜索文献，而是优先使用用户本地的 Zotero、Obsidian 文献笔记和 QQnote 生成内容，为具体 manuscript claim 找到可防守、可追溯、尽量不重复的引用。
+
+## 适用场景
+
+- 给论文中的一句话、一个段落或一个 claim 推荐参考文献。
+- 用户明确要求“需要综述”时，只推荐综述或优先推荐综述。
+- 用户要求“不要重复”时，按 DOI、Zotero key、题名和第一作者年份排查重复。
+- 为性能对比表筛选文献，例如光驱动器、湿度驱动器、传感器、TENG、光热效率等。
+- 从本地 PDF 原文中提取参数，并判断该文献是否适合进入主表。
+- 在本地文献不足时，再补充网页或数据库检索，并标注为库外或 web-sourced。
+
+## 核心原则
+
+1. 本地优先  
+   先查 QQnote/Obsidian/Zotero，再考虑网页检索。强本地证据不应被弱网页结果替代。
+
+2. 证据优先  
+   文献必须真正支持当前句子或表格参数，不能只因为标题关键词相似就推荐。
+
+3. 不重复优先  
+   推荐前检查当前 manuscript citation ledger 或从对话中推断已用文献。已用文献除非不可替代，否则降级或排除。
+
+4. 综述按需  
+   只有用户明确说“需要综述”“综述优先”等，才强制综述；具体实验、性能、机制参数通常优先原始研究。
+
+5. 参数可追溯  
+   性能参数必须记录来源层级，例如 main text、figure caption、supporting information、graph digitization、abstract only 或 calculated。
+
+## 基本文献推荐流程
+
+1. 拆分 claim  
+   将用户输入拆成一个个可引用的 claim，提取材料、机制、方法、应用、性能指标和边界条件。
+
+2. 检查重复  
+   读取 manuscript-specific ledger；没有 ledger 时，至少根据当前对话中已使用的 DOI、Zotero key、题名和作者年份排重。
+
+3. 本地检索  
+   优先搜索 Obsidian 文献笔记和 Zotero 元数据，必要时读取本地 PDF 原文。
+
+4. 语义筛选  
+   判断候选文献是 direct、partial、background、weak、contradictory，还是 metadata-only candidate。
+
+5. 排序输出  
+   按相关度、证据强度、文献类型、是否重复、元数据完整性排序。
+
+6. 记录 ledger  
+   输出后应能追加到 used-reference log 或 performance-table ledger。
+
+## 性能对比表方法论
+
+性能表不能只按关键词找文献。先定义硬性纳入标准，再筛选主表文献。
+
+常见纳入标准：
+
+- 材料体系是否匹配，例如 MOF 基、BC 基、MXene 基等。
+- 刺激类型是否匹配，例如光驱动、湿度驱动、电驱动、TENG 等。
+- 是否为原始研究，而不是综述。
+- 是否报告目标参数，例如曲率、光强、响应时间、温升、光热效率。
+- 单位是否能统一。
+- 是否在本地 Zotero/Obsidian 中存在。
+
+默认分层：
+
+| 分层 | 含义 |
+|---|---|
+| main-table usable | 可进主表。原始研究，材料/刺激匹配，直接给目标参数或可可靠换算。 |
+| supplemental comparison | 可做补充对照。相关但报告的是角度、速度、位移、应用演示等不同指标。 |
+| not recommended | 不建议使用。综述、非目标材料、非目标刺激、无性能参数或只做背景支持。 |
+
+## 参数来源等级
+
+每个性能参数都应标注来源：
+
+| 来源等级 | 用法 |
+|---|---|
+| main text | 正文直接给出数值。 |
+| figure caption | 图注给出数值。 |
+| supporting information | SI 或 Supplementary Note/Table/Figure 中给出。 |
+| graph digitization | 已经从图中读数。 |
+| needs digitization | 只能在图中看到趋势，尚未读数。 |
+| abstract only | 仅摘要中出现。 |
+| calculated | 根据原文参数换算或计算。 |
+
+如果值来自图读数，必须标注 `graph digitization`。如果还没有读数，只能标注 `needs digitization`，不能当成原文直接报道值。
+
+## 单位统一规则
+
+- 曲率统一为 `cm^-1`。
+- `1 mm^-1 = 10 cm^-1`。
+- 光强统一为 `mW cm^-2`。
+- `1 W cm^-2 = 1000 mW cm^-2`。
+- 如果原文只给总功率，例如 `125 mW`，但没有照射面积，应写 `total power, not normalized`，不能直接换算成 `mW cm^-2`。
+- 最高温度、温升和光热转换效率不是同一个指标，应分别记录为 `Tmax`、`Delta T` 和 `photothermal conversion efficiency`。
+
+角度转曲率只在有效长度明确时使用：
+
+```text
+kappa = theta(rad) / L(cm)
+```
+
+如果缺少有效长度或几何不适合换算，应写 `not convertible from main text`。
+
+## 推荐输出格式
+
+句子引用推荐：
+
+| Rank | Citation candidate | Type | Strength | Why it fits | Suggested use |
+|---:|---|---|---|---|---|
+| 1 | Title. Journal, Year. DOI: ... | review/primary | direct/background | ... | Cite after clause ... |
+
+性能表推荐：
+
+| 文献 | 材料体系 | 刺激与强度 | 响应时间 | 最大性能 | 关键备注 |
+|---|---|---:|---:|---:|---|
+| Journal volume (year) pages | MOF/system | 300 mW cm^-2 | 10 s | 1.20 cm^-1 | main text; local Zotero |
+
+不可比文献应单独列出：
+
+| 文献 | 原因 |
+|---|---|
+| Title, Year | angle-only; effective length missing |
+| Title, Year | figure only; needs digitization |
+
+## 与 Nature 系列 skill 的差异
+
+QQcites 更偏向用户本地文献库和材料科学论文写作；Nature 系列 skill 更偏向 Nature/CNS 范围、在线结构化检索、引用导出和全文 source map。
+
+QQcites 已吸收的关键方法包括：
+
+- 分段 claim 检索。
+- 支持等级判断。
+- DOI/Zotero key/title/author 去重。
+- 本地 PDF 原文参数抽取。
+- 性能表纳入/排除标准。
+- 图读数和单位换算风险标注。
+
+后续可继续增强：
+
+- 稳定 claim ID，例如 `S001`、`S002`。
+- RIS/BibTeX/ENW 导出。
+- citation verification 模式。
+- 图表 source map，记录页码、图号、表号和参数来源。
+
+## 仓库与同步位置
+
+项目副本：
+
+```text
+E:\11 AI\01 Codex\01 Skills\qqcites
+```
+
+Codex 已安装副本：
+
+```text
+C:\Users\qyh15\.codex\skills\qqcites
+```
+
+Obsidian 备份：
+
+```text
+C:\Users\qyh15\Documents\Obsidian Vault\Codex Skills\qqcites
+```
+
+Gitea 远程：
+
+```text
+git@git.qyhhh.top:Skills/QQcites.git
+```
+
+同步规则：修改项目副本后，应同步到 Codex 已安装副本和 Obsidian 备份，再提交并推送到 Gitea。
+
+## 常用 Git 命令
+
+```powershell
+git -C "E:\11 AI\01 Codex\01 Skills\qqcites" status
+git -C "E:\11 AI\01 Codex\01 Skills\qqcites" add .
+git -C "E:\11 AI\01 Codex\01 Skills\qqcites" commit -m "Update qqcites"
+git -C "E:\11 AI\01 Codex\01 Skills\qqcites" push
+```
+