DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-tvkt-vi

H

dsh-tvkt-vi

Manifest valid

Enforces a Vietnamese technical-writing standard on every agent: one prompt section applied to all modes, a skill with 30 writing rules and 70 terms, an agent mode with draft/review/rewrite discipline

hasBundlePatch

dsh-tvkt-vi

Chuẩn tiếng Việt kỹ thuật TVKT-100 cho DeepSeek Harness: một hợp đồng system prompt áp cho mọi mode, một skill nạp theo nhu cầu, một linter chạy được, và một agent mode riêng cho việc rà tài liệu.

Tiếng Việt của agent thường sai theo ba kiểu: dịch máy từ tiếng Anh, kiểu ghép động từ rỗng vào trước hành động thật, đổi tên định danh kỹ thuật, và khẳng định điều chưa kiểm chứng. Plugin này chặn cả ba ở tầng prompt, rồi đưa cả 30 quy tắc và 70 thuật ngữ vào một skill để không phải trả token cho chúng ở mọi request.

Cài

# từ Git
dsh plugin --profile web add https://github.com/Hieupt1904/dsh-tvkt-vi.git

# từ thư mục cục bộ (đang phát triển)
dsh plugin --profile web add /duong/dan/dsh-tvkt-vi

Khởi động lại dsh web nếu profile không bật patchReload: live. Sau khi cài:

  • Mọi agent trong profile nhận section Chuẩn tiếng Việt (TVKT-100) trong system prompt.
  • Skill tvkt-vi xuất hiện trong catalog — agent tự nạp khi gặp việc viết/rà tiếng Việt.
  • Settings → Agent presets có thêm mode Tiếng Việt chuẩn (TVKT-100).

Plugin làm gì

Thành phầnCơ chếTác động
Hợp đồng ngôn ngữctx.systemPrompt.section() ở order 10150 — sau hướng dẫn công cụ, trước persona suffix~1,7 KB mỗi request; áp cho mọi mode, kể cả mode tự tạo
Skill tvkt-victx.skills.registerProvider() — đọc SKILL.md mỗi lần nạp, không chép tệp vào ~/.dsh/skills0 token khi không nạp; ~6 KB khi nạp
Agent mode tvkt-vipreset khai trong cordis.patch.yml, persona dsh-persona + bộ tool của mode standardchỉ phiên chọn mode mới trả
Lintervendor/tvkt/ (bản đóng gói của TVKT-100 v1.0) + skills/tvkt-vi/scripts/lint-text.pychạy cục bộ, không gọi mạng
Tool tvkt_lintctx.tools.register() khi profile có service tools; model gọi được, chạy linter trong workspace0 token khi không gọi; tự chặn path traversal, có timeout và huỷ theo exec.signal

Bốn lớp này cố ý tách nhau: hợp đồng ngắn là thứ bắt buộc phải có ở mọi request; bộ 30 quy tắc và 70 thuật ngữ thì không. Tool là lớp thứ tư vì profile không có service tools vẫn phải mount được bundle.

Dùng

Rà một đoạn đang soạn (không tạo tệp tạm):

printf 'Hệ thống tiến hành kiểm tra dữ liệu một cách nhanh chóng.\n' \
  | python3 skills/tvkt-vi/scripts/lint-text.py
TVKT-LINTER: <stdin> | ERROR=0, WARNING=2, INFO=0
1: WARNING L001 (TVKT-002): Cụm từ không ưu tiên: 'một cách nhanh chóng'.
    → Cân nhắc: 'trong thời gian xác định'. Chỉ thay khi không đổi nghĩa.
1: WARNING L001 (TVKT-002): Cụm từ không ưu tiên: 'tiến hành kiểm tra'.
    → Cân nhắc: 'kiểm tra'. Chỉ thay khi không đổi nghĩa.

Trong hội thoại:

REWRITE theo TVKT: chuẩn hóa tài liệu api/readme.md, chỉ sửa hình thức.
REVIEW phần 3 giúp tôi, nêu mã TVKT cho từng chỗ.
Dịch đoạn này sang tiếng Việt kỹ thuật, giữ nguyên tên endpoint.

Linter trong CI:

python3 vendor/tvkt/tools/tvkt_lint.py docs/api.md --format json --fail-on WARNING

Ba chế độ của mode

Chế độNhận khi nàoĐược làm gì
DRAFTngười dùng cần viết mớitạo tài liệu, ghi giả định, đánh dấu phần chưa xác minh
REVIEWcó văn bản sẵn, không nói rõchỉ báo vấn đề — không sửa tệp
REWRITEyêu cầu chuẩn hóasao lưu → đề xuất từng đoạn → diff → chờ duyệt → mới áp dụng

Cấu hình

Plugin không có tuỳ chọn. Muốn đổi hợp đồng ngôn ngữ, sửa lib/contract.js. Muốn đổi thân skill, sửa skills/tvkt-vi/SKILL.md — provider đọc tệp trong get(), nên lần nạp kế tiếp đã thấy nội dung mới.

TVKT_HOME trỏ tới bộ TVKT-100 bản đầy đủ trên máy để lint-text.py dùng bản đang lưu hành thay cho vendor/tvkt/:

TVKT_HOME=/duong/dan/TVKT-100-v1.0 python3 skills/tvkt-vi/scripts/lint-text.py bai.md

Giới hạn phải biết

  • Linter phủ 7/30 quy tắc. TVKT-001, 004, 006-010, 012-015, 017-030 cần đọc hiểu; PASS không chứng minh tài liệu đúng kỹ thuật (TVKT-029).
  • Đếm "tiếng" bằng khoảng trắng. Tiếng Việt ghép từ bằng khoảng trắng nên "người dùng" bị tính 2 đơn vị; ngưỡng 30/40 là gợi ý, không phải luật cứng.
  • L006 bắt nhầm. "phải", "nên", "không được" dùng như từ thường vẫn bị báo INFO. Đó là mức thông tin, không phải lỗi.
  • Preset phụ thuộc bản DSH. Danh sách 23 row trong cordis.patch.yml sao từ mode standard của DSH 0.2.2-rc.2. Sau khi nâng cấp DSH, chạy node scripts/check-drift.mjs; một row trỏ module không còn tồn tại làm hỏng cả preset.
  • Hợp đồng tiếng Việt chiếm ~1,7 KB mỗi request. Nếu bạn đã tự thêm khối TVKT vào ~/.dsh/AGENTS.md, bỏ một trong hai để không trả tiền hai lần.
  • Mỗi loại thay đổi có độ trễ khác nhau. Xem bảng dưới; đừng giả định mọi thứ đều nóng.
  • Skill trùng tên. Provider của plugin ở hạng 300, nên thắng bản trong ~/.dsh/skills (hạng 400) và thua bản trong .dsh/skills của project (hạng 100/200). Chỉ nên có một bản.
  • Release tarball đi sau npm. Release GitHub mới nhất là v0.4.0 trong khi npm có 0.5.0. Cài bằng URL tarball của release sẽ ra 0.4.0; cần 0.5.0 thì cài từ npm hoặc từ git.
  • Chưa có bằng chứng chạy trên Windows. CI chỉ chạy Ubuntu; xem docs/compatibility.md.

Phạm vi tool của mode tvkt-vi

Preset gồm standard + tool-executor-ptc + tool-tvkt: 25 row, trong đó 23 row khớp toàn bộ cấu trúc của standard (không chỉ id/module), một row lấy từ ptc, và một row mount plugin gốc để có tool tvkt_lint.

Cấu trúc này là EXACT STANDARD BASE + override có chủ ý. Bản sao nguyên gốc của preset standard nằm ở docs/evidence/standard.patch.yml, kèm sha256 trong docs/compatibility.md. Kiểm bằng npm run check-drift.

CẢNH BÁO: row đó không phải "thêm một tool" mà đổi cách gọi tool. Executor PTC biến run_code thành công cụ duy nhất gọi trực tiếp; model viết chương trình gọi các tool khác bên trong. Đây là hành vi của mode ptc, dùng khi cần gọi nhiều tool một lượt rồi lọc, gộp, đếm kết quả.

Muốn mode chỉ dùng tool trực tiếp như standard, xoá ba dòng này khỏi cordis.patch.yml, rồi chạy npm run check-drift:

          - id: tool-executor-ptc
            name: '@deepseek-ai/dsh-tool-executor-ptc'

Nếu bỏ row, nhớ xoá mục rows.tool-executor-ptc khỏi INTENTIONAL_DIFFS trong scripts/check-drift.mjs, nếu không checker sẽ báo thừa (không còn row nhưng allowlist vẫn khai).

Không chép ba khác biệt còn lại của ptc, vì chúng là cắt bớt có chủ ý chứ không phải năng lực thêm:

ptc khác standardCó chép?
thêm tool-executor-ptccó
tắt tool-plugin-manager và tool-plugin-marketkhông — mode tiếng Việt vẫn cần quản lý plugin
bỏ customSkillDirs của dsh-agent-presetkhông — bỏ thì mất skill dsh-doc
đổi ghi chú apply_patchkhông — giữ nguyên như standard

Không khai lại plugin nằm ở bundle root. ego-browser, dsh-service, agent-team, dsh-mattpocock-skills-deck, các MCP… đăng ký tool ở tầng root, mà agent của preset thừa hưởng tầng đó:

ToolRestriction applies to the tools a scope inherits: the deployment-global layer plus every ancestor scope on its chain. — docs/subsystems/tools.md

Hệ quả: mọi mode đều thấy các tool đó mà không cần khai báo. Khai lại trong preset là trùng lặp; với row có dịch vụ hoặc HTTP route thì còn xung đột realm. Bằng chứng ngay trên máy này: phiên đang chạy dùng preset full-spectrum — danh sách của nó không có ego-browser lẫn MCP — nhưng vẫn có đủ ego_*, mcp__*, list_agents.

Muốn kiểm sau khi cài: mở mode tvkt-vi, xem danh sách tool có run_code (PTC) cùng ego_*, mcp__*; thiếu nhóm nào thì đó là lỗi mount của bundle tương ứng, không phải thiếu khai báo trong preset.

Đúng hợp đồng provider skill

Bản dsh-tvkt-vi được đối chiếu với @deepseek-ai/dsh-skill-office, provider skill đóng gói chính thức của DSH:

Hợp đồngCách làm
Huỷ đượcreadFile(..., { signal }), tôn trọng options.signal của consumer
Không ghim catalog hỏnglist() trả { candidates, complete }; lỗi tạm thời → complete: false để registry thử lại
Lỗi tồn tại bị loạiEACCES/EPERM/ENOTDIR và frontmatter hỏng → bỏ entry kèm cảnh báo một lần
Nạp hỏng phải nổi lênget() ném lỗi, không trả undefined im lặng; gọi control.invalidate() khi lỗi tồn tại
Thân skill sạchparseSkill() cắt frontmatter; metadata lấy từ hằng số trong mã
Đường dẫn đa nền tảngresourceBase.path dùng /
Chẩn đoántiếng Anh, qua ctx.logger, khử trùng lặp

Đúng hợp đồng bundle của DSH

Yêu cầuCách khaiGhi chú
Manifest bundledsh.bundle.patch → ./cordis.patch.ymlthiếu nó, dsh plugin chỉ cài như dependency thường và cảnh báo
Dải DSH hỗ trợengines.dsh: "0.2.2-rc.2"DSH từ chối cài nếu không khớp, thay vì lỗi lúc mount
Peer được host chia sẻ@deepseek-ai/cordis trong peerDependencies, có -0thiếu nhánh prerelease thì mọi bản pre-release bị loại im lặng
Tiêu đề, mô tả, tài liệu chi tiếtlocale/en.json, locale/zh.json, docs/DETAIL*.mdmeta.detail phải nằm trong thư mục con, không ở gốc gói
Iconicon.svg + trường icon trong manifestSVG tự chứa, dưới 256 KiB
Bản dựng sẵndsh.install.tarball + asset tên cố địnhchỉ là gợi ý: dshmarket không đọc trường này, nó đọc tarball: của entry danh mục
Không có UI trình duyệtkhông khai dsh.clientbundle chỉ đóng góp cấu hình và module Node

