# JSD+github解决图床问题（附PicGo+Typora）

## jsd+github

主要是在github添加一个repo用作图床，方便能够修改，避免一些图片莫名消失的可能。



因为一些不可抗力因素，便选择使用jsd加速静态资源的访问，当然博客的话也可以直接用jsd加速访问，不必忍受访问不了的原因。

1. 新建一个images的repo
2. 上传一张图片，此处使用PicGo上传

未使用jsd加速：https://raw.githubusercontent.com/GEAMING2020/images/main/blogimg/3.png

使用jsd加速：https://cdn.jsdelivr.net/gh/GEAMING2020/images/blogimg/3.png

很明显第二个链接更加“丝滑”

jsd链接的形式

```
https://cdn.jsdelivr.net/gh/GEAMING2020/images/blogimg/3.png
```

`https://cdn.jsdelivr.net/gh/username/repo/`+`仓库中路径`

### [jsd的一些进阶操作（摘自网络）](https://www.imooc.com/article/304189?block_id=tuijian_wz)

> 1. 指定 release 版本号/提交 sha1/分支名称，例如指定获取该仓库的名称为 `1.2.0` 或 `v1.2.0` 的 release 版本资源：
>
>    ```
>    https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.js
>    ```
>
>    如果指定版本为 `1` 或者 `1.2`，那它会自动匹配到这个范围内的最新版本号。
>
>    也可以不指定版本或者指定版本为 `latest`，这样总是使用最新版本的资源。
>
> 2. 压缩资源，在 js/css 文件后缀前面加上 `.min`：
>
>    ```
>    https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.min.js
>    ```
>
> 3. 合并多个文件，用 `combine/file1,file2,file3` 格式的链接：
>
>    ```
>    https://cdn.jsdelivr.net/combine/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.min.js,gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/simple-jekyll-search.min.js
>    ```
>
> 压缩资源、合并文件的 CDN 链接在第一次有人访问时可能比较慢，后面再有人访问就快了。
>
> 其它知识点：
>
> - 可以通过 `https://cdn.jsdelivr.net/combine/gh/mzlogin/mzlogin.github.io[@<版本号>]/[<文件夹>/]` 这样的路径浏览缓存文件列表；
> - 可以访问 `https://purge.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.js` 来清除指定文件的缓存；（将引用的 CDN 链接里的 `cdn` 改成 `purge` 就是了）
> - 可以访问 `https://data.jsdelivr.com/v1/package/gh/mzlogin/mzlogin.github.io` 来查看 CDN 上的 tags 和 versions 列表，更多数据接口参数参见 https://github.com/jsdelivr/data.jsdelivr.com。

## PicGo+Typora

po一些设定，设置之后Typora中的图片自动由PicGo上传到github并替换掉本地图床，挺方便的。

自定义路径里面换成jsd的路径来替换原本路径，加速访问

token生成时候把repo全部勾选即可

JSD+github解决图床问题（附PicGo+Typora）

# 配置git代理

将git走代理，避免git连接远程仓库超时。



用户目录下找到`.gitconfig`文件，`proxy`后添加本地代理，记得替换成对应的端口地址。

```
[user]
	name = 全局用户名
	email = 全局邮箱
[core]
	longpaths = true
[http]
	proxy = http://127.0.0.1:对应端口
[filter "lfs"]
	clean = git-lfs clean -- %f
	smudge = git-lfs smudge -- %f
	process = git-lfs filter-process
	required = true
```

## 参考

配置git代理

# 文献综述指南

因某课程考核需要，故开此篇作为撰写文献综述指南。记录主要记录**文献综述相关要点**和**实用工具**。



## 相关要点

”综“：综合分析整理，是基础

”述“：对所整理文献的结论和观点进行叙述和评论，是提升

### 文献检索与再检索

全面系统在多个数据库检索，关注所检索文献被引用情况。

- 使用文献管理软件（Endnote、Zotero等）
- 记录检索过程，以便重复检索
- 确定文献检索涵盖范围（即保留/不保留标准）
- 不仅要看研究论文，也要看之前综述，在先前基础上找到创新点
- 做好文献阅读笔记，写下自己的思考和想法，标注好文献信息

### 综述选题

选取前沿热点或者现有研究关键点，有Key point，不要什么都想包括

#### 前沿创新热点

针对该研究方向较新、相关研究较少、尚处于起步阶段。

可以通过探讨该技术/方向的潜力和可行性，分析该技术/方向的优势性所在；接着对于目前存在的研究困境，结合其他交叉学科提出可行性解决方案；最后对于该技术/方向全面分析。

#### 现有研究关键点

针对该研究方向已属于热点，现有相关基础研究很多。

建议通过聚焦现有研究突破口，针对某个关键环节（例如某个特殊的影响因素、某个工艺背景等）来说明问题、解决问题，而不是全篇通盘考虑，什么都想包括，什么都想概括。

### 综述构成

过往研究（Previous publications）+理论框架（Theoretical framework）+研究意义（Significance of this work）

#### 过往研究

汇聚与主题相关的前人研究

