24's Blog

一些思考和想法

Sat, 05 Apr 2025 00:00:00 +0000

Foreword

受到一些游戏，小说等启发，记录一些我觉得有意思的设计，希望有朝一日可以把他们实现到我的游戏中。

设定

无限流

无限恐怖

原形来源于无限恐怖，两方对立，各自有各自的目标，可以合作，也可以冲突，但是大家都不知道对方的目的，在一定的时间内完成任务，由第三方扮演监督方和NPC，从而达成一个三方博弈的局面，成功达成目标的，可以拿走他们的奖励，退出比赛，失败则是死亡或者丢失xxx。

同时也类似于现在的剧本杀，只是目前剧本杀只有2方，npc和玩家，这里引入另一方作为对抗，形成人斗的核心。

代入感

有点类似于上的玩家扮演NPC，其实就是一个RPG，但是玩家并不是只能从主角的角度进行游戏，而是可以进入到任何一个其中的角色进行游戏。一局内，可以扮演多个角色，最终让这种巧合达成一个结局，类似于疯狂的石头、疯狂的赛车、疯狂的外星人、无名之辈，这种类似的一环扣一环最终达成一个bad or happy ending。让玩家创造出一个环环相扣式的故事。当然这个结局可以是多种开放的。玩家体会到了每个角色的心路和情感，增强了代入感。

多种可能

Undertale

传说之下，没有玩过，但是被剧透了很多游戏相关的机制，简单说就是通过各种线索，让玩家在通过一个个boss或者关卡的时候，拥有不同的过关方式，而不是简单的杀死或者直接逃课类的通关，而是代入这个角色，了解角色的一切，进而做出人性的中善的操作。其实说的简单一点，就是让玩家去达成这个人物结局，而非编剧或者设定去决定，这种需要强编剧能力才能讲好一个故事。其实这种让玩家去了解boss，何尝不是一种设定，作者从一开始就算计好了，或者设计好了，是想让你从善的角度来解决问题的。

我希望的是遇到问题，解决问题，解决问题有多种方式，甚至是解决出问题的人，出问题的社会，出问题的游戏。

穿越

基于时空线的，可以穿越到各个时空线去改变过去和未来，互相交织，互相影响。每次改变过去，都会造成游戏从被影响的那一刻重新开始，或者说是让游戏重新开了。当重开了n次以后，终于达成了最终的结局，抛出核心：错过即不在，珍惜当下。同时有一个黑色结局，无论达成了什么样的结果，我亦无悔，直面未来。

我自己

将我自己作为一个NPC代入进游戏，让玩家了解、互动，最终认识作者，认识我。从一个第三方的角度，体验别人与我的相处，与我的互动和认识。

扩展：允许每个人设定自己，让自己成为一个npc，培养自己，让别人可以与自己认识，可以与自己交互，最终成为一个特立独行，一个我想成为的我。简单说就是让假我来扮演真我，或者是让真我来扮演假我。

个体成为NPC

简单说就是允许玩家赋予自己作为NPC，通过一定的编程或者蓝图或者类似的东西，可以将自己的行为准则，行事方式录入到世界中作为一个NPC来行动，从而与其他玩家进行交互，变成一个有血有肉的人，每个人可以定义自己的风格，可以通过达成某些条件之后获得某一项东西。送出的物品，需要玩家本身拥有才能送出，否则无法进行复制，同时这样的NPC也需要一定的审核后才能成为真的NPC。而平常离线时，则角色自动转化成NPC执行对应的事件。

NPC可以进行任务副本等等一切操作，甚至可以多个号联合在一起进行某些固定任务。

随机固定属性

玩家的属性是固定的，并且是随机的，但是拥有一项别人所没有的东西，那就是学习能力。通过后天的学习，可以将某些属性修炼到逆天的程度。不存在可以修改出身的设定，并且账号是绑定的，完全无法出售的，必须是本人登录的，跟随你一辈子的东西。账号永久绑定一个人，身份证、实名、人脸认证、机器绑定、IP绑定。一旦任何一项发生了改变，那么一切都需要重新认证一次。账号交易行为不被许可，创建人物的行为会被收费。多少个角色就收费多少次，如同买游戏一样。

loophero

类似loophero，可以随便加入别人房间，一起loop，可以把控制权交给对方，允许房间内的人操作

各种各样的冒险、事件、类似地下城的模式，加入以后可以共克难关，也能大佬带带

游戏名：带佬呆呆，英文名 Die noob, Die lorn

知识孤岛

让知识可以联系在一起的方式、方法

双向链接

可以看到当前页面中联系到的其他一些知识文章或者信息

修改markdown语法，增加双向链接的语法

跳转后可以返回相同位置

index

可以通过本文关键字，搜索当前知识库中相同关键字的文章

可以自主定义，搜索域

多个知识体系联合查询

Chatgpt 信息可信

当AI甚至人为的营销信息爆炸的时候，如何保证信息可信？

如何从爆炸信息中检索到关键且有用的信息，而不被带有偏差或者误导性质的信息带走

水冷-桌机-被动散热

40*40*25= 0.04立方米=40升

热容积=40*4200=168000焦耳/度

7950x最大功率230W

168000/230*50=36521秒  常温水上升50度大概要10小时，还是满功耗的情况，实际不可能

换成二甲基硅油，比热容是1630，比例2.5766，换算以后就是3.88小时，也不是很难

3080Ti满功率是350W

CPU+GPU全功率工作，用水，最多需要14482秒，升高50度，大概也就是4小时

如果用硅油，只需要1.56小时就能升高50度
所以貌似用这种方式散热不太行，温度上升的比较明显了，还是需要散热

主板反扣，将散热器怼到水面中

取消主板的所有前置，只有后置面，将后置面作为主面而非背面

按钮，直接使用无线开关即可，不需要有线的

自动开关窗

智能家居，自动开关窗，本质上风扇+防尘新风空调之类的，但是风量更大，更符合常识

已经有人实现并且做了，还有直接和窗户本体嵌入，一体化更好的

下一代代码编辑器

无论是哪种ide，本身都仅仅只有代码部分，而文档管理无论怎么修改都会和代码分割开来，而且文档会出现不同步，散乱在各种地方的情况

这种情况下要维护代码和文档就变得异常困难了

既然如此，为什么不把代码和文档混合在一起，形成一种新的格式呢

比如：代码上方就是文档，包含图片，视频，音频，等等类型的文件，同时允许引用其他地方的文档进入

超链接允许直接嵌入，显示时可以选择嵌入显示或者是跳转

甚至对于图来说，最好上面就可以直接进行编辑

代码的部分则更简单了，只要是同一个文件中的代码，他们就可以按照由上至下的逻辑进行拼接

同一个页面内的代码，有一个页面属性，可以用来设置他的编译类型，从而在中间过程中生成他原来的代码逻辑，可以单独把代码抽离成普通的代码文件，同时也能把文档抽离成普通的文档文件

这样就可以在写代码的时候，直接修改文档或者查看文档，这样就不会错过一些逻辑或者漏掉一些内容

同理，如果文档可以写的再规范一些，代码甚至可以用AI辅助开发，这样AI生成的代码就更加有理有据了

相当于我们在编译的环节中，又进行了一次编译，让代码不再仅仅是代码，而是真正的完整工程

竞品

swimm 有点类似，但是需要云端支持，结合了AI等内容，同时还具有代码扫描、审查类的功能

https://swimm.io/

古人的尝试

http://www.mark-to-win.com/tutorial/176050.html

jupyter 就是把代码和markdown都写在一起了，同时代码还能运行

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

特性

开源、独立、不影响代码的独立性，不需要远程服务器，能看到代码即能看到文档
文档以markdown形式记录
文档支持各种各样的block，每个文档和对应的代码存在行或者文件的绑定关系
允许文档合并，block合并
文件名改动或者行或者函数等发生变动时，需要有提示绑定关系的变更
切换文件时自动切换文档，也允许主动显示当前代码的文档内容
所有标记性的东西，记录在文档中，不影响原始的code状态
标记性的内容可以独立做一个目录，每次从目录中进行搜索匹配即可
最好可以跟踪git 自动修改文件名产生的变更
允许打开第三方链接或者笔记中的block
可以支持更多的IDE

长远

为什么代码不可以和文档写在一起，甚至多种代码混在一起

