2026-07-23 22:41:53 +08:00
{
"request" : {
"targetFilename" : "snapshot-note.zh.md" ,
"messages" : [
{
"role" : "system" ,
2026-08-11 11:06:00 +08:00
"content" : " # T r a n s l a t i o n P r o m p t \ n \ n Y o u a r e a s e n i o r t e c h n i c a l t r a n s l a t o r s p e c i a l i z i n g i n L L M a n d a g e n t d e v e l o p m e n t d o c u m e n t a t i o n . Y o u r t a s k i s t o t r a n s l a t e t h e c o m p l e t e s o u r c e d o c u m e n t f r o m E n g l i s h t o C h i n e s e , p r o d u c i n g n a t u r a l , p r o f e s s i o n a l t e c h n i c a l p r o s e . \ n \ n R e a d e a c h c o m p l e t e s e m a n t i c u n i t , u n d e r s t a n d i t , a n d r e s t a t e i t a s a n a t i v e t e c h n i c a l a u t h o r w o u l d w r i t e i t i n t h e t a r g e t l a n g u a g e . D o n o t m e c h a n i c a l l y p r e s e r v e s o u r c e - l a n g u a g e s y n t a x . T h e n v e r i f y t h e t r a n s l a t i o n a g a i n s t t h e s o u r c e c l a u s e b y c l a u s e : p r e s e r v e e v e r y p r o p o s i t i o n a n d a d d n o n e . F l u e n c y n e v e r j u s t i f i e s l o s i n g o r a l t e r i n g m e a n i n g , a n d c o m p l e t e n e s s n e v e r j u s t i f i e s u n n a t u r a l w o r d - f o r - w o r d p r o s e . \ n \ n # # P r i o r i t y \ n \ n A p p l y t h e s e a u t h o r i t i e s i n o r d e r : \ n \ n 1 . P r e s e r v e t h e s o u r c e m e a n i n g a n d t h e r e q u i r e d d o c u m e n t s t r u c t u r e , p r o t e c t e d c o n t e n t , a n d f o r m a t t i n g . \ n 2 . F o l l o w t h e i n j e c t e d t e r m i n o l o g y t a b l e e x a c t l y . \ n 3 . U s e t h e i n j e c t e d w h o l e - d o c u m e n t g o l d p a i r s t o c a l i b r a t e t a r g e t - l a n g u a g e v o i c e a n d p h r a s i n g . \ n 4 . A p p l y t h e g e n e r a l w r i t i n g g u i d a n c e a n d i l l u s t r a t i v e e x a m p l e s i n t h i s p r o m p t . \ n \ n A l o w e r - p r i o r i t y r u l e m a y r e f i n e b u t n e v e r o v e r r i d e a h i g h e r - p r i o r i t y r e q u i r e m e n t . G o l d p a i r s c a l i b r a t e v o i c e ; t h e y a r e n o t a t r a n s l a t i o n m e m o r y . N o s t y l e p r e f e r e n c e , g o l d - p a i r p h r a s i n g , o r e m b e d d e d e x a m p l e m a y o v e r r i d e s o u r c e m e a n i n g , r e q u i r e d s t r u c t u r e , p r o t e c t e d c o n t e n t , o r t h e t e r m i n o l o g y t a b l e . \ n \ n # # Q u a l i t y R e q u i r e m e n t s \ n \ n # # # S t r u c t u r e a n d F o r m a t P r e s e r v a t i o n \ n - O u t p u t a c o m p l e t e t r a n s l a t e d d o c u m e n t t h a t m a i n t a i n s t h e s a m e d o c u m e n t f r a m e a s t h e s o u r c e : h e a d i n g h i e r a r c h y a n d o r d e r , l i s t k i n d s a n d i t e m c o u n t s , o r d e r e d - l i s t s t a r t s , t a b l e r o w s a n d c o l u m n s , l i n k t a r g e t s , a n d c o d e b l o c k s . \ n - P a r a g r a p h b o u n d a r i e s m a y c h a n g e w i t h i n t h e s a m e s t r u c t u r a l u n i t w h e n t h e t a r g e t l a n g u a g e n e e d s d i f f e r e n t s e m a n t i c g r o u p i n g . D o n o t m e r g e o r m o v e c o n t e n t a c r o s s h e a d i n g s , l i s t i t e m s , t a b l e c e l l s , o r o t h e r i n d e p e n d e n t s t r u c t u r a l u n i t s . \ n - K e e p e a c h p r o s e p a r a g r a p h o n o n e p h y s i c a l l i n e . U s e p a r a g r a p h b r e a k s , n o t h a r d - w r a p p e d l i n e s i n s i d e a p a r a g r a p h . \ n - F e n c e d c o d e b l o c k s m u s t b e b y t e - i d e n t i c a l t o t h e s o u r c e , i n c l u d i n g i n f o s t r i n g s , w h i t e s p a c e , a n d A L L c o m m e n t s i n s i d e t h e m . D o N O T t r a n s l a t e o r r e f o r m a t a n y c o n t e n t i n s i d e c o d e b l o c k s . T h i s i s a h a r d r u l e w i t h n o e x c e p t i o n s . \ n - I n l i n e c o d e s p a n s m u s t b e k e p t v e r b a t i m . T h i s i n c l u d e s c o m m a n d s , f l a g s , p a t h s , i d e n t i f i e r s , A P I a n d e v e n t n a m e s , c o n f i g k e y s , p r o t o c o l v a l u e s , v e r s i o n n u m b e r s , a n d o t h e r m a c h i n e - r e a d a b l e t o k e n s . N e v e r t r a n s l a t e o r r e f o r m a t t h e m . \ n - E v e r y r e l a t i v e l i n k m u s t p o i n t t o t h e s a m e t a r g e t a s i n t h e s o u r c e . T r a n s l a t e l i n k t e x t ; d o n o t c h a n g e l i n k t a r g e t s . \ n - L a n g u a g e s w i t c h e r l i n e : w h e n a n E n g l i s h s o u r c e c o n t a i n s ` E n g l i s h | [ 中 文 ] ( s o u r c e - f i l e n a m e . z h . m d ) ` , w r i t e ` [ E n g l i s h ] ( s o u r c e - f i l e n a m e . m d ) | 中 文 ` . W h e n a C h i n e s e s o u r c e c o n t a i n s ` [ E n g l i s h ] ( s o u r c e - f i l e n a m e . m d ) | 中 文 ` , w r i t e ` E n g l i s h | [ 中 文 ] ( s o u r c e - f i l e n a m e . z h . m d ) ` . D o N O T c o p y t h e s o u r c e s w i t c h e r u n c h a n g e d . I f t h e s o u r c e h a s n o s w i t c h e r , d o n o t i n v e n t a f i l e n a m e o r s w i t c h e r ; t h e p i p e l i n e i n s e r t s t h e c a n o n i c a l t a r g e t s w i t c h e r a f t e r p a r s i n g ` < f i n a l > ` . \ n - P r e s e r v e e m p h a s i s m a r k e r t y p e s a n d t h e s e m a n t i c s p a n s t h e y c o v e r . D o n o t a d d , r e m o v e , m o v e , o r c h a n g e b o l d a n d i t a l i c m a r k e r s . \ n \ n # # # F a i t h f u l n e s s \ n - P r e s e r v e e v e r y p r o p o s i t i o n i n t h e s o u r c e a n d a d d n o n e . E v e r y s e n t e n c e , l i s t i t e m , n o t e , F I X M E , w a r n i n g , e x a m p l e , c a v e a t , p r e r e q u i s i t e , a n d g u a r a n t e e m u s t h a v e a n e q u i v a l e n t i n t h e t r a n s l a t i o n . C o u n t l i s t i t e m s o n b o t h s i d e s . \ n - P r e s e r v e a c t o r s , o b j e c t s , c o n d i t i o n s , e x c e p t i o n s , n e g a t i o n , m o d a l i t y , c a u s a l r e l a t i o n s h i p s , a n d d i s t i n c t i o n s b e t w e e n c o n c e p t s . \ n - P r e s e r v e t h e e x a c t s t r e n g t h a n d o r i e n t a t i o n o f c o n t r a c t s . C o m p l e t i o n a n d l i f e c y c l e c o n d i t i o n s , f a i l u r e b e h a v i o r , d i r e c t i o n s a n d d a t a f l o w , n o r m a l a n d e x c e p t i o n a l r e s u l t c h a n n e l s , o w n e r s h i p c h a n g e s , a n d q u a n t i t a t i v e b o u n d s m u s t n o t b e w e a k e n e d , s t r e n g t h e n e d , r e v e r s e d , o r m e r g e d . \ n - T r a n s l a t e i d e a s r a t h e r t h a n s o u r c e - l a n g u a g e i d i o m s , b u t n e v e r u s e f l u e n c y a s a r e a s o n t o o m i t o r a l t e r m e a n i n g . \ n \ n # # # T o n e a n d S t y l e \ n - T h e t r a n s l a t i o n m u s t r e a d a s i f o r i g i n a l l y w r i t t e n i n t h e t a r g e t l a n g u a g e b y a n a t i v e t e c h n i c a l a u t h o r . I
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-08-12 10:59:06 +08:00
"content" : "# DeepSeek Harness\n\nEnglish | [中文](README.zh.md)\n\nDeepSeek Harness (`dsh`) is an open-source coding agent built on the DeepSeek Harness SDK.\n\nIt uses an architecture where **everything is a plugin**.\n\n## Internal testing notice\n\nDeepSeek Harness is under internal testing. Features and interfaces may change.\n\nThe internal build uploads all Session Logs by default to help diagnose reported problems. Set `DSH_TELEMETRY_DISABLED=1` to disable telemetry. Send feedback through the internal WeChat group.\n\n## Run\n\nInstall Node.js ^22.19 or >= 24 and pnpm 11, then run the published package:\n\n```sh\nnpx @deepseek-ai/dsh web\n```\n\nThe command initializes the Web profile and prints the Web UI URL, which is `http://127.0.0.1:3080` by default. Open it, add a DeepSeek API key under **Settings → Models**, then start a session. The invoking directory is the default workspace; try `Summarize this repository and identify its main packages.`\n\nContinue with the [Web UI guide](docs/user/guide/).\n\n### Run from source\n\nTo run a repository checkout instead:\n\n```sh\ngit clone https://github.com/deepseek-harness/deepseek-harness.git\ncd deepseek-harness\npnpm install\npnpm dsh web\n```\n\nThe last command builds the repository and opens the same Web UI path.\n\n## Profiles and plugins\n\nA profile is an ordered list of plugin bundles. The shipped `web` profile powers `dsh web`. Manage a profile with `dsh plugin --profile <name> <pnpm args>`, which forwards the remaining arguments to pnpm in that profile's directory:\n\n```sh\nnpx -p @deepseek-ai/dsh dsh plugin --profile web add <package>\nnpx -p @deepseek-ai/dsh dsh plugin --profile web remove <package>\n```\n\n`add`, `remove`, `update`, `why`, and other pnpm commands work unchanged. The command initializes a missing profile before changing its packages and updates its bundle list from installed packages that declare `dsh.bundle`. See the [CLI reference](apps/cli/reference/README.md#plugin-management) for the exact behavior.\n\nThe [CLI reference](apps/cli/README.md) covers headless execution and custom profiles. The [Python SDK](python/README.md) and [examples](examples/README.md) cover programmatic and custom compositions.\n\n## Community\n\nFollow <a href=\"https://x.com/Deepseekharness\">DeepSeek Harness on Twitter</a> for project updates.\n\n## Development\n\nStart with the [development guide](docs/development.md) and read the [architecture](docs/architecture.md) before changing packages.\n\nFor agents, follow [AGENTS.md](AGENTS.md).\n\n## License\n\n[BSD 3-Clause](LICENSE)\n\nThird-party dependencies and their licenses are disclosed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).\n\n## Contributing\n\nRead [CONTRIBUTING.md](CONTRIBUTING.md) before contributing to this repository.\n"
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "assistant" ,
2026-08-12 10:59:06 +08:00
"content" : "# DeepSeek Harness\n\n[English](README.md) | 中文\n\nDeepSeek Harness（ （ ） ， ， ： ： ， ； ： ， ， （ ） ， ： ，
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-08-11 18:38:47 +08:00
"content" : " # D e v e l o p m e n t g u i d e \ n \ n E n g l i s h | [ 中 文 ] ( d e v e l o p m e n t . z h . m d ) \ n \ n T h e s e t u p t u t o r i a l t a k e s a n e w c o n t r i b u t o r f r o m p r e r e q u i s i t e s t o a c h e c k e d c h e c k o u t . T h e c o n t r i b u t o r r e f e r e n c e t h a t f o l l o w s c o v e r s r e p o s i t o r y l a y o u t , d a i l y w o r k f l o w , a n d C I o r g a n i z a t i o n . D e s i g n r a t i o n a l e a n d i m p l e m e n t a t i o n d e t a i l s b e l o n g t o t h e l i n k e d A g e n t N o t e s a n d s c r i p t s . \ n \ n # # S e t u p t u t o r i a l \ n \ n # # # P r e r e q u i s i t e s \ n \ n - N o d e . j s s u p p o r t s 22.19 + a n d 24 + . C I c o v e r s 22.19 , 24 , a n d 26 ; s e e t h e [ N o d e e n g i n e f l o o r A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -0 6 - n o d e - e n g i n e - f l o o r . m d ) . \ n - C o r e p a c k - e n a b l e d p n p m . T h e r e p o p i n s ` p n p m @ 11.7 . 0 ` i n ` p a c k a g e . j s o n ` ; r u n ` c o r e p a c k e n a b l e ` i f ` p n p m - - v e r s i o n ` d o e s n o t r e s o l v e t h r o u g h C o r e p a c k . \ n - G i t 2.26 o r n e w e r ; h o o k s e t u p e n a b l e s G i t ' s w o r k t r e e - s p e c i f i c c o n f i g u r a t i o n e x t e n s i o n . \ n - O p t i o n a l : a D e e p S e e k A P I k e y f o r t h e W e b , h e a d l e s s , a n d A C P a u t o m a t i o n d e m o s a n d r e a l - A P I e 2 e t e s t s . \ n \ n # # # F i r s t - t i m e s e t u p \ n \ n I n s t a l l d e p e n d e n c i e s f r o m t h e r e p o r o o t : \ n \ n ` ` ` s h \ n p n p m i n s t a l l \ n ` ` ` \ n \ n T h e i n s t a l l a l s o c o n f i g u r e s w o r k t r e e - l o c a l L e f t h o o k h o o k s a n d t h e ` d s h - t r a n s l a t i o n - p a i r i n g ` G i t m e r g e d r i v e r t h r o u g h ` s c r i p t s / i n s t a l l - l e f t h o o k . m j s ` . T h e [ w o r k t r e e - l o c a l h o o k s A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -27 - w o r k t r e e - l o c a l - l e f t h o o k . m d ) o w n s t h e h o o k - p a t h s a f e t y c o n t r a c t ; t h e [ a u t o m a t i c p a i r i n g m e r g e s A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 8 -0 8 - a u t o m a t i c - t r a n s l a t i o n - p a i r i n g - m e r g e s . m d ) o w n s t h e m e r g e d r i v e r . \ n \ n I f e i t h e r i n t e g r a t i o n i s m i s s i n g b e c a u s e d e p e n d e n c i e s w e r e r e s t o r e d f r o m c a c h e o r ` p o s t i n s t a l l ` w a s s k i p p e d , i n s t a l l t h e m m a n u a l l y : \ n \ n ` ` ` s h \ n n o d e s c r i p t s / i n s t a l l - l e f t h o o k . m j s \ n ` ` ` \ n \ n I f t h e w r a p p e r r e j e c t s e x i s t i n g G i t c o n f i g u r a t i o n o r r e p o r t s a s t a l e l o c k , f o l l o w i t s d i a g n o s t i c a n d t h e l i n k e d A g e n t N o t e r a t h e r t h a n e d i t i n g w o r k t r e e m e t a d a t a s p e c u l a t i v e l y . A f t e r m o v i n g a c h e c k o u t , r e r u n t h e w r a p p e r t o r e g e n e r a t e t h e o w n e d p a t h . \ n \ n R u n t y p e c h e c k o n c e a f t e r a f r e s h c l o n e : \ n \ n ` ` ` s h \ n p n p m r u n t y p e c h e c k \ n ` ` ` \ n \ n S e t u p i s c o m p l e t e w h e n ` p n p m r u n t y p e c h e c k ` e x i t s s u c c e s s f u l l y . \ n \ n # # C o n t r i b u t o r r e f e r e n c e \ n \ n # # # T y p e S c r i p t p r o j e c t l a y o u t \ n \ n T h e r e p o s i t o r y u s e s i s o l a t e d H o s t a n d C l i e n t a g g r e g a t e s . A n o r d i n a r y p a c k a g e i s r e g i s t e r e d i n e x a c t l y o n e a g g r e g a t e : H o s t p a c k a g e s i n ` t s c o n f i g . h o s t . j s o n ` a n d C l i e n t p a c k a g e s i n ` t s c o n f i g . c l i e n t . j s o n ` . \ n \ n | F i l e | R o l e | F o r m s a p r o g r a m ? | \ n | - - - | - - - | - - - | \ n | ` t s c o n f i g . j s o n ` | S o l u t i o n r o o t : ` e x t e n d s ` b a s e , ` f i l e s : [ ] ` , a n d r e f e r e n c e s t o t h e t w o a g g r e g a t e s . I t i s t h e t s s e r v e r d i s c o v e r y e n t r y a n d t h e e n t r y f o r e x p l i c i t l y r u n n i n g t h e c o m p l e t e P r o j e c t R e f e r e n c e g r a p h ; t h r o u g h t h e i n h e r i t e d ` p a t h s ` , i t i s a l s o t h e r e s o l u t i o n c o n f i g f o r t s x r u n n i n g ` e x a m p l e s / ` a n d ` s c r i p t s / ` . | N o | \ n | ` t s c o n f i g . h o s t . j s o n ` | H o s t a g g r e g a t e : H o s t p a c k a g e s , e x a m p l e s , t e s t s , s c r i p t s , w e b s i t e , a n d t h e e x c e p t i o n a l H o s t p r o j e c t o f ` a p i / r e m o t e s ` . | Y e s | \ n | ` t s c o n f i g . c l i e n t . j s o n ` | C l i e n t a g g r e g a t e : ` p a c k a g e s / c l i e n t / * ` p a c k a g e s a n d t h e i r t e s t s , ` a p p s / w e b ` , a n d t h e e x c e p t i o n a l C l i e n t p r o j e c t o f ` a p i / r e m o t e s ` . | Y e s | \ n | ` t s c o n f i g . b a s e . j s o n ` | S h a r e d c o m p i l e r O p t i o n s a n d t h e s o u r c e ` p a t h s ` m a p . A l s o t h e r e s o l u t i o n f a c a d e t h e v i t e s t c o n f i g s p o i n t v i t e - t s c o n f i g - p a t h s a t : i t h a s n o ` i n c l u d e ` , s o i t s ` p a t h s ` a p p l y t o e v e r y i m p o r t e r . | N o | \ n | ` t s c o n f i g . b a s e . c l i e n t . j s o n ` | B r o w s e r c o m p i l e r s e t t i n g s ( ` j s x ` , D O M l i b s , ` t y p e s : [ ] ` ) e x t e n d e d b y t h e C l i e n t a g g r e g a t e a n d e v e r y ` p a c k a g e s / c l i e n t / * ` p a c k a g e . | N o | \ n \ n H o s t a n d C l i e n t s t a y t w o a g g r e g a t e p r o g r a m s b e c a u s e b o t h s i d e s d e c l a r a t i o n - m e r g e t h e c o r d i s ` C o n t e x t ` i n t e r f a c e u n d e r t h e s a m e k e y s w i t h d i f f e r e n t s e r v i c e s ; o n e p r o g r a m s e e i n g b o t h m e r g e s r e p o r t s a c o l l i s i o n . T h e c o l l i s i o n e x i s t s o n l y i n s i d e a ` t s . P r o g r a m ` — m o d u l e r e s o l u t i o n n e v e r t r i g g e r s i t — w h i c h i s w h y t h e s o l u t i o n m a y r e f e r e n c e b o t h a g g r e g a t e s a n d o n e p a t h s f a c a d e m a y s p a n b o t h s i d e s . T h r e e d i s c i p l i n e s f o l l o w : \ n \ n - ` t s c o n f i g . b a s e . j s o n ` n e v e r g a i n s ` i n c l u d e ` o r ` f i l e s ` : t h e y w o u l d l e a k i n t o e v e r y e x t e n d i n g p a c k a g e p r o j e c t a n d n a r r o w t h e f a c a d e ' s m a t c h - a l l s c o p e . \ n - A s c r i p t t h a t b u i l d s a r e p o - w i d e ` t s . P r o g r a m ` s e e d s ` t s c o n f i g . h o s t . j s o n ` o r ` t s c o n f i g . c l i e n t . j s o n ` e x
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "assistant" ,
2026-08-11 18:38:47 +08:00
"content" : " # 开 发 指 南 \ n \ n [ E n g l i s h ] ( d e v e l o p m e n t . m d ) | 中 文 \ n \ n 搭 建 教 程 引 导 新 贡 献 者 从 准 备 前 置 条 件 开 始 ， 直 到 检 出 通 过 检 查 。 后 面 的 贡 献 者 参 考 介 绍 仓 库 布 局 、 日 常 工 作 流 和 C I 组 织 方 式 。 设 计 依 据 与 实 现 细 节 属 于 链 接 的 A g e n t N o t e 和 脚 本 。 \ n \ n # # 搭 建 教 程 \ n \ n # # # 前 置 条 件 \ n \ n - N o d e . j s 支 持 22.19 + 与 24 + 。 C I 覆 盖 22.19 、 24 和 26 ； 见 [ N o d e 引 擎 下 限 A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -0 6 - n o d e - e n g i n e - f l o o r . m d ) 。 \ n - 启 用 了 C o r e p a c k 的 p n p m 。 仓 库 在 ` p a c k a g e . j s o n ` 中 固 定 使 用 ` p n p m @ 11.7 . 0 ` ； 如 果 ` p n p m - - v e r s i o n ` 无 法 通 过 C o r e p a c k 解 析 ， 请 先 运 行 ` c o r e p a c k e n a b l e ` 。 \ n - G i t 2.26 或 更 高 版 本 ； 钩 子 设 置 会 启 用 G i t 的 w o r k t r e e 专 属 配 置 扩 展 。 \ n - 可 选 ： 一 个 D e e p S e e k A P I k e y ， 用 于 W e b 、 h e a d l e s s 和 A C P （ A g e n t C l i e n t P r o t o c o l ） 自 动 化 a g e n t （ 智 能 体 ） 演 示 以 及 真 实 A P I 的 e 2 e 测 试 。 \ n \ n # # # 首 次 搭 建 \ n \ n 在 仓 库 根 目 录 安 装 依 赖 ： \ n \ n ` ` ` s h \ n p n p m i n s t a l l \ n ` ` ` \ n \ n 安 装 过 程 还 会 通 过 ` s c r i p t s / i n s t a l l - l e f t h o o k . m j s ` 配 置 w o r k t r e e 本 地 的 L e f t h o o k 钩 子 和 ` d s h - t r a n s l a t i o n - p a i r i n g ` G i t 合 并 驱 动 。 [ w o r k t r e e 本 地 钩 子 A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -27 - w o r k t r e e - l o c a l - l e f t h o o k . m d ) 负 责 钩 子 路 径 的 安 全 约 定 ； [ 自 动 配 对 合 并 A g e n t N o t e ] ( . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 8 -0 8 - a u t o m a t i c - t r a n s l a t i o n - p a i r i n g - m e r g e s . m d ) 负 责 合 并 驱 动 。 \ n \ n 如 果 依 赖 是 从 缓 存 恢 复 或 ` p o s t i n s t a l l ` 被 跳 过 而 导 致 任 一 集 成 缺 失 ， 请 手 动 安 装 ： \ n \ n ` ` ` s h \ n n o d e s c r i p t s / i n s t a l l - l e f t h o o k . m j s \ n ` ` ` \ n \ n 如 果 包 装 脚 本 拒 绝 现 有 G i t 配 置 或 报 告 陈 旧 锁 ， 请 遵 循 其 诊 断 和 所 链 接 的 A g e n t N o t e ， 不 要 凭 猜 测 编 辑 w o r k t r e e 元 数 据 。 移 动 检 出 目 录 后 ， 请 重 新 运 行 包 装 脚 本 以 重 新 生 成 自 有 路 径 。 \ n \ n 新 克 隆 后 请 先 运 行 一 次 类 型 检 查 ： \ n \ n ` ` ` s h \ n p n p m r u n t y p e c h e c k \ n ` ` ` \ n \ n ` p n p m r u n t y p e c h e c k ` 成 功 退 出 即 表 示 搭 建 完 成 。 \ n \ n # # 贡 献 者 参 考 \ n \ n # # # T y p e S c r i p t 项 目 布 局 \ n \ n 仓 库 使 用 相 互 隔 离 的 H o s t 与 C l i e n t a g g r e g a t e 。 普 通 p a c k a g e 只 登 记 进 其 中 一 个 a g g r e g a t e ； H o s t 包 进 入 ` t s c o n f i g . h o s t . j s o n ` ， C l i e n t 包 进 入 ` t s c o n f i g . c l i e n t . j s o n ` 。 \ n \ n | 文 件 | 角 色 | 是 否 构 成 p r o g r a m ？ | \ n | - - - | - - - | - - - | \ n | ` t s c o n f i g . j s o n ` | s o l u t i o n 根 ： ` e x t e n d s ` b a s e 、 ` f i l e s : [ ] ` 、 引 用 两 个 a g g r e g a t e 。 它 是 t s s e r v e r 发 现 入 口 ， 也 是 显 式 执 行 整 张 P r o j e c t R e f e r e n c e 图 时 的 入 口 ； 经 继 承 的 ` p a t h s ` 充 当 t s x 运 行 ` e x a m p l e s / ` 与 ` s c r i p t s / ` 时 的 解 析 配 置 。 | 否 | \ n | ` t s c o n f i g . h o s t . j s o n ` | H o s t a g g r e g a t e ： H o s t p a c k a g e 、 示 例 、 测 试 、 脚 本 和 w e b s i t e ， 以 及 ` a p i / r e m o t e s ` 的 H o s t 特 例 p r o j e c t 。 | 是 | \ n | ` t s c o n f i g . c l i e n t . j s o n ` | C l i e n t a g g r e g a t e ： ` p a c k a g e s / c l i e n t / * ` p a c k a g e 及 其 测 试 、 ` a p p s / w e b ` ， 以 及 ` a p i / r e m o t e s ` 的 C l i e n t 特 例 p r o j e c t 。 | 是 | \ n | ` t s c o n f i g . b a s e . j s o n ` | 共 享 c o m p i l e r O p t i o n s 与 源 码 ` p a t h s ` 映 射 。 同 时 是 各 v i t e s t 配 置 让 v i t e - t s c o n f i g - p a t h s 指 向 的 解 析 门 面 ： 它 没 有 ` i n c l u d e ` ， 因 此 其 ` p a t h s ` 适 用 于 任 何 i m p o r t e r 。 | 否 | \ n | ` t s c o n f i g . b a s e . c l i e n t . j s o n ` | 浏 览 器 编 译 设 置 （ ` j s x ` 、 D O M l i b 、 ` t y p e s : [ ] ` ） ， 由 C l i e n t a g g r e g a t e 和 每 个 ` p a c k a g e s / c l i e n t / * ` p a c k a g e e x t e n d s 。 | 否 | \ n \ n H o s t 与 C l i e n t 保 持 两 个 a g g r e g a t e p r o g r a m ， 是 因 为 两 侧 在 相 同 键 下 以 不 同 服 务 对 c o r d i s ` C o n t e x t ` 接 口 做 声 明 合 并 ； 单 一 p r o g r a m 同 时 看 到 两 份 合 并 会 报 冲 突 。 这 种 冲 突 只 存 在 于 ` t s . P r o g r a m ` 内 部 — — 模 块 解 析 永 远 不 会 触 发 它 — — 所 以 s o l u t i o n 可 以 同 时 引 用 两 个 a g g r e g a t e ， 一 个 p a t h s 门 面 也 可 以 横 跨 两 侧 。 由 此 推 出 三 条 纪 律 ： \ n \ n - ` t s c o n f i g . b a s e . j s o n ` 永 不 添 加 ` i n c l u d e ` 或 ` f i l e s ` ： 它 们 会 泄 漏 进 每 个 e x t e n d s 它 的 包 项 目 ， 并 收 窄 门 面 的 全 匹 配 范 围 。 \ n - 构 造 全 仓 ` t s . P r o g r a m ` 的 脚 本 显 式 种 子 ` t s c o n f i g . h o s t . j s o n ` 或 ` t s c o n f i g . c l i e n t . j s o n ` — — 永 不 种 子 根 s o l u t i o n ， 因 为 把 两 个 a g g r e g a t e 展 平 进 一 个 p r o g r a m 会 撞 上 ` C o n t e x t ` 合 并 冲 突
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-08-11 18:09:16 +08:00
"content" : " # B i l i n g u a l d o c u m e n t a t i o n \ n \ n E n g l i s h | [ 中 文 ] ( R E A D M E . z h . m d ) \ n \ n T h i s r e p o ' s d o c u m e n t a t i o n i s r e a d b y p e o p l e a n d a g e n t s b o t h i n s i d e a n d o u t s i d e t h e c o m p a n y , s o e v e r y d o c u m e n t i n s c o p e i s m a i n t a i n e d i n E n g l i s h a n d S i m p l i f i e d C h i n e s e . T h i s p a g e d e f i n e s t h e p a i r i n g c o n t r a c t , c h e c k s , s c o p e , a n d e x c l u s i o n s ; [ t r a n s l a t i o n - r u l e s . m d ] ( t r a n s l a t i o n - r u l e s . m d ) d e f i n e s h o w t o t r a n s l a t e ; [ t e r m i n o l o g y . m d ] ( t e r m i n o l o g y . m d ) i s t h e t e r m i n o l o g y s o u r c e o f t r u t h . R o u t i n e a g e n t w o r k f o l l o w s t h e l i g h t w e i g h t p a t h i n [ d o c s / A G E N T S . m d ] ( . . / A G E N T S . m d ) ; t h e e x t e n d e d [ . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s ] ( . . / . . / . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s / S K I L L . m d ) w o r k f l o w i s a v a i l a b l e o n l y t h r o u g h e x p l i c i t u s e r i n v o c a t i o n . \ n \ n # # T h e p a i r i n g c o n t r a c t \ n \ n - * * B o t h l a n g u a g e s c a r r y e q u a l a u t h o r i t y . * * A d o c u m e n t m a y b e a u t h o r e d a n d r e v i e w e d i n e i t h e r l a n g u a g e f i r s t — a C h i n e s e - f i r s t A g e n t N o t e i s a s l e g i t i m a t e a s a n E n g l i s h - f i r s t o n e — a n d t h e c o u n t e r p a r t i s t r a n s l a t e d f r o m i t . N e i t h e r f i l e o u t r a n k s t h e o t h e r ; w h a t b i n d s t h e m i s t h a t t h e y m u s t s a y t h e s a m e t h i n g . \ n - * * A p a i r i s t h r e e s i b l i n g f i l e s . * * T h e E n g l i s h ` f o o . m d ` , t h e C h i n e s e ` f o o . z h . m d ` , a n d a c o n s i s t e n c y r e c o r d ` f o o . i 18 n . y a m l ` , a l l i n t h e s a m e d i r e c t o r y . N o l o c a l e d i r e c t o r i e s , n o s e p a r a t e t r a n s l a t i o n r e p o , n o i n t e r l e a v e d b i l i n g u a l f i l e s . P a i r s m e r g e w h o l e : a P R n e v e r l a n d s o n e l a n g u a g e w i t h o u t t h e o t h e r t w o f i l e s . \ n - * * T h e c o n s i s t e n c y r e c o r d . * * ` f o o . i 18 n . y a m l ` h o l d s t h e f u l l g i t b l o b h a s h o f e a c h s i d e a s o f t h e l a s t t i m e t h e t w o w e r e c o n f i r m e d t o s a y t h e s a m e t h i n g : \ n \ n ` ` ` y a m l \ n f o o . m d : 3 f 786850e387550 f d a b 836 e d 7e6 d c 881 d e 23001 b \ n f o o . z h . m d : 89e6 c 98 d 92887913 c a d f 0 6 b 2 a d b 97 f 26 c d e 4849 b \ n ` ` ` \ n \ n B l o b h a s h e s , n o t c o m m i t h a s h e s , s o t h e r e c o r d i s c o m p u t a b l e f o r f i l e s e d i t e d i n t h e s a m e P R ( ` g i t h a s h - o b j e c t f o o . m d ` ) a n d c o n s i s t e n c y i s a p u r e c o n t e n t c o m p a r i s o n . ` - - w r i t e ` s t o r e s t h o s e s n a p s h o t s i n t h e l o c a l G i t o b j e c t d a t a b a s e b e f o r e r e c o r d i n g t h e m , i n c l u d i n g u n c o m m i t t e d w o r k i n g - t r e e c o n t e n t s , a n d p i n s e v e r y d i s t i n c t s t o r e d b l o b u n d e r a c o n t e n t - a d d r e s s e d ` r e f s / d s h / t r a n s l a t i o n - p a i r i n g / s n a p s h o t s / ` r e f s o g a r b a g e c o l l e c t i o n c a n n o t i n v a l i d a t e a r e c o r d e d r e c o v e r y p o i n t e r . T h e r e c o r d e d h a s h e s t h e r e f o r e r e c o v e r t h e e x a c t l a s t - c o n f i r m e d t e x t o f e i t h e r s i d e , s o a n o u t - o f - s y n c p a i r i s u p d a t e d b y p a t c h i n g t h e c o u n t e r p a r t m i n i m a l l y a g a i n s t t h e e d i t e d s i d e ' s d i f f — n e v e r b y r e - t r a n s l a t i n g w h o l e f i l e s . R o u t i n e w o r k m a k e s t h a t p a t c h d i r e c t l y ; w h e n t h e u s e r e x p l i c i t l y i n v o k e s t h e e x t e n d e d w o r k f l o w , ` p n p m r u n g e n - t r a n s l a t i o n - b r i e f < p a i r > ` c a n i n s t e a d a s s e m b l e t h e u p d a t e a t t h e n a r r o w e s t s a f e l y a l i g n e d g r a n u l a r i t y a n d ` - - a p p l y ` c a n s p l i c e a c o d e - f e n c e - o n l y c h a n g e a f t e r s t r u c t u r a l v a l i d a t i o n ( [ b r i e f e d - u p d a t e s A g e n t N o t e ] ( . . / . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -26 - b r i e f e d - m i n i m a l - t r a n s l a t i o n - u p d a t e s . m d ) ) . A f t e r b r i n g i n g t h e p a i r b a c k i n l i n e , ` p n p m r u n v e r i f y - t r a n s l a t i o n - p a i r i n g - - w r i t e < p a i r > ` r e - r e c o r d s b o t h h a s h e s ; t h a t y a m l d i f f i s t h e r e v i e w a b l e a c t o f c o n f i r m i n g c o n s i s t e n c y , w h i c h i s w h y ` - - w r i t e ` r e q u i r e s n a m i n g t h e p a i r s y o u c o n f i r m e d ( ` - - w r i t e - - a l l ` i s t h e e x p l i c i t c o r p u s - w i d e f o r m ) . \ n \ n W h e n t w o b r a n c h e s c o n t a i n v a l i d c o n f i r m a t i o n s o f t h e s a m e p a i r , t h e i n s t a l l e d ` d s h - t r a n s l a t i o n - p a i r i n g ` G i t m e r g e d r i v e r c o m p o s e s a n e w r e c o r d o n l y i f G i t ' s d e f a u l t t e x t m e r g e s u c c e e d s f o r b o t h r e c o r d e d o w n e r - b l o b t r i p l e t s a n d t h e m e r g e d p a i r r e t a i n s i t s r e q u i r e d s w i t c h e r s a n d s t r u c t u r a l s i g n a t u r e . T h e C h i n e s e f i l e m u s t r e t a i n i t s E n g l i s h b a c k l i n k ; a n a u t h o r e d E n g l i s h s o u r c e m u s t r e t a i n i t s C h i n e s e l i n k , w h i l e a l i s t e d g e n e r a t e d E n g l i s h s o u r c e i s e x e m p t . A n y s t r u c t u r e t h e d r i v e r c a n n o t v e r i f y r e m a i n s a n o r d i n a r y c o n f l i c t ; ` p n p m r u n r e s o l v e - t r a n s l a t i o n - p a i r i n g - c o n f l i c t s ` a p p l i e s t h e s a m e f a i l - c l o s e d o p e r a t i o n t o a m e r g e t h a t h a s a l r e a d y s t o p p e d , s t a g e s e v e r y s a f e p a i r i n g r e c o r d , a n d e x i t s u n s u c c e s s f u l l y w h e n o t h e r p a i r i n g c o n f l i c t s r e m a i n . T h e [ a u t o m a t i c p a i r i n g m e r g e s A g e n t N o t e ] ( . . / . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 8 -0 8 - a u t o m a t i c - t r a n s l a t i o n - p a i r i n g - m e r g e s . m d ) o w n s t h e m e c h a n i s m a n d a l t e r n a t i v e s . \ n - * * L a n g u a g e s w i t c h e r . * * T h e C h i n e s e f i l e a l w a y s l i n k s b a c k i m m e d i a t e l y a f t e r i t s H 1 h e a d i n g w i t h ` [ E n
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "assistant" ,
2026-08-11 18:09:16 +08:00
"content" : " # 双 语 文 档 \ n \ n [ E n g l i s h ] ( R E A D M E . m d ) | 中 文 \ n \ n 本 仓 库 的 文 档 会 被 公 司 内 外 的 人 和 a g e n t （ 智 能 体 ） 阅 读 ， 因 此 范 围 内 的 每 篇 文 档 都 以 英 文 和 简 体 中 文 维 护 。 本 页 定 义 配 对 约 定 、 检 查 、 范 围 与 排 除 规 则 ； [ t r a n s l a t i o n - r u l e s . m d ] ( t r a n s l a t i o n - r u l e s . m d ) 定 义 如 何 翻 译 ； [ t e r m i n o l o g y . m d ] ( t e r m i n o l o g y . m d ) 是 术 语 真 源 。 a g e n t 的 日 常 工 作 遵 循 [ d o c s / A G E N T S . m d ] ( . . / A G E N T S . m d ) 中 的 轻 量 路 径 ； 扩 展 版 [ . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s ] ( . . / . . / . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s / S K I L L . m d ) 工 作 流 仅 在 用 户 显 式 调 用 时 可 用 。 \ n \ n # # 配 对 约 定 \ n \ n - * * 两 种 语 言 同 权 。 * * 一 篇 文 档 可 以 先 用 任 一 语 言 撰 写 和 评 审 （ 先 写 中 文 的 A g e n t N o t e 与 先 写 英 文 的 一 样 正 当 ） ， 另 一 侧 由 它 翻 译 而 来 。 两 个 文 件 谁 也 不 高 于 谁 ； 约 束 它 们 的 是 二 者 必 须 说 同 样 的 话 。 \ n - * * 一 对 文 档 是 三 个 同 目 录 文 件 。 * * 英 文 ` f o o . m d ` 、 中 文 ` f o o . z h . m d ` ， 加 一 份 一 致 性 记 录 ` f o o . i 18 n . y a m l ` ， 都 在 同 一 目 录 。 不 用 语 言 目 录 ， 不 用 独 立 翻 译 仓 库 ， 不 用 中 英 混 排 的 单 文 件 。 配 对 必 须 整 体 合 并 ： P R （ P u l l R e q u e s t ） 永 远 不 会 只 带 一 种 语 言 而 缺 其 余 两 个 文 件 。 \ n - * * 一 致 性 记 录 。 * * ` f o o . i 18 n . y a m l ` 保 存 两 侧 文 件 在 上 一 次 被 确 认 「 说 同 样 的 话 」 时 各 自 的 完 整 g i t b l o b h a s h ： \ n \ n ` ` ` y a m l \ n f o o . m d : 3 f 786850e387550 f d a b 836 e d 7e6 d c 881 d e 23001 b \ n f o o . z h . m d : 89e6 c 98 d 92887913 c a d f 0 6 b 2 a d b 97 f 26 c d e 4849 b \ n ` ` ` \ n \ n 用 b l o b h a s h 而 不 是 c o m m i t h a s h ， 这 样 同 一 个 P R 里 改 动 的 文 件 也 能 算 出 记 录 （ ` g i t h a s h - o b j e c t f o o . m d ` ） ， 一 致 性 是 纯 内 容 比 较 。 ` - - w r i t e ` 会 先 把 这 些 快 照 存 入 本 地 G i t 对 象 库 再 写 下 记 录 ， 未 提 交 的 工 作 树 内 容 也 不 例 外 ； 它 还 会 在 内 容 寻 址 的 ` r e f s / d s h / t r a n s l a t i o n - p a i r i n g / s n a p s h o t s / ` r e f 下 固 定 每 个 不 同 的 已 存 b l o b ， 使 垃 圾 回 收 无 法 让 已 记 录 的 恢 复 指 针 失 效 。 因 此 记 录 的 h a s h 能 还 原 任 一 侧 上 次 确 认 时 的 确 切 文 本 ， 所 以 失 去 同 步 的 配 对 是 「 按 被 改 一 侧 的 d i f f 最 小 化 地 修 补 另 一 侧 」 ， 从 不 整 篇 重 译 。 日 常 工 作 会 直 接 完 成 这 份 修 补 ； 用 户 显 式 调 用 扩 展 工 作 流 时 ， 可 改 由 ` p n p m r u n g e n - t r a n s l a t i o n - b r i e f < p a i r > ` 以 能 安 全 对 齐 的 最 窄 粒 度 汇 集 这 次 更 新 ， 并 由 ` - - a p p l y ` 在 结 构 校 验 后 拼 接 仅 涉 及 围 栏 代 码 块 的 改 动 （ [ b r i e f e d - u p d a t e s A g e n t N o t e ] ( . . / . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 7 -26 - b r i e f e d - m i n i m a l - t r a n s l a t i o n - u p d a t e s . m d ) ） 。 两 侧 对 齐 后 ， ` p n p m r u n v e r i f y - t r a n s l a t i o n - p a i r i n g - - w r i t e < p a i r > ` 重 新 记 录 两 个 h a s h ； 那 份 y a m l d i f f 就 是 「 确 认 一 致 」 这 个 动 作 本 身 ， 可 以 被 评 审 ， 也 正 因 如 此 ， ` - - w r i t e ` 要 求 点 名 你 确 认 过 的 配 对 （ ` - - w r i t e - - a l l ` 是 显 式 的 全 语 料 形 式 ） 。 \ n \ n 当 两 个 分 支 都 包 含 同 一 配 对 的 有 效 确 认 时 ， 已 安 装 的 ` d s h - t r a n s l a t i o n - p a i r i n g ` G i t 合 并 驱 动 只 会 在 G i t 默 认 文 本 合 并 能 分 别 干 净 合 并 记 录 所 指 向 的 英 文 三 方 b l o b 与 中 文 三 方 b l o b ， 且 合 并 后 的 配 对 仍 保 留 必 需 的 语 言 切 换 行 和 结 构 签 名 时 ， 组 合 出 一 份 新 记 录 。 中 文 文 件 必 须 保 留 指 向 英 文 的 反 向 链 接 ； 普 通 撰 写 的 英 文 源 必 须 保 留 指 向 中 文 的 链 接 ， 而 清 单 内 的 生 成 英 文 源 不 作 此 要 求 。 任 何 合 并 驱 动 无 法 验 证 的 结 构 都 保 留 为 普 通 冲 突 ； ` p n p m r u n r e s o l v e - t r a n s l a t i o n - p a i r i n g - c o n f l i c t s ` 会 对 已 经 停 止 的 合 并 执 行 同 一 套 遇 错 即 保 留 冲 突 的 操 作 ， 暂 存 每 份 可 安 全 生 成 的 配 对 记 录 ， 并 在 还 有 其 他 配 对 冲 突 时 以 非 零 状 态 退 出 。 [ 自 动 配 对 合 并 A g e n t N o t e ] ( . . / . . / . a g e n t s / n o t e s / i m p l e m e n t e d / p r o c e s s / 2026 -0 8 -0 8 - a u t o m a t i c - t r a n s l a t i o n - p a i r i n g - m e r g e s . m d ) 负 责 记 录 该 机 制 与 备 选 方 案 。 \ n - * * 语 言 切 换 行 。 * * 中 文 文 件 一 律 在 H 1 标 题 后 立 即 以 ` [ E n g l i s h ] ( f o o . m d ) | 中 文 ` 链 回 英 文 。 普 通 撰 写 的 英 文 文 件 在 同 一 位 置 以 ` E n g l i s h | [ 中 文 ] ( f o o . z h . m d ) ` 互 链 ； 清 单 内 的 生 成 英 文 源 省 略 此 行 ， 以 便 与 生 成 器 输 出 逐 字 节 一 致 。 \ n - * * 结 构 与 另 一 侧 一 一 对 应 。 * * 标 题 深 度 与 顺 序
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-08-08 15:44:45 +08:00
"content" : " # T r a n s l a t i o n r u l e s \ n \ n E n g l i s h | [ 中 文 ] ( t r a n s l a t i o n - r u l e s . z h . m d ) \ n \ n H o w t o t r a n s l a t e b e t w e e n t h e t w o s i d e s o f a d o c u m e n t a t i o n p a i r i n t h i s r e p o . B o t h l a n g u a g e s c a r r y e q u a l a u t h o r i t y ( [ R E A D M E . m d ] ( R E A D M E . m d ) ) : a c h a n g e i s a u t h o r e d i n e i t h e r l a n g u a g e , a n d t h a t s i d e i s t h e s o u r c e f o r t h a t u p d a t e — t h e s e r u l e s g o v e r n p r o d u c i n g o r u p d a t i n g t h e c o u n t e r p a r t . T h e y b i n d h u m a n s a n d a g e n t s e q u a l l y . R o u t i n e a g e n t w o r k t r a n s l a t e s t h e c h a n g e d c o n t e n t d i r e c t l y i n o n e t e r m i n o l o g y - g u i d e d p a s s ; t h e e x t e n d e d [ . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s ] ( . . / . . / . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s / S K I L L . m d ) w o r k f l o w r u n s o n l y w h e n t h e u s e r e x p l i c i t l y i n v o k e s i t . R u l e l e v e l s f o l l o w R F C 2119 u s a g e : * * M U S T * * / * * M U S T N O T * * a r e g a t e - o r r e v i e w - b l o c k i n g ; * * S H O U L D * * n e e d s a s t a t e d r e a s o n t o d e v i a t e ; * * M A Y * * i s d i s c r e t i o n a r y . \ n \ n # # F a i t h f u l n e s s \ n \ n - T h e c o u n t e r p a r t * M U S T * s a y w h a t t h e a u t h o r e d s i d e s a y s — n o a d d e d b e h a v i o r , p r e r e q u i s i t e s , w a r n i n g s , v e r s i o n c l a i m s , o r e x a m p l e s , a n d n o d r o p p e d o n e s . I f t h e p a i r d i s a g r e e s o n s u b s t a n c e , n e i t h e r l a n g u a g e w i n s b y d e f a u l t : f i x t h e s i d e t h a t i s w r o n g , t h e n b r i n g t h e o t h e r a l o n g i n t h e s a m e c h a n g e . \ n - T h e c o u n t e r p a r t * S H O U L D * r e a d a s n a t u r a l t e c h n i c a l w r i t i n g i n i t s o w n l a n g u a g e , n o t w o r d - b y - w o r d g l o s s . T r a n s l a t e m e a n i n g , r e s t r u c t u r e s e n t e n c e s w h e r e t h e t a r g e t g r a m m a r w a n t s i t , a n d k e e p t h e a u t h o r ' s r e g i s t e r — t e r s e s t a y s t e r s e . \ n - D o n o t t r a n s l a t e t h e u n t r a n s l a t a b l e : i f a s e n t e n c e r e s i s t s n a t u r a l r e n d e r i n g b e c a u s e i t l e a n s o n a n i d i o m o f t h e s o u r c e l a n g u a g e , t r a n s l a t e t h e i d e a , n o t t h e i d i o m . \ n \ n # # V o i c e \ n \ n - T h e r e g i s t e r i s c a l i b r a t e d b y [ s t y l e - s a m p l e s . m d ] ( s t y l e - s a m p l e s . m d ) — h u m a n - a p p r o v e d g o l d p a i r s , o n e p e r d o c u m e n t g e n r e . T h e c o u n t e r p a r t M U S T m a t c h t h e t a r g e t - l a n g u a g e s i d e o f t h e n e a r e s t s a m p l e ; w h e r e i t s v o i c e a n d a p r o s e v o i c e r u l e d i s a g r e e , t h e s a m p l e w i n s . C h i n e s e t a r g e t s u s e i n s t i t u t i o n a l t e c h n i c a l C h i n e s e ; E n g l i s h t a r g e t s u s e c o n c i s e p r o f e s s i o n a l d e v e l o p e r p r o s e . \ n - W r i t e a s a n a t i v e t e c h n i c a l a u t h o r r e s t a t i n g t h e c o n t e n t , n o t a s a t r a n s l a t o r t r a n s p o s i n g s e n t e n c e s , w h i l e p r e s e r v i n g e v e r y s o u r c e c l a u s e : n o t h i n g a d d e d , n o t h i n g d r o p p e d — f l u e n c y n e v e r j u s t i f i e s l o s i n g a c l a u s e . \ n - G i v e s e n t e n c e s a n e x p l i c i t a c t o r w h e n t h e t a r g e t l a n g u a g e w o u l d o t h e r w i s e o b s c u r e i t ; f o r C h i n e s e , r e p l a c e v a g u e p a s s i v e s o r a b s t r a c t s u b j e c t s w i t h t h e a c t u a l a c t o r ( 系 统 、 门 禁 、 评 审 人 ) . \ n - P r e f e r e s t a b l i s h e d t a r g e t - l a n g u a g e e n g i n e e r i n g i d i o m o v e r c a l q u e s ( 误 报 ／ 漏 检 f o r false p o s i t i v e / n e g a t i v e , 执 行 红 线 f o r e n f o r c e m e n t f r o n t i e r ) ; l o c a l i z e m e t a p h o r s i n s t e a d o f t r a n s p l a n t i n g t h e m , a n d u n p a c k n o u n c h a i n s w h e r e t h e t a r g e t l a n g u a g e r e q u i r e s i t . \ n - S p l i t l o n g p a r a g r a p h s b y s e m a n t i c u n i t — o n e i d e a p e r p a r a g r a p h . P a r a g r a p h b o u n d a r i e s M A Y d i f f e r f r o m t h e s o u r c e ; t h e s t r u c t u r a l s i g n a t u r e d o e s n o t c o u n t p a r a g r a p h s . \ n - W h e n t r a n s l a t i n g i n t o C h i n e s e , c a t e g o r y n o u n s u s e C h i n e s e w i t h a f i r s t - m e n t i o n E n g l i s h a n n o t a t i o n ( 实 操 手 册 （ c o o k b o o k ） ) ; w h e n t r a n s l a t i n g i n t o E n g l i s h , u s e t h e c o n v e n t i o n a l E n g l i s h c a t e g o r y n a m e . L i t e r a l d i r e c t o r y o r f i l e r e f e r e n c e s s t a y c o d e - f o r m a t t e d E n g l i s h . \ n \ n # # S t r u c t u r e p r e s e r v a t i o n \ n \ n T h e p a i r i n g g a t e c h e c k s h e a d i n g d e p t h s , f e n c e d c o d e b l o c k s , t a b l e r o w a n d c o l u m n c o u n t s , l i s t k i n d s , o r d e r e d - l i s t s t a r t s , l i s t i t e m c o u n t s , a n d l i n k t a r g e t s . P r e s e r v e t h e r e s t o f t h e f r a m e m a n u a l l y ; t h e p a i r e d f i l e s M U S T m a t c h o n e t o o n e i n : \ n \ n - h e a d i n g h i e r a r c h y ( s a m e l e v e l s , s a m e o r d e r — h e a d i n g T E X T i s t r a n s l a t e d ) , \ n - l i s t s h a p e a n d n u m b e r i n g , \ n - t a b l e s ( s a m e c o l u m n s , s a m e r o w o r d e r ; h e a d e r c e l l s t r a n s l a t e d p e r t e r m i n o l o g y ) , \ n - f e n c e d c o d e b l o c k s — * * b y t e - i d e n t i c a l , i n c l u d i n g c o m m e n t s * * ; t h e p a i r i n g s i g n a t u r e c o m p a r e s t h e i r i n f o s t r i n g s a n d c o n t e n t s , a n d ` ` ` ` t s ` b l o c k s c o m p i l e u n d e r ` d o c - t y p e c h e c k ` , \ n - i n l i n e c o d e s p a n s ( c o m m a n d s , f l a g s , c o n f i g k e y s , f i l e p a t h s , e v e n t n a m e s , A P I n a m e s , v e r s i o n n u m b e r s ) — v e r b a t i m , n e v e r t r a n s l a t e d o r r e f o r m a t t e d , \ n - l i n k s a n d a n c h o r s : e v e r y r e l a t i v e l i n k M U S T p o i n t a t t h e s a m e t a r g e t i n b o t h f i l e s — b y c o n v e n t i o n t h e ` . m d ` p a t h , n o t t h e ` . z h . m d ` s i b l i n g — s o l i n k s n e v e r d a n g l e w h e n o n e p a i r l a n d s b e f o r e i t s n e i g h b o r s . T h e O N L Y z h - s p e c
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "assistant" ,
2026-08-08 15:44:45 +08:00
"content" : " # 翻 译 规 则 \ n \ n [ E n g l i s h ] ( t r a n s l a t i o n - r u l e s . m d ) | 中 文 \ n \ n 本 文 规 定 ： 如 何 在 本 仓 库 文 档 配 对 的 中 英 文 两 种 语 言 之 间 进 行 翻 译 。 两 种 语 言 同 权 （ 见 [ R E A D M E . m d ] ( R E A D M E . m d ) ） ： 每 次 变 更 可 以 用 任 一 语 言 撰 写 ， 被 编 辑 的 一 侧 即 为 本 次 更 新 的 源 ； 本 文 的 规 则 约 束 如 何 产 出 或 更 新 对 侧 文 件 。 这 些 规 则 对 人 类 和 a g e n t （ 智 能 体 ） 同 等 生 效 。 日 常 工 作 中 ， a g e n t 会 在 术 语 指 导 下 直 接 一 次 完 成 有 改 动 内 容 的 翻 译 ； 扩 展 版 [ . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s ] ( . . / . . / . a g e n t s / s k i l l s / d s h - t r a n s l a t e - d o c s / S K I L L . m d ) 工 作 流 仅 在 用 户 显 式 调 用 时 运 行 。 规 则 级 别 沿 用 R F C 2119 的 用 法 ： * * 必 须 （ M U S T ） * * ／ * * 禁 止 （ M U S T N O T ） * * 会 卡 门 禁 或 评 审 ； * * 应 当 （ S H O U L D ） * * 偏 离 时 要 说 明 理 由 ； * * 可 以 （ M A Y ） * * 自 行 裁 量 。 \ n \ n # # 忠 实 性 \ n \ n - 对 侧 文 件 * 必 须 * 传 达 与 撰 写 侧 相 同 的 内 容 ： 不 添 加 行 为 、 前 置 条 件 、 警 告 、 版 本 声 明 或 示 例 ， 也 不 漏 掉 任 何 一 项 。 如 果 两 侧 在 实 质 内 容 上 不 一 致 ， 没 有 哪 种 语 言 默 认 获 胜 ； 请 修 正 错 误 的 一 侧 ， 并 在 同 一 个 变 更 里 同 步 更 新 另 一 侧 。 \ n - 对 侧 文 件 读 起 来 * 应 当 * 是 其 语 言 自 然 的 技 术 文 字 ， 而 非 逐 词 对 照 的 译 文 。 请 根 据 语 义 翻 译 ， 在 目 标 语 言 语 法 需 要 时 重 组 句 子 ， 并 保 持 原 作 者 的 语 域 （ 比 如 ： 简 练 的 保 持 简 练 ） 。 \ n - 不 要 翻 译 不 可 译 的 内 容 ： 如 果 一 句 话 依 赖 源 语 言 的 习 语 、 无 法 自 然 转 换 ， 请 翻 译 它 的 意 思 ， 而 非 习 语 本 身 。 \ n \ n # # 行 文 \ n \ n - 语 体 以 [ s t y l e - s a m p l e s . m d ] ( s t y l e - s a m p l e s . m d ) 为 校 准 锚 点 。 人 工 定 稿 的 金 标 样 例 按 文 体 各 一 组 ， 译 文 必 须 参 照 文 体 最 接 近 的 样 例 ， 采 用 其 中 目 标 语 言 一 侧 的 语 体 ； 如 果 样 例 与 本 文 的 行 文 规 则 冲 突 ， 以 样 例 为 准 。 译 成 中 文 时 ， 采 用 规 范 的 技 术 制 度 文 ； 译 成 英 文 时 ， 采 用 简 洁 、 专 业 的 开 发 者 文 档 语 体 。 \ n - 以 母 语 技 术 作 者 的 身 份 重 述 内 容 ， 而 不 是 以 译 者 身 份 逐 句 转 写 ， 同 时 保 留 原 文 的 每 个 语 义 成 分 ： 不 添 加 、 不 遗 漏 — — 流 畅 永 远 不 是 丢 掉 语 义 成 分 的 理 由 。 \ n - 如 果 直 译 会 让 执 行 主 体 含 糊 ， 请 明 确 写 出 实 际 执 行 者 ； 译 成 中 文 时 ， 应 由 「 系 统 、 门 禁 、 评 审 人 」 等 实 际 执 行 者 作 主 语 ， 避 免 含 糊 的 被 动 句 或 抽 象 主 语 。 \ n - 优 先 采 用 目 标 语 言 中 通 行 的 工 程 表 达 ， 避 免 生 硬 直 译 （ false p o s i t i v e / n e g a t i v e → 误 报 ／ 漏 检 、 e n f o r c e m e n t f r o n t i e r → 执 行 红 线 ） ； 隐 喻 应 自 然 改 写 ， 名 词 链 则 按 目 标 语 言 的 习 惯 拆 开 。 \ n - 长 段 按 语 义 单 元 拆 分 ， 一 段 一 件 事 。 段 落 边 界 可 以 与 原 文 不 同 ； 结 构 签 名 不 比 对 段 落 数 。 \ n - 翻 译 为 中 文 时 ， 类 别 名 词 使 用 中 文 并 在 首 现 括 注 英 文 （ 实 操 手 册 （ c o o k b o o k ） ） ； 翻 译 为 英 文 时 ， 使 用 通 行 的 英 文 类 别 名 。 指 目 录 或 文 件 本 身 时 保 留 代 码 体 英 文 。 \ n \ n # # 结 构 保 持 \ n \ n 配 对 门 禁 会 检 查 标 题 深 度 、 围 栏 代 码 块 、 表 格 行 列 数 、 列 表 类 型 、 有 序 列 表 起 始 编 号 、 列 表 项 数 量 与 链 接 目 标 ； 门 禁 未 覆 盖 的 结 构 仍 需 人 工 核 对 。 两 个 配 对 文 件 必 须 在 以 下 方 面 一 一 对 应 ： \ n \ n - 标 题 层 级 （ 相 同 级 别 、 相 同 顺 序 ； 标 题 的 * * 文 字 * * 要 翻 译 ） ； \ n - 列 表 形 态 与 编 号 ； \ n - 表 格 （ 相 同 的 列 、 相 同 的 行 序 ； 表 头 单 元 格 按 术 语 表 翻 译 ） ； \ n - 围 栏 代 码 块 ： * * 逐 字 节 一 致 ， 包 括 注 释 * * 。 配 对 签 名 比 对 信 息 字 符 串 与 内 容 ， ` ` ` ` t s ` 块 还 要 通 过 ` d o c - t y p e c h e c k ` 编 译 ； \ n - 行 内 代 码 （ 命 令 、 f l a g 、 配 置 键 、 文 件 路 径 、 事 件 名 、 A P I 名 、 版 本 号 ） ： 原 样 保 留 ， 从 不 翻 译 或 重 排 ； \ n - 链 接 与 锚 点 ： 每 个 相 对 链 接 在 两 个 文 件 中 必 须 指 向 相 同 的 目 标 （ 按 约 定 是 ` . m d ` 路 径 而 非 ` . z h . m d ` 兄 弟 文 件 ） ， 这 样 即 使 某 对 文 档 先 于 相 邻 文 件 落 地 ， 链 接 也 不 会 悬 空 。 唯 一 的 z h 特 有 链 接 是 语 言 切 换 行 。 链 接 * * 文 字 * * 翻 译 ； 链 接 目 标 不 翻 。 \ n \ n 本 仓 库 的 M a r k d o w n 约 定 对 ` . z h . m d ` 文 件 原 样 生 效 ： 一 个 段 落 一 个 物 <EFBFBD> <EFBFBD>
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-08-08 16:12:36 +08:00
"content" : " # A g e n t N o t e : B i l i n g u a l d o c u m e n t a t i o n v i a p a i r e d s i b l i n g f i l e s a n d a p a i r i n g g a t e \ n \ n S t a t u s : i m p l e m e n t e d \ n \ n E n g l i s h | [ 中 文 ] ( 2026 -0 7 -0 2 - b i l i n g u a l - d o c s - a n d - p a i r i n g - g a t e . z h . m d ) \ n \ n # # P r o b l e m \ n \ n T h i s r e p o ' s d o c u m e n t a t i o n c o r p u s i s r e a d b y p e o p l e a n d a g e n t s i n s i d e a n d o u t s i d e t h e c o m p a n y , i n b o t h E n g l i s h a n d C h i n e s e . M a i n t a i n i n g a s e c o n d l a n g u a g e b y h a n d , w i t h n o m e c h a n i s m , i s h o w t r a n s l a t i o n s r o t : o n e s i d e m o v e s o n , t h e o t h e r s i l e n t l y l i e s , a n d n o g a t e n o t i c e s . T h e r e p o ' s s t a n d i n g a n s w e r t o i n v a r i a n t s o f t h i s k i n d i s t o e n c o d e t h e m a s a m e c h a n i c a l c h e c k ( s e e [ q u a l i t y g a t e s ] ( 2026 -0 6 -11 - q u a l i t y - g a t e s . m d ) a n d [ d o c - s y n c e n f o r c e m e n t ] ( . . / . . / a r c h i v e d / p r o c e s s / 2026 -0 6 -11 - d o c - s y n c - e n f o r c e m e n t . m d ) ) , s o t h e b i l i n g u a l p o l i c y s h i p s w i t h o n e . \ n \ n # # D e c i s i o n \ n \ n - * * P a i r e d s i b l i n g f i l e s w i t h e q u a l a u t h o r i t y . * * A d o c u m e n t a t i o n p a i r i s t h r e e s i b l i n g f i l e s : E n g l i s h ` f o o . m d ` , C h i n e s e ` f o o . z h . m d ` , a n d a c o n s i s t e n c y r e c o r d ` f o o . i 18 n . y a m l ` . N e i t h e r l a n g u a g e i s c a n o n i c a l — a d o c u m e n t m a y b e a u t h o r e d a n d r e v i e w e d C h i n e s e - f i r s t a n d t r a n s l a t e d t o E n g l i s h a f t e r w a r d s , o r t h e r e v e r s e ; w h a t b i n d s t h e p a i r i s t h a t b o t h s i d e s m u s t s a y t h e s a m e t h i n g , a n d p a i r s m e r g e w h o l e ( b o t h l a n g u a g e s p l u s t h e r e c o r d , n e v e r o n e a l o n e ) . P o l i c y : [ d o c s / i 18 n / R E A D M E . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / R E A D M E . m d ) ; t r a n s l a t i o n r u l e s : [ d o c s / i 18 n / t r a n s l a t i o n - r u l e s . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / t r a n s l a t i o n - r u l e s . m d ) ; t e r m i n o l o g y s o u r c e o f t r u t h : [ d o c s / i 18 n / t e r m i n o l o g y . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / t e r m i n o l o g y . m d ) . \ n - * * A s i d e c a r r e c o r d o f b o t h b l o b h a s h e s m a k e s c o n s i s t e n c y c h e c k a b l e . * * ` f o o . i 18 n . y a m l ` h o l d s t h e f u l l g i t b l o b h a s h o f e a c h s i d e a s o f t h e l a s t c o n f i r m e d - c o n s i s t e n t s t a t e . A n e d i t t o e i t h e r s i d e w i t h o u t r e - c o n f i r m i n g t h e p a i r i s t h e n m e c h a n i c a l l y d e t e c t a b l e a s a p u r e c o n t e n t c o m p a r i s o n — n o h i s t o r y l o o k u p — a n d t h e h a s h e s a r e c o m p u t a b l e f o r f i l e s e d i t e d i n t h e s a m e P R , w h i c h a c o m m i t - h a s h r e c o r d i s n o t . R e - r e c o r d i n g ( ` v e r i f y - t r a n s l a t i o n - p a i r i n g - - w r i t e < p a i r > ` , w h i c h r e q u i r e s n a m i n g t h e c o n f i r m e d p a i r s — b u l k r e - r e c o r d i s a n e x p l i c i t ` - - w r i t e - - a l l ` ) p r o d u c e s a r e v i e w a b l e y a m l d i f f : c o n f i r m i n g c o n s i s t e n c y i s a n e x p l i c i t , v i s i b l e a c t i n t h e P R . \ n - * * ` v e r i f y - t r a n s l a t i o n - p a i r i n g ` j o i n s ` d o c - s y n c ` . * * T h e g a t e ( [ s c r i p t s / v e r i f y - t r a n s l a t i o n - p a i r i n g . t s ] ( . . / . . / . . / . . / s c r i p t s / v e r i f y - t r a n s l a t i o n - p a i r i n g . t s ) ) e n f o r c e s : e v e r y d i s c o v e r e d , n o n - e x c l u d e d s o u r c e h a s a c o m p l e t e p a i r ; e v e r y e x i s t i n g p a i r i s c o m p l e t e ( a l l t h r e e f i l e s ) a n d c o n s i s t e n t ( b o t h h a s h e s m a t c h , t h e C h i n e s e s i d e a n d e v e r y a u t h o r e d E n g l i s h s o u r c e c a r r y t h e i r s w i t c h e r s w h i l e l i s t e d g e n e r a t e d E n g l i s h s o u r c e s a r e e x e m p t , s t r u c t u r a l s i g n a t u r e s i d e n t i c a l ) ; a n d e x c l u d e d g e n e r a t e d , i n s t r u c t i o n , o r b i l i n g u a l - b y - c o n s t r u c t i o n f i l e s s t a y u n p a i r e d . [ s c r i p t s / t r a n s l a t i o n - p a i r i n g . m a n i f e s t . j s o n ] ( . . / . . / . . / . . / s c r i p t s / t r a n s l a t i o n - p a i r i n g . m a n i f e s t . j s o n ) c o n t a i n s o n l y e x p l i c i t e x c l u s i o n s , s o n o r e q u i r e m e n t c a n b y p a s s d i s c o v e r y a n d r e c e i v e a w e a k e r c h e c k . S o u r c e - o r i e n t e d c o d e g a t e s c o n s u m e a ` . z h . m d ` f e n c e s e q u e n c e a s a d e r i v a t i v e o n l y w h e n i t s u n s u f f i x e d s i b l i n g h a s t h e s a m e t r a c k e d f e n c e s i n t h e s a m e o r d e r w i t h b y t e - i d e n t i c a l b o d i e s ; a n i n c o m p l e t e , r e o r d e r e d , r e c l a s s i f i e d , o r c h a n g e d s e q u e n c e s t a y s i n d e p e n d e n t , s o t h e o w n i n g c o d e g a t e o r p a i r i n g g a t e r e p o r t s t h e m i s m a t c h . \ n - * * O n e c o r p u s - w i d e r e q u i r e m e n t . * * E v e r y d o c u m e n t i n s c o p e r e q u i r e s a c o m p l e t e p a i r f r o m c r e a t i o n ; t h e p o l i c y h a s n o p e r - f i l e r o l l o u t s t a t e , d a t e c u t o f f , o r R E A D M E - s p e c i f i c c l a s s . R E A D M E d i s c o v e r y c o v e r s e v e r y c a s e - i n s e n s i t i v e R E A D M E b a s e n a m e o u t s i d e v e n d o r e d , d e p e n d e n c y , a n d i g n o r e d b u i l d - o u t p u t t r e e s , i n c l u d i n g f u t u r e t o p - l e v e l d i r e c t o r i e s . A s i t e - p u b l i s h e d p a i r u s e s ` p a i r e d P a g e s ( ) ` s o t h e r o o t l o c a l e p r o j e c t s ` . z h . m d ` a n d ` / e n / ` p r o j e c t s ` . m d ` ; c r e a t i n g a c o u n t e r p a r t a l o n e d o e s n o t p u b l i s h i t . \ n - * * P a i r i n g r e c o r d s a r e m e t a d a t a , n o t C o r d i s L o a d e r c o n f i g u r a t i o n . * * C o r d i s c o n f i g u r a t i o n d i s c o v e r y a c c e p t s a c t u a l ` . c o r d i s . y m l ` a n d ` . c o r d i s . y a m l ` f i l e s w h i l e e x c l u d i n g ` * . i 18 n . y a m l ` , e v e n w h e n t h e d o c u m e n t n a m e c o n t a i n s ` c o r d i s ` . T h i s p r e s e r v e s v a l i d a t i o n o f e x e c u t a b l e L o a d e r e n t r i e s w i t h o u t p a r s i n g t r a n s l a t i o n h a s h e s a s c o n f i g u r a t i o n . \ n - * * T r a n s l a t i o n i s a g e n t
2026-08-08 15:44:45 +08:00
} ,
{
"role" : "assistant" ,
2026-08-08 16:12:36 +08:00
"content" : " # A g e n t N o t e : 通 过 配 对 兄 弟 文 件 与 配 对 门 禁 实 现 双 语 文 档 \ n \ n S t a t u s : i m p l e m e n t e d \ n \ n [ E n g l i s h ] ( 2026 -0 7 -0 2 - b i l i n g u a l - d o c s - a n d - p a i r i n g - g a t e . m d ) | 中 文 \ n \ n # # 问 题 \ n \ n 本 仓 库 的 文 档 语 料 会 被 公 司 内 外 的 人 和 a g e n t （ 智 能 体 ） 以 中 英 两 种 语 言 阅 读 。 在 没 有 机 制 的 情 况 下 纯 靠 手 工 维 护 第 二 语 言 ， 正 是 译 文 腐 烂 的 根 源 ： 一 侧 持 续 演 进 ， 另 一 侧 默 默 失 实 ， 而 没 有 门 禁 会 注 意 到 。 对 于 这 类 不 变 式 ， 本 仓 库 一 贯 的 做 法 是 将 其 编 码 为 机 械 检 查 （ 见 [ 质 量 门 禁 ] ( 2026 -0 6 -11 - q u a l i t y - g a t e s . m d ) 与 [ d o c - s y n c 强 制 ] ( . . / . . / a r c h i v e d / p r o c e s s / 2026 -0 6 -11 - d o c - s y n c - e n f o r c e m e n t . m d ) ） ， 因 此 双 语 政 策 随 附 一 道 门 禁 一 起 交 付 。 \ n \ n # # 决 策 \ n \ n - * * 配 对 兄 弟 文 件 ， 两 种 语 言 同 权 。 * * 一 对 文 档 由 三 个 兄 弟 文 件 组 成 ： 英 文 ` f o o . m d ` 、 中 文 ` f o o . z h . m d ` ， 以 及 一 份 一 致 性 记 录 ` f o o . i 18 n . y a m l ` 。 没 有 哪 种 语 言 是 正 典 ： 一 篇 文 档 可 以 先 用 中 文 撰 写 和 评 审 、 之 后 再 译 成 英 文 ， 反 之 亦 可 ； 约 束 配 对 的 是 ： 两 侧 必 须 表 达 相 同 的 内 容 ， 且 配 对 整 体 合 并 （ 两 种 语 言 加 记 录 ， 绝 不 单 独 落 一 侧 ） 。 政 策 见 [ d o c s / i 18 n / R E A D M E . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / R E A D M E . m d ) ； 翻 译 规 则 见 [ d o c s / i 18 n / t r a n s l a t i o n - r u l e s . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / t r a n s l a t i o n - r u l e s . m d ) ； 术 语 真 源 见 [ d o c s / i 18 n / t e r m i n o l o g y . m d ] ( . . / . . / . . / . . / d o c s / i 18 n / t e r m i n o l o g y . m d ) 。 \ n - * * 伴 随 记 录 保 存 两 侧 b l o b h a s h ， 使 一 致 性 可 检 查 。 * * ` f o o . i 18 n . y a m l ` 保 存 两 侧 文 件 在 上 一 次 确 认 一 致 时 各 自 的 完 整 g i t b l o b h a s h 。 此 后 修 改 了 任 一 侧 而 未 重 新 确 认 配 对 ， 都 能 被 机 械 检 测 出 来 （ 纯 内 容 比 较 ， 无 需 查 询 历 史 ） ， 而 且 同 一 个 P R （ P u l l R e q u e s t ） 内 改 动 的 文 件 也 能 计 算 出 h a s h ， c o m m i t h a s h 式 的 记 录 做 不 到 这 一 点 。 重 新 记 录 （ ` v e r i f y - t r a n s l a t i o n - p a i r i n g - - w r i t e < p a i r > ` ， 要 求 点 名 所 确 认 的 配 对 ； 批 量 重 新 记 录 是 显 式 的 ` - - w r i t e - - a l l ` ） 会 产 生 一 份 可 评 审 的 y a m l d i f f ： 确 认 一 致 在 P R 中 是 一 个 显 式 、 可 见 的 动 作 。 \ n - * * ` v e r i f y - t r a n s l a t i o n - p a i r i n g ` 加 入 ` d o c - s y n c ` 。 * * 门 禁 （ [ s c r i p t s / v e r i f y - t r a n s l a t i o n - p a i r i n g . t s ] ( . . / . . / . . / . . / s c r i p t s / v e r i f y - t r a n s l a t i o n - p a i r i n g . t s ) ） 强 制 执 行 以 下 规 则 ： 每 个 已 发 现 且 未 排 除 的 源 文 档 都 有 完 整 配 对 ； 每 个 现 有 配 对 都 完 整 （ 三 个 文 件 齐 全 ） 且 一 致 （ 两 个 h a s h 匹 配 、 中 文 侧 和 所 有 普 通 撰 写 的 英 文 源 都 带 切 换 行 而 清 单 内 的 生 成 英 文 源 除 外 、 结 构 签 名 一 致 ） ； 被 排 除 的 生 成 文 档 、 指 令 文 档 或 本 身 即 双 语 的 文 档 不 得 配 对 。 [ s c r i p t s / t r a n s l a t i o n - p a i r i n g . m a n i f e s t . j s o n ] ( . . / . . / . . / . . / s c r i p t s / t r a n s l a t i o n - p a i r i n g . m a n i f e s t . j s o n ) 只 包 含 显 式 排 除 项 ， 因 此 任 何 要 求 都 无 法 绕 过 发 现 流 程 而 接 受 较 弱 的 检 查 。 只 有 当 ` . z h . m d ` 围 栏 序 列 与 其 无 后 缀 兄 弟 文 件 拥 有 顺 序 相 同 、 正 文 按 字 节 一 致 的 同 一 组 受 跟 踪 围 栏 时 ， 面 向 源 码 的 代 码 门 禁 才 会 将 其 作 为 派 生 内 容 消 费 ； 不 完 整 、 顺 序 变 更 、 重 分 类 或 已 改 动 的 序 列 仍 会 独 立 受 检 ， 因 此 由 其 所 属 的 代 码 门 禁 或 配 对 门 禁 报 告 不 匹 配 。 \ n - * * 全 语 料 统 一 要 求 。 * * 范 围 内 的 每 篇 文 档 从 创 建 起 就 必 须 有 完 整 配 对 ； 政 策 没 有 逐 文 件 推 进 状 态 、 日 期 分 界 或 R E A D M E 专 用 类 别 。 R E A D M E 发 现 会 覆 盖 v e n d o r 源 码 、 依 赖 目 录 与 被 忽 略 的 构 建 产 物 目 录 之 外 所 有 文 件 名 不 区 分 大 小 写 匹 配 R E A D M E 的 文 件 ， 包 括 今 后 新 增 的 顶 层 目 录 。 发 布 到 文 档 站 的 配 对 使 用 ` p a i r e d P a g e s ( ) ` ， 由 根 l o c a l e 投 影 ` . z h . m d ` ， 由 ` / e n / ` 投 影 ` . m d ` ； 仅 创 建 对 侧 文 件 并 不 会 发 布 它 。 \ n - * * 配 对 记 录 是 元 数 据 ， 而 不 是 C o r d i s L o a d e r 配 置 。 * * C o r d i s 配 置 发 现 会 接 受 实 际 的 ` . c o r d i s . y m l ` 和 ` . c o r d i s . y a m l ` 文 件 ， 同 时 排 除 ` * . i 18 n . y a m l ` ， 即 使 文 档 名 中 包 含 ` c o r d i s ` 也 不 例 外 。 这 样 既 能 继 续 校 验 可 执 行 的 L o a d e r 配 置 项 ， 又 不 会 把 翻 译 h a s h 当 作 配 置 来 解 析 。 \ n - * * 翻 译 是 a g e n t 的 工 作 ， 由 人 评 审 。 * * 常 规 改 动 采 用 由 [ 轻 量 翻 译 决 策 ] ( 2026 -0 8 -0 8 - l i g h t w e i g h t -
2026-07-23 22:41:53 +08:00
} ,
{
"role" : "user" ,
2026-07-23 23:12:56 +08:00
"content" : "---\nlayout: doc\n---\n\n# Snapshot note\n\nThe agent performs one step.\n"
2026-07-23 22:41:53 +08:00
}
]
} ,
"response" : {
2026-07-23 23:12:56 +08:00
"translation" : "---\nlayout: doc\n---\n\n# 快照说明\n\nagent（ ） ,
2026-07-23 22:41:53 +08:00
"review" : "- 无修正" ,
2026-07-23 23:12:56 +08:00
"final" : "---\nlayout: doc\n---\n\n# 快照说明\n\n[English](snapshot-note.md) | 中文\n\nagent（ ）
2026-07-23 22:41:53 +08:00
}
}
