DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

hero-jianghaojie /

hero-jianghaojie/research-paper-style

Topic repository only

科研论文式作答技能 + 可点击引用溯源:摘要(1-3句结论)→详细介绍→参考文献;[n] 引用可跳转源文行;规则单一来源 + 回答 lint(可选 DSH 插件)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@77f8ea63

research-paper-style

科研论文式作答风格:每次回答先给 ## 摘要(1–3 句、只给结论、首句加粗),再在 ## 详细介绍 里展开技术参数与过程,文末给「参考文献」;引用本地文件/网页用 [n] 标注并写成可点击溯源链接(本地文件跳到指定行)。核心原则:结论先行、证据可查、严禁编造。

附带一个可选的 DSH 插件 dsh-cite-style:把风格注入每一轮系统提示,并提供一个只读的溯源预览路由 /dsh-cite/source(点击 [n] 打开源文并高亮行;文件不存在时明确提示"可能是编造的引用")。


目录结构

research-paper-style/
├── SKILL.md                 # 技能本体(agent skill;规则块由生成器维护)
├── style.policy.yaml        # 规则的唯一来源(结构/摘要/引用/输出形态/产物/隐私/语气)
├── tools/
│   ├── gen_style.py         # 从策略生成:plugin/style.prompt.mjs + SKILL.md 规则块
│   └── check_answer.py      # 对一条回答做 lint(14 项)
├── examples/golden/         # 9 条黄金用例(3 通过 / 6 应报错)
└── plugin/                  # 可选:DSH 插件(dsh-cite-style)
    ├── index.js             # 注入提示段 + /dsh-cite/source 只读路由
    ├── style.prompt.mjs     # 生成物:STYLE_PROMPT + 敏感名黑名单
    ├── test-local.mjs       # 假 ctx 自测(提示段 + 路由 + 404 提示)
    ├── cordis.patch.yml     # 插件行(插入 id: dsh-cite-style)
    └── package.json

快速开始

1) 只用技能(任何支持 Agent Skills 的客户端)

cp -r . ~/.agents/skills/research-paper-style     # 或你的技能目录

然后把 SKILL.md 里的规则视作作答规范。注意:[n] 的可点击依赖插件路由;没有插件时 [n] 退化为纯文本标注(写作纪律不变)。

2) 装 DSH 插件(可选,获得"可点击溯源")

dsh plugin --profile desktop add "<本仓库路径>\plugin"
# 重启 DSH 后:每轮自动注入风格;点击 [n] 打开 /dsh-cite/source 预览页

插件零第三方依赖,只用宿主服务:ctx.systemPrompt.section(...) 注入提示段、ctx.webServer.register(...) 注册只读路由;无 web 服务的 composition(如 TUI)会自动跳过路由、只保留风格。

规则(style.policy.yaml 摘要)

段 关键约束
structure 全文仅三个二级标题:## 摘要 / ## 详细介绍 / ## 参考文献;详细介绍内部一律 ###
abstract ≤3 句、只给结论;首句=直接答案并加粗;改动文件用行内代码写文件名(工作区内可点 chip,工作区外改链接);禁止在摘要里放尺寸/格式/依赖/过程/自检/绝对路径
citations [n] 递增;本地文件用 /dsh-cite/source?path=…&line=…;外部 URL 直链;引用前必须真读过;标注证据强度 [强]/[中]/[弱];外部来源须含标题/站点/访问日期
outputs GUI=可点链接;TUI=路径:行号;导出 Markdown=相对路径+脚注;粘贴 IM=文件名+一句话来源
deliverables 凡是产出数据表格,必须同时给出对应的图(v5 新增,2026-10-09 定规):图注/坐标轴英文、PNG+SVG 双出、从已存 JSON 出图不重跑仿真、量纲不同不共轴、跨 ≥3 数量级用对数轴、对比图不编造数据、拆解类用堆叠/分组条形图
emphasis 彩色/下划线/高亮只能走 KaTeX 行内数学(HTML 不渲染):红=风险、橙=未验证、绿=通过、蓝=文件/命令;\underline{} 下划线、\colorbox{} 高亮;中文须包在 \text{} 内;每段 ≤2 处、摘要禁彩色;禁止 <u>/<span>/<mark>
privacy 敏感文件名黑名单(.ssh/id_rsa/.pem 等)在路由层直接 403;外发时不留盘符

为什么彩色要用 KaTeX

DSH 的 Markdown 渲染器不放行原始 HTML(无 rehype-raw,html 节点按文本输出),所以 <u>、<span style="color:…">、<mark> 都会显示成字面标签。唯一能输出彩色文字的是行内数学(KaTeX):

$\textcolor{#d93025}{\text{红字(风险)}}$   $\textcolor{#1a73e8}{\text{蓝字(文件)}}$
$\underline{\text{下划线}}$              $\colorbox{#fff3cd}{\text{高亮底色}}$

中文必须包在 \text{} 内(否则按数学模式排、字距异常);每个 $…$ 只放一小段词。

工具链

# 改完 style.policy.yaml 后:重新生成「提示段 + SKILL.md 规则块」
python tools/gen_style.py

# 一致性回归:两处产物是否与策略一致(不写盘)
python tools/gen_style.py --check

# 对一条回答做 lint(14 项:结构/句数/首句加粗/禁用内容/绝对路径/链接标签/内部 ##/
#                  原始 HTML/摘要彩色/每段强调上限/表格必配图)
python tools/check_answer.py answer.md

黄金用例:pass-01/02/03 应全绿(03 含数据表+配图);fail-01(未加粗 + 禁用词 + 绝对路径)、fail-02(多出 ##)、fail-03(HTML 标签)、fail-04(摘要着色 + 一段超限)、fail-05(摘要 KaTeX 彩字)、fail-06(有表无图)应各自报错。

Windows 提示:两个脚本已把 stdout 强制成 UTF-8,✅/❌ 在 GBK 控制台(chcp 936)下不会再抛 UnicodeEncodeError。

已知限制

  • 行号是否准确取决于是否真的读过该文件;路由能抓"文件不存在"这类硬编造,但"行号对、内容不对"仍需人看一眼预览页;
  • 可点击 chip 只对工作区内文件有效(DSH 的 openFile 有工作区边界);工作区外文件请用链接或镜像到工作区;
  • 插件提示段是字符串常量:改策略后需重启 DSH;技能文件即时生效。

English (short)

research-paper-style is an agent skill that makes answers abstract-first: a ## 摘要 of 1–3 bold-lead sentences, then ## 详细介绍 with parameters and process, then a references list. Citations are numbered [n] and rendered as clickable links that open the exact source line (via the optional DSH plugin route /dsh-cite/source). Rules live in style.policy.yaml; tools/gen_style.py generates both the injected prompt and the skill's rules block, and tools/check_answer.py lints an answer against the policy.

License

MIT —— see LICENSE.

—/ 5

No ratings yet

Manifest verification required

Commit 77f8ea63ff23

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout