@lf_maple/koishi-plugin-phi-plugin-full 0.1.80

package/core/apps/Dan.js

@@ -0,0 +1,129 @@
+// import plugin from '../../../lib/plugins/plugin.js'
+// import Config from '../components/Config.js'
+// import send from '../model/render/send.js'
+// import get from '../model/getdata.js'
+// import Vika from '../model/integrations/Vika.js'
+// import { segment } from 'oicq'
+// import getSave from '../model/save/getSave.js'
+// import getBanGroup from '../model/user/getBanGroup.js';
+
+// const read = 'https://www.bilibili.com/read/cv27354116'
+// const sheet = 'https://f.kdocs.cn/g/fxsg4EM2/'
+// const word = get.getimg('dan_code')
+
+// const cancanneed = Vika.PhigrosDan ? true : false
+
+// if (!cancanneed) {
+//     logger.info(`[Phi-Plugin]未填写 Vika Token ，将禁用段位认证。`)
+// }
+
+// export class phiDan extends plugin {
+//     constructor() {
+//         super({
+//             name: 'phi-dan',
+//             dsc: 'phigros屁股肉段位',
+//             event: 'message',
+//             priority: 1000,
+//             rule: [
+//                 {
+//                     reg: `^[#/](${Config.getUserCfg('config', 'cmdhead')})(\\s*)(Dan|dan)(\\s*)update$`,
+//                     fnc: 'danupdate'
+//                 },
+//                 {
+//                     reg: `^[#/](${Config.getUserCfg('config', 'cmdhead')})(\\s*)(Dan|dan).*$`,
+//                     fnc: 'dan'
+//                 }
+//             ]
+//         })
+
+//     }
+
+//     async dan(e) {
+//         if (!cancanneed) {
+//             return false
+//         }
+
+//         if (await getBanGroup.get(e, 'dan')) {
+//             send.send_with_At(e, '这里被管理员禁止使用这个功能了呐QAQ！')
+//             return false
+//         }
+
+//         let name = e.msg.replace(/[#/].*(dan|Dan)(\s*)/g, '')
+//         if (!name) {
+//             let dan = await getSave.getDan(e.user_id, true)
+//             if (dan[0]) {
+//                 let resmsg = [`你的认证段位为`]
+//                 for (let i in dan) {
+//                     resmsg.push(`\n${dan[i].Dan.replace('/', ' ')} ${dan[i].EX ? 'EX' : ''}`)
+//                     resmsg.push(segment.image(dan[i].img))
+//                 }
+//                 send.send_with_At(e, resmsg)
+//             } else {
+//                 send.send_with_At(e, [`唔，本地没有你的认证记录哦！如果提交过审核的话，可以试试更新一下嗷！\n格式：/${Config.getUserCfg('config', 'cmdhead')} dan update`, word])
+//             }
+
+//             return true
+
+//         } else {
+//             try {
+//                 let dan = await Vika.GetUserDanByName(name);
+//                 if (!dan) {
+//                     send.send_with_At(e, [`唔，暂时没有在审核通过列表里找到${name}哦！如果提交过审核的话，请耐心等待审核通过哦！`, word])
+//                     return true
+//                 }
+//                 let resmsg = [`${name}的认证段位为`]
+//                 for (let i in dan) {
+//                     resmsg.push(`\n${dan[i].Dan.replace('/', ' ')} ${dan[i].EX ? 'EX' : ''}`)
+//                     resmsg.push(segment.image(dan[i].img))
+//                 }
+//                 send.send_with_At(e, resmsg)
+//                 return true
+//             } catch (err) {
+//                 logger.info(err)
+//                 send.send_with_At(e, `当前服务忙，请稍后重试QAQ！` + err)
+//                 return true
+//             }
+//         }
+//     }
+
+//     async danupdate(e) {
+//         if (!cancanneed) {
+//             return false
+//         }
+
+//         if (await getBanGroup.get(e, 'danupdate')) {
+//             send.send_with_At(e, '这里被管理员禁止使用这个功能了呐QAQ！')
+//             return false
+//         }
+
+//         /**检查是否绑定并提示 */
+//         let save = await send.getsave_result(e)
+//         if (!save) {
+//             return true
+//         }
+//         let dan = undefined
+//         try {
+//             dan = await Vika.GetUserDanBySstk(save.session);
+//         } catch (err) {
+//             logger.info(err)
+//             send.send_with_At(e, `当前服务忙，请稍后重试QAQ！` + err)
+//             return true
+//         }
+
+//         if (!dan) {
+//             send.send_with_At(e, [`唔，暂时没有在审核通过列表里找到你哦！如果提交过审核的话，请耐心等待审核通过哦！`, word])
+//             return true
+//         }
+
+//         history.dan = dan
+
+//         let resmsg = [`更新成功！你的认证段位为\n`]
+//         for (let i in dan) {
+//             resmsg.push(`${dan[i].Dan.replace('/', ' ')} ${dan[i].EX ? 'EX' : ''}`)
+//             resmsg.push(segment.image(dan[i].img))
+//         }
+//         send.send_with_At(e, resmsg)
+//         return true
+//     }
+
+// }

