維基百科討論:HanAssist
新增話題外觀
由Dabao qian在話題在其他wiki上使用上作出的最新留言:27 天前
HanAssist第四版
[編輯]- 下列討論已經關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。
HanAssist是一個wgULS及類似函數的替代品。舊版本文檔請參見Wikipedia:HanAssist。
倉庫地址:https://github.com/diskdance/HanAssist
第四版API本體變化不大,主要是調用方式:
- 杜絕了污染全局空間的問題。原先API會暴露到全局空間(
mw.libs),現在採用了ResourceLoader的模塊化設計。小工具需要先添加HanAssist的依賴,然後按照如下方式使用:用戶腳本則需要動態加載:const { conv, convByVar, batchConv } = require('ext.gadget.HanAssist'); // 注意大小写 // 对应wgULS conv( { hans: '一天一苹果,医生远离我。', hant: '一天一蘋果,醫生遠離我。' } ); // 对应wgUVS convByVar( { hans: '一天一苹果,医生远离我。', hant: '一天一蘋果,醫生遠離我。' } ); // 批量处理 mw.messages.set( batchConv( { 'article': { hans: '条目', hant: '條目' }, 'category': { hans: '分类', hant: '分類' }, 'categories': { hans: '分类', hant: '分類' }, 'image': { hans: '文件', hant: '檔案' }, 'images': { hans: '文件', hant: '檔案' }, 'minute': '分', 'minutes': '分', 'second': '秒', 'seconds': '秒', 'week': '周', 'weeks': '周', 'search': { hans: '搜索', hant: '搜尋' }, 'SearchHint': { hans: '搜索包含$1的页面', hant: '搜尋包含$1的頁面' }, 'web': { hans: '站点', hant: '站點' }, } ) ); mw.msg( 'categories' ); mw.msg( 'SearchHint', 'Apple' );
其他的加載方式不保證可用。mw.loader.using( 'ext.gadget.HanAssist' ).then( ( require ) => { const { conv, convByVar } = require( 'ext.gadget.HanAssist' ); // 在此处使用 } );
- 函數採用更直觀的命名方式。
- 現在在傳入不合法的參數的時候會給出警告信息。
以上。--碟之舞📀💿 2023年7月26日 (三) 10:20 (UTC)
- 小工具已經部署到中文Beta Cluster,各位可以先試試效果。--碟之舞📀💿 2023年7月26日 (三) 10:22 (UTC)
- 「其他的加載方式不保證可用。」意味着舊腳本需要維護更新?會有人來做嗎。--YFdyh000(留言) 2023年7月26日 (三) 15:22 (UTC)
- 不是這個意思。--碟之舞📀💿 2023年7月27日 (四) 03:33 (UTC)
- (-)反對,使用v4的載入法將導致該腳本必須以非常糟糕的方式(技術細節:v4載入法必然需要將HanAssist注入ResourceLoader才能使用,變成如果要在無此小工具的站點載入將必須污染ResourceLoader)才能被站外引用,這顯然不是一個合適的作法--SunAfterRain 2023年7月27日 (四) 15:15 (UTC)
- (+)支持--Taeas(留言) 2023年7月28日 (五) 05:36 (UTC)
- 上方所述的問題已經解決,如果沒有問題的話能否開始公示?--碟之舞📀💿 2023年8月2日 (三) 13:21 (UTC)
- 我覺得可以。--Taeas(留言) 2023年8月3日 (四) 02:04 (UTC)
- 部署方案:
- 從中文維基百科測試集群處複製此小工具的原始碼和小工具定義。
- 移除
site-lib中wgU*S的相關內容,由HanAssist接管,可參考測試集群配置。 - 將
ext.gadget.HanAssist添加為site-lib的依賴項。
公示7日,2023年8月11日 (五) 03:44 (UTC) 結束,抄送@Xiplus、@安憶- 以上。--碟之舞📀💿 2023年8月4日 (五) 03:43 (UTC)
- 本討論已關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。
在其他wiki上使用
[編輯]有些wiki項目(例如中文維基教科書)仍然採用老舊的wgU*S作為腳本字詞轉換系統,如果在這些項目上按照文檔中的用法直接跨站加載中文維基百科的HanAssist,則用戶工具就會因為無法改寫wgULS全局變量而報錯退出。針對這種跨維基使用的腳本,目前建議的做法是自行加載SunAfterRain放在元維基的HanAssist分支版本。例如:
function implWrapper( ...args ) {
if ( typeof mw.loader.impl === 'function' ) {
return mw.loader.impl( function () {
return args;
} );
}
return mw.loader.implement.apply( mw.loader, args );
}
async function loadHanAssist() {
const moduleName = 'userscript.MyGadget.HanAssist';
if ( mw.loader.getState( 'ext.gadget.HanAssist' ) ) {
mw.loader.register( moduleName, null, [ 'ext.gadget.HanAssist' ] );
await mw.loader.using( 'ext.gadget.HanAssist' );
implWrapper(
moduleName + '@',
{
main: 'index.js',
files: {
'index.js': ( require, module ) => {
module.exports = require( 'ext.gadget.HanAssist' );
}
}
}
);
if ( mw.loader.getState( moduleName ) === 'missing' ) {
mw.loader.state( { [ moduleName ]: 'loaded' } );
}
} else {
mw.loader.register( moduleName, null, [] );
implWrapper(
moduleName + '@',
[ 'https://meta.wikimedia.org/w/index.php?title=User:SunAfterRain/js/HanAssist.js&action=raw&ctype=text/javascript' ]
);
await mw.loader.using( moduleName );
}
const require = await mw.loader.using( moduleName );
return require( moduleName );
}
( async () => {
const { conv } = await loadHanAssist();
// 在此处使用
} )();
(這裏的內容就當我隨手記的筆記吧)--Dabao qian℡ 2026年10月18日 (日) 19:30 (UTC)
- 千萬別學我去hack mw.loader啊,
mw.loader.register、mw.loader.state、mw.loader.impl(及以前的mw.loader.implement)都是private api啊
囧rz……--SunAfterRain 2026年10月19日 (一) 16:28 (UTC)
- 改成原生fetch就可以確保100%不污染RL以及不使用私有API。--Dabao qian℡ 2026年10月21日 (三) 21:22 (UTC)