通过文件的标识，区分各种代码，代码的顺序可以唯一确定，但是查看的时候可以将各个代码块完全独立的移动

小米人在传感器Pro踩坑

Fri, 13 Sep 2024 00:00:00 +0000

Foreword

前面看了小米人在传感器Pro的应用感觉还挺有意思的，没想到一试发现是个大坑

小米人在传感器Pro

标称覆盖

看似水平有110°，其实最有用的静态只有106°左右，垂直角度是60°，其实非常小了，同时限制了你能俯仰的角度大概就是30度左右，极限是60度，再大就会吃掉垂直角度。

由于这个东西本身检测目标是人，所以他不能被直接遮挡在各种东西后面，他的检测空间最好相对干净一些，这就限制了他的安装高度，官方推荐是1.8m，大概就是人高，如果安装越高，就需要更大角度，但是角度大了，其实就变相缩小俯视角度下的覆盖面积。

真实覆盖

图中一小格是0.5m*0.5m

可以看到最远可以覆盖7m，静态范围只能4m，看似很大？实则很坑。

7m的动态侦测，换句话说就是不稳定，移动可以检测到，但是稳定目标不行，别想做任何静态相关的自动化，不太能用。

真正宣传和侧重的都是这个静态区域，但是由于角度问题，其实上图真正可以用的范围基本只有红圈内，雷达脚下1m，左右2m的范围内存在盲区，可用性很低

为什么，因为角度问题，如果角度放的够低，会削减盲区，灯下不黑了，但是同样的远端就小了，而角度降低很容易被其他家具挡住导致更多的盲区。这样导致实际可以检测互动的区域其实只有6-8㎡，去掉一些固定家具，一些大型家具遮挡，实际可用的范围就更小了。

对比他的价格，379，这个价格我都能买三四个小覆盖的毫米波雷达了，野生人在雷达我都能买六七个了，什么样的场景会覆盖不了。

鬼影问题很严重，动态区域和静态区域来回走，就能造成好几个鬼影，鬼影消失的也非常慢。更别说走出了检测区，鬼影出现就更厉害了

改进建议

目前看雷达的感应地图的精度太低了，可能和算力或者干扰有关系，0.5m*0.5m的地图如果是大客厅可能还可以，但是小一点的空间，这个精度太粗了，很多东西划不出来。

这个0.5同时也导致了安装难度过高，你安装完以后需要人去核对地图，这个时候你就会发现怎么安装好像都没办法说用这个传感器卡住地图，不是偏左就是偏右了（其实还是检测精度不够）

这个东西太大了，特别是配合上磁吸的安装座更大了，本来就装不高，还这么大，十分影响观感

Summary

优点还是有一些的，比如静态检测还是很稳定的，很少出现人消失误判的情况，静态区域的无人判断可以非常快

这么久以来智能家居都缺少一点点AI，这个雷达的数据总算是迈出了一步，可以结合到AI了，不过问题还是太多了，这个数据太烂了，做识别和深挖都不够用的。智能家居缺少了一个总控，可以分析收集所有数据的总控端，这个环节补上了，可能才会有新的应用场景，据说小米已经在做了，快要释放到客户端了

PHP

Fri, 06 Sep 2024 00:00:00 +0000

Foreword

传闻中天下第一的语言，试一下服务器部署，没想到这么困难，老古董还是有点难啊

PHP

部署

先安装PHP，2021 年开始，Ubuntu 官方不再支持 PHP 5.6 版本的维护和更新，因此如果需要在 Ubuntu 上安装 PHP 5.6，则需要使用第三方的 PPA（个人软件包归档）来进行安装

sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php5.6
php -v
PHP 5.6.40-78+ubuntu24.04.1+deb.sury.org+1 (cli) 
Copyright (c) 1997-2016 The PHP Group

好像fpm不这么装也行，5.3.3以后集成了fpm，本身是用来管理的

apt-get install php5.6-fpm
systemctl status php5.6-fpm

检查apache服务启动

systemctl status apache2.service

内网地址，可以看到页面了

http://10.10.2.24/

替换一个PHP的index看下

<!DOCTYPE html>
<html>
<body>

<h1>我的第一个 PHP 页面</h1>

<?php
echo "Hello World!";

?>

</body>
</html>

到这里已经可以正常显示启动了

数据库

sudo apt install php5.6-mysql

docker pull mysql:5.6
docker run --name user_database -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 -d mysql:5.6

<?php
// 准备连接参数
$servername = "localhost";
$servername = "127.0.0.1";
$username = "root";
$password = "123456";
$dbname = "user_database";
 
// 创建数据库连接
$connect = mysqli_connect($servername, $username, $password, $dbname);
 
// 检查连接
if (mysqli_connect_error()) {
die("连接失败: " . mysqli_connect_error());
}
 
// 选择数据库
if (mysqli_select_db($connect, $dbname)) {
echo "数据库连接成功";
} else {
echo "数据库连接失败";
}
 
// 关闭连接
mysqli_close($connect);
?>

测试是否可以连接到数据库，目前没有问题了

Apache2

Apache2和之前的不太一样，配置文件都改变了

ports.conf中是apache监听的端口

# If you just change the port or add more ports here, you will likely also
# have to change the VirtualHost statement in
# /etc/apache2/sites-enabled/000-default.conf

Listen 80

<IfModule ssl_module>
        Listen 443
</IfModule>

<IfModule mod_gnutls.c>
        Listen 443
</IfModule>

默认apache的虚拟主机是/etc/apache2/sites-available/000-default.conf

<VirtualHost *:80>
        # The ServerName directive sets the request scheme, hostname and port that
        # the server uses to identify itself. This is used when creating
        # redirection URLs. In the context of virtual hosts, the ServerName
        # specifies what hostname must appear in the request's Host: header to
        # match this virtual host. For the default virtual host (this file) this
        # value is not decisive as it is used as a last resort host regardless.
        # However, you must set it for any further virtual host explicitly.
        #ServerName www.example.com

        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/html

        # Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
        # error, crit, alert, emerg.
        # It is also possible to configure the loglevel for particular
        # modules, e.g.
        #LogLevel info ssl:warn

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

        # For most configuration files from conf-available/, which are
        # enabled or disabled at a global level, it is possible to
        # include a line for only one particular virtual host. For example the
        # following line enables the CGI configuration for this host only
        # after it has been globally disabled with "a2disconf".
        #Include conf-available/serve-cgi-bin.conf
</VirtualHost>

类似nginx的config文件，设置域名和端口等等相关代理设置

在apache2.conf中的是apache的全局设置，比如是否支持SSL，映射目录是什么

Summary

一个奇怪的问题php里localhost和127.0.0.1竟然不一样，识别不了localhost，查了一下大概是由于php.ini中缺少了默认sock的方式，localhost是一种特殊传递数据的方式，并不会经过socket

Quote

https://www.runoob.com/w3cnote/php-basic-summary.html?source=1

https://blog.csdn.net/m0_52985087/article/details/132132219

https://blog.csdn.net/weixin_71993565/article/details/140336762

https://blog.tag.gg/showinfo-13-35867-0.html

再破吉尼斯世界纪录

Thu, 05 Sep 2024 00:00:00 +0000

Foreword

再破一次吉尼斯世界记录，然而还不止于此。吉尼斯也会撞车，这谁敢信？不仅仅撞车，某一个类似的记录在连续一个月内被连破五次，这是巧合还是故意的？

吉尼斯

Most Unmanned Aerial Vehicles (UAVs) airborne simutaneously

现在已经无法回查到4年前的那条记录了，应该是出现了冲突，所以所有此条记录都不存在了，只有曾经的官方新闻证明曾经破过。

Most remote controlled multirotors/drones airborne simultaneously

现在是使用这条记录进行平替，以前的描述和标准其实都有点太过轻松了，而且也有很多不合理的点，特别是大架次以后还要人数，这个就非常扯蛋，以前三五千人数也就算了，这都快破万了，人数已经很不靠谱了。

https://www.guinnessworldrecords.cn/search?term=%2A

通过吉尼斯的查询入口，可以查到大部分记录，有一部分需要注册登录以后才能查询

这次破的是：

the largest image formed by multirotor/drones

