Redmine Macro Title 插件为Issue主题字段提供强大的宏解析功能。通过在标题中使用一些简单的“宏关键词”，系统可以在创建 Issue 时自动填入日期、用户、项目名称、以及递增编号等信息，大幅节省录入时间，并保持标题格式统一、自动编号索引。用户新建问题时可以快速选择所需要的宏标题（模版），立即自动生成期望的标题内容，同时也保持了团队协作时issue命名规范。此外，插件支持与 redmine_workload_mailer 、redmine_issue_autoform 插件整合，实现按规则动态创建标题和邮件报告。

插件的功能特点：¶

• 不用再手动写日期、版本等信息
  系统自动填入当前日期、时间、用户名、项目名称等。
• 标题格式始终统一
  项目内所有 Issue 的命名方式始终一致，不会“乱”。
• 自动编号，不会出错、不串号
  例如：第1次会议、第2次会议、第3次会议，自动按顺序编号无需人工干预。

使用方法：¶

• 新建问题时在“主题”里填写： 项目周会 - 第%%COUNT%%次 - %DATE% 保存后，标题显示效果为 项目周会 - 第7次 - 2025-01-15
• 新建问题时点击“主题”右侧的 图标，在弹出的宏列表中选择相应的“宏主题”模版
  

常见使用场景：¶

• 会议记录
• 周报/月报/季报
• 版本发布
• 阶段总结
• 批量需独立编号的各种工作

插件演示¶

Redmine中文站 上的所有虚拟主机已部署此插件，请在自己注册的Redmine虚拟主机 上体验和测试该插件。

---

• 目录
• • • 插件的功能特点：
    • 使用方法：
    • 常见使用场景：
    • 插件演示
• Redmine Macro Title 插件宏语法手册
  • 宏语法格式
  • 基础信息宏
    • 日期和时间宏
    • 用户信息宏
    • 项目信息宏
    • 问题信息宏
  • 智能计数器宏
    • 基础计数器
    • COUNT宏参数详解
      • 系列名称参数
      • 作用域参数
      • 数字格式参数
      • 自动递增参数
      • 简写格式参数
    • 参数组合示例
  • 使用示例
    • 综合应用示例

Redmine Macro Title 插件宏语法手册¶

宏语法格式¶

所有宏使用双百分号包裹：

%%宏名称%%               # 无参数格式
%%宏名称[参数]%%          # 带参数格式
%%宏名称[参数1,参数2]%%   # 多参数格式

基础信息宏¶

日期和时间宏¶

宏命令	描述	示例输入	示例输出
--------	------	----------	----------
%%DATE%%	当前日期 (YYYY-MM-DD)	日报-%%DATE%%	日报-2025-01-15
%%TIME%%	当前时间 (HH:MM:SS)	报告-%%TIME%%	报告-14:30:25
%%DATETIME%%	当前日期时间	备份-%%DATETIME%%	备份-2025-01-15 14:30:25

用户信息宏¶

宏命令	描述	示例输入	示例输出
--------	------	----------	----------
%%USER%%	当前用户登录名	[%%USER%%] 需求文档	[zhangsan] 需求文档
%%USER_NAME%%	当前用户全名	%USER_NAME%的申请	张三的申请

项目信息宏¶

宏命令	描述	示例输入	示例输出
--------	------	----------	----------
%%PROJECT%%	项目标识符	[%%PROJECT%%] 更新	[mobile-app] 更新
%%PROJECT_NAME%%	项目名称	%PROJECT_NAME%评审	移动应用项目评审

问题信息宏¶

宏命令	描述	示例输入	示例输出
--------	------	----------	----------
%%ISSUE_ID%%	Issue ID	相关问题：#%%ISSUE_ID%%	相关问题：#1234

智能计数器宏¶

基础计数器¶

宏命令	描述	示例输入	示例输出
--------	------	----------	----------
%%COUNT%%	基于主题系列的智能计数器	会议-第%%COUNT%%次	会议-第1次
%%N%%	COUNT的简写形式	测试-%%N%%	测试-42

注意：%%COUNT%% 宏基于主题文本自动识别系列，不同主题模式独立计数

COUNT宏参数详解¶

系列名称参数¶

参数格式	描述	示例
----------	------	------
系列名	直接指定计数器系列	%%COUNT[weekly]%% → 周会系列
pattern:系列名	明确指定模式系列	%%COUNT[pattern:monthly]%% → 月会系列

作用域参数¶

参数格式	描述	示例
----------	------	------
scope:global 或 scope:g	全局作用域，所有项目共享	%%COUNT[scope:global]%%
scope:project 或 scope:p	项目作用域，每个项目独立	%%COUNT[scope:project]%%

数字格式参数¶

参数格式	描述	示例输入	示例输出
----------	------	----------	----------
format:chinese	中文数字格式	第%%COUNT[format:chinese]%%章	第三章
format:roman	罗马数字格式	Release %COUNT[format:roman]%	Release III
format:arabic	阿拉伯数字格式（默认）	第%%COUNT[format:arabic]%%次	第3次

自动递增参数¶

参数格式	描述	示例
----------	------	------
auto_increment:true	启用自动递增（默认）	%%COUNT[auto_increment:true]%%
auto_increment:false	禁用自动递增	%%COUNT[auto_increment:false]%%

简写格式参数¶

参数格式	描述	示例
----------	------	------
类型#作用域	同时指定类型和作用域	%%COUNT[weekly#global]%%

参数组合示例¶

# 多个参数用逗号分隔
%%COUNT[weekly,format:chinese]%%          # 周会系列+中文数字
%%COUNT[bug,scope:project]%%              # Bug系列+项目作用域

# 复杂参数组合
%%COUNT[pattern:weekly,scope:global,format:chinese]%%
%%COUNT[monthly#global,format:roman]%%

使用示例¶

综合应用示例¶

场景	输入	输出
------	------	------
项目文档	[%%PROJECT%%] 文档-v%%COUNT%%-%%DATE%%	[mobile-app] 文档-v3-2025-01-15
问题跟踪	%USER_NAME%报告Bug-#%%COUNT[bug]%%	张三报告Bug-#127
会议管理	%PROJECT_NAME%-第%%COUNT[format:chinese]%%次会议	移动应用项目-第五次会议
版本发布	%PROJECT%-Release %COUNT[format:roman]%	mobile-app-Release IV