1. 不要单纯罗列，而是将研究成果分门别类、加以评价展示
2. 作为故事背景，写法上要服务后文故事主题以及故事目的

#### 理论框架

提供理解你研究成果的最佳视角

1. 没有现成结构，需要综述相关概念和理论来搭建
2. 文中所在位置可选多变，根据研究思路和论文内容来安排

#### 研究意义

强调本工作有何研究价值和意义

1. 总结文献综述
2. 对已综述的内容进行批判性审视，同时本研究工作所作出贡献应与所指问题相对应

### 综述写作关键Tips

避免直接引用；勤举各种示例；讨论主次分明；紧扣研究问题；不要简单罗列；善用图表分析

#### 避免直接引用

用自己的话对论文观点进行概括解释，如果专业术语无法回避，仅直接使用专业术语，其他用自己语言衔接。

#### 勤举各种示例

避免抽象描述某个理论或者某个结论，通过在后接上各种例子（用自己话概括原文内容），便于读者理解。

#### 讨论主次分明

并非所有相关的研究需要具体阐述的，根据文献的重要性和相关性去衡量。（可以通过Connected Paper确定）

#### 紧扣研究问题

时刻评估所讨论的文献/理论/概念对于理解你本研究有何意义，以及对于回答研究问题有何帮助。

#### 不要简单罗列

避免简单罗列文献，重要的是思考并评价文献，忌讳人与亦云，没有自己观点，也没有对文献加以批评和运用。

#### 善用图表分析

大段的文字不如图表来的直观，既有助于自己进行总结，找到差异和问题所在；也有助于读者阅读理解。

## 实用工具

### paper-digest

![image-20221212095301729](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221212095301729.png)

网址：http://www.paper-digest.com/

输入pdf链接或者本地上传pdf，通过AI自动生成相关文献的总结。

以"OpenFlow: Enabling Innovation in Campus Networks"为例：

![image-20221212095720698](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221212095720698.png)

### PaperDigest

![image-20221212095827224](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221212095827224.png)

网址：https://www.paperdigest.org/

与上面同名，但作用不同。主要用于查找相关领域文献，并自动生成总结。但是每次只能搜索十篇，数量不太够。

以"Attention"为例：虽然我想搜的是NLP里面的注意力机制，但是因为All Areas返回的是神经学相关的注意力🤣

![image-20221212100127773](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221212100127773.png)

### Connected Papers

网址：

通过输入文献，可以获得与文献相关的论文知识图谱，追踪文献的引用和被引关系。

### Stork文献鸟

网址：

通过输入研究方向的关键词，设定提醒时间，文献鸟会定时将符合关键词的文献发送邮件。

### research rabbit

![image-20221212103541652](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221212103541652.png)

网址：https://researchrabbitapp.com/

构建自己的文献库，并查看文献之间的关系，推荐相关联的文献。

### 润色工具