如果有相似团队或者个人挑战同一个记录，特别是商业目的的，吉尼斯会锁定这个词条大概一个月左右的时间，给予充分的宣传时间，如果是挑战不同记录，那就没啥错峰的操作了

还好这次破纪录可以反向逆推，数没起飞的就行了，实际数量也可以直接参考地面站的数值，不需要弄一堆第三方志愿者来数飞机了，太傻了。

四年前预言压力在网络上，大概极限是在7500左右，这次直接就破到了7598，刷新了最大架次，而事实证明这个数量还不是极限，还能再往上顶。

7598之后，就是7998，这也算是最短的记录了，破完第二天别人就又破了，起了个大早赶了个晚集

再接着8100，很烦，本来这个东西在这个级别再比起来就没啥意思了，但总有人在卷，你就得更卷，所以下次就是五位数了

Summary

迭代了2代产品，才勉强打过别人3年前出的产品，进步的速度肉眼可见的慢。

拿着4年后的产品跟别人三年前的产品比较，确实有所进步，总算领先了那么一点点，但也仅此而已了

Git LFS与各种Git管理软件对比

Wed, 28 Aug 2024 00:00:00 +0000

Foreword

之前选过一些资产管理软件，但是都不够好，当时遗漏了Git LFS，这里再补充测试一下

Git LFS

https://github.com/git-lfs/git-lfs

Git LFS的客户端和Git不同，但是可以使用相同的命令完成Git操作，其实LFS的底层原理挺简单，就是通过Git的时候进行回调，如果是LFS匹配的文件就进入到了LFS提交流程

将所有stp结尾的文件，加入到追踪中

git lfs track "*.stp"
git lfs track "*.CATDrawing"
git lfs track "*.CATPart"
git lfs track "*.dxf"
git lfs track "*.igs"

lfs文件追踪是加在.gitattributes文件中的

git add .gitattributes
git commit -m "track *.stp files using Git LFS"

lfs文件追踪是加在.gitattributes文件中的

git add .
git commit -m "add stp"

查看追踪文件

git lfs track

下载包含lsf的仓库时也需要加上lfs的标签

git lfs clone xxxx

更新内容的脚本

unset http_proxy;
unset https_proxy;
git pull origin main
git add .;
echo -e "\033[34m"
read -p "请输入更新内容，按回车键结束:"
echo -e "\033[0m"
git commit -m $REPLY;
git push origin main
echo -e "\033[34m提交完成，按任意键退出\033[0m"
read -n 1
echo 退出

克隆仓库的脚本

unset http_proxy;
unset https_proxy;
echo -e "\033[34m"
read -p "请输入仓库地址，中键复制，按回车键开始克隆:"
echo -e "\033[0m"
git lfs clone $REPLY;

git push origin main
echo -e "\033[34m提交完成，按任意键退出\033[0m"
read -n 1
echo 退出

创建新仓库脚本

unset http_proxy;
unset https_proxy;
git init --initial-branch=main

git lfs track "*.stp"
git lfs track "*.CATDrawing"
git lfs track "*.CATPart"
git lfs track "*.dxf"
git lfs track "*.igs"
git add .gitattributes
git commit -m "track files using Git LFS"

echo -e "\033[34m"
read -p "请输入仓库地址，中键复制，按回车键开始上传:"
echo -e "\033[0m"

git remote add origin $REPLY

git add .
git commit -m "initial repository commit"
git push origin main
echo -e "\033[34m提交完成，按任意键退出\033[0m"
read -n 1
echo 退出

迁移

把原来git代码中大文件变成lfs中存储

git lfs migrate import --include="*.stp" --everything
git lfs migrate import --include="*.igs" --everything

问题

$ git push -u origin master
Remote "origin" does not support the LFS locking API. Consider disabling it with:
  $ git config lfs.https://e.coding.net/xxxx/gitlfs/gitlfs.git].git/info/lfs.locksverify false

可能会出现以上提示，这个是服务端不支持文件锁定，所以需要配置一下让服务端关闭即可

测试

经过测试，1.11GB的文件，比较大的文件加入lfs以后，git add 命令会快很多

上传和下载就取决于网络和服务端限制了，正常使用似乎问题不大。

coding似乎5分钟左右就能完成2.28G的仓库上传，40秒不到就能把整个仓库完全拉下来，完全够用了

大部分硬件仓库和结构仓库，不包含一些七七八八的东西的话，用Git lfs管理足够。

配合SourceTree 给小白使用也非常简单

自建LFS服务器

Git LFS，coding里是标配了20G空间，不占用原有代码空间，Gitee里只有1G基本等于没有，必须要私有部署才行

GitLab也支持LFS，不过有一些要求

Git LFS is supported in GitLab starting with version 8.2. (gitlab版本需要 >= 8.2)
Git LFS must be enabled under project settings (必须在项目设置中开启LFS)
Users need to install Git LFS client version 1.0.1 and up （本地git lfs客户端版本 >= 1.0.1）

开源的LFS存储服务器，据说Github也是基于这个二次开发的

https://github.com/git-lfs/lfs-test-server

修改.lfsconfig文件，增加lfs服务器地址

  [lfs]
    url = "http://localhost:8080/"

弹性LFS，使用一些对象存储或者是云盘实现LFS服务

https://github.com/zhxxch/git-lfs-one

Gitea

https://gitee.com/gitea/gitea

Gitea更像是一个简化版的Gitlab，界面干净一些

Gitea和其他DevOps的对比

https://docs.gitea.com/zh-cn/installation/comparison

Gitea整体非常轻量，适合小机器部署，功能自然也缺少了很多，如果人员很少，也没有规模化的一些需求，可以使用Gitea，否则还是Gitlab更好一些

腾讯工蜂

https://code.tencent.com/

通过Ugit发现了腾讯还专门有一个给游戏类使用的管理平台

目前看起来和Coding重叠度非常高，但是给资源的角度非常大方，SaaS版本可以随便使用，LFS仓库给的非常大，可以说很离谱

工蜂的内部界面非常像Gitlab

SVN

https://www.visualsvn.com/

如果只是普通的SVN本地管理是免费的，但是SVN的服务端是收费的

VisualSVN Server

https://www.visualsvn.com/server/

VisualSVN是按照用户数收费的，买断制，所以可以根据人员决定价格，服务器自己出就行了，不过一次性付费只有12个月的更新和维护时间，后续再更新需要再次付费。

VisualSVN也有社区版本，社区版可以给15个人使用

Git UI工具

Ugit

https://ugit.qq.com/zh/index.html

Ugit是腾讯的自研Git客户端，本身分为专业版和美术版，美术版的交互类似SVN一些

Ugit界面相比SourceTree更加简洁一些

默认内置了LFS的模板，适合做大文件管理，内置了文件锁，可以防止文件被多个人更新

Ugit目前适配了私有部署的gitlab，如果此处提示无法登录，注意一下Gitlab的权限是否正常，是否开了代理，有时候代理会导致这里授权失败。

授权以后，可以直接从克隆看到远端仓库，可以直接克隆，还是比较方便的，同时用户信息也自动帮你填好了，上手难度还是降低了一些的

Ugit对比SourceTree，感觉Ugit确实更流畅一些，特别是文件比较多的时候，很明显的感觉，针对性优化确实有点意义

GitKraken

https://www.gitkraken.com/

GitKraken嵌入的比较多，更合适IDE里使用

gitui

https://github.com/extrawurst/gitui

rust写的git ui客户端，主要还是服务VI VIM类的界面

lazygit

https://github.com/jesseduffield/lazygit

和上面的gitui类似，也是服务mac、linux下的终端类界面

SmartGit

https://www.syntevo.com/smartgit/

付费Git客户端，界面类似SourceTree

GitButler

https://gitbutler.com/

gitbutler，交互拉满，各种东西都可以通过拖拽实现，很符合直觉

gitbutler是把修改内容和仓库文件进行了解耦，你修改的文件存在在workspace中，这次提交你可以提交或者融合到任何一个commit或者分支上去，具体怎么融合是他内部帮你处理好，不用自己写命令。

这种适合增量、文件之间耦合关系很弱的开发模式，gitbutler是必须要走PR流程的，如果PR无法正常运行，那么整个流程就走不动了，它不支持你直接合并，这有点奇怪

Summary

大部分情况LFS+Gitlab可以解决多数问题

Quote

