PKU Hole Community

P 大树洞网页版社区分支

^{（简称“树洞社区版”）}

树洞网页版无疑取得了巨大的成功，占有较大的“市场份额”

贵校有很多动手能力强的同学，也有很多同学有着对网页版树洞的独特想法。这些想法有的是合理的、巧妙的，有的是脑洞太大不切实际的；有的完全可以在客户端完成，有的则需要联系后端。

然而官方并没有很好的处理同学们自己动手和表达想法的渠道。而且有很多呼声较高的功能迟迟不添加（毕竟一个人的精力有限）

P 大树洞网页版社区分支（以下简称“社区版”）的定位是提供一个交流的平台，提供大家动手实现的方案，让大家自己动手实现对树洞网页版的想法。社区版并非试图取代官方版本，更多的是牺牲一部分稳定性来换取好用的功能。如果大家喜欢，乐于贡献代码或想法，社区版会继续维护下去。

计划功能列表

见 project

更新功能列表

（此列表跟进 beta 版）

主要功能

• 屏蔽词
• 在关注列表中搜索
• 别名，适用于给神洞等一个名字
• 关注列表按最新回复排序
• 可设置默认隐藏图片

次要功能

• 从一个洞内通过链接访问另一个洞，返回后记住原状态（即保留刷到的位置以及是否是倒序）
• 关注列表中缓存更新了的洞会有黄点提示（通常情况下是有新的回复）
• 侧边栏模式下禁止主时间线的滚动
• 以文本形式复制树洞时遵从逆序和仅看

界面/行为改变

• 顶栏中的应用链接（成绩、不咕）目前可以正常访问，但访问时会回到官方版
• 和 App 客户端一样受到验证限制，但提供不稳定的自动验证选项
• 将 CNZZ 统计替换为简单且隐私友好型的 Microanalytics，所有人均可查看（有时访问数会超过月度限制，可以切换到本月视图查看本月前几天的数据）

项目管理

• 使用主流的代码风格
• 配置 GitHub Actions, 利用版本号控制发布

其他

• 社区版提供 Beta 测试版本，登录状态与稳定版同步，但是会不稳定，试验性的新功能会优先推送到 Beta 版。

Contributing

有更多的同学喜欢，才有动力继续开发。而且现有的社区版开发者并非 React 土著，十分欢迎有 React 经验的同学共同开发。

社区版欢迎大家提出功能建议，或者参与到社区版的维护和更新中。相比于建议，社区版会优先考虑 PR。提出问题请到 GitHub Issue，树洞内讨论建议包含“树洞社区版”关键词。希望有能力的同学一起打造树洞社区版。

更多事项见 CONTRIBUTING.md

Note

使用社区版同样应当遵守树洞规范。

这个版本属于“自行实现你的想法”，基于 GPLv3 在 GitHub 开源。而不恰当使用此版本或利用此版本的漏洞对 PKU Helper 造成的不利影响由用户负责。作为社区版本，社区（no warranty）维护版本的安全，同时也欢迎同学实现你的想法。

附 PKU Helper 官方的意思：

根据GPL，你有权fork【网页版树洞前端】的代码并进行相应的修改。请注意，你的修改版本必须依然基于GPL授权，并依据此公开源码。

根据树洞规范5.3规定，非官方客户端在PKU Helper团队认定造成不利影响，例如非法攻击服务器、盗取用户个人信息时，我们有权对其进行封禁。

以下为原 README（注：这与访问原树洞网页版的 GitHub 链接不同，因为在某事件之后，xmcp 做了一些不同寻常的操作）

PKU Helper 网页版 P大树洞：pkuhelper.pku.edu.cn/hole

浏览器兼容

下表为当前 PKU Helper 网页版的浏览器兼容目标：

优先兼容 指不应有 bug 和性能问题，可以 Polyfill 的功能尽可能提供，若发现问题会立刻修复。

兼容 指不应有恶性 bug 和严重性能问题，若发现问题会在近期修复。

不兼容 指在此种浏览器上访问本网站是未定义行为，问题反馈一般会被忽略。

num+ 指符合版本号 num 的最新版本及后续所有版本。最新版 以 stable 分支为准。

问题反馈

对 PKU Helper 网页版的 bug 反馈请在相应仓库提交 Issue。

欢迎提出功能和 UI 建议，但可能不会被采纳。根据 GPL，你有权自行实现你的想法。

不方便在 GitHub 上说明的问题可以邮件 xmcp at pku dot edu dot cn。邮件内容可能会被公开。

对 PKU Helper 后端服务、客户端、账号、树洞内容的反馈请联系相应人员，或邮件 helper at pku dot edu dot cn。

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.