- [Grammarly](https://www.grammarly.com/)

- [Ginger](https://www.gingersoftware.com/)

- [Linggle](https://www.linggle.com/)

  - 使用指南：https://zhuanlan.zhihu.com/p/437285088
  
- [1checker](http://www.1checker.com/)
- 给写的段落打分
  

## 参考

https://www.bilibili.com/video/BV1de4y117is/

https://zhuanlan.zhihu.com/p/437285088

https://www.bilibili.com/video/BV1d14y1a7vA/

https://www.bilibili.com/video/BV1SB4y197kG/

文献综述指南

# 使用python进行邮件发送

需求：因为有时候会在服务器上进行模型的训练，希望能够及时获得模型训练的消息便加入此功能

同时为了方便调用，我将这个代码处理成为了函数。

因为本人只提供一个通知功能，对于邮件内其他内容，如附件等仅做简单讨论，其他情况读者可以自行搜索，尝试。



## 发送文本信息

`send_email_text`：

```python
def send_email_text(
    from_addr: str,
    password: str,
    to_addr: str,
    smtp_server: str,
    text: str,
    from_who: str,
    to_who: str,
    theme: str,
) -> bool:
    r"""
    发送纯文本邮件到指定邮箱地址
    Args:
        from_addr (str):发送方的邮件地址
        password (str):smtp授权码
        to_addr (str):接收方邮件地址
        smtp_server (str):发送方服务器，例，若发送方为@qq.com则发送方服务器为smtp.qq.com
        text (str):邮件内容
        from_who (str):发送方名称
        to_who (str):接收方名称
        theme (str):邮件主题
    Returns:
        send_flag (bool):是否成功发送邮件
    """
    import smtplib  # smtplib 用于邮件的发信动作
    from email.mime.text import MIMEText  # email 用于构建邮件内容
    from email.header import Header  # 构建邮件头

    # 邮件内容
    msg = MIMEText(text, "plain", "utf-8")
    msg["From"] = Header(from_who)  # 发送者
    msg["To"] = Header(to_who)  # 接收者
    subject = theme
    msg["Subject"] = Header(theme, "utf-8")  # 邮件主题
    try:
        smtpobj = smtplib.SMTP_SSL(smtp_server)
        smtpobj.connect(smtp_server, 465)  # 建立连接--qq邮箱服务和端口号（可百度查询）
        smtpobj.login(from_addr, password)  # 登录--发送者账号和口令
        smtpobj.sendmail(from_addr, to_addr, msg.as_string())
        send_flag = True
    except smtplib.SMTPException:
        send_flag = False
    finally:
        # 关闭服务器
        smtpobj.quit()
        return send_flag
```

调用例子：

```python
print(
    send_email_text(
        from_addr="---",
        password="---",
        to_addr="---",
        smtp_server="smtp.qq.com",
        text="test send_email function",
        from_who="Geaming",
        to_who="another Geaming",
        theme="function test",
    )
)
```





![image-20221030022140713](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/杂项/image-20221030022140713.png)

![image-20221030022249261](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/杂项/image-20221030022249261.png)

**特别提醒**

在调用时候请注意发送方服务器和对应端口。

## 发送携带附件的邮件

有些时候可能会有携带一些附件的发送需求，提供函数如下：

新增入参：

```python
attachments (List[str]):附件地址列表
attachments_name (List[str]):附件名称列表
```

```python
import typing
def send_email(
    from_addr: str,
    password: str,
    to_addr: str,
    smtp_server: str,
    text: str,
    from_who: str,
    to_who: str,
    theme: str,
    attachments: typing.List[str],
    attachments_name: typing.List[str],
) -> bool:
    r"""
    发送纯文本邮件到指定邮箱地址
    Args:
        from_addr (str):发送方的邮件地址
        password (str):smtp授权码
        to_addr (str):接收方邮件地址
        smtp_server (str):发送方服务器，例，若发送方为@qq.com则发送方服务器为smtp.qq.com
        text (str):邮件内容
        from_who (str):发送方名称
        to_who (str):接收方名称
        theme (str):邮件主题
        attachments (List[str]):附件地址列表
        attachments_name (List[str]):附件名称列表
    Returns:
        send_flag (bool):是否成功发送邮件
    """
    import smtplib  # smtplib 用于邮件的发信动作
    from email.mime.text import MIMEText  # email 用于构建邮件内容
    from email.mime.multipart import MIMEMultipart
    from email.header import Header  # 构建邮件头

    # 邮件内容
    msg = MIMEMultipart()
    msg.attach(MIMEText(text, "plain", "utf-8"))
    msg["From"] = Header(from_who)  # 发送者
    msg["To"] = Header(to_who)  # 接收者
    subject = theme
    msg["Subject"] = Header(theme, "utf-8")  # 邮件主题
    for idx, att_path in enumerate(attachments):
        att = MIMEText(open(att_path, "rb").read(), "base64", "utf-8")
        att["Content-Type"] = "application/octet-stream"
        # 这里的filename可以任意写，写什么名字，邮件中显示什么名字
        att["Content-Disposition"] = f'attachment; filename="{attachments_name[idx]}"'
        msg.attach(att)
    try:
        smtpobj = smtplib.SMTP_SSL(smtp_server)
        smtpobj.connect(smtp_server, 465)  # 建立连接--qq邮箱服务和端口号（可百度查询）
        smtpobj.login(from_addr, password)  # 登录--发送者账号和口令
        smtpobj.sendmail(from_addr, to_addr, msg.as_string())
        send_flag = True
    except smtplib.SMTPException:
        send_flag = False
    finally:
        # 关闭服务器
        smtpobj.quit()
        return send_flag
```

调用例子：

```python
print(
    send_email(
        from_addr="---",
        password="---",
        to_addr="---",
        smtp_server="smtp.qq.com",
        text="test send_email function",
        from_who="Geaming",
        to_who="another Geaming",
        theme="function test",
        attachments=[
            r"---\1.jpg",
            r"---\1.txt",
        ],
        attachments_name=["1.jpg", "1.txt"],
    )
)
```

![image-20221030024419317](https://github.com/Geaming-CHN/images/blob/main/blogimg/杂项/image-20221030024419317.png?raw=true)

![image-20221030024629660](https://github.com/Geaming-CHN/images/blob/main/blogimg/杂项/image-20221030024629660.png?raw=true)

**特别提醒**

在调用时候，附件传入路径请使用raw string。

## 参考

- [手把手教python发送邮件](https://blog.csdn.net/LOVEYSUXIN/article/details/124274549)

使用python进行邮件发送

# 🤗Hugging Face使用向

🤗Hugging Face官方链接：https://huggingface.co/

涉及Hugging Face生态及Hugging Face主干库：Transformer模型库、Dataset数据集库、Tokenizer分词库



![image-20221024021324165](https://cdn.jsdelivr.net/gh/GEAMING-CHN/images/blogimg/%E6%9D%82%E9%A1%B9/image-20221024021324165.png)

## Transformer模型库

```
pip install transformers
# 开发版本
# pip install transformers[sentencepiece]
```



## 参考资料

[Hugging Face 系列视频](https://www.bilibili.com/video/BV1YU4y1g753)