https://coding.net/help/docs/admin/pay/newprice.html

https://coding.net/help/docs/repo/git/lfs.html

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

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

https://gitee.com/help/articles/4235#article-header4

https://forcemz.net/git/2017/04/16/Moses/

https://forcemz.net/git/2018/07/15/GitLFSRethinking/

https://cloud.tencent.com/developer/article/1010589

https://www.escapelife.site/posts/92ef32ff.html

https://juejin.cn/post/6844903791855140872

https://blog.inkroom.cn/2023/02/27/10J1G9S.html

东北见闻

Mon, 19 Aug 2024 00:00:00 +0000

Foreword

记录一下东北见闻

长春

长春是吉林的省会，很奇怪为什么不是吉林，吉林其实离长春很近，只有一百多公里。吉林历史上确实是吉林的省会，后来伪满洲大力发展长春，让长春成了省会的潜在竞争者，1953年长春成了直辖市，吉林还是省会，从1954年开始长春成为了吉林省会，自此就再也没变过了。

长春比较有名的景点：

伪满皇宫博物院，溥仪最后做皇帝时的皇宫
净月潭
长春电影制片厂
这有山，其实是个比较特殊的商业中心，假山坐在楼中
刘老根大舞台，欣赏不来
德云社，东北竟然也有相声社，第一次见
桂林路，网红、小吃一条街，有的东西大差不差
长春天主教堂，比较西式的建筑，国内还是满少见的

东北的衰败，来到长春，确实很明显，特别是还刚巧去了长春的老城区，人民广场附近。地图上看起来像是市中心，其实实际到了以后，有点黑灯瞎火。周围没有很多高楼，更多的是黑灯的老楼，像是很久都没有人住了。

附近的门店也有很多关门很久很久了，人烟稀少。出租车司机说新城区人多一些，老城区基本没啥人了。到达的比较晚，也没啥吃饭的门店了，只有路边的烧烤，确实符合东北的风格，价格很低。

延吉

延吉城区比较小，繁华路段基本就集中在2-3公里的一条长街上。印象最深刻的就是打车贼便宜，5块的起步价，到哪里都是5块。可能正好处于旅游旺季，逆天的酒店价格，比深圳贵1.5倍左右。房价几千到一万多，在这样的小城市里也算是有点高的，招牌上基本都是中韩双语，路上遇到的人说韩语的也非常多。

延吉的景点都比较一般，甚至说有点寒酸：

水上市场，就是个早市
西市场，类似年代久远的百货商场，卖啥的都有，由于是旅游点之一，所以卫生、环境都还不错，相对人也比较多，不要好奇东市，菜市场而已
网红墙，妥妥的营销出来的景点，就是一堆广告牌，霓虹灯，深圳满大街都可以算是。人头攒动，摩肩接踵，过了这一片立马就消停了，属实迷惑，非要来的话可以接近23点再去，人少很多
帽儿山，比延吉市区高一头，可以俯瞰整个延吉，然而延吉没啥好看的
阿里郎广场，州政府对面，延边图书馆，跑道、街健、运动场，足球氛围拉满，挺不错的，深圳没几个这种地方，当地人多一些，旅客基本没有
延吉图们口岸，朝鲜，曾经在丹东见过对面破败的朝鲜，十年过去了，似乎也没什么变化
延边大学，双一流、211，进入校园需要提前预约

大概太阳下山后，中心老城区里非通行的广场上，摆摊、跳舞、烧烤、踢毽子、按摩，生活气氛浓郁。但总体都是老头老太太了，甚至还能看到营业的练歌房，老头老太太刚吼完出来，年轻人也不知道去了哪里。

百货大楼、地下街、防空洞，旋转大门，这些曾经老旧的东西，在这里还能看到

延吉作为距离长白山最近的城市，导致很多人去长白山玩，顺道被忽悠来延吉逛一逛，顺带带动了延吉的酒店。

延边大学

延边大学从正门进入需要提前预约，预约也很简单，微信搜索延边大学小程序-校内通行信息登记系统即可，简单就能预约到了，扫人脸进门

延边大学如果是从侧面进入是不需要预约信息的，跟学生一样走进去就行了

延边大学9.7号才开学，但是新生军训8.17已经提前开始了，操场上很多训练的方队。看了一下开学时间，延边大学也有小学期，暑假也是8月份才放的

学校里自习桌还挺高级的，自带小米50w无线快充，挺高级的

学校里可以参观的比较少，一个博物馆，一个抗联馆，前者是类似校史馆，后者是红色文化宣传教育馆。人稍微多一点的是游泳馆，似乎是对外开放的，买票就能进，而且很大。

学校食堂挺便宜的，都正常开放了，偏远角落还有一个咖啡文化馆，不过基本没啥人。

总体来说学校不是特别大，一下午就足够逛完了，大部分地方都没啥看点，再加上学生没返校，路人很少，只能追忆一下以前的校园生活。

长白山

长白山分为西坡和北坡，无论是哪边，都需要在天气好的情况下去，否则有可能封山

北坡风景比较多，天池，瀑布，走路比较少，很快就能到达山顶
西坡无法直达山顶，需要徒步1440级台阶

长白山如果隔天去，可能会遇到买不到票，然后去咸鱼找黄牛，黄牛说要明天19点以后给票或者当天19点以后给（巨大坑点），一张票加个40左右。

官方票务显示都没有票，但是真的等到了第二天大概18点以后，就会发现官方放票了。大多数票应该是提前被旅行社或者黄牛拿走了，导致官方一直显示是0，等时间到了，一放出来几千近万张票就来了，完全没必要加钱。

冬季去西坡，夏季去北坡，从延吉出发去长白山还是挺远的，有个大概100多公里。长白山本身所在就是二道白河镇（基本就是为长白山旅游住宿的小镇），实际去北坡行程是先到到了二道白河镇，买了北坡门票，然后乘坐官方大巴上山，大概50分钟左右到达山腰吧。转乘15分钟的小车，可以到达山顶，观赏天池。

山上观看天池的地方很小，人很多，除了看、拍照以外基本没有啥额外的娱乐活动了

山腰温度还行比正常低10-15度左右，山顶温度很低了，接近0度了，最好多带点衣服，风也很大
天池观赏非常看天气，大雾、多云建议都别去，大概率会关闭，如果不关闭天池也会像图里的，雾蒙蒙的，晴天风景完全不同

隐约可以看到对面这条小路，应该就是朝鲜了

山腰下来以后的其他景区，基本没啥看头，温泉只有一点点，没啥给你接触的机会；大瀑布不开放；岳桦栈道，也一般，纯走路没啥内容；小天池，还没村里的鱼塘大，去不去都那样；

绿渊谭，也是个小水池+小瀑布，观赏性实在是太低了，至于其他的人造景区、人造园林，那就更没意思了。

总的来说长白山也就天池值得一看，其他地方都太一般了，人工痕迹过重了，长白山大部门门票基本都是给了车票，全程都是景区内车接车送，当天景区内一共坐了6次车，在不同景点直接往返。

图们

从延吉到图们不到30公里，一小时不到就能到了。图们，曾经可以去朝鲜，是和朝鲜贸易的口岸，不过目前已经被废弃了，除了看看，没啥可玩点了，想去到朝鲜从这里也是完全不可能的了。

口岸界碑

25买个门票，就可以登上口岸顶

遥望对面的朝鲜，还是相当破败的，楼房里烧柴火，玻璃都没有，用塑料布当玻璃，正中大楼上还挂着将军一家的头像，很是嘲讽

图们口岸广场上玩门球的大爷和大妈，看了一场精彩的逆转，门球还挺少见的

珲春

珲春，一眼望三国，朝鲜+俄罗斯，珲春距离海参崴（曾经地理课本里经常出现的地方）很近了，可以直接从珲春出关进入俄罗斯，听说可以在俄罗斯打靶玩，目前还是免签的，很容易就可以到对面去看看了，不过除此以外珲春好像就没啥了

Summary

东北衰败，挺可惜的，人都没了，还谈什么振兴呢。看到了这样的小城市，再对比深圳的灯火通明。而小城市里的闲适、慵懒，在深圳怎么也找不到。如果不是为了欲，不是为了追求，为了卷，在小城市里work-life balance也许是不错的选择，不过那样的生活有点没意思，一眼就能望到头。

