白菜通信过程调用框架-IPC(进程间通信)篇
- 作者: admin
- 时间:
- 分类: 白菜开源项目,白菜通信过程调用框架
- 评论
白菜通信过程调用框架
简介
仓库包含三个主要项目及其下属的各子项目
- 易语言 实现的协程本体（基于Win32Fiber）与协程扩展（文件读写、TCP客户Duan）
- IPC（进程间通信，基于Win32API邮槽和共享内存实现，可采用APC/协程模型或IOCP/多线程模型）
- RPC（远程过程调用，易的实现模型同上，但关键在于跨语言能力，目前实现或已部分实现的语言有E、PHP、JS、Python）
前言的一些问题探讨与设计理念
[1.进程间通信遇到什么问题]
如果进程间通信是完全一对一的（指一个服务器端对应一个单线程客户），并且该单线程的客户不采用任何异步手段进行并发（即每次访问必定等待服务端的响应后才再次访问）那么进程间通信只需两端维护一个共享内存即可（当然该共享内存在设计上可以根据预定好缓冲大小，如果超过该大小则再次采用额外创建共享内存然后用完就释放它）
但如果该单线程客户允许使用异步并发（或是多进程客户或单进程内的多线程客户），也就是一时间的消息到来对于服务器而言没办法维护一个共享内存了，那么此时服务器端就要采用进程级的消息队列的形式（这样即便是多个客户同时往一个服务进程去塞进消息也不会覆盖多个消息本身），然后服务端根据其消息队列本身还可以采用多线程方式去进行“并发式消费”则可同时处理消息并返回处理结果到多个客户，从而进一步提高处理性能！
[2.如何实现进程级消息队列]
尽管有Windows自带的消息队列(Get/SendMessage)但这玩意通常是为窗口UI服务的会受到总消息数和性能的制约；
如果只是进程内的线程间通信可以采用性能最好的APC异步过程调用来实现，但QueueUserAPC并不能跨进程去投递APC队列，因为它所给的回调函数本身就只能在本进程内去访问其自身的地址空间（故只投递消息的话可能本身没什么问题但传递大数据或引用到非本进程的地址就完全不可行了），并且不同位数(32位<->64位)的程序去发起因为它的回调函数代码本身更加不能兼容跨进程的处理（微软官方也指出跨进程APC会存在问题）
如果使用最基本的事件/信号量+固定size的共享内存去搞消息队列，尽管可行，但也不容易向其中发出大量且体积较大的数据，再来是消息队列扩容本身也是个问题，因为CreateFileMapping一旦创建后该大小无法改变、并且也不容易销毁，因为只要有一方打开后内核对象的引用计数就不会是0，只有全都closehandle时才会销毁，故只能再额外创建新共享内存并用链表串起来——但还是那句话维护起来真的很麻烦，像是要手动写共享内存版的内存池管理一样。。
基于以上原因跨进程的消息队列本身不适宜自己手工实现，所以应当寻求系统自带的对于跨进程处理有什么好的内核级对象支持消息队列和传递大数据的通信方案！
[3.邮槽/命名管道/套接字选哪个]——套接字就不用说了性能肯定不如前两者
虽然我最终是使用了邮槽作为通信方案，但我还是要说说命名管道存在的问题
命名管道尽管支持双向通信(可客户到服务端然后服务端返回客户Duan数据)，且在使用的时候参数繁杂不说（提供支持流式和用户报文两种形式），关键是它并不能像TCP套接字那样即时连接即时支持多客户的多路句柄构建（这里边内幕挺深的，写过才知道用这玩意是真坑）
具体来讲，首先需求上应当支持多客户同时访问，那么命名管道本身的管道实例就肯定不能是一个，这句话的理解在于服务端一开始自身是一条管道，消息到来后就必须要为刚进来的客户那端去创建新的管道（这个在TCP套接字编程那边是支持这样做的），故：用多个管道的根本意义在于服务端输出返回值时不与其他客户冲突
尽管命名管道它也支持多个管道实例的连接创建但其实现是不完美的（ConnectNamedPipe用于等待新客户的到来但先前必须要创建好足够多的实例做准备，而不是客户每来一个就临时自动创建一个），此外将命名管道进行IOCP模型化时不容易区分是新到来的客户事件还是正在通信中的客户数据到来（虽然后来知道可以在重叠结构中给出自定义状态，对于新创建的实例投递ConnectNamedPipe后第一次IO完成响应时一定是新客户到来再次发出ReadFile投递后响应才是数据到来，通信完后务必要销毁掉该新实例，故总体而言在编码上还是挺麻烦的——但这不是关键，当你看我对下面分析邮槽IOCP模型化的设计优化你就知道我为什么更亲赖于使用邮槽了）；
使用邮槽的话它虽然仅支持单向通信且以用户报文形式进行传递，并且好处在于无差别客户发送数据进来不需要进行连接和等待连接，不过由于单向性故服务端并不能对其自身的同个邮槽发往到客户Duan，当然解决方案自然是客户Duan自己准备好它那边的邮槽就可以了那么这就不是什么问题了，然后客户投递给服务端数据时需额外提供客户这边自己的邮槽命名就可以让服务端打开后就可以发返回数据了！
[4.邮槽的IOCP模型化与设计优化]
首先在邮槽设计优化上客户这边如果自身对象不跨线程去调用则并不需要临时创建新邮槽，而是直接缓存该通信客户对象在初始化时所在主线程上的同个邮槽对象即可，以后就省去创建和销毁的开销（当然如果同个对象需要支持多线程则不可避免要临时创建和销毁新建的邮槽，可单独区分与初始化时所给的线程ID相对比即可知道当前对象的方法调用是否跨了线程，新建邮槽的意义在于多出一个独立使用的信道而不与原先的传输起冲突）
邮槽IOCP模型化后按理来说，服务端每条线程都维护各自独立的一个固定缓冲区来接收报文是最理想的（避免多次创建和销毁内存），但如果固定了缓冲区也带来一个问题就是要接的报文本身是多大的数据并不能直接知道，接的时候也不一定不会超出缓冲区大小，且最致命的是由于是无差别的客户报文你不可能再接着继续调用ReadFile读之后的数据（因为那可能不是你当前客户的数据，而是其他客户的），
对于邮槽IOCP模型化固定缓冲区的思路本身没问题，而对上述问题我还另外提出了采用共享内存的方式来给出额外参数，具体实现是这样的，首先固定邮槽的缓冲区64KB，如果超出64KB则额外采用共享内存映射的形式直达服务端的进程空间（该共享内存的内核对象名称是临时的，用完后当即销毁），那为何一开始不全都使用共享内存而是64KB？
之所以是64KB，我做个测试即便是映射了共享内存但它存在创建、映射、关闭、销毁该内核对象本身则存在一定的性能损耗，如果是少量数据本身可以一次性在邮槽/管道内携带（不必额外再给出共享内存），大数据的话传输上用上内存共享由于可以直接映射到对方的服务进程方的地址空间被处理时可以投递映射后的指针故是零复制性能非常高效，在64KB的时候创建和销毁共享内存的耗时几乎忽略不计（因为你就算用邮槽/管道传输了本身数据还会被服务端复制出来一份（在ReadFile时所给的缓冲区肯定是私有内存嘛），量越大时本身损耗会逼近创建/销毁共享内存这一内核对象且来的更快在超过64KB可以说是实验得出的临界点）
[5.关于用户权限和Session隔离问题]（付费内容，你也可以尝试问AI自行解决）
[6. 异步单线程协程化处理]
我在易语言这边已经实现了可扩展的协程框架，基于此允许开发者很容易开发出各式的协程生态（比如文件读写、套接字通信等但凡能够原生采用win32异步IO的调用，甚至还有一个通杀的wait信号量的协程化方案）
起初搞协程我是用于游戏脚本，需要每个多任务中死循环延时周期性检测而并行处理子任务，但又不想开多线程去实现（很容易造成资源冲突），由于传统sleep延时本身会阻塞上线程，一个传统非阻塞方案是如果用上可MsgWaitForMultipleObjects临时处理Windows消息的CreateWaitableTimer版本（有些地方被翻译为超级延迟）那么还会造就重叠延迟的问题：
场景是这样的，如果你的第一次超级延迟还没返回则进入了该超级延迟内部的邮槽事件循环处理了下一个客户的延迟的到来，事实上该下一个客户存在延迟那么就会导致该次没结束而上层的上个客户的消息处理循环也不会返回（而每次延迟所用的耗时本身是无意义的），那么这里的延迟会随着回调的增多产生叠加效应（并且，线程栈的大小本身是有限的肯定不可能支持大量的回调地狱）
总的来说如此的叠加效应是会在一个延迟里继续处理了下一个客户的进入于是再延迟导致先前的延迟还要继续等待之后的延迟才能返回！
那么协程这是一个大杀器可以完美解决这一问题，即我需要在延迟的同时还能去做其他事仍需保持其代码上下文的同步性故此需协程化，后来把它慢慢扩展到了在客户Duan/服务端上应用的完整的协程生态！（包括IPC和RPC都通用，甚至还有多子进程模式下的协程版本）
[7. 可变参数及通用数据类型的统一封装格式]
变参由语言本身去实现不必多说，问题在于如何把这些参数高效打包为字节集在通信中的载体，以及不必全解析而随时可访问任意其中的索引参数
参考我的另一个项目： https://bbs.ijingyi.com/forum.php?mod=viewthread&tid=14870183
服务端示例代码（易语言）
客户Duan示例代码（易语言）
IPC的单例服务模式
具体示例参考：IPC\单例服务模式
最后欢迎加群讨论，共同打造易的协程生态 【白易语言研究院】： Q群668536886
白菜通信过程调用框架-协程篇
- 作者: admin
- 时间:
- 分类: 白菜开源项目,白菜通信过程调用框架
- 评论
白菜通信过程调用框架
简介
仓库包含三个主要项目及其下属的各子项目
- 易语言 实现的协程本体（基于Win32Fiber）与协程扩展（文件读写、TCP客户Duan）
- IPC（进程间通信，基于Win32API邮槽和共享内存实现，可采用APC/协程模型或IOCP/多线程模型）
- RPC（远程过程调用，易的实现模型同上，但关键在于跨语言能力，目前实现或已部分实现的语言有E、PHP、JS、Python）
〇、序言·协程的五层境界
第一层：知道一个语言有所谓的执行流程让出机制，如轻量状态切换的yield跟生成器对象
第二层：结合异步IO的含事件消息循环的切换async/await，会用其封装的协程方法
第三层：基于底层封装提供的运行时协程API进行异步框架设计
第四层：理解操作系统线程的核心知识，运行时协程本体的重新设计或再优化（减少模拟栈或完整上下文的行为，并加上内存池、协程池或共享栈进一步减少开销和提升性能）
第五层：状态机协程（由编译器在全局统筹用较少的状态代价生成可复用可恢复的控制流代码）
一、易·协程本体篇（我在第三层）
前言
首先我必须得声明：我的协程实现基于Win32Fiber且用完即销毁（Fiber内存开销上硬性要求最低64KB保留栈（即Fiber最高上限在3w左右）和至少4KB提交栈，快是不可能有多快的，但我想比的压根不是开销跟性能）
我是知道这类运行时协程，后续可以通过内存池等手段来优化附加数据 亦或干脆直接将申请内存的地方放在Fiber实现的保留栈上（即做共享栈、搞Fiber池，而不是用完就销毁再新建）
甚至通过理解系统底层线程切换机制后自己另起炉灶从0开始实现更细致的运行时协程, 但这些实现起来肯定都很不优雅（由于涉及线程寄存器等上下文切换，纯易自身去写是不可能的，要么扣汇编要么封装DLL）
（后面我还会考察C++20的协程——相信在C++那边会得到最优解, 编译器层级的状态机协程,
而想扣汇编的话在编译期是不可能做到的、省去在易干脏活累活的事情了，
不过到时我也已经让易正式退出我的历史了）
在易这边属于最小化实现，代码逻辑清晰，真的不想写成屎山
此外我的目的仅是告诉易友们尽管非高性能下的协程它依然有存在的价值，以及让更多人知道基于协程底层API后的框架设计封装协程应用的基本原理。
- 单线程异步并发下可以写出整洁的同步化代码
- 单线程相比多线程天然无锁读写无冲突的优势，非常适合UI操作
- 协程扩展接口规范，怎样编写的很优雅方便扩展易的协程生态
协程源码里我内置了10000个4字节整型数组来静态存储各个hFbier，这意味着我对易协程的支持只能最大提交10000个任务（同时因Fiber开支要求会占用至少625 MB 的虚拟地址），但可后续通过等待机制阻止协程进一步提交创建新任务，即单线程中每隔100ms去轮询只有等可用的协程退出时才接着继续回到创建点继续创建协程（这部分看源码可知该妥协方案的妙处，【基础协程/! 协程压力测试.e】可测试超过1w的协程任务创建正确执行，当然这个方案也并非完美这个你可以仔细思考还会有什么不足）
等待对象信号(这里演示等待创建的进程退出)
三种方式的等待协程执行完毕
由于代码较多这里就不贴了（可详情源码"三种方式的等待协程执行完毕.e"），这里就简单聊聊
方法一：手动变量计数，手动切换协程
方法二：采用协程通道类（虽然也可以实现但并非协程通道的最佳应用场景）
方法三：自己封装变量计数（同时也将切换细节进行封装，推荐！）
探讨协程通道的真实使用场景
首先我的协程里实现的协程通道有两种模型（LIFO和FIFO，在无数据时 协程级阻塞，push是多生产者，但pop这里实现上局限于一个协程消费者）
其实对于模拟栈而言比模拟队列的意义更大（响应最新事件、覆盖型任务）
比如一种应用场景：适合仪表盘这种实时刷新数据的，现在有好几条数据一块到来了，那么以最后的数据显示为主（其余的可保留作为日志参考或直接丢弃）
而协程里纯队列FIFO（由于我这里实现的协程通常是单线程），那么这种FIFO我认为就没有太大的应用价值
原因是，能用上协程的地方多半是用上异步IO事件的，其给出的响应本身就是串行顺序处理，又或者数据还保留在内核的后续只不过需要赶上时才被接着消费（当然你说是为了快点从内核中摘除数据释放内核缓冲区，其实也不对，因为异步IO每次提交都是会创建分配新的用户内存空间且之后才给到协程上，所以这部分早就脱离内核缓冲区了——当然这部分是可以还再优化为使用先进的内存池管理了）
而这里FIFO本质就也只是普通顺序处理并没有重新做决策（还多了一层毫无必要的搬运）
故协程通道的队列版想要变得有价值，务必实现优先级队列才行（只有“可排序 / 可抢占”的事件队列才有价值）
这里我只是提一个idea，我自己是实际项目并还没用上这部分功能（而且优先级队列实现上也比传统的数据结构较为复杂，通常是完全二叉树实现的MinHeap）
子进程池下的协程服务（付费内容）
- 在各子进程中支持协程复用
- 一个子进程崩溃可自动重启不影响主进程
- 规避易的单个32位进程仅有2GB用户空间的限制
使用示例在【协程本体与协程生态/基础协程/4.子进程池版协程.e】
二、易·协程扩展篇
协程扩展空模板说明
通过当前进程的全局共享内存引出脱离原模块的协程原始接口函数（易的模块由于存在隔离冲突，更关键的是加上我的协程整体设计是单一主线程上的单例模式，其方法的调用务必要使用同一套函数）；
PS：事实上其他语言引出虚函数接口还有更好的办法这里就不多提了，易这里已经是最优解，目前官方仅提供以下2个协程扩展案例（当前仅展示使用，封装设计参考仓库源码），方便后继者使用和学习我的协程生态。
1. 协程扩展-文件读写
2. 协程扩展-TCP客户Duan(基于重叠APC的纯异步单线程)
最后欢迎加群讨论，共同打造易的协程生态
【白易语言研究院】：
Q群668536886
白菜通信过程调用框架
分三个篇章
协程篇
IPC(进程间通信)篇
RPC(远程过程调用)篇
小白菜笔记 - 数学公式编辑器插件
- 作者: admin
- 时间:
- 分类: 付费版,小白菜PC笔记管理器
- 评论
白菜一键精灵
小白菜笔记 - Mht/Htm制作pdf电子书
- 作者: admin
- 时间:
- 分类: 付费版,小白菜PC笔记管理器
- 评论
1. 将小白菜笔记中的mht转换到htm，将所有htm合并到一个完整页面最终生成一个PDF
2.处理当中的超链接和唯一锚点定位
3. 支持根据H(x)标题自动生成PDF标签（也可以根据文件名生成）
4. 设定自定义封面、页眉、页脚、目录样式（这些均用单独的HTML文件进行编写）
输出案例：https://down.xbcsoft.com/xbcMarknote/BC-FB-Standard.pdf
软件下载：
小白菜笔记本体：https://www.xbcsoft.com/archives/xbcMarknote.html
PDF制作器：https://down.xbcsoft.com/xbcMarknote/pdfMaker1.01.7z
软件购买（付费永久授权使用）：
购买须知：
授权方式是一机一码（支持重装系统），注册码在购买后即可得到（日后也可在支付宝搜"xbcsoft"找到商户订单号即为注册码）；
注册码一经发货即视为服务完成，恕不支持退款，请您在购买前确认软件功能满足需求。（或需加Q群668536886交流了解软件详情）；
软件购买后的首次注册需在下载软件的注册机reg.exe内填写购买后的注册码（软件本体不联网），如重装系统或重新下载但凡机器（CPU+主板）没有改变则以“空订单号”进行提交方可重新激活注册；
关于激活失效，如遇到网络原因或机器码意外失效导致无法激活，可联系作者白菜QQ785829865核实信息。
注：软件售价在100元以下且完全离线使用的非技术原因不支持解绑换机操作，需要重新购买，100元以上其他销售中的软件会有额外补充细则。
关于技术支持，仅限软件本体功能的有限技术支持，若技术请求超出服务范围，可能需额外付费。
软件基本使用（基于wkhtmltopdf）
添加所需HTML文件，调好配置（可以导入导出），开始转换即可输出PDF。
输出案例：https://down.xbcsoft.com/xbcMarknote/BC-FB-Standard.pdf
、
注意事项：确保包括html它们在内的资源都放在相对路径内（可以是子目录），HTML编码问题暂且由于易语言技术债的原因（这个项目2015年就开始写了吧）尽管文件编码本身不限，但内码统一使用了GBK（所以得确保源HTML文字不应使用GBK以外的字符）；
如果存在个别编码问题，把[其他]里这个勾打上，可自行修改最终要转换的合并HTML单文件
且由于使用的wkhtmltopdf.exe内核引擎是Qt4的WebKit（支持有限的HTML5，但不支持ES6及以上现代JS特性），之所以不换高版本也是发现存在适配问题，况且现在用的这个版本几乎对我写的文档样式上是比较完美的。
如果存在个别编码问题，把[其他]里这个勾打上，可自行修改最终要转换的合并HTML单文件
且由于使用的wkhtmltopdf.exe内核引擎是Qt4的WebKit（支持有限的HTML5，但不支持ES6及以上现代JS特性），之所以不换高版本也是发现存在适配问题，况且现在用的这个版本几乎对我写的文档样式上是比较完美的。
更多设置预览：
、
、
与小白菜笔记的导航联动
如需小白菜笔记软件联动，将自定义排序功能中导出的hhbc配置进行导入，便于制作PDF目录大纲
PS：导出的hhbc文件是一个7z压缩包，目录中包含配置文件和路径可后期自行编辑修改
接着可以在PDF制作器中导入、导出（会将当前用户设定好的pdf配置一并打包进去）
这里还要再说一下PDF制作目录大纲的细节
有两种模式：一是将每个子章节拆分到独立文件，二是一个单元一个完整的包括所有子章节的文件
- wkhtmltopdf总是按照HTML内的H1~H6去生成目录标签，如果使用了下图的hhbc配置缩进
注：此时这里显示名称必须填入（可以去掉后缀.$suffix）
原理是：将删除HTML中所有的H1~H4的标签（替换为等价样式的非H标签）
而后为每个HTML文件的头部进行生成H级标签，也就是每一个笔记文件它所在管理器中的缩进层次将等价成为H级标签；
但如果每个笔记都是其子内容了那我希望下一单元（主层次的HTML文件）一定进行换页该怎么搞？
事实上现在用了这种模式，首先你就不能在PDF配置这里边勾[在每个htm文件之后插入分页符强制分页]（勾应当要去掉）
换页需要手动在每一个主层次HTML页加上以下换页代码（这个是令上一个文件一定换页的）<DIV style="HEIGHT: 1px; PAGE-BREAK-BEFORE: always"></DIV>
当然如果你觉得直接输入源代码比较繁琐，这里得安利一下白菜一键精灵了，它能够让富文本贮存式一键呼出！
- 还要再说一下小白菜笔记配合写PDF的第二种模式，
那就是一个单元一个文件，然后所有的子标题都全写在里头，内部用H1~H6手动标记（当然不一定是H1，因为H1太大了，我都习惯上用H2开头）——这也是符合wkhtmltopdf内核原本的设定；然后还需设定每个htm文件后强制插入分页选项即可
页脚的奇偶页数对齐
样式已经内置，根据需要自定义，导入所需即可
目录页生成自定义
需要注意的大概就是由于目录页本身所需的页数无法确定（以及是否存在封面HTML的情况），需要按需调模板示例中的整页码的偏移量
知识产权与免责声明：
注册码授权仅限软件使用权，利用本软件发布的作品版权归作者所有，且其作品本身涉及的内容如有侵权行为与本软件无关；此外不得使用“xbcsoft”、"小白菜软件"软件名称、LOGO等素材进行未经授权的商业行为。
小白菜笔记 - Mht/Htm制作仿GitbookWeb站点
- 作者: admin
- 时间:
- 分类: 付费版,小白菜PC笔记管理器
- 评论
1. 将小白菜笔记中的mht转换为html
2. 制作仿gitbook的Web站点（支持部署为PHP搜索）
导出站点案例：
https://wiki.xbcsoft.com/english-grammar/
https://wiki.xbcsoft.com/BC-FB-Standard/
软件下载：
小白菜笔记本体：https://www.xbcsoft.com/archives/xbcMarknote.html
仿gitbook站点制作器：https://down.xbcsoft.com/xbcMarknote/webMaker1.01.7z
软件购买（付费永久授权使用）：
购买须知：
授权方式是一机一码（支持重装系统），注册码在购买后即可得到（日后也可在支付宝搜"xbcsoft"找到商户订单号即为注册码）；
注册码一经发货即视为服务完成，恕不支持退款，请您在购买前确认软件功能满足需求。（或需加Q群668536886交流了解软件详情）；
软件购买后的首次注册需在下载软件的注册机reg.exe内填写购买后的注册码（软件本体不联网），如重装系统或重新下载但凡机器（CPU+主板）没有改变则以“空订单号”进行提交方可重新激活注册；
关于激活失效，如遇到网络原因或机器码意外失效导致无法激活，可联系作者白菜QQ785829865核实信息。
注：软件售价在100元以下且完全离线使用的非技术原因不支持解绑换机操作，需要重新购买，100元以上其他销售中的软件会有额外补充细则。
关于技术支持，仅限软件本体功能的有限技术支持，若技术请求超出服务范围，可能需额外付费。
软件基本使用：
1.
将mht批量转换为html，在软件页面中添加文件/目录然后点击转换按钮即可；
其中主要的难点在于解决修复mht中URL链接问题（这个在使用笔记软件中内置的WizHtmlEditor编辑器在打开和保存mht的时候它是将临时目录中的文件进行封包会有该BUG路径的存在，我是后期做了此修复）
2. 需小白菜笔记软件联动，将自定义排序功能中导出的hhbc配置进行导入，便于制作仿gitbook的Web站点
PS：导出的hhbc文件是一个7z压缩包，目录中包含配置文件和路径可后期自行编辑修改（还有其中的导航标题可自定义展示）
注：源书籍目录中可有一个index.mht或index.html作为首页展示（否则站点首次进入时不展示任何内容，如站点案例展示中的英语语法参考手册）
此外，预处理统一书籍模板、样式可在本软件的目录内修改
（style.css、template_index.html）：
一句暖心的忠告说在前头：
从技术角度你确实可以只下载软件后，通过修改template_index.html、style.css自写一个模板引擎的工具（我也知道现在AI已经很强大了）来达到跟我工具一样的效果，我也不阻止你这样做因为你有能力确实也可以省下这笔钱（但你还是会花费些许时间去做调试其实原则上也是等价的，当然你还想二次销售另当别论，如果你真心认可我的作品，你的付费是我继续坚持做知识付费和原创软件的动力）
我是真心希望大环境能够变好的，当然你执意窃取我的果实，那我还有一个最后的尊严其底线就是在我的群里不要肆无忌惮来砸场就好。
从技术角度你确实可以只下载软件后，通过修改template_index.html、style.css自写一个模板引擎的工具（我也知道现在AI已经很强大了）来达到跟我工具一样的效果，我也不阻止你这样做因为你有能力确实也可以省下这笔钱（但你还是会花费些许时间去做调试其实原则上也是等价的，当然你还想二次销售另当别论，如果你真心认可我的作品，你的付费是我继续坚持做知识付费和原创软件的动力）
我是真心希望大环境能够变好的，当然你执意窃取我的果实，那我还有一个最后的尊严其底线就是在我的群里不要肆无忌惮来砸场就好。
导入hhbc配置后点击开始转换即可生成站点文件
注：本单例站点可直接以本地文件打开（但由于浏览器的XHR同源策略限制，会有诸多限制），建议配合Web服务器进行部署（如果配合PHP将直接得到搜索功能，当然如果你是其他语言需了解index.html与search.php中的交互逻辑以及collection.pack的封装和检索原理后可自行编写）
导出站点案例：
https://wiki.xbcsoft.com/english-grammar/
https://wiki.xbcsoft.com/BC-FB-Standard/
此外：如需定制PHP站点进行指定页面的授权控制需求，可在群里单独联系白菜作者进行开发。
知识产权与免责声明：
注册码授权仅限软件使用权，利用本软件发布的作品版权归作者所有，且其作品本身涉及的内容如有侵权行为与本软件无关；此外不得使用“xbcsoft”、"小白菜软件"软件名称、LOGO等素材进行未经授权的商业行为。
小白菜笔记 - Mht/Htm制作chm
- 作者: admin
- 时间:
- 分类: 付费版,小白菜PC笔记管理器
- 评论
1. 将小白菜笔记中的mht[可选]转换为html（存在#锚点定位问题则必须转）
2. 将mht/htm制作chm帮助文档
输出案例：https://down.xbcsoft.com/xbcMarknote/english-grammar.chm
软件下载：
小白菜笔记本体：https://www.xbcsoft.com/archives/xbcMarknote.html
CHM制作器：https://down.xbcsoft.com/xbcMarknote/chmMaker1.0.7z
软件购买（付费永久授权使用）：
购买须知：
授权方式是一机一码（支持重装系统），注册码在购买后即可得到（日后也可在支付宝搜"xbcsoft"找到商户订单号即为注册码）；
注册码一经发货即视为服务完成，恕不支持退款，请您在购买前确认软件功能满足需求。（或需加Q群668536886交流了解软件详情）；
软件购买后的首次注册需在下载软件的注册机reg.exe内填写购买后的注册码（软件本体不联网），如重装系统或重新下载但凡机器（CPU+主板）没有改变则以“空订单号”进行提交方可重新激活注册；
关于激活失效，如遇到网络原因或机器码意外失效导致无法激活，可联系作者白菜QQ785829865核实信息。
注：软件售价在100元以下且完全离线使用的非技术原因不支持解绑换机操作，需要重新购买，100元以上其他销售中的软件会有额外补充细则。
关于技术支持，仅限软件本体功能的有限技术支持，若技术请求超出服务范围，可能需额外付费。
软件基本使用：
1.
将mht批量转换为html，在软件页面中添加文件/目录然后点击转换按钮即可；
其中主要的难点在于解决修复mht中URL链接问题（这个在使用笔记软件中内置的WizHtmlEditor编辑器在打开和保存mht的时候它是将临时目录中的文件进行封包会有该BUG路径的存在，我是后期做了此修复）
2. 需小白菜笔记软件联动，将自定义排序功能中导出的hhbc配置进行导入，便于制作仿gitbook的Web站点
PS：导出的hhbc文件是一个7z压缩包，目录中包含配置文件和路径可后期自行编辑修改（还有其中的导航标题可自定义展示）
输出案例：https://down.xbcsoft.com/xbcMarknote/english-grammar.chm
高级特性自定义：
1. hhbc文件
hhbc配置文件是一个7z压缩包，在小白菜笔记中导出时已经生成了这三个跟帮助文档相关的配置文件
hhc后缀：CHM中一个用于HTML描述的左侧导航目录列表（它会引用需要的相对路径下的文件）
hhk后缀：索引列表，它也是一个HTML文件，通常情况可以等价于hhc（如果你不希望全引用导航目录中的内容，可以自行定义，当然导航目录也不一定展示所有的文件）
hhp后缀：这是一个搜集所有将要打包那些mht/html文件的INI配置（当然还包括描述CHM本体窗口样式的配置）
hhp后缀：这是一个搜集所有将要打包那些mht/html文件的INI配置（当然还包括描述CHM本体窗口样式的配置）
2. 帮助文档样式
对于帮助文档本身的样式生成（直接去查阅微软官方文档不直观学习成本也过大），
这里我推荐使用《PowerCHM》这款软件，打开此软件选项就可以自由编辑所需的CHM的窗口样式了
内容就随便添加个文件，然后直接对项目另存为，就能够生成chm所需的原生hhp配置了
我知道你现在肯定有这样的疑问，那我直接用人家这个软件去编写CHM不就好了？
那我把话先说在前头，它这款软件同样也是付费的，但不影响我们简单去免费使用它的另存为功能
尽管网上也有所谓的破解版，但chm帮助文档都有一个致命问题，那就是对中文文件名存在hash冲突导致部分链接不上，这也是我上边为什么要重新编码采用十六进制避免出现中文文件名的问题
如果你想自己独立开发chm制作器那么需要注意到这个问题，所以我的小白菜笔记软件就是提供了一整套的写笔记的解决方案，如果你觉得我的作品非常棒，你的付费是我继续坚持做知识付费和原创软件的动力~
那我把话先说在前头，它这款软件同样也是付费的，但不影响我们简单去免费使用它的另存为功能
尽管网上也有所谓的破解版，但chm帮助文档都有一个致命问题，那就是对中文文件名存在hash冲突导致部分链接不上，这也是我上边为什么要重新编码采用十六进制避免出现中文文件名的问题
如果你想自己独立开发chm制作器那么需要注意到这个问题，所以我的小白菜笔记软件就是提供了一整套的写笔记的解决方案，如果你觉得我的作品非常棒，你的付费是我继续坚持做知识付费和原创软件的动力~
知识产权与免责声明：
注册码授权仅限软件使用权，利用本软件发布的作品版权归作者所有，且其作品本身涉及的内容如有侵权行为与本软件无关；此外不得使用“xbcsoft”、"小白菜软件"软件名称、LOGO等素材进行未经授权的商业行为。
小白菜PC笔记管理器（本体完全免费）
- 作者: admin
- 时间:
- 分类: 免费版,白菜成品软件,小白菜PC笔记管理器
- 评论
小白菜笔记~为你点亮每一刻的技忆！
功能如下：
1. 支持高效便捷的Windows原生操作体验（内含资源管理器目录视图、打开方式等）
2. 支持txt/html/mht/md文档、pdf电子书、office三件套等格式预览/编辑
X. 下图中展示的功能目录大纲
完整记笔记软件的教程文档：
https://wiki.xbcsoft.com/xbcMarknote/
软件下载（本体功能完全免费）：
https://down.xbcsoft.com/xbcMarknote/xbcMarknote1.01.7z
以下属于笔记管理器外的扩展工具生态（需额外付费）：
数学公式编辑器插件：https://www.xbcsoft.com/archives/mathEdit.html
白菜一键精灵（生产富文本样式）：https://www.xbcsoft.com/archives/BCKeySmart.html
Mht/Htm制作chm：https://www.xbcsoft.com/archives/chmMaker.html
Mht/Htm制作pdf电子书：https://www.xbcsoft.com/archives/pdfMaker.html
Mht/Htm制作仿GitbookWeb站点：https://www.xbcsoft.com/archives/webMaker.html