Foreword

欢迎来到ANA入社考核环节，我们一共为大家准备了四个任务，时间安排和分值分配列举如下。安排这些任务的目的不是为了难，而是为了教学。我们非常欢迎学习能力强的小白，但我们不欢迎不愿意学习新知识的任何人。其中，申请者必须在Task 1中获得至少9分并且Task 1没有逾期，才可能具有入社资格。但是，本着以教学为主要原则，未完成Task 1目标的申请人仍然有资格参加后续的培训和任务，但无法加入研发部。但是不用担心，每一个Task都有详细的说明文档，我们不会默认被考核者具有某些先修知识。In other words, we are following one of the security principles: Use fail-safe default.

• Oct. 7th 00:00 - Oct. 13th 23:59 Task 1 c-basic (10 pts): 在这个任务中，你将熟悉C语言基本语法。
• Oct. 14th 00:00 - Oct. 20th 23:59 Task 2 upgrade-service (20 pts): 在这个任务中，你将熟悉C++ Standard Library（STL）的使用，并利用STL设计一个算法解决相关问题。
• Oct. 21st 00:00 - Oct. 27th 23:59 Task 3 http (30 pts): 在这个任务中，你将熟悉各种C语言系统调用和http服务器的构成，这些POSIX标准下的系统调用在其他语言中仍然非常有用，因为它们是基于C的。
• Oct. 28th 00:00 - Nov. 3rd 23:59 Task 4 An End-to-End Encrypted File Sharing System (40 pts): 在这个任务中，你将熟悉Go基本语法，并使用Go开发一些接口。除此之外，我们还会介绍一些密码学相关知识，你可以选择使用或不使用这些知识设计你的接口。

招新政策

如果你在所有任务中一共获得了至少68分，我们会认为你的技术达到了我们研发部的要求，但是，最终能否进入社团，还需要参考当年最大允许招收人数。如果名额充足，总分大于等于68的同学将全部被录取。即，68是我们的最低分数线。

包容性

我们希望营造一个开放和包容的学习环境，为此，我们打算支持多元化的观点和经验，并尊重所有人。同时，作为本考核的参与者，请认识到你可以积极主动地让其他同学感到被包容和受到尊重。

诚信政策

我们对学术诚信有最严格的要求，如果你违反了我们的学术诚信政策，将被取消本次考核成绩，并被记录在ANA诚信档案库中，永久不得加入ANA。

你可以做的：

• 向另一位同学解释一个概念，或要求另一位同学向你解释一个概念。
• 讨论项目组件的各种算法和方法。
• 讨论测试策略和方法。
• 在线搜索通用（非项目特定）抽象的算法或实现（例如，搜索哈希表的各种实现）。
• 帮助另一位同学使用高级调试方法（请注意，为其他同学提供代码解决方案甚至查看他们的代码是不可接受的，如下所述）。

你不可以做的：

• 抄袭任何其他参与考核者的代码。
• 从 CSDN、Stack Overflow、Pastebin 和 GitHub 上的公共存储库等在线资源复制代码。
• 在考核结束后公开发布你的代码。任何公开形式都不被允许，包括但不限于公开自己的student仓库、将自己的答案上传到github公共仓库等。
• 尝试破坏autograder，包括但不限于与外部用户建立网络连接、使用长输出攻击autograder、试图泄露autograder的机密等。

Getting started

Setup environment

首先让我们来进行环境配置，社团提供教学机器，所有环境都已经配置好，你可以在教学机器上完成所有考核项目。你也可以自己配置环境并在自己的PC上完成所有考核项目。

如果你选择在自己的PC上配置环境并且碰到了无法解决的问题，我们的社员有权拒绝回答此类问题，请使用教学机器。

ssh

我们已经为所有参与考核的人建立了账户，你可以使用ssh连接到你的账户：

ssh是什么？

ssh是一个终端命令，需要在终端环境下运行。Windows用户可以按下win+r并输入cmd，按下回车即可打开终端。

ssh被广泛用于连接远端设备。教学机器和你的pc是两台独立的设备，要从一台设备上访问另一台设备上的文件，就可以使用ssh在两台设备间建立可信连接，并进行数据传输。通常ssh只能打开另一个设备上的终端，但是如果你精通终端命令，打开终端和使用GUI访问从根本上来说没有区别。

有关ssh的更多知识请在Linux环境的终端中输入man ssh或者使用Google search: man ssh

校内连接方式：

$ ssh [email protected] -p 59999

校外连接方式：

$ ssh [email protected] -p 59999

注意请将其中的xxx替换为你姓名的首字母，2123456789替换为你的netid。

根据提示输入密码（初始密码为netid），再按回车，你会看到一个终端，使用这个终端，你可以执行许多Linux命令行操作。

注意：第一次登录后请使用passwd命令修改密码！

Github