一路看下来，整体消费还是比较低的，深圳满街的咖啡奶茶店，在这里就很少，唯一常见的就是蜜雪冰城。

快要接近8.20了，小小延吉，一个联名咖啡瞬间就没了，hhhh

回到深圳以后，同比深圳12点还灯火通明，延吉8点就没啥人了，街边店铺都关了，人才是发展的动力啊

在线画图工具

Tue, 06 Aug 2024 00:00:00 +0000

Foreword

测评一下在线画图工具，看还有没有比Draw.io更好用的，能否有更好的替代品

Draw.io

https://app.diagrams.net/

https://www.drawio.com/

优点太多了

免费、开源
很多软件支持嵌入，比如VS code，obsidian等
支持本地部署
模板众多、素材丰富
导出格式多
存储方式可以关联多种网盘
支持在线，也支持客户端离线使用

问题

风格有点老，不够好看
图片大了还是有点卡
打开和加载速度还是有点慢
缺少文件历史，必须要配合其他软件一起用

本地部署

# 创建 Draw.io 数据存放目录
mkdir /docker/Drawio -p && cd /docker/Drawio

# 使用 Docker-Cli 运行 Drawio 容器
docker run -dit --name=drawio -p 8080:8080 \
-v drawiojs:/usr/local/tomcat/webapps/draw/js/ \
--restart=always jgraph/drawio

访问路径，测试

http://服务器IP地址:8080

确认没问题，再套上caddy，自动SSL就行了

draw.xxxx.com {
    reverse_proxy 127.0.0.1:8080
}

https://app.diagrams.net/?lang=es

改进入语言需要加一个后缀，否则改不掉

配置修改

如果要修改服务器默认配置可以通过修改Preconfig.js文件实现

先把原配置复制出来

docker cp drawio:/usr/local/tomcat/webapps/draw/js/PreConfig.js ./

添加默认中文

urlParams['lang'] = 'zh'; //设置默认中文

同样的如果想修改默认配置，也可以通过添加属性来实现

window.DRAWIO_CONFIG = {"language":"zh","configVersion":null,"customFonts":[],"libraries":"general;uml;er;bpmn;flowchart;basic;arrows2","customLibraries":["L.scratchpad"],"plugins":[],"recentColors":[],"formatWidth":240,"createTarget":false,"pageFormat":{"x":0,"y":0,"width":827,"height":1169},"search":true,"showStartScreen":false,"gridColor":"#d0d0d0","darkGridColor":"#424242","autosave":false,"resizeImages":null,"openCounter":4,"version":18,"unit":1,"isRulerOn":false,"ui":"","darkMode":false,"pages":true,"defaultGridEnabled":false,"defaultPageVisible":false};

如果需要修改默认导出的url，可以修改BASE_URL

window.DRAWIO_BASE_URL = 'https://xx.com';

反向复制回去

docker cp ./PreConfig.js drawio:/usr/local/tomcat/webapps/draw/js/PreConfig.js

客户端修改

默认配置可以随便修改，这种只会修改个人的配置，根据浏览器缓存绑定，并不会修改服务端

https://www.drawio.com/doc/faq/configure-diagram-editor

{
  "language": "zh",
  "configVersion": null,
  "customFonts": [],
  "libraries": "general;uml;er;bpmn;flowchart;basic;arrows2",
  "customLibraries": [
    "L.scratchpad"
  ],
  "plugins": [],
  "recentColors": [],
  "formatWidth": 240,
  "createTarget": false,
  "pageFormat": {
    "x": 0,
    "y": 0,
    "width": 827,
    "height": 1169
  },
  "search": true,
  "showStartScreen": false,
  "gridColor": "#d0d0d0",
  "darkGridColor": "#424242",
  "autosave": false,
  "resizeImages": null,
  "openCounter": 4,
  "version": 18,
  "unit": 1,
  "isRulerOn": false,
  "ui": "",
  "darkMode": false,
  "pages": true,
  "defaultGridEnabled": false,
  "defaultPageVisible": false
}

比如上面的就是默认中文，关闭默认的网格显示，关闭页面视图，这样看起来就无限大了

私有化存储

Draw.io有一些私有化存储的方案

dropbox
github
trello
google drive
one drive
gitlab

不过这种都是个人存储，团队私有化的话，比较适合使用gitlab作为存储库，还有一种MinIO作为存储端，这种是DIY的方案

https://github.com/mathcoder23/drawio-minio-oss?tab=readme-ov-file

Gitlab联动

与Gitlab联动还挺麻烦的，首先需要Gitlab注册一个应用程序

注意，这里的程序id和secret需要复制下来，后续使用，此处需要给出对应的3个API接口访问权限才行，回调地址中需要填写你的drawio的地址并且加上/gitlab的回调路径才行

用前面方式创建的drawio的docker，如果只通过ProConfig，是无法适配的，总是会出现报错或者CSP问题，所以最好重新配置启动docker

docker run -d --name=drawio2   -p 8080:8080   -e DRAWIO_BASE_URL=https://你的drawio -e DRAWIO_GITLAB_ID=你的appid   -e DRAWIO_GITLAB_SECRET=你的secret   -e DRAWIO_GITLAB_URL=https://你的gitlab   -e DRAWIO_CSP_HEADER="src \'self\'; script-src \'self\' https://code.jquery.com \'unsafe-inline\'; connect-src \'self\' https://你的gitlab; img-src * data:; media-src * data:; font-src * about:; style-src \'self\' \'unsafe-inline\' https://fonts.googleapis.com; frame-src \'self\' https://你的gitlab;"   jgraph/drawio

修改PreConfig.js，开启Gitlab

(function() {
  try {
	    var s = document.createElement('meta');
	    s.setAttribute('content', 'src \'self\'; script-src \'self\' https://code.jquery.com \'unsafe-inline\'; connect-src \'self\' https://你的gitlab; img-src * data:; media-src * data:; font-src * about:; style-src \'self\' \'unsafe-inline\' https://fonts.googleapis.com; frame-src \'self\' https://你的gitlab;');
	    s.setAttribute('http-equiv', 'Content-Security-Policy');
 	    var t = document.getElementsByTagName('meta')[0];
      t.parentNode.insertBefore(s, t);
  } catch (e) {} // ignore
})();
window.DRAWIO_BASE_URL = 'https://你的drawio';
window.DRAWIO_SERVER_URL = window.DRAWIO_BASE_URL + '/';
window.DRAWIO_VIEWER_URL = '';
window.DRAWIO_LIGHTBOX_URL = '';
window.DRAW_MATH_URL = 'math/es5';
window.DRAWIO_CONFIG = {"language":"zh","configVersion":null,"customFonts":[],"libraries":"general;uml;er;bpmn;flowchart;basic;arrows2","customLibraries":["L.scratchpad"],"plugins":[],"recentColors":[],"formatWidth":240,"createTarget":false,"pageFormat":{"x":0,"y":0,"width":827,"height":1169},"search":true,"showStartScreen":false,"gridColor":"#d0d0d0","darkGridColor":"#424242","autosave":false,"resizeImages":null,"openCounter":4,"version":18,"unit":1,"isRulerOn":false,"ui":"","darkMode":false,"pages":true,"defaultGridEnabled":false,"defaultPageVisible":false};
urlParams['sync'] = 'manual'; //Disable Real-Time
urlParams['db'] = '0'; //dropbox
urlParams['gh'] = '0'; //github
urlParams['tr'] = '0'; //trello
urlParams['gapi'] = '0'; //Google Drive
urlParams['od'] = '0'; //OneDrive
window.DRAWIO_GITLAB_URL = 'https://你的gitlab'; 
window.DRAWIO_GITLAB_ID = '你的appid'; 
urlParams['lang'] = 'zh'; //设置默认中文

注意此处需要去掉urlParams['gl'] 如果有window.DRAWIO_CSP_HEADER属性也要去掉

理论上此时就已经可以访问了，启动时会提示GiLab

创建绘图以后会出现授权跳转

然后就可以直接存储到代码仓库中了，并且地址每次保存其实就是一个commit更新

常见问题

如果出现400错误

细看这个跳转链接，和issue中报错的其实是一样的

