guizang-voice

Personal tone profile

The profile is a Markdown file stored in the user's local Guizang Design data directory. Use the plugin-registered guizang_voice tool to read and write it; do not modify it directly with bash or file tools: the data directory is outside the workspace, so it cannot be written from inside the sandbox.

action	What it does
show	Read the profile; if there is no profile it will say so, which is not an error
note	Append an entry under "Learned in conversations" (text write clearly the user's original words and the revision)
save	Use text to overwrite the entire profile: used when creating or organizing the profile
collect	Organize messages the user has sent in DeepSeek into learning material, and return the path of the material file

When to read it

Before writing any text to be published under the user's name: articles, revised drafts, PPT scripts and page copy, card titles and body text, removing the AI flavor. First call guizang_voice(action: show); if there is a profile, write according to it; if not, write as usual, and do not interrupt or remind the user about this.

Creating the profile: learning from samples

1. There are two sources of samples, and they can be used together:
   • Chat history (default): messages the user has sent in DeepSeek, especially long passages. When the user clicks "Learn from my DeepSeek conversations" on the plugin page, the material has already been organized and the path is written in the message; otherwise first call guizang_voice(action: collect), then read the material file it returns. The material mixes instructions and casual short sentences: extract writing habits only from the passages of text the user wrote themselves; instruction-like sentences ("help me revise this", "turn it into a PPT") are only used to see wording preferences and are not treated as style samples.
   • Articles: articles, posts, or speeches the user has written (files, links, or pasted directly). When the passages of text add up to less than the amount of 3 articles, create it first and mark it "few samples, low confidence", then add more later.
2. Extract observable features one by one,each one must be supported by at least two pieces of evidence in the samples, and excerpt a short passage of the original text. Do not write anything without evidence, and do not fill in from impression:
   • Sentence length and rhythm: how long and short sentences alternate, how many sentences a paragraph usually has.
   • Opening and closing habits: whether to start from a scene, a conclusion, or a question; whether the ending summarizes or poses a question.
   • Person and address: "I / we / you / everyone", and how the reader is addressed.
   • Frequently used words and catchphrases (with occurrence counts), and expressions clearly not used (for example, never saying "empower" or "leverage").
   • Degree of certainty: whether to make judgments directly or often leave room; how uncertainty is expressed.
   • Punctuation: use of dashes, quotation marks, exclamation marks, ellipses, whether spaces are left between Chinese and English, and number formatting.
   • Chinese-English mixed typesetting: which words are kept in English and which are translated.
   • Humor and emotion: whether there is self-deprecation, rhetorical questions, or colloquial interjections.
3. Excerpt 2–3 passages of the original text that best represent the tone (each passage no more than 150 characters), and place them at the end of the profile as reference.
4. Write the entire profile according to the structure below, use guizang_voice(action: save) to save it, then show the profile content to the user for review; if the user says something is wrong, fix it and save again.

# 语气档案
更新：YYYY-MM-DD · 样本 N 篇（列出标题）

## 节奏与结构
## 人称与称呼
## 常用词 / 不用的词
## 判断与语气
## 标点与混排
## 对话中学到的
## 原文参照

Keep learning during the conversation

When the user corrects wording ("don't use that word", "I usually say it this way", "too formal"), in addition to making the change, use guizang_voice(action: note) to record an entry stating the original wording and the correction. When the same pattern appears a second time, move it from "learned from conversation" into the corresponding subsection (show the entire profile, and save after fixing it).

When writing with the profile

• The profile describes the user's habits, not a pile of features to stack up: use catchphrases according to their frequency in the samples, and don't put them in every paragraph.
• When used together with de-AI-flavoring (humanizer-zh), the profile takes precedence: expressions the user themselves likes to use are kept even if they look like templates.
• The profile stays only on the local machine; do not send its contents elsewhere; when the user asks to delete it, delete the file directly.