Bốn mục đầu và ba mục cuối đều có test chặn hồi quy trong test/plugin.test.js.

Độ trễ của từng loại thay đổi

Sửa gìHiệu lực khi nàoVì sao
skills/tvkt-vi/** (thân, references)lần nạp kế tiếp, không cần restartprovider đọc tệp trong get(); registry không cache thân skill
Tên hoặc mô tả skillsau khi restartcatalog lấy từ lib/skill.js, không đọc frontmatter
lib/contract.js (hợp đồng prompt)sau khi restartsection đăng ký một lần lúc mount
lib/** nói chungsau khi restartNode giữ module đã import
cordis.patch.ymlngay, nếu profile bật patchReload: liveloader áp lại patch

Cài từ npm

dsh plugin --profile web add dsh-tvkt-vi

Bản trên registry: 0.5.1. Trạng thái publish: CHỜ DUYỆT 2FA — registry đã nhận bản stage nhưng latest vẫn trỏ 0.5.0 cho tới khi chủ tài khoản duyệt. Bản ghi 0.0.0-stage còn nằm trong danh sách version do lần publish đầu bị cắt giữa đường; nó không phải bản cài được và đã bị npm deprecate.

Danh mục awesome-dsh-plugin tự ánh xạ repo sang gói npm: nó đọc name trong package.json của repo và kiểm repository.url của bản latest có chứa Hieupt1904/dsh-tvkt-vi. Entry không khai trường npm — bộ kiểm tra từ chối mọi trường ngoài url, name, category, description, icon, tarball.

Đường phát hiện: index format 1 chỉ nhận npm

Đã kiểm trên index công bố ngày 2026-11-15 (https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json, format 1, 5.643 entry):

Sự thậtHệ quả
Mọi version trong index đều source.type = "npm" — 0 entry từ GitHubmột plugin không publish npm không vào được tab Discover lẫn tool plugin_market
Entry không có npm bị bộ sinh index bỏ, ghi skipped.noNpmentry danh mục vẫn có (nó là danh sách), nhưng index là cửa khác
build-index.mjs đọc data/npm-map.json → { npm, version, publishedAt, enginesDsh }tên gói npm phải trùng tên plugin, hoặc khai qua npm: của entry

Nên có ba đường, dùng được độc lập:

  1. dsh plugin add <URL git> — chạy được ngay; đã mô phỏng bằng npm install github:Hieupt1904/dsh-tvkt-vi ra 0.3.0, và hasLoadableEntry() của chợ trả true.
  2. Nhánh chợ dshmarket — đọc tarball: của entry danh mục; dsh.install.tarball trong package.json không phải nguồn nó dùng.
  3. Index format 1 (Discover) — cần gói có trên npm; gói đã publish. Index công bố chưa chứa entry này (xem bảng trạng thái bên dưới).

Trạng thái trên chợ plugin

Trạng thái dưới đây kiểm trực tiếp, không suy từ commit. Mốc kiểm: 2026-11-16T09:20+07:00.

Hạng mụcTrạng tháiBằng chứng
Repo GitHubpublicgh repo view --json visibility → "visibility":"PUBLIC"; git ls-remote ẩn danh trả đúng HEAD
npm0.5.1 đã stage, chờ duyệt 2FA; latest đang là 0.5.0npm view dsh-tvkt-vi version dist-tags; đăng nhập npm duyệt bản stage để hoàn tất
Entry danh mụcđã mergegh pr view 15602 --repo awesome-dsh-plugin/awesome-dsh-plugin → MERGED lúc 2026-11-15T17:30:30Z
Release tarballv0.4.0, asset dsh-tvkt-vi.tgzgh release view --json tagName,assets
Index format 1 (Discover)CHƯA XÁC NHẬNtải index.json (5.643 entry), tìm dsh-tvkt-vi được 0 lần khớp

Hệ quả cần biết: entry danh mục đã merge nhưng index công bố chưa sinh lại, nên tab Discover chưa thấy plugin. Tarball tên cố định trỏ release mới nhất, mà release mới nhất là v0.4.0, không phải 0.5.0 trên npm.

Thông báo cập nhật không phụ thuộc index. Chợ đọc raw.githubusercontent.com/Hieupt1904/dsh-tvkt-vi/HEAD/package.json và so version với bản đang cài, nên mỗi lần tăng version rồi push là máy đã cài sẽ thấy "có bản mới". Repo private thì bước này trả 404 và không có thông báo nào — đó là lý do repo phải public.

Cài sang máy khác

Máy đích cần: dsh đã cài, Node ≥ 24.9.0, python3 cho linter. Đăng nhập npm không cần — gói public.

dsh plugin --profile web add dsh-tvkt-vi

Profile ghi ^0.5.1 và mount bundle ngay. Nếu máy đích không bật patchReload: live, khởi động lại dsh web để agent nhận section prompt và provider skill.

Bốn bước kiểm sau khi cài

# 1. cấu hình có row của plugin và preset
dsh --profile web --dump-config | grep -A1 -E 'id: (dsh-tvkt-vi|preset-tvkt-vi)'

# 2. preset khớp với mode standard của DSH trên máy đó
node node_modules/dsh-tvkt-vi/scripts/check-drift.mjs

# 3. linter cầm tay chạy được
printf 'Hệ thống tiến hành kiểm tra.\n' | python3 node_modules/dsh-tvkt-vi/skills/tvkt-vi/scripts/lint-text.py

# 4. trong phiên: /skill tvkt-vi
#    Folder holding this skill's files: …/node_modules/dsh-tvkt-vi/skills/tvkt-vi

Bước 4 là bằng chứng quyết định. Nếu đường dẫn trỏ ~/.dsh/skills/tvkt-vi, một bản chép tay đang đè provider của gói — xoá ~/.dsh/skills/tvkt-vi.

Khi có phiên bản mới

dsh plugin --profile web update dsh-tvkt-vi --latest

Chỉ định phiên bản: dsh plugin --profile web add dsh-tvkt-vi@0.5.1. Bản 0.0.0-stage bị deprecate, đừng ghim vào nó.

Hoặc để chợ báo: Settings → Plugins → Plugin configuration liệt kê plugin có bản mới và cập nhật bằng một nút. Cơ chế đọc raw.githubusercontent.com/Hieupt1904/dsh-tvkt-vi/HEAD/package.json, nên repo phải giữ public.

Cài không cần npm registry

Ba đường tương đương, dùng khi mạng chặn registry hoặc cần ghim bản:

# tarball đính kèm release (tên cố định; release mới nhất hiện là v0.4.0)
dsh plugin --profile web add https://github.com/Hieupt1904/dsh-tvkt-vi/releases/latest/download/dsh-tvkt-vi.tgz

# thẳng từ git
dsh plugin --profile web add https://github.com/Hieupt1904/dsh-tvkt-vi.git

# từ bản clone cục bộ
dsh plugin --profile web add /duong/dan/dsh-tvkt-vi

Cả ba đều không cần bước duyệt build script vì gói là JavaScript thuần, không có prepare/postinstall.

Chuyển từ bản cài tay

Bản trước khi có plugin dùng ba chỗ rời: mục TVKT trong ~/.dsh/AGENTS.md, thư mục ~/.dsh/skills/tvkt-vi, và preset chép tay trong ~/.dsh/profiles/web/cordis.patch.yml.

# gỡ preset chép tay (nếu còn): xoá entry insert chứa preset-tvkt-vi, giữ phần còn lại
cp ~/.dsh/profiles/web/cordis.patch.yml ~/.dsh/profiles/web/cordis.patch.yml.bak
$EDITOR ~/.dsh/profiles/web/cordis.patch.yml

# gỡ bản skill chép tay để provider của gói thắng
mv ~/.dsh/skills/tvkt-vi ~/.dsh/skills/tvkt-vi.bak

Mục TVKT trong AGENTS.md thì để nguyên nếu máy đích còn chạy profile khác chưa cài plugin (headless, tui). Bỏ đi nếu chỉ dùng profile web — tiết kiệm khoảng 3 KB mỗi phiên, vì nội dung trùng với section của plugin.

Gỡ sạch

dsh plugin --profile web remove dsh-tvkt-vi

Lệnh này gỡ cả dependency lẫn bundle patch, nên mode tvkt-vi biến mất theo. Cấu hình khác trong profile không bị đụng.

Phát triển

node --test                 # unit test + tích hợp registry; số case do trình chạy in ra
npm run check-drift         # so preset với standard của DSH đang cài
npm run lint:skill          # chạy linter lên chính SKILL.md
npm run compat:smoke        # boot DSH target thật: mount, section, skill, tool, dispose

Cấu trúc:

lib/contract.js              # hợp đồng ngôn ngữ (section prompt)
lib/index.js                 # apply(): section + đăng ký provider
lib/skill.js                 # provider: list() + get(), đọc SKILL.md mỗi lần nạp
cordis.patch.yml             # bundle patch: plugin row + preset tvkt-vi
skills/tvkt-vi/SKILL.md      # thân skill (một nguồn sự thật)
skills/tvkt-vi/references/   # thuật ngữ, mở rộng cho chat
skills/tvkt-vi/scripts/      # lint-text.py
vendor/tvkt/                 # linter + cấu hình của TVKT-100 v1.0

Giấy phép và ghi công

Mã plugin: MIT (xem LICENSE).

vendor/tvkt/ và nội dung 30 quy tắc lấy từ TVKT-100 v1.0 — bộ chuẩn nội bộ của tác giả dự án, không phải tiêu chuẩn quốc gia và không phải bản dịch ASD-STE100. Bộ gốc chưa có tệp giấy phép; xem NOTICE trước khi phân phối lại.


English

dsh-tvkt-vi packages the Vietnamese technical-writing standard TVKT-100 as a DeepSeek Harness plugin: a compact system-prompt contract applied to every agent, an on-demand skill with the full rule set, a bundled linter (L001-L007), and an agent mode with DRAFT/REVIEW/REWRITE discipline. Keeps identifiers untranslated, bans machine-translation calques, and requires unverified statements to be labelled.

dsh plugin --profile web add https://github.com/Hieupt1904/dsh-tvkt-vi.git

The node --test suite covers registration, section ordering, skill frontmatter parity, the prompt-pruner budget, and the exact-target runtime smoke.

Comments

Loading…

Similar plugins

dsh-prompt-lab

by xueccci

Agent-structured prompt optimizer for DeepSeek Harness (dsh). Modes: normal/slim/expand. Engines: local, hybrid, DSH, cloud API. Modal confirm with score and continue-optimize.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 3

MIT

JavaScript

Oct 16, 2026

dsh plugin --profile web add dsh-prompt-lab

by running-grass

DeepSeek Harness plugin: a `team` agent preset whose Lead decides and dispatches while short-lived workers do the writing

Sessions & MessagesManifest valid

★ 0

MIT

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-team-mode

by dbcaskml183-dotcom

DeepSeek Harness 的提示词写作助手。用 90 张方法卡给草稿补一句要求,或对照原稿编辑整段改写,再决定是否采用。

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 255

↓ 996/wk

MIT

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-prompt-coach

by jilian-dsh

Rules execution engine for dsh: parses AGENTS.md, hard-blocks rule-violating tool calls, text-based B/D rule auditing, /guard command, version-guard for versioned files, and free-zone support (engine

Security & AuditDevelopment & InfrastructureManifest valid

★ 3

↓ 171/wk

MIT

JavaScript

Sep 23, 2026

dsh plugin --profile web add dsh-rule-engine

by Cavan-Ou

Battle-tested multi-agent collaboration playbook for DeepSeek Harness: model-tier routing, spec discipline, git single-writer rule — as an installable skill. 多 agent 管线里运行 DSH 的实战协作规范

Agent skillsManifest valid

★ 6

MIT

JavaScript

Sep 11, 2026

dsh plugin --profile web add hermes-dsh-collab

by tea-whale

DeepSeek Harness (DSH) 写作工具插件:长文工作流、风格控制与 8 套常用写作模板,进度落盘、跨轮次续写。零运行时依赖。

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

Sep 9, 2026

dsh plugin --profile web add dsh-writing-studio