https://draw.你的.com/gitlab?code=e0303bc6cc574f0aba111db163e8831288026e28264ec334f093d22123c4430b&state=cId%3D你的id%26domain%3Ddraw.你的.com%26token%3D16rlbhnmkrmi3nnfnitokrltab7u0mcgd494phdgd5ba38ghhr4i

这里看起来更像是链接转义时有问题，正确的应该是类似下面的，但是这里有一个 state=cID=这里很奇怪，感觉是漏了一个&

https://draw.你的.com/gitlab?code=e0303bc6cc574f0aba111db163e8831288026e28264ec334f093d22123c4430b&state=cId=你的id&domain=draw.你的.com&token=16rlbhnmkrmi3nnfnitokrltab7u0mcgd494phdgd5ba38ghhr4i

出现这个问题是因为只在PreConfig中设置了GitLab相关内容，但是实际程序跑起来不知道为什么没有应用这里的配置，导致实际不生效，所以要通过docker的环境变量去配置

还有一种方式，在docker启动时直接指定参数

docker run -d --name=drawio2   -p 8016:8080   -e DRAWIO_BASE_URL=https://draw.你的.com:8016   -e DRAWIO_GITLAB_ID=你的id   -e DRAWIO_GITLAB_SECRET=你的secret -e DRAWIO_GITLAB_URL=https://gitlab.你的.com   -e DRAWIO_CSP_HEADER="default-src \'self\'; script-src \'self\' \'unsafe-inline\'; connect-src \'self\' https://gitlab.你的.com; img-src * data:; media-src * data:; font-src * about:; style-src \'self\' \'unsafe-inline\';"   jgraph/drawio

在授权时会遇到没有权限访问的情况了，这个是CSP有问题

简单说就是跨域还是有问题，好几个issue基本都是类似的问题

Refused to connect to 'https://gitlab.你的.com/api/v4/user' because it violates the following Content Security Policy directive: "connect-src 'self' https://*.dropboxapi.com https://api.trello.com https://api.github.com https://raw.githubusercontent.com https://*.googleapis.com https://*.googleusercontent.com https://graph.microsoft.com https://*.1drv.com https://*.sharepoint.com https://gitlab.com https://*.google.com https://fonts.gstatic.com https://fonts.googleapis.com".
mxXmlRequest.send	@	app.min.js:211

上面是一个博主写的CSP替换头，这个头其实不正确，就会导致一直报CSP问题，替换成下面的头即可

DRAWIO_CSP_HEADER=default-src \'self\'; script-src \'self\' https://code.jquery.com \'unsafe-inline\'; connect-src \'self\' http://MY_SERVER_URL; img-src * data:; media-src * data:; font-src * about:; style-src \'self\' \'unsafe-inline\' https://fonts.googleapis.com; frame-src \'self\' http://MY_SERVER_URL;

还有一种情况是你的PreConfig有问题，注意上面的s.setAttribute这个属性里会有你的gitlab地址，很多人用了错误的content导致只要PreConfig应用了就会出错的情况

(function() {
  try {
	    var s = document.createElement('meta');
	    s.setAttribute('content', 'src \'self\'; script-src \'self\' https://code.jquery.com \'unsafe-inline\'; connect-src \'self\' https://你的gitlab; img-src * data:; media-src * data:; font-src * about:; style-src \'self\' \'unsafe-inline\' https://fonts.googleapis.com; frame-src \'self\' https://你的gitlab;');
	    s.setAttribute('http-equiv', 'Content-Security-Policy');
 	    var t = document.getElementsByTagName('meta')[0];
      t.parentNode.insertBefore(s, t);
  } catch (e) {} // ignore
})();
window.DRAWIO_BASE_URL = 'https://你的drawio';
window.DRAWIO_SERVER_URL = window.DRAWIO_BASE_URL + '/';
window.DRAWIO_VIEWER_URL = '';
window.DRAWIO_LIGHTBOX_URL = '';
window.DRAW_MATH_URL = 'math/es5';
window.DRAWIO_CONFIG = null;
urlParams['sync'] = 'manual'; //Disable Real-Time
urlParams['db'] = '0'; //dropbox
urlParams['gh'] = '0'; //github
urlParams['tr'] = '0'; //trello
urlParams['gapi'] = '0'; //Google Drive
urlParams['od'] = '0'; //OneDrive
window.DRAWIO_GITLAB_URL = 'https://你的gitlab'; 
window.DRAWIO_GITLAB_ID = '你的appid'; 

国内

国内的基本没有免费，除了钱还是钱

PDDON

https://pddon.com/

国产画图工具，但是加载速度是真的慢，基本不具有可用性

访问困难

MindMaster

亿图图示，国内的在线制图，除了广告，就是弹窗，收费、收费、VIP，单用户1080的天价，打扰了

水平拉连接点会出现bug

ProcessOn

国内的在线制图，问题和MindMaster基本一样，除了广告就是弹窗VIP，免费版本只能在线创建9个图

技术上比MindMaster好一点，界面也清爽一些，剩下的差不多，价格也便宜一些，不过我期望的是免费，这里就不提了。

国外

国外的在线画图，都有一个统一的问题，国内访问困难

Excalidraw

https://excalidraw.com/

Excalidraw 准确说不像是个画图工具，更像画板工具，自由度很高，可以随便画

支持多人合作
支持自定义素材
免费限制很小
开源
界面好看

问题也比较明显，素材库每个人都不一样，没法对齐每个人的，免费功能还是有限

素材种手绘的样式比较多，很可爱，如果要正式场景下就有点难顶，素材库每次导入就是导入所有，而不能部分，有些别扭

私有化部署+修改存储方案

https://github.com/alswl/excalidraw-collaboration

Plant UML

https://plantuml.com/zh/

用代码画图，有一套完整的语法，早期我自己也用，后来发现想让别人理解太难了，可惜，画图而已，不想浪费生命，还是拖拽更好一些

Visio

老牌工具，没啥大问题，但是安装麻烦，体积太大，跟不上时代了

OneModel

https://www.onemodel.app/diagrams/my-diagrams

国外的制图网址，免费版限制很少，可以无限量画，只对工作空间人数有限制

图样的参数相对比较少，可用素材也比较少，素材风格相对比较统一

Tldraw

https://www.tldraw.com/

开源、免费的白板，支持多人共享，类似Excalidraw，但是没有素材库，也完全没有收费的版本

Figma

https://www.figma.com/

Figma更像UI规范的工具，画图也可以，整体简洁清爽，不过还是一样收费才能无限图，否则只能1个图文件

Summary

能打的画图工具太少了，wolai中也不支持draw.io嵌入，但是wolai已经有意向在之后加入draw.io了

Quote

https://blog.alswl.com/2022/10/self-hosted-excalidraw/

https://www.cnblogs.com/wuhanjiayou/p/18145848/Drawio

https://www.erballoon.vip/2024/01/14/dockerbszxhtdrawio/

https://musicfe.com/drawio/

https://www.xubiaosunny.top/post/self-hosted_drawio_and_add_pravate_gitlab_storage_yfzk.html

https://github.com/jgraph/docker-drawio/tree/dev/self-contained#gitlab

https://blog.csdn.net/qq_28800347/article/details/136523271

https://github.com/jgraph/docker-drawio/discussions/30

Trilium体验

Mon, 05 Aug 2024 00:00:00 +0000

Foreword

去年选择了wolai作为团队知识管理工具，之前已经使用过了obsidian，但是对非程序员不够好用，其次没有完善的权限管理，做共享比较麻烦，给出去就是源码，无法做后续管控，wolai基本都能解决这些问题。

但是也有一些不够好的点，性能上对比Typora或者一般的编辑软件确实弱了一些，文档书写为了普适性，更适合一般人用，而没有更专业的模式，或者说更适合程序员使用的模式，这点不够好。

其次wolai价格不便宜，偶尔还是有一些小bug

Trilium的效果有点出乎意料

Trilium

https://github.com/zadam/trilium

无意间发现了Trilium，这不就是一个obsidian+git+vps+图床+drawio的一个应用嘛，是不是可以取代wolai

特点

树状结构文件，支持任意嵌套和引用（克隆）
markdown格式，图，表，公式
code支持高亮
版本控制
可视化文档链接关系
支持各种图制作和嵌入，画板
在线制图工具嵌入，drawio
嵌入脚本
公开分享
支持导入和导出，支持剪藏
数据备份