package/core/apps/RankList.js

@@ -0,0 +1,322 @@
+import Save from '../model/save/Save.js'
+import fCompute from '../model/game/fCompute.js'
+import getInfo from '../model/game/getInfo.js'
+import getRksRank from '../model/game/getRksRank.js'
+import getSave from '../model/save/getSave.js'
+import send from '../model/render/send.js'
+import picmodle from '../model/render/picmodle.js'
+import Config from '../components/Config.js'
+import getBanGroup from '../model/user/getBanGroup.js';
+import makeRequest from '../model/api/makeRequest.js'
+import saveHistory from '../model/save/saveHistory.js'
+import phiPluginBase from '../components/baseClass.js'
+import { canUseApi } from '../model/user/apiPermission.js';
+import logger from '../components/Logger.js'
+import platform from '../components/platform/index.js'
+import { UserCredentials } from '../model/user/userCredentials.js'
+
+/**@import {botEvent} from '../components/baseClass.js' */
+
+export class phiRankList extends phiPluginBase {
+
+    constructor() {
+        super({
+            name: 'phi-rankList',
+            event: 'message',
+            priority: 1000,
+            dsc: 'phigros rks 排行榜',
+            rule: [
+                {
+                    reg: `^[#/](${Config.getUserCfg('config', 'cmdhead')})(\\s*)(排行榜|ranklist).*$`,
+                    fnc: 'rankList'
+                },
+                {
+                    reg: `^[#/](${Config.getUserCfg('config', 'cmdhead')})(\\s*)(查询排名|rankfind).*$`,
+                    fnc: 'rankfind'
+                }
+                // {
+                //     reg: `^[#/](${Config.getUserCfg('config', 'cmdhead')})(\\s*)(封神榜|godlist)$`,
+                //     fnc: 'godList'
+                // }
+            ]
+
+        })
+    }
+
+    /**
+     * 
+     * @param {botEvent} e 
+     * @returns 
+     */
+    async rankList(e) {
+
+        if (await getBanGroup.get(e, 'rankList')) {
+            send.send_with_At(e, '这里被管理员禁止使用这个功能了呐QAQ！')
+            return false
+        }
+
+
+
+        if (await canUseApi(e)) {
+            const credentials = UserCredentials.fromEvent(e)
+            let data = {
+                Title: "RankingScore排行榜",
+                totDataNum: 0,
+                BotNick: platform.getBotNickname(e),
+                /** @type {rankingListObject[]} */
+                users: [],
+                me: {},
+            }
+            /**请求的排名 */
+            let msg = e.msg.match(/\d+/)
+            const api_ranklist = msg
+                ? await makeRequest.getRanklistRank({ request_rank: Number(msg[0]) }, { event: e })
+                : await credentials.getRanklistUser()
+            if (api_ranklist) {
+                data.totDataNum = api_ranklist.totDataNum;
+                for (let item of api_ranklist.users) {
+                    data.users.push({ ...await makeSmallLine(item), index: item.index, me: item.me })
+                }
+                data.me = await makeLargeLine(new Save(api_ranklist.me.save), new saveHistory(api_ranklist.me.history), e)
+                send.send_with_At(e, [await picmodle.common(e, 'rankingList', data), `总数据量：${data.totDataNum}\n`])
+                return true
+            }
+        }
+        let data = {
+            Title: "RankingScore排行榜",
+            totDataNum: 0,
+            BotNick: platform.getBotNickname(e),
+            /** @type {rankingListObject[]} */
+            users: [],
+            me: {},
+        }
+        /**请求的排名 */
+        let msg = e.msg.match(/\d+/)
+        let rankNum = 0
+        data.totDataNum = await getRksRank.getAllRank()
+
+        if (msg) {
+            rankNum = Math.max(Math.min(Number(msg[0]), data.totDataNum), 1) - 1
+        } else {
+            let save = await send.getsave_result(e)
+            if (!save) {
+                return true
+            }
+            let sessionToken = save.getSessionToken()
+            rankNum = await getRksRank.getUserRank(sessionToken)
+        }
+
+        /**展示的用户数据 */
+        let list = []
+        let myTk = ''
+        if (rankNum < 2) {
+            list = await getRksRank.getRankUser(0, 5)
+            myTk = list[rankNum]
+        } else {
+            list = await getRksRank.getRankUser(rankNum - 2, rankNum + 3)
+            myTk = list[2]
+        }
+
+
+        for (let index = 0; index < Math.max(list.length, 5); index++) {
+            if (index >= list.length) {
+                data.users.push({ playerId: '无效用户', index: index + rankNum - 2 })
+                continue
+            }
+            let item = list[index]
+            let sessionToken = item
+            const save = await getSave.getSaveBySessionToken(sessionToken)
+            if (!save) {
+                data.users.push({ playerId: '无效用户', index: index + rankNum - 2 })
+                getRksRank.delUserRks(sessionToken)
+            } else {
+                data.users.push({ ...await makeSmallLine(save), index: Math.max(index + rankNum - 1, index + 1), me: myTk === save.getSessionToken() })
+                if (myTk === sessionToken) {
+                    let history = await getSave.getHistoryBySessionToken(save.getSessionToken())
+                    data.me = await makeLargeLine(save, history, e)
+                }
+            }
+        }
+
+        send.send_with_At(e, [`总数据量：${data.totDataNum}\n`, await picmodle.common(e, 'rankingList', data)])
+    }
+
+    /**
+     * 
+     * @param {botEvent} e 
+     * @returns 
+     */
+    async rankfind(e) {
+        if (await getBanGroup.get(e, 'rankList')) {
+            send.send_with_At(e, '这里被管理员禁止使用这个功能了呐QAQ！')
+            return false
+        }
+
+        let rks = Number(e.msg.replace(/^[#/]?.*?rankfind/, '').match(/\d+(.\d+)?/)?.[0])
+        if (!rks) {
+            send.send_with_At(e, `请输入要查询的 rks！\n格式： /${Config.getUserCfg('config', 'cmdhead')} rankfind <rks>`)
+            return false
+        }
+
+        if (await canUseApi(e, 'scoreStatistics')) {
+            const res = await makeRequest.getRanklistRks({ request_rks: rks }, { event: e })
+            if (res) {
+                send.send_with_At(e, `当前服务器记录中一共有 ${res.rksRank}/${res.totNum} 位玩家的 rks 大于 ${rks}！`)
+                return true
+            }
+        }
+
+        let totDataNum = await getRksRank.getAllRank()
+
+        let rank = await getRksRank.getRankByRks(rks)
+
+        send.send_with_At(e, `当前服务器记录中一共有 ${totDataNum - rank + 1}/${totDataNum} 位玩家的 rks 大于等于 ${rks}！`)
+
+        return true
+    }
+
+
+    // /**
+    //  * 
+    //  * @param {botEvent} e 
+    //  * @returns 
+    //  */
+    // async godList(e) {
+
+    //     if (await getBanGroup.get(e, 'godList')) {
+    //         send.send_with_At(e, '这里被管理员禁止使用这个功能了呐QAQ！')
+    //         return false
+    //     }
+
+    //     let plugin_data = await getNotes.getPluginData(e.user_id)
+    //     let data = {
+    //         Title: "封神榜",
+    //         totDataNum: 0,
+    //         BotNick: Bot.nickname,
+    //         users: [],
+    //         background: getInfo.getill(getInfo.illlist[Number((Math.random() * (getInfo.illlist.length - 1)).toFixed(0))], 'blur'),
+    //         theme: plugin_data?.plugin_data?.theme || 'star',
+    //     }
+
+    //     if (!list) {
+    //         data.totDataNum = 0
+    //         send.send_with_At(e, await picmodle.common(e, 'rankingList', data))
+    //         return true
+    //     }
+
+    //     data.totDataNum = list.length
+
+    //     for (let i = 0; i < list.length; i++) {
+    //         try {
+    //             let godRecord = new PhigrosUser(list[i].match(/[a-zA-Z0-9]{25}/)[0])
+    //             await godRecord.buildRecord()
+    //             let god = new Save(godRecord, true)
+    //             await god.init()
+    //             data.users.push(await makeLargeLine(god))
+    //             data.users[data.users.length].index = i
+    //         } catch (e) { }
+    //     }
+    //     send.send_with_At(e, await picmodle.common(e, 'rankingList', data))
+    // }
+}
+
+/**
+ * 创建一个详细对象
+ * @param {Save} save 
+ * @param {saveHistory} history
+ * @param {botEvent} e
+ */
+async function makeLargeLine(save, history, e) {
+    if (!save) {
+        return {
+            playerId: "无效用户"
+        }
+    }
+
+
+    let lineData = history.getRksAndDataLine()
+    lineData.rks_date.forEach((item, index) => {
+        // @ts-ignore
+        item = fCompute.formatDateToNow(item)
+        lineData.rks_date[index] = item
+    });
+    /**
+     * @type {{ ChallengeMode: number; ChallengeModeRank: number; date: string; }[]}
+     */
+    let clgHistory = []
+    history.challengeModeRank.forEach((item, index, array) => {
+        if (!index || item.value != array[index - 1].value) {
+            clgHistory.push({
+                ChallengeMode: Math.floor(item.value / 100),
+                ChallengeModeRank: item.value % 100,
+                date: fCompute.formatDateToNow(item.date)
+            })
+        }
+    })
+    let b30Data = await save.getB19(e, 33)
+    let b30list = {
+        P3: {
+            title: 'Perfect 3',
+            list: b30Data.phi
+        },
+        B3: {
+            title: 'Best 3',
+            list: b30Data.b19_list.slice(0, 3)
+        },
+        F3: {
+            title: 'Floor 3',
+            list: b30Data.b19_list.slice(24, 27)
+        },
+        L3: {
+            title: 'Overflow 3',
+            list: b30Data.b19_list.slice(27, 30)
+        }
+    }
+    return {
+        backgroundurl: getInfo.getBackground(save?.gameuser?.background),
+        avatar: getInfo.idgetavatar(save.saveInfo.summary.avatar) || 'Introduction',
+        playerId: fCompute.convertRichText(save.saveInfo.PlayerId),
+        rks: save.saveInfo.summary.rankingScore || 0,
+        ChallengeMode: Math.floor(save.saveInfo.summary.challengeModeRank / 100),
+        ChallengeModeRank: save.saveInfo.summary.challengeModeRank % 100,
+        updated: fCompute.formatDate(save.saveInfo.modifiedAt.iso),
+        selfIntro: fCompute.convertRichText(save?.gameuser?.selfIntro),
+        rks_history: lineData.rks_history,
+        rks_range: lineData.rks_range,
+        rks_date: lineData.rks_date,
+        b30list: b30list,
+        clg_list: clgHistory,
+    }
+}
+
+/**
+ * @typedef {Object} rankingListObject
+ * @property {string} playerId
+ * @property {string} [backgroundurl]
+ * @property {string} [avatar]
+ * @property {number} [rks]
+ * @property {number} [ChallengeMode]
+ * @property {number} [ChallengeModeRank]
+ * @property {boolean} [me]
+ * @property {number} index
+ */
+
+/**
+ * 创建一个简略对象
+ * @param {Save | import('../model/api/makeRequest.js').UserItem} save 
+ */
+async function makeSmallLine(save) {
+    if (!save) {
+        return {
+            playerId: "无效用户",
+        }
+    }
+    return {
+        backgroundurl: getInfo.getBackground(save?.gameuser?.background),
+        avatar: getInfo.idgetavatar(save.saveInfo.summary.avatar || ''),
+        playerId: fCompute.convertRichText(save.saveInfo.PlayerId),
+        rks: save.saveInfo.summary.rankingScore,
+        ChallengeMode: Math.floor(save.saveInfo.summary.challengeModeRank / 100),
+        ChallengeModeRank: save.saveInfo.summary.challengeModeRank % 100,
+    }
+}

package/core/apps/aliasProposal.js

@@ -0,0 +1,223 @@
+import Config from '../components/Config.js'
+import phiPluginBase from '../components/baseClass.js'
+import send from '../model/render/send.js'
+import getInfo from '../model/game/getInfo.js'
+import aliasProposalService from '../model/api/aliasProposalService.js'
+import botSyncService from '../model/api/botSyncService.js'
+
+/** @import {PlatformEvent} from '../components/platform/types.js' */
+/** @import {AliasProposalRecord, AliasProposalStatus} from '../model/type/aliasProposal.js' */
+
+const head = Config.getUserCfg('config', 'cmdhead')
+const prefix = `^[#/](${head})(\\s*)(别名|alias)(\\s*)`
+
+/** @returns {import('../components/platform/types.js').PlatformTask} */
+export function createAliasProposalTask() {
+    return {
+        name: 'phi-Bot状态与正式别名同步',
+        fnc: async () => {
+            await botSyncService.scheduledTask()
+            await aliasProposalService.scheduledTask()
+        },
+        cron: '0 * * * * ?',
+    }
+}
+
+/** @type {Record<AliasProposalStatus, string>} */
+const statusName = {
+    submitted: '等待初审',
+    rejected_private: '私密拒绝',
+    public_review_requested: '已申请公审',
+    public_voting: '公开投票',
+    vote_passed: '投票通过待终审',
+    approved: '正式通过',
+    public_review_denied: '公审申请被拒',
+    rejected_final: '最终拒绝',
+}
+
+/**
+ * 按命令前缀和竖线分隔符解析用户输入。
+ * @param {string} message 原始消息文本
+ * @param {string} command 命令部分的正则表达式片段
+ * @returns {string[]} 去除首尾空白后的参数
+ */
+function splitArgs(message, command) {
+    return message
+        .replace(new RegExp(`${prefix}${command}\\s*`, 'i'), '')
+        .split('|')
+        .map(item => item.trim())
+}
+
+/**
+ * 将提案列表格式化为适合 Bot 文本消息的紧凑内容。
+ * @param {AliasProposalRecord[]} items 提案列表
+ * @param {boolean} [includeVote=false] 是否展示票数和公开评审理由
+ * @returns {string} 可直接发送的消息文本
+ */
+function shortList(items, includeVote = false) {
+    if (!items.length) return '暂无相关别名提案。'
+    return items.slice(0, 15).map((item, index) => {
+        const vote = includeVote ? `｜+${item.votesUp || 0}/-${item.votesDown || 0}` : ''
+        const reason = includeVote && item.publicReviewReason ? `\n理由：${item.publicReviewReason}` : ''
+        return `${index + 1}. ${item.alias} -> ${item.songId}\n${statusName[item.status] || item.status}${vote}${reason}\nID: ${item.id}`
+    }).join('\n\n')
+}
+
+export class aliasProposal extends phiPluginBase {
+    /** 初始化命令规则、Bot心跳和正式别名同步任务。 */
+    constructor() {
+        super({
+            name: 'phi-别名提案',
+            dsc: 'Token 驱动的曲目别名提案与公投',
+            event: 'message',
+            priority: 1000,
+            task: createAliasProposalTask(),
+            rule: [
+                { reg: `${prefix}(提案|submit)(\\s*).*$`, fnc: 'propose' },
+                { reg: `${prefix}(我的|mine)$`, fnc: 'mine' },
+                { reg: `${prefix}(公审|public)$`, fnc: 'publicList' },
+                { reg: `${prefix}(申诉|appeal)(\\s*).*$`, fnc: 'appeal' },
+                { reg: `${prefix}(投票|vote)(\\s*).*$`, fnc: 'vote' },
+                { reg: `${prefix}(撤票|unvote)(\\s*).*$`, fnc: 'unvote' },
+            ],
+        })
+    }
+
+    /**
+     * 统一隐藏 API 错误细节，防止响应内容意外包含敏感信息。
+     * @template T
+     * @param {PlatformEvent} e 当前消息事件
+     * @param {() => Promise<T>} operation 要执行的别名 API 操作
+     * @returns {Promise<T | null>} 成功结果；失败时已回复用户并返回 null
+     */
+    async withFailureMessage(e, operation) {
+        try {
+            return await operation()
+        } catch (error) {
+            const message = error instanceof Error && error.message === '请先绑定 sessionToken。'
+                ? error.message
+                : '别名服务暂时不可用，请稍后重试。'
+            send.send_with_At(e, message)
+            return null
+        }
+    }
+
+    /**
+     * 私聊提交单曲别名提案。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功提交
+     */
+    async propose(e) {
+        if (e.isGroup) {
+            send.send_with_At(e, '别名提案仅允许在私聊中提交。')
+            return false
+        }
+        const [songText, alias, note] = splitArgs(e.msg, '(提案|submit)')
+        if (!songText || !alias) {
+            send.send_with_At(e, `格式：/${head} alias submit 曲目 | 别名 | 私密备注（可选）`)
+            return false
+        }
+        if (alias.length > 64 || (note && note.length > 500)) {
+            send.send_with_At(e, '别名最多 64 字，备注最多 500 字。')
+            return false
+        }
+        const songIds = getInfo.fuzzysongsnick(songText, 0.85, true)
+        if (songIds.length !== 1) {
+            const candidates = songIds.slice(0, 8).map(id => `${getInfo.info(id, true)?.song || id} (${id})`).join('\n')
+            send.send_with_At(e, songIds.length ? `曲目不唯一，请使用更精确的名称：\n${candidates}` : '未找到对应曲目。')
+            return false
+        }
+        const proposal = await this.withFailureMessage(e, () => aliasProposalService.create(e, {
+            songId: songIds[0], alias, note,
+        }))
+        if (proposal) send.send_with_At(e, `提案已提交。\n${proposal.alias} -> ${proposal.songId}\nID: ${proposal.id}`)
+        return Boolean(proposal)
+    }
+
+    /**
+     * 查询当前 token 用户的提案。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功取得列表
+     */
+    async mine(e) {
+        const items = await this.withFailureMessage(e, () => aliasProposalService.mine(e))
+        if (items) send.send_with_At(e, shortList(items))
+        return Boolean(items)
+    }
+
+    /**
+     * 查询正在公开投票的提案。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功取得列表
+     */
+    async publicList(e) {
+        const items = await this.withFailureMessage(e, () => aliasProposalService.publicList(e))
+        if (items) send.send_with_At(e, shortList(items, true))
+        return Boolean(items)
+    }
+
+    /**
+     * 私聊为一次私密拒绝申请公开评审。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功提交申请
+     */
+    async appeal(e) {
+        if (e.isGroup) {
+            send.send_with_At(e, '公审申请仅允许在私聊中提交。')
+            return false
+        }
+        const [proposalId, reason] = splitArgs(e.msg, '(申诉|appeal)')
+        if (!proposalId || !reason) {
+            send.send_with_At(e, `格式：/${head} alias appeal 提案ID | 10-500字理由`)
+            return false
+        }
+        if (reason.length < 10 || reason.length > 500) {
+            send.send_with_At(e, '公审理由必须为 10-500 字。')
+            return false
+        }
+        const proposal = await this.withFailureMessage(e, () => aliasProposalService.requestPublicReview(e, proposalId, reason))
+        if (proposal) send.send_with_At(e, `公审申请已提交。\nID: ${proposal.id}`)
+        return Boolean(proposal)
+    }
+
+    /**
+     * 设置或修改当前用户的公开投票。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功记录投票
+     */
+    async vote(e) {
+        const args = e.msg.replace(new RegExp(`${prefix}(投票|vote)\\s*`, 'i'), '').trim().split(/\s+/)
+        const proposalId = args[0]
+        const choice = String(args[1] || '').toLowerCase()
+        /** @type {1 | -1 | null} */
+        const value = ['赞成', 'yes', '1', '+'].includes(choice) ? 1 : ['反对', 'no', '-1', '-'].includes(choice) ? -1 : null
+        if (!proposalId || value === null) {
+            send.send_with_At(e, `格式：/${head} alias vote 提案ID 赞成|反对`)
+            return false
+        }
+        const proposal = await this.withFailureMessage(e, () => aliasProposalService.vote(e, proposalId, value))
+        if (proposal) send.send_with_At(e, `投票已记录：${value === 1 ? '赞成' : '反对'}。`)
+        return Boolean(proposal)
+    }
+
+    /**
+     * 撤回当前用户对指定提案的投票。
+     * @param {PlatformEvent} e 当前消息事件
+     * @returns {Promise<boolean>} 是否成功撤票
+     */
+    async unvote(e) {
+        const proposalId = e.msg.replace(new RegExp(`${prefix}(撤票|unvote)\\s*`, 'i'), '').trim()
+        if (!proposalId) {
+            send.send_with_At(e, `格式：/${head} alias unvote 提案ID`)
+            return false
+        }
+        const proposal = await this.withFailureMessage(e, () => aliasProposalService.vote(e, proposalId, 0))
+        if (proposal) send.send_with_At(e, '投票已撤回。')
+        return Boolean(proposal)
+    }
+
+    /** @returns {Promise<void>} 完成一次通知轮询和到期快照同步 */
+    async aliasScheduledTask() {
+        await aliasProposalService.scheduledTask()
+    }
+}