现在让我们来学习一下Github的使用。

为了顺利获取我们为你编写好的代码框架并提交作业，我们需要和Github进行友好交流，首先，前往Github注册一个账户。如果你打不开这个网页，多尝试几次，总有一次能成功。

要让Github认识你，知道是你在访问你的个人仓库而不是什么Alice和Bob，你需要建立一对RSA密钥，并且把公钥上传到Github。不要担心，我们一步一步来。

第1步：创建SSH Key。在用户主目录下，看看有没有.ssh目录，如果有，再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件，如果已经有了，可直接跳到下一步。如果没有，使用终端命令创建SSH Key：

$ ssh-keygen -t rsa -C "[email protected]"

你需要把邮件地址换成你自己的邮件地址，然后一路回车，使用默认值即可，由于这个Key也不是用于军事目的，所以也无需设置密码。

第2步：使用cat命令查看公钥：

$ cat ~/.ssh/id_rsa.pub

它应该类似于以下内容（长度可能不同）：

ssh-ed25519 AAAAC3NzaC1lZDI1N6jpH3Bnbebi7Xz7wMr20LxZCKi3U8UQTE5AAAAIBTc2HwlbOi8T [email protected]

在浏览器中，转到GitHub => Settings => SSH and GPG Keys => New SSH key并添加你的公钥。

• 将标题设置为可以帮助你记住该密钥所在设备的名称（例如XJTUANA instructional machine）。

第3步：尝试使用 SSH 连接到 GitHub：

ssh -T [email protected]

如果一切顺利，你应该看到类似以下内容：

Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.

Git和Github

Git是一个版本控制工具，Github是Git的远程仓库之一，其它类似的远程仓库还有Gitlab，Gitea，Gitee等。

使用Git创建的仓库可以被推送到远程仓库上，这样无论你在世界上的任何地方，使用任何设备，只要你能证明你是你*（如何证明？RSA密钥对。）*，你就能够访问到你的存储仓库，就像使用网盘一样。

至于Git有哪些操作，如何正确使用Git，网上有非常多的教程，这里推荐一篇面向小白，通俗易懂的Git教程：Git教程 - 廖雪峰的官方网站。

vscode

这个世界上有非常多的编辑器，在windows上有记事本，eclipse，visual studio等，在Linux上有vim，nano，gedit等。然而使用者最多，社区生态最好的编辑器，叫作visual studio code (vscode)。我们推荐使用vscode进行代码编辑。

在你自己的电脑上，访问vscode下载页面并找到你对应的版本。下载好以后根据引导安装即可。

通常我们下载的vscode是英文版的，对小白不太友好，若想将语言改为中文，打开Extensions，搜索Chinese，安装第一个。安装好以后重启，vscode就变成中文的了。

vscode的拓展插件非常丰富，我们可以使用Remote - SSH来连接到教学机器，搜索ssh，安装结果中的第一个。之后我们进入左边的远程资源管理器，鼠标放到SSH上，点击右边的'+'，将你登录教学机器的指令粘贴进去，按下回车，接着根据提示输入密码，你就可以通过vscode访问教学机器了。

除此之外，我们还推荐安装一些拓展：C/C++和Go。

Gradescope

我们使用Gradescope对所有考核者的成果进行评分，所有的评分由autograder自动完成，也就是说，评分不具有主观因素，是完全客观的。如果autograder出现了问题，例如误判，请及时在Issues板块（如下所述）提出问题。

注册Gradescope

由于Task 1-4均需要在Gradescope上提交，请前往Gradescope注册一个帐户。打开Gradescope主页 => 点击绿色的Sign Up按钮 => 选择Student => 输入个人信息（Course Entry Code已经通过考核群发送）。注意：Student ID必填，我们通过Student ID来唯一地标识出每个同学。

How to ask a question

请使用Github的Issues功能，你可以在我们公开的两个仓库setup和student0上提交Issues，我们的社员会不定时去解决你的问题。但请注意，提问请遵守诚信政策。你也可以在你自己的student仓库内提出私人Issues（其他人不可见），我们同样会解答你的问题。

请不要在qq群提出技术方面的问题，qq群仅用于交流考核政策(policy)方面的问题，或者闲聊。为什么？因为我们不希望一个问题被其他人的消息掩盖掉，而且我们希望看到一个问题将问题本身描述得非常详细，如果你仅仅是询问：怎么安装vscode？诸如此类的问题，我们有权拒绝回答。相对地，“我的代码编译不通过，编译器提示了这个错误（后面附一张图片）”这种问题，我们很乐意为你解答。

Issues还有另一个好处，它向我们展示了其他人遇到的问题。如果我们遇到了同样的问题，可以先查看其他人是如何解决的，并尝试解决。这样可以避免重复解答同一类问题，因为我们的实践经验告诉我们，很多人会遇到相同的问题。