试用

https://github.com/zadam/trilium/releases/tag/v0.63.7

建议先从windows开始，比较简单，解压就能用了

语言包

https://github.com/Nriver/trilium-translation/releases

默认Trilium是英文的，而且没有其他语系可以切换

如果已经打开过原版，需要删除缓存才能切换到中文版

你运行过原版的Trilium程序，系统里有英文版的缓存，请关闭trilium， Windows系统删除这个目录C:\Users\用户名\AppData\Roaming\Trilium Notes, Linux系统删除这个目录~/.config/Trilium Notes/ 。再启动Trilium就是中文的了。

trilium-data，最好也一并删除了，这样可以快速初始化中文数据库

这个前置块按钮和wolai好像

不过这个markdown好像不标准，没有一级标题，只有二级到六级，wolai是没有五六级，咋就是不完美呢

主题

仔细用了一下trilium这个默认主题也太难看了

特别是把原本的文章转过来，默认的这个markdown渲染，这都什么玩意

修改主题，使用SinkeyTheme，总算是舒服一点了

https://github.com/sinkey100/trilium-theme/blob/main/README_CN.md

难受的点就是目录里的这个123456是什么鬼啊，很不想要

转换blog

https://www.ankia.top/3LdIi2f30Pan

https://github.com/dvai/Ankia-Theme

使用Ankia的博客主题，直接开启分享就可以看到效果了

这渲染出来的效果还不错哎

已有文章拖进去，立马就能看到了

集成draw.io

https://www.shmaur.com/drawioInstall.html

https://github.com/SiriusXT/trilium-drawio

这简直跟VS Code一样了，直接集成各种JS应用

问题

不支持多人协作
多端同步也比较困难
分享无法带权限管理，只有密码或者公开
历史功能有点难用，不知道是什么逻辑记录历史的
书写体验有点拉跨，远逊于Typora、Obsidian等
Markdown格式不标准，这个很奇怪
插件、主题各种资源相对比较少一些
图片不能直接右键复制

其他

dokuwiki，作为wiki好像也打不过Trilium

Joplin，缺少树型结构，文档编辑类似论坛发文章的东西，没有什么亮点

tiddlywiki，无markdown，论坛式的，虽然支持双链、图片，但是交互逻辑过于老气了

Summary

Trilium通过小小的DIY，已经超出预期了，有点心动的感觉，唯一的缺点在于编辑方式比Typora差太多了

Quote

https://sspai.com/post/85515

https://post.smzdm.com/p/avp2w9m4/

https://www.ankia.top/sfDk7s6iFuno

https://post.smzdm.com/p/ao95lw4n/

https://www.ankia.top/

VS Code插件入门二

Wed, 31 Jul 2024 00:00:00 +0000

Foreword

第二步，通过API实现一点点小功能

VS Code插件入门

VS Code的API目录，可以先按照大类查找，然后再找下面具体的接口

https://code.visualstudio.com/api/references/vscode-api

VS Code的API例子在下面的地址中，相关的接口可以直接看一下例子里是怎么用的，效果怎样

https://github.com/microsoft/vscode-extension-samples

具体使用进入到对应的例子目录下，然后安装包，就可以启动了

npm install
F5

获取文件路径

首先是通过插件获取到当前打开文件路径在哪里

vscode.window.activeTextEditor.document.uri.path

试了一下，切换文件，显示没有问题，如果没有打开路径倒是会报错，需要异常处理一下

		if(vscode.window.activeTextEditor == undefined)
		{
			console.log("cant find active text editor")
		}
		else
		{
			console.log(vscode.window.activeTextEditor.document.uri.path) 
		}

还有一种路径，可能是需要当前打开的工程路径，可以通过下面这种方式获取

console.log(vscode.workspace.workspaceFolders[0].uri.fsPath)

创建一个新的显示区域

在创建新的显示区域之前，先要知道一下VS Code本身有哪些区域可以用来自定义

最左侧的是Tree View Container，这个就比较像快捷菜单

接着就是左侧的树型大纲视图，这里一般以大纲或者目录的形式显示一些辅助信息

最底下的就是状态栏，可以添加一些当前工程或者插件的状态信息，比如进度条等

最右侧较大范围的就是Webview

Webview，页面视图，简单理解就是HTML中的一个iframe，可以嵌入一个页面进来，但是这个嵌入的页面是个相对安全的沙河，只有从外部控制Webview的内容，而Webview反向控制就比较困难。

所以一般可以通过Webview调用markdown、gpt、copilot等等第三方的交换界面

Webview在VS Code中，可以反向hook editor event，比如撤销、重做、保存，这样就让你在VS Code中实现一个某种编辑器成为可能。

Webview一般有三种用法：

Webview Panels，一般的显示渲染结果的窗口
custom editor，一个自定义的编辑器
Webview views，大纲视图的二次开发

这里参考vscode-extension-samples\webview-sample的例子，看他是如何让小猫在webview中写代码的

export function activate(context: vscode.ExtensionContext) {
	context.subscriptions.push(
		vscode.commands.registerCommand('catCoding.start', () => {
			CatCodingPanel.createOrShow(context.extensionUri);
		})
	);

注册命令主要就是调用了这个CatCodingPanel的实例化

先缩起来看一下，CatCodingPanel这个类主要的几个方法，很明显的是CatCodingPanel使用的是vs的内部pannel对象vscode.WebviewPanel

		// Otherwise, create a new panel.
		const panel = vscode.window.createWebviewPanel(
			CatCodingPanel.viewType,
			'Cat Coding',
			column || vscode.ViewColumn.One,
			getWebviewOptions(extensionUri),
		);

停在接口上，就能很清晰看到4个参数的作用

function window.createWebviewPanel(viewType: string, title: string, showOptions: vscode.ViewColumn | {
    readonly viewColumn: vscode.ViewColumn;
    readonly preserveFocus?: boolean;
}, options?: vscode.WebviewPanelOptions & vscode.WebviewOptions): vscode.WebviewPanel
Create and show a new webview panel.

@param viewType — Identifies the type of the webview panel.

@param title — Title of the panel.

@param showOptions — Where to show the webview in the editor. If preserveFocus is set, the new webview will not take focus.

@param options — Settings for the new panel.

@return — New webview panel.

发现这个函数好像根本没有说具体内容是怎么显示出来的

那就看一下构造函数的内容

	private constructor(panel: vscode.WebviewPanel, extensionUri: vscode.Uri) {
		this._panel = panel;
		this._extensionUri = extensionUri;

		// Set the webview's initial html content
		this._update();

		// Listen for when the panel is disposed
		// This happens when the user closes the panel or when the panel is closed programmatically
		this._panel.onDidDispose(() => this.dispose(), null, this._disposables);

		// Update the content based on view changes
		this._panel.onDidChangeViewState(
			e => {
				if (this._panel.visible) {
					this._update();
				}
			},
			null,
			this._disposables
		);

		// Handle messages from the webview
		this._panel.webview.onDidReceiveMessage(
			message => {
				switch (message.command) {
					case 'alert':
						vscode.window.showErrorMessage(message.text);
						return;
				}
			},
			null,
			this._disposables
		);
	}

可以看到显示内容是靠update初始化的，最终调用到_getHtmlForWebview，这个里面基本上就是封装了一个HTML页面

onDidChangeViewState就可以认为是页面改动触发的刷新，比如分屏显示，缩小或者放大webview大小

onDidReceiveMessage添加了一个事件回调，收到某些命令时进行弹窗显示

Webview的生命周期

Webview是有一个生命周期的，并且Webview的句柄是需要你自己保存的，否则这个东西就没人可以控制了。

而Webview同样也需要正确释放，否则就会造成额外的错误

constructor
dispose
revive/reveal 从后台切到前台显示，获得焦点

Debug

Developer: Toggle Developer Tools可以看到这个webview的界面，就能清楚的看到这里其实嵌入式了iframe

内部的网页就是cat coding

加载本地资源

function getWebviewOptions(extensionUri: vscode.Uri): vscode.WebviewOptions {
	return {
		// Enable javascript in the webview
		enableScripts: true,

		// And restrict the webview to only loading content from our extension's `media` directory.
		localResourceRoots: [vscode.Uri.joinPath(extensionUri, 'media')]
	};
}

需要注意在getWebviewOptions中的localResourceRoots中会限制可以读取的资源路径，比如这里就限制必须是在插件路径的media文件夹内才可以

		const scriptPathOnDisk1 = vscode.Uri.joinPath(this._extensionUri, 'giphy.gif');
		//const scriptPathOnDisk1 = vscode.Uri.joinPath(this._extensionUri, 'media', 'cat.gif');

		const scriptUri1 = webview.asWebviewUri(scriptPathOnDisk1);

如果后续读取使用的是非media路径，webview会显示不了对应的gif

通信

	context.subscriptions.push(
		vscode.commands.registerCommand('catCoding.doRefactor', () => {
			if (CatCodingPanel.currentPanel) {
				CatCodingPanel.currentPanel.doRefactor();
			}
		})
	);	
	public doRefactor() {
		// Send a message to the webview webview.
		// You can send any JSON serializable data.
		this._panel.webview.postMessage({ command: 'refactor' });
	}

插件可以通过postMessage发送消息给实例化的webview，进而实现一些控制

    // Handle messages sent from the extension to the webview
    window.addEventListener('message', event => {
        const message = event.data; // The json data that the extension sent
        switch (message.command) {
            case 'refactor':
                currentCount = Math.ceil(currentCount * 0.5);
                counter.textContent = `${currentCount}`;
                break;
        }
    });

在media/main.js中可以看到对应事件的响应代码

反过来，webview也可以通过vs插件接口发送消息给插件

    setInterval(() => {
        counter.textContent = `${currentCount++} `;

        // Update state
        vscode.setState({ count: currentCount });

        // Alert the extension when the cat introduces a bug
        if (Math.random() < Math.min(0.001 * currentCount, 0.05)) {
            // Send a message back to the extension
            vscode.postMessage({
                command: 'alert',
                text: '🐛  on line ' + currentCount
            });
        }
    }, 100);

在media/main.js中可以看到webview加载的本地js直接调用了vs的api，进行post信息

显示markdown

非常简单直接使用内置的markdown命令实现显示当前激活文档的markdown渲染视图

vscode.commands.executeCommand("markdown.showPreviewToSide", vscode.window.activeTextEditor.document.uri.path);

不过这种方式只能显示一个markdown，而且具体markdown能显示啥，不能显示啥，或者说markdown的扩展，就不是我能控制的了

Summary

第二步ok

Quote

https://liiked.github.io/VS-Code-Extension-Doc-ZH/#/

https://code.visualstudio.com/api

https://stackoverflow.com/questions/39569993/vs-code-extension-get-full-path

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

https://www.cnblogs.com/liuxianan/p/vscode-plugin-webview.html

https://code.visualstudio.com/api/extension-guides/webview

VS Code插件入门一

Tue, 30 Jul 2024 00:00:00 +0000

Foreword

一直有一个插件或者工具的想法，只是有初步的一些点，但还不确定具体能做到什么程度，先拿VS Code的插件来实验一下是否可行

VS Code插件入门

VS Code本身是基于Electron的，所以插件的开发基础自然也就是nodejs+js

先搞懂VS Code的基础架构和插件接口，就可以考虑实现一个小demo看看效果

基于插件入门的文档，预备阶段需要一些TS知识就先跳过，写的时候再学也可以

https://liiked.github.io/VS-Code-Extension-Doc-ZH/#/

看了一下插件API可以实现的功能，以下两点大概是我目前最在意的

在UI中添加自定义组件和视图——扩展工作台
创建Webview，使用HTML/CSS/JS显示自定义网页——Webview指南

构建插件

来一次Hello World准是没错的

https://code.visualstudio.com/api/get-started/your-first-extension

准备

Node.js
Git

首先安装好代码生成

npm install --global yo generator-code

最好挂上代理，这个包有点难拉

Hello World

调用脚手架生成代码

yo code

回答一系列问题以后，hellow就生成了，然后根据提示打开一个新的VS Code

提示安装一下插件测试器，并且提示刚才构建的插件过于老了，没关系先玩玩看

自动打开刚才新建的工程，但是此工程实际上可能跑不起来，需要先修改两个内容

直接F5，启动调试，可以看到新起了一个VS Code，尝试看是否有Hello World命令，测试应该是没有的

此时查看测试VS Code的版本号，发现是1.90.2

核对一下package.json中的包代码，发现不一致

  "engines": {
    "vscode": "^1.90.2"
  },
  
    "devDependencies": {
    "@types/vscode": "^1.90.2",

将依赖的包版本修改为对应的VS版本后重启

如果是热修改，VS Code也支持热重启，在调试启动的VS Code使用Ctrl+R就会重新加载修改后的插件，立马就能验证插件了

已经有Hello World命令，并且消息提示正常

主工程的VS Code中可以看到对应的log提示

代码解析

工程结构，相对比较简单

.
├── .vscode
│   ├── launch.json     // 插件加载和调试的配置
│   └── tasks.json      // 配置TypeScript编译任务
├── node_modules        // nodejs需要引用的各种模块
├── test                // 单元测试相关内容
├── .vscode-test.mjs    // 单元测试相关内容
├── .gitignore          
├── .vscodeignore       // vscode工程的忽略文件
├── .eslintrc.json      // 应该是es编译器相关配置
├── jsconfig.json       // js相关配置
├── .gitignore          
├── README.md
├── extension.ts        // 插件源代码
├── package.json        // 插件配置清单
├── tsconfig.json       // TypeScript配置

node_modules/@types/vscode/index.d.ts 中有所有的API接口
前面安装的插件vscode.extension-test-runner是为了配合工程中的test单元测试使用的

其他文件基本都是配置或者环境相关文件，主要实现还是在extension.js中

// The module 'vscode' contains the VS Code extensibility API
// Import the module and reference it with the alias vscode in your code below
const vscode = require('vscode');

// This method is called when your extension is activated
// Your extension is activated the very first time the command is executed

/**
 * @param {vscode.ExtensionContext} context
 */
function activate(context) {

	// Use the console to output diagnostic information (console.log) and errors (console.error)
	// This line of code will only be executed once when your extension is activated
	console.log('Congratulations, your extension "hellow" is now active!');

	// The command has been defined in the package.json file
	// Now provide the implementation of the command with  registerCommand
	// The commandId parameter must match the command field in package.json
	const disposable = vscode.commands.registerCommand('hellow.helloWorld', function () {
		// The code you place here will be executed every time your command is executed

		// Display a message box to the user
		vscode.window.showInformationMessage('Hello World from hellow!');
	});

	context.subscriptions.push(disposable);
}

// This method is called when your extension is deactivated
function deactivate() {}

module.exports = {
	activate,
	deactivate
}

插件注册流程也比较简单，就是激活和反激活，在这两个时间可以做一些注册命令或者安装或者清理环境之类的工作

activate
deactivate

整个插件模块可以暴露的接口，也是可以自定义设计的

module.exports = {
	activate,
	deactivate
}

主要就是调用了两个接口，一个注册命令，一个显示消息

vscode.commands.registerCommand
vscode.window.showInformationMessage

简单理解为向VS Code的上下文中注册了这个接口

context.subscriptions.push

package.json需要重点说明一下，这里面描述了入口是谁，并且插件的版本和他对vscode的版本的要求，这里都是最低版本要求，同时插件的命令也在这里进行了说明

{
  "name": "hellow",
  "displayName": "hellow",
  "description": "",
  "version": "0.0.1",
  "engines": {
    "vscode": "^1.90.2"
  },
  "categories": [
    "Other"
  ],
  "activationEvents": [],
  "main": "./extension.js",
  "contributes": {
    "commands": [{
      "command": "hellow.helloWorld",
      "title": "Hello World"
    }]
  },
  "scripts": {
    "lint": "eslint .",
    "pretest": "npm run lint",
    "test": "vscode-test"
  },
  "devDependencies": {
    "@types/vscode": "^1.90.2",
    "@types/mocha": "^10.0.7",
    "@types/node": "20.x",
    "eslint": "^8.57.0",
    "typescript": "^5.4.5",
    "@vscode/test-cli": "^0.0.9",
    "@vscode/test-electron": "^2.4.0"
  }
}

Summary

第一步ok

Quote

https://liiked.github.io/VS-Code-Extension-Doc-ZH/#/

https://code.visualstudio.com/api